phoebus_os/docs/HANDOFF.md
Phoebus fc64793aec docs: update references after retiring the Bash installer
Point AGENTS.md, README.md and the docs at the Rust-only toolchain and the
moved VM-BOOT-VERIFICATION.md, and drop the Bash installer from DEVELOPMENT.md.
2026-09-20 04:00:19 -07:00

44 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 `TBD4` (2026-09-20)
- **Current focus:** the Bash installer is retired (migration Phases 0–4, see
`docs/BASH-MIGRATION.md`); `installer-rs/` is the only installer.
- **Last verified:** static Rust binary, full encrypted UEFI VM install +
detached boot (`docs/VM-BOOT-VERIFICATION.md`); desktop stack and Flatpak
verified headless.
- **Public repo:** <https://git.phoebus.club/phoebus/phoebus_os>
(remote `origin`, SSH port 2222).
## Next actions (in order)
1. **Physical-seat desktop**: run `phoebus-session`/dwl on a real VT and verify
kitty, wofi, XWayland, the polkit agent, logout and reboot interactively.
2. **Desktop binary strategy**: match desktop USE to a signed binhost (or
publish one) to stop compiling ~26 minutes of desktop packages.
3. **Snapshots + safe updates end-to-end**: prove `sys` snapshot and
`prepare-updates` on an installed system, then implement and test rollback
before wiring `sys undo`.
## Known blockers / risks
- No Forgejo Actions runner is known to exist; `.forgejo/workflows/ci.yml`
only runs once one is registered.
- Desktop graphical login has not been exercised with a real logind seat.
- NVIDIA is not verified on hardware.
## 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/*`.
## 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`).