phoebus_os/docs
Phoebus f9e39925b4 feat(install): AI-first sys install workflow
Implement the shared installation workflow (ADR 0013). sys install, sys ask
install and the explicit backend flags all use one path: identify -> evidence
-> AI investigation -> deterministic validation/effects -> review -> approval
-> execute -> verify -> history.

- phoebus-ai::install: bounded, multi-turn investigation. The model may request
  typed read-only evidence (discover_candidates, inspect_candidate,
  check_backend, inspect_installation), ask one bounded question about intent,
  and must return a structured InstallProposal. Turn/request/size limits and
  repeated-request detection bound it; a rejected proposal is revised.
- phoebus-core: add the four read-only investigation actions and strict
  validators; add a transaction id; backend/kind wire names now match as_str.
- phoebus-executor::install: resolve_explicit (no model, no fallback),
  resolve_deterministic and resolve_with_ai; validate_proposal re-resolves the
  candidate against real metadata, rejects fabrication/ambiguity/staleness/
  duplicates, maps it to the existing broker action, and binds approval to a
  digest; revalidate + verify_installed. chooser gains per-lane friendly-name
  resolution and structured evidence.
- transaction::begin/finish record an in-progress transaction before mutation.
- sys: --portage/--flatpak/--nix/--snap/--appimage/--ebuild (mutually
  exclusive) bypass the model; an unqualified install consults the model and,
  with none, prints the deterministic selection and installs nothing.
- The installer persists /etc/phoebus/install.toml; sys loads it and adds free
  space, Wayland, usable lanes, saved preferences and recovery capability to
  the bounded facts.
- Docs: ADR 0013, docs/SYS.md install sections and cases 23-31, CHANGELOG,
  STATUS, HANDOFF, ROADMAP. New live-VM workflow check script.

Host gates pass: fmt, clippy (no new warnings), workspace tests, make test.
VM: verified the workflow CLI and read-only investigation on the reference
LiveGUI ISO; a full target install journey is running (see HANDOFF).
2026-09-23 20:30:13 -07:00
..
adr feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00
screenshots feat(installer): graphical welcome and install wizard over a typed bridge 2026-09-21 13:13:40 -07:00
ARCHITECTURE.md feat(installer): graphical welcome and install wizard over a typed bridge 2026-09-21 13:13:40 -07:00
BASH-MIGRATION.md docs(migration): record Phases 0-4 complete in the session log 2026-09-20 04:01:03 -07:00
CHANGELOG.md feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00
CONTRIBUTING.md docs: update references after retiring the Bash installer 2026-09-20 04:00:19 -07:00
DEVELOPMENT.md feat(desktop): make Mango + DankMaterialShell the default and build a live desktop ISO 2026-09-21 06:47:22 -07:00
FINDINGS.md refactor!: retire the Bash installer tree and relocate its docs 2026-09-20 04:00:14 -07:00
GIT-WORKFLOW.md docs: update references after retiring the Bash installer 2026-09-20 04:00:19 -07:00
HANDOFF.md feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00
OBJECTIVES.md docs: one control plane — sys typed actions, not raw Portage 2026-09-20 14:35:05 -07:00
OPENCODE.md feat(gui): select and validate OpenCode from the installer 2026-09-22 02:36:36 -07:00
PLAN-DEBIAN-LIVE.md docs(live): record the Debian-Live appliance install and detached boot 2026-09-20 13:49:49 -07:00
ROADMAP.md feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00
STATUS.md feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00
SYS.md feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00
VERIFICATION.md docs(verification): record the graphical journey results and host-time blocker 2026-09-22 12:30:55 -07:00
VM-BOOT-VERIFICATION.md docs: reconcile NVIDIA, verification and harness status 2026-09-23 06:28:30 -07:00