@neat.is/core 0.5.3 → 0.6.0

package/dist/server.cjs

@@ -59,8 +59,8 @@ function mountBearerAuth(app, opts) {
   ]);
   const publicRead = opts.publicRead === true;
   app.addHook("preHandler", (req, reply, done) => {
-    const path51 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
-    if (exactUnauthPaths.has(path51) || PROJECT_SCOPED_UNAUTH_PATTERN.test(path51)) {
+    const path52 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
+    if (exactUnauthPaths.has(path52) || PROJECT_SCOPED_UNAUTH_PATTERN.test(path52)) {
       done();
       return;
     }
@@ -192,8 +192,8 @@ function reshapeGrpcRequest(req) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path47.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path47.default.resolve(here, "..", "proto");
+  const here = import_node_path48.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return import_node_path48.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -261,13 +261,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path47, import_node_crypto2, grpc, protoLoader;
+var import_node_url, import_node_path48, 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_path47 = __toESM(require("path"), 1);
+    import_node_path48 = __toESM(require("path"), 1);
     import_node_crypto2 = require("crypto");
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
@@ -340,6 +340,11 @@ function pickEnv(spanAttrs, resourceAttrs) {
   }
   return ENV_FALLBACK;
 }
+function normalizeDbSystem(attrs) {
+  const raw = attrs["db.system"];
+  if (typeof raw !== "string") return void 0;
+  return raw === "mongoose" ? "mongodb" : raw;
+}
 function messagingDestinationOf(attrs) {
   for (const key of ["messaging.destination.name", "messaging.destination"]) {
     const v = attrs[key];
@@ -360,8 +365,8 @@ function websocketChannelPathOf(attrs) {
     const v = attrs[key];
     if (typeof v === "string" && v.length > 0) {
       const q = v.indexOf("?");
-      const path51 = q === -1 ? v : v.slice(0, q);
-      if (path51.length > 0) return path51;
+      const path52 = q === -1 ? v : v.slice(0, q);
+      if (path52.length > 0) return path52;
     }
   }
   return void 0;
@@ -394,8 +399,9 @@ function parseOtlpRequest(body) {
           durationNanos: durationNanos(span.startTimeUnixNano, span.endTimeUnixNano),
           env: pickEnv(attrs, resourceAttrs),
           attributes: attrs,
-          dbSystem: typeof attrs["db.system"] === "string" ? attrs["db.system"] : void 0,
+          dbSystem: normalizeDbSystem(attrs),
           dbName: typeof attrs["db.name"] === "string" ? attrs["db.name"] : void 0,
+          dbCollection: typeof attrs["db.collection.name"] === "string" ? attrs["db.collection.name"] : typeof attrs["db.mongodb.collection"] === "string" ? attrs["db.mongodb.collection"] : void 0,
           messagingSystem: typeof attrs["messaging.system"] === "string" ? attrs["messaging.system"] : void 0,
           messagingDestination: messagingDestinationOf(attrs),
           graphqlOperationName: typeof attrs["graphql.operation.name"] === "string" && attrs["graphql.operation.name"].length > 0 ? attrs["graphql.operation.name"] : void 0,
@@ -415,10 +421,10 @@ function parseOtlpRequest(body) {
   return out;
 }
 function loadProtoRoot() {
-  const here = import_node_path48.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path48.default.resolve(here, "..", "proto");
+  const here = import_node_path49.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path49.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path48.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path49.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -630,12 +636,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path48, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
+var import_node_path49, 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_path48 = __toESM(require("path"), 1);
+    import_node_path49 = __toESM(require("path"), 1);
     import_node_url2 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -651,7 +657,7 @@ var init_otel = __esm({
 
 // src/server.ts
 init_cjs_shims();
-var import_node_path50 = __toESM(require("path"), 1);
+var import_node_path51 = __toESM(require("path"), 1);
 
 // src/graph.ts
 init_cjs_shims();
@@ -675,7 +681,7 @@ function getGraph(project = DEFAULT_PROJECT) {
 init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
-var import_types33 = require("@neat.is/types");
+var import_types34 = require("@neat.is/types");
 
 // src/extend/index.ts
 init_cjs_shims();
@@ -1446,19 +1452,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, path51, edges) {
-    if (path51.length > best.path.length) {
-      best = { path: [...path51], edges: [...edges] };
+  function step(node, path52, edges) {
+    if (path52.length > best.path.length) {
+      best = { path: [...path52], edges: [...edges] };
     }
-    if (path51.length - 1 >= maxDepth) return;
+    if (path52.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);
-      path51.push(srcId);
+      path52.push(srcId);
       edges.push(edge);
-      step(srcId, path51, edges);
-      path51.pop();
+      step(srcId, path52, edges);
+      path52.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1652,26 +1658,26 @@ function dominantFailingCall(graph, serviceId5, visited) {
   return best;
 }
 function followFailingCallChain(graph, originServiceId, maxDepth) {
-  const path51 = [originServiceId];
+  const path52 = [originServiceId];
   const edges = [];
   const visited = /* @__PURE__ */ new Set([originServiceId]);
   let current = originServiceId;
   for (let depth = 0; depth < maxDepth; depth++) {
     const hop = dominantFailingCall(graph, current, visited);
     if (!hop) break;
-    path51.push(hop.nextService);
+    path52.push(hop.nextService);
     edges.push(hop.edge);
     visited.add(hop.nextService);
     current = hop.nextService;
   }
   if (edges.length === 0) return null;
-  return { path: path51, edges, culprit: current };
+  return { path: path52, edges, culprit: current };
 }
 function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   const chain = followFailingCallChain(graph, originId, ROOT_CAUSE_MAX_DEPTH);
   if (!chain) return null;
   const culprit = chain.culprit;
-  const path51 = [...chain.path];
+  const path52 = [...chain.path];
   const edgeProvenances = chain.edges.map((e) => e.provenance);
   const baseConfidence = confidenceFromMix(chain.edges);
   const confidence = Math.max(0, Math.min(1, baseConfidence * INCIDENT_ROOT_CAUSE_CONFIDENCE));
@@ -1679,14 +1685,14 @@ function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   if (loc) {
     let rootCauseNode = culprit;
     if (loc.fileNode) {
-      path51.push(loc.fileNode);
+      path52.push(loc.fileNode);
       edgeProvenances.push(import_types.Provenance.OBSERVED);
       rootCauseNode = loc.fileNode;
     }
     return import_types.RootCauseResultSchema.parse({
       rootCauseNode,
       rootCauseReason: loc.rootCauseReason,
-      traversalPath: path51,
+      traversalPath: path52,
       edgeProvenances,
       confidence,
       ...loc.fixRecommendation ? { fixRecommendation: loc.fixRecommendation } : {}
@@ -1698,7 +1704,7 @@ function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   return import_types.RootCauseResultSchema.parse({
     rootCauseNode: culprit,
     rootCauseReason: `${culpritName} is failing downstream calls (${errs} observed error${errs === 1 ? "" : "s"})`,
-    traversalPath: path51,
+    traversalPath: path52,
     edgeProvenances,
     confidence,
     fixRecommendation: `Inspect ${culpritName}'s failing handler`
@@ -3122,6 +3128,19 @@ function ensureServiceNode(graph, serviceName, env) {
   graph.addNode(id, node);
   return id;
 }
+function ensureInfraNode(graph, kind, name, provider) {
+  const id = (0, import_types4.infraId)(kind, name);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: import_types4.NodeType.InfraNode,
+    name,
+    provider,
+    kind
+  };
+  graph.addNode(id, node);
+  return id;
+}
 function ensureDatabaseNode(graph, host, engine) {
   const id = (0, import_types4.databaseId)(host);
   if (graph.hasNode(id)) return id;
@@ -3434,6 +3453,18 @@ async function handleSpan(ctx, span) {
         callSiteEvidence
       );
       if (result) affectedNode = targetId;
+      if (span.dbSystem === "mongodb" && span.dbCollection) {
+        const collectionId = ensureInfraNode(ctx.graph, "mongodb-collection", span.dbCollection, "self");
+        upsertObservedEdge(
+          ctx.graph,
+          import_types4.EdgeType.CALLS,
+          observedSource(),
+          collectionId,
+          ts,
+          isError,
+          callSiteEvidence
+        );
+      }
     }
   } else if (span.messagingSystem && span.messagingDestination && spanMintsMessagingEdge(span.kind)) {
     const targetId = ensureMessagingDestinationNode(
@@ -6281,7 +6312,7 @@ async function addGrpcMethods(graph, services) {
 
 // src/extract/calls/index.ts
 init_cjs_shims();
-var import_types21 = require("@neat.is/types");
+var import_types22 = require("@neat.is/types");
 
 // src/extract/calls/http.ts
 init_cjs_shims();
@@ -6994,15 +7025,311 @@ function supabaseEndpointsFromFile(file, serviceDir) {
   return out;
 }
 
+// src/extract/calls/mongoose.ts
+init_cjs_shims();
+var import_node_path33 = __toESM(require("path"), 1);
+var import_types21 = require("@neat.is/types");
+var MONGOOSE_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])mongoose['"`]/;
+var MONGODB_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])mongodb['"`]/;
+var PLURALIZE_DISABLED_RE = /\bpluralize\s*\(\s*(?:null|false)\s*\)/;
+var UNCOUNTABLES = /* @__PURE__ */ new Set([
+  "advice",
+  "energy",
+  "excretion",
+  "digestion",
+  "cooperation",
+  "health",
+  "justice",
+  "labour",
+  "machinery",
+  "equipment",
+  "information",
+  "pollution",
+  "sewage",
+  "paper",
+  "money",
+  "species",
+  "series",
+  "rain",
+  "rice",
+  "fish",
+  "sheep",
+  "moose",
+  "deer",
+  "news",
+  "expertise",
+  "status",
+  "media"
+]);
+var PLURALIZE_RULES = [
+  [/human$/gi, "humans"],
+  [/(m)an$/gi, "$1en"],
+  [/(pe)rson$/gi, "$1ople"],
+  [/(child)$/gi, "$1ren"],
+  [/^(ox)$/gi, "$1en"],
+  [/(ax|test)is$/gi, "$1es"],
+  [/(octop|vir)us$/gi, "$1i"],
+  [/(alias|status)$/gi, "$1es"],
+  [/(bu)s$/gi, "$1ses"],
+  [/(buffal|tomat|potat)o$/gi, "$1oes"],
+  [/([ti])um$/gi, "$1a"],
+  [/sis$/gi, "ses"],
+  [/(?:([^f])fe|([lr])f)$/gi, "$1$2ves"],
+  [/(hive)$/gi, "$1s"],
+  [/([^aeiouy]|qu)y$/gi, "$1ies"],
+  [/(x|ch|ss|sh)$/gi, "$1es"],
+  [/(matr|vert|ind)ix|ex$/gi, "$1ices"],
+  [/([m|l])ouse$/gi, "$1ice"],
+  [/(kn|w|l)ife$/gi, "$1ives"],
+  [/(quiz)$/gi, "$1zes"],
+  [/s$/gi, "s"],
+  [/([^a-z])$/, "$1"],
+  [/$/gi, "s"]
+];
+function pluralizeCollection(name) {
+  const str = name.toLowerCase();
+  if (UNCOUNTABLES.has(str)) return str;
+  for (const [re, repl] of PLURALIZE_RULES) {
+    if (str.match(re)) return str.replace(re, repl);
+  }
+  return str;
+}
+var MODEL_METHODS = [
+  "find",
+  "findOne",
+  "findById",
+  "findByIdAndUpdate",
+  "findByIdAndDelete",
+  "findOneAndUpdate",
+  "findOneAndDelete",
+  "findOneAndReplace",
+  "countDocuments",
+  "estimatedDocumentCount",
+  "distinct",
+  "aggregate",
+  "exists",
+  "where",
+  "populate",
+  "watch",
+  "hydrate",
+  "create",
+  "insertMany",
+  "insertOne",
+  "updateOne",
+  "updateMany",
+  "replaceOne",
+  "deleteOne",
+  "deleteMany",
+  "bulkWrite",
+  "bulkSave",
+  "save",
+  // pre-v7, removed in current mongoose but present in older codebases:
+  "count",
+  "update",
+  "remove",
+  "findOneAndRemove",
+  "findByIdAndRemove"
+];
+var MODEL_METHODS_ALT = MODEL_METHODS.join("|");
+function schemaCollectionVars(content) {
+  const out = /* @__PURE__ */ new Map();
+  const re = /(?:const|let|var)\s+(\w+)\s*=\s*new\s+(?:mongoose\s*\.\s*)?Schema\s*\(/g;
+  let m;
+  while ((m = re.exec(content)) !== null) {
+    const windowText = content.slice(m.index, m.index + 2e3);
+    const opt = /\bcollection\s*:\s*['"`]([\w.-]+)['"`]/.exec(windowText);
+    if (opt) out.set(m[1], opt[1]);
+  }
+  return out;
+}
+function resolveModel(modelName, rest, schemaColl, pluralizeOn) {
+  const trimmed = rest.trim();
+  const literalThird = /,\s*['"`]([\w.-]+)['"`]\s*$/.exec(trimmed);
+  if (literalThird) return { name: literalThird[1], kind: "mongodb-collection" };
+  const firstIdent = /^([A-Za-z_$][\w$]*)/.exec(trimmed)?.[1];
+  if (firstIdent && schemaColl.has(firstIdent)) {
+    return { name: schemaColl.get(firstIdent), kind: "mongodb-collection" };
+  }
+  if (/,\s*[A-Za-z_$][\w$]*\s*$/.test(trimmed)) {
+    return { name: modelName, kind: "mongodb-model" };
+  }
+  return { name: pluralizeOn ? pluralizeCollection(modelName) : modelName, kind: "mongodb-collection" };
+}
+function collectModelDefs(content, pluralizeOn) {
+  const schemaColl = schemaCollectionVars(content);
+  const out = [];
+  const re = /(?:(?:const|let|var)\s+(\w+)\s*=\s*)?(?:await\s+)?(?:\b\w+\s*\.\s*)?\bmodel\s*\(\s*['"`]([\w$]+)['"`]\s*(?:,\s*([\s\S]{0,300}?))?\)/g;
+  let m;
+  while ((m = re.exec(content)) !== null) {
+    out.push({
+      modelName: m[2],
+      varName: m[1] ?? null,
+      resolved: resolveModel(m[2], m[3] ?? "", schemaColl, pluralizeOn),
+      matchText: m[0]
+    });
+  }
+  return out;
+}
+function endpoint(r, file, serviceDir, matchText) {
+  const line = lineOf(file.content, matchText);
+  return {
+    infraId: (0, import_types21.infraId)(r.kind, r.name),
+    name: r.name,
+    kind: r.kind,
+    edgeType: "CALLS",
+    confidenceKind: "verified-call-site",
+    evidence: { file: import_node_path33.default.relative(serviceDir, file.path), line, snippet: snippet(file.content, line) }
+  };
+}
+function mongooseEndpointsFromFile(file, serviceDir) {
+  const hasMongoose = MONGOOSE_IMPORT_RE.test(file.content);
+  const hasMongodb = MONGODB_IMPORT_RE.test(file.content);
+  if (!hasMongoose && !hasMongodb) return [];
+  const content = file.content;
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const push = (r, matchText) => {
+    const key = `${r.kind}/${r.name}`;
+    if (seen.has(key)) return;
+    seen.add(key);
+    out.push(endpoint(r, file, serviceDir, matchText));
+  };
+  if (hasMongoose) {
+    const pluralizeOn = !PLURALIZE_DISABLED_RE.test(content);
+    for (const def of collectModelDefs(content, pluralizeOn)) push(def.resolved, def.matchText);
+  }
+  const collRe = /\.\s*collection\s*\(\s*['"`]([\w.$-]+)['"`]\s*\)/g;
+  let c;
+  while ((c = collRe.exec(content)) !== null) {
+    push({ name: c[1], kind: "mongodb-collection" }, c[0]);
+  }
+  return out;
+}
+function parseDestructure(inner, specifier, out) {
+  for (const raw of inner.split(",")) {
+    const part = raw.trim();
+    if (!part) continue;
+    const asM = /^(\w+)\s+as\s+(\w+)$/.exec(part);
+    const colonM = /^(\w+)\s*:\s*(\w+)$/.exec(part);
+    if (asM) out.push({ local: asM[2], kind: "named", exportName: asM[1], specifier });
+    else if (colonM) out.push({ local: colonM[2], kind: "named", exportName: colonM[1], specifier });
+    else {
+      const id = /^(\w+)$/.exec(part);
+      if (id) out.push({ local: id[1], kind: "named", exportName: id[1], specifier });
+    }
+  }
+}
+function parseImportBindings(content) {
+  const out = [];
+  const esm = /import\s+([^;'"`\n]+?)\s+from\s*['"`]([^'"`]+)['"`]/g;
+  let m;
+  while ((m = esm.exec(content)) !== null) {
+    const clause = m[1].trim();
+    const spec = m[2];
+    const ns = /^\*\s+as\s+(\w+)$/.exec(clause);
+    if (ns) {
+      out.push({ local: ns[1], kind: "namespace", specifier: spec });
+      continue;
+    }
+    const named = /\{([^}]*)\}/.exec(clause);
+    if (named) parseDestructure(named[1], spec, out);
+    const def = /^(\w+)\s*(?:,|$)/.exec(clause);
+    if (def && !clause.startsWith("{")) out.push({ local: def[1], kind: "default", specifier: spec });
+  }
+  const cjs = /(?:const|let|var)\s+(\{[^}]*\}|\w+)\s*=\s*require\(\s*['"`]([^'"`]+)['"`]\s*\)/g;
+  while ((m = cjs.exec(content)) !== null) {
+    const lhs = m[1];
+    const spec = m[2];
+    if (lhs.startsWith("{")) parseDestructure(lhs.slice(1, -1), spec, out);
+    else out.push({ local: lhs, kind: "whole", specifier: spec });
+  }
+  return out;
+}
+function fileExportsOf(content, pluralizeOn) {
+  const defs = collectModelDefs(content, pluralizeOn).filter((d) => d.resolved.kind === "mongodb-collection");
+  if (defs.length === 0) return null;
+  const byVar = /* @__PURE__ */ new Map();
+  for (const d of defs) if (d.varName) byVar.set(d.varName, d.resolved.name);
+  const byName = new Map(byVar);
+  let def;
+  const named = /(?:module\.exports|export\s+default)\s*=\s*(\w+)\b/.exec(content);
+  if (named && byVar.has(named[1])) def = byVar.get(named[1]);
+  if (!def) {
+    const inline = /(?:module\.exports|export\s+default)\s*=\s*(?:await\s+)?(?:\w+\s*\.\s*)?model\s*\(\s*['"`]([\w$]+)['"`]/.exec(content);
+    if (inline) def = pluralizeOn ? pluralizeCollection(inline[1]) : inline[1];
+  }
+  if (!def && byVar.size === 1) def = [...byVar.values()][0];
+  return { byName, ...def ? { default: def } : {} };
+}
+async function mongooseCrossFileEndpoints(files, serviceDir) {
+  const mongooseFiles = files.filter((f) => MONGOOSE_IMPORT_RE.test(f.content));
+  if (mongooseFiles.length === 0) return [];
+  const pluralizeOn = !files.some((f) => PLURALIZE_DISABLED_RE.test(f.content));
+  const registry = /* @__PURE__ */ new Map();
+  for (const f of mongooseFiles) {
+    const fx = fileExportsOf(f.content, pluralizeOn);
+    if (fx) registry.set(toPosix2(import_node_path33.default.relative(serviceDir, f.path)), fx);
+  }
+  if (registry.size === 0) return [];
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const f of files) {
+    const bindings = parseImportBindings(f.content);
+    if (bindings.length === 0) continue;
+    const directColl = /* @__PURE__ */ new Map();
+    const nsExports = /* @__PURE__ */ new Map();
+    for (const b of bindings) {
+      const resolvedRel = await resolveJsImport(b.specifier, import_node_path33.default.dirname(f.path), serviceDir, null);
+      if (!resolvedRel) continue;
+      const fx = registry.get(resolvedRel);
+      if (!fx) continue;
+      if (b.kind === "named" && b.exportName) {
+        const coll = fx.byName.get(b.exportName);
+        if (coll) directColl.set(b.local, coll);
+      } else if (b.kind === "default") {
+        if (fx.default) directColl.set(b.local, fx.default);
+      } else {
+        if (fx.default) directColl.set(b.local, fx.default);
+        nsExports.set(b.local, fx);
+      }
+    }
+    if (directColl.size === 0 && nsExports.size === 0) continue;
+    const localDefs = new Set(
+      collectModelDefs(f.content, pluralizeOn).map((d) => d.varName).filter((v) => v !== null)
+    );
+    const emit = (collection, matchText) => {
+      const key = `${f.path}::${collection}`;
+      if (seen.has(key)) return;
+      seen.add(key);
+      out.push(endpoint({ name: collection, kind: "mongodb-collection" }, f, serviceDir, matchText));
+    };
+    for (const [local, collection] of directColl) {
+      if (localDefs.has(local)) continue;
+      const qre = new RegExp(`\\b${local}\\s*\\.\\s*(?:${MODEL_METHODS_ALT})\\s*\\(`, "g");
+      let qm;
+      while ((qm = qre.exec(f.content)) !== null) emit(collection, qm[0]);
+    }
+    for (const [local, fx] of nsExports) {
+      const qre = new RegExp(`\\b${local}\\s*\\.\\s*(\\w+)\\s*\\.\\s*(?:${MODEL_METHODS_ALT})\\s*\\(`, "g");
+      let qm;
+      while ((qm = qre.exec(f.content)) !== null) {
+        const coll = fx.byName.get(qm[1]);
+        if (coll) emit(coll, qm[0]);
+      }
+    }
+  }
+  return out;
+}
+
 // src/extract/calls/index.ts
 function edgeTypeFromEndpoint(ep) {
   switch (ep.edgeType) {
     case "PUBLISHES_TO":
-      return import_types21.EdgeType.PUBLISHES_TO;
+      return import_types22.EdgeType.PUBLISHES_TO;
     case "CONSUMES_FROM":
-      return import_types21.EdgeType.CONSUMES_FROM;
+      return import_types22.EdgeType.CONSUMES_FROM;
     default:
-      return import_types21.EdgeType.CALLS;
+      return import_types22.EdgeType.CALLS;
   }
 }
 function isAwsKind(kind) {
@@ -7014,23 +7341,27 @@ async function addExternalEndpointEdges(graph, services) {
   for (const service of services) {
     const files = await loadSourceFiles(service.dir);
     const endpoints = [];
+    const maskedFiles = [];
     for (const file of files) {
       if (isTestPath(file.path)) continue;
       const masked = maskCommentsInSource(file.content);
       const maskedFile = { path: file.path, content: masked };
+      maskedFiles.push(maskedFile);
       endpoints.push(...kafkaEndpointsFromFile(maskedFile, service.dir));
       endpoints.push(...redisEndpointsFromFile(maskedFile, service.dir));
       endpoints.push(...awsEndpointsFromFile(maskedFile, service.dir));
       endpoints.push(...grpcEndpointsFromFile(maskedFile, service.dir));
       endpoints.push(...supabaseEndpointsFromFile(maskedFile, service.dir));
+      endpoints.push(...mongooseEndpointsFromFile(maskedFile, service.dir));
     }
+    endpoints.push(...await mongooseCrossFileEndpoints(maskedFiles, service.dir));
     if (endpoints.length === 0) continue;
     const seenEdges = /* @__PURE__ */ new Set();
     for (const ep of endpoints) {
       if (!graph.hasNode(ep.infraId)) {
         const node = {
           id: ep.infraId,
-          type: import_types21.NodeType.InfraNode,
+          type: import_types22.NodeType.InfraNode,
           name: ep.name,
           // #238 — `aws-*` covers AWS-SDK client kinds (aws-s3, aws-dynamodb,
           // aws-cognito-identity-provider, …); `s3-` / `dynamodb-` cover the
@@ -7042,7 +7373,7 @@ async function addExternalEndpointEdges(graph, services) {
         nodesAdded++;
       }
       const edgeType = edgeTypeFromEndpoint(ep);
-      const confidence = (0, import_types21.confidenceForExtracted)(ep.confidenceKind);
+      const confidence = (0, import_types22.confidenceForExtracted)(ep.confidenceKind);
       const relFile = toPosix2(ep.evidence.file);
       const { fileNodeId, nodesAdded: n, edgesAdded: e } = ensureFileNode(
         graph,
@@ -7052,7 +7383,7 @@ async function addExternalEndpointEdges(graph, services) {
       );
       nodesAdded += n;
       edgesAdded += e;
-      if (!(0, import_types21.passesExtractedFloor)(confidence)) {
+      if (!(0, import_types22.passesExtractedFloor)(confidence)) {
         noteExtractedDropped({
           source: fileNodeId,
           target: ep.infraId,
@@ -7072,7 +7403,7 @@ async function addExternalEndpointEdges(graph, services) {
           source: fileNodeId,
           target: ep.infraId,
           type: edgeType,
-          provenance: import_types21.Provenance.EXTRACTED,
+          provenance: import_types22.Provenance.EXTRACTED,
           confidence,
           evidence: ep.evidence
         };
@@ -7098,16 +7429,16 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path33 = __toESM(require("path"), 1);
-var import_types23 = require("@neat.is/types");
+var import_node_path34 = __toESM(require("path"), 1);
+var import_types24 = require("@neat.is/types");
 
 // src/extract/infra/shared.ts
 init_cjs_shims();
-var import_types22 = require("@neat.is/types");
+var import_types23 = require("@neat.is/types");
 function makeInfraNode(kind, name, provider = "self", extras) {
   return {
-    id: (0, import_types22.infraId)(kind, name),
-    type: import_types22.NodeType.InfraNode,
+    id: (0, import_types23.infraId)(kind, name),
+    type: import_types23.NodeType.InfraNode,
     name,
     provider,
     kind,
@@ -7151,8 +7482,8 @@ function emitPlatformResourceEdge(graph, anchorId, edgeType, kind, name, provide
       source: anchorId,
       target: node.id,
       type: edgeType,
-      provenance: import_types22.Provenance.EXTRACTED,
-      confidence: (0, import_types22.confidenceForExtracted)("structural"),
+      provenance: import_types23.Provenance.EXTRACTED,
+      confidence: (0, import_types23.confidenceForExtracted)("structural"),
       evidence: { file: evidenceFile, ...line !== void 0 ? { line } : {} }
     };
     graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -7169,7 +7500,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path33.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path34.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -7178,7 +7509,7 @@ async function addComposeInfra(graph, scanPath, services) {
   let edgesAdded = 0;
   let composePath = null;
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = import_node_path33.default.join(scanPath, name);
+    const abs = import_node_path34.default.join(scanPath, name);
     if (await exists2(abs)) {
       composePath = abs;
       break;
@@ -7191,13 +7522,13 @@ async function addComposeInfra(graph, scanPath, services) {
   } catch (err) {
     recordExtractionError(
       "infra docker-compose",
-      import_node_path33.default.relative(scanPath, composePath),
+      import_node_path34.default.relative(scanPath, composePath),
       err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path33.default.relative(scanPath, composePath).split(import_node_path33.default.sep).join("/");
+  const evidenceFile = import_node_path34.default.relative(scanPath, composePath).split(import_node_path34.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -7219,15 +7550,15 @@ async function addComposeInfra(graph, scanPath, services) {
     for (const dep of dependsOnList(svc.depends_on)) {
       const targetId = composeNameToNodeId.get(dep);
       if (!targetId) continue;
-      const edgeId = (0, import_types5.extractedEdgeId)(sourceId, targetId, import_types23.EdgeType.DEPENDS_ON);
+      const edgeId = (0, import_types5.extractedEdgeId)(sourceId, targetId, import_types24.EdgeType.DEPENDS_ON);
       if (graph.hasEdge(edgeId)) continue;
       const edge = {
         id: edgeId,
         source: sourceId,
         target: targetId,
-        type: import_types23.EdgeType.DEPENDS_ON,
-        provenance: import_types23.Provenance.EXTRACTED,
-        confidence: (0, import_types23.confidenceForExtracted)("structural"),
+        type: import_types24.EdgeType.DEPENDS_ON,
+        provenance: import_types24.Provenance.EXTRACTED,
+        confidence: (0, import_types24.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -7239,9 +7570,9 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path34 = __toESM(require("path"), 1);
+var import_node_path35 = __toESM(require("path"), 1);
 var import_node_fs18 = require("fs");
-var import_types24 = require("@neat.is/types");
+var import_types25 = require("@neat.is/types");
 function readDockerfile(content) {
   let image = null;
   const ports = [];
@@ -7270,7 +7601,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path34.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path35.default.join(service.dir, "Dockerfile");
     if (!await exists2(dockerfilePath)) continue;
     let content;
     try {
@@ -7278,7 +7609,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     } catch (err) {
       recordExtractionError(
         "infra dockerfile",
-        import_node_path34.default.relative(scanPath, dockerfilePath),
+        import_node_path35.default.relative(scanPath, dockerfilePath),
         err
       );
       continue;
@@ -7290,8 +7621,8 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const relDockerfile = toPosix2(import_node_path34.default.relative(service.dir, dockerfilePath));
-    const evidenceFile = toPosix2(import_node_path34.default.relative(scanPath, dockerfilePath));
+    const relDockerfile = toPosix2(import_node_path35.default.relative(service.dir, dockerfilePath));
+    const evidenceFile = toPosix2(import_node_path35.default.relative(scanPath, dockerfilePath));
     const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
       graph,
       service.pkg.name,
@@ -7300,15 +7631,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     );
     nodesAdded += fn;
     edgesAdded += fe;
-    const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, node.id, import_types24.EdgeType.RUNS_ON);
+    const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, node.id, import_types25.EdgeType.RUNS_ON);
     if (!graph.hasEdge(edgeId)) {
       const edge = {
         id: edgeId,
         source: fileNodeId,
         target: node.id,
-        type: import_types24.EdgeType.RUNS_ON,
-        provenance: import_types24.Provenance.EXTRACTED,
-        confidence: (0, import_types24.confidenceForExtracted)("structural"),
+        type: import_types25.EdgeType.RUNS_ON,
+        provenance: import_types25.Provenance.EXTRACTED,
+        confidence: (0, import_types25.confidenceForExtracted)("structural"),
         evidence: {
           file: evidenceFile,
           ...facts.entrypoint ? { snippet: facts.entrypoint.slice(0, 120) } : {}
@@ -7323,15 +7654,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
         graph.addNode(portNode.id, portNode);
         nodesAdded++;
       }
-      const portEdgeId = (0, import_types5.extractedEdgeId)(fileNodeId, portNode.id, import_types24.EdgeType.CONNECTS_TO);
+      const portEdgeId = (0, import_types5.extractedEdgeId)(fileNodeId, portNode.id, import_types25.EdgeType.CONNECTS_TO);
       if (graph.hasEdge(portEdgeId)) continue;
       const portEdge = {
         id: portEdgeId,
         source: fileNodeId,
         target: portNode.id,
-        type: import_types24.EdgeType.CONNECTS_TO,
-        provenance: import_types24.Provenance.EXTRACTED,
-        confidence: (0, import_types24.confidenceForExtracted)("structural"),
+        type: import_types25.EdgeType.CONNECTS_TO,
+        provenance: import_types25.Provenance.EXTRACTED,
+        confidence: (0, import_types25.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile, snippet: `EXPOSE ${port}` }
       };
       graph.addEdgeWithKey(portEdgeId, portEdge.source, portEdge.target, portEdge);
@@ -7344,8 +7675,8 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 // src/extract/infra/terraform.ts
 init_cjs_shims();
 var import_node_fs19 = require("fs");
-var import_node_path35 = __toESM(require("path"), 1);
-var import_types25 = require("@neat.is/types");
+var import_node_path36 = __toESM(require("path"), 1);
+var import_types26 = require("@neat.is/types");
 var RESOURCE_RE = /resource\s+"(aws_[A-Za-z0-9_]+)"\s+"([A-Za-z0-9_-]+)"/g;
 var REFERENCE_RE = /(?<![\w.])(aws_[A-Za-z0-9_]+)\.([A-Za-z0-9_-]+)/g;
 async function walkTfFiles(start, depth = 0, max = 5) {
@@ -7355,11 +7686,11 @@ async function walkTfFiles(start, depth = 0, max = 5) {
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name) || entry.name === ".terraform") continue;
-      const child = import_node_path35.default.join(start, entry.name);
+      const child = import_node_path36.default.join(start, entry.name);
       if (await isPythonVenvDir(child)) continue;
       out.push(...await walkTfFiles(child, depth + 1, max));
     } else if (entry.isFile() && entry.name.endsWith(".tf")) {
-      out.push(import_node_path35.default.join(start, entry.name));
+      out.push(import_node_path36.default.join(start, entry.name));
     }
   }
   return out;
@@ -7391,7 +7722,7 @@ async function addTerraformResources(graph, scanPath) {
   const files = await walkTfFiles(scanPath);
   for (const file of files) {
     const content = await import_node_fs19.promises.readFile(file, "utf8");
-    const evidenceFile = toPosix2(import_node_path35.default.relative(scanPath, file));
+    const evidenceFile = toPosix2(import_node_path36.default.relative(scanPath, file));
     const resources = [];
     const byKey = /* @__PURE__ */ new Map();
     RESOURCE_RE.lastIndex = 0;
@@ -7426,16 +7757,16 @@ async function addTerraformResources(graph, scanPath) {
         if (!target) continue;
         if (seen.has(target.nodeId)) continue;
         seen.add(target.nodeId);
-        const edgeId = (0, import_types5.extractedEdgeId)(resource.nodeId, target.nodeId, import_types25.EdgeType.DEPENDS_ON);
+        const edgeId = (0, import_types5.extractedEdgeId)(resource.nodeId, target.nodeId, import_types26.EdgeType.DEPENDS_ON);
         if (graph.hasEdge(edgeId)) continue;
         const line = lineAt2(content, resource.bodyOffset + ref.index);
         const edge = {
           id: edgeId,
           source: resource.nodeId,
           target: target.nodeId,
-          type: import_types25.EdgeType.DEPENDS_ON,
-          provenance: import_types25.Provenance.EXTRACTED,
-          confidence: (0, import_types25.confidenceForExtracted)("structural"),
+          type: import_types26.EdgeType.DEPENDS_ON,
+          provenance: import_types26.Provenance.EXTRACTED,
+          confidence: (0, import_types26.confidenceForExtracted)("structural"),
           evidence: { file: evidenceFile, line, snippet: key }
         };
         graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -7449,7 +7780,7 @@ async function addTerraformResources(graph, scanPath) {
 // src/extract/infra/k8s.ts
 init_cjs_shims();
 var import_node_fs20 = require("fs");
-var import_node_path36 = __toESM(require("path"), 1);
+var import_node_path37 = __toESM(require("path"), 1);
 var import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -7467,11 +7798,11 @@ async function walkYamlFiles2(start, depth = 0, max = 5) {
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name)) continue;
-      const child = import_node_path36.default.join(start, entry.name);
+      const child = import_node_path37.default.join(start, entry.name);
       if (await isPythonVenvDir(child)) continue;
       out.push(...await walkYamlFiles2(child, depth + 1, max));
-    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path36.default.extname(entry.name))) {
-      out.push(import_node_path36.default.join(start, entry.name));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path37.default.extname(entry.name))) {
+      out.push(import_node_path37.default.join(start, entry.name));
     }
   }
   return out;
@@ -7505,13 +7836,13 @@ async function addK8sResources(graph, scanPath) {
 // src/extract/infra/cloudflare.ts
 init_cjs_shims();
 var import_node_fs21 = require("fs");
-var import_node_path37 = __toESM(require("path"), 1);
+var import_node_path38 = __toESM(require("path"), 1);
 var import_smol_toml2 = require("smol-toml");
-var import_types26 = require("@neat.is/types");
+var import_types27 = require("@neat.is/types");
 var WRANGLER_FILENAMES = ["wrangler.toml", "wrangler.jsonc", "wrangler.json"];
 async function readWranglerConfig(dir) {
   for (const filename of WRANGLER_FILENAMES) {
-    const abs = import_node_path37.default.join(dir, filename);
+    const abs = import_node_path38.default.join(dir, filename);
     if (!await exists2(abs)) continue;
     const raw = await import_node_fs21.promises.readFile(abs, "utf8");
     const config = filename === "wrangler.toml" ? (0, import_smol_toml2.parse)(raw) : JSON.parse(maskCommentsInSource(raw));
@@ -7555,8 +7886,8 @@ function addResourceEdge(graph, anchorId, edgeType, kind, name, evidenceFile, li
       source: anchorId,
       target: node.id,
       type: edgeType,
-      provenance: import_types26.Provenance.EXTRACTED,
-      confidence: (0, import_types26.confidenceForExtracted)("structural"),
+      provenance: import_types27.Provenance.EXTRACTED,
+      confidence: (0, import_types27.confidenceForExtracted)("structural"),
       evidence: { file: evidenceFile, ...line !== void 0 ? { line } : {} }
     };
     graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -7574,11 +7905,11 @@ async function addCloudflareWorkers(graph, services, scanPath) {
     try {
       read = await readWranglerConfig(service.dir);
     } catch (err) {
-      recordExtractionError("infra cloudflare", import_node_path37.default.relative(scanPath, service.dir), err);
+      recordExtractionError("infra cloudflare", import_node_path38.default.relative(scanPath, service.dir), err);
       continue;
     }
     if (!read || !read.config.name) continue;
-    const evidenceFile = toPosix2(import_node_path37.default.relative(scanPath, import_node_path37.default.join(service.dir, read.relFile)));
+    const evidenceFile = toPosix2(import_node_path38.default.relative(scanPath, import_node_path38.default.join(service.dir, read.relFile)));
     discovered.push({ service, config: read.config, relFile: read.relFile, raw: read.raw, evidenceFile });
   }
   for (const worker of discovered) {
@@ -7590,7 +7921,7 @@ async function addCloudflareWorkers(graph, services, scanPath) {
     }
     let anchorId = service.node.id;
     if (config.main) {
-      const entryRelPath = toPosix2(import_node_path37.default.normalize(config.main));
+      const entryRelPath = toPosix2(import_node_path38.default.normalize(config.main));
       const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
         graph,
         service.pkg.name,
@@ -7617,15 +7948,15 @@ async function addCloudflareWorkers(graph, services, scanPath) {
       nodesAdded++;
     }
     if (runtimeNode.id !== anchorId) {
-      const runsOnId = (0, import_types5.extractedEdgeId)(anchorId, runtimeNode.id, import_types26.EdgeType.RUNS_ON);
+      const runsOnId = (0, import_types5.extractedEdgeId)(anchorId, runtimeNode.id, import_types27.EdgeType.RUNS_ON);
       if (!graph.hasEdge(runsOnId)) {
         const edge = {
           id: runsOnId,
           source: anchorId,
           target: runtimeNode.id,
-          type: import_types26.EdgeType.RUNS_ON,
-          provenance: import_types26.Provenance.EXTRACTED,
-          confidence: (0, import_types26.confidenceForExtracted)("structural"),
+          type: import_types27.EdgeType.RUNS_ON,
+          provenance: import_types27.Provenance.EXTRACTED,
+          confidence: (0, import_types27.confidenceForExtracted)("structural"),
           evidence: {
             file: evidenceFile,
             ...config.compatibility_date ? { snippet: `compatibility_date = ${config.compatibility_date}`.slice(0, 120) } : {}
@@ -7639,7 +7970,7 @@ async function addCloudflareWorkers(graph, services, scanPath) {
       const result = addResourceEdge(
         graph,
         anchorId,
-        import_types26.EdgeType.CONNECTS_TO,
+        import_types27.EdgeType.CONNECTS_TO,
         "cloudflare-route",
         route,
         evidenceFile,
@@ -7663,7 +7994,7 @@ async function addCloudflareWorkers(graph, services, scanPath) {
         const result = addResourceEdge(
           graph,
           anchorId,
-          import_types26.EdgeType.DEPENDS_ON,
+          import_types27.EdgeType.DEPENDS_ON,
           group.kind,
           name,
           evidenceFile,
@@ -7677,7 +8008,7 @@ async function addCloudflareWorkers(graph, services, scanPath) {
       const result = addResourceEdge(
         graph,
         anchorId,
-        import_types26.EdgeType.DEPENDS_ON,
+        import_types27.EdgeType.DEPENDS_ON,
         "cloudflare-cron",
         cron,
         evidenceFile,
@@ -7690,7 +8021,7 @@ async function addCloudflareWorkers(graph, services, scanPath) {
       const result = addResourceEdge(
         graph,
         anchorId,
-        import_types26.EdgeType.DEPENDS_ON,
+        import_types27.EdgeType.DEPENDS_ON,
         "cloudflare-env-var",
         varName,
         evidenceFile,
@@ -7703,15 +8034,15 @@ async function addCloudflareWorkers(graph, services, scanPath) {
       if (!svc.service) continue;
       const target = workerIndex.get(svc.service);
       if (target && target.anchorId !== anchorId) {
-        const edgeId = (0, import_types5.extractedEdgeId)(anchorId, target.anchorId, import_types26.EdgeType.CALLS);
+        const edgeId = (0, import_types5.extractedEdgeId)(anchorId, target.anchorId, import_types27.EdgeType.CALLS);
         if (!graph.hasEdge(edgeId)) {
           const edge = {
             id: edgeId,
             source: anchorId,
             target: target.anchorId,
-            type: import_types26.EdgeType.CALLS,
-            provenance: import_types26.Provenance.EXTRACTED,
-            confidence: (0, import_types26.confidenceForExtracted)("structural"),
+            type: import_types27.EdgeType.CALLS,
+            provenance: import_types27.Provenance.EXTRACTED,
+            confidence: (0, import_types27.confidenceForExtracted)("structural"),
             evidence: { file: evidenceFile, line: lineContaining2(raw, svc.service) }
           };
           graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -7722,7 +8053,7 @@ async function addCloudflareWorkers(graph, services, scanPath) {
       const result = addResourceEdge(
         graph,
         anchorId,
-        import_types26.EdgeType.DEPENDS_ON,
+        import_types27.EdgeType.DEPENDS_ON,
         "cloudflare-service-binding",
         svc.service,
         evidenceFile,
@@ -7738,12 +8069,12 @@ async function addCloudflareWorkers(graph, services, scanPath) {
 // src/extract/infra/vercel.ts
 init_cjs_shims();
 var import_node_fs22 = require("fs");
-var import_node_path38 = __toESM(require("path"), 1);
-var import_types27 = require("@neat.is/types");
+var import_node_path39 = __toESM(require("path"), 1);
+var import_types28 = require("@neat.is/types");
 var VERCEL_CONFIG_FILENAMES = ["vercel.json", "vercel.jsonc"];
 async function readVercelConfig(dir) {
   for (const filename of VERCEL_CONFIG_FILENAMES) {
-    const abs = import_node_path38.default.join(dir, filename);
+    const abs = import_node_path39.default.join(dir, filename);
     if (!await exists2(abs)) continue;
     const raw = await import_node_fs22.promises.readFile(abs, "utf8");
     const config = JSON.parse(maskCommentsInSource(raw));
@@ -7752,7 +8083,7 @@ async function readVercelConfig(dir) {
   return null;
 }
 async function readLinkedProjectName(dir) {
-  const abs = import_node_path38.default.join(dir, ".vercel", "project.json");
+  const abs = import_node_path39.default.join(dir, ".vercel", "project.json");
   if (!await exists2(abs)) return void 0;
   const parsed = JSON.parse(await import_node_fs22.promises.readFile(abs, "utf8"));
   return typeof parsed.projectName === "string" ? parsed.projectName : void 0;
@@ -7770,7 +8101,7 @@ async function addVercelServices(graph, services, scanPath) {
       read = await readVercelConfig(service.dir);
       projectName = await readLinkedProjectName(service.dir);
     } catch (err) {
-      recordExtractionError("infra vercel", import_node_path38.default.relative(scanPath, service.dir), err);
+      recordExtractionError("infra vercel", import_node_path39.default.relative(scanPath, service.dir), err);
       continue;
     }
     if (!read && !projectName) continue;
@@ -7786,7 +8117,7 @@ async function addVercelServices(graph, services, scanPath) {
     const anchorId = service.node.id;
     if (!read) continue;
     const { config, relFile, raw } = read;
-    const evidenceFile = toPosix2(import_node_path38.default.relative(scanPath, import_node_path38.default.join(service.dir, relFile)));
+    const evidenceFile = toPosix2(import_node_path39.default.relative(scanPath, import_node_path39.default.join(service.dir, relFile)));
     const add = (edgeType, kind, name) => {
       if (!name) return;
       const result = emitPlatformResourceEdge(
@@ -7802,12 +8133,12 @@ async function addVercelServices(graph, services, scanPath) {
       nodesAdded += result.nodesAdded;
       edgesAdded += result.edgesAdded;
     };
-    add(import_types27.EdgeType.RUNS_ON, "vercel", "vercel");
-    for (const cron of config.crons ?? []) add(import_types27.EdgeType.DEPENDS_ON, "vercel-cron", cron.path ?? cron.schedule);
-    for (const varName of Object.keys(config.env ?? {})) add(import_types27.EdgeType.DEPENDS_ON, "vercel-env-var", varName);
-    for (const varName of Object.keys(config.build?.env ?? {})) add(import_types27.EdgeType.DEPENDS_ON, "vercel-env-var", varName);
+    add(import_types28.EdgeType.RUNS_ON, "vercel", "vercel");
+    for (const cron of config.crons ?? []) add(import_types28.EdgeType.DEPENDS_ON, "vercel-cron", cron.path ?? cron.schedule);
+    for (const varName of Object.keys(config.env ?? {})) add(import_types28.EdgeType.DEPENDS_ON, "vercel-env-var", varName);
+    for (const varName of Object.keys(config.build?.env ?? {})) add(import_types28.EdgeType.DEPENDS_ON, "vercel-env-var", varName);
     for (const route of [...config.rewrites ?? [], ...config.redirects ?? [], ...config.routes ?? []]) {
-      add(import_types27.EdgeType.CONNECTS_TO, "vercel-route", routeSource(route));
+      add(import_types28.EdgeType.CONNECTS_TO, "vercel-route", routeSource(route));
     }
   }
   return { nodesAdded, edgesAdded };
@@ -7816,13 +8147,13 @@ async function addVercelServices(graph, services, scanPath) {
 // src/extract/infra/railway.ts
 init_cjs_shims();
 var import_node_fs23 = require("fs");
-var import_node_path39 = __toESM(require("path"), 1);
+var import_node_path40 = __toESM(require("path"), 1);
 var import_smol_toml3 = require("smol-toml");
-var import_types28 = require("@neat.is/types");
+var import_types29 = require("@neat.is/types");
 var RAILWAY_FILENAMES = ["railway.toml", "railway.json", "railway.jsonc"];
 async function readRailwayConfig(dir) {
   for (const filename of RAILWAY_FILENAMES) {
-    const abs = import_node_path39.default.join(dir, filename);
+    const abs = import_node_path40.default.join(dir, filename);
     if (!await exists2(abs)) continue;
     const raw = await import_node_fs23.promises.readFile(abs, "utf8");
     const config = filename === "railway.toml" ? (0, import_smol_toml3.parse)(raw) : JSON.parse(maskCommentsInSource(raw));
@@ -7838,7 +8169,7 @@ async function addRailwayServices(graph, services, scanPath) {
     try {
       read = await readRailwayConfig(service.dir);
     } catch (err) {
-      recordExtractionError("infra railway", import_node_path39.default.relative(scanPath, service.dir), err);
+      recordExtractionError("infra railway", import_node_path40.default.relative(scanPath, service.dir), err);
       continue;
     }
     if (!read) continue;
@@ -7848,7 +8179,7 @@ async function addRailwayServices(graph, services, scanPath) {
     }
     const anchorId = service.node.id;
     const { config, relFile, raw } = read;
-    const evidenceFile = toPosix2(import_node_path39.default.relative(scanPath, import_node_path39.default.join(service.dir, relFile)));
+    const evidenceFile = toPosix2(import_node_path40.default.relative(scanPath, import_node_path40.default.join(service.dir, relFile)));
     const add = (edgeType, kind, name) => {
       if (!name) return;
       const result = emitPlatformResourceEdge(
@@ -7864,9 +8195,9 @@ async function addRailwayServices(graph, services, scanPath) {
       nodesAdded += result.nodesAdded;
       edgesAdded += result.edgesAdded;
     };
-    add(import_types28.EdgeType.RUNS_ON, "railway", "railway");
-    add(import_types28.EdgeType.CONNECTS_TO, "railway-route", config.deploy?.healthcheckPath);
-    add(import_types28.EdgeType.DEPENDS_ON, "railway-cron", config.deploy?.cronSchedule);
+    add(import_types29.EdgeType.RUNS_ON, "railway", "railway");
+    add(import_types29.EdgeType.CONNECTS_TO, "railway-route", config.deploy?.healthcheckPath);
+    add(import_types29.EdgeType.DEPENDS_ON, "railway-cron", config.deploy?.cronSchedule);
   }
   return { nodesAdded, edgesAdded };
 }
@@ -7874,12 +8205,12 @@ async function addRailwayServices(graph, services, scanPath) {
 // src/extract/infra/supabase.ts
 init_cjs_shims();
 var import_node_fs24 = require("fs");
-var import_node_path40 = __toESM(require("path"), 1);
+var import_node_path41 = __toESM(require("path"), 1);
 var import_smol_toml4 = require("smol-toml");
-var import_types29 = require("@neat.is/types");
+var import_types30 = require("@neat.is/types");
 async function readSupabaseConfig(dir) {
-  const relFile = import_node_path40.default.join("supabase", "config.toml");
-  const abs = import_node_path40.default.join(dir, relFile);
+  const relFile = import_node_path41.default.join("supabase", "config.toml");
+  const abs = import_node_path41.default.join(dir, relFile);
   if (!await exists2(abs)) return null;
   const raw = await import_node_fs24.promises.readFile(abs, "utf8");
   const config = (0, import_smol_toml4.parse)(raw);
@@ -7893,7 +8224,7 @@ async function addSupabaseProjects(graph, services, scanPath) {
     try {
       read = await readSupabaseConfig(service.dir);
     } catch (err) {
-      recordExtractionError("infra supabase", import_node_path40.default.relative(scanPath, service.dir), err);
+      recordExtractionError("infra supabase", import_node_path41.default.relative(scanPath, service.dir), err);
       continue;
     }
     if (!read) continue;
@@ -7908,7 +8239,7 @@ async function addSupabaseProjects(graph, services, scanPath) {
       });
     }
     const anchorId = service.node.id;
-    const evidenceFile = toPosix2(import_node_path40.default.relative(scanPath, import_node_path40.default.join(service.dir, relFile)));
+    const evidenceFile = toPosix2(import_node_path41.default.relative(scanPath, import_node_path41.default.join(service.dir, relFile)));
     const add = (edgeType, kind, name) => {
       if (!name) return;
       const result = emitPlatformResourceEdge(
@@ -7924,10 +8255,10 @@ async function addSupabaseProjects(graph, services, scanPath) {
       nodesAdded += result.nodesAdded;
       edgesAdded += result.edgesAdded;
     };
-    add(import_types29.EdgeType.RUNS_ON, "supabase", "supabase");
-    for (const fn of Object.keys(config.functions ?? {})) add(import_types29.EdgeType.DEPENDS_ON, "supabase-function", fn);
-    if (config.storage) add(import_types29.EdgeType.DEPENDS_ON, "supabase-storage", "storage");
-    if (config.auth) add(import_types29.EdgeType.DEPENDS_ON, "supabase-auth", "auth");
+    add(import_types30.EdgeType.RUNS_ON, "supabase", "supabase");
+    for (const fn of Object.keys(config.functions ?? {})) add(import_types30.EdgeType.DEPENDS_ON, "supabase-function", fn);
+    if (config.storage) add(import_types30.EdgeType.DEPENDS_ON, "supabase-storage", "storage");
+    if (config.auth) add(import_types30.EdgeType.DEPENDS_ON, "supabase-auth", "auth");
   }
   return { nodesAdded, edgesAdded };
 }
@@ -7949,17 +8280,17 @@ async function addInfra(graph, scanPath, services) {
 }
 
 // src/extract/index.ts
-var import_node_path42 = __toESM(require("path"), 1);
+var import_node_path43 = __toESM(require("path"), 1);
 
 // src/extract/retire.ts
 init_cjs_shims();
 var import_node_fs25 = require("fs");
-var import_node_path41 = __toESM(require("path"), 1);
-var import_types30 = require("@neat.is/types");
+var import_node_path42 = __toESM(require("path"), 1);
+var import_types31 = require("@neat.is/types");
 function dropOrphanedFileNodes(graph) {
   const orphans = [];
   graph.forEachNode((id, attrs) => {
-    if (attrs.type !== import_types30.NodeType.FileNode) return;
+    if (attrs.type !== import_types31.NodeType.FileNode) return;
     if (graph.inboundEdges(id).length === 0 && graph.outboundEdges(id).length === 0) {
       orphans.push(id);
     }
@@ -7972,14 +8303,14 @@ function retireExtractedEdgesByMissingFile(graph, scanPath, serviceDirs = []) {
   const bases = [scanPath, ...serviceDirs];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== import_types30.Provenance.EXTRACTED) return;
+    if (edge.provenance !== import_types31.Provenance.EXTRACTED) return;
     const evidenceFile = edge.evidence?.file;
     if (!evidenceFile) return;
-    if (import_node_path41.default.isAbsolute(evidenceFile)) {
+    if (import_node_path42.default.isAbsolute(evidenceFile)) {
       if (!(0, import_node_fs25.existsSync)(evidenceFile)) toDrop.push(id);
       return;
     }
-    const found = bases.some((base) => (0, import_node_fs25.existsSync)(import_node_path41.default.join(base, evidenceFile)));
+    const found = bases.some((base) => (0, import_node_fs25.existsSync)(import_node_path42.default.join(base, evidenceFile)));
     if (!found) toDrop.push(id);
   });
   for (const id of toDrop) graph.dropEdge(id);
@@ -8021,7 +8352,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
-    const rejectedPath = import_node_path42.default.join(import_node_path42.default.dirname(opts.errorsPath), "rejected.ndjson");
+    const rejectedPath = import_node_path43.default.join(import_node_path43.default.dirname(opts.errorsPath), "rejected.ndjson");
     try {
       await writeRejectedExtracted(droppedEntries, rejectedPath);
     } catch (err) {
@@ -8133,8 +8464,8 @@ function canonicalJson(value) {
 // src/persist.ts
 init_cjs_shims();
 var import_node_fs27 = require("fs");
-var import_node_path43 = __toESM(require("path"), 1);
-var import_types31 = require("@neat.is/types");
+var import_node_path44 = __toESM(require("path"), 1);
+var import_types32 = require("@neat.is/types");
 var SCHEMA_VERSION = 4;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -8156,12 +8487,12 @@ function migrateV2ToV3(payload) {
     for (const edge of edges) {
       const attrs = edge.attributes;
       if (!attrs || attrs.provenance !== "FRONTIER") continue;
-      attrs.provenance = import_types31.Provenance.OBSERVED;
+      attrs.provenance = import_types32.Provenance.OBSERVED;
       const type = typeof attrs.type === "string" ? attrs.type : void 0;
       const source = typeof attrs.source === "string" ? attrs.source : void 0;
       const target = typeof attrs.target === "string" ? attrs.target : void 0;
       if (type && source && target) {
-        const newId = (0, import_types31.observedEdgeId)(source, target, type);
+        const newId = (0, import_types32.observedEdgeId)(source, target, type);
         attrs.id = newId;
         if (edge.key) edge.key = newId;
       }
@@ -8170,7 +8501,7 @@ function migrateV2ToV3(payload) {
   return { ...payload, schemaVersion: 3 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs27.promises.mkdir(import_node_path43.default.dirname(filePath), { recursive: true });
+  await import_node_fs27.promises.mkdir(import_node_path44.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -8251,23 +8582,23 @@ function startPersistLoop(graph, outPath, opts = {}) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path44 = __toESM(require("path"), 1);
+var import_node_path45 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path44.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path44.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path44.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path44.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path44.default.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: import_node_path45.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path45.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path45.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path45.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path45.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: import_node_path44.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path44.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path44.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path44.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path44.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: import_node_path45.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path45.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path45.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path45.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path45.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -8309,15 +8640,15 @@ function parseExtraProjects(raw) {
 init_cjs_shims();
 var import_node_fs28 = require("fs");
 var import_node_os3 = __toESM(require("os"), 1);
-var import_node_path45 = __toESM(require("path"), 1);
-var import_types32 = require("@neat.is/types");
+var import_node_path46 = __toESM(require("path"), 1);
+var import_types33 = require("@neat.is/types");
 function neatHome() {
   const override = process.env.NEAT_HOME;
-  if (override && override.length > 0) return import_node_path45.default.resolve(override);
-  return import_node_path45.default.join(import_node_os3.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path46.default.resolve(override);
+  return import_node_path46.default.join(import_node_os3.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path45.default.join(neatHome(), "projects.json");
+  return import_node_path46.default.join(neatHome(), "projects.json");
 }
 async function readRegistry() {
   const file = registryPath();
@@ -8331,7 +8662,7 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types32.RegistryFileSchema.parse(parsed);
+  return import_types33.RegistryFileSchema.parse(parsed);
 }
 async function getProject(name) {
   const reg = await readRegistry();
@@ -8406,16 +8737,16 @@ init_auth();
 // src/connectors-config.ts
 init_cjs_shims();
 var import_node_os4 = __toESM(require("os"), 1);
-var import_node_path46 = __toESM(require("path"), 1);
+var import_node_path47 = __toESM(require("path"), 1);
 var import_node_fs29 = require("fs");
 var CONNECTORS_CONFIG_VERSION = 1;
 function neatHome2() {
   const override = process.env.NEAT_HOME;
-  if (override && override.length > 0) return import_node_path46.default.resolve(override);
-  return import_node_path46.default.join(import_node_os4.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path47.default.resolve(override);
+  return import_node_path47.default.join(import_node_os4.default.homedir(), ".neat");
 }
 function connectorsConfigPath(home = neatHome2()) {
-  return import_node_path46.default.join(home, "connectors.json");
+  return import_node_path47.default.join(home, "connectors.json");
 }
 var MODE_MASK_LOOSER_THAN_0600 = 63;
 async function warnIfModeLooserThan0600(file) {
@@ -8714,11 +9045,11 @@ function registerRoutes(scope, ctx) {
       const candidates = req.query.type.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
       const parsed = [];
       for (const c of candidates) {
-        const r = import_types33.DivergenceTypeSchema.safeParse(c);
+        const r = import_types34.DivergenceTypeSchema.safeParse(c);
         if (!r.success) {
           return reply.code(400).send({
             error: `unknown divergence type "${c}"`,
-            allowed: import_types33.DivergenceTypeSchema.options
+            allowed: import_types34.DivergenceTypeSchema.options
           });
         }
         parsed.push(r.data);
@@ -8989,7 +9320,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req.query.severity) {
-      const sev = import_types33.PolicySeveritySchema.safeParse(req.query.severity);
+      const sev = import_types34.PolicySeveritySchema.safeParse(req.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -9028,7 +9359,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req, reply) => {
     const proj = resolveProject(registry, req, reply, ctx.bootstrap, ctx.singleProject);
     if (!proj) return;
-    const parsed = import_types33.PoliciesCheckBodySchema.safeParse(req.body ?? {});
+    const parsed = import_types34.PoliciesCheckBodySchema.safeParse(req.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -9100,6 +9431,42 @@ function registerRoutes(scope, ctx) {
       return reply.code(500).send({ error: err.message });
     }
   });
+  scope.get("/instrumentation", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap, ctx.singleProject);
+    if (!proj) return;
+    if (!proj.scanPath) {
+      return { engaged: null };
+    }
+    try {
+      const state = await describeProjectInstrumentation({ project: proj.name, scanPath: proj.scanPath });
+      const uninstrumented = await listUninstrumented({ project: proj.name, scanPath: proj.scanPath });
+      if (state.hookFiles.length === 0) {
+        return {
+          engaged: false,
+          diagnosis: {
+            reason: "No instrumented entry point found \u2014 NEAT hasn't written an OTel init hook for this project.",
+            fixCommand: "neat init",
+            detail: "Run `neat init` so NEAT writes the instrumentation hook next to your entry point, then run your app."
+          }
+        };
+      }
+      if (uninstrumented.length > 0) {
+        const names = uninstrumented.map((u) => u.library);
+        const more = names.length > 1 ? ` (and ${names.length - 1} more)` : "";
+        return {
+          engaged: false,
+          diagnosis: {
+            reason: `\`${names[0]}\`${more} isn't in the auto-instrumentation set, so spans from it won't reach the graph.`,
+            fixCommand: "neat extend",
+            detail: `Uninstrumented on your hot path: ${names.join(", ")}. Run \`neat extend\` to wire the missing instrumentation.`
+          }
+        };
+      }
+      return { engaged: true };
+    } catch {
+      return { engaged: null };
+    }
+  });
   scope.post("/extend/apply", async (req, reply) => {
     const proj = resolveProject(registry, req, reply, ctx.bootstrap, ctx.singleProject);
     if (!proj) return;
@@ -9294,7 +9661,7 @@ init_otel_grpc();
 // src/search.ts
 init_cjs_shims();
 var import_node_fs30 = require("fs");
-var import_node_path49 = __toESM(require("path"), 1);
+var import_node_path50 = __toESM(require("path"), 1);
 var import_node_crypto3 = require("crypto");
 var DEFAULT_LIMIT = 10;
 var NOMIC_DIM = 768;
@@ -9457,7 +9824,7 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, cache) {
-  await import_node_fs30.promises.mkdir(import_node_path49.default.dirname(cachePath), { recursive: true });
+  await import_node_fs30.promises.mkdir(import_node_path50.default.dirname(cachePath), { recursive: true });
   await import_node_fs30.promises.writeFile(cachePath, JSON.stringify(cache));
 }
 var VectorIndex = class {
@@ -9638,14 +10005,14 @@ async function bootProject(registry, name, scanPath, baseDir) {
 async function main() {
   const baseDirEnv = process.env.NEAT_OUT_DIR;
   const legacyOutPath = process.env.NEAT_OUT_PATH;
-  const baseDir = baseDirEnv ? import_node_path50.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path50.default.resolve(import_node_path50.default.dirname(legacyOutPath)) : import_node_path50.default.resolve("./neat-out");
-  const defaultScanPath = import_node_path50.default.resolve(process.env.NEAT_SCAN_PATH ?? "./demo");
+  const baseDir = baseDirEnv ? import_node_path51.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path51.default.resolve(import_node_path51.default.dirname(legacyOutPath)) : import_node_path51.default.resolve("./neat-out");
+  const defaultScanPath = import_node_path51.default.resolve(process.env.NEAT_SCAN_PATH ?? "./demo");
   const registry = new Projects();
   await bootProject(registry, DEFAULT_PROJECT, defaultScanPath, baseDir);
   for (const name of parseExtraProjects(process.env.NEAT_PROJECTS)) {
     const envKey = `NEAT_PROJECT_SCAN_PATH_${name.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`;
     const projectScan = process.env[envKey];
-    await bootProject(registry, name, projectScan ? import_node_path50.default.resolve(projectScan) : void 0, baseDir);
+    await bootProject(registry, name, projectScan ? import_node_path51.default.resolve(projectScan) : void 0, baseDir);
   }
   const host = process.env.HOST ?? "0.0.0.0";
   const port = Number(process.env.PORT ?? 8080);