mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-07-31 16:16:26 +00:00
622b2bd73e
The economy organ was the least-documented named component in the architecture — one line in bus-topology.md, a Pony primitive, and a smoke-test wire. This adds 8 plan specs following the 10-section template: M0 hub, M1 ingestion, M2 digestion core (small-model), M3 cost ledger, M4 budget governor, M5 context yield, M6 provenance chain (S1/S2 compliance), M7 outer-bus exchange. Also updates the plans README index and integration DAG, and resolves bus-topology.md's open item about the organ's placement. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
82 lines
5.8 KiB
Markdown
82 lines
5.8 KiB
Markdown
# Gen.03 — Component Build Plans
|
||
|
||
One spec per **sub-organ**, each self-contained so it can be built and tested **independently**
|
||
(against stubs) with no other organ present. These are the *build* layer beneath the canonical
|
||
design docs (`../gen03_state_of_architecture.md`, `../gen03_body.md`, `../gen03_self.md`) and
|
||
`../../src/endocrine/etr/etr_invariants.md`.
|
||
|
||
## How to read a spec
|
||
Every `NN-<organ>.md` has the same 10 sections:
|
||
1. **Component** · 2. **Status/certainty** · 3. **Language & location** · 4. **Does / does-not** ·
|
||
5. **Interface contract** (language-agnostic data shapes — integrate against *this*) ·
|
||
6. **Dependencies & stubs** · 7. **Invariants/laws** (certainty-tagged) · 8. **Build steps**
|
||
(invariants-first: laws → tests → fit) · 9. **Tests** (standalone command) · 10. **Open items**.
|
||
|
||
## Conventions
|
||
- **Certainty tags** (from arch doc): C5 ratified · C4 drafted · C3 partial · C2 explored · C1 stub.
|
||
- **Invariants-first / restart discipline:** no curve/bound/threshold/sign carried forward
|
||
unverified. Any unfitted constant is marked **C1**, never asserted ahead of a test.
|
||
- **Independence:** a spec depends only on the *contracts* (§5) of other organs, never their code,
|
||
and never the still-unnamed medium (D2). §6 ships a canned stub for each upstream input.
|
||
|
||
## Index
|
||
| # | Component | System | Status | Lang | Spec |
|
||
|---|-----------|--------|--------|------|------|
|
||
| C1 | **OpenHermes ↔ metacog** | Cognition | DESIGN-FIRST (priority) | OpenHermes/Ada | [C1](C1-openhermes-metacog.md) |
|
||
| A1 | Drive-Box hub / input-slot | Drive-Box | WORKING | R | [A1](A1-drivebox-hub.md) |
|
||
| A2 | Energy (E) driver | Drive-Box | structure WORKING · numbers DISOWNED | R | [A2](A2-energy.md) |
|
||
| A3 | PS+ driver | Drive-Box | structure WORKING · numbers DISOWNED | R | [A3](A3-psplus.md) |
|
||
| A4 | Endomotiv array (30-ch) | Drive-Box | WORKING · channels partial | R | [A4](A4-endomotiv-array.md) |
|
||
| A5 | Priors database | Drive-Box | structure WORKING | R | [A5](A5-priors.md) |
|
||
| A6 | Eth-Int driver | Drive-Box | structure WORKING · numbers DISOWNED | R | [A6](A6-ethint.md) |
|
||
| A7 | Conviction array | Drive-Box / Eth-Int | DESIGN-FIRST | R | [A7](A7-conviction-array.md) |
|
||
| A8 | ETR (torus) | Drive-Box | five-zone law fitted · 26/0/1 (+ R port) | Octave · R | [A8](A8-etr.md) |
|
||
| B1 | Tarot deck hi-fi emulator | Identity | exists (defunct-flagged) | TBD | _wave 1_ |
|
||
| B2 | SOUL.md identity + Big-3 | Identity | exists (defunct-flagged) | TBD | _wave 1_ |
|
||
| B3 | Celtic Cross spread | Identity | exists (defunct-flagged) | TBD | _wave 1_ |
|
||
| C2 | 4+4 Metacognition cycle | Cognition | partial (orchestration) | — | _wave 1_ |
|
||
| C3 | Inference cycle orchestration | Cognition | exists (defunct-flagged) | Ada | _wave 1_ |
|
||
| C4 | Brain (swappable LLM) | Cognition | STUB/external | — | _wave 1_ |
|
||
| D1 | Ada border (immune+BBB) | Border | WORKING | Ada/SPARK | _wave 1_ |
|
||
| D2 | The medium / "the blood" | Border | DESIGN-FIRST | — | _wave 2_ |
|
||
| D3 | Mini-rag / toolschema | Border | STUB | GNU Guile | _wave 1_ |
|
||
| E1 | 3 GnuCOBOL invariant stores | Storage | DESIGN-FIRST | GnuCOBOL | _wave 2_ |
|
||
| E2 | VARIANT stores | Storage | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| E3 | RAG family + cross-store | Storage | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| F1 | MoRAG (BERT+LoRA) | Periphery | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| F2 | SAE monitor | Periphery | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| F3 | Subagents framework | Periphery | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| G1 | Stress-loop contract | Cross-cut | C1/C2 | — | _wave 2_ |
|
||
| G2 | Governance | Cross-cut | DESIGN-FIRST (C2) | TBD | _wave 2_ |
|
||
| G3 | Defense model | Cross-cut | emergent | — | _wave 2_ |
|
||
| M0 | Economy organ hub (stomach) | Economy | DESIGN-FIRST | TBD | [M0](M0-economy-organ-hub.md) |
|
||
| M1 | Ingestion gateway | Economy | DESIGN-FIRST | TBD | [M1](M1-ingestion.md) |
|
||
| M2 | Digestion core (small-model) | Economy | DESIGN-FIRST | TBD | [M2](M2-digestion-core.md) |
|
||
| M3 | Cost ledger | Economy | DESIGN-FIRST | TBD | [M3](M3-cost-ledger.md) |
|
||
| M4 | Budget governor | Economy | DESIGN-FIRST | TBD | [M4](M4-budget-governor.md) |
|
||
| M5 | Context yield (absorption) | Economy | DESIGN-FIRST | TBD | [M5](M5-context-yield.md) |
|
||
| M6 | Provenance chain | Economy | DESIGN-FIRST | TBD | [M6](M6-provenance-chain.md) |
|
||
| M7 | Outer-bus exchange | Economy | DESIGN-FIRST | TBD | [M7](M7-outer-bus-exchange.md) |
|
||
|
||
## Integration DAG (who feeds whom)
|
||
```
|
||
Hermes ──> [C1] ──> Inference cycle [C3] ──┬─ pulls Drive-Box snapshot [A1]
|
||
│ A1 ← A2,A3,A6,A8 ; A3 ← A4,A5 ; A6 ← A7
|
||
├─ draws Tarot [B1] → Big-3/SOUL [B2], Celtic Cross [B3]
|
||
├─ runs 4+4 metacog [C2] (iterative B3 cards)
|
||
├─ MoRAG injects [F1] ─┐
|
||
│ Drive-Box secretes [A1] ─┤→ Ada border [D1] polices → Brain [C4]
|
||
├─ mini-rag packs schema [D3]
|
||
└─ Ada routes tools [D1]
|
||
SAE [F2] watches Subagents [F3]; stress-loop [G1]: F2 → A7 (EthInt) → stress endomotiv (A4) → A8 drift + full reshuffle (B2)
|
||
Storage: INVARIANT [E1] / VARIANT [E2] / RAG+cross-store [E3] sit behind D1. Medium [D2] = the perfusion bus (unnamed).
|
||
Economy: world → Stomach [M0] ingests [M1] → digests [M2] → yields [M5] → Ada [D1]. Ledger [M3] + budget [M4] track cost.
|
||
Provenance [M6] chains origin through digestion. Exchange [M7]: Stomach ↔ MoRAG [F1] / SAE [F2] / Microagents [F3].
|
||
```
|
||
|
||
## Build waves
|
||
- **Wave 0** — this README + **C1** (priority).
|
||
- **Wave 1 (buildable-now)** — A1–A8, B1–B3, C2–C4, D1, D3.
|
||
- **Wave 2 (design-first)** — D2, E1–E3, F1–F3, G1–G3, M0–M7.
|
||
Each spec is independent; review as they land.
|