@neat.is/core 0.4.11 → 0.4.12

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 path46 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
+    const path47 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
     for (const suffix of suffixes) {
-      if (path46 === suffix || path46.endsWith(suffix)) {
+      if (path47 === suffix || path47.endsWith(suffix)) {
         done();
         return;
       }
@@ -186,8 +186,8 @@ function reshapeGrpcRequest(req) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path35.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path35.default.resolve(here, "..", "proto");
+  const here = import_node_path37.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return import_node_path37.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -255,13 +255,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path35, import_node_crypto2, grpc, protoLoader;
+var import_node_url, import_node_path37, import_node_crypto2, grpc, protoLoader;
 var init_otel_grpc = __esm({
   "src/otel-grpc.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_url = require("url");
-    import_node_path35 = __toESM(require("path"), 1);
+    import_node_path37 = __toESM(require("path"), 1);
     import_node_crypto2 = require("crypto");
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
@@ -371,10 +371,10 @@ function parseOtlpRequest(body) {
   return out;
 }
 function loadProtoRoot() {
-  const here = import_node_path36.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path36.default.resolve(here, "..", "proto");
+  const here = import_node_path38.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path38.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path36.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path38.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -567,12 +567,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path36, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
+var import_node_path38, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
 var init_otel = __esm({
   "src/otel.ts"() {
     "use strict";
     init_cjs_shims();
-    import_node_path36 = __toESM(require("path"), 1);
+    import_node_path38 = __toESM(require("path"), 1);
     import_node_url2 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -600,8 +600,8 @@ __export(cli_exports, {
 });
 module.exports = __toCommonJS(cli_exports);
 init_cjs_shims();
-var import_node_path45 = __toESM(require("path"), 1);
-var import_node_fs29 = require("fs");
+var import_node_path46 = __toESM(require("path"), 1);
+var import_node_fs30 = require("fs");
 var import_node_url3 = require("url");
 
 // src/graph.ts
@@ -1131,19 +1131,19 @@ function confidenceFromMix(edges, now = Date.now()) {
 function longestIncomingWalk(graph, start, maxDepth) {
   let best = { path: [start], edges: [] };
   const visited = /* @__PURE__ */ new Set([start]);
-  function step(node, path46, edges) {
-    if (path46.length > best.path.length) {
-      best = { path: [...path46], edges: [...edges] };
+  function step(node, path47, edges) {
+    if (path47.length > best.path.length) {
+      best = { path: [...path47], edges: [...edges] };
     }
-    if (path46.length - 1 >= maxDepth) return;
+    if (path47.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);
-      path46.push(srcId);
+      path47.push(srcId);
       edges.push(edge);
-      step(srcId, path46, edges);
-      path46.pop();
+      step(srcId, path47, edges);
+      path47.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1975,7 +1975,7 @@ function ensureFrontierNode(graph, host, ts) {
   graph.addNode(id, node);
   return id;
 }
-function upsertObservedEdge(graph, type, source, target, ts, isError = false) {
+function upsertObservedEdge(graph, type, source, target, ts, isError = false, evidence) {
   if (!graph.hasNode(source) || !graph.hasNode(target)) return null;
   const id = makeObservedEdgeId(type, source, target);
   if (graph.hasEdge(id)) {
@@ -2012,7 +2012,10 @@ function upsertObservedEdge(graph, type, source, target, ts, isError = false) {
     confidence: (0, import_types3.confidenceForObservedSignal)(signal),
     lastObserved: ts,
     callCount: 1,
-    signal
+    signal,
+    // Call-site evidence from span code.* semconv (file-awareness.md §4 + §6).
+    // Only set when code.filepath was present on the span — never fabricated.
+    ...evidence ? { evidence } : {}
   };
   graph.addEdgeWithKey(id, source, target, edge);
   return { edge, created: true };
@@ -2106,6 +2109,7 @@ async function handleSpan(ctx, span) {
   const sourceServiceNode = ctx.graph.getNodeAttributes(sourceId);
   const callSite = callSiteFromSpan(span, sourceServiceNode, ctx.scanPath);
   const observedSource = () => callSite ? ensureObservedFileNode(ctx.graph, span.service, sourceId, callSite) : sourceId;
+  const callSiteEvidence = callSite ? { file: callSite.relPath, ...callSite.line !== void 0 ? { line: callSite.line } : {} } : void 0;
   let affectedNode = sourceId;
   const mintsFromCallerSide = spanMintsObservedEdge(span.kind);
   if (span.dbSystem) {
@@ -2119,7 +2123,8 @@ async function handleSpan(ctx, span) {
         observedSource(),
         targetId,
         ts,
-        isError
+        isError,
+        callSiteEvidence
       );
       if (result) affectedNode = targetId;
     }
@@ -2135,7 +2140,8 @@ async function handleSpan(ctx, span) {
           observedSource(),
           targetId,
           ts,
-          isError
+          isError,
+          callSiteEvidence
         );
         affectedNode = targetId;
         resolvedViaAddress = true;
@@ -2147,7 +2153,8 @@ async function handleSpan(ctx, span) {
           observedSource(),
           frontierNodeId,
           ts,
-          isError
+          isError,
+          callSiteEvidence
         );
         affectedNode = frontierNodeId;
         resolvedViaAddress = true;
@@ -3110,14 +3117,111 @@ async function addServiceAliases(graph, scanPath, services) {
 
 // src/extract/databases/index.ts
 init_cjs_shims();
-var import_node_path17 = __toESM(require("path"), 1);
+var import_node_path18 = __toESM(require("path"), 1);
+var import_types8 = require("@neat.is/types");
+
+// src/extract/calls/shared.ts
+init_cjs_shims();
+var import_node_fs10 = require("fs");
+var import_node_path10 = __toESM(require("path"), 1);
 var import_types7 = require("@neat.is/types");
+async function walkSourceFiles(dir) {
+  const out = [];
+  async function walk(current) {
+    const entries = await import_node_fs10.promises.readdir(current, { withFileTypes: true }).catch(() => []);
+    for (const entry2 of entries) {
+      const full = import_node_path10.default.join(current, entry2.name);
+      if (entry2.isDirectory()) {
+        if (IGNORED_DIRS.has(entry2.name)) continue;
+        if (await isPythonVenvDir(full)) continue;
+        await walk(full);
+      } else if (entry2.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path10.default.extname(entry2.name))) {
+        out.push(full);
+      }
+    }
+  }
+  await walk(dir);
+  return out;
+}
+async function loadSourceFiles(dir) {
+  const paths = await walkSourceFiles(dir);
+  const out = [];
+  for (const p of paths) {
+    try {
+      const content = await import_node_fs10.promises.readFile(p, "utf8");
+      out.push({ path: p, content });
+    } catch {
+    }
+  }
+  return out;
+}
+function lineOf(text, needle) {
+  const idx = text.indexOf(needle);
+  if (idx < 0) return 1;
+  return text.slice(0, idx).split("\n").length;
+}
+function snippet(text, line) {
+  const lines = text.split("\n");
+  return (lines[line - 1] ?? "").trim();
+}
+function toPosix2(p) {
+  return p.split("\\").join("/");
+}
+function languageForPath(relPath) {
+  switch (import_node_path10.default.extname(relPath).toLowerCase()) {
+    case ".py":
+      return "python";
+    case ".ts":
+    case ".tsx":
+      return "typescript";
+    case ".js":
+    case ".jsx":
+    case ".mjs":
+    case ".cjs":
+      return "javascript";
+    default:
+      return void 0;
+  }
+}
+function ensureFileNode(graph, serviceName, serviceNodeId, relPath) {
+  let nodesAdded = 0;
+  let edgesAdded = 0;
+  const fileNodeId = (0, import_types7.fileId)(serviceName, relPath);
+  if (!graph.hasNode(fileNodeId)) {
+    const language = languageForPath(relPath);
+    const node = {
+      id: fileNodeId,
+      type: import_types7.NodeType.FileNode,
+      service: serviceName,
+      path: relPath,
+      ...language ? { language } : {},
+      discoveredVia: "static"
+    };
+    graph.addNode(fileNodeId, node);
+    nodesAdded++;
+  }
+  const containsId = (0, import_types7.extractedEdgeId)(serviceNodeId, fileNodeId, import_types7.EdgeType.CONTAINS);
+  if (!graph.hasEdge(containsId)) {
+    const edge = {
+      id: containsId,
+      source: serviceNodeId,
+      target: fileNodeId,
+      type: import_types7.EdgeType.CONTAINS,
+      provenance: import_types7.Provenance.EXTRACTED,
+      confidence: (0, import_types7.confidenceForExtracted)("structural"),
+      evidence: { file: relPath }
+    };
+    graph.addEdgeWithKey(containsId, serviceNodeId, fileNodeId, edge);
+    edgesAdded++;
+  }
+  return { fileNodeId, nodesAdded, edgesAdded };
+}
 
 // src/extract/databases/db-config-yaml.ts
 init_cjs_shims();
-var import_node_path10 = __toESM(require("path"), 1);
+var import_node_path11 = __toESM(require("path"), 1);
 async function parse(serviceDir) {
-  const yamlPath = import_node_path10.default.join(serviceDir, "db-config.yaml");
+  const yamlPath = import_node_path11.default.join(serviceDir, "db-config.yaml");
   if (!await exists(yamlPath)) return [];
   const raw = await readYaml(yamlPath);
   return [
@@ -3135,13 +3239,13 @@ var dbConfigYamlParser = { name: "db-config.yaml", parse };
 
 // src/extract/databases/dotenv.ts
 init_cjs_shims();
-var import_node_fs11 = require("fs");
-var import_node_path12 = __toESM(require("path"), 1);
+var import_node_fs12 = require("fs");
+var import_node_path13 = __toESM(require("path"), 1);
 
 // src/extract/databases/shared.ts
 init_cjs_shims();
-var import_node_fs10 = require("fs");
-var import_node_path11 = __toESM(require("path"), 1);
+var import_node_fs11 = require("fs");
+var import_node_path12 = __toESM(require("path"), 1);
 function schemeToEngine(scheme) {
   const s = scheme.toLowerCase().split("+")[0];
   switch (s) {
@@ -3180,14 +3284,14 @@ function parseConnectionString(url) {
 }
 async function readIfExists(filePath) {
   try {
-    return await import_node_fs10.promises.readFile(filePath, "utf8");
+    return await import_node_fs11.promises.readFile(filePath, "utf8");
   } catch {
     return null;
   }
 }
 async function findFirst(serviceDir, candidates) {
   for (const rel of candidates) {
-    const abs = import_node_path11.default.join(serviceDir, rel);
+    const abs = import_node_path12.default.join(serviceDir, rel);
     const content = await readIfExists(abs);
     if (content !== null) return abs;
   }
@@ -3238,15 +3342,15 @@ function parseDotenvLine(line) {
   return { key, value };
 }
 async function parse2(serviceDir) {
-  const entries = await import_node_fs11.promises.readdir(serviceDir, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs12.promises.readdir(serviceDir, { withFileTypes: true }).catch(() => []);
   const configs = [];
   const seen = /* @__PURE__ */ new Set();
   for (const entry2 of entries) {
     if (!entry2.isFile()) continue;
     const match = isConfigFile(entry2.name);
     if (!match.match || match.fileType !== "env") continue;
-    const filePath = import_node_path12.default.join(serviceDir, entry2.name);
-    const content = await import_node_fs11.promises.readFile(filePath, "utf8");
+    const filePath = import_node_path13.default.join(serviceDir, entry2.name);
+    const content = await import_node_fs12.promises.readFile(filePath, "utf8");
     for (const line of content.split("\n")) {
       const parsed = parseDotenvLine(line);
       if (!parsed) continue;
@@ -3265,9 +3369,9 @@ var dotenvParser = { name: ".env", parse: parse2 };
 
 // src/extract/databases/prisma.ts
 init_cjs_shims();
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 async function parse3(serviceDir) {
-  const schemaPath = import_node_path13.default.join(serviceDir, "prisma", "schema.prisma");
+  const schemaPath = import_node_path14.default.join(serviceDir, "prisma", "schema.prisma");
   const content = await readIfExists(schemaPath);
   if (!content) return [];
   const block = content.match(/datasource\s+\w+\s*\{([^}]*)\}/s);
@@ -3399,10 +3503,10 @@ var knexParser = { name: "knex", parse: parse5 };
 
 // src/extract/databases/ormconfig.ts
 init_cjs_shims();
-var import_node_path14 = __toESM(require("path"), 1);
+var import_node_path15 = __toESM(require("path"), 1);
 async function parse6(serviceDir) {
   for (const candidate of ["ormconfig.json", "ormconfig.yaml", "ormconfig.yml"]) {
-    const abs = import_node_path14.default.join(serviceDir, candidate);
+    const abs = import_node_path15.default.join(serviceDir, candidate);
     if (!await exists(abs)) continue;
     const raw = candidate.endsWith(".json") ? await readJson(abs) : await readYaml(abs);
     const entries = Array.isArray(raw) ? raw : [raw];
@@ -3462,9 +3566,9 @@ var typeormParser = { name: "typeorm", parse: parse7 };
 
 // src/extract/databases/sequelize.ts
 init_cjs_shims();
-var import_node_path15 = __toESM(require("path"), 1);
+var import_node_path16 = __toESM(require("path"), 1);
 async function parse8(serviceDir) {
-  const configPath = import_node_path15.default.join(serviceDir, "config", "config.json");
+  const configPath = import_node_path16.default.join(serviceDir, "config", "config.json");
   if (!await exists(configPath)) return [];
   const raw = await readJson(configPath);
   const out = [];
@@ -3491,7 +3595,7 @@ var sequelizeParser = { name: "sequelize", parse: parse8 };
 
 // src/extract/databases/docker-compose.ts
 init_cjs_shims();
-var import_node_path16 = __toESM(require("path"), 1);
+var import_node_path17 = __toESM(require("path"), 1);
 function portFromService(svc) {
   for (const raw of svc.ports ?? []) {
     const str = String(raw);
@@ -3518,7 +3622,7 @@ function databaseFromEnv(svc) {
 }
 async function parse9(serviceDir) {
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = import_node_path16.default.join(serviceDir, name);
+    const abs = import_node_path17.default.join(serviceDir, name);
     if (!await exists(abs)) continue;
     const raw = await readYaml(abs);
     if (!raw?.services) return [];
@@ -3559,8 +3663,8 @@ function compatibleDriversFor(engine) {
 }
 function toDatabaseNode(config) {
   return {
-    id: (0, import_types7.databaseId)(config.host),
-    type: import_types7.NodeType.DatabaseNode,
+    id: (0, import_types8.databaseId)(config.host),
+    type: import_types8.NodeType.DatabaseNode,
     name: config.database || config.host,
     engine: config.engine,
     engineVersion: config.engineVersion,
@@ -3690,19 +3794,24 @@ async function addDatabasesAndCompat(graph, services, scanPath) {
           discoveredVia: mergedDiscoveredVia
         });
       }
+      const relConfigFile = toPosix2(import_node_path18.default.relative(service.dir, config.sourceFile));
+      const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
+        graph,
+        service.pkg.name,
+        service.node.id,
+        relConfigFile
+      );
+      nodesAdded += fn;
+      edgesAdded += fe;
+      const evidenceFile = toPosix2(import_node_path18.default.relative(scanPath, config.sourceFile));
       const edge = {
-        id: (0, import_types4.extractedEdgeId)(service.node.id, dbNode.id, import_types7.EdgeType.CONNECTS_TO),
-        source: service.node.id,
+        id: (0, import_types4.extractedEdgeId)(fileNodeId, dbNode.id, import_types8.EdgeType.CONNECTS_TO),
+        source: fileNodeId,
         target: dbNode.id,
-        type: import_types7.EdgeType.CONNECTS_TO,
-        provenance: import_types7.Provenance.EXTRACTED,
-        confidence: (0, import_types7.confidenceForExtracted)("structural"),
-        // ADR-032 / #140 — every EXTRACTED edge carries evidence.file.
-        // Ghost-edge cleanup keys retirement on this; the conditional
-        // sourceFile spread that used to live here was a v0.1.x leftover.
-        evidence: {
-          file: import_node_path17.default.relative(scanPath, config.sourceFile).split(import_node_path17.default.sep).join("/")
-        }
+        type: import_types8.EdgeType.CONNECTS_TO,
+        provenance: import_types8.Provenance.EXTRACTED,
+        confidence: (0, import_types8.confidenceForExtracted)("structural"),
+        evidence: { file: evidenceFile }
       };
       if (!graph.hasEdge(edge.id)) {
         graph.addEdgeWithKey(edge.id, edge.source, edge.target, edge);
@@ -3728,15 +3837,15 @@ async function addDatabasesAndCompat(graph, services, scanPath) {
 
 // src/extract/configs.ts
 init_cjs_shims();
-var import_node_fs12 = require("fs");
-var import_node_path18 = __toESM(require("path"), 1);
-var import_types8 = require("@neat.is/types");
+var import_node_fs13 = require("fs");
+var import_node_path19 = __toESM(require("path"), 1);
+var import_types9 = require("@neat.is/types");
 async function walkConfigFiles(dir) {
   const out = [];
   async function walk(current) {
-    const entries = await import_node_fs12.promises.readdir(current, { withFileTypes: true });
+    const entries = await import_node_fs13.promises.readdir(current, { withFileTypes: true });
     for (const entry2 of entries) {
-      const full = import_node_path18.default.join(current, entry2.name);
+      const full = import_node_path19.default.join(current, entry2.name);
       if (entry2.isDirectory()) {
         if (IGNORED_DIRS.has(entry2.name)) continue;
         if (await isPythonVenvDir(full)) continue;
@@ -3755,26 +3864,35 @@ async function addConfigNodes(graph, services, scanPath) {
   for (const service of services) {
     const configFiles = await walkConfigFiles(service.dir);
     for (const file of configFiles) {
-      const relPath = import_node_path18.default.relative(scanPath, file);
+      const relPath = import_node_path19.default.relative(scanPath, file);
       const node = {
-        id: (0, import_types8.configId)(relPath),
-        type: import_types8.NodeType.ConfigNode,
-        name: import_node_path18.default.basename(file),
+        id: (0, import_types9.configId)(relPath),
+        type: import_types9.NodeType.ConfigNode,
+        name: import_node_path19.default.basename(file),
         path: relPath,
-        fileType: isConfigFile(import_node_path18.default.basename(file)).fileType
+        fileType: isConfigFile(import_node_path19.default.basename(file)).fileType
       };
       if (!graph.hasNode(node.id)) {
         graph.addNode(node.id, node);
         nodesAdded++;
       }
+      const relToService = toPosix2(import_node_path19.default.relative(service.dir, file));
+      const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
+        graph,
+        service.pkg.name,
+        service.node.id,
+        relToService
+      );
+      nodesAdded += fn;
+      edgesAdded += fe;
       const edge = {
-        id: (0, import_types4.extractedEdgeId)(service.node.id, node.id, import_types8.EdgeType.CONFIGURED_BY),
-        source: service.node.id,
+        id: (0, import_types4.extractedEdgeId)(fileNodeId, node.id, import_types9.EdgeType.CONFIGURED_BY),
+        source: fileNodeId,
         target: node.id,
-        type: import_types8.EdgeType.CONFIGURED_BY,
-        provenance: import_types8.Provenance.EXTRACTED,
-        confidence: (0, import_types8.confidenceForExtracted)("structural"),
-        evidence: { file: relPath.split(import_node_path18.default.sep).join("/") }
+        type: import_types9.EdgeType.CONFIGURED_BY,
+        provenance: import_types9.Provenance.EXTRACTED,
+        confidence: (0, import_types9.confidenceForExtracted)("structural"),
+        evidence: { file: relPath.split(import_node_path19.default.sep).join("/") }
       };
       if (!graph.hasEdge(edge.id)) {
         graph.addEdgeWithKey(edge.id, edge.source, edge.target, edge);
@@ -3796,105 +3914,6 @@ var import_tree_sitter = __toESM(require("tree-sitter"), 1);
 var import_tree_sitter_javascript = __toESM(require("tree-sitter-javascript"), 1);
 var import_tree_sitter_python = __toESM(require("tree-sitter-python"), 1);
 var import_types10 = require("@neat.is/types");
-
-// src/extract/calls/shared.ts
-init_cjs_shims();
-var import_node_fs13 = require("fs");
-var import_node_path19 = __toESM(require("path"), 1);
-var import_types9 = require("@neat.is/types");
-async function walkSourceFiles(dir) {
-  const out = [];
-  async function walk(current) {
-    const entries = await import_node_fs13.promises.readdir(current, { withFileTypes: true }).catch(() => []);
-    for (const entry2 of entries) {
-      const full = import_node_path19.default.join(current, entry2.name);
-      if (entry2.isDirectory()) {
-        if (IGNORED_DIRS.has(entry2.name)) continue;
-        if (await isPythonVenvDir(full)) continue;
-        await walk(full);
-      } else if (entry2.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path19.default.extname(entry2.name))) {
-        out.push(full);
-      }
-    }
-  }
-  await walk(dir);
-  return out;
-}
-async function loadSourceFiles(dir) {
-  const paths = await walkSourceFiles(dir);
-  const out = [];
-  for (const p of paths) {
-    try {
-      const content = await import_node_fs13.promises.readFile(p, "utf8");
-      out.push({ path: p, content });
-    } catch {
-    }
-  }
-  return out;
-}
-function lineOf(text, needle) {
-  const idx = text.indexOf(needle);
-  if (idx < 0) return 1;
-  return text.slice(0, idx).split("\n").length;
-}
-function snippet(text, line) {
-  const lines = text.split("\n");
-  return (lines[line - 1] ?? "").trim();
-}
-function toPosix2(p) {
-  return p.split("\\").join("/");
-}
-function languageForPath(relPath) {
-  switch (import_node_path19.default.extname(relPath).toLowerCase()) {
-    case ".py":
-      return "python";
-    case ".ts":
-    case ".tsx":
-      return "typescript";
-    case ".js":
-    case ".jsx":
-    case ".mjs":
-    case ".cjs":
-      return "javascript";
-    default:
-      return void 0;
-  }
-}
-function ensureFileNode(graph, serviceName, serviceNodeId, relPath) {
-  let nodesAdded = 0;
-  let edgesAdded = 0;
-  const fileNodeId = (0, import_types9.fileId)(serviceName, relPath);
-  if (!graph.hasNode(fileNodeId)) {
-    const language = languageForPath(relPath);
-    const node = {
-      id: fileNodeId,
-      type: import_types9.NodeType.FileNode,
-      service: serviceName,
-      path: relPath,
-      ...language ? { language } : {},
-      discoveredVia: "static"
-    };
-    graph.addNode(fileNodeId, node);
-    nodesAdded++;
-  }
-  const containsId = (0, import_types9.extractedEdgeId)(serviceNodeId, fileNodeId, import_types9.EdgeType.CONTAINS);
-  if (!graph.hasEdge(containsId)) {
-    const edge = {
-      id: containsId,
-      source: serviceNodeId,
-      target: fileNodeId,
-      type: import_types9.EdgeType.CONTAINS,
-      provenance: import_types9.Provenance.EXTRACTED,
-      confidence: (0, import_types9.confidenceForExtracted)("structural"),
-      evidence: { file: relPath }
-    };
-    graph.addEdgeWithKey(containsId, serviceNodeId, fileNodeId, edge);
-    edgesAdded++;
-  }
-  return { fileNodeId, nodesAdded, edgesAdded };
-}
-
-// src/extract/calls/http.ts
 var STRING_LITERAL_NODE_TYPES = /* @__PURE__ */ new Set(["string_fragment", "string_content"]);
 var JSX_EXTERNAL_LINK_TAGS = /* @__PURE__ */ new Set(["a", "Link", "NavLink", "ExternalLink", "Anchor"]);
 function isInsideJsxExternalLink(node) {
@@ -4178,6 +4197,7 @@ var AWS_SDK_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@aws-sdk\/client-([a-
 var GRPC_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@grpc\/grpc-js['"`]|_grpc_pb['"`]/;
 function isLikelyAddress(value) {
   if (!value) return false;
+  if (/\s/.test(value) || value.startsWith("{")) return false;
   return /:\d{2,5}$/.test(value) || value.includes(".");
 }
 function normaliseForMatch(s) {
@@ -4489,17 +4509,26 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const edgeId = (0, import_types4.extractedEdgeId)(service.node.id, node.id, import_types18.EdgeType.RUNS_ON);
+    const relDockerfile = toPosix2(import_node_path26.default.relative(service.dir, dockerfilePath));
+    const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
+      graph,
+      service.pkg.name,
+      service.node.id,
+      relDockerfile
+    );
+    nodesAdded += fn;
+    edgesAdded += fe;
+    const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, node.id, import_types18.EdgeType.RUNS_ON);
     if (!graph.hasEdge(edgeId)) {
       const edge = {
         id: edgeId,
-        source: service.node.id,
+        source: fileNodeId,
         target: node.id,
         type: import_types18.EdgeType.RUNS_ON,
         provenance: import_types18.Provenance.EXTRACTED,
         confidence: (0, import_types18.confidenceForExtracted)("structural"),
         evidence: {
-          file: import_node_path26.default.relative(scanPath, dockerfilePath).split(import_node_path26.default.sep).join("/")
+          file: toPosix2(import_node_path26.default.relative(scanPath, dockerfilePath))
         }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -5198,38 +5227,353 @@ function renderValueForwardSummary(input) {
     for (const [t, c] of [...byEdge.entries()].sort()) lines.push(`  ${t}: ${c}`);
     lines.push("");
   }
-  return lines.join("\n");
+  return lines.join("\n");
+}
+function formatIncompat(inc) {
+  if (inc.kind === "node-engine") {
+    const range = inc.declaredNodeEngine ? ` (engines.node="${inc.declaredNodeEngine}")` : "";
+    return `${inc.package}@${inc.packageVersion ?? "?"} requires Node ${inc.requiredNodeVersion}${range} \u2014 ${inc.reason}`;
+  }
+  if (inc.kind === "package-conflict") {
+    const found = inc.foundVersion ? `@${inc.foundVersion}` : " (missing)";
+    return `${inc.package}@${inc.packageVersion ?? "?"} requires ${inc.requires.name}>=${inc.requires.minVersion}; found ${inc.requires.name}${found} \u2014 ${inc.reason}`;
+  }
+  if (inc.kind === "deprecated-api") {
+    return `${inc.package}@${inc.packageVersion ?? "?"} is deprecated \u2014 ${inc.reason}`;
+  }
+  return `${inc.driver}@${inc.driverVersion} vs ${inc.engine} ${inc.engineVersion} \u2014 ${inc.reason}`;
+}
+
+// src/watch.ts
+init_cjs_shims();
+var import_node_fs25 = __toESM(require("fs"), 1);
+var import_node_path40 = __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_types24 = require("@neat.is/types");
+
+// src/extend/index.ts
+init_cjs_shims();
+var import_node_fs21 = require("fs");
+var import_node_path34 = __toESM(require("path"), 1);
+var import_node_os2 = __toESM(require("os"), 1);
+var import_instrumentation_registry = require("@neat.is/instrumentation-registry");
+
+// src/installers/package-manager.ts
+init_cjs_shims();
+var import_node_fs20 = require("fs");
+var import_node_path33 = __toESM(require("path"), 1);
+var import_node_child_process = require("child_process");
+var LOCKFILE_PRIORITY = [
+  { lockfile: "bun.lockb", pm: "bun", args: ["install", "--no-summary"] },
+  { lockfile: "pnpm-lock.yaml", pm: "pnpm", args: ["install", "--no-summary"] },
+  { lockfile: "yarn.lock", pm: "yarn", args: ["install", "--silent"] },
+  {
+    lockfile: "package-lock.json",
+    pm: "npm",
+    args: ["install", "--no-audit", "--no-fund", "--prefer-offline"]
+  }
+];
+var NPM_FALLBACK_ARGS = ["install", "--no-audit", "--no-fund", "--prefer-offline"];
+async function exists2(p) {
+  try {
+    await import_node_fs20.promises.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function detectPackageManager(serviceDir) {
+  let dir = import_node_path33.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_path33.default.join(dir, candidate.lockfile);
+      if (await exists2(lockPath)) {
+        return { pm: candidate.pm, cwd: dir, args: [...candidate.args] };
+      }
+    }
+    const parent = import_node_path33.default.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return { pm: "npm", cwd: import_node_path33.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
+}
+async function runPackageManagerInstall(cmd) {
+  return new Promise((resolve) => {
+    const child = (0, import_node_child_process.spawn)(cmd.pm, cmd.args, {
+      cwd: cmd.cwd,
+      // Inherit PATH + HOME so the user's installed managers resolve.
+      env: process.env,
+      // `false` keeps the parent in control of cleanup if the orchestrator
+      // exits before install finishes. Cross-platform-safe.
+      shell: false,
+      stdio: ["ignore", "ignore", "pipe"]
+    });
+    let stderr = "";
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString("utf8");
+    });
+    child.on("error", (err) => {
+      resolve({
+        pm: cmd.pm,
+        cwd: cmd.cwd,
+        args: cmd.args,
+        exitCode: 127,
+        stderr: stderr + `
+${err.message}`
+      });
+    });
+    child.on("close", (code) => {
+      resolve({
+        pm: cmd.pm,
+        cwd: cmd.cwd,
+        args: cmd.args,
+        exitCode: code ?? 1,
+        stderr: stderr.trim()
+      });
+    });
+  });
+}
+
+// src/extend/index.ts
+async function fileExists(p) {
+  try {
+    await import_node_fs21.promises.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readPackageJson(scanPath) {
+  const pkgPath = import_node_path34.default.join(scanPath, "package.json");
+  const raw = await import_node_fs21.promises.readFile(pkgPath, "utf8");
+  return JSON.parse(raw);
+}
+async function findHookFiles(scanPath) {
+  const entries = await import_node_fs21.promises.readdir(scanPath);
+  return entries.filter(
+    (e) => (e.startsWith("instrumentation") || e.startsWith("otel-init")) && /\.(ts|js)$/.test(e)
+  ).sort();
+}
+function extendLogPath() {
+  return process.env.NEAT_EXTEND_LOG ?? import_node_path34.default.join(import_node_os2.default.homedir(), ".neat", "extend-log.ndjson");
+}
+async function appendExtendLog(entry2) {
+  const logPath = extendLogPath();
+  await import_node_fs21.promises.mkdir(import_node_path34.default.dirname(logPath), { recursive: true });
+  await import_node_fs21.promises.appendFile(logPath, JSON.stringify(entry2) + "\n", "utf8");
+}
+function splicedContent(fileContent, snippet2) {
+  if (fileContent.includes("__INSTRUMENTATION_BLOCK__")) {
+    return fileContent.replace("__INSTRUMENTATION_BLOCK__", `${snippet2}
+__INSTRUMENTATION_BLOCK__`);
+  }
+  const lines = fileContent.split("\n");
+  let lastPushIdx = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].includes("instrumentations.push(")) lastPushIdx = i;
+  }
+  if (lastPushIdx >= 0) {
+    lines.splice(lastPushIdx + 1, 0, snippet2);
+    return lines.join("\n");
+  }
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].includes("new NodeSDK(")) {
+      lines.splice(i, 0, snippet2);
+      return lines.join("\n");
+    }
+  }
+  return null;
+}
+async function listUninstrumented(ctx) {
+  const pkg = await readPackageJson(ctx.scanPath);
+  const allDeps2 = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+  const results = [];
+  for (const [library, installedVersion] of Object.entries(allDeps2)) {
+    const entry2 = (0, import_instrumentation_registry.resolve)(library, installedVersion);
+    if (!entry2) continue;
+    if (entry2.coverage === "bundled" || entry2.coverage === "http-only") continue;
+    results.push({
+      library,
+      coverage: entry2.coverage,
+      installedVersion,
+      instrumentation_package: entry2.instrumentation_package,
+      package_version: entry2.package_version,
+      registration: entry2.registration,
+      notes: entry2.notes
+    });
+  }
+  return results;
+}
+function lookupInstrumentation(library, installedVersion) {
+  const entry2 = (0, import_instrumentation_registry.resolve)(library, installedVersion);
+  if (!entry2) return null;
+  return {
+    library: entry2.library,
+    coverage: entry2.coverage,
+    instrumentation_package: entry2.instrumentation_package,
+    package_version: entry2.package_version,
+    registration: entry2.registration,
+    notes: entry2.notes
+  };
+}
+async function describeProjectInstrumentation(ctx) {
+  const hookFiles = await findHookFiles(ctx.scanPath);
+  const envNeat = await fileExists(import_node_path34.default.join(ctx.scanPath, ".env.neat"));
+  const registryInstrPackages = new Set(
+    (0, import_instrumentation_registry.list)().map((e) => e.instrumentation_package).filter((p) => !!p)
+  );
+  const pkg = await readPackageJson(ctx.scanPath);
+  const allDeps2 = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+  const installedDeps = {};
+  for (const [key, version] of Object.entries(allDeps2)) {
+    if (key.startsWith("@opentelemetry/") || registryInstrPackages.has(key)) {
+      installedDeps[key] = version;
+    }
+  }
+  return { hookFiles, envNeat, installedDeps };
+}
+async function applyExtension(ctx, args, options) {
+  const hookFiles = await findHookFiles(ctx.scanPath);
+  if (hookFiles.length === 0) {
+    throw new Error(
+      `No instrumentation hook files found in ${ctx.scanPath}. Run \`neat init\` first.`
+    );
+  }
+  for (const file of hookFiles) {
+    const content = await import_node_fs21.promises.readFile(import_node_path34.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_path34.default.join(ctx.scanPath, primaryFile);
+  const filesTouched = [];
+  const depsAdded = [];
+  const pkgPath = import_node_path34.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 };
+    await import_node_fs21.promises.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
+    filesTouched.push("package.json");
+    depsAdded.push(`${args.instrumentation_package}@${args.version}`);
+  }
+  const hookContent = await import_node_fs21.promises.readFile(primaryPath, "utf8");
+  const patched = splicedContent(hookContent, args.registration_snippet);
+  if (!patched) {
+    throw new Error(
+      `Could not find instrumentation insertion point in ${primaryFile}. Expected __INSTRUMENTATION_BLOCK__, instrumentations.push(, or new NodeSDK(.`
+    );
+  }
+  await import_node_fs21.promises.writeFile(primaryPath, patched, "utf8");
+  filesTouched.push(primaryFile);
+  const cmd = await detectPackageManager(ctx.scanPath);
+  const installer = options?.runInstall ?? runPackageManagerInstall;
+  const install = await installer(cmd);
+  const installOutput = install.exitCode === 0 ? `${cmd.pm} install succeeded` : install.stderr || `${cmd.pm} install failed (exit ${install.exitCode})`;
+  await appendExtendLog({
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    project: ctx.project,
+    library: args.library,
+    instrumentation_package: args.instrumentation_package,
+    version: args.version,
+    registration_snippet: args.registration_snippet,
+    filesTouched,
+    depsAdded,
+    installOutput
+  });
+  return { library: args.library, filesTouched, depsAdded, installOutput, alreadyApplied: false };
 }
-function formatIncompat(inc) {
-  if (inc.kind === "node-engine") {
-    const range = inc.declaredNodeEngine ? ` (engines.node="${inc.declaredNodeEngine}")` : "";
-    return `${inc.package}@${inc.packageVersion ?? "?"} requires Node ${inc.requiredNodeVersion}${range} \u2014 ${inc.reason}`;
+async function dryRunExtension(ctx, args) {
+  const hookFiles = await findHookFiles(ctx.scanPath);
+  if (hookFiles.length === 0) {
+    return {
+      library: args.library,
+      filesTouched: [],
+      depsToAdd: [],
+      packageJsonPatch: {},
+      templatePatch: "No hook files found. Run 'neat init' first."
+    };
   }
-  if (inc.kind === "package-conflict") {
-    const found = inc.foundVersion ? `@${inc.foundVersion}` : " (missing)";
-    return `${inc.package}@${inc.packageVersion ?? "?"} requires ${inc.requires.name}>=${inc.requires.minVersion}; found ${inc.requires.name}${found} \u2014 ${inc.reason}`;
+  for (const file of hookFiles) {
+    const content = await import_node_fs21.promises.readFile(import_node_path34.default.join(ctx.scanPath, file), "utf8");
+    if (content.includes(args.registration_snippet)) {
+      return {
+        library: args.library,
+        filesTouched: [],
+        depsToAdd: [],
+        packageJsonPatch: {},
+        templatePatch: "Already applied \u2014 no changes would be made."
+      };
+    }
   }
-  if (inc.kind === "deprecated-api") {
-    return `${inc.package}@${inc.packageVersion ?? "?"} is deprecated \u2014 ${inc.reason}`;
+  const primaryFile = hookFiles[0];
+  const filesTouched = [];
+  const depsToAdd = [];
+  let packageJsonPatch = {};
+  let templatePatch = "";
+  const pkg = await readPackageJson(ctx.scanPath);
+  if (!(pkg.dependencies ?? {})[args.instrumentation_package]) {
+    packageJsonPatch = { dependencies: { [args.instrumentation_package]: args.version } };
+    depsToAdd.push(`${args.instrumentation_package}@${args.version}`);
+    filesTouched.push("package.json");
+  }
+  const hookContent = await import_node_fs21.promises.readFile(import_node_path34.default.join(ctx.scanPath, primaryFile), "utf8");
+  const patched = splicedContent(hookContent, args.registration_snippet);
+  if (patched) {
+    filesTouched.push(primaryFile);
+    templatePatch = `+ ${args.registration_snippet}`;
+  } else {
+    templatePatch = "Could not find insertion point in hook file.";
+  }
+  return { library: args.library, filesTouched, depsToAdd, packageJsonPatch, templatePatch };
+}
+async function rollbackExtension(ctx, args) {
+  const logPath = extendLogPath();
+  if (!await fileExists(logPath)) {
+    return { undone: false, message: "no apply found for library" };
+  }
+  const raw = await import_node_fs21.promises.readFile(logPath, "utf8");
+  const entries = raw.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line));
+  const match = [...entries].reverse().find((e) => e.project === ctx.project && e.library === args.library);
+  if (!match) {
+    return { undone: false, message: "no apply found for library" };
+  }
+  const pkgPath = import_node_path34.default.join(ctx.scanPath, "package.json");
+  if (await fileExists(pkgPath)) {
+    const pkg = await readPackageJson(ctx.scanPath);
+    if (pkg.dependencies?.[match.instrumentation_package]) {
+      const { [match.instrumentation_package]: _removed, ...rest } = pkg.dependencies;
+      pkg.dependencies = rest;
+      await import_node_fs21.promises.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
+    }
+  }
+  const hookFiles = await findHookFiles(ctx.scanPath);
+  for (const file of hookFiles) {
+    const filePath = import_node_path34.default.join(ctx.scanPath, file);
+    const content = await import_node_fs21.promises.readFile(filePath, "utf8");
+    if (content.includes(match.registration_snippet)) {
+      const filtered = content.split("\n").filter((line) => !line.includes(match.registration_snippet)).join("\n");
+      await import_node_fs21.promises.writeFile(filePath, filtered, "utf8");
+      break;
+    }
   }
-  return `${inc.driver}@${inc.driverVersion} vs ${inc.engine} ${inc.engineVersion} \u2014 ${inc.reason}`;
+  return {
+    undone: true,
+    message: `rolled back ${match.library} (${match.instrumentation_package})`
+  };
 }
 
-// src/watch.ts
-init_cjs_shims();
-var import_node_fs23 = __toESM(require("fs"), 1);
-var import_node_path38 = __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_types24 = require("@neat.is/types");
-
 // src/diff.ts
 init_cjs_shims();
-var import_node_fs20 = require("fs");
+var import_node_fs22 = require("fs");
 async function loadSnapshotForDiff(target) {
   if (/^https?:\/\//i.test(target)) {
     const res = await fetch(target);
@@ -5238,7 +5582,7 @@ async function loadSnapshotForDiff(target) {
     }
     return await res.json();
   }
-  const raw = await import_node_fs20.promises.readFile(target, "utf8");
+  const raw = await import_node_fs22.promises.readFile(target, "utf8");
   return JSON.parse(raw);
 }
 function indexEntries(entries) {
@@ -5306,23 +5650,23 @@ function canonicalJson(value) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_path35 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path33.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path33.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path33.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path33.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path33.default.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: import_node_path35.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path35.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path35.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path35.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path35.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: import_node_path33.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path33.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path33.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path33.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path33.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: import_node_path35.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path35.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path35.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path35.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path35.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -5358,25 +5702,25 @@ var Projects = class {
 
 // src/registry.ts
 init_cjs_shims();
-var import_node_fs21 = require("fs");
-var import_node_os2 = __toESM(require("os"), 1);
-var import_node_path34 = __toESM(require("path"), 1);
+var import_node_fs23 = require("fs");
+var import_node_os3 = __toESM(require("os"), 1);
+var import_node_path36 = __toESM(require("path"), 1);
 var import_types23 = 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_path34.default.resolve(override);
-  return import_node_path34.default.join(import_node_os2.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path36.default.resolve(override);
+  return import_node_path36.default.join(import_node_os3.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path34.default.join(neatHome(), "projects.json");
+  return import_node_path36.default.join(neatHome(), "projects.json");
 }
 function registryLockPath() {
-  return import_node_path34.default.join(neatHome(), "projects.json.lock");
+  return import_node_path36.default.join(neatHome(), "projects.json.lock");
 }
 function daemonPidPath() {
-  return import_node_path34.default.join(neatHome(), "neatd.pid");
+  return import_node_path36.default.join(neatHome(), "neatd.pid");
 }
 function isPidAliveDefault(pid) {
   try {
@@ -5388,7 +5732,7 @@ function isPidAliveDefault(pid) {
 }
 async function readPidFile(file) {
   try {
-    const raw = await import_node_fs21.promises.readFile(file, "utf8");
+    const raw = await import_node_fs23.promises.readFile(file, "utf8");
     const pid = Number.parseInt(raw.trim(), 10);
     return Number.isInteger(pid) && pid > 0 ? pid : void 0;
   } catch {
@@ -5436,32 +5780,32 @@ function lockHolderMessage(holder, lockPath, timeoutMs) {
   }
 }
 async function normalizeProjectPath(input) {
-  const resolved = import_node_path34.default.resolve(input);
+  const resolved = import_node_path36.default.resolve(input);
   try {
-    return await import_node_fs21.promises.realpath(resolved);
+    return await import_node_fs23.promises.realpath(resolved);
   } catch {
     return resolved;
   }
 }
 async function writeAtomically(target, contents) {
-  await import_node_fs21.promises.mkdir(import_node_path34.default.dirname(target), { recursive: true });
+  await import_node_fs23.promises.mkdir(import_node_path36.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_fs21.promises.open(tmp, "w");
+  const fd = await import_node_fs23.promises.open(tmp, "w");
   try {
     await fd.writeFile(contents, "utf8");
     await fd.sync();
   } finally {
     await fd.close();
   }
-  await import_node_fs21.promises.rename(tmp, target);
+  await import_node_fs23.promises.rename(tmp, target);
 }
 async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS, probe = defaultLockHolderProbe) {
   const deadline = Date.now() + timeoutMs;
-  await import_node_fs21.promises.mkdir(import_node_path34.default.dirname(lockPath), { recursive: true });
+  await import_node_fs23.promises.mkdir(import_node_path36.default.dirname(lockPath), { recursive: true });
   let probedHolder = false;
   while (true) {
     try {
-      const fd = await import_node_fs21.promises.open(lockPath, "wx");
+      const fd = await import_node_fs23.promises.open(lockPath, "wx");
       try {
         await fd.writeFile(`${process.pid}
 `, "utf8");
@@ -5486,7 +5830,7 @@ async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS, probe = defaul
   }
 }
 async function releaseLock(lockPath) {
-  await import_node_fs21.promises.unlink(lockPath).catch(() => {
+  await import_node_fs23.promises.unlink(lockPath).catch(() => {
   });
 }
 async function withLock(fn) {
@@ -5502,7 +5846,7 @@ async function readRegistry() {
   const file = registryPath();
   let raw;
   try {
-    raw = await import_node_fs21.promises.readFile(file, "utf8");
+    raw = await import_node_fs23.promises.readFile(file, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
       return { version: 1, projects: [] };
@@ -6043,6 +6387,105 @@ function registerRoutes(scope, ctx) {
       violations
     };
   });
+  scope.get("/extend/list-uninstrumented", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap);
+    if (!proj) return;
+    if (!proj.scanPath) {
+      return reply.code(409).send({ error: "scan path not configured for this project", project: proj.name });
+    }
+    try {
+      const results = await listUninstrumented({ project: proj.name, scanPath: proj.scanPath });
+      return { libraries: results };
+    } catch (err) {
+      return reply.code(500).send({ error: err.message });
+    }
+  });
+  scope.get("/extend/lookup", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap);
+    if (!proj) return;
+    const { library, version } = req.query;
+    if (!library) {
+      return reply.code(400).send({ error: "query parameter `library` is required" });
+    }
+    const result = lookupInstrumentation(library, version);
+    if (!result) {
+      return reply.code(404).send({ error: "library not found in registry", library });
+    }
+    return result;
+  });
+  scope.get("/extend/describe", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap);
+    if (!proj) return;
+    if (!proj.scanPath) {
+      return reply.code(409).send({ error: "scan path not configured for this project", project: proj.name });
+    }
+    try {
+      const state = await describeProjectInstrumentation({ project: proj.name, scanPath: proj.scanPath });
+      return state;
+    } catch (err) {
+      return reply.code(500).send({ error: err.message });
+    }
+  });
+  scope.post("/extend/apply", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap);
+    if (!proj) return;
+    if (!proj.scanPath) {
+      return reply.code(409).send({ error: "scan path not configured for this project", project: proj.name });
+    }
+    const { library, instrumentation_package, version, registration_snippet } = req.body ?? {};
+    if (!library || !instrumentation_package || !version || !registration_snippet) {
+      return reply.code(400).send({ error: "body must include library, instrumentation_package, version, registration_snippet" });
+    }
+    try {
+      const result = await applyExtension(
+        { project: proj.name, scanPath: proj.scanPath },
+        { library, instrumentation_package, version, registration_snippet }
+      );
+      return result;
+    } catch (err) {
+      return reply.code(500).send({ error: err.message });
+    }
+  });
+  scope.post("/extend/dry-run", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap);
+    if (!proj) return;
+    if (!proj.scanPath) {
+      return reply.code(409).send({ error: "scan path not configured for this project", project: proj.name });
+    }
+    const { library, instrumentation_package, version, registration_snippet } = req.body ?? {};
+    if (!library || !instrumentation_package || !version || !registration_snippet) {
+      return reply.code(400).send({ error: "body must include library, instrumentation_package, version, registration_snippet" });
+    }
+    try {
+      const result = await dryRunExtension(
+        { project: proj.name, scanPath: proj.scanPath },
+        { library, instrumentation_package, version, registration_snippet }
+      );
+      return result;
+    } catch (err) {
+      return reply.code(500).send({ error: err.message });
+    }
+  });
+  scope.post("/extend/rollback", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap);
+    if (!proj) return;
+    if (!proj.scanPath) {
+      return reply.code(409).send({ error: "scan path not configured for this project", project: proj.name });
+    }
+    const { library } = req.body ?? {};
+    if (!library) {
+      return reply.code(400).send({ error: "body must include library" });
+    }
+    try {
+      const result = await rollbackExtension(
+        { project: proj.name, scanPath: proj.scanPath },
+        { library }
+      );
+      return result;
+    } catch (err) {
+      return reply.code(500).send({ error: err.message });
+    }
+  });
 }
 async function buildApi(opts) {
   const app = (0, import_fastify.default)({ logger: false });
@@ -6154,8 +6597,8 @@ init_otel_grpc();
 
 // src/search.ts
 init_cjs_shims();
-var import_node_fs22 = require("fs");
-var import_node_path37 = __toESM(require("path"), 1);
+var import_node_fs24 = require("fs");
+var import_node_path39 = __toESM(require("path"), 1);
 var import_node_crypto3 = require("crypto");
 var DEFAULT_LIMIT = 10;
 var NOMIC_DIM = 768;
@@ -6285,7 +6728,7 @@ async function pickEmbedder() {
 }
 async function readCache(cachePath) {
   try {
-    const raw = await import_node_fs22.promises.readFile(cachePath, "utf8");
+    const raw = await import_node_fs24.promises.readFile(cachePath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.version !== 1) return null;
     return parsed;
@@ -6294,8 +6737,8 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, cache) {
-  await import_node_fs22.promises.mkdir(import_node_path37.default.dirname(cachePath), { recursive: true });
-  await import_node_fs22.promises.writeFile(cachePath, JSON.stringify(cache));
+  await import_node_fs24.promises.mkdir(import_node_path39.default.dirname(cachePath), { recursive: true });
+  await import_node_fs24.promises.writeFile(cachePath, JSON.stringify(cache));
 }
 var VectorIndex = class {
   constructor(embedder, cachePath) {
@@ -6450,8 +6893,8 @@ var ALL_PHASES = [
 ];
 function classifyChange(relPath) {
   const phases = /* @__PURE__ */ new Set();
-  const base = import_node_path38.default.basename(relPath).toLowerCase();
-  const segments = relPath.split(import_node_path38.default.sep).map((s) => s.toLowerCase());
+  const base = import_node_path40.default.basename(relPath).toLowerCase();
+  const segments = relPath.split(import_node_path40.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");
@@ -6559,16 +7002,16 @@ function countWatchableDirs(scanPath, limit) {
     if (count >= limit) return;
     let entries;
     try {
-      entries = import_node_fs23.default.readdirSync(dir, { withFileTypes: true });
+      entries = import_node_fs25.default.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     for (const e of entries) {
       if (count >= limit) return;
       if (!e.isDirectory()) continue;
-      if (IGNORED_WATCH_PATHS.some((re) => re.test(import_node_path38.default.join(dir, e.name) + import_node_path38.default.sep))) continue;
+      if (IGNORED_WATCH_PATHS.some((re) => re.test(import_node_path40.default.join(dir, e.name) + import_node_path40.default.sep))) continue;
       count++;
-      if (depth < 2) visit(import_node_path38.default.join(dir, e.name), depth + 1);
+      if (depth < 2) visit(import_node_path40.default.join(dir, e.name), depth + 1);
     }
   };
   visit(scanPath, 0);
@@ -6586,8 +7029,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_path38.default.join(opts.scanPath, "policy.json");
-  const policyViolationsPath = import_node_path38.default.join(import_node_path38.default.dirname(opts.outPath), "policy-violations.ndjson");
+  const policyFilePath = import_node_path40.default.join(opts.scanPath, "policy.json");
+  const policyViolationsPath = import_node_path40.default.join(import_node_path40.default.dirname(opts.outPath), "policy-violations.ndjson");
   let policies = [];
   try {
     policies = await loadPolicyFile(policyFilePath);
@@ -6638,7 +7081,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_path38.default.join(import_node_path38.default.dirname(opts.outPath), "embeddings.json");
+  const cachePath = opts.embeddingsCachePath ?? import_node_path40.default.join(import_node_path40.default.dirname(opts.outPath), "embeddings.json");
   let searchIndex;
   try {
     searchIndex = await buildSearchIndex(graph, { cachePath });
@@ -6656,7 +7099,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_path38.default.dirname(opts.outPath)),
+      ...pathsForProject(projectName, import_node_path40.default.dirname(opts.outPath)),
       snapshotPath: opts.outPath,
       errorsPath: opts.errorsPath,
       staleEventsPath: opts.staleEventsPath
@@ -6743,9 +7186,9 @@ async function startWatch(graph, opts) {
   };
   const onPath = (absPath) => {
     if (shouldIgnore(absPath)) return;
-    const rel = import_node_path38.default.relative(opts.scanPath, absPath);
+    const rel = import_node_path40.default.relative(opts.scanPath, absPath);
     if (!rel || rel.startsWith("..")) return;
-    pendingPaths.add(rel.split(import_node_path38.default.sep).join("/"));
+    pendingPaths.add(rel.split(import_node_path40.default.sep).join("/"));
     const phases = classifyChange(rel);
     if (phases.size === 0) {
       for (const p of ALL_PHASES) pending.add(p);
@@ -6799,16 +7242,16 @@ async function startWatch(graph, opts) {
 
 // src/deploy/detect.ts
 init_cjs_shims();
-var import_node_fs24 = require("fs");
-var import_node_path39 = __toESM(require("path"), 1);
-var import_node_child_process = require("child_process");
+var import_node_fs26 = require("fs");
+var import_node_path41 = __toESM(require("path"), 1);
+var import_node_child_process2 = require("child_process");
 var import_node_crypto4 = require("crypto");
 function generateToken() {
   return (0, import_node_crypto4.randomBytes)(32).toString("base64url");
 }
 async function probeBinary(binary, arg) {
   return new Promise((resolve) => {
-    const child = (0, import_node_child_process.spawn)(binary, [arg], { stdio: "ignore" });
+    const child = (0, import_node_child_process2.spawn)(binary, [arg], { stdio: "ignore" });
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
       resolve(false);
@@ -6900,21 +7343,21 @@ async function runDeploy(opts = {}) {
   const token = generateToken();
   switch (substrate) {
     case "docker-compose": {
-      const artifactPath = import_node_path39.default.join(cwd, "docker-compose.neat.yml");
+      const artifactPath = import_node_path41.default.join(cwd, "docker-compose.neat.yml");
       const contents = emitDockerCompose(cwd);
-      await import_node_fs24.promises.writeFile(artifactPath, contents, "utf8");
+      await import_node_fs26.promises.writeFile(artifactPath, contents, "utf8");
       return {
         substrate,
         artifactPath,
         token,
         contents,
-        startCommand: `NEAT_AUTH_TOKEN=${token} docker compose -f ${import_node_path39.default.basename(artifactPath)} up -d`
+        startCommand: `NEAT_AUTH_TOKEN=${token} docker compose -f ${import_node_path41.default.basename(artifactPath)} up -d`
       };
     }
     case "systemd": {
-      const artifactPath = import_node_path39.default.join(cwd, "neat.service");
+      const artifactPath = import_node_path41.default.join(cwd, "neat.service");
       const contents = emitSystemdUnit(cwd);
-      await import_node_fs24.promises.writeFile(artifactPath, contents, "utf8");
+      await import_node_fs26.promises.writeFile(artifactPath, contents, "utf8");
       return {
         substrate,
         artifactPath,
@@ -6947,8 +7390,9 @@ init_cjs_shims();
 
 // src/installers/javascript.ts
 init_cjs_shims();
-var import_node_fs25 = require("fs");
-var import_node_path40 = __toESM(require("path"), 1);
+var import_node_fs27 = require("fs");
+var import_node_path42 = __toESM(require("path"), 1);
+var import_semver2 = __toESM(require("semver"), 1);
 
 // src/installers/templates.ts
 init_cjs_shims();
@@ -7485,15 +7929,15 @@ var OTEL_ENV = {
   value: "http://localhost:4318/projects/<project>/v1/traces"
 };
 function serviceNodeName(pkg, serviceDir) {
-  return pkg.name ?? import_node_path40.default.basename(serviceDir);
+  return pkg.name ?? import_node_path42.default.basename(serviceDir);
 }
 function projectToken(pkg, serviceDir, project) {
   if (project && project.length > 0) return project;
-  return pkg.name ?? import_node_path40.default.basename(serviceDir);
+  return pkg.name ?? import_node_path42.default.basename(serviceDir);
 }
 async function readJsonFile(p) {
   try {
-    const raw = await import_node_fs25.promises.readFile(p, "utf8");
+    const raw = await import_node_fs27.promises.readFile(p, "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -7502,26 +7946,33 @@ 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_path40.default.join(pkgRoot, "app.json"));
+  const appJson = await readJsonFile(import_node_path42.default.join(pkgRoot, "app.json"));
   if (appJson && typeof appJson === "object" && "expo" in appJson) {
     return "react-native";
   }
-  if (await exists2(import_node_path40.default.join(pkgRoot, "vite.config.js")) || await exists2(import_node_path40.default.join(pkgRoot, "vite.config.ts")) || await exists2(import_node_path40.default.join(pkgRoot, "vite.config.mjs")) || "vite" in deps) {
+  if (await exists3(import_node_path42.default.join(pkgRoot, "vite.config.js")) || await exists3(import_node_path42.default.join(pkgRoot, "vite.config.ts")) || await exists3(import_node_path42.default.join(pkgRoot, "vite.config.mjs")) || "vite" in deps) {
     return "browser-bundle";
   }
+  if (await exists3(import_node_path42.default.join(pkgRoot, "wrangler.toml"))) return "cloudflare-workers";
+  if (await exists3(import_node_path42.default.join(pkgRoot, "bun.lockb"))) return "bun";
+  if (await exists3(import_node_path42.default.join(pkgRoot, "deno.json")) || await exists3(import_node_path42.default.join(pkgRoot, "deno.lock"))) {
+    return "deno";
+  }
+  const engines = pkg.engines ?? {};
+  if ("electron" in engines) return "electron";
   return "node";
 }
-async function readPackageJson(serviceDir) {
+async function readPackageJson2(serviceDir) {
   try {
-    const raw = await import_node_fs25.promises.readFile(import_node_path40.default.join(serviceDir, "package.json"), "utf8");
+    const raw = await import_node_fs27.promises.readFile(import_node_path42.default.join(serviceDir, "package.json"), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
   }
 }
-async function exists2(p) {
+async function exists3(p) {
   try {
-    await import_node_fs25.promises.stat(p);
+    await import_node_fs27.promises.stat(p);
     return true;
   } catch {
     return false;
@@ -7529,7 +7980,7 @@ async function exists2(p) {
 }
 async function readFileMaybe(p) {
   try {
-    return await import_node_fs25.promises.readFile(p, "utf8");
+    return await import_node_fs27.promises.readFile(p, "utf8");
   } catch {
     return null;
   }
@@ -7545,14 +7996,20 @@ async function planOtelInitGeneration(file, contents) {
   return null;
 }
 async function detect(serviceDir) {
-  const pkg = await readPackageJson(serviceDir);
+  const pkg = await readPackageJson2(serviceDir);
   return pkg !== null && typeof pkg.name === "string";
 }
+function needsVersionUpgrade(installed, expected) {
+  return !import_semver2.default.satisfies(
+    import_semver2.default.minVersion(installed)?.version ?? installed,
+    expected
+  ) && !import_semver2.default.intersects(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_path40.default.join(serviceDir, name);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, name);
+    if (await exists3(candidate)) return candidate;
   }
   return null;
 }
@@ -7578,8 +8035,8 @@ function hasRemixDependency(pkg) {
 }
 async function findRemixEntry(serviceDir) {
   for (const rel of REMIX_ENTRY_CANDIDATES) {
-    const candidate = import_node_path40.default.join(serviceDir, rel);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, rel);
+    if (await exists3(candidate)) return candidate;
   }
   return null;
 }
@@ -7590,15 +8047,15 @@ function hasSvelteKitDependency(pkg) {
 }
 async function findSvelteKitHooks(serviceDir) {
   for (const rel of SVELTEKIT_HOOKS_CANDIDATES) {
-    const candidate = import_node_path40.default.join(serviceDir, rel);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.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_path40.default.join(serviceDir, rel);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, rel);
+    if (await exists3(candidate)) return candidate;
   }
   return null;
 }
@@ -7608,8 +8065,8 @@ function hasNuxtDependency(pkg) {
 }
 async function findNuxtConfig(serviceDir) {
   for (const name of NUXT_CONFIG_CANDIDATES) {
-    const candidate = import_node_path40.default.join(serviceDir, name);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, name);
+    if (await exists3(candidate)) return candidate;
   }
   return null;
 }
@@ -7619,8 +8076,8 @@ function hasAstroDependency(pkg) {
 }
 async function findAstroConfig(serviceDir) {
   for (const name of ASTRO_CONFIG_CANDIDATES) {
-    const candidate = import_node_path40.default.join(serviceDir, name);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, name);
+    if (await exists3(candidate)) return candidate;
   }
   return null;
 }
@@ -7633,7 +8090,7 @@ function parseNextMajor(range) {
   return Number.isFinite(n) ? n : null;
 }
 async function isTypeScriptProject(serviceDir) {
-  return exists2(import_node_path40.default.join(serviceDir, "tsconfig.json"));
+  return exists3(import_node_path42.default.join(serviceDir, "tsconfig.json"));
 }
 var INDEX_EXTENSIONS = [".ts", ".tsx", ".js", ".mjs", ".cjs"];
 var INDEX_CANDIDATES = INDEX_EXTENSIONS.map((ext) => `index${ext}`);
@@ -7679,8 +8136,8 @@ function entryFromScript(script) {
 }
 async function resolveEntry(serviceDir, pkg) {
   if (typeof pkg.main === "string" && pkg.main.length > 0) {
-    const candidate = import_node_path40.default.resolve(serviceDir, pkg.main);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.resolve(serviceDir, pkg.main);
+    if (await exists3(candidate)) return candidate;
   }
   if (pkg.bin) {
     let binEntry;
@@ -7693,36 +8150,36 @@ async function resolveEntry(serviceDir, pkg) {
       if (typeof first === "string") binEntry = first;
     }
     if (binEntry) {
-      const candidate = import_node_path40.default.resolve(serviceDir, binEntry);
-      if (await exists2(candidate)) return candidate;
+      const candidate = import_node_path42.default.resolve(serviceDir, binEntry);
+      if (await exists3(candidate)) return candidate;
     }
   }
   const startEntry = entryFromScript(pkg.scripts?.start);
   if (startEntry) {
-    const candidate = import_node_path40.default.resolve(serviceDir, startEntry);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.resolve(serviceDir, startEntry);
+    if (await exists3(candidate)) return candidate;
   }
   const devEntry = entryFromScript(pkg.scripts?.dev);
   if (devEntry) {
-    const candidate = import_node_path40.default.resolve(serviceDir, devEntry);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.resolve(serviceDir, devEntry);
+    if (await exists3(candidate)) return candidate;
   }
   for (const rel of SRC_INDEX_CANDIDATES) {
-    const candidate = import_node_path40.default.join(serviceDir, rel);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, rel);
+    if (await exists3(candidate)) return candidate;
   }
   for (const rel of SRC_NAMED_CANDIDATES) {
-    const candidate = import_node_path40.default.join(serviceDir, rel);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, rel);
+    if (await exists3(candidate)) return candidate;
   }
   for (const name of INDEX_CANDIDATES) {
-    const candidate = import_node_path40.default.join(serviceDir, name);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.default.join(serviceDir, name);
+    if (await exists3(candidate)) return candidate;
   }
   return null;
 }
 function dispatchEntry(entryFile, pkg) {
-  const ext = import_node_path40.default.extname(entryFile).toLowerCase();
+  const ext = import_node_path42.default.extname(entryFile).toLowerCase();
   if (ext === ".ts" || ext === ".tsx") return "ts";
   if (ext === ".mjs") return "esm";
   if (ext === ".cjs") return "cjs";
@@ -7739,9 +8196,9 @@ function otelInitContents(flavor) {
   return OTEL_INIT_CJS;
 }
 function injectionLine(flavor, entryFile, otelInitFile) {
-  let rel = import_node_path40.default.relative(import_node_path40.default.dirname(entryFile), otelInitFile);
+  let rel = import_node_path42.default.relative(import_node_path42.default.dirname(entryFile), otelInitFile);
   if (!rel.startsWith(".")) rel = `./${rel}`;
-  rel = rel.split(import_node_path40.default.sep).join("/");
+  rel = rel.split(import_node_path42.default.sep).join("/");
   if (flavor === "cjs") return `require('${rel}')`;
   if (flavor === "esm") return `import '${rel}'`;
   const tsRel = rel.replace(/\.ts$/, "");
@@ -7754,56 +8211,56 @@ function lineIsOtelInjection(line) {
 }
 async function detectsSrcLayout(serviceDir) {
   const [hasSrcApp, hasSrcPages, hasRootApp, hasRootPages] = await Promise.all([
-    exists2(import_node_path40.default.join(serviceDir, "src", "app")),
-    exists2(import_node_path40.default.join(serviceDir, "src", "pages")),
-    exists2(import_node_path40.default.join(serviceDir, "app")),
-    exists2(import_node_path40.default.join(serviceDir, "pages"))
+    exists3(import_node_path42.default.join(serviceDir, "src", "app")),
+    exists3(import_node_path42.default.join(serviceDir, "src", "pages")),
+    exists3(import_node_path42.default.join(serviceDir, "app")),
+    exists3(import_node_path42.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_path40.default.join(serviceDir, "src") : serviceDir;
-  const instrumentationFile = import_node_path40.default.join(baseDir, useTs ? "instrumentation.ts" : "instrumentation.js");
-  const instrumentationNodeFile = import_node_path40.default.join(
+  const baseDir = srcLayout ? import_node_path42.default.join(serviceDir, "src") : serviceDir;
+  const instrumentationFile = import_node_path42.default.join(baseDir, useTs ? "instrumentation.ts" : "instrumentation.js");
+  const instrumentationNodeFile = import_node_path42.default.join(
     baseDir,
     useTs ? "instrumentation.node.ts" : "instrumentation.node.js"
   );
-  const envNeatFile = import_node_path40.default.join(baseDir, ".env.neat");
+  const envNeatFile = import_node_path42.default.join(baseDir, ".env.neat");
   const existingDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
   const dependencyEdits = [];
   for (const sdk of SDK_PACKAGES) {
-    if (sdk.name in existingDeps) continue;
-    dependencyEdits.push({
-      file: manifestPath,
-      kind: "add",
-      name: sdk.name,
-      version: sdk.version
-    });
+    if (sdk.name in existingDeps) {
+      if (needsVersionUpgrade(existingDeps[sdk.name], sdk.version)) {
+        dependencyEdits.push({ file: manifestPath, kind: "upgrade", name: sdk.name, version: sdk.version, fromVersion: existingDeps[sdk.name] });
+      }
+      continue;
+    }
+    dependencyEdits.push({ file: manifestPath, kind: "add", name: sdk.name, version: sdk.version });
   }
   const nonBundled = detectNonBundledInstrumentations(pkg);
   for (const inst of nonBundled) {
-    if (inst.pkg in existingDeps) continue;
-    dependencyEdits.push({
-      file: manifestPath,
-      kind: "add",
-      name: inst.pkg,
-      version: inst.version
-    });
+    if (inst.pkg in existingDeps) {
+      if (needsVersionUpgrade(existingDeps[inst.pkg], inst.version)) {
+        dependencyEdits.push({ file: manifestPath, kind: "upgrade", name: inst.pkg, version: inst.version, fromVersion: existingDeps[inst.pkg] });
+      }
+      continue;
+    }
+    dependencyEdits.push({ file: manifestPath, kind: "add", name: inst.pkg, version: inst.version });
   }
   const svcName = serviceNodeName(pkg, serviceDir);
   const projectName = projectToken(pkg, serviceDir, project);
   const registrations = nonBundled.map((i) => i.registration);
   const generatedFiles = [];
-  if (!await exists2(instrumentationFile)) {
+  if (!await exists3(instrumentationFile)) {
     generatedFiles.push({
       file: instrumentationFile,
       contents: useTs ? NEXT_INSTRUMENTATION_TS : NEXT_INSTRUMENTATION_JS,
       skipIfExists: true
     });
   }
-  if (!await exists2(instrumentationNodeFile)) {
+  if (!await exists3(instrumentationNodeFile)) {
     generatedFiles.push({
       file: instrumentationNodeFile,
       contents: renderNextInstrumentationNode(
@@ -7815,7 +8272,7 @@ async function planNext(serviceDir, pkg, manifestPath, nextConfigPath, project)
       skipIfExists: true
     });
   }
-  if (!await exists2(envNeatFile)) {
+  if (!await exists3(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
       contents: renderEnvNeat(svcName, projectName),
@@ -7827,7 +8284,7 @@ async function planNext(serviceDir, pkg, manifestPath, nextConfigPath, project)
   const nextMajor = parseNextMajor(nextRange);
   if (nextMajor !== null && nextMajor < 15) {
     try {
-      const raw = await import_node_fs25.promises.readFile(nextConfigPath, "utf8");
+      const raw = await import_node_fs27.promises.readFile(nextConfigPath, "utf8");
       if (!raw.includes("instrumentationHook")) {
         nextConfigEdit = {
           file: nextConfigPath,
@@ -7875,8 +8332,8 @@ function buildDependencyEdits(pkg, manifestPath) {
   return edits;
 }
 async function queueEnvNeat(serviceDir, pkg, project, generatedFiles) {
-  const envNeatFile = import_node_path40.default.join(serviceDir, ".env.neat");
-  if (!await exists2(envNeatFile)) {
+  const envNeatFile = import_node_path42.default.join(serviceDir, ".env.neat");
+  if (!await exists3(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
       contents: renderEnvNeat(
@@ -7910,13 +8367,13 @@ function fileImportsOtelHook(raw, specifiers) {
 }
 async function planRemix(serviceDir, pkg, manifestPath, entryFile, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelServerFile = import_node_path40.default.join(
+  const otelServerFile = import_node_path42.default.join(
     serviceDir,
     useTs ? "app/otel.server.ts" : "app/otel.server.js"
   );
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
-  if (!await exists2(otelServerFile)) {
+  if (!await exists3(otelServerFile)) {
     generatedFiles.push({
       file: otelServerFile,
       contents: renderFrameworkOtelInitForPkg(
@@ -7931,7 +8388,7 @@ async function planRemix(serviceDir, pkg, manifestPath, entryFile, project) {
   await queueEnvNeat(serviceDir, pkg, project, generatedFiles);
   const entrypointEdits = [];
   try {
-    const raw = await import_node_fs25.promises.readFile(entryFile, "utf8");
+    const raw = await import_node_fs27.promises.readFile(entryFile, "utf8");
     if (!fileImportsOtelHook(raw, ["./otel.server"])) {
       const lines = raw.split(/\r?\n/);
       const firstReal = lines[0]?.startsWith("#!") ? lines[1] ?? "" : lines[0] ?? "";
@@ -7967,15 +8424,15 @@ 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_path40.default.join(
+  const otelInitFile = import_node_path42.default.join(
     serviceDir,
     useTs ? "src/otel-init.ts" : "src/otel-init.js"
   );
-  const resolvedHooksFile = hooksFile ?? import_node_path40.default.join(serviceDir, useTs ? "src/hooks.server.ts" : "src/hooks.server.js");
+  const resolvedHooksFile = hooksFile ?? import_node_path42.default.join(serviceDir, useTs ? "src/hooks.server.ts" : "src/hooks.server.js");
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
   const entrypointEdits = [];
-  if (!await exists2(otelInitFile)) {
+  if (!await exists3(otelInitFile)) {
     generatedFiles.push({
       file: otelInitFile,
       contents: renderFrameworkOtelInitForPkg(
@@ -7996,7 +8453,7 @@ async function planSvelteKit(serviceDir, pkg, manifestPath, hooksFile, project)
     });
   } else {
     try {
-      const raw = await import_node_fs25.promises.readFile(hooksFile, "utf8");
+      const raw = await import_node_fs27.promises.readFile(hooksFile, "utf8");
       if (!fileImportsOtelHook(raw, ["./otel-init"])) {
         const lines = raw.split(/\r?\n/);
         const firstReal = lines[0]?.startsWith("#!") ? lines[1] ?? "" : lines[0] ?? "";
@@ -8033,17 +8490,17 @@ async function planSvelteKit(serviceDir, pkg, manifestPath, hooksFile, project)
 }
 async function planNuxt(serviceDir, pkg, manifestPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelPluginFile = import_node_path40.default.join(
+  const otelPluginFile = import_node_path42.default.join(
     serviceDir,
     useTs ? "server/plugins/otel.ts" : "server/plugins/otel.js"
   );
-  const otelInitFile = import_node_path40.default.join(
+  const otelInitFile = import_node_path42.default.join(
     serviceDir,
     useTs ? "server/plugins/otel-init.ts" : "server/plugins/otel-init.js"
   );
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
-  if (!await exists2(otelInitFile)) {
+  if (!await exists3(otelInitFile)) {
     generatedFiles.push({
       file: otelInitFile,
       contents: renderFrameworkOtelInitForPkg(
@@ -8055,7 +8512,7 @@ async function planNuxt(serviceDir, pkg, manifestPath, project) {
       skipIfExists: true
     });
   }
-  if (!await exists2(otelPluginFile)) {
+  if (!await exists3(otelPluginFile)) {
     generatedFiles.push({
       file: otelPluginFile,
       contents: useTs ? NUXT_OTEL_PLUGIN_TS : NUXT_OTEL_PLUGIN_JS,
@@ -8088,23 +8545,23 @@ 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_path40.default.join(serviceDir, rel);
-    if (await exists2(candidate)) return candidate;
+    const candidate = import_node_path42.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_path40.default.join(
+  const otelInitFile = import_node_path42.default.join(
     serviceDir,
     useTs ? "src/otel-init.ts" : "src/otel-init.js"
   );
   const existingMiddleware = await findAstroMiddleware(serviceDir);
-  const middlewareFile = existingMiddleware ?? import_node_path40.default.join(serviceDir, useTs ? "src/middleware.ts" : "src/middleware.js");
+  const middlewareFile = existingMiddleware ?? import_node_path42.default.join(serviceDir, useTs ? "src/middleware.ts" : "src/middleware.js");
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
   const entrypointEdits = [];
-  if (!await exists2(otelInitFile)) {
+  if (!await exists3(otelInitFile)) {
     generatedFiles.push({
       file: otelInitFile,
       contents: renderFrameworkOtelInitForPkg(
@@ -8125,7 +8582,7 @@ async function planAstro(serviceDir, pkg, manifestPath, project) {
     });
   } else {
     try {
-      const raw = await import_node_fs25.promises.readFile(existingMiddleware, "utf8");
+      const raw = await import_node_fs27.promises.readFile(existingMiddleware, "utf8");
       if (!fileImportsOtelHook(raw, ["./otel-init"])) {
         const lines = raw.split(/\r?\n/);
         const firstReal = lines[0]?.startsWith("#!") ? lines[1] ?? "" : lines[0] ?? "";
@@ -8195,8 +8652,8 @@ async function findFrameworkDispatch(serviceDir, pkg, manifestPath, project) {
   return null;
 }
 async function plan(serviceDir, opts) {
-  const pkg = await readPackageJson(serviceDir);
-  const manifestPath = import_node_path40.default.join(serviceDir, "package.json");
+  const pkg = await readPackageJson2(serviceDir);
+  const manifestPath = import_node_path42.default.join(serviceDir, "package.json");
   const project = opts?.project;
   const empty = {
     language: "javascript",
@@ -8231,32 +8688,32 @@ async function plan(serviceDir, opts) {
     return { ...empty, libOnly: true };
   }
   const flavor = dispatchEntry(entryFile, pkg);
-  const otelInitFile = import_node_path40.default.join(import_node_path40.default.dirname(entryFile), otelInitFilename(flavor));
-  const envNeatFile = import_node_path40.default.join(serviceDir, ".env.neat");
+  const otelInitFile = import_node_path42.default.join(import_node_path42.default.dirname(entryFile), otelInitFilename(flavor));
+  const envNeatFile = import_node_path42.default.join(serviceDir, ".env.neat");
   const existingDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
   const dependencyEdits = [];
   for (const sdk of SDK_PACKAGES) {
-    if (sdk.name in existingDeps) continue;
-    dependencyEdits.push({
-      file: manifestPath,
-      kind: "add",
-      name: sdk.name,
-      version: sdk.version
-    });
+    if (sdk.name in existingDeps) {
+      if (needsVersionUpgrade(existingDeps[sdk.name], sdk.version)) {
+        dependencyEdits.push({ file: manifestPath, kind: "upgrade", name: sdk.name, version: sdk.version, fromVersion: existingDeps[sdk.name] });
+      }
+      continue;
+    }
+    dependencyEdits.push({ file: manifestPath, kind: "add", name: sdk.name, version: sdk.version });
   }
   const nonBundled = detectNonBundledInstrumentations(pkg);
   for (const inst of nonBundled) {
-    if (inst.pkg in existingDeps) continue;
-    dependencyEdits.push({
-      file: manifestPath,
-      kind: "add",
-      name: inst.pkg,
-      version: inst.version
-    });
+    if (inst.pkg in existingDeps) {
+      if (needsVersionUpgrade(existingDeps[inst.pkg], inst.version)) {
+        dependencyEdits.push({ file: manifestPath, kind: "upgrade", name: inst.pkg, version: inst.version, fromVersion: existingDeps[inst.pkg] });
+      }
+      continue;
+    }
+    dependencyEdits.push({ file: manifestPath, kind: "add", name: inst.pkg, version: inst.version });
   }
   const entrypointEdits = [];
   try {
-    const raw = await import_node_fs25.promises.readFile(entryFile, "utf8");
+    const raw = await import_node_fs27.promises.readFile(entryFile, "utf8");
     const lines = raw.split(/\r?\n/);
     const firstReal = lines[0]?.startsWith("#!") ? lines[1] ?? "" : lines[0] ?? "";
     if (!lineIsOtelInjection(firstReal)) {
@@ -8279,7 +8736,7 @@ async function plan(serviceDir, opts) {
     renderNodeOtelInit(otelInitContents(flavor), svcName, projectName, registrations)
   );
   if (otelInitGen) generatedFiles.push(otelInitGen);
-  if (!await exists2(envNeatFile)) {
+  if (!await exists3(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
       contents: renderEnvNeat(svcName, projectName),
@@ -8301,13 +8758,13 @@ async function plan(serviceDir, opts) {
   };
 }
 function isAllowedWritePath(serviceDir, target) {
-  const rel = import_node_path40.default.relative(serviceDir, target);
+  const rel = import_node_path42.default.relative(serviceDir, target);
   if (rel.startsWith("..")) return false;
-  const base = import_node_path40.default.basename(target);
+  const base = import_node_path42.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_path40.default.sep).join("/");
+  const relPosix = rel.split(import_node_path42.default.sep).join("/");
   if (/^instrumentation(?:\.node)?\.(?:js|cjs|mjs|ts)$/.test(base)) {
     if (relPosix === base) return true;
     if (relPosix === `src/${base}`) return true;
@@ -8324,10 +8781,10 @@ function isAllowedWritePath(serviceDir, target) {
   return false;
 }
 async function writeAtomic(file, contents) {
-  await import_node_fs25.promises.mkdir(import_node_path40.default.dirname(file), { recursive: true });
+  await import_node_fs27.promises.mkdir(import_node_path42.default.dirname(file), { recursive: true });
   const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
-  await import_node_fs25.promises.writeFile(tmp, contents, "utf8");
-  await import_node_fs25.promises.rename(tmp, file);
+  await import_node_fs27.promises.writeFile(tmp, contents, "utf8");
+  await import_node_fs27.promises.rename(tmp, file);
 }
 async function apply(installPlan) {
   const { serviceDir } = installPlan;
@@ -8355,6 +8812,28 @@ async function apply(installPlan) {
       writtenFiles: []
     };
   }
+  if (installPlan.runtimeKind === "bun") {
+    return { serviceDir, outcome: "bun", reason: "Bun runtime; use BYO-OTel", writtenFiles: [] };
+  }
+  if (installPlan.runtimeKind === "deno") {
+    return { serviceDir, outcome: "deno", reason: "Deno runtime; use BYO-OTel", writtenFiles: [] };
+  }
+  if (installPlan.runtimeKind === "cloudflare-workers") {
+    return {
+      serviceDir,
+      outcome: "cloudflare-workers",
+      reason: "Cloudflare Workers runtime; use BYO-OTel",
+      writtenFiles: []
+    };
+  }
+  if (installPlan.runtimeKind === "electron") {
+    return {
+      serviceDir,
+      outcome: "electron",
+      reason: "Electron; use BYO-OTel",
+      writtenFiles: []
+    };
+  }
   if (installPlan.dependencyEdits.length === 0 && installPlan.entrypointEdits.length === 0 && (installPlan.generatedFiles?.length ?? 0) === 0 && installPlan.nextConfigEdit === void 0) {
     return {
       serviceDir,
@@ -8379,9 +8858,9 @@ async function apply(installPlan) {
   const originals = /* @__PURE__ */ new Map();
   const createdFiles = [];
   for (const target of allTargets) {
-    if (await exists2(target)) {
+    if (await exists3(target)) {
       try {
-        originals.set(target, await import_node_fs25.promises.readFile(target, "utf8"));
+        originals.set(target, await import_node_fs27.promises.readFile(target, "utf8"));
       } catch {
       }
     }
@@ -8405,6 +8884,8 @@ async function apply(installPlan) {
           if (!(dep.name in (pkg.dependencies ?? {}))) {
             pkg.dependencies[dep.name] = dep.version;
           }
+        } else if (dep.kind === "upgrade") {
+          pkg.dependencies[dep.name] = dep.version;
         } else {
           delete pkg.dependencies[dep.name];
         }
@@ -8414,7 +8895,7 @@ async function apply(installPlan) {
       writtenFiles.push(file);
     }
     for (const gen of installPlan.generatedFiles ?? []) {
-      if (gen.skipIfExists && await exists2(gen.file)) {
+      if (gen.skipIfExists && await exists3(gen.file)) {
         continue;
       }
       await writeAtomic(gen.file, gen.contents);
@@ -8462,14 +8943,14 @@ async function rollback(installPlan, originals, createdFiles) {
   const removed = [];
   for (const [file, raw] of originals.entries()) {
     try {
-      await import_node_fs25.promises.writeFile(file, raw, "utf8");
+      await import_node_fs27.promises.writeFile(file, raw, "utf8");
       restored.push(file);
     } catch {
     }
   }
   for (const file of createdFiles) {
     try {
-      await import_node_fs25.promises.unlink(file);
+      await import_node_fs27.promises.unlink(file);
       removed.push(file);
     } catch {
     }
@@ -8484,8 +8965,8 @@ async function rollback(installPlan, originals, createdFiles) {
     ...removed.map((f) => `removed:  ${f}`),
     ""
   ];
-  const rollbackPath = import_node_path40.default.join(installPlan.serviceDir, "neat-rollback.patch");
-  await import_node_fs25.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
+  const rollbackPath = import_node_path42.default.join(installPlan.serviceDir, "neat-rollback.patch");
+  await import_node_fs27.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 function injectInstrumentationHook(raw) {
   if (raw.includes("instrumentationHook")) return raw;
@@ -8514,8 +8995,8 @@ var javascriptInstaller = {
 
 // src/installers/python.ts
 init_cjs_shims();
-var import_node_fs26 = require("fs");
-var import_node_path41 = __toESM(require("path"), 1);
+var import_node_fs28 = require("fs");
+var import_node_path43 = __toESM(require("path"), 1);
 var SDK_PACKAGES2 = [
   { name: "opentelemetry-distro", version: ">=0.49b0" },
   { name: "opentelemetry-exporter-otlp", version: ">=1.28.0" }
@@ -8525,9 +9006,9 @@ var OTEL_ENV2 = {
   key: "OTEL_EXPORTER_OTLP_ENDPOINT",
   value: "http://localhost:4318"
 };
-async function exists3(p) {
+async function exists4(p) {
   try {
-    await import_node_fs26.promises.stat(p);
+    await import_node_fs28.promises.stat(p);
     return true;
   } catch {
     return false;
@@ -8536,7 +9017,7 @@ async function exists3(p) {
 async function detect2(serviceDir) {
   const markers = ["requirements.txt", "pyproject.toml", "setup.py"];
   for (const m of markers) {
-    if (await exists3(import_node_path41.default.join(serviceDir, m))) return true;
+    if (await exists4(import_node_path43.default.join(serviceDir, m))) return true;
   }
   return false;
 }
@@ -8546,9 +9027,9 @@ function reqPackageName(line) {
   return head.replace(/[<>=!~].*$/, "").toLowerCase();
 }
 async function planRequirementsTxtEdits(serviceDir) {
-  const file = import_node_path41.default.join(serviceDir, "requirements.txt");
-  if (!await exists3(file)) return null;
-  const raw = await import_node_fs26.promises.readFile(file, "utf8");
+  const file = import_node_path43.default.join(serviceDir, "requirements.txt");
+  if (!await exists4(file)) return null;
+  const raw = await import_node_fs28.promises.readFile(file, "utf8");
   const presentNames = new Set(
     raw.split(/\r?\n/).map(reqPackageName).filter((n) => n.length > 0)
   );
@@ -8556,9 +9037,9 @@ async function planRequirementsTxtEdits(serviceDir) {
   return { manifest: file, missing: [...missing] };
 }
 async function planProcfileEdits(serviceDir) {
-  const procfile = import_node_path41.default.join(serviceDir, "Procfile");
-  if (!await exists3(procfile)) return [];
-  const raw = await import_node_fs26.promises.readFile(procfile, "utf8");
+  const procfile = import_node_path43.default.join(serviceDir, "Procfile");
+  if (!await exists4(procfile)) return [];
+  const raw = await import_node_fs28.promises.readFile(procfile, "utf8");
   const edits = [];
   for (const line of raw.split(/\r?\n/)) {
     if (line.length === 0) continue;
@@ -8610,8 +9091,8 @@ async function applyRequirementsTxt(manifest, edits, original) {
   const next = `${original}${trailing}${newlines.join("\n")}
 `;
   const tmp = `${manifest}.${process.pid}.${Date.now()}.tmp`;
-  await import_node_fs26.promises.writeFile(tmp, next, "utf8");
-  await import_node_fs26.promises.rename(tmp, manifest);
+  await import_node_fs28.promises.writeFile(tmp, next, "utf8");
+  await import_node_fs28.promises.rename(tmp, manifest);
 }
 async function applyProcfile(procfile, edits, original) {
   let next = original;
@@ -8620,8 +9101,8 @@ async function applyProcfile(procfile, edits, original) {
     next = next.replace(e.before, e.after);
   }
   const tmp = `${procfile}.${process.pid}.${Date.now()}.tmp`;
-  await import_node_fs26.promises.writeFile(tmp, next, "utf8");
-  await import_node_fs26.promises.rename(tmp, procfile);
+  await import_node_fs28.promises.writeFile(tmp, next, "utf8");
+  await import_node_fs28.promises.rename(tmp, procfile);
 }
 async function apply2(installPlan) {
   const { serviceDir } = installPlan;
@@ -8634,7 +9115,7 @@ async function apply2(installPlan) {
   const originals = /* @__PURE__ */ new Map();
   for (const file of touched) {
     try {
-      originals.set(file, await import_node_fs26.promises.readFile(file, "utf8"));
+      originals.set(file, await import_node_fs28.promises.readFile(file, "utf8"));
     } catch {
     }
   }
@@ -8645,7 +9126,7 @@ async function apply2(installPlan) {
       if (raw === void 0) {
         throw new Error(`python installer: cannot read ${file} during apply`);
       }
-      const base = import_node_path41.default.basename(file);
+      const base = import_node_path43.default.basename(file);
       if (base === "requirements.txt") {
         const edits = installPlan.dependencyEdits.filter((e) => e.file === file);
         if (edits.length > 0) {
@@ -8670,7 +9151,7 @@ async function rollback2(installPlan, originals) {
   const restored = [];
   for (const [file, raw] of originals.entries()) {
     try {
-      await import_node_fs26.promises.writeFile(file, raw, "utf8");
+      await import_node_fs28.promises.writeFile(file, raw, "utf8");
       restored.push(file);
     } catch {
     }
@@ -8684,8 +9165,8 @@ async function rollback2(installPlan, originals) {
     ...restored.map((f) => `restored: ${f}`),
     ""
   ];
-  const rollbackPath = import_node_path41.default.join(installPlan.serviceDir, "neat-rollback.patch");
-  await import_node_fs26.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
+  const rollbackPath = import_node_path43.default.join(installPlan.serviceDir, "neat-rollback.patch");
+  await import_node_fs28.promises.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 var pythonInstaller = {
   name: "python",
@@ -8808,100 +9289,19 @@ function renderPatch(sections) {
 
 // src/orchestrator.ts
 init_cjs_shims();
-var import_node_fs28 = require("fs");
+var import_node_fs29 = require("fs");
 var import_node_http = __toESM(require("http"), 1);
 var import_node_net = __toESM(require("net"), 1);
-var import_node_path43 = __toESM(require("path"), 1);
+var import_node_path44 = __toESM(require("path"), 1);
 var import_node_child_process3 = require("child_process");
 var import_node_readline = __toESM(require("readline"), 1);
-
-// src/installers/package-manager.ts
-init_cjs_shims();
-var import_node_fs27 = require("fs");
-var import_node_path42 = __toESM(require("path"), 1);
-var import_node_child_process2 = require("child_process");
-var LOCKFILE_PRIORITY = [
-  { lockfile: "bun.lockb", pm: "bun", args: ["install", "--no-summary"] },
-  { lockfile: "pnpm-lock.yaml", pm: "pnpm", args: ["install", "--no-summary"] },
-  { lockfile: "yarn.lock", pm: "yarn", args: ["install", "--silent"] },
-  {
-    lockfile: "package-lock.json",
-    pm: "npm",
-    args: ["install", "--no-audit", "--no-fund", "--prefer-offline"]
-  }
-];
-var NPM_FALLBACK_ARGS = ["install", "--no-audit", "--no-fund", "--prefer-offline"];
-async function exists4(p) {
-  try {
-    await import_node_fs27.promises.access(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function detectPackageManager(serviceDir) {
-  let dir = import_node_path42.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_path42.default.join(dir, candidate.lockfile);
-      if (await exists4(lockPath)) {
-        return { pm: candidate.pm, cwd: dir, args: [...candidate.args] };
-      }
-    }
-    const parent = import_node_path42.default.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return { pm: "npm", cwd: import_node_path42.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
-}
-async function runPackageManagerInstall(cmd) {
-  return new Promise((resolve) => {
-    const child = (0, import_node_child_process2.spawn)(cmd.pm, cmd.args, {
-      cwd: cmd.cwd,
-      // Inherit PATH + HOME so the user's installed managers resolve.
-      env: process.env,
-      // `false` keeps the parent in control of cleanup if the orchestrator
-      // exits before install finishes. Cross-platform-safe.
-      shell: false,
-      stdio: ["ignore", "ignore", "pipe"]
-    });
-    let stderr = "";
-    child.stderr?.on("data", (chunk) => {
-      stderr += chunk.toString("utf8");
-    });
-    child.on("error", (err) => {
-      resolve({
-        pm: cmd.pm,
-        cwd: cmd.cwd,
-        args: cmd.args,
-        exitCode: 127,
-        stderr: stderr + `
-${err.message}`
-      });
-    });
-    child.on("close", (code) => {
-      resolve({
-        pm: cmd.pm,
-        cwd: cmd.cwd,
-        args: cmd.args,
-        exitCode: code ?? 1,
-        stderr: stderr.trim()
-      });
-    });
-  });
-}
-
-// 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_path43.default.join(opts.scanPath, "neat-out"));
+  const projectPaths = pathsForProject(graphKey, import_node_path44.default.join(opts.scanPath, "neat-out"));
   const extraction = await extractFromDirectory(graph, opts.scanPath, {
     errorsPath: projectPaths.errorsPath
   });
@@ -8927,6 +9327,10 @@ async function applyInstallersOver(services, project, options = {}) {
   let libOnly = 0;
   let browserBundle = 0;
   let reactNative = 0;
+  let bun = 0;
+  let deno = 0;
+  let cloudflareWorkers = 0;
+  let electron = 0;
   const installPlans = /* @__PURE__ */ new Map();
   for (const svc of services) {
     const installer = await pickInstaller(svc.dir);
@@ -8951,7 +9355,59 @@ 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++;
-      console.log(`skipping ${svc.dir}: React Native target; browser-OTel support lands in a future release.`);
+      const svcName = import_node_path44.default.basename(svc.dir);
+      console.log(
+        `neat: ${svc.dir} detected as React Native / Expo
+  The installer doesn't cover this runtime deterministically.
+  Configure your OTel binding to send spans to:
+    http://localhost:4318/projects/${project}/v1/traces
+  Set OTEL_SERVICE_NAME=${svcName}
+  See docs/installer-scope.md \u2192 "Manual setup for out-of-scope runtimes"`
+      );
+    } else if (outcome.outcome === "bun") {
+      bun++;
+      const svcName = import_node_path44.default.basename(svc.dir);
+      console.log(
+        `neat: ${svc.dir} detected as Bun
+  The installer doesn't cover this runtime deterministically.
+  Configure your OTel binding to send spans to:
+    http://localhost:4318/projects/${project}/v1/traces
+  Set OTEL_SERVICE_NAME=${svcName}
+  See docs/installer-scope.md \u2192 "Manual setup for out-of-scope runtimes"`
+      );
+    } else if (outcome.outcome === "deno") {
+      deno++;
+      const svcName = import_node_path44.default.basename(svc.dir);
+      console.log(
+        `neat: ${svc.dir} detected as Deno
+  The installer doesn't cover this runtime deterministically.
+  Configure your OTel binding to send spans to:
+    http://localhost:4318/projects/${project}/v1/traces
+  Set OTEL_SERVICE_NAME=${svcName}
+  See docs/installer-scope.md \u2192 "Manual setup for out-of-scope runtimes"`
+      );
+    } else if (outcome.outcome === "cloudflare-workers") {
+      cloudflareWorkers++;
+      const svcName = import_node_path44.default.basename(svc.dir);
+      console.log(
+        `neat: ${svc.dir} detected as Cloudflare Workers
+  The installer doesn't cover this runtime deterministically.
+  Configure your OTel binding to send spans to:
+    http://localhost:4318/projects/${project}/v1/traces
+  Set OTEL_SERVICE_NAME=${svcName}
+  See docs/installer-scope.md \u2192 "Manual setup for out-of-scope runtimes"`
+      );
+    } else if (outcome.outcome === "electron") {
+      electron++;
+      const svcName = import_node_path44.default.basename(svc.dir);
+      console.log(
+        `neat: ${svc.dir} detected as Electron
+  The installer doesn't cover this runtime deterministically.
+  Configure your OTel binding to send spans to:
+    http://localhost:4318/projects/${project}/v1/traces
+  Set OTEL_SERVICE_NAME=${svcName}
+  See docs/installer-scope.md \u2192 "Manual setup for out-of-scope runtimes"`
+      );
     }
   }
   const packageManagerInstalls = [];
@@ -8976,6 +9432,10 @@ async function applyInstallersOver(services, project, options = {}) {
     libOnly,
     browserBundle,
     reactNative,
+    bun,
+    deno,
+    cloudflareWorkers,
+    electron,
     packageManagerInstalls
   };
 }
@@ -9113,10 +9573,10 @@ function formatPortCollisionMessage(port) {
   ];
 }
 function spawnDaemonDetached() {
-  const here = import_node_path43.default.dirname(new URL(importMetaUrl).pathname);
+  const here = import_node_path44.default.dirname(new URL(importMetaUrl).pathname);
   const candidates = [
-    import_node_path43.default.join(here, "neatd.cjs"),
-    import_node_path43.default.join(here, "neatd.js")
+    import_node_path44.default.join(here, "neatd.cjs"),
+    import_node_path44.default.join(here, "neatd.js")
   ];
   let entry2 = null;
   const fsSync = require("fs");
@@ -9174,7 +9634,7 @@ async function runOrchestrator(opts) {
       browser: "skipped"
     }
   };
-  const stat = await import_node_fs28.promises.stat(opts.scanPath).catch(() => null);
+  const stat = await import_node_fs29.promises.stat(opts.scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) {
     console.error(`neat: ${opts.scanPath} is not a directory`);
     result.exitCode = 2;
@@ -9317,7 +9777,7 @@ function printSummary(result, graph, dashboardUrl) {
 
 // src/cli-verbs.ts
 init_cjs_shims();
-var import_node_path44 = __toESM(require("path"), 1);
+var import_node_path45 = __toESM(require("path"), 1);
 
 // src/cli-client.ts
 init_cjs_shims();
@@ -9346,10 +9806,10 @@ function createHttpClient(baseUrl, bearerToken) {
   const root = baseUrl.replace(/\/$/, "");
   const authHeader = bearerToken && bearerToken.length > 0 ? { authorization: `Bearer ${bearerToken}` } : {};
   return {
-    async get(path46) {
+    async get(path47) {
       let res;
       try {
-        res = await fetch(`${root}${path46}`, {
+        res = await fetch(`${root}${path47}`, {
           headers: { ...authHeader }
         });
       } catch (err) {
@@ -9361,16 +9821,16 @@ function createHttpClient(baseUrl, bearerToken) {
         const body = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on GET ${path46}: ${body}`,
+          `${res.status} ${res.statusText} on GET ${path47}: ${body}`,
           body
         );
       }
       return await res.json();
     },
-    async post(path46, body) {
+    async post(path47, body) {
       let res;
       try {
-        res = await fetch(`${root}${path46}`, {
+        res = await fetch(`${root}${path47}`, {
           method: "POST",
           headers: { "content-type": "application/json", ...authHeader },
           body: JSON.stringify(body)
@@ -9384,7 +9844,7 @@ function createHttpClient(baseUrl, bearerToken) {
         const text = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on POST ${path46}: ${text}`,
+          `${res.status} ${res.statusText} on POST ${path47}: ${text}`,
           text
         );
       }
@@ -9398,12 +9858,12 @@ function projectPath(project, suffix) {
 }
 async function runRootCause(client, input) {
   const qs = input.errorId ? `?errorId=${encodeURIComponent(input.errorId)}` : "";
-  const path46 = projectPath(
+  const path47 = projectPath(
     input.project,
     `/graph/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
   );
   try {
-    const result = await client.get(path46);
+    const result = await client.get(path47);
     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}.` : "");
@@ -9429,12 +9889,12 @@ async function runRootCause(client, input) {
 }
 async function runBlastRadius(client, input) {
   const qs = input.depth !== void 0 ? `?depth=${input.depth}` : "";
-  const path46 = projectPath(
+  const path47 = projectPath(
     input.project,
     `/graph/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
   );
   try {
-    const result = await client.get(path46);
+    const result = await client.get(path47);
     if (result.totalAffected === 0) {
       return {
         summary: `${result.origin} has no downstream dependencies. Nothing else would break if it failed.`
@@ -9468,12 +9928,12 @@ function formatBlastEntry(n) {
 }
 async function runDependencies(client, input) {
   const depth = input.depth ?? 3;
-  const path46 = projectPath(
+  const path47 = projectPath(
     input.project,
     `/graph/dependencies/${encodeURIComponent(input.nodeId)}?depth=${depth}`
   );
   try {
-    const result = await client.get(path46);
+    const result = await client.get(path47);
     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}).`
@@ -9554,9 +10014,9 @@ function formatDuration(ms) {
   return `${Math.round(h / 24)}d`;
 }
 async function runIncidents(client, input) {
-  const path46 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
+  const path47 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
   try {
-    const body = await client.get(path46);
+    const body = await client.get(path47);
     const events = body.events;
     if (events.length === 0) {
       return {
@@ -9846,7 +10306,7 @@ 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_path44.default.sep}`)) {
+    if (resolvedCwd === entry2.path || resolvedCwd.startsWith(`${entry2.path}${import_node_path45.default.sep}`)) {
       return entry2;
     }
   }
@@ -10206,14 +10666,14 @@ function assignFlag(out, field, value) {
   out[field] = value;
 }
 function readPackageVersion() {
-  const here = typeof __dirname !== "undefined" ? __dirname : import_node_path45.default.dirname((0, import_node_url3.fileURLToPath)(importMetaUrl));
+  const here = typeof __dirname !== "undefined" ? __dirname : import_node_path46.default.dirname((0, import_node_url3.fileURLToPath)(importMetaUrl));
   const candidates = [
-    import_node_path45.default.resolve(here, "../package.json"),
-    import_node_path45.default.resolve(here, "../../package.json")
+    import_node_path46.default.resolve(here, "../package.json"),
+    import_node_path46.default.resolve(here, "../../package.json")
   ];
   for (const candidate of candidates) {
     try {
-      const raw = (0, import_node_fs29.readFileSync)(candidate, "utf8");
+      const raw = (0, import_node_fs30.readFileSync)(candidate, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed.name === "@neat.is/core" && typeof parsed.version === "string") {
         return parsed.version;
@@ -10277,7 +10737,7 @@ async function buildPatchSections(services, project) {
 }
 async function runInit(opts) {
   const written = [];
-  const stat = await import_node_fs29.promises.stat(opts.scanPath).catch(() => null);
+  const stat = await import_node_fs30.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 };
@@ -10286,13 +10746,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_path45.default.join(opts.scanPath, "neat.patch");
+  const patchPath = import_node_path46.default.join(opts.scanPath, "neat.patch");
   if (opts.dryRun) {
-    await import_node_fs29.promises.writeFile(patchPath, patch, "utf8");
+    await import_node_fs30.promises.writeFile(patchPath, patch, "utf8");
     written.push(patchPath);
     console.log(`dry-run: patch written to ${patchPath}`);
-    const gitignorePath = import_node_path45.default.join(opts.scanPath, ".gitignore");
-    const gitignoreExists = await import_node_fs29.promises.stat(gitignorePath).then(() => true).catch(() => false);
+    const gitignorePath = import_node_path46.default.join(opts.scanPath, ".gitignore");
+    const gitignoreExists = await import_node_fs30.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.");
@@ -10303,9 +10763,9 @@ async function runInit(opts) {
   const graph = getGraph(graphKey);
   const projectPaths = pathsForProject(
     graphKey,
-    import_node_path45.default.join(opts.scanPath, "neat-out")
+    import_node_path46.default.join(opts.scanPath, "neat-out")
   );
-  const errorsPath = import_node_path45.default.join(import_node_path45.default.dirname(opts.outPath), import_node_path45.default.basename(projectPaths.errorsPath));
+  const errorsPath = import_node_path46.default.join(import_node_path46.default.dirname(opts.outPath), import_node_path46.default.basename(projectPaths.errorsPath));
   const result = await extractFromDirectory(graph, opts.scanPath, { errorsPath });
   await saveGraphToDisk(graph, opts.outPath);
   written.push(opts.outPath);
@@ -10384,7 +10844,7 @@ async function runInit(opts) {
         console.log("Run `npm install` (or your language equivalent) to refresh lockfiles.");
       }
     } else {
-      await import_node_fs29.promises.writeFile(patchPath, patch, "utf8");
+      await import_node_fs30.promises.writeFile(patchPath, patch, "utf8");
       written.push(patchPath);
     }
   }
@@ -10424,9 +10884,9 @@ var CLAUDE_SKILL_CONFIG = {
 };
 function claudeConfigPath() {
   const override = process.env.NEAT_CLAUDE_CONFIG;
-  if (override && override.length > 0) return import_node_path45.default.resolve(override);
+  if (override && override.length > 0) return import_node_path46.default.resolve(override);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path45.default.join(home, ".claude.json");
+  return import_node_path46.default.join(home, ".claude.json");
 }
 async function runSkill(opts) {
   const snippet2 = JSON.stringify(CLAUDE_SKILL_CONFIG, null, 2) + "\n";
@@ -10438,7 +10898,7 @@ async function runSkill(opts) {
     const target = claudeConfigPath();
     let existing = {};
     try {
-      existing = JSON.parse(await import_node_fs29.promises.readFile(target, "utf8"));
+      existing = JSON.parse(await import_node_fs30.promises.readFile(target, "utf8"));
     } catch (err) {
       if (err.code !== "ENOENT") {
         console.error(`neat skill: failed to read ${target} \u2014 ${err.message}`);
@@ -10450,8 +10910,8 @@ async function runSkill(opts) {
       ...existing,
       mcpServers: { ...mcp, neat: CLAUDE_SKILL_CONFIG.mcpServers.neat }
     };
-    await import_node_fs29.promises.mkdir(import_node_path45.default.dirname(target), { recursive: true });
-    await import_node_fs29.promises.writeFile(target, JSON.stringify(merged, null, 2) + "\n", "utf8");
+    await import_node_fs30.promises.mkdir(import_node_path46.default.dirname(target), { recursive: true });
+    await import_node_fs30.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 };
@@ -10489,12 +10949,12 @@ async function main() {
       console.error("neat init: --apply and --dry-run are mutually exclusive");
       process.exit(2);
     }
-    const scanPath = import_node_path45.default.resolve(target);
+    const scanPath = import_node_path46.default.resolve(target);
     const projectExplicit = parsed.project !== null;
-    const projectName = projectExplicit ? project : import_node_path45.default.basename(scanPath);
+    const projectName = projectExplicit ? project : import_node_path46.default.basename(scanPath);
     const projectKey = projectExplicit ? project : DEFAULT_PROJECT;
-    const fallback = pathsForProject(projectKey, import_node_path45.default.join(scanPath, "neat-out")).snapshotPath;
-    const outPath = import_node_path45.default.resolve(process.env.NEAT_OUT_PATH ?? fallback);
+    const fallback = pathsForProject(projectKey, import_node_path46.default.join(scanPath, "neat-out")).snapshotPath;
+    const outPath = import_node_path46.default.resolve(process.env.NEAT_OUT_PATH ?? fallback);
     const result = await runInit({
       scanPath,
       outPath,
@@ -10515,21 +10975,21 @@ async function main() {
       usage();
       process.exit(2);
     }
-    const scanPath = import_node_path45.default.resolve(target);
-    const stat = await import_node_fs29.promises.stat(scanPath).catch(() => null);
+    const scanPath = import_node_path46.default.resolve(target);
+    const stat = await import_node_fs30.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_path45.default.join(scanPath, "neat-out"));
-    const outPath = import_node_path45.default.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
-    const errorsPath = import_node_path45.default.resolve(
-      process.env.NEAT_ERRORS_PATH ?? import_node_path45.default.join(import_node_path45.default.dirname(outPath), import_node_path45.default.basename(projectPaths.errorsPath))
+    const projectPaths = pathsForProject(project, import_node_path46.default.join(scanPath, "neat-out"));
+    const outPath = import_node_path46.default.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
+    const errorsPath = import_node_path46.default.resolve(
+      process.env.NEAT_ERRORS_PATH ?? import_node_path46.default.join(import_node_path46.default.dirname(outPath), import_node_path46.default.basename(projectPaths.errorsPath))
     );
-    const staleEventsPath = import_node_path45.default.resolve(
-      process.env.NEAT_STALE_EVENTS_PATH ?? import_node_path45.default.join(import_node_path45.default.dirname(outPath), import_node_path45.default.basename(projectPaths.staleEventsPath))
+    const staleEventsPath = import_node_path46.default.resolve(
+      process.env.NEAT_STALE_EVENTS_PATH ?? import_node_path46.default.join(import_node_path46.default.dirname(outPath), import_node_path46.default.basename(projectPaths.staleEventsPath))
     );
-    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? import_node_path45.default.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
+    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? import_node_path46.default.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
     const handle = await startWatch(getGraph(project), {
       scanPath,
       outPath,
@@ -10675,11 +11135,11 @@ async function main() {
   process.exit(1);
 }
 async function tryOrchestrator(cmd, parsed) {
-  const scanPath = import_node_path45.default.resolve(cmd);
-  const stat = await import_node_fs29.promises.stat(scanPath).catch(() => null);
+  const scanPath = import_node_path46.default.resolve(cmd);
+  const stat = await import_node_fs30.promises.stat(scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) return null;
   const projectExplicit = parsed.project !== null;
-  const projectName = projectExplicit ? parsed.project : import_node_path45.default.basename(scanPath);
+  const projectName = projectExplicit ? parsed.project : import_node_path46.default.basename(scanPath);
   const result = await runOrchestrator({
     scanPath,
     project: projectName,