Remove stale ADR-005 drift tables across all architecture docs since ResponseEnvelope types, factories, detection, and integration points are now fully implemented in source code. Key changes: - api-surface.md: Remove ADR-005 drift table (all items implemented), retain ADR-006 drift table without execute() return type (now done) - call-protocol.md: Remove ADR-005 drift table, update ADR-006 table, fix CallHandlerConfig to show callMap? (current source) - adapters.md: Remove 'current source state' and 'implementation changes needed' tables for from_mcp and from_openapi, replace with current-accurate descriptions of envelope behavior - response-envelopes.md: Remove 'current source state' blocks, update migration checklist to show all code changes completed - 005-response-envelopes.md: Change status from Draft to Implemented - 006-unified-invocation-path.md: Update Prerequisites section to note ADR-005 is now implemented - build-distribution.md: Add response-envelope.ts to source layout - architecture.md: Add response-envelopes.md link and ADR-005/006 entries to design decisions table - README.md: Add response-envelopes.md to documents table - Update last_updated dates on all changed docs
1.9 KiB
1.9 KiB
Architecture
This document has been decomposed into modular documents. See docs/architecture/ for the current architecture specification.
| Document | Content |
|---|---|
| architecture/README.md | Overview, why this exists, what it provides, consumer context, threat model |
| architecture/api-surface.md | All public types, registry API, call protocol API, subscribe, env, adapters |
| architecture/call-protocol.md | PendingRequestMap, CallHandler, call≡subscribe semantics, events, error model, access control |
| architecture/response-envelopes.md | Response envelope types, factory functions, detection, schemas, integration points |
| architecture/adapters.md | from_schema, from_openapi, from_mcp, scanner — how they work, how to add new adapters |
| architecture/build-distribution.md | Dependencies, project structure, sub-path exports, peer deps, build tooling |
Design Decisions
| ADR | Decision |
|---|---|
| 001 | Direct @logtape/logtape import instead of wrapper module |
| 002 | Inject filesystem dependencies for runtime agnosticism |
| 003 | Peer dependencies for adapter isolation (MCP SDK, @std/path) |
| 004 | Schema const naming convention (AccessControlSchema + AccessControl type) |
| 005 | Response Envelopes for transport-aware results |
| 006 | Unified Invocation Path (execute as single entry point) |