@neat.is/core 0.2.9 → 0.3.0

package/dist/cli.d.cts

@@ -27,6 +27,8 @@ interface ParsedArgs {
     against: string | null;
     errorId: string | null;
     hypotheticalAction: string | null;
+    type: string | null;
+    minConfidence: number | null;
     positional: string[];
 }
 declare function parseArgs(rest: string[]): ParsedArgs;

package/dist/cli.d.ts

@@ -27,6 +27,8 @@ interface ParsedArgs {
     against: string | null;
     errorId: string | null;
     hypotheticalAction: string | null;
+    type: string | null;
+    minConfidence: number | null;
     positional: string[];
 }
 declare function parseArgs(rest: string[]): ParsedArgs;

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-XOOCA5T7.js";
 import {
   buildApi
-} from "./chunk-5KX7EI4F.js";
+} from "./chunk-NVCEZXL7.js";
 import {
   DEFAULT_PROJECT,
   PolicyViolationsLog,
@@ -37,11 +37,12 @@ import {
   setStatus,
   startPersistLoop,
   startStalenessLoop
-} from "./chunk-IRPH6KL4.js";
+} from "./chunk-B7UUGIXB.js";
 import {
   buildOtelReceiver,
   startOtelGrpcReceiver
-} from "./chunk-I5IMCXRO.js";
+} from "./chunk-QYUB3FQL.js";
+import "./chunk-DGUM43GV.js";
 
 // src/cli.ts
 import path4 from "path";
@@ -753,6 +754,9 @@ function renderPatch(sections) {
   return lines.join("\n");
 }
 
