typegraph-mcp 0.9.32 → 0.9.33

package/README.md

@@ -142,7 +142,7 @@ npx typegraph-mcp check
 | Symptom | Fix |
 |---|---|
 | Server won't start | `cd plugins/typegraph-mcp && npm install --include=optional` |
-| "TypeScript not found" | Add `typescript` to devDependencies |
+| "TypeScript not found" | Run `pnpm install` or `npm install`; if TypeScript is not declared, add it to devDependencies first |
 | Tools return empty results | Check `TYPEGRAPH_TSCONFIG` points to the right tsconfig |
 | Build errors from plugins/ | Add `"plugins/**"` to tsconfig.json `exclude` array |
 | `@esbuild/*` or `@rollup/*` package missing | Reinstall with Node 22: `npm install --include=optional` |

package/check.ts

@@ -162,6 +162,45 @@ function hasTrustedCodexProject(projectRoot: string): boolean | null {
   return matchesTrustedProject();
 }
 
+function readProjectPackageJson(projectRoot: string): Record<string, unknown> | null {
+  const packageJsonPath = path.resolve(projectRoot, "package.json");
+  if (!fs.existsSync(packageJsonPath)) return null;
+
+  try {
+    return JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")) as Record<string, unknown>;
+  } catch {
+    return null;
+  }
+}
+
+function getProjectInstallCommand(projectRoot: string, packageJson: Record<string, unknown> | null): string {
+  const packageManager = typeof packageJson?.["packageManager"] === "string"
+    ? packageJson["packageManager"]
+    : "";
+
+  if (packageManager.startsWith("pnpm@") || fs.existsSync(path.join(projectRoot, "pnpm-lock.yaml"))) {
+    return "pnpm install";
+  }
+  if (packageManager.startsWith("yarn@") || fs.existsSync(path.join(projectRoot, "yarn.lock"))) {
+    return "yarn install";
+  }
+  return "npm install";
+}
+
+function hasDeclaredDependency(packageJson: Record<string, unknown> | null, packageName: string): boolean {
+  const depKeys = [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies",
+  ] as const;
+
+  return depKeys.some((key) => {
+    const deps = packageJson?.[key];
+    return typeof deps === "object" && deps !== null && packageName in deps;
+  });
+}
+
 // ─── Main ────────────────────────────────────────────────────────────────────
 
 export async function main(configOverride?: TypegraphConfig): Promise<CheckResult> {
@@ -171,6 +210,8 @@ export async function main(configOverride?: TypegraphConfig): Promise<CheckResul
   let passed = 0;
   let failed = 0;
   let warned = 0;
+  const projectPackageJson = readProjectPackageJson(projectRoot);
+  const installCommand = getProjectInstallCommand(projectRoot, projectPackageJson);
 
   function pass(msg: string): void {
     console.log(`  \u2713 ${msg}`);
@@ -228,9 +269,14 @@ export async function main(configOverride?: TypegraphConfig): Promise<CheckResul
     tsVersion = tsPkg.version;
     pass(`TypeScript found (v${tsVersion})`);
   } catch {
+    const hasDeclaredTs = hasDeclaredDependency(projectPackageJson, "typescript");
     fail(
-      "TypeScript not found in project",
-      "Add `typescript` to devDependencies and run `npm install`"
+      hasDeclaredTs
+        ? "TypeScript is declared but not installed in project"
+        : "TypeScript not found in project",
+      hasDeclaredTs
+        ? `Run \`${installCommand}\` to install project dependencies`
+        : `Add \`typescript\` to devDependencies and run \`${installCommand}\``
     );
   }
 

package/dist/check.js

@@ -472,11 +472,44 @@ function hasTrustedCodexProject(projectRoot) {
   }
   return matchesTrustedProject();
 }
