From 5b93b97191a90f8342b0640ad481f8197f19b29e Mon Sep 17 00:00:00 2001 From: Bernardo Magri Date: Fri, 10 Jul 2026 09:39:59 +0100 Subject: [PATCH] =?UTF-8?q?docs(agent):=20close=20NEXT=20#64=E2=80=93#73?= =?UTF-8?q?=20after=20parallel=20land?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Landed worktree batch: migration docs, installer chown, theme-state reader, theme fidelity, audit/import tools, IR docs, template-sot check, hardware MOTD tips. Verified contrast + template-sot + flake check. --- agent/BACKLOG.md | 54 ------------------------------------------------ agent/JOURNAL.md | 11 ++++++++++ 2 files changed, 11 insertions(+), 54 deletions(-) diff --git a/agent/BACKLOG.md b/agent/BACKLOG.md index 0c86ac0..ec76617 100644 --- a/agent/BACKLOG.md +++ b/agent/BACKLOG.md @@ -28,60 +28,6 @@ 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. diff --git a/agent/JOURNAL.md b/agent/JOURNAL.md index 8cde88c..4692f25 100644 --- a/agent/JOURNAL.md +++ b/agent/JOURNAL.md @@ -17,6 +17,17 @@ Template: --- +## 2026-07-10 — Loop batch land #64–#73 (parallel worktrees) +- **Task:** agent-actionable NEXT #64–#73 via worktree agents; land on main. +- **Did:** #64 MIGRATION snapshots · #65 real-uid chown · #66 theme-state + fail-closed reader · #67/#68 theme fidelity+ANSI · #69/#70 audit+import + tools · #71 IR portal docs · #72 template-sot check · #73 MOTD/first-boot + fingerprint+doctor tips. Agents did not push; parent cherry-picked + (stripped agent BACKLOG races). Closed #64–#73. +- **Verified:** **V0/V1** — theme-contrast 24×7 pass; template-sot green; + bash -n install; flake check --no-build green. +- **Next suggestion:** #74 unattended matrix + #75 V2 install (KVM). + ## 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 ·