Skip to content

docs(ci): record the cited-example discipline the mention-shape rationales rely on #11444

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-steve merged 1 commit into from
Aug 23, 2026
Merged

docs(ci): record the cited-example discipline the mention-shape rationales rely on #11444

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 17 additions & 6 deletions scripts/check-cross-package-test-inputs.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -204,6 +204,17 @@ const REPO_ROOT = resolve(HERE, '..');
* Every entry names the test that justifies it, so the next person can check
* the radius against the code rather than trusting the glob.
*
* A rationale may cite a sibling path as an EXAMPLE only when that path is
* structurally unable to change status. The mention-shape entries below all
* reach for `check-nul-bytes.mjs`, which is load-bearing rather than habit:
* no test has a reason to READ a gate script, so "named rather than read"
* stays true of it for as long as the sentence exists. A path under active
* test does not qualify -- `sync-template-versions.mjs` was cited that way
* until #9763 taught the collector to see the split-segment read that
* `template-version-stamps.test.ts` had been making all along, and every
* sentence naming it went false at once, in copies that had to be retired one
* at a time. Cite the invariant example, or name no sibling at all.
*
* `heldBy` is that sentence made CHECKABLE for the globs the roster cannot see
* (#10566). Most globs are held mechanically: some path the tests name lands
* inside them, and `globHolderVerdict()` finds it. A read whose path this
Expand Down Expand Up @@ -546,12 +557,12 @@ export const CROSS_PACKAGE_TEST_INPUTS = {
'packages/runtime/src/**',
'packages/services/service-sms/src/**',
// The three below are NAMED in that test's prose rather than read by it —
// the same shape as `serve.ts` on the @objectstack/spec entry above and
// `realtime-protocol.mdx` on @objectstack/dogfood, and settled the same
// way: the literal collector takes quoted paths without parsing, so a
// mention forces a declaration, and declaring the file is cheaper than
// rewording prose to dodge the scanner. All three are low-churn, so the
// added cache invalidation is nominal next to the two directories above.
// the same shape as `check-nul-bytes.mjs` on the @objectstack/cli entry
// above, and settled the same way: the literal collector takes quoted
// paths without parsing, so a mention forces a declaration, and declaring
// the file is cheaper than rewording prose to dodge the scanner. All
// three are low-churn, so the added cache invalidation is nominal next to
// the two directories above.
'scripts/check-published-files.mjs',
'scripts/check-cross-package-test-inputs.mjs',
'packages/types/src/node-isolation.test.ts',
Expand Down
Loading