mirror of https://github.com/SHOGGOTH-SECTOR/sica-fondt.git synced 2026-07-31 08:06:26 +00:00

Reorg step 1: consolidate repo under core/, drop the mafiabot label

Mechanical structure-only pass (no document/guide content edits):

- Move src/ichor, src/endocrine, and docs/ into core/; the old top-level
  mafiabot_core/ becomes core/. Everything now lives under a single core/ root.
- Drop the "mafiabot" label from the Ada/Alire crate: core.gpr (project Core),
  alire.toml name = "core"; the generated *_config.* regenerate as core_config.*.
- Repoint build-critical wiring only:
  - .claude/skills/run-sica-fondt/smoke.sh (ponyc + Ada + COBOL paths)
  - core/src/endocrine R source()/runner paths and the test glob
  - .github/workflows/ci.yml (working-directory + gpr name)

Verified green: smoke ALL GREEN (Pony Ichor, Ada core crate + tests, COBOL E1
vault); R endocrine 14/0; Octave ETR 26/0/1.

Deferred (reserved for a less-ephemeral doc/guide pass): docmap.yaml, the guide
files and nested AGENTS.md/README prose + now-stale relative links, SOUL.md, and
the deeper ring/storage restructure.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c

2026-06-23 07:46:47 +00:00

2.1 KiB

Raw Blame History

E3 — RAG family (declarative memory + per-room cross-store) (DESIGN-FIRST)

1. Component

Two memories with different machinery: declarative/relational room context (vector-RAG, namespaced per thread) and the per-room Celtic-Cross store (deterministic keyed — room_id → current cross).

2. Status / certainty

DESIGN-FIRST · cross-store + room-RAG split C4 (mechanism decided); backing C1.

3. Language & location

TBD · new location e.g. src/rag/. Sits behind Ada (D1). This is Ada-RAG = what-you-know (declarative), distinct from mini-rag D3 (procedural).

4. Does / does-not

Does: store/retrieve per-thread relational context (vector-RAG); store/restore each room's live Celtic Cross by exact key (not vector search).
Does-not: hold procedural tool schemas (D3) or the invariant core (E1).

5. Interface contract (proposed)

Cross-store: get_cross(room_id) -> spread / put_cross(room_id, spread) — deterministic keyed, never similarity search (similarity could return the nearest room's spread → wrong lens).
Room-RAG: retrieve(thread_ns, query) -> context[] — namespaced per thread so room A can't bleed into B.
Both behind Ada (D1); writes carry provenance tags.

6. Dependencies & stubs

B3 cross (what's stored) — stub: canned spread. D1 provenance — stub: allow-all. B2 reshuffle reads/writes the cross.

7. Invariants / laws

L1 (C4): live cross per room → deterministic keyed store, never vector-RAG.
L2 (C4): room relational context → vector-RAG, namespaced per thread (no cross-room bleed).
L3 (C4): all writes carry provenance (D1).

8. Build steps

Choose backings (keyed KV for cross-store; vector store for room-RAG). 2. Implement both contracts.
Wire B2/B3 (cross lifecycle) + the cycle's step-2 enrich (C3).

9. Tests

Cross-store exact-key round-trip (and a test that it does NOT do nearest-match); room-RAG namespace isolation.

10. Open items

Backings (C1). Vector store choice (copyleft-first). Provenance tag format (shared with D1/E1/E2).

2.1 KiB Raw Blame History