Point AGENTS.md, README.md and the docs at the Rust-only toolchain and the moved VM-BOOT-VERIFICATION.md, and drop the Bash installer from DEVELOPMENT.md.
105 lines
5 KiB
Markdown
105 lines
5 KiB
Markdown
# 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
|
||
|
||
### Added
|
||
- 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 — 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).
|