@neat.is/core 0.4.16 → 0.4.18

package/dist/cli.cjs

@@ -58,9 +58,9 @@ function mountBearerAuth(app, opts) {
   const suffixes = [...DEFAULT_UNAUTH_SUFFIXES, ...opts.extraUnauthenticatedSuffixes ?? []];
   const publicRead = opts.publicRead === true;
   app.addHook("preHandler", (req, reply, done) => {
-    const path50 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
+    const path53 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
     for (const suffix of suffixes) {
-      if (path50 === suffix || path50.endsWith(suffix)) {
+      if (path53 === suffix || path53.endsWith(suffix)) {
         done();
         return;
       }
@@ -188,8 +188,8 @@ function reshapeGrpcRequest(req) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path40.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  return import_node_path40.default.resolve(here, "..", "proto");
+  const here = import_node_path41.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  return import_node_path41.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -257,13 +257,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url2, import_node_path40, import_node_crypto2, grpc, protoLoader;
+var import_node_url2, import_node_path41, import_node_crypto2, grpc, protoLoader;
 var init_otel_grpc = __esm({
   "src/otel-grpc.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_url2 = require("url");
-    import_node_path40 = __toESM(require("path"), 1);
+    import_node_path41 = __toESM(require("path"), 1);
     import_node_crypto2 = require("crypto");
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
@@ -373,10 +373,10 @@ function parseOtlpRequest(body) {
   return out;
 }
 function loadProtoRoot() {
-  const here = import_node_path41.default.dirname((0, import_node_url3.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path41.default.resolve(here, "..", "proto");
+  const here = import_node_path42.default.dirname((0, import_node_url3.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path42.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path41.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path42.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -474,8 +474,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(
@@ -572,12 +574,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path41, import_node_url3, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
+var import_node_path42, import_node_url3, 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_path41 = __toESM(require("path"), 1);
+    import_node_path42 = __toESM(require("path"), 1);
     import_node_url3 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -595,6 +597,7 @@ var init_otel = __esm({
 var cli_exports = {};
 __export(cli_exports, {
   CLAUDE_SKILL_CONFIG: () => CLAUDE_SKILL_CONFIG,
+  ProjectResolutionError: () => ProjectResolutionError,
   QUERY_VERBS: () => QUERY_VERBS,
   commandPrefix: () => commandPrefix,
   isNpxInvocation: () => isNpxInvocation,
@@ -602,6 +605,7 @@ __export(cli_exports, {
   parseArgs: () => parseArgs,
   printBanner: () => printBanner,
   readPackageVersion: () => readPackageVersion,
+  resolveProjectForVerb: () => resolveProjectForVerb,
   runInit: () => runInit,
   runQueryVerb: () => runQueryVerb,
   runSkill: () => runSkill,
@@ -609,8 +613,8 @@ __export(cli_exports, {
 });
 module.exports = __toCommonJS(cli_exports);
 init_cjs_shims();
-var import_node_path49 = __toESM(require("path"), 1);
-var import_node_fs32 = require("fs");
+var import_node_path52 = __toESM(require("path"), 1);
+var import_node_fs34 = require("fs");
 
 // src/banner.ts
 init_cjs_shims();
@@ -1175,19 +1179,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, path50, edges) {
-    if (path50.length > best.path.length) {
-      best = { path: [...path50], edges: [...edges] };
+  function step(node, path53, edges) {
+    if (path53.length > best.path.length) {
+      best = { path: [...path53], edges: [...edges] };
     }
-    if (path50.length - 1 >= maxDepth) return;
+    if (path53.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);
-      path50.push(srcId);
+      path53.push(srcId);
       edges.push(edge);
-      step(srcId, path50, edges);
-      path50.pop();
+      step(srcId, path53, edges);
+      path53.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1727,6 +1731,41 @@ function thresholdForEdgeType(edgeType, overrides) {
   const map = overrides ?? loadStaleThresholdsFromEnv();
   return map[edgeType] ?? FALLBACK_STALE_THRESHOLD_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();
 }
@@ -2140,6 +2179,71 @@ function makeErrorSpanWriter(errorsPath) {
     await import_node_fs4.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();
@@ -2238,6 +2342,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);
 }
@@ -4269,7 +4381,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();
@@ -4622,15 +4734,75 @@ function grpcEndpointsFromFile(file, serviceDir) {
   return out;
 }
 
+// src/extract/calls/supabase.ts
+init_cjs_shims();
+var import_node_path28 = __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_path28.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) {
@@ -4650,6 +4822,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();
@@ -4657,7 +4830,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
@@ -4669,7 +4842,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,
@@ -4679,7 +4852,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,
@@ -4699,7 +4872,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
         };
@@ -4724,16 +4897,16 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path28 = __toESM(require("path"), 1);
-var import_types18 = require("@neat.is/types");
+var import_node_path29 = __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,
@@ -4762,7 +4935,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path28.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path29.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -4771,7 +4944,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_path28.default.join(scanPath, name);
+    const abs = import_node_path29.default.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
@@ -4784,13 +4957,13 @@ async function addComposeInfra(graph, scanPath, services) {
   } catch (err) {
     recordExtractionError(
       "infra docker-compose",
-      import_node_path28.default.relative(scanPath, composePath),
+      import_node_path29.default.relative(scanPath, composePath),
       err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path28.default.relative(scanPath, composePath).split(import_node_path28.default.sep).join("/");
+  const evidenceFile = import_node_path29.default.relative(scanPath, composePath).split(import_node_path29.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -4812,15 +4985,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);
@@ -4832,9 +5005,9 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path29 = __toESM(require("path"), 1);
+var import_node_path30 = __toESM(require("path"), 1);
 var import_node_fs16 = 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;
@@ -4853,7 +5026,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path29.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path30.default.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
     let content;
     try {
@@ -4861,7 +5034,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     } catch (err) {
       recordExtractionError(
         "infra dockerfile",
-        import_node_path29.default.relative(scanPath, dockerfilePath),
+        import_node_path30.default.relative(scanPath, dockerfilePath),
         err
       );
       continue;
@@ -4873,7 +5046,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const relDockerfile = toPosix2(import_node_path29.default.relative(service.dir, dockerfilePath));
+    const relDockerfile = toPosix2(import_node_path30.default.relative(service.dir, dockerfilePath));
     const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
       graph,
       service.pkg.name,
@@ -4882,17 +5055,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_path29.default.relative(scanPath, dockerfilePath))
+          file: toPosix2(import_node_path30.default.relative(scanPath, dockerfilePath))
         }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -4905,7 +5078,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 // src/extract/infra/terraform.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 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 [];
@@ -4914,11 +5087,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_path30.default.join(start, entry2.name);
+      const child = import_node_path31.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_path30.default.join(start, entry2.name));
+      out.push(import_node_path31.default.join(start, entry2.name));
     }
   }
   return out;
@@ -4946,7 +5119,7 @@ async function addTerraformResources(graph, scanPath) {
 // src/extract/infra/k8s.ts
 init_cjs_shims();
 var import_node_fs18 = require("fs");
-var import_node_path31 = __toESM(require("path"), 1);
+var import_node_path32 = __toESM(require("path"), 1);
 var import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -4964,11 +5137,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_path31.default.join(start, entry2.name);
+      const child = import_node_path32.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_path31.default.extname(entry2.name))) {
-      out.push(import_node_path31.default.join(start, entry2.name));
+    } else if (entry2.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path32.default.extname(entry2.name))) {
+      out.push(import_node_path32.default.join(start, entry2.name));
     }
   }
   return out;
@@ -5012,17 +5185,17 @@ async function addInfra(graph, scanPath, services) {
 }
 
 // src/extract/index.ts
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_path34 = __toESM(require("path"), 1);
 
 // src/extract/retire.ts
 init_cjs_shims();
 var import_node_fs19 = require("fs");
-var import_node_path32 = __toESM(require("path"), 1);
-var import_types20 = require("@neat.is/types");
+var import_node_path33 = __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);
     }
@@ -5035,7 +5208,7 @@ function retireEdgesByFile(graph, file) {
   const toDrop = [];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== import_types20.Provenance.EXTRACTED) return;
+    if (edge.provenance !== import_types21.Provenance.EXTRACTED) return;
     if (!edge.evidence?.file) return;
     if (edge.evidence.file === normalized) toDrop.push(id);
   });
@@ -5048,14 +5221,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_path32.default.isAbsolute(evidenceFile)) {
+    if (import_node_path33.default.isAbsolute(evidenceFile)) {
       if (!(0, import_node_fs19.existsSync)(evidenceFile)) toDrop.push(id);
       return;
     }
-    const found = bases.some((base) => (0, import_node_fs19.existsSync)(import_node_path32.default.join(base, evidenceFile)));
+    const found = bases.some((base) => (0, import_node_fs19.existsSync)(import_node_path33.default.join(base, evidenceFile)));
     if (!found) toDrop.push(id);
   });
   for (const id of toDrop) graph.dropEdge(id);
@@ -5095,7 +5268,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
-    const rejectedPath = import_node_path33.default.join(import_node_path33.default.dirname(opts.errorsPath), "rejected.ndjson");
+    const rejectedPath = import_node_path34.default.join(import_node_path34.default.dirname(opts.errorsPath), "rejected.ndjson");
     try {
       await writeRejectedExtracted(droppedEntries, rejectedPath);
     } catch (err) {
@@ -5129,7 +5302,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
 
 // src/divergences.ts
 init_cjs_shims();
-var import_types21 = require("@neat.is/types");
+var import_types22 = require("@neat.is/types");
 function bucketKey(source, target, type) {
   return `${type}|${source}|${target}`;
 }
@@ -5137,22 +5310,22 @@ function bucketEdges(graph) {
   const buckets = /* @__PURE__ */ new Map();
   graph.forEachEdge((id, attrs) => {
     const e = attrs;
-    const parsed = (0, import_types21.parseEdgeId)(id);
+    const parsed = (0, import_types22.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_types21.Provenance.EXTRACTED:
+      case import_types22.Provenance.EXTRACTED:
         cur.extracted = e;
         break;
-      case import_types21.Provenance.OBSERVED:
+      case import_types22.Provenance.OBSERVED:
         cur.observed = e;
         break;
-      case import_types21.Provenance.INFERRED:
+      case import_types22.Provenance.INFERRED:
         cur.inferred = e;
         break;
       default:
-        if (e.provenance === import_types21.Provenance.STALE) cur.stale = e;
+        if (e.provenance === import_types22.Provenance.STALE) cur.stale = e;
     }
     buckets.set(key, cur);
   });
@@ -5161,7 +5334,7 @@ function bucketEdges(graph) {
 function nodeIsFrontier(graph, nodeId) {
   if (!graph.hasNode(nodeId)) return false;
   const attrs = graph.getNodeAttributes(nodeId);
-  return attrs.type === import_types21.NodeType.FrontierNode;
+  return attrs.type === import_types22.NodeType.FrontierNode;
 }
 function clampConfidence(n) {
   if (!Number.isFinite(n)) return 0;
@@ -5182,7 +5355,7 @@ function gradedConfidence(edge) {
 }
 function detectMissingDivergences(graph, bucket) {
   const out = [];
-  if (bucket.type === import_types21.EdgeType.CONTAINS) return out;
+  if (bucket.type === import_types22.EdgeType.CONTAINS) return out;
   if (bucket.extracted && !bucket.observed) {
     if (!nodeIsFrontier(graph, bucket.target)) {
       out.push({
@@ -5223,7 +5396,7 @@ function declaredHostFor(svc) {
 function hasExtractedConfiguredBy(graph, svcId) {
   for (const edgeId of graph.outboundEdges(svcId)) {
     const e = graph.getEdgeAttributes(edgeId);
-    if (e.type === import_types21.EdgeType.CONFIGURED_BY && e.provenance === import_types21.Provenance.EXTRACTED) {
+    if (e.type === import_types22.EdgeType.CONFIGURED_BY && e.provenance === import_types22.Provenance.EXTRACTED) {
       return true;
     }
   }
@@ -5236,10 +5409,10 @@ function detectHostMismatch(graph, svcId, svc) {
   const out = [];
   for (const edgeId of graph.outboundEdges(svcId)) {
     const edge = graph.getEdgeAttributes(edgeId);
-    if (edge.type !== import_types21.EdgeType.CONNECTS_TO) continue;
-    if (edge.provenance !== import_types21.Provenance.OBSERVED) continue;
+    if (edge.type !== import_types22.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types22.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types21.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types22.NodeType.DatabaseNode) continue;
     const observedHost = target.host?.trim();
     if (!observedHost) continue;
     if (observedHost === declaredHost) continue;
@@ -5261,10 +5434,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_types21.EdgeType.CONNECTS_TO) continue;
-    if (edge.provenance !== import_types21.Provenance.OBSERVED) continue;
+    if (edge.type !== import_types22.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types22.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types21.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types22.NodeType.DatabaseNode) continue;
     for (const pair of compatPairs()) {
       if (pair.engine !== target.engine) continue;
       const declared = deps[pair.driver];
@@ -5325,7 +5498,7 @@ function computeDivergences(graph, opts = {}) {
   }
   graph.forEachNode((nodeId, attrs) => {
     const n = attrs;
-    if (n.type !== import_types21.NodeType.ServiceNode) return;
+    if (n.type !== import_types22.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);
@@ -5358,7 +5531,7 @@ function computeDivergences(graph, opts = {}) {
     if (a.source !== b.source) return a.source.localeCompare(b.source);
     return a.target.localeCompare(b.target);
   });
-  return import_types21.DivergenceResultSchema.parse({
+  return import_types22.DivergenceResultSchema.parse({
     divergences: filtered,
     totalAffected: filtered.length,
     computedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -5368,8 +5541,8 @@ function computeDivergences(graph, opts = {}) {
 // src/persist.ts
 init_cjs_shims();
 var import_node_fs20 = require("fs");
-var import_node_path34 = __toESM(require("path"), 1);
-var import_types22 = require("@neat.is/types");
+var import_node_path35 = __toESM(require("path"), 1);
+var import_types23 = require("@neat.is/types");
 var SCHEMA_VERSION = 4;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -5391,12 +5564,12 @@ function migrateV2ToV3(payload) {
     for (const edge of edges) {
       const attrs = edge.attributes;
       if (!attrs || attrs.provenance !== "FRONTIER") continue;
-      attrs.provenance = import_types22.Provenance.OBSERVED;
+      attrs.provenance = import_types23.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_types22.observedEdgeId)(source, target, type);
+        const newId = (0, import_types23.observedEdgeId)(source, target, type);
         attrs.id = newId;
         if (edge.key) edge.key = newId;
       }
@@ -5405,7 +5578,7 @@ function migrateV2ToV3(payload) {
   return { ...payload, schemaVersion: 3 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs20.promises.mkdir(import_node_path34.default.dirname(filePath), { recursive: true });
+  await import_node_fs20.promises.mkdir(import_node_path35.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -5481,7 +5654,7 @@ function startPersistLoop(graph, outPath, intervalMs = 6e4) {
 // src/gitignore.ts
 init_cjs_shims();
 var import_node_fs21 = require("fs");
-var import_node_path35 = __toESM(require("path"), 1);
+var import_node_path36 = __toESM(require("path"), 1);
 var NEAT_OUT_LINE = "neat-out/";
 var NEAT_HEADER = "# NEAT \u2014 machine-local snapshots and events";
 function isNeatOutLine(line) {
@@ -5489,7 +5662,7 @@ function isNeatOutLine(line) {
   return trimmed === "neat-out/" || trimmed === "neat-out";
 }
 async function ensureNeatOutIgnored(projectDir) {
-  const file = import_node_path35.default.join(projectDir, ".gitignore");
+  const file = import_node_path36.default.join(projectDir, ".gitignore");
   let existing = null;
   try {
     existing = await import_node_fs21.promises.readFile(file, "utf8");
@@ -5516,7 +5689,7 @@ ${NEAT_OUT_LINE}
 
 // src/summary.ts
 init_cjs_shims();
-var import_types23 = require("@neat.is/types");
+var import_types24 = require("@neat.is/types");
 function renderOtelEnvBlock() {
   return [
     "for prod OTel routing, set these in your deploy platform's env:",
@@ -5526,19 +5699,19 @@ function renderOtelEnvBlock() {
 }
 function findIncompatServices(nodes) {
   return nodes.filter(
-    (n) => n.type === import_types23.NodeType.ServiceNode && Array.isArray(n.incompatibilities) && (n.incompatibilities ?? []).length > 0
+    (n) => n.type === import_types24.NodeType.ServiceNode && Array.isArray(n.incompatibilities) && (n.incompatibilities ?? []).length > 0
   );
 }
 function servicesWithoutObserved(nodes, edges) {
   const seen = /* @__PURE__ */ new Set();
   for (const e of edges) {
-    if (e.provenance === import_types23.Provenance.OBSERVED) {
+    if (e.provenance === import_types24.Provenance.OBSERVED) {
       seen.add(e.source);
       seen.add(e.target);
     }
   }
   return nodes.filter(
-    (n) => n.type === import_types23.NodeType.ServiceNode && !seen.has(n.id)
+    (n) => n.type === import_types24.NodeType.ServiceNode && !seen.has(n.id)
   );
 }
 function formatDivergence(d) {
@@ -5613,26 +5786,26 @@ function formatIncompat(inc) {
 // src/watch.ts
 init_cjs_shims();
 var import_node_fs27 = __toESM(require("fs"), 1);
-var import_node_path43 = __toESM(require("path"), 1);
+var import_node_path44 = __toESM(require("path"), 1);
 var import_chokidar = __toESM(require("chokidar"), 1);
 
 // src/api.ts
 init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
-var import_types25 = require("@neat.is/types");
+var import_types26 = require("@neat.is/types");
 
 // src/extend/index.ts
 init_cjs_shims();
 var import_node_fs23 = require("fs");
-var import_node_path37 = __toESM(require("path"), 1);
+var import_node_path38 = __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_fs22 = require("fs");
-var import_node_path36 = __toESM(require("path"), 1);
+var import_node_path37 = __toESM(require("path"), 1);
 var import_node_child_process = require("child_process");
 var LOCKFILE_PRIORITY = [
   { lockfile: "bun.lockb", pm: "bun", args: ["install", "--no-summary"] },
@@ -5654,22 +5827,22 @@ async function exists2(p) {
   }
 }
 async function detectPackageManager(serviceDir) {
-  let dir = import_node_path36.default.resolve(serviceDir);
+  let dir = import_node_path37.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_path36.default.join(dir, candidate.lockfile);
+      const lockPath = import_node_path37.default.join(dir, candidate.lockfile);
       if (await exists2(lockPath)) {
         return { pm: candidate.pm, cwd: dir, args: [...candidate.args] };
       }
     }
-    const parent = import_node_path36.default.dirname(dir);
+    const parent = import_node_path37.default.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return { pm: "npm", cwd: import_node_path36.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
+  return { pm: "npm", cwd: import_node_path37.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
 }
 async function runPackageManagerInstall(cmd) {
   return new Promise((resolve) => {
@@ -5718,7 +5891,7 @@ async function fileExists2(p) {
   }
 }
 async function readPackageJson(scanPath) {
-  const pkgPath = import_node_path37.default.join(scanPath, "package.json");
+  const pkgPath = import_node_path38.default.join(scanPath, "package.json");
   const raw = await import_node_fs23.promises.readFile(pkgPath, "utf8");
   return JSON.parse(raw);
 }
@@ -5729,11 +5902,11 @@ async function findHookFiles(scanPath) {
   ).sort();
 }
 function extendLogPath() {
-  return process.env.NEAT_EXTEND_LOG ?? import_node_path37.default.join(import_node_os2.default.homedir(), ".neat", "extend-log.ndjson");
+  return process.env.NEAT_EXTEND_LOG ?? import_node_path38.default.join(import_node_os2.default.homedir(), ".neat", "extend-log.ndjson");
 }
 async function appendExtendLog(entry2) {
   const logPath = extendLogPath();
-  await import_node_fs23.promises.mkdir(import_node_path37.default.dirname(logPath), { recursive: true });
+  await import_node_fs23.promises.mkdir(import_node_path38.default.dirname(logPath), { recursive: true });
   await import_node_fs23.promises.appendFile(logPath, JSON.stringify(entry2) + "\n", "utf8");
 }
 function splicedContent(fileContent, snippet2) {
@@ -5792,7 +5965,7 @@ function lookupInstrumentation(library, installedVersion) {
 }
 async function describeProjectInstrumentation(ctx) {
   const hookFiles = await findHookFiles(ctx.scanPath);
-  const envNeat = await fileExists2(import_node_path37.default.join(ctx.scanPath, ".env.neat"));
+  const envNeat = await fileExists2(import_node_path38.default.join(ctx.scanPath, ".env.neat"));
   const registryInstrPackages = new Set(
     (0, import_instrumentation_registry.list)().map((e) => e.instrumentation_package).filter((p) => !!p)
   );
@@ -5814,16 +5987,16 @@ async function applyExtension(ctx, args, options) {
     );
   }
   for (const file of hookFiles) {
-    const content = await import_node_fs23.promises.readFile(import_node_path37.default.join(ctx.scanPath, file), "utf8");
+    const content = await import_node_fs23.promises.readFile(import_node_path38.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_path37.default.join(ctx.scanPath, primaryFile);
+  const primaryPath = import_node_path38.default.join(ctx.scanPath, primaryFile);
   const filesTouched = [];
   const depsAdded = [];
-  const pkgPath = import_node_path37.default.join(ctx.scanPath, "package.json");
+  const pkgPath = import_node_path38.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 };
@@ -5869,7 +6042,7 @@ async function dryRunExtension(ctx, args) {
     };
   }
   for (const file of hookFiles) {
-    const content = await import_node_fs23.promises.readFile(import_node_path37.default.join(ctx.scanPath, file), "utf8");
+    const content = await import_node_fs23.promises.readFile(import_node_path38.default.join(ctx.scanPath, file), "utf8");
     if (content.includes(args.registration_snippet)) {
       return {
         library: args.library,
@@ -5891,7 +6064,7 @@ async function dryRunExtension(ctx, args) {
     depsToAdd.push(`${args.instrumentation_package}@${args.version}`);
     filesTouched.push("package.json");
   }
-  const hookContent = await import_node_fs23.promises.readFile(import_node_path37.default.join(ctx.scanPath, primaryFile), "utf8");
+  const hookContent = await import_node_fs23.promises.readFile(import_node_path38.default.join(ctx.scanPath, primaryFile), "utf8");
   const patched = splicedContent(hookContent, args.registration_snippet);
   if (patched) {
     filesTouched.push(primaryFile);
@@ -5912,7 +6085,7 @@ async function rollbackExtension(ctx, args) {
   if (!match) {
     return { undone: false, message: "no apply found for library" };
   }
-  const pkgPath = import_node_path37.default.join(ctx.scanPath, "package.json");
+  const pkgPath = import_node_path38.default.join(ctx.scanPath, "package.json");
   if (await fileExists2(pkgPath)) {
     const pkg = await readPackageJson(ctx.scanPath);
     if (pkg.dependencies?.[match.instrumentation_package]) {
@@ -5923,7 +6096,7 @@ async function rollbackExtension(ctx, args) {
   }
   const hookFiles = await findHookFiles(ctx.scanPath);
   for (const file of hookFiles) {
-    const filePath = import_node_path37.default.join(ctx.scanPath, file);
+    const filePath = import_node_path38.default.join(ctx.scanPath, file);
     const content = await import_node_fs23.promises.readFile(filePath, "utf8");
     if (content.includes(match.registration_snippet)) {
       const filtered = content.split("\n").filter((line) => !line.includes(match.registration_snippet)).join("\n");
@@ -6016,23 +6189,23 @@ function canonicalJson(value) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path38 = __toESM(require("path"), 1);
+var import_node_path39 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path38.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path38.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path38.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path38.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path38.default.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: import_node_path39.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path39.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path39.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path39.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path39.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: import_node_path38.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path38.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path38.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path38.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path38.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: import_node_path39.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path39.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path39.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path39.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path39.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -6070,23 +6243,128 @@ var Projects = class {
 init_cjs_shims();
 var import_node_fs25 = require("fs");
 var import_node_os3 = __toESM(require("os"), 1);
-var import_node_path39 = __toESM(require("path"), 1);
-var import_types24 = require("@neat.is/types");
+var import_node_path40 = __toESM(require("path"), 1);
+var import_types25 = 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_path39.default.resolve(override);
-  return import_node_path39.default.join(import_node_os3.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path40.default.resolve(override);
+  return import_node_path40.default.join(import_node_os3.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path39.default.join(neatHome(), "projects.json");
+  return import_node_path40.default.join(neatHome(), "projects.json");
 }
 function registryLockPath() {
-  return import_node_path39.default.join(neatHome(), "projects.json.lock");
+  return import_node_path40.default.join(neatHome(), "projects.json.lock");
 }
 function daemonPidPath() {
-  return import_node_path39.default.join(neatHome(), "neatd.pid");
+  return import_node_path40.default.join(neatHome(), "neatd.pid");
+}
+function daemonsDir() {
+  return import_node_path40.default.join(neatHome(), "daemons");
+}
+function isFiniteInt(v) {
+  return typeof v === "number" && Number.isFinite(v);
+}
+function parseDaemonRecord(raw) {
+  let obj;
+  try {
+    obj = JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+  if (typeof obj !== "object" || obj === null) return void 0;
+  const r = obj;
+  const ports = r.ports;
+  if (typeof r.project !== "string" || typeof r.projectPath !== "string" || !isFiniteInt(r.pid) || r.status !== "running" && r.status !== "stopped" || typeof r.startedAt !== "string" || typeof r.neatVersion !== "string" || !ports || !isFiniteInt(ports.rest) || !isFiniteInt(ports.otlp) || !isFiniteInt(ports.web)) {
+    return void 0;
+  }
+  return {
+    project: r.project,
+    projectPath: r.projectPath,
+    pid: r.pid,
+    status: r.status,
+    ports: { rest: ports.rest, otlp: ports.otlp, web: ports.web },
+    startedAt: r.startedAt,
+    neatVersion: r.neatVersion
+  };
+}
+var defaultDiscoveryProbe = { isPidAlive: isPidAliveDefault };
+async function discoverDaemons(probe = defaultDiscoveryProbe) {
+  const dir = daemonsDir();
+  let names;
+  try {
+    names = await import_node_fs25.promises.readdir(dir);
+  } catch (err) {
+    if (err.code === "ENOENT") return [];
+    throw err;
+  }
+  const out = [];
+  for (const name of names) {
+    if (!name.endsWith(".json")) continue;
+    const file = import_node_path40.default.join(dir, name);
+    let raw;
+    try {
+      raw = await import_node_fs25.promises.readFile(file, "utf8");
+    } catch {
+      continue;
+    }
+    const record = parseDaemonRecord(raw);
+    if (!record) continue;
+    const live = record.status === "running" && probe.isPidAlive(record.pid);
+    out.push({ record, live, source: file });
+  }
+  out.sort((a, b) => a.record.project.localeCompare(b.record.project));
+  return out;
+}
+async function removeDaemonRecord(source) {
+  await import_node_fs25.promises.unlink(source).catch(() => {
+  });
+}
+async function listMachineProjects(probe = defaultDiscoveryProbe) {
+  const discovered = await discoverDaemons(probe);
+  const byPath = /* @__PURE__ */ new Map();
+  for (const d of discovered) {
+    const key = await normalizeProjectPath(d.record.projectPath);
+    byPath.set(key, {
+      project: d.record.project,
+      projectPath: d.record.projectPath,
+      state: d.live ? "running" : "stopped",
+      ports: d.record.ports,
+      pid: d.record.pid
+    });
+  }
+  let legacy = [];
+  try {
+    legacy = (await readRegistry()).projects;
+  } catch {
+    legacy = [];
+  }
+  for (const entry2 of legacy) {
+    const key = await normalizeProjectPath(entry2.path);
+    if (byPath.has(key)) continue;
+    byPath.set(key, {
+      project: entry2.name,
+      projectPath: entry2.path,
+      state: "registered",
+      registryStatus: entry2.status
+    });
+  }
+  return [...byPath.values()].sort((a, b) => a.project.localeCompare(b.project));
+}
+async function findDaemonByProject(name, probe = defaultDiscoveryProbe) {
+  const discovered = await discoverDaemons(probe);
+  return discovered.find((d) => d.record.project === name);
+}
+function signalDaemonStop(pid) {
+  try {
+    process.kill(pid, "SIGTERM");
+    return true;
+  } catch (err) {
+    if (err.code === "ESRCH") return false;
+    throw err;
+  }
 }
 function isPidAliveDefault(pid) {
   try {
@@ -6146,7 +6424,7 @@ function lockHolderMessage(holder, lockPath, timeoutMs) {
   }
 }
 async function normalizeProjectPath(input) {
-  const resolved = import_node_path39.default.resolve(input);
+  const resolved = import_node_path40.default.resolve(input);
   try {
     return await import_node_fs25.promises.realpath(resolved);
   } catch {
@@ -6154,7 +6432,7 @@ async function normalizeProjectPath(input) {
   }
 }
 async function writeAtomically(target, contents) {
-  await import_node_fs25.promises.mkdir(import_node_path39.default.dirname(target), { recursive: true });
+  await import_node_fs25.promises.mkdir(import_node_path40.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_fs25.promises.open(tmp, "w");
   try {
@@ -6167,7 +6445,7 @@ async function writeAtomically(target, contents) {
 }
 async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS, probe = defaultLockHolderProbe) {
   const deadline = Date.now() + timeoutMs;
-  await import_node_fs25.promises.mkdir(import_node_path39.default.dirname(lockPath), { recursive: true });
+  await import_node_fs25.promises.mkdir(import_node_path40.default.dirname(lockPath), { recursive: true });
   let probedHolder = false;
   while (true) {
     try {
@@ -6220,10 +6498,10 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types24.RegistryFileSchema.parse(parsed);
+  return import_types25.RegistryFileSchema.parse(parsed);
 }
 async function writeRegistry(reg) {
-  const validated = import_types24.RegistryFileSchema.parse(reg);
+  const validated = import_types25.RegistryFileSchema.parse(reg);
   await writeAtomically(registryPath(), JSON.stringify(validated, null, 2) + "\n");
 }
 var ProjectNameCollisionError = class extends Error {
@@ -6294,6 +6572,58 @@ async function removeProject(name) {
     return removed;
   });
 }
+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_fs25.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();
@@ -6307,6 +6637,7 @@ function handleSse(req, 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 = () => {
@@ -6486,11 +6817,11 @@ function registerRoutes(scope, ctx) {
       const candidates = req.query.type.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
       const parsed = [];
       for (const c of candidates) {
-        const r = import_types25.DivergenceTypeSchema.safeParse(c);
+        const r = import_types26.DivergenceTypeSchema.safeParse(c);
         if (!r.success) {
           return reply.code(400).send({
             error: `unknown divergence type "${c}"`,
-            allowed: import_types25.DivergenceTypeSchema.options
+            allowed: import_types26.DivergenceTypeSchema.options
           });
         }
         parsed.push(r.data);
@@ -6703,7 +7034,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req.query.severity) {
-      const sev = import_types25.PolicySeveritySchema.safeParse(req.query.severity);
+      const sev = import_types26.PolicySeveritySchema.safeParse(req.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -6720,7 +7051,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req, reply) => {
     const proj = resolveProject(registry, req, reply, ctx.bootstrap);
     if (!proj) return;
-    const parsed = import_types25.PoliciesCheckBodySchema.safeParse(req.body ?? {});
+    const parsed = import_types26.PoliciesCheckBodySchema.safeParse(req.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -6964,7 +7295,7 @@ init_otel_grpc();
 // src/search.ts
 init_cjs_shims();
 var import_node_fs26 = require("fs");
-var import_node_path42 = __toESM(require("path"), 1);
+var import_node_path43 = __toESM(require("path"), 1);
 var import_node_crypto3 = require("crypto");
 var DEFAULT_LIMIT = 10;
 var NOMIC_DIM = 768;
@@ -7103,7 +7434,7 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, cache) {
-  await import_node_fs26.promises.mkdir(import_node_path42.default.dirname(cachePath), { recursive: true });
+  await import_node_fs26.promises.mkdir(import_node_path43.default.dirname(cachePath), { recursive: true });
   await import_node_fs26.promises.writeFile(cachePath, JSON.stringify(cache));
 }
 var VectorIndex = class {
@@ -7260,8 +7591,8 @@ var ALL_PHASES = [
 ];
 function classifyChange(relPath) {
   const phases = /* @__PURE__ */ new Set();
-  const base = import_node_path43.default.basename(relPath).toLowerCase();
-  const segments = relPath.split(import_node_path43.default.sep).map((s) => s.toLowerCase());
+  const base = import_node_path44.default.basename(relPath).toLowerCase();
+  const segments = relPath.split(import_node_path44.default.sep).map((s) => s.toLowerCase());
   if (base === "package.json" || base === "requirements.txt" || base === "pyproject.toml" || base === "setup.py") {
     phases.add("services");
     phases.add("aliases");
@@ -7382,9 +7713,9 @@ function countWatchableDirs(scanPath, limit) {
     for (const e of entries) {
       if (count >= limit) return;
       if (!e.isDirectory()) continue;
-      if (IGNORED_WATCH_PATHS.some((re) => re.test(import_node_path43.default.join(dir, e.name) + import_node_path43.default.sep))) continue;
+      if (IGNORED_WATCH_PATHS.some((re) => re.test(import_node_path44.default.join(dir, e.name) + import_node_path44.default.sep))) continue;
       count++;
-      if (depth < 2) visit(import_node_path43.default.join(dir, e.name), depth + 1);
+      if (depth < 2) visit(import_node_path44.default.join(dir, e.name), depth + 1);
     }
   };
   visit(scanPath, 0);
@@ -7402,8 +7733,8 @@ async function startWatch(graph, opts) {
   const projectName = opts.project ?? DEFAULT_PROJECT;
   await loadGraphFromDisk(graph, opts.outPath);
   const detachEventBus = attachGraphToEventBus(graph, { project: projectName });
-  const policyFilePath = import_node_path43.default.join(opts.scanPath, "policy.json");
-  const policyViolationsPath = import_node_path43.default.join(import_node_path43.default.dirname(opts.outPath), "policy-violations.ndjson");
+  const policyFilePath = import_node_path44.default.join(opts.scanPath, "policy.json");
+  const policyViolationsPath = import_node_path44.default.join(import_node_path44.default.dirname(opts.outPath), "policy-violations.ndjson");
   let policies = [];
   try {
     policies = await loadPolicyFile(policyFilePath);
@@ -7454,7 +7785,7 @@ async function startWatch(graph, opts) {
   assertBindAuthority(host, auth.authToken);
   const port = opts.port ?? 8080;
   const otelPort = opts.otelPort ?? 4318;
-  const cachePath = opts.embeddingsCachePath ?? import_node_path43.default.join(import_node_path43.default.dirname(opts.outPath), "embeddings.json");
+  const cachePath = opts.embeddingsCachePath ?? import_node_path44.default.join(import_node_path44.default.dirname(opts.outPath), "embeddings.json");
   let searchIndex;
   try {
     searchIndex = await buildSearchIndex(graph, { cachePath });
@@ -7472,7 +7803,7 @@ async function startWatch(graph, opts) {
       // Paths are derived from the explicit options the watch caller passes
       // — pathsForProject is only used to fill in the embeddings/snapshot
       // fields so the registry shape is complete.
-      ...pathsForProject(projectName, import_node_path43.default.dirname(opts.outPath)),
+      ...pathsForProject(projectName, import_node_path44.default.dirname(opts.outPath)),
       snapshotPath: opts.outPath,
       errorsPath: opts.errorsPath,
       staleEventsPath: opts.staleEventsPath
@@ -7559,9 +7890,9 @@ async function startWatch(graph, opts) {
   };
   const onPath = (absPath) => {
     if (shouldIgnore(absPath)) return;
-    const rel = import_node_path43.default.relative(opts.scanPath, absPath);
+    const rel = import_node_path44.default.relative(opts.scanPath, absPath);
     if (!rel || rel.startsWith("..")) return;
-    pendingPaths.add(rel.split(import_node_path43.default.sep).join("/"));
+    pendingPaths.add(rel.split(import_node_path44.default.sep).join("/"));
     const phases = classifyChange(rel);
     if (phases.size === 0) {
       for (const p of ALL_PHASES) pending.add(p);
@@ -7616,7 +7947,7 @@ async function startWatch(graph, opts) {
 // src/deploy/detect.ts
 init_cjs_shims();
 var import_node_fs28 = require("fs");
-var import_node_path44 = __toESM(require("path"), 1);
+var import_node_path45 = __toESM(require("path"), 1);
 var import_node_child_process2 = require("child_process");
 var import_node_crypto4 = require("crypto");
 function generateToken() {
@@ -7716,7 +8047,7 @@ async function runDeploy(opts = {}) {
   const token = generateToken();
   switch (substrate) {
     case "docker-compose": {
-      const artifactPath = import_node_path44.default.join(cwd, "docker-compose.neat.yml");
+      const artifactPath = import_node_path45.default.join(cwd, "docker-compose.neat.yml");
       const contents = emitDockerCompose(cwd);
       await import_node_fs28.promises.writeFile(artifactPath, contents, "utf8");
       return {
@@ -7724,11 +8055,11 @@ async function runDeploy(opts = {}) {
         artifactPath,
         token,
         contents,
-        startCommand: `NEAT_AUTH_TOKEN=${token} docker compose -f ${import_node_path44.default.basename(artifactPath)} up -d`
+        startCommand: `NEAT_AUTH_TOKEN=${token} docker compose -f ${import_node_path45.default.basename(artifactPath)} up -d`
       };
     }
     case "systemd": {
-      const artifactPath = import_node_path44.default.join(cwd, "neat.service");
+      const artifactPath = import_node_path45.default.join(cwd, "neat.service");
       const contents = emitSystemdUnit(cwd);
       await import_node_fs28.promises.writeFile(artifactPath, contents, "utf8");
       return {
@@ -7764,15 +8095,56 @@ init_cjs_shims();
 // src/installers/javascript.ts
 init_cjs_shims();
 var import_node_fs29 = require("fs");
-var import_node_path45 = __toESM(require("path"), 1);
+var import_node_path46 = __toESM(require("path"), 1);
 var import_semver2 = __toESM(require("semver"), 1);
 
 // src/installers/templates.ts
 init_cjs_shims();
 var OTEL_INIT_HEADER = "// Generated by `neat init --apply` (ADR-069). OpenTelemetry auto-instrumentation hook.";
-var OTEL_INIT_STAMP = "// neat-template-version: 5 \u2014 layered file-first capture (ADR-090) + http/json protocol pin (#468).";
+var OTEL_INIT_STAMP = "// neat-template-version: 6 \u2014 daemon.json endpoint resolution (ADR-096) + layered file-first capture (ADR-090).";
 var OTEL_OTLP_HEADERS_JS = "if (process.env.NEAT_OTEL_TOKEN) process.env.OTEL_EXPORTER_OTLP_HEADERS ||= 'Authorization=Bearer ' + process.env.NEAT_OTEL_TOKEN";
 var OTEL_OTLP_PROTOCOL_JS = "process.env.OTEL_EXPORTER_OTLP_PROTOCOL ||= 'http/json'";
+var OTEL_ENDPOINT_RESOLVER_CJS = `;(function () {
+  try {
+    if (process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_ENDPOINT) return
+    const __neatFs = require('node:fs')
+    const __neatPath = require('node:path')
+    let __neatDir = process.cwd()
+    for (let __i = 0; __i < 8; __i++) {
+      try {
+        const __rec = JSON.parse(__neatFs.readFileSync(__neatPath.join(__neatDir, 'neat-out', 'daemon.json'), 'utf8'))
+        if (__rec && __rec.ports && typeof __rec.ports.otlp === 'number') {
+          process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = 'http://localhost:' + __rec.ports.otlp + '/v1/traces'
+          break
+        }
+      } catch (_e) {}
+      const __parent = __neatPath.dirname(__neatDir)
+      if (__parent === __neatDir) break
+      __neatDir = __parent
+    }
+  } catch (_e) {}
+  process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/v1/traces'
+})()`;
+var OTEL_ESM_NODE_IMPORTS = "import { readFileSync as __neatReadFileSync } from 'node:fs'\nimport { join as __neatJoin, dirname as __neatDirname } from 'node:path'";
+var OTEL_ENDPOINT_RESOLVER_ESM = `;(function () {
+  try {
+    if (process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_ENDPOINT) return
+    let __neatDir = process.cwd()
+    for (let __i = 0; __i < 8; __i++) {
+      try {
+        const __rec = JSON.parse(__neatReadFileSync(__neatJoin(__neatDir, 'neat-out', 'daemon.json'), 'utf8'))
+        if (__rec && __rec.ports && typeof __rec.ports.otlp === 'number') {
+          process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = 'http://localhost:' + __rec.ports.otlp + '/v1/traces'
+          break
+        }
+      } catch (_e) {}
+      const __parent = __neatDirname(__neatDir)
+      if (__parent === __neatDir) break
+      __neatDir = __parent
+    }
+  } catch (_e) {}
+  process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/v1/traces'
+})()`;
 function neatCaptureSource(ts) {
   const spanT = ts ? ": any" : "";
   const strOpt = ts ? ": string | undefined" : "";
@@ -8061,7 +8433,7 @@ try {
 var OTEL_INIT_CJS = `${OTEL_INIT_HEADER}
 ${OTEL_INIT_STAMP}
 process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
-process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+${OTEL_ENDPOINT_RESOLVER_CJS}
 ${OTEL_OTLP_PROTOCOL_JS}
 ${OTEL_OTLP_HEADERS_JS}
 
@@ -8079,8 +8451,9 @@ ${neatWireCaptureSource(false)}
 `;
 var OTEL_INIT_ESM = `${OTEL_INIT_HEADER}
 ${OTEL_INIT_STAMP}
+${OTEL_ESM_NODE_IMPORTS}
 process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
-process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+${OTEL_ENDPOINT_RESOLVER_ESM}
 ${OTEL_OTLP_PROTOCOL_JS}
 ${OTEL_OTLP_HEADERS_JS}
 
@@ -8103,8 +8476,9 @@ ${OTEL_INIT_STAMP}
 // strict user tsconfig would reject; suppressing type-checking here keeps the
 // generated file from breaking the host project's \`tsc\` gate (#427) without
 // constraining the runtime logic. The file is regenerated, never hand-edited.
+${OTEL_ESM_NODE_IMPORTS}
 process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
-process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+${OTEL_ENDPOINT_RESOLVER_ESM}
 ${OTEL_OTLP_PROTOCOL_JS}
 ${OTEL_OTLP_HEADERS_JS}
 
@@ -8126,11 +8500,14 @@ ${registrations.join("\n")}
 `;
   return template.replace(/__SERVICE_NAME__/g, serviceName).replace(/__PROJECT__/g, projectName).replace(/__INSTRUMENTATION_BLOCK__\n?/g, block);
 }
-function renderEnvNeat(serviceName, projectName) {
+function renderEnvNeat(serviceName, _projectName) {
   return [
     "# Generated by `neat init --apply` (ADR-069).",
     `OTEL_SERVICE_NAME=${serviceName}`,
-    `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:4318/projects/${projectName}/v1/traces`,
+    "# Advisory only \u2014 the generated otel-init resolves the live endpoint from",
+    "# <project>/neat-out/daemon.json (ports.otlp) at boot (ADR-096). This is the",
+    "# canonical default the daemon takes when its first-choice OTLP port is free.",
+    "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:4318/v1/traces",
     "OTEL_EXPORTER_OTLP_PROTOCOL=http/json",
     "# Set NEAT_OTEL_TOKEN to the daemon's OTLP secret to authenticate exported spans (#410).",
     "# NEAT_OTEL_TOKEN=",
@@ -8153,8 +8530,9 @@ export async function register() {
 }
 `;
 var NEXT_INSTRUMENTATION_NODE_TS = `${NEXT_INSTRUMENTATION_HEADER}
+${OTEL_ESM_NODE_IMPORTS}
 process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
-process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+${OTEL_ENDPOINT_RESOLVER_ESM}
 ${OTEL_OTLP_PROTOCOL_JS}
 ${OTEL_OTLP_HEADERS_JS}
 
@@ -8167,7 +8545,7 @@ new NodeSDK({ instrumentations }).start()
 `;
 var NEXT_INSTRUMENTATION_NODE_JS = `${NEXT_INSTRUMENTATION_HEADER}
 process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
-process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+${OTEL_ENDPOINT_RESOLVER_CJS}
 ${OTEL_OTLP_PROTOCOL_JS}
 ${OTEL_OTLP_HEADERS_JS}
 
@@ -8186,8 +8564,9 @@ ${registrations.join("\n")}
 }
 var FRAMEWORK_OTEL_INIT_HEADER = "// Generated by `neat init --apply` (ADR-074). OpenTelemetry SDK hook.";
 var FRAMEWORK_OTEL_INIT_TS_BODY = `${FRAMEWORK_OTEL_INIT_HEADER}
+${OTEL_ESM_NODE_IMPORTS}
 process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
-process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+${OTEL_ENDPOINT_RESOLVER_ESM}
 ${OTEL_OTLP_PROTOCOL_JS}
 ${OTEL_OTLP_HEADERS_JS}
 
@@ -8202,7 +8581,7 @@ sdk.start()
 `;
 var FRAMEWORK_OTEL_INIT_JS_BODY = `${FRAMEWORK_OTEL_INIT_HEADER}
 process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
-process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+${OTEL_ENDPOINT_RESOLVER_CJS}
 ${OTEL_OTLP_PROTOCOL_JS}
 ${OTEL_OTLP_HEADERS_JS}
 
@@ -8311,11 +8690,11 @@ var OTEL_ENV = {
   value: "http://localhost:4318/projects/<project>/v1/traces"
 };
 function serviceNodeName(pkg, serviceDir) {
-  return pkg.name ?? import_node_path45.default.basename(serviceDir);
+  return pkg.name ?? import_node_path46.default.basename(serviceDir);
 }
 function projectToken(pkg, serviceDir, project) {
   if (project && project.length > 0) return project;
-  return pkg.name ?? import_node_path45.default.basename(serviceDir);
+  return pkg.name ?? import_node_path46.default.basename(serviceDir);
 }
 async function readJsonFile(p) {
   try {
@@ -8328,16 +8707,16 @@ async function readJsonFile(p) {
 async function detectRuntimeKind(pkgRoot, pkg) {
   const deps = allDeps(pkg);
   if ("react-native" in deps || "expo" in deps) return "react-native";
-  const appJson = await readJsonFile(import_node_path45.default.join(pkgRoot, "app.json"));
+  const appJson = await readJsonFile(import_node_path46.default.join(pkgRoot, "app.json"));
   if (appJson && typeof appJson === "object" && "expo" in appJson) {
     return "react-native";
   }
-  if (await exists3(import_node_path45.default.join(pkgRoot, "vite.config.js")) || await exists3(import_node_path45.default.join(pkgRoot, "vite.config.ts")) || await exists3(import_node_path45.default.join(pkgRoot, "vite.config.mjs")) || "vite" in deps) {
+  if (await exists3(import_node_path46.default.join(pkgRoot, "vite.config.js")) || await exists3(import_node_path46.default.join(pkgRoot, "vite.config.ts")) || await exists3(import_node_path46.default.join(pkgRoot, "vite.config.mjs")) || "vite" in deps) {
     return "browser-bundle";
   }
-  if (await exists3(import_node_path45.default.join(pkgRoot, "wrangler.toml"))) return "cloudflare-workers";
-  if (await exists3(import_node_path45.default.join(pkgRoot, "bun.lockb"))) return "bun";
-  if (await exists3(import_node_path45.default.join(pkgRoot, "deno.json")) || await exists3(import_node_path45.default.join(pkgRoot, "deno.lock"))) {
+  if (await exists3(import_node_path46.default.join(pkgRoot, "wrangler.toml"))) return "cloudflare-workers";
+  if (await exists3(import_node_path46.default.join(pkgRoot, "bun.lockb"))) return "bun";
+  if (await exists3(import_node_path46.default.join(pkgRoot, "deno.json")) || await exists3(import_node_path46.default.join(pkgRoot, "deno.lock"))) {
     return "deno";
   }
   const engines = pkg.engines ?? {};
@@ -8346,7 +8725,7 @@ async function detectRuntimeKind(pkgRoot, pkg) {
 }
 async function readPackageJson2(serviceDir) {
   try {
-    const raw = await import_node_fs29.promises.readFile(import_node_path45.default.join(serviceDir, "package.json"), "utf8");
+    const raw = await import_node_fs29.promises.readFile(import_node_path46.default.join(serviceDir, "package.json"), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -8390,7 +8769,7 @@ function needsVersionUpgrade(installed, expected) {
 var NEXT_CONFIG_CANDIDATES = ["next.config.js", "next.config.ts", "next.config.mjs"];
 async function findNextConfig(serviceDir) {
   for (const name of NEXT_CONFIG_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, name);
+    const candidate = import_node_path46.default.join(serviceDir, name);
     if (await exists3(candidate)) return candidate;
   }
   return null;
@@ -8417,7 +8796,7 @@ function hasRemixDependency(pkg) {
 }
 async function findRemixEntry(serviceDir) {
   for (const rel of REMIX_ENTRY_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, rel);
+    const candidate = import_node_path46.default.join(serviceDir, rel);
     if (await exists3(candidate)) return candidate;
   }
   return null;
@@ -8429,14 +8808,14 @@ function hasSvelteKitDependency(pkg) {
 }
 async function findSvelteKitHooks(serviceDir) {
   for (const rel of SVELTEKIT_HOOKS_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, rel);
+    const candidate = import_node_path46.default.join(serviceDir, rel);
     if (await exists3(candidate)) return candidate;
   }
   return null;
 }
 async function findSvelteKitConfig(serviceDir) {
   for (const rel of SVELTEKIT_CONFIG_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, rel);
+    const candidate = import_node_path46.default.join(serviceDir, rel);
     if (await exists3(candidate)) return candidate;
   }
   return null;
@@ -8447,7 +8826,7 @@ function hasNuxtDependency(pkg) {
 }
 async function findNuxtConfig(serviceDir) {
   for (const name of NUXT_CONFIG_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, name);
+    const candidate = import_node_path46.default.join(serviceDir, name);
     if (await exists3(candidate)) return candidate;
   }
   return null;
@@ -8458,7 +8837,7 @@ function hasAstroDependency(pkg) {
 }
 async function findAstroConfig(serviceDir) {
   for (const name of ASTRO_CONFIG_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, name);
+    const candidate = import_node_path46.default.join(serviceDir, name);
     if (await exists3(candidate)) return candidate;
   }
   return null;
@@ -8472,7 +8851,7 @@ function parseNextMajor(range) {
   return Number.isFinite(n) ? n : null;
 }
 async function isTypeScriptProject(serviceDir) {
-  return exists3(import_node_path45.default.join(serviceDir, "tsconfig.json"));
+  return exists3(import_node_path46.default.join(serviceDir, "tsconfig.json"));
 }
 var INDEX_EXTENSIONS = [".ts", ".tsx", ".js", ".mjs", ".cjs"];
 var INDEX_CANDIDATES = INDEX_EXTENSIONS.map((ext) => `index${ext}`);
@@ -8518,7 +8897,7 @@ function entryFromScript(script) {
 }
 async function resolveEntry(serviceDir, pkg) {
   if (typeof pkg.main === "string" && pkg.main.length > 0) {
-    const candidate = import_node_path45.default.resolve(serviceDir, pkg.main);
+    const candidate = import_node_path46.default.resolve(serviceDir, pkg.main);
     if (await exists3(candidate)) return candidate;
   }
   if (pkg.bin) {
@@ -8532,36 +8911,36 @@ async function resolveEntry(serviceDir, pkg) {
       if (typeof first === "string") binEntry = first;
     }
     if (binEntry) {
-      const candidate = import_node_path45.default.resolve(serviceDir, binEntry);
+      const candidate = import_node_path46.default.resolve(serviceDir, binEntry);
       if (await exists3(candidate)) return candidate;
     }
   }
   const startEntry = entryFromScript(pkg.scripts?.start);
   if (startEntry) {
-    const candidate = import_node_path45.default.resolve(serviceDir, startEntry);
+    const candidate = import_node_path46.default.resolve(serviceDir, startEntry);
     if (await exists3(candidate)) return candidate;
   }
   const devEntry = entryFromScript(pkg.scripts?.dev);
   if (devEntry) {
-    const candidate = import_node_path45.default.resolve(serviceDir, devEntry);
+    const candidate = import_node_path46.default.resolve(serviceDir, devEntry);
     if (await exists3(candidate)) return candidate;
   }
   for (const rel of SRC_INDEX_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, rel);
+    const candidate = import_node_path46.default.join(serviceDir, rel);
     if (await exists3(candidate)) return candidate;
   }
   for (const rel of SRC_NAMED_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, rel);
+    const candidate = import_node_path46.default.join(serviceDir, rel);
     if (await exists3(candidate)) return candidate;
   }
   for (const name of INDEX_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, name);
+    const candidate = import_node_path46.default.join(serviceDir, name);
     if (await exists3(candidate)) return candidate;
   }
   return null;
 }
 function dispatchEntry(entryFile, pkg) {
-  const ext = import_node_path45.default.extname(entryFile).toLowerCase();
+  const ext = import_node_path46.default.extname(entryFile).toLowerCase();
   if (ext === ".ts" || ext === ".tsx") return "ts";
   if (ext === ".mjs") return "esm";
   if (ext === ".cjs") return "cjs";
@@ -8578,9 +8957,9 @@ function otelInitContents(flavor) {
   return OTEL_INIT_CJS;
 }
 function injectionLine(flavor, entryFile, otelInitFile) {
-  let rel = import_node_path45.default.relative(import_node_path45.default.dirname(entryFile), otelInitFile);
+  let rel = import_node_path46.default.relative(import_node_path46.default.dirname(entryFile), otelInitFile);
   if (!rel.startsWith(".")) rel = `./${rel}`;
-  rel = rel.split(import_node_path45.default.sep).join("/");
+  rel = rel.split(import_node_path46.default.sep).join("/");
   if (flavor === "cjs") return `require('${rel}')`;
   if (flavor === "esm") return `import '${rel}'`;
   const tsRel = rel.replace(/\.ts$/, "");
@@ -8593,23 +8972,23 @@ function lineIsOtelInjection(line) {
 }
 async function detectsSrcLayout(serviceDir) {
   const [hasSrcApp, hasSrcPages, hasRootApp, hasRootPages] = await Promise.all([
-    exists3(import_node_path45.default.join(serviceDir, "src", "app")),
-    exists3(import_node_path45.default.join(serviceDir, "src", "pages")),
-    exists3(import_node_path45.default.join(serviceDir, "app")),
-    exists3(import_node_path45.default.join(serviceDir, "pages"))
+    exists3(import_node_path46.default.join(serviceDir, "src", "app")),
+    exists3(import_node_path46.default.join(serviceDir, "src", "pages")),
+    exists3(import_node_path46.default.join(serviceDir, "app")),
+    exists3(import_node_path46.default.join(serviceDir, "pages"))
   ]);
   return (hasSrcApp || hasSrcPages) && !hasRootApp && !hasRootPages;
 }
 async function planNext(serviceDir, pkg, manifestPath, nextConfigPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
   const srcLayout = await detectsSrcLayout(serviceDir);
-  const baseDir = srcLayout ? import_node_path45.default.join(serviceDir, "src") : serviceDir;
-  const instrumentationFile = import_node_path45.default.join(baseDir, useTs ? "instrumentation.ts" : "instrumentation.js");
-  const instrumentationNodeFile = import_node_path45.default.join(
+  const baseDir = srcLayout ? import_node_path46.default.join(serviceDir, "src") : serviceDir;
+  const instrumentationFile = import_node_path46.default.join(baseDir, useTs ? "instrumentation.ts" : "instrumentation.js");
+  const instrumentationNodeFile = import_node_path46.default.join(
     baseDir,
     useTs ? "instrumentation.node.ts" : "instrumentation.node.js"
   );
-  const envNeatFile = import_node_path45.default.join(baseDir, ".env.neat");
+  const envNeatFile = import_node_path46.default.join(baseDir, ".env.neat");
   const existingDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
   const dependencyEdits = [];
   for (const sdk of SDK_PACKAGES) {
@@ -8714,7 +9093,7 @@ function buildDependencyEdits(pkg, manifestPath) {
   return edits;
 }
 async function queueEnvNeat(serviceDir, pkg, project, generatedFiles) {
-  const envNeatFile = import_node_path45.default.join(serviceDir, ".env.neat");
+  const envNeatFile = import_node_path46.default.join(serviceDir, ".env.neat");
   if (!await exists3(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
@@ -8749,7 +9128,7 @@ function fileImportsOtelHook(raw, specifiers) {
 }
 async function planRemix(serviceDir, pkg, manifestPath, entryFile, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelServerFile = import_node_path45.default.join(
+  const otelServerFile = import_node_path46.default.join(
     serviceDir,
     useTs ? "app/otel.server.ts" : "app/otel.server.js"
   );
@@ -8806,11 +9185,11 @@ async function planRemix(serviceDir, pkg, manifestPath, entryFile, project) {
 }
 async function planSvelteKit(serviceDir, pkg, manifestPath, hooksFile, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelInitFile = import_node_path45.default.join(
+  const otelInitFile = import_node_path46.default.join(
     serviceDir,
     useTs ? "src/otel-init.ts" : "src/otel-init.js"
   );
-  const resolvedHooksFile = hooksFile ?? import_node_path45.default.join(serviceDir, useTs ? "src/hooks.server.ts" : "src/hooks.server.js");
+  const resolvedHooksFile = hooksFile ?? import_node_path46.default.join(serviceDir, useTs ? "src/hooks.server.ts" : "src/hooks.server.js");
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
   const entrypointEdits = [];
@@ -8872,11 +9251,11 @@ async function planSvelteKit(serviceDir, pkg, manifestPath, hooksFile, project)
 }
 async function planNuxt(serviceDir, pkg, manifestPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelPluginFile = import_node_path45.default.join(
+  const otelPluginFile = import_node_path46.default.join(
     serviceDir,
     useTs ? "server/plugins/otel.ts" : "server/plugins/otel.js"
   );
-  const otelInitFile = import_node_path45.default.join(
+  const otelInitFile = import_node_path46.default.join(
     serviceDir,
     useTs ? "server/plugins/otel-init.ts" : "server/plugins/otel-init.js"
   );
@@ -8927,19 +9306,19 @@ async function planNuxt(serviceDir, pkg, manifestPath, project) {
 var ASTRO_MIDDLEWARE_CANDIDATES = ["src/middleware.ts", "src/middleware.js"];
 async function findAstroMiddleware(serviceDir) {
   for (const rel of ASTRO_MIDDLEWARE_CANDIDATES) {
-    const candidate = import_node_path45.default.join(serviceDir, rel);
+    const candidate = import_node_path46.default.join(serviceDir, rel);
     if (await exists3(candidate)) return candidate;
   }
   return null;
 }
 async function planAstro(serviceDir, pkg, manifestPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelInitFile = import_node_path45.default.join(
+  const otelInitFile = import_node_path46.default.join(
     serviceDir,
     useTs ? "src/otel-init.ts" : "src/otel-init.js"
   );
   const existingMiddleware = await findAstroMiddleware(serviceDir);
-  const middlewareFile = existingMiddleware ?? import_node_path45.default.join(serviceDir, useTs ? "src/middleware.ts" : "src/middleware.js");
+  const middlewareFile = existingMiddleware ?? import_node_path46.default.join(serviceDir, useTs ? "src/middleware.ts" : "src/middleware.js");
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
   const entrypointEdits = [];
@@ -9035,7 +9414,7 @@ async function findFrameworkDispatch(serviceDir, pkg, manifestPath, project) {
 }
 async function plan(serviceDir, opts) {
   const pkg = await readPackageJson2(serviceDir);
-  const manifestPath = import_node_path45.default.join(serviceDir, "package.json");
+  const manifestPath = import_node_path46.default.join(serviceDir, "package.json");
   const project = opts?.project;
   const empty = {
     language: "javascript",
@@ -9070,8 +9449,8 @@ async function plan(serviceDir, opts) {
     return { ...empty, libOnly: true };
   }
   const flavor = dispatchEntry(entryFile, pkg);
-  const otelInitFile = import_node_path45.default.join(import_node_path45.default.dirname(entryFile), otelInitFilename(flavor));
-  const envNeatFile = import_node_path45.default.join(serviceDir, ".env.neat");
+  const otelInitFile = import_node_path46.default.join(import_node_path46.default.dirname(entryFile), otelInitFilename(flavor));
+  const envNeatFile = import_node_path46.default.join(serviceDir, ".env.neat");
   const existingDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
   const dependencyEdits = [];
   for (const sdk of SDK_PACKAGES) {
@@ -9140,13 +9519,13 @@ async function plan(serviceDir, opts) {
   };
 }
 function isAllowedWritePath(serviceDir, target) {
-  const rel = import_node_path45.default.relative(serviceDir, target);
+  const rel = import_node_path46.default.relative(serviceDir, target);
   if (rel.startsWith("..")) return false;
-  const base = import_node_path45.default.basename(target);
+  const base = import_node_path46.default.basename(target);
   if (base === "package.json") return true;
   if (base === ".env.neat") return true;
   if (/^otel-init\.(?:js|cjs|mjs|ts)$/.test(base)) return true;
-  const relPosix = rel.split(import_node_path45.default.sep).join("/");
+  const relPosix = rel.split(import_node_path46.default.sep).join("/");
   if (/^instrumentation(?:\.node)?\.(?:js|cjs|mjs|ts)$/.test(base)) {
     if (relPosix === base) return true;
     if (relPosix === `src/${base}`) return true;
@@ -9163,7 +9542,7 @@ function isAllowedWritePath(serviceDir, target) {
   return false;
 }
 async function writeAtomic(file, contents) {
-  await import_node_fs29.promises.mkdir(import_node_path45.default.dirname(file), { recursive: true });
+  await import_node_fs29.promises.mkdir(import_node_path46.default.dirname(file), { recursive: true });
   const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
   await import_node_fs29.promises.writeFile(tmp, contents, "utf8");
   await import_node_fs29.promises.rename(tmp, file);
@@ -9347,7 +9726,7 @@ async function rollback(installPlan, originals, createdFiles) {
     ...removed.map((f) => `removed:  ${f}`),
     ""
   ];
-  const rollbackPath = import_node_path45.default.join(installPlan.serviceDir, "neat-rollback.patch");
+  const rollbackPath = import_node_path46.default.join(installPlan.serviceDir, "neat-rollback.patch");
   await import_node_fs29.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 function injectInstrumentationHook(raw) {
@@ -9378,7 +9757,7 @@ var javascriptInstaller = {
 // src/installers/python.ts
 init_cjs_shims();
 var import_node_fs30 = require("fs");
-var import_node_path46 = __toESM(require("path"), 1);
+var import_node_path47 = __toESM(require("path"), 1);
 var SDK_PACKAGES2 = [
   { name: "opentelemetry-distro", version: ">=0.49b0" },
   { name: "opentelemetry-exporter-otlp", version: ">=1.28.0" }
@@ -9399,7 +9778,7 @@ async function exists4(p) {
 async function detect2(serviceDir) {
   const markers = ["requirements.txt", "pyproject.toml", "setup.py"];
   for (const m of markers) {
-    if (await exists4(import_node_path46.default.join(serviceDir, m))) return true;
+    if (await exists4(import_node_path47.default.join(serviceDir, m))) return true;
   }
   return false;
 }
@@ -9409,7 +9788,7 @@ function reqPackageName(line) {
   return head.replace(/[<>=!~].*$/, "").toLowerCase();
 }
 async function planRequirementsTxtEdits(serviceDir) {
-  const file = import_node_path46.default.join(serviceDir, "requirements.txt");
+  const file = import_node_path47.default.join(serviceDir, "requirements.txt");
   if (!await exists4(file)) return null;
   const raw = await import_node_fs30.promises.readFile(file, "utf8");
   const presentNames = new Set(
@@ -9419,7 +9798,7 @@ async function planRequirementsTxtEdits(serviceDir) {
   return { manifest: file, missing: [...missing] };
 }
 async function planProcfileEdits(serviceDir) {
-  const procfile = import_node_path46.default.join(serviceDir, "Procfile");
+  const procfile = import_node_path47.default.join(serviceDir, "Procfile");
   if (!await exists4(procfile)) return [];
   const raw = await import_node_fs30.promises.readFile(procfile, "utf8");
   const edits = [];
@@ -9508,7 +9887,7 @@ async function apply2(installPlan) {
       if (raw === void 0) {
         throw new Error(`python installer: cannot read ${file} during apply`);
       }
-      const base = import_node_path46.default.basename(file);
+      const base = import_node_path47.default.basename(file);
       if (base === "requirements.txt") {
         const edits = installPlan.dependencyEdits.filter((e) => e.file === file);
         if (edits.length > 0) {
@@ -9547,7 +9926,7 @@ async function rollback2(installPlan, originals) {
     ...restored.map((f) => `restored: ${f}`),
     ""
   ];
-  const rollbackPath = import_node_path46.default.join(installPlan.serviceDir, "neat-rollback.patch");
+  const rollbackPath = import_node_path47.default.join(installPlan.serviceDir, "neat-rollback.patch");
   await import_node_fs30.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 var pythonInstaller = {
@@ -9671,19 +10050,51 @@ function renderPatch(sections) {
 
 // src/orchestrator.ts
 init_cjs_shims();
-var import_node_fs31 = require("fs");
+var import_node_fs33 = require("fs");
 var import_node_http = __toESM(require("http"), 1);
 var import_node_net = __toESM(require("net"), 1);
-var import_node_path47 = __toESM(require("path"), 1);
+var import_node_path50 = __toESM(require("path"), 1);
 var import_node_child_process3 = require("child_process");
 var import_node_readline = __toESM(require("readline"), 1);
+
+// src/daemon.ts
+init_cjs_shims();
+var import_node_fs32 = require("fs");
+var import_node_path49 = __toESM(require("path"), 1);
+var import_node_module = require("module");
+init_otel();
+init_auth();
+
+// src/unrouted.ts
+init_cjs_shims();
+var import_node_fs31 = require("fs");
+var import_node_path48 = __toESM(require("path"), 1);
+
+// src/daemon.ts
+function daemonJsonPath(scanPath) {
+  return import_node_path49.default.join(scanPath, "neat-out", "daemon.json");
+}
+async function readDaemonRecord(scanPath) {
+  try {
+    const raw = await import_node_fs32.promises.readFile(daemonJsonPath(scanPath), "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.project === "string" && parsed.ports && typeof parsed.ports.rest === "number" && typeof parsed.ports.otlp === "number" && typeof parsed.ports.web === "number") {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/orchestrator.ts
 async function extractAndPersist(opts) {
   const services = await discoverServices(opts.scanPath);
   const languages = [...new Set(services.map((s) => s.node.language))].sort();
   const graphKey = opts.projectExplicit ? opts.project : DEFAULT_PROJECT;
   resetGraph(graphKey);
   const graph = getGraph(graphKey);
-  const projectPaths = pathsForProject(graphKey, import_node_path47.default.join(opts.scanPath, "neat-out"));
+  const projectPaths = pathsForProject(graphKey, import_node_path50.default.join(opts.scanPath, "neat-out"));
   const extraction = await extractFromDirectory(graph, opts.scanPath, {
     errorsPath: projectPaths.errorsPath
   });
@@ -9737,7 +10148,7 @@ async function applyInstallersOver(services, project, options = {}) {
       console.log(`skipping ${svc.dir}: browser bundle; browser-OTel support lands in a future release.`);
     } else if (outcome.outcome === "react-native") {
       reactNative++;
-      const svcName = import_node_path47.default.basename(svc.dir);
+      const svcName = import_node_path50.default.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as React Native / Expo
   The installer doesn't cover this runtime deterministically.
@@ -9748,7 +10159,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "bun") {
       bun++;
-      const svcName = import_node_path47.default.basename(svc.dir);
+      const svcName = import_node_path50.default.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Bun
   The installer doesn't cover this runtime deterministically.
@@ -9759,7 +10170,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "deno") {
       deno++;
-      const svcName = import_node_path47.default.basename(svc.dir);
+      const svcName = import_node_path50.default.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Deno
   The installer doesn't cover this runtime deterministically.
@@ -9770,7 +10181,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "cloudflare-workers") {
       cloudflareWorkers++;
-      const svcName = import_node_path47.default.basename(svc.dir);
+      const svcName = import_node_path50.default.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Cloudflare Workers
   The installer doesn't cover this runtime deterministically.
@@ -9781,7 +10192,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "electron") {
       electron++;
-      const svcName = import_node_path47.default.basename(svc.dir);
+      const svcName = import_node_path50.default.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Electron
   The installer doesn't cover this runtime deterministically.
@@ -9862,10 +10273,6 @@ async function fetchDaemonHealth(restPort) {
     });
   });
 }
-async function checkDaemonHealth(restPort) {
-  const body = await fetchDaemonHealth(restPort);
-  return body !== null;
-}
 async function probeProjectHealth(restPort, name) {
   return new Promise((resolve) => {
     const req = import_node_http.default.get(
@@ -9941,12 +10348,6 @@ async function isPortFree(port) {
     server.listen(port, "127.0.0.1");
   });
 }
-async function probePortsFree() {
-  for (const port of NEAT_PORTS) {
-    if (!await isPortFree(port)) return { free: false, held: port };
-  }
-  return { free: true };
-}
 function formatPortCollisionMessage(port) {
   return [
     `neat: port ${port} is in use; the NEAT daemon needs it.`,
@@ -9954,11 +10355,82 @@ function formatPortCollisionMessage(port) {
     `      \`lsof -i :${port}\` to find the holding process.`
   ];
 }
-function spawnDaemonDetached() {
-  const here = import_node_path47.default.dirname(new URL(importMetaUrl).pathname);
+var PORT_ALLOCATION_ATTEMPTS = 8;
+var PORT_STRIDE = 1;
+async function tripleFree(ports) {
+  for (const p of [ports.rest, ports.otlp, ports.web]) {
+    if (!await isPortFree(p)) return false;
+  }
+  return true;
+}
+async function allocatePorts() {
+  const [baseRest, baseOtlp, baseWeb] = NEAT_PORTS;
+  for (let i = 0; i < PORT_ALLOCATION_ATTEMPTS; i++) {
+    const candidate = {
+      rest: baseRest + i * PORT_STRIDE,
+      otlp: baseOtlp + i * PORT_STRIDE,
+      web: baseWeb + i * PORT_STRIDE
+    };
+    if (await tripleFree(candidate)) return candidate;
+  }
+  return null;
+}
+async function persistedPortsFor(scanPath) {
+  const record = await readDaemonRecord(scanPath);
+  if (!record) return null;
+  return { rest: record.ports.rest, otlp: record.ports.otlp, web: record.ports.web };
+}
+async function acquireSpawnLock(scanPath) {
+  const lockPath = import_node_path50.default.join(scanPath, "neat-out", "daemon.spawn.lock");
+  await import_node_fs33.promises.mkdir(import_node_path50.default.dirname(lockPath), { recursive: true });
+  const STALE_LOCK_MS = 6e4;
+  try {
+    const fd = await import_node_fs33.promises.open(lockPath, "wx");
+    await fd.writeFile(`${process.pid}
+`, "utf8");
+    await fd.close();
+    return async () => {
+      await import_node_fs33.promises.unlink(lockPath).catch(() => {
+      });
+    };
+  } catch (err) {
+    if (err.code !== "EEXIST") return null;
+    try {
+      const stat = await import_node_fs33.promises.stat(lockPath);
+      if (Date.now() - stat.mtimeMs > STALE_LOCK_MS) {
+        await import_node_fs33.promises.unlink(lockPath).catch(() => {
+        });
+        return acquireSpawnLock(scanPath);
+      }
+    } catch {
+      return acquireSpawnLock(scanPath);
+    }
+    return null;
+  }
+}
+async function waitForPeerDaemon(restPort, project, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await healthIsForProject(restPort, project)) return true;
+    await new Promise((r) => setTimeout(r, PROBE_INTERVAL_MS));
+  }
+  return healthIsForProject(restPort, project);
+}
+async function healthIsForProject(restPort, project) {
+  const body = await fetchDaemonHealth(restPort);
+  if (body === null) return false;
+  const named = body.project;
+  if (typeof named === "string") return named === project;
+  if (Array.isArray(body.projects)) {
+    return body.projects.some((p) => p.name === project);
+  }
+  return false;
+}
+function spawnDaemonDetached(spec) {
+  const here = import_node_path50.default.dirname(new URL(importMetaUrl).pathname);
   const candidates = [
-    import_node_path47.default.join(here, "neatd.cjs"),
-    import_node_path47.default.join(here, "neatd.js")
+    import_node_path50.default.join(here, "neatd.cjs"),
+    import_node_path50.default.join(here, "neatd.js")
   ];
   let entry2 = null;
   const fsSync = require("fs");
@@ -9978,6 +10450,13 @@ function spawnDaemonDetached() {
   if (!hasToken && (!env.HOST || env.HOST.length === 0)) {
     env.HOST = "127.0.0.1";
   }
+  if (spec) {
+    env.NEAT_PROJECT = spec.project;
+    env.NEAT_PROJECT_PATH = spec.projectPath;
+    env.PORT = String(spec.ports.rest);
+    env.OTEL_PORT = String(spec.ports.otlp);
+    env.NEAT_WEB_PORT = String(spec.ports.web);
+  }
   const child = (0, import_node_child_process3.spawn)(process.execPath, [entry2, "start"], {
     detached: true,
     // stderr inherits the orchestrator's fd so the daemon's
@@ -10016,7 +10495,7 @@ async function runOrchestrator(opts) {
       browser: "skipped"
     }
   };
-  const stat = await import_node_fs31.promises.stat(opts.scanPath).catch(() => null);
+  const stat = await import_node_fs33.promises.stat(opts.scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) {
     console.error(`neat: ${opts.scanPath} is not a directory`);
     result.exitCode = 2;
@@ -10097,48 +10576,75 @@ async function runOrchestrator(opts) {
       result.exitCode = 1;
     }
   }
-  const restPort = Number(process.env.PORT ?? 8080);
   const timeoutMs = opts.daemonReadyTimeoutMs ?? DEFAULT_DAEMON_READY_TIMEOUT_MS;
-  if (await checkDaemonHealth(restPort)) {
+  const persistedPorts = await persistedPortsFor(opts.scanPath);
+  let allocated = null;
+  if (persistedPorts && await healthIsForProject(persistedPorts.rest, currentProjectName)) {
     result.steps.daemon = "already-running";
+    allocated = persistedPorts;
   } else {
-    const probe = await probePortsFree();
-    if (!probe.free) {
-      for (const line of formatPortCollisionMessage(probe.held)) {
+    if (persistedPorts && await isPortFree(persistedPorts.rest) && await tripleFree(persistedPorts)) {
+      allocated = persistedPorts;
+    } else {
+      allocated = await allocatePorts();
+    }
+    if (!allocated) {
+      for (const line of formatPortCollisionMessage(NEAT_PORTS[0])) {
         console.error(line);
       }
       result.exitCode = 3;
       return result;
     }
-    try {
-      spawnDaemonDetached();
-    } catch (err) {
-      console.error(`neat: daemon spawn failed \u2014 ${err.message}`);
-      result.exitCode = 1;
-      return result;
-    }
-    const ready = await waitForDaemonReady(restPort, timeoutMs);
-    result.steps.daemon = ready.ready ? "spawned" : "timed-out";
-    if (!ready.ready) {
-      console.error(`neat: daemon did not become ready within ${timeoutMs}ms`);
-      if (ready.stillBootstrapping.length > 0) {
-        console.error(
-          `neat: still bootstrapping: ${ready.stillBootstrapping.join(", ")}`
-        );
+    const release = await acquireSpawnLock(opts.scanPath);
+    if (!release) {
+      const reused = await waitForPeerDaemon(allocated.rest, currentProjectName, timeoutMs);
+      if (reused) {
+        result.steps.daemon = "already-running";
+      } else {
+        console.error("neat: another `neat` is spawning this project but its daemon did not come up in time");
+        result.exitCode = 1;
+        return result;
       }
-      if (ready.brokenProjects.length > 0) {
-        console.error(`neat: broken projects: ${ready.brokenProjects.join(", ")}`);
+    } else {
+      try {
+        if (await healthIsForProject(allocated.rest, currentProjectName)) {
+          result.steps.daemon = "already-running";
+        } else {
+          spawnDaemonDetached({
+            project: currentProjectName,
+            projectPath: opts.scanPath,
+            ports: allocated
+          });
+          const ready = await waitForDaemonReady(allocated.rest, timeoutMs);
+          result.steps.daemon = ready.ready ? "spawned" : "timed-out";
+          if (!ready.ready) {
+            console.error(`neat: daemon did not become ready within ${timeoutMs}ms`);
+            if (ready.stillBootstrapping.length > 0) {
+              console.error(`neat: still bootstrapping: ${ready.stillBootstrapping.join(", ")}`);
+            }
+            if (ready.brokenProjects.length > 0) {
+              console.error(`neat: broken projects: ${ready.brokenProjects.join(", ")}`);
+            }
+            result.exitCode = 1;
+            return result;
+          }
+          if (ready.brokenProjects.length > 0) {
+            console.warn(
+              `neat: ${ready.brokenProjects.length} project(s) reported broken: ${ready.brokenProjects.join(", ")}`
+            );
+          }
+        }
+      } catch (err) {
+        console.error(`neat: daemon spawn failed \u2014 ${err.message}`);
+        result.exitCode = 1;
+        return result;
+      } finally {
+        await release();
       }
-      result.exitCode = 1;
-      return result;
-    }
-    if (ready.brokenProjects.length > 0) {
-      console.warn(
-        `neat: ${ready.brokenProjects.length} project(s) reported broken: ${ready.brokenProjects.join(", ")}`
-      );
     }
   }
-  const dashboardUrl = opts.dashboardUrl ?? "http://localhost:6328";
+  const webPort = allocated?.web ?? NEAT_PORTS[2];
+  const dashboardUrl = opts.dashboardUrl ?? `http://localhost:${webPort}`;
   if (opts.noOpen || !process.stdout.isTTY) {
     result.steps.browser = "skipped";
   } else {
@@ -10173,11 +10679,11 @@ function printSummary(result, graph, dashboardUrl) {
 
 // src/cli-verbs.ts
 init_cjs_shims();
-var import_node_path48 = __toESM(require("path"), 1);
+var import_node_path51 = __toESM(require("path"), 1);
 
 // src/cli-client.ts
 init_cjs_shims();
-var import_types26 = require("@neat.is/types");
+var import_types27 = require("@neat.is/types");
 var HttpError = class extends Error {
   constructor(status2, message, responseBody = "") {
     super(message);
@@ -10202,10 +10708,10 @@ function createHttpClient(baseUrl, bearerToken) {
   const root = baseUrl.replace(/\/$/, "");
   const authHeader = bearerToken && bearerToken.length > 0 ? { authorization: `Bearer ${bearerToken}` } : {};
   return {
-    async get(path50) {
+    async get(path53) {
       let res;
       try {
-        res = await fetch(`${root}${path50}`, {
+        res = await fetch(`${root}${path53}`, {
           headers: { ...authHeader }
         });
       } catch (err) {
@@ -10217,16 +10723,16 @@ function createHttpClient(baseUrl, bearerToken) {
         const body = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on GET ${path50}: ${body}`,
+          `${res.status} ${res.statusText} on GET ${path53}: ${body}`,
           body
         );
       }
       return await res.json();
     },
-    async post(path50, body) {
+    async post(path53, body) {
       let res;
       try {
-        res = await fetch(`${root}${path50}`, {
+        res = await fetch(`${root}${path53}`, {
           method: "POST",
           headers: { "content-type": "application/json", ...authHeader },
           body: JSON.stringify(body)
@@ -10240,7 +10746,7 @@ function createHttpClient(baseUrl, bearerToken) {
         const text = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on POST ${path50}: ${text}`,
+          `${res.status} ${res.statusText} on POST ${path53}: ${text}`,
           text
         );
       }
@@ -10254,12 +10760,12 @@ function projectPath(project, suffix) {
 }
 async function runRootCause(client, input) {
   const qs = input.errorId ? `?errorId=${encodeURIComponent(input.errorId)}` : "";
-  const path50 = projectPath(
+  const path53 = projectPath(
     input.project,
     `/graph/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
   );
   try {
-    const result = await client.get(path50);
+    const result = await client.get(path53);
     const arrowPath = result.traversalPath.join(" \u2190 ");
     const provenances = result.edgeProvenances.length ? result.edgeProvenances.join(", ") : "(direct, no edges traversed)";
     const summary = `Root cause for ${input.errorNode} is ${result.rootCauseNode}. ` + result.rootCauseReason + (result.fixRecommendation ? ` Recommended fix: ${result.fixRecommendation}.` : "");
@@ -10285,12 +10791,12 @@ async function runRootCause(client, input) {
 }
 async function runBlastRadius(client, input) {
   const qs = input.depth !== void 0 ? `?depth=${input.depth}` : "";
-  const path50 = projectPath(
+  const path53 = projectPath(
     input.project,
     `/graph/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
   );
   try {
-    const result = await client.get(path50);
+    const result = await client.get(path53);
     if (result.totalAffected === 0) {
       return {
         summary: `${result.origin} has no downstream dependencies. Nothing else would break if it failed.`
@@ -10319,17 +10825,17 @@ async function runBlastRadius(client, input) {
   }
 }
 function formatBlastEntry(n) {
-  const tag = n.edgeProvenance === import_types26.Provenance.STALE ? " [STALE \u2014 last seen too long ago]" : "";
+  const tag = n.edgeProvenance === import_types27.Provenance.STALE ? " [STALE \u2014 last seen too long ago]" : "";
   return `  \u2022 ${n.nodeId} (distance ${n.distance}, ${n.edgeProvenance})${tag}`;
 }
 async function runDependencies(client, input) {
   const depth = input.depth ?? 3;
-  const path50 = projectPath(
+  const path53 = projectPath(
     input.project,
     `/graph/dependencies/${encodeURIComponent(input.nodeId)}?depth=${depth}`
   );
   try {
-    const result = await client.get(path50);
+    const result = await client.get(path53);
     if (result.total === 0) {
       return {
         summary: depth === 1 ? `${input.nodeId} has no direct dependencies in the graph.` : `${input.nodeId} has no dependencies (BFS to depth ${depth}).`
@@ -10365,9 +10871,9 @@ async function runObservedDependencies(client, input) {
     const edges = await client.get(
       projectPath(input.project, `/graph/edges/${encodeURIComponent(input.nodeId)}`)
     );
-    const observed = edges.outbound.filter((e) => e.provenance === import_types26.Provenance.OBSERVED);
+    const observed = edges.outbound.filter((e) => e.provenance === import_types27.Provenance.OBSERVED);
     if (observed.length === 0) {
-      const hasExtracted = edges.outbound.some((e) => e.provenance === import_types26.Provenance.EXTRACTED);
+      const hasExtracted = edges.outbound.some((e) => e.provenance === import_types27.Provenance.EXTRACTED);
       const note = hasExtracted ? " Static (EXTRACTED) dependencies exist but no runtime traffic has been seen \u2014 is OTel running?" : "";
       return { summary: `No OBSERVED dependencies for ${input.nodeId}.${note}` };
     }
@@ -10375,7 +10881,7 @@ async function runObservedDependencies(client, input) {
     return {
       summary: `${input.nodeId} has ${observed.length} runtime dependenc${observed.length === 1 ? "y" : "ies"} confirmed by OTel.`,
       block: blockLines.join("\n"),
-      provenance: import_types26.Provenance.OBSERVED
+      provenance: import_types27.Provenance.OBSERVED
     };
   } catch (err) {
     if (err instanceof HttpError && err.status === 404) {
@@ -10410,9 +10916,9 @@ function formatDuration(ms) {
   return `${Math.round(h / 24)}d`;
 }
 async function runIncidents(client, input) {
-  const path50 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
+  const path53 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
   try {
-    const body = await client.get(path50);
+    const body = await client.get(path53);
     const events = body.events;
     if (events.length === 0) {
       return {
@@ -10429,7 +10935,7 @@ async function runIncidents(client, input) {
     return {
       summary: `${target} has ${body.total} recorded incident${body.total === 1 ? "" : "s"}; showing the ${ordered.length} most recent.`,
       block: blockLines.join("\n"),
-      provenance: import_types26.Provenance.OBSERVED
+      provenance: import_types27.Provenance.OBSERVED
     };
   } catch (err) {
     if (err instanceof HttpError && err.status === 404) {
@@ -10538,7 +11044,7 @@ async function runStaleEdges(client, input) {
   return {
     summary: `${events.length} stale-edge transition${events.length === 1 ? "" : "s"} recorded${input.edgeType ? ` for ${input.edgeType}` : ""}.`,
     block: blockLines.join("\n"),
-    provenance: import_types26.Provenance.STALE
+    provenance: import_types27.Provenance.STALE
   };
 }
 async function runPolicies(client, input) {
@@ -10702,13 +11208,13 @@ async function resolveProjectEntry(opts) {
   const cwd = opts.cwd ?? process.cwd();
   const resolvedCwd = await normalizeProjectPath(cwd);
   for (const entry2 of entries) {
-    if (resolvedCwd === entry2.path || resolvedCwd.startsWith(`${entry2.path}${import_node_path48.default.sep}`)) {
+    if (resolvedCwd === entry2.path || resolvedCwd.startsWith(`${entry2.path}${import_node_path51.default.sep}`)) {
       return entry2;
     }
   }
   return null;
 }
-async function checkDaemonHealth2(baseUrl) {
+async function checkDaemonHealth(baseUrl) {
   try {
     const res = await fetch(`${baseUrl.replace(/\/$/, "")}/health`, {
       signal: AbortSignal.timeout(1500)
@@ -10809,7 +11315,7 @@ async function runSync(opts) {
       }
     } else {
       const daemonUrl = opts.daemonUrl ?? process.env.NEAT_API_URL ?? "http://localhost:8080";
-      const healthy = await checkDaemonHealth2(daemonUrl);
+      const healthy = await checkDaemonHealth(daemonUrl);
       if (healthy) {
         try {
           await pushSnapshotToRemote({
@@ -10852,7 +11358,7 @@ async function runSync(opts) {
 }
 
 // src/cli.ts
-var import_types27 = require("@neat.is/types");
+var import_types28 = require("@neat.is/types");
 function isNpxInvocation() {
   if (process.env.npm_command === "exec") return true;
   const execpath = process.env.npm_execpath ?? "";
@@ -10883,12 +11389,18 @@ function usage() {
   console.log("  watch <path>   Start neat-core, watch <path>, re-extract on changes.");
   console.log("                 PORT (default 8080), OTEL_PORT (4318), HOST (0.0.0.0)");
   console.log("                 control listeners. NEAT_OTLP_GRPC=true also opens 4317.");
-  console.log("  list           List every project registered in the machine-level registry.");
-  console.log("  pause <name>   Mark a project paused \u2014 daemon stops watching until resumed.");
-  console.log("  resume <name>  Mark a project active again.");
+  console.log("  list           Report the daemons running on this machine (alias: ps).");
+  console.log("                 Reads ~/.neat/daemons/ and folds in any registered");
+  console.log("                 project no daemon has self-described yet.");
+  console.log("  ps             Alias of list.");
+  console.log("  pause <name>   Stop a project's daemon until it is started again.");
+  console.log("  resume <name>  Bring a paused project back; for a stopped daemon, re-run");
+  console.log("                 `neat <path>` to start it.");
   console.log("  uninstall <name>");
-  console.log("                 Remove a project from the registry. Does not touch");
+  console.log("                 Stop a project's daemon and retire it. Does not touch");
   console.log("                 neat-out/, policy.json, or any user file.");
+  console.log("  prune          Drop registry entries whose path is gone from disk.");
+  console.log("                 Flags: --json   emit the removed list as JSON");
   console.log("  version        Print the installed @neat.is/core version and exit.");
   console.log("                 Aliases: --version, -v.");
   console.log("  skill          Install or print the Claude Code MCP drop-in.");
@@ -10948,6 +11460,7 @@ function usage() {
   console.log("");
   console.log("environment:");
   console.log("  NEAT_API_URL    base URL for the core REST API (default http://localhost:8080)");
+  console.log("                  alias: NEAT_CORE_URL (the name the MCP server reads)");
   console.log("  NEAT_PROJECT    project name when --project isn't passed");
 }
 var STRING_FLAGS = [
@@ -11081,6 +11594,14 @@ function printVersion() {
   process.stdout.write(`${readPackageVersion()}
 `);
 }
+function formatMachineProjectRow(r) {
+  if (r.ports) {
+    const where = r.pid !== void 0 ? `	pid=${r.pid}` : "";
+    return `${r.project}	${r.state}	rest=${r.ports.rest} otlp=${r.ports.otlp} web=${r.ports.web}	${r.projectPath}${where}`;
+  }
+  const status2 = r.registryStatus ? `	(${r.registryStatus})` : "";
+  return `${r.project}	${r.state}${status2}	${r.projectPath}`;
+}
 function printDiscoveryReport(opts, services) {
   const languages = [...new Set(services.map((s) => s.node.language))].sort();
   const mode = opts.dryRun ? "dry-run" : opts.apply ? "apply" : "patch-only";
@@ -11119,7 +11640,7 @@ async function buildPatchSections(services, project) {
 }
 async function runInit(opts) {
   const written = [];
-  const stat = await import_node_fs32.promises.stat(opts.scanPath).catch(() => null);
+  const stat = await import_node_fs34.promises.stat(opts.scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) {
     console.error(`neat init: ${opts.scanPath} is not a directory`);
     return { exitCode: 2, writtenFiles: written };
@@ -11128,13 +11649,13 @@ async function runInit(opts) {
   printDiscoveryReport(opts, services);
   const sections = opts.noInstall ? [] : await buildPatchSections(services, opts.project);
   const patch = renderPatch(sections);
-  const patchPath = import_node_path49.default.join(opts.scanPath, "neat.patch");
+  const patchPath = import_node_path52.default.join(opts.scanPath, "neat.patch");
   if (opts.dryRun) {
-    await import_node_fs32.promises.writeFile(patchPath, patch, "utf8");
+    await import_node_fs34.promises.writeFile(patchPath, patch, "utf8");
     written.push(patchPath);
     console.log(`dry-run: patch written to ${patchPath}`);
-    const gitignorePath = import_node_path49.default.join(opts.scanPath, ".gitignore");
-    const gitignoreExists = await import_node_fs32.promises.stat(gitignorePath).then(() => true).catch(() => false);
+    const gitignorePath = import_node_path52.default.join(opts.scanPath, ".gitignore");
+    const gitignoreExists = await import_node_fs34.promises.stat(gitignorePath).then(() => true).catch(() => false);
     const verb = gitignoreExists ? "append" : "create";
     console.log(`dry-run: would ${verb} ${gitignorePath} (add neat-out/)`);
     console.log("rerun without --dry-run to register and snapshot.");
@@ -11145,9 +11666,9 @@ async function runInit(opts) {
   const graph = getGraph(graphKey);
   const projectPaths = pathsForProject(
     graphKey,
-    import_node_path49.default.join(opts.scanPath, "neat-out")
+    import_node_path52.default.join(opts.scanPath, "neat-out")
   );
-  const errorsPath = import_node_path49.default.join(import_node_path49.default.dirname(opts.outPath), import_node_path49.default.basename(projectPaths.errorsPath));
+  const errorsPath = import_node_path52.default.join(import_node_path52.default.dirname(opts.outPath), import_node_path52.default.basename(projectPaths.errorsPath));
   const result = await extractFromDirectory(graph, opts.scanPath, { errorsPath });
   await saveGraphToDisk(graph, opts.outPath);
   written.push(opts.outPath);
@@ -11226,7 +11747,7 @@ async function runInit(opts) {
         console.log("Run `npm install` (or your language equivalent) to refresh lockfiles.");
       }
     } else {
-      await import_node_fs32.promises.writeFile(patchPath, patch, "utf8");
+      await import_node_fs34.promises.writeFile(patchPath, patch, "utf8");
       written.push(patchPath);
     }
   }
@@ -11259,16 +11780,16 @@ var CLAUDE_SKILL_CONFIG = {
       command: "npx",
       args: ["-y", "@neat.is/mcp"],
       env: {
-        NEAT_API_URL: "http://localhost:8080"
+        NEAT_CORE_URL: "http://localhost:8080"
       }
     }
   }
 };
 function claudeConfigPath() {
   const override = process.env.NEAT_CLAUDE_CONFIG;
-  if (override && override.length > 0) return import_node_path49.default.resolve(override);
+  if (override && override.length > 0) return import_node_path52.default.resolve(override);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path49.default.join(home, ".claude.json");
+  return import_node_path52.default.join(home, ".claude.json");
 }
 async function runSkill(opts) {
   const snippet2 = JSON.stringify(CLAUDE_SKILL_CONFIG, null, 2) + "\n";
@@ -11280,7 +11801,7 @@ async function runSkill(opts) {
     const target = claudeConfigPath();
     let existing = {};
     try {
-      existing = JSON.parse(await import_node_fs32.promises.readFile(target, "utf8"));
+      existing = JSON.parse(await import_node_fs34.promises.readFile(target, "utf8"));
     } catch (err) {
       if (err.code !== "ENOENT") {
         console.error(`neat skill: failed to read ${target} \u2014 ${err.message}`);
@@ -11292,8 +11813,8 @@ async function runSkill(opts) {
       ...existing,
       mcpServers: { ...mcp, neat: CLAUDE_SKILL_CONFIG.mcpServers.neat }
     };
-    await import_node_fs32.promises.mkdir(import_node_path49.default.dirname(target), { recursive: true });
-    await import_node_fs32.promises.writeFile(target, JSON.stringify(merged, null, 2) + "\n", "utf8");
+    await import_node_fs34.promises.mkdir(import_node_path52.default.dirname(target), { recursive: true });
+    await import_node_fs34.promises.writeFile(target, JSON.stringify(merged, null, 2) + "\n", "utf8");
     console.log(`neat skill: wrote mcpServers.neat to ${target}`);
     console.log("restart Claude Code to pick up the new MCP server.");
     return { exitCode: 0 };
@@ -11305,6 +11826,9 @@ async function runSkill(opts) {
   console.log("");
   console.log("Manual install: copy mcpServers.neat from --print-config into ~/.claude.json,");
   console.log("then restart Claude Code. See packages/claude-skill/SKILL.md for the tool list.");
+  console.log("");
+  console.log("The MCP server reads NEAT_CORE_URL for the daemon URL \u2014 point it at a");
+  console.log("non-default daemon by editing that value in the generated config.");
   return { exitCode: 0 };
 }
 async function main() {
@@ -11339,12 +11863,12 @@ async function main() {
       console.error("neat init: --apply and --dry-run are mutually exclusive");
       process.exit(2);
     }
-    const scanPath = import_node_path49.default.resolve(target);
+    const scanPath = import_node_path52.default.resolve(target);
     const projectExplicit = parsed.project !== null;
-    const projectName = projectExplicit ? project : import_node_path49.default.basename(scanPath);
+    const projectName = projectExplicit ? project : import_node_path52.default.basename(scanPath);
     const projectKey = projectExplicit ? project : DEFAULT_PROJECT;
-    const fallback = pathsForProject(projectKey, import_node_path49.default.join(scanPath, "neat-out")).snapshotPath;
-    const outPath = import_node_path49.default.resolve(process.env.NEAT_OUT_PATH ?? fallback);
+    const fallback = pathsForProject(projectKey, import_node_path52.default.join(scanPath, "neat-out")).snapshotPath;
+    const outPath = import_node_path52.default.resolve(process.env.NEAT_OUT_PATH ?? fallback);
     const result = await runInit({
       scanPath,
       outPath,
@@ -11365,21 +11889,21 @@ async function main() {
       usage();
       process.exit(2);
     }
-    const scanPath = import_node_path49.default.resolve(target);
-    const stat = await import_node_fs32.promises.stat(scanPath).catch(() => null);
+    const scanPath = import_node_path52.default.resolve(target);
+    const stat = await import_node_fs34.promises.stat(scanPath).catch(() => null);
     if (!stat || !stat.isDirectory()) {
       console.error(`neat watch: ${scanPath} is not a directory`);
       process.exit(2);
     }
-    const projectPaths = pathsForProject(project, import_node_path49.default.join(scanPath, "neat-out"));
-    const outPath = import_node_path49.default.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
-    const errorsPath = import_node_path49.default.resolve(
-      process.env.NEAT_ERRORS_PATH ?? import_node_path49.default.join(import_node_path49.default.dirname(outPath), import_node_path49.default.basename(projectPaths.errorsPath))
+    const projectPaths = pathsForProject(project, import_node_path52.default.join(scanPath, "neat-out"));
+    const outPath = import_node_path52.default.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
+    const errorsPath = import_node_path52.default.resolve(
+      process.env.NEAT_ERRORS_PATH ?? import_node_path52.default.join(import_node_path52.default.dirname(outPath), import_node_path52.default.basename(projectPaths.errorsPath))
     );
-    const staleEventsPath = import_node_path49.default.resolve(
-      process.env.NEAT_STALE_EVENTS_PATH ?? import_node_path49.default.join(import_node_path49.default.dirname(outPath), import_node_path49.default.basename(projectPaths.staleEventsPath))
+    const staleEventsPath = import_node_path52.default.resolve(
+      process.env.NEAT_STALE_EVENTS_PATH ?? import_node_path52.default.join(import_node_path52.default.dirname(outPath), import_node_path52.default.basename(projectPaths.staleEventsPath))
     );
-    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? import_node_path49.default.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
+    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? import_node_path52.default.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
     const handle = await startWatch(getGraph(project), {
       scanPath,
       outPath,
@@ -11406,16 +11930,14 @@ async function main() {
     process.on("SIGINT", shutdown);
     return;
   }
-  if (cmd === "list") {
-    const projects = await listProjects();
-    if (projects.length === 0) {
-      console.log("no projects registered. run `neat init <path>` to register one.");
+  if (cmd === "list" || cmd === "ps") {
+    const rows = await listMachineProjects();
+    if (rows.length === 0) {
+      console.log("no daemons running and no projects registered. run `neat init <path>` to register one.");
       return;
     }
-    for (const p of projects) {
-      const seen = p.lastSeenAt ? p.lastSeenAt : "never";
-      const langs = p.languages.length > 0 ? p.languages.join(",") : "-";
-      console.log(`${p.name}	${p.status}	${langs}	${p.path}	last-seen=${seen}`);
+    for (const r of rows) {
+      console.log(formatMachineProjectRow(r));
     }
     return;
   }
@@ -11426,6 +11948,15 @@ async function main() {
       usage();
       process.exit(2);
     }
+    const daemon = await findDaemonByProject(name);
+    if (daemon) {
+      if (daemon.live && signalDaemonStop(daemon.record.pid)) {
+        console.log(`paused: ${name} (${daemon.record.projectPath}) \u2014 stopped daemon pid ${daemon.record.pid}`);
+      } else {
+        console.log(`paused: ${name} (${daemon.record.projectPath}) \u2014 daemon was not running`);
+      }
+      return;
+    }
     try {
       const entry2 = await setStatus(name, "paused");
       console.log(`paused: ${entry2.name} (${entry2.path})`);
@@ -11442,6 +11973,15 @@ async function main() {
       usage();
       process.exit(2);
     }
+    const daemon = await findDaemonByProject(name);
+    if (daemon) {
+      if (daemon.live) {
+        console.log(`resume: ${name} (${daemon.record.projectPath}) \u2014 daemon already running`);
+      } else {
+        console.log(`resume: ${name} (${daemon.record.projectPath}) \u2014 run \`neat ${daemon.record.projectPath}\` to start its daemon again`);
+      }
+      return;
+    }
     try {
       const entry2 = await setStatus(name, "active");
       console.log(`resumed: ${entry2.name} (${entry2.path})`);
@@ -11463,15 +12003,36 @@ async function main() {
       usage();
       process.exit(2);
     }
+    const daemon = await findDaemonByProject(name);
     const removed = await removeProject(name);
-    if (!removed) {
+    if (!daemon && !removed) {
       console.error(`neat uninstall: no project named "${name}"`);
       process.exit(1);
     }
-    console.log(`unregistered: ${removed.name} (${removed.path})`);
+    const projectPath2 = daemon?.record.projectPath ?? removed?.path ?? "(unknown path)";
+    if (daemon) {
+      if (daemon.live && signalDaemonStop(daemon.record.pid)) {
+        console.log(`uninstall: ${name} \u2014 stopped daemon pid ${daemon.record.pid}`);
+      }
+      await removeDaemonRecord(daemon.source);
+    }
+    console.log(`unregistered: ${name} (${projectPath2})`);
     console.log("note: neat-out/, policy.json, and other files at the project path were left in place.");
     return;
   }
+  if (cmd === "prune") {
+    const removed = await pruneRegistry({ ttlMs: 0 });
+    if (parsed.json) {
+      console.log(JSON.stringify(removed.map((p) => ({ name: p.name, path: p.path })), null, 2));
+      return;
+    }
+    if (removed.length === 0) {
+      console.log("nothing to prune \u2014 every registered project path still exists.");
+      return;
+    }
+    console.log(`pruned ${removed.length} project${removed.length === 1 ? "" : "s"}: ${removed.map((p) => p.name).join(", ")}`);
+    return;
+  }
   if (cmd === "deploy") {
     const artifact = await runDeploy();
     const block = renderOtelEnvBlock2(artifact.token);
@@ -11525,11 +12086,11 @@ async function main() {
   process.exit(1);
 }
 async function tryOrchestrator(cmd, parsed) {
-  const scanPath = import_node_path49.default.resolve(cmd);
-  const stat = await import_node_fs32.promises.stat(scanPath).catch(() => null);
+  const scanPath = import_node_path52.default.resolve(cmd);
+  const stat = await import_node_fs34.promises.stat(scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) return null;
   const projectExplicit = parsed.project !== null;
-  const projectName = projectExplicit ? parsed.project : import_node_path49.default.basename(scanPath);
+  const projectName = projectExplicit ? parsed.project : import_node_path52.default.basename(scanPath);
   const result = await runOrchestrator({
     scanPath,
     project: projectName,
@@ -11559,12 +12120,44 @@ function resolveProjectFlag(parsed) {
   if (env && env.length > 0 && env !== DEFAULT_PROJECT) return env;
   return void 0;
 }
+var ProjectResolutionError = class extends Error {
+  constructor(message, exitCode = 2) {
+    super(message);
+    this.exitCode = exitCode;
+    this.name = "ProjectResolutionError";
+  }
+  exitCode;
+};
+async function resolveProjectForVerb(client, parsed) {
+  const explicit = resolveProjectFlag(parsed);
+  if (explicit) return explicit;
+  const projects = await client.get("/projects");
+  if (projects.some((p) => p.name === DEFAULT_PROJECT)) {
+    return void 0;
+  }
+  if (projects.length === 1) {
+    return projects[0].name;
+  }
+  if (projects.length === 0) {
+    throw new ProjectResolutionError(
+      "No projects are registered with the daemon yet. Run `npx neat.is` in a repo to build a graph first, then re-run this command."
+    );
+  }
+  const names = projects.map((p) => p.name).sort().map((n) => `  ${n}`).join("\n");
+  throw new ProjectResolutionError(
+    `Several projects are registered and none is named "default", so I can't pick one for you.
+Pass --project <name> to choose:
+${names}`
+  );
+}
+function resolveDaemonUrl() {
+  return process.env.NEAT_API_URL ?? process.env.NEAT_CORE_URL ?? "http://localhost:8080";
+}
 async function runQueryVerb(cmd, parsed) {
-  const baseUrl = process.env.NEAT_API_URL ?? "http://localhost:8080";
+  const baseUrl = resolveDaemonUrl();
   const client = createHttpClient(baseUrl, resolveAuthToken());
-  const project = resolveProjectFlag(parsed);
   const positional = parsed.positional;
-  let work;
+  let makeWork;
   switch (cmd) {
     case "root-cause": {
       const node = positional[0];
@@ -11572,7 +12165,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat root-cause: missing <node-id>");
         return 2;
       }
-      work = runRootCause(client, {
+      makeWork = (project) => runRootCause(client, {
         errorNode: node,
         ...parsed.errorId ? { errorId: parsed.errorId } : {},
         ...project ? { project } : {}
@@ -11585,7 +12178,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat blast-radius: missing <node-id>");
         return 2;
       }
-      work = runBlastRadius(client, {
+      makeWork = (project) => runBlastRadius(client, {
         nodeId: node,
         ...parsed.depth !== null ? { depth: parsed.depth } : {},
         ...project ? { project } : {}
@@ -11598,7 +12191,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat dependencies: missing <node-id>");
         return 2;
       }
-      work = runDependencies(client, {
+      makeWork = (project) => runDependencies(client, {
         nodeId: node,
         ...parsed.depth !== null ? { depth: parsed.depth } : {},
         ...project ? { project } : {}
@@ -11611,14 +12204,14 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat observed-dependencies: missing <node-id>");
         return 2;
       }
-      work = runObservedDependencies(client, {
+      makeWork = (project) => runObservedDependencies(client, {
         nodeId: node,
         ...project ? { project } : {}
       });
       break;
     }
     case "incidents": {
-      work = runIncidents(client, {
+      makeWork = (project) => runIncidents(client, {
         ...positional[0] ? { nodeId: positional[0] } : {},
         ...parsed.limit !== null ? { limit: parsed.limit } : {},
         ...project ? { project } : {}
@@ -11631,7 +12224,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat search: missing <query>");
         return 2;
       }
-      work = runSearch(client, { query: q, ...project ? { project } : {} });
+      makeWork = (project) => runSearch(client, { query: q, ...project ? { project } : {} });
       break;
     }
     case "diff": {
@@ -11640,14 +12233,14 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat diff: --against <snapshot-path> is required");
         return 2;
       }
-      work = runDiff(client, {
+      makeWork = (project) => runDiff(client, {
         againstSnapshot: against,
         ...project ? { project } : {}
       });
       break;
     }
     case "stale-edges": {
-      work = runStaleEdges(client, {
+      makeWork = (project) => runStaleEdges(client, {
         ...parsed.limit !== null ? { limit: parsed.limit } : {},
         ...parsed.edgeType ? { edgeType: parsed.edgeType } : {},
         ...project ? { project } : {}
@@ -11666,7 +12259,7 @@ async function runQueryVerb(cmd, parsed) {
           return 2;
         }
       }
-      work = runPolicies(client, {
+      makeWork = (project) => runPolicies(client, {
         ...parsed.node ? { nodeId: parsed.node } : {},
         ...hypothetical ? { hypotheticalAction: hypothetical } : {},
         ...project ? { project } : {}
@@ -11679,10 +12272,10 @@ async function runQueryVerb(cmd, parsed) {
         const parts = parsed.type.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
         const out = [];
         for (const p of parts) {
-          const r = import_types27.DivergenceTypeSchema.safeParse(p);
+          const r = import_types28.DivergenceTypeSchema.safeParse(p);
           if (!r.success) {
             console.error(
-              `neat divergences: unknown --type "${p}". allowed: ${import_types27.DivergenceTypeSchema.options.join(", ")}`
+              `neat divergences: unknown --type "${p}". allowed: ${import_types28.DivergenceTypeSchema.options.join(", ")}`
             );
             return 2;
           }
@@ -11690,7 +12283,7 @@ async function runQueryVerb(cmd, parsed) {
         }
         typeFilter = out;
       }
-      work = runDivergences(client, {
+      makeWork = (project) => runDivergences(client, {
         ...typeFilter ? { type: typeFilter } : {},
         ...parsed.minConfidence !== null ? { minConfidence: parsed.minConfidence } : {},
         ...parsed.node ? { node: parsed.node } : {},
@@ -11703,16 +12296,21 @@ async function runQueryVerb(cmd, parsed) {
       return 2;
   }
   try {
-    const result = await work;
+    const project = await resolveProjectForVerb(client, parsed);
+    const result = await makeWork(project);
     if (parsed.json) process.stdout.write(formatJson(result) + "\n");
     else process.stdout.write(formatHuman(result) + "\n");
     return 0;
   } catch (err) {
+    if (err instanceof ProjectResolutionError) {
+      console.error(`neat ${cmd}: ${err.message}`);
+      return err.exitCode;
+    }
     if (err instanceof HttpError) {
       const detail = err.responseBody.length > 0 ? err.responseBody : err.message;
       console.error(`neat ${cmd}: ${detail.trim()}`);
     } else if (err instanceof TransportError) {
-      console.error(`neat ${cmd}: ${err.message}. Is the daemon running? (NEAT_API_URL=${process.env.NEAT_API_URL ?? "http://localhost:8080"})`);
+      console.error(`neat ${cmd}: ${err.message}. Is the daemon running? (NEAT_API_URL=${resolveDaemonUrl()})`);
     } else {
       console.error(`neat ${cmd}: ${err.message}`);
     }
@@ -11729,6 +12327,7 @@ if (/[\\/]cli\.(?:cjs|js)$/.test(entry) || entry.endsWith("/cli") || entry.endsW
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CLAUDE_SKILL_CONFIG,
+  ProjectResolutionError,
   QUERY_VERBS,
   commandPrefix,
   isNpxInvocation,
@@ -11736,6 +12335,7 @@ if (/[\\/]cli\.(?:cjs|js)$/.test(entry) || entry.endsWith("/cli") || entry.endsW
   parseArgs,
   printBanner,
   readPackageVersion,
+  resolveProjectForVerb,
   runInit,
   runQueryVerb,
   runSkill,