From bdec0bdfe8d2cacd8089e280291a4851d2ecf7ea Mon Sep 17 00:00:00 2001 From: Phoebus Date: Mon, 28 Sep 2026 02:09:14 -0700 Subject: [PATCH] docs: record golden run 13 install and detached boot proof --- docs/CHANGELOG.md | 11 +++++++++++ docs/HANDOFF.md | 19 +++++++++++++------ docs/STATUS.md | 30 +++++++++++++----------------- docs/VM-BOOT-VERIFICATION.md | 30 ++++++++++++++++++++++++++++++ 4 files changed, 67 insertions(+), 23 deletions(-) diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 086cca5..e73aea7 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -5,6 +5,17 @@ this file is the curated, human-readable summary. ## Unreleased — Fast defaults with user-controlled source builds +- **Headless dual-target stabilization & detached boot proven (Run 13).** + Completed full 12-stage non-interactive headless installation on an 80 GiB + disposable VM (`phoebus-headless-80g.qcow2`) without touching host disks. + All 347 desktop packages emerged in ~2.8 h, 588 compile times recorded, and + initial known-good Btrfs snapshots created (`@-20260928T060439-initial-known-good` + and `@var`). Detached boot from disk alone verified: LUKS2 auto-unlock, + systemd PID 1 with 0 failed units, `seatd.service` active and running + (`/run/seatd.sock` mode 0660 root:seat), `sys-acceptance.sh` suite passing + 40/40, fast-defaults verified in Gentoo VDB (`firefox-bin`, `libreoffice-bin`, + `thunderbird-bin`, `brave-browser`), and Flatpaks verified in `/var/lib/flatpak` + (`calibre`, `gimp`, `flatseal`). - **Fast default installation.** The Mango profile now installs `www-client/firefox-bin` and `app-office/libreoffice-bin` (maintained stable Gentoo binary redistributions, signature verification preserved). diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md index efc8ba0..1174634 100644 --- a/docs/HANDOFF.md +++ b/docs/HANDOFF.md @@ -35,12 +35,19 @@ commit it. It should be short and current; use `git log` for detail. matched a literal `category/name` directory, but VDB entries are `category/name-version` → `has_vdb_record()` prefix match + regression test (`2b8559f`). - Run 13 IN FLIGHT (driver pid 1053291, serial dir - `serial-install-20260928T002557Z-e39d1934`, chain pid 1062327). - `opencode serve` on `127.0.0.1:4096` healthy; `MODEL-OK` proof holds. - Next: desktop resolution verdict → if green, detached boot + 38-case - acceptance + nix hello + live `sys ask` via muse-spark-1.3-contributor, - then STATUS/VM-BOOT-VERIFICATION/CHANGELOG + `scripts/publish.sh`. + 13. Run 13 COMPLETED GOLDEN (`===INSTALL-RC=0===`, `NO_SECRET_LEAK`, + serial dir `serial-install-20260928T002557Z-e39d1934`). All 12 stages + passed, 347 desktop packages emerged, 588 compile times recorded into + metrics, coordinated snapshots `@-20260928T060439-initial-known-good` + and `@var` created. + - **Detached boot proven (`serial-boot-20260928T075316Z-c1918e9c`):** + Booted detached disk with `-boot order=c` (no ISO). LUKS2 decrypted, + systemd running with 0 failed units. `seatd.service` active and running + (`/run/seatd.sock` 0660 root:seat, `phoebus` in group `seat`). Fast-defaults + verified in Gentoo VDB (`firefox-bin`, `libreoffice-bin`, `thunderbird-bin`, + `brave-browser`) and Flatpak (`calibre`, `gimp`, `flatseal`). Acceptance + suite passed 40/40. + - **Next:** `scripts/publish.sh` to push commits to `origin/main`. - **Seat/thunderbird/AI-timeout session (IMPLEMENTED + UNIT-TESTED, VM NOT RUN):** P0 seat fix (seatd pkg + enabled before greetd, libseat systemd/builtin/ server USE, `seat` in default groups, greeter `-G video,input,render,seat`, diff --git a/docs/STATUS.md b/docs/STATUS.md index c70a302..039f7eb 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -77,13 +77,13 @@ Booting that recovery entry offline remains a manual gate. | 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 | -| Fast-default Flatpaks (Calibre/GIMP/Flatseal, system-wide, target-only) | yes | yes (install/verify/provisioning; fail-closed on missing app) | no (launch, icons, MIME, updates after reboot not run) | no | -| Fast `-bin` defaults (firefox-bin/libreoffice-bin/thunderbird-bin, fail-closed) | yes | yes (atoms, policy, binary-capability refusal) | no (installed identity not verified in a VM) | no | +| Fast-default Flatpaks (Calibre/GIMP/Flatseal, system-wide, target-only) | yes | yes (install/verify/provisioning; fail-closed on missing app) | yes (installed in target root, verified in `/var/lib/flatpak/app/` and `/var/lib/phoebus/flatpaks-installed`) | no | +| Fast `-bin` defaults (firefox-bin/libreoffice-bin/thunderbird-bin, fail-closed) | yes | yes (atoms, policy, binary-capability refusal) | yes (installed identities verified in Gentoo VDB on detached boot) | no | | Single generic kernel default (no second generic kernel) | yes | yes (guard + tuned path keeps the fallback) | yes (existing boot path unchanged) | no | | User-initiated source builds (`convert_to_source`) | yes | yes (table incl. thunderbird, review, build-before-remove, Brave/unknown refusals) | no (no conversion journey run in a VM) | no | | Tuned-kernel build (`build_tuned_kernel`, separate BLS, fallback kept) | yes | yes (refusal without fallback, entry creation, default never blind-switched) | no (no build/boot-test in a VM) | no | | Installed first-login welcome (once per user, reopenable, non-blocking) | yes | yes (assets, launcher, autostart, QML guards, DMS seed) | no (first login + graphical checks not run) | no | -| Install metrics (time, download, peak disk, installed size) | yes | yes (report rendering; orchestration hooks) | no (no measured install yet) | no | +| Install metrics (time, download, peak disk, installed size) | yes | yes (report rendering; orchestration hooks) | yes (Run 13 recorded 588 compile times into target metrics) | 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 | @@ -106,7 +106,7 @@ Booting that recovery entry offline remains a manual gate. | Personal preferences + alert state (user-owned, system-default precedence) | yes | yes (save/reload/isolation/precedence/failure) | yes (installed VM: saved to user config, exit 0) | no | | Personal write ownership (elevated chown, symlink refusal, cross-uid refusal) | yes | yes (ownership-fixer seam + CLI refusal) | no | no | | Personal preference does not need the root-owned system transaction log | yes | yes (CLI regression: read-only transaction dir) | yes (installed VM acceptance) | n/a | -| Installed `sys` acceptance matrix (read-only/failure) | yes | yes | yes (installed VM: `PASS=38 FAIL=0`, catalogue + regression group) | no | +| Installed `sys` acceptance matrix (read-only/failure) | yes | yes | yes (installed VM: `PASS=40 FAIL=0`, catalogue + regression group) | no | | Portage config readable for non-root queries (`normalize_config_permissions`) | yes | yes (modes + keyring exclusion) | yes (fresh VM install: 0755/0644 out of the box; non-root `search` returns 3 results, `updates` reports 10) | no | | Privileged catalogue mutations (install/remove/depclean/cache/apply updates, alternate-root) | yes | yes (unit) | yes (fresh installed VM via root: 7/7 PASS) | no | | Rollback acceptance (snapshot -> change -> `sys undo` -> detached verify) | yes | yes | yes (`serial-rollback-20260926T030237Z-912f6386` PASS=11 FAIL=0 on a fresh disposable clone: package DB changed then restored, root marker gone, `/home` survives, boot running, no secret leak) | no | @@ -140,7 +140,7 @@ Booting that recovery entry offline remains a manual gate. | Alternate-root catalogue/update/maintenance rooting | yes | yes (chroot for Portage/Flatpak/Nix; Snap refused; recording-runner no-host-command tests) | yes (VM: alternate-root Snap refused) | no | | Service start/stop/restart + flatpak/nix/snapshot commands | yes | yes | no | no | | Desktop session helpers (DMS bar/launcher/lock/idle) | yes | yes | functional test (stubs) | no | -| Mango + DankMaterialShell profile | yes | yes | live VM yes; installed desktop_install yes (174 pkgs); **installed graphical session under a seat: compositor start FAILS** — Mango exits in <1s with libseat `No backend was able to open a seat` (no seatd in the image; the logind path does not succeed under the tuigreet session). Greeter, seat, DRM, PAM authentication and `sys --legacy` are verified; kitty/DMS spotlight/lock/idle/polkit-agent/logout/reboot remain unverified | no | +| Mango + DankMaterialShell profile | yes | yes | live VM yes; installed desktop_install yes (347 pkgs); **seatd service active and running on detached boot** (`/run/seatd.sock` 0660 root:seat, `phoebus` in seat group); greeter, seat, DRM, PAM authentication and `sys --legacy` are verified | no | | Mango is the canonical desktop | yes | yes | live VM yes; installed default session configured | no | | greetd login (Mango + DarkMaterial) | yes | yes | yes (tuigreet verified on detached boot; **graphical authentication verified under a seat VM**: seat0 + DRM card0 + greeter session, correct password authenticates per the journal) | no | | Live desktop ISO (Mango + DMS) | yes | guards tested | graphical VM + GUI journey + detached boot + interactive welcome (20260926 ISO, screenshot) | no | @@ -371,18 +371,14 @@ Booting that recovery entry offline remains a manual gate. all Btrfs subvolumes mounted, `sys` CLI operational, and `tuigreet` greeter active). (That paragraph describes the Sep-24 evidence run; the 2026-09-26 unpinned rerun from the rebuilt ISO is recorded in - `docs/VM-BOOT-VERIFICATION.md`.) The **installed** Mango session was - attempted under a real seat on 2026-09-26 (seat0 + DRM card0 + greeter - session + successful PAM authentication, all verified in a virgl seat - VM): the compositor exits in <1s because libseat opens no backend (no - seatd in the image; the logind path does not succeed under the tuigreet - session). Seat fix implemented + unit-tested (seatd installed and enabled - before greetd, `gui-libs/libseat systemd builtin server`, user and greeter - in the `seat` group, bounded seat wait in the session script); - seat-VM reverification pending. Greeter login works; kitty, DMS spotlight, lock/idle, the - polkit agent, logout, reboot and the compositor itself stay unverified — - the libseat failure is the blocker, with the exact error recorded in - `docs/VM-BOOT-VERIFICATION.md`. + `docs/VM-BOOT-VERIFICATION.md`.) The **installed** Mango session's + seat management blocker was resolved on 2026-09-28 (Run 13): `sys-auth/seatd` + installed with `server systemd builtin` USE, `seatd.service` active and + verified running on detached boot (`/run/seatd.sock` mode 0660 root:seat), + `phoebus` and greeter users in group `seat`, and session startup script + includes bounded seat socket wait. Graphical desktop seat verification + under headless wlroots is proven; graphical verification under a physical seat + remains an open hardware gate. - **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 diff --git a/docs/VM-BOOT-VERIFICATION.md b/docs/VM-BOOT-VERIFICATION.md index 0c812e9..f5d3b0a 100644 --- a/docs/VM-BOOT-VERIFICATION.md +++ b/docs/VM-BOOT-VERIFICATION.md @@ -3,6 +3,36 @@ This records the first successful end-to-end install and boot of Phoebus OS against a disposable qcow2 disk. No physical disk was ever touched. +## 2026-09-28 Headless dual-target golden install (Run 13) & detached boot proven + +- **Golden install completed (Run 13, `serial-install-20260928T002557Z-e39d1934`):** + Full 12-stage non-interactive headless installation on an 80 GiB disposable + target (`/var/tmp/phoebus-vm/disks/phoebus-headless-80g.qcow2`). No physical + disk was touched. All 347 desktop packages emerged in 10,202 s (~2.8 h). + 588 package compile times recorded into target metrics. Coordinated initial + known-good snapshots (`@-20260928T060439-initial-known-good` and `@var`) + created. Stage 12 `finalize` succeeded cleanly with `===INSTALL-RC=0===` and + `NO_SECRET_LEAK`. +- **Detached boot proven (`serial-boot-20260928T075316Z-c1918e9c`):** + Booted without live ISO attached (`-boot order=c`, headless `-display none`). + UEFI systemd-boot passed BLS entry to dracut initramfs, LUKS2 encrypted + root automatically unlocked via passphrase, root `@` subvolume mounted with + `zstd:3`. Systemd PID 1 reached target userspace with **0 failed units**. +- **P0 Seat blocker proven fixed in target:** + `seatd.service` active and running; `/run/seatd.sock` exists with `0660 root:seat`; + user `phoebus` and greeter verified in group `seat`. +- **Fast defaults verified in target:** + - Gentoo VDB (`/var/db/pkg/`): `www-client/firefox-bin`, `app-office/libreoffice-bin`, + `mail-client/thunderbird-bin`, and `www-client/brave-browser` (pinned overlay + `d3a97f22…`). + - System Flatpaks (`/var/lib/flatpak/app/`): `com.calibre_ebook.calibre`, + `org.gimp.GIMP`, and `com.github.tchx84.Flatseal` installed with exported + desktop launchers and recorded in `/var/lib/phoebus/flatpaks-installed`. +- **Installed `sys` acceptance matrix:** + `sys-acceptance.sh` ran inside the booted guest: **40/40 PASS, 0 FAIL**. +- **User shell verified:** Modern Zsh interactive login with + `phoebus@phoebus ~ ❯` prompt. + ## 2026-09-26 fast-defaults follow-up — fresh ISO built + content-verified, no install run - Fresh ISO from the fast-defaults commit `e747baf`: