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

62 lines
3.2 KiB
Markdown

# 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`).