Skip to content

fix(security-doc, collection, tooling): #1249 unreachable pacer + guard, #1230 loud omission, #1235 dangling citations - #385

Merged
wshallwshall merged 6 commits into
mainfrom
claude/b2-1249-1230-1235
Aug 14, 2026
Merged

fix(security-doc, collection, tooling): #1249 unreachable pacer + guard, #1230 loud omission, #1235 dangling citations#385
wshallwshall merged 6 commits into
mainfrom
claude/b2-1249-1230-1235

Conversation

@wshallwshall

Copy link
Copy Markdown
Collaborator

Three items, five commits. 94ad263a and e92b7ecf must land together or not at all -- the doc commit alone reds main, and the lineage here guarantees the pair.

item commits what
#1249 94ad263a + e92b7ecf the ingest-plane row says the pacer cannot be enabled, and its guard now tests the DOC against the CODE
#1230 bbd2d86c an incomplete local run states what it could not collect
#1235 8e7ee150, 8387c88d detect a backlog citation naming no item at all, plus why the floor's conservatism is the design

The landing constraint, verified rather than relayed

tests/test_security_doc_rate_limits.py:549 on origin/main asserts "ships OFF" in block. 94ad263a rewrites that row to say the pacer is unreachable, so alone it fails its own guard. e92b7ecf updates the guard to assert the NEW true claim while keeping every other assertion.

"NOT REACHABLE" is a STRONGER claim than "off", so the guard gets stronger, not looser.

#1249 STAYS OPEN, and the guard must not be read as settling it

The owner has NOT chosen between exposing the two pacer keys and removing the row -- that question is live in front of them.

The guard asserts "the doc matches the code". It does NOT assert "unreachable is the intended end state." Read the other way, a green check would settle a product question by build. Whichever way the owner rules, the guard follows the doc.

#1230's scope was already ruled

Owner, 2026-08-12: build the LOUD-OMISSION half ONLY. That is what bbd2d86c does; the other two options the item offers are untouched.

And it fired on its author in the very run that proved this branch green -- 861 skips include the five uninstalled extras, so that green does not establish the full suite is green. The tool refusing to let its own author overclaim is the entire point of the item.

Seven failures that were invisible in isolation

Every test in test_incomplete_run_banner.py failed in the full suite and passed in isolation. Cause: a bare import conftest. pyproject has two testpaths, and packaging/messagefoundry-webconsole/tests/conftest.py claims the same top-level module name, so a full run bound the import to the webconsole's conftest:

AttributeError: <module 'conftest' from '...webconsole/tests/conftest.py'>
                has no attribute '_OPTIONAL_EXTRAS'

The name resolved to the neighbouring module and nothing said so. Fixed by moving the probe to tests/_extras_probe.py and importing it package-qualified. Importing conftest by path was rejected: its body claims a per-process test slot and registers an atexit unlink.

Proved against the failure mode, not in isolation: both testpaths together, 437 passed; then the bare import was restored and the same command re-run -- exactly those 7 failed. The negative control is what makes the green mean anything, because isolation had said "fine" twice, wrongly.

Verification

full suite    12335 passed, 861 skipped, 0 failed (31:59)

Exit 0 is pytest's own -- the run was not piped. That distinction is load-bearing: an earlier run reported exit code 0 belonging to tail while the suite had been killed at 94%.

No banner flip

Zero files under docs/ outside docs/SECURITY.md; authoring ledger content is not the builder's. The ledger amendments follow separately under the sanctioned interim.

