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).
6 KiB
6 KiB
Roadmap
Priority order is deliberate. Do not skip a higher item because a later one is more interesting. Status vocabulary: Done, Partial, Next, Later.
| # | Item | Status | Evidence / notes |
|---|---|---|---|
| 1 | Verify the Bash baseline | Done (retired) | tagged v0.1.0-bash-reference; retired with evidence in docs/BASH-MIGRATION.md |
| 2 | Build the Rust architecture | Done | installer-rs/ workspace, 5 crates |
| 3 | Port the deterministic core | Done | phoebus-core (config, plan, policy, validation, models) |
| 4 | Port the destructive backend | Done | phoebus-executor (storage, LUKS2, Btrfs, Portage, boot, users, services) |
| 5 | Rust VM boot parity | Done | Full encrypted UEFI install + boot, zero failed units, 10.7 s |
| 6 | Finish the desktop | Partial | Mango + DankMaterialShell is the default (dwl fallback); greetd login; the live ISO boots the branded welcome + graphical installer and was verified in a graphical VM; installed-desktop verification pending |
| 7 | Finish Flatpak | Partial | flatpak 1.18.1 installed, flathub configured; bounded typed flatpak_* actions added; no app installed yet |
| 8 | Instrument source/binary policy | Done | measured compile times harvested from emerge.log (326 entries); resolved-effect previews added |
| 9 | Background update preparation | Partial | distfile fetch VM-verified; --buildpkgonly skipped while deps need merging (recorded Ready); activation explicit |
| 10 | Snapshots / rollback | Partial | snapshot sets + history VM-verified on Btrfs; coordinated rollback, sys undo, recovery entry, retention and free-space gate implemented + unit-tested; destructive VM acceptance test pending |
| 11 | AI privilege and privacy architecture | Partial | typed actions + enforced privacy boundary + guided proposal review + OS-level sandbox (systemd-run hardening) + approval-bound resolved effects; live call/sandbox not VM-verified |
| 12 | sys operations |
Partial | history, enable/disable, inspect, install, prepare-updates VM-verified; target-root consistency, execution-boundary validation, truthful ask failure, full transaction outcomes, empty-vs-unestablished plans, and start/stop/restart + flatpak/nix/snapshot commands added (unit/integration-tested; VM gate pending). Installed-target sys now provisioned by the installer (unit-tested; VM gate pending) |
| 13 | Kernel optimization policy | Later | conservative fragments only; SAFE/OPTIMIZED/AGGRESSIVE selection exists |
| 14 | ISO / release pipeline | Partial | manifest/verify/assemble-plan tooling; release gates, atomic publish and signing helpers added; no CI runner has executed a gate |
| 15 | Recovery environment | Later | recovery BLS entry generated; snapshot-based recovery entry written at install; full recovery image not built |
| — | Rust TUI | Partial | ratatui UI with plan/ERASE and AI provider selection; not yet the default on all paths |
| — | Graphical installer (welcome + wizard) | Partial | Quickshell/QML over the typed --gui-bridge; live graphical VM verified, including a detached install+boot; live AI call pending (ADR 0010) |
| — | AI-guided install optimization | Partial | DeepSeek/OpenAI/local providers, evidence-gated typed review, mandatory at install with --no-ai break-glass; fixture-verified, no live call |
| — | Nix as a built-in second lane | Partial | pinned-release bootstrap; nix-daemon active and nix shell nixpkgs#hello VM-verified; on by default |
| — | Hardware-aware software selection (all lanes) | Partial | shared policy + candidate resolution + choose_package/set_package_preference (unit-tested); Snap, AppImage and custom-ebuild backends implemented (unit-tested); VM journeys pending (ADR 0006 revised) |
| — | AI-first package installation | Partial | shared sys install workflow with bounded AI investigation, deterministic validation, explicit backend flags and no-model offer (unit/integration-tested); VM install journeys pending (ADR 0013) |
| — | Git workflow + agent guide | Done | this docs/ set, .githooks/, scripts/ |
Immediate next steps
- Physical-seat desktop: run
phoebus-session/dwl on a real VT (or aseatd-backed session) and verify kitty, wofi,phoebus-menu,phoebus-idle, the polkit agent, logout and reboot interactively (docs/DEVELOPMENT.md). - Mango + DankMaterialShell graphical verification: Mango is now the
default (ADR 0009). Install the
mangoprofile and boot the Mango live ISO in a graphical, seat-providing VM and run the gates indocs/VM-BOOT-VERIFICATION.md. Default promotion was an explicit owner decision; verification is still required to claim stability. - Rollback VM acceptance: deliberately break an update in the disposable
VM, run
sys undo, reboot detached, verify package-state consistency, then boot the recovery entry with no network or model (ADR 0007). - Binary strategy: keep the official signed binhost for packages whose USE
matches and use Flatpak/Nix for other binaries; do not publish a private
Gentoo binhost (ADR 0006). Verify with
emerge -pvand record reuse. - Lane acceptance in the disposable VM: run the
sysacceptance matrix (installer/tests/vm/sys-acceptance.sh) on a booted installed disk, then a Snap install/refresh/remove, an AppImage acquire/launch/remove, and one custom-ebuild build (docs/SYS.md). This is the remaining proof for the new lanes and the installed-syslifecycle. - Live AI provider call: exercise
sys askand the installer guided path with a real 0600 key file; the path is currently fixture-verified only, and thesystemd-runsandbox is not yet VM-verified.
Later
- Full recovery environment (network, LUKS, Btrfs, Portage/kernel repair).
- Automated biweekly ISO candidate build with tiered tests and atomic publish.
- AI OS sandbox (systemd sandboxing / namespaces / bubblewrap / Landlock).
- Local model support; richer provider onboarding.
- Optimised kernel profiles with real hardware detection.
- Risk-class update policy (CORE / PROVEN / EDGE) and update preflight.