Skip to content

docs(benchmarks): stop instructing a rebuild of an instrument that exists - #42

Merged
wshallwshall merged 1 commit into
mainfrom
bench
Jul 29, 2026
Merged

docs(benchmarks): stop instructing a rebuild of an instrument that exists#42
wshallwshall merged 1 commit into
mainfrom
bench

Conversation

@wshallwshall

Copy link
Copy Markdown
Collaborator

THROUGHPUT-STATUS-2026-07-10 tells the reader four times that the per-process CPU-attribution instrument "DOES NOT EXIST YET — it must be BUILT", and PLAN-ENGINE-ATTRIBUTION's backlog actions still list closing #208 and holding #220 at P3 as pending work.

All of that is stale. #220 shipped: ProcSample.cpu_pids records the exact PID set summed each tick (probe.py:57-70,261), the piecewise max(0, Δcpu) fold is in connscale/runner.py, and falsifiers live in tests/test_connscale_cpu_probe.py. #208 is closed, and its only residual is off-repo measurement that no in-repo change can close.

An instruction to build something that already exists is precisely how merged work gets rebuilt — the same failure #41 just fixed at the ledger level. These two documents were the remaining copy of it outside docs/BACKLOG.md.

Corrected by annotation, not rewriting

Both files are dated artifacts — a status record and a plan. Their findings and reasoning were sound for what was known at the time, and silently editing them would falsify the account of why those decisions were made. So the original text stands, with a correction banner at the top of each and an inline supersession marker at the four imperative "build it" sites, so a reader landing mid-document still gets the correction.

Verified: both relative links resolve from docs/benchmarks/; leak gate exit 0 with detectors live (names=7, estate=13, site_prefixes=1).

…ists

THROUGHPUT-STATUS-2026-07-10 tells the reader four times that the per-process
CPU-attribution instrument "DOES NOT EXIST YET -- it must be BUILT" and calls
building it the next piece of work. PLAN-ENGINE-ATTRIBUTION's backlog actions
still list closing #208 and holding #220 at P3 as pending.

All of that is stale. #220 shipped: ProcSample.cpu_pids records the exact PID
set summed each tick (harness/load/connscale/probe.py:57-70,261), the piecewise
max(0, delta) fold is in connscale/runner.py, and falsifiers live in
tests/test_connscale_cpu_probe.py. #208 is closed, and its only residual is
off-repo measurement that no in-repo change can close.

An instruction to build something that already exists is precisely how merged
work gets rebuilt -- the same failure the backlog reconcile just addressed at
the ledger level. These two documents were the remaining copy of it outside
docs/BACKLOG.md.

Corrected by annotation, not rewriting. Both files are DATED artifacts: a status
record and a plan. Their findings and reasoning were sound for what was known at
the time, and silently editing them would falsify the account of why the
decisions were made. So the original text stands, with a correction banner at the
top of each and an inline supersession marker at the four imperative "build it"
sites -- a reader landing mid-document still gets the correction.

Verified: both relative links resolve from the docs/benchmarks/ directory; leak
gate exit 0 with detectors live (names=7, estate=13, site_prefixes=1).
@wshallwshall
wshallwshall enabled auto-merge (squash) July 29, 2026 15:27
@wshallwshall
wshallwshall merged commit fbfc93c into main Jul 29, 2026
31 checks passed
@wshallwshall
wshallwshall deleted the bench branch July 29, 2026 15:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant