docs(agent): clean QA sweep + VISION-gap pass (3 PROPOSED)
All checks were successful
Check / eval (push) Successful in 3m44s

QA/drift sweep: deterministic checks + bash -n/py_compile all pass
(the 4 "needs-args" scripts pass via their flake derivations); drift
recon found none (dead code, stale refs, TODOs, changed-area
contradictions, counts all clean — 24 presets/previews consistent);
eval sweep green. No fixes needed.

VISION-gap pass: verified candidates against the tree first, which
killed two false gaps (nomarchy-rebuild/home already tail logs + point
at doctor on failure = §A; nvd diff = §B; Firmware menu already exists).
Filed three verified-open PROPOSED items: doctor hibernate/sleep section
(§C, natural #76 follow-on), Omarchy migrant one-pager (§F), auto
time-of-day theme pair (§D, big). Await human triage.

Verification: V0 (agent-notes/docs only); flake check --no-build green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Bernardo Magri
2026-07-10 20:51:36 +01:00
parent dc33694a56
commit cf97f5605d
2 changed files with 56 additions and 2 deletions

View File

@@ -99,6 +99,17 @@ high-ROI, etc.) live in the journal + ROADMAP — not here.*
### Product / day-2
- **Doctor: hibernate/sleep section** (`VISION § C`) — the doctor covers
units/disk/flake/network/audio/GPU/fingerprint/fwupd/charge but has **no**
hibernate check, even though #76 just made hibernation a default. Add a
read-only section: `resume=`+`resume_offset` present on `/proc/cmdline`
(or acknowledge the `swap=0` opt-out), a disk swap ≥ RAM present, zram
active at its priority, and no failed suspend/resume in the recent journal.
Self-gating (skip when swap=0). Why: "trust > new power UI." Cost: ~1
iteration, V2-guardable — the highest-ROI Day-2 gap found + a natural #76
follow-on. (Verified 2026-07-10: no resume/swap/hibernate lines in
`nomarchy-doctor.sh`.)
_(Battery charge-limit instant → shipped 2026-07-10; V3 PASS Latitude
5310: Custom charge type + live menu + unplug re-apply.)_
@@ -123,6 +134,17 @@ _(Friendlier mkFlake theme-state errors → **#66**.)_
### Theme polish
- **Auto time-of-day theme pair** (`VISION § D`) `[big]` — no scheduled
light/dark theme switch exists today (only night-light gamma via hyprsunset
+ wallpaper `bg auto`). Let a user pair two shipped themes (e.g.
summer-day ↔ summer-night) and switch on a schedule/sunset through the
**existing** engine — a systemd timer running `nomarchy-theme-sync apply
<slug>` — staying one theme engine (GOALS: no second pipeline). Split
before starting: (a) state schema for the pair + schedule, (b) the timer/
hook, (c) menu surface. Cost: multi-slice; verify each `apply` still bakes
one clean generation. (Verified 2026-07-10: no time-of-day/auto-theme
scheduler in the tree.)
_(#52 residual ANSI → **#68** ✓.)_
_(Fidelity / hierarchy nits → **#67** ✓.)_
_(Import pipeline hierarchy → **#70** ✓.)_
@@ -135,10 +157,22 @@ _(Identity taste retunes + hand `btop.theme` for white/vantablack/lumon/
hackerman/matte-black/miasma/neon-glass/boreal/executive-slate →
shipped 2026-07-10.)_
### Docs / narrative
- **Omarchy migrant one-pager** (`VISION § F`) — no Omarchy→Nomarchy guide
exists (MIGRATION.md is NixOS→Nomarchy; RECOVERY is recovery). Omarchy is
the closest sibling and the likeliest source of new users. A short `docs/`
page mapping the deltas: keybindings, the theme system (`nomarchy-theme-sync`
vs Omarchy's), the install path (ISO vs Arch script), and what feels the
same (Hyprland/Waybar). Docs-only, low-risk, adoption-facing. Cost: small.
(Verified 2026-07-10: no "omarchy" mentions in docs beyond VISION's idea.)
### v1.0 pointer
See **VISION**. Open PROPOSED: NVIDIA wrappers deferred past v1; IR
portal (b)/(c) hardware. Browser default = Chromium; power = PPD.
See **VISION**. Open PROPOSED: doctor hibernate section (`§C`, top Day-2
pick); Omarchy migrant doc (`§F`); auto time-of-day theme pair (`§D`, big);
NVIDIA wrappers deferred past v1; IR portal (b)/(c) hardware. Browser
default = Chromium; power = PPD.
## Decisions `[human]`