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

package/dist/index.js

@@ -747,6 +747,60 @@ async function getIncidentHistory(client2, input) {
     });
   }, `Node ${input.nodeId} not found in the graph.`);
 }
+async function getIncidentCard(client2, input) {
+  return withMissingNodeFallback(
+    client2,
+    input.project,
+    async () => {
+      const qs = input.errorId ? `?errorId=${encodeURIComponent(input.errorId)}` : "";
+      const card = await client2.get(
+        projectPath(input.project, `/graph/incident-card/${encodeURIComponent(input.nodeId)}${qs}`)
+      );
+      const lines = [];
+      lines.push(`  incident ${card.id} [${card.incidentKind}] at ${card.at}`);
+      lines.push(`  ${card.message}`);
+      if (card.locus) {
+        const l = card.locus;
+        lines.push(
+          `  locus: ${l.symbol ? `${l.symbol} ` : ""}${l.file}${l.lineStart ? `:${l.lineStart}` : ""} [${l.provenance}]`
+        );
+      } else {
+        lines.push("  locus: none recovered \u2014 service grain");
+      }
+      if (card.rootCause) {
+        const rc = card.rootCause;
+        lines.push(
+          `  root cause: ${rc.node}${rc.classification ? ` (${rc.classification})` : ""} \u2014 ${rc.reason} [confidence ${rc.confidence.toFixed(2)}]`
+        );
+        lines.push(`  chain: ${rc.chain.map((h) => `${h.node} [${h.provenance}]`).join(" \u2192 ")}`);
+        if (rc.fix) lines.push(`  fix: ${rc.fix}`);
+      } else {
+        lines.push("  root cause: none reachable");
+      }
+      if (card.blastRadius) {
+        lines.push(
+          `  blast radius: ${card.blastRadius.totalAffected} node(s); nearest ${card.blastRadius.nearest.map((n) => n.node).join(", ")}`
+        );
+      }
+      if (card.policies && card.policies.length > 0) {
+        lines.push(
+          `  policies: ${card.policies.map((p) => `[${p.severity}] ${p.policyName}`).join("; ")}`
+        );
+      }
+      if (card.divergence && card.divergence.length > 0) {
+        lines.push(
+          `  divergence: ${card.divergence.map((d) => `${d.type} (${d.summary})`).join("; ")}`
+        );
+      }
+      return formatToolResponse({
+        summary: card.headline,
+        block: lines.join("\n"),
+        provenance: Provenance.OBSERVED
+      });
+    },
+    `No incident card available for ${input.nodeId}.`
+  );
+}
 async function semanticSearch(client2, input) {
   try {
     const result = await client2.get(
@@ -1303,6 +1357,16 @@ registerTool(
   },
   async (input) => getIncidentHistory(client, { ...input, project: projectFor(input) })
 );
+registerTool(
+  "get_incident_card",
+  "One self-sufficient work order for an incident on a node (ADR-221): the incident fused with its root-cause chain, blast radius, governing policies, and node divergence \u2014 each claim provenance-stamped, so you can act without grepping. Give a node id (a service, file, or symbol); omit errorId for the node's most-recent incident, or pass errorId to pin one.",
+  {
+    nodeId: z.string().describe("Graph node id the incident is on (service/file/symbol)"),
+    errorId: z.string().optional().describe("Pin a specific incident by its id; omit for the most recent"),
+    project: projectField
+  },
+  async (input) => getIncidentCard(client, { ...input, project: projectFor(input) })
+);
 registerTool(
   "semantic_search",
   "Search nodes by natural-language query. Uses embedding vectors when an embedder is available (Ollama nomic-embed-text \u2192 in-process MiniLM \u2192 substring fallback) \u2014 phrase the query the way you would describe what you want.",