Fixed
Specification Documents
docs/features/event-system.md— Fixed severity levels fromwarning/criticaltowarn/fatal, aligning with PROTOCOL_SPEC §10.2docs/features/core-executor.md— Fixed Identity description: removed incorrectpermissionsfield, corrected toid,type,roles,attrsper PROTOCOL_SPEC §5.7docs/features/core-executor.md— Added missingApprovalPendingErrorto Approval Gate description per PROTOCOL_SPEC §7.4docs/features/middleware-system.md— Addedretry.pyto Key Files table (was described in Components but missing from file list)docs/features/observability.md— Added concrete metric names (apcore_module_calls_total,apcore_module_errors_total,apcore_module_duration_seconds) to convenience method documentation
Protocol Specification
- Fixed duplicate
### 10.5section numbering — renumbered Sensitive Data Redaction to §10.6, Sampling Strategy to §10.7, Span Naming Convention to §10.8 - Fixed
### 8.1.1misnumbered under §9.1 — corrected to §9.1.1 - Fixed
### 10.8.xmisnumbered under §11.8 — corrected to §11.8.1–§11.8.4 - Fixed middleware priority model contradiction between §11.2 (explicit 0-1000) and §12 (registration order) — §12 now aligns with §11.2
- Fixed
on_errorexamples in README.md and concepts.md — changedraise errorto correct return-based contract (return None/return dict) - Updated "Last Updated" date to 2026-03-24
Scope Document
- Added Approval System (§7) and Event System to "Core Protocol Includes" list in SCOPE.md
README
- Added AI-Perceivable brand definition block to README header
- Added "Perceived → Understood → Executed" progression table to "Why AI-Perceivable?" section
Ecosystem
§5.13 Display Overlay (specified in v0.13.0) is now implemented across the official adapter stack:
| Package | Version | What was implemented |
|---|---|---|
apcore-toolkit |
0.4.0 | DisplayResolver — §5.13 resolve priority chain, MCP alias sanitization/64-char limit, CLI alias validation, suggested_alias fallback, binding_path file/directory loading |
apcore-cli |
0.3.0 | CLI command routing from metadata["display"]["cli"]["alias"]; descriptor cache; JSON output reads display overlay |
apcore-mcp |
0.11.0 | MCP tool name and description from metadata["display"]["mcp"]; guidance appended to tool description |
apcore-a2a |
0.3.0 | A2A skill id/description/tags from metadata["display"]["a2a"]; removed dead _build_extensions() |
fastapi-apcore |
0.4.0 | binding_path parameter on create_cli() / create_mcp_server(); DeprecationWarning for simplify_ids=True |
- §5.14 Convention Module Discovery — new optional protocol capability for zero-decorator module registration via
commands/directory convention.