Some checks are pending
ci / test (push) Waiting to run
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.
62 lines
3.2 KiB
Markdown
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`).
|