@neat.is/core 0.3.1 → 0.3.3

package/dist/neatd.cjs

@@ -100,8 +100,8 @@ function reshapeGrpcRequest(req2) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path31.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path31.default.resolve(here, "..", "proto");
+  const here = import_node_path33.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return import_node_path33.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -156,13 +156,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path31, grpc, protoLoader;
+var import_node_url, import_node_path33, grpc, protoLoader;
 var init_otel_grpc = __esm({
   "src/otel-grpc.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_url = require("url");
-    import_node_path31 = __toESM(require("path"), 1);
+    import_node_path33 = __toESM(require("path"), 1);
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
     init_otel();
@@ -259,10 +259,10 @@ function parseOtlpRequest(body) {
 }
 function loadProtobufDecoder() {
   if (exportTraceServiceRequestType) return exportTraceServiceRequestType;
-  const here = import_node_path32.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path32.default.resolve(here, "..", "proto");
+  const here = import_node_path34.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path34.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path32.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path34.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -354,12 +354,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path32, import_node_url2, import_fastify2, import_protobufjs, exportTraceServiceRequestType;
+var import_node_path34, import_node_url2, import_fastify2, import_protobufjs, exportTraceServiceRequestType;
 var init_otel = __esm({
   "src/otel.ts"() {
     "use strict";
     init_cjs_shims();
-    import_node_path32 = __toESM(require("path"), 1);
+    import_node_path34 = __toESM(require("path"), 1);
     import_node_url2 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -369,13 +369,13 @@ var init_otel = __esm({
 
 // src/neatd.ts
 init_cjs_shims();
-var import_node_fs20 = require("fs");
-var import_node_path35 = __toESM(require("path"), 1);
+var import_node_fs22 = require("fs");
+var import_node_path37 = __toESM(require("path"), 1);
 
 // src/daemon.ts
 init_cjs_shims();
-var import_node_fs19 = require("fs");
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_fs21 = require("fs");
+var import_node_path35 = __toESM(require("path"), 1);
 
 // src/graph.ts
 init_cjs_shims();
@@ -831,19 +831,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, path36, edges) {
-    if (path36.length > best.path.length) {
-      best = { path: [...path36], edges: [...edges] };
+  function step(node, path38, edges) {
+    if (path38.length > best.path.length) {
+      best = { path: [...path38], edges: [...edges] };
     }
-    if (path36.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);
-      path36.push(srcId);
+      path38.push(srcId);
       edges.push(edge);
-      step(srcId, path36, edges);
-      path36.pop();
+      step(srcId, path38, edges);
+      path38.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1785,8 +1785,8 @@ async function readErrorEvents(errorsPath) {
 
 // src/extract/services.ts
 init_cjs_shims();
-var import_node_fs7 = require("fs");
-var import_node_path7 = __toESM(require("path"), 1);
+var import_node_fs8 = require("fs");
+var import_node_path8 = __toESM(require("path"), 1);
 var import_ignore = __toESM(require("ignore"), 1);
 var import_minimatch2 = require("minimatch");
 var import_types5 = require("@neat.is/types");
@@ -1810,9 +1810,107 @@ var IGNORED_DIRS = /* @__PURE__ */ new Set([
 function isConfigFile(name) {
   const ext = import_node_path4.default.extname(name);
   if (CONFIG_FILE_EXTENSIONS.has(ext)) return { match: true, fileType: ext.slice(1) };
-  if (name === ".env" || name.startsWith(".env.")) return { match: true, fileType: "env" };
+  if (name === ".env" || name.startsWith(".env.")) {
+    if (isEnvTemplateFile(name)) return { match: false, fileType: "" };
+    return { match: true, fileType: "env" };
+  }
   return { match: false, fileType: "" };
 }
+function isTestPath(filePath) {
+  const normalised = filePath.replace(/\\/g, "/");
+  const segments = normalised.split("/");
+  for (const seg of segments) {
+    if (seg === "__tests__" || seg === "__fixtures__" || seg === "integration-tests") {
+      return true;
+    }
+  }
+  const base = segments[segments.length - 1] ?? "";
+  return /\.(spec|test)\.(?:tsx?|jsx?|mjs|cjs|py)$/i.test(base);
+}
+function isEnvTemplateFile(name) {
+  if (name === ".env.template" || name === ".env.example" || name === ".env.sample") {
+    return true;
+  }
+  return /^\.env\.[^.]+\.(?:template|example|sample)$/i.test(name);
+}
+function maskCommentsInSource(src) {
+  const len = src.length;
+  const out = new Array(len);
+  let i = 0;
+  let inString = 0;
+  let escaped = false;
+  while (i < len) {
+    const c = src[i];
+    if (inString !== 0) {
+      out[i] = c;
+      if (escaped) {
+        escaped = false;
+      } else if (c === "\\") {
+        escaped = true;
+      } else if (c === inString) {
+        inString = 0;
+      }
+      i++;
+      continue;
+    }
+    if (c === "/" && i + 1 < len) {
+      const next = src[i + 1];
+      if (next === "/") {
+        out[i] = " ";
+        out[i + 1] = " ";
+        let j = i + 2;
+        while (j < len && src[j] !== "\n") {
+          out[j] = " ";
+          j++;
+        }
+        i = j;
+        continue;
+      }
+      if (next === "*") {
+        out[i] = " ";
+        out[i + 1] = " ";
+        let j = i + 2;
+        while (j < len) {
+          if (src[j] === "\n") {
+            out[j] = "\n";
+            j++;
+            continue;
+          }
+          if (src[j] === "*" && j + 1 < len && src[j + 1] === "/") {
+            out[j] = " ";
+            out[j + 1] = " ";
+            j += 2;
+            break;
+          }
+          out[j] = " ";
+          j++;
+        }
+        i = j;
+        continue;
+      }
+    }
+    out[i] = c;
+    if (c === "'" || c === '"' || c === "`") inString = c;
+    i++;
+  }
+  return out.join("");
+}
+var URL_LIKE = /^(?:[a-z][a-z0-9+.-]*:)?\/\//i;
+function urlMatchesHost(urlString, host) {
+  if (typeof urlString !== "string" || urlString.length === 0) return false;
+  if (!URL_LIKE.test(urlString)) return false;
+  const [wantedHost, wantedPort] = host.split(":");
+  let parsed;
+  try {
+    const candidate = urlString.startsWith("//") ? `http:${urlString}` : urlString;
+    parsed = new URL(candidate);
+  } catch {
+    return false;
+  }
+  if (parsed.hostname.toLowerCase() !== (wantedHost ?? "").toLowerCase()) return false;
+  if (wantedPort && parsed.port !== wantedPort) return false;
+  return true;
+}
 function cleanVersion(raw) {
   if (!raw) return void 0;
   return raw.replace(/^[\^~><=v\s]+/, "").trim() || void 0;
@@ -1968,6 +2066,33 @@ async function computeServiceOwner(codeowners, repoPath, serviceDir) {
   return author ?? void 0;
 }
 
+// src/extract/errors.ts
+init_cjs_shims();
+var import_node_fs7 = require("fs");
+var import_node_path7 = __toESM(require("path"), 1);
+var sink = [];
+function recordExtractionError(producer, file, err) {
+  const e = err instanceof Error ? err : new Error(String(err));
+  sink.push({
+    producer,
+    file,
+    error: e.message,
+    stack: e.stack,
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    source: "extract"
+  });
+  console.warn(`[neat] ${producer} skipped ${file}: ${e.message}`);
+}
+function drainExtractionErrors() {
+  return sink.splice(0, sink.length);
+}
+async function writeExtractionErrors(errors, errorsPath) {
+  if (errors.length === 0) return;
+  await import_node_fs7.promises.mkdir(import_node_path7.default.dirname(errorsPath), { recursive: true });
+  const lines = errors.map((e) => JSON.stringify(e)).join("\n") + "\n";
+  await import_node_fs7.promises.appendFile(errorsPath, lines, "utf8");
+}
+
 // src/extract/services.ts
 var DEFAULT_SCAN_DEPTH = 5;
 function parseScanDepth() {
@@ -1984,21 +2109,21 @@ function workspaceGlobs(pkg) {
   return null;
 }
 async function loadGitignore(scanPath) {
-  const gitignorePath = import_node_path7.default.join(scanPath, ".gitignore");
+  const gitignorePath = import_node_path8.default.join(scanPath, ".gitignore");
   if (!await exists(gitignorePath)) return null;
-  const raw = await import_node_fs7.promises.readFile(gitignorePath, "utf8");
+  const raw = await import_node_fs8.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_fs7.promises.readdir(current, { withFileTypes: true }).catch(() => []);
+    const entries = await import_node_fs8.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_path7.default.join(current, entry2.name);
+      const child = import_node_path8.default.join(current, entry2.name);
       if (options.ig) {
-        const rel = import_node_path7.default.relative(scanPath, child).split(import_node_path7.default.sep).join("/");
+        const rel = import_node_path8.default.relative(scanPath, child).split(import_node_path8.default.sep).join("/");
         if (rel && options.ig.ignores(rel + "/")) continue;
       }
       await visit(child);
@@ -2013,8 +2138,8 @@ async function expandWorkspaceGlobs(scanPath, globs) {
   for (const raw of globs) {
     const pattern = raw.replace(/^\.\//, "");
     if (!pattern.includes("*")) {
-      const candidate = import_node_path7.default.join(scanPath, pattern);
-      if (await exists(import_node_path7.default.join(candidate, "package.json"))) found.add(candidate);
+      const candidate = import_node_path8.default.join(scanPath, pattern);
+      if (await exists(import_node_path8.default.join(candidate, "package.json"))) found.add(candidate);
       continue;
     }
     const segments = pattern.split("/");
@@ -2023,13 +2148,13 @@ async function expandWorkspaceGlobs(scanPath, globs) {
       if (seg.includes("*")) break;
       staticSegments.push(seg);
     }
-    const start = import_node_path7.default.join(scanPath, ...staticSegments);
+    const start = import_node_path8.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_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"))) {
+      const rel = import_node_path8.default.relative(scanPath, dir).split(import_node_path8.default.sep).join("/");
+      if ((0, import_minimatch2.minimatch)(rel, pattern) && await exists(import_node_path8.default.join(dir, "package.json"))) {
         found.add(dir);
       }
     });
@@ -2037,15 +2162,13 @@ async function expandWorkspaceGlobs(scanPath, globs) {
   return [...found];
 }
 async function discoverNodeService(scanPath, dir) {
-  const pkgPath = import_node_path7.default.join(dir, "package.json");
+  const pkgPath = import_node_path8.default.join(dir, "package.json");
   if (!await exists(pkgPath)) return null;
   let pkg;
   try {
     pkg = await readJson(pkgPath);
   } catch (err) {
-    console.warn(
-      `[neat] services skipped ${import_node_path7.default.relative(scanPath, pkgPath)}: ${err.message}`
-    );
+    recordExtractionError("services", import_node_path8.default.relative(scanPath, pkgPath), err);
     return null;
   }
   if (!pkg.name) return null;
@@ -2056,7 +2179,7 @@ async function discoverNodeService(scanPath, dir) {
     language: "javascript",
     version: pkg.version,
     dependencies: pkg.dependencies ?? {},
-    repoPath: import_node_path7.default.relative(scanPath, dir),
+    repoPath: import_node_path8.default.relative(scanPath, dir),
     ...pkg.engines?.node ? { nodeEngine: pkg.engines.node } : {}
   };
   return { pkg, dir, node };
@@ -2072,19 +2195,21 @@ async function discoverPyService(scanPath, dir) {
     language: "python",
     version: py.version,
     dependencies: py.dependencies,
-    repoPath: import_node_path7.default.relative(scanPath, dir)
+    repoPath: import_node_path8.default.relative(scanPath, dir)
   };
   return { pkg, dir, node };
 }
 async function discoverServices(scanPath) {
-  const rootPkgPath = import_node_path7.default.join(scanPath, "package.json");
+  const rootPkgPath = import_node_path8.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}`
+      recordExtractionError(
+        "services workspaces",
+        import_node_path8.default.relative(scanPath, rootPkgPath),
+        err
       );
     }
   }
@@ -2100,9 +2225,9 @@ async function discoverServices(scanPath) {
       scanPath,
       { maxDepth: parseScanDepth(), ig },
       async (dir) => {
-        if (await exists(import_node_path7.default.join(dir, "package.json"))) {
+        if (await exists(import_node_path8.default.join(dir, "package.json"))) {
           candidateDirs.push(dir);
-        } 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"))) {
+        } else if (await exists(import_node_path8.default.join(dir, "pyproject.toml")) || await exists(import_node_path8.default.join(dir, "requirements.txt")) || await exists(import_node_path8.default.join(dir, "setup.py"))) {
           candidateDirs.push(dir);
         }
       }
@@ -2116,8 +2241,8 @@ async function discoverServices(scanPath) {
     if (!service) continue;
     const existingDir = seen.get(service.node.name);
     if (existingDir !== void 0) {
-      const a = import_node_path7.default.relative(scanPath, existingDir) || ".";
-      const b = import_node_path7.default.relative(scanPath, dir) || ".";
+      const a = import_node_path8.default.relative(scanPath, existingDir) || ".";
+      const b = import_node_path8.default.relative(scanPath, dir) || ".";
       console.warn(
         `[neat] duplicate package name "${service.node.name}" \u2014 keeping ${a}, ignoring ${b}`
       );
@@ -2154,8 +2279,8 @@ function addServiceNodes(graph, services) {
 
 // src/extract/aliases.ts
 init_cjs_shims();
-var import_node_path8 = __toESM(require("path"), 1);
-var import_node_fs8 = require("fs");
+var import_node_path9 = __toESM(require("path"), 1);
+var import_node_fs9 = require("fs");
 var import_yaml2 = require("yaml");
 var import_types6 = require("@neat.is/types");
 var K8S_KINDS_WITH_HOSTNAMES = /* @__PURE__ */ new Set([
@@ -2182,14 +2307,14 @@ 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_path8.default.basename(s.dir), s.node.id);
+    map.set(import_node_path9.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_path8.default.join(scanPath, name);
+    const abs = import_node_path9.default.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
@@ -2200,8 +2325,10 @@ async function collectComposeAliases(graph, scanPath, serviceIndex) {
   try {
     compose = await readYaml(composePath);
   } catch (err) {
-    console.warn(
-      `[neat] aliases compose skipped ${import_node_path8.default.relative(scanPath, composePath)}: ${err.message}`
+    recordExtractionError(
+      "aliases compose",
+      import_node_path9.default.relative(scanPath, composePath),
+      err
     );
     return;
   }
@@ -2243,15 +2370,13 @@ function parseDockerfileLabels(content) {
 }
 async function collectDockerfileAliases(graph, services) {
   for (const service of services) {
-    const dockerfilePath = import_node_path8.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path9.default.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
     let content;
     try {
-      content = await import_node_fs8.promises.readFile(dockerfilePath, "utf8");
+      content = await import_node_fs9.promises.readFile(dockerfilePath, "utf8");
     } catch (err) {
-      console.warn(
-        `[neat] aliases dockerfile skipped ${dockerfilePath}: ${err.message}`
-      );
+      recordExtractionError("aliases dockerfile", dockerfilePath, err);
       continue;
     }
     const aliases = parseDockerfileLabels(content);
@@ -2261,13 +2386,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_fs8.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs9.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_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));
+      out.push(...await walkYamlFiles(import_node_path9.default.join(start, entry2.name), depth + 1, max));
+    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path9.default.extname(entry2.name))) {
+      out.push(import_node_path9.default.join(start, entry2.name));
     }
   }
   return out;
@@ -2294,7 +2419,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_fs8.promises.readFile(file, "utf8");
+    const content = await import_node_fs9.promises.readFile(file, "utf8");
     let docs;
     try {
       docs = (0, import_yaml2.parseAllDocuments)(content).map((d) => d.toJSON());
@@ -2319,14 +2444,14 @@ async function addServiceAliases(graph, scanPath, services) {
 
 // src/extract/databases/index.ts
 init_cjs_shims();
-var import_node_path16 = __toESM(require("path"), 1);
+var import_node_path17 = __toESM(require("path"), 1);
 var import_types7 = require("@neat.is/types");
 
 // src/extract/databases/db-config-yaml.ts
 init_cjs_shims();
-var import_node_path9 = __toESM(require("path"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
 async function parse(serviceDir) {
-  const yamlPath = import_node_path9.default.join(serviceDir, "db-config.yaml");
+  const yamlPath = import_node_path10.default.join(serviceDir, "db-config.yaml");
   if (!await exists(yamlPath)) return [];
   const raw = await readYaml(yamlPath);
   return [
@@ -2344,13 +2469,13 @@ var dbConfigYamlParser = { name: "db-config.yaml", parse };
 
 // src/extract/databases/dotenv.ts
 init_cjs_shims();
-var import_node_fs10 = require("fs");
-var import_node_path11 = __toESM(require("path"), 1);
+var import_node_fs11 = require("fs");
+var import_node_path12 = __toESM(require("path"), 1);
 
 // src/extract/databases/shared.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);
 function schemeToEngine(scheme) {
   const s = scheme.toLowerCase().split("+")[0];
   switch (s) {
@@ -2389,14 +2514,14 @@ function parseConnectionString(url) {
 }
 async function readIfExists(filePath) {
   try {
-    return await import_node_fs9.promises.readFile(filePath, "utf8");
+    return await import_node_fs10.promises.readFile(filePath, "utf8");
   } catch {
     return null;
   }
 }
 async function findFirst(serviceDir, candidates) {
   for (const rel of candidates) {
-    const abs = import_node_path10.default.join(serviceDir, rel);
+    const abs = import_node_path11.default.join(serviceDir, rel);
     const content = await readIfExists(abs);
     if (content !== null) return abs;
   }
@@ -2447,15 +2572,15 @@ function parseDotenvLine(line) {
   return { key, value };
 }
 async function parse2(serviceDir) {
-  const entries = await import_node_fs10.promises.readdir(serviceDir, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs11.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_path11.default.join(serviceDir, entry2.name);
-    const content = await import_node_fs10.promises.readFile(filePath, "utf8");
+    const filePath = import_node_path12.default.join(serviceDir, entry2.name);
+    const content = await import_node_fs11.promises.readFile(filePath, "utf8");
     for (const line of content.split("\n")) {
       const parsed = parseDotenvLine(line);
       if (!parsed) continue;
@@ -2474,9 +2599,9 @@ var dotenvParser = { name: ".env", parse: parse2 };
 
 // src/extract/databases/prisma.ts
 init_cjs_shims();
-var import_node_path12 = __toESM(require("path"), 1);
+var import_node_path13 = __toESM(require("path"), 1);
 async function parse3(serviceDir) {
-  const schemaPath = import_node_path12.default.join(serviceDir, "prisma", "schema.prisma");
+  const schemaPath = import_node_path13.default.join(serviceDir, "prisma", "schema.prisma");
   const content = await readIfExists(schemaPath);
   if (!content) return [];
   const block = content.match(/datasource\s+\w+\s*\{([^}]*)\}/s);
@@ -2608,10 +2733,10 @@ var knexParser = { name: "knex", parse: parse5 };
 
 // src/extract/databases/ormconfig.ts
 init_cjs_shims();
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 async function parse6(serviceDir) {
   for (const candidate of ["ormconfig.json", "ormconfig.yaml", "ormconfig.yml"]) {
-    const abs = import_node_path13.default.join(serviceDir, candidate);
+    const abs = import_node_path14.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];
@@ -2671,9 +2796,9 @@ var typeormParser = { name: "typeorm", parse: parse7 };
 
 // src/extract/databases/sequelize.ts
 init_cjs_shims();
-var import_node_path14 = __toESM(require("path"), 1);
+var import_node_path15 = __toESM(require("path"), 1);
 async function parse8(serviceDir) {
-  const configPath = import_node_path14.default.join(serviceDir, "config", "config.json");
+  const configPath = import_node_path15.default.join(serviceDir, "config", "config.json");
   if (!await exists(configPath)) return [];
   const raw = await readJson(configPath);
   const out = [];
@@ -2700,7 +2825,7 @@ var sequelizeParser = { name: "sequelize", parse: parse8 };
 
 // src/extract/databases/docker-compose.ts
 init_cjs_shims();
-var import_node_path15 = __toESM(require("path"), 1);
+var import_node_path16 = __toESM(require("path"), 1);
 function portFromService(svc) {
   for (const raw of svc.ports ?? []) {
     const str = String(raw);
@@ -2727,7 +2852,7 @@ function databaseFromEnv(svc) {
 }
 async function parse9(serviceDir) {
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = import_node_path15.default.join(serviceDir, name);
+    const abs = import_node_path16.default.join(serviceDir, name);
     if (!await exists(abs)) continue;
     const raw = await readYaml(abs);
     if (!raw?.services) return [];
@@ -2905,11 +3030,12 @@ async function addDatabasesAndCompat(graph, services, scanPath) {
         target: dbNode.id,
         type: import_types7.EdgeType.CONNECTS_TO,
         provenance: import_types7.Provenance.EXTRACTED,
-        ...config.sourceFile ? {
-          evidence: {
-            file: import_node_path16.default.relative(scanPath, config.sourceFile).split(import_node_path16.default.sep).join("/")
-          }
-        } : {}
+        // ADR-032 / #140 — every EXTRACTED edge carries evidence.file.
+        // Ghost-edge cleanup keys retirement on this; the conditional
+        // sourceFile spread that used to live here was a v0.1.x leftover.
+        evidence: {
+          file: import_node_path17.default.relative(scanPath, config.sourceFile).split(import_node_path17.default.sep).join("/")
+        }
       };
       if (!graph.hasEdge(edge.id)) {
         graph.addEdgeWithKey(edge.id, edge.source, edge.target, edge);
@@ -2935,15 +3061,15 @@ async function addDatabasesAndCompat(graph, services, scanPath) {
 
 // src/extract/configs.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);
 var import_types8 = require("@neat.is/types");
 async function walkConfigFiles(dir) {
   const out = [];
   async function walk(current) {
-    const entries = await import_node_fs11.promises.readdir(current, { withFileTypes: true });
+    const entries = await import_node_fs12.promises.readdir(current, { withFileTypes: true });
     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() && isConfigFile(entry2.name).match) {
@@ -2960,13 +3086,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_path17.default.relative(scanPath, file);
+      const relPath = import_node_path18.default.relative(scanPath, file);
       const node = {
         id: (0, import_types8.configId)(relPath),
         type: import_types8.NodeType.ConfigNode,
-        name: import_node_path17.default.basename(file),
+        name: import_node_path18.default.basename(file),
         path: relPath,
-        fileType: isConfigFile(import_node_path17.default.basename(file)).fileType
+        fileType: isConfigFile(import_node_path18.default.basename(file)).fileType
       };
       if (!graph.hasNode(node.id)) {
         graph.addNode(node.id, node);
@@ -2978,7 +3104,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_path17.default.sep).join("/") }
+        evidence: { file: relPath.split(import_node_path18.default.sep).join("/") }
       };
       if (!graph.hasEdge(edge.id)) {
         graph.addEdgeWithKey(edge.id, edge.source, edge.target, edge);
@@ -2995,7 +3121,7 @@ var import_types14 = require("@neat.is/types");
 
 // src/extract/calls/http.ts
 init_cjs_shims();
-var import_node_path19 = __toESM(require("path"), 1);
+var import_node_path20 = __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);
@@ -3003,17 +3129,17 @@ var import_types9 = require("@neat.is/types");
 
 // src/extract/calls/shared.ts
 init_cjs_shims();
-var import_node_fs12 = require("fs");
-var import_node_path18 = __toESM(require("path"), 1);
+var import_node_fs13 = require("fs");
+var import_node_path19 = __toESM(require("path"), 1);
 async function walkSourceFiles(dir) {
   const out = [];
   async function walk(current) {
-    const entries = await import_node_fs12.promises.readdir(current, { withFileTypes: true }).catch(() => []);
+    const entries = await import_node_fs13.promises.readdir(current, { withFileTypes: true }).catch(() => []);
     for (const entry2 of entries) {
-      const full = import_node_path18.default.join(current, entry2.name);
+      const full = import_node_path19.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_path18.default.extname(entry2.name))) {
+      } else if (entry2.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path19.default.extname(entry2.name))) {
         out.push(full);
       }
     }
@@ -3026,7 +3152,7 @@ async function loadSourceFiles(dir) {
   const out = [];
   for (const p of paths) {
     try {
-      const content = await import_node_fs12.promises.readFile(p, "utf8");
+      const content = await import_node_fs13.promises.readFile(p, "utf8");
       out.push({ path: p, content });
     } catch {
     }
@@ -3045,8 +3171,27 @@ function snippet(text, line) {
 
 // src/extract/calls/http.ts
 var STRING_LITERAL_NODE_TYPES = /* @__PURE__ */ new Set(["string_fragment", "string_content"]);
+var JSX_EXTERNAL_LINK_TAGS = /* @__PURE__ */ new Set(["a", "Link", "NavLink", "ExternalLink", "Anchor"]);
+function isInsideJsxExternalLink(node) {
+  let cursor = node.parent;
+  while (cursor) {
+    if (cursor.type === "jsx_attribute") {
+      let owner = cursor.parent;
+      while (owner && owner.type !== "jsx_opening_element" && owner.type !== "jsx_self_closing_element") {
+        owner = owner.parent;
+      }
+      if (!owner) return false;
+      const tagNode = owner.namedChild(0);
+      const tagName = tagNode?.text ?? "";
+      const right = tagName.includes(".") ? tagName.split(".").pop() : tagName;
+      return JSX_EXTERNAL_LINK_TAGS.has(right);
+    }
+    cursor = cursor.parent;
+  }
+  return false;
+}
 function collectStringLiterals(node, out) {
-  if (STRING_LITERAL_NODE_TYPES.has(node.type)) out.push(node.text);
+  if (STRING_LITERAL_NODE_TYPES.has(node.type)) out.push({ text: node.text, node });
   for (let i = 0; i < node.namedChildCount; i++) {
     const child = node.namedChild(i);
     if (child) collectStringLiterals(child, out);
@@ -3058,8 +3203,9 @@ function callsFromSource(source, parser, knownHosts) {
   collectStringLiterals(tree.rootNode, literals);
   const targets = /* @__PURE__ */ new Set();
   for (const lit of literals) {
+    if (isInsideJsxExternalLink(lit.node)) continue;
     for (const host of knownHosts) {
-      if (lit.includes(`//${host}`) || lit.includes(`//${host}:`)) {
+      if (urlMatchesHost(lit.text, host)) {
         targets.add(host);
       }
     }
@@ -3082,9 +3228,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_path19.default.basename(service.dir));
+    knownHosts.add(import_node_path20.default.basename(service.dir));
     knownHosts.add(service.pkg.name);
-    hostToNodeId.set(import_node_path19.default.basename(service.dir), service.node.id);
+    hostToNodeId.set(import_node_path20.default.basename(service.dir), service.node.id);
     hostToNodeId.set(service.pkg.name, service.node.id);
   }
   let edgesAdded = 0;
@@ -3092,14 +3238,13 @@ 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_path19.default.extname(file.path) === ".py" ? pyParser : jsParser;
+      if (isTestPath(file.path)) continue;
+      const parser = import_node_path20.default.extname(file.path) === ".py" ? pyParser : jsParser;
       let targets;
       try {
         targets = callsFromSource(file.content, parser, knownHosts);
       } catch (err) {
-        console.warn(
-          `[neat] http call extraction skipped ${file.path}: ${err.message}`
-        );
+        recordExtractionError("http call extraction", file.path, err);
         continue;
       }
       for (const t of targets) {
@@ -3120,7 +3265,7 @@ async function addHttpCallEdges(graph, services) {
         type: import_types9.EdgeType.CALLS,
         provenance: import_types9.Provenance.EXTRACTED,
         evidence: {
-          file: import_node_path19.default.relative(service.dir, evidenceFile.file),
+          file: import_node_path20.default.relative(service.dir, evidenceFile.file),
           line,
           snippet: snippet(fileContent, line)
         }
@@ -3136,7 +3281,7 @@ async function addHttpCallEdges(graph, services) {
 
 // src/extract/calls/kafka.ts
 init_cjs_shims();
-var import_node_path20 = __toESM(require("path"), 1);
+var import_node_path21 = __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;
@@ -3163,7 +3308,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
       kind: "kafka-topic",
       edgeType,
       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)
       }
@@ -3176,7 +3321,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/redis.ts
 init_cjs_shims();
-var import_node_path21 = __toESM(require("path"), 1);
+var import_node_path22 = __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) {
@@ -3195,7 +3340,7 @@ function redisEndpointsFromFile(file, serviceDir) {
       kind: "redis",
       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)
       }
@@ -3206,7 +3351,7 @@ function redisEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/aws.ts
 init_cjs_shims();
-var import_node_path22 = __toESM(require("path"), 1);
+var import_node_path23 = __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;
@@ -3236,7 +3381,7 @@ function awsEndpointsFromFile(file, serviceDir) {
       kind,
       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)
       }
@@ -3261,16 +3406,42 @@ function awsEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/grpc.ts
 init_cjs_shims();
-var import_node_path23 = __toESM(require("path"), 1);
+var import_node_path24 = __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;
+var AWS_SDK_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@aws-sdk\/client-([a-z0-9-]+)['"`]/g;
+var GRPC_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@grpc\/grpc-js['"`]|_grpc_pb['"`]/;
 function isLikelyAddress(value) {
   if (!value) return false;
   return /:\d{2,5}$/.test(value) || value.includes(".");
 }
+function normaliseForMatch(s) {
+  return s.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function readImports(content) {
+  const awsSdkSuffixes = /* @__PURE__ */ new Map();
+  AWS_SDK_IMPORT_RE.lastIndex = 0;
+  let m;
+  while ((m = AWS_SDK_IMPORT_RE.exec(content)) !== null) {
+    const raw = m[1];
+    awsSdkSuffixes.set(normaliseForMatch(raw), raw);
+  }
+  return {
+    awsSdkSuffixes,
+    hasGrpcImport: GRPC_IMPORT_RE.test(content)
+  };
+}
+function classifyClient(symbol, ctx) {
+  const key = normaliseForMatch(symbol);
+  const awsRaw = ctx.awsSdkSuffixes.get(key);
+  if (awsRaw) return { kind: `aws-${awsRaw}` };
+  if (ctx.hasGrpcImport) return { kind: "grpc-service" };
+  return null;
+}
 function grpcEndpointsFromFile(file, serviceDir) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
+  const ctx = readImports(file.content);
   GRPC_CLIENT_RE.lastIndex = 0;
   let m;
   while ((m = GRPC_CLIENT_RE.exec(file.content)) !== null) {
@@ -3278,15 +3449,18 @@ function grpcEndpointsFromFile(file, serviceDir) {
     const addr = m[2]?.trim();
     const name = isLikelyAddress(addr) ? addr : symbol;
     if (seen.has(name)) continue;
+    const classified = classifyClient(symbol, ctx);
+    if (!classified) continue;
     seen.add(name);
+    const { kind } = classified;
     const line = lineOf(file.content, m[0]);
     out.push({
-      infraId: (0, import_types13.infraId)("grpc-service", name),
+      infraId: (0, import_types13.infraId)(kind, name),
       name,
-      kind: "grpc-service",
+      kind,
       edgeType: "CALLS",
       evidence: {
-        file: import_node_path23.default.relative(serviceDir, file.path),
+        file: import_node_path24.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -3306,6 +3480,9 @@ function edgeTypeFromEndpoint(ep) {
       return import_types14.EdgeType.CALLS;
   }
 }
+function isAwsKind(kind) {
+  return kind.startsWith("aws-") || kind.startsWith("s3") || kind.startsWith("dynamodb");
+}
 async function addExternalEndpointEdges(graph, services) {
   let nodesAdded = 0;
   let edgesAdded = 0;
@@ -3313,10 +3490,13 @@ async function addExternalEndpointEdges(graph, services) {
     const files = await loadSourceFiles(service.dir);
     const endpoints = [];
     for (const file of files) {
-      endpoints.push(...kafkaEndpointsFromFile(file, service.dir));
-      endpoints.push(...redisEndpointsFromFile(file, service.dir));
-      endpoints.push(...awsEndpointsFromFile(file, service.dir));
-      endpoints.push(...grpcEndpointsFromFile(file, service.dir));
+      if (isTestPath(file.path)) continue;
+      const masked = maskCommentsInSource(file.content);
+      const maskedFile = { path: file.path, content: masked };
+      endpoints.push(...kafkaEndpointsFromFile(maskedFile, service.dir));
+      endpoints.push(...redisEndpointsFromFile(maskedFile, service.dir));
+      endpoints.push(...awsEndpointsFromFile(maskedFile, service.dir));
+      endpoints.push(...grpcEndpointsFromFile(maskedFile, service.dir));
     }
     if (endpoints.length === 0) continue;
     const seenEdges = /* @__PURE__ */ new Set();
@@ -3326,7 +3506,10 @@ async function addExternalEndpointEdges(graph, services) {
           id: ep.infraId,
           type: import_types14.NodeType.InfraNode,
           name: ep.name,
-          provider: ep.kind.startsWith("s3") || ep.kind.startsWith("dynamodb") ? "aws" : "self",
+          // #238 — `aws-*` covers AWS-SDK client kinds (aws-s3, aws-dynamodb,
+          // aws-cognito-identity-provider, …); `s3-` / `dynamodb-` cover the
+          // bucket / table kinds from aws.ts.
+          provider: isAwsKind(ep.kind) ? "aws" : "self",
           kind: ep.kind
         };
         graph.addNode(node.id, node);
@@ -3366,7 +3549,7 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path24 = __toESM(require("path"), 1);
+var import_node_path25 = __toESM(require("path"), 1);
 var import_types16 = require("@neat.is/types");
 
 // src/extract/infra/shared.ts
@@ -3404,7 +3587,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path24.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path25.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -3413,7 +3596,7 @@ 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_path24.default.join(scanPath, name);
+    const abs = import_node_path25.default.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
@@ -3424,13 +3607,15 @@ async function addComposeInfra(graph, scanPath, services) {
   try {
     compose = await readYaml(composePath);
   } catch (err) {
-    console.warn(
-      `[neat] infra docker-compose skipped ${import_node_path24.default.relative(scanPath, composePath)}: ${err.message}`
+    recordExtractionError(
+      "infra docker-compose",
+      import_node_path25.default.relative(scanPath, composePath),
+      err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path24.default.relative(scanPath, composePath).split(import_node_path24.default.sep).join("/");
+  const evidenceFile = import_node_path25.default.relative(scanPath, composePath).split(import_node_path25.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -3471,8 +3656,8 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path25 = __toESM(require("path"), 1);
-var import_node_fs13 = require("fs");
+var import_node_path26 = __toESM(require("path"), 1);
+var import_node_fs14 = require("fs");
 var import_types17 = require("@neat.is/types");
 function runtimeImage(content) {
   const lines = content.split("\n");
@@ -3492,14 +3677,16 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path25.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path26.default.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
     let content;
     try {
-      content = await import_node_fs13.promises.readFile(dockerfilePath, "utf8");
+      content = await import_node_fs14.promises.readFile(dockerfilePath, "utf8");
     } catch (err) {
-      console.warn(
-        `[neat] infra dockerfile skipped ${import_node_path25.default.relative(scanPath, dockerfilePath)}: ${err.message}`
+      recordExtractionError(
+        "infra dockerfile",
+        import_node_path26.default.relative(scanPath, dockerfilePath),
+        err
       );
       continue;
     }
@@ -3519,7 +3706,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
         type: import_types17.EdgeType.RUNS_ON,
         provenance: import_types17.Provenance.EXTRACTED,
         evidence: {
-          file: import_node_path25.default.relative(scanPath, dockerfilePath).split(import_node_path25.default.sep).join("/")
+          file: import_node_path26.default.relative(scanPath, dockerfilePath).split(import_node_path26.default.sep).join("/")
         }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -3531,19 +3718,19 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 
 // src/extract/infra/terraform.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 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_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) || entry2.name === ".terraform") continue;
-      out.push(...await walkTfFiles(import_node_path26.default.join(start, entry2.name), depth + 1, max));
+      out.push(...await walkTfFiles(import_node_path27.default.join(start, entry2.name), depth + 1, max));
     } else if (entry2.isFile() && entry2.name.endsWith(".tf")) {
-      out.push(import_node_path26.default.join(start, entry2.name));
+      out.push(import_node_path27.default.join(start, entry2.name));
     }
   }
   return out;
@@ -3552,7 +3739,7 @@ async function addTerraformResources(graph, scanPath) {
   let nodesAdded = 0;
   const files = await walkTfFiles(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");
     RESOURCE_RE.lastIndex = 0;
     let m;
     while ((m = RESOURCE_RE.exec(content)) !== null) {
@@ -3570,8 +3757,8 @@ async function addTerraformResources(graph, scanPath) {
 
 // src/extract/infra/k8s.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 import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -3585,13 +3772,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_fs15.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs16.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_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));
+      out.push(...await walkYamlFiles2(import_node_path28.default.join(start, entry2.name), depth + 1, max));
+    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path28.default.extname(entry2.name))) {
+      out.push(import_node_path28.default.join(start, entry2.name));
     }
   }
   return out;
@@ -3600,7 +3787,7 @@ async function addK8sResources(graph, scanPath) {
   let nodesAdded = 0;
   const files = await walkYamlFiles2(scanPath);
   for (const file of files) {
-    const content = await import_node_fs15.promises.readFile(file, "utf8");
+    const content = await import_node_fs16.promises.readFile(file, "utf8");
     let docs;
     try {
       docs = (0, import_yaml3.parseAllDocuments)(content).map((d) => d.toJSON());
@@ -3634,9 +3821,34 @@ async function addInfra(graph, scanPath, services) {
   };
 }
 
+// src/extract/retire.ts
+init_cjs_shims();
+var import_node_fs17 = require("fs");
+var import_node_path29 = __toESM(require("path"), 1);
+var import_types18 = require("@neat.is/types");
+function retireExtractedEdgesByMissingFile(graph, scanPath, serviceDirs = []) {
+  const toDrop = [];
+  const bases = [scanPath, ...serviceDirs];
+  graph.forEachEdge((id, attrs) => {
+    const edge = attrs;
+    if (edge.provenance !== import_types18.Provenance.EXTRACTED) return;
+    const evidenceFile = edge.evidence?.file;
+    if (!evidenceFile) return;
+    if (import_node_path29.default.isAbsolute(evidenceFile)) {
+      if (!(0, import_node_fs17.existsSync)(evidenceFile)) toDrop.push(id);
+      return;
+    }
+    const found = bases.some((base) => (0, import_node_fs17.existsSync)(import_node_path29.default.join(base, evidenceFile)));
+    if (!found) toDrop.push(id);
+  });
+  for (const id of toDrop) graph.dropEdge(id);
+  return toDrop.length;
+}
+
 // src/extract/index.ts
 async function extractFromDirectory(graph, scanPath, opts = {}) {
   await ensureCompatLoaded();
+  drainExtractionErrors();
   const services = await discoverServices(scanPath);
   const phase1Nodes = addServiceNodes(graph, services);
   await addServiceAliases(graph, scanPath, services);
@@ -3644,12 +3856,30 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   const phase3 = await addConfigNodes(graph, services, scanPath);
   const phase4 = await addCallEdges(graph, services);
   const phase5 = await addInfra(graph, scanPath, services);
+  const ghostsRetired = retireExtractedEdgesByMissingFile(
+    graph,
+    scanPath,
+    services.map((s) => s.dir)
+  );
   const frontiersPromoted = promoteFrontierNodes(graph);
   if (opts.onPolicyTrigger) await opts.onPolicyTrigger(graph);
+  const errorEntries = drainExtractionErrors();
+  if (opts.errorsPath && errorEntries.length > 0) {
+    try {
+      await writeExtractionErrors(errorEntries, opts.errorsPath);
+    } catch (err) {
+      console.warn(
+        `[neat] failed to write extraction errors to ${opts.errorsPath}: ${err.message}`
+      );
+    }
+  }
   const result = {
     nodesAdded: phase1Nodes + phase2.nodesAdded + phase3.nodesAdded + phase4.nodesAdded + phase5.nodesAdded,
     edgesAdded: phase2.edgesAdded + phase3.edgesAdded + phase4.edgesAdded + phase5.edgesAdded,
-    frontiersPromoted
+    frontiersPromoted,
+    extractionErrors: errorEntries.length,
+    errorEntries,
+    ghostsRetired
   };
   emitNeatEvent({
     type: "extraction-complete",
@@ -3666,8 +3896,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
 
 // src/persist.ts
 init_cjs_shims();
-var import_node_fs16 = require("fs");
-var import_node_path28 = __toESM(require("path"), 1);
+var import_node_fs18 = require("fs");
+var import_node_path30 = __toESM(require("path"), 1);
 var SCHEMA_VERSION = 2;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -3681,7 +3911,7 @@ function migrateV1ToV2(payload) {
   return { ...payload, schemaVersion: 2 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs16.promises.mkdir(import_node_path28.default.dirname(filePath), { recursive: true });
+  await import_node_fs18.promises.mkdir(import_node_path30.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -3691,13 +3921,13 @@ async function saveGraphToDisk(graph, outPath) {
     graph: graph.export()
   };
   const tmp = `${outPath}.tmp`;
-  await import_node_fs16.promises.writeFile(tmp, JSON.stringify(payload), "utf8");
-  await import_node_fs16.promises.rename(tmp, outPath);
+  await import_node_fs18.promises.writeFile(tmp, JSON.stringify(payload), "utf8");
+  await import_node_fs18.promises.rename(tmp, outPath);
 }
 async function loadGraphFromDisk(graph, outPath) {
   let raw;
   try {
-    raw = await import_node_fs16.promises.readFile(outPath, "utf8");
+    raw = await import_node_fs18.promises.readFile(outPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") return;
     throw err;
@@ -3750,23 +3980,23 @@ function startPersistLoop(graph, outPath, intervalMs = 6e4) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path29 = __toESM(require("path"), 1);
+var import_node_path31 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      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")
+      snapshotPath: import_node_path31.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path31.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path31.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path31.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path31.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    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`)
+    snapshotPath: import_node_path31.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path31.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path31.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path31.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path31.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -3804,11 +4034,11 @@ var Projects = class {
 init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
-var import_types20 = require("@neat.is/types");
+var import_types21 = require("@neat.is/types");
 
 // src/divergences.ts
 init_cjs_shims();
-var import_types18 = require("@neat.is/types");
+var import_types19 = require("@neat.is/types");
 function bucketKey(source, target, type) {
   return `${type}|${source}|${target}`;
 }
@@ -3816,25 +4046,25 @@ function bucketEdges(graph) {
   const buckets = /* @__PURE__ */ new Map();
   graph.forEachEdge((id, attrs) => {
     const e = attrs;
-    const parsed = (0, import_types18.parseEdgeId)(id);
+    const parsed = (0, import_types19.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:
+      case import_types19.Provenance.EXTRACTED:
         cur.extracted = e;
         break;
-      case import_types18.Provenance.OBSERVED:
+      case import_types19.Provenance.OBSERVED:
         cur.observed = e;
         break;
-      case import_types18.Provenance.INFERRED:
+      case import_types19.Provenance.INFERRED:
         cur.inferred = e;
         break;
-      case import_types18.Provenance.FRONTIER:
+      case import_types19.Provenance.FRONTIER:
         cur.frontier = e;
         break;
       default:
-        if (e.provenance === import_types18.Provenance.STALE) cur.stale = e;
+        if (e.provenance === import_types19.Provenance.STALE) cur.stale = e;
     }
     buckets.set(key, cur);
   });
@@ -3843,13 +4073,13 @@ function bucketEdges(graph) {
 function nodeIsFrontier(graph, nodeId) {
   if (!graph.hasNode(nodeId)) return false;
   const attrs = graph.getNodeAttributes(nodeId);
-  return attrs.type === import_types18.NodeType.FrontierNode;
+  return attrs.type === import_types19.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;
+    if (e.provenance === import_types19.Provenance.OBSERVED) return true;
   }
   return false;
 }
@@ -3910,7 +4140,7 @@ function declaredHostFor(svc) {
 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) {
+    if (e.type === import_types19.EdgeType.CONFIGURED_BY && e.provenance === import_types19.Provenance.EXTRACTED) {
       return true;
     }
   }
@@ -3923,10 +4153,10 @@ function detectHostMismatch(graph, svcId, svc) {
   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;
+    if (edge.type !== import_types19.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types19.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types18.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types19.NodeType.DatabaseNode) continue;
     const observedHost = target.host?.trim();
     if (!observedHost) continue;
     if (observedHost === declaredHost) continue;
@@ -3948,10 +4178,10 @@ function detectCompatDivergences(graph, svcId, svc) {
   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;
+    if (edge.type !== import_types19.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types19.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types18.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types19.NodeType.DatabaseNode) continue;
     for (const pair of compatPairs()) {
       if (pair.engine !== target.engine) continue;
       const declared = deps[pair.driver];
@@ -4012,7 +4242,7 @@ function computeDivergences(graph, opts = {}) {
   }
   graph.forEachNode((nodeId, attrs) => {
     const n = attrs;
-    if (n.type !== import_types18.NodeType.ServiceNode) return;
+    if (n.type !== import_types19.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);
@@ -4036,7 +4266,7 @@ function computeDivergences(graph, opts = {}) {
     if (a.source !== b.source) return a.source.localeCompare(b.source);
     return a.target.localeCompare(b.target);
   });
-  return import_types18.DivergenceResultSchema.parse({
+  return import_types19.DivergenceResultSchema.parse({
     divergences: filtered,
     totalAffected: filtered.length,
     computedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -4045,7 +4275,7 @@ function computeDivergences(graph, opts = {}) {
 
 // src/diff.ts
 init_cjs_shims();
-var import_node_fs17 = require("fs");
+var import_node_fs19 = require("fs");
 async function loadSnapshotForDiff(target) {
   if (/^https?:\/\//i.test(target)) {
     const res = await fetch(target);
@@ -4054,7 +4284,7 @@ async function loadSnapshotForDiff(target) {
     }
     return await res.json();
   }
-  const raw = await import_node_fs17.promises.readFile(target, "utf8");
+  const raw = await import_node_fs19.promises.readFile(target, "utf8");
   return JSON.parse(raw);
 }
 function indexEntries(entries) {
@@ -4122,41 +4352,41 @@ function canonicalJson(value) {
 
 // src/registry.ts
 init_cjs_shims();
-var import_node_fs18 = require("fs");
+var import_node_fs20 = require("fs");
 var import_node_os2 = __toESM(require("os"), 1);
-var import_node_path30 = __toESM(require("path"), 1);
-var import_types19 = require("@neat.is/types");
+var import_node_path32 = __toESM(require("path"), 1);
+var import_types20 = 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_path30.default.resolve(override);
-  return import_node_path30.default.join(import_node_os2.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path32.default.resolve(override);
+  return import_node_path32.default.join(import_node_os2.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path30.default.join(neatHome(), "projects.json");
+  return import_node_path32.default.join(neatHome(), "projects.json");
 }
 function registryLockPath() {
-  return import_node_path30.default.join(neatHome(), "projects.json.lock");
+  return import_node_path32.default.join(neatHome(), "projects.json.lock");
 }
 async function writeAtomically(target, contents) {
-  await import_node_fs18.promises.mkdir(import_node_path30.default.dirname(target), { recursive: true });
+  await import_node_fs20.promises.mkdir(import_node_path32.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_fs18.promises.open(tmp, "w");
+  const fd = await import_node_fs20.promises.open(tmp, "w");
   try {
     await fd.writeFile(contents, "utf8");
     await fd.sync();
   } finally {
     await fd.close();
   }
-  await import_node_fs18.promises.rename(tmp, target);
+  await import_node_fs20.promises.rename(tmp, target);
 }
 async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS) {
   const deadline = Date.now() + timeoutMs;
-  await import_node_fs18.promises.mkdir(import_node_path30.default.dirname(lockPath), { recursive: true });
+  await import_node_fs20.promises.mkdir(import_node_path32.default.dirname(lockPath), { recursive: true });
   while (true) {
     try {
-      const fd = await import_node_fs18.promises.open(lockPath, "wx");
+      const fd = await import_node_fs20.promises.open(lockPath, "wx");
       await fd.close();
       return;
     } catch (err) {
@@ -4172,7 +4402,7 @@ async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS) {
   }
 }
 async function releaseLock(lockPath) {
-  await import_node_fs18.promises.unlink(lockPath).catch(() => {
+  await import_node_fs20.promises.unlink(lockPath).catch(() => {
   });
 }
 async function withLock(fn) {
@@ -4188,7 +4418,7 @@ async function readRegistry() {
   const file = registryPath();
   let raw;
   try {
-    raw = await import_node_fs18.promises.readFile(file, "utf8");
+    raw = await import_node_fs20.promises.readFile(file, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
       return { version: 1, projects: [] };
@@ -4196,10 +4426,10 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types19.RegistryFileSchema.parse(parsed);
+  return import_types20.RegistryFileSchema.parse(parsed);
 }
 async function writeRegistry(reg) {
-  const validated = import_types19.RegistryFileSchema.parse(reg);
+  const validated = import_types20.RegistryFileSchema.parse(reg);
   await writeAtomically(registryPath(), JSON.stringify(validated, null, 2) + "\n");
 }
 async function getProject(name) {
@@ -4409,11 +4639,11 @@ function registerRoutes(scope, ctx) {
       const candidates = req2.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);
+        const r = import_types21.DivergenceTypeSchema.safeParse(c);
         if (!r.success) {
           return reply.code(400).send({
             error: `unknown divergence type "${c}"`,
-            allowed: import_types20.DivergenceTypeSchema.options
+            allowed: import_types21.DivergenceTypeSchema.options
           });
         }
         parsed.push(r.data);
@@ -4597,7 +4827,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req2.query.severity) {
-      const sev = import_types20.PolicySeveritySchema.safeParse(req2.query.severity);
+      const sev = import_types21.PolicySeveritySchema.safeParse(req2.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -4614,7 +4844,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req2, reply) => {
     const proj = resolveProject(registry, req2, reply);
     if (!proj) return;
-    const parsed = import_types20.PoliciesCheckBodySchema.safeParse(req2.body ?? {});
+    const parsed = import_types21.PoliciesCheckBodySchema.safeParse(req2.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -4715,11 +4945,11 @@ async function buildApi(opts) {
 // src/daemon.ts
 init_otel();
 function neatHomeFor(opts) {
-  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path33.default.resolve(opts.neatHome);
+  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path35.default.resolve(opts.neatHome);
   const env = process.env.NEAT_HOME;
-  if (env && env.length > 0) return import_node_path33.default.resolve(env);
+  if (env && env.length > 0) return import_node_path35.default.resolve(env);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path33.default.join(home, ".neat");
+  return import_node_path35.default.join(home, ".neat");
 }
 function routeSpanToProject(serviceName, projects) {
   if (!serviceName) return DEFAULT_PROJECT;
@@ -4732,9 +4962,9 @@ function routeSpanToProject(serviceName, projects) {
   return DEFAULT_PROJECT;
 }
 async function bootstrapProject(entry2) {
-  const paths = pathsForProject(entry2.name, import_node_path33.default.join(entry2.path, "neat-out"));
+  const paths = pathsForProject(entry2.name, import_node_path35.default.join(entry2.path, "neat-out"));
   try {
-    const stat = await import_node_fs19.promises.stat(entry2.path);
+    const stat = await import_node_fs21.promises.stat(entry2.path);
     if (!stat.isDirectory()) {
       throw new Error(`registered path ${entry2.path} is not a directory`);
     }
@@ -4799,13 +5029,13 @@ async function startDaemon(opts = {}) {
   const home = neatHomeFor(opts);
   const regPath = registryPath();
   try {
-    await import_node_fs19.promises.access(regPath);
+    await import_node_fs21.promises.access(regPath);
   } catch {
     throw new Error(
       `neatd: registry not found at ${regPath}. Run \`neat init <path>\` to register a project before starting the daemon.`
     );
   }
-  const pidPath = import_node_path33.default.join(home, "neatd.pid");
+  const pidPath = import_node_path35.default.join(home, "neatd.pid");
   await writeAtomically(pidPath, `${process.pid}
 `);
   const slots = /* @__PURE__ */ new Map();
@@ -4874,7 +5104,7 @@ async function startDaemon(opts = {}) {
       }
       if (restApp) await restApp.close().catch(() => {
       });
-      await import_node_fs19.promises.unlink(pidPath).catch(() => {
+      await import_node_fs21.promises.unlink(pidPath).catch(() => {
       });
       throw new Error(
         `neatd: failed to bind REST on port ${restPort} \u2014 ${err.message}`
@@ -4919,7 +5149,7 @@ async function startDaemon(opts = {}) {
       });
       if (otlpApp) await otlpApp.close().catch(() => {
       });
-      await import_node_fs19.promises.unlink(pidPath).catch(() => {
+      await import_node_fs21.promises.unlink(pidPath).catch(() => {
       });
       throw new Error(
         `neatd: failed to bind OTLP on port ${otlpPort} \u2014 ${err.message}`
@@ -4959,7 +5189,7 @@ async function startDaemon(opts = {}) {
       } catch {
       }
     }
-    await import_node_fs19.promises.unlink(pidPath).catch(() => {
+    await import_node_fs21.promises.unlink(pidPath).catch(() => {
     });
   };
   return { slots, reload, stop, pidPath, restAddress, otlpAddress };
@@ -4969,7 +5199,7 @@ async function startDaemon(opts = {}) {
 init_cjs_shims();
 var import_node_child_process = require("child_process");
 var import_node_net = __toESM(require("net"), 1);
-var import_node_path34 = __toESM(require("path"), 1);
+var import_node_path36 = __toESM(require("path"), 1);
 var DEFAULT_WEB_PORT = 6328;
 async function assertPortFree(port) {
   await new Promise((resolve, reject) => {
@@ -4997,7 +5227,10 @@ function resolveWebPackageDir() {
     eval("require")
   );
   const pkgJsonPath = req.resolve("@neat.is/web/package.json");
-  return import_node_path34.default.dirname(pkgJsonPath);
+  return import_node_path36.default.dirname(pkgJsonPath);
+}
+function resolveStandaloneServerEntry(webDir) {
+  return import_node_path36.default.join(webDir, ".next/standalone/packages/web/server.js");
 }
 async function spawnWebUI(restPort) {
   const portRaw = process.env.NEAT_WEB_PORT;
@@ -5007,13 +5240,22 @@ async function spawnWebUI(restPort) {
   }
   await assertPortFree(port);
   const cwd = resolveWebPackageDir();
+  const serverEntry = resolveStandaloneServerEntry(cwd);
+  try {
+    require.resolve(serverEntry);
+  } catch {
+    throw new Error(
+      `neatd: web UI standalone build missing at ${serverEntry}. The published @neat.is/web tarball should include it; if you're running from a monorepo checkout, run \`npm run build --workspace @neat.is/web\` first, or set NEAT_WEB_DISABLED=1 to skip the web UI.`
+    );
+  }
   const env = {
     ...process.env,
     PORT: String(port),
+    HOSTNAME: process.env.HOSTNAME ?? "0.0.0.0",
     NEAT_API_URL: process.env.NEAT_API_URL ?? `http://localhost:${restPort}`
   };
-  const child = (0, import_node_child_process.spawn)("npm", ["exec", "--", "next", "start", "-p", String(port)], {
-    cwd,
+  const child = (0, import_node_child_process.spawn)(process.execPath, [serverEntry], {
+    cwd: import_node_path36.default.dirname(serverEntry),
     env,
     stdio: ["ignore", "inherit", "inherit"],
     detached: false
@@ -5050,14 +5292,14 @@ async function spawnWebUI(restPort) {
 // src/neatd.ts
 function neatHome2() {
   if (process.env.NEAT_HOME && process.env.NEAT_HOME.length > 0) {
-    return import_node_path35.default.resolve(process.env.NEAT_HOME);
+    return import_node_path37.default.resolve(process.env.NEAT_HOME);
   }
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path35.default.join(home, ".neat");
+  return import_node_path37.default.join(home, ".neat");
 }
 async function readPid() {
   try {
-    const raw = await import_node_fs20.promises.readFile(import_node_path35.default.join(neatHome2(), "neatd.pid"), "utf8");
+    const raw = await import_node_fs22.promises.readFile(import_node_path37.default.join(neatHome2(), "neatd.pid"), "utf8");
     const n = Number.parseInt(raw.trim(), 10);
     return Number.isFinite(n) ? n : null;
   } catch {