phoebus_os/docs/CHANGELOG.md
Phoebus bbd3d89d6a
Some checks are pending
ci / test (push) Waiting to run
feat(desktop): make Mango + DankMaterialShell the default and build a live desktop ISO
- desktop.profile defaults to mango with Flatpak on; explicit none/minimal/dwl/
  full still win. The plan shows the selected session.
- Installed login uses greetd + tuigreet (authentication required, Mango default,
  dwl selectable); live autologin is a separate live-only configuration.
- installer/live/build.sh builds a rootless Debian testing rootfs with Mango
  (pinned source build), DankMaterialShell (pinned SHA-256 release), Quickshell,
  scenefx, Qt Wayland and greetd, then splices it into the base Debian-Live boot
  equipment. Live autologin, an Install Phoebus launcher and a serial/VT
  recovery console are included and the build fails clearly if a desktop
  component is missing. Verified in a graphical seat-providing VM (Mango + DMS +
  Quickshell; DMS panel captured).
- Shared desktop assets emitted by phoebus-installer --emit-asset, a graphical
  VM driver (live-driver.py), and regression tests for defaults/overrides,
  login, live/installed separation and the live ISO guards.
- Docs updated: ADR 0005/0009, STATUS, HANDOFF, CHANGELOG, ROADMAP, DEVELOPMENT
  and VM-BOOT-VERIFICATION.
2026-09-21 06:47:22 -07:00

14 KiB
Raw Blame History

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

  • Mango + DankMaterialShell is now the default desktop for both the installation ISO and the installed system (explicit owner decision). Omitted desktop.profile selects mango; Flatpak and PipeWire are on by default. Explicit none, minimal, dwl and full continue to work unchanged (ADR 0009).
  • Installed login uses greetd + tuigreet. Authentication is always required; the default session is Mango and the dwl entry remains selectable (--sessions /usr/share/wayland-sessions). Live autologin is a separate, live-only configuration and is never written to an installed system.

Added

  • Live desktop ISO: installer/live/build.sh now builds a rootless Debian testing rootfs containing Mango (built from a pinned source release), DankMaterialShell (pinned, SHA-256-verified release tarball), Quickshell, scenefx, wlroots 0.20, greetd/tuigreet and the desktop integration, then splices it into the base Debian-Live boot equipment. The live user autologins into Mango, an "Install Phoebus" launcher opens the unchanged installer UI, and a serial/VT recovery console is retained. The build fails clearly if a required desktop component is missing. Debian packages never enter the Gentoo target. The built ISO was booted in a graphical, seat-providing VM: Mango + DankMaterialShell + Quickshell ran and a screendump captured the DMS panel and welcome window (docs/VM-BOOT-VERIFICATION.md).
  • Shared desktop assets are emitted from one source of truth by phoebus-installer --emit-asset and used by both the installer and the live build. Regression tests cover the default/overrides, login configuration, live/installed separation, session entries, pinned checksums and the live ISO desktop-payload guards.

Added

  • Mango + DankMaterialShell desktop option (desktop.profile = "mango"): gui-wm/mangowm 0.17.2 (wlroots 0.20) plus gui-apps/dankmaterialshell 1.5.3 / Quickshell 0.3.1 / scenefx 0.5, installed through the GURU community overlay with scoped ~amd64 keywords (never global). The installer writes GURU's repos.conf, bootstraps dev-vcs/git, and syncs the overlay. A phoebus-session-mango entry point, a packaged Mango config seeded once into the user's config, DMS keybindings, a mango-session.target binding for DMS, and phoebus-mango.desktop/phoebus-dwl.desktop session entries are generated. dwl remains the fallback session and is installed alongside. The profile is selectable but not promoted to default pending graphical-VM verification (ADR 0009).

2026-09-21 — Coherent rollback, installed assistant, Nix isolation

