Cortex Memory — Master Index (THE cortex entry point)
Created 2026-06-21 · rewritten to the ratified direction 2026-06-26.
This is the single canonical entry for the cortex memory program. It is the cortex anchor; the
program-wide priority order lives in [[delivery/PROGRAM-ROADMAP.md]] (cortex is one program within it).
Everything cortex hangs off this file.
Direction (operator-ratified, kulbir 2026-06-26). Read this first — it supersedes the 2026-06-21
scope framing below it.
0. The ratified direction (what cortex IS)
1. Cortex is THE universal memory backend. Every agent and every application that needs to recall
like a human does — Conduir teams, Claude, Codex, Antigravity, future agents — uses cortex. Anything
with history it must recall is a cortex client. There is no second memory system.
2. ONE cortex — the twin/vendored copies are debt, not architecture. Today there are 3+ physical
memory trees (the canonical cortex_memory/, the ~20K-LOC symposium/memory/ twin, a vendored
cortex-memory/src/symposium/ tree, +a 4th evolution_memory.py) held together by a byte-identity
parity gate. That gate was always only a stopgap. Single-cortex was always the plan; the twin is
retired by CON-4147 (decomposition + full gap register:
[[delivery/CORTEX-SINGLE-CORTEX-CONSOLIDATION-GAPS-2026-06-26.md]]). Named blocker: CON-4203
(twin tenant-RLS) + the contracts/privacy decision.
3. One reach surface — MCP for all. P7 interfaces converge on an MCP-memory seam (CON-4202, under
P8/CON-4209) so every agent reaches the one cortex the same way; the witness-SSE stream (CON-4201) and
single write-path are the runtime proof the contract is consumable.
4. Durable + erasable — crypto-shredding reconciles RTBF with the immutable ledger. The P5 Ledger is
tamper-evident + hash-chained AND supports true GDPR erasure by hashing ciphertext and destroying the
per-user key (not the bytes). Design (swarm-hardened):
delivery/CORTEX-L4-CRYPTO-SHREDDING-DESIGN-2026-06-26.md (CON-3994 / successor CON-4235) —
dead citation, not on evolution/main, found 2026-07-28 by check_wikilinks.py (see §1 table row below).
5. Swappable provider + elastic platform are deferred successors, not blockers. Hexagonal
MemoryProvider port = CON-4221; the Postgres-native elastic-RLS platform = P8/CON-4209.
Today's SQLite-tier cortex is the substrate; these raise the ceiling later (chosen by trajectory, not
a today's-performance bake-off).
1. Live authoritative docs (consult these for current state — not memory)
| Document | Role |
|---|---|
| [[delivery/CORTEX-SINGLE-CORTEX-CONSOLIDATION-GAPS-2026-06-26.md]] | Single-cortex gap register + CON-4147 P0..N kill-plan (3 trees, 2 tenant models, per-module parity). |
delivery/CORTEX-OPEN-TICKET-DUE-DILIGENCE-2026-06-26.md (not on evolution/main — dead citation, found 2026-07-28 by check_wikilinks.py; content exists only on unrelated stale experimental branches with no clear content authority to restore from, see delivery/PHASE-0-COORDINATION-REGISTRY-2026-05-19.md §5 2026-07-28 row) | Ground-truth triage of the open cortex tickets (buckets: agent-fixable / operator-gated / spike / blocked / future), file:line cited. |
delivery/CORTEX-EPIC-COMPLIANCE-READINESS-HANDOFF-2026-06-25.md (dead citation, same follow-up as above) | The P4–P7 readiness pre-check for the independent /epic-compliance session (executor does NOT self-audit, §4). |
delivery/CORTEX-L4-CRYPTO-SHREDDING-DESIGN-2026-06-26.md (dead citation, same follow-up as above) | P5 RTBF crypto-erasure design (swarm-hardened: XChaCha20, AAD, full-envelope hash, Vault Transit key-destruction, per-record HKDF DEK). |
| [[delivery/PROGRAM-ROADMAP.md]] | Program-wide priority (cortex is one program within it) — the cross-program "what's next". |
2. Design principles (the "why" — forged in the 2026-06-21 review, still load-bearing)
| Document | Captures |
|---|---|
| CORTEX-COGNITIVE-ONTOLOGY-2026-06-21.md | Information→Knowledge→Habit→Marker; no-regex-knowledge; forgetting≠destruction; affective/persona valuation w/ safety floor; Eureka override; use-makes-it-live |
| CORTEX-MEMORY-PROVENANCE-LEDGER-2026-06-21.md | Memory-vs-Ledger split; non-fungibility; assertion≠truth; poison-vs-Eureka; RTBF-scoped; action-audit; approval-gateway |
| CORTEX-MULTI-TENANCY-ARCH-REVIEW-CHARTER-2026-06-21.md | MT-ARR: single elastic multi-tenant platform, logical RLS, kind-aware (skill-vs-interaction, team-scope) |
| CORTEX-MEASUREMENT-LEADERBOARD-PROTOCOL-2026-06-21.md | CCMLP — release leaderboard + memory-OFF falsifiable benchmark (measurement spine) |
| CORTEX-MEMORY-MULTIVERSE-2026-06-21.md | Bitemporal history + branch/replay (G103) |
| CORTEX-ADAPTIVE-RANKING-ENSEMBLE-2026-06-21.md | Measured/evolving multi-ranker fusion (G106) |
| CORTEX-COMPONENT-PLUGIN-MODULARIZATION-2026-06-21.md | Component plug-ins / tech-agnostic (G107, CON-3987) |
3. The delivery epics (JIRA)
| Epic | Phase | Scope | State |
|---|---|---|---|
| CON-3993 | P4 Learn / Habit / Compounding | outcome credit (G1/G2) + Eureka (G104) + valuation — the thesis | In Progress |
| CON-3994 | P5 Govern / Durable / Trust | the Ledger + RTBF (crypto-shredding) + recovery | In Progress |
| CON-3995 | P6 Tenancy & Platform | single-platform RLS + skill/interaction + team-scope | In Progress |
| CON-3996 | P7 Interfaces | single write-path + MCP-for-all + Claude seam + witness | In Progress |
| CON-4147 | Single-cortex consolidation | retire the twin / vendored trees onto ONE cortex | To Do (operator-gated sequence) |
| CON-4209 | P8 — deferred elastic platform | Postgres-native RLS + MCP server + crypto-erase successors | To Do |
| CON-4221 | Hexagonal memory | swappable MemoryProvider port | In Review |
(Earlier P0–P3 umbrellas CON-3989/3990/3991/3992 fed the substrate/formation/retrieval/consolidate work
folded into the above.)
4. Honest status (CLAUDE.md §1 — documentation never closes a ticket)
Substantial P4–P7 implementation merged to main this cycle (tenant fail-closed CON-4187; tenant-scoped
reads CON-4210; cross-user recall CON-4169; twin re-single-source CON-4200/#1441; action-audit CON-4195;
approval-gate CON-4196; crystal quarantine CON-4198; witness-SSE CON-4201; grounded-analyst CON-4131; thecortex-memory audit profile). None of the four epics is Done — they remain In Progress pending an
independent /epic-compliance PASS (executor does not self-certify, §4) and the operator-gated set:
- P5 RTBF crypto-erasure build greenlight + Vault
CORTEX_L4_LEDGER_KEYprovisioning (tamper-evidence inert until keyed — no flag-off theater). - P4 live-loop go on real/replayed traces (CON-4197/4199 — unblocks the compounding thesis gate).
- P6/P7 single-cortex consolidation sequence (CON-4147) + recall root-cause under load (CON-4003/4001).
The path to PASS is: merge + close the agent-fixable children, land the operator decisions, then an
independent audit. Consult §1's live docs (not this summary) for the current per-ticket truth.