feat(types): migrate test suite and config files to TypeScript (Phase 6)

.github/workflows/benchmark.yml

@@ -93,11 +93,11 @@ jobs:
           if [ "${{ steps.mode.outputs.source }}" = "npm" ]; then
             ARGS="$ARGS --npm"
           fi
-          node scripts/benchmark.js $ARGS 2>/dev/null > benchmark-result.json
+          node --experimental-strip-types scripts/benchmark.ts $ARGS 2>/dev/null > benchmark-result.json
 
       - name: Update build report
         if: steps.existing.outputs.skip != 'true'
-        run: node scripts/update-benchmark-report.js benchmark-result.json
+        run: node --experimental-strip-types scripts/update-benchmark-report.ts benchmark-result.json
 
       - name: Upload build result
         if: steps.existing.outputs.skip != 'true'
@@ -244,11 +244,11 @@ jobs:
           if [ "${{ steps.mode.outputs.source }}" = "npm" ]; then
             ARGS="$ARGS --npm"
           fi
-          node scripts/embedding-benchmark.js $ARGS 2>/dev/null > embedding-benchmark-result.json
+          node --experimental-strip-types scripts/embedding-benchmark.ts $ARGS 2>/dev/null > embedding-benchmark-result.json
 
       - name: Update embedding report
         if: steps.existing.outputs.skip != 'true'
-        run: node scripts/update-embedding-report.js embedding-benchmark-result.json
+        run: node --experimental-strip-types scripts/update-embedding-report.ts embedding-benchmark-result.json
 
       - name: Upload embedding result
         if: steps.existing.outputs.skip != 'true'
@@ -381,11 +381,11 @@ jobs:
           if [ "${{ steps.mode.outputs.source }}" = "npm" ]; then
             ARGS="$ARGS --npm"
           fi
-          node scripts/query-benchmark.js $ARGS 2>/dev/null > query-benchmark-result.json
+          node --experimental-strip-types scripts/query-benchmark.ts $ARGS 2>/dev/null > query-benchmark-result.json
 
       - name: Update query report
         if: steps.existing.outputs.skip != 'true'
-        run: node scripts/update-query-report.js query-benchmark-result.json
+        run: node --experimental-strip-types scripts/update-query-report.ts query-benchmark-result.json
 
       - name: Upload query result
         if: steps.existing.outputs.skip != 'true'
@@ -518,11 +518,11 @@ jobs:
           if [ "${{ steps.mode.outputs.source }}" = "npm" ]; then
             ARGS="$ARGS --npm"
           fi
-          node scripts/incremental-benchmark.js $ARGS 2>/dev/null > incremental-benchmark-result.json
+          node --experimental-strip-types scripts/incremental-benchmark.ts $ARGS 2>/dev/null > incremental-benchmark-result.json
 
       - name: Update incremental report
         if: steps.existing.outputs.skip != 'true'
-        run: node scripts/update-incremental-report.js incremental-benchmark-result.json
+        run: node --experimental-strip-types scripts/update-incremental-report.ts incremental-benchmark-result.json
 
       - name: Upload incremental result
         if: steps.existing.outputs.skip != 'true'

.github/workflows/build-native.yml

@@ -60,7 +60,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 22
 
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable

.github/workflows/ci.yml

@@ -43,7 +43,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        node-version: [20, 22]
+        node-version: [22]
 
     runs-on: ${{ matrix.os }}
     name: Test Node ${{ matrix.node-version }} (${{ matrix.os }})
@@ -113,7 +113,7 @@ jobs:
           node-version: 22
 
       - name: Verify all dynamic imports resolve
-        run: node scripts/verify-imports.js
+        run: node --experimental-strip-types scripts/verify-imports.ts
 
   rust-check:
     runs-on: ubuntu-latest

.github/workflows/embedding-regression.yml

@@ -38,4 +38,4 @@ jobs:
           key: hf-models-minilm-v1
 
       - name: Run embedding regression tests
-        run: npx vitest run tests/search/embedding-regression.test.js
+        run: npx vitest run tests/search/embedding-regression.test.ts

.github/workflows/publish.yml

@@ -142,7 +142,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 22
 
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
@@ -224,7 +224,7 @@ jobs:
           VERSION: ${{ needs.compute-version.outputs.version }}
         run: |
           npm version "$VERSION" --no-git-tag-version --allow-same-version
-          node scripts/sync-native-versions.js --strip
+          node --experimental-strip-types scripts/sync-native-versions.ts --strip
           echo "Packaging version $VERSION"
 
       - name: Build TypeScript
@@ -405,7 +405,7 @@ jobs:
         run: |
           git checkout -- package-lock.json
           npm version "$VERSION" --no-git-tag-version --allow-same-version
-          node scripts/sync-native-versions.js
+          node --experimental-strip-types scripts/sync-native-versions.ts
           echo "Publishing version $VERSION"
 
       - name: Build TypeScript

.npmignore

@@ -7,5 +7,5 @@ docs/
 *.db
 .codegraphrc.json
 .versionrc.json
-commitlint.config.js
+commitlint.config.ts
 codegraph-improvements.md

docs/examples/claude-code-hooks/pre-commit.sh

@@ -48,7 +48,7 @@ fi
 
 # Run all checks in a single Node.js process
 HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-RESULT=$(node "$HOOK_DIR/pre-commit-checks.js" "$WORK_ROOT" "$EDITED_FILES" "$STAGED" 2>/dev/null) || true
+RESULT=$(node --experimental-strip-types "$HOOK_DIR/pre-commit-checks.ts" "$WORK_ROOT" "$EDITED_FILES" "$STAGED" 2>/dev/null) || true
 
 if [ -z "$RESULT" ]; then
   exit 0

package.json

@@ -26,26 +26,26 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.6"
   },
   "scripts": {
-    "build": "tsc",
-    "build:wasm": "node scripts/build-wasm.js",
+    "build": "tsc && node -e \"require('fs').writeFileSync('dist/index.cjs',require('fs').readFileSync('src/index.cjs','utf8').replaceAll('./index.ts','./index.js'))\"",
+    "build:wasm": "node --experimental-strip-types scripts/build-wasm.ts",
     "typecheck": "tsc --noEmit",
-    "verify-imports": "node scripts/verify-imports.js",
-    "test": "node scripts/test.js run",
-    "test:watch": "node scripts/test.js",
-    "test:coverage": "node scripts/test.js run --coverage",
+    "verify-imports": "node --experimental-strip-types scripts/verify-imports.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "lint": "biome check src/ tests/",
     "lint:fix": "biome check --write src/ tests/",
     "format": "biome format --write src/ tests/",
     "prepack": "npm run build",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true});require('fs').rmSync('.tsbuildinfo',{force:true})\"",
     "prepare": "npm run build:wasm && npm run build && husky && npm run deps:tree",
-    "deps:tree": "node scripts/gen-deps.cjs",
+    "deps:tree": "node --experimental-strip-types scripts/gen-deps.ts",
     "release": "commit-and-tag-version",
     "release:dry-run": "commit-and-tag-version --dry-run",
