@aiready/ast-mcp-server 0.4.8 → 0.6.0

package/dist/index.cjs

@@ -31,10 +31,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_tsx@4.21.0_typescript@6.0.2_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.9_tsx@4.21.0_typescript@6.0.2_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_tsx@4.21.0_typescript@6.0.2_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.9_tsx@4.21.0_typescript@6.0.2_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
     getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
@@ -186,6 +186,9 @@ var CheckSymbolGroundingSchema = import_zod.z.object({
   symbol: import_zod.z.string().describe("Symbol name to assess grounding for"),
   path: import_zod.z.string().describe("Project root directory")
 });
+var CodebaseAuditSchema = import_zod.z.object({
+  path: import_zod.z.string().describe("Project root directory to audit for debt and bloat")
+});
 
 // src/tools/resolve-definition.ts
 init_cjs_shims();
@@ -584,9 +587,9 @@ var TypeScriptAdapter = class {
       await symbolIndex.buildIndex(searchPath);
     }
   }
-  async resolveDefinition(symbolName, path6) {
-    validateWorkspacePath(path6);
-    await this.ensureIndex(path6);
+  async resolveDefinition(symbolName, path7) {
+    validateWorkspacePath(path7);
+    await this.ensureIndex(path7);
     const indexHits = symbolIndex.lookup(symbolName);
     if (indexHits.length > 0) {
       const results = [];
@@ -614,33 +617,33 @@ var TypeScriptAdapter = class {
       }
       return results;
     }
-    if (import_fs3.default.statSync(path6).isDirectory()) {
+    if (import_fs3.default.statSync(path7).isDirectory()) {
       return [];
     }
-    const tsconfig = await projectManager.findNearestTsConfig(path6);
+    const tsconfig = await projectManager.findNearestTsConfig(path7);
     if (!tsconfig) return [];
     try {
       const result = await this.pool.execute(
         "resolve_definition",
         {
           tsconfig,
-          file: path6,
+          file: path7,
           symbol: symbolName
         }
       );
       return result;
     } catch {
       const project = projectManager.ensureProject(tsconfig);
-      const sourceFile = project.addSourceFileAtPathIfExists(path6);
+      const sourceFile = project.addSourceFileAtPathIfExists(path7);
       if (!sourceFile) return [];
       const exported = sourceFile.getExportedDeclarations().get(symbolName);
       if (!exported) return [];
       return exported.map((decl) => this.mapToDefinitionLocation(decl));
     }
   }
-  async findReferences(symbolName, path6, limit = 50, offset = 0) {
-    validateWorkspacePath(path6);
-    await this.ensureIndex(path6);
+  async findReferences(symbolName, path7, limit = 50, offset = 0) {
+    validateWorkspacePath(path7);
+    await this.ensureIndex(path7);
     const hits = symbolIndex.lookup(symbolName);
     if (hits.length === 0) return { references: [], total_count: 0 };
     const hit = hits[0];
@@ -653,7 +656,7 @@ var TypeScriptAdapter = class {
       const { searchCode: searchCode2 } = await Promise.resolve().then(() => (init_search_code(), search_code_exports));
       const searchResults = await searchCode2(
         symbolName,
-        path6,
+        path7,
         "**/*.{ts,tsx,js,jsx}",
         1e3,
         false
@@ -690,9 +693,9 @@ var TypeScriptAdapter = class {
       total_count: unique.length
     };
   }
-  async findImplementations(symbolName, path6, limit = 50, offset = 0) {
-    validateWorkspacePath(path6);
-    await this.ensureIndex(path6);
+  async findImplementations(symbolName, path7, limit = 50, offset = 0) {
+    validateWorkspacePath(path7);
+    await this.ensureIndex(path7);
     const hits = symbolIndex.lookup(symbolName);
     if (hits.length === 0) return { implementations: [], total_count: 0 };
     const hit = hits[0];
@@ -723,7 +726,7 @@ var TypeScriptAdapter = class {
         const { searchCode: searchCode2 } = await Promise.resolve().then(() => (init_search_code(), search_code_exports));
         const searchResults = await searchCode2(
           symbolName,
-          path6,
+          path7,
           "**/*.{ts,tsx,js,jsx}",
           1e3,
           false
@@ -902,33 +905,33 @@ var TypeScriptAdapter = class {
 var typescriptAdapter = new TypeScriptAdapter();
 
 // src/utils/tool-utils.ts
-async function wrapAdapterCall(methodName, symbol, path6, ...args) {
+async function wrapAdapterCall(methodName, symbol, path7, ...args) {
   const method = typescriptAdapter[methodName];
-  return await method.apply(typescriptAdapter, [symbol, path6, ...args]);
+  return await method.apply(typescriptAdapter, [symbol, path7, ...args]);
 }
 
 // src/tools/resolve-definition.ts
-async function resolveDefinition(symbol, path6) {
+async function resolveDefinition(symbol, path7) {
   return await wrapAdapterCall(
     "resolveDefinition",
     symbol,
-    path6
+    path7
   );
 }
 
 // src/tools/find-references.ts
 init_cjs_shims();
-async function findReferences(symbol, path6, limit = 50, offset = 0) {
-  return await wrapAdapterCall("findReferences", symbol, path6, limit, offset);
+async function findReferences(symbol, path7, limit = 50, offset = 0) {
+  return await wrapAdapterCall("findReferences", symbol, path7, limit, offset);
 }
 
 // src/tools/find-implementations.ts
 init_cjs_shims();
-async function findImplementations(symbol, path6, limit = 50, offset = 0) {
+async function findImplementations(symbol, path7, limit = 50, offset = 0) {
   return await wrapAdapterCall(
     "findImplementations",
     symbol,
-    path6,
+    path7,
     limit,
     offset
   );
@@ -975,8 +978,8 @@ async function getSymbolDocs(symbol, filePath) {
 
 // src/tools/build-symbol-index.ts
 init_cjs_shims();
-async function buildSymbolIndex(path6) {
-  return await symbolIndex.buildIndex(path6);
+async function buildSymbolIndex(path7) {
+  return await symbolIndex.buildIndex(path7);
 }
 
 // src/tools/call-hierarchy.ts
@@ -1136,6 +1139,117 @@ async function checkSymbolGrounding(symbol, filePath) {
   };
 }
 
+// src/tools/codebase-audit.ts
+init_cjs_shims();
+var import_child_process2 = require("child_process");
+var import_util2 = require("util");
+var import_ripgrep2 = require("@vscode/ripgrep");
+var fs4 = __toESM(require("fs"), 1);
+var path6 = __toESM(require("path"), 1);
+init_security();
+var execFileAsync2 = (0, import_util2.promisify)(import_child_process2.execFile);
+async function codebaseAudit(rootDir) {
+  const safePath = validateWorkspacePath(rootDir);
+  let debtMarkers = 0;
+  try {
+    const { stdout } = await execFileAsync2(import_ripgrep2.rgPath, [
+      "--count-matches",
+      "--fixed-strings",
+      "-e",
+      "TODO",
+      "-e",
+      "FIXME",
+      "--glob",
+      "!**/node_modules/**",
+      "--glob",
+      "!**/.git/**",
+      "--glob",
+      "!**/dist/**",
+      safePath
+    ]);
+    const lines = stdout.split("\n").filter(Boolean);
+    for (const line of lines) {
+      const match = line.match(/:(\d+)$/);
+      if (match) {
+        debtMarkers += parseInt(match[1], 10);
+      }
+    }
+  } catch (error) {
+    if (error.code !== 1) {
+      console.error("[Audit] Error counting debt markers:", error);
+    }
+  }
+  const emptyDirs = [];
+  const scanEmpty = (dir) => {
+    const files = fs4.readdirSync(dir);
+    if (files.length === 0) {
+      emptyDirs.push(path6.relative(safePath, dir));
+      return;
+    }
+    for (const file of files) {
+      const fullPath = path6.join(dir, file);
+      if (fs4.statSync(fullPath).isDirectory()) {
+        if (["node_modules", ".git", "dist", ".sst", ".turbo", ".next"].includes(
+          file
+        ))
+          continue;
+        scanEmpty(fullPath);
+      }
+    }
+  };
+  scanEmpty(safePath);
+  const orphanedFiles = [];
+  const allFiles = [];
+  const collectFiles = (dir) => {
+    const files = fs4.readdirSync(dir);
+    for (const file of files) {
+      const fullPath = path6.join(dir, file);
+      if (fs4.statSync(fullPath).isDirectory()) {
+        if (["node_modules", ".git", "dist", ".sst", ".turbo", ".next"].includes(
+          file
+        ))
+          continue;
+        collectFiles(fullPath);
+      } else if (file.endsWith(".ts") || file.endsWith(".js") || file.endsWith(".tsx") || file.endsWith(".jsx")) {
+        allFiles.push(fullPath);
+      }
+    }
+  };
+  collectFiles(safePath);
+  for (const file of allFiles) {
+    const base = path6.basename(file, path6.extname(file));
+    if (base === "index" || base.endsWith(".test") || base.endsWith(".spec") || base === "sst.config")
+      continue;
+    let referenced = false;
+    try {
+      const { status } = await execFileAsync2(import_ripgrep2.rgPath, [
+        "--quiet",
+        "--fixed-strings",
+        "--word-regexp",
+        "--glob",
+        `!${path6.relative(safePath, file)}`,
+        "--glob",
+        "!**/node_modules/**",
+        "--glob",
+        "!**/.git/**",
+        base,
+        safePath
+      ]);
+      if (status === 0) referenced = true;
+    } catch (e) {
+      if (e.code === 0) referenced = true;
+    }
+    if (!referenced) {
+      orphanedFiles.push(path6.relative(safePath, file));
+    }
+  }
+  return {
+    debtMarkers,
+    emptyDirs,
+    orphanedFiles
+  };
+}
+
 // src/index.ts
 var import_types2 = require("@modelcontextprotocol/sdk/types.js");
 var ASTExplorerServer = class {
@@ -1321,6 +1435,20 @@ var ASTExplorerServer = class {
               },
               required: ["symbol", "path"]
             }
+          },
+          {
+            name: "codebase_audit",
+            description: "Performs a codebase-level audit for technical debt (TODOs) and bloat (empty dirs, orphans).",
+            inputSchema: {
+              type: "object",
+              properties: {
+                path: {
+                  type: "string",
+                  description: "Project root directory to audit"
+                }
+              },
+              required: ["path"]
+            }
           }
         ]
       };
@@ -1330,8 +1458,8 @@ var ASTExplorerServer = class {
       try {
         switch (name) {
           case "resolve_definition": {
-            const { symbol, path: path6 } = ResolveDefinitionSchema.parse(args);
-            const results = await resolveDefinition(symbol, path6);
+            const { symbol, path: path7 } = ResolveDefinitionSchema.parse(args);
+            const results = await resolveDefinition(symbol, path7);
             return {
               content: [
                 { type: "text", text: JSON.stringify(results, null, 2) }
@@ -1339,8 +1467,8 @@ var ASTExplorerServer = class {
             };
           }
           case "find_references": {
-            const { symbol, path: path6, limit, offset } = FindReferencesSchema.parse(args);
-            const results = await findReferences(symbol, path6, limit, offset);
+            const { symbol, path: path7, limit, offset } = FindReferencesSchema.parse(args);
+            const results = await findReferences(symbol, path7, limit, offset);
             return {
               content: [
                 { type: "text", text: JSON.stringify(results, null, 2) }
@@ -1348,10 +1476,10 @@ var ASTExplorerServer = class {
             };
           }
           case "find_implementations": {
-            const { symbol, path: path6, limit, offset } = FindImplementationsSchema.parse(args);
+            const { symbol, path: path7, limit, offset } = FindImplementationsSchema.parse(args);
             const results = await findImplementations(
               symbol,
-              path6,
+              path7,
               limit,
               offset
             );
@@ -1371,10 +1499,10 @@ var ASTExplorerServer = class {
             };
           }
           case "search_code": {
-            const { pattern, path: path6, filePattern, limit, offset, regex } = SearchCodeSchema.parse(args);
+            const { pattern, path: path7, filePattern, limit, offset, regex } = SearchCodeSchema.parse(args);
             const results = await searchCode(
               pattern,
-              path6,
+              path7,
               filePattern,
               limit,
               regex,
@@ -1387,22 +1515,22 @@ var ASTExplorerServer = class {
             };
           }
           case "get_symbol_docs": {
-            const { symbol, path: path6 } = GetSymbolDocsSchema.parse(args);
-            const docs = await getSymbolDocs(symbol, path6);
+            const { symbol, path: path7 } = GetSymbolDocsSchema.parse(args);
+            const docs = await getSymbolDocs(symbol, path7);
             return {
               content: [{ type: "text", text: JSON.stringify(docs, null, 2) }]
             };
           }
           case "build_symbol_index": {
-            const { path: path6 } = BuildSymbolIndexSchema.parse(args);
-            const stats = await buildSymbolIndex(path6);
+            const { path: path7 } = BuildSymbolIndexSchema.parse(args);
+            const stats = await buildSymbolIndex(path7);
             return {
               content: [{ type: "text", text: JSON.stringify(stats, null, 2) }]
             };
           }
           case "get_call_hierarchy": {
-            const { symbol, path: path6, direction } = GetCallHierarchySchema.parse(args);
-            const hierarchy = await getCallHierarchy(symbol, path6, direction);
+            const { symbol, path: path7, direction } = GetCallHierarchySchema.parse(args);
+            const hierarchy = await getCallHierarchy(symbol, path7, direction);
             return {
               content: [
                 { type: "text", text: JSON.stringify(hierarchy, null, 2) }
@@ -1410,8 +1538,17 @@ var ASTExplorerServer = class {
             };
           }
           case "check_symbol_grounding": {
-            const { symbol, path: path6 } = CheckSymbolGroundingSchema.parse(args);
-            const result = await checkSymbolGrounding(symbol, path6);
+            const { symbol, path: path7 } = CheckSymbolGroundingSchema.parse(args);
+            const result = await checkSymbolGrounding(symbol, path7);
+            return {
+              content: [
+                { type: "text", text: JSON.stringify(result, null, 2) }
+              ]
+            };
+          }
+          case "codebase_audit": {
+            const { path: path7 } = CodebaseAuditSchema.parse(args);
+            const result = await codebaseAudit(path7);
             return {
               content: [
                 { type: "text", text: JSON.stringify(result, null, 2) }