@aiready/ast-mcp-server 0.8.0 → 0.8.2

package/dist/chunk-EHE3VUUP.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+// src/security.ts
+import path from "path";
+function resolveWorkspaceRoot() {
+  return process.env.AST_WORKSPACE_ROOT || process.cwd();
+}
+function validateWorkspacePath(inputPath) {
+  const root = resolveWorkspaceRoot();
+  const resolved = path.resolve(root, inputPath);
+  const normalized = path.normalize(resolved);
+  if (!normalized.startsWith(root)) {
+    throw new Error(
+      `Path traversal detected: ${inputPath} escapes workspace root`
+    );
+  }
+  if (normalized.includes("\0")) {
+    throw new Error("Path contains null bytes");
+  }
+  return normalized;
+}
+
+export {
+  validateWorkspacePath
+};
+//# sourceMappingURL=chunk-EHE3VUUP.js.map

package/dist/chunk-EHE3VUUP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/security.ts"],"sourcesContent":["import path from 'path';\nimport fs from 'fs';\n\nexport function resolveWorkspaceRoot(): string {\n  return process.env.AST_WORKSPACE_ROOT || process.cwd();\n}\n\nexport function validateWorkspacePath(inputPath: string): string {\n  const root = resolveWorkspaceRoot();\n  const resolved = path.resolve(root, inputPath);\n  const normalized = path.normalize(resolved);\n\n  // Reject path traversal\n  if (!normalized.startsWith(root)) {\n    throw new Error(\n      `Path traversal detected: ${inputPath} escapes workspace root`\n    );\n  }\n\n  // Reject null bytes\n  if (normalized.includes('\\0')) {\n    throw new Error('Path contains null bytes');\n  }\n\n  return normalized;\n}\n\nexport function validateFileExists(filePath: string): string {\n  const safe = validateWorkspacePath(filePath);\n  if (!fs.existsSync(safe)) {\n    throw new Error(`File not found: ${filePath}`);\n  }\n  if (!fs.statSync(safe).isFile()) {\n    throw new Error(`Not a file: ${filePath}`);\n  }\n  return safe;\n}\n"],"mappings":";;;AAAA,OAAO,UAAU;AAGV,SAAS,uBAA+B;AAC7C,SAAO,QAAQ,IAAI,sBAAsB,QAAQ,IAAI;AACvD;AAEO,SAAS,sBAAsB,WAA2B;AAC/D,QAAM,OAAO,qBAAqB;AAClC,QAAM,WAAW,KAAK,QAAQ,MAAM,SAAS;AAC7C,QAAM,aAAa,KAAK,UAAU,QAAQ;AAG1C,MAAI,CAAC,WAAW,WAAW,IAAI,GAAG;AAChC,UAAM,IAAI;AAAA,MACR,4BAA4B,SAAS;AAAA,IACvC;AAAA,EACF;AAGA,MAAI,WAAW,SAAS,IAAI,GAAG;AAC7B,UAAM,IAAI,MAAM,0BAA0B;AAAA,EAC5C;AAEA,SAAO;AACT;","names":[]}

package/dist/index.cjs

@@ -162,6 +162,16 @@ var FindImplementationsSchema = import_zod.z.object({
 var GetFileStructureSchema = import_zod.z.object({
   file: import_zod.z.string().describe("Absolute path to the file to analyze")
 });
+var GrepSearchSchema = import_zod.z.object({
+  pattern: import_zod.z.string().describe("Search pattern (regex by default)"),
+  path: import_zod.z.string().describe("Directory to search in"),
+  include: import_zod.z.array(import_zod.z.string()).optional().describe('Include only these glob patterns (e.g., ["*.ts", "src/**"])'),
+  exclude: import_zod.z.array(import_zod.z.string()).optional().describe('Exclude these glob patterns (e.g., ["**/*.test.ts"])'),
+  limit: import_zod.z.number().optional().default(50).describe("Max matches to return (default 50)"),
+  offset: import_zod.z.number().optional().default(0).describe("Pagination offset (default 0)"),
+  context: import_zod.z.number().optional().default(2).describe("Number of context lines before and after (default 2)"),
+  isRegex: import_zod.z.boolean().optional().default(true).describe("Use regex mode (default true)")
+});
 var SearchCodeSchema = import_zod.z.object({
   pattern: import_zod.z.string().describe("Search pattern (regex by default)"),
   path: import_zod.z.string().describe("Directory to search in"),
@@ -587,9 +597,9 @@ var TypeScriptAdapter = class {
       await symbolIndex.buildIndex(searchPath);
     }
   }
-  async resolveDefinition(symbolName, path7) {
-    validateWorkspacePath(path7);
-    await this.ensureIndex(path7);
+  async resolveDefinition(symbolName, path6) {
+    validateWorkspacePath(path6);
+    await this.ensureIndex(path6);
     const indexHits = symbolIndex.lookup(symbolName);
     if (indexHits.length > 0) {
       const results = [];
@@ -617,33 +627,33 @@ var TypeScriptAdapter = class {
       }
       return results;
     }
-    if (import_fs3.default.statSync(path7).isDirectory()) {
+    if (import_fs3.default.statSync(path6).isDirectory()) {
       return [];
     }
-    const tsconfig = await projectManager.findNearestTsConfig(path7);
+    const tsconfig = await projectManager.findNearestTsConfig(path6);
     if (!tsconfig) return [];
     try {
       const result = await this.pool.execute(
         "resolve_definition",
         {
           tsconfig,
-          file: path7,
+          file: path6,
           symbol: symbolName
         }
       );
       return result;
     } catch {
       const project = projectManager.ensureProject(tsconfig);
-      const sourceFile = project.addSourceFileAtPathIfExists(path7);
+      const sourceFile = project.addSourceFileAtPathIfExists(path6);
       if (!sourceFile) return [];
       const exported = sourceFile.getExportedDeclarations().get(symbolName);
       if (!exported) return [];
       return exported.map((decl) => this.mapToDefinitionLocation(decl));
     }
   }
-  async findReferences(symbolName, path7, limit = 50, offset = 0) {
-    validateWorkspacePath(path7);
-    await this.ensureIndex(path7);
+  async findReferences(symbolName, path6, limit = 50, offset = 0) {
+    validateWorkspacePath(path6);
+    await this.ensureIndex(path6);
     const hits = symbolIndex.lookup(symbolName);
     if (hits.length === 0) return { references: [], total_count: 0 };
     const hit = hits[0];
@@ -656,7 +666,7 @@ var TypeScriptAdapter = class {
       const { searchCode: searchCode2 } = await Promise.resolve().then(() => (init_search_code(), search_code_exports));
       const searchResults = await searchCode2(
         symbolName,
-        path7,
+        path6,
         "**/*.{ts,tsx,js,jsx}",
         1e3,
         false
@@ -693,9 +703,9 @@ var TypeScriptAdapter = class {
       total_count: unique.length
     };
   }
-  async findImplementations(symbolName, path7, limit = 50, offset = 0) {
-    validateWorkspacePath(path7);
-    await this.ensureIndex(path7);
+  async findImplementations(symbolName, path6, limit = 50, offset = 0) {
+    validateWorkspacePath(path6);
+    await this.ensureIndex(path6);
     const hits = symbolIndex.lookup(symbolName);
     if (hits.length === 0) return { implementations: [], total_count: 0 };
     const hit = hits[0];
@@ -726,7 +736,7 @@ var TypeScriptAdapter = class {
         const { searchCode: searchCode2 } = await Promise.resolve().then(() => (init_search_code(), search_code_exports));
         const searchResults = await searchCode2(
           symbolName,
-          path7,
+          path6,
           "**/*.{ts,tsx,js,jsx}",
           1e3,
           false
@@ -905,33 +915,33 @@ var TypeScriptAdapter = class {
 var typescriptAdapter = new TypeScriptAdapter();
 
 // src/utils/tool-utils.ts
-async function wrapAdapterCall(methodName, symbol, path7, ...args) {
+async function wrapAdapterCall(methodName, symbol, path6, ...args) {
   const method = typescriptAdapter[methodName];
-  return await method.apply(typescriptAdapter, [symbol, path7, ...args]);
+  return await method.apply(typescriptAdapter, [symbol, path6, ...args]);
 }
 
 // src/tools/resolve-definition.ts
-async function resolveDefinition(symbol, path7) {
+async function resolveDefinition(symbol, path6) {
   return await wrapAdapterCall(
     "resolveDefinition",
     symbol,
-    path7
+    path6
   );
 }
 
 // src/tools/find-references.ts
 init_cjs_shims();
-async function findReferences(symbol, path7, limit = 50, offset = 0) {
-  return await wrapAdapterCall("findReferences", symbol, path7, limit, offset);
+async function findReferences(symbol, path6, limit = 50, offset = 0) {
+  return await wrapAdapterCall("findReferences", symbol, path6, limit, offset);
 }
 
 // src/tools/find-implementations.ts
 init_cjs_shims();
-async function findImplementations(symbol, path7, limit = 50, offset = 0) {
+async function findImplementations(symbol, path6, limit = 50, offset = 0) {
   return await wrapAdapterCall(
     "findImplementations",
     symbol,
-    path7,
+    path6,
     limit,
     offset
   );
@@ -944,7 +954,7 @@ async function getFileStructure(file) {
 }
 
 // src/index.ts
-init_search_code();
+var import_core = require("@aiready/core");
 
 // src/tools/get-symbol-docs.ts
 init_cjs_shims();
@@ -978,8 +988,8 @@ async function getSymbolDocs(symbol, filePath) {
 
 // src/tools/build-symbol-index.ts
 init_cjs_shims();
-async function buildSymbolIndex(path7) {
-  return await symbolIndex.buildIndex(path7);
+async function buildSymbolIndex(path6) {
+  return await symbolIndex.buildIndex(path6);
 }
 
 // src/tools/call-hierarchy.ts
@@ -1139,117 +1149,6 @@ 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 {
@@ -1368,9 +1267,35 @@ var ASTExplorerServer = class {
               required: ["file"]
             }
           },
+          {
+            name: "grep_search",
+            description: "Fast, context-aware text search via ripgrep. Supports context lines and result summarization.",
+            inputSchema: {
+              type: "object",
+              properties: {
+                pattern: { type: "string", description: "Search pattern" },
+                path: { type: "string", description: "Directory to search" },
+                include: {
+                  type: "array",
+                  items: { type: "string" },
+                  description: "Glob filter"
+                },
+                exclude: {
+                  type: "array",
+                  items: { type: "string" },
+                  description: "Exclusion filter"
+                },
+                limit: { type: "number", default: 50 },
+                offset: { type: "number", default: 0 },
+                context: { type: "number", default: 2 },
+                isRegex: { type: "boolean", default: true }
+              },
+              required: ["pattern", "path"]
+            }
+          },
           {
             name: "search_code",
-            description: "Fast regex search via bundled ripgrep.",
+            description: "Fast regex search via bundled ripgrep (alias for grep_search).",
             inputSchema: {
               type: "object",
               properties: {
@@ -1437,8 +1362,8 @@ var ASTExplorerServer = class {
             }
           },
           {
-            name: "codebase_audit",
-            description: "Performs a codebase-level audit for technical debt (TODOs) and bloat (empty dirs, orphans).",
+            name: "hygiene_audit",
+            description: "Performs a codebase-level hygiene check for technical debt (TODOs) and waste (empty dirs, orphans).",
             inputSchema: {
               type: "object",
               properties: {
@@ -1449,6 +1374,28 @@ var ASTExplorerServer = class {
               },
               required: ["path"]
             }
+          },
+          {
+            name: "metabolism_audit",
+            description: "Alias for hygiene_audit (Serverless Claw compat).",
+            inputSchema: {
+              type: "object",
+              properties: {
+                path: { type: "string" }
+              },
+              required: ["path"]
+            }
+          },
+          {
+            name: "codebase_audit",
+            description: "Alias for hygiene_audit.",
+            inputSchema: {
+              type: "object",
+              properties: {
+                path: { type: "string" }
+              },
+              required: ["path"]
+            }
           }
         ]
       };
@@ -1458,8 +1405,8 @@ var ASTExplorerServer = class {
       try {
         switch (name) {
           case "resolve_definition": {
-            const { symbol, path: path7 } = ResolveDefinitionSchema.parse(args);
-            const results = await resolveDefinition(symbol, path7);
+            const { symbol, path: path6 } = ResolveDefinitionSchema.parse(args);
+            const results = await resolveDefinition(symbol, path6);
             return {
               content: [
                 { type: "text", text: JSON.stringify(results, null, 2) }
@@ -1467,8 +1414,8 @@ var ASTExplorerServer = class {
             };
           }
           case "find_references": {
-            const { symbol, path: path7, limit, offset } = FindReferencesSchema.parse(args);
-            const results = await findReferences(symbol, path7, limit, offset);
+            const { symbol, path: path6, limit, offset } = FindReferencesSchema.parse(args);
+            const results = await findReferences(symbol, path6, limit, offset);
             return {
               content: [
                 { type: "text", text: JSON.stringify(results, null, 2) }
@@ -1476,10 +1423,10 @@ var ASTExplorerServer = class {
             };
           }
           case "find_implementations": {
-            const { symbol, path: path7, limit, offset } = FindImplementationsSchema.parse(args);
+            const { symbol, path: path6, limit, offset } = FindImplementationsSchema.parse(args);
             const results = await findImplementations(
               symbol,
-              path7,
+              path6,
               limit,
               offset
             );
@@ -1498,39 +1445,67 @@ var ASTExplorerServer = class {
               ]
             };
           }
+          case "grep_search": {
+            const {
+              pattern,
+              path: path6,
+              include,
+              exclude,
+              limit,
+              offset,
+              context,
+              isRegex
+            } = GrepSearchSchema.parse(args);
+            const result = await (0, import_core.grepSearch)({
+              pattern,
+              path: path6,
+              include,
+              exclude,
+              limit,
+              offset,
+              context,
+              isRegex
+            });
+            return {
+              content: [
+                { type: "text", text: JSON.stringify(result, null, 2) }
+              ]
+            };
+          }
           case "search_code": {
-            const { pattern, path: path7, filePattern, limit, offset, regex } = SearchCodeSchema.parse(args);
-            const results = await searchCode(
+            const { pattern, path: path6, filePattern, limit, offset, regex } = SearchCodeSchema.parse(args);
+            const result = await (0, import_core.grepSearch)({
               pattern,
-              path7,
-              filePattern,
+              path: path6,
+              include: filePattern ? [filePattern] : [],
               limit,
-              regex,
-              offset
-            );
+              offset,
+              isRegex: regex,
+              context: 0
+            });
             return {
               content: [
-                { type: "text", text: JSON.stringify(results, null, 2) }
+                { type: "text", text: JSON.stringify(result, null, 2) }
               ]
             };
           }
           case "get_symbol_docs": {
-            const { symbol, path: path7 } = GetSymbolDocsSchema.parse(args);
-            const docs = await getSymbolDocs(symbol, path7);
+            const { symbol, path: path6 } = GetSymbolDocsSchema.parse(args);
+            const docs = await getSymbolDocs(symbol, path6);
             return {
               content: [{ type: "text", text: JSON.stringify(docs, null, 2) }]
             };
           }
           case "build_symbol_index": {
-            const { path: path7 } = BuildSymbolIndexSchema.parse(args);
-            const stats = await buildSymbolIndex(path7);
+            const { path: path6 } = BuildSymbolIndexSchema.parse(args);
+            const stats = await buildSymbolIndex(path6);
             return {
               content: [{ type: "text", text: JSON.stringify(stats, null, 2) }]
             };
           }
           case "get_call_hierarchy": {
-            const { symbol, path: path7, direction } = GetCallHierarchySchema.parse(args);
-            const hierarchy = await getCallHierarchy(symbol, path7, direction);
+            const { symbol, path: path6, direction } = GetCallHierarchySchema.parse(args);
+            const hierarchy = await getCallHierarchy(symbol, path6, direction);
             return {
               content: [
                 { type: "text", text: JSON.stringify(hierarchy, null, 2) }
@@ -1538,21 +1513,38 @@ var ASTExplorerServer = class {
             };
           }
           case "check_symbol_grounding": {
-            const { symbol, path: path7 } = CheckSymbolGroundingSchema.parse(args);
-            const result = await checkSymbolGrounding(symbol, path7);
+            const { symbol, path: path6 } = CheckSymbolGroundingSchema.parse(args);
+            const result = await checkSymbolGrounding(symbol, path6);
             return {
               content: [
                 { type: "text", text: JSON.stringify(result, null, 2) }
               ]
             };
           }
+          case "hygiene_audit":
+          case "metabolism_audit":
           case "codebase_audit": {
-            const { path: path7 } = CodebaseAuditSchema.parse(args);
-            const result = await codebaseAudit(path7);
+            const { path: rootDir } = CodebaseAuditSchema.parse(args);
+            const { HygieneAuditProvider } = await import("@aiready/hygiene-audit");
+            const provider = new HygieneAuditProvider();
+            const result = await provider.analyze({ rootDir });
+            const allIssues = result.results.flatMap((r) => r.issues);
+            const metadata = {
+              debtMarkers: result.metadata?.debtMarkers || 0,
+              emptyDirs: result.metadata?.emptyDirs || [],
+              orphanedFiles: result.metadata?.orphanedFiles || [],
+              findings: allIssues.map((i) => ({
+                expected: i.recommendation || i.suggestion || "",
+                actual: i.message,
+                severity: i.severity === "critical" ? "P0" : i.severity === "major" ? "P1" : "P2",
+                recommendation: i.recommendation || i.suggestion || ""
+              }))
+            };
             return {
               content: [
                 { type: "text", text: JSON.stringify(result, null, 2) }
-              ]
+              ],
+              metadata
             };
           }
           default: