P0 seat fix: sys-auth/seatd installed and enabled before greetd, gui-libs/libseat with systemd+builtin+server USE, seat in default user groups, greeter in video/input/render/seat, and a bounded 3 s seat wait in phoebus-session-mango (LIBSEAT_BACKEND deliberately unset so every compiled backend stays available). P1 fast install: mail-client/thunderbird-bin replaces the source build in workstation_packages; Thunderbird joins fast_default_deliveries and SOURCE_CONVERSIONS (source target mail-client/thunderbird, honest 45-90 min estimate), the preference-neutrality guard covers it, and the first-login welcome names it. All lanes and the mandatory-AI install requirement are unchanged. AI robustness: CurlTransport max-time 120 s -> 300 s default, overrideable via PHOEBUS_AI_TIMEOUT (fail-closed parsing; zero refused) for both direct and sandboxed sends. Verified: cargo fmt --check, clippy --workspace --all-targets -- -D warnings, cargo test --workspace 759/759 (was 757), bash -n on the session script. Seat-VM reverification, thunderbird VM journeys, and live CPU-inference proof are NotRun (no VM run this session).
23 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.
-
Seat/thunderbird/AI-timeout session (IMPLEMENTED + UNIT-TESTED, VM NOT RUN): P0 seat fix (seatd pkg + enabled before greetd, libseat systemd/builtin/ server USE,
seatin default groups, greeter-G video,input,render,seat, 3 s bounded seat wait in the session script,LIBSEAT_BACKENDdeliberately unset), thunderbird-bin fast default +SOURCE_CONVERSIONSentry + welcome text (all lanes untouched; mandatory-AI requirement unchanged), andCurlTransporttimeout 120 s → 300 s default viaPHOEBUS_AI_TIMEOUT(fail-closed parsing). Gates: fmt, clippy--workspace --all-targets -- -D warnings, 759/759 tests (was 757),bash -nsession script. Seat-VM reverification, thunderbird installed-identity/conversion journey, and live CPU-inference timeout proof are NotRun (no VM run this session). -
Zsh modernization (2026-09-26, IMPLEMENTED + UNIT-TESTED, VM NOT RUN): rewrote
ZSH_SKEL_RC(color fix, cached compinit, Kitty keybindings,INC_APPEND_HISTORY, vcs_info git branch, exit-status prompt) and addedZSH_ZPROFILE(/etc/profilebridge +~/.local/bin);seed_default_zshuses the new const. Gates: fmt, clippy--workspace --all-targets -- -D warnings, 757/757 tests,zsh -n+ interactive startup smoke on host zsh 5.9. Seeding is once-only (existing~/.zshrcpreserved). Installed-session behavior (login env, Nix paths, prompt/git/keys in Kitty) awaits the disposable VM. Uncommitted;docs/DUAL-BOOT.mdfrom the prior session also still uncommitted. -
Fast-defaults follow-up (2026-09-26, ISO BUILT + CONTENT-VERIFIED, VM NOT RUN): audited the
e747baffast-defaults tree against the prompt (all lanes covered, no code changes needed), re-ran gates green (fmt, clippy -D, 757/757 tests, release build, vmsafety 18/18, shellcheck info-only), rebuilt the static binaries frome747baf(phoebus-installer8cf90d0f…,sysc87557…), and built a fresh ISOphoebus-installer-amd64-fastdefaults.iso(1.6 GiB,ad9cddb2…, build20260926T145700Z,PHOEBUS_REUSE_ROOTFS=1; git-ignored) with content verification (embedded binaries hash-match, Gentoo key both fingerprints, Mango/DMS + installer UI present). NO install/boot this session — wall-clock blocker (full Mango install ~165 min; host ready: doctor 20 ok, ~103 GiB free); all install/boot/graphical/source/tuned gates NotRun with exact unblock in VM-BOOT-VERIFICATION.md. Next: disposable 80 GiB install of thead9cddb2…ISO + detached boot, 37-case acceptance, graphical/file/device/source/tuned gates. -
Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it. -
Fast-defaults session (2026-09-26, IMPLEMENTED + UNIT-TESTED, VM NOT RUN): Firefox/LibreOffice as
-bin, Calibre/GIMP/Flatseal as target-only system-wide Flatpaks (no Portage duplicates), single generic kernel, delivery section in plan review + progress log, install metrics hooks, preference neutrality guard,convert_to_source(Firefox/LibreOffice/ Calibre/GIMP; Brave refused with reason) +build_tuned_kernel(separate BLS, fallback kept, default only after test boot) typed actions with full reviews through the existing approval/broker path, installed once-per-user reopenable non-blocking welcome + DMS skel seed, portal/MIME defaults with no sandbox overrides. Gates: fmt, clippy -D, 757 tests (was 736), release build, vmsafety 18/18, shellcheck clean. NO new ISO, NO install/boot this session — session-time blocker (host ready: doctor 20 ok, 104 GiB free); all VM gates NotRun with exact unblock in STATUS. Next: build ISO, disposable 80 GiB install + detached boot, 37-case acceptance, graphical/file/device/source/tuned gates per VM-BOOT-VERIFICATION.md. -
Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it. -
Workstation experience session (2026-09-26, IMPLEMENTED + UNIT-TESTED, VM BLOCKED): Mango workstation atoms (22 apps, exact, no substitute; Kitty kept, Nemo default, CUPS local-only, sshd installed/disabled), Brave stable scoped overlay (pin pre-network fail-closed; no pin recorded yet), Zsh-by-default
- packaged plugins, Vanilla-DMZ 24 cursors, default ccache 2G, AI reuse handoff (per-user 0600 key, truthful status, no Approve&Execute on errors), startup-check model (blur optional, PPD+D-Bus, matugen, cava) with truthful summary, assistant dark-default + light + responsive + token-drift guard, 60/20 GiB disk gates. Gates: fmt, clippy -D, 736/736 tests, release build, vmsafety 18/18, shellcheck info-only. NO new ISO (8 GiB free, needs ≥20; target needs 60–80), NO install/boot this session — all VM gates NotRun with exact unblock in STATUS. Next: free ≥80 GiB, pin Brave commit, build ISO, disposable 80 GiB install + detached boot, seat-VM compositor/cursor/ DMS/theme checks, fixture + live-AI handoff, local CUPS job, sshd-disabled
- PPD D-Bus recheck after reboot.
-
Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it. -
ISO rebuild + verification session (2026-09-26, DONE except seat-compositor): new ISO
installer/live/phoebus-installer-amd64-20260926.iso(1.6 GiB,250dbe9a…, build20260926T041500Z, HEAD11c0ee0+0b41781) built viaPHOEBUS_REUSE_ROOTFS=1, content-verified (embedded hashes match, Gentoo key both fingerprints, UI payload present); old Sep-24 ISO kept. Interactive VM RUNNING (KVM/GTK,phoebus-interactive-20260926.qcow2+ private vars in/var/tmp/phoebus-interactive/, screenshot at welcome, undisturbed). Unpinned signed-DIGESTS full install PASSED (gui-install-20260926T040728Z-f3ae68f4,INSTALL-RC=0,NO_SECRET_LEAK, ~165 min) + detached boot (running, 0 failed units,sys --legacy+ snapshot). Tamper refusals PASSED (placeholder pin pre-network, hash mismatch post-download, bothRC=1+ no leak). Recovery-entry boot PASSED (snapshot cmdline/findmnt, login,sys --legacy, truthfulaskfailure, systemd degraded). Seat desktop PARTIAL: seat0/DRM/greeter/auth verified, Mango dies in <1s (libseat, no seatd) — the blocker. Snap: no Store revision, still partial confinement. Nix: GC-dangling NOT reproduced; new gap: modern per-user Nix profiles invisible tosys(follow-up). Live AI: still no credential/model (NotRun).gui-driver.pyboot sys-check fixed (--legacy).gates --execute: 0/0/6 NotRun, no publish. Quality gates green (717/717, clippy -D, vmsafety 18/18). Evidence diskdisks/unpinned-accept-1.qcow2KEPT; scratch overlays removed. Next: seatd-or-logind fix for Mango (design+rebuild+retest), per-user Nix enumeration, live AI credential, snap revision/strict, NVIDIA. -
Security/readiness follow-up (2026-09-26): trust anchor + executable gates + strengthened rollback PASS.
- Stage3 trust anchor (fixed):
release_key_path()ignoresPHOEBUS_GENTOO_RELEASE_KEY; production always uses the provisioned key, test injection only via explicitverify_digests_with_key. Host-level Good-signature check of the real DIGESTS passes (not VM evidence). VM proof blocked: needs a rebuilt live ISO + disposable install (exact prerequisites indocs/VM-BOOT-VERIFICATION.md). - Release gates executable: invalid
checks/desktopmodes fixed (realbootmodes),--executeruns each argv and reports Passed/Failed/NotRun from evidence (unconfigured host: 0/0/6, publish refuses). Found and fixed agui-driver.pySyntaxError. 6 new tests. - Strengthened rollback rerun PASSED
(
serial-rollback-20260926T034218Z-7fab51ef, PASS=11 FAIL=0, exit 0, no leak, overlayrollback-accept-8.qcow2): mandatory===ROLLBACK-MARKER present===before undo, DBca398d71…→fda3780a…→restored, marker absent after detached reboot,/homesurvives, systemd running.SERVEshellcheck fix included. - Recovery-entry boot is now a distinct manual gate with its own
procedure (NOT RUN). Roadmap no longer lists passed
sys undoas unfinished; Secure Boot filed as a separate opt-in milestone. - Quality gates:
cargo fmt --check,clippy --workspace --all-targets -- -D warnings,cargo test --workspace717/717 (oneassistant_bridgeflake under parallel load, green in isolation and on rerun), release + static-pie builds,test_vmsafety.py18/18,shellcheckclean. Seat desktop, live AI, Snap revision/strict, and NVIDIA stay open with exact prerequisites (STATUS).
- Stage3 trust anchor (fixed):
-
Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it. -
Hardening pass (2026-09-26): stage3 fail-closed + truthful boot security + rollback acceptance PASS.
- Stage3 (security defect, fixed): the unpinned path warned and
continued on DIGESTS-download failure, missing SHA-512 entry, missing
gpg/key, failed key import, and gpg launch errors. All stop the install
before extraction now; bad signature/hash also stop it. The pinned path
requires a valid 64-hex pin (placeholder refused) before any network
use.
stage_installchecks forgpg/sha256sum/sha512sumfirst. 16 new regression tests (every failure branch, nonzero-exit and cannot-start doubles, both positive paths). The live image shipsgnupgplus the Gentoo release key, fingerprint-checked at build time against Gentoo's published fingerprints (13EB…2910weekly,D99E…2058signing). Commits2162670,744059b. - Boot security (fixed):
uki=true/secureboot=trueare rejected atvalidate_config(shared by CLI/TUI/GUI bridge); the plan preview always reports unsigned BLS. Parsing/validation/rendering regressions + golden updated. Commit95e0d05. Authenticated boot stays an open limitation (STATUS). - Rollback acceptance PASSED for real
(
serial-rollback-20260926T030237Z-912f6386, PASS=11 FAIL=0, exit 0, no secret leak): fresh overlayrollback-accept-7.qcow2onfresh-install-1.qcow2— snapshot →app-misc/helloinstall (DBca39…→fda3…) →sys undo <id>rc=0 → detached reboot (DB restored, root marker absent,/homesurvives, systemd running, recovery entry present). The 2026-09-25 pass claim had no transcript and did not reproduce; fixed harness defects: sudo auth (stale-prompt match bug found and fixed with unique markers), root phases, explicit--legacy, verified break (nanowas pre-installed), targeted undo, marker-absent assertion, preserved phase-1 log. Commits744059b,5f69996. - Release candidate (local, isolated): manifest (2 artifacts), verify,
tamper refusal, and publish refusal against the NotRun report all behave;
gates --executeis 0 passed / 6 NotRun (every gate needs VM/seat/model;run_gatesnever executes gate commands itself). Nothing published. - Quality gates:
cargo fmt --check,cargo clippy --workspace --all-targets -- -D warnings,cargo test --workspace712/712, release + static-pie builds,test_vmsafety.py18/18,make doctor19 ok / 1 disk-space warning.
- Stage3 (security defect, fixed): the unpinned path warned and
continued on DIGESTS-download failure, missing SHA-512 entry, missing
gpg/key, failed key import, and gpg launch errors. All stop the install
before extraction now; bad signature/hash also stop it. The pinned path
requires a valid 64-hex pin (placeholder refused) before any network
use.
-
Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it. -
Quality pass (2026-09-26): boxed
ExecError::Commanddetails (CommandFailure, 128 → 96 bytes, measured with a path-dependent probe crate; constructor + all match sites updated, error text/redaction/stderr-tail preserved, 4 regression tests), clearedcargo clippy --workspace --all-targets -- -D warningswith no blanket allows (type alias,CommandRecordparams struct,DiskPhaserenames), and splitservice.rs(4218 lines →service/mod,plan,validation,execution,tests) andgui_bridge.rs(2763 lines →gui_bridge/mod,protocol,bridge,tests) as structural refactors with explicit re-exports andpub(super)seams — noservice.rsleft alongsideservice/mod.rs.make testgreen (692/692, unchanged across the splits). Release + static-pie builds pass. The disposable VM re-ran the current 38-casesysacceptance matrix against the new staticsys(70f0a72b…): guestPASS=38 FAIL=0, driverPASS=41 FAIL=0(serial-boot-20260926T014746Z-3089a820, overlaysys-acceptance-refactor.qcow2). Commitse69bfb9,1bf31c5,2dd48d1. -
Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it. -
Snap first-use follow-up (2026-09-25): the previous "no snapd" note was a real integration gap. The normal
sys install … --legacy --snapresolver needs snapd to confirm a Store candidate before approval, while a raw typedsnap_installsilently added it during execution. First-use setup is now a separately reviewed Portage install plus socket enable/start, with exact guidance when absent. Fresh installs set scopedsys-fs/squashfs-tools lzma lzo, which Gentoo's snapd ebuild requires. A disposable VM exposed a second bug: Portage candidate resolution picked the first dependency (dev-lang/go-bootstrap) instead of the requestedapp-containers/snapd; it now matches the requested atom. Snap confinement is reported from the daemon rather than assumed strict. The disposable VM completed setup, Store install, refresh and remove (PASS=10 FAIL=0), with partial confinement. A fresh overlay and a clean reboot repeat with the final static binary each passedPASS=11 FAIL=0, including clean poweroff. Refresh found no newer revision. -
Previous session: second-round
sysreview fixes. Follow-up tod3f676a. Three further confirmed defects are fixed with regression tests: unsafe cleanup previews, non-exact Flatpak/Snap update execution, and reverse-dependency self-reference.make testis green (661 → 683 tests). This corrects the earlier blanket claim that every review finding was already fixed. -
Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it.
Snap first-use changes
phoebus-core::systemgenerates scoped SquashFS USE flags for new installs.- Portage candidate resolution selects the requested atom from the pretend plan, even when dependencies precede it. A multi-package regression covers the bug found by the VM.
- The Snap install path gives exact setup commands when snapd is absent; the
typed action no longer adds an unreviewed Portage dependency. Candidate
sandbox levels and missing
snap infofields are treated conservatively. installer/tests/vm/snap-guest.shdrives the installed-system journey. The serial driver can authenticate for boot checks and logs only guest output, keeping sent test passwords out of its transcript.
Previous sys review work
- Cleanup previews are non-destructive (finding 1).
eclean-dist/eclean-pkgdelete by default, soportage_cleanersnow previews with--pretend --deep(same selection policy as execution) and executes with--deep; the Nix preview uses the documentednix-store --gc --print-dead. Items are read from stdout+stderr, sorted and bound. Tests prove a cleaner never runs destructively during planning, revalidation or cancelled approval. - Exact Flatpak/Snap update transactions (finding 2).
ResolvedPlan.updatescarriesUpdateTransactions: full Flatpak ref + full installed/remote commits (viaflatpak info, since thecommitcolumn is abbreviated), or snap name + old/new revisions + channel. Execution consumes the reviewed transaction (add_executable…flatpak update --commit=<c>), revalidates each source immediately before its mutation, verifies the resulting commit/revision, and refuses non-exact transactions. A source whose resolution failed is never re-discovered.PlanStoreaggregation includesupdates. - Reverse dependencies (finding 3). The reverse branch no longer drops valid matches; it excludes only a genuine self-reference (the dependent is the queried package).
- Determinism.
All selected packages:removals are sorted (depclean previews are now order-independent);emerge --depclean --ask=n.
Verified in disposable VMs
- Cache cleanup + depclean (real tools):
ecleanupstream preview is non-destructive;sys clean cachepreview/cancelled/approved/drift/failed all behave correctly; depclean cancel/approve with transaction history and preserved/home. - Reverse dependencies:
sys-libs/glibcandsys-libs/zlibreport real dependents (conditional/versioned included). - Flatpak: installed via Portage (
sys-apps/flatpak, enablingmedia-libs/freetype[harfbuzz]), flathub added, an app installed and downgraded, thensys apply updates --flatpakresolved full ref+commits, deployed the pinned commit, and verified it. - Custom ebuild: stage → build/install (VDB entry + installed file) → remove.
- Managed AppImage: acquire with pinned SHA-256, list, run the managed ELF, remove; a placeholder SHA is refused.
- Nix: a
NIX_ENABLED=yesinstall bootstraps Nix;nix profile install nixpkgs#nodejs-sliminto/nix/var/nix/profiles/profileis enumerated bysys list --nixand found bysys list nodejs --nix, with store paths and generations reported separately. - Non-root
pkexec sys --broker: with the shipped polkit action and the standard wheel-admin rule installed on the disposable image, a wheel user authenticated through a terminal agent; cancellations changed nothing, the approved removal returned the broker JSON outcome, and the replay was rejected. The shipped privilege policy is unchanged. - Read-only acceptance:
installer/tests/vm/sys-acceptance.shPASS=38 FAIL=0re-run against the final staticsys(dd61c610…), including the newrdeps-legacyreverse-dependency regression. - Snap first use: the disposable VM installed
app-containers/snapdthrough the reviewed Portage plan (six effects), enabled and startedsnapd.socket, installed Snap Storehello-world6.4 revision 29, ran refresh, then removed it. The daemon reportedpartialconfinement and the install review agreed. The harness reportedPASS=10 FAIL=0(serial-boot-20260926T001830Z-107996de). Final-binary runs on a fresh overlay passedPASS=11 FAIL=0on first boot (serial-boot-20260926T005327Z-c024cc43) and after a clean reboot (serial-boot-20260926T010605Z-e6193c3a); both shut down cleanly.
Not completed / blocked
- Stage3 VM proof with the new binary: unit-tested (19 stage3 tests) and
the pinned path is unchanged for real pins, but no full install has run
with the fail-closed binary yet; the next disposable install is the proof.
The unpinned (signed-DIGESTS) VM proof additionally needs a rebuilt live
ISO carrying the provisioned key (
installer/live/build.shnow provisions it; no ISO was rebuilt in this session). - Installed Mango + DMS session under a seat: still needs a
seat-providing graphical VM (or physical VT): login, kitty, DMS
spotlight, lock/idle, polkit agent, logout, reboot
(
docs/DEVELOPMENT.mdphysical-VT procedure). - Snap update to a different revision / strict confinement: refresh with no newer revision and partial confinement were VM-verified. A revision-changing refresh and AppArmor-backed strict confinement were not (need an AppArmor-ready guest kernel with loaded policy, and a Store snap that actually has a newer revision than installed).
- Live AI: a local OpenAI-compatible model (
llama-server+ a GGUF model) was served on the host; the AI workflow reached the model, but the sandboxed call exceeded the 120 s transport timeout on CPU (curlexit 28). Needs a faster model/GPU or a remote provider credential. Fixture-backed routing and failure tests pass (ask-offline, missing-model offer, source constraint). - Recovery boot (distinct from rollback): the recovery BLS entry is present and asserted in the rollback acceptance, but booting it interactively was not automated. Method: select "Phoebus Recovery (known-good snapshot)" in the systemd-boot menu with no network.
- Nix re-run flakiness: a later
sys list --nixre-run reported the profile link dangling (the profile store path was gone) and correctly listed no packages; the first run with a real profile is the positive evidence.
Known blockers / risks
- VM serial login is occasionally flaky; retry the boot when
detached-boot-loginfails. make doctorpasses (KVM accessible via an ACL). Disk is shared by build and VM; watch free space.- The pre-existing
test-disk.qcow2cannot be unlocked (unknown passphrase); do not guess or brute-force it.
Next actions (in order)
- Stage3 install proof: next disposable install with the fail-closed binary (pinned path), then a rebuilt live ISO (with the provisioned Gentoo key) proving the signed-DIGESTS path in the VM.
- Recovery boot by selecting the recovery BLS entry with the network down.
- Live AI with a faster local model/GPU or an authorized provider credential (natural-language discovery, source constraints, reviewed install).
- Installed desktop under a seat (Mango + DMS login through reboot).
- Nix profile GC stability if the dangling re-run is reproducible.
- Snap strict confinement and changed-revision update in a disposable VM when an AppArmor-ready kernel and a revision-changing Store test are available.
Definition of a good stopping point
make testpasses;docs/STATUS.md,docs/CHANGELOG.mdand this file updated; committed (scripts/agent-commit.sh) and pushed (scripts/publish.sh).