typegraph-mcp 0.9.21 → 0.9.23

package/README.md

@@ -143,6 +143,7 @@ npx typegraph-mcp check
 | "TypeScript not found" | Add `typescript` to devDependencies |
 | Tools return empty results | Check `TYPEGRAPH_TSCONFIG` points to the right tsconfig |
 | Build errors from plugins/ | Add `"plugins/**"` to tsconfig.json `exclude` array |
+| "npm warn Unknown project config" | Safe to ignore — caused by pnpm settings in your `.npmrc` that npm doesn't recognize |
 
 ## Manual MCP configuration
 

package/check.ts

@@ -371,8 +371,10 @@ export async function main(configOverride?: TypegraphConfig): Promise<CheckResul
 
   // 11. ESLint ignores (only when typegraph-mcp is embedded inside the project)
   if (toolIsEmbedded) {
-    const eslintConfigPath = path.resolve(projectRoot, "eslint.config.mjs");
-    if (fs.existsSync(eslintConfigPath)) {
+    const eslintConfigNames = ["eslint.config.mjs", "eslint.config.js", "eslint.config.ts", "eslint.config.cjs"];
+    const eslintConfigFile = eslintConfigNames.find((name) => fs.existsSync(path.resolve(projectRoot, name)));
+    if (eslintConfigFile) {
+      const eslintConfigPath = path.resolve(projectRoot, eslintConfigFile);
       const eslintContent = fs.readFileSync(eslintConfigPath, "utf-8");
       // Determine the parent directory (e.g. "plugins") for the ignore pattern
       const parentDir = path.basename(path.dirname(toolDir));
@@ -384,11 +386,11 @@ export async function main(configOverride?: TypegraphConfig): Promise<CheckResul
       } else {
         fail(
           `ESLint missing ignore: "${parentDir}/**"`,
-          `Add to the ignores array in eslint.config.mjs:\n    "${parentDir}/**",`
+          `Add to the ignores array in ${eslintConfigFile}:\n    "${parentDir}/**",`
         );
       }
     } else {
-      skip("ESLint config check (no eslint.config.mjs)");
+      skip("ESLint config check (no eslint flat config found)");
     }
   } else {
     skip("ESLint config check (typegraph-mcp is external to project)");

package/cli.ts

@@ -362,6 +362,51 @@ function ensureTsconfigExclude(projectRoot: string): void {
   }
 }
 
+// ─── ESLint Ignore ───────────────────────────────────────────────────────────
+
+function ensureEslintIgnore(projectRoot: string): void {
+  const eslintConfigNames = ["eslint.config.mjs", "eslint.config.js", "eslint.config.ts", "eslint.config.cjs"];
+  const eslintConfigFile = eslintConfigNames.find((name) => fs.existsSync(path.resolve(projectRoot, name)));
+  if (!eslintConfigFile) return;
+  const eslintConfigPath = path.resolve(projectRoot, eslintConfigFile);
+
+  try {
+    const raw = fs.readFileSync(eslintConfigPath, "utf-8");
+    const pattern = /["']plugins\/\*\*["']/;
+    if (pattern.test(raw)) return; // Already ignored
+
+    // Strategy 1: Append to an existing ignores array
+    const ignoresArrayRe = /(ignores\s*:\s*\[)([\s\S]*?)(\])/;
+    const match = raw.match(ignoresArrayRe);
+    if (match) {
+      const updated = raw.replace(ignoresArrayRe, (_m, open, items, close) => {
+        const trimmed = items.trimEnd();
+        const needsComma = trimmed.length > 0 && !trimmed.endsWith(",");
+        return `${open}${items.trimEnd()}${needsComma ? "," : ""} "plugins/**"${close}`;
+      });
+      fs.writeFileSync(eslintConfigPath, updated);
+      p.log.success(`Added "plugins/**" to ${eslintConfigFile} ignores`);
+      return;
+    }
+
+    // Strategy 2: Insert a new ignores object at the start of the exported array
+    // Matches: export default [ or export default tseslint.config(
+    const exportArrayRe = /(export\s+default\s+(?:\w+\.config\(|\[))\s*\n?/;
+    if (exportArrayRe.test(raw)) {
+      const updated = raw.replace(exportArrayRe, (m) => {
+        return `${m}  { ignores: ["plugins/**"] },\n`;
+      });
+      fs.writeFileSync(eslintConfigPath, updated);
+      p.log.success(`Added "plugins/**" to ${eslintConfigFile} ignores`);
+      return;
+    }
+
+    p.log.warn(`Could not patch ${eslintConfigFile} — manually add "plugins/**" to the ignores array`);
+  } catch {
+    p.log.warn(`Could not update ${eslintConfigFile} — manually add "plugins/**" to the ignores array`);
+  }
+}
+
 // ─── Agent Selection ─────────────────────────────────────────────────────────
 
 function detectAgents(projectRoot: string): AgentId[] {
@@ -564,7 +609,10 @@ async function setup(yes: boolean): Promise<void> {
   // 8. Ensure plugins/ is excluded from tsconfig
   ensureTsconfigExclude(projectRoot);
 
-  // 9. Verification
+  // 9. Ensure plugins/ is ignored by ESLint
+  ensureEslintIgnore(projectRoot);
+
+  // 10. Verification
   await runVerification(targetDir, selectedAgents);
 }
 
@@ -808,6 +856,9 @@ const command = args.find((a) => !a.startsWith("-"));
 const yes = args.includes("--yes") || args.includes("-y");
 const help = args.includes("--help") || args.includes("-h");
 
+// Clear npx download noise (warnings, "Ok to proceed?" prompt)
+process.stdout.write("\x1Bc");
+
 if (help || !command) {
   console.log(HELP);
   process.exit(0);

package/dist/check.js

@@ -663,8 +663,10 @@ async function main(configOverride) {
     );
   }
   if (toolIsEmbedded) {
-    const eslintConfigPath = path3.resolve(projectRoot, "eslint.config.mjs");
-    if (fs2.existsSync(eslintConfigPath)) {
+    const eslintConfigNames = ["eslint.config.mjs", "eslint.config.js", "eslint.config.ts", "eslint.config.cjs"];
+    const eslintConfigFile = eslintConfigNames.find((name) => fs2.existsSync(path3.resolve(projectRoot, name)));
+    if (eslintConfigFile) {
+      const eslintConfigPath = path3.resolve(projectRoot, eslintConfigFile);
       const eslintContent = fs2.readFileSync(eslintConfigPath, "utf-8");
       const parentDir = path3.basename(path3.dirname(toolDir));
       const parentIgnorePattern = new RegExp(`["']${parentDir}\\/\\*\\*["']`);
@@ -674,12 +676,12 @@ async function main(configOverride) {
       } else {
         fail(
           `ESLint missing ignore: "${parentDir}/**"`,
-          `Add to the ignores array in eslint.config.mjs:
+          `Add to the ignores array in ${eslintConfigFile}:
     "${parentDir}/**",`
         );
       }
     } else {
-      skip("ESLint config check (no eslint.config.mjs)");
+      skip("ESLint config check (no eslint flat config found)");
     }
   } else {
     skip("ESLint config check (typegraph-mcp is external to project)");

package/dist/cli.js

@@ -670,8 +670,10 @@ async function main(configOverride) {
     );
   }
   if (toolIsEmbedded) {
-    const eslintConfigPath = path3.resolve(projectRoot3, "eslint.config.mjs");
-    if (fs2.existsSync(eslintConfigPath)) {
+    const eslintConfigNames = ["eslint.config.mjs", "eslint.config.js", "eslint.config.ts", "eslint.config.cjs"];
+    const eslintConfigFile = eslintConfigNames.find((name) => fs2.existsSync(path3.resolve(projectRoot3, name)));
+    if (eslintConfigFile) {
+      const eslintConfigPath = path3.resolve(projectRoot3, eslintConfigFile);
       const eslintContent = fs2.readFileSync(eslintConfigPath, "utf-8");
       const parentDir = path3.basename(path3.dirname(toolDir));
       const parentIgnorePattern = new RegExp(`["']${parentDir}\\/\\*\\*["']`);
@@ -681,12 +683,12 @@ async function main(configOverride) {
       } else {
         fail(
           `ESLint missing ignore: "${parentDir}/**"`,
-          `Add to the ignores array in eslint.config.mjs:
+          `Add to the ignores array in ${eslintConfigFile}:
     "${parentDir}/**",`
         );
       }
     } else {
-      skip("ESLint config check (no eslint.config.mjs)");
+      skip("ESLint config check (no eslint flat config found)");
     }
   } else {
     skip("ESLint config check (typegraph-mcp is external to project)");
@@ -3055,6 +3057,42 @@ function ensureTsconfigExclude(projectRoot3) {
     p.log.warn('Could not update tsconfig.json \u2014 manually add "plugins/**" to the exclude array to prevent build errors');
   }
 }
+function ensureEslintIgnore(projectRoot3) {
+  const eslintConfigNames = ["eslint.config.mjs", "eslint.config.js", "eslint.config.ts", "eslint.config.cjs"];
+  const eslintConfigFile = eslintConfigNames.find((name) => fs8.existsSync(path9.resolve(projectRoot3, name)));
+  if (!eslintConfigFile) return;
+  const eslintConfigPath = path9.resolve(projectRoot3, eslintConfigFile);
+  try {
+    const raw = fs8.readFileSync(eslintConfigPath, "utf-8");
+    const pattern = /["']plugins\/\*\*["']/;
+    if (pattern.test(raw)) return;
+    const ignoresArrayRe = /(ignores\s*:\s*\[)([\s\S]*?)(\])/;
+    const match = raw.match(ignoresArrayRe);
+    if (match) {
+      const updated = raw.replace(ignoresArrayRe, (_m, open, items, close) => {
+        const trimmed = items.trimEnd();
+        const needsComma = trimmed.length > 0 && !trimmed.endsWith(",");
+        return `${open}${items.trimEnd()}${needsComma ? "," : ""} "plugins/**"${close}`;
+      });
+      fs8.writeFileSync(eslintConfigPath, updated);
+      p.log.success(`Added "plugins/**" to ${eslintConfigFile} ignores`);
+      return;
+    }
+    const exportArrayRe = /(export\s+default\s+(?:\w+\.config\(|\[))\s*\n?/;
+    if (exportArrayRe.test(raw)) {
+      const updated = raw.replace(exportArrayRe, (m) => {
+        return `${m}  { ignores: ["plugins/**"] },
+`;
+      });
+      fs8.writeFileSync(eslintConfigPath, updated);
+      p.log.success(`Added "plugins/**" to ${eslintConfigFile} ignores`);
+      return;
+    }
+    p.log.warn(`Could not patch ${eslintConfigFile} \u2014 manually add "plugins/**" to the ignores array`);
+  } catch {
+    p.log.warn(`Could not update ${eslintConfigFile} \u2014 manually add "plugins/**" to the ignores array`);
+  }
+}
 function detectAgents(projectRoot3) {
   return AGENT_IDS.filter((id) => AGENTS[id].detect(projectRoot3));
 }
@@ -3199,6 +3237,7 @@ async function setup(yes2) {
   await setupAgentInstructions(projectRoot3, selectedAgents);
   registerMcpServers(projectRoot3, selectedAgents);
   ensureTsconfigExclude(projectRoot3);
+  ensureEslintIgnore(projectRoot3);
   await runVerification(targetDir, selectedAgents);
 }
 async function removePlugin(projectRoot3, pluginDir) {
@@ -3373,6 +3412,7 @@ var args = process.argv.slice(2);
 var command = args.find((a) => !a.startsWith("-"));
 var yes = args.includes("--yes") || args.includes("-y");
 var help = args.includes("--help") || args.includes("-h");
+process.stdout.write("\x1Bc");
 if (help || !command) {
   console.log(HELP);
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typegraph-mcp",
-  "version": "0.9.21",
+  "version": "0.9.23",
   "description": "Type-aware codebase navigation for AI coding agents — 14 MCP tools powered by tsserver + oxc",
   "license": "MIT",
   "type": "module",