Some checks are pending
ci / test (push) Waiting to run
Update the changelog, status matrix, handoff and VM boot verification with the 23/23 graphical journey, the hardened harness, the confirmed fixes and the remaining blocked/unverified gates (full GUI install past AI, rollback, installed desktop, physical second-computer OpenCode transport).
89 lines
5.1 KiB
Markdown
89 lines
5.1 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:** this session (2026-09-22), harness + security + polish.
|
|
- **Current focus:** Hardened the VM harness (enforced qcow2/`/dev`/backing-chain
|
|
safety, structured PASS/FAIL results, per-run OVMF+QMP, no `os.system`),
|
|
fixed confirmed security defects (disk revalidation before partitioning,
|
|
bridge replay/concurrency + input bounds, provider transport URL/size
|
|
hardening, `TargetRoot` symlink escapes, and the `0 B` disk-size probe bug),
|
|
added an OpenCode server capability probe + docs/ADR 0011, and fixed the
|
|
welcome focus ring and the untruthful mid-install cancellation.
|
|
- **Last verified (this session):**
|
|
- `gui-driver.py gui` on the rebuilt ISO: **23/23 PASS**, exit 0. Welcome
|
|
autostarts; Return launches the installer (focus fixed); duplicate sessions
|
|
prevented; live medium protected; keyboard navigation reaches network + AI;
|
|
advancing without a model is refused and starts nothing.
|
|
- `make test` green (Rust + 16 harness unit tests); `cargo fmt --check`,
|
|
`cargo clippy --workspace --all-targets` (no errors), release + static
|
|
builds.
|
|
- OpenCode probe: `ready` against `opencode 1.18.32`; `authentication_required`
|
|
(exit 1) against an unauthenticated LAN bind.
|
|
- ISO: `installer/live/phoebus-installer-amd64.iso` 1.6 GiB,
|
|
`sha256 428dbd7547db8690596bf5c3a0d7a6fa8aee4c9f9eca1e926c216712dd050b36`;
|
|
static binary `sha256 2f9cd4b36a12e469d2b6187166acaf8b11f7f382cc19f7ad08bb2a809c855591`.
|
|
- **Public repo:** <https://git.phoebus.club/phoebus/phoebus_os>
|
|
(remote `origin`, SSH port 2222).
|
|
|
|
## Next actions (in order)
|
|
|
|
1. **Complete the graphical install with a real model**: download a small local
|
|
OpenAI-compatible model (or supply a 0600 provider key), then run
|
|
`gui-driver.py gui` through disk/account/review/ERASE/install/rebooot twice
|
|
on fresh qcow2 disks and record the passing journeys. The current automated
|
|
journey passes to the AI gate only.
|
|
2. **Installed Mango desktop**: install the default profile in a graphical VM
|
|
and verify the panel/launcher/terminal/audio/network/lock/idle, the dwl
|
|
fallback, and the welcome/installer absence on the installed system.
|
|
3. **Rollback VM acceptance**: deliberately break an update, run `sys undo`,
|
|
reboot detached, verify `/var/db/pkg` matches `/`, then boot the recovery
|
|
entry with no network or model (ADR 0007).
|
|
4. **Narrow the live broker privilege**: replace the live-only
|
|
`NOPASSWD: ALL` rule for the GUI bridge with the smallest practical
|
|
command-scoped rule once a safe sudoers form is verified (ADR 0011 context).
|
|
5. **Physical-seat desktop**: run `phoebus-session` on a real VT/seat and check
|
|
`phoebus-menu`, `phoebus-lock`, `phoebus-idle`, kitty, XWayland, the polkit
|
|
agent, logout/reap and reboot (`docs/DEVELOPMENT.md`).
|
|
6. **Release gates on a CI runner**: `phoebus-release gates --execute` and
|
|
`publish` once a runner exists; no gate has executed.
|
|
|
|
## Known blockers / risks
|
|
|
|
- No live DeepSeek/OpenAI key and no local model are available; the **full GUI
|
|
install past the AI step** and two fresh-disk graphical installs are NOT
|
|
verified (normal installation requires a connected model). The AI step is
|
|
verified as a blocked prerequisite and with a fixture transport.
|
|
- **Installed** Mango (GURU + compiled Quickshell/DMS) is not VM-verified; nor
|
|
is the dwl fallback session.
|
|
- Rollback and the AI sandbox are implemented and unit-tested but not
|
|
VM-verified. NVIDIA is not verified.
|
|
- A **separate physical computer** for the OpenCode transport test is not
|
|
available (BLOCKED); a forwarded-hop + unauthenticated-LAN-refusal host-local
|
|
test was done instead.
|
|
- The GUI bridge reaches Quickshell via `Process` + `/usr/bin/sudo -n`; it
|
|
relies on the live user's passwordless sudo. The live sudoers rule is still
|
|
`NOPASSWD: ALL` (live-only); narrowing the broker permission is future work.
|
|
- Harness artifacts live under `/var/tmp/phoebus-vm/` (outside git):
|
|
`results.json`, `screenshot-manifest.json`, `report.html`, screenshots.
|
|
|
|
## Environment notes
|
|
|
|
- Dev host: Ubuntu 26.04. QEMU/OVMF/xorriso/rustfmt/clippy/ImageMagick present.
|
|
- Debian-Live base ISO is cached at `/home/dominic/debian-live-standard.iso`
|
|
(matches `installer/live/base.sha256`); the appliance ISO builds without root.
|
|
- Local QML iteration: `/tmp/opencode/run-qml.sh <config-dir>` runs a config on
|
|
a nested Mango over the host X11 using the built rootfs libraries, and
|
|
`grim` captures it. The sanctioned verification is the disposable VM.
|
|
- VM harnesses: `installer/tests/vm/gui-driver.py` (graphical live ISO:
|
|
`gui`/`install`/`boot`), `appliance-driver.py`, `serial-driver.py`.
|
|
`DISK` must be a disposable qcow2; never point it at `/dev/*`.
|
|
- Serve the install fixtures from `/home/dominic/vmlab/serve` with
|
|
`python3 -m http.server 8000 --bind 127.0.0.1` (reachable as `10.0.2.2:8000`).
|
|
|
|
## 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`).
|