test(group): fail loud on CI when tree-sitter-kotlin grammar is unavailable

[henry201605]

Summary

Follow-up to #1855, addressing the deferred Finding 2 from Claude's review (#1855 (comment)).

The Kotlin Provider tests (#1849) and Consumer tests (#1855) both gate their it() calls behind:

const kotlinAvailable = getPluginForFile('Probe.kt') !== undefined;
const itKotlin = kotlinAvailable ? it : it.skip;

Locally this is intentional — contributors on platforms where the optional tree-sitter-kotlin native binding can't build (or who haven't installed it) shouldn't be blocked by red Kotlin tests.

On CI it's a silent-skip hazard: if the optional dep ever fails to install (npm registry hiccup, build-toolchain drift on a runner image update, ABI bump in tree-sitter-kotlin) all 17+ Kotlin cases would silently skip and CI would still pass green.

Fix

A module-load tripwire that throws only when both conditions hold:

• process.env.CI is set
• getPluginForFile('Probe.kt') returns undefined

Mirrors the existing CI tripwire pattern at test/integration/object-literal-owner-resolution.test.ts:55-66, which guards against silent skip on missing dist/parse-worker.js.

The error message states what's missing, what would otherwise happen (silent skip of Provider + Consumer), where to look (optionalDependencies + runner toolchain), and explicitly reassures contributors that local runs are unaffected.

Coverage

This single tripwire protects all Kotlin tests in http-route-extractor.test.ts:

• 11 itKotlin cases (Provider — feat(group): add Kotlin Spring HTTP route extraction (named + positional) #1849)
• 6 itKotlinConsumer cases (Consumer — feat(group): add Kotlin Spring HTTP consumer extraction #1855)
• Any future Kotlin tests added under the same gating pattern

Reverse-validated four states

Scenario	Behavior
local + grammar present	60 / 60 pass (unchanged)
local + grammar absent	43 pass + 17 skip (unchanged)
CI=true + grammar present	60 / 60 pass (unchanged)
CI=true + grammar ABSENT	tripwire throws with clear error message (was silently green; now hard red)

The "grammar absent" cases were exercised locally by temporarily commenting out Kotlin = _require('tree-sitter-kotlin') in kotlin.ts and running the suite under both env settings.

Local validation

• http-route-extractor.test.ts — 60 / 60 ✅
• test/unit/group — 540 / 540 ✅
• npm run format:check — clean ✅

[vercel]

Someone is attempting to deploy a commit to the NexusCore Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

CI Report

✅ All checks passed

Pipeline Status

Stage	Status	Details
✅ Typecheck	success	tsc --noEmit
✅ Tests	success	unit tests, 3 platforms
✅ E2E	success	gitnexus-web changes only

Test Results

Tests	Passed	Failed	Skipped	Duration
10005	10001	0	4	606s

✅ All 10001 tests passed

4 test(s) skipped — expand for details

• PHP pipeline benchmark > scales with file count (workers enabled)
• Ruby pipeline benchmark > scales with file count (workers enabled)
• Rust pipeline benchmark > scales with file count (workers enabled)
• buildTypeEnv > known limitations (documented skip tests) > Ruby block parameter: users.each { |user| } — closure param inference, different feature

Code Coverage

Tests

Metric	Coverage	Covered	Base	Delta	Status
Statements	79.73%	34809/43654	79.48%	📈 +0.2	🟢 ███████████████░░░░░
Branches	68.25%	22183/32499	68%	📈 +0.2	🟢 █████████████░░░░░░░
Functions	84.67%	3602/4254	84.56%	📈 +0.1	🟢 ████████████████░░░░
Lines	83.23%	31354/37668	82.97%	📈 +0.3	🟢 ████████████████░░░░

---

_{📋 View full run · Generated by CI}