typegraph-mcp 0.9.47 → 0.9.48

package/dist/module-graph.js

@@ -18,8 +18,19 @@ var SKIP_DIRS = /* @__PURE__ */ new Set([
   "coverage"
 ]);
 var SKIP_FILES = /* @__PURE__ */ new Set(["routeTree.gen.ts"]);
-function discoverFiles(rootDir) {
+function normalizeExcludedPaths(rootDir, excludedPaths) {
+  return excludedPaths.map(
+    (excludedPath) => path.resolve(rootDir, excludedPath)
+  );
+}
+function isExcluded(filePath, excludedPaths) {
+  return excludedPaths.some(
+    (excludedPath) => filePath === excludedPath || filePath.startsWith(excludedPath + path.sep)
+  );
+}
+function discoverFiles(rootDir, excludedPaths = []) {
   const files = [];
+  const normalizedExclusions = normalizeExcludedPaths(rootDir, excludedPaths);
   function walk(dir) {
     let entries;
     try {
@@ -31,7 +42,9 @@ function discoverFiles(rootDir) {
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (entry.name.startsWith(".") && dir !== rootDir) continue;
-        walk(path.join(dir, entry.name));
+        const childDir = path.join(dir, entry.name);
+        if (isExcluded(childDir, normalizedExclusions)) continue;
+        walk(childDir);
       } else if (entry.isFile()) {
         const name = entry.name;
         if (SKIP_FILES.has(name)) continue;
@@ -132,11 +145,9 @@ function resolveProjectImport(resolver, fromDir, specifier, projectRoot) {
   return null;
 }
 function createResolver(projectRoot, tsconfigPath) {
+  const configFile = path.resolve(projectRoot, tsconfigPath);
   return new ResolverFactory({
-    tsconfig: {
-      configFile: path.resolve(projectRoot, tsconfigPath),
-      references: "auto"
-    },
+    ...fs.existsSync(configFile) ? { tsconfig: { configFile, references: "auto" } } : {},
     extensions: [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"],
     extensionAlias: {
       ".js": [".ts", ".tsx", ".js"],
@@ -202,10 +213,10 @@ function buildReverseMap(forward) {
   }
   return reverse;
 }
-async function buildGraph(projectRoot, tsconfigPath) {
+async function buildGraph(projectRoot, tsconfigPath, excludedPaths = []) {
   const startTime = performance.now();
   const resolver = createResolver(projectRoot, tsconfigPath);
-  const fileList = discoverFiles(projectRoot);
+  const fileList = discoverFiles(projectRoot, excludedPaths);
   log(`Discovered ${fileList.length} source files`);
   const { forward, parseFailures } = buildForwardEdges(fileList, resolver, projectRoot);
   const reverse = buildReverseMap(forward);
@@ -297,8 +308,9 @@ function removeFile(graph, filePath) {
   graph.reverse.delete(filePath);
   graph.files.delete(filePath);
 }
-function startWatcher(projectRoot, graph, resolver, hooks) {
+function startWatcher(projectRoot, graph, resolver, hooks, excludedPaths = []) {
   try {
+    const normalizedExclusions = normalizeExcludedPaths(projectRoot, excludedPaths);
     const watcher = fs.watch(
       projectRoot,
       { recursive: true },
@@ -312,6 +324,7 @@ function startWatcher(projectRoot, graph, resolver, hooks) {
         if (filename.endsWith(".d.ts") || filename.endsWith(".d.mts") || filename.endsWith(".d.cts"))
           return;
         const absPath = path.resolve(projectRoot, filename);
+        if (isExcluded(absPath, normalizedExclusions)) return;
         if (fs.existsSync(absPath)) {
           updateFile(graph, absPath, resolver, projectRoot);
           void hooks?.onFileUpdated?.(absPath);

package/dist/server.js

@@ -12,6 +12,30 @@ import * as fs from "fs";
 import { createRequire } from "module";
 var log = (...args) => console.error("[typegraph/tsserver]", ...args);
 var REQUEST_TIMEOUT_MS = 1e4;
+function readPackageVersion(packagePath) {
+  const pkg = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+  return pkg.version ?? "unknown";
+}
+function resolveTsServer(projectRoot2) {
+  const projectRequire = createRequire(path.resolve(projectRoot2, "package.json"));
+  let projectVersion;
+  try {
+    const packagePath2 = projectRequire.resolve("typescript/package.json");
+    projectVersion = readPackageVersion(packagePath2);
+    const serverPath2 = projectRequire.resolve("typescript/lib/tsserver.js");
+    return { path: serverPath2, version: projectVersion, source: "project" };
+  } catch {
+  }
+  const toolRequire = createRequire(import.meta.url);
+  const packagePath = toolRequire.resolve("typescript/package.json");
+  const serverPath = toolRequire.resolve("typescript/lib/tsserver.js");
+  return {
+    path: serverPath,
+    version: readPackageVersion(packagePath),
+    source: "typegraph",
+    projectVersion
+  };
+}
 var TsServerClient = class {
   constructor(projectRoot2, tsconfigPath2 = "./tsconfig.json") {
     this.projectRoot = projectRoot2;
@@ -48,9 +72,12 @@ var TsServerClient = class {
   // ─── Lifecycle ──────────────────────────────────────────────────────────
   async start() {
     if (this.child) return;
-    const require2 = createRequire(path.resolve(this.projectRoot, "package.json"));
-    const tsserverPath = require2.resolve("typescript/lib/tsserver.js");
-    log(`Spawning tsserver: ${tsserverPath}`);
+    const resolution = resolveTsServer(this.projectRoot);
+    const tsserverPath = resolution.path;
+    const fallbackNote = resolution.projectVersion ? `; project TypeScript ${resolution.projectVersion} has no legacy tsserver` : "";
+    log(
+      `Spawning tsserver: ${tsserverPath} (TypeScript ${resolution.version}, ${resolution.source}${fallbackNote})`
+    );
     log(`Project root: ${this.projectRoot}`);
     log(`tsconfig: ${this.tsconfigPath}`);
     this.child = spawn("node", [tsserverPath, "--disableAutomaticTypingAcquisition"], {
@@ -79,12 +106,9 @@ var TsServerClient = class {
       }
     });
     const warmStart = performance.now();
-    const tsconfigAbs = this.resolvePath(this.tsconfigPath);
-    if (fs.existsSync(tsconfigAbs)) {
-      await this.sendRequest("compilerOptionsForInferredProjects", {
-        options: { allowJs: true, checkJs: false }
-      });
-    }
+    await this.sendRequest("compilerOptionsForInferredProjects", {
+      options: { allowJs: true, checkJs: false }
+    });
     this.ready = true;
     log(`Ready [${(performance.now() - warmStart).toFixed(0)}ms configure]`);
   }
@@ -328,8 +352,19 @@ var SKIP_DIRS = /* @__PURE__ */ new Set([
   "coverage"
 ]);
 var SKIP_FILES = /* @__PURE__ */ new Set(["routeTree.gen.ts"]);
-function discoverFiles(rootDir) {
+function normalizeExcludedPaths(rootDir, excludedPaths2) {
+  return excludedPaths2.map(
+    (excludedPath) => path2.resolve(rootDir, excludedPath)
+  );
+}
+function isExcluded(filePath, excludedPaths2) {
+  return excludedPaths2.some(
+    (excludedPath) => filePath === excludedPath || filePath.startsWith(excludedPath + path2.sep)
+  );
+}
+function discoverFiles(rootDir, excludedPaths2 = []) {
   const files = [];
+  const normalizedExclusions = normalizeExcludedPaths(rootDir, excludedPaths2);
   function walk(dir) {
     let entries;
     try {
@@ -341,7 +376,9 @@ function discoverFiles(rootDir) {
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (entry.name.startsWith(".") && dir !== rootDir) continue;
-        walk(path2.join(dir, entry.name));
+        const childDir = path2.join(dir, entry.name);
+        if (isExcluded(childDir, normalizedExclusions)) continue;
+        walk(childDir);
       } else if (entry.isFile()) {
         const name = entry.name;
         if (SKIP_FILES.has(name)) continue;
@@ -442,11 +479,9 @@ function resolveProjectImport(resolver, fromDir, specifier, projectRoot2) {
   return null;
 }
 function createResolver(projectRoot2, tsconfigPath2) {
+  const configFile = path2.resolve(projectRoot2, tsconfigPath2);
   return new ResolverFactory({
-    tsconfig: {
-      configFile: path2.resolve(projectRoot2, tsconfigPath2),
-      references: "auto"
-    },
+    ...fs2.existsSync(configFile) ? { tsconfig: { configFile, references: "auto" } } : {},
     extensions: [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"],
     extensionAlias: {
       ".js": [".ts", ".tsx", ".js"],
@@ -512,10 +547,10 @@ function buildReverseMap(forward) {
   }
   return reverse;
 }
-async function buildGraph(projectRoot2, tsconfigPath2) {
+async function buildGraph(projectRoot2, tsconfigPath2, excludedPaths2 = []) {
   const startTime = performance.now();
   const resolver = createResolver(projectRoot2, tsconfigPath2);
-  const fileList = discoverFiles(projectRoot2);
+  const fileList = discoverFiles(projectRoot2, excludedPaths2);
   log2(`Discovered ${fileList.length} source files`);
   const { forward, parseFailures } = buildForwardEdges(fileList, resolver, projectRoot2);
   const reverse = buildReverseMap(forward);
@@ -607,8 +642,9 @@ function removeFile(graph, filePath) {
   graph.reverse.delete(filePath);
   graph.files.delete(filePath);
 }
-function startWatcher(projectRoot2, graph, resolver, hooks) {
+function startWatcher(projectRoot2, graph, resolver, hooks, excludedPaths2 = []) {
   try {
+    const normalizedExclusions = normalizeExcludedPaths(projectRoot2, excludedPaths2);
     const watcher = fs2.watch(
       projectRoot2,
       { recursive: true },
@@ -622,6 +658,7 @@ function startWatcher(projectRoot2, graph, resolver, hooks) {
         if (filename.endsWith(".d.ts") || filename.endsWith(".d.mts") || filename.endsWith(".d.cts"))
           return;
         const absPath2 = path2.resolve(projectRoot2, filename);
+        if (isExcluded(absPath2, normalizedExclusions)) return;
         if (fs2.existsSync(absPath2)) {
           updateFile(graph, absPath2, resolver, projectRoot2);
           void hooks?.onFileUpdated?.(absPath2);
@@ -917,17 +954,18 @@ import * as path5 from "path";
 
 // config.ts
 import * as path4 from "path";
-function resolveConfig(toolDir) {
+function resolveConfig(toolDir2) {
   const cwd = process.cwd();
-  const projectRoot2 = process.env["TYPEGRAPH_PROJECT_ROOT"] ? path4.resolve(cwd, process.env["TYPEGRAPH_PROJECT_ROOT"]) : path4.basename(path4.dirname(toolDir)) === "plugins" ? path4.resolve(toolDir, "../..") : cwd;
+  const projectRoot2 = process.env["TYPEGRAPH_PROJECT_ROOT"] ? path4.resolve(cwd, process.env["TYPEGRAPH_PROJECT_ROOT"]) : path4.basename(path4.dirname(toolDir2)) === "plugins" ? path4.resolve(toolDir2, "../..") : cwd;
   const tsconfigPath2 = process.env["TYPEGRAPH_TSCONFIG"] || "./tsconfig.json";
-  const toolIsEmbedded = toolDir.startsWith(projectRoot2 + path4.sep);
-  const toolRelPath = toolIsEmbedded ? path4.relative(projectRoot2, toolDir) : toolDir;
-  return { projectRoot: projectRoot2, tsconfigPath: tsconfigPath2, toolDir, toolIsEmbedded, toolRelPath };
+  const toolIsEmbedded2 = toolDir2.startsWith(projectRoot2 + path4.sep);
+  const toolRelPath = toolIsEmbedded2 ? path4.relative(projectRoot2, toolDir2) : toolDir2;
+  return { projectRoot: projectRoot2, tsconfigPath: tsconfigPath2, toolDir: toolDir2, toolIsEmbedded: toolIsEmbedded2, toolRelPath };
 }
 
 // server.ts
-var { projectRoot, tsconfigPath } = resolveConfig(import.meta.dirname);
+var { projectRoot, tsconfigPath, toolDir, toolIsEmbedded } = resolveConfig(import.meta.dirname);
+var excludedPaths = toolIsEmbedded ? [toolDir] : [];
 var log3 = (...args) => console.error("[typegraph]", ...args);
 var client = new TsServerClient(projectRoot, tsconfigPath);
 var moduleGraph;
@@ -1714,25 +1752,31 @@ async function main() {
   log3(`tsconfig: ${tsconfigPath}`);
   const [, graphResult] = await Promise.all([
     client.start(),
-    buildGraph(projectRoot, tsconfigPath)
+    buildGraph(projectRoot, tsconfigPath, excludedPaths)
   ]);
   moduleGraph = graphResult.graph;
   moduleResolver = graphResult.resolver;
-  startWatcher(projectRoot, moduleGraph, graphResult.resolver, {
-    onFileUpdated: (filePath) => client.reloadOpenFile(filePath).then(
-      (wasOpen) => {
-        if (!wasOpen) client.markProjectsDirty();
-      },
-      (err) => {
+  startWatcher(
+    projectRoot,
+    moduleGraph,
+    graphResult.resolver,
+    {
+      onFileUpdated: (filePath) => client.reloadOpenFile(filePath).then(
+        (wasOpen) => {
+          if (!wasOpen) client.markProjectsDirty();
+        },
+        (err) => {
+          client.markProjectsDirty();
+          log3(`Failed to reload open file ${relPath(filePath)}:`, err);
+        }
+      ),
+      onFileDeleted: (filePath) => {
+        client.closeFile(filePath);
         client.markProjectsDirty();
-        log3(`Failed to reload open file ${relPath(filePath)}:`, err);
       }
-    ),
-    onFileDeleted: (filePath) => {
-      client.closeFile(filePath);
-      client.markProjectsDirty();
-    }
-  });
+    },
+    excludedPaths
+  );
   const transport = new StdioServerTransport();
   await mcpServer.connect(transport);
   log3("MCP server connected and ready");

package/dist/smoke-test.js

@@ -10,6 +10,30 @@ import * as fs from "fs";
 import { createRequire } from "module";
 var log = (...args) => console.error("[typegraph/tsserver]", ...args);
 var REQUEST_TIMEOUT_MS = 1e4;
+function readPackageVersion(packagePath) {
+  const pkg = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+  return pkg.version ?? "unknown";
+}
+function resolveTsServer(projectRoot) {
+  const projectRequire = createRequire(path.resolve(projectRoot, "package.json"));
+  let projectVersion;
+  try {
+    const packagePath2 = projectRequire.resolve("typescript/package.json");
+    projectVersion = readPackageVersion(packagePath2);
+    const serverPath2 = projectRequire.resolve("typescript/lib/tsserver.js");
+    return { path: serverPath2, version: projectVersion, source: "project" };
+  } catch {
+  }
+  const toolRequire = createRequire(import.meta.url);
+  const packagePath = toolRequire.resolve("typescript/package.json");
+  const serverPath = toolRequire.resolve("typescript/lib/tsserver.js");
+  return {
+    path: serverPath,
+    version: readPackageVersion(packagePath),
+    source: "typegraph",
+    projectVersion
+  };
+}
 var TsServerClient = class {
   constructor(projectRoot, tsconfigPath = "./tsconfig.json") {
     this.projectRoot = projectRoot;
@@ -46,9 +70,12 @@ var TsServerClient = class {
   // ─── Lifecycle ──────────────────────────────────────────────────────────
   async start() {
     if (this.child) return;
-    const require2 = createRequire(path.resolve(this.projectRoot, "package.json"));
-    const tsserverPath = require2.resolve("typescript/lib/tsserver.js");
-    log(`Spawning tsserver: ${tsserverPath}`);
+    const resolution = resolveTsServer(this.projectRoot);
+    const tsserverPath = resolution.path;
+    const fallbackNote = resolution.projectVersion ? `; project TypeScript ${resolution.projectVersion} has no legacy tsserver` : "";
+    log(
+      `Spawning tsserver: ${tsserverPath} (TypeScript ${resolution.version}, ${resolution.source}${fallbackNote})`
+    );
     log(`Project root: ${this.projectRoot}`);
     log(`tsconfig: ${this.tsconfigPath}`);
     this.child = spawn("node", [tsserverPath, "--disableAutomaticTypingAcquisition"], {
@@ -77,12 +104,9 @@ var TsServerClient = class {
       }
     });
     const warmStart = performance.now();
-    const tsconfigAbs = this.resolvePath(this.tsconfigPath);
-    if (fs.existsSync(tsconfigAbs)) {
-      await this.sendRequest("compilerOptionsForInferredProjects", {
-        options: { allowJs: true, checkJs: false }
-      });
-    }
+    await this.sendRequest("compilerOptionsForInferredProjects", {
+      options: { allowJs: true, checkJs: false }
+    });
     this.ready = true;
     log(`Ready [${(performance.now() - warmStart).toFixed(0)}ms configure]`);
   }
@@ -177,12 +201,12 @@ var TsServerClient = class {
       command,
       arguments: args
     };
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const timer = setTimeout(() => {
         this.pending.delete(seq);
         reject(new Error(`tsserver ${command} timed out after ${REQUEST_TIMEOUT_MS}ms`));
       }, REQUEST_TIMEOUT_MS);
-      this.pending.set(seq, { resolve: resolve5, reject, timer, command });
+      this.pending.set(seq, { resolve: resolve6, reject, timer, command });
       this.child.stdin.write(JSON.stringify(request) + "\n");
     });
   }
@@ -326,8 +350,19 @@ var SKIP_DIRS = /* @__PURE__ */ new Set([
   "coverage"
 ]);
 var SKIP_FILES = /* @__PURE__ */ new Set(["routeTree.gen.ts"]);
-function discoverFiles(rootDir) {
+function normalizeExcludedPaths(rootDir, excludedPaths) {
+  return excludedPaths.map(
+    (excludedPath) => path2.resolve(rootDir, excludedPath)
+  );
+}
+function isExcluded(filePath, excludedPaths) {
+  return excludedPaths.some(
+    (excludedPath) => filePath === excludedPath || filePath.startsWith(excludedPath + path2.sep)
+  );
+}
+function discoverFiles(rootDir, excludedPaths = []) {
   const files = [];
+  const normalizedExclusions = normalizeExcludedPaths(rootDir, excludedPaths);
   function walk(dir) {
     let entries;
     try {
@@ -339,7 +374,9 @@ function discoverFiles(rootDir) {
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (entry.name.startsWith(".") && dir !== rootDir) continue;
-        walk(path2.join(dir, entry.name));
+        const childDir = path2.join(dir, entry.name);
+        if (isExcluded(childDir, normalizedExclusions)) continue;
+        walk(childDir);
       } else if (entry.isFile()) {
         const name = entry.name;
         if (SKIP_FILES.has(name)) continue;
@@ -440,11 +477,9 @@ function resolveProjectImport(resolver, fromDir, specifier, projectRoot) {
   return null;
 }
 function createResolver(projectRoot, tsconfigPath) {
+  const configFile = path2.resolve(projectRoot, tsconfigPath);
   return new ResolverFactory({
-    tsconfig: {
-      configFile: path2.resolve(projectRoot, tsconfigPath),
-      references: "auto"
-    },
+    ...fs2.existsSync(configFile) ? { tsconfig: { configFile, references: "auto" } } : {},
     extensions: [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"],
     extensionAlias: {
       ".js": [".ts", ".tsx", ".js"],
@@ -510,10 +545,10 @@ function buildReverseMap(forward) {
   }
   return reverse;
 }
-async function buildGraph(projectRoot, tsconfigPath) {
+async function buildGraph(projectRoot, tsconfigPath, excludedPaths = []) {
   const startTime = performance.now();
   const resolver = createResolver(projectRoot, tsconfigPath);
-  const fileList = discoverFiles(projectRoot);
+  const fileList = discoverFiles(projectRoot, excludedPaths);
   log2(`Discovered ${fileList.length} source files`);
   const { forward, parseFailures } = buildForwardEdges(fileList, resolver, projectRoot);
   const reverse = buildReverseMap(forward);
@@ -877,8 +912,9 @@ var SKIP_DIRS2 = /* @__PURE__ */ new Set([
   "coverage",
   "out"
 ]);
-function findTestFile(rootDir) {
+function findTestFile(rootDir, excludedPaths = []) {
   const candidates = [];
+  const normalizedExclusions = excludedPaths.map((excludedPath) => path5.resolve(excludedPath));
   function walk(dir, depth) {
     if (depth > 5 || candidates.length >= 30) return;
     let entries;
@@ -890,7 +926,11 @@ function findTestFile(rootDir) {
     for (const entry of entries) {
       if (entry.isDirectory()) {
         if (SKIP_DIRS2.has(entry.name) || entry.name.startsWith(".")) continue;
-        walk(path5.join(dir, entry.name), depth + 1);
+        const childDir = path5.join(dir, entry.name);
+        if (normalizedExclusions.some(
+          (excludedPath) => childDir === excludedPath || childDir.startsWith(excludedPath + path5.sep)
+        )) continue;
+        walk(childDir, depth + 1);
       } else if (entry.isFile()) {
         const name = entry.name;
         if (name.endsWith(".d.ts") || name.endsWith(".test.ts") || name.endsWith(".spec.ts"))
@@ -898,7 +938,7 @@ function findTestFile(rootDir) {
         if (!name.endsWith(".ts") && !name.endsWith(".tsx")) continue;
         try {
           const stat = fs4.statSync(path5.join(dir, name));
-          if (stat.size > 200 && stat.size < 5e4) {
+          if (stat.size > 0 && stat.size < 5e4) {
             candidates.push({ file: path5.join(dir, name), size: stat.size });
           }
         } catch {
@@ -922,7 +962,8 @@ function findImporter(graph, file) {
   return (preferred ?? revEdges[0]).target;
 }
 async function main(configOverride) {
-  const { projectRoot, tsconfigPath } = configOverride ?? resolveConfig(import.meta.dirname);
+  const { projectRoot, tsconfigPath, toolDir, toolIsEmbedded } = configOverride ?? resolveConfig(import.meta.dirname);
+  const excludedPaths = toolIsEmbedded ? [toolDir] : [];
   let passed = 0;
   let failed = 0;
   let skipped = 0;
@@ -945,7 +986,7 @@ async function main(configOverride) {
   console.log("=====================");
   console.log(`Project root: ${projectRoot}`);
   console.log("");
-  const testFile = findTestFile(projectRoot);
+  const testFile = findTestFile(projectRoot, excludedPaths);
   if (!testFile) {
     console.log("  No suitable .ts file found in project. Cannot run smoke tests.");
     return { passed, failed: failed + 1, skipped };
@@ -958,7 +999,7 @@ async function main(configOverride) {
   let t0;
   t0 = performance.now();
   try {
-    const result = await buildGraph(projectRoot, tsconfigPath);
+    const result = await buildGraph(projectRoot, tsconfigPath, excludedPaths);
     graph = result.graph;
     const ms = performance.now() - t0;
     const edgeCount = [...graph.forward.values()].reduce((s, e) => s + e.length, 0);

package/dist/tsserver-client.js

@@ -5,6 +5,30 @@ import * as fs from "fs";
 import { createRequire } from "module";
 var log = (...args) => console.error("[typegraph/tsserver]", ...args);
 var REQUEST_TIMEOUT_MS = 1e4;
+function readPackageVersion(packagePath) {
+  const pkg = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+  return pkg.version ?? "unknown";
+}
+function resolveTsServer(projectRoot) {
+  const projectRequire = createRequire(path.resolve(projectRoot, "package.json"));
+  let projectVersion;
+  try {
+    const packagePath2 = projectRequire.resolve("typescript/package.json");
+    projectVersion = readPackageVersion(packagePath2);
+    const serverPath2 = projectRequire.resolve("typescript/lib/tsserver.js");
+    return { path: serverPath2, version: projectVersion, source: "project" };
+  } catch {
+  }
+  const toolRequire = createRequire(import.meta.url);
+  const packagePath = toolRequire.resolve("typescript/package.json");
+  const serverPath = toolRequire.resolve("typescript/lib/tsserver.js");
+  return {
+    path: serverPath,
+    version: readPackageVersion(packagePath),
+    source: "typegraph",
+    projectVersion
+  };
+}
 var TsServerClient = class {
   constructor(projectRoot, tsconfigPath = "./tsconfig.json") {
     this.projectRoot = projectRoot;
@@ -41,9 +65,12 @@ var TsServerClient = class {
   // ─── Lifecycle ──────────────────────────────────────────────────────────
   async start() {
     if (this.child) return;
-    const require2 = createRequire(path.resolve(this.projectRoot, "package.json"));
-    const tsserverPath = require2.resolve("typescript/lib/tsserver.js");
-    log(`Spawning tsserver: ${tsserverPath}`);
+    const resolution = resolveTsServer(this.projectRoot);
+    const tsserverPath = resolution.path;
+    const fallbackNote = resolution.projectVersion ? `; project TypeScript ${resolution.projectVersion} has no legacy tsserver` : "";
+    log(
+      `Spawning tsserver: ${tsserverPath} (TypeScript ${resolution.version}, ${resolution.source}${fallbackNote})`
+    );
     log(`Project root: ${this.projectRoot}`);
     log(`tsconfig: ${this.tsconfigPath}`);
     this.child = spawn("node", [tsserverPath, "--disableAutomaticTypingAcquisition"], {
@@ -72,12 +99,9 @@ var TsServerClient = class {
       }
     });
     const warmStart = performance.now();
-    const tsconfigAbs = this.resolvePath(this.tsconfigPath);
-    if (fs.existsSync(tsconfigAbs)) {
-      await this.sendRequest("compilerOptionsForInferredProjects", {
-        options: { allowJs: true, checkJs: false }
-      });
-    }
+    await this.sendRequest("compilerOptionsForInferredProjects", {
+      options: { allowJs: true, checkJs: false }
+    });
     this.ready = true;
     log(`Ready [${(performance.now() - warmStart).toFixed(0)}ms configure]`);
   }
@@ -301,5 +325,6 @@ var TsServerClient = class {
   }
 };
 export {
-  TsServerClient
+  TsServerClient,
+  resolveTsServer
 };

package/module-graph.ts

@@ -55,8 +55,22 @@ const SKIP_FILES = new Set(["routeTree.gen.ts"]);
 
 // ─── File Discovery ──────────────────────────────────────────────────────────
 
-export function discoverFiles(rootDir: string): string[] {
+function normalizeExcludedPaths(rootDir: string, excludedPaths: string[]): string[] {
+  return excludedPaths.map((excludedPath) =>
+    path.resolve(rootDir, excludedPath)
+  );
+}
+
+function isExcluded(filePath: string, excludedPaths: string[]): boolean {
+  return excludedPaths.some(
+    (excludedPath) =>
+      filePath === excludedPath || filePath.startsWith(excludedPath + path.sep)
+  );
+}
+
+export function discoverFiles(rootDir: string, excludedPaths: string[] = []): string[] {
   const files: string[] = [];
+  const normalizedExclusions = normalizeExcludedPaths(rootDir, excludedPaths);
 
   function walk(dir: string): void {
     let entries: fs.Dirent[];
@@ -71,7 +85,9 @@ export function discoverFiles(rootDir: string): string[] {
         if (SKIP_DIRS.has(entry.name)) continue;
         // Skip hidden directories (except the root)
         if (entry.name.startsWith(".") && dir !== rootDir) continue;
-        walk(path.join(dir, entry.name));
+        const childDir = path.join(dir, entry.name);
+        if (isExcluded(childDir, normalizedExclusions)) continue;
+        walk(childDir);
       } else if (entry.isFile()) {
         const name = entry.name;
         if (SKIP_FILES.has(name)) continue;
@@ -240,11 +256,11 @@ export function resolveProjectImport(
 }
 
 export function createResolver(projectRoot: string, tsconfigPath: string): ResolverFactory {
+  const configFile = path.resolve(projectRoot, tsconfigPath);
   return new ResolverFactory({
-    tsconfig: {
-      configFile: path.resolve(projectRoot, tsconfigPath),
-      references: "auto",
-    },
+    ...(fs.existsSync(configFile)
+      ? { tsconfig: { configFile, references: "auto" as const } }
+      : {}),
     extensions: [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"],
     extensionAlias: {
       ".js": [".ts", ".tsx", ".js"],
@@ -328,12 +344,13 @@ function buildReverseMap(forward: Map<string, ImportEdge[]>): Map<string, Import
 
 export async function buildGraph(
   projectRoot: string,
-  tsconfigPath: string
+  tsconfigPath: string,
+  excludedPaths: string[] = []
 ): Promise<BuildGraphResult> {
   const startTime = performance.now();
 
   const resolver = createResolver(projectRoot, tsconfigPath);
-  const fileList = discoverFiles(projectRoot);
+  const fileList = discoverFiles(projectRoot, excludedPaths);
 
   log(`Discovered ${fileList.length} source files`);
 
@@ -464,9 +481,11 @@ export function startWatcher(
   hooks?: {
     onFileUpdated?: (filePath: string) => void | Promise<void>;
     onFileDeleted?: (filePath: string) => void | Promise<void>;
-  }
+  },
+  excludedPaths: string[] = []
 ): void {
   try {
+    const normalizedExclusions = normalizeExcludedPaths(projectRoot, excludedPaths);
     const watcher = fs.watch(
       projectRoot,
       { recursive: true },
@@ -489,6 +508,7 @@ export function startWatcher(
           return;
 
         const absPath = path.resolve(projectRoot, filename);
+        if (isExcluded(absPath, normalizedExclusions)) return;
 
         if (fs.existsSync(absPath)) {
           // File created or modified

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typegraph-mcp",
-  "version": "0.9.47",
+  "version": "0.9.48",
   "description": "Type-aware codebase navigation for AI coding agents — 14 MCP tools powered by tsserver + oxc",
   "license": "MIT",
   "type": "module",
@@ -33,8 +33,9 @@
   ],
   "scripts": {
     "build": "tsup",
+    "setup:self": "tsx scripts/self-install.ts",
     "start": "tsx server.ts",
-    "test": "tsx smoke-test-selection-test.ts && tsx export-surface-test.ts && tsx engine-sync-test.ts && tsx install-oxlint-test.ts",
+    "test": "tsx tests/smoke-test-selection-test.ts && tsx tests/biome-config-test.ts && tsx tests/self-install-test.ts && tsx tests/tsserver-resolution-test.ts && tsx tests/export-surface-test.ts && tsx tests/engine-sync-test.ts && tsx tests/install-oxlint-test.ts",
     "check": "tsx check.ts"
   },
   "dependencies": {
@@ -42,12 +43,12 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "oxc-parser": "^0.114.0",
     "oxc-resolver": "^11.17.1",
+    "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",
     "tsup": "^8.5.0",
-    "tsx": "^4.21.0",
-    "typescript": "^5.8.0"
+    "tsx": "^4.21.0"
   }
 }