@neat.is/core 0.2.8 → 0.2.10

package/dist/cli.cjs

@@ -101,8 +101,8 @@ function reshapeGrpcRequest(req) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path30.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path30.default.resolve(here, "..", "proto");
+  const here = import_node_path31.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return import_node_path31.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -157,13 +157,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path30, grpc, protoLoader;
+var import_node_url, import_node_path31, grpc, protoLoader;
 var init_otel_grpc = __esm({
   "src/otel-grpc.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_url = require("url");
-    import_node_path30 = __toESM(require("path"), 1);
+    import_node_path31 = __toESM(require("path"), 1);
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
     init_otel();
@@ -260,10 +260,10 @@ function parseOtlpRequest(body) {
 }
 function loadProtobufDecoder() {
   if (exportTraceServiceRequestType) return exportTraceServiceRequestType;
-  const here = import_node_path31.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path31.default.resolve(here, "..", "proto");
+  const here = import_node_path32.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path32.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path31.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path32.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -355,12 +355,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path31, import_node_url2, import_fastify2, import_protobufjs, exportTraceServiceRequestType;
+var import_node_path32, import_node_url2, import_fastify2, import_protobufjs, exportTraceServiceRequestType;
 var init_otel = __esm({
   "src/otel.ts"() {
     "use strict";
     init_cjs_shims();
-    import_node_path31 = __toESM(require("path"), 1);
+    import_node_path32 = __toESM(require("path"), 1);
     import_node_url2 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -380,8 +380,8 @@ __export(cli_exports, {
 });
 module.exports = __toCommonJS(cli_exports);
 init_cjs_shims();
-var import_node_path36 = __toESM(require("path"), 1);
-var import_node_fs21 = require("fs");
+var import_node_path37 = __toESM(require("path"), 1);
+var import_node_fs22 = require("fs");
 
 // src/graph.ts
 init_cjs_shims();
@@ -887,19 +887,19 @@ function confidenceFromMix(edges, now = Date.now()) {
 function longestIncomingWalk(graph, start, maxDepth) {
   let best = { path: [start], edges: [] };
   const visited = /* @__PURE__ */ new Set([start]);
-  function step(node, path37, edges) {
-    if (path37.length > best.path.length) {
-      best = { path: [...path37], edges: [...edges] };
+  function step(node, path38, edges) {
+    if (path38.length > best.path.length) {
+      best = { path: [...path38], edges: [...edges] };
     }
-    if (path37.length - 1 >= maxDepth) return;
+    if (path38.length - 1 >= maxDepth) return;
     const incoming = bestEdgeBySource(graph, graph.inboundEdges(node));
     for (const [srcId, edge] of incoming) {
       if (visited.has(srcId)) continue;
       visited.add(srcId);
-      path37.push(srcId);
+      path38.push(srcId);
       edges.push(edge);
-      step(srcId, path37, edges);
-      path37.pop();
+      step(srcId, path38, edges);
+      path38.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1936,10 +1936,10 @@ async function readErrorEvents(errorsPath) {
 
 // src/extract/services.ts
 init_cjs_shims();
-var import_node_fs6 = require("fs");
-var import_node_path6 = __toESM(require("path"), 1);
+var import_node_fs7 = require("fs");
+var import_node_path7 = __toESM(require("path"), 1);
 var import_ignore = __toESM(require("ignore"), 1);
-var import_minimatch = require("minimatch");
+var import_minimatch2 = require("minimatch");
 var import_types5 = require("@neat.is/types");
 
 // src/extract/shared.ts
@@ -2052,6 +2052,73 @@ function pythonToPackage(service) {
   };
 }
 
+// src/extract/owners.ts
+init_cjs_shims();
+var import_node_fs6 = require("fs");
+var import_node_path6 = __toESM(require("path"), 1);
+var import_minimatch = require("minimatch");
+async function loadCodeowners(scanPath) {
+  const candidates = [
+    import_node_path6.default.join(scanPath, "CODEOWNERS"),
+    import_node_path6.default.join(scanPath, ".github", "CODEOWNERS")
+  ];
+  for (const file of candidates) {
+    if (await exists(file)) {
+      const raw = await import_node_fs6.promises.readFile(file, "utf8");
+      return parseCodeowners(raw);
+    }
+  }
+  return null;
+}
+function parseCodeowners(raw) {
+  const rules = [];
+  for (const line of raw.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const match = /^(\S+)\s+(.+)$/.exec(trimmed);
+    if (!match) continue;
+    rules.push({ pattern: match[1], owners: match[2].trim() });
+  }
+  return { rules };
+}
+function matchOwner(file, repoPath) {
+  const normalized = repoPath.split(import_node_path6.default.sep).join("/");
+  for (const rule of file.rules) {
+    if (matchesPattern(rule.pattern, normalized)) return rule.owners;
+  }
+  return null;
+}
+function matchesPattern(rawPattern, repoPath) {
+  let pattern = rawPattern.startsWith("/") ? rawPattern.slice(1) : rawPattern;
+  if (pattern === "*") return !repoPath.includes("/");
+  if (pattern === "**" || pattern === "") return true;
+  if (pattern.endsWith("/")) pattern = pattern + "**";
+  if ((0, import_minimatch.minimatch)(repoPath, pattern, { dot: true })) return true;
+  if (!pattern.includes("*") && (0, import_minimatch.minimatch)(repoPath, pattern + "/**", { dot: true })) return true;
+  return false;
+}
+async function readPackageJsonAuthor(serviceDir) {
+  const pkgPath = import_node_path6.default.join(serviceDir, "package.json");
+  if (!await exists(pkgPath)) return null;
+  try {
+    const pkg = await readJson(pkgPath);
+    if (!pkg.author) return null;
+    if (typeof pkg.author === "string") return pkg.author;
+    if (typeof pkg.author === "object" && typeof pkg.author.name === "string") return pkg.author.name;
+    return null;
+  } catch {
+    return null;
+  }
+}
+async function computeServiceOwner(codeowners, repoPath, serviceDir) {
+  if (codeowners && repoPath !== void 0) {
+    const owner = matchOwner(codeowners, repoPath);
+    if (owner) return owner;
+  }
+  const author = await readPackageJsonAuthor(serviceDir);
+  return author ?? void 0;
+}
+
 // src/extract/services.ts
 var DEFAULT_SCAN_DEPTH = 5;
 function parseScanDepth() {
@@ -2068,21 +2135,21 @@ function workspaceGlobs(pkg) {
   return null;
 }
 async function loadGitignore(scanPath) {
-  const gitignorePath = import_node_path6.default.join(scanPath, ".gitignore");
+  const gitignorePath = import_node_path7.default.join(scanPath, ".gitignore");
   if (!await exists(gitignorePath)) return null;
-  const raw = await import_node_fs6.promises.readFile(gitignorePath, "utf8");
+  const raw = await import_node_fs7.promises.readFile(gitignorePath, "utf8");
   return (0, import_ignore.default)().add(raw);
 }
 async function walkDirs(start, scanPath, options, visit) {
   async function recurse(current, depth) {
     if (depth > options.maxDepth) return;
-    const entries = await import_node_fs6.promises.readdir(current, { withFileTypes: true }).catch(() => []);
+    const entries = await import_node_fs7.promises.readdir(current, { withFileTypes: true }).catch(() => []);
     for (const entry2 of entries) {
       if (!entry2.isDirectory()) continue;
       if (IGNORED_DIRS.has(entry2.name)) continue;
-      const child = import_node_path6.default.join(current, entry2.name);
+      const child = import_node_path7.default.join(current, entry2.name);
       if (options.ig) {
-        const rel = import_node_path6.default.relative(scanPath, child).split(import_node_path6.default.sep).join("/");
+        const rel = import_node_path7.default.relative(scanPath, child).split(import_node_path7.default.sep).join("/");
         if (rel && options.ig.ignores(rel + "/")) continue;
       }
       await visit(child);
@@ -2097,8 +2164,8 @@ async function expandWorkspaceGlobs(scanPath, globs) {
   for (const raw of globs) {
     const pattern = raw.replace(/^\.\//, "");
     if (!pattern.includes("*")) {
-      const candidate = import_node_path6.default.join(scanPath, pattern);
-      if (await exists(import_node_path6.default.join(candidate, "package.json"))) found.add(candidate);
+      const candidate = import_node_path7.default.join(scanPath, pattern);
+      if (await exists(import_node_path7.default.join(candidate, "package.json"))) found.add(candidate);
       continue;
     }
     const segments = pattern.split("/");
@@ -2107,13 +2174,13 @@ async function expandWorkspaceGlobs(scanPath, globs) {
       if (seg.includes("*")) break;
       staticSegments.push(seg);
     }
-    const start = import_node_path6.default.join(scanPath, ...staticSegments);
+    const start = import_node_path7.default.join(scanPath, ...staticSegments);
     if (!await exists(start)) continue;
     const hasDoubleStar = pattern.includes("**");
     const walkDepth = hasDoubleStar ? scanDepth : Math.max(0, segments.length - staticSegments.length - 1);
     await walkDirs(start, scanPath, { maxDepth: walkDepth, ig: null }, async (dir) => {
-      const rel = import_node_path6.default.relative(scanPath, dir).split(import_node_path6.default.sep).join("/");
-      if ((0, import_minimatch.minimatch)(rel, pattern) && await exists(import_node_path6.default.join(dir, "package.json"))) {
+      const rel = import_node_path7.default.relative(scanPath, dir).split(import_node_path7.default.sep).join("/");
+      if ((0, import_minimatch2.minimatch)(rel, pattern) && await exists(import_node_path7.default.join(dir, "package.json"))) {
         found.add(dir);
       }
     });
@@ -2121,9 +2188,17 @@ async function expandWorkspaceGlobs(scanPath, globs) {
   return [...found];
 }
 async function discoverNodeService(scanPath, dir) {
-  const pkgPath = import_node_path6.default.join(dir, "package.json");
+  const pkgPath = import_node_path7.default.join(dir, "package.json");
   if (!await exists(pkgPath)) return null;
-  const pkg = await readJson(pkgPath);
+  let pkg;
+  try {
+    pkg = await readJson(pkgPath);
+  } catch (err) {
+    console.warn(
+      `[neat] services skipped ${import_node_path7.default.relative(scanPath, pkgPath)}: ${err.message}`
+    );
+    return null;
+  }
   if (!pkg.name) return null;
   const node = {
     id: (0, import_types5.serviceId)(pkg.name),
@@ -2132,7 +2207,7 @@ async function discoverNodeService(scanPath, dir) {
     language: "javascript",
     version: pkg.version,
     dependencies: pkg.dependencies ?? {},
-    repoPath: import_node_path6.default.relative(scanPath, dir),
+    repoPath: import_node_path7.default.relative(scanPath, dir),
     ...pkg.engines?.node ? { nodeEngine: pkg.engines.node } : {}
   };
   return { pkg, dir, node };
@@ -2148,13 +2223,22 @@ async function discoverPyService(scanPath, dir) {
     language: "python",
     version: py.version,
     dependencies: py.dependencies,
-    repoPath: import_node_path6.default.relative(scanPath, dir)
+    repoPath: import_node_path7.default.relative(scanPath, dir)
   };
   return { pkg, dir, node };
 }
 async function discoverServices(scanPath) {
-  const rootPkgPath = import_node_path6.default.join(scanPath, "package.json");
-  const rootPkg = await exists(rootPkgPath) ? await readJson(rootPkgPath) : null;
+  const rootPkgPath = import_node_path7.default.join(scanPath, "package.json");
+  let rootPkg = null;
+  if (await exists(rootPkgPath)) {
+    try {
+      rootPkg = await readJson(rootPkgPath);
+    } catch (err) {
+      console.warn(
+        `[neat] services workspaces skipped ${import_node_path7.default.relative(scanPath, rootPkgPath)}: ${err.message}`
+      );
+    }
+  }
   const wsGlobs = rootPkg ? workspaceGlobs(rootPkg) : null;
   const candidateDirs = [];
   if (wsGlobs) {
@@ -2167,9 +2251,9 @@ async function discoverServices(scanPath) {
       scanPath,
       { maxDepth: parseScanDepth(), ig },
       async (dir) => {
-        if (await exists(import_node_path6.default.join(dir, "package.json"))) {
+        if (await exists(import_node_path7.default.join(dir, "package.json"))) {
           candidateDirs.push(dir);
-        } else if (await exists(import_node_path6.default.join(dir, "pyproject.toml")) || await exists(import_node_path6.default.join(dir, "requirements.txt")) || await exists(import_node_path6.default.join(dir, "setup.py"))) {
+        } else if (await exists(import_node_path7.default.join(dir, "pyproject.toml")) || await exists(import_node_path7.default.join(dir, "requirements.txt")) || await exists(import_node_path7.default.join(dir, "setup.py"))) {
           candidateDirs.push(dir);
         }
       }
@@ -2183,8 +2267,8 @@ async function discoverServices(scanPath) {
     if (!service) continue;
     const existingDir = seen.get(service.node.name);
     if (existingDir !== void 0) {
-      const a = import_node_path6.default.relative(scanPath, existingDir) || ".";
-      const b = import_node_path6.default.relative(scanPath, dir) || ".";
+      const a = import_node_path7.default.relative(scanPath, existingDir) || ".";
+      const b = import_node_path7.default.relative(scanPath, dir) || ".";
       console.warn(
         `[neat] duplicate package name "${service.node.name}" \u2014 keeping ${a}, ignoring ${b}`
       );
@@ -2193,6 +2277,11 @@ async function discoverServices(scanPath) {
     seen.set(service.node.name, dir);
     out.push(service);
   }
+  const codeowners = await loadCodeowners(scanPath);
+  for (const service of out) {
+    const owner = await computeServiceOwner(codeowners, service.node.repoPath, service.dir);
+    if (owner !== void 0) service.node.owner = owner;
+  }
   return out;
 }
 function addServiceNodes(graph, services) {
@@ -2216,8 +2305,8 @@ function addServiceNodes(graph, services) {
 
 // src/extract/aliases.ts
 init_cjs_shims();
-var import_node_path7 = __toESM(require("path"), 1);
-var import_node_fs7 = require("fs");
+var import_node_path8 = __toESM(require("path"), 1);
+var import_node_fs8 = require("fs");
 var import_yaml2 = require("yaml");
 var import_types6 = require("@neat.is/types");
 var K8S_KINDS_WITH_HOSTNAMES = /* @__PURE__ */ new Set([
@@ -2244,21 +2333,29 @@ function indexServicesByName(services) {
   const map = /* @__PURE__ */ new Map();
   for (const s of services) {
     map.set(s.node.name, s.node.id);
-    map.set(import_node_path7.default.basename(s.dir), s.node.id);
+    map.set(import_node_path8.default.basename(s.dir), s.node.id);
   }
   return map;
 }
 async function collectComposeAliases(graph, scanPath, serviceIndex) {
   let composePath = null;
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = import_node_path7.default.join(scanPath, name);
+    const abs = import_node_path8.default.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
     }
   }
   if (!composePath) return;
-  const compose = await readYaml(composePath);
+  let compose;
+  try {
+    compose = await readYaml(composePath);
+  } catch (err) {
+    console.warn(
+      `[neat] aliases compose skipped ${import_node_path8.default.relative(scanPath, composePath)}: ${err.message}`
+    );
+    return;
+  }
   if (!compose?.services) return;
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const serviceId3 = serviceIndex.get(composeName);
@@ -2297,9 +2394,17 @@ function parseDockerfileLabels(content) {
 }
 async function collectDockerfileAliases(graph, services) {
   for (const service of services) {
-    const dockerfilePath = import_node_path7.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path8.default.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
-    const content = await import_node_fs7.promises.readFile(dockerfilePath, "utf8");
+    let content;
+    try {
+      content = await import_node_fs8.promises.readFile(dockerfilePath, "utf8");
+    } catch (err) {
+      console.warn(
+        `[neat] aliases dockerfile skipped ${dockerfilePath}: ${err.message}`
+      );
+      continue;
+    }
     const aliases = parseDockerfileLabels(content);
     if (aliases.length > 0) addAliases(graph, service.node.id, aliases);
   }
@@ -2307,13 +2412,13 @@ async function collectDockerfileAliases(graph, services) {
 async function walkYamlFiles(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await import_node_fs7.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs8.promises.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry2 of entries) {
     if (entry2.isDirectory()) {
       if (IGNORED_DIRS.has(entry2.name)) continue;
-      out.push(...await walkYamlFiles(import_node_path7.default.join(start, entry2.name), depth + 1, max));
-    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path7.default.extname(entry2.name))) {
-      out.push(import_node_path7.default.join(start, entry2.name));
+      out.push(...await walkYamlFiles(import_node_path8.default.join(start, entry2.name), depth + 1, max));
+    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path8.default.extname(entry2.name))) {
+      out.push(import_node_path8.default.join(start, entry2.name));
     }
   }
   return out;
@@ -2340,7 +2445,7 @@ function k8sServiceTarget(doc, byName) {
 async function collectK8sAliases(graph, scanPath, serviceIndex) {
   const files = await walkYamlFiles(scanPath);
   for (const file of files) {
-    const content = await import_node_fs7.promises.readFile(file, "utf8");
+    const content = await import_node_fs8.promises.readFile(file, "utf8");
     let docs;
     try {
       docs = (0, import_yaml2.parseAllDocuments)(content).map((d) => d.toJSON());
@@ -2365,14 +2470,14 @@ async function addServiceAliases(graph, scanPath, services) {
 
 // src/extract/databases/index.ts
 init_cjs_shims();
-var import_node_path15 = __toESM(require("path"), 1);
+var import_node_path16 = __toESM(require("path"), 1);
 var import_types7 = require("@neat.is/types");
 
 // src/extract/databases/db-config-yaml.ts
 init_cjs_shims();
-var import_node_path8 = __toESM(require("path"), 1);
+var import_node_path9 = __toESM(require("path"), 1);
 async function parse(serviceDir) {
-  const yamlPath = import_node_path8.default.join(serviceDir, "db-config.yaml");
+  const yamlPath = import_node_path9.default.join(serviceDir, "db-config.yaml");
   if (!await exists(yamlPath)) return [];
   const raw = await readYaml(yamlPath);
   return [
@@ -2390,13 +2495,13 @@ var dbConfigYamlParser = { name: "db-config.yaml", parse };
 
 // src/extract/databases/dotenv.ts
 init_cjs_shims();
-var import_node_fs9 = require("fs");
-var import_node_path10 = __toESM(require("path"), 1);
+var import_node_fs10 = require("fs");
+var import_node_path11 = __toESM(require("path"), 1);
 
 // src/extract/databases/shared.ts
 init_cjs_shims();
-var import_node_fs8 = require("fs");
-var import_node_path9 = __toESM(require("path"), 1);
+var import_node_fs9 = require("fs");
+var import_node_path10 = __toESM(require("path"), 1);
 function schemeToEngine(scheme) {
   const s = scheme.toLowerCase().split("+")[0];
   switch (s) {
@@ -2435,14 +2540,14 @@ function parseConnectionString(url) {
 }
 async function readIfExists(filePath) {
   try {
-    return await import_node_fs8.promises.readFile(filePath, "utf8");
+    return await import_node_fs9.promises.readFile(filePath, "utf8");
   } catch {
     return null;
   }
 }
 async function findFirst(serviceDir, candidates) {
   for (const rel of candidates) {
-    const abs = import_node_path9.default.join(serviceDir, rel);
+    const abs = import_node_path10.default.join(serviceDir, rel);
     const content = await readIfExists(abs);
     if (content !== null) return abs;
   }
@@ -2493,15 +2598,15 @@ function parseDotenvLine(line) {
   return { key, value };
 }
 async function parse2(serviceDir) {
-  const entries = await import_node_fs9.promises.readdir(serviceDir, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs10.promises.readdir(serviceDir, { withFileTypes: true }).catch(() => []);
   const configs = [];
   const seen = /* @__PURE__ */ new Set();
   for (const entry2 of entries) {
     if (!entry2.isFile()) continue;
     const match = isConfigFile(entry2.name);
     if (!match.match || match.fileType !== "env") continue;
-    const filePath = import_node_path10.default.join(serviceDir, entry2.name);
-    const content = await import_node_fs9.promises.readFile(filePath, "utf8");
+    const filePath = import_node_path11.default.join(serviceDir, entry2.name);
+    const content = await import_node_fs10.promises.readFile(filePath, "utf8");
     for (const line of content.split("\n")) {
       const parsed = parseDotenvLine(line);
       if (!parsed) continue;
@@ -2520,9 +2625,9 @@ var dotenvParser = { name: ".env", parse: parse2 };
 
 // src/extract/databases/prisma.ts
 init_cjs_shims();
-var import_node_path11 = __toESM(require("path"), 1);
+var import_node_path12 = __toESM(require("path"), 1);
 async function parse3(serviceDir) {
-  const schemaPath = import_node_path11.default.join(serviceDir, "prisma", "schema.prisma");
+  const schemaPath = import_node_path12.default.join(serviceDir, "prisma", "schema.prisma");
   const content = await readIfExists(schemaPath);
   if (!content) return [];
   const block = content.match(/datasource\s+\w+\s*\{([^}]*)\}/s);
@@ -2654,10 +2759,10 @@ var knexParser = { name: "knex", parse: parse5 };
 
 // src/extract/databases/ormconfig.ts
 init_cjs_shims();
-var import_node_path12 = __toESM(require("path"), 1);
+var import_node_path13 = __toESM(require("path"), 1);
 async function parse6(serviceDir) {
   for (const candidate of ["ormconfig.json", "ormconfig.yaml", "ormconfig.yml"]) {
-    const abs = import_node_path12.default.join(serviceDir, candidate);
+    const abs = import_node_path13.default.join(serviceDir, candidate);
     if (!await exists(abs)) continue;
     const raw = candidate.endsWith(".json") ? await readJson(abs) : await readYaml(abs);
     const entries = Array.isArray(raw) ? raw : [raw];
@@ -2717,9 +2822,9 @@ var typeormParser = { name: "typeorm", parse: parse7 };
 
 // src/extract/databases/sequelize.ts
 init_cjs_shims();
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 async function parse8(serviceDir) {
-  const configPath = import_node_path13.default.join(serviceDir, "config", "config.json");
+  const configPath = import_node_path14.default.join(serviceDir, "config", "config.json");
   if (!await exists(configPath)) return [];
   const raw = await readJson(configPath);
   const out = [];
@@ -2746,7 +2851,7 @@ var sequelizeParser = { name: "sequelize", parse: parse8 };
 
 // src/extract/databases/docker-compose.ts
 init_cjs_shims();
-var import_node_path14 = __toESM(require("path"), 1);
+var import_node_path15 = __toESM(require("path"), 1);
 function portFromService(svc) {
   for (const raw of svc.ports ?? []) {
     const str = String(raw);
@@ -2773,7 +2878,7 @@ function databaseFromEnv(svc) {
 }
 async function parse9(serviceDir) {
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = import_node_path14.default.join(serviceDir, name);
+    const abs = import_node_path15.default.join(serviceDir, name);
     if (!await exists(abs)) continue;
     const raw = await readYaml(abs);
     if (!raw?.services) return [];
@@ -2953,7 +3058,7 @@ async function addDatabasesAndCompat(graph, services, scanPath) {
         provenance: import_types7.Provenance.EXTRACTED,
         ...config.sourceFile ? {
           evidence: {
-            file: import_node_path15.default.relative(scanPath, config.sourceFile).split(import_node_path15.default.sep).join("/")
+            file: import_node_path16.default.relative(scanPath, config.sourceFile).split(import_node_path16.default.sep).join("/")
           }
         } : {}
       };
@@ -2981,15 +3086,15 @@ async function addDatabasesAndCompat(graph, services, scanPath) {
 
 // src/extract/configs.ts
 init_cjs_shims();
-var import_node_fs10 = require("fs");
-var import_node_path16 = __toESM(require("path"), 1);
+var import_node_fs11 = require("fs");
+var import_node_path17 = __toESM(require("path"), 1);
 var import_types8 = require("@neat.is/types");
 async function walkConfigFiles(dir) {
   const out = [];
   async function walk(current) {
-    const entries = await import_node_fs10.promises.readdir(current, { withFileTypes: true });
+    const entries = await import_node_fs11.promises.readdir(current, { withFileTypes: true });
     for (const entry2 of entries) {
-      const full = import_node_path16.default.join(current, entry2.name);
+      const full = import_node_path17.default.join(current, entry2.name);
       if (entry2.isDirectory()) {
         if (!IGNORED_DIRS.has(entry2.name)) await walk(full);
       } else if (entry2.isFile() && isConfigFile(entry2.name).match) {
@@ -3006,13 +3111,13 @@ async function addConfigNodes(graph, services, scanPath) {
   for (const service of services) {
     const configFiles = await walkConfigFiles(service.dir);
     for (const file of configFiles) {
-      const relPath = import_node_path16.default.relative(scanPath, file);
+      const relPath = import_node_path17.default.relative(scanPath, file);
       const node = {
         id: (0, import_types8.configId)(relPath),
         type: import_types8.NodeType.ConfigNode,
-        name: import_node_path16.default.basename(file),
+        name: import_node_path17.default.basename(file),
         path: relPath,
-        fileType: isConfigFile(import_node_path16.default.basename(file)).fileType
+        fileType: isConfigFile(import_node_path17.default.basename(file)).fileType
       };
       if (!graph.hasNode(node.id)) {
         graph.addNode(node.id, node);
@@ -3024,7 +3129,7 @@ async function addConfigNodes(graph, services, scanPath) {
         target: node.id,
         type: import_types8.EdgeType.CONFIGURED_BY,
         provenance: import_types8.Provenance.EXTRACTED,
-        evidence: { file: relPath.split(import_node_path16.default.sep).join("/") }
+        evidence: { file: relPath.split(import_node_path17.default.sep).join("/") }
       };
       if (!graph.hasEdge(edge.id)) {
         graph.addEdgeWithKey(edge.id, edge.source, edge.target, edge);
@@ -3041,7 +3146,7 @@ var import_types14 = require("@neat.is/types");
 
 // src/extract/calls/http.ts
 init_cjs_shims();
-var import_node_path18 = __toESM(require("path"), 1);
+var import_node_path19 = __toESM(require("path"), 1);
 var import_tree_sitter = __toESM(require("tree-sitter"), 1);
 var import_tree_sitter_javascript = __toESM(require("tree-sitter-javascript"), 1);
 var import_tree_sitter_python = __toESM(require("tree-sitter-python"), 1);
@@ -3049,17 +3154,17 @@ var import_types9 = require("@neat.is/types");
 
 // src/extract/calls/shared.ts
 init_cjs_shims();
-var import_node_fs11 = require("fs");
-var import_node_path17 = __toESM(require("path"), 1);
+var import_node_fs12 = require("fs");
+var import_node_path18 = __toESM(require("path"), 1);
 async function walkSourceFiles(dir) {
   const out = [];
   async function walk(current) {
-    const entries = await import_node_fs11.promises.readdir(current, { withFileTypes: true }).catch(() => []);
+    const entries = await import_node_fs12.promises.readdir(current, { withFileTypes: true }).catch(() => []);
     for (const entry2 of entries) {
-      const full = import_node_path17.default.join(current, entry2.name);
+      const full = import_node_path18.default.join(current, entry2.name);
       if (entry2.isDirectory()) {
         if (!IGNORED_DIRS.has(entry2.name)) await walk(full);
-      } else if (entry2.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path17.default.extname(entry2.name))) {
+      } else if (entry2.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path18.default.extname(entry2.name))) {
         out.push(full);
       }
     }
@@ -3072,7 +3177,7 @@ async function loadSourceFiles(dir) {
   const out = [];
   for (const p of paths) {
     try {
-      const content = await import_node_fs11.promises.readFile(p, "utf8");
+      const content = await import_node_fs12.promises.readFile(p, "utf8");
       out.push({ path: p, content });
     } catch {
     }
@@ -3128,9 +3233,9 @@ async function addHttpCallEdges(graph, services) {
   const knownHosts = /* @__PURE__ */ new Set();
   const hostToNodeId = /* @__PURE__ */ new Map();
   for (const service of services) {
-    knownHosts.add(import_node_path18.default.basename(service.dir));
+    knownHosts.add(import_node_path19.default.basename(service.dir));
     knownHosts.add(service.pkg.name);
-    hostToNodeId.set(import_node_path18.default.basename(service.dir), service.node.id);
+    hostToNodeId.set(import_node_path19.default.basename(service.dir), service.node.id);
     hostToNodeId.set(service.pkg.name, service.node.id);
   }
   let edgesAdded = 0;
@@ -3138,7 +3243,7 @@ async function addHttpCallEdges(graph, services) {
     const files = await loadSourceFiles(service.dir);
     const seenTargets = /* @__PURE__ */ new Map();
     for (const file of files) {
-      const parser = import_node_path18.default.extname(file.path) === ".py" ? pyParser : jsParser;
+      const parser = import_node_path19.default.extname(file.path) === ".py" ? pyParser : jsParser;
       let targets;
       try {
         targets = callsFromSource(file.content, parser, knownHosts);
@@ -3166,7 +3271,7 @@ async function addHttpCallEdges(graph, services) {
         type: import_types9.EdgeType.CALLS,
         provenance: import_types9.Provenance.EXTRACTED,
         evidence: {
-          file: import_node_path18.default.relative(service.dir, evidenceFile.file),
+          file: import_node_path19.default.relative(service.dir, evidenceFile.file),
           line,
           snippet: snippet(fileContent, line)
         }
@@ -3182,7 +3287,7 @@ async function addHttpCallEdges(graph, services) {
 
 // src/extract/calls/kafka.ts
 init_cjs_shims();
-var import_node_path19 = __toESM(require("path"), 1);
+var import_node_path20 = __toESM(require("path"), 1);
 var import_types10 = require("@neat.is/types");
 var PRODUCER_TOPIC_RE = /(?:producer|kafkaProducer)[\s\S]{0,40}?\.send\s*\(\s*\{[\s\S]{0,200}?topic\s*:\s*['"`]([^'"`]+)['"`]/g;
 var CONSUMER_TOPIC_RE = /(?:consumer|kafkaConsumer)[\s\S]{0,40}?\.(?:subscribe|run)\s*\(\s*\{[\s\S]{0,200}?topic[s]?\s*:\s*(?:\[\s*)?['"`]([^'"`]+)['"`]/g;
@@ -3209,7 +3314,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
       kind: "kafka-topic",
       edgeType,
       evidence: {
-        file: import_node_path19.default.relative(serviceDir, file.path),
+        file: import_node_path20.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -3222,7 +3327,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/redis.ts
 init_cjs_shims();
-var import_node_path20 = __toESM(require("path"), 1);
+var import_node_path21 = __toESM(require("path"), 1);
 var import_types11 = require("@neat.is/types");
 var REDIS_URL_RE = /redis(?:s)?:\/\/(?:[^@'"`\s]+@)?([^:/'"`\s]+)(?::(\d+))?/g;
 function redisEndpointsFromFile(file, serviceDir) {
@@ -3241,7 +3346,7 @@ function redisEndpointsFromFile(file, serviceDir) {
       kind: "redis",
       edgeType: "CALLS",
       evidence: {
-        file: import_node_path20.default.relative(serviceDir, file.path),
+        file: import_node_path21.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -3252,7 +3357,7 @@ function redisEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/aws.ts
 init_cjs_shims();
-var import_node_path21 = __toESM(require("path"), 1);
+var import_node_path22 = __toESM(require("path"), 1);
 var import_types12 = require("@neat.is/types");
 var S3_BUCKET_RE = /Bucket\s*:\s*['"`]([^'"`]+)['"`]/g;
 var DYNAMO_TABLE_RE = /TableName\s*:\s*['"`]([^'"`]+)['"`]/g;
@@ -3282,7 +3387,7 @@ function awsEndpointsFromFile(file, serviceDir) {
       kind,
       edgeType: "CALLS",
       evidence: {
-        file: import_node_path21.default.relative(serviceDir, file.path),
+        file: import_node_path22.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -3307,7 +3412,7 @@ function awsEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/grpc.ts
 init_cjs_shims();
-var import_node_path22 = __toESM(require("path"), 1);
+var import_node_path23 = __toESM(require("path"), 1);
 var import_types13 = require("@neat.is/types");
 var GRPC_CLIENT_RE = /new\s+([A-Z][A-Za-z0-9_]*)Client\s*\(\s*['"`]?([^,'"`)]+)?/g;
 function isLikelyAddress(value) {
@@ -3332,7 +3437,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
       kind: "grpc-service",
       edgeType: "CALLS",
       evidence: {
-        file: import_node_path22.default.relative(serviceDir, file.path),
+        file: import_node_path23.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -3412,7 +3517,7 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path23 = __toESM(require("path"), 1);
+var import_node_path24 = __toESM(require("path"), 1);
 var import_types16 = require("@neat.is/types");
 
 // src/extract/infra/shared.ts
@@ -3450,7 +3555,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path23.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path24.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -3459,16 +3564,24 @@ async function addComposeInfra(graph, scanPath, services) {
   let edgesAdded = 0;
   let composePath = null;
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = import_node_path23.default.join(scanPath, name);
+    const abs = import_node_path24.default.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
     }
   }
   if (!composePath) return { nodesAdded, edgesAdded };
-  const compose = await readYaml(composePath);
+  let compose;
+  try {
+    compose = await readYaml(composePath);
+  } catch (err) {
+    console.warn(
+      `[neat] infra docker-compose skipped ${import_node_path24.default.relative(scanPath, composePath)}: ${err.message}`
+    );
+    return { nodesAdded, edgesAdded };
+  }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path23.default.relative(scanPath, composePath).split(import_node_path23.default.sep).join("/");
+  const evidenceFile = import_node_path24.default.relative(scanPath, composePath).split(import_node_path24.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -3509,8 +3622,8 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path24 = __toESM(require("path"), 1);
-var import_node_fs12 = require("fs");
+var import_node_path25 = __toESM(require("path"), 1);
+var import_node_fs13 = require("fs");
 var import_types17 = require("@neat.is/types");
 function runtimeImage(content) {
   const lines = content.split("\n");
@@ -3530,9 +3643,17 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path24.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path25.default.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
-    const content = await import_node_fs12.promises.readFile(dockerfilePath, "utf8");
+    let content;
+    try {
+      content = await import_node_fs13.promises.readFile(dockerfilePath, "utf8");
+    } catch (err) {
+      console.warn(
+        `[neat] infra dockerfile skipped ${import_node_path25.default.relative(scanPath, dockerfilePath)}: ${err.message}`
+      );
+      continue;
+    }
     const image = runtimeImage(content);
     if (!image) continue;
     const node = makeInfraNode("container-image", image);
@@ -3549,7 +3670,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
         type: import_types17.EdgeType.RUNS_ON,
         provenance: import_types17.Provenance.EXTRACTED,
         evidence: {
-          file: import_node_path24.default.relative(scanPath, dockerfilePath).split(import_node_path24.default.sep).join("/")
+          file: import_node_path25.default.relative(scanPath, dockerfilePath).split(import_node_path25.default.sep).join("/")
         }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -3561,19 +3682,19 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 
 // src/extract/infra/terraform.ts
 init_cjs_shims();
-var import_node_fs13 = require("fs");
-var import_node_path25 = __toESM(require("path"), 1);
+var import_node_fs14 = require("fs");
+var import_node_path26 = __toESM(require("path"), 1);
 var RESOURCE_RE = /resource\s+"(aws_[A-Za-z0-9_]+)"\s+"([A-Za-z0-9_-]+)"/g;
 async function walkTfFiles(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await import_node_fs13.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs14.promises.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry2 of entries) {
     if (entry2.isDirectory()) {
       if (IGNORED_DIRS.has(entry2.name) || entry2.name === ".terraform") continue;
-      out.push(...await walkTfFiles(import_node_path25.default.join(start, entry2.name), depth + 1, max));
+      out.push(...await walkTfFiles(import_node_path26.default.join(start, entry2.name), depth + 1, max));
     } else if (entry2.isFile() && entry2.name.endsWith(".tf")) {
-      out.push(import_node_path25.default.join(start, entry2.name));
+      out.push(import_node_path26.default.join(start, entry2.name));
     }
   }
   return out;
@@ -3582,7 +3703,7 @@ async function addTerraformResources(graph, scanPath) {
   let nodesAdded = 0;
   const files = await walkTfFiles(scanPath);
   for (const file of files) {
-    const content = await import_node_fs13.promises.readFile(file, "utf8");
+    const content = await import_node_fs14.promises.readFile(file, "utf8");
     RESOURCE_RE.lastIndex = 0;
     let m;
     while ((m = RESOURCE_RE.exec(content)) !== null) {
@@ -3600,8 +3721,8 @@ async function addTerraformResources(graph, scanPath) {
 
 // src/extract/infra/k8s.ts
 init_cjs_shims();
-var import_node_fs14 = require("fs");
-var import_node_path26 = __toESM(require("path"), 1);
+var import_node_fs15 = require("fs");
+var import_node_path27 = __toESM(require("path"), 1);
 var import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -3615,13 +3736,13 @@ var K8S_KIND_TO_INFRA_KIND = {
 async function walkYamlFiles2(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await import_node_fs14.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs15.promises.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry2 of entries) {
     if (entry2.isDirectory()) {
       if (IGNORED_DIRS.has(entry2.name)) continue;
-      out.push(...await walkYamlFiles2(import_node_path26.default.join(start, entry2.name), depth + 1, max));
-    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path26.default.extname(entry2.name))) {
-      out.push(import_node_path26.default.join(start, entry2.name));
+      out.push(...await walkYamlFiles2(import_node_path27.default.join(start, entry2.name), depth + 1, max));
+    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path27.default.extname(entry2.name))) {
+      out.push(import_node_path27.default.join(start, entry2.name));
     }
   }
   return out;
@@ -3630,7 +3751,7 @@ async function addK8sResources(graph, scanPath) {
   let nodesAdded = 0;
   const files = await walkYamlFiles2(scanPath);
   for (const file of files) {
-    const content = await import_node_fs14.promises.readFile(file, "utf8");
+    const content = await import_node_fs15.promises.readFile(file, "utf8");
     let docs;
     try {
       docs = (0, import_yaml3.parseAllDocuments)(content).map((d) => d.toJSON());
@@ -3696,8 +3817,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
 
 // src/persist.ts
 init_cjs_shims();
-var import_node_fs15 = require("fs");
-var import_node_path27 = __toESM(require("path"), 1);
+var import_node_fs16 = require("fs");
+var import_node_path28 = __toESM(require("path"), 1);
 var SCHEMA_VERSION = 2;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -3711,7 +3832,7 @@ function migrateV1ToV2(payload) {
   return { ...payload, schemaVersion: 2 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs15.promises.mkdir(import_node_path27.default.dirname(filePath), { recursive: true });
+  await import_node_fs16.promises.mkdir(import_node_path28.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -3721,13 +3842,13 @@ async function saveGraphToDisk(graph, outPath) {
     graph: graph.export()
   };
   const tmp = `${outPath}.tmp`;
-  await import_node_fs15.promises.writeFile(tmp, JSON.stringify(payload), "utf8");
-  await import_node_fs15.promises.rename(tmp, outPath);
+  await import_node_fs16.promises.writeFile(tmp, JSON.stringify(payload), "utf8");
+  await import_node_fs16.promises.rename(tmp, outPath);
 }
 async function loadGraphFromDisk(graph, outPath) {
   let raw;
   try {
-    raw = await import_node_fs15.promises.readFile(outPath, "utf8");
+    raw = await import_node_fs16.promises.readFile(outPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") return;
     throw err;
@@ -3780,18 +3901,255 @@ function startPersistLoop(graph, outPath, intervalMs = 6e4) {
 
 // src/watch.ts
 init_cjs_shims();
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_path34 = __toESM(require("path"), 1);
 var import_chokidar = __toESM(require("chokidar"), 1);
 
 // src/api.ts
 init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
-var import_types19 = require("@neat.is/types");
+var import_types20 = require("@neat.is/types");
+
+// src/divergences.ts
+init_cjs_shims();
+var import_types18 = require("@neat.is/types");
+function bucketKey(source, target, type) {
+  return `${type}|${source}|${target}`;
+}
+function bucketEdges(graph) {
+  const buckets = /* @__PURE__ */ new Map();
+  graph.forEachEdge((id, attrs) => {
+    const e = attrs;
+    const parsed = (0, import_types18.parseEdgeId)(id);
+    const provenance = parsed?.provenance ?? e.provenance;
+    const key = bucketKey(e.source, e.target, e.type);
+    const cur = buckets.get(key) ?? { source: e.source, target: e.target, type: e.type };
+    switch (provenance) {
+      case import_types18.Provenance.EXTRACTED:
+        cur.extracted = e;
+        break;
+      case import_types18.Provenance.OBSERVED:
+        cur.observed = e;
+        break;
+      case import_types18.Provenance.INFERRED:
+        cur.inferred = e;
+        break;
+      case import_types18.Provenance.FRONTIER:
+        cur.frontier = e;
+        break;
+      default:
+        if (e.provenance === import_types18.Provenance.STALE) cur.stale = e;
+    }
+    buckets.set(key, cur);
+  });
+  return buckets;
+}
+function nodeIsFrontier(graph, nodeId) {
+  if (!graph.hasNode(nodeId)) return false;
+  const attrs = graph.getNodeAttributes(nodeId);
+  return attrs.type === import_types18.NodeType.FrontierNode;
+}
+function hasAnyObservedFromSource(graph, sourceId) {
+  if (!graph.hasNode(sourceId)) return false;
+  for (const edgeId of graph.outboundEdges(sourceId)) {
+    const e = graph.getEdgeAttributes(edgeId);
+    if (e.provenance === import_types18.Provenance.OBSERVED) return true;
+  }
+  return false;
+}
+function clampConfidence(n) {
+  if (!Number.isFinite(n)) return 0;
+  return Math.max(0, Math.min(1, n));
+}
+function reasonForMissingObserved(source, target, type) {
+  return `Code declares ${source} \u2192 ${target} (${type}) but no production traffic has been observed for this edge.`;
+}
+function reasonForMissingExtracted(source, target, type) {
+  return `Production observed ${source} \u2192 ${target} (${type}) but static analysis did not surface this edge.`;
+}
+var RECOMMENDATION_MISSING_OBSERVED = "Verify the code path is exercised in production; check feature flags or conditional branches that might gate the call.";
+var RECOMMENDATION_MISSING_EXTRACTED = "Likely dynamic dispatch, reflection, or a coverage gap in tree-sitter extraction. Consider an `aliases` entry on the source service or file an extractor issue.";
+var RECOMMENDATION_HOST_MISMATCH = "Check environment-specific config overrides \u2014 the runtime host differs from what static configuration declares.";
+function detectMissingDivergences(graph, bucket) {
+  const out = [];
+  if (bucket.extracted && !bucket.observed) {
+    if (!nodeIsFrontier(graph, bucket.target)) {
+      const sourceHasTraffic = hasAnyObservedFromSource(graph, bucket.source);
+      out.push({
+        type: "missing-observed",
+        source: bucket.source,
+        target: bucket.target,
+        edgeType: bucket.type,
+        extracted: bucket.extracted,
+        confidence: sourceHasTraffic ? 1 : 0.5,
+        reason: reasonForMissingObserved(bucket.source, bucket.target, bucket.type),
+        recommendation: RECOMMENDATION_MISSING_OBSERVED
+      });
+    }
+  }
+  if (bucket.observed && !bucket.extracted) {
+    const cascaded = clampConfidence(confidenceForEdge(bucket.observed));
+    out.push({
+      type: "missing-extracted",
+      source: bucket.source,
+      target: bucket.target,
+      edgeType: bucket.type,
+      observed: bucket.observed,
+      confidence: cascaded,
+      reason: reasonForMissingExtracted(bucket.source, bucket.target, bucket.type),
+      recommendation: RECOMMENDATION_MISSING_EXTRACTED
+    });
+  }
+  return out;
+}
+function declaredHostFor(svc) {
+  const raw = svc.dbConnectionTarget?.trim();
+  if (!raw) return null;
+  const colon = raw.lastIndexOf(":");
+  if (colon === -1) return raw;
+  const port = raw.slice(colon + 1);
+  if (/^\d+$/.test(port)) return raw.slice(0, colon);
+  return raw;
+}
+function hasExtractedConfiguredBy(graph, svcId) {
+  for (const edgeId of graph.outboundEdges(svcId)) {
+    const e = graph.getEdgeAttributes(edgeId);
+    if (e.type === import_types18.EdgeType.CONFIGURED_BY && e.provenance === import_types18.Provenance.EXTRACTED) {
+      return true;
+    }
+  }
+  return false;
+}
+function detectHostMismatch(graph, svcId, svc) {
+  const declaredHost = declaredHostFor(svc);
+  if (!declaredHost) return [];
+  if (!hasExtractedConfiguredBy(graph, svcId)) return [];
+  const out = [];
+  for (const edgeId of graph.outboundEdges(svcId)) {
+    const edge = graph.getEdgeAttributes(edgeId);
+    if (edge.type !== import_types18.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types18.Provenance.OBSERVED) continue;
+    const target = graph.getNodeAttributes(edge.target);
+    if (target.type !== import_types18.NodeType.DatabaseNode) continue;
+    const observedHost = target.host?.trim();
+    if (!observedHost) continue;
+    if (observedHost === declaredHost) continue;
+    out.push({
+      type: "host-mismatch",
+      source: svcId,
+      target: edge.target,
+      extractedHost: declaredHost,
+      observedHost,
+      confidence: clampConfidence(confidenceForEdge(edge)),
+      reason: `Config declares ${svcId} connects to ${declaredHost}; production connects to ${observedHost}.`,
+      recommendation: RECOMMENDATION_HOST_MISMATCH
+    });
+  }
+  return out;
+}
+function detectCompatDivergences(graph, svcId, svc) {
+  const out = [];
+  const deps = svc.dependencies ?? {};
+  for (const edgeId of graph.outboundEdges(svcId)) {
+    const edge = graph.getEdgeAttributes(edgeId);
+    if (edge.type !== import_types18.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types18.Provenance.OBSERVED) continue;
+    const target = graph.getNodeAttributes(edge.target);
+    if (target.type !== import_types18.NodeType.DatabaseNode) continue;
+    for (const pair of compatPairs()) {
+      if (pair.engine !== target.engine) continue;
+      const declared = deps[pair.driver];
+      if (!declared) continue;
+      const result = checkCompatibility(
+        pair.driver,
+        declared,
+        target.engine,
+        target.engineVersion
+      );
+      if (!result.compatible && result.reason) {
+        out.push({
+          type: "version-mismatch",
+          source: svcId,
+          target: edge.target,
+          extractedVersion: declared,
+          observedVersion: target.engineVersion,
+          compatibility: "incompatible",
+          confidence: 1,
+          reason: result.reason,
+          recommendation: result.minDriverVersion ? `Upgrade ${pair.driver} to >= ${result.minDriverVersion}.` : `Update the ${pair.driver} driver to a version compatible with ${target.engine} ${target.engineVersion}.`
+        });
+      }
+    }
+    for (const rule of deprecatedApis()) {
+      const declared = deps[rule.package];
+      if (!declared) continue;
+      const result = checkDeprecatedApi(rule, declared);
+      if (!result.compatible && result.reason) {
+        const ruleRef = {
+          kind: rule.kind ?? "deprecated-api",
+          reason: result.reason,
+          package: rule.package
+        };
+        out.push({
+          type: "compat-violation",
+          source: svcId,
+          target: edge.target,
+          rule: ruleRef,
+          observed: edge,
+          confidence: 1,
+          reason: result.reason,
+          recommendation: `Replace deprecated ${rule.package}@${declared} with a supported version.`
+        });
+      }
+    }
+  }
+  return out;
+}
+function involvesNode(d, nodeId) {
+  return d.source === nodeId || d.target === nodeId;
+}
+function computeDivergences(graph, opts = {}) {
+  const all = [];
+  const buckets = bucketEdges(graph);
+  for (const bucket of buckets.values()) {
+    for (const d of detectMissingDivergences(graph, bucket)) all.push(d);
+  }
+  graph.forEachNode((nodeId, attrs) => {
+    const n = attrs;
+    if (n.type !== import_types18.NodeType.ServiceNode) return;
+    const svc = n;
+    for (const d of detectHostMismatch(graph, nodeId, svc)) all.push(d);
+    for (const d of detectCompatDivergences(graph, nodeId, svc)) all.push(d);
+  });
+  let filtered = all;
+  if (opts.type) {
+    const allowed = opts.type;
+    filtered = filtered.filter((d) => allowed.has(d.type));
+  }
+  if (opts.minConfidence !== void 0) {
+    const threshold = opts.minConfidence;
+    filtered = filtered.filter((d) => d.confidence >= threshold);
+  }
+  if (opts.node) {
+    const target = opts.node;
+    filtered = filtered.filter((d) => involvesNode(d, target));
+  }
+  filtered.sort((a, b) => {
+    if (b.confidence !== a.confidence) return b.confidence - a.confidence;
+    if (a.type !== b.type) return a.type.localeCompare(b.type);
+    if (a.source !== b.source) return a.source.localeCompare(b.source);
+    return a.target.localeCompare(b.target);
+  });
+  return import_types18.DivergenceResultSchema.parse({
+    divergences: filtered,
+    totalAffected: filtered.length,
+    computedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
 
 // src/diff.ts
 init_cjs_shims();
-var import_node_fs16 = require("fs");
+var import_node_fs17 = require("fs");
 async function loadSnapshotForDiff(target) {
   if (/^https?:\/\//i.test(target)) {
     const res = await fetch(target);
@@ -3800,7 +4158,7 @@ async function loadSnapshotForDiff(target) {
     }
     return await res.json();
   }
-  const raw = await import_node_fs16.promises.readFile(target, "utf8");
+  const raw = await import_node_fs17.promises.readFile(target, "utf8");
   return JSON.parse(raw);
 }
 function indexEntries(entries) {
@@ -3868,23 +4226,23 @@ function canonicalJson(value) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path28 = __toESM(require("path"), 1);
+var import_node_path29 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path28.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path28.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path28.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path28.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path28.default.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: import_node_path29.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path29.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path29.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path29.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path29.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: import_node_path28.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path28.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path28.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path28.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path28.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: import_node_path29.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path29.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path29.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path29.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path29.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -3920,49 +4278,49 @@ var Projects = class {
 
 // src/registry.ts
 init_cjs_shims();
-var import_node_fs17 = require("fs");
+var import_node_fs18 = require("fs");
 var import_node_os2 = __toESM(require("os"), 1);
-var import_node_path29 = __toESM(require("path"), 1);
-var import_types18 = require("@neat.is/types");
+var import_node_path30 = __toESM(require("path"), 1);
+var import_types19 = require("@neat.is/types");
 var LOCK_TIMEOUT_MS = 5e3;
 var LOCK_RETRY_MS = 50;
 function neatHome() {
   const override = process.env.NEAT_HOME;
-  if (override && override.length > 0) return import_node_path29.default.resolve(override);
-  return import_node_path29.default.join(import_node_os2.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path30.default.resolve(override);
+  return import_node_path30.default.join(import_node_os2.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path29.default.join(neatHome(), "projects.json");
+  return import_node_path30.default.join(neatHome(), "projects.json");
 }
 function registryLockPath() {
-  return import_node_path29.default.join(neatHome(), "projects.json.lock");
+  return import_node_path30.default.join(neatHome(), "projects.json.lock");
 }
 async function normalizeProjectPath(input) {
-  const resolved = import_node_path29.default.resolve(input);
+  const resolved = import_node_path30.default.resolve(input);
   try {
-    return await import_node_fs17.promises.realpath(resolved);
+    return await import_node_fs18.promises.realpath(resolved);
   } catch {
     return resolved;
   }
 }
 async function writeAtomically(target, contents) {
-  await import_node_fs17.promises.mkdir(import_node_path29.default.dirname(target), { recursive: true });
+  await import_node_fs18.promises.mkdir(import_node_path30.default.dirname(target), { recursive: true });
   const tmp = `${target}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}.tmp`;
-  const fd = await import_node_fs17.promises.open(tmp, "w");
+  const fd = await import_node_fs18.promises.open(tmp, "w");
   try {
     await fd.writeFile(contents, "utf8");
     await fd.sync();
   } finally {
     await fd.close();
   }
-  await import_node_fs17.promises.rename(tmp, target);
+  await import_node_fs18.promises.rename(tmp, target);
 }
 async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS) {
   const deadline = Date.now() + timeoutMs;
-  await import_node_fs17.promises.mkdir(import_node_path29.default.dirname(lockPath), { recursive: true });
+  await import_node_fs18.promises.mkdir(import_node_path30.default.dirname(lockPath), { recursive: true });
   while (true) {
     try {
-      const fd = await import_node_fs17.promises.open(lockPath, "wx");
+      const fd = await import_node_fs18.promises.open(lockPath, "wx");
       await fd.close();
       return;
     } catch (err) {
@@ -3978,7 +4336,7 @@ async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS) {
   }
 }
 async function releaseLock(lockPath) {
-  await import_node_fs17.promises.unlink(lockPath).catch(() => {
+  await import_node_fs18.promises.unlink(lockPath).catch(() => {
   });
 }
 async function withLock(fn) {
@@ -3994,7 +4352,7 @@ async function readRegistry() {
   const file = registryPath();
   let raw;
   try {
-    raw = await import_node_fs17.promises.readFile(file, "utf8");
+    raw = await import_node_fs18.promises.readFile(file, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
       return { version: 1, projects: [] };
@@ -4002,10 +4360,10 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types18.RegistryFileSchema.parse(parsed);
+  return import_types19.RegistryFileSchema.parse(parsed);
 }
 async function writeRegistry(reg) {
-  const validated = import_types18.RegistryFileSchema.parse(reg);
+  const validated = import_types19.RegistryFileSchema.parse(reg);
   await writeAtomically(registryPath(), JSON.stringify(validated, null, 2) + "\n");
 }
 var ProjectNameCollisionError = class extends Error {
@@ -4238,6 +4596,41 @@ function registerRoutes(scope, ctx) {
     }
     return getTransitiveDependencies(proj.graph, id, depth);
   });
+  scope.get("/graph/divergences", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply);
+    if (!proj) return;
+    let typeFilter;
+    if (req.query.type) {
+      const candidates = req.query.type.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+      const parsed = [];
+      for (const c of candidates) {
+        const r = import_types20.DivergenceTypeSchema.safeParse(c);
+        if (!r.success) {
+          return reply.code(400).send({
+            error: `unknown divergence type "${c}"`,
+            allowed: import_types20.DivergenceTypeSchema.options
+          });
+        }
+        parsed.push(r.data);
+      }
+      typeFilter = new Set(parsed);
+    }
+    let minConfidence;
+    if (req.query.minConfidence !== void 0) {
+      const n = Number(req.query.minConfidence);
+      if (!Number.isFinite(n) || n < 0 || n > 1) {
+        return reply.code(400).send({
+          error: "minConfidence must be a number in [0, 1]"
+        });
+      }
+      minConfidence = n;
+    }
+    return computeDivergences(proj.graph, {
+      ...typeFilter ? { type: typeFilter } : {},
+      ...minConfidence !== void 0 ? { minConfidence } : {},
+      ...req.query.node ? { node: req.query.node } : {}
+    });
+  });
   scope.get("/incidents", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
@@ -4391,7 +4784,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req.query.severity) {
-      const sev = import_types19.PolicySeveritySchema.safeParse(req.query.severity);
+      const sev = import_types20.PolicySeveritySchema.safeParse(req.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -4408,7 +4801,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
-    const parsed = import_types19.PoliciesCheckBodySchema.safeParse(req.body ?? {});
+    const parsed = import_types20.PoliciesCheckBodySchema.safeParse(req.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -4494,13 +4887,13 @@ async function buildApi(opts) {
 
 // src/extract/retire.ts
 init_cjs_shims();
-var import_types20 = require("@neat.is/types");
+var import_types21 = require("@neat.is/types");
 function retireEdgesByFile(graph, file) {
   const normalized = file.split("\\").join("/");
   const toDrop = [];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== import_types20.Provenance.EXTRACTED) return;
+    if (edge.provenance !== import_types21.Provenance.EXTRACTED) return;
     if (!edge.evidence?.file) return;
     if (edge.evidence.file === normalized) toDrop.push(id);
   });
@@ -4514,8 +4907,8 @@ init_otel_grpc();
 
 // src/search.ts
 init_cjs_shims();
-var import_node_fs18 = require("fs");
-var import_node_path32 = __toESM(require("path"), 1);
+var import_node_fs19 = require("fs");
+var import_node_path33 = __toESM(require("path"), 1);
 var import_node_crypto = require("crypto");
 var DEFAULT_LIMIT = 10;
 var NOMIC_DIM = 768;
@@ -4645,7 +5038,7 @@ async function pickEmbedder() {
 }
 async function readCache(cachePath) {
   try {
-    const raw = await import_node_fs18.promises.readFile(cachePath, "utf8");
+    const raw = await import_node_fs19.promises.readFile(cachePath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.version !== 1) return null;
     return parsed;
@@ -4654,8 +5047,8 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, cache) {
-  await import_node_fs18.promises.mkdir(import_node_path32.default.dirname(cachePath), { recursive: true });
-  await import_node_fs18.promises.writeFile(cachePath, JSON.stringify(cache));
+  await import_node_fs19.promises.mkdir(import_node_path33.default.dirname(cachePath), { recursive: true });
+  await import_node_fs19.promises.writeFile(cachePath, JSON.stringify(cache));
 }
 var VectorIndex = class {
   constructor(embedder, cachePath) {
@@ -4810,8 +5203,8 @@ var ALL_PHASES = [
 ];
 function classifyChange(relPath) {
   const phases = /* @__PURE__ */ new Set();
-  const base = import_node_path33.default.basename(relPath).toLowerCase();
-  const segments = relPath.split(import_node_path33.default.sep).map((s) => s.toLowerCase());
+  const base = import_node_path34.default.basename(relPath).toLowerCase();
+  const segments = relPath.split(import_node_path34.default.sep).map((s) => s.toLowerCase());
   if (base === "package.json" || base === "requirements.txt" || base === "pyproject.toml" || base === "setup.py") {
     phases.add("services");
     phases.add("aliases");
@@ -4894,8 +5287,8 @@ async function startWatch(graph, opts) {
   const projectName = opts.project ?? DEFAULT_PROJECT;
   await loadGraphFromDisk(graph, opts.outPath);
   const detachEventBus = attachGraphToEventBus(graph, { project: projectName });
-  const policyFilePath = import_node_path33.default.join(opts.scanPath, "policy.json");
-  const policyViolationsPath = import_node_path33.default.join(import_node_path33.default.dirname(opts.outPath), "policy-violations.ndjson");
+  const policyFilePath = import_node_path34.default.join(opts.scanPath, "policy.json");
+  const policyViolationsPath = import_node_path34.default.join(import_node_path34.default.dirname(opts.outPath), "policy-violations.ndjson");
   let policies = [];
   try {
     policies = await loadPolicyFile(policyFilePath);
@@ -4944,7 +5337,7 @@ async function startWatch(graph, opts) {
   const host = opts.host ?? "0.0.0.0";
   const port = opts.port ?? 8080;
   const otelPort = opts.otelPort ?? 4318;
-  const cachePath = opts.embeddingsCachePath ?? import_node_path33.default.join(import_node_path33.default.dirname(opts.outPath), "embeddings.json");
+  const cachePath = opts.embeddingsCachePath ?? import_node_path34.default.join(import_node_path34.default.dirname(opts.outPath), "embeddings.json");
   let searchIndex;
   try {
     searchIndex = await buildSearchIndex(graph, { cachePath });
@@ -4962,7 +5355,7 @@ async function startWatch(graph, opts) {
       // Paths are derived from the explicit options the watch caller passes
       // — pathsForProject is only used to fill in the embeddings/snapshot
       // fields so the registry shape is complete.
-      ...pathsForProject(projectName, import_node_path33.default.dirname(opts.outPath)),
+      ...pathsForProject(projectName, import_node_path34.default.dirname(opts.outPath)),
       snapshotPath: opts.outPath,
       errorsPath: opts.errorsPath,
       staleEventsPath: opts.staleEventsPath
@@ -5047,9 +5440,9 @@ async function startWatch(graph, opts) {
   };
   const onPath = (absPath) => {
     if (shouldIgnore(absPath)) return;
-    const rel = import_node_path33.default.relative(opts.scanPath, absPath);
+    const rel = import_node_path34.default.relative(opts.scanPath, absPath);
     if (!rel || rel.startsWith("..")) return;
-    pendingPaths.add(rel.split(import_node_path33.default.sep).join("/"));
+    pendingPaths.add(rel.split(import_node_path34.default.sep).join("/"));
     const phases = classifyChange(rel);
     if (phases.size === 0) {
       for (const p of ALL_PHASES) pending.add(p);
@@ -5097,8 +5490,8 @@ init_cjs_shims();
 
 // src/installers/javascript.ts
 init_cjs_shims();
-var import_node_fs19 = require("fs");
-var import_node_path34 = __toESM(require("path"), 1);
+var import_node_fs20 = require("fs");
+var import_node_path35 = __toESM(require("path"), 1);
 var SDK_PACKAGES = [
   { name: "@opentelemetry/api", version: "^1.9.0" },
   { name: "@opentelemetry/sdk-node", version: "^0.57.0" },
@@ -5114,7 +5507,7 @@ var OTEL_ENV = {
 };
 async function readPackageJson(serviceDir) {
   try {
-    const raw = await import_node_fs19.promises.readFile(import_node_path34.default.join(serviceDir, "package.json"), "utf8");
+    const raw = await import_node_fs20.promises.readFile(import_node_path35.default.join(serviceDir, "package.json"), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -5133,7 +5526,7 @@ function rewriteStartScript(start) {
 }
 async function plan(serviceDir) {
   const pkg = await readPackageJson(serviceDir);
-  const manifestPath = import_node_path34.default.join(serviceDir, "package.json");
+  const manifestPath = import_node_path35.default.join(serviceDir, "package.json");
   const empty = {
     language: "javascript",
     serviceDir,
@@ -5180,7 +5573,7 @@ async function apply(installPlan) {
   const originals = /* @__PURE__ */ new Map();
   for (const file of touched) {
     try {
-      originals.set(file, await import_node_fs19.promises.readFile(file, "utf8"));
+      originals.set(file, await import_node_fs20.promises.readFile(file, "utf8"));
     } catch {
     }
   }
@@ -5206,8 +5599,8 @@ async function apply(installPlan) {
       }
       const newRaw = JSON.stringify(pkg, null, 2) + "\n";
       const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
-      await import_node_fs19.promises.writeFile(tmp, newRaw, "utf8");
-      await import_node_fs19.promises.rename(tmp, file);
+      await import_node_fs20.promises.writeFile(tmp, newRaw, "utf8");
+      await import_node_fs20.promises.rename(tmp, file);
     }
   } catch (err) {
     await rollback(installPlan, originals);
@@ -5218,7 +5611,7 @@ async function rollback(installPlan, originals) {
   const restored = [];
   for (const [file, raw] of originals.entries()) {
     try {
-      await import_node_fs19.promises.writeFile(file, raw, "utf8");
+      await import_node_fs20.promises.writeFile(file, raw, "utf8");
       restored.push(file);
     } catch {
     }
@@ -5232,8 +5625,8 @@ async function rollback(installPlan, originals) {
     ...restored.map((f) => `restored: ${f}`),
     ""
   ];
-  const rollbackPath = import_node_path34.default.join(installPlan.serviceDir, "neat-rollback.patch");
-  await import_node_fs19.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
+  const rollbackPath = import_node_path35.default.join(installPlan.serviceDir, "neat-rollback.patch");
+  await import_node_fs20.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 var javascriptInstaller = {
   name: "javascript",
@@ -5244,8 +5637,8 @@ var javascriptInstaller = {
 
 // src/installers/python.ts
 init_cjs_shims();
-var import_node_fs20 = require("fs");
-var import_node_path35 = __toESM(require("path"), 1);
+var import_node_fs21 = require("fs");
+var import_node_path36 = __toESM(require("path"), 1);
 var SDK_PACKAGES2 = [
   { name: "opentelemetry-distro", version: ">=0.49b0" },
   { name: "opentelemetry-exporter-otlp", version: ">=1.28.0" }
@@ -5257,7 +5650,7 @@ var OTEL_ENV2 = {
 };
 async function exists2(p) {
   try {
-    await import_node_fs20.promises.stat(p);
+    await import_node_fs21.promises.stat(p);
     return true;
   } catch {
     return false;
@@ -5266,7 +5659,7 @@ async function exists2(p) {
 async function detect2(serviceDir) {
   const markers = ["requirements.txt", "pyproject.toml", "setup.py"];
   for (const m of markers) {
-    if (await exists2(import_node_path35.default.join(serviceDir, m))) return true;
+    if (await exists2(import_node_path36.default.join(serviceDir, m))) return true;
   }
   return false;
 }
@@ -5276,9 +5669,9 @@ function reqPackageName(line) {
   return head.replace(/[<>=!~].*$/, "").toLowerCase();
 }
 async function planRequirementsTxtEdits(serviceDir) {
-  const file = import_node_path35.default.join(serviceDir, "requirements.txt");
+  const file = import_node_path36.default.join(serviceDir, "requirements.txt");
   if (!await exists2(file)) return null;
-  const raw = await import_node_fs20.promises.readFile(file, "utf8");
+  const raw = await import_node_fs21.promises.readFile(file, "utf8");
   const presentNames = new Set(
     raw.split(/\r?\n/).map(reqPackageName).filter((n) => n.length > 0)
   );
@@ -5286,9 +5679,9 @@ async function planRequirementsTxtEdits(serviceDir) {
   return { manifest: file, missing: [...missing] };
 }
 async function planProcfileEdits(serviceDir) {
-  const procfile = import_node_path35.default.join(serviceDir, "Procfile");
+  const procfile = import_node_path36.default.join(serviceDir, "Procfile");
   if (!await exists2(procfile)) return [];
-  const raw = await import_node_fs20.promises.readFile(procfile, "utf8");
+  const raw = await import_node_fs21.promises.readFile(procfile, "utf8");
   const edits = [];
   for (const line of raw.split(/\r?\n/)) {
     if (line.length === 0) continue;
@@ -5340,8 +5733,8 @@ async function applyRequirementsTxt(manifest, edits, original) {
   const next = `${original}${trailing}${newlines.join("\n")}
 `;
   const tmp = `${manifest}.${process.pid}.${Date.now()}.tmp`;
-  await import_node_fs20.promises.writeFile(tmp, next, "utf8");
-  await import_node_fs20.promises.rename(tmp, manifest);
+  await import_node_fs21.promises.writeFile(tmp, next, "utf8");
+  await import_node_fs21.promises.rename(tmp, manifest);
 }
 async function applyProcfile(procfile, edits, original) {
   let next = original;
@@ -5350,8 +5743,8 @@ async function applyProcfile(procfile, edits, original) {
     next = next.replace(e.before, e.after);
   }
   const tmp = `${procfile}.${process.pid}.${Date.now()}.tmp`;
-  await import_node_fs20.promises.writeFile(tmp, next, "utf8");
-  await import_node_fs20.promises.rename(tmp, procfile);
+  await import_node_fs21.promises.writeFile(tmp, next, "utf8");
+  await import_node_fs21.promises.rename(tmp, procfile);
 }
 async function apply2(installPlan) {
   const touched = /* @__PURE__ */ new Set();
@@ -5361,7 +5754,7 @@ async function apply2(installPlan) {
   const originals = /* @__PURE__ */ new Map();
   for (const file of touched) {
     try {
-      originals.set(file, await import_node_fs20.promises.readFile(file, "utf8"));
+      originals.set(file, await import_node_fs21.promises.readFile(file, "utf8"));
     } catch {
     }
   }
@@ -5371,7 +5764,7 @@ async function apply2(installPlan) {
       if (raw === void 0) {
         throw new Error(`python installer: cannot read ${file} during apply`);
       }
-      const base = import_node_path35.default.basename(file);
+      const base = import_node_path36.default.basename(file);
       if (base === "requirements.txt") {
         const edits = installPlan.dependencyEdits.filter((e) => e.file === file);
         if (edits.length > 0) await applyRequirementsTxt(file, edits, raw);
@@ -5389,7 +5782,7 @@ async function rollback2(installPlan, originals) {
   const restored = [];
   for (const [file, raw] of originals.entries()) {
     try {
-      await import_node_fs20.promises.writeFile(file, raw, "utf8");
+      await import_node_fs21.promises.writeFile(file, raw, "utf8");
       restored.push(file);
     } catch {
     }
@@ -5403,8 +5796,8 @@ async function rollback2(installPlan, originals) {
     ...restored.map((f) => `restored: ${f}`),
     ""
   ];
-  const rollbackPath = import_node_path35.default.join(installPlan.serviceDir, "neat-rollback.patch");
-  await import_node_fs20.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
+  const rollbackPath = import_node_path36.default.join(installPlan.serviceDir, "neat-rollback.patch");
+  await import_node_fs21.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 var pythonInstaller = {
   name: "python",
@@ -5492,9 +5885,12 @@ function renderPatch(sections) {
   return lines.join("\n");
 }
 
+// src/cli.ts
+var import_types23 = require("@neat.is/types");
+
 // src/cli-client.ts
 init_cjs_shims();
-var import_types21 = require("@neat.is/types");
+var import_types22 = require("@neat.is/types");
 var HttpError = class extends Error {
   constructor(status2, message, responseBody = "") {
     super(message);
@@ -5514,10 +5910,10 @@ var TransportError = class extends Error {
 function createHttpClient(baseUrl) {
   const root = baseUrl.replace(/\/$/, "");
   return {
-    async get(path37) {
+    async get(path38) {
       let res;
       try {
-        res = await fetch(`${root}${path37}`);
+        res = await fetch(`${root}${path38}`);
       } catch (err) {
         throw new TransportError(
           `cannot reach neat-core at ${root}: ${err.message}`
@@ -5527,16 +5923,16 @@ function createHttpClient(baseUrl) {
         const body = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on GET ${path37}: ${body}`,
+          `${res.status} ${res.statusText} on GET ${path38}: ${body}`,
           body
         );
       }
       return await res.json();
     },
-    async post(path37, body) {
+    async post(path38, body) {
       let res;
       try {
-        res = await fetch(`${root}${path37}`, {
+        res = await fetch(`${root}${path38}`, {
           method: "POST",
           headers: { "content-type": "application/json" },
           body: JSON.stringify(body)
@@ -5550,7 +5946,7 @@ function createHttpClient(baseUrl) {
         const text = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on POST ${path37}: ${text}`,
+          `${res.status} ${res.statusText} on POST ${path38}: ${text}`,
           text
         );
       }
@@ -5564,12 +5960,12 @@ function projectPath(project, suffix) {
 }
 async function runRootCause(client, input) {
   const qs = input.errorId ? `?errorId=${encodeURIComponent(input.errorId)}` : "";
-  const path37 = projectPath(
+  const path38 = projectPath(
     input.project,
     `/traverse/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
   );
   try {
-    const result = await client.get(path37);
+    const result = await client.get(path38);
     const arrowPath = result.traversalPath.join(" \u2190 ");
     const provenances = result.edgeProvenances.length ? result.edgeProvenances.join(", ") : "(direct, no edges traversed)";
     const summary = `Root cause for ${input.errorNode} is ${result.rootCauseNode}. ` + result.rootCauseReason + (result.fixRecommendation ? ` Recommended fix: ${result.fixRecommendation}.` : "");
@@ -5595,12 +5991,12 @@ async function runRootCause(client, input) {
 }
 async function runBlastRadius(client, input) {
   const qs = input.depth !== void 0 ? `?depth=${input.depth}` : "";
-  const path37 = projectPath(
+  const path38 = projectPath(
     input.project,
     `/traverse/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
   );
   try {
-    const result = await client.get(path37);
+    const result = await client.get(path38);
     if (result.totalAffected === 0) {
       return {
         summary: `${result.origin} has no downstream dependencies. Nothing else would break if it failed.`
@@ -5629,17 +6025,17 @@ async function runBlastRadius(client, input) {
   }
 }
 function formatBlastEntry(n) {
-  const tag = n.edgeProvenance === import_types21.Provenance.STALE ? " [STALE \u2014 last seen too long ago]" : "";
+  const tag = n.edgeProvenance === import_types22.Provenance.STALE ? " [STALE \u2014 last seen too long ago]" : "";
   return `  \u2022 ${n.nodeId} (distance ${n.distance}, ${n.edgeProvenance})${tag}`;
 }
 async function runDependencies(client, input) {
   const depth = input.depth ?? 3;
-  const path37 = projectPath(
+  const path38 = projectPath(
     input.project,
     `/graph/node/${encodeURIComponent(input.nodeId)}/dependencies?depth=${depth}`
   );
   try {
-    const result = await client.get(path37);
+    const result = await client.get(path38);
     if (result.total === 0) {
       return {
         summary: depth === 1 ? `${input.nodeId} has no direct dependencies in the graph.` : `${input.nodeId} has no dependencies (BFS to depth ${depth}).`
@@ -5675,9 +6071,9 @@ async function runObservedDependencies(client, input) {
     const edges = await client.get(
       projectPath(input.project, `/graph/edges/${encodeURIComponent(input.nodeId)}`)
     );
-    const observed = edges.outbound.filter((e) => e.provenance === import_types21.Provenance.OBSERVED);
+    const observed = edges.outbound.filter((e) => e.provenance === import_types22.Provenance.OBSERVED);
     if (observed.length === 0) {
-      const hasExtracted = edges.outbound.some((e) => e.provenance === import_types21.Provenance.EXTRACTED);
+      const hasExtracted = edges.outbound.some((e) => e.provenance === import_types22.Provenance.EXTRACTED);
       const note = hasExtracted ? " Static (EXTRACTED) dependencies exist but no runtime traffic has been seen \u2014 is OTel running?" : "";
       return { summary: `No OBSERVED dependencies for ${input.nodeId}.${note}` };
     }
@@ -5685,7 +6081,7 @@ async function runObservedDependencies(client, input) {
     return {
       summary: `${input.nodeId} has ${observed.length} runtime dependenc${observed.length === 1 ? "y" : "ies"} confirmed by OTel.`,
       block: blockLines.join("\n"),
-      provenance: import_types21.Provenance.OBSERVED
+      provenance: import_types22.Provenance.OBSERVED
     };
   } catch (err) {
     if (err instanceof HttpError && err.status === 404) {
@@ -5720,9 +6116,9 @@ function formatDuration(ms) {
   return `${Math.round(h / 24)}d`;
 }
 async function runIncidents(client, input) {
-  const path37 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
+  const path38 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
   try {
-    const events = await client.get(path37);
+    const events = await client.get(path38);
     if (events.length === 0) {
       return {
         summary: input.nodeId ? `No incidents recorded against ${input.nodeId}.` : "No incidents recorded."
@@ -5738,7 +6134,7 @@ async function runIncidents(client, input) {
     return {
       summary: `${target} has ${events.length} recorded incident${events.length === 1 ? "" : "s"}; showing the ${ordered.length} most recent.`,
       block: blockLines.join("\n"),
-      provenance: import_types21.Provenance.OBSERVED
+      provenance: import_types22.Provenance.OBSERVED
     };
   } catch (err) {
     if (err instanceof HttpError && err.status === 404) {
@@ -5846,7 +6242,7 @@ async function runStaleEdges(client, input) {
   return {
     summary: `${events.length} stale-edge transition${events.length === 1 ? "" : "s"} recorded${input.edgeType ? ` for ${input.edgeType}` : ""}.`,
     block: blockLines.join("\n"),
-    provenance: import_types21.Provenance.STALE
+    provenance: import_types22.Provenance.STALE
   };
 }
 async function runPolicies(client, input) {
@@ -5909,6 +6305,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;
@@ -5987,6 +6431,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".');
@@ -6011,7 +6458,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 = [];
@@ -6030,6 +6479,8 @@ function parseArgs(rest) {
     against: null,
     errorId: null,
     hypotheticalAction: null,
+    type: null,
+    minConfidence: null,
     positional: []
   };
   for (let i = 0; i < rest.length; i++) {
@@ -6089,6 +6540,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;
 }
@@ -6170,7 +6630,7 @@ async function buildPatchSections(services) {
 }
 async function runInit(opts) {
   const written = [];
-  const stat = await import_node_fs21.promises.stat(opts.scanPath).catch(() => null);
+  const stat = await import_node_fs22.promises.stat(opts.scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) {
     console.error(`neat init: ${opts.scanPath} is not a directory`);
     return { exitCode: 2, writtenFiles: written };
@@ -6179,9 +6639,9 @@ async function runInit(opts) {
   printDiscoveryReport(opts, services);
   const sections = opts.noInstall ? [] : await buildPatchSections(services);
   const patch = renderPatch(sections);
-  const patchPath = import_node_path36.default.join(opts.scanPath, "neat.patch");
+  const patchPath = import_node_path37.default.join(opts.scanPath, "neat.patch");
   if (opts.dryRun) {
-    await import_node_fs21.promises.writeFile(patchPath, patch, "utf8");
+    await import_node_fs22.promises.writeFile(patchPath, patch, "utf8");
     written.push(patchPath);
     console.log(`dry-run: patch written to ${patchPath}`);
     console.log("rerun without --dry-run to register and snapshot.");
@@ -6221,7 +6681,7 @@ async function runInit(opts) {
         console.log("patch applied. Run `npm install` (or your language equivalent) to refresh lockfiles.");
       }
     } else {
-      await import_node_fs21.promises.writeFile(patchPath, patch, "utf8");
+      await import_node_fs22.promises.writeFile(patchPath, patch, "utf8");
       written.push(patchPath);
     }
   }
@@ -6261,9 +6721,9 @@ var CLAUDE_SKILL_CONFIG = {
 };
 function claudeConfigPath() {
   const override = process.env.NEAT_CLAUDE_CONFIG;
-  if (override && override.length > 0) return import_node_path36.default.resolve(override);
+  if (override && override.length > 0) return import_node_path37.default.resolve(override);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path36.default.join(home, ".claude.json");
+  return import_node_path37.default.join(home, ".claude.json");
 }
 async function runSkill(opts) {
   const snippet2 = JSON.stringify(CLAUDE_SKILL_CONFIG, null, 2) + "\n";
@@ -6275,7 +6735,7 @@ async function runSkill(opts) {
     const target = claudeConfigPath();
     let existing = {};
     try {
-      existing = JSON.parse(await import_node_fs21.promises.readFile(target, "utf8"));
+      existing = JSON.parse(await import_node_fs22.promises.readFile(target, "utf8"));
     } catch (err) {
       if (err.code !== "ENOENT") {
         console.error(`neat skill: failed to read ${target} \u2014 ${err.message}`);
@@ -6287,8 +6747,8 @@ async function runSkill(opts) {
       ...existing,
       mcpServers: { ...mcp, neat: CLAUDE_SKILL_CONFIG.mcpServers.neat }
     };
-    await import_node_fs21.promises.mkdir(import_node_path36.default.dirname(target), { recursive: true });
-    await import_node_fs21.promises.writeFile(target, JSON.stringify(merged, null, 2) + "\n", "utf8");
+    await import_node_fs22.promises.mkdir(import_node_path37.default.dirname(target), { recursive: true });
+    await import_node_fs22.promises.writeFile(target, JSON.stringify(merged, null, 2) + "\n", "utf8");
     console.log(`neat skill: wrote mcpServers.neat to ${target}`);
     console.log("restart Claude Code to pick up the new MCP server.");
     return { exitCode: 0 };
@@ -6322,12 +6782,12 @@ async function main() {
       console.error("neat init: --apply and --dry-run are mutually exclusive");
       process.exit(2);
     }
-    const scanPath = import_node_path36.default.resolve(target);
+    const scanPath = import_node_path37.default.resolve(target);
     const projectExplicit = parsed.project !== null;
-    const projectName = projectExplicit ? project : import_node_path36.default.basename(scanPath);
+    const projectName = projectExplicit ? project : import_node_path37.default.basename(scanPath);
     const projectKey = projectExplicit ? project : DEFAULT_PROJECT;
-    const fallback = pathsForProject(projectKey, import_node_path36.default.join(scanPath, "neat-out")).snapshotPath;
-    const outPath = import_node_path36.default.resolve(process.env.NEAT_OUT_PATH ?? fallback);
+    const fallback = pathsForProject(projectKey, import_node_path37.default.join(scanPath, "neat-out")).snapshotPath;
+    const outPath = import_node_path37.default.resolve(process.env.NEAT_OUT_PATH ?? fallback);
     const result = await runInit({
       scanPath,
       outPath,
@@ -6347,21 +6807,21 @@ async function main() {
       usage();
       process.exit(2);
     }
-    const scanPath = import_node_path36.default.resolve(target);
-    const stat = await import_node_fs21.promises.stat(scanPath).catch(() => null);
+    const scanPath = import_node_path37.default.resolve(target);
+    const stat = await import_node_fs22.promises.stat(scanPath).catch(() => null);
     if (!stat || !stat.isDirectory()) {
       console.error(`neat watch: ${scanPath} is not a directory`);
       process.exit(2);
     }
-    const projectPaths = pathsForProject(project, import_node_path36.default.join(scanPath, "neat-out"));
-    const outPath = import_node_path36.default.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
-    const errorsPath = import_node_path36.default.resolve(
-      process.env.NEAT_ERRORS_PATH ?? import_node_path36.default.join(import_node_path36.default.dirname(outPath), import_node_path36.default.basename(projectPaths.errorsPath))
+    const projectPaths = pathsForProject(project, import_node_path37.default.join(scanPath, "neat-out"));
+    const outPath = import_node_path37.default.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
+    const errorsPath = import_node_path37.default.resolve(
+      process.env.NEAT_ERRORS_PATH ?? import_node_path37.default.join(import_node_path37.default.dirname(outPath), import_node_path37.default.basename(projectPaths.errorsPath))
     );
-    const staleEventsPath = import_node_path36.default.resolve(
-      process.env.NEAT_STALE_EVENTS_PATH ?? import_node_path36.default.join(import_node_path36.default.dirname(outPath), import_node_path36.default.basename(projectPaths.staleEventsPath))
+    const staleEventsPath = import_node_path37.default.resolve(
+      process.env.NEAT_STALE_EVENTS_PATH ?? import_node_path37.default.join(import_node_path37.default.dirname(outPath), import_node_path37.default.basename(projectPaths.staleEventsPath))
     );
-    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? import_node_path36.default.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
+    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? import_node_path37.default.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
     const handle = await startWatch(getGraph(project), {
       scanPath,
       outPath,
@@ -6472,7 +6932,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;
@@ -6594,6 +7056,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 = import_types23.DivergenceTypeSchema.safeParse(p);
+          if (!r.success) {
+            console.error(
+              `neat divergences: unknown --type "${p}". allowed: ${import_types23.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;