docs(adr): retract the 74 GiB extrapolation in ADR 0087, in place - #932
docs(adr): retract the 74 GiB extrapolation in ADR 0087, in place#932wshallwshall wants to merge 2 commits into
Conversation
A ratified ADR stated an extrapolation as a measurement. The figure was refuted by an adversarial pass run by the seat that produced it, and each defect was re-checked against the files before this change. Retracted in place rather than deleted, per this project's correction rule: the wrong version and why it was wrong both stay, because deleting an error invites the next reader to re-derive it. THE THREE DEFECTS, each sufficient alone: 1. Wrong multiplier. ADR 0052 AC-2 commits to "1,500 concurrent connections"; the word "inbound" does not appear. Sandbox children exist per traffic-carrying inbound, so 1,500 is not the count to multiply by. 2. Linearity was never measured. Every result JSON records worker_tree_uss_mb, worker_tree_rss_mb and worker_tree_processes SINGULAR -- one tree, five files, no scaling series. 3. Resident set is bounded by installed RAM. The tier is 16 GB and the bench box 31.7 GiB, so 74 GiB resident is not a quantity any sized host can exhibit. A demand figure wants private commit charge. WHAT STANDS UNCHANGED: the per-child measurement of ~50 MiB unique / ~77 MiB resident, and the constraint itself, which is stronger without the extrapolation -- ADR 0052 AC-2 requires 1,500 concurrent connections WITHOUT per-connection-worker exhaustion (fd/socket/worker-task limits), and mode=subprocess holds one never-pooled worker tree per traffic-carrying inbound. That is the resource class AC-2 names. No decision, boundary or acceptance criterion of ADR 0087 changes. The Status line records the amendment, as the 2026-08-04 amendment did. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
This pull request is green and nobody has marked it read. Every check that has reported is passing and the To clear it, IN THIS ORDER:
DO NOT TRIAGE THIS FROM A seat can find every pull request in this state in one call: The |
A ratified ADR on
mainstates an extrapolation as a measurement. This retracts it in place.The figure was refuted by an adversarial pass run by the seat that produced it. I re-checked each defect against the files before making this change rather than acting on the retraction alone.
The three defects, each sufficient alone
origin/mainworker_tree_uss_mb,worker_tree_rss_mb,worker_tree_processessingular — one tree, five files, no scaling series.Retracted in place, not deleted
Per this project's correction rule, the withdrawn sentence is quoted inside the retraction with why it was wrong. Deleting an error invites the next reader to re-derive it — and this one had already been re-derived once, in a backlog row, before anyone checked it.
What stands, unchanged
mode=subprocessthe engine holds one never-pooled worker tree per traffic-carrying inbound — two processes each, two daemon threads, three pipe fds, a job-object handle. That is precisely the resource class AC-2 names, and ADR 0052 records its 1,500-connection axis as unvalidated with no harness.No decision, boundary or acceptance criterion of ADR 0087 changes. The Status line records the amendment in the same form as the 2026-08-04 one.
Why this is its own PR
Amending a ratified ADR is a deliberate act and should not ride in a remediation PR — the Manager seat declined to do it from one, and was right to. The owner was asked directly and chose to amend rather than let a backlog row carry the correction while the ADR kept asserting the figure.
Checks
Docs-only, one file.
pytest -k relative_linkpasses (2 passed) — both new relative links resolve. Hosted-only legs unread from here.Co-Authored-By: Claude Opus 5 noreply@anthropic.com