@neat.is/core 0.2.7 → 0.2.9

package/dist/server.cjs

@@ -99,8 +99,8 @@ function reshapeGrpcRequest(req) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path29.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path29.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();
@@ -155,13 +155,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path29, 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_path29 = __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();
@@ -258,10 +258,10 @@ function parseOtlpRequest(body) {
 }
 function loadProtobufDecoder() {
   if (exportTraceServiceRequestType) return exportTraceServiceRequestType;
-  const here = import_node_path30.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path30.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_path30.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 }
@@ -353,12 +353,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path30, 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_path30 = __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);
@@ -368,7 +368,7 @@ var init_otel = __esm({
 
 // src/server.ts
 init_cjs_shims();
-var import_node_path32 = __toESM(require("path"), 1);
+var import_node_path34 = __toESM(require("path"), 1);
 
 // src/graph.ts
 init_cjs_shims();
@@ -392,7 +392,7 @@ function getGraph(project = DEFAULT_PROJECT) {
 init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
-var import_types18 = require("@neat.is/types");
+var import_types19 = require("@neat.is/types");
 
 // src/policy.ts
 init_cjs_shims();
@@ -713,6 +713,18 @@ function deprecatedApis() {
   return currentMatrix().deprecatedApis ?? [];
 }
 
+// src/events.ts
+init_cjs_shims();
+var import_node_events = require("events");
+var EVENT_BUS_CHANNEL = "event";
+var NeatEventBus = class extends import_node_events.EventEmitter {
+};
+var eventBus = new NeatEventBus();
+eventBus.setMaxListeners(0);
+function emitNeatEvent(envelope) {
+  eventBus.emit(EVENT_BUS_CHANNEL, envelope);
+}
+
 // src/traverse.ts
 init_cjs_shims();
 var import_types = require("@neat.is/types");
@@ -800,19 +812,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, path33, edges) {
-    if (path33.length > best.path.length) {
-      best = { path: [...path33], edges: [...edges] };
+  function step(node, path35, edges) {
+    if (path35.length > best.path.length) {
+      best = { path: [...path35], edges: [...edges] };
     }
-    if (path33.length - 1 >= maxDepth) return;
+    if (path35.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);
-      path33.push(srcId);
+      path35.push(srcId);
       edges.push(edge);
-      step(srcId, path33, edges);
-      path33.pop();
+      step(srcId, path35, edges);
+      path35.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1276,9 +1288,11 @@ async function loadPolicyFile(policyPath) {
 }
 var PolicyViolationsLog = class {
   path;
+  project;
   seen = null;
-  constructor(logPath) {
+  constructor(logPath, project = DEFAULT_PROJECT) {
     this.path = logPath;
+    this.project = project;
   }
   async append(v) {
     if (!this.seen) await this.hydrate();
@@ -1286,6 +1300,11 @@ var PolicyViolationsLog = class {
     this.seen.add(v.id);
     await import_node_fs2.promises.mkdir(import_node_path2.default.dirname(this.path), { recursive: true });
     await import_node_fs2.promises.appendFile(this.path, JSON.stringify(v) + "\n", "utf8");
+    emitNeatEvent({
+      type: "policy-violation",
+      project: this.project,
+      payload: { violation: v }
+    });
     return true;
   }
   async readAll() {
@@ -1741,6 +1760,7 @@ async function markStaleEdges(graph, options = {}) {
   const thresholds = options.thresholds ?? loadStaleThresholdsFromEnv();
   const now = options.now ?? Date.now();
   const events = [];
+  const project = options.project ?? DEFAULT_PROJECT;
   graph.forEachEdge((id, attrs) => {
     const e = attrs;
     if (e.provenance !== import_types3.Provenance.OBSERVED) return;
@@ -1760,6 +1780,15 @@ async function markStaleEdges(graph, options = {}) {
         lastObserved: e.lastObserved,
         transitionedAt: new Date(now).toISOString()
       });
+      emitNeatEvent({
+        type: "stale-transition",
+        project,
+        payload: {
+          edgeId: id,
+          from: import_types3.Provenance.OBSERVED,
+          to: import_types3.Provenance.STALE
+        }
+      });
     }
   });
   if (options.staleEventsPath && events.length > 0) {
@@ -1790,7 +1819,8 @@ function startStalenessLoop(graph, options = {}) {
       try {
         await markStaleEdges(graph, {
           thresholds: options.thresholds,
-          staleEventsPath: options.staleEventsPath
+          staleEventsPath: options.staleEventsPath,
+          project: options.project
         });
         if (options.onPolicyTrigger) await options.onPolicyTrigger(graph);
       } catch (err) {
@@ -1817,10 +1847,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
@@ -1933,6 +1963,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() {
@@ -1949,21 +2046,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 entry of entries) {
       if (!entry.isDirectory()) continue;
       if (IGNORED_DIRS.has(entry.name)) continue;
-      const child = import_node_path6.default.join(current, entry.name);
+      const child = import_node_path7.default.join(current, entry.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);
@@ -1978,8 +2075,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("/");
@@ -1988,13 +2085,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);
       }
     });
@@ -2002,9 +2099,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),
@@ -2013,7 +2118,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 };
@@ -2029,13 +2134,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) {
@@ -2048,9 +2162,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);
         }
       }
@@ -2064,8 +2178,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}`
       );
@@ -2074,6 +2188,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) {
@@ -2097,8 +2216,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([
@@ -2125,21 +2244,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);
@@ -2178,9 +2305,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);
   }
@@ -2188,13 +2323,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 entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name)) continue;
-      out.push(...await walkYamlFiles(import_node_path7.default.join(start, entry.name), depth + 1, max));
-    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path7.default.extname(entry.name))) {
-      out.push(import_node_path7.default.join(start, entry.name));
+      out.push(...await walkYamlFiles(import_node_path8.default.join(start, entry.name), depth + 1, max));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path8.default.extname(entry.name))) {
+      out.push(import_node_path8.default.join(start, entry.name));
     }
   }
   return out;
@@ -2221,7 +2356,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());
@@ -2246,14 +2381,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 [
@@ -2271,13 +2406,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) {
@@ -2316,14 +2451,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;
   }
@@ -2374,15 +2509,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 entry of entries) {
     if (!entry.isFile()) continue;
     const match = isConfigFile(entry.name);
     if (!match.match || match.fileType !== "env") continue;
-    const filePath = import_node_path10.default.join(serviceDir, entry.name);
-    const content = await import_node_fs9.promises.readFile(filePath, "utf8");
+    const filePath = import_node_path11.default.join(serviceDir, entry.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;
@@ -2401,9 +2536,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);
@@ -2535,10 +2670,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];
@@ -2598,9 +2733,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 = [];
@@ -2627,7 +2762,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);
@@ -2654,7 +2789,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 [];
@@ -2834,7 +2969,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("/")
           }
         } : {}
       };
@@ -2862,15 +2997,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 entry of entries) {
-      const full = import_node_path16.default.join(current, entry.name);
+      const full = import_node_path17.default.join(current, entry.name);
       if (entry.isDirectory()) {
         if (!IGNORED_DIRS.has(entry.name)) await walk(full);
       } else if (entry.isFile() && isConfigFile(entry.name).match) {
@@ -2887,13 +3022,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);
@@ -2905,7 +3040,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);
@@ -2922,7 +3057,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);
@@ -2930,17 +3065,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 entry of entries) {
-      const full = import_node_path17.default.join(current, entry.name);
+      const full = import_node_path18.default.join(current, entry.name);
       if (entry.isDirectory()) {
         if (!IGNORED_DIRS.has(entry.name)) await walk(full);
-      } else if (entry.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path17.default.extname(entry.name))) {
+      } else if (entry.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path18.default.extname(entry.name))) {
         out.push(full);
       }
     }
@@ -2953,7 +3088,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 {
     }
@@ -3009,9 +3144,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;
@@ -3019,8 +3154,16 @@ 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 targets = callsFromSource(file.content, parser, knownHosts);
+      const parser = import_node_path19.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}`
+        );
+        continue;
+      }
       for (const t of targets) {
         const targetId = hostToNodeId.get(t);
         if (!targetId || targetId === service.node.id) continue;
@@ -3039,7 +3182,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)
         }
