Fimeg/SouveraineOS
Watch
1
0
Fork
You've already forked SouveraineOS
 0
Code Releases Activity
No description
204 commits 1 branch 0 tags 2.4 MiB
  • Python 86.4%
  • C 8.4%
  • Shell 5.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Fimeg 6cc89ef25c docs: checkpoint device and system state
2026-08-10 17:00:23 -04:00
.gitea/workflows distribution: establish the OS release contract 2026-08-10 16:53:18 -04:00
blueline blueline: move wifi-bringup to Pixel3Arch rootfs-overlay 2026-08-01 13:16:45 -04:00
devices devices/d10: the panel cannot sleep, and both ends are blueline-shaped 2026-08-09 22:33:23 -04:00
distribution distribution: establish the OS release contract 2026-08-10 16:53:18 -04:00
docs docs: checkpoint device and system state 2026-08-10 17:00:23 -04:00
PAF docs: checkpoint device and system state 2026-08-10 17:00:23 -04:00
tools distribution: establish the OS release contract 2026-08-10 16:53:18 -04:00
USB docs: reconcile USB, Waydroid, audio and charging 2026-08-07 14:52:28 -04:00
AGENTS.md docs: checkpoint device and system state 2026-08-10 17:00:23 -04:00
CLAUDE.md docs: checkpoint device and system state 2026-08-10 17:00:23 -04:00
HANDOFF-2026-08-05-navigation.md compositor pushes the strip; float, gamma 2026-08-05 19:16:41 -04:00
HANDOFF-2026-08-09-power-authority.md docs: checkpoint device and system state 2026-08-10 17:00:23 -04:00
HANDOFF-2026-08-10-d10.md HANDOFF 2026-08-10: the d10, dark and untouchable 2026-08-09 22:38:05 -04:00
START-HERE.md devices/: a support matrix per body 2026-08-09 22:30:29 -04:00
STATE.md dump: fingerprint handoff, and the protocol is recovered 2026-08-09 10:01:51 -04:00

docs/README.md

SouveraineOS — docs

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).

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.