phoebus_os/docs/HANDOFF.md
Phoebus b12b2768b4
Some checks are pending
ci / test (push) Waiting to run
feat(nix): default Nix on; flush finalize writes before unmount
Nix is on by default (NIX_ENABLED=no opts out); a desktop VM verified
nix-daemon active and 'nix shell nixpkgs#hello' -> Hello, world!. Create
/nix/var/nix/daemon-socket (the unit's ConditionPathIsReadWrite) and the
.wants links. finalize now runs sync before unmounting so the session script
and exported log are durable across a forced poweroff.
2026-09-20 22:35:46 -07:00

3.2 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: commit b2f5181 (2026-09-20)
  • Current focus: four workstreams — AI-assisted install guidance, desktop session reliability, signed-binary reuse, and snapshots/safe updates.
  • Last verified: static Rust binary install + detached boot (docs/VM-BOOT-VERIFICATION.md); in this session additionally: the Debian-Live appliance ISO (firmware boot, full install, detached boot), the mandatory-AI gate, desktop portals, and the built-in Nix lane (nix-daemon active, nix shell nixpkgs#hello -> Hello, world!); sys snapshot/history and update preparation on an installed Btrfs VM; and the AI guided path by fixtures.
  • Public repo: https://git.phoebus.club/phoebus/phoebus_os (remote origin, SSH port 2222).

Next actions (in order)

  1. Re-verify the finalize sync (build 3ba913ba): the Nix lane is VM-verified (nix-daemon active, nix shell works) and on by default, but the one-line durability fix that should make /usr/local/bin/phoebus-session survive a forced poweroff was not re-run end to end (host root was ~98% full and the base emerge became pathologically slow). A binary Nix ebuild was ruled out (upstream has no DESTDIR).
  2. Physical-seat desktop: run /usr/local/bin/phoebus-session on a real VT and check kitty, XWayland, the polkit agent, logout/reap and reboot (docs/DEVELOPMENT.md -> "Physical VT / real-seat check").
  3. Matching signed binhost: the official Gentoo binhost is OpenRC/hardened, so systemd/desktop packages compile from source. Publish (or point at) a systemd/desktop binhost to raise binary reuse; verify with emerge -pv.
  4. Rollback gate: implement Btrfs default-subvolume + ESP handling and pass a detached-boot test before exposing sys undo.
  5. Live AI provider call: exercise DeepSeek/OpenAI/local with a real 0600 key file; the path is currently fixture-verified only.
  6. Desktop graphical login: exercise a real logind seat.

Known blockers / risks

  • No live DeepSeek/OpenAI call has been made (no key in this environment).
  • No Forgejo Actions runner is known to exist; .forgejo/workflows/ci.yml only runs once one is registered.
  • Desktop graphical login / physical seat has not been exercised; the serial VM has no logind seat.
  • NVIDIA is not verified on hardware.
  • Rollback is not implemented (by design, gated).

Environment notes

  • Dev host: Ubuntu 26.04. QEMU/OVMF/xorriso/rustfmt/clippy installed.
  • Reference ISO is livegui-amd64-20260913T163055Z.iso (gitignored).
  • Forgejo token for API tasks: ~/.config/phoebus/forgejo.token (0600).
  • The VM harness disks are disposable qcow2 files on / (not /tmp, which is a small tmpfs on the dev host); never point DISK at /dev/*.
  • The VM harness honours CHECKS_TIMEOUT for long guest checks.

Definition of a good stopping point

  • make test passes; docs/STATUS.md and docs/CHANGELOG.md updated; docs/HANDOFF.md updated; committed and pushed (scripts/agent-commit.sh + scripts/publish.sh).