+// src/cli.ts
+import { DivergenceTypeSchema } from "@neat.is/types";
+
 // src/cli-client.ts
 import { Provenance as Provenance2 } from "@neat.is/types";
 var HttpError = class extends Error {
@@ -826,7 +830,7 @@ async function runRootCause(client, input) {
   const qs = input.errorId ? `?errorId=${encodeURIComponent(input.errorId)}` : "";
   const path5 = projectPath(
     input.project,
-    `/traverse/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
+    `/graph/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
   );
   try {
     const result = await client.get(path5);
@@ -857,7 +861,7 @@ async function runBlastRadius(client, input) {
   const qs = input.depth !== void 0 ? `?depth=${input.depth}` : "";
   const path5 = projectPath(
     input.project,
-    `/traverse/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
+    `/graph/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
   );
   try {
     const result = await client.get(path5);
@@ -896,7 +900,7 @@ async function runDependencies(client, input) {
   const depth = input.depth ?? 3;
   const path5 = projectPath(
     input.project,
-    `/graph/node/${encodeURIComponent(input.nodeId)}/dependencies?depth=${depth}`
+    `/graph/dependencies/${encodeURIComponent(input.nodeId)}?depth=${depth}`
   );
   try {
     const result = await client.get(path5);
@@ -982,7 +986,8 @@ function formatDuration(ms) {
 async function runIncidents(client, input) {
   const path5 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
   try {
-    const events = await client.get(path5);
+    const body = await client.get(path5);
+    const events = body.events;
     if (events.length === 0) {
       return {
         summary: input.nodeId ? `No incidents recorded against ${input.nodeId}.` : "No incidents recorded."
@@ -996,7 +1001,7 @@ async function runIncidents(client, input) {
     }
     const target = input.nodeId ?? "the project";
     return {
-      summary: `${target} has ${events.length} recorded incident${events.length === 1 ? "" : "s"}; showing the ${ordered.length} most recent.`,
+      summary: `${target} has ${body.total} recorded incident${body.total === 1 ? "" : "s"}; showing the ${ordered.length} most recent.`,
       block: blockLines.join("\n"),
       provenance: Provenance2.OBSERVED
     };
@@ -1092,9 +1097,10 @@ async function runStaleEdges(client, input) {
   if (input.limit !== void 0) params.set("limit", String(input.limit));
   if (input.edgeType) params.set("edgeType", input.edgeType);
   const qs = params.size > 0 ? `?${params.toString()}` : "";
-  const events = await client.get(
-    projectPath(input.project, `/incidents/stale${qs}`)
+  const body = await client.get(
+    projectPath(input.project, `/stale-events${qs}`)
   );
+  const events = body.events;
   if (events.length === 0) {
     return {
       summary: input.edgeType ? `No stale ${input.edgeType} edges recorded.` : "No stale-edge transitions recorded yet."
@@ -1128,9 +1134,10 @@ async function runPolicies(client, input) {
     const params = new URLSearchParams();
     if (input.policyId) params.set("policyId", input.policyId);
     const qs = params.size > 0 ? `?${params.toString()}` : "";
-    violations = await client.get(
+    const body = await client.get(
       projectPath(input.project, `/policies/violations${qs}`)
     );
+    violations = body.violations;
     allowed = violations.every((v) => v.onViolation !== "block");
   }
   if (input.nodeId) {
@@ -1169,6 +1176,54 @@ async function runPolicies(client, input) {
     provenance: severities.join(" ")
   };
 }
+function formatDivergenceLine(d) {
+  switch (d.type) {
+    case "missing-observed":
+    case "missing-extracted":
+      return `  \u2022 [${d.type}] ${d.source} \u2192 ${d.target} (${d.edgeType}) \u2014 confidence ${d.confidence.toFixed(2)}`;
+    case "version-mismatch":
+      return `  \u2022 [${d.type}] ${d.source} \u2192 ${d.target} \u2014 declared ${d.extractedVersion}, observed engine ${d.observedVersion} (${d.compatibility})`;
+    case "host-mismatch":
+      return `  \u2022 [${d.type}] ${d.source} \u2192 ${d.target} \u2014 declared host ${d.extractedHost}, observed host ${d.observedHost}`;
+    case "compat-violation":
+      return `  \u2022 [${d.type}] ${d.source} \u2192 ${d.target} \u2014 ${d.rule.kind}${d.rule.package ? ` (${d.rule.package})` : ""}`;
+  }
+}
+async function runDivergences(client, input) {
+  const params = new URLSearchParams();
+  if (input.type && input.type.length > 0) params.set("type", input.type.join(","));
+  if (input.minConfidence !== void 0) {
+    params.set("minConfidence", String(input.minConfidence));
+  }
+  if (input.node) params.set("node", input.node);
+  const qs = params.size > 0 ? `?${params.toString()}` : "";
+  const result = await client.get(
+    projectPath(input.project, `/graph/divergences${qs}`)
+  );
+  if (result.totalAffected === 0) {
+    return {
+      summary: "No divergences found between the declared (EXTRACTED) and observed (OBSERVED) views of the graph."
+    };
+  }
+  const headline = result.divergences[0];
+  const summary = `Found ${result.totalAffected} divergence${result.totalAffected === 1 ? "" : "s"} between code and production. Highest-confidence: ${headline.type} on ${headline.source} \u2192 ${headline.target}. ${headline.reason}`;
+  const blockLines = [];
+  for (const d of result.divergences) {
+    blockLines.push(formatDivergenceLine(d));
+    blockLines.push(`    reason: ${d.reason}`);
+    blockLines.push(`    recommendation: ${d.recommendation}`);
+  }
+  const maxConfidence = result.divergences.reduce(
+    (m, d) => Math.max(m, d.confidence),
+    0
+  );
+  return {
+    summary,
+    block: blockLines.join("\n"),
+    confidence: maxConfidence,
+    provenance: "composite (EXTRACTED + OBSERVED)"
+  };
+}
 function formatFooter(confidence, provenance) {
   const c = confidence === void 0 ? "n/a" : confidence.toFixed(2);
   const p = provenance === void 0 ? "n/a" : Array.isArray(provenance) ? [...new Set(provenance)].join(", ") : provenance;
@@ -1247,6 +1302,9 @@ function usage() {
   console.log("  policies                         Current policy violations.");
   console.log("                                   Flags: --node <id>, --hypothetical-action <json>");
   console.log("                                   example: neat policies --node service:<name> --json");
+  console.log("  divergences                      Where code (EXTRACTED) and production (OBSERVED) disagree.");
+  console.log("                                   Flags: --type <list>, --min-confidence <0..1>, --node <id>");
+  console.log("                                   example: neat divergences --min-confidence 0.7");
   console.log("");
   console.log("flags:");
   console.log('  --project <name>   Name the project this command targets. Default: "default".');
@@ -1271,7 +1329,9 @@ var STRING_FLAGS = [
   ["--since", "since"],
   ["--against", "against"],
   ["--error-id", "errorId"],
-  ["--hypothetical-action", "hypotheticalAction"]
+  ["--hypothetical-action", "hypotheticalAction"],
+  ["--type", "type"],
+  ["--min-confidence", "minConfidence"]
 ];
 function parseArgs(rest) {
   const positional = [];
@@ -1290,6 +1350,8 @@ function parseArgs(rest) {
     against: null,
     errorId: null,
     hypotheticalAction: null,
+    type: null,
+    minConfidence: null,
     positional: []
   };
   for (let i = 0; i < rest.length; i++) {
@@ -1349,6 +1411,15 @@ function assignFlag(out, field, value) {
     out[field] = n;
     return;
   }
+  if (field === "minConfidence") {
+    const n = Number(value);
+    if (!Number.isFinite(n) || n < 0 || n > 1) {
+      console.error("neat: --min-confidence must be a number in [0, 1]");
+      process.exit(2);
+    }
+    out.minConfidence = n;
+    return;
+  }
   ;
   out[field] = value;
 }
@@ -1732,7 +1803,9 @@ var QUERY_VERBS = /* @__PURE__ */ new Set([
   "search",
   "diff",
   "stale-edges",
-  "policies"
+  "policies",
+  // Tenth verb (ADR-060) — amends ADR-050's locked allowlist of nine.
+  "divergences"
 ]);
 function resolveProjectFlag(parsed) {
   if (parsed.project) return parsed.project;
@@ -1854,6 +1927,31 @@ async function runQueryVerb(cmd, parsed) {
       });
       break;
     }
+    case "divergences": {
+      let typeFilter;
+      if (parsed.type) {
+        const parts = parsed.type.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+        const out = [];
+        for (const p of parts) {
+          const r = DivergenceTypeSchema.safeParse(p);
+          if (!r.success) {
+            console.error(
+              `neat divergences: unknown --type "${p}". allowed: ${DivergenceTypeSchema.options.join(", ")}`
+            );
+            return 2;
+          }
+          out.push(r.data);
+        }
+        typeFilter = out;
+      }
+      work = runDivergences(client, {
+        ...typeFilter ? { type: typeFilter } : {},
+        ...parsed.minConfidence !== null ? { minConfidence: parsed.minConfidence } : {},
+        ...parsed.node ? { node: parsed.node } : {},
+        ...project ? { project } : {}
+      });
+      break;
+    }
     default:
       console.error(`neat: unknown query verb "${cmd}"`);
       return 2;