phoebus_os/docs/ROADMAP.md
Phoebus 7ebb616c99
Some checks are pending
ci / test (push) Waiting to run
feat(ai,desktop): unify administration layer, provision QML, and add conversation continuity
Unifies AI-first administration across the CLI (sys) and desktop GUI
(phoebus-assistant) through a shared service layer, fixes installed
desktop QML asset provisioning, adds Polkit elevation, and introduces
contextual conversation continuity.

- Extract phoebus_installer::service shared by CLI and desktop assistant bridge:
  - Reviewable plan staging (PreparedPlan) with SHA-256 cryptographic digests,
    15-minute TTL expiration, and replay prevention (PlanStore).
  - Pre-mutation system state revalidation binding execution strictly to the reviewed plan.
  - Honest recommendations displaying genuine provenance and unmeasured compile times.
  - Two-phase transaction logging (begin before mutation, finish with verification).
- Provision installed desktop assets and Polkit policy in phoebus-executor::desktop:
  - Added gui-apps/quickshell to canonical Mango desktop packages.
  - Embed 13 QML and policy files into target root under /usr/share/phoebus/assistant/.
  - Installed Polkit policy (club.phoebus.sys.policy) allowing unprivileged users to
    authenticate mutating plans via pkexec without blanket passwordless sudo.
- Eliminate startup freeze and polling in phoebus-assistant:
  - Multi-source update queries moved to on-demand tab switching.
  - Handshake timer reduced to one-shot 100ms with fast deterministic check.
- Add phoebus_installer::conversation:
  - Bounded 10-turn history with credential redaction.
  - Contextual follow-up resolution for comparisons, backend switching, and confirmation.
- Implement unified cross-source removal (plan_removal) preserving user data by default.
- Verified: all 486 workspace tests pass, release and crt-static builds succeed,
  and 23/23 VM acceptance cases pass (PASS=23 FAIL=0).
2026-09-24 17:21:16 -07:00

6.3 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 canonical desktop; 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 Done 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, start/stop/restart + flatpak/nix/snapshot commands, deterministic --legacy administration, audited --broker/--legacy gates, unified multi-source updates, quiet proactive assistance, shared service layer (phoebus_installer::service), and 23-case VM acceptance suite (sys-acceptance.sh 23/23 PASS)
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 administration Done unified CLI (sys install, please, ask) and desktop GUI (phoebus-assistant) backed by shared service::* planning, PreparedPlan digests with replay protection, Polkit elevation, QML provisioning, conversation continuity (conversation::*), Nix attribute verification, Portage binhost checks, and cross-source removal
— Git workflow + agent guide Done this docs/ set, .githooks/, scripts/

Immediate next steps

  1. Physical-seat desktop: run Mango + DarkMaterial on a real VT (or a seat-providing VM) and verify kitty, DMS spotlight, lock, idle, the polkit agent, logout and reboot interactively (docs/DEVELOPMENT.md).
  2. Mango + DankMaterialShell graphical verification: Mango is now the default (ADR 0009). Install the mango profile and boot the Mango live ISO in a graphical, seat-providing VM and run the gates in docs/VM-BOOT-VERIFICATION.md. Default promotion was an explicit owner decision; verification is still required to claim stability.
  3. 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).
  4. 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 -pv and record reuse.
  5. Lane acceptance in the disposable VM: run the sys acceptance 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-sys lifecycle.
  6. Live AI provider call: exercise sys ask and the installer guided path with a real 0600 key file; the path is currently fixture-verified only, and the systemd-run sandbox 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.