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.
7.9 KiB
7.9 KiB
Changelog
All notable changes are recorded here. The authoritative history is git log;
this file is the curated, human-readable summary.
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, orPHOEBUS_NO_AI=1) is used. A newlocalprovider (Ollama/llama.cpp/ LM Studio) and--ai-endpointsupport a model the user downloaded; no model is shipped. - Desktop installs now include
sys-apps/xdg-desktop-portal,xdg-desktop-portal-gtkandxdg-desktop-portal-wlr, so Flatpak and Wayland apps get file choosers and screencast support.
Added
sysoffline package commands:sys install <name>,sys remove <name>,sys search <query>(plus theremove_package/search_packagestyped actions). They are deterministic Portage operations with no model involved —emergeresolves a bare name or a full atom — so the system stays fully administrable offline and without the assistant.- Debian-Live installer appliance (
installer/live/build.sh, no root): a bootable Phoebus installer ISO built by overlaying the static installer, the OpenCode manifest and the Debian tools the live image lacks onto a Debian-Live stable base, with a serial-visible auto-booting grub config. The target stays Gentoo. Seedocs/PLAN-DEBIAN-LIVE.mdand ADR 0005. - Git workflow: committed hooks (
.githooks/),scripts/check-secrets.sh,scripts/agent-commit.sh,scripts/publish.sh,scripts/setup-hooks.sh. - Documentation set:
docs/OBJECTIVES.md,ROADMAP.md,STATUS.md,ARCHITECTURE.md,DEVELOPMENT.md,CONTRIBUTING.md,GIT-WORKFLOW.md,CHANGELOG.md, and the top-levelAGENTS.md. .gitignorecovering the ISO, build output, transcripts and secrets.
2026-09-20 — AI guidance, desktop reliability, snapshots
Added
- AI-assisted install guidance: an OpenAI-compatible provider layer for
DeepSeek and OpenAI plus a test transport
(
phoebus-ai::provider), credential loading and a curl transport that keeps the API key out of argv, config and logs (phoebus-executor::ai), and CLI flags--ai,--ai-provider,--ai-model,--ai-api-key-file,--ai-proposal-file,--ai-facts. The TUI offers DeepSeek/ChatGPT/without-AI. - Typed proposal extensions: scoped
package.use, explicit build jobs and binary-package preference. Every proposal now requires a non-empty reason and duplicate/conflicting changes are rejected before anything is applied. syshistory and update preparation are VM-verified on a Btrfs install.
Changed
phoebus-sessionnow startsdwlfirst, waits for the Wayland socket before launching waybar/mako/swaybg, establishesXDG_RUNTIME_DIRand a session bus, starts the polkit authentication agent, and reaps helpers on logout.- Portage policy: the unused
installkernel ukiflag is no longer forced, the duplicate/empty PipeWire/WirePlumber lines are gone, and the signed binhost is derived from the selected profile when unset. - Update preparation records a successful distfile fetch as ready even when
--buildpkgonlyis skipped because dependencies must be merged first, and the state note now includes the redacted Portage reason.
Fixed
- A high-risk
sysaction now creates its protective snapshot insideactions::executeand fails closed if the.snapshotssubvolume exists but the snapshot cannot be created; corrupt snapshot history is surfaced instead of being hidden as empty.
2026-09-20 — Retire the Bash installer (migration Phases 0–4)
Added
phoebus-executor::opencode: pinned-manifest parsing, architecture detection, fetch throughExec, SHA-256 verification, fail-closed placeholder checks, extraction and config writer (7 unit tests).--bootstrap-opencodeon the CLI;PHOEBUS_OPENCODE_MANIFESToverrides the embedded manifest for fixture verification.cli_coverageand golden plan tests (plan_golden.rs,tests/golden/).docs/BASH-MIGRATION.md: the evidence-gated retirement plan and ledger.
Changed
- The disposable VM harness installs with the static Rust binary; full
encrypted install + detached boot re-verified (systemd PID 1,
running, 0 failed units, LUKS, login). - CI, the pre-commit hook, the Makefile and the commit/publish scripts gate on
Rust only (
cargo fmt,clippy,test). installer/doc/VM-BOOT-VERIFICATION.mdandinstaller/doc/FINDINGS.mdmoved todocs/.
Removed
- The Bash installer tree (entry point, libraries, TUI, configuration, shell
test suite and README), retired in favour of
installer-rs/. The Bash reference remains taggedv0.1.0-bash-reference. The disposable VM harness underinstaller/tests/vm/is retained.
2026-09-20 — Rust installer parity, desktop, and foundations
Added
- Rust workspace (
installer-rs/):phoebus-core,phoebus-executor,phoebus-ai,phoebus-tui,phoebus-installer(~9.4k LOC, 45 files). - Typed
InstallConfigsupporting TOML and the legacy flat format. TargetRoot(host/target path safety),SecretString/Redactor,DestructiveAuthorization, centralExeccommand layer with dry-run.- Storage backend: GPT, ESP, LUKS2, Btrfs layout, fstab/crypttab, swapfile.
- Stage3 fetch with pinned SHA-256 (or signed DIGESTS), Portage configuration, signed binary use, source builds, kernel, dracut, systemd-boot BLS.
- Desktop/Flatpak: selects
default/linux/amd64/23.0/desktop/systemd, writes/usr/local/bin/phoebus-session; flathub remote configured. - Package policy instrumentation: measured compile times parsed from
emerge.log(326 entries recorded in the desktop run), persisted to/var/lib/phoebus/compile-times.tsv. - Snapshots: read-only Btrfs snapshots + TOML transaction history.
- Background update preparation (
--fetchonly+--buildpkgonly). - Typed
SystemActionschema, privileged broker, and thesyscommand. - AI privacy boundary (
PrivacyPolicy,ContextBundle, forbidden paths). - Release tooling:
phoebus-releasemanifest/verify/sha256/assemble. - ratatui TUI with plan review and ERASE confirmation.
- Recovery BLS entry booting
rescue.target.
Fixed
- Subvolumes mounted before creation.
- fstab/crypttab overwritten by stage3 extraction (moved to
fstab_generate). - Missing
/var/tmpbreakingkernel-install. installkernelrequiringuki_generatoreven for BLS.- dracut
cryptmodule andsystemd-cryptsetupmissing. - LUKS cmdline using
rd.luks.uuidinstead ofrd.luks.name. - dracut UKI missing the kernel command line (BLS adopted).
@swapnot mounted, breaking swap activation.- Portage GPG verify user unable to read the getuto keyring.
- Transient rsync mirror quarantine (sync retries).
- Pillow/HarfBuzz documentation circular dependency.
- Legacy config silently parsed as TOML with defaults.
Verified
- Full encrypted UEFI install and boot with the ISO detached:
systemdPID 1,is-system-running = running, 0 failed units, 10.73 s boot. - Desktop stack headless: dwl, waybar, mako, swaybg,
grimscreenshot,wl-copy/wl-paste,wpctl,flatpak 1.18.1+ flathub. - No secret leakage in the installer log.
2026-09-19 — Bash installer prototype and first VM boot
Added
- Bash +
dialoginstaller (installer/) with deterministic backend, TUI, plan/review, dry-run, logging, and destructive confirmation. - Read-only hardware/disk discovery with live-medium protection.
- GPT/LUKS2/Btrfs backend, systemd stage3, Portage, kernel, systemd-boot, users/services/desktop modules.
- Unit/regression suite and a disposable VM harness.
Verified
- First complete encrypted UEFI VM install and boot with the Bash installer.
Fixed
- The subvolume-ordering, fstab-timing,
/var/tmp,rd.luks.name,uki_generator, cryptsetup,@swap, andlocal root="$1" dir=...bugs (these are the class of bug the Rust port is designed to prevent).