diff --git a/agent/BACKLOG.md b/agent/BACKLOG.md index 32d2301..24a624b 100644 --- a/agent/BACKLOG.md +++ b/agent/BACKLOG.md @@ -107,14 +107,33 @@ 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. -_(#80–#83 + #85–#87 shipped 2026-07-11. Dock V3 residuals: #86 - clamshell + #87 audio on real hardware → HARDWARE-QUEUE.)_ +- **Post-install hardware hints** (`VISION § B`) — After the general + “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 -See **VISION**. Open PROPOSED: NVIDIA wrappers deferred past v1; IR -portal (b)/(c) need T14s hardware (HARDWARE-QUEUE § T14s). Standing -calls: browser default = Chromium; power backend = PPD. +See **VISION** (suggested slices rewritten 2026-07-11). Open PROPOSED: +post-install hardware hints; neon-glass finish/quarantine `[human]`; +NVIDIA deferred past v1; IR portal (b)/(c) need T14s hardware +(HARDWARE-QUEUE § T14s). Standing calls: browser = Chromium; power = PPD. ## Decisions `[human]` diff --git a/agent/JOURNAL.md b/agent/JOURNAL.md index 668a66b..836b8ec 100644 --- a/agent/JOURNAL.md +++ b/agent/JOURNAL.md @@ -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) - **Task:** QA sweep — NEXT only has #76 `[blocked:hw]`; no other actionable items. diff --git a/docs/VISION.md b/docs/VISION.md index 33f0a65..1bd0c32 100644 --- a/docs/VISION.md +++ b/docs/VISION.md @@ -51,15 +51,17 @@ Steam Deck, docs website, binary cache. ## Theme A — Day-2 confidence (highest product ROI) 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 | -|------|--------|-------------| -| **System › Firmware** | fwupd is on but CLI-only; menu: refresh → list → confirm → update (never auto-flash) | BACKLOG Hardware product | -| **Fingerprint menu** | Enroll/list when fprintd present; optional PAM + rebuild note | BACKLOG Hardware product | -| **Doctor hardware section** | NM, sink, optional GPU smoke, fprintd, fwupd pending, charge threshold | BACKLOG Hardware product | -| **Machine health entry** | One System row → doctor (not five submenus) | Menu / doctor | -| **Human rebuild errors** | On failed switch, point at last log lines + `nomarchy-doctor` | pkgs / menu | -| **HM pre-activate fail flag** ✓ | Durable recovery one-liner on target if bake failed | ✓ shipped #83 — doctor first-boot row + install-time hint | +| Idea | Intent | Status | +|------|--------|--------| +| **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 | ✓ shipped #55; V3 enroll HARDWARE-QUEUE | +| **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 | ✓ System › Doctor + Waybar tripwire | +| **Human rebuild errors** ✓ | Failed switch → last log lines + `nomarchy-doctor` | ✓ shipped #56 | +| **HM pre-activate fail flag** ✓ | Recovery one-liner if theme bake failed | ✓ shipped #83 | 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 | |------|--------|-------| | **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? | -| **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 | |------|--------|-------| | **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) | -| **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) -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) -2. `VISION § A` — System › Firmware (fwupd wrapper) -3. `VISION § A` — doctor hardware section (read-only checks) -4. `VISION § A` — fingerprint enroll menu (self-gated) -5. `VISION § B` — first-boot dismissible tips (one surface) -6. `VISION § A` — human-facing rebuild failure hint -7. `VISION § v1.0` — install P0 contracts (swap / unattended LUKS) -8. `VISION § D` — neon-glass quarantine or finish -9. `VISION § F` — Omarchy migrant doc (short) -10. `VISION § H` — HARDWARE-QUEUE session notes only Bernardo runs +1. `VISION § B` — post-install hardware hints (self-gated first-session + toast when `fwupdmgr` / `fprintd-list` exist; one-shot markers; no nag) +2. `VISION § D` — neon-glass: finish visual polish **or** quarantine + (human taste call; contrast already gated) +3. `VISION § D` / LATER — wallpapers artifact split (decided deferred; + promote only if theme-switch latency still hurts after measurement) +4. `VISION § H` — HARDWARE-QUEUE burn-down (human-only V3; agents only + append exact steps) +5. `VISION § v1.0` — install P0 re-verify before any `v1` fast-forward + (swap=0 / unattended LUKS contracts; human ships the pointer) -Larger themes (dock life, time-of-day theme, wallpapers split) stay -`[big]` until split. +Do **not** re-open Theme A firmware/fingerprint/doctor/rebuild rows — +those shipped. Dock/hibernate agent work is done; residual is V3 hardware.