typegraph-mcp 0.9.46 → 0.9.48

package/engine-sync-test.ts

@@ -1,262 +0,0 @@
-#!/usr/bin/env npx tsx
-
-import * as assert from "node:assert/strict";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
-
-type DependencyTreeResult = {
-  root: string;
-  nodes: number;
-  files: string[];
-};
-
-type TypeInfoResult = {
-  type: string | null;
-  documentation: string | null;
-  kind?: string;
-  source?: string;
-};
-
-type ModuleExportsResult = {
-  file: string;
-  exports: Array<{
-    symbol: string;
-    type: string | null;
-  }>;
-  count: number;
-};
-
-function normalize(file: string): string {
-  return file.replaceAll("\\", "/");
-}
-
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-async function waitFor(
-  description: string,
-  fn: () => Promise<void>,
-  timeoutMs = 5_000,
-  intervalMs = 50
-): Promise<void> {
-  const start = Date.now();
-  let lastError: unknown;
-
-  while (Date.now() - start < timeoutMs) {
-    try {
-      await fn();
-      return;
-    } catch (err) {
-      lastError = err;
-      await sleep(intervalMs);
-    }
-  }
-
-  throw new Error(
-    `${description} did not stabilize within ${timeoutMs}ms: ${String(lastError)}`
-  );
-}
-
-function writeFile(root: string, relativePath: string, content: string): void {
-  const absPath = path.join(root, relativePath);
-  fs.mkdirSync(path.dirname(absPath), { recursive: true });
-  fs.writeFileSync(absPath, content);
-}
-
-async function main(): Promise<void> {
-  const repoRoot = import.meta.dirname;
-  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "typegraph-engine-sync-"));
-  const projectRoot = path.join(tempRoot, "project");
-
-  fs.mkdirSync(projectRoot, { recursive: true });
-  writeFile(
-    projectRoot,
-    "package.json",
-    JSON.stringify(
-      {
-        name: "typegraph-engine-sync-fixture",
-        private: true,
-        type: "module",
-      },
-      null,
-      2
-    ) + "\n"
-  );
-  writeFile(
-    projectRoot,
-    "tsconfig.json",
-    JSON.stringify(
-      {
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "Bundler",
-          strict: true,
-        },
-        include: ["src/**/*.ts"],
-      },
-      null,
-      2
-    ) + "\n"
-  );
-
-  writeFile(projectRoot, "src/a.ts", 'export const current = "a" as const;\n');
-  writeFile(projectRoot, "src/b.ts", 'export const current = "b" as const;\n');
-  writeFile(
-    projectRoot,
-    "src/main.ts",
-    'import { current } from "./a";\nexport const value = current;\n'
-  );
-  writeFile(projectRoot, "src/test.ts", "export const oldName = 1 as const;\n");
-  writeFile(projectRoot, "src/util.ts", "export const helper = 1 as const;\n");
-  writeFile(projectRoot, "src/closed.ts", "export const closedValue = 1 as const;\n");
-  writeFile(
-    projectRoot,
-    "src/closed-consumer.ts",
-    'import { closedValue } from "./closed";\nexport const observed = closedValue;\n'
-  );
-
-  fs.mkdirSync(path.join(projectRoot, "node_modules"), { recursive: true });
-  fs.symlinkSync(
-    path.join(repoRoot, "node_modules/typescript"),
-    path.join(projectRoot, "node_modules/typescript"),
-    "dir"
-  );
-
-  const client = new Client({ name: "engine-sync-test", version: "1.0.0" });
-  const transport = new StdioClientTransport({
-    command: path.join(repoRoot, "node_modules/.bin/tsx"),
-    args: [path.join(repoRoot, "server.ts")],
-    cwd: projectRoot,
-    env: {
-      TYPEGRAPH_PROJECT_ROOT: projectRoot,
-      TYPEGRAPH_TSCONFIG: path.join(projectRoot, "tsconfig.json"),
-    },
-  });
-
-  async function callTool<T>(name: string, args: Record<string, unknown>): Promise<T> {
-    const result = await client.request(
-      {
-        method: "tools/call",
-        params: {
-          name,
-          arguments: args,
-        },
-      },
-      CallToolResultSchema
-    );
-
-    const content = result.content[0];
-    assert.ok(content?.type === "text", `Expected text response from ${name}`);
-    return JSON.parse(content.text) as T;
-  }
-
-  try {
-    await client.connect(transport);
-
-    const initialType = await callTool<TypeInfoResult>("ts_type_info", {
-      file: "src/main.ts",
-      line: 2,
-      column: 14,
-    });
-    assert.match(initialType.type ?? "", /"a"/);
-
-    writeFile(projectRoot, "src/main.ts", 'import { current } from "./b";\nexport const value = current;\n');
-
-    await waitFor("import swap to synchronize graph and tsserver", async () => {
-      const deps = await callTool<DependencyTreeResult>("ts_dependency_tree", {
-        file: "src/main.ts",
-      });
-      const normalizedDeps = deps.files.map(normalize);
-      assert.ok(normalizedDeps.includes("src/b.ts"), `Expected src/b.ts in ${normalizedDeps}`);
-      assert.ok(!normalizedDeps.includes("src/a.ts"), `Expected src/a.ts to be removed from ${normalizedDeps}`);
-
-      const typeInfo = await callTool<TypeInfoResult>("ts_type_info", {
-        file: "src/main.ts",
-        line: 2,
-        column: 14,
-      });
-      assert.match(typeInfo.type ?? "", /"b"/);
-    });
-
-    // Open test.ts through ts_module_exports, then rename the export on disk.
-    const initialExports = await callTool<ModuleExportsResult>("ts_module_exports", {
-      file: "src/test.ts",
-    });
-    assert.ok(initialExports.exports.some((item) => item.symbol === "oldName"));
-
-    writeFile(projectRoot, "src/test.ts", "export const newName = 1 as const;\n");
-
-    await waitFor("symbol rename to refresh mixed export metadata", async () => {
-      const exportsResult = await callTool<ModuleExportsResult>("ts_module_exports", {
-        file: "src/test.ts",
-      });
-      const next = exportsResult.exports.find((item) => item.symbol === "newName");
-      assert.ok(next, `Expected newName in ${JSON.stringify(exportsResult.exports)}`);
-      assert.match(next.type ?? "", /\bnewName\b/);
-      assert.ok(!exportsResult.exports.some((item) => item.symbol === "oldName"));
-    });
-
-    // Change a file that tsserver has not opened. The watcher should mark
-    // projects dirty so the next semantic query reloads closed-file contents.
-    writeFile(projectRoot, "src/closed.ts", "export const closedValue = 2 as const;\n");
-
-    await waitFor("closed file update to refresh semantic project state", async () => {
-      const deps = await callTool<DependencyTreeResult>("ts_dependency_tree", {
-        file: "src/closed-consumer.ts",
-      });
-      const normalizedDeps = deps.files.map(normalize);
-      assert.ok(normalizedDeps.includes("src/closed.ts"), `Expected src/closed.ts in ${normalizedDeps}`);
-
-      const typeInfo = await callTool<TypeInfoResult>("ts_type_info", {
-        file: "src/closed-consumer.ts",
-        line: 2,
-        column: 14,
-      });
-      assert.match(typeInfo.type ?? "", /\b2\b/);
-    });
-
-    // Open util.ts directly so tsserver tracks it, then delete it from disk.
-    const utilInfo = await callTool<TypeInfoResult>("ts_type_info", {
-      file: "src/util.ts",
-      line: 1,
-      column: 14,
-    });
-    assert.match(utilInfo.type ?? "", /\bhelper: 1\b/);
-    fs.rmSync(path.join(projectRoot, "src/util.ts"));
-
-    await waitFor("deleted file to disappear from semantic answers", async () => {
-      const deletedInfo = await callTool<TypeInfoResult>("ts_type_info", {
-        file: "src/util.ts",
-        line: 1,
-        column: 14,
-      });
-      assert.equal(
-        deletedInfo.type,
-        null,
-        `Expected deleted file to have no type info, got ${JSON.stringify(deletedInfo)}`
-      );
-    });
-
-    console.log("");
-    console.log("typegraph-mcp Engine Sync Test");
-    console.log("==============================");
-    console.log("  ✓ import swaps keep dependency_tree and type_info aligned");
-    console.log("  ✓ export renames refresh ts_module_exports semantic metadata");
-    console.log("  ✓ closed-file edits refresh tsserver project state");
-    console.log("  ✓ deleted open files do not survive as tsserver ghost snapshots");
-  } finally {
-    await transport.close().catch(() => {});
-    fs.rmSync(tempRoot, { recursive: true, force: true });
-  }
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/export-surface-test.ts

@@ -1,202 +0,0 @@
-#!/usr/bin/env npx tsx
-
-import * as assert from "node:assert/strict";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
-
-type ModuleExportRecord = {
-  symbol: string;
-  kind: string;
-  line: number;
-  type: string | null;
-  exportKind: "value" | "type";
-  isTypeOnly: boolean;
-  isNamespace: boolean;
-  source: "local" | "re-export" | "star-re-export";
-  from: string | null;
-  definedIn: string;
-  definedLine: number | null;
-};
-
-type ModuleExportsResult = {
-  file: string;
-  exports: ModuleExportRecord[];
-  count: number;
-  localCount: number;
-  reExportCount: number;
-  typeOnlyCount: number;
-  valueCount: number;
-  namespaceExportCount: number;
-  hasLocalRuntimeExports: boolean;
-  isPrimarilyBarrel: boolean;
-};
-
-function copyDir(src: string, dest: string): void {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function findExport(
-  result: ModuleExportsResult,
-  symbol: string,
-  exportKind: "value" | "type"
-): ModuleExportRecord {
-  const found = result.exports.find(
-    (item) => item.symbol === symbol && item.exportKind === exportKind
-  );
-  assert.ok(found, `Expected ${symbol}:${exportKind} in ${result.file}`);
-  return found;
-}
-
-function assertProjectPath(actual: string | null, expected: string): void {
-  assert.ok(actual, `Expected path ${expected}`);
-  const normalized = actual.replaceAll("\\", "/");
-  assert.equal(normalized, expected, `Expected ${normalized} to equal ${expected}`);
-}
-
-async function main(): Promise<void> {
-  const repoRoot = import.meta.dirname;
-  const fixtureRoot = path.join(repoRoot, ".fixtures/export-surface");
-  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "typegraph-export-surface-"));
-  const projectRoot = path.join(tempRoot, "project");
-
-  copyDir(fixtureRoot, projectRoot);
-  fs.mkdirSync(path.join(projectRoot, "node_modules"), { recursive: true });
-  fs.symlinkSync(
-    path.join(repoRoot, "node_modules/typescript"),
-    path.join(projectRoot, "node_modules/typescript"),
-    "dir"
-  );
-
-  const client = new Client({ name: "export-surface-test", version: "1.0.0" });
-  const transport = new StdioClientTransport({
-    command: path.join(repoRoot, "node_modules/.bin/tsx"),
-    args: [path.join(repoRoot, "server.ts")],
-    cwd: projectRoot,
-    env: {
-      TYPEGRAPH_PROJECT_ROOT: projectRoot,
-      TYPEGRAPH_TSCONFIG: path.join(projectRoot, "tsconfig.json"),
-    },
-  });
-
-  try {
-    await client.connect(transport);
-
-    async function moduleExports(file: string): Promise<ModuleExportsResult> {
-      const result = await client.request(
-        {
-          method: "tools/call",
-          params: {
-            name: "ts_module_exports",
-            arguments: { file },
-          },
-        },
-        CallToolResultSchema
-      );
-
-      const content = result.content[0];
-      assert.ok(content?.type === "text", `Expected text response for ${file}`);
-      return JSON.parse(content.text) as ModuleExportsResult;
-    }
-
-    const source = await moduleExports("src/source.ts");
-    const defaultExport = findExport(source, "default", "value");
-    assert.equal(defaultExport.source, "local");
-    assert.equal(defaultExport.kind, "function");
-    assert.equal(defaultExport.definedIn, "src/source.ts");
-    assert.equal(defaultExport.definedLine, 1);
-
-    const defaultExpression = await moduleExports("src/default-expression.ts");
-    const expressionDefault = findExport(defaultExpression, "default", "value");
-    assert.equal(expressionDefault.source, "local");
-    assert.equal(expressionDefault.definedIn, "src/default-expression.ts");
-
-    const barrel = await moduleExports("src/barrel.ts");
-    const barrelValue = findExport(barrel, "value", "value");
-    const barrelUserShape = findExport(barrel, "UserShape", "type");
-    assert.equal(barrelValue.source, "star-re-export");
-    assert.equal(barrelUserShape.source, "star-re-export");
-    assert.equal(barrel.exports.some((item) => item.symbol === "default"), false);
-    assert.equal(barrel.exports.some((item) => item.symbol === "buildUser"), false);
-    assert.equal(barrelUserShape.isTypeOnly, true);
-    assert.equal(barrel.typeOnlyCount, 2);
-    assert.equal(barrel.isPrimarilyBarrel, true);
-    assert.equal(barrel.hasLocalRuntimeExports, false);
-
-    const typeReExport = await moduleExports("src/reexport-type.ts");
-    const userShape = findExport(typeReExport, "UserShape", "type");
-    assert.equal(userShape.source, "re-export");
-    assert.equal(userShape.isTypeOnly, true);
-    assert.equal(userShape.exportKind, "type");
-    assert.equal(typeReExport.typeOnlyCount, 1);
-    assert.equal(typeReExport.valueCount, 0);
-
-    const namedReExport = await moduleExports("src/named-reexport.ts");
-    const aliasedValue = findExport(namedReExport, "aliasedValue", "value");
-    assert.equal(aliasedValue.source, "re-export");
-    assertProjectPath(aliasedValue.from, "src/source.ts");
-    assert.equal(aliasedValue.definedIn, "src/source.ts");
-    assert.equal(namedReExport.namespaceExportCount, 0);
-
-    const namespaceReExport = await moduleExports("src/namespace-reexport.ts");
-    const models = findExport(namespaceReExport, "Models", "value");
-    assert.equal(models.source, "re-export");
-    assert.equal(models.isNamespace, true);
-    assert.equal(namespaceReExport.namespaceExportCount, 1);
-
-    const mixed = await moduleExports("src/mixed.ts");
-    const localValue = findExport(mixed, "SessionId", "value");
-    const localType = findExport(mixed, "SessionId", "type");
-    const externalValue = findExport(mixed, "externalValue", "value");
-    const externalUserShape = findExport(mixed, "ExternalUserShape", "type");
-    assert.equal(localValue.source, "local");
-    assert.equal(localType.source, "local");
-    assert.equal(localType.kind, "type");
-    assert.equal(localType.definedLine, 2);
-    assert.equal(externalValue.source, "re-export");
-    assert.equal(externalUserShape.source, "re-export");
-    assert.equal(externalUserShape.isTypeOnly, true);
-    assert.equal(mixed.localCount, 2);
-    assert.equal(mixed.reExportCount, 2);
-    assert.equal(mixed.typeOnlyCount, 2);
-    assert.equal(mixed.hasLocalRuntimeExports, true);
-    assert.equal(mixed.isPrimarilyBarrel, false);
-
-    const collision = await moduleExports("src/collision-barrel.ts");
-    assert.equal(collision.exports.some((item) => item.symbol === "dup"), false);
-    assert.equal(collision.count, 0);
-
-    console.log("");
-    console.log("typegraph-mcp Export Surface Test");
-    console.log("=================================");
-    console.log("  ✓ local default exports are reported as default");
-    console.log("  ✓ anonymous default exports stay visible");
-    console.log("  ✓ barrel star re-exports");
-    console.log("  ✓ barrel star re-exports exclude default exports");
-    console.log("  ✓ type-only named re-exports");
-    console.log("  ✓ named alias re-exports");
-    console.log("  ✓ namespace re-exports");
-    console.log("  ✓ mixed local + re-export modules");
-    console.log("  ✓ conflicting star re-exports stay hidden");
-  } finally {
-    await transport.close().catch(() => {});
-    fs.rmSync(tempRoot, { recursive: true, force: true });
-  }
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/install-oxlint-test.ts

@@ -1,116 +0,0 @@
-#!/usr/bin/env npx tsx
-
-import * as assert from "node:assert/strict";
-import { execFileSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-
-function copyDir(src: string, dest: string): void {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function runTsx(
-  toolRoot: string,
-  args: string[],
-  cwd: string,
-  env: NodeJS.ProcessEnv = process.env
-): string {
-  return execFileSync(path.join(toolRoot, "node_modules/.bin/tsx"), args, {
-    cwd,
-    encoding: "utf-8",
-    maxBuffer: 10 * 1024 * 1024,
-    env,
-  });
-}
-
-function assertIncludes(text: string, expected: string): void {
-  assert.ok(
-    text.includes(expected),
-    `Expected output to include:\n${expected}\n\nActual output:\n${text}`
-  );
-}
-
-async function main(): Promise<void> {
-  const repoRoot = import.meta.dirname;
-  const fixtureRoot = path.join(repoRoot, ".fixtures/install-oxlint");
-  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "typegraph-install-oxlint-"));
-  const projectRoot = path.join(tempRoot, "project");
-  const homeRoot = path.join(tempRoot, "home");
-
-  copyDir(fixtureRoot, projectRoot);
-  fs.mkdirSync(path.join(projectRoot, "node_modules"), { recursive: true });
-  fs.symlinkSync(
-    path.join(repoRoot, "node_modules/typescript"),
-    path.join(projectRoot, "node_modules/typescript"),
-    "dir"
-  );
-
-  try {
-    fs.mkdirSync(homeRoot, { recursive: true });
-    const testEnv = { ...process.env, HOME: homeRoot };
-    const setupOutput = runTsx(
-      repoRoot,
-      [path.join(repoRoot, "cli.ts"), "setup", "--yes"],
-      projectRoot,
-      testEnv
-    );
-    const pluginRoot = path.join(projectRoot, "plugins/typegraph-mcp");
-
-    const tsconfig = fs.readFileSync(path.join(projectRoot, "tsconfig.json"), "utf-8");
-    const oxlint = fs.readFileSync(path.join(projectRoot, ".oxlintrc.json"), "utf-8");
-    const eslint = fs.readFileSync(path.join(projectRoot, "eslint.config.js"), "utf-8");
-
-    assertIncludes(tsconfig, '"$schema": "http://json.schemastore.org/tsconfig"');
-    assertIncludes(tsconfig, '"exclude": ["plugins/**"]');
-    assertIncludes(oxlint, '"ignorePatterns": [');
-    assertIncludes(oxlint, '"plugins/**"');
-    assertIncludes(eslint, 'const config = [\n  { ignores: ["plugins/**"] },');
-    assert.ok(fs.existsSync(path.join(pluginRoot, "cli.ts")), "Expected installed plugin CLI");
-
-    assertIncludes(setupOutput, 'Added "plugins/**" to tsconfig.json exclude');
-    assertIncludes(setupOutput, 'Added "plugins/**" to .oxlintrc.json ignorePatterns');
-    assertIncludes(setupOutput, 'Added "plugins/**" to eslint.config.js ignores');
-    assertIncludes(setupOutput, "Oxlint ignores plugins/ (.oxlintrc.json)");
-    assertIncludes(setupOutput, "ESLint ignores plugins/ (eslint.config.js)");
-
-    const checkOutput = runTsx(
-      pluginRoot,
-      [path.join(pluginRoot, "cli.ts"), "check"],
-      projectRoot,
-      testEnv
-    );
-    assertIncludes(checkOutput, "Oxlint ignores plugins/ (.oxlintrc.json)");
-    assertIncludes(checkOutput, "ESLint ignores plugins/ (eslint.config.js)");
-    assert.ok(
-      !checkOutput.includes("Lint config check (no ESLint or Oxlint config found)"),
-      `Did not expect lint config detection to be skipped:\n${checkOutput}`
-    );
-
-    console.log("");
-    console.log("typegraph-mcp Install Oxlint Test");
-    console.log("=================================");
-    console.log("  ✓ tsconfig schema URL preserved during exclude patch");
-    console.log("  ✓ tsconfig exclude patch ignores unrelated plugins text");
-    console.log("  ✓ .oxlintrc.json patched with plugins ignore");
-    console.log("  ✓ eslint.config.js named flat-config array patched with plugins ignore");
-    console.log("  ✓ installed plugin health check recognizes Oxlint config");
-    console.log("  ✓ installed plugin health check recognizes ESLint config");
-  } finally {
-    fs.rmSync(tempRoot, { recursive: true, force: true });
-  }
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});