diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 983c288..7488106 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -45,9 +45,22 @@ this file is the curated, human-readable summary. duplicate/changed-evidence, action mapping, transaction begin/finish, CLI flag conflicts/no-fallback/no-model, and target-vs-host facts. +### Verified (disposable VM) +- A deterministic minimal install completed (`INSTALL-RC=0`), including + installing `/usr/local/bin/sys` and verifying the target, then booted detached + (systemd `running`, 0 failed units). +- `sys install app-misc/hello --portage` ran the full workflow: plan + effects, + protective snapshot, install, verification in the package database, and a + durable transaction in `sys history` that survived a clean reboot. +- `sys remove app-misc/hello`, the no-model offer, backend-flag conflicts and + the read-only investigation actions were exercised; the matrix reported + `FAIL=0` (19/19). + ### Not yet verified -- Real VM installation journeys through `sys install` (AI-selected and - explicit-backend) are the next gate; see `docs/HANDOFF.md`. +- The **AI-selected** journey (`sys install ` with a connected model) is + unit-tested with scripted transports and was not run against a live provider: + no authorised provider/credential exists in this environment. The exact + command is in `docs/HANDOFF.md`; it is the remaining gate. ## 2026-09-24 — Hardware-aware software selection, Snap/AppImage/custom ebuild, `sys` lifecycle diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md index 866cff0..010c36c 100644 --- a/docs/HANDOFF.md +++ b/docs/HANDOFF.md @@ -38,34 +38,48 @@ commit it. It should be short and current; use `git log` for detail. no-fallback, no-model offer, help; target-vs-host facts. - `installer/tests/vm/test_vmsafety.py` (18 tests) passes with the extended `sys-acceptance.sh`. -- **Not yet verified this session:** a real VM installation journey through - `sys install` (AI-selected and explicit-backend). The `sys` acceptance matrix - now includes the read-only install-workflow cases (23–31). No live model call - was made. + - **Disposable VM (deterministic minimal install, `--no-ai`)**: completed + with `INSTALL-RC=0` and installed `/usr/local/bin/sys`; booted detached + (systemd `running`). `sys install app-misc/hello --portage` produced a + plan + effects, a protective snapshot, installed and verified it in the + package database, and recorded a durable transaction that survived a clean + reboot. `sys remove` succeeded (after fixing unmerge parsing) and the + acceptance matrix reported `FAIL=0` (19/19). See + `docs/CHANGELOG.md` and `docs/STATUS.md` for details. +- **Not yet verified this session:** the **AI-selected** journey + (`sys install ` with a connected model). It is unit-tested with scripted + transports but was not run against a live provider because no authorised + provider/credential exists in this environment. The exact command is in + "Next actions" below. - **Public repo:** (remote `origin`, SSH port 2222). ## Next actions (in order) -1. **VM install journey**: clone the installed disposable disk, boot it - detached, and run: +1. **AI-selected install journey (needs an authorised provider)**: boot the + installed disposable disk, serve the built `sys` and a 0600 key file, then: ```sh - # serve the freshly built static binaries (make static) plus the guest scripts - DISK=/var/tmp/phoebus-vm/disks/.qcow2 OVMF_CODE=... OVMF_VARS=... \ - BOOT_CHECKS='test -x /usr/local/bin/sys && /usr/local/bin/sys --version; \ - sudo /usr/local/bin/sys install app-misc/hello --portage; \ - sudo /usr/local/bin/sys history; \ - curl -fsSL http://10.0.2.2:8000/sys-acceptance.sh -o /tmp/sa.sh && bash /tmp/sa.sh; \ - echo ===CHECKS-$(printf END)===' \ - python3 installer/tests/vm/serial-driver.py boot + sudo sys --ai-provider deepseek --ai-api-key-file /run/phoebus/ai.key \ + install + # and the no-model control in the same run: + PHOEBUS_AI_PROVIDER= sudo sys install + ``` + Confirm the model requests evidence, the resolver confirms the candidate, + the plan is presented before approval, and the transaction is recorded. No + credential is available here; do not invent one. +2. **Rerun the deterministic journey on a fresh disk** if the harness changes: + ```sh + make static + cp installer-rs/target/x86_64-unknown-linux-gnu/release/{phoebus-installer,sys} /home/dominic/vmlab/serve/ + cp installer/tests/vm/{install.sh,sys-acceptance.sh} /home/dominic/vmlab/serve/ + OVMF_CODE=/usr/share/OVMF/OVMF_CODE_4M.fd OVMF_VARS=/usr/share/OVMF/OVMF_VARS_4M.fd \ + DISK=/var/tmp/phoebus-vm/disks/ \ + ISO=/home/dominic/Source/phoebus_os/livegui-amd64-20260913T163055Z.iso \ + KERNEL=/var/tmp/live-boot/gentoo INITRD=/var/tmp/live-boot/gentoo.igz \ + INSTALL_URL=http://10.0.2.2:8000/install.sh \ + python3 installer/tests/vm/serial-driver.py install + # then serial-driver.py boot with BOOT_CHECKS running the matrix ``` - Confirm an explicit-backend install succeeds, appears in `sys history`, and - the matrix reports `FAIL=0`. -2. **AI-selected install journey**: with a configured provider (existing - authorization, 0600 key file), run `sudo sys install ` in the VM and - confirm the model investigates, the resolver confirms the candidate, and the - plan is presented before approval. Use `PHOEBUS_AI_PROVIDER=` (empty) to - exercise the no-model offer in the same run. 3. **Rollback VM acceptance** (`serial-driver.py rollback`) remains unrun. 4. **NVIDIA hardware acceptance (BLOCKED)**: needs an NVIDIA GPU. 5. **Installed Mango desktop** and the **live ISO `gui` journey** remain to be diff --git a/docs/STATUS.md b/docs/STATUS.md index 94dda5c..71b9306 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -92,13 +92,13 @@ still not VM-verified. | AppImage lane (import/acquire/integrity/desktop/remove) | yes | yes | no | no | | Custom ebuild overlay (stage/approve/build/remove) | yes | yes | no | no | | `sys` installed into the target + verified in chroot | yes | yes (unit) | no | no | -| AI-first install workflow (`sys install`, `sys ask`) | yes | yes | no | no | -| Bounded AI investigation (typed read-only evidence) | yes | yes | no | no | +| AI-first install workflow (`sys install`, `sys ask`) | yes | yes | explicit-backend journey; AI-selected not run | no | +| Bounded AI investigation (typed read-only evidence) | yes | yes | read-only actions on a booted VM | no | | Deterministic proposal validation (fabrication/stale/ambiguous/duplicate) | yes | yes | no | no | -| Explicit backend install flags (no fallback) | yes | yes | no | no | -| No-model unqualified install refuses and offers commands | yes | yes | no | no | -| Install transaction begin/finish + verification | yes | yes | no | no | -| Installed config loaded (`/etc/phoebus/install.toml`) | yes | no | no | no | +| Explicit backend install flags (no fallback) | yes | yes | yes (Portage install + remove, history) | no | +| No-model unqualified install refuses and offers commands | yes | yes | yes (matrix case) | no | +| Install transaction begin/finish + verification | yes | yes | yes (install verified; durable across reboot) | no | +| Installed config loaded (`/etc/phoebus/install.toml`) | yes | no | install writes it; `sys` reads it on the installed system | no | | `sys` consistent target-root execution | yes | yes | no | no | | `sys` validation at the execution boundary | yes | yes | no | n/a | | `sys ask` truthful failure (nonzero, stop, record) | yes | yes | no | n/a | diff --git a/docs/SYS.md b/docs/SYS.md index bc4f8f8..bf37bb5 100644 --- a/docs/SYS.md +++ b/docs/SYS.md @@ -235,6 +235,13 @@ and `crates/phoebus-installer/tests/sys_cli.rs`). Cases 15–20 and the in-VM subset are exercised by the VM acceptance script; their current verification status is recorded in `docs/STATUS.md`. +Verified in the disposable VM (deterministic minimal install, booted detached): +`sys install app-misc/hello --portage` (plan + effects → snapshot → install → +package-database verification → durable history), `sys remove app-misc/hello`, +the no-model offer and flag-conflict cases, and the read-only investigation +actions; `sys-acceptance.sh` reported `FAIL=0` (19/19). The AI-selected journey +needs a connected model and is the remaining gate (`docs/HANDOFF.md`). + ## Security properties - **No shell.** Every command is an argument vector through