docs(vision): mark shipped Theme A/B/C; refresh PROPOSED
Some checks failed
Check / eval (push) Has been cancelled
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:
@@ -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]`
|
||||||
|
|||||||
@@ -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
|
||||||
|
iteration’s 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.
|
||||||
|
|||||||
@@ -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 “you’re 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 “you’re 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 V0–V2; 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.
|
||||||
|
|||||||
Reference in New Issue
Block a user