Skip to content

Commit cd27234

Browse files
committed
docs(pm): correct the subtraction measurement in the matcher docblock
All nine promoted scripts become gate files, not six; four were followed on the base tree over 111 import edges and all four declare zero literals, which is why the net subtraction is zero. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015ahemw8RcTgqtxrj15PEZx
1 parent ff20f81 commit cd27234

1 file changed

Lines changed: 14 additions & 11 deletions

File tree

scripts/pm/dispatch-gates.mjs

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -493,9 +493,8 @@ const SELF_TEST_INVOCATION =
493493
*
494494
* ## Why a `check-` basename is skipped here rather than re-keyed
495495
*
496-
* 21 of the 30 self-test-shaped invocations on this tree already have a
497-
* `check-` basename and are therefore already families under their BARE path
498-
* key. Admitting them again under a `… --self-test` key would SPLIT each into
496+
* 21 of the 30 scripts invoked this way on this tree already have a `check-`
497+
* basename and are therefore already families under their BARE path key. Admitting them again under a `… --self-test` key would SPLIT each into
499498
* two families and move its matches to the new key — a re-attribution reported
500499
* as a gain, which is the error this repo keeps catching. Skipping them makes
501500
* zero re-attribution a property of the code rather than a number that happened
@@ -517,14 +516,18 @@ const SELF_TEST_INVOCATION =
517516
* tree its self-test clones), `pm/ci-failure.mjs` +30 (`.github`),
518517
* `pr-labels.mjs` +1 (`.github/labeler.yml`).
519518
*
520-
* Six of the nine — `invoked-as.mjs`, `js-comment-mask.mjs`, `ts-parse.mjs`,
521-
* `partition-test-shards.mjs`, `git-history.mjs`, `pr-labels.mjs` — also become
522-
* GATE FILES, which `discoverFamilies` excludes from import-following. That is
523-
* the one direction of this change that could SUBTRACT, so it is measured
524-
* rather than argued: of the six, only `pr-labels.mjs` declares a hint at all,
525-
* and no gate imports it, so zero families lose an inherited hint. Asserted in
526-
* the self-test, because a subtraction here is silent — a lead that stops
527-
* appearing looks exactly like a lead that was never earned.
519+
* All nine also become GATE FILES, which `discoverFamilies` excludes from
520+
* import-following. That is the one direction of this change that could
521+
* SUBTRACT, so it is measured rather than argued. Four of the nine were being
522+
* followed on the base tree, over 111 import edges — `invoked-as.mjs` by 77
523+
* families, `ts-parse.mjs` by 18, `js-comment-mask.mjs` by 14,
524+
* `pm/git-history.mjs` by 2 — and all four declare ZERO path literals, so the
525+
* edges carried nothing to lose. The three that do declare literals
526+
* (`release-rehearsal-clone.mjs` 7, `pm/ci-failure.mjs` 2, `pr-labels.mjs` 1)
527+
* are followed by no family at all. Net subtraction: zero hints, zero pairs.
528+
* Asserted in the self-test rather than left as this paragraph, because a
529+
* subtraction here is silent — a lead that stops appearing looks exactly like
530+
* a lead that was never earned.
528531
*
529532
* ## What is NOT closed here, and why it is not folded in
530533
*

0 commit comments

Comments
 (0)