-    "version": "node scripts/sync-native-versions.js && git add package.json crates/codegraph-core/Cargo.toml"
+    "version": "node --experimental-strip-types scripts/sync-native-versions.ts && git add package.json crates/codegraph-core/Cargo.toml"
   },
   "keywords": [
     "codegraph",

scripts/gen-deps.cjs → scripts/gen-deps.ts

@@ -1,18 +1,19 @@
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 
-const outFile = path.join('generated', 'DEPENDENCIES.md');
-fs.mkdirSync(path.dirname(outFile), { recursive: true });
+const outFile = join('generated', 'DEPENDENCIES.md');
+mkdirSync(dirname(outFile), { recursive: true });
 
 try {
   const tree = execSync('npm ls --all --omit=dev', { encoding: 'utf8' });
-  fs.writeFileSync(outFile, '# Dependencies\n\n```\n' + tree + '```\n');
-} catch (err) {
+  writeFileSync(outFile, '# Dependencies\n\n```\n' + tree + '```\n');
+} catch (err: any) {
   // npm ls exits non-zero on ELSPROBLEMS (version mismatches in optional deps).
   // If stdout still has content, write it; otherwise skip silently.
   if (err.stdout) {
-    fs.writeFileSync(
+    writeFileSync(
       outFile,
       '# Dependencies\n\n```\n' + err.stdout + '```\n',
     );

scripts/ts-resolve-hooks.ts

@@ -0,0 +1,28 @@
+/**
+ * ESM resolve hook — rewrites .js specifiers to .ts when the .js file
+ * does not exist on disk. Needed because TypeScript's moduleResolution
+ * "nodenext" convention uses .js extensions in imports, but at runtime
+ * the source files are .ts.
+ *
+ * Loaded via module.register() from ts-resolve-loader.ts.
+ */
+
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+export async function resolve(
+  specifier: string,
+  context: { parentURL?: string; conditions: string[] },
+  nextResolve: (specifier: string, context?: { parentURL?: string; conditions: string[] }) => Promise<{ url: string; shortCircuit?: boolean }>,
+): Promise<{ url: string; shortCircuit?: boolean }> {
+  try {
+    return await nextResolve(specifier, context);
+  } catch (err: any) {
+    // Only attempt .js → .ts fallback for file-relative specifiers
+    if (err?.code === 'ERR_MODULE_NOT_FOUND' && specifier.endsWith('.js')) {
+      const tsSpecifier = specifier.slice(0, -3) + '.ts';
+      return nextResolve(tsSpecifier, context);
+    }
+    throw err;
+  }
+}

scripts/ts-resolve-loader.ts

@@ -0,0 +1,9 @@
+/**
+ * Registers the .js → .ts ESM resolve hook.
+ *
+ * Usage: node --experimental-strip-types --import ./scripts/ts-resolve-loader.ts src/cli.ts
+ */
+
+import { register } from 'node:module';
+
+register(new URL('./ts-resolve-hooks.ts', import.meta.url));

src/index.cjs

@@ -13,4 +13,4 @@
 // Note: if import() rejects (e.g. missing dependency), the rejected Promise is cached
 // by the CJS module system and every subsequent require() call will re-surface the same
 // rejection without re-attempting the load.
-module.exports = import('./index.js');
+module.exports = import('./index.ts');

tests/benchmarks/resolution/resolution-benchmark.test.js → tests/benchmarks/resolution/resolution-benchmark.test.ts

@@ -242,10 +242,10 @@ describe('Call Resolution Precision/Recall', () => {
 
   for (const lang of languages) {
     describe(lang, () => {
-      let fixtureDir;
-      let resolvedEdges;
-      let expectedEdges;
-      let metrics;
+      let fixtureDir: string;
+      let resolvedEdges: any[];
+      let expectedEdges: any[];
+      let metrics: any;
 
       beforeAll(async () => {
         fixtureDir = copyFixture(lang);

tests/builder/collect-files.test.js → tests/builder/collect-files.test.ts

@@ -8,7 +8,7 @@ import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 import { PipelineContext } from '../../src/domain/graph/builder/context.js';
 import { collectFiles } from '../../src/domain/graph/builder/stages/collect-files.js';
 
-let tmpDir;
+let tmpDir: string;
 
 beforeAll(() => {
   tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codegraph-stage-collect-'));

tests/builder/detect-changes.test.js → tests/builder/detect-changes.test.ts

@@ -10,7 +10,7 @@ import { PipelineContext } from '../../src/domain/graph/builder/context.js';
 import { detectChanges } from '../../src/domain/graph/builder/stages/detect-changes.js';
 import { writeJournalHeader } from '../../src/domain/graph/journal.js';
 
-let tmpDir;
+let tmpDir: string;
 
 beforeAll(() => {
   tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codegraph-stage-detect-'));

tests/builder/pipeline.test.js → tests/builder/pipeline.test.ts

@@ -11,7 +11,7 @@ import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 import { buildGraph } from '../../src/domain/graph/builder/pipeline.js';
 
 const FIXTURE_DIR = path.join(import.meta.dirname, '..', 'fixtures', 'sample-project');
-let tmpDir;
+let tmpDir: string;
 
 beforeAll(() => {
   tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codegraph-pipeline-'));

tests/engines/dataflow-parity.test.js → tests/engines/dataflow-parity.test.ts

@@ -16,8 +16,8 @@ import { createParsers, getParser } from '../../src/domain/parser.js';
 import { extractDataflow } from '../../src/features/dataflow.js';
 import { isNativeAvailable } from '../../src/infrastructure/native.js';
 
-let native;
-let parsers;
+let native: any;
+let parsers: any;
 let nativeHasDataflow = false;
 
 /**

tests/engines/parity.test.js → tests/engines/parity.test.ts

@@ -23,8 +23,8 @@ import {
 } from '../../src/domain/parser.js';
 import { isNativeAvailable } from '../../src/infrastructure/native.js';
 
-let native;
-let parsers;
+let native: any;
+let parsers: any;
 
 function wasmExtract(code, filePath) {
   const parser = getParser(parsers, filePath);

tests/engines/query-walk-parity.test.js → tests/engines/query-walk-parity.test.ts

@@ -12,7 +12,7 @@ import { beforeAll, describe, expect, it } from 'vitest';
 import { createParsers, getParser, parseFileAuto } from '../../src/domain/parser.js';
 import { extractSymbols } from '../../src/extractors/javascript.js';
 
-let parsers;
+let parsers: any;
 
 beforeAll(async () => {
   parsers = await createParsers();

tests/incremental/cache.test.js → tests/incremental/cache.test.ts

@@ -10,7 +10,7 @@ import { isNativeAvailable, loadNative } from '../../src/infrastructure/native.j
 const hasNative = isNativeAvailable();
 
 describe.skipIf(!hasNative)('ParseTreeCache', () => {
-  let cache;
+  let cache: any;
 
   beforeEach(() => {
     const native = loadNative();

tests/incremental/watcher-incremental.test.js → tests/incremental/watcher-incremental.test.ts

@@ -17,8 +17,8 @@ import { isNativeAvailable } from '../../src/infrastructure/native.js';
 const hasNative = isNativeAvailable();
 
 describe.skipIf(!hasNative)('Watcher incremental flow', () => {
-  let tmpDir;
-  let cache;
+  let tmpDir: string;
+  let cache: any;
 
   beforeEach(() => {
     tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codegraph-inc-'));

tests/integration/ast.test.js → tests/integration/ast.test.ts

@@ -30,7 +30,7 @@ function insertAstNode(db, file, line, kind, name, text, receiver, parentNodeId)
 
 // ─── Fixture DB ────────────────────────────────────────────────────────
 
-let tmpDir, dbPath;
+let tmpDir: string, dbPath: string;
 
 beforeAll(() => {
   tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codegraph-ast-'));

tests/integration/audit.test.js → tests/integration/audit.test.ts

@@ -46,7 +46,7 @@ function insertComplexity(db, nodeId, opts = {}) {
 
 // ─── Fixture DB ────────────────────────────────────────────────────────
 
-let tmpDir, dbPath;
+let tmpDir: string, dbPath: string;
 
 beforeAll(() => {
   tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codegraph-audit-'));