docs: record the VM-verified install journey
Some checks are pending
ci / test (push) Waiting to run

Record the disposable-VM evidence for the AI-first install workflow: the
deterministic install, the explicit --portage install/remove journey with a
protective snapshot and durable history, the no-model offer, the read-only
investigation actions, and the 19/19 acceptance matrix. Note the AI-selected
journey as the remaining gate (needs a connected provider).
This commit is contained in:
Phoebus 2026-09-23 21:42:11 -07:00
parent dedaa4bc48
commit 3435d5aed1
4 changed files with 63 additions and 29 deletions

View file

@ -45,9 +45,22 @@ this file is the curated, human-readable summary.
duplicate/changed-evidence, action mapping, transaction begin/finish, CLI duplicate/changed-evidence, action mapping, transaction begin/finish, CLI
flag conflicts/no-fallback/no-model, and target-vs-host facts. 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 ### Not yet verified
- Real VM installation journeys through `sys install` (AI-selected and - The **AI-selected** journey (`sys install <app>` with a connected model) is
explicit-backend) are the next gate; see `docs/HANDOFF.md`. 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 ## 2026-09-24 — Hardware-aware software selection, Snap/AppImage/custom ebuild, `sys` lifecycle

View file

@ -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. no-fallback, no-model offer, help; target-vs-host facts.
- `installer/tests/vm/test_vmsafety.py` (18 tests) passes with the extended - `installer/tests/vm/test_vmsafety.py` (18 tests) passes with the extended
`sys-acceptance.sh`. `sys-acceptance.sh`.
- **Not yet verified this session:** a real VM installation journey through - **Disposable VM (deterministic minimal install, `--no-ai`)**: completed
`sys install` (AI-selected and explicit-backend). The `sys` acceptance matrix with `INSTALL-RC=0` and installed `/usr/local/bin/sys`; booted detached
now includes the read-only install-workflow cases (23–31). No live model call (systemd `running`). `sys install app-misc/hello --portage` produced a
was made. 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 <app>` 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:** <https://git.phoebus.club/phoebus/phoebus_os> - **Public repo:** <https://git.phoebus.club/phoebus/phoebus_os>
(remote `origin`, SSH port 2222). (remote `origin`, SSH port 2222).
## Next actions (in order) ## Next actions (in order)
1. **VM install journey**: clone the installed disposable disk, boot it 1. **AI-selected install journey (needs an authorised provider)**: boot the
detached, and run: installed disposable disk, serve the built `sys` and a 0600 key file, then:
```sh ```sh
# serve the freshly built static binaries (make static) plus the guest scripts sudo sys --ai-provider deepseek --ai-api-key-file /run/phoebus/ai.key \
DISK=/var/tmp/phoebus-vm/disks/<clone>.qcow2 OVMF_CODE=... OVMF_VARS=... \ install <application>
BOOT_CHECKS='test -x /usr/local/bin/sys && /usr/local/bin/sys --version; \ # and the no-model control in the same run:
sudo /usr/local/bin/sys install app-misc/hello --portage; \ PHOEBUS_AI_PROVIDER= sudo sys install <application>
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; \ Confirm the model requests evidence, the resolver confirms the candidate,
echo ===CHECKS-$(printf END)===' \ the plan is presented before approval, and the transaction is recorded. No
python3 installer/tests/vm/serial-driver.py boot 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/<qcow2> \
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 <app>` 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. 3. **Rollback VM acceptance** (`serial-driver.py rollback`) remains unrun.
4. **NVIDIA hardware acceptance (BLOCKED)**: needs an NVIDIA GPU. 4. **NVIDIA hardware acceptance (BLOCKED)**: needs an NVIDIA GPU.
5. **Installed Mango desktop** and the **live ISO `gui` journey** remain to be 5. **Installed Mango desktop** and the **live ISO `gui` journey** remain to be

View file

@ -92,13 +92,13 @@ still not VM-verified.
| AppImage lane (import/acquire/integrity/desktop/remove) | yes | yes | no | no | | AppImage lane (import/acquire/integrity/desktop/remove) | yes | yes | no | no |
| Custom ebuild overlay (stage/approve/build/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 | | `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 | | 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 | no | 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 | | Deterministic proposal validation (fabrication/stale/ambiguous/duplicate) | yes | yes | no | no |
| Explicit backend install flags (no fallback) | yes | yes | 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 | no | no | | No-model unqualified install refuses and offers commands | yes | yes | yes (matrix case) | no |
| Install transaction begin/finish + verification | yes | yes | no | no | | Install transaction begin/finish + verification | yes | yes | yes (install verified; durable across reboot) | no |
| Installed config loaded (`/etc/phoebus/install.toml`) | yes | no | no | 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` consistent target-root execution | yes | yes | no | no |
| `sys` validation at the execution boundary | yes | yes | no | n/a | | `sys` validation at the execution boundary | yes | yes | no | n/a |
| `sys ask` truthful failure (nonzero, stop, record) | yes | yes | no | n/a | | `sys ask` truthful failure (nonzero, stop, record) | yes | yes | no | n/a |

View file

@ -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 subset are exercised by the VM acceptance script; their current verification
status is recorded in `docs/STATUS.md`. 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 ## Security properties
- **No shell.** Every command is an argument vector through - **No shell.** Every command is an argument vector through