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

1.7 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 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).