@@ -3055,7 +3198,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;
@@ -3082,7 +3225,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)
       }
@@ -3095,7 +3238,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) {
@@ -3114,7 +3257,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)
       }
@@ -3125,7 +3268,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;
@@ -3155,7 +3298,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)
       }
@@ -3180,7 +3323,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) {
@@ -3205,7 +3348,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)
       }
@@ -3285,7 +3428,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
@@ -3323,7 +3466,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;
 }
@@ -3332,16 +3475,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);
@@ -3382,8 +3533,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");
@@ -3403,9 +3554,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);
@@ -3422,7 +3581,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);
@@ -3434,19 +3593,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 entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name) || entry.name === ".terraform") continue;
-      out.push(...await walkTfFiles(import_node_path25.default.join(start, entry.name), depth + 1, max));
+      out.push(...await walkTfFiles(import_node_path26.default.join(start, entry.name), depth + 1, max));
     } else if (entry.isFile() && entry.name.endsWith(".tf")) {
-      out.push(import_node_path25.default.join(start, entry.name));
+      out.push(import_node_path26.default.join(start, entry.name));
     }
   }
   return out;
@@ -3455,7 +3614,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) {
@@ -3473,8 +3632,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",
@@ -3488,13 +3647,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 entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name)) continue;
-      out.push(...await walkYamlFiles2(import_node_path26.default.join(start, entry.name), depth + 1, max));
-    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path26.default.extname(entry.name))) {
-      out.push(import_node_path26.default.join(start, entry.name));
+      out.push(...await walkYamlFiles2(import_node_path27.default.join(start, entry.name), depth + 1, max));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path27.default.extname(entry.name))) {
+      out.push(import_node_path27.default.join(start, entry.name));
     }
   }
   return out;
