docs: record the mandatory-AI gate, local provider and portals

Note the rebuilt appliance ISO (fec8e312) and the new desktop portals; add
Nix packaging as the top next task since it was deliberately not faked.
This commit is contained in:
Phoebus 2026-09-20 14:43:34 -07:00
parent 3a405dd1e7
commit f8b34635c7
4 changed files with 25 additions and 3 deletions

View file

@ -7,6 +7,16 @@ Format: Keep a Changelog. Dates are UTC.
## Unreleased
### Changed
- **Installing Phoebus now requires an AI.** The installer refuses an install
with no provider unless the explicit break-glass `--no-ai` (alias `--legacy`,
or `PHOEBUS_NO_AI=1`) is used. A new `local` provider (Ollama/llama.cpp/
LM Studio) and `--ai-endpoint` support a model the user downloaded; no model
is shipped.
- Desktop installs now include `sys-apps/xdg-desktop-portal`,
`xdg-desktop-portal-gtk` and `xdg-desktop-portal-wlr`, so Flatpak and
Wayland apps get file choosers and screencast support.
### Added
- `sys` offline package commands: `sys install <name>`, `sys remove <name>`,
`sys search <query>` (plus the `remove_package`/`search_packages` typed

View file

@ -17,7 +17,10 @@ commit it. It should be short and current; use `git log` for detail.
## Next actions (in order)
1. **Physical-seat desktop**: run `/usr/local/bin/phoebus-session` on a real VT
1. **Nix packaging**: author a `sys-apps/nix` ebuild (Phoebus overlay) +
`nix-daemon.service`, wire it into the installer, and VM-verify. This is the
remaining piece of "Nix is built in"; it was deliberately not faked.
2. **Physical-seat desktop**: run `/usr/local/bin/phoebus-session` on a real VT
and check kitty, XWayland, the polkit agent, logout/reap and reboot
(`docs/DEVELOPMENT.md` -> "Physical VT / real-seat check").
2. **Matching signed binhost**: the official Gentoo binhost is OpenRC/hardened,

View file

@ -21,7 +21,8 @@ more interesting. Status vocabulary: **Done**, **Partial**, **Next**, **Later**.
| 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 providers, evidence-gated typed review, TUI opt-in; fixture-verified, no live call |
| — | 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 | Next | `sys-apps/nix` Portage overlay + `nix-daemon`; installer wiring; not yet packaged |
| — | Git workflow + agent guide | Done | this `docs/` set, `.githooks/`, `scripts/` |
## Immediate next steps

View file

@ -285,9 +285,17 @@ the remaining step; no time estimate is claimed beyond the recorded ~26 min.
## Debian-Live installer appliance (actual ISO)
An appliance ISO was built **without root** by `installer/live/build.sh`
(Debian-Live 13.7 standard base + `/phoebus` overlay), SHA-256
(Debian-Live 13.7 standard base + `/phoebus` overlay). The full-install
evidence below was recorded with build
`c0105bc9a282fddcbefab42baa577ea99843060f00fa45a75bcbc8358186bfd5`.
The current build is
`fec8e312bfe641c423f2656970ae4271a1544b3a6107b407a8a29cb71f8850be`; it carries
the mandatory-AI install gate (`--no-ai`/`--legacy` break-glass), the `local`
model provider, and the desktop portals. It was **not** re-run through the full
install in this session (resource constraints); treat the earlier run as the
boot/install evidence and this as the current artifact.
Firmware boot (UEFI/OVMF, no `-kernel`; the ISO's own grub chain):
- auto-boots the live system on the serial console;