docs(backlog): six VISION-gap PROPOSED pitches (B/C/A-residual/F)
All checks were successful
Check / eval (push) Successful in 4m18s

VISION cross-checked against the tree: firmware menu, fingerprint,
doctor GPU/hibernate, rebuild-error hints, post-install hints and the
install contracts are shipped; the genuinely open gaps are filed as
PROPOSED with one-paragraph pitches — first-boot welcome card,
generation readability, battery health readout, doctor pre-activate
fail flag, dock life polish [big], hardware hall of fame.

Verification: V0 (backlog only).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Bernardo Magri
2026-07-11 09:44:56 +01:00
parent 53f75f6e1b
commit 56793c1c27

View File

@@ -107,6 +107,48 @@ high-ROI, etc.) live in the journal + ROADMAP — not here.*
2026-07-10). Keep #59 commented install guidance; no
`nomarchy.hardware.nvidia.*` until a hybrid maintainer + queue.
- **First-boot welcome card** (`VISION § B`) — one dismissible "you're
set" toast on the first session (SUPER+M menu, SUPER+T themes,
SUPER+? keys, network pointer) — a notification, **not** a wizard.
Needs a one-shot marker that respects "no state outside the checkout":
either key off HM generation №1 or a `settings.firstBootShown` write.
Cost: one iteration (swaync notify + gate + VM assert).
- **Generation readability** (`VISION § B`) — "what changed last
rebuild" in plain language: post-switch `nvd`/`nix store
diff-closures` summary (n packages up/down/added) surfaced as a toast
and/or a "What changed?" row beside System Rollback. Rollback lists
generations but the story is incomplete. Cost: one iteration; VM
assert on the diff text.
- **Battery health readout** (`VISION § C`) — report-only:
`cycle_count` + `charge_full/charge_full_design` % in a doctor
battery-health line (and optionally the Power menu). sysfs-gated so
desktops/VMs skip it. Cost: small, one iteration; extend
checks.doctor with a faked sysfs battery.
- **Doctor first-boot section: pre-activate fail flag** (`VISION § A`
residual) — the installer already leaves
`/var/log/nomarchy-hm-preactivate.log` on the target when the theme
bake fails, but nothing on the installed system points at it. Doctor
gains a first-boot line: if the log shows failure and the HM
generation is missing, print the recovery one-liner. Cost: small.
- **Dock life polish** (`VISION § C`) `[big]` — split before starting:
(a) clamshell — lid closed with external monitor connected must not
suspend (logind lidSwitchDocked/ExternalPower audit + display-profile
interplay), wake behaves; (b) default audio sink follows dock/undock
(switch to dock sink on plug, back to internal on unplug — WirePlumber
policy or a udev hook). Display profiles + auto-switch already exist;
this is the remaining edge-case pass.
### Docs / narrative
- **Hardware hall of fame** (`VISION § F`) — a HARDWARE.md
"install-tested machines" table (model, DMI, profile, date, notes)
seeded from the Latitude/dev-box sessions + a short "send your DMI
line" PR invite. Docs-only, one iteration.
### v1.0 pointer
See **VISION**. Open PROPOSED: NVIDIA wrappers deferred past v1; IR