- Python 86.4%
- C 8.4%
- Shell 5.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
d9e6043e9b
Sidebar right verified and owned as of b8e76c4 in souveraine. Garden moved from notification card to drawer tab. Lens events emit through notify-send. Only toggle dialogs still borrow from ii. |
||
| .gitea/workflows | ||
| blueline | ||
| devices | ||
| distribution | ||
| docs | ||
| project-state | ||
| saf | ||
| tools | ||
| USB | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| HANDOFF-2026-08-05-navigation.md | ||
| HANDOFF-2026-08-09-power-authority.md | ||
| HANDOFF-2026-08-10-d10.md | ||
| START-HERE.md | ||
SouveraineOS — docs
The map is
saf/INDEX.md— read it first. This directory is the older doctrinal set; the SAF spine owns the living architecture and is reached from the index.
Two subjects live here, and the split is real:
- this directory — the device. Session authority, lock, power, sensors, shell, packaging, hardware.
substrate/— the agent. Consciousness, memory, sensorium, felt state, federation transport, TUI. Rescued 2026-07-26 out of a gitignored directory on a full disk; read its README before trusting anything in it.
The device — read in this order
The distribution. ../distribution/ — the canonical
body, package, installer-profile, and release graph. Component repositories
build the declared pieces; they do not define the OS.
Why. SESSION-AUTHORITY-DOCTRINE.md —
§13 first (who owns the device), then §4 (never hold state the protocol owns),
§9 (sensors are evidence), §10–11 (one authority).
What is built. DEVICE-STATE-MACHINE.md — the
unified machine: the audit that found each bug, the evidence model, the error
contract, prior art, source health, and the trail.
What is true of the hardware.
LOCK-DPMS-LESSONS.md — ordering, the FTS controller,
suspend, with receipts.
Contracts and status. SESSION-TRUST-ARCHITECTURE.md
(the contract), TRUST-BOUNDARY-MATRIX.md
(what is actually gated), SECURITY-AUDIT.md (P1–P7 and
the threat register), souveraine-components/ (the
authority binaries and their audit ladder).
Shared state. SHARED-STATE-ARCHITECTURE.md
is the design of record for household tasks, calendar, contacts, and their
sync. Culver is a Personal-class client; Culver/machined owns identity and
admission; the shared-state service owns the canonical event trail and local
projection; QML only renders it. Loro is an offline merge substrate, never an
authority.
Designs of record. STORAGE-ENCRYPTION.md,
WAYDROID.md, ../USB/README.md,
FEDERATION.md,
session-authority-boot-order.md.
The shell and its apps. FIRST-CLASS-APPS.md (the
nine requirements), SHELL-ECOSYSTEM.md (layer registry,
manifests, guarded methods — the substrate doctrine §13's chaining needs),
SETTINGS-AUTHORITY.md,
AUDIO-PRIVACY.md,
INTERFACE-ARCHITECTURE.md (intent),
HOW-IT-WORKS.md (current wiring),
REFERENCE-EXTRACTION.md (what to steal from whom),
SETTINGS-APP-PLAN.md.
Work. tasks/README.md is the index. Single-session
units, numbered. Fewer files, not more — a finding goes in the doc that owns
the subject.
archive/ is superseded material kept as evidence. It is not
authoritative and it is not deleted.
The rule that governs all of it
Where a doc and the code disagree, the code is right — fix one or the other in the same change, and never leave a third story.