@prosdevlab/dev-agent 0.10.2 → 0.10.4

package/dist/mcp.js

@@ -20005,6 +20005,35 @@ var init_vector = __esm({
         this.assertReady();
         return this.store.getAll(options);
       }
+      /**
+       * Get indexed documents grouped by file path.
+       *
+       * Uses getAll with a capped limit + client-side exact path filter.
+       * More reliable than BM25 search which tokenizes paths unpredictably.
+       *
+       * Note: Fetches up to 5,000 docs client-side. Fine for single repos,
+       * won't scale to monorepos with 50k+ files. See .claude/scratchpad.md.
+       */
+      async getDocsByFilePath(filePaths) {
+        this.assertReady();
+        const DOC_LIMIT = 5e3;
+        const pathSet = new Set(filePaths);
+        const allDocs = await this.getAll({ limit: DOC_LIMIT });
+        if (allDocs.length >= DOC_LIMIT) {
+          console.error(
+            `[dev-agent] Warning: getDocsByFilePath hit ${DOC_LIMIT} doc limit. Some files may be missing.`
+          );
+        }
+        const byFile = /* @__PURE__ */ new Map();
+        for (const doc of allDocs) {
+          const docPath = doc.metadata.path;
+          if (pathSet.has(docPath)) {
+            if (!byFile.has(docPath)) byFile.set(docPath, []);
+            byFile.get(docPath).push(doc);
+          }
+        }
+        return byFile;
+      }
       /**
        * Get a document by ID
        */
@@ -38492,6 +38521,44 @@ var init_test_utils = __esm({
 });
 
 // ../core/src/services/pattern-analysis-service.ts
+function extractImportStyleFromContent(content3) {
+  const esmImports = content3.match(/^import\s/gm) || [];
+  const cjsImports = content3.match(/require\s*\(/g) || [];
+  const hasESM = esmImports.length > 0;
+  const hasCJS = cjsImports.length > 0;
+  if (!hasESM && !hasCJS) return { style: "unknown", importCount: 0 };
+  const importCount = esmImports.length + cjsImports.length;
+  const style = hasESM && hasCJS ? "mixed" : hasESM ? "esm" : "cjs";
+  return { style, importCount };
+}
+function extractErrorHandlingFromContent(content3) {
+  const counts = {
+    throw: [...content3.matchAll(/throw\s+new\s+\w*Error/g)].length,
+    result: [...content3.matchAll(/Result<|{\s*ok:\s*(true|false)/g)].length,
+    errorReturn: [...content3.matchAll(/\)\s*:\s*\([^)]*,\s*error\)/g)].length
+  };
+  const total = counts.throw + counts.result + counts.errorReturn;
+  if (total === 0) return { style: "unknown", examples: [] };
+  const max = Math.max(counts.throw, counts.result, counts.errorReturn);
+  const hasMultiple = Object.values(counts).filter((c) => c > 0).length > 1;
+  let style = "unknown";
+  if (hasMultiple) style = "mixed";
+  else if (counts.throw === max) style = "throw";
+  else if (counts.result === max) style = "result";
+  else if (counts.errorReturn === max) style = "error-return";
+  return { style, examples: [] };
+}
+function extractTypeCoverageFromSignatures(signatures) {
+  if (signatures.length === 0) return { coverage: "none", annotatedCount: 0, totalCount: 0 };
+  const annotated = signatures.filter((sig) => /(\)|=>)\s*:\s*\w+/.test(sig));
+  const ratio = annotated.length / signatures.length;
+  let coverage;
+  if (ratio >= 0.9) coverage = "full";
+  else if (ratio >= 0.5) coverage = "partial";
+  else if (ratio > 0) coverage = "minimal";
+  else coverage = "none";
+  return { coverage, annotatedCount: annotated.length, totalCount: signatures.length };
+}
 var fs9, path13, PatternAnalysisService;
 var init_pattern_analysis_service = __esm({
   "../core/src/services/pattern-analysis-service.ts"() {
@@ -38519,38 +38586,72 @@ var init_pattern_analysis_service = __esm({
         return this.analyzeFileWithDocs(filePath, documents);
       }
       /**
-       * Compare patterns between target file and similar files
+       * Analyze file patterns using indexed metadata (fast — no ts-morph).
        *
-       * OPTIMIZED: Batch scans all files in one pass to avoid repeated ts-morph initialization
+       * Reads signatures from the Antfly index, content from disk (for line count
+       * and error handling regex). Falls back gracefully on ENOENT (deleted file).
+       */
+      async analyzeFileFromIndex(filePath, indexedDocs) {
+        const fullPath = path13.join(this.config.repositoryPath, filePath);
+        let content3 = "";
+        let bytes = 0;
+        let lines = 0;
+        try {
+          const [fileContent, stat2] = await Promise.all([
+            fs9.readFile(fullPath, "utf-8"),
+            fs9.stat(fullPath)
+          ]);
+          content3 = fileContent;
+          bytes = stat2.size;
+          lines = content3.split("\n").length;
+        } catch (error46) {
+          if (error46.code !== "ENOENT") throw error46;
+        }
+        const testing = await this.analyzeTesting(filePath);
+        const signatures = indexedDocs.filter((d) => d.metadata.type === "function" || d.metadata.type === "method").map((d) => d.metadata.signature || "").filter(Boolean);
+        return {
+          fileSize: { lines, bytes },
+          testing,
+          importStyle: extractImportStyleFromContent(content3),
+          errorHandling: extractErrorHandlingFromContent(content3),
+          typeAnnotations: extractTypeCoverageFromSignatures(signatures)
+        };
+      }
+      /**
+       * Compare patterns between target file and similar files
        *
-       * @param targetFile - Target file to analyze
-       * @param similarFiles - Array of similar file paths
-       * @returns Pattern comparison results
+       * Uses Antfly index when vectorStorage is available (fast path, ~100ms).
+       * Falls back to ts-morph scanning when not (tests, offline).
        */
       async comparePatterns(targetFile, similarFiles) {
         const allFiles = [targetFile, ...similarFiles];
-        const batchResult = await scanRepository({
-          repoRoot: this.config.repositoryPath,
-          include: allFiles
-        });
-        const docsByFile = /* @__PURE__ */ new Map();
-        for (const doc of batchResult.documents) {
-          const file2 = doc.metadata.file;
-          if (!docsByFile.has(file2)) {
-            docsByFile.set(file2, []);
-          }
-          const docs = docsByFile.get(file2);
-          if (docs) {
-            docs.push(doc);
-          }
+        let targetPatterns;
+        let similarPatterns;
+        if (this.config.vectorStorage) {
+          const docsByFile = await this.config.vectorStorage.getDocsByFilePath(allFiles);
+          targetPatterns = await this.analyzeFileFromIndex(
+            targetFile,
+            docsByFile.get(targetFile) || []
+          );
+          similarPatterns = await Promise.all(
+            similarFiles.map((f) => this.analyzeFileFromIndex(f, docsByFile.get(f) || []))
+          );
+        } else {
+          const batchResult = await scanRepository({
+            repoRoot: this.config.repositoryPath,
+            include: allFiles
+          });
+          const docsByFile = /* @__PURE__ */ new Map();
+          for (const doc of batchResult.documents) {
+            const file2 = doc.metadata.file;
+            if (!docsByFile.has(file2)) docsByFile.set(file2, []);
+            docsByFile.get(file2).push(doc);
+          }
+          targetPatterns = await this.analyzeFileWithDocs(targetFile, docsByFile.get(targetFile) || []);
+          similarPatterns = await Promise.all(
+            similarFiles.map((f) => this.analyzeFileWithDocs(f, docsByFile.get(f) || []))
+          );
         }
-        const targetPatterns = await this.analyzeFileWithDocs(
-          targetFile,
-          docsByFile.get(targetFile) || []
-        );
-        const similarPatterns = await Promise.all(
-          similarFiles.map((f) => this.analyzeFileWithDocs(f, docsByFile.get(f) || []))
-        );
         return {
           fileSize: this.compareFileSize(
             targetPatterns.fileSize,
@@ -38575,34 +38676,26 @@ var init_pattern_analysis_service = __esm({
         };
       }
       /**
-       * Analyze file patterns using pre-scanned documents (faster)
-       *
-       * @param filePath - Relative path from repository root
-       * @param documents - Pre-scanned documents for this file
-       * @returns Pattern analysis results
+       * Analyze file patterns using pre-scanned documents (fallback path).
        */
       async analyzeFileWithDocs(filePath, documents) {
         const fullPath = path13.join(this.config.repositoryPath, filePath);
-        const [stat2, content3] = await Promise.all([fs9.stat(fullPath), fs9.readFile(fullPath, "utf-8")]);
-        const lines = content3.split("\n").length;
+        const [content3, stat2, testing] = await Promise.all([
+          fs9.readFile(fullPath, "utf-8"),
+          fs9.stat(fullPath),
+          this.analyzeTesting(filePath)
+        ]);
+        const signatures = documents.filter((d) => d.type === "function" || d.type === "method").map((d) => d.metadata.signature || "").filter(Boolean);
         return {
-          fileSize: {
-            lines,
-            bytes: stat2.size
-          },
-          testing: await this.analyzeTesting(filePath),
-          importStyle: await this.analyzeImportsFromFile(filePath, documents),
-          errorHandling: this.analyzeErrorHandling(content3),
-          typeAnnotations: this.analyzeTypes(documents)
+          fileSize: { lines: content3.split("\n").length, bytes: stat2.size },
+          testing,
+          importStyle: extractImportStyleFromContent(content3),
+          errorHandling: extractErrorHandlingFromContent(content3),
+          typeAnnotations: extractTypeCoverageFromSignatures(signatures)
         };
       }
-      // ========================================================================
-      // Pattern Extractors (MVP: 5 core patterns)
-      // ========================================================================
       /**
        * Analyze test coverage for a file
-       *
-       * Checks for co-located test files (*.test.*, *.spec.*)
        */
       async analyzeTesting(filePath) {
         if (isTestFile(filePath)) {
@@ -38614,109 +38707,6 @@ var init_pattern_analysis_service = __esm({
           testPath: testFile || void 0
         };
       }
-      /**
-       * Analyze import style from documents
-       *
-       * Always uses content analysis for reliability (scanner may not extract imports from all files).
-       */
-      async analyzeImportsFromFile(filePath, _documents) {
-        const fullPath = path13.join(this.config.repositoryPath, filePath);
-        const content3 = await fs9.readFile(fullPath, "utf-8");
-        return this.analyzeImportsFromContent(content3);
-      }
-      /**
-       * Analyze imports from raw file content (fallback method)
-       */
-      analyzeImportsFromContent(content3) {
-        const esmImports = content3.match(/^import\s/gm) || [];
-        const cjsImports = content3.match(/require\s*\(/g) || [];
-        const hasESM = esmImports.length > 0;
-        const hasCJS = cjsImports.length > 0;
-        if (!hasESM && !hasCJS) {
-          return { style: "unknown", importCount: 0 };
-        }
-        const importCount = esmImports.length + cjsImports.length;
-        let style;
-        if (hasESM && hasCJS) {
-          style = "mixed";
-        } else if (hasESM) {
-          style = "esm";
-        } else {
-          style = "cjs";
-        }
-        return { style, importCount };
-      }
-      /**
-       * Analyze error handling patterns in file content
-       *
-       * Detects: throw, Result<T>, error returns (Go style)
-       */
-      analyzeErrorHandling(content3) {
-        const patterns = {
-          throw: /throw\s+new\s+\w*Error/g,
-          result: /Result<|{\s*ok:\s*(true|false)/g,
-          errorReturn: /\)\s*:\s*\([^)]*,\s*error\)/g
-          // Go: (val, error)
-        };
-        const matches = {
-          throw: [...content3.matchAll(patterns.throw)],
-          result: [...content3.matchAll(patterns.result)],
-          errorReturn: [...content3.matchAll(patterns.errorReturn)]
-        };
-        const counts = {
-          throw: matches.throw.length,
-          result: matches.result.length,
-          errorReturn: matches.errorReturn.length
-        };
-        const total = counts.throw + counts.result + counts.errorReturn;
-        if (total === 0) {
-          return { style: "unknown", examples: [] };
-        }
-        const max = Math.max(counts.throw, counts.result, counts.errorReturn);
-        const hasMultiple = Object.values(counts).filter((c) => c > 0).length > 1;
-        let style = "unknown";
-        if (hasMultiple) {
-          style = "mixed";
-        } else if (counts.throw === max) {
-          style = "throw";
-        } else if (counts.result === max) {
-          style = "result";
-        } else if (counts.errorReturn === max) {
-          style = "error-return";
-        }
-        return { style, examples: [] };
-      }
-      /**
-       * Analyze type annotation coverage from documents
-       *
-       * Checks function/method signatures for explicit types.
-       */
-      analyzeTypes(documents) {
-        const functions = documents.filter((d) => d.type === "function" || d.type === "method");
-        if (functions.length === 0) {
-          return { coverage: "none", annotatedCount: 0, totalCount: 0 };
-        }
-        const annotated = functions.filter((d) => {
-          const sig = d.metadata.signature || "";
-          return /(\)|=>)\s*:\s*\w+/.test(sig);
-        });
-        const coverage = annotated.length / functions.length;
-        let coverageLevel;
-        if (coverage >= 0.9) {
-          coverageLevel = "full";
-        } else if (coverage >= 0.5) {
-          coverageLevel = "partial";
-        } else if (coverage > 0) {
-          coverageLevel = "minimal";
-        } else {
-          coverageLevel = "none";
-        }
-        return {
-          coverage: coverageLevel,
-          annotatedCount: annotated.length,
-          totalCount: functions.length
-        };
-      }
       // ========================================================================
       // Pattern Comparisons
       // ========================================================================
@@ -54366,7 +54356,7 @@ var require_schemas3 = __commonJS({
   "../mcp-server/dist/src/schemas/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.InspectOutputSchema = exports2.RefsOutputSchema = exports2.RefResultSchema = exports2.MapOutputSchema = exports2.HealthOutputSchema = exports2.HealthCheckResultSchema = exports2.SearchOutputSchema = exports2.HealthArgsSchema = exports2.StatusOutputSchema = exports2.StatusArgsSchema = exports2.MapArgsSchema = exports2.RefsArgsSchema = exports2.SearchArgsSchema = exports2.InspectArgsSchema = exports2.BaseQuerySchema = exports2.FormatSchema = void 0;
+    exports2.InspectOutputSchema = exports2.RefsOutputSchema = exports2.RefResultSchema = exports2.MapOutputSchema = exports2.SearchOutputSchema = exports2.StatusOutputSchema = exports2.StatusArgsSchema = exports2.MapArgsSchema = exports2.RefsArgsSchema = exports2.SearchArgsSchema = exports2.InspectArgsSchema = exports2.BaseQuerySchema = exports2.FormatSchema = void 0;
     var zod_1 = require_zod();
     exports2.FormatSchema = zod_1.z.enum(["compact", "verbose"]);
     exports2.BaseQuerySchema = zod_1.z.object({
@@ -54374,9 +54364,9 @@ var require_schemas3 = __commonJS({
       limit: zod_1.z.number().int().min(1).max(50).default(10)
     });
     exports2.InspectArgsSchema = zod_1.z.object({
-      query: zod_1.z.string().min(1, "Query must be a non-empty string (file path)"),
+      filePath: zod_1.z.string().min(1, "filePath must be a non-empty file path"),
       limit: zod_1.z.number().int().min(1).max(50).default(10),
-      format: exports2.FormatSchema.default("compact")
+      format: zod_1.z.enum(["compact", "verbose", "json"]).default("compact")
     }).strict();
     exports2.SearchArgsSchema = zod_1.z.object({
       query: zod_1.z.string().min(1, "Query must be a non-empty string"),
@@ -54407,31 +54397,11 @@ var require_schemas3 = __commonJS({
       format: zod_1.z.string(),
       length: zod_1.z.number()
     });
-    exports2.HealthArgsSchema = zod_1.z.object({
-      verbose: zod_1.z.boolean().default(false)
-    }).strict();
     exports2.SearchOutputSchema = zod_1.z.object({
       query: zod_1.z.string(),
       format: zod_1.z.string(),
       content: zod_1.z.string()
     });
-    exports2.HealthCheckResultSchema = zod_1.z.object({
-      status: zod_1.z.enum(["pass", "warn", "fail"]),
-      message: zod_1.z.string(),
-      details: zod_1.z.any().optional()
-      // Allow any type for details
-    });
-    exports2.HealthOutputSchema = zod_1.z.object({
-      status: zod_1.z.enum(["healthy", "degraded", "unhealthy"]),
-      uptime: zod_1.z.number(),
-      timestamp: zod_1.z.string(),
-      checks: zod_1.z.object({
-        vectorStorage: exports2.HealthCheckResultSchema,
-        repository: exports2.HealthCheckResultSchema,
-        githubIndex: exports2.HealthCheckResultSchema.optional()
-      }),
-      formattedReport: zod_1.z.string()
-    });
     exports2.MapOutputSchema = zod_1.z.object({
       content: zod_1.z.string(),
       totalComponents: zod_1.z.number(),
@@ -54689,302 +54659,6 @@ var require_validation = __commonJS({
   }
 });
 
-// ../mcp-server/dist/src/adapters/built-in/health-adapter.js
-var require_health_adapter = __commonJS({
-  "../mcp-server/dist/src/adapters/built-in/health-adapter.js"(exports2) {
-    "use strict";
-    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports2 && exports2.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports2 && exports2.__importStar || /* @__PURE__ */ (function() {
-      var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function(o2) {
-          var ar = [];
-          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
-          return ar;
-        };
-        return ownKeys(o);
-      };
-      return function(mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) {
-          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        }
-        __setModuleDefault(result, mod);
-        return result;
-      };
-    })();
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.HealthAdapter = void 0;
-    var fs11 = __importStar(require("fs/promises"));
-    var index_js_1 = require_schemas3();
-    var tool_adapter_1 = require_tool_adapter();
-    var validation_js_1 = require_validation();
-    var HealthAdapter = class extends tool_adapter_1.ToolAdapter {
-      metadata = {
-        name: "health-adapter",
-        version: "1.0.0",
-        description: "Provides health and readiness checks for the MCP server"
-      };
-      config;
-      startTime;
-      constructor(config2) {
-        super();
-        this.config = config2;
-        this.startTime = Date.now();
-      }
-      async initialize(context) {
-        this.initializeBase(context);
-      }
-      async shutdown() {
-      }
-      getToolDefinition() {
-        return {
-          name: "dev_health",
-          description: "Check the health status of the dev-agent MCP server and its dependencies (vector storage, repository, GitHub index)",
-          inputSchema: {
-            type: "object",
-            properties: {
-              verbose: {
-                type: "boolean",
-                description: "Include detailed diagnostic information",
-                default: false
-              }
-            }
-          }
-        };
-      }
-      async execute(args, context) {
-        const validation = (0, validation_js_1.validateArgs)(index_js_1.HealthArgsSchema, args);
-        if (!validation.success) {
-          return validation.error;
-        }
-        const { verbose } = validation.data;
-        try {
-          const health = await this.performHealthChecks(verbose);
-          const status = this.getOverallStatus(health);
-          const emoji3 = status === "healthy" ? "\u2705" : status === "degraded" ? "\u26A0\uFE0F" : "\u274C";
-          const content3 = this.formatHealthReport(health, verbose);
-          return {
-            success: true,
-            data: `${emoji3} **MCP Server Health: ${status.toUpperCase()}**
-
-${content3}`
-          };
-        } catch (error46) {
-          context.logger.error("Health check failed", {
-            error: error46 instanceof Error ? error46.message : String(error46)
-          });
-          return {
-            success: false,
-            error: {
-              code: "HEALTH_CHECK_ERROR",
-              message: error46 instanceof Error ? error46.message : "Health check failed",
-              recoverable: true
-            }
-          };
-        }
-      }
-      async performHealthChecks(verbose) {
-        const [vectorStorage, repository, githubIndex] = await Promise.all([
-          this.checkVectorStorage(verbose),
-          this.checkRepository(verbose),
-          this.config.githubStatePath ? this.checkGitHubIndex(verbose) : Promise.resolve(void 0)
-        ]);
-        const checks = {
-          vectorStorage,
-          repository
-        };
-        if (githubIndex) {
-          checks.githubIndex = githubIndex;
-        }
-        return {
-          status: this.getOverallStatus({ checks }),
-          checks,
-          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-          uptime: Date.now() - this.startTime
-        };
-      }
-      async checkVectorStorage(verbose) {
-        try {
-          const stats = await fs11.stat(this.config.vectorStorePath);
-          if (!stats.isDirectory()) {
-            return {
-              status: "fail",
-              message: "Vector storage path is not a directory"
-            };
-          }
-          const files = await fs11.readdir(this.config.vectorStorePath);
-          const hasData = files.length > 0;
-          if (!hasData) {
-            return {
-              status: "warn",
-              message: "Vector storage is empty (repository may not be indexed)",
-              details: verbose ? { path: this.config.vectorStorePath } : void 0
-            };
-          }
-          return {
-            status: "pass",
-            message: `Vector storage operational (${files.length} files)`,
-            details: verbose ? { path: this.config.vectorStorePath, fileCount: files.length } : void 0
-          };
-        } catch (error46) {
-          return {
-            status: "fail",
-            message: `Vector storage not accessible: ${error46 instanceof Error ? error46.message : String(error46)}`,
-            details: verbose ? { path: this.config.vectorStorePath } : void 0
-          };
-        }
-      }
-      async checkRepository(verbose) {
-        try {
-          const stats = await fs11.stat(this.config.repositoryPath);
-          if (!stats.isDirectory()) {
-            return {
-              status: "fail",
-              message: "Repository path is not a directory"
-            };
-          }
-          try {
-            await fs11.stat(`${this.config.repositoryPath}/.git`);
-            return {
-              status: "pass",
-              message: "Repository accessible and is a Git repository",
-              details: verbose ? { path: this.config.repositoryPath } : void 0
-            };
-          } catch {
-            return {
-              status: "warn",
-              message: "Repository accessible but not a Git repository",
-              details: verbose ? { path: this.config.repositoryPath } : void 0
-            };
-          }
-        } catch (error46) {
-          return {
-            status: "fail",
-            message: `Repository not accessible: ${error46 instanceof Error ? error46.message : String(error46)}`,
-            details: verbose ? { path: this.config.repositoryPath } : void 0
-          };
-        }
-      }
-      async checkGitHubIndex(verbose) {
-        if (!this.config.githubStatePath) {
-          return {
-            status: "warn",
-            message: "GitHub index not configured"
-          };
-        }
-        try {
-          const content3 = await fs11.readFile(this.config.githubStatePath, "utf-8");
-          const state = JSON.parse(content3);
-          const lastIndexed = state.lastIndexed ? new Date(state.lastIndexed) : null;
-          const itemCount = state.items?.length ?? 0;
-          if (!lastIndexed) {
-            return {
-              status: "warn",
-              message: "GitHub index exists but has no lastIndexed timestamp",
-              details: verbose ? { path: this.config.githubStatePath } : void 0
-            };
-          }
-          const ageMs = Date.now() - lastIndexed.getTime();
-          const ageHours = Math.floor(ageMs / (1e3 * 60 * 60));
-          if (ageHours > 24) {
-            return {
-              status: "warn",
-              message: `GitHub index is ${ageHours}h old (${itemCount} items) - consider re-indexing`,
-              details: verbose ? { path: this.config.githubStatePath, lastIndexed: lastIndexed.toISOString() } : void 0
-            };
-          }
-          return {
-            status: "pass",
-            message: `GitHub index operational (${itemCount} items, indexed ${ageHours}h ago)`,
-            details: verbose ? { path: this.config.githubStatePath, lastIndexed: lastIndexed.toISOString() } : void 0
-          };
-        } catch (error46) {
-          return {
-            status: "warn",
-            message: `GitHub index not accessible: ${error46 instanceof Error ? error46.message : String(error46)}`,
-            details: verbose ? { path: this.config.githubStatePath } : void 0
-          };
-        }
-      }
-      getOverallStatus(health) {
-        const checks = Object.values(health.checks).filter((check2) => check2 !== void 0);
-        const hasFail = checks.some((check2) => check2.status === "fail");
-        const hasWarn = checks.some((check2) => check2.status === "warn");
-        if (hasFail) {
-          return "unhealthy";
-        }
-        if (hasWarn) {
-          return "degraded";
-        }
-        return "healthy";
-      }
-      formatHealthReport(health, verbose) {
-        const lines = [];
-        const uptimeMs = health.uptime;
-        const uptimeStr = this.formatUptime(uptimeMs);
-        lines.push(`**Uptime:** ${uptimeStr}`);
-        lines.push(`**Timestamp:** ${new Date(health.timestamp).toLocaleString()}`);
-        lines.push("");
-        lines.push("**Component Status:**");
-        lines.push("");
-        for (const [name, check2] of Object.entries(health.checks)) {
-          if (!check2)
-            continue;
-          const statusEmoji = check2.status === "pass" ? "\u2705" : check2.status === "warn" ? "\u26A0\uFE0F" : "\u274C";
-          const componentName = this.formatComponentName(name);
-          lines.push(`${statusEmoji} **${componentName}:** ${check2.message}`);
-          if (verbose && check2.details) {
-            lines.push(`   *Details:* ${JSON.stringify(check2.details)}`);
-          }
-        }
-        return lines.join("\n");
-      }
-      formatComponentName(name) {
-        return name.replace(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase()).trim();
-      }
-      formatUptime(ms) {
-        const seconds = Math.floor(ms / 1e3);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        const days = Math.floor(hours / 24);
-        if (days > 0) {
-          return `${days}d ${hours % 24}h ${minutes % 60}m`;
-        }
-        if (hours > 0) {
-          return `${hours}h ${minutes % 60}m`;
-        }
-        if (minutes > 0) {
-          return `${minutes}m ${seconds % 60}s`;
-        }
-        return `${seconds}s`;
-      }
-      async healthCheck() {
-        const health = await this.performHealthChecks(false);
-        return health.status === "healthy";
-      }
-    };
-    exports2.HealthAdapter = HealthAdapter;
-  }
-});
-
 // ../mcp-server/dist/src/adapters/built-in/inspect-adapter.js
 var require_inspect_adapter = __commonJS({
   "../mcp-server/dist/src/adapters/built-in/inspect-adapter.js"(exports2) {
@@ -55012,7 +54686,8 @@ var require_inspect_adapter = __commonJS({
         this.repositoryPath = config2.repositoryPath;
         this.searchService = config2.searchService;
         this.patternService = new dev_agent_core_12.PatternAnalysisService({
-          repositoryPath: config2.repositoryPath
+          repositoryPath: config2.repositoryPath,
+          vectorStorage: config2.vectorStorage
         });
         this.defaultLimit = config2.defaultLimit ?? 10;
         this.defaultThreshold = config2.defaultThreshold ?? 0.7;
@@ -55031,11 +54706,11 @@ var require_inspect_adapter = __commonJS({
       getToolDefinition() {
         return {
           name: "dev_patterns",
-          description: "Analyze coding patterns in a file against the codebase. Compares import style, error handling, type coverage, test coverage, and file size against similar files. Use for code reviews and consistency checks.",
+          description: "Analyze coding patterns in a file against similar code in the codebase. Compares import style, error handling, type coverage, test coverage, and file size. Use for code reviews and consistency checks. NOT for finding code (use dev_search) or tracing calls (use dev_refs).",
           inputSchema: {
             type: "object",
             properties: {
-              query: {
+              filePath: {
                 type: "string",
                 description: 'File path to analyze (e.g., "src/auth/middleware.ts")'
               },
@@ -55048,12 +54723,12 @@ var require_inspect_adapter = __commonJS({
               },
               format: {
                 type: "string",
-                enum: ["compact", "verbose"],
-                description: 'Output format: "compact" for summaries (default), "verbose" for full details',
+                enum: ["compact", "verbose", "json"],
+                description: 'Output format: "compact" (default), "verbose" for details, "json" for structured data',
                 default: this.defaultFormat
               }
             },
-            required: ["query"]
+            required: ["filePath"]
           }
         };
       }
@@ -55062,34 +54737,42 @@ var require_inspect_adapter = __commonJS({
         if (!validation.success) {
           return validation.error;
         }
-        const { query, limit, format } = validation.data;
+        const { filePath, limit, format } = validation.data;
         try {
           context.logger.debug("Executing pattern analysis", {
-            query,
+            filePath,
             limit,
             format
           });
-          const { content: content3, similarFilesCount, patternsAnalyzed } = await this.inspectFile(
-            query,
-            limit,
-            0,
-            // No threshold — let the pattern service decide relevance
-            format
-          );
+          const { content: content3, similarFilesCount, patternsAnalyzed, patternComparison } = await this.inspectFile(filePath, limit, 0, format);
           context.logger.info("File inspection completed", {
-            query,
+            filePath,
             similarFilesCount,
             patternsAnalyzed,
             contentLength: content3.length
           });
+          if (format === "json" && patternComparison) {
+            const jsonData = JSON.stringify(patternComparison, null, 2);
+            return {
+              success: true,
+              data: jsonData,
+              metadata: {
+                tokens: jsonData.length / 4,
+                duration_ms: 0,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                cached: false,
+                similar_files_count: similarFilesCount,
+                patterns_analyzed: patternsAnalyzed,
+                format: "json"
+              }
+            };
+          }
           return {
             success: true,
             data: content3,
             metadata: {
               tokens: content3.length / 4,
-              // Rough estimate
               duration_ms: 0,
-              // Calculated by MCP server
               timestamp: (/* @__PURE__ */ new Date()).toISOString(),
               cached: false,
               similar_files_count: similarFilesCount,
@@ -55105,7 +54788,7 @@ var require_inspect_adapter = __commonJS({
                 success: false,
                 error: {
                   code: "FILE_NOT_FOUND",
-                  message: `File not found: ${query}`,
+                  message: `File not found: ${filePath}`,
                   suggestion: "Check the file path and ensure it exists in the repository."
                 }
               };
@@ -55125,7 +54808,8 @@ var require_inspect_adapter = __commonJS({
             success: false,
             error: {
               code: "INSPECTION_ERROR",
-              message: error46 instanceof Error ? error46.message : "Unknown inspection error"
+              message: error46 instanceof Error ? error46.message : "Unknown inspection error",
+              suggestion: "Check the file path is valid and the repository is indexed."
             }
           };
         }
@@ -55161,12 +54845,12 @@ var require_inspect_adapter = __commonJS({
         }
         const similarFilePaths = filteredResults.map((r) => r.metadata.path);
         const patternComparison = await this.patternService.comparePatterns(filePath, similarFilePaths);
-        const content3 = format === "verbose" ? await this.formatInspectionVerbose(filePath, filteredResults, patternComparison) : await this.formatInspectionCompact(filePath, filteredResults, patternComparison);
+        const content3 = format === "json" ? "" : format === "verbose" ? await this.formatInspectionVerbose(filePath, filteredResults, patternComparison) : await this.formatInspectionCompact(filePath, filteredResults, patternComparison);
         return {
           content: content3,
           similarFilesCount: filteredResults.length,
-          patternsAnalyzed: 5
-          // Currently analyzing 5 pattern categories
+          patternsAnalyzed: 5,
+          patternComparison
         };
       }
       /**
@@ -55491,7 +55175,7 @@ var require_map_adapter = __commonJS({
             error: {
               code: "MAP_FAILED",
               message: error46 instanceof Error ? error46.message : "Unknown error",
-              details: error46
+              suggestion: 'Run "dev index" first. Try a lower depth if the map is too large.'
             }
           };
         }
@@ -55584,7 +55268,8 @@ var require_refs_adapter = __commonJS({
               success: false,
               error: {
                 code: "NOT_FOUND",
-                message: `Could not find function or method named "${name}"`
+                message: `Could not find function or method named "${name}"`,
+                suggestion: "Verify the function name exists with dev_search first. Names are case-sensitive."
               }
             };
           }
@@ -55629,7 +55314,7 @@ var require_refs_adapter = __commonJS({
             error: {
               code: "REFS_FAILED",
               message: error46 instanceof Error ? error46.message : "Unknown error",
-              details: error46
+              suggestion: "Try dev_search to find the correct function name first."
             }
           };
         }
@@ -56383,7 +56068,7 @@ var require_search_adapter = __commonJS({
             error: {
               code: "SEARCH_FAILED",
               message: error46 instanceof Error ? error46.message : "Unknown error",
-              details: error46
+              suggestion: 'Run "dev index" to index the repository. Try a different query if no results.'
             }
           };
         }
@@ -56524,7 +56209,7 @@ var require_status_adapter = __commonJS({
             error: {
               code: "STATUS_FAILED",
               message: error46 instanceof Error ? error46.message : "Unknown error",
-              details: error46
+              suggestion: 'Run "dev setup" to ensure Antfly is running, then "dev index" to index.'
             }
           };
         }
@@ -56725,11 +56410,7 @@ var require_built_in = __commonJS({
   "../mcp-server/dist/src/adapters/built-in/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.StatusAdapter = exports2.SearchAdapter = exports2.RefsAdapter = exports2.MapAdapter = exports2.InspectAdapter = exports2.HealthAdapter = void 0;
-    var health_adapter_js_1 = require_health_adapter();
-    Object.defineProperty(exports2, "HealthAdapter", { enumerable: true, get: function() {
-      return health_adapter_js_1.HealthAdapter;
-    } });
+    exports2.StatusAdapter = exports2.SearchAdapter = exports2.RefsAdapter = exports2.MapAdapter = exports2.InspectAdapter = void 0;
     var inspect_adapter_js_1 = require_inspect_adapter();
     Object.defineProperty(exports2, "InspectAdapter", { enumerable: true, get: function() {
       return inspect_adapter_js_1.InspectAdapter;
@@ -58403,14 +58084,11 @@ async function main() {
     const inspectAdapter = new built_in_1.InspectAdapter({
       repositoryPath,
       searchService,
+      vectorStorage: indexer.getVectorStorage(),
       defaultLimit: 10,
       defaultThreshold: 0.7,
       defaultFormat: "compact"
     });
-    const healthAdapter = new built_in_1.HealthAdapter({
-      repositoryPath,
-      vectorStorePath: filePaths.vectors
-    });
     const refsAdapter = new built_in_1.RefsAdapter({
       searchService,
       defaultLimit: 20
@@ -58431,14 +58109,7 @@ async function main() {
         logLevel
       },
       transport: "stdio",
-      adapters: [
-        searchAdapter,
-        statusAdapter,
-        inspectAdapter,
-        healthAdapter,
-        refsAdapter,
-        mapAdapter
-      ]
+      adapters: [searchAdapter, statusAdapter, inspectAdapter, refsAdapter, mapAdapter]
     });
     await server.start();
     const incrementalIndexer = (0, watcher_1.createIncrementalIndexer)({