docs: record the VM-verified install journey
Some checks are pending
ci / test (push) Waiting to run
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:
parent
dedaa4bc48
commit
3435d5aed1
4 changed files with 63 additions and 29 deletions
|
|
@ -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 <app>` 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
|
||||
|
||||
|
|
|
|||
|
|
@ -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 <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>
|
||||
(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/<clone>.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 <application>
|
||||
# and the no-model control in the same run:
|
||||
PHOEBUS_AI_PROVIDER= sudo sys install <application>
|
||||
```
|
||||
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/<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.
|
||||
4. **NVIDIA hardware acceptance (BLOCKED)**: needs an NVIDIA GPU.
|
||||
5. **Installed Mango desktop** and the **live ISO `gui` journey** remain to be
|
||||
|
|
|
|||
|
|
@ -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 |
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue