25 · Codebase Alignment
Founder Canon → repository reality. Baseline commit, surveyed services/packages/apps, nine planes, drift register G-01 → G-10, evidence, status, remediation sequence.
What This Page Is
This page never redefines the Founder Canon. It answers:
How closely does the implementation currently match it?
Authority is ranked: Founder decisions (31 Aug 2026) + latest project conversations → late-August consolidation → 1 Aug 2026 freeze → earlier docs/code → external 2026 market research (validation only). See Founder Canon.
Baseline & Survey
- Baseline commit —
1 Aug 2026 GitHub canonical freeze(implementation baseline where not superseded). - Surveyed surface —
apps/(web, docs, auth, connector),services/(gateway, spine, pipeline, hermes, ai, twin),packages/(capability, work, spine, sdk, types, ui), plusdocs/canonical/(00–18) as the only source allowed to redefine architecture. - Nine planes — the SpineWorkspace planes (Business Context Spine, Human + AI Workbenches, Work, Projection, Capability Fabric, Governance, Hermes, Sync/Verify/Reconcile, Identity/Tenancy) traced to code.
Drift Register (G-01 → G-10)
| ID | Gap | Evidence | Status | Remediation |
|---|---|---|---|---|
| G-01 | Monolithic AI Orchestrator vs separated cognition/routing/agent-runtime/capability/execution | services/ai + gateway routing + ADK vs single orchestrator assumption | Partial — separation underway | Finish ADK middleware extraction; see Runtime Wiring |
| G-02 | Projection Engine as sole composition layer | 04-projection-engine vs mixed UI composition paths | Open | Route gateway to delegate composition |
| G-03 | Loader as sole canonical writer | services/pipeline loader vs direct Spine writes | Open | Enforce governed writers only |
| G-04 | IQ Hub derived intelligence only | services/iq-hub vs canonical-entity confusion | Open | Constrain to derived |
| G-05 | Capability Fabric executes, not Hermes alone | Mixed Hermes direct calls | Open | Route through Fabric |
| G-06 | Governance on composition + execution | Partial policy-plane wiring | Open | Dual-plane governance |
| G-07 | ADK middleware orphan — actual MCP Pool routing | Orphaned ADK path, MCP Pool boundary unclear | Open | Wiring evidence in Runtime Wiring |
| G-08 | Personal Contextual Spine boundary | 03-HUMAN-WORKBENCH-AND-PERSONAL-MEMORY vs 07_MEMORY_SYSTEM | Defined | Enforce per-user, serve-BC |
| G-09 | Customer Zero → External go-live doctrine | CUSTOMER_ZERO_CONSTITUTION vs marketplace | Defined | Follow 16 + marketplace spec |
| G-10 | AI Continuity persistence substrate | Canonical: semantic scope defined; substrate remains architecture decision | Tracked — see Memory & Continuity | Decide store/cache/substrate without changing semantic |
Remediation sequence follows this table order — G-01 → G-10 — unless a gap blocks verified closure.
Evidence
Every row above links to code, docs, and ADRs. The full evidence bundle and surveyed file list live in docs/canonical/17-IMPLEMENTATION-ALIGNMENT-AND-GAP-REGISTER.md.
Where to Go Next
<CardGroup cols={2}>What imports what, what invokes what, live vs orphaned paths.
The decisions that supersede earlier framings.
Canon planes → runnable mapping.