phoebus_os/docs/HANDOFF.md
Phoebus 83368f774c
Some checks are pending
ci / test (push) Waiting to run
feat(git): add session context, host doctor, ADRs and git hygiene
Adds scripts/context.sh + 'make context' (one-screen session briefing),
scripts/doctor.sh + 'make doctor' (host prerequisites), docs/HANDOFF.md
(rolling cross-session note), docs/adr/ (BLS, desktop profile, keyring, Rust),
.githooks/commit-msg (Conventional Commits), .gitattributes, scripts/backup-git.sh
+ 'make backup', and a Forgejo Actions CI workflow. Updates AGENTS.md reading
order/work loop and DEVELOPMENT.md.
2026-09-20 02:36:32 -07:00

41 lines
1.7 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 `e680084` (2026-09-20)
- **Current focus:** repository/context setup and git workflow.
- **Last verified:** Rust installer full encrypted UEFI VM boot with the ISO
detached (`installer/doc/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).
## 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`).