…so (BACKLOG #1249)

The control table listed `max_messages_per_second` and `message_burst` with state
"off", which every reader takes to mean "set it to on", and the cell went on to
describe what happens "when set". No documented configuration can set them.

MEASURED, with a positive control that proves the check discriminates:

  MLLP() parameters: 26, **kwargs present: False
    max_messages_per_second   NOT A PARAMETER
    message_burst             NOT A PARAMETER
    max_connections           ACCEPTED          <- positive control

  mllp.py:1378  mps = s.get("max_messages_per_second", DEFAULT_...)   pacer reads it
  mllp.py:116   DEFAULT_MAX_MESSAGES_PER_SECOND = None                ships off

`connections.toml` routes through the SAME factory, so neither authoring surface can
express the keys. The pacer is real, reads its settings, and is unreachable.

A SECURITY DOCUMENT DESCRIBING A CONTROL, ITS BEHAVIOUR WHEN ENABLED, AND ITS
COVERAGE LIMITS -- FOR SOMETHING NOTHING CAN ENABLE -- is a compensating control
resting on a false premise, which SDS-3.7 forbids by name.

TWO THINGS DELIBERATELY KEPT, because the correction must not overshoot:

  Not "unbounded intake". That would be FALSE and it runs against the engine.
  Several bounds ship ON -- max_connections 256, receive_timeout 60s,
  max_frame_bytes 16 MiB, per-connection max_message_bytes, source_ip_allowlist.
  They bound SIZE and CONCURRENCY, not RATE. The cell now says which is which.

  The off default was RULED, not accidental -- a rate on a clinical interface is
  only safe at a number from a real feed profile. That reasoning stands. What the
  old text conflated is that a ruled default and an unreachable setting are
  different things, and only the first was intended.

NOT FIXED HERE, and not mine to decide: adding the two keys to the MLLP() signature
would change a shipped public factory, and whether the posture should be reachable
at all is a product question -- the item notes the default is ruled off for a
reason. Handed to the dispatcher; the doc half does not wait on it.

Verified: table structure intact (10 cells in the edited row, same as its
neighbour; 360 pipe-rows unchanged); link resolution and banner hygiene 30 passed;
cp1252 scan over the ADDED line -- 7 non-ASCII seen, all safe punctuation, 0 unsafe.

Coordinated: the collision gate refused this edit while another session held the
file with an unresolved merge conflict. I held rather than overriding, and they
released it. Their commits touch :56-77, :1164 and :1834 -- nowhere near this row.

No ledger edit; banner flip withheld, disposition routes to the dispatcher.
…CODE (BACKLOG #1249)

94ad263 rewrote the SECURITY.md ingest-plane row from "ships off" to "NOT REACHABLE" and did NOT
update the guard that pins that wording, so the commit as handed over failed
test_ingest_plane_rate_limit_is_documented_as_existing_but_off. Found by running the full suite;
entirely mine. A docs-only diff is not test-neutral -- a test reads that file from disk, so a
documentation commit moves a test result.

The guard now reads reachability from inspect.signature(wiring.MLLP) and requires the row to AGREE
with it, instead of asserting that unreachability is the correct state.

#1249 IS OPEN AND THIS COMMIT DOES NOT CLOSE IT. The owner has not chosen between exposing
max_messages_per_second / message_burst and rewording the row. A guard that pinned "NOT REACHABLE"
as correct would settle that product question by build -- the same shape as settling one by
omission. This guard flips on its own: expose the keys and it demands the row stop saying
unreachable; leave them out and it demands the row say so. A green run here is not the ruling.

Verified: MLLP() (config/wiring.py:1007) accepts neither pacing key, and connections.toml desugars
through that same factory. Both branches are exercised -- simulating accepted keys fires the
opposite assertion against the current doc.

Unrelated: seven failures elsewhere in the full suite remain unlocated. They are not named here
because I have not run them individually, and two positional estimates of their location were both
wrong.
…t collect (BACKLOG #1230)

The LOUD-OMISSION half only, per the owner's 2026-08-12 scope ruling. The worktree venv is
deliberately NOT changed here.

scripts/worktree/new.ps1:232 builds a worktree venv with .[dev,harness]; CI installs
.[dev,harness,fhir,dicom,x12,xml,webauthn] (.github/workflows/ci.yml:273). Every module gated on
that five-extra gap removes ITSELF at collection time via a module-level pytest.importorskip, so
those tests never become test items: a block of coverage collapses into a short skip tally and the
run still prints as green. THE DEFECT IS THE SILENCE, NOT THE ABSENCE -- skipping an uninstalled
optional extra is correct; rendering an incomplete run as a complete one is not.

A report-header line and a terminal-summary block now name the absent extras and the exact install
command. NO PINNED TEST COUNT: a hard-coded figure is right the day it is written and silently
wrong after, and re-running reproduces it, so it reads as verified.

Proved in BOTH directions. The silent arm (nothing missing means nothing printed) is the one this
venv cannot show on its own, so it is staged with monkeypatch rather than assumed.

THE PROBE LIVES IN ITS OWN MODULE, AND THAT IS THE INTERESTING PART. It began inside conftest.py
and the tests reached it with a bare `import conftest`. That passes when only tests/ is collected
and FAILS IN A FULL RUN: pyproject has two testpaths, and packaging/messagefoundry-webconsole/
tests/conftest.py claims the same top-level module name, so the import bound to the webconsole's
conftest and every attribute lookup failed. Seven tests passed alone and failed together -- the
worst way for a test to be wrong, because isolation says it is fine.

Fixed by moving the probe to tests/_extras_probe.py (no module-level side effects) and importing it
package-qualified, the same idiom as tests._workflow_contexts. Importing conftest BY PATH was
rejected: its module body claims a per-process test slot and registers an atexit unlink, so a second
execution burns a slot for nothing.

Verified against the failure mode, not just in isolation: with both testpaths collected together the
suite is green, and restoring the bare import reproduces exactly those seven failures. The negative
control is what makes the green meaningful.

Known limit, stated rather than implied: these hooks load for any run that collects tests/, which
includes every full-suite run -- the only kind that can earn "the full suite is green". A run scoped
entirely to the webconsole testpath prints no banner. Measured both ways. Left rather than fixed
with a repo-root conftest.py, which would change collection globally and is outside this scope.
…ACKLOG #1235)

The RULE half. A citation to a number that names nothing resolves to nothing -- honest, and it
advertises its own brokenness. If that number is later issued, the citation silently starts naming
unrelated work, which the ledger's own erratum calls the worse outcome.

THE DISTINCTION THAT DECIDES WHETHER A CITATION CAN EVER ARM, and it is not the obvious one.
alloc.ps1 starts its search at $observed + 1 (config at :392, or the public-floor clamp at :389) and
scans UPWARD, never filling a hole: "numbers are never reclaimed ... holes are free, collisions are
not". So a number at or below the high-water mark is unreachable FOREVER; only a number above it can
be issued. A check that asked only "does this resolve in the ledger" rates the two identically and
raises 26 false alarms on this repository alone.

Classification is by the FLOOR, deliberately not by the allocation registry. An earlier draft read
the records under the git common dir. It gave the same answers and rested on the wrong thing: those
records are machine-local, uncommittable and losable, so garbage-collecting a directory would appear
to change a conclusion that never depended on it. The unreachability is structural.

The floor is built from the ledgers only, so it can only UNDERSTATE the allocator's true floor
(which also spans refs and allocations). Understating means over-warning, never a missed trap.

TWO DEFECTS IN THE TOOL ITSELF, both found by RUNNING it over docs/ and both now pinned as tests.
It crashed mid-scan on a character a cp1252 console cannot encode -- a scanner that dies partway
prints a partial list that reads as a complete one. And it matched CSS/Mermaid hex colours: #1565c0
read as a citation of #1565, 8 of 40 hits spurious. An inflated count in a tool whose whole output
is a bound is the one failure that makes it useless.

Output is an UPPER BOUND ON CITATIONS, never a defect count, and says so in those words. Every hit
prints with its file, line and source line so a human judges it; PR/issue/foreign-repo shapes are
ANNOTATED, never trimmed, because a trimmed scan silently understates.

Measured over docs/: 32 tokens, 26 below the floor, 6 above -- and all 6 are foreign references
(pyodbc#1459, a Mirth forum #4849, code-server #6256). ZERO genuine live traps in this repository.

NOT backlog_citation_check.py, which sits beside it and answers a different question (#1095: does
the cited FILE contain the item, live ledger vs archive). Neither subsumes the other. The near-
identical names are why that distinction is the first paragraph of the new module.

The item's own premise needs amending -- its two named live traps are inert by construction -- but
a builder may not author ledger content, so that is filed with the dispatcher, not written here.
…KLOG #1235)

Docstring only; no behaviour change.

The dispatcher and I converged on the allocator's mechanics through four positions between us, and
the durable part is not in the code yet. Two additions:

WHY THE LEDGER-ONLY FLOOR CAN ONLY UNDERSTATE, as a structural argument rather than an assertion:
the allocator's observed set is a SUPERSET of the ledger headings -- it also reads refs, the working
tree, claim files and a persisted high-water mark (alloc.ps1:97). Independently reproduced: ledger
floor 1250 on origin/main against the allocator's own 1254.

WHY AN ABOVE-FLOOR REPORT ON A FRESHLY-ALLOCATED NUMBER IS CORRECT AND NOT A FALSE POSITIVE. The
ratchet persists the max of the OBSERVED set, not the number just issued (:205, :214, :215), so
after issuing N the watermark holds N-1 and the only durable record of N is an untracked,
never-pushed registry file. Lose it and N is re-issued. The flag then clears itself once the heading
lands and the floor rises past it -- which is precisely when the number becomes permanently
reserved.

Recorded because both are things a future reader would otherwise "fix": by treating a live report on
a just-allocated number as noise, or by adding a near-the-floor heuristic for an edge this floor
already covers. #1253, #1254 and #1255 are in exactly that state today.
@wshallwshall
wshallwshall enabled auto-merge (squash) August 14, 2026 08:46
@wshallwshall
wshallwshall merged commit 558d2ed into main Aug 14, 2026
34 of 35 checks passed
@wshallwshall
wshallwshall deleted the claude/b2-1249-1230-1235 branch August 14, 2026 12:43
wshallwshall added a commit that referenced this pull request Aug 14, 2026
…30 on its ruled half (#388)

* backlog: correct #1114's Severity line, which contradicted its own body

The Severity line read "could submit unbounded messages". Four bounds ship ON and
were re-verified at origin/main 96c9a860: DEFAULT_MAX_FRAME_BYTES 16 MiB
(transports/mllp.py:105), DEFAULT_MAX_CONNECTIONS 256 (:106),
DEFAULT_RECEIVE_TIMEOUT 60.0s (:107), and max_file_bytes (transports/file.py:384,
remotefile.py:808). They bound SIZE and CONCURRENCY, not RATE.

The item's own "What holds it short today" paragraph already said exactly that, two
paragraphs above, so the Severity line was contradicting its own item rather than
describing the engine. Corrected to "at an unbounded RATE"; the finding is unchanged
and the item stays open.

The correction runs in the direction that makes the engine look better, which is why
the amendment states it explicitly: a Severity line is the sentence most often quoted
onward without its body.

Amendment only, no heading added, so ledger ownership is not consulted. parse_items
before and after: 277 items / 203 open, unchanged.

* backlog: flip #1237 to shipped -- its fix landed without a ledger edit

PR #372 merged the code as 96c9a860 and did not touch docs/BACKLOG.md, so the
item read "not started" while its fix was on main. Banner repair, not a change
of plan.

Both stated limbs verified at origin/main 96c9a860 rather than inferred from the
PR title:

  Signature -- an AST probe located all three functions, so it was not blind:
  gzip_decompress :101, deflate_decompress :138, zip_decompress :195 each carry
  max_output_bytes keyword-only with NO DEFAULT. That is the construct the item
  asked for, a gate that refuses when the precondition is absent, rather than a
  changed default value, which the parent item #1129 explicitly rules out.

  Tests -- tests/test_compression.py pins it: "Calling a decompressor without
  max_output_bytes is a TypeError, not an unbounded read", with a
  pytest.raises(TypeError) assertion. The re-exported public surface still
  resolves in messagefoundry/__init__.py and parsing/__init__.py.

This closes NO ASVS cell and the amendment says so in the item. The verdict is
the assessor's and the vault scorecard is the record of record; the "before
uncompressing" reading question is unresolved without the pre-pass #1237
deliberately excluded, which remains unfiled and is an owner call.

Controls: parse_items 277 items / 203 open / 74 closed before, 277 / 202 / 75
after -- 0 / -1 / +1, the expected delta for one close. backlog_status_check
green, every item declaring exactly one status. Banner invariant checked on the
item body: one closed-alphabet character, zero open-alphabet characters.

* backlog: strike #1245's false delete clause, and narrow two overclaims

#1245's SCOPE paragraph said the bootstrap account "cannot be renamed
(update_user does not rename) or deleted, so it persists as a permanently
disabled row". The rename half is correct. The delete half is FALSE.

Reproduced end to end by a second session: DELETE /users/<bootstrap admin>
returns 200 {'detail': 'deleted'}. Confirmed here independently from the code --
BOOTSTRAP_USERNAME appears 0 times in messagefoundry/api/auth_routes.py, with a
positive control of 7 occurrences in auth/service.py so the probe discriminates.
No delete-time guard names the bootstrap account. The only guard on that route
is is_last_enabled_admin (auth_routes.py:714), which skips disabled users, and
retirement is what disables this one.

Why the correction matters more than the fact: "persists as a permanently
disabled row" is what makes this read as an availability defect with no exit.
There is an exit and it is destructive. A fix must not rest on the row being
undeletable, and a reader checking this paragraph would otherwise re-conclude a
related defect is unreachable and close it as impossible.

Two narrower corrections in the same pass, both REDUCING what the item claims:

  "Silent at both ends" is half wrong. The 201 response body does carry
  disabled:true (auth_routes.py:656-658 re-reads after retirement, _user_summary
  sets it at :195). It is silent at the login end only, via the generic 401 that
  is deliberately indistinguishable from a wrong password.

  Login is not the sole retirement trigger: auth/service.py:518 fires on every
  service start and :2551 on create, so a regression test assuming :650 is the
  only path is narrower than the defect.

Struck rather than deleted, so the wrong version stays visible to the next
reader. The item stays open and its severity is unchanged.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 280 items / 205 open / 75 closed, unchanged.

* backlog: retract my own #1245 narrowing -- it was measured on the wrong route

Forty minutes ago I amended #1245 to say "silent at both ends" was half wrong,
on the ground that a 201 response body carries disabled:true. That measurement
is TRUE and it is about a DIFFERENT ROUTE.

auth_routes.py:656-658 and _user_summary:195 are POST /users -- a create, and
the stacked-admin-name defect's route. #1245 is a RESET defect. The reset route
at auth_routes.py:753 ends at :776 with

    return PasswordResetResponse(temp_password=temp)

no re-read, no _user_summary, no disabled field.

And the stronger reason, which makes "silent at both ends" true in principle
rather than by omission: admin_reset_password (auth/service.py:2717) does not
call _retire_superseded_bootstrap at all. Its only three call sites are :518,
:651 and :2551 -- positive control, the probe resolves real sites. So the re-arm
is LATENT: at the moment the reset returns nothing has happened yet, there is no
disabled state to report, and a re-read there would correctly say disabled:false.

"Silent at both ends" therefore STANDS for this item. The create-path fact is
real and belongs in the stacked-name item instead.

Caught by the builder holding #1245, which re-measured rather than accepting a
correction from the dispatcher. That is the second time today the two of us have
hit the same shape in opposite directions: an instrument answering truthfully
about the neighbouring question. Kept struck rather than deleted, because the
two routes are adjacent in one file and the wrong version is what a later reader
would re-derive.

One correction from that pass DOES stand and is retained: login is not the sole
retirement trigger (:518 on service start, :2551 on create), so a test assuming
:651 is the only path is narrower than the defect. Recorded as already handled.

SECOND DEFECT IN THIS SAME EDIT, caught by the before/after control and fixed
before commit: the retraction was first written with a closed-alphabet character
opening a blockquote in the item body. parse_items read it as a status banner
and #1245 flipped to CLOSED -- 280/204/76 against an expected 280/205/75. A live
item under active build, removed from the queue by a prose edit. The rule is
absolute for exactly this reason: no banner-alphabet character in an item body,
any position. Say the word.

Controls after the fix: 280 items / 205 open / 75 closed, #1245 is_open True,
zero closed-alphabet characters in the body, backlog_status_check green with
every item declaring exactly one status.

* backlog: close #1240, record #1241 as partial -- the ledger edit PR #379 cannot make itself

PR #379 is red on a required check that says a PR implementing BACKLOG #N must
update BACKLOG.md. The owner's 2026-08-13 ruling says a builder may resolve merge
conflicts but may not author ledger content. Those two are mutually unsatisfiable
for a compliant builder PR, so the builder correctly withheld the banner and the
PR correctly went red. Authoring is dispatcher and lander only; this supplies the
edit. Neither a bug nor anyone's error -- two correct rules meeting.

#1240 CLOSED. Verified before signing by printing the operands on both refs
rather than counting them, after a count instrument returned 0 on a string the
printed lines visibly contained:

  origin/main   _FHIR_TYPE_RE = re.compile(r"^[A-Za-z]+$")
  PR #379 head  _FHIR_TYPE_RE = re.compile(r"^[A-Za-z]+\Z")

$ -> \Z on the two pattern definitions, call sites unchanged. That is the durable
form: it covers all three call sites at once and cannot be re-broken by a future
caller, where converting the calls to .fullmatch would fix three and leave a
fourth free to reintroduce it. The read-path _reject_control_chars limb was
deliberately not added -- redundant once the gates are strict, and it would
reintroduce duplication that #1239 records as retired.

The item also records that the obvious regression test cannot discriminate:
_resolve_read_url strips, so "Patient/123\n" yields an identical URL before and
after the fix and only "Patient\n/123" flips. Measured by executing the shipped
and patched sources, not argued.

#1241 STAYS OPEN, amended to record partial progress. #379 fixed construction-time
screening plus a wrong-exception-class defect worse than the filed finding --
http.client.InvalidURL derives from HTTPException, not ValueError and not OSError,
so it escaped every except arm in _post including the backstop written for that
case. Still outstanding: transports/dicomweb.py, which the item names, and a
second unscreened url-construction site in FhirLookupExecutor in the same file.
The item's subject is the ASYMMETRY, so one sink screened while a sibling is not
reproduces the very defect being reported. A partial close would be wrong.

Two corrections to #1241's filed text, neither reducing severity: its comparison
clause INVERTS rather than going stale, because the neighbouring path it called
"weaker but at least screening" was removed outright, leaving :431 the only
unencoded interpolation in the file; and its enum rationale is right advice for
the wrong reason, since containment comes from the !r conversion rather than the
enum's closedness.

Controls: parse_items 281 items / 206 open / 75 closed before, 281 / 205 / 76
after -- 0 / -1 / +1, the expected delta for exactly one close and one amendment.
backlog_status_check green, every item declaring exactly one status. Banner
invariant checked per item: #1240 one closed-alphabet character and zero open,
#1241 zero closed and one open.

* backlog: flip #1204 to shipped, and record that #1203 is abandoned rather than free

#1204's banner read OPEN while its own body said "FIXED in the same change" and
its Verdict line said "build (done)". Banner repair, not a change of plan.

Verified at origin/main before signing, with a discriminating control. All four
artifacts ship: scripts/docs/asvs_tally_lint.py, scripts/docs/asvs_tally_baseline.txt,
.github/workflows/asvs-tally-lint.yml, tests/test_asvs_tally_lint.py. A deliberately
impossible path under the same probe returned ABSENT, so the four PRESENTs are
evidence rather than a probe that answers yes to everything.

One defect found while verifying, and it is not what it first looks like.
asvs-tally-lint.yml:3 cites BACKLOG #1203; the item it implements is #1204. The
obvious reading is a typo pointing at an unissued number, and that reading is
wrong in the direction that causes harm: it would send someone to file #1203 as
free.

Measured: "## 1203." appears in neither docs/BACKLOG.md nor
docs/archive/backlog/BACKLOG-CLOSED.md, with "## 1204." resolving in the live
ledger as the positive control. But the allocator record
mefor-coord/alloc/backlog/1203.json EXISTS, titled "Decide how the public engine
repo obtains the private ASVS scorecard for --prove-absences".

So #1203 is ALLOCATED AND NEVER FILED -- abandoned, not free. Numbers are never
reclaimed and holes are free, so the hole costs nothing. What costs something is
that nothing reports an allocated-but-unfiled number, and a live citation makes
it look issued. The :3 correction to #1204 is a one-word fix and rides with
whatever next touches that workflow.

Controls: parse_items 281 items / 205 open / 76 closed before, 281 / 204 / 77
after -- 0 / -1 / +1, the expected delta for one close. backlog_status_check
green, every item declaring exactly one status. Banner invariant on the item
body: one closed-alphabet character, zero open-alphabet.

* docs(adr): ADR 0165 -- a builder PR satisfies the ledger gate with a paired commit

Records a coordination decision that until now existed only in session messages
and a queue file, which is the exact shape this project keeps being bitten by --
a ruling with no artifact behind it.

THE COLLISION. The required check "a PR that implements BACKLOG #N must update
BACKLOG.md" demands a ledger edit in the PR's own diff. The owner's 2026-08-13
authoring ruling forbids a BUILDER to author ledger content, on the property that
a mechanical union cannot invent a disposition but authoring a banner can, and a
seat that can author its own item's banner can turn its own PR green. Composed,
a compliant builder PR cannot pass a required check. Measured live: PR #379 went
red for obeying the ruling.

THE DECISION. The Dispatcher or Lander authors the disposition and the commit
rides on the PR branch. Owner-ruled a1.

THE PART THAT INVERTED ON MEASUREMENT. Reading the gate rather than reasoning
about it: backlog-hygiene.yml:64-98 computes a three-dot diff and passes if the
changed set touches docs/BACKLOG.md or docs/archive/backlog/. It never inspects
authorship. Evaluated against the real cherry-picked head for #379 -- touches_code
1, ledger 1, PASS. So the pattern was in force before it was named, no gate change
was required, and none is pending.

The ledger gate permits the cherry-pick for a non-obvious reason: it iterates
headings added relative to base, and a banner flip or amendment on an item already
on main adds no "## N." heading, so ownership is never consulted and the committing
seat is irrelevant. Holds only for landed items; a PR that FILES an item is a
different shape.

REJECTED, with reasons rather than preferences. (a2) separately-landed plus
cross-branch correlation would undo a deliberate control -- the gate uses three-dot
on purpose and its own comment says two-dot "would pass while enforcing nothing".
(b) a builder carve-out to flip its own banner reopens the self-approval hazard.
(c) as a distinct interim dissolved: it is the same mechanism, so there is no
transition.

RECORDED NEAR-MISS, kept rather than deleted because the wrong version is what a
later reader re-derives: the ruling was briefly written as "(c) is fine until (a)
lands" -- an expiry whose trigger had ALREADY FIRED. It looks like the safe
construction and behaves like the unsafe one, becoming permanent by default while
appearing bounded.

Provenance is split three ways in the ADR because each half is only checkable if
attributed: the collision found by the Lander on #379's red check, the
self-approval property by Builder 2, the gate measurement and the no-build finding
by the Dispatcher, the ruling by the owner.

ADR number allocated atomically to this worktree; index row added in the same
commit, as the ledger gate requires. No engine behaviour changes.

Note for whoever integrates: docs/adr/README.md is an APPEND/APPEND conflict with
claude/builder-seat-playbook-bf2ead, which appends ADR 0164's row at the same tail.
Both rows are additive and disjoint -- take both sides.

* backlog: measure one limb of #1143's research question, and fix a blank-line citation

#1143 asks what identification keyed on the IdP-namespaced subject would actually
require across all three store backends. One limb of that is now measured rather
than left to be re-derived by whoever picks the research up.

MEASURED at origin/main, with a discriminating control:

  UNIQUE index or index naming oidc_issuer / oidc_subject:
    store.py 0    postgres.py 0    sqlserver.py 0
    positive control: "UNIQUE" appears 13 times in store.py, so the probe
    discriminates and the three zeroes are real absences

  column types today:
    postgres.py:531-532   oidc_issuer TEXT, oidc_subject TEXT
    sqlserver.py:1357     oidc_issuer NVARCHAR(MAX) NULL,
                          oidc_subject NVARCHAR(MAX) NULL

So the federated columns exist and carry no uniqueness constraint of any kind. An
(issuer, subject) identity key is therefore not a code-only change: it needs a
unique index on all three backends, and on SQL Server NVARCHAR(MAX) cannot be an
index key column at all, so both columns must first be re-typed to a bounded
NVARCHAR(n). That is a second migration on that backend.

That cost is an INPUT to choosing between the candidate designs rather than a
consequence of having chosen one, which is why it belongs in the item before the
research runs rather than after.

CITATION FIX in the same pass: the banner cites store.py:1590 for users.username.
:1590 is a BLANK LINE; the declaration "username TEXT NOT NULL UNIQUE" is at
:1593. Found independently by two seats, so it is recorded rather than quietly
patched.

Explicitly NOT settled, and stated in the item: the ceremony for the first
federated login of an account that predates federation. That remains the item's
hard question and nothing above touches it. A migration cost informs that
decision; it does not answer it.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged.

* backlog: audit #1020's directory path -- it widens, and it invalidates one candidate fix

#1020 said "the AD/OIDC-provisioned path in auth/reconcile.py was not audited, so
the finding may narrow to local accounts". Audited now. Wrong file, and it widens
rather than narrows.

Every link opened individually, because a chain of separately-verified links is
not a verified chain:

  authenticate_oidc      auth/service.py:942   -> returns _complete_ad_login :1056
  _complete_ad_login     auth/service.py:1081  -> calls _upsert_ad_user :1107
  _upsert_ad_user        auth/service.py:1209  -> update_user_profile(email=principal.email)
  update_user_profile    store/store.py:7742   -> UPDATE users SET display_name=?, email=?, ...

Both the AD and the OIDC login paths provision through the SAME function,
_upsert_ad_user -- not auth/reconcile.py, which the struck sentence names.
authenticate_oidc returns _complete_ad_login directly, so one provisioning path
serves two providers.

The sharp end is the unconditional write. update_user_profile issues
UPDATE users SET display_name=?, email=? with no conditional and no coalesce, and
_upsert_ad_user calls it on every directory login with whatever the directory
asserted. So a directory-sourced account cannot retain a hand-set address: an
operator who sets one via PATCH /users/{id} has it overwritten at the account
holder's next login. LDAP mail is optional at every layer, so where the directory
asserts nothing the address returns to NULL.

That invalidates one of the item's three candidate fixes. "Add a self-service
email field" does not reach directory-provisioned accounts at all -- whatever the
user sets is overwritten on their next login by the same unconditional write. Any
fix gating on "a privileged account must have a deliverable address" needs a
separate answer for the directory-sourced population, which moves it into the
owner's decision rather than leaving it an implementation detail underneath.

Deliberately NOT re-litigated: "Difficulty 3, no schema change, no migration cost"
may still hold for the local-account half, and nobody has measured it for the
directory half. The amendment says so rather than quietly widening the estimate.

Also removed a pre-existing closed-alphabet character from this item's BODY at the
old :4111. It was not flipping the item -- the counts were identical before and
after -- but the rule is absolute for exactly that reason: position decides
whether it parses as a status banner, and four items were mis-parsed by this class
today. Replaced with the word.

Provenance: the widening was measured by the Builder 2 seat during a blind
re-verification pass; the chain above was re-read link by link here before being
written into the ledger.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged.

* backlog: record #1020's owner ruling, and correct the fix location it points at

Owner ruled option (b): gate startup on a deliverable channel. Recorded in the
item because until now the ruling existed only in session messages, which is the
failure mode this session has been correcting all evening -- a decision with no
artifact behind it.

The deciding argument is recorded as the reason rather than only the choice:
(b) is the only option that does not rest on an operator action. That is
decisive because update_user_profile issues

    UPDATE users SET display_name=?, email=?

with no conditional and no coalesce, on every directory login (store.py:7742), so
any address a human sets on an AD or OIDC account is overwritten at the account
holder's next login. A fix depending on someone setting an address cannot cover
that population.

The item's stated fix location is wrong and a builder would walk into it. The
text points at __main__.py:2259, but _serve is synchronous and opens no store --
probing its full range for open_store|AuthService|list_users|count_users returns
one hit and it is a comment, and uvicorn.run is at :2827 so the lifespan
bootstrap has not run. The only place the store and the fresh bootstrap admin are
both in hand is the ASGI lifespan at api/app.py:~5852.

Option (c) is recorded as population-limited, NOT defective, and the amendment
says the ruling must not be cited as a finding that it was broken. A self-service
email field works for local accounts and is silently overwritten for directory
ones. The incompleteness was invisible to the operator, which is more useful than
"it was wrong" -- an earlier framing of mine that I withdrew.

Recorded as unpriced rather than carried forward: whether "Difficulty 3, no
schema change, no migration cost" still holds for the directory half. It may hold
for the local half; nobody has measured the directory half. A stale difficulty
estimate silently sets a lane's expectations.

The build is NOT dispatched. The pool is at HOLD NEW WORK / PROTECT AND WRAP, and
a builder taking this would be starting a new item and a new claim, which that
state prohibits. Recording the ruling is work in hand; building it is not.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged.

* backlog: record #1217 half 1 as built, half 2 outstanding -- the item stays open

PR #383 is red on "a PR that implements BACKLOG #N must update BACKLOG.md". The
builder withheld the banner correctly under the owner's authoring ruling, so the
ledger edit is the dispatcher's. This supplies it. Same shape as #1241 on #379,
and ADR 0165 records why that is the standing pattern.

Half 1, the >=1 floor, is BUILT. Verified on the branch against origin/main
rather than taken from the report:

  origin/main   retry_max_attempts: int | None = 100
  PR #383       retry_max_attempts: int | None = Field(default=100, ge=1)

A configured 0 or negative is now refused at load rather than loading clean and
dead-lettering on the FIRST failure -- the delivery check is
item.attempts >= max_attempts against a post-increment count
(pipeline/wiring_runner.py:5040), so 0 meant give-up-now while reading like
"no limit".

The floor is on the OPERATOR-FACING setting only, and that is deliberate.
RetryPolicy(max_attempts=0) remains a live internal idiom for a permanent
no-retry failure: measured across 5 files, including store.mark_failed call sites
and asserted by tests at tests/test_batch_completion.py:206-208 and
tests/test_postgres_store.py:3109. Constraining the dataclass instead would have
deleted a used mechanism while claiming to add a guard -- the
reads-as-hardening-but-removes-a-control shape.

The item's stated reason for deferring the floor is answered rather than ignored.
It said the floor was documented and not fixed "because a floor changes the
accepted-configuration set". Under section 0 there are zero deployments, so there
is no accepted configuration to break and no migration cost to protect.

STILL OPEN, and it is why the item does not close: whether the retry-forever
posture needs a TOML or env spelling. "", none and null all raise ValidationError,
so that posture is reachable in code-first configuration only. It is a product
question, it was handed back rather than decided, and the item itself says it
should be decided alongside the floor. A closure on #383 would answer it by
omission.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged, and
#1217 verified still OPEN after the edit.

* backlog: #1242's loss is irreversible, not merely expensive -- and a relay's framing corrected

The ASVS Tracker surfaced this defect via the Liaison as a candidate for a NEW
item. It is not new: it is #1242, filed 2026-08-13, and Builder 2 is building it.
No number was allocated. A duplicate ledger row is not a harmless extra line --
it splits the work and the second number looks unbuilt forever, because the fix
lands under the first.

Two things in the relay were genuinely new. One is recorded here; the other is
deliberately not.

RECORDED: the loss is not recoverable by re-running the derivation. The anchors
most at risk are the D3 backfill's, and their warrant was that two independent
derivations AGREED, measured at two different refs. Those refs have moved. So a
fresh derivation reproduces values without reproducing the agreement that
justified writing them, and that agreement is the whole evidentiary content. The
loss is therefore irreversible rather than expensive, which is why this item
outranks other writer defects rather than being one among them. Nothing in the
item said this.

NOT RECORDED, deliberately: the supporting anchor counts. docs/BACKLOG.md is
public, and a tally over a closed public requirement set is the shape that hands
out coverage by subtraction. The mechanism is fully stated without them -- a
reader with vault access can price it, and a reader without one still knows what
to fix and why. Verified my added lines carry no such figure, with a positive
control proving the scan discriminates.

AND THE RELAY'S FRAMING IS CORRECTED BY THE ITEM'S OWN TEXT. It described the
defect as dropping sym/ctx. #1242 already forbids fixing it that way: the defect
is the handling of UNKNOWN keys, and a fix special-casing those two by name
rebuilds the same trap for the next field added. The item was ahead of the relay
and a builder must follow the item.

The Tracker's core claim was verified here rather than taken: sym and ctx each
return 0 occurrences in scripts/asvs/apply.py at origin/main, positive control
expect returns 2.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged, and
#1242 verified still OPEN.

* backlog: close #1238 and #1239 on the code, and file #1253 so the closure does not retire the hazard

Builder 2 reported four banners owed. Two of the four -- #1237 and #1204 -- were
already authored on this branch and are invisible to that lane because ledger
authorship and push are held by different seats. That is recorded as a finding in
the episode note; it is not fixed here. The two genuinely owed are written now.

Both closures verified against origin/main rather than against the build report,
because a banner that closes on a report inherits the report's errors.

#1238: _is_contained_name is defined at transports/remotefile.py:97, wired at
:954, and asserted in BOTH polarities at tests/test_remotefile_transport.py:1185
and :1195. The one-polarity case is called out because such a test passes against
a function that refuses everything. posixpath.basename() was not used, per the
owner ruling.

#1239: _has_control_char returns 0 occurrences across messagefoundry/ at
origin/main, so the pair it named is a single. The item's own condition is met.

#1253 exists because closing #1239 there would have been true of the item as
written and false of the hazard it describes. The reporting lane amended its own
closure recommendation to say so -- the predicate is copied more widely today
than when #1239 was filed, partly by the work that resolved it. A repo-wide
re-measure widened that further: the amendment scanned transports/ and found five
sites across four files; across messagefoundry/ it is seven across six, the two
extra being config/codeset_edit.py:305 and config/impact.py:631.

Two exclusions are recorded in the item so a later scan does not re-add them:
rest.py:109 matches a naive grep but is prose in a docstring, and sniff.py:179
tests the same code points through a genuinely different byte-wise predicate that
subtracts an allowlist, so folding it in would change its behaviour.

rest.py:111 strips where the others reject. That is recorded as defensible and
NOT as a second instance of the pattern the owner ruled against in #1238, so the
next reader does not inherit a false lead: stripping CR/LF from a header value
cannot redirect a request, whereas basename() mutates a path into a real and
different target.

#1253 allocated with alloc.ps1, never grepped. parse_items before and after:
281/204/77 -> 282/203/79, matching the predicted delta for two closures plus one
filing, with a control confirming no item carries a stray banner.

* backlog: record that #1234 is not startable from main -- its subject has not landed

Builder 2 refused a restock offer of #1234 by correcting its OWN earlier
recommendation, and verified before claiming rather than after. Re-measured here
rather than taken: at origin/main, require_least_privilege returns 0 hits in any
.py and appears only in this ledger's own prose. Positive control on the same
instrument, require_managed_identity, returns hits across four .py files, so the
scan sees Python fine -- the zero is a fact about the tree, not a broken needle.

The probe this item reports a defect in exists only on the
w3-store-privilege-preflight branch, dormant at that reading.

The amendment is careful not to overrule the item's own "independent of #1008"
paragraph, because that paragraph is right about a different thing. Both halves
hold: the item is not hostage to #1008's POLICY ruling, and it is nonetheless
unbuildable by any lane working from main until that BRANCH lands. Collapsing the
two would either re-gate a code defect behind a demand gate or keep offering work
whose subject does not exist.

This is the same wasted-claim cost as #1253's provenance, one layer deeper: there,
an item was unstartable because the FIX had already landed; here, because the
SUBJECT has not. A banner-driven queue cannot distinguish either case from
startable work, which is why both are now written down where the next dispatcher
reads rather than left in session mail.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 282 items / 203 open / 79 closed, unchanged, and
#1234 verified still OPEN.

* backlog: file #1254 -- a required check is named for its subject, not its assertion

Handed to me by the Liaison to number if I judged it worth one, in the Lander's
framing. It is, because the naive fix is dangerous and nothing currently records
that.

MEASURED INSTANCE: the Windows leg went red under the label
"test (windows-2025, py3.14)", which reads as "the tests failed on Windows". The
tests passed. What failed was the wall-clock gate "Step margin -- both gated
steps" (ci.yml:675). The check answered its own question truthfully and the NAME
described a different one -- the reverse of the shape this project keeps hitting,
where the label is honest and the instrument is not.

The job name is built at ci.yml:42 from the matrix, so all three legs are named
for WHERE they ran and never for WHAT they assert, while holding at least three
independent assertions. Stated as at least three rather than enumerated.

WHY THIS IS NOT A ONE-LINE RENAME, which is the whole reason it needed writing
down: those three strings ARE required contexts. They are listed in
.github/required-contexts.txt, asserted against branch protection by
tests/test_required_contexts.py, and matched BY NAME on the GitHub side. A
required-but-absent context blocks every PR forever, so a rename is one atomic
change across the workflow, the contexts file, that test's pinned count, and the
branch-protection setting, in the order that file's header prescribes.

So the item deliberately does NOT recommend the rename. It prices three options
and names the cheapest first: make the margin gate's failure output say in its
first line that the suite passed and a timing gate fired. That costs nothing and
cannot wedge the repo. The rename is listed third.

Severity carries no deployment axis, but the near-miss is recorded: the
misreading pointed at the wall-clock cap, and #1096's banner already says the
actual fix is #320 and that re-deriving the caps is itself the failure mode.

#1254 allocated with alloc.ps1, never grepped. parse_items before and after:
282/203/79 -> 283/204/79, matching the predicted delta for one filing, with a
control confirming no item carries a stray banner.

* backlog: amend #1235 -- its two named instances are inert, and I dispatched the opposite

Builder 2 refused the starting fact I gave it and measured instead. It was right
and I was backwards.

I told it to start #1235 from #1203 as a CONFIRMED LIVE TRAP, reasoning that an
allocation record with no ledger entry meant the number was free. The record is
what makes the number permanently UNAVAILABLE. Verified here rather than taken:
1203.json and 1231.json both exist in .git/mefor-coord/alloc/backlog/ (claimed
2026-08-09 and 2026-08-12), and alloc.ps1 has no release at all -- :41 "a one-way
door -- claims are never released", :24 "numbers are never reclaimed ... holes are
free, collisions are not". So the item's own text is wrong where it says #1231 was
"allocated and released without being filed", and wrong that the pair is "defused
only by an accident of timing". They are defused by construction.

ONE CORRECTION AGAINST THE REPORT AS WELL, because its reason is weaker than its
conclusion. The argument as relayed rests on the allocation RECORDS existing. Those
live under .git: uncommittable, machine-local, losable without trace. The reason
that survives their loss is structural -- alloc.ps1 issues $observed + 1 (:392,
and :389 under the public floor clamp) and NEVER fills a hole, so a number below
the floor is unreachable whether or not its record still exists. Recording the
registry as the protection would make a sound property look fragile and invite a
guard nothing needs.

The live shape is the other one and the item now says so: a citation to a number
NEVER allocated sits above the floor and will be issued in the normal course. A
detector reading only the ledgers rates the two states identically, which over
docs/ in this repo mis-scores 26 reserved citations as live; of the 6 genuinely
never-allocated tokens there, all six are foreign references, so this repo holds
zero genuine instances. The private-repo population the item was filed against is
not re-measured here and is stated as separate.

The remedy is unchanged and still correct. Only the account of WHY the two named
instances are harmless is corrected.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 283 items / 204 open / 79 closed, unchanged, and
#1235 verified still OPEN.

* backlog: correct #1235 and #1254 -- two of my own committed claims, falsified under adversarial check

I ran six independent skeptics over every claim I committed tonight, against the
SIMULATED POST-MERGE TREE rather than my branch, because my branch was six behind
origin/main and the merge is CLEAN -- git conflicts on concurrent edits, never on
invalidated claims. Four claims held. Two did not. Both failures are my authoring,
not merge drift: all cited files are byte-identical across the merge tree,
origin/main and HEAD.

#1235. The conclusion survives, the reason did not. I had written that the
allocation registry is irrelevant because the mechanism is structural. That is
FALSE for the newest number: the high-water ratchet persists $floor, the maximum
of the OBSERVED set (:205, :214, :215), NOT the number being issued, so after
issuing N it holds N-1. alloc.ps1 only PRINTS the heading, so until it is
committed the sole durable record of N is its own untracked, never-pushed
<n>.json. Lose that and the next run re-issues N. So the registry is exactly what
protects a just-allocated-but-unfiled number -- the state #1203 and #1231 were both
in when allocated.

What actually makes those two unreachable is a CONJUNCTION, now stated as one: the
loop never searches downward (:392, :389, :394), AND the floor is computed from
COMMITTED LEDGER HEADINGS. Measured non-destructively with -ShowFloor: floor 1254,
swept from docs/BACKLOG.md and the closed archive. Those are tracked content on
refs, they survive a fresh clone, and both numbers sit far below them. Recorded the
public-floor clamp as a THIRD, separate guarantee about the output range, with the
caveat that its own anti-lowering ratchet lives in the same untracked directory and
is disarmed on a registry-absent clone.

#1254 cited the margin gate as ci.yml:675. That is a clock MARK
(step_margin.py --mark between, :677). The gate is :765, if: always(), invoking at
:778 and :781. The error is worth recording rather than silently fixing: I opened
:675, found a step whose name NEARLY matched, and adopted it instead of treating
the near-match as the signal the line was wrong. A near-miss terminates the search;
no match would have continued it.

Also corrected in #1254: tests/test_required_contexts.py does NOT call the GitHub
API. It pins the count at :101 and resolves contexts against real workflow job
names at :107; the branch-protection comparison is a HUMAN step in the comment at
:100. The item's central argument is unaffected -- the strings are still required
contexts and a rename still resolves them to no job -- but the evidence now says
what the test does.

The four that held: #1253's seven-sites-across-six-files with both exclusions and
every line number, #1239's zero occurrences, #1238's defined-wired-and-both-test-
polarities, and #1234's zero .py hits with its positive control.

Amendments only, no heading added, so ledger ownership is not consulted.
parse_items unchanged at 283 items / 204 open / 79 closed.

* backlog: file #1255 -- two testpaths ship a top-level conftest each

Diagnosed by the lane whose own commit tripped it, and filed here because the
collision outlives that commit. Seven tests in one file failed in a full run and
passed in isolation, twice. Cause: pyproject sets two testpaths, both directories
contain a conftest.py, neither contains an __init__.py, so both claim the top-level
module name and a bare `import conftest` binds to whichever loaded first.

Verified at origin/main rather than taken from the report: both conftest.py files
present, both __init__.py absent, and a scan for `import conftest` /
`from conftest import` across both trees returns ZERO hits. That zero is why this
is filed as LATENT rather than live -- the collision is real and currently
untripped, so nothing is failing today and the item must not be cited as a current
gap.

The signature is recorded because it mis-attributes itself: the mis-bound import
surfaces as an AttributeError naming a module path from the WRONG package, not as
an ImportError, so it reads as a missing attribute rather than a bad import.

Two things the item forbids, both because a plausible fix is worse than the defect.
Do not import conftest BY PATH -- its body claims a per-process test slot and
registers an atexit unlink, so a second import under another name has side effects.
And do not prove a fix in isolation: isolation is precisely the condition under
which this defect reports success. The proof has to run both testpaths together and
then restore the bare import to confirm the same command fails again.

The house idiom already solves it -- tests/_workflow_contexts.py is imported
package-qualified at tests/_negative_controls.py:35 -- so the scope is to make the
name unambiguous, not to invent a mechanism.

#1255 allocated with alloc.ps1, never grepped. parse_items before and after:
283/204/79 -> 284/205/79, matching the predicted delta for one filing, with a
control confirming no item carries a stray banner.

* backlog: record that PR #382 closed ONE of #1242's four limbs -- the item stays open

I told a builder its engine fix closed this item's mechanism and to claim it. That
was wrong, and this records the correction where the next reader will hit it rather
than in session mail.

#382 merged 2026-08-13 with this item's number in its title and a title that
faithfully describes what it fixed: the payload-only TOP-LEVEL key limb. Verified
at origin/main -- apply.py:97 now walks {**(live or {}), **cell}.items() rather
than the live cell alone. That limb is genuinely closed.

The limb carrying the item's severity is untouched, and the same revision shows
why the union cannot reach it: :98 skips _ORDERED and _SUBTABLES BEFORE the union
at :97 is consulted for them, and evidence entries are re-emitted at :101-105 by
enumerating exactly path, line and expect (absence at :106-110 by exactly pattern,
positive_control, mutation). A key inside a [[cell.evidence]] entry is still
dropped -- which is exactly where the backfill put the affected keys, on evidence
ENTRIES and not on top-level keys. The top-level table-mangling limb also appears
untouched.

I had additionally told that builder to stop measuring the two affected key names
because the item forbids fixing by naming them. The prohibition is real but I
applied it to the wrong activity: the item forbids naming them in a FIX, not
measuring their absence as a SYMPTOM, and their absence from the writer is exactly
the evidence that the sub-table limb still bites.

Recorded as the PARTIAL-MOVE shape, which is the reusable part: a merged PR bearing
an item's number, whose title truthfully describes what it fixed, is the strongest
available signal the item is done. Verify-before-closing is not enough on its own
here -- the verification has to ask WHICH HALF. The item's own proof condition is
the discriminator and is unchanged: put an unknown key INSIDE an evidence entry,
re-render, assert both that it survives and that the guard refuses when it is
deliberately dropped. #382 does not satisfy it, and no test asserting only
top-level carry-through will.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 284 items / 205 open / 79 closed, unchanged, and
#1242 verified still OPEN.

* backlog: record #1242's BASE REQUIREMENT -- the obvious base for limb 4 reverts limb 3

Builder 2 confirmed limb 4 as I described it, then refused to build it and handed
it back with a reason better than the instruction I gave. Recording the reason,
because it is not discoverable from the item and git will not raise it.

Its branch still carried scripts/asvs/apply.py:88 as

    if key in _ORDERED or key in _SUBTABLES or key in cell:

Verified here against that ref rather than taken: the clause is present there and
ABSENT at origin/main. `or key in cell` is precisely what #382 deleted to fix limb
3. So a limb-4 fix authored on that base and merged would carry limb 3's REVERSAL
in the same diff -- no conflict, no marker, every check green, and the item's own
landed fix undone by the commit claiming to extend it.

Git raises nothing here because git conflicts on concurrent edits to the same
lines, never on a stale base re-asserting a clause that was deleted elsewhere. That
is the same family as the clean-merge hazard this session has been working under
all night, arriving from the direction nobody watches: not a doc invalidated by a
merge, but a FIX reverted by an extension of itself.

The item now states the base requirement and a pre-PR check that discriminates:
branch fresh from current origin/main, and confirm `or key in cell` returns zero
hits in the diff's own version of the file before opening a PR.

Also corrected upstream of this, in my own dispatch rather than the ledger: I had
told that lane to stop measuring the two affected key names. Measuring their
absence as a SYMPTOM was always legitimate; only fixing by naming them is
forbidden. It withdrew its acceptance of my earlier "bound lifted" on the grounds
that it had taken it from me without measuring -- correctly.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 284 items / 205 open / 79 closed, unchanged, and
#1242 verified still OPEN.

* backlog: file #1256 -- the federated binding never checks subject exclusivity

Builder 1 concluded #1143's research and handed over the finding rather than a
commit: the defensible-ceremony question dissolves, because every candidate
collapses to trust-on-first-use when no out-of-band proof exists at first
federated login. What it surfaced instead is a separable gap, and that gap is
this item. Content theirs, number mine, per the authoring split.

Verified at origin/main rather than relayed. auth/service.py:1109-1114 compares
user.oidc_subject against the presented subject and refuses on mismatch, then
binds at :1119-1120. The comparison is keyed on the USER, so it is structurally
incapable of noticing a second account carrying the same (issuer, subject). A scan
for a UNIQUE constraint naming the federated columns returns 0 on ALL THREE
backends, so nothing below it closes the gap either.

The item credits the three shipped controls rather than implying an absence: the
hybrid-only refusal, the subject-continuity guard, and the UPN suffix allow-list.
All three constrain which subject may bind to a GIVEN account. None constrains how
many accounts one SUBJECT may bind to. Stating that explicitly is what should stop
this being re-closed as a duplicate of #1015 or #1143.

The difficulty is recorded where it actually lives. SQL Server types the federated
columns NVARCHAR(MAX), and a MAX column cannot be an index key, so a unique index
there needs a RE-TYPE and not merely a constraint -- a cost SQLite and Postgres do
not share. The proof condition requires demonstrating the refusal on every backend
in CI, because the two server store suites SKIP in a local run and a green on
SQLite alone would certify nothing.

#1143 is NOT closed by this and the item says so: whether TOFU is the defensible
ceremony is separable and still open.

#1256 allocated with alloc.ps1, never grepped. parse_items: 285 items / 206 open /
79 closed after, matching the predicted +1/+1/0 for a single filing, with a control
confirming no item carries a stray banner.

* backlog: record that #1020's refusal path hangs in-harness and is unverified under uvicorn

Reported by the lane that built the gate, against its own work, and recorded here
because it changes what "built" means for this item.

The gate refuses by raising during ASGI lifespan STARTUP, and in-harness that
HANGS rather than exiting. Their control is what makes it a measurement rather
than an impression: the sibling non-raising lifespan test passes in 1.13s, raising
from the lifespan BODY exits cleanly, and raising during STARTUP hangs with zero
output. It sits after engine.start() and before the task handles teardown expects,
so the condition is PRE-EXISTING -- the gate is simply the first thing to raise in
that window, which is why this is not filed as a defect in their fix.

What was NOT measured is what uvicorn does there, and uvicorn is the runner that
ships. They said so explicitly rather than letting the harness result stand for
the product, which is the reason this is worth recording at all.

The consequence is ordered plainly in the item: a startup refusal that hangs a
service is STRICTLY WORSE than the mis-report #1020 exists to correct. An operator
can see a wrong readiness answer; they cannot see a process that never finishes
starting. So the banner now carries an explicit bar on closing this on the gate
landing until the refusal is shown to TERMINATE under uvicorn rather than under
the test harness.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items unchanged at 285 items / 206 open / 79 closed, and #1020 verified
still OPEN.

* backlog: #1235 is PARTIAL, not closed -- the detector shipped, the rule did not

I was about to close this on PR #385 landing. An adversarial pass over my own
proposed banner refuted it, and the refutation is right.

What I would have relied on -- do the two files exist at origin/main -- passes
identically whether or not the rule landed and whether or not anything invokes the
detector. It measures PRESENCE, NOT ENFORCEMENT, and it is the same
cannot-fail shape as running a CLI's --help and reading exit 0, which I had
already caught once today in my own #1030 check.

Three measurements, each independently sufficient to block closure:

  the RULE is unwritten. #1235's Scope names its deliverable as "a rule, not a
  sweep", and that guidance appears at origin/main only in the item's own prose --
  zero hits for "unallocated" across CLAUDE.md, docs/LEDGER-GATE.md, CONTRIBUTING,
  scripts/, .github/ and .claude/.

  the DETECTOR is wired into nothing. Repo-wide it is referenced by exactly two
  lines, both inside its own unit test. Not in any workflow, not in
  .pre-commit-config.yaml, not in .mefor-hooks/pre-commit, not in pyproject.toml.

  it EXITS 0 even when it fires. main() ends `return 1 if args.fail else 0` and
  --fail is opt-in and passed by nothing. A planted live-shape citation was
  reported correctly and the process still exited 0. No test runs
  unresolved_citations over the real docs/ tree, so a new dangling citation turns
  nothing red.

The controls are what make those zeros trustworthy: the same wiring grep DOES
resolve three sibling scripts/docs tools that are wired into CI, and the detector
itself discriminates correctly when --fail is supplied. So the absences are facts
about the tree, not a broken pattern or a blind scan.

Banner moves to in-progress rather than closed, and the item now records what
shipped, the two residual limbs (write the rule where authors read it; wire the
detector with --fail or test it against the real tree), and a coverage bound that
survives both -- by its own docstring the detector cannot see the private
companion repository, which is where this item's filed instances live.

Closing on the detector's existence would have recorded an enforced rule where
nothing enforces it. The builder declined to close it for the same reason and left
the ledger half to me.

Amendment only, no heading added, so ledger ownership is not consulted. Both
glyphs are OPEN, so parse_items is unchanged at 285 items / 206 open / 79 closed,
with #1235 verified still OPEN and carrying exactly one banner.

* backlog: close #1230 on the owner-ruled half, with the wiring's own regression gap named

Four proposed banner verdicts went through an adversarial pass before any was
written. Three survived; one did not and was corrected separately (#1235). This is
the survivor, and it survived on evidence stronger than I would have gathered.

#1230 CLOSES because the loud-omission half is built AND WIRED, not merely
present. tests/_extras_probe.py supplies the emitters and tests/conftest.py binds
them to pytest's own hooks at :366 and :370. Verified by RUNNING rather than
reading, in both directions on two real interpreters: extras-complete venv, banner
ABSENT; the venv scripts/worktree/new.ps1 actually builds, banner FIRES in both
surfaces -- including on a bare full-suite run collecting 13,187 tests. The
silent direction was observed rather than assumed, which is what makes the loud
direction mean something.

Scope is exactly the half the owner ruled. new.ps1:232 is unchanged, so options
(a) and (b) -- installing the five extras into every worktree venv -- were
correctly not taken.

CLOSED WITH A NAMED RESIDUAL, because folding it into the closure would reproduce
the defect. Deleting BOTH hook functions from tests/conftest.py leaves
tests/test_incomplete_run_banner.py reporting 7 passed, while a real run goes from
banner-present to banner-gone. The tests drive the probe against a fake reporter;
nothing asserts that pytest invokes it. Repo-wide, pytest_report_header and
pytest_terminal_summary appear ONLY at conftest.py:366 and :370, guarded by no
test, lint or gate. So a conftest refactor can silently delete the mechanism with
every check green -- which is this item's own failure shape, one layer up, inside
the fix for it.

The item closes on the owner-ruled half working. The residual is recorded in the
banner rather than discovered later by whoever the silence next costs.

Amendment plus banner flip, no heading added, so ledger ownership is not
consulted. parse_items 285 items / 206 open / 79 closed -> 285 / 205 / 80,
matching the predicted 0/-1/+1 for a single closure, with a control confirming no
item carries a stray banner and #1235, #1249 and #1030 all verified still OPEN.
wshallwshall added a commit that referenced this pull request Aug 14, 2026
…1250 (#389)

* backlog: correct #1114's Severity line, which contradicted its own body

The Severity line read "could submit unbounded messages". Four bounds ship ON and
were re-verified at origin/main 96c9a860: DEFAULT_MAX_FRAME_BYTES 16 MiB
(transports/mllp.py:105), DEFAULT_MAX_CONNECTIONS 256 (:106),
DEFAULT_RECEIVE_TIMEOUT 60.0s (:107), and max_file_bytes (transports/file.py:384,
remotefile.py:808). They bound SIZE and CONCURRENCY, not RATE.

The item's own "What holds it short today" paragraph already said exactly that, two
paragraphs above, so the Severity line was contradicting its own item rather than
describing the engine. Corrected to "at an unbounded RATE"; the finding is unchanged
and the item stays open.

The correction runs in the direction that makes the engine look better, which is why
the amendment states it explicitly: a Severity line is the sentence most often quoted
onward without its body.

Amendment only, no heading added, so ledger ownership is not consulted. parse_items
before and after: 277 items / 203 open, unchanged.

* backlog: flip #1237 to shipped -- its fix landed without a ledger edit

PR #372 merged the code as 96c9a860 and did not touch docs/BACKLOG.md, so the
item read "not started" while its fix was on main. Banner repair, not a change
of plan.

Both stated limbs verified at origin/main 96c9a860 rather than inferred from the
PR title:

  Signature -- an AST probe located all three functions, so it was not blind:
  gzip_decompress :101, deflate_decompress :138, zip_decompress :195 each carry
  max_output_bytes keyword-only with NO DEFAULT. That is the construct the item
  asked for, a gate that refuses when the precondition is absent, rather than a
  changed default value, which the parent item #1129 explicitly rules out.

  Tests -- tests/test_compression.py pins it: "Calling a decompressor without
  max_output_bytes is a TypeError, not an unbounded read", with a
  pytest.raises(TypeError) assertion. The re-exported public surface still
  resolves in messagefoundry/__init__.py and parsing/__init__.py.

This closes NO ASVS cell and the amendment says so in the item. The verdict is
the assessor's and the vault scorecard is the record of record; the "before
uncompressing" reading question is unresolved without the pre-pass #1237
deliberately excluded, which remains unfiled and is an owner call.

Controls: parse_items 277 items / 203 open / 74 closed before, 277 / 202 / 75
after -- 0 / -1 / +1, the expected delta for one close. backlog_status_check
green, every item declaring exactly one status. Banner invariant checked on the
item body: one closed-alphabet character, zero open-alphabet characters.

* backlog: strike #1245's false delete clause, and narrow two overclaims

#1245's SCOPE paragraph said the bootstrap account "cannot be renamed
(update_user does not rename) or deleted, so it persists as a permanently
disabled row". The rename half is correct. The delete half is FALSE.

Reproduced end to end by a second session: DELETE /users/<bootstrap admin>
returns 200 {'detail': 'deleted'}. Confirmed here independently from the code --
BOOTSTRAP_USERNAME appears 0 times in messagefoundry/api/auth_routes.py, with a
positive control of 7 occurrences in auth/service.py so the probe discriminates.
No delete-time guard names the bootstrap account. The only guard on that route
is is_last_enabled_admin (auth_routes.py:714), which skips disabled users, and
retirement is what disables this one.

Why the correction matters more than the fact: "persists as a permanently
disabled row" is what makes this read as an availability defect with no exit.
There is an exit and it is destructive. A fix must not rest on the row being
undeletable, and a reader checking this paragraph would otherwise re-conclude a
related defect is unreachable and close it as impossible.

Two narrower corrections in the same pass, both REDUCING what the item claims:

  "Silent at both ends" is half wrong. The 201 response body does carry
  disabled:true (auth_routes.py:656-658 re-reads after retirement, _user_summary
  sets it at :195). It is silent at the login end only, via the generic 401 that
  is deliberately indistinguishable from a wrong password.

  Login is not the sole retirement trigger: auth/service.py:518 fires on every
  service start and :2551 on create, so a regression test assuming :650 is the
  only path is narrower than the defect.

Struck rather than deleted, so the wrong version stays visible to the next
reader. The item stays open and its severity is unchanged.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 280 items / 205 open / 75 closed, unchanged.

* backlog: retract my own #1245 narrowing -- it was measured on the wrong route

Forty minutes ago I amended #1245 to say "silent at both ends" was half wrong,
on the ground that a 201 response body carries disabled:true. That measurement
is TRUE and it is about a DIFFERENT ROUTE.

auth_routes.py:656-658 and _user_summary:195 are POST /users -- a create, and
the stacked-admin-name defect's route. #1245 is a RESET defect. The reset route
at auth_routes.py:753 ends at :776 with

    return PasswordResetResponse(temp_password=temp)

no re-read, no _user_summary, no disabled field.

And the stronger reason, which makes "silent at both ends" true in principle
rather than by omission: admin_reset_password (auth/service.py:2717) does not
call _retire_superseded_bootstrap at all. Its only three call sites are :518,
:651 and :2551 -- positive control, the probe resolves real sites. So the re-arm
is LATENT: at the moment the reset returns nothing has happened yet, there is no
disabled state to report, and a re-read there would correctly say disabled:false.

"Silent at both ends" therefore STANDS for this item. The create-path fact is
real and belongs in the stacked-name item instead.

Caught by the builder holding #1245, which re-measured rather than accepting a
correction from the dispatcher. That is the second time today the two of us have
hit the same shape in opposite directions: an instrument answering truthfully
about the neighbouring question. Kept struck rather than deleted, because the
two routes are adjacent in one file and the wrong version is what a later reader
would re-derive.

One correction from that pass DOES stand and is retained: login is not the sole
retirement trigger (:518 on service start, :2551 on create), so a test assuming
:651 is the only path is narrower than the defect. Recorded as already handled.

SECOND DEFECT IN THIS SAME EDIT, caught by the before/after control and fixed
before commit: the retraction was first written with a closed-alphabet character
opening a blockquote in the item body. parse_items read it as a status banner
and #1245 flipped to CLOSED -- 280/204/76 against an expected 280/205/75. A live
item under active build, removed from the queue by a prose edit. The rule is
absolute for exactly this reason: no banner-alphabet character in an item body,
any position. Say the word.

Controls after the fix: 280 items / 205 open / 75 closed, #1245 is_open True,
zero closed-alphabet characters in the body, backlog_status_check green with
every item declaring exactly one status.

* backlog: close #1240, record #1241 as partial -- the ledger edit PR #379 cannot make itself

PR #379 is red on a required check that says a PR implementing BACKLOG #N must
update BACKLOG.md. The owner's 2026-08-13 ruling says a builder may resolve merge
conflicts but may not author ledger content. Those two are mutually unsatisfiable
for a compliant builder PR, so the builder correctly withheld the banner and the
PR correctly went red. Authoring is dispatcher and lander only; this supplies the
edit. Neither a bug nor anyone's error -- two correct rules meeting.

#1240 CLOSED. Verified before signing by printing the operands on both refs
rather than counting them, after a count instrument returned 0 on a string the
printed lines visibly contained:

  origin/main   _FHIR_TYPE_RE = re.compile(r"^[A-Za-z]+$")
  PR #379 head  _FHIR_TYPE_RE = re.compile(r"^[A-Za-z]+\Z")

$ -> \Z on the two pattern definitions, call sites unchanged. That is the durable
form: it covers all three call sites at once and cannot be re-broken by a future
caller, where converting the calls to .fullmatch would fix three and leave a
fourth free to reintroduce it. The read-path _reject_control_chars limb was
deliberately not added -- redundant once the gates are strict, and it would
reintroduce duplication that #1239 records as retired.

The item also records that the obvious regression test cannot discriminate:
_resolve_read_url strips, so "Patient/123\n" yields an identical URL before and
after the fix and only "Patient\n/123" flips. Measured by executing the shipped
and patched sources, not argued.

#1241 STAYS OPEN, amended to record partial progress. #379 fixed construction-time
screening plus a wrong-exception-class defect worse than the filed finding --
http.client.InvalidURL derives from HTTPException, not ValueError and not OSError,
so it escaped every except arm in _post including the backstop written for that
case. Still outstanding: transports/dicomweb.py, which the item names, and a
second unscreened url-construction site in FhirLookupExecutor in the same file.
The item's subject is the ASYMMETRY, so one sink screened while a sibling is not
reproduces the very defect being reported. A partial close would be wrong.

Two corrections to #1241's filed text, neither reducing severity: its comparison
clause INVERTS rather than going stale, because the neighbouring path it called
"weaker but at least screening" was removed outright, leaving :431 the only
unencoded interpolation in the file; and its enum rationale is right advice for
the wrong reason, since containment comes from the !r conversion rather than the
enum's closedness.

Controls: parse_items 281 items / 206 open / 75 closed before, 281 / 205 / 76
after -- 0 / -1 / +1, the expected delta for exactly one close and one amendment.
backlog_status_check green, every item declaring exactly one status. Banner
invariant checked per item: #1240 one closed-alphabet character and zero open,
#1241 zero closed and one open.

* backlog: flip #1204 to shipped, and record that #1203 is abandoned rather than free

#1204's banner read OPEN while its own body said "FIXED in the same change" and
its Verdict line said "build (done)". Banner repair, not a change of plan.

Verified at origin/main before signing, with a discriminating control. All four
artifacts ship: scripts/docs/asvs_tally_lint.py, scripts/docs/asvs_tally_baseline.txt,
.github/workflows/asvs-tally-lint.yml, tests/test_asvs_tally_lint.py. A deliberately
impossible path under the same probe returned ABSENT, so the four PRESENTs are
evidence rather than a probe that answers yes to everything.

One defect found while verifying, and it is not what it first looks like.
asvs-tally-lint.yml:3 cites BACKLOG #1203; the item it implements is #1204. The
obvious reading is a typo pointing at an unissued number, and that reading is
wrong in the direction that causes harm: it would send someone to file #1203 as
free.

Measured: "## 1203." appears in neither docs/BACKLOG.md nor
docs/archive/backlog/BACKLOG-CLOSED.md, with "## 1204." resolving in the live
ledger as the positive control. But the allocator record
mefor-coord/alloc/backlog/1203.json EXISTS, titled "Decide how the public engine
repo obtains the private ASVS scorecard for --prove-absences".

So #1203 is ALLOCATED AND NEVER FILED -- abandoned, not free. Numbers are never
reclaimed and holes are free, so the hole costs nothing. What costs something is
that nothing reports an allocated-but-unfiled number, and a live citation makes
it look issued. The :3 correction to #1204 is a one-word fix and rides with
whatever next touches that workflow.

Controls: parse_items 281 items / 205 open / 76 closed before, 281 / 204 / 77
after -- 0 / -1 / +1, the expected delta for one close. backlog_status_check
green, every item declaring exactly one status. Banner invariant on the item
body: one closed-alphabet character, zero open-alphabet.

* docs(adr): ADR 0165 -- a builder PR satisfies the ledger gate with a paired commit

Records a coordination decision that until now existed only in session messages
and a queue file, which is the exact shape this project keeps being bitten by --
a ruling with no artifact behind it.

THE COLLISION. The required check "a PR that implements BACKLOG #N must update
BACKLOG.md" demands a ledger edit in the PR's own diff. The owner's 2026-08-13
authoring ruling forbids a BUILDER to author ledger content, on the property that
a mechanical union cannot invent a disposition but authoring a banner can, and a
seat that can author its own item's banner can turn its own PR green. Composed,
a compliant builder PR cannot pass a required check. Measured live: PR #379 went
red for obeying the ruling.

THE DECISION. The Dispatcher or Lander authors the disposition and the commit
rides on the PR branch. Owner-ruled a1.

THE PART THAT INVERTED ON MEASUREMENT. Reading the gate rather than reasoning
about it: backlog-hygiene.yml:64-98 computes a three-dot diff and passes if the
changed set touches docs/BACKLOG.md or docs/archive/backlog/. It never inspects
authorship. Evaluated against the real cherry-picked head for #379 -- touches_code
1, ledger 1, PASS. So the pattern was in force before it was named, no gate change
was required, and none is pending.

The ledger gate permits the cherry-pick for a non-obvious reason: it iterates
headings added relative to base, and a banner flip or amendment on an item already
on main adds no "## N." heading, so ownership is never consulted and the committing
seat is irrelevant. Holds only for landed items; a PR that FILES an item is a
different shape.

REJECTED, with reasons rather than preferences. (a2) separately-landed plus
cross-branch correlation would undo a deliberate control -- the gate uses three-dot
on purpose and its own comment says two-dot "would pass while enforcing nothing".
(b) a builder carve-out to flip its own banner reopens the self-approval hazard.
(c) as a distinct interim dissolved: it is the same mechanism, so there is no
transition.

RECORDED NEAR-MISS, kept rather than deleted because the wrong version is what a
later reader re-derives: the ruling was briefly written as "(c) is fine until (a)
lands" -- an expiry whose trigger had ALREADY FIRED. It looks like the safe
construction and behaves like the unsafe one, becoming permanent by default while
appearing bounded.

Provenance is split three ways in the ADR because each half is only checkable if
attributed: the collision found by the Lander on #379's red check, the
self-approval property by Builder 2, the gate measurement and the no-build finding
by the Dispatcher, the ruling by the owner.

ADR number allocated atomically to this worktree; index row added in the same
commit, as the ledger gate requires. No engine behaviour changes.

Note for whoever integrates: docs/adr/README.md is an APPEND/APPEND conflict with
claude/builder-seat-playbook-bf2ead, which appends ADR 0164's row at the same tail.
Both rows are additive and disjoint -- take both sides.

* backlog: measure one limb of #1143's research question, and fix a blank-line citation

#1143 asks what identification keyed on the IdP-namespaced subject would actually
require across all three store backends. One limb of that is now measured rather
than left to be re-derived by whoever picks the research up.

MEASURED at origin/main, with a discriminating control:

  UNIQUE index or index naming oidc_issuer / oidc_subject:
    store.py 0    postgres.py 0    sqlserver.py 0
    positive control: "UNIQUE" appears 13 times in store.py, so the probe
    discriminates and the three zeroes are real absences

  column types today:
    postgres.py:531-532   oidc_issuer TEXT, oidc_subject TEXT
    sqlserver.py:1357     oidc_issuer NVARCHAR(MAX) NULL,
                          oidc_subject NVARCHAR(MAX) NULL

So the federated columns exist and carry no uniqueness constraint of any kind. An
(issuer, subject) identity key is therefore not a code-only change: it needs a
unique index on all three backends, and on SQL Server NVARCHAR(MAX) cannot be an
index key column at all, so both columns must first be re-typed to a bounded
NVARCHAR(n). That is a second migration on that backend.

That cost is an INPUT to choosing between the candidate designs rather than a
consequence of having chosen one, which is why it belongs in the item before the
research runs rather than after.

CITATION FIX in the same pass: the banner cites store.py:1590 for users.username.
:1590 is a BLANK LINE; the declaration "username TEXT NOT NULL UNIQUE" is at
:1593. Found independently by two seats, so it is recorded rather than quietly
patched.

Explicitly NOT settled, and stated in the item: the ceremony for the first
federated login of an account that predates federation. That remains the item's
hard question and nothing above touches it. A migration cost informs that
decision; it does not answer it.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged.

* backlog: audit #1020's directory path -- it widens, and it invalidates one candidate fix

#1020 said "the AD/OIDC-provisioned path in auth/reconcile.py was not audited, so
the finding may narrow to local accounts". Audited now. Wrong file, and it widens
rather than narrows.

Every link opened individually, because a chain of separately-verified links is
not a verified chain:

  authenticate_oidc      auth/service.py:942   -> returns _complete_ad_login :1056
  _complete_ad_login     auth/service.py:1081  -> calls _upsert_ad_user :1107
  _upsert_ad_user        auth/service.py:1209  -> update_user_profile(email=principal.email)
  update_user_profile    store/store.py:7742   -> UPDATE users SET display_name=?, email=?, ...

Both the AD and the OIDC login paths provision through the SAME function,
_upsert_ad_user -- not auth/reconcile.py, which the struck sentence names.
authenticate_oidc returns _complete_ad_login directly, so one provisioning path
serves two providers.

The sharp end is the unconditional write. update_user_profile issues
UPDATE users SET display_name=?, email=? with no conditional and no coalesce, and
_upsert_ad_user calls it on every directory login with whatever the directory
asserted. So a directory-sourced account cannot retain a hand-set address: an
operator who sets one via PATCH /users/{id} has it overwritten at the account
holder's next login. LDAP mail is optional at every layer, so where the directory
asserts nothing the address returns to NULL.

That invalidates one of the item's three candidate fixes. "Add a self-service
email field" does not reach directory-provisioned accounts at all -- whatever the
user sets is overwritten on their next login by the same unconditional write. Any
fix gating on "a privileged account must have a deliverable address" needs a
separate answer for the directory-sourced population, which moves it into the
owner's decision rather than leaving it an implementation detail underneath.

Deliberately NOT re-litigated: "Difficulty 3, no schema change, no migration cost"
may still hold for the local-account half, and nobody has measured it for the
directory half. The amendment says so rather than quietly widening the estimate.

Also removed a pre-existing closed-alphabet character from this item's BODY at the
old :4111. It was not flipping the item -- the counts were identical before and
after -- but the rule is absolute for exactly that reason: position decides
whether it parses as a status banner, and four items were mis-parsed by this class
today. Replaced with the word.

Provenance: the widening was measured by the Builder 2 seat during a blind
re-verification pass; the chain above was re-read link by link here before being
written into the ledger.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged.

* backlog: record #1020's owner ruling, and correct the fix location it points at

Owner ruled option (b): gate startup on a deliverable channel. Recorded in the
item because until now the ruling existed only in session messages, which is the
failure mode this session has been correcting all evening -- a decision with no
artifact behind it.

The deciding argument is recorded as the reason rather than only the choice:
(b) is the only option that does not rest on an operator action. That is
decisive because update_user_profile issues

    UPDATE users SET display_name=?, email=?

with no conditional and no coalesce, on every directory login (store.py:7742), so
any address a human sets on an AD or OIDC account is overwritten at the account
holder's next login. A fix depending on someone setting an address cannot cover
that population.

The item's stated fix location is wrong and a builder would walk into it. The
text points at __main__.py:2259, but _serve is synchronous and opens no store --
probing its full range for open_store|AuthService|list_users|count_users returns
one hit and it is a comment, and uvicorn.run is at :2827 so the lifespan
bootstrap has not run. The only place the store and the fresh bootstrap admin are
both in hand is the ASGI lifespan at api/app.py:~5852.

Option (c) is recorded as population-limited, NOT defective, and the amendment
says the ruling must not be cited as a finding that it was broken. A self-service
email field works for local accounts and is silently overwritten for directory
ones. The incompleteness was invisible to the operator, which is more useful than
"it was wrong" -- an earlier framing of mine that I withdrew.

Recorded as unpriced rather than carried forward: whether "Difficulty 3, no
schema change, no migration cost" still holds for the directory half. It may hold
for the local half; nobody has measured the directory half. A stale difficulty
estimate silently sets a lane's expectations.

The build is NOT dispatched. The pool is at HOLD NEW WORK / PROTECT AND WRAP, and
a builder taking this would be starting a new item and a new claim, which that
state prohibits. Recording the ruling is work in hand; building it is not.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged.

* backlog: record #1217 half 1 as built, half 2 outstanding -- the item stays open

PR #383 is red on "a PR that implements BACKLOG #N must update BACKLOG.md". The
builder withheld the banner correctly under the owner's authoring ruling, so the
ledger edit is the dispatcher's. This supplies it. Same shape as #1241 on #379,
and ADR 0165 records why that is the standing pattern.

Half 1, the >=1 floor, is BUILT. Verified on the branch against origin/main
rather than taken from the report:

  origin/main   retry_max_attempts: int | None = 100
  PR #383       retry_max_attempts: int | None = Field(default=100, ge=1)

A configured 0 or negative is now refused at load rather than loading clean and
dead-lettering on the FIRST failure -- the delivery check is
item.attempts >= max_attempts against a post-increment count
(pipeline/wiring_runner.py:5040), so 0 meant give-up-now while reading like
"no limit".

The floor is on the OPERATOR-FACING setting only, and that is deliberate.
RetryPolicy(max_attempts=0) remains a live internal idiom for a permanent
no-retry failure: measured across 5 files, including store.mark_failed call sites
and asserted by tests at tests/test_batch_completion.py:206-208 and
tests/test_postgres_store.py:3109. Constraining the dataclass instead would have
deleted a used mechanism while claiming to add a guard -- the
reads-as-hardening-but-removes-a-control shape.

The item's stated reason for deferring the floor is answered rather than ignored.
It said the floor was documented and not fixed "because a floor changes the
accepted-configuration set". Under section 0 there are zero deployments, so there
is no accepted configuration to break and no migration cost to protect.

STILL OPEN, and it is why the item does not close: whether the retry-forever
posture needs a TOML or env spelling. "", none and null all raise ValidationError,
so that posture is reachable in code-first configuration only. It is a product
question, it was handed back rather than decided, and the item itself says it
should be decided alongside the floor. A closure on #383 would answer it by
omission.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged, and
#1217 verified still OPEN after the edit.

* backlog: #1242's loss is irreversible, not merely expensive -- and a relay's framing corrected

The ASVS Tracker surfaced this defect via the Liaison as a candidate for a NEW
item. It is not new: it is #1242, filed 2026-08-13, and Builder 2 is building it.
No number was allocated. A duplicate ledger row is not a harmless extra line --
it splits the work and the second number looks unbuilt forever, because the fix
lands under the first.

Two things in the relay were genuinely new. One is recorded here; the other is
deliberately not.

RECORDED: the loss is not recoverable by re-running the derivation. The anchors
most at risk are the D3 backfill's, and their warrant was that two independent
derivations AGREED, measured at two different refs. Those refs have moved. So a
fresh derivation reproduces values without reproducing the agreement that
justified writing them, and that agreement is the whole evidentiary content. The
loss is therefore irreversible rather than expensive, which is why this item
outranks other writer defects rather than being one among them. Nothing in the
item said this.

NOT RECORDED, deliberately: the supporting anchor counts. docs/BACKLOG.md is
public, and a tally over a closed public requirement set is the shape that hands
out coverage by subtraction. The mechanism is fully stated without them -- a
reader with vault access can price it, and a reader without one still knows what
to fix and why. Verified my added lines carry no such figure, with a positive
control proving the scan discriminates.

AND THE RELAY'S FRAMING IS CORRECTED BY THE ITEM'S OWN TEXT. It described the
defect as dropping sym/ctx. #1242 already forbids fixing it that way: the defect
is the handling of UNKNOWN keys, and a fix special-casing those two by name
rebuilds the same trap for the next field added. The item was ahead of the relay
and a builder must follow the item.

The Tracker's core claim was verified here rather than taken: sym and ctx each
return 0 occurrences in scripts/asvs/apply.py at origin/main, positive control
expect returns 2.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 281 items / 204 open / 77 closed, unchanged, and
#1242 verified still OPEN.

* backlog: close #1238 and #1239 on the code, and file #1253 so the closure does not retire the hazard

Builder 2 reported four banners owed. Two of the four -- #1237 and #1204 -- were
already authored on this branch and are invisible to that lane because ledger
authorship and push are held by different seats. That is recorded as a finding in
the episode note; it is not fixed here. The two genuinely owed are written now.

Both closures verified against origin/main rather than against the build report,
because a banner that closes on a report inherits the report's errors.

#1238: _is_contained_name is defined at transports/remotefile.py:97, wired at
:954, and asserted in BOTH polarities at tests/test_remotefile_transport.py:1185
and :1195. The one-polarity case is called out because such a test passes against
a function that refuses everything. posixpath.basename() was not used, per the
owner ruling.

#1239: _has_control_char returns 0 occurrences across messagefoundry/ at
origin/main, so the pair it named is a single. The item's own condition is met.

#1253 exists because closing #1239 there would have been true of the item as
written and false of the hazard it describes. The reporting lane amended its own
closure recommendation to say so -- the predicate is copied more widely today
than when #1239 was filed, partly by the work that resolved it. A repo-wide
re-measure widened that further: the amendment scanned transports/ and found five
sites across four files; across messagefoundry/ it is seven across six, the two
extra being config/codeset_edit.py:305 and config/impact.py:631.

Two exclusions are recorded in the item so a later scan does not re-add them:
rest.py:109 matches a naive grep but is prose in a docstring, and sniff.py:179
tests the same code points through a genuinely different byte-wise predicate that
subtracts an allowlist, so folding it in would change its behaviour.

rest.py:111 strips where the others reject. That is recorded as defensible and
NOT as a second instance of the pattern the owner ruled against in #1238, so the
next reader does not inherit a false lead: stripping CR/LF from a header value
cannot redirect a request, whereas basename() mutates a path into a real and
different target.

#1253 allocated with alloc.ps1, never grepped. parse_items before and after:
281/204/77 -> 282/203/79, matching the predicted delta for two closures plus one
filing, with a control confirming no item carries a stray banner.

* backlog: record that #1234 is not startable from main -- its subject has not landed

Builder 2 refused a restock offer of #1234 by correcting its OWN earlier
recommendation, and verified before claiming rather than after. Re-measured here
rather than taken: at origin/main, require_least_privilege returns 0 hits in any
.py and appears only in this ledger's own prose. Positive control on the same
instrument, require_managed_identity, returns hits across four .py files, so the
scan sees Python fine -- the zero is a fact about the tree, not a broken needle.

The probe this item reports a defect in exists only on the
w3-store-privilege-preflight branch, dormant at that reading.

The amendment is careful not to overrule the item's own "independent of #1008"
paragraph, because that paragraph is right about a different thing. Both halves
hold: the item is not hostage to #1008's POLICY ruling, and it is nonetheless
unbuildable by any lane working from main until that BRANCH lands. Collapsing the
two would either re-gate a code defect behind a demand gate or keep offering work
whose subject does not exist.

This is the same wasted-claim cost as #1253's provenance, one layer deeper: there,
an item was unstartable because the FIX had already landed; here, because the
SUBJECT has not. A banner-driven queue cannot distinguish either case from
startable work, which is why both are now written down where the next dispatcher
reads rather than left in session mail.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 282 items / 203 open / 79 closed, unchanged, and
#1234 verified still OPEN.

* backlog: file #1254 -- a required check is named for its subject, not its assertion

Handed to me by the Liaison to number if I judged it worth one, in the Lander's
framing. It is, because the naive fix is dangerous and nothing currently records
that.

MEASURED INSTANCE: the Windows leg went red under the label
"test (windows-2025, py3.14)", which reads as "the tests failed on Windows". The
tests passed. What failed was the wall-clock gate "Step margin -- both gated
steps" (ci.yml:675). The check answered its own question truthfully and the NAME
described a different one -- the reverse of the shape this project keeps hitting,
where the label is honest and the instrument is not.

The job name is built at ci.yml:42 from the matrix, so all three legs are named
for WHERE they ran and never for WHAT they assert, while holding at least three
independent assertions. Stated as at least three rather than enumerated.

WHY THIS IS NOT A ONE-LINE RENAME, which is the whole reason it needed writing
down: those three strings ARE required contexts. They are listed in
.github/required-contexts.txt, asserted against branch protection by
tests/test_required_contexts.py, and matched BY NAME on the GitHub side. A
required-but-absent context blocks every PR forever, so a rename is one atomic
change across the workflow, the contexts file, that test's pinned count, and the
branch-protection setting, in the order that file's header prescribes.

So the item deliberately does NOT recommend the rename. It prices three options
and names the cheapest first: make the margin gate's failure output say in its
first line that the suite passed and a timing gate fired. That costs nothing and
cannot wedge the repo. The rename is listed third.

Severity carries no deployment axis, but the near-miss is recorded: the
misreading pointed at the wall-clock cap, and #1096's banner already says the
actual fix is #320 and that re-deriving the caps is itself the failure mode.

#1254 allocated with alloc.ps1, never grepped. parse_items before and after:
282/203/79 -> 283/204/79, matching the predicted delta for one filing, with a
control confirming no item carries a stray banner.

* backlog: amend #1235 -- its two named instances are inert, and I dispatched the opposite

Builder 2 refused the starting fact I gave it and measured instead. It was right
and I was backwards.

I told it to start #1235 from #1203 as a CONFIRMED LIVE TRAP, reasoning that an
allocation record with no ledger entry meant the number was free. The record is
what makes the number permanently UNAVAILABLE. Verified here rather than taken:
1203.json and 1231.json both exist in .git/mefor-coord/alloc/backlog/ (claimed
2026-08-09 and 2026-08-12), and alloc.ps1 has no release at all -- :41 "a one-way
door -- claims are never released", :24 "numbers are never reclaimed ... holes are
free, collisions are not". So the item's own text is wrong where it says #1231 was
"allocated and released without being filed", and wrong that the pair is "defused
only by an accident of timing". They are defused by construction.

ONE CORRECTION AGAINST THE REPORT AS WELL, because its reason is weaker than its
conclusion. The argument as relayed rests on the allocation RECORDS existing. Those
live under .git: uncommittable, machine-local, losable without trace. The reason
that survives their loss is structural -- alloc.ps1 issues $observed + 1 (:392,
and :389 under the public floor clamp) and NEVER fills a hole, so a number below
the floor is unreachable whether or not its record still exists. Recording the
registry as the protection would make a sound property look fragile and invite a
guard nothing needs.

The live shape is the other one and the item now says so: a citation to a number
NEVER allocated sits above the floor and will be issued in the normal course. A
detector reading only the ledgers rates the two states identically, which over
docs/ in this repo mis-scores 26 reserved citations as live; of the 6 genuinely
never-allocated tokens there, all six are foreign references, so this repo holds
zero genuine instances. The private-repo population the item was filed against is
not re-measured here and is stated as separate.

The remedy is unchanged and still correct. Only the account of WHY the two named
instances are harmless is corrected.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 283 items / 204 open / 79 closed, unchanged, and
#1235 verified still OPEN.

* backlog: correct #1235 and #1254 -- two of my own committed claims, falsified under adversarial check

I ran six independent skeptics over every claim I committed tonight, against the
SIMULATED POST-MERGE TREE rather than my branch, because my branch was six behind
origin/main and the merge is CLEAN -- git conflicts on concurrent edits, never on
invalidated claims. Four claims held. Two did not. Both failures are my authoring,
not merge drift: all cited files are byte-identical across the merge tree,
origin/main and HEAD.

#1235. The conclusion survives, the reason did not. I had written that the
allocation registry is irrelevant because the mechanism is structural. That is
FALSE for the newest number: the high-water ratchet persists $floor, the maximum
of the OBSERVED set (:205, :214, :215), NOT the number being issued, so after
issuing N it holds N-1. alloc.ps1 only PRINTS the heading, so until it is
committed the sole durable record of N is its own untracked, never-pushed
<n>.json. Lose that and the next run re-issues N. So the registry is exactly what
protects a just-allocated-but-unfiled number -- the state #1203 and #1231 were both
in when allocated.

What actually makes those two unreachable is a CONJUNCTION, now stated as one: the
loop never searches downward (:392, :389, :394), AND the floor is computed from
COMMITTED LEDGER HEADINGS. Measured non-destructively with -ShowFloor: floor 1254,
swept from docs/BACKLOG.md and the closed archive. Those are tracked content on
refs, they survive a fresh clone, and both numbers sit far below them. Recorded the
public-floor clamp as a THIRD, separate guarantee about the output range, with the
caveat that its own anti-lowering ratchet lives in the same untracked directory and
is disarmed on a registry-absent clone.

#1254 cited the margin gate as ci.yml:675. That is a clock MARK
(step_margin.py --mark between, :677). The gate is :765, if: always(), invoking at
:778 and :781. The error is worth recording rather than silently fixing: I opened
:675, found a step whose name NEARLY matched, and adopted it instead of treating
the near-match as the signal the line was wrong. A near-miss terminates the search;
no match would have continued it.

Also corrected in #1254: tests/test_required_contexts.py does NOT call the GitHub
API. It pins the count at :101 and resolves contexts against real workflow job
names at :107; the branch-protection comparison is a HUMAN step in the comment at
:100. The item's central argument is unaffected -- the strings are still required
contexts and a rename still resolves them to no job -- but the evidence now says
what the test does.

The four that held: #1253's seven-sites-across-six-files with both exclusions and
every line number, #1239's zero occurrences, #1238's defined-wired-and-both-test-
polarities, and #1234's zero .py hits with its positive control.

Amendments only, no heading added, so ledger ownership is not consulted.
parse_items unchanged at 283 items / 204 open / 79 closed.

* backlog: file #1255 -- two testpaths ship a top-level conftest each

Diagnosed by the lane whose own commit tripped it, and filed here because the
collision outlives that commit. Seven tests in one file failed in a full run and
passed in isolation, twice. Cause: pyproject sets two testpaths, both directories
contain a conftest.py, neither contains an __init__.py, so both claim the top-level
module name and a bare `import conftest` binds to whichever loaded first.

Verified at origin/main rather than taken from the report: both conftest.py files
present, both __init__.py absent, and a scan for `import conftest` /
`from conftest import` across both trees returns ZERO hits. That zero is why this
is filed as LATENT rather than live -- the collision is real and currently
untripped, so nothing is failing today and the item must not be cited as a current
gap.

The signature is recorded because it mis-attributes itself: the mis-bound import
surfaces as an AttributeError naming a module path from the WRONG package, not as
an ImportError, so it reads as a missing attribute rather than a bad import.

Two things the item forbids, both because a plausible fix is worse than the defect.
Do not import conftest BY PATH -- its body claims a per-process test slot and
registers an atexit unlink, so a second import under another name has side effects.
And do not prove a fix in isolation: isolation is precisely the condition under
which this defect reports success. The proof has to run both testpaths together and
then restore the bare import to confirm the same command fails again.

The house idiom already solves it -- tests/_workflow_contexts.py is imported
package-qualified at tests/_negative_controls.py:35 -- so the scope is to make the
name unambiguous, not to invent a mechanism.

#1255 allocated with alloc.ps1, never grepped. parse_items before and after:
283/204/79 -> 284/205/79, matching the predicted delta for one filing, with a
control confirming no item carries a stray banner.

* backlog: record that PR #382 closed ONE of #1242's four limbs -- the item stays open

I told a builder its engine fix closed this item's mechanism and to claim it. That
was wrong, and this records the correction where the next reader will hit it rather
than in session mail.

#382 merged 2026-08-13 with this item's number in its title and a title that
faithfully describes what it fixed: the payload-only TOP-LEVEL key limb. Verified
at origin/main -- apply.py:97 now walks {**(live or {}), **cell}.items() rather
than the live cell alone. That limb is genuinely closed.

The limb carrying the item's severity is untouched, and the same revision shows
why the union cannot reach it: :98 skips _ORDERED and _SUBTABLES BEFORE the union
at :97 is consulted for them, and evidence entries are re-emitted at :101-105 by
enumerating exactly path, line and expect (absence at :106-110 by exactly pattern,
positive_control, mutation). A key inside a [[cell.evidence]] entry is still
dropped -- which is exactly where the backfill put the affected keys, on evidence
ENTRIES and not on top-level keys. The top-level table-mangling limb also appears
untouched.

I had additionally told that builder to stop measuring the two affected key names
because the item forbids fixing by naming them. The prohibition is real but I
applied it to the wrong activity: the item forbids naming them in a FIX, not
measuring their absence as a SYMPTOM, and their absence from the writer is exactly
the evidence that the sub-table limb still bites.

Recorded as the PARTIAL-MOVE shape, which is the reusable part: a merged PR bearing
an item's number, whose title truthfully describes what it fixed, is the strongest
available signal the item is done. Verify-before-closing is not enough on its own
here -- the verification has to ask WHICH HALF. The item's own proof condition is
the discriminator and is unchanged: put an unknown key INSIDE an evidence entry,
re-render, assert both that it survives and that the guard refuses when it is
deliberately dropped. #382 does not satisfy it, and no test asserting only
top-level carry-through will.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 284 items / 205 open / 79 closed, unchanged, and
#1242 verified still OPEN.

* backlog: record #1242's BASE REQUIREMENT -- the obvious base for limb 4 reverts limb 3

Builder 2 confirmed limb 4 as I described it, then refused to build it and handed
it back with a reason better than the instruction I gave. Recording the reason,
because it is not discoverable from the item and git will not raise it.

Its branch still carried scripts/asvs/apply.py:88 as

    if key in _ORDERED or key in _SUBTABLES or key in cell:

Verified here against that ref rather than taken: the clause is present there and
ABSENT at origin/main. `or key in cell` is precisely what #382 deleted to fix limb
3. So a limb-4 fix authored on that base and merged would carry limb 3's REVERSAL
in the same diff -- no conflict, no marker, every check green, and the item's own
landed fix undone by the commit claiming to extend it.

Git raises nothing here because git conflicts on concurrent edits to the same
lines, never on a stale base re-asserting a clause that was deleted elsewhere. That
is the same family as the clean-merge hazard this session has been working under
all night, arriving from the direction nobody watches: not a doc invalidated by a
merge, but a FIX reverted by an extension of itself.

The item now states the base requirement and a pre-PR check that discriminates:
branch fresh from current origin/main, and confirm `or key in cell` returns zero
hits in the diff's own version of the file before opening a PR.

Also corrected upstream of this, in my own dispatch rather than the ledger: I had
told that lane to stop measuring the two affected key names. Measuring their
absence as a SYMPTOM was always legitimate; only fixing by naming them is
forbidden. It withdrew its acceptance of my earlier "bound lifted" on the grounds
that it had taken it from me without measuring -- correctly.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items before and after: 284 items / 205 open / 79 closed, unchanged, and
#1242 verified still OPEN.

* backlog: file #1256 -- the federated binding never checks subject exclusivity

Builder 1 concluded #1143's research and handed over the finding rather than a
commit: the defensible-ceremony question dissolves, because every candidate
collapses to trust-on-first-use when no out-of-band proof exists at first
federated login. What it surfaced instead is a separable gap, and that gap is
this item. Content theirs, number mine, per the authoring split.

Verified at origin/main rather than relayed. auth/service.py:1109-1114 compares
user.oidc_subject against the presented subject and refuses on mismatch, then
binds at :1119-1120. The comparison is keyed on the USER, so it is structurally
incapable of noticing a second account carrying the same (issuer, subject). A scan
for a UNIQUE constraint naming the federated columns returns 0 on ALL THREE
backends, so nothing below it closes the gap either.

The item credits the three shipped controls rather than implying an absence: the
hybrid-only refusal, the subject-continuity guard, and the UPN suffix allow-list.
All three constrain which subject may bind to a GIVEN account. None constrains how
many accounts one SUBJECT may bind to. Stating that explicitly is what should stop
this being re-closed as a duplicate of #1015 or #1143.

The difficulty is recorded where it actually lives. SQL Server types the federated
columns NVARCHAR(MAX), and a MAX column cannot be an index key, so a unique index
there needs a RE-TYPE and not merely a constraint -- a cost SQLite and Postgres do
not share. The proof condition requires demonstrating the refusal on every backend
in CI, because the two server store suites SKIP in a local run and a green on
SQLite alone would certify nothing.

#1143 is NOT closed by this and the item says so: whether TOFU is the defensible
ceremony is separable and still open.

#1256 allocated with alloc.ps1, never grepped. parse_items: 285 items / 206 open /
79 closed after, matching the predicted +1/+1/0 for a single filing, with a control
confirming no item carries a stray banner.

* backlog: record that #1020's refusal path hangs in-harness and is unverified under uvicorn

Reported by the lane that built the gate, against its own work, and recorded here
because it changes what "built" means for this item.

The gate refuses by raising during ASGI lifespan STARTUP, and in-harness that
HANGS rather than exiting. Their control is what makes it a measurement rather
than an impression: the sibling non-raising lifespan test passes in 1.13s, raising
from the lifespan BODY exits cleanly, and raising during STARTUP hangs with zero
output. It sits after engine.start() and before the task handles teardown expects,
so the condition is PRE-EXISTING -- the gate is simply the first thing to raise in
that window, which is why this is not filed as a defect in their fix.

What was NOT measured is what uvicorn does there, and uvicorn is the runner that
ships. They said so explicitly rather than letting the harness result stand for
the product, which is the reason this is worth recording at all.

The consequence is ordered plainly in the item: a startup refusal that hangs a
service is STRICTLY WORSE than the mis-report #1020 exists to correct. An operator
can see a wrong readiness answer; they cannot see a process that never finishes
starting. So the banner now carries an explicit bar on closing this on the gate
landing until the refusal is shown to TERMINATE under uvicorn rather than under
the test harness.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items unchanged at 285 items / 206 open / 79 closed, and #1020 verified
still OPEN.

* backlog: #1235 is PARTIAL, not closed -- the detector shipped, the rule did not

I was about to close this on PR #385 landing. An adversarial pass over my own
proposed banner refuted it, and the refutation is right.

What I would have relied on -- do the two files exist at origin/main -- passes
identically whether or not the rule landed and whether or not anything invokes the
detector. It measures PRESENCE, NOT ENFORCEMENT, and it is the same
cannot-fail shape as running a CLI's --help and reading exit 0, which I had
already caught once today in my own #1030 check.

Three measurements, each independently sufficient to block closure:

  the RULE is unwritten. #1235's Scope names its deliverable as "a rule, not a
  sweep", and that guidance appears at origin/main only in the item's own prose --
  zero hits for "unallocated" across CLAUDE.md, docs/LEDGER-GATE.md, CONTRIBUTING,
  scripts/, .github/ and .claude/.

  the DETECTOR is wired into nothing. Repo-wide it is referenced by exactly two
  lines, both inside its own unit test. Not in any workflow, not in
  .pre-commit-config.yaml, not in .mefor-hooks/pre-commit, not in pyproject.toml.

  it EXITS 0 even when it fires. main() ends `return 1 if args.fail else 0` and
  --fail is opt-in and passed by nothing. A planted live-shape citation was
  reported correctly and the process still exited 0. No test runs
  unresolved_citations over the real docs/ tree, so a new dangling citation turns
  nothing red.

The controls are what make those zeros trustworthy: the same wiring grep DOES
resolve three sibling scripts/docs tools that are wired into CI, and the detector
itself discriminates correctly when --fail is supplied. So the absences are facts
about the tree, not a broken pattern or a blind scan.

Banner moves to in-progress rather than closed, and the item now records what
shipped, the two residual limbs (write the rule where authors read it; wire the
detector with --fail or test it against the real tree), and a coverage bound that
survives both -- by its own docstring the detector cannot see the private
companion repository, which is where this item's filed instances live.

Closing on the detector's existence would have recorded an enforced rule where
nothing enforces it. The builder declined to close it for the same reason and left
the ledger half to me.

Amendment only, no heading added, so ledger ownership is not consulted. Both
glyphs are OPEN, so parse_items is unchanged at 285 items / 206 open / 79 closed,
with #1235 verified still OPEN and carrying exactly one banner.

* backlog: close #1230 on the owner-ruled half, with the wiring's own regression gap named

Four proposed banner verdicts went through an adversarial pass before any was
written. Three survived; one did not and was corrected separately (#1235). This is
the survivor, and it survived on evidence stronger than I would have gathered.

#1230 CLOSES because the loud-omission half is built AND WIRED, not merely
present. tests/_extras_probe.py supplies the emitters and tests/conftest.py binds
them to pytest's own hooks at :366 and :370. Verified by RUNNING rather than
reading, in both directions on two real interpreters: extras-complete venv, banner
ABSENT; the venv scripts/worktree/new.ps1 actually builds, banner FIRES in both
surfaces -- including on a bare full-suite run collecting 13,187 tests. The
silent direction was observed rather than assumed, which is what makes the loud
direction mean something.

Scope is exactly the half the owner ruled. new.ps1:232 is unchanged, so options
(a) and (b) -- installing the five extras into every worktree venv -- were
correctly not taken.

CLOSED WITH A NAMED RESIDUAL, because folding it into the closure would reproduce
the defect. Deleting BOTH hook functions from tests/conftest.py leaves
tests/test_incomplete_run_banner.py reporting 7 passed, while a real run goes from
banner-present to banner-gone. The tests drive the probe against a fake reporter;
nothing asserts that pytest invokes it. Repo-wide, pytest_report_header and
pytest_terminal_summary appear ONLY at conftest.py:366 and :370, guarded by no
test, lint or gate. So a conftest refactor can silently delete the mechanism with
every check green -- which is this item's own failure shape, one layer up, inside
the fix for it.

The item closes on the owner-ruled half working. The residual is recorded in the
banner rather than discovered later by whoever the silence next costs.

Amendment plus banner flip, no heading added, so ledger ownership is not
consulted. parse_items 285 items / 206 open / 79 closed -> 285 / 205 / 80,
matching the predicted 0/-1/+1 for a single closure, with a control confirming no
item carries a stray banner and #1235, #1249 and #1030 all verified still OPEN.

* backlog: file #1257 -- a startup refusal after engine.start() hangs instead of exiting

Found by the lane building #1020, against its own work, when it closed that item's
own open question: does the refusal terminate under uvicorn rather than under the
harness. It does not, and the answer blocks #1020.

The distinction is the finding. uvicorn behaves correctly -- full error printed,
"Application startup failed. Exiting.", SystemExit(3), no socket bound. The PROCESS
then never exits; measured alive 90 seconds later and killed. So this is a HUNG
refusal, not a silent one: an operator at a console sees exactly the right error,
and a SUPERVISOR sees a process that started and never stopped. The engine ships
under NSSM, and systemd and container runtimes decide the same way -- by process
liveness. Running-and-dead is the one state a restart policy cannot detect, which
is why this outranks the mis-report #1020 exists to fix.

Structural half re-verified here at HEAD rather than taken. Every pre-engine step
carries its own unwinding: api/app.py:5608 for startup attestation and :5628 for
the trust-anchor preflight each wrap in try/except BaseException, close the
notifier and store, and re-raise. From await engine.start() at :5731 to the yield
there is no try, no except and no finally at all, and auth_settings handling sits
at :5816-5818, inside that unprotected span.

Filed separately from #1020 deliberately. The cause is pre-existing and the gate is
merely the first thing that has ever raised in that window; a lifespan-teardown
change has its own blast radius in code every deployment runs and should not ride
in on an auth item.

The rejected option is recorded with its reason so it is not re-proposed: moving
the check before engine.start() fails on measurement, because the bootstrap admin
does not exist until auth.initialize(), which runs later.

The proof condition is written to exclude the checks that already pass: raise
deliberately in the post-engine span and assert the PROCESS EXITS -- not that the
error is printed and not that SystemExit is raised, both of which are true today
and neither of which discriminates.

#1257 allocated with alloc.ps1, never grepped. parse_items 285/206/79 -> 286/206/80
... note the closed count moves because the prior commit closed #1230; this filing
itself is +1 item / +1 open. Control confirms no item carries a stray banner.

* backlog: record that #1250 is now load-bearing, and keep the retroactive question separate

Owner ruled 2026-08-14 that an item whose substance is a weakness in the
coordination tooling or the seat topology is a DEFICIT and may not go in the public
ledger. With no private ledger existing, such an item PARKS pending #1250.

That changes what #1250 is. It was a proposal; it is now the thing a real,
measured, reproduced defect is waiting on, and the ruling applies to every future
item of this class rather than to the one instance. The cost of not having it is
therefore per-item and accumulating: each such finding lands in a coordination
handoff file, discoverable only by whoever thinks to look there.

I did NOT re-score the priority. The P2 line predates the ruling and is left
untouched deliberately -- re-scoring is the owner's call, and recording why an item
now matters is not the same act as deciding it matters more. Someone reading this
should be able to see the new fact and make that decision, rather than inherit a
number I moved quietly.

The parked item itself is not described here, only that one exists. Describing it
in this file is precisely what the ruling forbids, so the amendment records the
GATING relationship and nothing about the gated content.

The retroactive question is recorded as explicitly NOT settled by this. The ruling
answered where a NEW item goes; several items already in this ledger appear to be
the same class, and they have a different cost structure because unfiling from a
public repository does not unpublish anything. A boundary never applied
retroactively is not a boundary ignored, and merging the two questions would let
the cheaper answer decide the harder one.

Amendment only, no heading added, so ledger ownership is not consulted.
parse_items unchanged at 286 items / 206 open / 80 closed, #1250 verified still
OPEN, no stray banners.

* backlog: file #1258 -- classify existing ledger items against the deficits ruling

Owner-authorised. I raised this observation earlier and deliberately did not act on
it, on the grounds that reclassifying existing public items is not a dispatcher's
unilateral call. It was escalated, the owner said file it, so it is filed.

FILED AS BLOCKED BEHIND #1250, and that is a judgment I made before dispatching
rather than one discovered when the result lands. The sweep's product is a list of
public items that disclose tooling weaknesses. That list is an index to exactly
what the rule protects -- the same aggregation argument that kept the 2026-08-14
item out of this file. So the output cannot be written here, and with no private
ledger existing it has nowhere to go. Running the sweep first would manufacture a
finding that must then be parked in a handoff file, adding to the cost #1250 exists
to end.

WORDING CONSTRAINTS ARE THE SUBSTANCE OF THIS ITEM, not decoration on it. The item
names the RULE and the SCOPE and no candidates. It records no count either, because
a count over a bounded set is the same disclosure one subtraction later. Verified
before committing: the only backlog number appearing in the item's body is #1250,
its blocker, with a positive control showing the same pattern finds 543 references
across the file -- so the single hit is a true reading rather than a broken scan.
An item that enumerated its candidates would perform the defect it was filed to
find.

The remedy is explicitly left open. Unfiling from a public repository does not
unpublish anything, so what to do about anything found is a separate question with
a different cost structure, and this item must not answer it by implication. A
reclassification that moves text without reducing exposure is churn wearing the
shape of a fix.

The framing is a constraint too. The ruling is dated 2026-08-13 and the items most
likely to match were filed around the same time. A boundary never applied
retroactively is not a boundary ignored. This is hygiene, not an audit of anyone's
judgement, and if the output reads as an accusation it has been written wrongly.

#1258 allocated with alloc.ps1, never grepped. parse_items 286/206/80 -> 287/207/80,
matching the predicted +1/+1/0, no stray banners.

* docs(ledger): write the citation rule #1235 asked for, in both places a reader looks

#1235's stated deliverable was "a rule, not a sweep", and an adversarial pass
established that the rule existed nowhere at origin/main except the item's own
prose. A builder shipped the detector and correctly declined this half as
authorship rather than build work. This writes it.

TWO PLACES, because "where authors read it" is the whole point and they are
different audiences. CLAUDE.md section 5 gets it as a bullet directly beneath the
never-grep-for-a-number rule it mirrors -- an author reading the allocation rule
now meets the citation rule in the same breath. docs/LEDGER-GATE.md gets the full
treatment under its own section, next to the machinery.

THE RULE: either allocate the number before citing it, or write a reference that
CANNOT resolve. Naming the subject instead of a number costs nothing and cannot
arm.

WHAT THE LONG FORM ADDS, because a bare rule invites the wrong remediation:
- Only a citation ABOVE the allocation floor can ever arm. A reserved-but-never-
  filed number is inert PERMANENTLY -- alloc.ps1 issues $observed + 1, never fills
  a hole, and computes its floor from committed ledger headings that survive a
  fresh clone. Without this, a reader would treat every unresolved citation as a
  live trap and sweep the harmless majority.
- Foreign #N references are not citations of this ledger at all and are not the
  rule's subject.
- Enforcement does not replace the rule. A checker finds only what has already
  been written; the rule is what stops it being written.

THE CLAUDE.MD EDIT IS APPEND-ONLY inside an existing bullet list, and I verified
section numbering is unchanged -- 13 numbered headings before and after -- because
renumbering that file silently breaks citations across the tree and nothing
validates one. The new cross-reference was checked to resolve: the LEDGER-GATE.md
anchor it names exists.

#1235 stays PARTIAL. Limb (i) is discharged and recorded as such; the wiring and
fail-closed halves are a builder's work on an unlanded branch, so the item does not
close on this.

parse_items unchanged at 287 items / 207 open / 80 closed, #1235 verified still
OPEN and carrying exactly one banner.

* backlog: file #1259 -- parse_items censuses a conflicted ledger without error

The landing seat ran parse_items on a merge-tree output BEFORE checking the merge's
exit code and got a census matching my incoming batch's prediction exactly: right
item count, right open count, both new numbers present, no duplicates. The exit
code was rc=1 with six conflict markers in the blob. It reported the near-miss
against its own process rather than quietly reordering its checks, which is why
there is an item.

Reproduced here with a control rather than taken: the live ledger and a copy
poisoned with conflict markers BOTH parse to 287 items / 207 open, and nothing
raises. The counts being IDENTICAL is the finding -- the census cannot be used to
detect the condition, because the number is right and the file is unusable.

I nearly recorded that a gate already covers this. A grep for "conflict" across the
ledger gates returned a hit in ledger_check.py, and reading the context showed both
matches are PROSE -- a comment about clean merges and an error string reading "not
as a conflict". Neither detects a marker. backlog_status_check.py and
backlog_citation_check.py contain no detection either, and .pre-commit-config.yaml
runs nothing that inspects Markdown for markers. So a conflicted docs/BACKLOG.md
can be committed and every ledger gate passes over it.

Scope prices two options and says which one matters. The standard
check-merge-conflict pre-commit hook is the cheap general fix and covers every
file. Making the READER refuse a conflicted source is the one that protects
PROGRAMMATIC callers, and that is where this bit -- a hook does not help a gate
handed a tree in memory.

The proof condition excludes the check that cannot fail: poison a copy of the real
ledger and assert the reader FAILS. Asserting it parses a clean file proves
nothing; it already does that, and did so throughout the incident.

The general rule is recorded with the item because it outlives the fix: read the
EXIT CODE before the CONTENT, because a content check on a conflicted tree
certifies nothing.

#1259 allocated with alloc.ps1, never grepped. parse_items 287/207/80 -> 288/208/80,
matching the predicted +1/+1/0, no stray banners.

* backlog: reframe #1242 limb 4 as the unbuilt half of an existing spec

The ASVS Tracker supplied this from the design record and it is a better brief
than anything in the item so far. The promotion of the writer was SPECIFIED to
carry through the union of live and payload keys, so the schema could grow without
hand-editing the record. What shipped delivers that for top-level scalars and drops
it for sub-table entries.

So limb 4 is not a new requirement. It is the unbuilt half of one, and "restore the
specified behaviour" is a stronger instruction to a builder than "also handle sym
and ctx" -- the latter invites a fix keyed to the two names that happen to exist
today, which would satisfy the symptom and still drop the next field anyone adds.
The Tracker made that same point about its own earlier framing and I am recording
its version rather than mine.

The evidenc…
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