phoebus_os/docs/adr
Phoebus 3b1b54ffb9
Some checks are pending
ci / test (push) Waiting to run
docs: reconcile NVIDIA, verification and harness status
Record the reliability pass across STATUS, HANDOFF, CHANGELOG, ADR 0012,
the live README and the boot-verification log: the deterministic live GPU
decision with a real nouveau fallback, the 580 legacy cap and mixed
open/proprietary incompatibility, the compatibility verifier, the
installed lifecycle fix, the repaired GUI harness, the automated but
unrun rollback gate, and the scoped live sudoers. Withdraw the stale
handoff claim that the gui_bridge tests hang (the workspace suite
passes) and record the installed-target missing-sys gap.
2026-09-23 06:28:30 -07:00
..
0001-rust-installer.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0002-bls-over-uki.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0003-desktop-systemd-profile.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0004-portage-verify-keyring.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0005-debian-live-appliance.md feat(desktop): make Mango + DankMaterialShell the default and build a live desktop ISO 2026-09-21 06:47:22 -07:00
0006-package-lanes.md feat(desktop): add Mango + DankMaterialShell profile with rollback, assistant and release foundations 2026-09-21 03:46:52 -07:00
0007-coherent-rollback.md feat(desktop): add Mango + DankMaterialShell profile with rollback, assistant and release foundations 2026-09-21 03:46:52 -07:00
0008-nix-isolation-lifecycle.md feat(desktop): add Mango + DankMaterialShell profile with rollback, assistant and release foundations 2026-09-21 03:46:52 -07:00
0009-mango-dankmaterialshell-desktop.md feat(desktop): make Mango + DankMaterialShell the default and build a live desktop ISO 2026-09-21 06:47:22 -07:00
0010-graphical-installer-frontend.md feat(installer): graphical welcome and install wizard over a typed bridge 2026-09-21 13:13:40 -07:00
0011-opencode-connection-boundary.md feat(gui): select and validate OpenCode from the installer 2026-09-22 02:36:36 -07:00
0012-nvidia-driver-policy.md docs: reconcile NVIDIA, verification and harness status 2026-09-23 06:28:30 -07:00
README.md feat(nvidia): hardware-driven driver policy, installed integration and live payload 2026-09-22 21:53:28 -07:00

Architecture Decision Records

Short records of significant decisions, so a new session understands why rather than only what. Add a new numbered file for each meaningful decision and link it here.

ADR Title Status
0001 Rust installer as production; Bash retained as reference Accepted
0002 BLS entries instead of UKI for the boot path Accepted
0003 Desktop installs inherit the Gentoo desktop/systemd profile Accepted
0004 Relax the getuto keyring for the dropped-privilege verifier Accepted
0005 Debian-Live appliance ISO with a Gentoo target Accepted
0006 Package lanes — Portage, Flatpak, and Nix (built in) Accepted
0007 Coherent rollback and recovery Accepted
0008 Nix lifecycle, build isolation, and packaging Accepted
0009 Mango + DankMaterialShell desktop option Accepted
0010 Graphical installer frontend and typed bridge Accepted
0011 OpenCode connection boundary Accepted
0012 NVIDIA accelerated-driver policy and payload Accepted

Format: Context / Decision / Consequences / Status.