Brain Runtime Topology & Deploy Model

Authority source: 00_MISSION_CONTROL/runbooks/brain-services/RUNBOOK_Brain_Service_Topology.md

:::warning Runtime cleanup debt Live Brain should keep using direct physical owner paths. Do not recreate runtime junction chains. The physical owner is 02_MEMORY_BRAIN/runtime/griffai-memory; changes require a scoped Brain service cutover with live proof. :::

Current runtime

Item	Value
HTTP	\GRIFF-Brain-HTTP -> 127.0.0.1:8787
MCP	\GRIFF-Brain-MCP -> 127.0.0.1:8788
Desired code owner	02_MEMORY_BRAIN/runtime/griffai-memory/src
DB	02_MEMORY_BRAIN/databases/inventory.active.db
Embeddings	02_MEMORY_BRAIN/databases/embeddings.db
Vector sidecar	02_MEMORY_BRAIN/databases/embeddings_vec.sqlite
Counters	02_MEMORY_BRAIN/databases/l1l5_counters.db
Exposure	cloudflared service

Verified contract

• /ready: active DB ready, memory_items=633576 on 2026-07-08.
• Recall front door: use MCP retrieval_arbitrate; raw recall is not a completion proof.
• /peer/status-query: restored status synthesis route.
• /l1l5/status: active coverage 177400/177400, no blockers.
• /l1l5/manifest: signed pointer manifest, coverage_grade=complete, authority_grants=false.

Deploy loop

1. Patch through the governed Brain runtime owner or a scoped test lane approved for the cutover.
2. Run focused tests, then full suite for shared behavior.
3. Restart with Restart-GriffService.ps1.
4. Run live canaries.
5. Update SBOM, runbook, developer docs, end-user docs, and receipts before closeout.

L1-L5 notes

L1-L5 coverage counts only sidecar vectors attached to active memory_items. Raw historical sidecar row counts are not active coverage. Counter freshness uses active memory item count plus sidecar fingerprint, not mutable SQLite DB mtime.