Added

  • Coherent rollback and recovery (phoebus-core::rollback, phoebus-executor::rollback): a recovery point now captures @ and the separately mounted @var (Portage state) under one name; rollback creates a writable root generation, rewrites the restored root's fstab and the BLS rootflags=subvol=, selects a boot entry whose kernel modules match the restored /lib/modules, and writes "previous" and snapshot-based "recovery" entries. A persisted rollback-state.toml makes interruption safe and resumable; retention prunes old snapshots and protects in-flight targets; a 1 GiB free-space check gates the operation. See ADR 0007.
  • sys undo / sys undo <id> / sys undo status and the high-risk undo typed action. The installer now records a snapshot-based "Phoebus Recovery" entry at install time, so recovery does not depend on the live root.
  • Installed conversational assistant (phoebus-ai::assistant, sys ask <request>): bounded facts -> typed plan -> concrete resolved effects -> approval/authentication -> deterministic execution -> transaction record. No model is required: sys ask falls back to the deterministic parser.
  • OS-level model sandbox (phoebus-executor::sandbox): the network call runs in a hardened, unprivileged transient systemd unit (DynamicUser, ProtectHome, ProtectSystem=strict, NoNewPrivileges, syscall and address-family filters). It fails closed when systemd-run is unavailable.
  • Resolved package effects and approval binding (phoebus-core::effects): emerge --pretend is parsed into additions/upgrades/downgrades/removals with source-vs-binary provenance and download size; a plan digest binds approval, and a material change between review and execution aborts. New bounded typed actions flatpak_install/flatpak_remove/flatpak_list and nix_prepare.
  • Transaction log (phoebus-core::transaction): assistant and sys actions record their actions, result and recovery point; sys history shows snapshots and transactions.
  • Desktop completeness: phoebus-menu (wofi drun launcher + power menu), phoebus-lock (swaylock), phoebus-idle (swayidle: lock, suspend, before-sleep lock) and a system-wide Waybar config with network, audio, battery, clock and power controls.
  • Release gates (phoebus-installer::release): a registry of the real candidate checks (install, detached boot, desktop, updates/rollback, no-model), a gate report that never records an unexecuted check as passed, atomic publication that preserves the last known-good latest.iso.prev, and signing/verification command helpers.
  • New VM harness for the Debian-Live appliance: installer/tests/vm/appliance-driver.py, appliance-guest.sh and appliance-test.conf.example.

Changed

  • Nix build isolation is enforced: sandbox = true, sandbox-fallback = false, with store bounds (min-free/max-free) and auto-optimise-store. Lifecycle operations (remove/purge, gc) and a bounded nix_prepare action were added; the Portage-owned ebuild approach is documented in ADR 0008. See ADR 0006.
  • Desktops install swayidle/swaylock session helpers and a Waybar configuration; phoebus-session starts the idle daemon.

Added

  • Nix bootstrap (on by default, VM-verified). phoebus-executor::nix fetches the pinned, SHA-256-verified official Nix release and bootstraps it into the target with discrete commands (store copy, nix-store --load-db, nixbld users, state dirs, profile and daemon units). A desktop VM confirmed nix-daemon.service active and nix shell nixpkgs#hello printing Hello, world!. A binary ebuild was ruled out: the upstream installer has no DESTDIR and runs nix-store --load-db against the real root.
  • finalize now flushes the target (sync) before unmounting, so late writes such as /usr/local/bin/phoebus-session and the exported installer log are on disk even after a forced poweroff.

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 actions). They are deterministic Portage operations with no model involved — emerge resolves 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. See docs/PLAN-DEBIAN-LIVE.md and 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-level AGENTS.md.
  • .gitignore covering 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.
  • sys history and update preparation are VM-verified on a Btrfs install.

Changed

  • phoebus-session now starts dwl first, waits for the Wayland socket before launching waybar/mako/swaybg, establishes XDG_RUNTIME_DIR and a session bus, starts the polkit authentication agent, and reaps helpers on logout.
  • Portage policy: the unused installkernel uki flag 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 --buildpkgonly is skipped because dependencies must be merged first, and the state note now includes the redacted Portage reason.

Fixed

  • A high-risk sys action now creates its protective snapshot inside actions::execute and fails closed if the .snapshots subvolume 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 through Exec, SHA-256 verification, fail-closed placeholder checks, extraction and config writer (7 unit tests).
  • --bootstrap-opencode on the CLI; PHOEBUS_OPENCODE_MANIFEST overrides the embedded manifest for fixture verification.
  • cli_coverage and 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.md and installer/doc/FINDINGS.md moved to docs/.

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 tagged v0.1.0-bash-reference. The disposable VM harness under installer/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 InstallConfig supporting TOML and the legacy flat format.
  • TargetRoot (host/target path safety), SecretString/Redactor, DestructiveAuthorization, central Exec command 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 SystemAction schema, privileged broker, and the sys command.
  • AI privacy boundary (PrivacyPolicy, ContextBundle, forbidden paths).
  • Release tooling: phoebus-release manifest/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/tmp breaking kernel-install.
  • installkernel requiring uki_generator even for BLS.
  • dracut crypt module and systemd-cryptsetup missing.
  • LUKS cmdline using rd.luks.uuid instead of rd.luks.name.
  • dracut UKI missing the kernel command line (BLS adopted).
  • @swap not 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: systemd PID 1, is-system-running = running, 0 failed units, 10.73 s boot.
  • Desktop stack headless: dwl, waybar, mako, swaybg, grim screenshot, 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 + dialog installer (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, and local root="$1" dir=... bugs (these are the class of bug the Rust port is designed to prevent).