2843ffde

docs: record the 2026-09-02 hygiene run

a73x 2026-09-02 09:28

Commit message

docs: record the 2026-09-02 hygiene run

docs/decisions.md

+with `[HOST]`, so the boot leg's absolute refusal bound moved 15 -> 16,
+re-derived the way its comment derives it (above complaint-plus-usage,
+below the ~20-line Debug panic floor).
+## 2026-09-02 — hygiene run: figures, dead pub, a socket leak filed
+**What was measured.** Every figure in CLAUDE.md's reading guide was
+re-run with `wc -l`: `client.zig` and `wallview.zig` had each grown a
+hundred lines past their stated size, one server test file and one wall test
+file sat a few lines over their "none over" bounds, and the comment ratio
+read 36% of Zig bytes as whole `//` lines, not the 44% stated (the method is
+now named beside the number). `tools/deadcode.sh` listed twenty `pub` decls
+referenced by nothing outside their own file; every one lost its `pub` and
+the compiler agreed. `client_core.zig` was the one module root without a
+`//!` header (collab 2432d35e, closed). `make check` and `make ci` green
+before and after: 107 e2e scenarios, 38 convergence points, agent 10/10,
+throughput within its bounds.
+**What was found and not fixed.** Five `mux-ask-<pid>.sock` files sat in
+the real `$XDG_RUNTIME_DIR`, every pid dead: the wall unlinks its prompt
+socket on the normal exit and on error returns, and nowhere else, so a
+wall that dies by SIGHUP or a kill leaves one per death. Filed as collab
+f97d2808 with the two fix shapes; the five were removed by hand. Patch
+d8a5 (collectLeafIds propagates its allocation failure, the forge-3
+spike's first product) cherry-picks cleanly onto main and passes
+`make check`; it is verified, not merged. `.zig-cache` is 124 GB on a disk
+with 272 GB free — not cleared, because a clear costs every build a cold
+start and nothing was blocked on the space. Also left as found, for the
+owner to decide: the `stash@{0}` of 2026-08-30, whose flagged comments in
+`main.zig` no longer exist; the `origin/worktree-web-client-spec` branch
+(one 2026-08-11 spec commit never merged); `wall` and `wall.bak` in the
+state dir, retired with the wall file; and sixteen `/tmp/e2e*.out`
+captures from 2026-09-01 hand runs.
+**What `/tmp` said.** 12,008 `mux-e2e-out-<pid>.*` captures from 161 dead
+runs over six days, the `.h*` suffixes of the hosts group — killed
+`E2E_ONLY` loops, since a run that reaches its trap sweeps `$OUT.*` and
+today's full `make ci` left none. Everything older than today was removed;
+today's 1,875 stayed. And 31 `mux-agent-<pid>-<hash>` dirs from dead
+daemons, four of them left by the green ci run itself, so the leak in
+collab 68dc4c90 is reached by the suite's own legs and the leak sweep does
+not count it; noted there, removed here.