@neat.is/mcp 0.9.7-dev.20260827 → 0.9.8-dev.20260828

package/dist/index.cjs

@@ -445,7 +445,29 @@ function projectPath(project, suffix) {
   if (!project) return suffix;
   return `/projects/${encodeURIComponent(project)}${suffix}`;
 }
-async function withMissingNodeFallback(fn, notFoundMessage) {
+async function readinessReason(client2, project) {
+  let health;
+  try {
+    const named = project ?? "default";
+    health = await client2.get(projectPath(named, "/health"));
+  } catch {
+    return void 0;
+  }
+  const coverage = health.coverage;
+  if (!coverage || typeof coverage.skippedFiles !== "number") {
+    return "(index still building \u2014 the first extraction pass has not finished yet, so this may be incomplete; retry once it settles.)";
+  }
+  if (coverage.skippedFiles > 0) {
+    const n = coverage.skippedFiles;
+    return `(index partial \u2014 ${n} file${n === 1 ? "" : "s"} failed to parse in the last pass, so this may be incomplete.)`;
+  }
+  return "(graph is current \u2014 this is a real empty result, not a still-building index.)";
+}
+async function emptyWithReadiness(client2, project, summary) {
+  const reason = await readinessReason(client2, project);
+  return reason ? formatToolResponse({ summary: `${summary} ${reason}` }) : formatEmptyResponse(summary);
+}
+async function withMissingNodeFallback(client2, project, fn, notFoundMessage) {
   try {
     return await fn();
   } catch (err) {
@@ -453,7 +475,7 @@ async function withMissingNodeFallback(fn, notFoundMessage) {
       return formatErrorResponse(err.message);
     }
     if (err instanceof HttpError && err.status === 404) {
-      return formatEmptyResponse(notFoundMessage);
+      return emptyWithReadiness(client2, project, notFoundMessage);
     }
     return formatErrorResponse(`Error talking to neat-core: ${err.message}`);
   }
@@ -464,7 +486,7 @@ async function getRootCause(client2, input) {
     input.project,
     `/graph/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
   );
-  return withMissingNodeFallback(async () => {
+  return withMissingNodeFallback(client2, input.project, async () => {
     const result = await client2.get(path);
     const arrowPath = result.traversalPath.join(" \u2190 ");
     const provenances = result.edgeProvenances.length ? result.edgeProvenances.join(", ") : "(direct, no edges traversed)";
@@ -498,10 +520,12 @@ async function getBlastRadius(client2, input) {
     input.project,
     `/graph/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
   );
-  return withMissingNodeFallback(async () => {
+  return withMissingNodeFallback(client2, input.project, async () => {
     const result = await client2.get(path);
     if (result.totalAffected === 0) {
-      return formatEmptyResponse(
+      return emptyWithReadiness(
+        client2,
+        input.project,
         `${result.origin} has no dependents. Nothing else would break if it failed.`
       );
     }
@@ -532,10 +556,12 @@ async function getDependencies(client2, input) {
     input.project,
     `/graph/dependencies/${encodeURIComponent(input.nodeId)}?depth=${depth}`
   );
-  return withMissingNodeFallback(async () => {
+  return withMissingNodeFallback(client2, input.project, async () => {
     const result = await client2.get(path);
     if (result.total === 0) {
-      return formatEmptyResponse(
+      return emptyWithReadiness(
+        client2,
+        input.project,
         depth === 1 ? `${input.nodeId} has no direct dependencies in the graph.` : `${input.nodeId} has no dependencies (BFS to depth ${depth}).`
       );
     }
@@ -568,7 +594,7 @@ function observedDepLine(nodeId, e) {
   return `  \u2022 ${e.target} \u2014 ${e.type}${via}${edgeMeta(e)}`;
 }
 async function getObservedDependencies(client2, input) {
-  return withMissingNodeFallback(async () => {
+  return withMissingNodeFallback(client2, input.project, async () => {
     const result = await client2.get(
       projectPath(
         input.project,
@@ -623,7 +649,7 @@ async function expandNode(client2, input) {
     input.project,
     `/graph/expand/${encodeURIComponent(input.nodeId)}?direction=${input.direction}`
   );
-  return withMissingNodeFallback(async () => {
+  return withMissingNodeFallback(client2, input.project, async () => {
     const result = await client2.get(path);
     const dirWord = input.direction === "up" ? "callers/dependents (up)" : "callees/dependencies (down)";
     const summary = `${result.node.id} is ${result.node.classification}. ${result.neighbours.length} ${dirWord}.`;
@@ -665,7 +691,7 @@ async function relate(client2, input) {
 async function ask(client2, input) {
   const question = input.question.trim();
   if (!question) return formatEmptyResponse("ask: the question was empty.");
-  return withMissingNodeFallback(async () => {
+  return withMissingNodeFallback(client2, input.project, async () => {
     const result = await client2.get(
       projectPath(input.project, `/graph/ask?q=${encodeURIComponent(question)}`)
     );
@@ -693,7 +719,7 @@ async function ask(client2, input) {
   }, `ask: nothing in "${question}" resolved to a node in the graph.`);
 }
 async function getIncidentHistory(client2, input) {
-  return withMissingNodeFallback(async () => {
+  return withMissingNodeFallback(client2, input.project, async () => {
     const body = await client2.get(
       projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`)
     );
@@ -968,13 +994,23 @@ function formatDivergenceLine(d) {
       const member = d.symbol ? ` ${d.symbol}` : "";
       return `  \u2022 [${d.type}] ${d.source}${member}${at} (${d.mismatchKind}) \u2014 confidence ${d.confidence.toFixed(2)}`;
     }
+    case "observed-failing": {
+      if (d.edgeType) {
+        const rate = d.errorRate !== void 0 ? ` ${Math.round(d.errorRate * 100)}% of observed calls fail` : "";
+        return `  \u2022 [${d.type}] ${d.source} \u2192 ${d.target} (${d.edgeType}) \u2014${rate} (${d.failureKind}) \u2014 confidence ${d.confidence.toFixed(2)}`;
+      }
+      const at = d.location ? ` at ${d.location}` : "";
+      return `  \u2022 [${d.type}] ${d.source}${at} (${d.failureKind}) \u2014 confidence ${d.confidence.toFixed(2)}`;
+    }
   }
 }
 async function getDivergences(client2, input) {
   try {
     const result = await client2.get(buildDivergencesPath(input));
     if (result.totalAffected === 0) {
-      return formatEmptyResponse(
+      return emptyWithReadiness(
+        client2,
+        input.project,
         "No divergences found between the declared (EXTRACTED) and observed (OBSERVED) views of the graph."
       );
     }
@@ -1297,7 +1333,7 @@ registerTool(
   "Returns places where what the code declares (EXTRACTED) doesn't match what production observed (OBSERVED). The single most NEAT-shaped query \u2014 the one that justifies the whole graph. Use when the user asks 'is anything weird?' or 'what does production do that the code doesn't?' or 'find me a bug' on an unfamiliar codebase. Returns divergences ranked by confidence \xD7 severity. Prefer this over `get_root_cause` when no specific node is failing.",
   {
     type: import_zod.z.array(import_types2.DivergenceTypeSchema).optional().describe(
-      "Filter by divergence type. One or more of: missing-observed, missing-extracted, version-mismatch, host-mismatch, compat-violation, observed-symbol-mismatch. Omit for all."
+      "Filter by divergence type. One or more of: missing-observed, missing-extracted, version-mismatch, host-mismatch, compat-violation, observed-symbol-mismatch, observed-failing. Omit for all."
     ),
     minConfidence: import_zod.z.number().min(0).max(1).optional().describe("Drop divergences below this confidence threshold (0.0 - 1.0)."),
     node: import_zod.z.string().optional().describe("Scope to divergences involving this node id (as source or target)."),