quarry: Artifact Description [df9ca90f52]

Artifact df9ca90f52ab2ba559d9f93c3b4a973f1c0e4cdf31096c62895516aa9d8db85a:

File docs/api.md
- 2026-08-25 14:45:17 — part of check-in [022966bc05] on branch fleet-ops — ops: the forge can see itself
  quarry could not answer two questions about its own behaviour. A render time was printed in the page footer and discarded, so a 4.24s files page was visible only to whoever loaded it and read the footer. Subprocess load was visible nowhere: a warm loop once ran 134 concurrent `zit ls --long` against the same hash, load average 546 on 14 cores, and /fleet said "all healthy" throughout.
  /fleet/ops, site-admin only. Slowest routes by p95 — a mean hides the tail, and the tail is the thing worth finding. Store subprocesses rolled up per verb, with the number that actually mattered: how many run at once, and the peak, which outlives the incident. Recent renders with ops time and the zit time inside it.
  Instrumented at the two seams that cover everything: the ops registry, which every page's data crosses, and the outermost middleware, which is the only place the template's own cost is known — the footer's breakdown is assembled before the template runs, so a page can never report the time it spent rendering itself.
  Datastar with no no-script path, deliberately: an internal dashboard that cannot move while an operator watches a fleet index is worth much less than one that can, and no consumer depends on it. The op behind it is registered and versioned like any other.
  The rings are small and in memory. This is the snapshot; history belongs in the analytics store behind obs.Sink, which is an interface with a no-op default so the persistent implementation can be cgo without the request path importing it. (user: dmestas, size: 37429) [annotate] [blame] [check-ins using]
- 2026-08-25 14:58:50 — part of check-in [2cacce9b01] on branch trunk — Accepted. The forge can see itself; the rest is history storage. (user: dmestas, size: 37429) [annotate] [blame] [check-ins using]