Some checks are pending
ci / test (push) Waiting to run
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.
7.7 KiB
7.7 KiB
Handoff
Rolling note between work sessions. Update this file before you finish, then
commit it. It should be short and current; use git log for detail.
- Last updated: this session (2026-09-23), NVIDIA reliability and verification pass: live driver decision, verifier hardening, installed lifecycle, rollback harness, GUI harness repair, scoped live privilege.
- Current focus:
- Deterministic live NVIDIA decision.
phoebus-installer --live-gpu-planclassifies the actual PCI display controllers against the bundled branch and returnsload-nvidia/nouveau-fallback/no-device/disabled; the old0x10de-vendor grep is gone. An unsupported GPU (or a failed load) explicitlymodprobesnouveau, and the fail-safe entry setsnomodeset phoebus.nvidia=offwhich the script and unit both honour. - Live payload gate is a compatibility gate. It rejects placeholder
modules/libraries, requires registration in the live kernel's
modules.dep, matches userspace/firmware versions to the bundled driver, infers and checks the module flavor, and requires the exactetc/modprobe.d/phoebus-nvidia.conf(now produced bybuild.sh). - Branch boundary corrected. Maxwell/Pascal/Volta are capped at the last
supporting series (580) instead of
<595; a Blackwell plus proprietary-only GPU is reported as an explicit incompatibility. - Installed lifecycle. The NVIDIA
force_driversfragment is written only after the driver exists; the installer proves the modules built for a kernel and records the real version/kernel/module names. - GUI harness repaired for the six-step installer (no step 0, no ERASE, no confirmation toggle, single-password account); state-based step navigation; boot uses the single-password disk passphrase.
- Rollback acceptance automated as
serial-driver.py rollback. - Live privilege scoped:
NOPASSWDonly for the two typed brokers andsystemctlpower actions; the recovery console uses the live password.
- Deterministic live NVIDIA decision.
- Last verified (this session):
cargo fmt --all -- --check,cargo clippy --workspace --all-targets(0 errors) andcargo test --workspaceall pass. Thegui_bridgedry-run tests do not hang on this checkout: the earlier "block" note was stale and is withdrawn.installer/tests/vm/test_vmsafety.py(18 tests) passes, includingbash -nover every guest script.- Py-compile clean for
gui-driver.py,serial-driver.py,live-driver.py. - The emitted live sudoers policy is validated with host
visudoin a unit test and at build time. - New coverage:
live_nvidia_plandecisions, sysfs device scan + CLI fixtures, mixed-hardware incompatibility, verifier negatives (placeholders, stalemodules.dep, version/flavor mismatch, missing final config), installed module proof + version record, and the ordering fix.
- Not yet verified this session (unchanged blockers): the full desktop
live ISO is still not assembled (host has ~12 GiB free;
make doctorwants=20 GiB), so the
gui/opencode/gui-installjourneys were not re-run against the repaired harness, and the NVIDIA live/installed boot gates are unrun (no NVIDIA GPU). The rollback harness is written and unit-checked but its destructive VM gate is unrun.sysis not installed into the target (see below). - Public repo: https://git.phoebus.club/phoebus/phoebus_os
(remote
origin, SSH port 2222).
Next actions (in order)
- Run the repaired GUI harness once disk allows:
gui,opencode, thengui-install+ detachedboot. It now expects the six-step flow and the direct "Install now" action. Servelive.pw(0600) alongsidetest.conf,luks.pwanduser.pwfor thegui-installpreseed. - NVIDIA hardware acceptance (BLOCKED): on a machine with an NVIDIA GPU
boot the live ISO and the installed system and confirm the accelerated stack,
nvidia_drmmodeset, Mango/DMS acceleration, XWayland/Flatpak, and a kernel update that rebuilds the modules and initramfs. Needs an NVIDIA GPU. - Rollback VM acceptance (BLOCKED on disk + a clone): create an installed
disposable clone, then
serial-driver.py rollback. The gate and the exact evidence markers are implemented; it has not executed. - Install
sysinto the target: the installed system still lacks the deterministic CLI, so the no-model fallback contract is only partially shipped. This blocks a pure product-path rollback test. - Live ISO build + verify (BLOCKED on disk):
installer/live/build.shnow also emits andvisudo-validates the scoped sudo policy and produces the live NVIDIA config. Free space and run theguiharness. - Installed Mango desktop: install the default profile in a graphical VM and verify panel/launcher/terminal/audio/network/lock/idle and the dwl fallback; a no-desktop run is a separate baseline.
- Release gates on a CI runner:
phoebus-release gates --executeandpublishonce a runner exists; no gate has executed.
Known blockers / risks
- Disk is the harness constraint.
make doctorreports ~12 GiB free versus the >=20 GiB the VM harness wants. This blocks assembling the full desktop ISO and the rollback acceptance run. Do not delete unrelated files. - No NVIDIA GPU (and no authorised passthrough): actual acceleration cannot be verified here. The live decision and verifier are device-based and unit/fixture-tested only.
sysis absent from the installed target. The live medium and thephoebus-assistantlauncher usesys, and the rollback harness fetches it from the host, but the installed system has no/usr/local/bin/sys. Fixing it (embedding the staticsysbinary in the install) is future work.- The
gui-installcompletion is still host-time bound: the base package stage took ~116 min and the AI-selected kernel was still compiling at the 4 h timeout. The deterministic noninteractive install + detached boot remains the proven path. - Installed Mango (GURU + compiled Quickshell/DMS) and the dwl fallback are still not VM-verified.
- Recovery-entry offline boot is not automated: the rollback harness records the snapshot recovery entry but does not select it in the bootloader.
- The live appliance guest scripts (
appliance-guest.sh,appliance-guest-gui.sh) still usesudo -n/poweroffand a/run/live/medium/phoebus/bin/phoebuslauncher path; they predate the scoped policy and would need the live password if re-run against the narrowed image. - Harness artifacts live under
/var/tmp/phoebus-vm/(outside git):results.json,screenshot-manifest.json,report.html, screenshots.
Environment notes
- Dev host: Ubuntu 26.04. QEMU/OVMF/xorriso/rustfmt/clippy/ImageMagick/visudo present. ~12 GiB free on the root filesystem.
- Debian-Live base ISO is cached at
/home/dominic/debian-live-standard.iso(matchesinstaller/live/base.sha256). - VM harnesses:
installer/tests/vm/gui-driver.py(gui/opencode/gui-install/install/boot),serial-driver.py(install/boot/rollback),appliance-driver.py,live-driver.py.DISKmust be a disposable qcow2; never point it at/dev/*. - Serve fixtures from
/home/dominic/vmlab/servewithpython3 -m http.server 8000 --bind 127.0.0.1(reachable as10.0.2.2:8000), includinglive.pwfor thegui-installpreseed androllback-guest.sh,rollback-verify.shandsysfor the rollback mode.
Definition of a good stopping point
make testpasses;docs/STATUS.mdanddocs/CHANGELOG.mdupdated;docs/HANDOFF.mdupdated; committed (viascripts/agent-commit.sh) and pushed (scripts/publish.sh).