Adds the documentation a new session needs: AGENTS.md (read-first contract), docs/OBJECTIVES.md, ROADMAP.md, STATUS.md, ARCHITECTURE.md, DEVELOPMENT.md, CONTRIBUTING.md, GIT-WORKFLOW.md and CHANGELOG.md. STATUS.md records an honest implemented/unit-tested/VM-verified matrix and known limitations.
3 KiB
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 | installer/tests/run_tests.sh, installer/doc/VM-BOOT-VERIFICATION.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 | dwl/waybar/mako/swaybg/pipewire verified headless; 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 | --fetchonly + --buildpkgonly implemented and unit-tested; not VM-tested |
| 10 | Snapshots / rollback | Partial | snapshot create + history done; rollback not implemented |
| 11 | AI privilege and privacy architecture | Partial | typed actions + enforced privacy boundary; OS sandbox not implemented |
| 12 | sys operations |
Partial | history, enable/disable service, inspect, install, prepare-updates |
| 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; not yet the default on all paths |
| — | 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, XWayland, the polkit agent, logout and reboot interactively. - Desktop binary strategy: match the desktop USE set to a signed binhost (or publish one) so desktop installs stop compiling ~26 minutes of packages.
- Snapshots and safe updates end-to-end: prove
syssnapshot +prepare-updateson an installed system, then implement and test rollback before wiringsys undo.
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.