+function readProjectPackageJson(projectRoot) {
+  const packageJsonPath = path3.resolve(projectRoot, "package.json");
+  if (!fs2.existsSync(packageJsonPath)) return null;
+  try {
+    return JSON.parse(fs2.readFileSync(packageJsonPath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function getProjectInstallCommand(projectRoot, packageJson) {
+  const packageManager = typeof packageJson?.["packageManager"] === "string" ? packageJson["packageManager"] : "";
+  if (packageManager.startsWith("pnpm@") || fs2.existsSync(path3.join(projectRoot, "pnpm-lock.yaml"))) {
+    return "pnpm install";
+  }
+  if (packageManager.startsWith("yarn@") || fs2.existsSync(path3.join(projectRoot, "yarn.lock"))) {
+    return "yarn install";
+  }
+  return "npm install";
+}
+function hasDeclaredDependency(packageJson, packageName) {
+  const depKeys = [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies"
+  ];
+  return depKeys.some((key) => {
+    const deps = packageJson?.[key];
+    return typeof deps === "object" && deps !== null && packageName in deps;
+  });
+}
 async function main(configOverride) {
   const { projectRoot, tsconfigPath, toolDir, toolIsEmbedded, toolRelPath } = configOverride ?? resolveConfig(import.meta.dirname);
   let passed = 0;
   let failed = 0;
   let warned = 0;
+  const projectPackageJson = readProjectPackageJson(projectRoot);
+  const installCommand = getProjectInstallCommand(projectRoot, projectPackageJson);
   function pass(msg) {
     console.log(`  \u2713 ${msg}`);
     passed++;
@@ -522,9 +555,10 @@ async function main(configOverride) {
     tsVersion = tsPkg.version;
     pass(`TypeScript found (v${tsVersion})`);
   } catch {
+    const hasDeclaredTs = hasDeclaredDependency(projectPackageJson, "typescript");
     fail(
-      "TypeScript not found in project",
-      "Add `typescript` to devDependencies and run `npm install`"
+      hasDeclaredTs ? "TypeScript is declared but not installed in project" : "TypeScript not found in project",
+      hasDeclaredTs ? `Run \`${installCommand}\` to install project dependencies` : `Add \`typescript\` to devDependencies and run \`${installCommand}\``
     );
   }
   const tsconfigAbs = path3.resolve(projectRoot, tsconfigPath);

package/dist/cli.js

@@ -479,11 +479,44 @@ function hasTrustedCodexProject(projectRoot3) {
   }
   return matchesTrustedProject();
 }
+function readProjectPackageJson(projectRoot3) {
+  const packageJsonPath = path3.resolve(projectRoot3, "package.json");
+  if (!fs2.existsSync(packageJsonPath)) return null;
+  try {
+    return JSON.parse(fs2.readFileSync(packageJsonPath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function getProjectInstallCommand(projectRoot3, packageJson) {
+  const packageManager = typeof packageJson?.["packageManager"] === "string" ? packageJson["packageManager"] : "";
+  if (packageManager.startsWith("pnpm@") || fs2.existsSync(path3.join(projectRoot3, "pnpm-lock.yaml"))) {
+    return "pnpm install";
+  }
+  if (packageManager.startsWith("yarn@") || fs2.existsSync(path3.join(projectRoot3, "yarn.lock"))) {
+    return "yarn install";
+  }
+  return "npm install";
+}
+function hasDeclaredDependency(packageJson, packageName) {
+  const depKeys = [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies"
+  ];
+  return depKeys.some((key) => {
+    const deps = packageJson?.[key];
+    return typeof deps === "object" && deps !== null && packageName in deps;
+  });
+}
 async function main(configOverride) {
   const { projectRoot: projectRoot3, tsconfigPath: tsconfigPath3, toolDir, toolIsEmbedded, toolRelPath } = configOverride ?? resolveConfig(import.meta.dirname);
   let passed = 0;
   let failed = 0;
   let warned = 0;
+  const projectPackageJson = readProjectPackageJson(projectRoot3);
+  const installCommand = getProjectInstallCommand(projectRoot3, projectPackageJson);
   function pass(msg) {
     console.log(`  \u2713 ${msg}`);
     passed++;
@@ -529,9 +562,10 @@ async function main(configOverride) {
     tsVersion = tsPkg.version;
     pass(`TypeScript found (v${tsVersion})`);
   } catch {
+    const hasDeclaredTs = hasDeclaredDependency(projectPackageJson, "typescript");
     fail(
-      "TypeScript not found in project",
-      "Add `typescript` to devDependencies and run `npm install`"
+      hasDeclaredTs ? "TypeScript is declared but not installed in project" : "TypeScript not found in project",
+      hasDeclaredTs ? `Run \`${installCommand}\` to install project dependencies` : `Add \`typescript\` to devDependencies and run \`${installCommand}\``
     );
   }
   const tsconfigAbs = path3.resolve(projectRoot3, tsconfigPath3);

package/package.json

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