neurolink: Skill for Claude Code

Adding NeuroLink tests — modality, provider, or feature

Goal: extend test/continuous-test-suite-*.ts without re-inventing harness code, without breaking the canonical patterns the May 2026 consolidation locked in, and without creating SKIP/FAIL confusion in CI.

0. Mental model in one paragraph

Tests are plain tsx scripts — no Jest/Vitest. Every suite is a single test/continuous-test-suite-<domain>.ts file invoked via pnpm exec tsx <path> or pnpm run test:<domain>. All shared logic lives in test/helpers/*.ts. The harness defines a tri-state result:

• PASS — test fn returns/resolves normally
• FAIL — test fn throws an Error that doesn't look like a skip
• SKIP — test fn throws new Skip(reason), OR a known provider error (isExpectedProviderError), OR an env-missing string starting with "SKIP:"

You never write a new suite directory, never add a runner config, never introduce a new logger. You add code to an existing per-domain file OR write one new file with the same canonical shape.

1. Decision tree — where does my test go?

What are you adding?
│
├── New AI provider (e.g. "Together AI", "Cerebras")
│   → Edit test/helpers/providerMatrix.ts (add PROVIDERS entry)
│   → Edit test/continuous-test-suite-new-providers.ts (live smoke)
│   → pnpm run test:matrix picks it up automatically
│
├── New modality on an existing provider
│   ├── vision input          → test/continuous-test-suite-providers.ts
│   │                            (+ flip `vision: true` in providerMatrix)
│   ├── image generation      → test/continuous-test-suite-media-gen.ts
│   ├── video generation      → test/continuous-test-suite-media-gen.ts
│   ├── TTS                   → test/continuous-test-suite-tts.ts
│   ├── STT / realtime / voice→ test/continuous-test-suite-voice.ts
│   ├── embeddings            → test/continuous-test-suite-provider-matrix.ts
│   │                            (auto-discovered when `embeddings: true`)
│   └── thinking / reasoning  → test/continuous-test-suite-providers.ts
│
├── New file processor (e.g. .heic, .protobuf, .xlsx variant)
│   → test/continuous-test-suite-context.ts
│
├── New SDK feature
│   ├── tool / MCP            → test/continuous-test-suite-mcp-sdk.ts
│   ├── tool reliability      → test/continuous-test-suite-tool-reliability.ts
│   ├── memory / sessions     → test/continuous-test-suite-memory.ts
│   ├── RAG / chunking        → test/continuous-test-suite-rag.ts
│   ├── workflow              → test/continuous-test-suite-workflow.ts
│   ├── observability / OTEL  → test/continuous-test-suite-observability.ts
│   ├── HITL                  → test/continuous-test-suite-hitl.ts
│   ├── credentials surface   → test/continuous-test-suite-credentials.ts
│   ├── proxy / fallback      → test/continuous-test-suite-proxy.ts
│   ├── server (HTTP)         → test/continuous-test-suite-servers.ts
│   ├── evaluation / RAGAS    → test/continuous-test-suite-evaluation.ts
│   ├── autoresearch          → test/continuous-test-suite-autoresearch.ts
│   ├── middleware            → test/continuous-test-suite-middleware.ts
│   └── client SDK surface    → test/continuous-test-suite-client.ts
│
└── A whole new domain that doesn't fit above?
    → Create test/continuous-test-suite-<name>.ts (use § 2 template),
      add `test:<name>` script to package.json, add to test/README.md § 3.