docs(agent): stability+usefulness survey #71 — 2 PROPOSED items
All checks were successful
Check / eval (push) Successful in 2m58s

Research iteration (LOOP §1). Findings: the state-file path is robust;
the real stability hole is the eval-only automated lock-bump gate (#14)
with no binary cache, whose true fix is the KVM-blocked #20. Usefulness:
the capture suite lacks a screenshot annotate step. Filed 2 PROPOSED —
an interim build-tier lock gate (no KVM) and a satty annotate step.
V0 (docs-only).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Bernardo Magri
2026-07-08 21:31:34 +01:00
parent db48bb85d5
commit b1a9d2ea66
2 changed files with 54 additions and 0 deletions

View File

@@ -324,6 +324,40 @@ implement. Bernardo moves accepted items into a tier.*
pairs with a hardware-queue session. Recommend (a) now, (b)
investigated when the T14s is next available.
- **[stability] Interim build-tier gate for automated lock bumps**
(surfaced by the 2026-07-08 stability survey, iteration #71). Today
`.gitea/workflows/bump.yml` pushes a lock bump to `main` on the
**eval tier only** (`nix flake check --no-build`), and Nomarchy ships
**no binary cache** — so users pull `main` and *compile* whatever
landed. A bump that evaluates but fails to *build* (a dropped patch, an
IFD/Stylix break, an upstream package that no longer compiles) reaches
users as a broken `home-update`/`sys-rebuild`. Item 20 (VM suite in CI)
is the real fix but is `[human]`-blocked on a KVM runner. Cheap interim
that needs **no KVM**: have the bump gate additionally *build*
`homeConfigurations.nomarchy.activationPackage` and
`nixosConfigurations.nomarchy.config.system.build.toplevel` before the
push (V1 tier — catches build-time breakage eval misses). Cost/open
question: the docker `act_runner` compiles Nomarchy's own derivations
from source (cache.nixos.org still serves upstream), so a full toplevel
build could be slow/heavy — measure once; if too heavy, gate on the HM
activation package alone (the surface most bumps touch). Does not
replace item 20; it raises the floor until item 20 lands.
- **[usefulness] Screenshot annotation step (satty)** (surfaced by the
2026-07-08 usefulness survey, iteration #71). The capture suite is rich
(region/screen → clipboard or timestamped file, OCR, recording) but has
**no annotate step** — you can't arrow/box/blur/crop before sharing,
the single common workstation gap left. Add `satty` (Wayland-native,
themeable) and an "annotate" path: e.g. `grim -g "$(slurp)" - | satty
--filename -` with save-to-`~/Pictures/Screenshots` + copy-to-clipboard
actions, wired as a Print-family keybind (SUPER+SHIFT+Print, or a
Tools ▸ Capture ▸ "Annotate region" row) with the cheatsheet entry.
Cost: small — one package + one keybind/menu row + satty theming to the
palette (its config takes colors). Verifiable to V1 headlessly (build +
bind renders); the annotate UI itself is V3-visual (queue it). Check
whether satty's palette knobs are enough to keep it on-theme or if it
needs a generated config file like the other surfaces.
## Decisions `[human]`
Open calls only Bernardo can make; agents add options/evidence but never