@neat.is/core 0.4.16 → 0.4.18

package/dist/neatd.cjs

@@ -57,9 +57,9 @@ function mountBearerAuth(app, opts) {
   const suffixes = [...DEFAULT_UNAUTH_SUFFIXES, ...opts.extraUnauthenticatedSuffixes ?? []];
   const publicRead = opts.publicRead === true;
   app.addHook("preHandler", (req2, reply, done) => {
-    const path44 = (req2.url.split("?")[0] ?? "").replace(/\/+$/, "");
+    const path45 = (req2.url.split("?")[0] ?? "").replace(/\/+$/, "");
     for (const suffix of suffixes) {
-      if (path44 === suffix || path44.endsWith(suffix)) {
+      if (path45 === suffix || path45.endsWith(suffix)) {
         done();
         return;
       }
@@ -187,8 +187,8 @@ function reshapeGrpcRequest(req2) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path38.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path38.default.resolve(here, "..", "proto");
+  const here = import_node_path39.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return import_node_path39.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -256,13 +256,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path38, import_node_crypto2, grpc, protoLoader;
+var import_node_url, import_node_path39, import_node_crypto2, grpc, protoLoader;
 var init_otel_grpc = __esm({
   "src/otel-grpc.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_url = require("url");
-    import_node_path38 = __toESM(require("path"), 1);
+    import_node_path39 = __toESM(require("path"), 1);
     import_node_crypto2 = require("crypto");
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
@@ -372,10 +372,10 @@ function parseOtlpRequest(body) {
   return out;
 }
 function loadProtoRoot() {
-  const here = import_node_path39.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path39.default.resolve(here, "..", "proto");
+  const here = import_node_path40.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path40.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path39.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path40.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -473,8 +473,10 @@ async function buildOtelReceiver(opts) {
     for (const s of spans) projectQueue.push({ project, span: s });
     projectDrainPromise = projectDrainPromise.then(() => drainProject());
   };
+  const offersProjectRouting = opts.onProjectSpan !== void 0;
   const legacyEndpointWarned = /* @__PURE__ */ new Set();
   function warnLegacyEndpoint(serviceName) {
+    if (!offersProjectRouting) return;
     if (legacyEndpointWarned.has(serviceName)) return;
     legacyEndpointWarned.add(serviceName);
     console.warn(
@@ -571,12 +573,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path39, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
+var import_node_path40, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
 var init_otel = __esm({
   "src/otel.ts"() {
     "use strict";
     init_cjs_shims();
-    import_node_path39 = __toESM(require("path"), 1);
+    import_node_path40 = __toESM(require("path"), 1);
     import_node_url2 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -592,14 +594,15 @@ var init_otel = __esm({
 
 // src/neatd.ts
 init_cjs_shims();
-var import_node_fs26 = require("fs");
-var import_node_path43 = __toESM(require("path"), 1);
-var import_node_module = require("module");
+var import_node_fs27 = require("fs");
+var import_node_path44 = __toESM(require("path"), 1);
+var import_node_module2 = require("module");
 
 // src/daemon.ts
 init_cjs_shims();
 var import_node_fs25 = require("fs");
-var import_node_path41 = __toESM(require("path"), 1);
+var import_node_path42 = __toESM(require("path"), 1);
+var import_node_module = require("module");
 
 // src/graph.ts
 init_cjs_shims();
@@ -1128,19 +1131,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, path44, edges) {
-    if (path44.length > best.path.length) {
-      best = { path: [...path44], edges: [...edges] };
+  function step(node, path45, edges) {
+    if (path45.length > best.path.length) {
+      best = { path: [...path45], edges: [...edges] };
     }
-    if (path44.length - 1 >= maxDepth) return;
+    if (path45.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);
-      path44.push(srcId);
+      path45.push(srcId);
       edges.push(edge);
-      step(srcId, path44, edges);
-      path44.pop();
+      step(srcId, path45, edges);
+      path45.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1658,6 +1661,41 @@ var DEFAULT_STALE_THRESHOLDS = {
   CONFIGURED_BY: DAY_MS,
   RUNS_ON: DAY_MS
 };
+var DEFAULT_INCIDENT_THRESHOLDS = {
+  threshold: 5,
+  windowMs: 6e4
+};
+function loadIncidentThresholdsFromEnv() {
+  const raw = process.env.NEAT_INCIDENT_THRESHOLDS;
+  if (!raw) return DEFAULT_INCIDENT_THRESHOLDS;
+  try {
+    const overrides = JSON.parse(raw);
+    const merged = { ...DEFAULT_INCIDENT_THRESHOLDS };
+    if (typeof overrides.threshold === "number" && Number.isFinite(overrides.threshold) && overrides.threshold >= 1) {
+      merged.threshold = Math.floor(overrides.threshold);
+    }
+    if (typeof overrides.windowMs === "number" && Number.isFinite(overrides.windowMs) && overrides.windowMs >= 0) {
+      merged.windowMs = overrides.windowMs;
+    }
+    return merged;
+  } catch (err) {
+    console.warn(
+      `[neat] NEAT_INCIDENT_THRESHOLDS could not be parsed (${err.message}); using defaults`
+    );
+    return DEFAULT_INCIDENT_THRESHOLDS;
+  }
+}
+function httpResponseStatus(span) {
+  for (const key of ["http.response.status_code", "http.status_code"]) {
+    const v = span.attributes[key];
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+    if (typeof v === "string") {
+      const n = Number(v);
+      if (Number.isFinite(n)) return n;
+    }
+  }
+  return void 0;
+}
 function nowIso(ctx) {
   return new Date(ctx.now ? ctx.now() : Date.now()).toISOString();
 }
@@ -2071,6 +2109,71 @@ function makeErrorSpanWriter(errorsPath) {
     await import_node_fs3.promises.appendFile(errorsPath, JSON.stringify(ev) + "\n", "utf8");
   };
 }
+async function recordFailingResponseIncident(ctx, span, affectedNode, timestamp, statusCode, count, firstTimestamp) {
+  const attrs = sanitizeAttributes(span.attributes);
+  const first = firstTimestamp ?? timestamp;
+  const peer = pickAddress(span);
+  const message = count > 1 ? `${count} consecutive HTTP ${statusCode} responses` + (peer ? ` to ${peer}` : "") : `HTTP ${statusCode} response` + (peer ? ` from ${peer}` : "");
+  const ev = {
+    id: `${span.traceId}:${span.spanId}`,
+    timestamp,
+    service: span.service,
+    traceId: span.traceId,
+    spanId: span.spanId,
+    errorType: "http-failure",
+    errorMessage: message,
+    ...Object.keys(attrs).length > 0 ? { attributes: attrs } : {},
+    affectedNode,
+    httpStatusCode: statusCode,
+    incidentCount: count,
+    firstTimestamp: first,
+    lastTimestamp: timestamp
+  };
+  await appendErrorEvent(ctx, ev);
+}
+async function advance4xxBurst(ctx, span, affectedNode, ts, nowMs, status2) {
+  const { threshold, windowMs } = loadIncidentThresholdsFromEnv();
+  if (!ctx.burstState) ctx.burstState = /* @__PURE__ */ new Map();
+  const peer = pickAddress(span) ?? span.spanId;
+  const key = `${span.service}->${peer}`;
+  const existing = ctx.burstState.get(key);
+  let state;
+  if (existing && nowMs - existing.lastMs <= windowMs) {
+    existing.count += 1;
+    existing.lastTs = ts;
+    existing.lastMs = nowMs;
+    existing.codes.set(status2, (existing.codes.get(status2) ?? 0) + 1);
+    state = existing;
+  } else {
+    state = {
+      count: 1,
+      firstTs: ts,
+      lastTs: ts,
+      lastMs: nowMs,
+      codes: /* @__PURE__ */ new Map([[status2, 1]])
+    };
+    ctx.burstState.set(key, state);
+  }
+  if (state.count < threshold) return;
+  let dominant = status2;
+  let max = 0;
+  for (const [code, n] of state.codes) {
+    if (n > max) {
+      max = n;
+      dominant = code;
+    }
+  }
+  await recordFailingResponseIncident(
+    ctx,
+    span,
+    affectedNode,
+    state.lastTs,
+    dominant,
+    state.count,
+    state.firstTs
+  );
+  ctx.burstState.delete(key);
+}
 async function handleSpan(ctx, span) {
   const ts = span.startTimeIso ?? nowIso(ctx);
   const nowMs = ctx.now ? ctx.now() : Date.now();
@@ -2169,6 +2272,14 @@ async function handleSpan(ctx, span) {
       await appendErrorEvent(ctx, ev);
     }
   }
+  if (span.statusCode !== 2) {
+    const status2 = httpResponseStatus(span);
+    if (status2 !== void 0 && status2 >= 500) {
+      await recordFailingResponseIncident(ctx, span, sourceId, ts, status2, 1);
+    } else if (status2 !== void 0 && status2 >= 400 && spanMintsObservedEdge(span.kind)) {
+      await advance4xxBurst(ctx, span, sourceId, ts, nowMs, status2);
+    }
+  }
   void affectedNode;
   if (ctx.onPolicyTrigger) await ctx.onPolicyTrigger(ctx.graph);
 }
@@ -4115,7 +4226,7 @@ async function addConfigNodes(graph, services, scanPath) {
 
 // src/extract/calls/index.ts
 init_cjs_shims();
-var import_types16 = require("@neat.is/types");
+var import_types17 = require("@neat.is/types");
 
 // src/extract/calls/http.ts
 init_cjs_shims();
@@ -4468,15 +4579,75 @@ function grpcEndpointsFromFile(file, serviceDir) {
   return out;
 }
 
+// src/extract/calls/supabase.ts
+init_cjs_shims();
+var import_node_path27 = __toESM(require("path"), 1);
+var import_types16 = require("@neat.is/types");
+var SUPABASE_JS_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@supabase\/supabase-js['"`]/;
+var SUPABASE_SSR_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@supabase\/ssr['"`]/;
+var SUPABASE_CLIENT_RE = /\b(createClient|createServerClient|createBrowserClient)\s*\(\s*(?:['"`]([^'"`]*)['"`])?/g;
+function hostFromLiteral(literal) {
+  if (!literal) return null;
+  const m = /^https?:\/\/([^/:'"`\s]+)/.exec(literal.trim());
+  if (!m) return null;
+  const host = m[1];
+  if (!/\.supabase\.(co|in)$/i.test(host)) return null;
+  return host;
+}
+function readImports2(content) {
+  return {
+    hasSupabaseJs: SUPABASE_JS_IMPORT_RE.test(content),
+    hasSupabaseSsr: SUPABASE_SSR_IMPORT_RE.test(content)
+  };
+}
+function constructorMatchesImport(name, ctx) {
+  if (name === "createClient") return ctx.hasSupabaseJs;
+  return ctx.hasSupabaseSsr;
+}
+function supabaseEndpointsFromFile(file, serviceDir) {
+  const ctx = readImports2(file.content);
+  if (!ctx.hasSupabaseJs && !ctx.hasSupabaseSsr) return [];
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  SUPABASE_CLIENT_RE.lastIndex = 0;
+  let m;
+  while ((m = SUPABASE_CLIENT_RE.exec(file.content)) !== null) {
+    const ctor = m[1];
+    if (!constructorMatchesImport(ctor, ctx)) continue;
+    const host = hostFromLiteral(m[2]);
+    const name = host ?? "env";
+    if (seen.has(name)) continue;
+    seen.add(name);
+    const line = lineOf(file.content, m[0]);
+    out.push({
+      infraId: (0, import_types16.infraId)("supabase", name),
+      name,
+      kind: "supabase",
+      edgeType: "CALLS",
+      // `createClient(...)` from @supabase/supabase-js (or createServerClient /
+      // createBrowserClient from @supabase/ssr) with the import in scope — a
+      // framework-aware recognizer matched the SDK shape. Verified-call-site
+      // tier (ADR-066), the same grade aws.ts / grpc.ts emit at.
+      confidenceKind: "verified-call-site",
+      evidence: {
+        file: import_node_path27.default.relative(serviceDir, file.path),
+        line,
+        snippet: snippet(file.content, line)
+      }
+    });
+  }
+  return out;
+}
+
 // src/extract/calls/index.ts
 function edgeTypeFromEndpoint(ep) {
   switch (ep.edgeType) {
     case "PUBLISHES_TO":
-      return import_types16.EdgeType.PUBLISHES_TO;
+      return import_types17.EdgeType.PUBLISHES_TO;
     case "CONSUMES_FROM":
-      return import_types16.EdgeType.CONSUMES_FROM;
+      return import_types17.EdgeType.CONSUMES_FROM;
     default:
-      return import_types16.EdgeType.CALLS;
+      return import_types17.EdgeType.CALLS;
   }
 }
 function isAwsKind(kind) {
@@ -4496,6 +4667,7 @@ async function addExternalEndpointEdges(graph, services) {
       endpoints.push(...redisEndpointsFromFile(maskedFile, service.dir));
       endpoints.push(...awsEndpointsFromFile(maskedFile, service.dir));
       endpoints.push(...grpcEndpointsFromFile(maskedFile, service.dir));
+      endpoints.push(...supabaseEndpointsFromFile(maskedFile, service.dir));
     }
     if (endpoints.length === 0) continue;
     const seenEdges = /* @__PURE__ */ new Set();
@@ -4503,7 +4675,7 @@ async function addExternalEndpointEdges(graph, services) {
       if (!graph.hasNode(ep.infraId)) {
         const node = {
           id: ep.infraId,
-          type: import_types16.NodeType.InfraNode,
+          type: import_types17.NodeType.InfraNode,
           name: ep.name,
           // #238 — `aws-*` covers AWS-SDK client kinds (aws-s3, aws-dynamodb,
           // aws-cognito-identity-provider, …); `s3-` / `dynamodb-` cover the
@@ -4515,7 +4687,7 @@ async function addExternalEndpointEdges(graph, services) {
         nodesAdded++;
       }
       const edgeType = edgeTypeFromEndpoint(ep);
-      const confidence = (0, import_types16.confidenceForExtracted)(ep.confidenceKind);
+      const confidence = (0, import_types17.confidenceForExtracted)(ep.confidenceKind);
       const relFile = toPosix2(ep.evidence.file);
       const { fileNodeId, nodesAdded: n, edgesAdded: e } = ensureFileNode(
         graph,
@@ -4525,7 +4697,7 @@ async function addExternalEndpointEdges(graph, services) {
       );
       nodesAdded += n;
       edgesAdded += e;
-      if (!(0, import_types16.passesExtractedFloor)(confidence)) {
+      if (!(0, import_types17.passesExtractedFloor)(confidence)) {
         noteExtractedDropped({
           source: fileNodeId,
           target: ep.infraId,
@@ -4545,7 +4717,7 @@ async function addExternalEndpointEdges(graph, services) {
           source: fileNodeId,
           target: ep.infraId,
           type: edgeType,
-          provenance: import_types16.Provenance.EXTRACTED,
+          provenance: import_types17.Provenance.EXTRACTED,
           confidence,
           evidence: ep.evidence
         };
@@ -4570,16 +4742,16 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path27 = __toESM(require("path"), 1);
-var import_types18 = require("@neat.is/types");
+var import_node_path28 = __toESM(require("path"), 1);
+var import_types19 = require("@neat.is/types");
 
 // src/extract/infra/shared.ts
 init_cjs_shims();
-var import_types17 = require("@neat.is/types");
+var import_types18 = require("@neat.is/types");
 function makeInfraNode(kind, name, provider = "self", extras) {
   return {
-    id: (0, import_types17.infraId)(kind, name),
-    type: import_types17.NodeType.InfraNode,
+    id: (0, import_types18.infraId)(kind, name),
+    type: import_types18.NodeType.InfraNode,
     name,
     provider,
     kind,
@@ -4608,7 +4780,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path27.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path28.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -4617,7 +4789,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_path27.default.join(scanPath, name);
+    const abs = import_node_path28.default.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
@@ -4630,13 +4802,13 @@ async function addComposeInfra(graph, scanPath, services) {
   } catch (err) {
     recordExtractionError(
       "infra docker-compose",
-      import_node_path27.default.relative(scanPath, composePath),
+      import_node_path28.default.relative(scanPath, composePath),
       err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path27.default.relative(scanPath, composePath).split(import_node_path27.default.sep).join("/");
+  const evidenceFile = import_node_path28.default.relative(scanPath, composePath).split(import_node_path28.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -4658,15 +4830,15 @@ async function addComposeInfra(graph, scanPath, services) {
     for (const dep of dependsOnList(svc.depends_on)) {
       const targetId = composeNameToNodeId.get(dep);
       if (!targetId) continue;
-      const edgeId = (0, import_types4.extractedEdgeId)(sourceId, targetId, import_types18.EdgeType.DEPENDS_ON);
+      const edgeId = (0, import_types4.extractedEdgeId)(sourceId, targetId, import_types19.EdgeType.DEPENDS_ON);
       if (graph.hasEdge(edgeId)) continue;
       const edge = {
         id: edgeId,
         source: sourceId,
         target: targetId,
-        type: import_types18.EdgeType.DEPENDS_ON,
-        provenance: import_types18.Provenance.EXTRACTED,
-        confidence: (0, import_types18.confidenceForExtracted)("structural"),
+        type: import_types19.EdgeType.DEPENDS_ON,
+        provenance: import_types19.Provenance.EXTRACTED,
+        confidence: (0, import_types19.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -4678,9 +4850,9 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path28 = __toESM(require("path"), 1);
+var import_node_path29 = __toESM(require("path"), 1);
 var import_node_fs15 = require("fs");
-var import_types19 = require("@neat.is/types");
+var import_types20 = require("@neat.is/types");
 function runtimeImage(content) {
   const lines = content.split("\n");
   let last = null;
@@ -4699,7 +4871,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path28.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path29.default.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
     let content;
     try {
@@ -4707,7 +4879,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     } catch (err) {
       recordExtractionError(
         "infra dockerfile",
-        import_node_path28.default.relative(scanPath, dockerfilePath),
+        import_node_path29.default.relative(scanPath, dockerfilePath),
         err
       );
       continue;
@@ -4719,7 +4891,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const relDockerfile = toPosix2(import_node_path28.default.relative(service.dir, dockerfilePath));
+    const relDockerfile = toPosix2(import_node_path29.default.relative(service.dir, dockerfilePath));
     const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
       graph,
       service.pkg.name,
@@ -4728,17 +4900,17 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     );
     nodesAdded += fn;
     edgesAdded += fe;
-    const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, node.id, import_types19.EdgeType.RUNS_ON);
+    const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, node.id, import_types20.EdgeType.RUNS_ON);
     if (!graph.hasEdge(edgeId)) {
       const edge = {
         id: edgeId,
         source: fileNodeId,
         target: node.id,
-        type: import_types19.EdgeType.RUNS_ON,
-        provenance: import_types19.Provenance.EXTRACTED,
-        confidence: (0, import_types19.confidenceForExtracted)("structural"),
+        type: import_types20.EdgeType.RUNS_ON,
+        provenance: import_types20.Provenance.EXTRACTED,
+        confidence: (0, import_types20.confidenceForExtracted)("structural"),
         evidence: {
-          file: toPosix2(import_node_path28.default.relative(scanPath, dockerfilePath))
+          file: toPosix2(import_node_path29.default.relative(scanPath, dockerfilePath))
         }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -4751,7 +4923,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 // src/extract/infra/terraform.ts
 init_cjs_shims();
 var import_node_fs16 = require("fs");
-var import_node_path29 = __toESM(require("path"), 1);
+var import_node_path30 = __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 [];
@@ -4760,11 +4932,11 @@ async function walkTfFiles(start, depth = 0, max = 5) {
   for (const entry2 of entries) {
     if (entry2.isDirectory()) {
       if (IGNORED_DIRS.has(entry2.name) || entry2.name === ".terraform") continue;
-      const child = import_node_path29.default.join(start, entry2.name);
+      const child = import_node_path30.default.join(start, entry2.name);
       if (await isPythonVenvDir(child)) continue;
       out.push(...await walkTfFiles(child, depth + 1, max));
     } else if (entry2.isFile() && entry2.name.endsWith(".tf")) {
-      out.push(import_node_path29.default.join(start, entry2.name));
+      out.push(import_node_path30.default.join(start, entry2.name));
     }
   }
   return out;
@@ -4792,7 +4964,7 @@ async function addTerraformResources(graph, scanPath) {
 // src/extract/infra/k8s.ts
 init_cjs_shims();
 var import_node_fs17 = require("fs");
-var import_node_path30 = __toESM(require("path"), 1);
+var import_node_path31 = __toESM(require("path"), 1);
 var import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -4810,11 +4982,11 @@ async function walkYamlFiles2(start, depth = 0, max = 5) {
   for (const entry2 of entries) {
     if (entry2.isDirectory()) {
       if (IGNORED_DIRS.has(entry2.name)) continue;
-      const child = import_node_path30.default.join(start, entry2.name);
+      const child = import_node_path31.default.join(start, entry2.name);
       if (await isPythonVenvDir(child)) continue;
       out.push(...await walkYamlFiles2(child, depth + 1, max));
-    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path30.default.extname(entry2.name))) {
-      out.push(import_node_path30.default.join(start, entry2.name));
+    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path31.default.extname(entry2.name))) {
+      out.push(import_node_path31.default.join(start, entry2.name));
     }
   }
   return out;
@@ -4858,17 +5030,17 @@ async function addInfra(graph, scanPath, services) {
 }
 
 // src/extract/index.ts
-var import_node_path32 = __toESM(require("path"), 1);
+var import_node_path33 = __toESM(require("path"), 1);
 
 // src/extract/retire.ts
 init_cjs_shims();
 var import_node_fs18 = require("fs");
-var import_node_path31 = __toESM(require("path"), 1);
-var import_types20 = require("@neat.is/types");
+var import_node_path32 = __toESM(require("path"), 1);
+var import_types21 = require("@neat.is/types");
 function dropOrphanedFileNodes(graph) {
   const orphans = [];
   graph.forEachNode((id, attrs) => {
-    if (attrs.type !== import_types20.NodeType.FileNode) return;
+    if (attrs.type !== import_types21.NodeType.FileNode) return;
     if (graph.inboundEdges(id).length === 0 && graph.outboundEdges(id).length === 0) {
       orphans.push(id);
     }
@@ -4881,14 +5053,14 @@ function retireExtractedEdgesByMissingFile(graph, scanPath, serviceDirs = []) {
   const bases = [scanPath, ...serviceDirs];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== import_types20.Provenance.EXTRACTED) return;
+    if (edge.provenance !== import_types21.Provenance.EXTRACTED) return;
     const evidenceFile = edge.evidence?.file;
     if (!evidenceFile) return;
-    if (import_node_path31.default.isAbsolute(evidenceFile)) {
+    if (import_node_path32.default.isAbsolute(evidenceFile)) {
       if (!(0, import_node_fs18.existsSync)(evidenceFile)) toDrop.push(id);
       return;
     }
-    const found = bases.some((base) => (0, import_node_fs18.existsSync)(import_node_path31.default.join(base, evidenceFile)));
+    const found = bases.some((base) => (0, import_node_fs18.existsSync)(import_node_path32.default.join(base, evidenceFile)));
     if (!found) toDrop.push(id);
   });
   for (const id of toDrop) graph.dropEdge(id);
@@ -4928,7 +5100,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
-    const rejectedPath = import_node_path32.default.join(import_node_path32.default.dirname(opts.errorsPath), "rejected.ndjson");
+    const rejectedPath = import_node_path33.default.join(import_node_path33.default.dirname(opts.errorsPath), "rejected.ndjson");
     try {
       await writeRejectedExtracted(droppedEntries, rejectedPath);
     } catch (err) {
@@ -4963,8 +5135,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
 // src/persist.ts
 init_cjs_shims();
 var import_node_fs19 = require("fs");
-var import_node_path33 = __toESM(require("path"), 1);
-var import_types21 = require("@neat.is/types");
+var import_node_path34 = __toESM(require("path"), 1);
+var import_types22 = require("@neat.is/types");
 var SCHEMA_VERSION = 4;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -4986,12 +5158,12 @@ function migrateV2ToV3(payload) {
     for (const edge of edges) {
       const attrs = edge.attributes;
       if (!attrs || attrs.provenance !== "FRONTIER") continue;
-      attrs.provenance = import_types21.Provenance.OBSERVED;
+      attrs.provenance = import_types22.Provenance.OBSERVED;
       const type = typeof attrs.type === "string" ? attrs.type : void 0;
       const source = typeof attrs.source === "string" ? attrs.source : void 0;
       const target = typeof attrs.target === "string" ? attrs.target : void 0;
       if (type && source && target) {
-        const newId = (0, import_types21.observedEdgeId)(source, target, type);
+        const newId = (0, import_types22.observedEdgeId)(source, target, type);
         attrs.id = newId;
         if (edge.key) edge.key = newId;
       }
@@ -5000,7 +5172,7 @@ function migrateV2ToV3(payload) {
   return { ...payload, schemaVersion: 3 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs19.promises.mkdir(import_node_path33.default.dirname(filePath), { recursive: true });
+  await import_node_fs19.promises.mkdir(import_node_path34.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -5075,23 +5247,23 @@ function startPersistLoop(graph, outPath, intervalMs = 6e4) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path34 = __toESM(require("path"), 1);
+var import_node_path35 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path34.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path34.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path34.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path34.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path34.default.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: import_node_path35.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path35.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path35.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path35.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path35.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: import_node_path34.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path34.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path34.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path34.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path34.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: import_node_path35.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path35.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path35.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path35.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path35.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -5129,19 +5301,19 @@ var Projects = class {
 init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
-var import_types24 = require("@neat.is/types");
+var import_types25 = require("@neat.is/types");
 
 // src/extend/index.ts
 init_cjs_shims();
 var import_node_fs21 = require("fs");
-var import_node_path36 = __toESM(require("path"), 1);
+var import_node_path37 = __toESM(require("path"), 1);
 var import_node_os2 = __toESM(require("os"), 1);
 var import_instrumentation_registry = require("@neat.is/instrumentation-registry");
 
 // src/installers/package-manager.ts
 init_cjs_shims();
 var import_node_fs20 = require("fs");
-var import_node_path35 = __toESM(require("path"), 1);
+var import_node_path36 = __toESM(require("path"), 1);
 var import_node_child_process = require("child_process");
 var LOCKFILE_PRIORITY = [
   { lockfile: "bun.lockb", pm: "bun", args: ["install", "--no-summary"] },
@@ -5163,22 +5335,22 @@ async function exists2(p) {
   }
 }
 async function detectPackageManager(serviceDir) {
-  let dir = import_node_path35.default.resolve(serviceDir);
+  let dir = import_node_path36.default.resolve(serviceDir);
   const stops = /* @__PURE__ */ new Set();
   for (let i = 0; i < 64; i++) {
     if (stops.has(dir)) break;
     stops.add(dir);
     for (const candidate of LOCKFILE_PRIORITY) {
-      const lockPath = import_node_path35.default.join(dir, candidate.lockfile);
+      const lockPath = import_node_path36.default.join(dir, candidate.lockfile);
       if (await exists2(lockPath)) {
         return { pm: candidate.pm, cwd: dir, args: [...candidate.args] };
       }
     }
-    const parent = import_node_path35.default.dirname(dir);
+    const parent = import_node_path36.default.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return { pm: "npm", cwd: import_node_path35.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
+  return { pm: "npm", cwd: import_node_path36.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
 }
 async function runPackageManagerInstall(cmd) {
   return new Promise((resolve) => {
@@ -5227,7 +5399,7 @@ async function fileExists2(p) {
   }
 }
 async function readPackageJson(scanPath) {
-  const pkgPath = import_node_path36.default.join(scanPath, "package.json");
+  const pkgPath = import_node_path37.default.join(scanPath, "package.json");
   const raw = await import_node_fs21.promises.readFile(pkgPath, "utf8");
   return JSON.parse(raw);
 }
@@ -5238,11 +5410,11 @@ async function findHookFiles(scanPath) {
   ).sort();
 }
 function extendLogPath() {
-  return process.env.NEAT_EXTEND_LOG ?? import_node_path36.default.join(import_node_os2.default.homedir(), ".neat", "extend-log.ndjson");
+  return process.env.NEAT_EXTEND_LOG ?? import_node_path37.default.join(import_node_os2.default.homedir(), ".neat", "extend-log.ndjson");
 }
 async function appendExtendLog(entry2) {
   const logPath = extendLogPath();
-  await import_node_fs21.promises.mkdir(import_node_path36.default.dirname(logPath), { recursive: true });
+  await import_node_fs21.promises.mkdir(import_node_path37.default.dirname(logPath), { recursive: true });
   await import_node_fs21.promises.appendFile(logPath, JSON.stringify(entry2) + "\n", "utf8");
 }
 function splicedContent(fileContent, snippet2) {
@@ -5301,7 +5473,7 @@ function lookupInstrumentation(library, installedVersion) {
 }
 async function describeProjectInstrumentation(ctx) {
   const hookFiles = await findHookFiles(ctx.scanPath);
-  const envNeat = await fileExists2(import_node_path36.default.join(ctx.scanPath, ".env.neat"));
+  const envNeat = await fileExists2(import_node_path37.default.join(ctx.scanPath, ".env.neat"));
   const registryInstrPackages = new Set(
     (0, import_instrumentation_registry.list)().map((e) => e.instrumentation_package).filter((p) => !!p)
   );
@@ -5323,16 +5495,16 @@ async function applyExtension(ctx, args, options) {
     );
   }
   for (const file of hookFiles) {
-    const content = await import_node_fs21.promises.readFile(import_node_path36.default.join(ctx.scanPath, file), "utf8");
+    const content = await import_node_fs21.promises.readFile(import_node_path37.default.join(ctx.scanPath, file), "utf8");
     if (content.includes(args.registration_snippet)) {
       return { library: args.library, filesTouched: [], depsAdded: [], installOutput: "", alreadyApplied: true };
     }
   }
   const primaryFile = hookFiles[0];
-  const primaryPath = import_node_path36.default.join(ctx.scanPath, primaryFile);
+  const primaryPath = import_node_path37.default.join(ctx.scanPath, primaryFile);
   const filesTouched = [];
   const depsAdded = [];
-  const pkgPath = import_node_path36.default.join(ctx.scanPath, "package.json");
+  const pkgPath = import_node_path37.default.join(ctx.scanPath, "package.json");
   const pkg = await readPackageJson(ctx.scanPath);
   if (!(pkg.dependencies ?? {})[args.instrumentation_package]) {
     pkg.dependencies = { ...pkg.dependencies ?? {}, [args.instrumentation_package]: args.version };
@@ -5378,7 +5550,7 @@ async function dryRunExtension(ctx, args) {
     };
   }
   for (const file of hookFiles) {
-    const content = await import_node_fs21.promises.readFile(import_node_path36.default.join(ctx.scanPath, file), "utf8");
+    const content = await import_node_fs21.promises.readFile(import_node_path37.default.join(ctx.scanPath, file), "utf8");
     if (content.includes(args.registration_snippet)) {
       return {
         library: args.library,
@@ -5400,7 +5572,7 @@ async function dryRunExtension(ctx, args) {
     depsToAdd.push(`${args.instrumentation_package}@${args.version}`);
     filesTouched.push("package.json");
   }
-  const hookContent = await import_node_fs21.promises.readFile(import_node_path36.default.join(ctx.scanPath, primaryFile), "utf8");
+  const hookContent = await import_node_fs21.promises.readFile(import_node_path37.default.join(ctx.scanPath, primaryFile), "utf8");
   const patched = splicedContent(hookContent, args.registration_snippet);
   if (patched) {
     filesTouched.push(primaryFile);
@@ -5421,7 +5593,7 @@ async function rollbackExtension(ctx, args) {
   if (!match) {
     return { undone: false, message: "no apply found for library" };
   }
-  const pkgPath = import_node_path36.default.join(ctx.scanPath, "package.json");
+  const pkgPath = import_node_path37.default.join(ctx.scanPath, "package.json");
   if (await fileExists2(pkgPath)) {
     const pkg = await readPackageJson(ctx.scanPath);
     if (pkg.dependencies?.[match.instrumentation_package]) {
@@ -5432,7 +5604,7 @@ async function rollbackExtension(ctx, args) {
   }
   const hookFiles = await findHookFiles(ctx.scanPath);
   for (const file of hookFiles) {
-    const filePath = import_node_path36.default.join(ctx.scanPath, file);
+    const filePath = import_node_path37.default.join(ctx.scanPath, file);
     const content = await import_node_fs21.promises.readFile(filePath, "utf8");
     if (content.includes(match.registration_snippet)) {
       const filtered = content.split("\n").filter((line) => !line.includes(match.registration_snippet)).join("\n");
@@ -5448,7 +5620,7 @@ async function rollbackExtension(ctx, args) {
 
 // src/divergences.ts
 init_cjs_shims();
-var import_types22 = require("@neat.is/types");
+var import_types23 = require("@neat.is/types");
 function bucketKey(source, target, type) {
   return `${type}|${source}|${target}`;
 }
@@ -5456,22 +5628,22 @@ function bucketEdges(graph) {
   const buckets = /* @__PURE__ */ new Map();
   graph.forEachEdge((id, attrs) => {
     const e = attrs;
-    const parsed = (0, import_types22.parseEdgeId)(id);
+    const parsed = (0, import_types23.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_types22.Provenance.EXTRACTED:
+      case import_types23.Provenance.EXTRACTED:
         cur.extracted = e;
         break;
-      case import_types22.Provenance.OBSERVED:
+      case import_types23.Provenance.OBSERVED:
         cur.observed = e;
         break;
-      case import_types22.Provenance.INFERRED:
+      case import_types23.Provenance.INFERRED:
         cur.inferred = e;
         break;
       default:
-        if (e.provenance === import_types22.Provenance.STALE) cur.stale = e;
+        if (e.provenance === import_types23.Provenance.STALE) cur.stale = e;
     }
     buckets.set(key, cur);
   });
@@ -5480,7 +5652,7 @@ function bucketEdges(graph) {
 function nodeIsFrontier(graph, nodeId) {
   if (!graph.hasNode(nodeId)) return false;
   const attrs = graph.getNodeAttributes(nodeId);
-  return attrs.type === import_types22.NodeType.FrontierNode;
+  return attrs.type === import_types23.NodeType.FrontierNode;
 }
 function clampConfidence(n) {
   if (!Number.isFinite(n)) return 0;
@@ -5501,7 +5673,7 @@ function gradedConfidence(edge) {
 }
 function detectMissingDivergences(graph, bucket) {
   const out = [];
-  if (bucket.type === import_types22.EdgeType.CONTAINS) return out;
+  if (bucket.type === import_types23.EdgeType.CONTAINS) return out;
   if (bucket.extracted && !bucket.observed) {
     if (!nodeIsFrontier(graph, bucket.target)) {
       out.push({
@@ -5542,7 +5714,7 @@ function declaredHostFor(svc) {
 function hasExtractedConfiguredBy(graph, svcId) {
   for (const edgeId of graph.outboundEdges(svcId)) {
     const e = graph.getEdgeAttributes(edgeId);
-    if (e.type === import_types22.EdgeType.CONFIGURED_BY && e.provenance === import_types22.Provenance.EXTRACTED) {
+    if (e.type === import_types23.EdgeType.CONFIGURED_BY && e.provenance === import_types23.Provenance.EXTRACTED) {
       return true;
     }
   }
@@ -5555,10 +5727,10 @@ function detectHostMismatch(graph, svcId, svc) {
   const out = [];
   for (const edgeId of graph.outboundEdges(svcId)) {
     const edge = graph.getEdgeAttributes(edgeId);
-    if (edge.type !== import_types22.EdgeType.CONNECTS_TO) continue;
-    if (edge.provenance !== import_types22.Provenance.OBSERVED) continue;
+    if (edge.type !== import_types23.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types23.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types22.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types23.NodeType.DatabaseNode) continue;
     const observedHost = target.host?.trim();
     if (!observedHost) continue;
     if (observedHost === declaredHost) continue;
@@ -5580,10 +5752,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_types22.EdgeType.CONNECTS_TO) continue;
-    if (edge.provenance !== import_types22.Provenance.OBSERVED) continue;
+    if (edge.type !== import_types23.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types23.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types22.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types23.NodeType.DatabaseNode) continue;
     for (const pair of compatPairs()) {
       if (pair.engine !== target.engine) continue;
       const declared = deps[pair.driver];
@@ -5644,7 +5816,7 @@ function computeDivergences(graph, opts = {}) {
   }
   graph.forEachNode((nodeId, attrs) => {
     const n = attrs;
-    if (n.type !== import_types22.NodeType.ServiceNode) return;
+    if (n.type !== import_types23.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);
@@ -5677,7 +5849,7 @@ function computeDivergences(graph, opts = {}) {
     if (a.source !== b.source) return a.source.localeCompare(b.source);
     return a.target.localeCompare(b.target);
   });
-  return import_types22.DivergenceResultSchema.parse({
+  return import_types23.DivergenceResultSchema.parse({
     divergences: filtered,
     totalAffected: filtered.length,
     computedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -5765,23 +5937,23 @@ function canonicalJson(value) {
 init_cjs_shims();
 var import_node_fs23 = require("fs");
 var import_node_os3 = __toESM(require("os"), 1);
-var import_node_path37 = __toESM(require("path"), 1);
-var import_types23 = require("@neat.is/types");
+var import_node_path38 = __toESM(require("path"), 1);
+var import_types24 = 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_path37.default.resolve(override);
-  return import_node_path37.default.join(import_node_os3.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path38.default.resolve(override);
+  return import_node_path38.default.join(import_node_os3.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path37.default.join(neatHome(), "projects.json");
+  return import_node_path38.default.join(neatHome(), "projects.json");
 }
 function registryLockPath() {
-  return import_node_path37.default.join(neatHome(), "projects.json.lock");
+  return import_node_path38.default.join(neatHome(), "projects.json.lock");
 }
 function daemonPidPath() {
-  return import_node_path37.default.join(neatHome(), "neatd.pid");
+  return import_node_path38.default.join(neatHome(), "neatd.pid");
 }
 function isPidAliveDefault(pid) {
   try {
@@ -5841,7 +6013,7 @@ function lockHolderMessage(holder, lockPath, timeoutMs) {
   }
 }
 async function writeAtomically(target, contents) {
-  await import_node_fs23.promises.mkdir(import_node_path37.default.dirname(target), { recursive: true });
+  await import_node_fs23.promises.mkdir(import_node_path38.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_fs23.promises.open(tmp, "w");
   try {
@@ -5854,7 +6026,7 @@ async function writeAtomically(target, contents) {
 }
 async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS, probe = defaultLockHolderProbe) {
   const deadline = Date.now() + timeoutMs;
-  await import_node_fs23.promises.mkdir(import_node_path37.default.dirname(lockPath), { recursive: true });
+  await import_node_fs23.promises.mkdir(import_node_path38.default.dirname(lockPath), { recursive: true });
   let probedHolder = false;
   while (true) {
     try {
@@ -5907,10 +6079,10 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types23.RegistryFileSchema.parse(parsed);
+  return import_types24.RegistryFileSchema.parse(parsed);
 }
 async function writeRegistry(reg) {
-  const validated = import_types23.RegistryFileSchema.parse(reg);
+  const validated = import_types24.RegistryFileSchema.parse(reg);
   await writeAtomically(registryPath(), JSON.stringify(validated, null, 2) + "\n");
 }
 async function getProject(name) {
@@ -5940,6 +6112,58 @@ async function touchLastSeen(name, at = (/* @__PURE__ */ new Date()).toISOString
     await writeRegistry(reg);
   });
 }
+var DAY_MS2 = 24 * 60 * 60 * 1e3;
+var DEFAULT_PRUNE_TTL_MS = 7 * DAY_MS2;
+function pruneTtlMs() {
+  const raw = process.env.NEAT_REGISTRY_PRUNE_TTL_MS;
+  if (!raw) return DEFAULT_PRUNE_TTL_MS;
+  const n = Number.parseInt(raw, 10);
+  if (Number.isFinite(n) && n >= 0) return n;
+  console.warn(
+    `[neat] NEAT_REGISTRY_PRUNE_TTL_MS could not be parsed (${raw}); using default ${DEFAULT_PRUNE_TTL_MS}ms`
+  );
+  return DEFAULT_PRUNE_TTL_MS;
+}
+async function statPathStatus(p) {
+  try {
+    const stat = await import_node_fs23.promises.stat(p);
+    return stat.isDirectory() ? "present" : "unknown";
+  } catch (err) {
+    return err.code === "ENOENT" ? "gone" : "unknown";
+  }
+}
+async function pruneRegistry(opts = {}) {
+  const ttlMs = opts.ttlMs ?? pruneTtlMs();
+  const statPath = opts.statPath ?? statPathStatus;
+  const now = opts.now ?? Date.now;
+  return withLock(async () => {
+    const reg = await readRegistry();
+    const removed = [];
+    const kept = [];
+    for (const entry2 of reg.projects) {
+      const status2 = await statPath(entry2.path);
+      if (status2 !== "gone") {
+        kept.push(entry2);
+        continue;
+      }
+      if (ttlMs <= 0) {
+        removed.push(entry2);
+        continue;
+      }
+      const lastSeen = Date.parse(entry2.lastSeenAt ?? entry2.registeredAt);
+      const age = now() - (Number.isFinite(lastSeen) ? lastSeen : 0);
+      if (age > ttlMs) {
+        removed.push(entry2);
+      } else {
+        kept.push(entry2);
+      }
+    }
+    if (removed.length === 0) return [];
+    reg.projects = kept;
+    await writeRegistry(reg);
+    return removed;
+  });
+}
 
 // src/streaming.ts
 init_cjs_shims();
@@ -5953,6 +6177,7 @@ function handleSse(req2, reply, opts) {
   reply.raw.setHeader("Connection", "keep-alive");
   reply.raw.setHeader("X-Accel-Buffering", "no");
   reply.raw.flushHeaders?.();
+  reply.raw.write(":open\n\n");
   let pending = 0;
   let dropped = false;
   const closeConnection = () => {
@@ -6132,11 +6357,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_types24.DivergenceTypeSchema.safeParse(c);
+        const r = import_types25.DivergenceTypeSchema.safeParse(c);
         if (!r.success) {
           return reply.code(400).send({
             error: `unknown divergence type "${c}"`,
-            allowed: import_types24.DivergenceTypeSchema.options
+            allowed: import_types25.DivergenceTypeSchema.options
           });
         }
         parsed.push(r.data);
@@ -6349,7 +6574,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req2.query.severity) {
-      const sev = import_types24.PolicySeveritySchema.safeParse(req2.query.severity);
+      const sev = import_types25.PolicySeveritySchema.safeParse(req2.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -6366,7 +6591,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req2, reply) => {
     const proj = resolveProject(registry, req2, reply, ctx.bootstrap);
     if (!proj) return;
-    const parsed = import_types24.PoliciesCheckBodySchema.safeParse(req2.body ?? {});
+    const parsed = import_types25.PoliciesCheckBodySchema.safeParse(req2.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -6609,7 +6834,7 @@ init_auth();
 // src/unrouted.ts
 init_cjs_shims();
 var import_node_fs24 = require("fs");
-var import_node_path40 = __toESM(require("path"), 1);
+var import_node_path41 = __toESM(require("path"), 1);
 function buildUnroutedSpanRecord(serviceName, traceId, now = /* @__PURE__ */ new Date()) {
   return {
     timestamp: now.toISOString(),
@@ -6619,15 +6844,68 @@ function buildUnroutedSpanRecord(serviceName, traceId, now = /* @__PURE__ */ new
   };
 }
 async function appendUnroutedSpan(neatHome3, record) {
-  const target = import_node_path40.default.join(neatHome3, "errors.ndjson");
+  const target = import_node_path41.default.join(neatHome3, "errors.ndjson");
   await import_node_fs24.promises.mkdir(neatHome3, { recursive: true });
   await import_node_fs24.promises.appendFile(target, JSON.stringify(record) + "\n", "utf8");
 }
 function unroutedErrorsPath(neatHome3) {
-  return import_node_path40.default.join(neatHome3, "errors.ndjson");
+  return import_node_path41.default.join(neatHome3, "errors.ndjson");
 }
 
 // src/daemon.ts
+function daemonJsonPath(scanPath) {
+  return import_node_path42.default.join(scanPath, "neat-out", "daemon.json");
+}
+function daemonsDiscoveryDir(home) {
+  const base = home && home.length > 0 ? home : neatHomeFromEnv();
+  return import_node_path42.default.join(base, "daemons");
+}
+function daemonDiscoveryPath(project, home) {
+  return import_node_path42.default.join(daemonsDiscoveryDir(home), `${sanitizeDiscoveryName(project)}.json`);
+}
+function sanitizeDiscoveryName(project) {
+  return project.replace(/[^A-Za-z0-9._-]/g, "_");
+}
+function neatHomeFromEnv() {
+  const env = process.env.NEAT_HOME;
+  if (env && env.length > 0) return import_node_path42.default.resolve(env);
+  const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+  return import_node_path42.default.join(home, ".neat");
+}
+function resolveNeatVersion() {
+  if (process.env.NEAT_LOCAL_VERSION && process.env.NEAT_LOCAL_VERSION.length > 0) {
+    return process.env.NEAT_LOCAL_VERSION;
+  }
+  try {
+    const req2 = (0, import_node_module.createRequire)(importMetaUrl);
+    const pkg = req2("../package.json");
+    return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+async function writeDaemonRecord(record, home) {
+  const body = JSON.stringify(record, null, 2) + "\n";
+  await writeAtomically(daemonJsonPath(record.projectPath), body);
+  try {
+    await writeAtomically(daemonDiscoveryPath(record.project, home), body);
+  } catch (err) {
+    console.warn(
+      `neatd: could not write discovery copy for "${record.project}" \u2014 ${err.message}`
+    );
+  }
+}
+async function clearDaemonRecord(record, home) {
+  try {
+    const stopped = { ...record, status: "stopped" };
+    await writeAtomically(daemonJsonPath(record.projectPath), JSON.stringify(stopped, null, 2) + "\n");
+  } catch {
+  }
+  try {
+    await import_node_fs25.promises.unlink(daemonDiscoveryPath(record.project, home));
+  } catch {
+  }
+}
 function teardownSlot(slot) {
   try {
     slot.stopPersist();
@@ -6639,11 +6917,11 @@ function teardownSlot(slot) {
   }
 }
 function neatHomeFor(opts) {
-  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path41.default.resolve(opts.neatHome);
+  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path42.default.resolve(opts.neatHome);
   const env = process.env.NEAT_HOME;
-  if (env && env.length > 0) return import_node_path41.default.resolve(env);
+  if (env && env.length > 0) return import_node_path42.default.resolve(env);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path41.default.join(home, ".neat");
+  return import_node_path42.default.join(home, ".neat");
 }
 function routeSpanToProject(serviceName, projects) {
   if (!serviceName) return DEFAULT_PROJECT;
@@ -6678,7 +6956,7 @@ function isTokenContained(needle, haystack) {
   return tokens.includes(needle);
 }
 async function bootstrapProject(entry2) {
-  const paths = pathsForProject(entry2.name, import_node_path41.default.join(entry2.path, "neat-out"));
+  const paths = pathsForProject(entry2.name, import_node_path42.default.join(entry2.path, "neat-out"));
   try {
     const stat = await import_node_fs25.promises.stat(entry2.path);
     if (!stat.isDirectory()) {
@@ -6744,6 +7022,23 @@ function resolveOtlpPort(opts) {
   }
   return 4318;
 }
+function resolveWebPort() {
+  const env = process.env.NEAT_WEB_PORT;
+  if (env && env.length > 0) {
+    const n = Number.parseInt(env, 10);
+    if (Number.isFinite(n)) return n;
+  }
+  return 6328;
+}
+function portFromListenAddress(address, fallback) {
+  try {
+    const port = new URL(address).port;
+    const n = Number.parseInt(port, 10);
+    if (Number.isFinite(n) && n > 0) return n;
+  } catch {
+  }
+  return fallback;
+}
 function resolveHost(opts, authTokenSet) {
   if (opts.host && opts.host.length > 0) return opts.host;
   const env = process.env.HOST;
@@ -6754,14 +7049,25 @@ function resolveHost(opts, authTokenSet) {
 async function startDaemon(opts = {}) {
   const home = neatHomeFor(opts);
   const regPath = registryPath();
-  try {
-    await import_node_fs25.promises.access(regPath);
-  } catch {
+  const projectArg = typeof opts.project === "string" && opts.project.length > 0 ? opts.project : process.env.NEAT_PROJECT && process.env.NEAT_PROJECT.length > 0 ? process.env.NEAT_PROJECT : null;
+  const projectPathArg = opts.projectPath && opts.projectPath.length > 0 ? opts.projectPath : process.env.NEAT_PROJECT_PATH && process.env.NEAT_PROJECT_PATH.length > 0 ? process.env.NEAT_PROJECT_PATH : null;
+  const singleProject = projectArg;
+  const singleProjectPath = singleProject && projectPathArg ? import_node_path42.default.resolve(projectPathArg) : null;
+  if (singleProject && !singleProjectPath) {
     throw new Error(
-      `neatd: registry not found at ${regPath}. Run \`neat init <path>\` to register a project before starting the daemon.`
+      `neatd: project "${singleProject}" given without a projectPath; pass NEAT_PROJECT_PATH alongside NEAT_PROJECT.`
     );
   }
-  const pidPath = import_node_path41.default.join(home, "neatd.pid");
+  if (!singleProject) {
+    try {
+      await import_node_fs25.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_path42.default.join(home, "neatd.pid");
   await writeAtomically(pidPath, `${process.pid}
 `);
   const slots = /* @__PURE__ */ new Map();
@@ -6849,8 +7155,37 @@ async function startDaemon(opts = {}) {
       });
     }
   }
+  async function enumerateProjects() {
+    if (singleProject && singleProjectPath) {
+      return [
+        {
+          name: singleProject,
+          path: singleProjectPath,
+          registeredAt: (/* @__PURE__ */ new Date()).toISOString(),
+          languages: [],
+          status: "active"
+        }
+      ];
+    }
+    return listProjects();
+  }
   async function loadAll() {
-    const projects = await listProjects();
+    if (!singleProject) {
+      try {
+        const pruned = await pruneRegistry();
+        for (const entry2 of pruned) {
+          console.log(
+            `neatd: pruned project "${entry2.name}" \u2014 registered path ${entry2.path} is gone`
+          );
+          slots.delete(entry2.name);
+          bootstrapStatus.delete(entry2.name);
+          bootstrapStartedAt.delete(entry2.name);
+        }
+      } catch (err) {
+        console.warn(`neatd: registry prune skipped \u2014 ${err.message}`);
+      }
+    }
+    const projects = await enumerateProjects();
     const seen = /* @__PURE__ */ new Set();
     const pending = [];
     for (const entry2 of projects) {
@@ -6875,7 +7210,7 @@ async function startDaemon(opts = {}) {
     }
     await Promise.allSettled(pending);
   }
-  const initialEntries = await listProjects().catch(() => []);
+  const initialEntries = await enumerateProjects().catch(() => []);
   for (const entry2 of initialEntries) {
     bootstrapStatus.set(entry2.name, "bootstrapping");
     bootstrapStartedAt.set(entry2.name, Date.now());
@@ -6885,6 +7220,7 @@ async function startDaemon(opts = {}) {
   let otlpApp = null;
   let restAddress = "";
   let otlpAddress = "";
+  let daemonRecord = null;
   if (bind) {
     const auth = readAuthEnv();
     const host = resolveHost(opts, Boolean(auth.authToken));
@@ -6909,6 +7245,20 @@ async function startDaemon(opts = {}) {
           }
         }
       });
+      if (singleProject) {
+        restApp.addHook("onSend", async (req2, _reply, payload) => {
+          if (req2.url.split("?")[0] !== "/health") return payload;
+          if (typeof payload !== "string") return payload;
+          try {
+            const body = JSON.parse(payload);
+            if (typeof body !== "object" || body === null) return payload;
+            body.project = singleProject;
+            return JSON.stringify(body);
+          } catch {
+            return payload;
+          }
+        });
+      }
       restAddress = await restApp.listen({ port: restPort, host });
       console.log(`neatd: REST listening on ${restAddress}`);
     } catch (err) {
@@ -6924,6 +7274,25 @@ async function startDaemon(opts = {}) {
       );
     }
     async function resolveTargetSlot(serviceName, traceId) {
+      if (singleProject) {
+        let slot2 = slots.get(singleProject);
+        if (!slot2) {
+          slot2 = await tryRecoverSlot({
+            name: singleProject,
+            path: singleProjectPath,
+            registeredAt: (/* @__PURE__ */ new Date()).toISOString(),
+            languages: [],
+            status: "active"
+          });
+        } else if (slot2.status === "broken") {
+          slot2 = await tryRecoverSlot(slot2.entry);
+        }
+        if (!slot2 || slot2.status !== "active") {
+          warnDroppedSpan(singleProject, slot2?.errorReason ?? "unknown");
+          return null;
+        }
+        return slot2;
+      }
       const liveEntries = await listProjects().catch(() => []);
       const target = routeSpanToProject(serviceName, liveEntries);
       let slot = slots.get(target) ?? slots.get(DEFAULT_PROJECT);
@@ -7026,6 +7395,42 @@ async function startDaemon(opts = {}) {
         `neatd: failed to bind OTLP on port ${otlpPort} \u2014 ${err.message}`
       );
     }
+    if (singleProject && singleProjectPath) {
+      const ports = {
+        rest: portFromListenAddress(restAddress, restPort),
+        otlp: portFromListenAddress(otlpAddress, otlpPort),
+        // The daemon doesn't bind the web port itself (neatd spawns the web
+        // child); it records the allocated value passed through so the
+        // dashboard and `neat ps` agree on where to look.
+        web: typeof opts.webPort === "number" ? opts.webPort : resolveWebPort()
+      };
+      daemonRecord = {
+        project: singleProject,
+        projectPath: singleProjectPath,
+        pid: process.pid,
+        status: "running",
+        ports,
+        startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        neatVersion: resolveNeatVersion()
+      };
+      try {
+        await writeDaemonRecord(daemonRecord, home);
+        console.log(
+          `neatd: project "${singleProject}" \u2192 REST ${ports.rest} / OTLP ${ports.otlp} / web ${ports.web} (daemon.json written)`
+        );
+      } catch (err) {
+        for (const slot of slots.values()) teardownSlot(slot);
+        if (restApp) await restApp.close().catch(() => {
+        });
+        if (otlpApp) await otlpApp.close().catch(() => {
+        });
+        await import_node_fs25.promises.unlink(pidPath).catch(() => {
+        });
+        throw new Error(
+          `neatd: failed to write daemon.json for "${singleProject}" \u2014 ${err.message}`
+        );
+      }
+    }
   }
   const initialBootstrap = loadAll().catch((err) => {
     console.warn(`neatd: initial bootstrap pass failed \u2014 ${err.message}`);
@@ -7065,9 +7470,9 @@ async function startDaemon(opts = {}) {
   const REGISTRY_RELOAD_DEBOUNCE_MS = 500;
   let registryWatcher = null;
   let reloadTimer = null;
-  try {
-    const regDir = import_node_path41.default.dirname(regPath);
-    const regBase = import_node_path41.default.basename(regPath);
+  if (!singleProject) try {
+    const regDir = import_node_path42.default.dirname(regPath);
+    const regBase = import_node_path42.default.basename(regPath);
     registryWatcher = (0, import_node_fs25.watch)(regDir, (_eventType, filename) => {
       if (filename !== null && filename !== regBase) return;
       if (reloadTimer) clearTimeout(reloadTimer);
@@ -7108,6 +7513,9 @@ async function startDaemon(opts = {}) {
     for (const slot of slots.values()) {
       teardownSlot(slot);
     }
+    if (daemonRecord) {
+      await clearDaemonRecord(daemonRecord, home);
+    }
     await import_node_fs25.promises.unlink(pidPath).catch(() => {
     });
   };
@@ -7119,7 +7527,8 @@ async function startDaemon(opts = {}) {
     restAddress,
     otlpAddress,
     bootstrap: tracker,
-    initialBootstrap
+    initialBootstrap,
+    daemonRecord
   };
 }
 
@@ -7129,9 +7538,40 @@ init_auth();
 // src/web-spawn.ts
 init_cjs_shims();
 var import_node_child_process2 = require("child_process");
+var import_node_fs26 = require("fs");
 var import_node_net = __toESM(require("net"), 1);
-var import_node_path42 = __toESM(require("path"), 1);
+var import_node_path43 = __toESM(require("path"), 1);
 var DEFAULT_WEB_PORT = 6328;
+var DEFAULT_REST_PORT = 8080;
+function asValidPort(value) {
+  const n = typeof value === "number" ? value : Number.parseInt(String(value ?? ""), 10);
+  return Number.isInteger(n) && n > 0 && n <= 65535 ? n : null;
+}
+function projectRoot() {
+  const fromEnv = process.env.NEAT_SCAN_PATH;
+  return import_node_path43.default.resolve(fromEnv && fromEnv.length > 0 ? fromEnv : process.cwd());
+}
+async function readDaemonPorts(root) {
+  try {
+    const raw = await import_node_fs26.promises.readFile(import_node_path43.default.join(root, "neat-out", "daemon.json"), "utf8");
+    const parsed = JSON.parse(raw);
+    const ports = parsed?.ports ?? {};
+    return { web: asValidPort(ports.web), rest: asValidPort(ports.rest) };
+  } catch {
+    return { web: null, rest: null };
+  }
+}
+function resolveWebPorts(args) {
+  const { daemonWeb, daemonRest, webPortEnv, apiUrlEnv, restPortArg } = args;
+  const portFromEnv = webPortEnv && webPortEnv.length > 0 ? Number.parseInt(webPortEnv, 10) : null;
+  if (portFromEnv !== null && (!Number.isFinite(portFromEnv) || portFromEnv <= 0 || portFromEnv > 65535)) {
+    throw new Error(`neatd: invalid NEAT_WEB_PORT="${webPortEnv}"`);
+  }
+  const webPort = daemonWeb ?? portFromEnv ?? DEFAULT_WEB_PORT;
+  const restPort = daemonRest ?? asValidPort(restPortArg) ?? DEFAULT_REST_PORT;
+  const apiUrl = apiUrlEnv ?? `http://localhost:${restPort}`;
+  return { webPort, apiUrl };
+}
 async function assertPortFree(port) {
   await new Promise((resolve, reject) => {
     const tester = import_node_net.default.createServer();
@@ -7158,47 +7598,103 @@ function resolveWebPackageDir() {
     eval("require")
   );
   const pkgJsonPath = req.resolve("@neat.is/web/package.json");
-  return import_node_path42.default.dirname(pkgJsonPath);
+  return import_node_path43.default.dirname(pkgJsonPath);
 }
 function resolveStandaloneServerEntry(webDir) {
-  return import_node_path42.default.join(webDir, ".next/standalone/packages/web/server.js");
+  return import_node_path43.default.join(webDir, ".next/standalone/packages/web/server.js");
+}
+async function pickInternalPort() {
+  return new Promise((resolve, reject) => {
+    const srv = import_node_net.default.createServer();
+    srv.once("error", reject);
+    srv.listen(0, "127.0.0.1", () => {
+      const addr = srv.address();
+      if (addr && typeof addr === "object") {
+        const port = addr.port;
+        srv.close(() => resolve(port));
+      } else {
+        srv.close(() => reject(new Error("neatd: could not pick an internal web port")));
+      }
+    });
+  });
 }
-async function spawnWebUI(restPort) {
-  const portRaw = process.env.NEAT_WEB_PORT;
-  const port = portRaw && portRaw.length > 0 ? Number.parseInt(portRaw, 10) : DEFAULT_WEB_PORT;
-  if (!Number.isFinite(port) || port <= 0 || port > 65535) {
-    throw new Error(`neatd: invalid NEAT_WEB_PORT="${portRaw}"`);
-  }
+async function spawnWebUI(restPort, opts = {}) {
+  const root = projectRoot();
+  const fromDaemon = await readDaemonPorts(root);
+  const { webPort: port, apiUrl } = resolveWebPorts({
+    daemonWeb: fromDaemon.web,
+    daemonRest: fromDaemon.rest,
+    webPortEnv: process.env.NEAT_WEB_PORT,
+    apiUrlEnv: process.env.NEAT_API_URL,
+    restPortArg: 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 serverEntry = opts.serverEntry ?? resolveStandaloneServerEntry(resolveWebPackageDir());
+  if (!opts.skipBuildCheck) {
+    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_process2.spawn)(process.execPath, [serverEntry], {
-    cwd: import_node_path42.default.dirname(serverEntry),
-    env,
-    stdio: ["ignore", "inherit", "inherit"],
-    detached: false
+  let child = null;
+  let internalPort = 0;
+  let starting = null;
+  let stopped = false;
+  function ensureStarted() {
+    if (starting) return starting;
+    starting = (async () => {
+      internalPort = await pickInternalPort();
+      const env = {
+        ...process.env,
+        PORT: String(internalPort),
+        HOSTNAME: "127.0.0.1",
+        NEAT_API_URL: apiUrl
+      };
+      child = (0, import_node_child_process2.spawn)(process.execPath, [serverEntry], {
+        cwd: import_node_path43.default.dirname(serverEntry),
+        env,
+        stdio: ["ignore", "inherit", "inherit"],
+        detached: false
+      });
+      child.on("error", (err) => {
+        console.error(`neatd: web UI spawn error \u2014 ${err.message}`);
+      });
+      await waitForListening(internalPort);
+      console.log(`neatd: web UI ready on http://localhost:${port}`);
+    })();
+    return starting;
+  }
+  const front = import_node_net.default.createServer((socket) => {
+    socket.on("error", () => socket.destroy());
+    ensureStarted().then(() => {
+      if (stopped) {
+        socket.destroy();
+        return;
+      }
+      const upstream = import_node_net.default.connect(internalPort, "127.0.0.1");
+      upstream.on("error", () => socket.destroy());
+      socket.pipe(upstream);
+      upstream.pipe(socket);
+      socket.on("close", () => upstream.destroy());
+      upstream.on("close", () => socket.destroy());
+    }).catch((err) => {
+      console.error(`neatd: web UI failed to start \u2014 ${err.message}`);
+      socket.destroy();
+    });
   });
-  child.on("error", (err) => {
-    console.error(`neatd: web UI spawn error \u2014 ${err.message}`);
+  await new Promise((resolve, reject) => {
+    front.once("error", reject);
+    front.listen(port, "127.0.0.1", () => resolve());
   });
-  console.log(`neatd: web UI listening on http://localhost:${port}`);
-  let stopped = false;
+  console.log(`neatd: web UI listening on http://localhost:${port} (starts on first open)`);
   async function stop() {
-    if (stopped || !child.pid) return;
+    if (stopped) return;
     stopped = true;
+    await new Promise((resolve) => front.close(() => resolve()));
+    if (!child || !child.pid) return;
     try {
       child.kill("SIGTERM");
     } catch {
@@ -7206,18 +7702,46 @@ async function spawnWebUI(restPort) {
     await new Promise((resolve) => {
       const t = setTimeout(() => {
         try {
-          child.kill("SIGKILL");
+          child?.kill("SIGKILL");
         } catch {
         }
         resolve();
       }, 3e3);
-      child.once("exit", () => {
+      child?.once("exit", () => {
         clearTimeout(t);
         resolve();
       });
     });
   }
-  return { child, port, stop };
+  return {
+    get child() {
+      return child;
+    },
+    port,
+    started: () => child !== null,
+    stop
+  };
+}
+async function waitForListening(port, timeoutMs = 15e3) {
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const ok = await new Promise((resolve) => {
+      const s = import_node_net.default.connect(port, "127.0.0.1");
+      s.once("connect", () => {
+        s.destroy();
+        resolve(true);
+      });
+      s.once("error", () => {
+        s.destroy();
+        resolve(false);
+      });
+    });
+    if (ok) return;
+    if (Date.now() > deadline) {
+      throw new Error(`neatd: web UI did not start listening on :${port} within ${timeoutMs}ms`);
+    }
+    await new Promise((r) => setTimeout(r, 150));
+  }
 }
 
 // src/version-skew.ts
@@ -7290,7 +7814,7 @@ function localVersion() {
     return process.env.NEAT_LOCAL_VERSION;
   }
   try {
-    const req2 = (0, import_node_module.createRequire)(importMetaUrl);
+    const req2 = (0, import_node_module2.createRequire)(importMetaUrl);
     const pkg = req2("../package.json");
     return typeof pkg.version === "string" ? pkg.version : "0.0.0";
   } catch {
@@ -7299,14 +7823,14 @@ function localVersion() {
 }
 function neatHome2() {
   if (process.env.NEAT_HOME && process.env.NEAT_HOME.length > 0) {
-    return import_node_path43.default.resolve(process.env.NEAT_HOME);
+    return import_node_path44.default.resolve(process.env.NEAT_HOME);
   }
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path43.default.join(home, ".neat");
+  return import_node_path44.default.join(home, ".neat");
 }
 async function readPid() {
   try {
-    const raw = await import_node_fs26.promises.readFile(import_node_path43.default.join(neatHome2(), "neatd.pid"), "utf8");
+    const raw = await import_node_fs27.promises.readFile(import_node_path44.default.join(neatHome2(), "neatd.pid"), "utf8");
     const n = Number.parseInt(raw.trim(), 10);
     return Number.isFinite(n) ? n : null;
   } catch {
@@ -7320,10 +7844,19 @@ function restPortFromEnv() {
   const raw = process.env.PORT;
   return raw && raw.length > 0 ? Number.parseInt(raw, 10) : 8080;
 }
+function webPortFromEnv() {
+  const raw = process.env.NEAT_WEB_PORT;
+  if (!raw || raw.length === 0) return void 0;
+  const n = Number.parseInt(raw, 10);
+  return Number.isFinite(n) ? n : void 0;
+}
 async function cmdStart() {
+  const project = process.env.NEAT_PROJECT;
+  const projectPath = process.env.NEAT_PROJECT_PATH;
+  const startOpts = project && project.length > 0 ? { project, projectPath, webPort: webPortFromEnv() } : {};
   let handle;
   try {
-    handle = await startDaemon();
+    handle = await startDaemon(startOpts);
   } catch (err) {
     if (err instanceof BindAuthorityError) {
       console.error(`neatd: ${err.message}`);