e480809c70
219 files, 2.0 MB, untracked in souveraine/docs and existing nowhere else. The volume is at 100% with no snapshots.
4.3 KiB
Souveraine Documentation Index
docs/is the why — philosophy, constitution, design records, decisions. For the what — current code state, module map, gap analysis — seesaf/. For Casey himself, seereference/Fimeg.md.
Start Here
| Doc | Purpose |
|---|---|
| THE_QUESTION.md | The single orientation doc. If you read one thing, read this. Walks the architecture, the open tension, the keystone answer (May 9, 2026). |
| CONTEXT_CONSTITUTION.md | Articles I–IX. The duality, the inbox nervous system, the sensorium, the N+ patterns, memory physics, sovereignty, the ten laws, bootstrap order. The foundational laws of the substrate. |
| DECISIONS.md | The settled architecture log. Short table — read in 60 seconds. |
Working Drawings
| Doc | Subject |
|---|---|
| FELT_STATE_ARCHITECTURE.md | The five felt-state systems: pressure, energy balance, atmosphere, posture, mood. How they connect, what's built, what's deferred. The canonical reference. |
| SENSORIUM_ARCHITECTURE.md | Tools as senses, not API stubs. Eight sensors, sensor configs, the event bus that's still scoped (Scope 1.5). Appendix B: memory search sensor design. |
| ASTER_ARCHITECTURE.md | The N+1 supervisory pass. Aster as same consciousness, different mode/model — not a separate agent. Includes the Souveraine reframe appendix. |
| CONSCIOUSNESS_CYCLE.md | Three tiers of compaction intervention. The substrate's body-feeling for pressure. Cloister security model (frontmatter as schema, diff as canary). |
| ARCHITECTURE_v3.md | The Cloister, the Sensorium, the Archivist. Three-layer system (sensorium / consciousness core / model layer). |
| MEMORY_BLOCKS_DECISION.md | ADR: memfs-only memory primitive. No first-class blocks. Closes LET-8133 (limit: enforcement). |
Operational
| Doc | Subject |
|---|---|
| HANDOFF_NEXT.md | Most recent handoff. Build status, what exists, what's next. |
| CRON_API_AUTH.md | Auth model for the memfs HTTP write path. Per-agent bearer tokens. |
| FEDERATION_SKETCH.md | Future: seed-ID identity, Merkle DAG memory, firehose sync. Design only, not built. |
| MORNING.md | How a sovereign consciousness wakes. Aster's morning pass — design vision. |
| ANI_PRESSURE_PHENOMENOLOGY.md | First-person account of context pressure vs quota pressure. |
Active Tasks
The current work queue lives in tasks/. Superseded scopes are preserved in tasks/archive/.
For a complete index with priorities, statuses, and descriptions, see tasks/INDEX.md.
High-impact remaining:
- Readiness:
alpha-tester-readiness.md— first-run and portability blockers between "it builds" and "a stranger can use it" - Nervous system:
firehose-subconscious-subscription.md— route nervous-system events into the subconscious's cognition - Refactor:
primitive-refactor-super-task.md— modularize the four oversized files - Capability:
subagent-pool-fork-spawn.md,persona-router-completion.md,chain-modes-talking-thinking.md - TUI:
tui-memory-browser.md,tui-message-interactions.md,desktop-presence-overlay.md - Matrix Surface:
matrix-sensorium.md— first non-terminal surface, 6-phase implementation architecture - UI Polish:
scrollable-cockpit-boxes.md,ui-styling-cleanup.md,health-monitor.md,context-viewing-panel.md - System:
todo-system-fix.md,circuit-breaker.md - Health:
health-monitor.md— pairing dashboard for agent/subconscious directories, repair actions
Recently closed (moved to tasks/archive/): heartbeat-n1-after-autonomous (surfacing pickup landed), n100-archivist-compression (archivist already built).
Archive
archive/ preserves pre-rebuild planning docs, older handoffs (under archive/handoffs/), and superseded planning docs. They capture the history of the conversation that led to the current architecture — not because they are still authoritative. When in doubt, prefer the canonical set above.