Skip to content

Commit 02c4c02

Browse files
committed
tooling(cutover): check:agent-test-spelling declares ui/AGENTS.md as a counter-example file (objectstack#25803)
Bill item 21(c) amendment: ui/AGENTS.md quotes `pnpm --filter <pkg> test -- --run <paths>` inside the warning that teaches it (objectui's trap two). The gate's header rules that case: a COUNTER_EXAMPLE_FILES entry with a reason, never a reworded warning. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CUXv64KLMfYv3ia2sWi6te
1 parent 25b5d2b commit 02c4c02

1 file changed

Lines changed: 17 additions & 7 deletions

File tree

‎scripts/check-agent-test-spelling.mjs‎

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -160,10 +160,11 @@
160160
*
161161
* That objection is correct and is answered here structurally, not waived.
162162
* `COUNTER_EXAMPLE_FILES` is a declared list of instruction files permitted to
163-
* spell the bad form as a warning, each entry carrying a REASON. It is EMPTY
164-
* today, because #11425's refusal is prose ("everything after a bare `--` is
165-
* discarded") rather than a quoted bad command -- so the escape hatch is not
166-
* yet needed, and an empty list is the honest state to record. Adding an entry
163+
* spell the bad form as a warning, each entry carrying a REASON. #11425's own
164+
* refusal is prose ("everything after a bare `--` is discarded") rather than a
165+
* quoted bad command, so this repo's corpus never needed the hatch; its one
166+
* entry is the imported objectui contributor guide, which quotes the broken
167+
* command inside the warning that teaches it. Adding an entry
167168
* is a visible, reviewed edit to this file, not an inline mute marker scattered
168169
* through the corpus; `--self-test` rejects an entry without a reason and pins
169170
* the list small, so it cannot grow into a mute button.
@@ -238,16 +239,25 @@ export const RULE_OWNING_FILES = ['scripts/check-agent-test-spelling.mjs'];
238239
/**
239240
* Instruction files permitted to quote the broken spelling as a WARNING.
240241
*
241-
* See the header. EMPTY today and that is a measurement, not an oversight:
242-
* #11425's refusal is prose, so nothing in the corpus needs the hatch yet.
242+
* See the header. #11425's refusal is prose, so nothing objectstack wrote needs
243+
* the hatch; the one entry arrived with the `ui/` import at the cutover.
243244
*
244245
* Shape: `{ path, reason }`. The reason is required -- `--self-test` refuses an
245246
* entry without one -- because "why is this file allowed to spell it" is the
246247
* whole content of the exemption.
247248
*
248249
* @type {{ path: string, reason: string }[]}
249250
*/
250-
export const COUNTER_EXAMPLE_FILES = [];
251+
export const COUNTER_EXAMPLE_FILES = [
252+
{
253+
path: 'ui/AGENTS.md',
254+
reason:
255+
'objectui\'s contributor guide (imported as ui/ at the cutover) lists `pnpm --filter <pkg> test -- --run <paths>` ' +
256+
'as its "trap two" (objectui#3288): the bullet quotes the broken command to explain that pnpm forwards the `--` ' +
257+
'and vitest drops every path after it, and ui/scripts/vitest-invocation-guard.mjs refuses the form at run time. ' +
258+
'Rewording the quote would delete the warning, which is the case this list exists for.',
259+
},
260+
];
251261

252262
/** Roots read as the agent-facing instruction corpus. */
253263
export const INSTRUCTION_ROOTS = ['.claude', 'skills'];

0 commit comments

Comments
 (0)