From 6b488d69ef733c355e600f4877a011aaa0af1b2e Mon Sep 17 00:00:00 2001 From: Bernardo Magri Date: Fri, 10 Jul 2026 09:29:01 +0100 Subject: [PATCH] =?UTF-8?q?docs(agent):=20promote=20agent-actionable=20PRO?= =?UTF-8?q?POSED=20=E2=86=92=20NEXT=20#64=E2=80=93#75?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Category 1 (no hw/human): MIGRATION, chown, mkFlake errors, theme fidelity nits, residual ANSI, audit exemptions, import pipeline, IR docs, SoT CI, hardware-hints residual. Category 2 (KVM): unattended matrix + SoT V2 install. Queue head is #64. --- agent/BACKLOG.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++ agent/JOURNAL.md | 12 +++++++++ 2 files changed, 75 insertions(+) diff --git a/agent/BACKLOG.md b/agent/BACKLOG.md index 3be67d7..96a8c7e 100644 --- a/agent/BACKLOG.md +++ b/agent/BACKLOG.md @@ -28,6 +28,69 @@ in [`docs/ROADMAP.md`](../docs/ROADMAP.md); map in ## NEXT +### 64. MIGRATION.md snapshot layout vs installer +Installer creates disko `@snapshots` → `/.snapshots` and a first-boot +oneshot for nested `/home/.snapshots`. MIGRATION still speaks of +top-level `@home-snapshots` (TuringMachine vocabulary). One paragraph +clarifying installer layout vs migration machines. Cost: docs only; V0. + +### 65. Installer soft gap: chown flake dir +`chown -R 1000:100` on the generated flake assumes first-user UID/GID. +Use the real install username’s uid/gid (or `id` after user create). +Cost: small; V0–V1. + +### 66. Fail-closed / friendlier theme-state errors in `mkFlake` +Missing or invalid `theme-state.json` should fail early with a pointer +to schema/docs, not a raw `readFile`/`fromJSON` stack. Related: +`settings.displayProfile*` defaults; unknown border role. Cost: medium +lib UX; V0–V1. + +### 67. Theme fidelity / hierarchy nits (popular ports) +gruvbox Material vs classic name+btop split; nord inverted subtext/text; +tokyo-night btop warm fg; ethereal surface=base; retro-82 surface +darker than base; ristretto subtext=text + btop bg drift; flexoki-light +bright-black. Cost: small JSON/btop each; V0 contrast + V1. + +### 68. #52 residual ANSI +**vantablack** `ansi[8]` still `#fdfdfd` (diverges from `muted #666666`); +**osaka-jade** `ansi[3]` still warn-green `#459451` while `warn` is +`#E5C736`. Treat as fidelity bugs (align with muted/warn). Cost: tiny +JSON; V0 contrast. + +### 69. audit-theme-design identity exemptions +Document expected CVD/hue noise for white/vantablack/lumon/hackerman/ +matte-black/miasma so audits don’t “fix” identity into traffic lights. +Optional special-case in the report script. Cost: docs or small script; V0. + +### 70. Import pipeline hierarchy when ANSI 0==8 +`tools/import-palettes.py` maps surface←color0, overlay←color8; when +0==8 (gruvbox, everforest) surface=overlay; light themes get sludge +mantle. Allow role overrides independent of ANSI; don’t re-import +without a hierarchy pass. Cost: tool + convention; V0. + +### 71. Portal/Flatpak IR camera — document (a) +Ship the recommended path only: document that the WirePlumber *v4l2* +IR-hide does not cover libcamera/Flatpak pickers (ROADMAP § Webcam). +Leave (b)/(c) engineering for a T14s session. Cost: docs; V0. + +### 72. Installer ↔ template SoT — CI parity check +Optional pure check that the install share ships the same template +files as `templates/downstream`. Cost: small tool + flake check; V0. + +### 73. Post-install hardware hints residual +#43 shipped Firmware MOTD/tip. Still open: fingerprint + doctor +one-liners (once or until dismissed). Cost: small greeter/MOTD/notify; +V1–V2. + +### 74. Unattended-install test matrix +`test-install.sh` always LUKS+swap; add (or document) no-swap and +explicit no-LUKS paths via env flags only. Cost: script + KVM time; V2. + +### 75. Installer template SoT — V2 install after ISO rebuild +HM pre-activate now pulls starter packages (larger closure). Run +`test-install.sh` (or equivalent) on a rebuilt live ISO and confirm +first boot still themed. Cost: ISO + KVM; V2. + ### 20. KVM runner → VM suite in CI `[human]` The remaining stretch of the CI item — checks-on-push is live and **green** (run #58; runner = gitea/act_runner docker, eval tier). diff --git a/agent/JOURNAL.md b/agent/JOURNAL.md index 4c94466..8cde88c 100644 --- a/agent/JOURNAL.md +++ b/agent/JOURNAL.md @@ -17,6 +17,18 @@ Template: --- +## 2026-07-10 — Promote agent-actionable PROPOSED → NEXT #64–#75 +- **Task:** Bernardo: bump non-hw/non-human PROPOSED categories 1+2. +- **Did:** **#64** MIGRATION snapshots · **#65** installer chown · + **#66** mkFlake theme-state errors · **#67** theme fidelity nits · + **#68** #52 residual ANSI · **#69** audit identity exemptions · + **#70** import-pipeline hierarchy · **#71** IR portal docs (a) · + **#72** template SoT CI · **#73** hardware hints residual · **#74** + unattended install matrix · **#75** SoT V2 install. Breadcrumbs in + PROPOSED; actionable items sit above #20/#41 in NEXT. +- **Verified:** V0 (backlog only). +- **Next suggestion:** queue head **#64** (docs) or batch #67/#68 themes. + ## 2026-07-10 — PROPOSED cleanup (stale exam residue) - **Task:** Bernardo: clean stale PROPOSED items after A/B/C + #52 ship. - **Did:** Rewrote PROPOSED to open work only — dropped #52 shipped