Fimeg/SouveraineOS
Watch
1
0
Fork
You've already forked SouveraineOS
 0
Code Releases Activity
No description
148 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 e46c6588c2 TASK-43: viewtop is the session compositor 
greetd launches it, Hyprland does not run, the shell's whole surface tree
composites on it. Points at the session record in the viewtop repo rather
than restating it here.

Steps 1-2 of the build order are done and step 3 is half done; the live
gap list lives with the code.
2026-08-02 14:03:36 -04:00
blueline blueline: move wifi-bringup to Pixel3Arch rootfs-overlay 2026-08-01 13:16:45 -04:00
docs TASK-43: viewtop is the session compositor 2026-08-02 14:03:36 -04:00
PAF PAF: bring the blueline architecture framework into SouveraineOS 2026-07-24 11:04:07 -04:00
tools tools: read CI outcomes from the API, and do it automatically 2026-07-28 17:38:44 -04:00
CLAUDE.md CLAUDE.md: the umbrella repo had none 2026-07-30 19:13:34 -04:00
STATE.md TASK-43: touch served; next lane is KMS on device 2026-08-02 08:56:05 -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

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