@neat.is/core 0.2.8 → 0.2.10

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-FTKDVKBC.js";
+} from "./chunk-W7ZYJZC7.js";
 import {
   DEFAULT_PROJECT,
   PolicyViolationsLog,
@@ -37,11 +37,12 @@ import {
   setStatus,
   startPersistLoop,
   startStalenessLoop
-} from "./chunk-GAYTAGEH.js";
+} from "./chunk-JMLZOKCS.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 {
@@ -1169,6 +1173,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 +1299,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 +1326,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 +1347,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 +1408,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 +1800,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 +1924,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;