@@ -3503,7 +3662,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());
@@ -3549,16 +3708,27 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   const phase5 = await addInfra(graph, scanPath, services);
   const frontiersPromoted = promoteFrontierNodes(graph);
   if (opts.onPolicyTrigger) await opts.onPolicyTrigger(graph);
-  return {
+  const result = {
     nodesAdded: phase1Nodes + phase2.nodesAdded + phase3.nodesAdded + phase4.nodesAdded + phase5.nodesAdded,
     edgesAdded: phase2.edgesAdded + phase3.edgesAdded + phase4.edgesAdded + phase5.edgesAdded,
     frontiersPromoted
   };
+  emitNeatEvent({
+    type: "extraction-complete",
+    project: opts.project ?? DEFAULT_PROJECT,
+    payload: {
+      project: opts.project ?? DEFAULT_PROJECT,
+      fileCount: services.length,
+      nodesAdded: result.nodesAdded,
+      edgesAdded: result.edgesAdded
+    }
+  });
+  return result;
 }
 
 // src/diff.ts
 init_cjs_shims();
-var import_node_fs15 = require("fs");
+var import_node_fs16 = require("fs");
 async function loadSnapshotForDiff(target) {
   if (/^https?:\/\//i.test(target)) {
     const res = await fetch(target);
@@ -3567,7 +3737,7 @@ async function loadSnapshotForDiff(target) {
     }
     return await res.json();
   }
-  const raw = await import_node_fs15.promises.readFile(target, "utf8");
+  const raw = await import_node_fs16.promises.readFile(target, "utf8");
   return JSON.parse(raw);
 }
 function indexEntries(entries) {
@@ -3635,23 +3805,23 @@ function canonicalJson(value) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path27 = __toESM(require("path"), 1);
+var import_node_path28 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path27.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path27.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path27.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path27.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path27.default.join(baseDir, "policy-violations.ndjson")
+      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")
     };
   }
   return {
-    snapshotPath: import_node_path27.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path27.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path27.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path27.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path27.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    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`)
   };
 }
 var Projects = class {
@@ -3689,6 +3859,94 @@ function parseExtraProjects(raw) {
   return raw.split(",").map((p) => p.trim()).filter((p) => p.length > 0 && p !== DEFAULT_PROJECT);
 }
 
+// src/registry.ts
+init_cjs_shims();
+var import_node_fs17 = 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");
+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");
+}
+function registryPath() {
+  return import_node_path29.default.join(neatHome(), "projects.json");
+}
+async function readRegistry() {
+  const file = registryPath();
+  let raw;
+  try {
+    raw = await import_node_fs17.promises.readFile(file, "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return { version: 1, projects: [] };
+    }
+    throw err;
+  }
+  const parsed = JSON.parse(raw);
+  return import_types18.RegistryFileSchema.parse(parsed);
+}
+async function listProjects() {
+  const reg = await readRegistry();
+  return reg.projects;
+}
+
+// src/streaming.ts
+init_cjs_shims();
+var SSE_HEARTBEAT_MS = 3e4;
+var SSE_BACKPRESSURE_CAP = 1e3;
+function handleSse(req, reply, opts) {
+  const heartbeatMs = opts.heartbeatMs ?? SSE_HEARTBEAT_MS;
+  const backpressureCap = opts.backpressureCap ?? SSE_BACKPRESSURE_CAP;
+  reply.raw.setHeader("Content-Type", "text/event-stream");
+  reply.raw.setHeader("Cache-Control", "no-cache, no-transform");
+  reply.raw.setHeader("Connection", "keep-alive");
+  reply.raw.setHeader("X-Accel-Buffering", "no");
+  reply.raw.flushHeaders?.();
+  let pending = 0;
+  let dropped = false;
+  const closeConnection = () => {
+    if (dropped) return;
+    dropped = true;
+    eventBus.off(EVENT_BUS_CHANNEL, listener);
+    clearInterval(heartbeat);
+    if (!reply.raw.writableEnded) reply.raw.end();
+  };
+  const writeFrame = (frame) => {
+    if (dropped) return;
+    if (pending >= backpressureCap) {
+      const errFrame = `event: error
+data: ${JSON.stringify({ reason: "backpressure" })}
+
+`;
+      reply.raw.write(errFrame);
+      closeConnection();
+      return;
+    }
+    pending++;
+    reply.raw.write(frame, () => {
+      pending = Math.max(0, pending - 1);
+    });
+  };
+  const listener = (envelope) => {
+    if (envelope.project !== opts.project) return;
+    writeFrame(`event: ${envelope.type}
+data: ${JSON.stringify(envelope.payload)}
+
+`);
+  };
+  eventBus.on(EVENT_BUS_CHANNEL, listener);
+  const heartbeat = setInterval(() => {
+    if (dropped) return;
+    reply.raw.write(":heartbeat\n\n");
+  }, heartbeatMs);
+  if (typeof heartbeat.unref === "function") heartbeat.unref();
+  req.raw.on("close", closeConnection);
+  reply.raw.on("close", closeConnection);
+  reply.raw.on("error", closeConnection);
+}
+
 // src/api.ts
 function serializeGraph(graph) {
   const nodes = [];
@@ -3737,6 +3995,11 @@ function buildLegacyRegistry(opts) {
 }
 function registerRoutes(scope, ctx) {
   const { registry, startedAt, errorsPathFor, staleEventsPathFor } = ctx;
+  scope.get("/events", (req, reply) => {
+    const proj = resolveProject(registry, req, reply);
+    if (!proj) return;
+    handleSse(req, reply, { project: proj.name });
+  });
   scope.get("/health", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
@@ -3947,7 +4210,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req.query.severity) {
-      const sev = import_types18.PolicySeveritySchema.safeParse(req.query.severity);
+      const sev = import_types19.PolicySeveritySchema.safeParse(req.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -3964,7 +4227,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
-    const parsed = import_types18.PoliciesCheckBodySchema.safeParse(req.body ?? {});
+    const parsed = import_types19.PoliciesCheckBodySchema.safeParse(req.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -4028,17 +4291,16 @@ async function buildApi(opts) {
     staleEventsPathFor,
     policyFilePathFor
   };
-  app.get("/projects", async () => ({
-    projects: registry.list().map((name) => {
-      const proj = registry.get(name);
-      return {
-        name,
-        nodeCount: proj.graph.order,
-        edgeCount: proj.graph.size,
-        scanPath: proj.scanPath
-      };
-    })
-  }));
+  app.get("/projects", async (_req, reply) => {
+    try {
+      return await listProjects();
+    } catch (err) {
+      return reply.code(500).send({
+        error: "failed to read project registry",
+        details: err.message
+      });
+    }
+  });
   registerRoutes(app, routeCtx);
   await app.register(
     async (scope) => {
@@ -4051,8 +4313,8 @@ async function buildApi(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;
@@ -4066,7 +4328,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);
@@ -4076,13 +4338,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;
@@ -4139,8 +4401,8 @@ init_otel_grpc();
 
 // src/search.ts
 init_cjs_shims();
-var import_node_fs17 = require("fs");
-var import_node_path31 = __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;
@@ -4270,7 +4532,7 @@ async function pickEmbedder() {
 }
 async function readCache(cachePath) {
   try {
-    const raw = await import_node_fs17.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;
@@ -4279,8 +4541,8 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, cache) {
-  await import_node_fs17.promises.mkdir(import_node_path31.default.dirname(cachePath), { recursive: true });
-  await import_node_fs17.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) {
@@ -4459,14 +4721,14 @@ async function bootProject(registry, name, scanPath, baseDir) {
 async function main() {
   const baseDirEnv = process.env.NEAT_OUT_DIR;
   const legacyOutPath = process.env.NEAT_OUT_PATH;
-  const baseDir = baseDirEnv ? import_node_path32.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path32.default.resolve(import_node_path32.default.dirname(legacyOutPath)) : import_node_path32.default.resolve("./neat-out");
-  const defaultScanPath = import_node_path32.default.resolve(process.env.NEAT_SCAN_PATH ?? "./demo");
+  const baseDir = baseDirEnv ? import_node_path34.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path34.default.resolve(import_node_path34.default.dirname(legacyOutPath)) : import_node_path34.default.resolve("./neat-out");
+  const defaultScanPath = import_node_path34.default.resolve(process.env.NEAT_SCAN_PATH ?? "./demo");
   const registry = new Projects();
   await bootProject(registry, DEFAULT_PROJECT, defaultScanPath, baseDir);
   for (const name of parseExtraProjects(process.env.NEAT_PROJECTS)) {
     const envKey = `NEAT_PROJECT_SCAN_PATH_${name.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`;
     const projectScan = process.env[envKey];
-    await bootProject(registry, name, projectScan ? import_node_path32.default.resolve(projectScan) : void 0, baseDir);
+    await bootProject(registry, name, projectScan ? import_node_path34.default.resolve(projectScan) : void 0, baseDir);
   }
   const host = process.env.HOST ?? "0.0.0.0";
   const port = Number(process.env.PORT ?? 8080);