docs: factual-drift pass + i2c option docs (#47, #48)

Fix documentation drift (each claim verified against code): theme count
21→24; waybar whole-swap lists (waybar.css=5 incl. neon-glass vs
waybar.jsonc parity=4 + boreal); idle "suspend 30"→"15 min battery-only";
Tailscale sudo→operator; hosts/live.nix "No installer yet" header; link
docs/MIGRATION.md + fix its placeholder URL; README layout tree
(+doctor/control-center/battery-notify); OVERRIDES swappy→satty; document
always-on home pieces. String fixes: keybind cheatsheet
nmtui→networkmanager_dmenu; complete nomarchy-menu usage string
(+doctor/firmware/controlcenter/rollback). Add README rows for
nomarchy.hardware.i2c.* (#48) — closes checks.option-docs.

Implemented by a worktree agent; diff reviewed and cherry-picked.
Verified V0 (flake check) + checks.option-docs green + V1 (HM build).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

agent/BACKLOG.md

@@ -114,32 +114,6 @@ Next slice: on hardware, run `hyprctl clients` while each is open, read
 the real `class`, then append rules. Also revisit whether blueman/s-c-p
 actually float once seen (regex tolerance for the `.…-wrapped` form).
 
-### 47. Docs + string factual-drift pass (promoted 2026-07-09)
-Pure docs (V0) plus two `.nix` string fixes (V1: HM build). One pass or split:
-- **README/docs drift:** theme count **21 → 24** (`README.md`,
-  `docs/TESTING.md`, `templates/downstream/README.md`); waybar whole-swap
-  list → summer-day/summer-night/executive-slate/boreal/neon-glass (drop the
-  catppuccin/lumon/nord/retro-82 stubs); idle table "suspend **30**" →
-  **15 min battery-only** (`idle.nix`); Tailscale row `sudo tailscale up` →
-  operator/no-sudo; `hosts/live.nix` header "No installer yet" → current;
-  CONVENTIONS parity list add **boreal**.
-- **Secondary docs:** README layout tree add doctor/control-center/
-  battery-notify; link `docs/MIGRATION.md` from README nav + fix its
-  placeholder flake-init URL; OVERRIDES.md screenshot pipe swappy → **satty**.
-- **Document always-on home pieces:** easyeffects/udiskie/cliphist ship with
-  no toggle by design — a short README note + override pointer.
-- **String fixes (V1):** keybind cheatsheet `desc = "Network (nmtui)"` →
-  networkmanager_dmenu (`keybinds.nix`); complete the `nomarchy-menu` usage
-  string (add doctor/controlcenter/rollback/firmware/…, `rofi.nix`).
-Verify any documented command by running it.
-
-### 48. Document `nomarchy.hardware.i2c.*` — close checks.option-docs (promoted 2026-07-09)
-`nomarchy.hardware.i2c.enable` and `.ddcci` (`modules/nixos/hardware.nix`)
-have no README table rows → `checks.option-docs` is red. Add rows (+ note the
-effective default: option default `false` but distro `mkDefault true` for
-ddcci in `modules/nixos/default.nix`). Optional template opt-in comment.
-V0 — `checks.option-docs` verifies (pure runCommand, no VM).
-
 ### 49. Pure-contract `checks.*` batch — no VM (promoted 2026-07-09)
 Add pure runCommand checks (all V0):
 - Expand CI `py_compile` to **all** tracked `*.py` (compose-lock, tools/*,

agent/CONVENTIONS.md

@@ -45,8 +45,8 @@ those, it probably shouldn't exist.
 - **Waybar:** new indicators self-gate (hidden when irrelevant), use
   named `writeShellScriptBin`s on PATH (so static configs can exec them
   by bare name), and are added to **both** the generated `waybar.nix`
-  config **and** every `waybar.jsonc` whole-swap — summer-day, summer-night
-  and executive-slate (the parity rule).
+  config **and** every `waybar.jsonc` whole-swap — summer-day, summer-night,
+  executive-slate and boreal (the parity rule).
 - **Theming:** every new visual surface consumes the palette from the
   state JSON. There is no second renderer to keep in sync — add the key
   to the JSON, consume it in the module.

agent/JOURNAL.md

@@ -17,6 +17,24 @@ Template:
 
 ---
 
+## 2026-07-09 — #47+#48 docs/string factual-drift pass (delegated, worktree)
+- **Task:** NEXT #47 (docs + string drift) + #48 (i2c option-docs). Delegated
+  to a worktree sonnet agent, parallel with #46 VM + the #49 agent, no shared
+  files.
+- **Did:** Agent fixed every drift after verifying each claim against code:
+  theme count 21→24 (README ×3, TESTING, template), waybar whole-swap list
+  (correctly split waybar.css=5 incl. neon-glass vs waybar.jsonc parity=4 +
+  boreal), idle 30→15min-battery-only, Tailscale sudo→operator, live.nix
+  header, MIGRATION link + URL, README layout tree (+doctor/CC/battery-notify),
+  OVERRIDES swappy→satty, always-on note; keybind nmtui→networkmanager_dmenu;
+  nomarchy-menu usage string (+doctor/firmware/controlcenter/rollback). Added
+  README i2c rows (#48). Reviewed the diff, cherry-picked onto main.
+- **Verified:** V0 flake check green; `checks.option-docs` now **green** (85
+  options, no stale rows) — closes #48; V1 HM generation builds (usage string +
+  keybind label confirmed in the built output). Re-run on main after cherry-pick.
+- **Pending:** none — docs/config, fully verified at their tier.
+- **Next suggestion:** land #49 (checks batch); then #50.
+
 ## 2026-07-09 — Promote V0/V1 PROPOSED items → NEXT #47–50 (Bernardo-directed)
 - **Task:** Bernardo asked to bump the non-V2 PROPOSED items into NEXT (to
   feed parallel worktree agents that can't touch the VM). Triage is his call;