Repository navigation
Commit 97923fd
committed
docs(driver-memory): the
The `$eq`-only exemption above the no-value guard justified its
operator-shaped spelling by naming the cells it declined to move —
`$in: [null]` / `$nin: [null]` — as "#13357's cells,
`needs-user-decision`, held for the maintainer". That sentence stopped
being true on 2026-08-31, when the maintainer ruled them (option C) and
the shapes became REFUSED at the contract's validation entrance
(`assertListComparandShapes`), with the negative pin
`memory-null-list-member-unreachable.test.ts`.
This is not wording polish. `needs-user-decision` is a live protocol
state with a named reader — the maintainer's inbox. A source comment
asserting a cell sits in that state, when the door two packages over
refuses the shape by ruling, invites the next author to re-escalate a
settled question into the most expensive queue in this repo.
The same package already stated it correctly, twice: the `$gte: null`
note 34 lines below in this file ("the 2026-08-31 ruling had refused the
three siblings"), and the sibling header in
`memory-matcher-null-value-and-comparand.test.ts` ("They were
`needs-user-decision` when #13494/#13495/#13549 landed"). So the package
stated the decision state two ways, and the stale one is the one an
author reading this guard arrives at first.
The exemption's REASONING is deliberately unchanged: writing it over the
OPERATOR rather than over "the comparand is null" is still right,
because a rule spelled over the VALUE would still reach arms whose
no-value answer is ruled elsewhere. Only the cells' state moved —
refused at the door, rather than held. The note now says so, and says
explicitly that the ruling is not a licence to re-spell the exemption.
Comment-only. No arm, no guard condition, no behaviour: every added and
removed line in the diff is a `//` comment.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ARYe3yQTQCUFm5qPYNgKaJ$eq exemption's note says the null-list cells were RULED, not held (#15480)1 parent 1157e7b commit 97923fd
1 file changed
Lines changed: 18 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
309 | 309 | | |
310 | 310 | | |
311 | 311 | | |
312 | | - | |
313 | | - | |
| 312 | + | |
| 313 | + | |
| 314 | + | |
| 315 | + | |
| 316 | + | |
| 317 | + | |
| 318 | + | |
| 319 | + | |
| 320 | + | |
| 321 | + | |
| 322 | + | |
| 323 | + | |
| 324 | + | |
| 325 | + | |
| 326 | + | |
| 327 | + | |
| 328 | + | |
| 329 | + | |
314 | 330 | | |
315 | 331 | | |
316 | 332 | | |
| |||
0 commit comments