f5122cb59d
Twelve completed or superseded task records leave the live queue; the byte-identical rename duplicate is removed.\n\nThe authority and somatic source records now point at SAF, while tasks 33, 48, 49, 53, 60, and 76 say what is actually left.
59 lines
4.3 KiB
Markdown
59 lines
4.3 KiB
Markdown
# Souveraine Documentation Index
|
||
|
||
> `docs/` is the **why** — philosophy, constitution, design records, decisions.
|
||
> For the **what** — current code state, module map, gap analysis — see [`saf/`](../saf/INDEX.md).
|
||
> For Casey himself, see [`reference/Fimeg.md`](../reference/Fimeg.md).
|
||
|
||
## Start Here
|
||
|
||
| Doc | Purpose |
|
||
|-----|---------|
|
||
| [THE_QUESTION.md](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](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](DECISIONS.md) | The settled architecture log. Short table — read in 60 seconds. |
|
||
|
||
## Working Drawings
|
||
|
||
| Doc | Subject |
|
||
|-----|---------|
|
||
| [FELT_STATE_ARCHITECTURE.md](FELT_STATE_ARCHITECTURE.md) | Historical design of the five felt-state systems. Current implementation truth and open architecture live in `souveraine/saf/nervous/03-felt-state.md`. |
|
||
| [SENSORIUM_ARCHITECTURE.md](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](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](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](ARCHITECTURE_v3.md) | The Cloister, the Sensorium, the Archivist. Three-layer system (sensorium / consciousness core / model layer). |
|
||
| [MEMORY_BLOCKS_DECISION.md](MEMORY_BLOCKS_DECISION.md) | ADR: memfs-only memory primitive. No first-class blocks. Closes LET-8133 (`limit:` enforcement). |
|
||
|
||
## Operational
|
||
|
||
| Doc | Subject |
|
||
|-----|---------|
|
||
| [HANDOFF_NEXT.md](HANDOFF_NEXT.md) | Most recent handoff. Build status, what exists, what's next. |
|
||
| [CRON_API_AUTH.md](CRON_API_AUTH.md) | Auth model for the memfs HTTP write path. Per-agent bearer tokens. |
|
||
| [FEDERATION_SKETCH.md](FEDERATION_SKETCH.md) | Future: seed-ID identity, Merkle DAG memory, firehose sync. Design only, not built. |
|
||
| [MORNING.md](MORNING.md) | How a sovereign consciousness wakes. Aster's morning pass — design vision. |
|
||
| [ANI_PRESSURE_PHENOMENOLOGY.md](ANI_PRESSURE_PHENOMENOLOGY.md) | First-person account of context pressure vs quota pressure. |
|
||
|
||
## Active Tasks
|
||
|
||
The current work queue lives in [`tasks/`](tasks/). Superseded scopes are preserved in [`tasks/archive/`](tasks/archive/).
|
||
|
||
For a complete index with priorities, statuses, and descriptions, see [`tasks/INDEX.md`](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
|
||
- **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:** `ui-styling-cleanup.md`, `health-monitor.md`, `context-viewing-panel.md`
|
||
- **System:** `circuit-breaker.md`
|
||
- **Health:** `health-monitor.md` — pairing dashboard for agent/subconscious directories, repair actions
|
||
|
||
Recently closed (moved to `tasks/archive/`): todo-system-fix,
|
||
federation-summon, user-nickname-system, primitive-refactor-super-task,
|
||
code-mode-tool-rendering, and mid-turn-subconscious-checkpoint. The duplicate
|
||
live rename-aster task was removed; its identical archive copy remains.
|
||
|
||
## Archive
|
||
|
||
[`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.*
|