ci(schema): enforce locale-tag refs

.github/workflows/build-check.yml

@@ -72,6 +72,9 @@ jobs:
       - name: Schema link plugin tests
         run: npm run test:schema-links
 
+      - name: Language-tag schema reference guard
+        run: npm run test:language-tag-refs
+
       - name: Fetch 3.0.x for error-code drift comparison
         if: github.ref != 'refs/heads/3.0.x' && github.base_ref != '3.0.x'
         run: git fetch --depth=1 origin +3.0.x:refs/remotes/origin/3.0.x

package.json

@@ -103,6 +103,7 @@
     "test:patch-3-0-compat-bundle": "node --test --test-force-exit --test-timeout=30000 tests/patch-3-0-compat-bundle.test.cjs",
     "test:error-codes": "node scripts/lint-error-codes.cjs",
     "test:error-code-drift": "node scripts/lint-error-code-drift.cjs",
+    "test:language-tag-refs": "node --test --test-force-exit --test-timeout=30000 tests/lint-language-tag-refs.test.cjs && node scripts/lint-language-tag-refs.cjs",
     "test:compliance-snippets": "node --test --test-force-exit --test-timeout=30000 tests/generate-compliance-snippets.node.mjs tests/link-compliance-symbols.node.mjs && npm run build:compliance -- --check",
     "test:doc-compliance-drift": "node --test --test-force-exit --test-timeout=30000 tests/lint-doc-compliance-drift.test.cjs",
     "test:substitution-vector-names": "node scripts/lint-substitution-vector-names.cjs",

scripts/lint-language-tag-refs-dispositions.json

@@ -0,0 +1,185 @@
+{
+  "$comment": "Reviewed exceptions for scripts/lint-language-tag-refs.cjs. Legacy language boundaries are migration debt; name collisions are structural fields selected by the deliberately broad matcher.",
+  "entries": [
+    {
+      "path": "brand.json#/definitions/data_subject_contestation/properties/languages",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing contestation channel language list predates the canonical locale-tag primitive."
+    },
+    {
+      "path": "brand.json#/definitions/localized_name",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Legacy localized maps use underscore-separated keys and an explicit underscore-to-hyphen bridge."
+    },
+    {
+      "path": "brand.json#/definitions/localized_string_list_entry",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Legacy localized list maps use underscore-separated keys and the brand.json bridge contract."
+    },
+    {
+      "path": "content-standards/artifact.json#/properties/assets/items/oneOf/0/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing content-standards artifact language values predate the canonical primitive."
+    },
+    {
+      "path": "content-standards/content-standards.json#/properties/languages_any",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing content-standards scope language values are retained for wire compatibility."
+    },
+    {
+      "path": "content-standards/create-content-standards-request.json#/properties/calibration_exemplars/properties/fail/items/oneOf/0/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing calibration exemplar language values predate the canonical primitive."
+    },
+    {
+      "path": "content-standards/create-content-standards-request.json#/properties/calibration_exemplars/properties/pass/items/oneOf/0/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing calibration exemplar language values predate the canonical primitive."
+    },
+    {
+      "path": "content-standards/create-content-standards-request.json#/properties/scope/properties/languages_any",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing create-request scope language values are retained for wire compatibility."
+    },
+    {
+      "path": "content-standards/list-content-standards-request.json#/properties/languages",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing list filter language values predate the canonical primitive."
+    },
+    {
+      "path": "content-standards/update-content-standards-request.json#/properties/calibration_exemplars/properties/fail/items/oneOf/0/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing calibration exemplar language values predate the canonical primitive."
+    },
+    {
+      "path": "content-standards/update-content-standards-request.json#/properties/calibration_exemplars/properties/pass/items/oneOf/0/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing calibration exemplar language values predate the canonical primitive."
+    },
+    {
+      "path": "content-standards/update-content-standards-request.json#/properties/scope/properties/languages_any",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing update-request scope language values are retained for wire compatibility."
+    },
+    {
+      "path": "core/assets/markdown-asset.json#/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Published markdown asset language values predate the canonical primitive."
+    },
+    {
+      "path": "core/assets/text-asset.json#/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Published text asset language values predate the canonical primitive."
+    },
+    {
+      "path": "core/brand-ref.json#/properties/data_subject_contestation/properties/languages",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing contestation channel language list predates the canonical locale-tag primitive."
+    },
+    {
+      "path": "core/collection.json#/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Published collection language values predate the canonical primitive."
+    },
+    {
+      "path": "core/creative-brief.json#/properties/compliance/properties/required_disclosures/items/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Published disclosure language values predate the canonical primitive."
+    },
+    {
+      "path": "core/creative-localization-readback.json#/properties/default_locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization-readback.json#/properties/locale_fallbacks/items/properties/locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization-readback.json#/properties/locale_matching",
+      "disposition": "not-a-language-tag",
+      "rationale": "Matching algorithm enum, not a concrete language identity or range."
+    },
+    {
+      "path": "core/creative-localization-readback.json#/properties/unmatched_locale_action",
+      "disposition": "not-a-language-tag",
+      "rationale": "Fallback behavior enum, not a concrete language identity or range."
+    },
+    {
+      "path": "core/creative-localization-readback.json#/properties/variants/items/oneOf/0/properties/locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization-readback.json#/properties/variants/items/oneOf/1/properties/locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization.json#/properties/default_locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization.json#/properties/locale_fallbacks/items/properties/locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization.json#/properties/source/properties/locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization.json#/properties/target_variants/items/properties/locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/creative-localization.json#/properties/unmatched_locale_action",
+      "disposition": "not-a-language-tag",
+      "rationale": "Fallback behavior enum, not a concrete language identity or range."
+    },
+    {
+      "path": "core/creative-variant.json#/allOf/1/properties/locale_variant_id",
+      "disposition": "not-a-language-tag",
+      "rationale": "Stable identifier for a locale variant, not a BCP 47 value."
+    },
+    {
+      "path": "core/education-item.json#/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Published education item language values predate the canonical primitive."
+    },
+    {
+      "path": "core/signal-definition-enrichment.json#/properties/data_subject_rights/properties/channels/items/properties/languages",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing rights-channel language values predate the canonical primitive."
+    },
+    {
+      "path": "core/signal-definition.json#/properties/data_subject_rights/properties/channels/items/properties/languages",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Existing rights-channel language values predate the canonical primitive."
+    },
+    {
+      "path": "core/targeting.json#/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Legacy targeting uses ISO 639-1 values and intentionally retains its published wire shape."
+    },
+    {
+      "path": "protocol/get-adcp-capabilities-response.json#/properties/creative/properties/localization/properties/locale_matching",
+      "disposition": "not-a-language-tag",
+      "rationale": "Capability enum naming a supported matching algorithm, not a language tag."
+    },
+    {
+      "path": "sponsored-intelligence/si-identity.json#/properties/user/properties/locale",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Published sponsored-intelligence identity locale predates the canonical primitive."
+    },
+    {
+      "path": "trusted-match/context-match-request.json#/properties/context_signals/properties/language",
+      "disposition": "legacy-language-boundary",
+      "rationale": "Published trusted-match context language predates the canonical primitive."
+    }
+  ]
+}