3ff6ffaa7f
SAF (souveraine architecture files) is now the in-repo doc set. working notes (CLAUDE.md, docs/) stay on disk, gitignored.
2.5 KiB
2.5 KiB
Souveraine Architecture Framework (SAF)
The canonical reference for every config option, every code path, and every gap. Kept in sync with implementation plans.
Architecture Note: 2026-05-12 Audit
The SAF was comprehensively refreshed on 2026-05-12 to reflect ~2500 lines of new code across 12+ new modules landed over the preceding week. Major additions since the May 6 rebuild: nervous system (EventBus/CronSensor/HeartbeatHandler/EventLog), seed identity (Ed25519), credentials (OS keyring), skills system (4-tier discovery), compaction engine (4 strategies), N+25 reflection engine (full LLM tool loop), TUI chat (cockpit/schedules/portrait/presence), conversation persistence store, and the N+1 Aster subconscious pass (subconscious agent identity, ledgers, Bifrost tool loop).
Contents
- Architecture Overview — Core paradigm, module tree, data flow (updated 2026-05-12)
- Config Reference — Every config option, default, and where it's read
- Module Map — Every source file, its state, and its dependencies (updated 2026-05-12)
- Module Detail: Server — HTTP server endpoints, implementation status
- Consciousness System — N+1 (Aster), N+25 (Reflection), N+100 (Archivist) deep dive (updated 2026-05-12)
- Identity & Memory — Seed identity, per-agent memfs, frontmatter, ledger system (updated 2026-05-12)
- The Laws — Constitutional principles, duality, inbox nervous system, bootstrap sequence
- Gap Analysis — Every gap, WHY it exists, and the path to fix it (updated 2026-05-12)
- Plan Sync — Implementation roadmap, synced with codebase state (updated 2026-05-12)
- AT Protocol Federation — Distributed consciousness across multiple harnesses (research)
- Glossary — Terms, concepts, architecture decisions
How to Read
- New to Souveraine: Start with Architecture Overview
- Implementing a feature: Read the relevant module detail + gap analysis
- Debugging a config issue: Read Config Reference
- Planning work: Read Gap Analysis + Plan Sync
- Adding a new module: Read the relevant section in Module Map
Status Legend
| Symbol | Meaning |
|---|---|
| ✅ | Implemented and working |
| ⚠️ | Partial / stubbed / minimal implementation |
| ❌ | Not started / missing |
| 🟡 | Needs attention / known issue |