phoebus_os/docs/ROADMAP.md
Phoebus 0718bb34e5 feat(nix): gated bootstrap of the pinned Nix release
A binary ebuild is impossible (the upstream installer has no DESTDIR and runs
nix-store --load-db against the real root), so bootstrap the pinned,
SHA-256-verified official release with discrete commands in the target chroot
(no curl|sh, no sh -c): store copy, DB load, nixbld users, profile wiring and
nix-daemon units. Gated behind packages.nix (default off) until VM-verified.
2026-09-20 14:50:57 -07:00

3.8 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 session script race-free + polkit + helper cleanup (functional test); headless compositor verified; physical seat + interactive login pending
7 Finish Flatpak Partial flatpak 1.18.1 installed, flathub configured; no app installed yet
8 Instrument source/binary policy Done measured compile times harvested from emerge.log (326 entries)
9 Background update preparation Partial distfile fetch VM-verified; --buildpkgonly skipped while deps need merging (recorded Ready); activation explicit
10 Snapshots / rollback Partial snapshot create + history VM-verified on Btrfs; rollback not implemented
11 AI privilege and privacy architecture Partial typed actions + enforced privacy boundary + guided DeepSeek/OpenAI proposal review; OS sandbox not implemented
12 sys operations Partial history, enable/disable, inspect, install, prepare-updates VM-verified
13 Kernel optimization policy Later conservative fragments only; SAFE/OPTIMIZED/AGGRESSIVE selection exists
14 ISO / release pipeline Partial manifest/verify/assemble-plan tooling; no scheduling/publish/smoke test
15 Recovery environment Later recovery BLS entry generated; full recovery image not built
— Rust TUI Partial ratatui UI with plan/ERASE and AI provider selection; not yet the default on all paths
— 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 in the target chroot with nix-daemon; packages.nix gated off pending VM verification
— Git workflow + agent guide Done this docs/ set, .githooks/, scripts/

Immediate next steps

  1. Physical-seat desktop: run phoebus-session/dwl on a real VT (or a seatd-backed session) and verify kitty, wofi, XWayland, the polkit agent, logout and reboot interactively (docs/DEVELOPMENT.md).
  2. Desktop binary strategy: match the desktop USE set to a signed binhost (or publish one) so desktop installs stop compiling ~26 minutes of packages. The official binhost is OpenRC/hardened; a systemd/desktop host is needed.
  3. Rollback as a safety gate: implement Btrfs default-subvolume + ESP handling and pass a detached-boot test before exposing sys undo (snapshot/history/prepare-updates are now VM-verified).
  4. Live AI provider call: exercise DeepSeek/OpenAI with a real 0600 key file; the guided path is currently fixture-verified only.

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.