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
|
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
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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 |
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue