Rework the graphical installer into a fixed first-time-user sequence (Welcome, Language and keyboard, Internet and readiness, AI connection, Destination disk, Account and encryption, Review and confirmation, Installation, Completion) with configuration, validation, plans, approval and execution still authoritative in Rust. Fix the audited interaction defects: readiness `Re-check` is a read-only probe that no longer resets the step or clears the disk; model catalogs are fetched after syncing the edited settings and credentials and stale replies are ignored; editing a connection field invalidates the validated state; suggestion lists support arrow/Enter/Escape with a visible highlight and accessibility; the keyboard step labels the live-session limitation truthfully; readiness separates the local link from reachable install services; and busy states always clear, with the bridge failing outstanding requests when the backend exits. Add human-readable language/keyboard names, an explicit AI change review (Accept/Discard), backend-fact review with edit links, real stage progress with elapsed time and activity, and clearer failure and completion guidance. Extend the VM harness with a `gui-install` mode that drives the whole journey through the visible controls, plus regressions for readiness refresh, disk survival, keyboard suggestion selection and AI invalidation. Add Rust tests for readiness, the network probe, error kinds and labels.
189 lines
11 KiB
Markdown
189 lines
11 KiB
Markdown
# Status
|
|
|
|
Truthful implementation/verification matrix. Vocabulary:
|
|
|
|
- **Implemented** — code exists.
|
|
- **Unit tested** — covered by automated tests that run on any host.
|
|
- **VM verified** — exercised in the disposable QEMU/OVMF VM.
|
|
- **Hardware verified** — exercised on real hardware.
|
|
- **Not verified** — do not claim it works.
|
|
|
|
## Proven baseline (do not regress)
|
|
|
|
A complete installation in a disposable UEFI VM, booted with the ISO detached:
|
|
|
|
```
|
|
QEMU + OVMF (UEFI)
|
|
30 GiB qcow2, virtio-blk (/dev/vda); live ISO at /dev/sr0
|
|
GPT: 1 GiB FAT32 ESP + LUKS2 remainder
|
|
Btrfs: @ @home @var @snapshots @swap
|
|
Gentoo systemd stage3 (default/linux/amd64/23.0/systemd)
|
|
systemd-boot + BLS entry + dracut initramfs
|
|
LUKS2 passphrase unlock at boot
|
|
systemd PID 1, login, networking
|
|
systemctl is-system-running = running; 0 failed units
|
|
```
|
|
|
|
Boot timing (Rust installer): 1.378 s kernel + 5.238 s initrd + 4.114 s
|
|
userspace = 10.730 s.
|
|
|
|
The committed VM harness (`installer/tests/vm/serial-driver.py` +
|
|
`install.sh`) drives the **static Rust binary**; the Bash installer is no longer
|
|
on the install path (Bash migration Phase 2, see
|
|
`docs/VM-BOOT-VERIFICATION.md`).
|
|
|
|
A second harness (`installer/tests/vm/appliance-driver.py` +
|
|
`appliance-guest.sh`) drives the Debian-Live appliance ISO. On 2026-09-21 it
|
|
produced `INSTALL-RC=0`, `NO_SECRET_LEAK`, and a detached boot
|
|
(`systemd`, running, 0 failed units) whose Btrfs history contains the installer's
|
|
coordinated `@` + `@var` **initial known-good** snapshot and a snapshot-based
|
|
recovery boot entry (see `docs/VM-BOOT-VERIFICATION.md`). `sys undo` itself is
|
|
still not VM-verified.
|
|
|
|
## Matrix
|
|
|
|
| Area | Implemented | Unit tested | VM verified | Hardware verified |
|
|
|------|-------------|-------------|-------------|-------------------|
|
|
| Config (TOML + legacy), validation | yes | yes | yes | n/a |
|
|
| Hardware/disk discovery, protection | yes | yes | yes | no |
|
|
| Install plan + destructive preview | yes | yes | yes | n/a |
|
|
| Destructive authorization (ERASE) | yes | yes | yes | n/a |
|
|
| GPT partitioning + ESP | yes | yes | yes | no |
|
|
| LUKS2 format/open/close | yes | yes | yes | no |
|
|
| Btrfs subvolumes + swapfile | yes | yes | yes | no |
|
|
| fstab / crypttab generation | yes | yes | yes | no |
|
|
| stage3 fetch + SHA-256 verify + extract | yes | yes | yes | n/a |
|
|
| Portage config + sync + getuto | yes | yes | yes | n/a |
|
|
| Signed Gentoo binary install | yes | yes | yes | n/a |
|
|
| Source package compilation | yes | yes | yes | n/a |
|
|
| Kernel install + dracut initramfs | yes | yes | yes | no |
|
|
| systemd-boot + BLS | yes | yes | yes | no |
|
|
| Boot default pins the real kernel (not recovery) | yes | yes | yes | no |
|
|
| Recovery BLS entry (rescue.target) | yes | yes | boots (not default) | no |
|
|
| Users, passwords, sudo | yes | yes | yes | n/a |
|
|
| Locale/timezone/keymap/services | yes | yes | yes | n/a |
|
|
| Rust VM boot parity | yes | yes | yes | no |
|
|
| Rust TUI | yes | yes | smoke test | no |
|
|
| Typed GUI bridge (`--gui-bridge`) | yes | yes (dry-run) | live VM + full journey | n/a |
|
|
| Graphical welcome + install wizard (Quickshell) | yes | yes | live graphical VM + full GUI journey | no |
|
|
| Phoebus brand system (SVG + tokens) | yes | yes | live VM | n/a |
|
|
| Desktop profile (dwl/waybar/mako/swaybg) | yes | partial | headless only | no |
|
|
| Desktop session script (socket wait, polkit, cleanup) | yes | yes | functional test (stubs) | no |
|
|
| PipeWire/WirePlumber | yes | no | headless (`wpctl`) | no |
|
|
| Flatpak + flathub | yes | no | installed + remote | no |
|
|
| XWayland / polkit agent / kitty / wofi | yes | no | installed, not launched | no |
|
|
| Package policy + measured history | yes | yes | yes (326 entries) | no |
|
|
| Background update preparation | yes | yes | yes (fetch; buildpkgonly skipped) | no |
|
|
| Btrfs snapshots + history | yes | yes | yes | no |
|
|
| Coordinated snapshot sets (`@` + `@var`) | yes | yes | no | no |
|
|
| Btrfs rollback (`sys undo`) | yes | yes | no | no |
|
|
| Recovery/known-good BLS entry | yes | yes | no | no |
|
|
| Snapshot retention + free-space gate | yes | yes | no | no |
|
|
| AI typed proposals + evidence review | yes | yes | fixture end-to-end | n/a |
|
|
| AI guided install (DeepSeek/OpenAI) | yes | yes | fixture path only (no live call) | n/a |
|
|
| AI privacy boundary (facts only) | yes | yes | no | n/a |
|
|
| AI OS sandbox (systemd hardened unit) | yes | yes | no | no |
|
|
| Installed assistant (`sys ask`) | yes | yes | fixture path only (no live call) | n/a |
|
|
| Resolved package effects + approval binding | yes | yes (empty vs unestablished) | no | n/a |
|
|
| Transaction log (outcomes, protective snapshots) | yes | yes | no | no |
|
|
| Flatpak/Nix bounded typed actions | yes | yes | no | no |
|
|
| `sys` consistent target-root execution | yes | yes | no | no |
|
|
| `sys` validation at the execution boundary | yes | yes | no | n/a |
|
|
| `sys ask` truthful failure (nonzero, stop, record) | yes | yes | no | n/a |
|
|
| Service start/stop/restart + flatpak/nix/snapshot commands | yes | yes | no | no |
|
|
| Desktop session helpers (menu/lock/idle) | yes | yes | functional test (stubs) | no |
|
|
| Mango + DankMaterialShell profile | yes | yes | live graphical VM yes; installed no | no |
|
|
| Mango is the default desktop | yes | yes | live graphical VM yes; installed install pending | no |
|
|
| greetd login (Mango default, dwl fallback) | yes | yes | no | no |
|
|
| Live desktop ISO (Mango + DMS) | yes | guards tested | graphical VM + GUI journey + detached boot | no |
|
|
| Live welcome autostart + duplicate prevention | yes | guards tested | live graphical VM | no |
|
|
| Welcome primary action keyboard-focus | yes | guards tested | live graphical VM | no |
|
|
| VM harness disk safety + structured results | yes | yes (16 tests) | n/a | n/a |
|
|
| Target disk revalidation before partition | yes | yes | no | n/a |
|
|
| Bridge replay/concurrency + input bounds | yes | yes | no | n/a |
|
|
| Provider transport endpoint/size hardening | yes | yes | no | n/a |
|
|
| `TargetRoot` symlink-escape guard | yes | yes | n/a | n/a |
|
|
| OpenCode server capability probe | yes | yes | real host probe + auth + policy | n/a |
|
|
| OpenCode proposal adapter (real inference) | yes | yes | real model (`deepseek-v4-flash`) | n/a |
|
|
| OpenCode in GUI / CLI / `sys ask` | yes | yes | GUI AI step + `sys ask` live | n/a |
|
|
| OpenCode full graphical install | yes | yes | full GUI journey through ERASE + backend stages | n/a |
|
|
| GUI readiness refresh / AI revalidation / keyboard nav | yes | yes (Rust) | VM harness regressions | n/a |
|
|
| Mandatory AI requires a validated interaction | yes | yes | bridge + CLI | n/a |
|
|
| GURU packaging (scoped keywords) | yes | yes | no (build/install unverified) | no |
|
|
| Release gates + atomic publish | yes | yes | no | n/a |
|
|
| `sys` verbs | yes | yes | yes | no |
|
|
| OpenCode pinned bootstrap | yes | yes | no | n/a |
|
|
| Release manifest/verify | yes | yes | no | n/a |
|
|
| NVIDIA proprietary | architecture only | no | no | no |
|
|
| UKI | no (deferred) | no | no | no |
|
|
|
|
## Known limitations
|
|
|
|
- **Desktop graphical session** was verified with the *headless* wlroots
|
|
backend because the serial-only VM has no logind seat. The DRM path and a
|
|
real VT login are not yet exercised. `phoebus-session` is written by the
|
|
installer for that purpose.
|
|
- **Flatpak apps** were not installed from the remote; only the runtime and
|
|
the flathub remote were verified.
|
|
- **NVIDIA** is architecturally allowed but not verified on hardware.
|
|
- **UKI** is deferred; the dracut UKI generator did not embed the kernel
|
|
command line, so BLS is used (and verified).
|
|
- **Rollback is NOT VM-verified.** It is implemented and unit-tested end to end
|
|
at the command/text layer (snapshot sets, root/var generation, fstab and BLS
|
|
rewriting, kernel selection, interruption resume, retention, free-space
|
|
gate), but the destructive acceptance test (deliberately broken update ->
|
|
`sys undo` -> detached reboot -> package-state check -> recovery with no
|
|
network/model) was **not run in this session**. Blockers: (1) `make doctor`
|
|
reports only ~13 GiB free versus the >=20 GiB the VM harness wants, and the
|
|
root filesystem has ~12 GiB free; (2) the committed appliance/serial harness
|
|
only implements `install` and `boot` modes — there is no automated driver for
|
|
the break-update / `sys undo` / recovery-boot sequence, which is documented as
|
|
an interactive procedure. `sys undo` is present; treat VM verification as the
|
|
gate before relying on it.
|
|
- **Mango + DankMaterialShell** is the default desktop
|
|
(`desktop.profile = "mango"`, Flatpak on). It is implemented with Mango
|
|
0.17.2, DMS (pinned release), Quickshell 0.3.1 and scenefx 0.5 from the GURU
|
|
overlay, a dwl fallback session and scoped `~amd64` keywords. The default is
|
|
set by explicit owner decision; it has not been installed or booted in a
|
|
graphical VM, so **no desktop stability is claimed**. `docs/STATUS.md`
|
|
distinguishes "default in configuration", "successfully built" and
|
|
"graphically verified".
|
|
- **The live desktop ISO** (`installer/live/build.sh`) builds a Debian testing
|
|
rootfs with Mango + DMS, live-only autologin, a branded welcome window and a
|
|
graphical installer frontend over the typed bridge. Its desktop-payload
|
|
guards are unit-tested. The rebuilt ISO
|
|
(`sha256 428dbd75…`, 1.6 GiB, build id in `/etc/phoebus/build`) was booted in
|
|
a graphical, seat-providing VM and the automated `gui` journey passed
|
|
**23/23** checks: the welcome window opened automatically, "Install Phoebus
|
|
OS" launched the installer from the keyboard, a second launch created no
|
|
duplicate, the live medium was reported protected, keyboard navigation
|
|
reached the network and AI steps, and advancing without a connected model was
|
|
refused. An earlier appliance build of the same code path was installed
|
|
non-interactively (`INSTALL-RC=0`, `NO_SECRET_LEAK`) and booted **with the
|
|
ISO detached** (systemd running, 0 failed units, LUKS2, all Btrfs subvolumes,
|
|
network). A live AI provider call was **not** possible (no key and no local
|
|
model in this environment), so the **full graphical install past the AI step**
|
|
is not claimed; the AI step is verified as a blocked prerequisite and with a
|
|
fixture transport in unit tests. The **installed** Mango system (GURU +
|
|
compiled Quickshell/DMS) and the dwl fallback in a VM are not yet verified.
|
|
- **AI sandbox** is implemented (`systemd-run` hardening properties, tested at
|
|
the argv level) and fails closed without `systemd-run`; it has not been
|
|
exercised in a VM. Only typed actions and the privacy boundary were previously
|
|
enforced.
|
|
- **Release automation** now has gates, a report, atomic publish and signing
|
|
command helpers, but no gate has been executed by a configured CI runner; the
|
|
report records unexecuted gates as `NotRun`.
|
|
- The desktop transaction compiles heavily because desktop USE does not match
|
|
the signed binhost (~26 min for the desktop set on 8 vCPUs in the test VM).
|
|
The official Gentoo binhost is OpenRC/hardened, so a systemd system can only
|
|
reuse binaries for packages whose USE matches; the policy still requests
|
|
signed binaries where it can. Publishing a matching binhost is future work.
|
|
- **Live AI provider calls are not verified.** DeepSeek/OpenAI requests are
|
|
built and reviewed by fixtures (`phoebus-ai::provider::TestTransport`) and the
|
|
curl transport is covered by a recording runner; no call was made with a real
|
|
key.
|
|
- The installer rebuilds `sys-apps/systemd` from source because
|
|
boot/policykit/cryptsetup USE differ from the binhost.
|
|
- `sys undo` is implemented with the default-subvolume, fstab, kernel-cmdline
|
|
and BLS handling described in ADR 0007; its destructive VM acceptance test is
|
|
the remaining safety gate.
|