feat(devx): pin the teaching corpus against lexical claim drift (#13582) (#13742)

A table-driven, shrink-only ratchet over `content/docs` and `skills`: it
fails when a spelling the platform implements stands within a few lines of
prose naming a semantic it does not have.

#13539 taught `$exists` as a key-presence test when it asks whether the
field HAS A VALUE. The false line was a `//` comment INSIDE an `os:check`
block, so `check-skill-examples.ts` type-checked that exact block green —
"has a value" and "the key is present" type identically — and both
`skills/**` sites shipped to customers.

Table-driven per the #13582 triage ruling, carrying the `$exists` family
only. The engine takes the table as a parameter and `--self-test` drives a
synthetic second row through it, so genericity is proven without filling
the table.


Claude-Session: https://claude.ai/code/session_01Pk26oZ12t5N1hwGW1m1MgC

Co-authored-by: Claude <noreply@anthropic.com>

Author: os-project-manager

.github/workflows/lint.yml

@@ -1767,6 +1767,28 @@ jobs:
       - name: Reserved-word ("role") docs ratchet
         run: pnpm check:role-word
 
+      # #13582: a LEXICAL anti-drift ratchet over the same corpus, and the
+      # sibling of the step above rather than a duplicate of it. That one asks
+      # whether a reserved WORD appears at all; this one asks whether a spelling
+      # the platform implements is standing next to prose describing a semantic
+      # it does not have. #13539 taught `$exists` as a key-presence test when it
+      # asks whether the field HAS A VALUE, and the false line was a `//` comment
+      # INSIDE an `os:check` block: `check-skill-examples.ts` type-checked that
+      # exact block green, because "has a value" and "the key is present" type
+      # identically. Both `skills/**` sites shipped to customers.
+      #
+      # Table-driven by the #13582 triage ruling, carrying the `$exists` family
+      # ONLY — each further word (the retired `$regex` spelling, #13532's
+      # `visibleWhen` claims) pays its own baseline on its own card.
+      #
+      # It lives in this job for the reason every other docs guard does
+      # (`check:doc-anchors`, `check:docs-audit-scope`, `check:role-word` above):
+      # this job carries the whole `check:*` gate family and has no paths filter,
+      # which matters here because one of the gate's two roots is `skills/**` and
+      # a `content/docs/**` filter would blind it to half its population.
+      - name: Teaching-corpus lexical anti-drift ratchet
+        run: pnpm check:corpus-claim-drift
+
       # #11671: `os i18n extract --fill=default` fills GAPS only, so revising a
       # source string rewrites `en` and strands the previous source text in every
       # other locale. The bundle stays in sync BY KEY, so `check:i18n` reports OK

package.json

@@ -54,6 +54,7 @@
     "check:page-declaration-shape": "node scripts/check-page-declaration-shape.mjs --self-test && node scripts/check-page-declaration-shape.mjs",
     "check:template-version-sync": "node scripts/sync-template-versions.mjs --self-test",
     "check:role-word": "node scripts/check-role-word.mjs --self-test && node scripts/check-role-word.mjs",
+    "check:corpus-claim-drift": "node scripts/check-corpus-claim-drift.mjs --self-test && node scripts/check-corpus-claim-drift.mjs",
     "check:quick-reference-counts": "node scripts/check-quick-reference-counts.mjs --self-test && node scripts/check-quick-reference-counts.mjs",
     "check:overlay-whitelist-table": "node scripts/check-overlay-whitelist-table.mjs --self-test && node scripts/check-overlay-whitelist-table.mjs",
     "check:runtime-services-index": "node scripts/check-runtime-services-index.mjs --self-test && node scripts/check-runtime-services-index.mjs",