sica-fondt/docs/plans/D2-medium.md
Claude 20e99f434c
docs/plans: remaining component specs — Identity, Cognition, Border, Storage, Periphery, Cross-cutting
Wave 1 remainder + Wave 2 design-first specs, completing one build plan per sub-organ:
- B1 tarot emulator, B2 SOUL/Big-3, B3 Celtic Cross
- C2 4+4 metacog, C3 inference cycle, C4 Brain
- D1 Ada border, D2 the medium, D3 mini-rag
- E1 3 GnuCOBOL invariant stores, E2 VARIANT stores, E3 RAG family
- F1 MoRAG, F2 SAE monitor, F3 subagents
- G1 stress-loop contract, G2 governance, G3 defense model

Each: contract + stubs for independent build; unfitted constants marked C1.

https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c
2026-06-13 20:08:19 +00:00

42 lines
2.1 KiB
Markdown

# D2 — The medium / "the blood" *(DESIGN-FIRST)*
## 1. Component
The perfusion bus the organs share — what circulates between Brain and periphery. The architecture is
explicit that organs communicate by **perfusion, not direct wiring**; this is that medium. Currently
**unnamed and unimplemented**.
## 2. Status / certainty
DESIGN-FIRST · **C1** (named structurally only; no backing, no name).
## 3. Language & location
TBD. Likely a message/IPC substrate (the R↔Octave↔Ada↔Guile organs must interoperate across languages),
so a language-neutral transport (e.g. line-delimited JSON, or a small broker) is the leading shape.
## 4. Does / does-not
- **Does:** carry organ secretions/injections between organs, always *through* Ada (D1) before reaching the Brain.
- **Does-not:** police (D1), enrich (organs), or hold state (storage E*). It is transport, not gate.
## 5. Interface contract (proposed)
- A typed envelope `{ from_organ, to, payload, provenance }` every organ emits/consumes.
- All cross-language organs (R Drive-Box, Octave ETR, Ada border, Guile mini-rag) speak this one shape →
this is what makes the polyglot body interoperate without bespoke per-pair wiring.
## 6. Dependencies & stubs
Everything rides it; nothing it depends on. *Stub today:* in-process function calls + canned envelopes
(which is exactly how the per-organ specs stub their I/O now — the medium formalizes those stubs).
## 7. Invariants / laws
- **L1 (C5):** perfusion, not direct wiring — no organ holds a hard reference to another's internals.
- **L2 (C5):** everything reaching the Brain crosses **Ada (D1)** first.
- **L3 (C1):** envelope carries provenance (so D1 can enforce its provenance laws).
## 8. Build steps
1. **Name it** + choose transport. 2. Define the envelope. 3. Replace the per-organ in-process stubs with
real medium calls, one edge of the DAG at a time (start R↔Octave for the Drive-Box, A8/A1).
## 9. Tests
Round-trip an envelope between two stub organs; assert it passes through a D1 `admit` check; provenance preserved.
## 10. Open items
- **The name.** The transport choice. Whether RDE drives idle-perfusion. (All C1.)