Watch
1
0
Fork
You've already forked SouveraineOS
0
SouveraineOS/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Fimeg 7086b4a41e atmosphere: correct the seam, and name whose instrument this is
The shader half landed (viewtop 5d6f0f0, smithay 48adf6f) — dissonance is a
verb, the clock is shared with the dim, nobody has seen it on the panel.

Three corrections that came from opening the tree instead of the assessment:

The reference compositor has no post-process pass and no patched texture
shader. Windows are external textures inside the Flutter scene, so effects are
scene-graph filters — and their backdrop widget carries the grouped-blur rule
and a bounded ImageFilterConfig that are engine API, not stock Flutter. The
expensive half of #2 is already written upstream of us.

Our clone of it is 64 commits stale and they moved to Impeller as the default
renderer, so the eleven-patch DMSAA series our pins inherit is now a question
rather than an asset.

And atmosphere is not a thing this task invents. FELT_STATE_ARCHITECTURE.md has
had fourteen presets and a tool she calls since May. This is that instrument
moved down the stack, which means the preset layer is the deliverable and the
fifteen techniques are its renderer. Mood stays underived — the gap between what
she shows and what she carries is load-bearing.
2026-08-15 21:07:43 -04:00
..
archive docs: checkpoint device and system state 2026-08-10 17:00:23 -04:00
davids-tasks docs: record SLIMbus v1 submission 2026-08-07 20:40:16 -04:00
souveraine-components docs: give Membrane its boundary 2026-08-13 17:46:49 -04:00
substrate docs: give Membrane its boundary 2026-08-13 17:46:49 -04:00
tasks atmosphere: correct the seam, and name whose instrument this is 2026-08-15 21:07:43 -04:00
AUDIO-PRIVACY.md docs: checkpoint device and system state 2026-08-10 17:00:23 -04:00
DEVICE-STATE-MACHINE.md state: charge is a sensor source, and the laptop is moving to viewtop 2026-08-15 11:45:28 -04:00
DUMP-bugs-2026-08-06.md 59/60 and the bug dump: what landed the day her face went on the glass 2026-08-07 02:29:37 -04:00
DUMP-fingerprint-2026-08-09.md dump: fingerprint handoff, and the protocol is recovered 2026-08-09 10:01:51 -04:00
DUMP-keyboards-2026-07-29.md correct the graphical-session.target claim 2026-08-15 10:55:25 -04:00
DUMP-packages-publish-2026-07-30.md mark package stranding resolved (TASK-25) 2026-07-30 13:57:00 -04:00
DUMP-taskdocs-2026-08-14.md correct the graphical-session.target claim 2026-08-15 10:55:25 -04:00
FEDERATION.md federation: instance awareness live half landed (hosted_agents in announce) 2026-07-16 11:18:25 -04:00
FIRST-CLASS-APPS.md docs: fold the stranded device tasks, archive the handoffs, one index per tree 2026-07-26 12:33:03 -04:00
HOW-IT-WORKS.md SouveraineOS umbrella: docs, dumps, handoffs, cross-repo STATE 2026-07-16 08:59:26 -04:00
INTERFACE-ARCHITECTURE.md SouveraineOS umbrella: docs, dumps, handoffs, cross-repo STATE 2026-07-16 08:59:26 -04:00
LOCK-DPMS-LESSONS.md lock-dpms: waking is the machine's, and the compositor must not do it itself 2026-08-02 17:37:51 -04:00
provisioning-gaps.md provisioning-gaps: log every hand-fill from the first federation test 2026-07-16 16:11:15 -04:00
README.md docs: set the shared-state authority spine 2026-08-10 20:09:54 -04:00
REFERENCE-EXTRACTION.md SouveraineOS umbrella: docs, dumps, handoffs, cross-repo STATE 2026-07-16 08:59:26 -04:00
SECURITY-AUDIT.md docs: correct three claims that were false, in place 2026-08-03 15:31:56 -04:00
session-authority-boot-order.md file task 76: nothing owns provisioning 2026-08-15 09:57:51 -04:00
SESSION-AUTHORITY-DOCTRINE.md doctrine: §13 — the verb table and refusal codes are built 2026-07-26 13:01:37 -04:00
SESSION-TRUST-ARCHITECTURE.md SouveraineOS umbrella: docs, dumps, handoffs, cross-repo STATE 2026-07-16 08:59:26 -04:00
SETTINGS-APP-PLAN.md SouveraineOS umbrella: docs, dumps, handoffs, cross-repo STATE 2026-07-16 08:59:26 -04:00
SETTINGS-AUTHORITY.md docs: fold the stranded device tasks, archive the handoffs, one index per tree 2026-07-26 12:33:03 -04:00
SHARED-STATE-ARCHITECTURE.md docs: set the shared-state authority spine 2026-08-10 20:09:54 -04:00
SHELL-ECOSYSTEM.md docs: fold the stranded device tasks, archive the handoffs, one index per tree 2026-07-26 12:33:03 -04:00
SHELL-SURFACES.md docs: give Membrane its boundary 2026-08-13 17:46:49 -04:00
STORAGE-ENCRYPTION.md docs: reconcile USB, Waydroid, audio and charging 2026-08-07 14:52:28 -04:00
TRUST-BOUNDARY-MATRIX.md SouveraineOS umbrella: docs, dumps, handoffs, cross-repo STATE 2026-07-16 08:59:26 -04:00
VIEWTOP-AND-DENIAL.md viewtop: assess denial as the base; the lock model is the one thing we cannot take 2026-07-28 13:41:37 -04:00
WAYDROID.md docs: reconcile USB, Waydroid, audio and charging 2026-08-07 14:52:28 -04:00

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), §1011 (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 (P1P7 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.