|
160 | 160 | * |
161 | 161 | * That objection is correct and is answered here structurally, not waived. |
162 | 162 | * `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 |
167 | 168 | * is a visible, reviewed edit to this file, not an inline mute marker scattered |
168 | 169 | * through the corpus; `--self-test` rejects an entry without a reason and pins |
169 | 170 | * 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']; |
238 | 239 | /** |
239 | 240 | * Instruction files permitted to quote the broken spelling as a WARNING. |
240 | 241 | * |
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. |
243 | 244 | * |
244 | 245 | * Shape: `{ path, reason }`. The reason is required -- `--self-test` refuses an |
245 | 246 | * entry without one -- because "why is this file allowed to spell it" is the |
246 | 247 | * whole content of the exemption. |
247 | 248 | * |
248 | 249 | * @type {{ path: string, reason: string }[]} |
249 | 250 | */ |
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 | +]; |
251 | 261 |
|
252 | 262 | /** Roots read as the agent-facing instruction corpus. */ |
253 | 263 | export const INSTRUCTION_ROOTS = ['.claude', 'skills']; |
|
0 commit comments