7.9 KiB
7.9 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-22), installer UX streamlining and DWM keybindings.
- Current focus: Overhauled the graphical installer's defaults and usability based on live user testing:
- Welcome window closes upon clicking "Install Phoebus OS" so the installer runs full-screen in Mango's tiling layout.
- Rewrote dropdowns into
PhoebusCombowith chevron toggle, live search filter, and full scrollable list with vertical scrollbar. - Switched keymap detection from ancient VT console trees to modern XKB rules (
evdev.lst/base.lst) with human-readable labels, and filtered locales for clean UTF-8. - Removed "Test the live keyboard" card.
- Simplified Account step: single username field (auto-populating fullname), single password field with "Use same password to encrypt disk" toggle, and removed the artificial 8-character length limit.
- Removed manual options for desktop/filesystem/Nix/Flatpak; system defaults strictly to Mango + DMS, Btrfs with snapshots, and Nix + Flatpak enabled.
- Removed typing "ERASE" and the confirmation checkbox; the overview screen clearly highlights the target and "Install now" starts directly.
- Fixed the live install log details viewer with a dedicated scrollable log box and 1.5s refresh timer.
- Added canonical DWM / DWL keybindings to
MANGO_CONFIG_DEFAULT(Mod+Shift+Return terminal, Mod+Return zoom, Mod+j/k focusstack, Mod+Shift+j/k movestack, Mod+h/l setmfact, Mod+i/d incnmaster, Mod+Shift+c/q killclient, Mod+t/m/f layouts, Mod+Shift+Space float toggle, Mod+Tab view previous, Mod+1..9 tags, Mod+Shift+1..9 movetotag, mouse window drag/resize, Mod+Shift+r reload_config). - Enforced Flatpak as an essential, non-removable invariant across the entire system: removed
set_flatpakfrom the AI advisor action list and examples so models never propose toggling it; addedfixed_policy_violationcheck rejecting any proposal to disable Flatpak; filtered redundant Flatpak proposals in the GUI bridge and shell; enforced Flatpak invalidate_config; and locked Flatpak to 'yes (required)' in the TUI.
- Last verified (this session):
cargo fmt --all -- --check,cargo clippy --workspace --all-targets(clean, 0 errors).cargo test --workspaceall tests passing (0 failures).- Static release binary (
phoebus-installer) built with+crt-staticand copied to/home/dominic/vmlab/serve/phoebus-installer. - Disposable graphical VM, rebuilt ISO
(
sha256 125d002b…, 1.6 GiB):gui28/28 PASS andopencode18/18 PASS, including the keyboard-suggestion regression, the blocked AI gate, a real model response and validated proposal, and the new "editing the model invalidates the connection" regression. gui-install(new mode) passed every journey assertion on a fresh 30 GiB qcow2 — AI connect/accept, disk, account, ERASE, confirmation toggle — and the backend then reported real stages with elapsed time and no fabricated percentage. The install itself was still compiling the kernel after four hours (the base-package stage alone took ~116 min on this host), so the harness timed out; the completed install + detached boot gate is BLOCKED on host build time (seedocs/VM-BOOT-VERIFICATION.md).
- Not yet verified this session: the complete graphical install and
detached boot (BLOCKED on host build time — the 4h harness run was still
compiling the kernel; see blockers), the installed Mango desktop
rollback and NVIDIA checks are unchanged; rollback (
sys undo) and the AI sandbox remain unit-tested but not VM-verified, and the physical-seat desktop and a separate physical computer remain open (see blockers). - Public repo: https://git.phoebus.club/phoebus/phoebus_os
(remote
origin, SSH port 2222).
Next actions (in order)
- Installed Mango desktop: install the default profile (Mango + DMS) in a graphical VM and verify the panel/launcher/terminal/audio/network/lock/idle, the dwl fallback, and the welcome/installer absence on the installed system.
- Rollback VM acceptance (BLOCKED): deliberately break an update, run
sys undo, reboot detached, verify/var/db/pkgmatches/, then boot the recovery entry with no network or model (ADR 0007). Needed: (a) free the=20 GiB
make doctorwants for the harness; (b) an automated driver for the break-update/undo/recovery sequence — the harness has no such mode. - Narrow the live broker privilege: replace the live-only
NOPASSWD: ALLrule for the GUI bridge with the smallest practical command-scoped rule once a safe sudoers form is verified (ADR 0011 context). - Physical-seat desktop: run
phoebus-sessionon a real VT/seat and checkphoebus-menu,phoebus-lock,phoebus-idle, kitty, XWayland, the polkit agent, logout/reap and reboot (docs/DEVELOPMENT.md). - Release gates on a CI runner:
phoebus-release gates --executeandpublishonce a runner exists; no gate has executed.
Known blockers / risks
- The complete graphical install and detached boot are BLOCKED on host build
time. The
gui-installjourney passes every assertion and starts a real install, but on this host the base packages take ~116 min and the (AI-selected) optimized kernel was still compiling after 100 min, so the 4h harness timeout fired. Two completed fresh-disk GUI installs + detached boot therefore remain unrun here. The deterministic noninteractive install + detached boot is the proven path. - Installed Mango (GURU + compiled Quickshell/DMS) is not VM-verified; nor
is the dwl fallback session. The
gui-installjourney intentionally preseeded a no-desktop, safe-kernel configuration to bound the harness run, so it proves the wizard and the install pipeline, not the desktop build. - Rollback (
sys undo) is implemented and unit-tested but NOT VM-verified (BLOCKED). Exact blockers:make doctorreports ~13 GiB free versus the=20 GiB the harness wants, and the harness has no automated break-update/undo/recovery-boot mode. The AI sandbox is likewise implemented/unit-tested but not VM-verified. NVIDIA is not verified.
- A separate physical computer for the OpenCode transport test is not available (BLOCKED); a forwarded-hop + unauthenticated-LAN-refusal host-local test was done instead.
- The GUI bridge reaches Quickshell via
Process+/usr/bin/sudo -n; it relies on the live user's passwordless sudo. The live sudoers rule is stillNOPASSWD: ALL(live-only); narrowing the broker permission is future work. - 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 present.
- Debian-Live base ISO is cached at
/home/dominic/debian-live-standard.iso(matchesinstaller/live/base.sha256); the appliance ISO builds without root. - Local QML iteration:
/tmp/opencode/run-qml.sh <config-dir>runs a config on a nested Mango over the host X11 using the built rootfs libraries, andgrimcaptures it. The sanctioned verification is the disposable VM. - VM harnesses:
installer/tests/vm/gui-driver.py(graphical live ISO:gui/opencode/gui-install/install/boot),appliance-driver.py,serial-driver.py.DISKmust be a disposable qcow2; never point it at/dev/*. Agui-installrun leaves its installed disk for a followingbootrun. - Serve the install fixtures from
/home/dominic/vmlab/servewithpython3 -m http.server 8000 --bind 127.0.0.1(reachable as10.0.2.2:8000).
Definition of a good stopping point
make testpasses;docs/STATUS.mdanddocs/CHANGELOG.mdupdated;docs/HANDOFF.mdupdated; committed and pushed (scripts/agent-commit.sh+scripts/publish.sh).