docs(vision): mark shipped Theme A/B/C; refresh PROPOSED
Some checks failed
Check / eval (push) Has been cancelled

VISION was still listing Firmware/Fingerprint/doctor/rebuild as open
work after they shipped. Sync ✓ rows + rewrite suggested agent slices.
PROPOSED: post-install hardware hints; neon-glass finish-or-quarantine.

Verified: V0 (docs/backlog only). Queue remains #76 [blocked:hw] only.
This commit is contained in:
Bernardo Magri
2026-07-11 10:59:11 +01:00
parent 9e8433e4d6
commit fc63feaa9d
3 changed files with 65 additions and 30 deletions

View File

@@ -107,14 +107,33 @@ high-ROI, etc.) live in the journal + ROADMAP — not here.*
2026-07-10). Keep #59 commented install guidance; no 2026-07-10). Keep #59 commented install guidance; no
`nomarchy.hardware.nvidia.*` until a hybrid maintainer + queue. `nomarchy.hardware.nvidia.*` until a hybrid maintainer + queue.
_(#80#83 + #85#87 shipped 2026-07-11. Dock V3 residuals: #86 - **Post-install hardware hints** (`VISION § B`) — After the general
clamshell + #87 audio on real hardware → HARDWARE-QUEUE.)_ “you're set” card (#81), optionally fire **one** additional
self-gated notify when the machine actually has the hardware:
(a) `fwupdmgr` on PATH → “System Firmware to check LVFS updates”;
(b) `fprintd-list` on PATH → “System Fingerprint to enroll”.
One-shot markers in `settings.*` (same in-checkout discipline as
`firstBootShown`); never a permanent MOTD nag. Cost: small — extend
`nomarchy-first-boot` or a sibling oneshot + `checks.first-boot`
fixture. Control-center / MOTD already mention these; the gap is the
silent first *graphical* session for people who never open those.
- **neon-glass finish or quarantine** (`VISION § D`) `[human]` — Theme
still ships (`themes/neon-glass/`). Either invest a visual polish pass
(whole-swap CSS + preview + theme-shot) or stop recommending it
(picker demote / docs “experimental”). Needs a taste call before an
agent burns a theme iteration.
_(#80#83 + #85#87 shipped 2026-07-11. Theme A day-2 menu/doctor
surfaces largely shipped earlier — see VISION ✓ table. Dock/hibernate
V3 residuals → HARDWARE-QUEUE.)_
### v1.0 pointer ### v1.0 pointer
See **VISION**. Open PROPOSED: NVIDIA wrappers deferred past v1; IR See **VISION** (suggested slices rewritten 2026-07-11). Open PROPOSED:
portal (b)/(c) need T14s hardware (HARDWARE-QUEUE § T14s). Standing post-install hardware hints; neon-glass finish/quarantine `[human]`;
calls: browser default = Chromium; power backend = PPD. NVIDIA deferred past v1; IR portal (b)/(c) need T14s hardware
(HARDWARE-QUEUE § T14s). Standing calls: browser = Chromium; power = PPD.
## Decisions `[human]` ## Decisions `[human]`

View File

@@ -19,6 +19,20 @@ Template:
--- ---
## 2026-07-11 — VISION hygiene + PROPOSED (queue empty)
- **Task:** QA/docs loop — NEXT still only #76 `[blocked:hw]`; no product
item to implement without inventing work.
- **Did:** Marked Theme A/B/C shipped rows in `docs/VISION.md` (Firmware
#43, Fingerprint #55, doctor stack, rebuild errors #56, Boreal default,
hibernate confidence #77). Rewrote “Suggested agent slices” to open
work only. PROPOSED: post-install hardware hints; neon-glass
finish/quarantine `[human]`.
- **Verified:** **V0** — docs/backlog only (no module change). Prior
iterations V2 suite still stands; no regression claimed here.
- **Pending:** human triage of PROPOSED; HARDWARE-QUEUE V3.
- **Next suggestion:** promote post-install hints → NEXT, or human
HARDWARE-QUEUE / neon-glass call.
## 2026-07-11 — QA sweep (queue empty but #76) ## 2026-07-11 — QA sweep (queue empty but #76)
- **Task:** QA sweep — NEXT only has #76 `[blocked:hw]`; no other - **Task:** QA sweep — NEXT only has #76 `[blocked:hw]`; no other
actionable items. actionable items.

View File

@@ -51,15 +51,17 @@ Steam Deck, docs website, binary cache.
## Theme A — Day-2 confidence (highest product ROI) ## Theme A — Day-2 confidence (highest product ROI)
The install is already strong. The gap is **after** first boot. The install is already strong. The gap is **after** first boot.
Most of this theme **shipped** mid-2026; residual is V3 hardware QA +
optional polish.
| Idea | Intent | Likely home | | Idea | Intent | Status |
|------|--------|-------------| |------|--------|--------|
| **System Firmware** | fwupd is on but CLI-only; menu: refresh → list → confirm → update (never auto-flash) | BACKLOG Hardware product | | **System Firmware** | fwupd menu: refresh → list → confirm → update (never auto-flash) | ✓ shipped #43 (+ V2 #43 render) |
| **Fingerprint menu** | Enroll/list when fprintd present; optional PAM + rebuild note | BACKLOG Hardware product | | **Fingerprint menu** | Enroll/list when fprintd present; optional PAM + rebuild note | ✓ shipped #55; V3 enroll HARDWARE-QUEUE |
| **Doctor hardware section** | NM, sink, optional GPU smoke, fprintd, fwupd pending, charge threshold | BACKLOG Hardware product | | **Doctor hardware section** | NM, sink, GPU smoke, fprintd, fwupd, charge, battery health, hibernate | ✓ shipped #44 + #77 + #80 + #83 |
| **Machine health entry** | One System row → doctor (not five submenus) | Menu / doctor | | **Machine health entry** | One System row → doctor | ✓ System Doctor + Waybar tripwire |
| **Human rebuild errors** | On failed switch, point at last log lines + `nomarchy-doctor` | pkgs / menu | | **Human rebuild errors** ✓ | Failed switch last log lines + `nomarchy-doctor` | ✓ shipped #56 |
| **HM pre-activate fail flag** ✓ | Durable recovery one-liner on target if bake failed | ✓ shipped #83 — doctor first-boot row + install-time hint | | **HM pre-activate fail flag** ✓ | Recovery one-liner if theme bake failed | ✓ shipped #83 |
Reference: [HARDWARE.md](HARDWARE.md) §4§5, §11 (doctor). Reference: [HARDWARE.md](HARDWARE.md) §4§5, §11 (doctor).
@@ -70,9 +72,9 @@ Reference: [HARDWARE.md](HARDWARE.md) §4§5, §11 (doctor).
| Idea | Intent | Notes | | Idea | Intent | Notes |
|------|--------|-------| |------|--------|-------|
| **Silent first-week card** ✓ | One dismissible “youre set” (menu, themes, keys, network) — not a wizard | ✓ shipped #81`settings.firstBootShown` + notify; live ISO keeps its own toast | | **Silent first-week card** ✓ | One dismissible “youre set” (menu, themes, keys, network) — not a wizard | ✓ shipped #81`settings.firstBootShown` + notify; live ISO keeps its own toast |
| **Boreal as default** | Identity on first boot | BACKLOG PROPOSED already | | **Boreal as default** | Identity on first boot | ✓ seed `theme-state.json` + install path use Boreal (2026-07-09) |
| **Generation readability** ✓ | “What changed last rebuild” in plain language | ✓ shipped #82 — nvd toast + System What changed? | | **Generation readability** ✓ | “What changed last rebuild” in plain language | ✓ shipped #82 — nvd toast + System What changed? |
| **Post-install hints** | One-shot MOTD/notify for fwupd / fprintd when relevant | Avoid permanent nag | | **Post-install hints** | One-shot MOTD/notify for fwupd / fprintd when relevant | Partial: MOTD + control-center tips; still no self-gated *first-session* toast when hardware is present (see BACKLOG PROPOSED) |
--- ---
@@ -81,9 +83,9 @@ Reference: [HARDWARE.md](HARDWARE.md) §4§5, §11 (doctor).
| Idea | Intent | Notes | | Idea | Intent | Notes |
|------|--------|-------| |------|--------|-------|
| **Dock life** ✓ | Lid closed + external only, wake, default audio sink on undock | ✓ #86 clamshell logind; ✓ #87 WirePlumber HDMI/USB priority (V3 hotplug QA) | | **Dock life** ✓ | Lid closed + external only, wake, default audio sink on undock | ✓ #86 clamshell logind; ✓ #87 WirePlumber HDMI/USB priority (V3 hotplug QA) |
| **Hibernate/sleep confidence** | Doctor: resume device, swap size, clean suspend journal | Trust > new power UI | | **Hibernate/sleep confidence** | Doctor: resume device, swap size, clean suspend journal | ✓ shipped #77 (+ #76 agent V0V2; V3 power-cycle HARDWARE-QUEUE) |
| **Battery health readout** ✓ | Cycles + design capacity % in doctor where sysfs allows | ✓ shipped #80 (report-only; charge limit is a separate row) | | **Battery health readout** ✓ | Cycles + design capacity % in doctor where sysfs allows | ✓ shipped #80 (report-only; charge limit is a separate row) |
| **Charge-limit instant apply** | Already PROPOSED `[blocked:hw]` | Keep privilege tradeoff explicit | | **Charge-limit instant apply** | Live sysfs write without rebuild | Shipped menu live-write path 2026-07-10; residual V3 Dell Adaptive / non-BAT* in HARDWARE-QUEUE |
--- ---
@@ -150,18 +152,18 @@ From GOALS non-goals and installer audits — do not “fill the roadmap” with
## Suggested agent slices (promote via PROPOSED → NEXT) ## Suggested agent slices (promote via PROPOSED → NEXT)
Small enough for one iteration each; reference this file: **Still open** (as of 2026-07-11). Shipped items above are *not* open work.
1. `VISION § v1.0`default theme → boreal (seed state + fallbacks) 1. `VISION § B`post-install hardware hints (self-gated first-session
2. `VISION § A` — System Firmware (fwupd wrapper) toast when `fwupdmgr` / `fprintd-list` exist; one-shot markers; no nag)
3. `VISION § A`doctor hardware section (read-only checks) 2. `VISION § D`neon-glass: finish visual polish **or** quarantine
4. `VISION § A` — fingerprint enroll menu (self-gated) (human taste call; contrast already gated)
5. `VISION § B` — first-boot dismissible tips (one surface) 3. `VISION § D` / LATER — wallpapers artifact split (decided deferred;
6. `VISION § A` — human-facing rebuild failure hint promote only if theme-switch latency still hurts after measurement)
7. `VISION § v1.0`install P0 contracts (swap / unattended LUKS) 4. `VISION § H`HARDWARE-QUEUE burn-down (human-only V3; agents only
8. `VISION § D` — neon-glass quarantine or finish append exact steps)
9. `VISION § F`Omarchy migrant doc (short) 5. `VISION § v1.0`install P0 re-verify before any `v1` fast-forward
10. `VISION § H` — HARDWARE-QUEUE session notes only Bernardo runs (swap=0 / unattended LUKS contracts; human ships the pointer)
Larger themes (dock life, time-of-day theme, wallpapers split) stay Do **not** re-open Theme A firmware/fingerprint/doctor/rebuild rows —
`[big]` until split. those shipped. Dock/hibernate agent work is done; residual is V3 hardware.