@neat.is/core 0.4.11 → 0.4.13

package/dist/server.cjs

@@ -56,9 +56,9 @@ function mountBearerAuth(app, opts) {
   const suffixes = [...DEFAULT_UNAUTH_SUFFIXES, ...opts.extraUnauthenticatedSuffixes ?? []];
   const publicRead = opts.publicRead === true;
   app.addHook("preHandler", (req, reply, done) => {
-    const path38 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
+    const path42 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
     for (const suffix of suffixes) {
-      if (path38 === suffix || path38.endsWith(suffix)) {
+      if (path42 === suffix || path42.endsWith(suffix)) {
         done();
         return;
       }
@@ -184,8 +184,8 @@ function reshapeGrpcRequest(req) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path34.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path34.default.resolve(here, "..", "proto");
+  const here = import_node_path38.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return import_node_path38.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -253,13 +253,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path34, import_node_crypto2, grpc, protoLoader;
+var import_node_url, import_node_path38, 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_path34 = __toESM(require("path"), 1);
+    import_node_path38 = __toESM(require("path"), 1);
     import_node_crypto2 = require("crypto");
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
@@ -369,10 +369,10 @@ function parseOtlpRequest(body) {
   return out;
 }
 function loadProtoRoot() {
-  const here = import_node_path35.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path35.default.resolve(here, "..", "proto");
+  const here = import_node_path39.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path39.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path35.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path39.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -565,12 +565,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path35, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
+var import_node_path39, 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_path35 = __toESM(require("path"), 1);
+    import_node_path39 = __toESM(require("path"), 1);
     import_node_url2 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -586,7 +586,7 @@ var init_otel = __esm({
 
 // src/server.ts
 init_cjs_shims();
-var import_node_path37 = __toESM(require("path"), 1);
+var import_node_path41 = __toESM(require("path"), 1);
 
 // src/graph.ts
 init_cjs_shims();
@@ -610,7 +610,322 @@ 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_types23 = require("@neat.is/types");
+var import_types24 = require("@neat.is/types");
+
+// src/extend/index.ts
+init_cjs_shims();
+var import_node_fs2 = require("fs");
+var import_node_path2 = __toESM(require("path"), 1);
+var import_node_os = __toESM(require("os"), 1);
+var import_instrumentation_registry = require("@neat.is/instrumentation-registry");
+
+// src/installers/package-manager.ts
+init_cjs_shims();
+var import_node_fs = require("fs");
+var import_node_path = __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 exists(p) {
+  try {
+    await import_node_fs.promises.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function detectPackageManager(serviceDir) {
+  let dir = import_node_path.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_path.default.join(dir, candidate.lockfile);
+      if (await exists(lockPath)) {
+        return { pm: candidate.pm, cwd: dir, args: [...candidate.args] };
+      }
+    }
+    const parent = import_node_path.default.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return { pm: "npm", cwd: import_node_path.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_fs2.promises.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readPackageJson(scanPath) {
+  const pkgPath = import_node_path2.default.join(scanPath, "package.json");
+  const raw = await import_node_fs2.promises.readFile(pkgPath, "utf8");
+  return JSON.parse(raw);
+}
+async function findHookFiles(scanPath) {
+  const entries = await import_node_fs2.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_path2.default.join(import_node_os.default.homedir(), ".neat", "extend-log.ndjson");
+}
+async function appendExtendLog(entry) {
+  const logPath = extendLogPath();
+  await import_node_fs2.promises.mkdir(import_node_path2.default.dirname(logPath), { recursive: true });
+  await import_node_fs2.promises.appendFile(logPath, JSON.stringify(entry) + "\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 allDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+  const results = [];
+  for (const [library, installedVersion] of Object.entries(allDeps)) {
+    const entry = (0, import_instrumentation_registry.resolve)(library, installedVersion);
+    if (!entry) continue;
+    if (entry.coverage === "bundled" || entry.coverage === "http-only") continue;
+    results.push({
+      library,
+      coverage: entry.coverage,
+      installedVersion,
+      instrumentation_package: entry.instrumentation_package,
+      package_version: entry.package_version,
+      registration: entry.registration,
+      notes: entry.notes
+    });
+  }
+  return results;
+}
+function lookupInstrumentation(library, installedVersion) {
+  const entry = (0, import_instrumentation_registry.resolve)(library, installedVersion);
+  if (!entry) return null;
+  return {
+    library: entry.library,
+    coverage: entry.coverage,
+    instrumentation_package: entry.instrumentation_package,
+    package_version: entry.package_version,
+    registration: entry.registration,
+    notes: entry.notes
+  };
+}
+async function describeProjectInstrumentation(ctx) {
+  const hookFiles = await findHookFiles(ctx.scanPath);
+  const envNeat = await fileExists(import_node_path2.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 allDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+  const installedDeps = {};
+  for (const [key, version] of Object.entries(allDeps)) {
+    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_fs2.promises.readFile(import_node_path2.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_path2.default.join(ctx.scanPath, primaryFile);
+  const filesTouched = [];
+  const depsAdded = [];
+  const pkgPath = import_node_path2.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_fs2.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_fs2.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_fs2.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 };
+}
+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."
+    };
+  }
+  for (const file of hookFiles) {
+    const content = await import_node_fs2.promises.readFile(import_node_path2.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."
+      };
+    }
+  }
+  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_fs2.promises.readFile(import_node_path2.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_fs2.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_path2.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_fs2.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_path2.default.join(ctx.scanPath, file);
+    const content = await import_node_fs2.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_fs2.promises.writeFile(filePath, filtered, "utf8");
+      break;
+    }
+  }
+  return {
+    undone: true,
+    message: `rolled back ${match.library} (${match.instrumentation_package})`
+  };
+}
 
 // src/divergences.ts
 init_cjs_shims();
@@ -618,9 +933,9 @@ var import_types2 = require("@neat.is/types");
 
 // src/compat.ts
 init_cjs_shims();
-var import_node_fs = require("fs");
-var import_node_os = __toESM(require("os"), 1);
-var import_node_path = __toESM(require("path"), 1);
+var import_node_fs3 = require("fs");
+var import_node_os2 = __toESM(require("os"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
 var import_semver = __toESM(require("semver"), 1);
 
 // compat.json
@@ -749,8 +1064,8 @@ var compat_default = {
 var bundledMatrix = compat_default;
 var mergedMatrix = null;
 var remoteLoadAttempted = false;
-var REMOTE_CACHE_DIR = import_node_path.default.join(import_node_os.default.homedir(), ".neat");
-var REMOTE_CACHE_PATH = import_node_path.default.join(REMOTE_CACHE_DIR, "compat-cache.json");
+var REMOTE_CACHE_DIR = import_node_path3.default.join(import_node_os2.default.homedir(), ".neat");
+var REMOTE_CACHE_PATH = import_node_path3.default.join(REMOTE_CACHE_DIR, "compat-cache.json");
 var REMOTE_TTL_MS = 24 * 60 * 60 * 1e3;
 function engineMeetsThreshold(engineVersion, threshold) {
   const e = parseInt(engineVersion, 10);
@@ -861,7 +1176,7 @@ function mergeMatrices(a, b) {
 }
 async function readRemoteCache(url) {
   try {
-    const raw = await import_node_fs.promises.readFile(REMOTE_CACHE_PATH, "utf8");
+    const raw = await import_node_fs3.promises.readFile(REMOTE_CACHE_PATH, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.url !== url) return null;
     const age = Date.now() - new Date(parsed.fetchedAt).getTime();
@@ -878,8 +1193,8 @@ async function writeRemoteCache(url, matrix) {
     matrix
   };
   try {
-    await import_node_fs.promises.mkdir(REMOTE_CACHE_DIR, { recursive: true });
-    await import_node_fs.promises.writeFile(REMOTE_CACHE_PATH, JSON.stringify(file), "utf8");
+    await import_node_fs3.promises.mkdir(REMOTE_CACHE_DIR, { recursive: true });
+    await import_node_fs3.promises.writeFile(REMOTE_CACHE_PATH, JSON.stringify(file), "utf8");
   } catch (err) {
     console.warn(`[neat] failed to cache compat matrix: ${err.message}`);
   }
@@ -1038,19 +1353,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, path38, edges) {
-    if (path38.length > best.path.length) {
-      best = { path: [...path38], edges: [...edges] };
+  function step(node, path42, edges) {
+    if (path42.length > best.path.length) {
+      best = { path: [...path42], edges: [...edges] };
     }
-    if (path38.length - 1 >= maxDepth) return;
+    if (path42.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);
-      path38.push(srcId);
+      path42.push(srcId);
       edges.push(edge);
-      step(srcId, path38, edges);
-      path38.pop();
+      step(srcId, path42, edges);
+      path42.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1476,8 +1791,8 @@ function computeDivergences(graph, opts = {}) {
 
 // src/policy.ts
 init_cjs_shims();
-var import_node_fs2 = require("fs");
-var import_node_path2 = __toESM(require("path"), 1);
+var import_node_fs4 = require("fs");
+var import_node_path4 = __toESM(require("path"), 1);
 var import_types3 = require("@neat.is/types");
 
 // src/events.ts
@@ -1763,7 +2078,7 @@ function evaluateAllPolicies(graph, policies, ctx) {
 async function loadPolicyFile(policyPath) {
   let raw;
   try {
-    raw = await import_node_fs2.promises.readFile(policyPath, "utf8");
+    raw = await import_node_fs4.promises.readFile(policyPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") return [];
     throw err;
@@ -1784,8 +2099,8 @@ var PolicyViolationsLog = class {
     if (!this.seen) await this.hydrate();
     if (this.seen.has(v.id)) return false;
     this.seen.add(v.id);
-    await import_node_fs2.promises.mkdir(import_node_path2.default.dirname(this.path), { recursive: true });
-    await import_node_fs2.promises.appendFile(this.path, JSON.stringify(v) + "\n", "utf8");
+    await import_node_fs4.promises.mkdir(import_node_path4.default.dirname(this.path), { recursive: true });
+    await import_node_fs4.promises.appendFile(this.path, JSON.stringify(v) + "\n", "utf8");
     emitNeatEvent({
       type: "policy-violation",
       project: this.project,
@@ -1795,7 +2110,7 @@ var PolicyViolationsLog = class {
   }
   async readAll() {
     try {
-      const raw = await import_node_fs2.promises.readFile(this.path, "utf8");
+      const raw = await import_node_fs4.promises.readFile(this.path, "utf8");
       return raw.split("\n").filter(Boolean).map((line) => JSON.parse(line));
     } catch (err) {
       if (err.code === "ENOENT") return [];
@@ -1817,8 +2132,8 @@ init_cjs_shims();
 
 // src/ingest.ts
 init_cjs_shims();
-var import_node_fs3 = require("fs");
-var import_node_path3 = __toESM(require("path"), 1);
+var import_node_fs5 = require("fs");
+var import_node_path5 = __toESM(require("path"), 1);
 var sourceMapJs = __toESM(require("source-map-js"), 1);
 var import_types4 = require("@neat.is/types");
 var HOUR_MS = 60 * 60 * 1e3;
@@ -1918,7 +2233,7 @@ function languageForExt(relPath) {
 function relPathForRuntimeFile(filepath, serviceNode, scanPath) {
   let p = toPosix(filepath).replace(/^file:\/\//, "");
   if (scanPath && scanPath.length > 0) {
-    const absRoot = toPosix(import_node_path3.default.resolve(scanPath, serviceNode?.repoPath ?? ""));
+    const absRoot = toPosix(import_node_path5.default.resolve(scanPath, serviceNode?.repoPath ?? ""));
     const anchor = absRoot.endsWith("/") ? absRoot : `${absRoot}/`;
     if (p.startsWith(anchor)) return p.slice(anchor.length);
   }
@@ -1946,10 +2261,10 @@ function resolveDistToSrc(absFilepath, line) {
     entry = null;
     const mapPath = `${absFilepath}.map`;
     try {
-      if ((0, import_node_fs3.existsSync)(mapPath)) {
-        const raw = JSON.parse((0, import_node_fs3.readFileSync)(mapPath, "utf8"));
+      if ((0, import_node_fs5.existsSync)(mapPath)) {
+        const raw = JSON.parse((0, import_node_fs5.readFileSync)(mapPath, "utf8"));
         const consumer = new sourceMapJs.SourceMapConsumer(raw);
-        entry = { consumer, dir: import_node_path3.default.dirname(mapPath) };
+        entry = { consumer, dir: import_node_path5.default.dirname(mapPath) };
       }
     } catch {
       entry = null;
@@ -1964,7 +2279,7 @@ function resolveDistToSrc(absFilepath, line) {
     });
     if (!pos || !pos.source) return null;
     const root = entry.consumer.sourceRoot ?? "";
-    const resolved = import_node_path3.default.resolve(entry.dir, root, pos.source);
+    const resolved = import_node_path5.default.resolve(entry.dir, root, pos.source);
     return { filepath: resolved, ...pos.line ? { line: pos.line } : {} };
   } catch {
     return null;
@@ -2146,7 +2461,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)) {
@@ -2183,7 +2498,10 @@ function upsertObservedEdge(graph, type, source, target, ts, isError = false) {
     confidence: (0, import_types4.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 };
@@ -2228,8 +2546,8 @@ function upsertInferredEdge(graph, type, source, target, ts) {
   graph.addEdgeWithKey(id, source, target, edge);
 }
 async function appendErrorEvent(ctx, ev) {
-  await import_node_fs3.promises.mkdir(import_node_path3.default.dirname(ctx.errorsPath), { recursive: true });
-  await import_node_fs3.promises.appendFile(ctx.errorsPath, JSON.stringify(ev) + "\n", "utf8");
+  await import_node_fs5.promises.mkdir(import_node_path5.default.dirname(ctx.errorsPath), { recursive: true });
+  await import_node_fs5.promises.appendFile(ctx.errorsPath, JSON.stringify(ev) + "\n", "utf8");
 }
 function sanitizeAttributes(attrs) {
   const out = {};
@@ -2252,6 +2570,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) {
@@ -2265,7 +2584,8 @@ async function handleSpan(ctx, span) {
         observedSource(),
         targetId,
         ts,
-        isError
+        isError,
+        callSiteEvidence
       );
       if (result) affectedNode = targetId;
     }
@@ -2281,7 +2601,8 @@ async function handleSpan(ctx, span) {
           observedSource(),
           targetId,
           ts,
-          isError
+          isError,
+          callSiteEvidence
         );
         affectedNode = targetId;
         resolvedViaAddress = true;
@@ -2293,7 +2614,8 @@ async function handleSpan(ctx, span) {
           observedSource(),
           frontierNodeId,
           ts,
-          isError
+          isError,
+          callSiteEvidence
         );
         affectedNode = frontierNodeId;
         resolvedViaAddress = true;
@@ -2451,13 +2773,13 @@ async function markStaleEdges(graph, options = {}) {
   return { count: events.length, events };
 }
 async function appendStaleEvents(staleEventsPath, events) {
-  await import_node_fs3.promises.mkdir(import_node_path3.default.dirname(staleEventsPath), { recursive: true });
+  await import_node_fs5.promises.mkdir(import_node_path5.default.dirname(staleEventsPath), { recursive: true });
   const lines = events.map((e) => JSON.stringify(e)).join("\n") + "\n";
-  await import_node_fs3.promises.appendFile(staleEventsPath, lines, "utf8");
+  await import_node_fs5.promises.appendFile(staleEventsPath, lines, "utf8");
 }
 async function readStaleEvents(staleEventsPath) {
   try {
-    const raw = await import_node_fs3.promises.readFile(staleEventsPath, "utf8");
+    const raw = await import_node_fs5.promises.readFile(staleEventsPath, "utf8");
     return raw.split("\n").filter((line) => line.length > 0).map((line) => JSON.parse(line));
   } catch (err) {
     if (err.code === "ENOENT") return [];
@@ -2491,7 +2813,7 @@ function startStalenessLoop(graph, options = {}) {
 }
 async function readErrorEvents(errorsPath) {
   try {
-    const raw = await import_node_fs3.promises.readFile(errorsPath, "utf8");
+    const raw = await import_node_fs5.promises.readFile(errorsPath, "utf8");
     return raw.split("\n").filter((line) => line.length > 0).map((line) => JSON.parse(line));
   } catch (err) {
     if (err.code === "ENOENT") return [];
@@ -2523,16 +2845,16 @@ function mergeSnapshot(graph, snapshot) {
 
 // src/extract/services.ts
 init_cjs_shims();
-var import_node_fs8 = require("fs");
-var import_node_path8 = __toESM(require("path"), 1);
+var import_node_fs10 = require("fs");
+var import_node_path10 = __toESM(require("path"), 1);
 var import_ignore = __toESM(require("ignore"), 1);
 var import_minimatch2 = require("minimatch");
 var import_types6 = require("@neat.is/types");
 
 // src/extract/shared.ts
 init_cjs_shims();
-var import_node_fs4 = require("fs");
-var import_node_path4 = __toESM(require("path"), 1);
+var import_node_fs6 = require("fs");
+var import_node_path6 = __toESM(require("path"), 1);
 var import_yaml = require("yaml");
 var import_types5 = require("@neat.is/types");
 var SERVICE_FILE_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".mjs", ".cjs", ".ts", ".tsx", ".py"]);
@@ -2564,7 +2886,7 @@ async function isPythonVenvDir(dir) {
   const cached = PYVENV_MARKER_CACHE.get(dir);
   if (cached !== void 0) return cached;
   try {
-    const stat = await import_node_fs4.promises.stat(import_node_path4.default.join(dir, "pyvenv.cfg"));
+    const stat = await import_node_fs6.promises.stat(import_node_path6.default.join(dir, "pyvenv.cfg"));
     const ok = stat.isFile();
     PYVENV_MARKER_CACHE.set(dir, ok);
     return ok;
@@ -2574,7 +2896,7 @@ async function isPythonVenvDir(dir) {
   }
 }
 function isConfigFile(name) {
-  const ext = import_node_path4.default.extname(name);
+  const ext = import_node_path6.default.extname(name);
   if (CONFIG_FILE_EXTENSIONS.has(ext)) return { match: true, fileType: ext.slice(1) };
   if (name === ".env" || name.startsWith(".env.")) {
     if (isEnvTemplateFile(name)) return { match: false, fileType: "" };
@@ -2682,16 +3004,16 @@ function cleanVersion(raw) {
   return raw.replace(/^[\^~><=v\s]+/, "").trim() || void 0;
 }
 async function readJson(filePath) {
-  const raw = await import_node_fs4.promises.readFile(filePath, "utf8");
+  const raw = await import_node_fs6.promises.readFile(filePath, "utf8");
   return JSON.parse(raw);
 }
 async function readYaml(filePath) {
-  const raw = await import_node_fs4.promises.readFile(filePath, "utf8");
+  const raw = await import_node_fs6.promises.readFile(filePath, "utf8");
   return (0, import_yaml.parse)(raw);
 }
-async function exists(p) {
+async function exists2(p) {
   try {
-    await import_node_fs4.promises.access(p);
+    await import_node_fs6.promises.access(p);
     return true;
   } catch {
     return false;
@@ -2700,8 +3022,8 @@ async function exists(p) {
 
 // src/extract/python.ts
 init_cjs_shims();
-var import_node_fs5 = require("fs");
-var import_node_path5 = __toESM(require("path"), 1);
+var import_node_fs7 = require("fs");
+var import_node_path7 = __toESM(require("path"), 1);
 var import_smol_toml = require("smol-toml");
 var REQUIREMENT_LINE = /^\s*([A-Za-z0-9_.-]+)(?:\[[^\]]*\])?\s*(?:(==)\s*([A-Za-z0-9_.+-]+))?/;
 function parseRequirementsTxt(content) {
@@ -2734,25 +3056,25 @@ function depsFromPyProject(pyproject) {
   return out;
 }
 async function discoverPythonService(serviceDir) {
-  const pyprojectPath = import_node_path5.default.join(serviceDir, "pyproject.toml");
-  const requirementsPath = import_node_path5.default.join(serviceDir, "requirements.txt");
-  const setupPath = import_node_path5.default.join(serviceDir, "setup.py");
-  const hasPyproject = await exists(pyprojectPath);
-  const hasRequirements = await exists(requirementsPath);
-  const hasSetup = await exists(setupPath);
+  const pyprojectPath = import_node_path7.default.join(serviceDir, "pyproject.toml");
+  const requirementsPath = import_node_path7.default.join(serviceDir, "requirements.txt");
+  const setupPath = import_node_path7.default.join(serviceDir, "setup.py");
+  const hasPyproject = await exists2(pyprojectPath);
+  const hasRequirements = await exists2(requirementsPath);
+  const hasSetup = await exists2(setupPath);
   if (!hasPyproject && !hasRequirements && !hasSetup) return null;
-  let name = import_node_path5.default.basename(serviceDir);
+  let name = import_node_path7.default.basename(serviceDir);
   let version;
   const dependencies = {};
   if (hasPyproject) {
-    const raw = await import_node_fs5.promises.readFile(pyprojectPath, "utf8");
+    const raw = await import_node_fs7.promises.readFile(pyprojectPath, "utf8");
     const pyproject = (0, import_smol_toml.parse)(raw);
     name = pyproject.project?.name ?? pyproject.tool?.poetry?.name ?? name;
     version = pyproject.project?.version ?? pyproject.tool?.poetry?.version ?? void 0;
     Object.assign(dependencies, depsFromPyProject(pyproject));
   }
   if (hasRequirements) {
-    const raw = await import_node_fs5.promises.readFile(requirementsPath, "utf8");
+    const raw = await import_node_fs7.promises.readFile(requirementsPath, "utf8");
     Object.assign(dependencies, parseRequirementsTxt(raw));
   }
   return { name, version, dependencies };
@@ -2767,17 +3089,17 @@ function pythonToPackage(service) {
 
 // src/extract/owners.ts
 init_cjs_shims();
-var import_node_fs6 = require("fs");
-var import_node_path6 = __toESM(require("path"), 1);
+var import_node_fs8 = require("fs");
+var import_node_path8 = __toESM(require("path"), 1);
 var import_minimatch = require("minimatch");
 async function loadCodeowners(scanPath) {
   const candidates = [
-    import_node_path6.default.join(scanPath, "CODEOWNERS"),
-    import_node_path6.default.join(scanPath, ".github", "CODEOWNERS")
+    import_node_path8.default.join(scanPath, "CODEOWNERS"),
+    import_node_path8.default.join(scanPath, ".github", "CODEOWNERS")
   ];
   for (const file of candidates) {
-    if (await exists(file)) {
-      const raw = await import_node_fs6.promises.readFile(file, "utf8");
+    if (await exists2(file)) {
+      const raw = await import_node_fs8.promises.readFile(file, "utf8");
       return parseCodeowners(raw);
     }
   }
@@ -2795,7 +3117,7 @@ function parseCodeowners(raw) {
   return { rules };
 }
 function matchOwner(file, repoPath) {
-  const normalized = repoPath.split(import_node_path6.default.sep).join("/");
+  const normalized = repoPath.split(import_node_path8.default.sep).join("/");
   for (const rule of file.rules) {
     if (matchesPattern(rule.pattern, normalized)) return rule.owners;
   }
@@ -2811,8 +3133,8 @@ function matchesPattern(rawPattern, repoPath) {
   return false;
 }
 async function readPackageJsonAuthor(serviceDir) {
-  const pkgPath = import_node_path6.default.join(serviceDir, "package.json");
-  if (!await exists(pkgPath)) return null;
+  const pkgPath = import_node_path8.default.join(serviceDir, "package.json");
+  if (!await exists2(pkgPath)) return null;
   try {
     const pkg = await readJson(pkgPath);
     if (!pkg.author) return null;
@@ -2834,8 +3156,8 @@ async function computeServiceOwner(codeowners, repoPath, serviceDir) {
 
 // src/extract/errors.ts
 init_cjs_shims();
-var import_node_fs7 = require("fs");
-var import_node_path7 = __toESM(require("path"), 1);
+var import_node_fs9 = require("fs");
+var import_node_path9 = __toESM(require("path"), 1);
 var sink = [];
 function recordExtractionError(producer, file, err) {
   const e = err instanceof Error ? err : new Error(String(err));
@@ -2854,9 +3176,9 @@ function drainExtractionErrors() {
 }
 async function writeExtractionErrors(errors, errorsPath) {
   if (errors.length === 0) return;
-  await import_node_fs7.promises.mkdir(import_node_path7.default.dirname(errorsPath), { recursive: true });
+  await import_node_fs9.promises.mkdir(import_node_path9.default.dirname(errorsPath), { recursive: true });
   const lines = errors.map((e) => JSON.stringify(e)).join("\n") + "\n";
-  await import_node_fs7.promises.appendFile(errorsPath, lines, "utf8");
+  await import_node_fs9.promises.appendFile(errorsPath, lines, "utf8");
 }
 var droppedSink = [];
 function noteExtractedDropped(edge) {
@@ -2871,9 +3193,9 @@ function isRejectedLogEnabled() {
 }
 async function writeRejectedExtracted(drops, rejectedPath) {
   if (drops.length === 0) return;
-  await import_node_fs7.promises.mkdir(import_node_path7.default.dirname(rejectedPath), { recursive: true });
+  await import_node_fs9.promises.mkdir(import_node_path9.default.dirname(rejectedPath), { recursive: true });
   const lines = drops.map((d) => JSON.stringify({ ...d, ts: (/* @__PURE__ */ new Date()).toISOString() })).join("\n") + "\n";
-  await import_node_fs7.promises.appendFile(rejectedPath, lines, "utf8");
+  await import_node_fs9.promises.appendFile(rejectedPath, lines, "utf8");
 }
 
 // src/extract/services.ts
@@ -2892,21 +3214,21 @@ function workspaceGlobs(pkg) {
   return null;
 }
 async function loadGitignore(scanPath) {
-  const gitignorePath = import_node_path8.default.join(scanPath, ".gitignore");
-  if (!await exists(gitignorePath)) return null;
-  const raw = await import_node_fs8.promises.readFile(gitignorePath, "utf8");
+  const gitignorePath = import_node_path10.default.join(scanPath, ".gitignore");
+  if (!await exists2(gitignorePath)) return null;
+  const raw = await import_node_fs10.promises.readFile(gitignorePath, "utf8");
   return (0, import_ignore.default)().add(raw);
 }
 async function walkDirs(start, scanPath, options, visit) {
   async function recurse(current, depth) {
     if (depth > options.maxDepth) return;
-    const entries = await import_node_fs8.promises.readdir(current, { withFileTypes: true }).catch(() => []);
+    const entries = await import_node_fs10.promises.readdir(current, { withFileTypes: true }).catch(() => []);
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       if (IGNORED_DIRS.has(entry.name)) continue;
-      const child = import_node_path8.default.join(current, entry.name);
+      const child = import_node_path10.default.join(current, entry.name);
       if (options.ig) {
-        const rel = import_node_path8.default.relative(scanPath, child).split(import_node_path8.default.sep).join("/");
+        const rel = import_node_path10.default.relative(scanPath, child).split(import_node_path10.default.sep).join("/");
         if (rel && options.ig.ignores(rel + "/")) continue;
       }
       if (await isPythonVenvDir(child)) continue;
@@ -2922,8 +3244,8 @@ async function expandWorkspaceGlobs(scanPath, globs) {
   for (const raw of globs) {
     const pattern = raw.replace(/^\.\//, "");
     if (!pattern.includes("*")) {
-      const candidate = import_node_path8.default.join(scanPath, pattern);
-      if (await exists(import_node_path8.default.join(candidate, "package.json"))) found.add(candidate);
+      const candidate = import_node_path10.default.join(scanPath, pattern);
+      if (await exists2(import_node_path10.default.join(candidate, "package.json"))) found.add(candidate);
       continue;
     }
     const segments = pattern.split("/");
@@ -2932,13 +3254,13 @@ async function expandWorkspaceGlobs(scanPath, globs) {
       if (seg.includes("*")) break;
       staticSegments.push(seg);
     }
-    const start = import_node_path8.default.join(scanPath, ...staticSegments);
-    if (!await exists(start)) continue;
+    const start = import_node_path10.default.join(scanPath, ...staticSegments);
+    if (!await exists2(start)) continue;
     const hasDoubleStar = pattern.includes("**");
     const walkDepth = hasDoubleStar ? scanDepth : Math.max(0, segments.length - staticSegments.length - 1);
     await walkDirs(start, scanPath, { maxDepth: walkDepth, ig: null }, async (dir) => {
-      const rel = import_node_path8.default.relative(scanPath, dir).split(import_node_path8.default.sep).join("/");
-      if ((0, import_minimatch2.minimatch)(rel, pattern) && await exists(import_node_path8.default.join(dir, "package.json"))) {
+      const rel = import_node_path10.default.relative(scanPath, dir).split(import_node_path10.default.sep).join("/");
+      if ((0, import_minimatch2.minimatch)(rel, pattern) && await exists2(import_node_path10.default.join(dir, "package.json"))) {
         found.add(dir);
       }
     });
@@ -2958,13 +3280,13 @@ function detectJsFramework(pkg) {
   return void 0;
 }
 async function discoverNodeService(scanPath, dir) {
-  const pkgPath = import_node_path8.default.join(dir, "package.json");
-  if (!await exists(pkgPath)) return null;
+  const pkgPath = import_node_path10.default.join(dir, "package.json");
+  if (!await exists2(pkgPath)) return null;
   let pkg;
   try {
     pkg = await readJson(pkgPath);
   } catch (err) {
-    recordExtractionError("services", import_node_path8.default.relative(scanPath, pkgPath), err);
+    recordExtractionError("services", import_node_path10.default.relative(scanPath, pkgPath), err);
     return null;
   }
   if (!pkg.name) return null;
@@ -2976,7 +3298,7 @@ async function discoverNodeService(scanPath, dir) {
     language: "javascript",
     version: pkg.version,
     dependencies: pkg.dependencies ?? {},
-    repoPath: import_node_path8.default.relative(scanPath, dir),
+    repoPath: import_node_path10.default.relative(scanPath, dir),
     ...pkg.engines?.node ? { nodeEngine: pkg.engines.node } : {},
     ...framework ? { framework } : {}
   };
@@ -2993,20 +3315,20 @@ async function discoverPyService(scanPath, dir) {
     language: "python",
     version: py.version,
     dependencies: py.dependencies,
-    repoPath: import_node_path8.default.relative(scanPath, dir)
+    repoPath: import_node_path10.default.relative(scanPath, dir)
   };
   return { pkg, dir, node };
 }
 async function discoverServices(scanPath) {
-  const rootPkgPath = import_node_path8.default.join(scanPath, "package.json");
+  const rootPkgPath = import_node_path10.default.join(scanPath, "package.json");
   let rootPkg = null;
-  if (await exists(rootPkgPath)) {
+  if (await exists2(rootPkgPath)) {
     try {
       rootPkg = await readJson(rootPkgPath);
     } catch (err) {
       recordExtractionError(
         "services workspaces",
-        import_node_path8.default.relative(scanPath, rootPkgPath),
+        import_node_path10.default.relative(scanPath, rootPkgPath),
         err
       );
     }
@@ -3023,9 +3345,9 @@ async function discoverServices(scanPath) {
       scanPath,
       { maxDepth: parseScanDepth(), ig },
       async (dir) => {
-        if (await exists(import_node_path8.default.join(dir, "package.json"))) {
+        if (await exists2(import_node_path10.default.join(dir, "package.json"))) {
           candidateDirs.push(dir);
-        } else if (await exists(import_node_path8.default.join(dir, "pyproject.toml")) || await exists(import_node_path8.default.join(dir, "requirements.txt")) || await exists(import_node_path8.default.join(dir, "setup.py"))) {
+        } else if (await exists2(import_node_path10.default.join(dir, "pyproject.toml")) || await exists2(import_node_path10.default.join(dir, "requirements.txt")) || await exists2(import_node_path10.default.join(dir, "setup.py"))) {
           candidateDirs.push(dir);
         }
       }
@@ -3039,8 +3361,8 @@ async function discoverServices(scanPath) {
     if (!service) continue;
     const existingDir = seen.get(service.node.name);
     if (existingDir !== void 0) {
-      const a = import_node_path8.default.relative(scanPath, existingDir) || ".";
-      const b = import_node_path8.default.relative(scanPath, dir) || ".";
+      const a = import_node_path10.default.relative(scanPath, existingDir) || ".";
+      const b = import_node_path10.default.relative(scanPath, dir) || ".";
       console.warn(
         `[neat] duplicate package name "${service.node.name}" \u2014 keeping ${a}, ignoring ${b}`
       );
@@ -3077,8 +3399,8 @@ function addServiceNodes(graph, services) {
 
 // src/extract/aliases.ts
 init_cjs_shims();
-var import_node_path9 = __toESM(require("path"), 1);
-var import_node_fs9 = require("fs");
+var import_node_path11 = __toESM(require("path"), 1);
+var import_node_fs11 = require("fs");
 var import_yaml2 = require("yaml");
 var import_types7 = require("@neat.is/types");
 var K8S_KINDS_WITH_HOSTNAMES = /* @__PURE__ */ new Set([
@@ -3105,15 +3427,15 @@ function indexServicesByName(services) {
   const map = /* @__PURE__ */ new Map();
   for (const s of services) {
     map.set(s.node.name, s.node.id);
-    map.set(import_node_path9.default.basename(s.dir), s.node.id);
+    map.set(import_node_path11.default.basename(s.dir), s.node.id);
   }
   return map;
 }
 async function collectComposeAliases(graph, scanPath, serviceIndex) {
   let composePath = null;
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = import_node_path9.default.join(scanPath, name);
-    if (await exists(abs)) {
+    const abs = import_node_path11.default.join(scanPath, name);
+    if (await exists2(abs)) {
       composePath = abs;
       break;
     }
@@ -3125,7 +3447,7 @@ async function collectComposeAliases(graph, scanPath, serviceIndex) {
   } catch (err) {
     recordExtractionError(
       "aliases compose",
-      import_node_path9.default.relative(scanPath, composePath),
+      import_node_path11.default.relative(scanPath, composePath),
       err
     );
     return;
@@ -3168,11 +3490,11 @@ function parseDockerfileLabels(content) {
 }
 async function collectDockerfileAliases(graph, services) {
   for (const service of services) {
-    const dockerfilePath = import_node_path9.default.join(service.dir, "Dockerfile");
-    if (!await exists(dockerfilePath)) continue;
+    const dockerfilePath = import_node_path11.default.join(service.dir, "Dockerfile");
+    if (!await exists2(dockerfilePath)) continue;
     let content;
     try {
-      content = await import_node_fs9.promises.readFile(dockerfilePath, "utf8");
+      content = await import_node_fs11.promises.readFile(dockerfilePath, "utf8");
     } catch (err) {
       recordExtractionError("aliases dockerfile", dockerfilePath, err);
       continue;
@@ -3184,15 +3506,15 @@ async function collectDockerfileAliases(graph, services) {
 async function walkYamlFiles(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await import_node_fs9.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs11.promises.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name)) continue;
-      const child = import_node_path9.default.join(start, entry.name);
+      const child = import_node_path11.default.join(start, entry.name);
       if (await isPythonVenvDir(child)) continue;
       out.push(...await walkYamlFiles(child, depth + 1, max));
-    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path9.default.extname(entry.name))) {
-      out.push(import_node_path9.default.join(start, entry.name));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path11.default.extname(entry.name))) {
+      out.push(import_node_path11.default.join(start, entry.name));
     }
   }
   return out;
@@ -3219,7 +3541,7 @@ function k8sServiceTarget(doc, byName) {
 async function collectK8sAliases(graph, scanPath, serviceIndex) {
   const files = await walkYamlFiles(scanPath);
   for (const file of files) {
-    const content = await import_node_fs9.promises.readFile(file, "utf8");
+    const content = await import_node_fs11.promises.readFile(file, "utf8");
     let docs;
     try {
       docs = (0, import_yaml2.parseAllDocuments)(content).map((d) => d.toJSON());
@@ -3242,105 +3564,522 @@ async function addServiceAliases(graph, scanPath, services) {
   await collectK8sAliases(graph, scanPath, byName);
 }
 
-// src/extract/databases/index.ts
+// src/extract/files.ts
 init_cjs_shims();
-var import_node_path17 = __toESM(require("path"), 1);
-var import_types8 = require("@neat.is/types");
 
-// src/extract/databases/db-config-yaml.ts
+// src/extract/calls/shared.ts
 init_cjs_shims();
-var import_node_path10 = __toESM(require("path"), 1);
-async function parse(serviceDir) {
-  const yamlPath = import_node_path10.default.join(serviceDir, "db-config.yaml");
-  if (!await exists(yamlPath)) return [];
-  const raw = await readYaml(yamlPath);
-  return [
-    {
-      host: raw.host,
-      port: raw.port,
-      database: raw.database,
-      engine: raw.engine,
-      engineVersion: raw.engineVersion !== void 0 ? String(raw.engineVersion) : "unknown",
-      sourceFile: yamlPath
+var import_node_fs12 = require("fs");
+var import_node_path12 = __toESM(require("path"), 1);
+var import_types8 = require("@neat.is/types");
+async function walkSourceFiles(dir) {
+  const out = [];
+  async function walk(current) {
+    const entries = await import_node_fs12.promises.readdir(current, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+      const full = import_node_path12.default.join(current, entry.name);
+      if (entry.isDirectory()) {
+        if (IGNORED_DIRS.has(entry.name)) continue;
+        if (await isPythonVenvDir(full)) continue;
+        await walk(full);
+      } else if (entry.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path12.default.extname(entry.name))) {
+        out.push(full);
+      }
     }
-  ];
+  }
+  await walk(dir);
+  return out;
 }
-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);
-
-// src/extract/databases/shared.ts
-init_cjs_shims();
-var import_node_fs10 = require("fs");
-var import_node_path11 = __toESM(require("path"), 1);
-function schemeToEngine(scheme) {
-  const s = scheme.toLowerCase().split("+")[0];
-  switch (s) {
-    case "postgres":
-    case "postgresql":
-      return "postgresql";
-    case "mysql":
-    case "mariadb":
-      return "mysql";
-    case "mongodb":
-    case "mongodb+srv":
-      return "mongodb";
-    case "redis":
-    case "rediss":
-      return "redis";
-    case "sqlite":
-      return "sqlite";
-    default:
-      return null;
+async function loadSourceFiles(dir) {
+  const paths = await walkSourceFiles(dir);
+  const out = [];
+  for (const p of paths) {
+    try {
+      const content = await import_node_fs12.promises.readFile(p, "utf8");
+      out.push({ path: p, content });
+    } catch {
+    }
   }
+  return out;
 }
-function parseConnectionString(url) {
-  const m = url.match(
-    /^(?<scheme>[a-z][a-z+]*):\/\/(?:[^@/]+(?::[^@]*)?@)?(?<host>[^:/?]+)(?::(?<port>\d+))?(?:\/(?<db>[^?#]*))?/i
-  );
-  if (!m || !m.groups) return null;
-  const engine = schemeToEngine(m.groups.scheme);
-  if (!engine) return null;
-  return {
-    host: m.groups.host,
-    port: m.groups.port ? Number(m.groups.port) : void 0,
-    database: m.groups.db ?? "",
-    engine,
-    engineVersion: "unknown"
-  };
+function lineOf(text, needle) {
+  const idx = text.indexOf(needle);
+  if (idx < 0) return 1;
+  return text.slice(0, idx).split("\n").length;
 }
-async function readIfExists(filePath) {
-  try {
-    return await import_node_fs10.promises.readFile(filePath, "utf8");
-  } catch {
-    return null;
-  }
+function snippet(text, line) {
+  const lines = text.split("\n");
+  return (lines[line - 1] ?? "").trim();
 }
-async function findFirst(serviceDir, candidates) {
-  for (const rel of candidates) {
-    const abs = import_node_path11.default.join(serviceDir, rel);
-    const content = await readIfExists(abs);
-    if (content !== null) return abs;
+function toPosix2(p) {
+  return p.split("\\").join("/");
+}
+function languageForPath(relPath) {
+  switch (import_node_path12.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;
   }
-  return null;
 }
-function engineFromImage(image) {
-  const lower = image.toLowerCase();
-  const colon = lower.lastIndexOf(":");
-  const repo = colon >= 0 ? lower.slice(0, colon) : lower;
-  const tag = colon >= 0 ? lower.slice(colon + 1) : "latest";
-  const last = repo.split("/").pop() ?? repo;
-  let engine = null;
-  if (last.startsWith("postgres")) engine = "postgresql";
-  else if (last.startsWith("mysql") || last.startsWith("mariadb")) engine = "mysql";
-  else if (last.startsWith("mongo")) engine = "mongodb";
-  else if (last.startsWith("redis")) engine = "redis";
-  else if (last.startsWith("sqlite")) engine = "sqlite";
-  if (!engine) return null;
-  const versionMatch = tag.match(/^(\d+(?:\.\d+){0,2})/);
+function ensureFileNode(graph, serviceName, serviceNodeId, relPath) {
+  let nodesAdded = 0;
+  let edgesAdded = 0;
+  const fileNodeId = (0, import_types8.fileId)(serviceName, relPath);
+  if (!graph.hasNode(fileNodeId)) {
+    const language = languageForPath(relPath);
+    const node = {
+      id: fileNodeId,
+      type: import_types8.NodeType.FileNode,
+      service: serviceName,
+      path: relPath,
+      ...language ? { language } : {},
+      discoveredVia: "static"
+    };
+    graph.addNode(fileNodeId, node);
+    nodesAdded++;
+  }
+  const containsId = (0, import_types8.extractedEdgeId)(serviceNodeId, fileNodeId, import_types8.EdgeType.CONTAINS);
+  if (!graph.hasEdge(containsId)) {
+    const edge = {
+      id: containsId,
+      source: serviceNodeId,
+      target: fileNodeId,
+      type: import_types8.EdgeType.CONTAINS,
+      provenance: import_types8.Provenance.EXTRACTED,
+      confidence: (0, import_types8.confidenceForExtracted)("structural"),
+      evidence: { file: relPath }
+    };
+    graph.addEdgeWithKey(containsId, serviceNodeId, fileNodeId, edge);
+    edgesAdded++;
+  }
+  return { fileNodeId, nodesAdded, edgesAdded };
+}
+
+// src/extract/files.ts
+var import_node_path13 = __toESM(require("path"), 1);
+async function addFiles(graph, services) {
+  let nodesAdded = 0;
+  let edgesAdded = 0;
+  for (const service of services) {
+    const filePaths = await walkSourceFiles(service.dir);
+    for (const filePath of filePaths) {
+      const relPath = toPosix2(import_node_path13.default.relative(service.dir, filePath));
+      const { nodesAdded: n, edgesAdded: e } = ensureFileNode(
+        graph,
+        service.pkg.name,
+        service.node.id,
+        relPath
+      );
+      nodesAdded += n;
+      edgesAdded += e;
+    }
+  }
+  return { nodesAdded, edgesAdded };
+}
+
+// src/extract/imports.ts
+init_cjs_shims();
+var import_node_path14 = __toESM(require("path"), 1);
+var import_node_fs13 = require("fs");
+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_types9 = require("@neat.is/types");
+var PARSE_CHUNK = 16384;
+function parseSource(parser, source) {
+  return parser.parse(
+    (index) => index >= source.length ? "" : source.slice(index, index + PARSE_CHUNK)
+  );
+}
+function makeJsParser() {
+  const p = new import_tree_sitter.default();
+  p.setLanguage(import_tree_sitter_javascript.default);
+  return p;
+}
+function makePyParser() {
+  const p = new import_tree_sitter.default();
+  p.setLanguage(import_tree_sitter_python.default);
+  return p;
+}
+function stringLiteralText(node) {
+  for (let i = 0; i < node.childCount; i++) {
+    const child = node.child(i);
+    if (child?.type === "string_fragment") return child.text;
+  }
+  const raw = node.text;
+  if (raw.length >= 2) return raw.slice(1, -1);
+  return raw.length === 0 ? null : "";
+}
+function clipSnippet(text) {
+  const oneLine = text.split("\n")[0] ?? text;
+  return oneLine.length > 120 ? oneLine.slice(0, 120) : oneLine;
+}
+function collectJsImports(node, out) {
+  if (node.type === "import_statement") {
+    const source = node.childForFieldName("source");
+    if (source) {
+      const specifier = stringLiteralText(source);
+      if (specifier) {
+        out.push({ specifier, line: node.startPosition.row + 1, snippet: clipSnippet(node.text) });
+      }
+    }
+    return;
+  }
+  if (node.type === "call_expression") {
+    const fn = node.childForFieldName("function");
+    if (fn?.type === "identifier" && fn.text === "require") {
+      const args = node.childForFieldName("arguments");
+      const firstArg = args?.namedChild(0);
+      if (firstArg?.type === "string") {
+        const specifier = stringLiteralText(firstArg);
+        if (specifier) {
+          out.push({ specifier, line: node.startPosition.row + 1, snippet: clipSnippet(node.text) });
+        }
+      }
+    }
+  }
+  for (let i = 0; i < node.namedChildCount; i++) {
+    const child = node.namedChild(i);
+    if (child) collectJsImports(child, out);
+  }
+}
+function collectPyImports(node, out) {
+  if (node.type === "import_from_statement") {
+    let level = 0;
+    let modulePath = "";
+    let pastFrom = false;
+    for (let i = 0; i < node.childCount; i++) {
+      const child = node.child(i);
+      if (!child) continue;
+      if (!pastFrom) {
+        if (child.type === "from") pastFrom = true;
+        continue;
+      }
+      if (child.type === "import") break;
+      if (child.type === "relative_import") {
+        for (let j = 0; j < child.childCount; j++) {
+          const rc = child.child(j);
+          if (!rc) continue;
+          if (rc.type === "import_prefix") {
+            for (let k = 0; k < rc.childCount; k++) {
+              if (rc.child(k)?.type === ".") level++;
+            }
+          } else if (rc.type === "dotted_name") modulePath = rc.text;
+        }
+        break;
+      }
+      if (child.type === "dotted_name") {
+        modulePath = child.text;
+        break;
+      }
+    }
+    if (level > 0 || modulePath) {
+      out.push({ modulePath, level, line: node.startPosition.row + 1, snippet: clipSnippet(node.text) });
+    }
+  }
+  for (let i = 0; i < node.namedChildCount; i++) {
+    const child = node.namedChild(i);
+    if (child) collectPyImports(child, out);
+  }
+}
+async function fileExists2(p) {
+  try {
+    await import_node_fs13.promises.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isWithinServiceDir(candidate, serviceDir) {
+  const rel = import_node_path14.default.relative(serviceDir, candidate);
+  return rel !== "" && !rel.startsWith("..") && !import_node_path14.default.isAbsolute(rel);
+}
+var JS_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+var JS_INDEX_FILES = JS_EXTENSIONS.map((ext) => `index${ext}`);
+async function firstExistingCandidate(base, serviceDir) {
+  for (const ext of JS_EXTENSIONS) {
+    const candidate = base + ext;
+    if (isWithinServiceDir(candidate, serviceDir) && await fileExists2(candidate)) {
+      return toPosix2(import_node_path14.default.relative(serviceDir, candidate));
+    }
+  }
+  for (const indexFile of JS_INDEX_FILES) {
+    const candidate = import_node_path14.default.join(base, indexFile);
+    if (isWithinServiceDir(candidate, serviceDir) && await fileExists2(candidate)) {
+      return toPosix2(import_node_path14.default.relative(serviceDir, candidate));
+    }
+  }
+  return null;
+}
+async function loadTsPathConfig(serviceDir) {
+  const tsconfigPath = import_node_path14.default.join(serviceDir, "tsconfig.json");
+  let raw;
+  try {
+    raw = await import_node_fs13.promises.readFile(tsconfigPath, "utf8");
+  } catch {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    const paths = parsed.compilerOptions?.paths;
+    if (!paths || Object.keys(paths).length === 0) return null;
+    const baseUrl = parsed.compilerOptions?.baseUrl;
+    return { paths, baseDir: baseUrl ? import_node_path14.default.resolve(serviceDir, baseUrl) : serviceDir };
+  } catch (err) {
+    recordExtractionError("import alias resolution", tsconfigPath, err);
+    return null;
+  }
+}
+async function resolveTsAlias(specifier, config, serviceDir) {
+  for (const [pattern, targets] of Object.entries(config.paths)) {
+    let suffix = null;
+    if (pattern === specifier) {
+      suffix = "";
+    } else if (pattern.endsWith("/*")) {
+      const prefix = pattern.slice(0, -1);
+      if (specifier.startsWith(prefix)) suffix = specifier.slice(prefix.length);
+    }
+    if (suffix === null) continue;
+    for (const target of targets) {
+      const targetBase = target.endsWith("/*") ? target.slice(0, -2) : target.replace(/\*$/, "");
+      const resolvedBase = import_node_path14.default.resolve(config.baseDir, targetBase, suffix);
+      const hit = await firstExistingCandidate(resolvedBase, serviceDir);
+      if (hit) return hit;
+      if (isWithinServiceDir(resolvedBase, serviceDir) && await fileExists2(resolvedBase)) {
+        return toPosix2(import_node_path14.default.relative(serviceDir, resolvedBase));
+      }
+    }
+  }
+  return null;
+}
+async function resolveJsImport(specifier, importerDir, serviceDir, tsPaths) {
+  if (!specifier) return null;
+  if (specifier.startsWith("./") || specifier.startsWith("../")) {
+    const base = import_node_path14.default.resolve(importerDir, specifier);
+    const ext = import_node_path14.default.extname(specifier);
+    if (ext) {
+      if (ext === ".js" || ext === ".jsx") {
+        const tsExt = ext === ".jsx" ? ".tsx" : ".ts";
+        const tsSibling = base.slice(0, -ext.length) + tsExt;
+        if (isWithinServiceDir(tsSibling, serviceDir) && await fileExists2(tsSibling)) {
+          return toPosix2(import_node_path14.default.relative(serviceDir, tsSibling));
+        }
+      }
+      if (isWithinServiceDir(base, serviceDir) && await fileExists2(base)) {
+        return toPosix2(import_node_path14.default.relative(serviceDir, base));
+      }
+      return null;
+    }
+    return firstExistingCandidate(base, serviceDir);
+  }
+  if (tsPaths) return resolveTsAlias(specifier, tsPaths, serviceDir);
+  return null;
+}
+async function resolvePyImport(imp, importerPath, serviceDir) {
+  if (!imp.modulePath) return null;
+  const relPath = imp.modulePath.split(".").join("/");
+  let baseDir;
+  if (imp.level > 0) {
+    baseDir = import_node_path14.default.dirname(importerPath);
+    for (let i = 1; i < imp.level; i++) baseDir = import_node_path14.default.dirname(baseDir);
+  } else {
+    baseDir = serviceDir;
+  }
+  const candidates = [import_node_path14.default.join(baseDir, `${relPath}.py`), import_node_path14.default.join(baseDir, relPath, "__init__.py")];
+  for (const candidate of candidates) {
+    if (isWithinServiceDir(candidate, serviceDir) && await fileExists2(candidate)) {
+      return toPosix2(import_node_path14.default.relative(serviceDir, candidate));
+    }
+  }
+  return null;
+}
+function emitImportEdge(graph, serviceName, importerFileId, importerRelPath, importeeRelPath, line, snippet2) {
+  const importeeFileId = (0, import_types9.fileId)(serviceName, importeeRelPath);
+  if (!graph.hasNode(importeeFileId)) return 0;
+  const edgeId = (0, import_types9.extractedEdgeId)(importerFileId, importeeFileId, import_types9.EdgeType.IMPORTS);
+  if (graph.hasEdge(edgeId)) return 0;
+  const edge = {
+    id: edgeId,
+    source: importerFileId,
+    target: importeeFileId,
+    type: import_types9.EdgeType.IMPORTS,
+    provenance: import_types9.Provenance.EXTRACTED,
+    confidence: (0, import_types9.confidenceForExtracted)("structural"),
+    evidence: { file: importerRelPath, line, snippet: snippet2 }
+  };
+  graph.addEdgeWithKey(edgeId, importerFileId, importeeFileId, edge);
+  return 1;
+}
+async function addImports(graph, services) {
+  const jsParser = makeJsParser();
+  const pyParser = makePyParser();
+  let edgesAdded = 0;
+  for (const service of services) {
+    const tsPaths = await loadTsPathConfig(service.dir);
+    const files = await loadSourceFiles(service.dir);
+    for (const file of files) {
+      if (isTestPath(file.path)) continue;
+      const relFile = toPosix2(import_node_path14.default.relative(service.dir, file.path));
+      const importerFileId = (0, import_types9.fileId)(service.pkg.name, relFile);
+      const isPython = import_node_path14.default.extname(file.path) === ".py";
+      if (isPython) {
+        let pyImports = [];
+        try {
+          const tree = parseSource(pyParser, file.content);
+          collectPyImports(tree.rootNode, pyImports);
+        } catch (err) {
+          recordExtractionError("import extraction", file.path, err);
+          continue;
+        }
+        for (const imp of pyImports) {
+          const resolved = await resolvePyImport(imp, file.path, service.dir);
+          if (!resolved) continue;
+          edgesAdded += emitImportEdge(
+            graph,
+            service.pkg.name,
+            importerFileId,
+            relFile,
+            resolved,
+            imp.line,
+            imp.snippet
+          );
+        }
+        continue;
+      }
+      let jsImports = [];
+      try {
+        const tree = parseSource(jsParser, file.content);
+        collectJsImports(tree.rootNode, jsImports);
+      } catch (err) {
+        recordExtractionError("import extraction", file.path, err);
+        continue;
+      }
+      for (const imp of jsImports) {
+        const resolved = await resolveJsImport(imp.specifier, import_node_path14.default.dirname(file.path), service.dir, tsPaths);
+        if (!resolved) continue;
+        edgesAdded += emitImportEdge(
+          graph,
+          service.pkg.name,
+          importerFileId,
+          relFile,
+          resolved,
+          imp.line,
+          imp.snippet
+        );
+      }
+    }
+  }
+  return { nodesAdded: 0, edgesAdded };
+}
+
+// src/extract/databases/index.ts
+init_cjs_shims();
+var import_node_path22 = __toESM(require("path"), 1);
+var import_types10 = require("@neat.is/types");
+
+// src/extract/databases/db-config-yaml.ts
+init_cjs_shims();
+var import_node_path15 = __toESM(require("path"), 1);
+async function parse(serviceDir) {
+  const yamlPath = import_node_path15.default.join(serviceDir, "db-config.yaml");
+  if (!await exists2(yamlPath)) return [];
+  const raw = await readYaml(yamlPath);
+  return [
+    {
+      host: raw.host,
+      port: raw.port,
+      database: raw.database,
+      engine: raw.engine,
+      engineVersion: raw.engineVersion !== void 0 ? String(raw.engineVersion) : "unknown",
+      sourceFile: yamlPath
+    }
+  ];
+}
+var dbConfigYamlParser = { name: "db-config.yaml", parse };
+
+// src/extract/databases/dotenv.ts
+init_cjs_shims();
+var import_node_fs15 = require("fs");
+var import_node_path17 = __toESM(require("path"), 1);
+
+// src/extract/databases/shared.ts
+init_cjs_shims();
+var import_node_fs14 = require("fs");
+var import_node_path16 = __toESM(require("path"), 1);
+function schemeToEngine(scheme) {
+  const s = scheme.toLowerCase().split("+")[0];
+  switch (s) {
+    case "postgres":
+    case "postgresql":
+      return "postgresql";
+    case "mysql":
+    case "mariadb":
+      return "mysql";
+    case "mongodb":
+    case "mongodb+srv":
+      return "mongodb";
+    case "redis":
+    case "rediss":
+      return "redis";
+    case "sqlite":
+      return "sqlite";
+    default:
+      return null;
+  }
+}
+function parseConnectionString(url) {
+  const m = url.match(
+    /^(?<scheme>[a-z][a-z+]*):\/\/(?:[^@/]+(?::[^@]*)?@)?(?<host>[^:/?]+)(?::(?<port>\d+))?(?:\/(?<db>[^?#]*))?/i
+  );
+  if (!m || !m.groups) return null;
+  const engine = schemeToEngine(m.groups.scheme);
+  if (!engine) return null;
+  return {
+    host: m.groups.host,
+    port: m.groups.port ? Number(m.groups.port) : void 0,
+    database: m.groups.db ?? "",
+    engine,
+    engineVersion: "unknown"
+  };
+}
+async function readIfExists(filePath) {
+  try {
+    return await import_node_fs14.promises.readFile(filePath, "utf8");
+  } catch {
+    return null;
+  }
+}
+async function findFirst(serviceDir, candidates) {
+  for (const rel of candidates) {
+    const abs = import_node_path16.default.join(serviceDir, rel);
+    const content = await readIfExists(abs);
+    if (content !== null) return abs;
+  }
+  return null;
+}
+function engineFromImage(image) {
+  const lower = image.toLowerCase();
+  const colon = lower.lastIndexOf(":");
+  const repo = colon >= 0 ? lower.slice(0, colon) : lower;
+  const tag = colon >= 0 ? lower.slice(colon + 1) : "latest";
+  const last = repo.split("/").pop() ?? repo;
+  let engine = null;
+  if (last.startsWith("postgres")) engine = "postgresql";
+  else if (last.startsWith("mysql") || last.startsWith("mariadb")) engine = "mysql";
+  else if (last.startsWith("mongo")) engine = "mongodb";
+  else if (last.startsWith("redis")) engine = "redis";
+  else if (last.startsWith("sqlite")) engine = "sqlite";
+  if (!engine) return null;
+  const versionMatch = tag.match(/^(\d+(?:\.\d+){0,2})/);
   return {
     engine,
     engineVersion: versionMatch ? versionMatch[1] : "unknown"
@@ -3372,15 +4111,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_fs15.promises.readdir(serviceDir, { withFileTypes: true }).catch(() => []);
   const configs = [];
   const seen = /* @__PURE__ */ new Set();
   for (const entry of entries) {
     if (!entry.isFile()) continue;
     const match = isConfigFile(entry.name);
     if (!match.match || match.fileType !== "env") continue;
-    const filePath = import_node_path12.default.join(serviceDir, entry.name);
-    const content = await import_node_fs11.promises.readFile(filePath, "utf8");
+    const filePath = import_node_path17.default.join(serviceDir, entry.name);
+    const content = await import_node_fs15.promises.readFile(filePath, "utf8");
     for (const line of content.split("\n")) {
       const parsed = parseDotenvLine(line);
       if (!parsed) continue;
@@ -3399,9 +4138,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_path18 = __toESM(require("path"), 1);
 async function parse3(serviceDir) {
-  const schemaPath = import_node_path13.default.join(serviceDir, "prisma", "schema.prisma");
+  const schemaPath = import_node_path18.default.join(serviceDir, "prisma", "schema.prisma");
   const content = await readIfExists(schemaPath);
   if (!content) return [];
   const block = content.match(/datasource\s+\w+\s*\{([^}]*)\}/s);
@@ -3533,11 +4272,11 @@ 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_path19 = __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);
-    if (!await exists(abs)) continue;
+    const abs = import_node_path19.default.join(serviceDir, candidate);
+    if (!await exists2(abs)) continue;
     const raw = candidate.endsWith(".json") ? await readJson(abs) : await readYaml(abs);
     const entries = Array.isArray(raw) ? raw : [raw];
     const out = [];
@@ -3596,10 +4335,10 @@ 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_path20 = __toESM(require("path"), 1);
 async function parse8(serviceDir) {
-  const configPath = import_node_path15.default.join(serviceDir, "config", "config.json");
-  if (!await exists(configPath)) return [];
+  const configPath = import_node_path20.default.join(serviceDir, "config", "config.json");
+  if (!await exists2(configPath)) return [];
   const raw = await readJson(configPath);
   const out = [];
   const seen = /* @__PURE__ */ new Set();
@@ -3625,7 +4364,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_path21 = __toESM(require("path"), 1);
 function portFromService(svc) {
   for (const raw of svc.ports ?? []) {
     const str = String(raw);
@@ -3652,8 +4391,8 @@ 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);
-    if (!await exists(abs)) continue;
+    const abs = import_node_path21.default.join(serviceDir, name);
+    if (!await exists2(abs)) continue;
     const raw = await readYaml(abs);
     if (!raw?.services) return [];
     const out = [];
@@ -3693,8 +4432,8 @@ function compatibleDriversFor(engine) {
 }
 function toDatabaseNode(config) {
   return {
-    id: (0, import_types8.databaseId)(config.host),
-    type: import_types8.NodeType.DatabaseNode,
+    id: (0, import_types10.databaseId)(config.host),
+    type: import_types10.NodeType.DatabaseNode,
     name: config.database || config.host,
     engine: config.engine,
     engineVersion: config.engineVersion,
@@ -3824,19 +4563,24 @@ async function addDatabasesAndCompat(graph, services, scanPath) {
           discoveredVia: mergedDiscoveredVia
         });
       }
+      const relConfigFile = toPosix2(import_node_path22.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_path22.default.relative(scanPath, config.sourceFile));
       const edge = {
-        id: (0, import_types5.extractedEdgeId)(service.node.id, dbNode.id, import_types8.EdgeType.CONNECTS_TO),
-        source: service.node.id,
+        id: (0, import_types5.extractedEdgeId)(fileNodeId, dbNode.id, import_types10.EdgeType.CONNECTS_TO),
+        source: fileNodeId,
         target: dbNode.id,
-        type: import_types8.EdgeType.CONNECTS_TO,
-        provenance: import_types8.Provenance.EXTRACTED,
-        confidence: (0, import_types8.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_types10.EdgeType.CONNECTS_TO,
+        provenance: import_types10.Provenance.EXTRACTED,
+        confidence: (0, import_types10.confidenceForExtracted)("structural"),
+        evidence: { file: evidenceFile }
       };
       if (!graph.hasEdge(edge.id)) {
         graph.addEdgeWithKey(edge.id, edge.source, edge.target, edge);
@@ -3862,15 +4606,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_types9 = require("@neat.is/types");
+var import_node_fs16 = require("fs");
+var import_node_path23 = __toESM(require("path"), 1);
+var import_types11 = 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_fs16.promises.readdir(current, { withFileTypes: true });
     for (const entry of entries) {
-      const full = import_node_path18.default.join(current, entry.name);
+      const full = import_node_path23.default.join(current, entry.name);
       if (entry.isDirectory()) {
         if (IGNORED_DIRS.has(entry.name)) continue;
         if (await isPythonVenvDir(full)) continue;
@@ -3889,26 +4633,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_path23.default.relative(scanPath, file);
       const node = {
-        id: (0, import_types9.configId)(relPath),
-        type: import_types9.NodeType.ConfigNode,
-        name: import_node_path18.default.basename(file),
+        id: (0, import_types11.configId)(relPath),
+        type: import_types11.NodeType.ConfigNode,
+        name: import_node_path23.default.basename(file),
         path: relPath,
-        fileType: isConfigFile(import_node_path18.default.basename(file)).fileType
+        fileType: isConfigFile(import_node_path23.default.basename(file)).fileType
       };
       if (!graph.hasNode(node.id)) {
         graph.addNode(node.id, node);
         nodesAdded++;
       }
+      const relToService = toPosix2(import_node_path23.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_types5.extractedEdgeId)(service.node.id, node.id, import_types9.EdgeType.CONFIGURED_BY),
-        source: service.node.id,
+        id: (0, import_types5.extractedEdgeId)(fileNodeId, node.id, import_types11.EdgeType.CONFIGURED_BY),
+        source: fileNodeId,
         target: node.id,
-        type: import_types9.EdgeType.CONFIGURED_BY,
-        provenance: import_types9.Provenance.EXTRACTED,
-        confidence: (0, import_types9.confidenceForExtracted)("structural"),
-        evidence: { file: relPath.split(import_node_path18.default.sep).join("/") }
+        type: import_types11.EdgeType.CONFIGURED_BY,
+        provenance: import_types11.Provenance.EXTRACTED,
+        confidence: (0, import_types11.confidenceForExtracted)("structural"),
+        evidence: { file: relPath.split(import_node_path23.default.sep).join("/") }
       };
       if (!graph.hasEdge(edge.id)) {
         graph.addEdgeWithKey(edge.id, edge.source, edge.target, edge);
@@ -3921,114 +4674,15 @@ async function addConfigNodes(graph, services, scanPath) {
 
 // src/extract/calls/index.ts
 init_cjs_shims();
-var import_types16 = require("@neat.is/types");
+var import_types17 = require("@neat.is/types");
 
 // src/extract/calls/http.ts
 init_cjs_shims();
-var import_node_path20 = __toESM(require("path"), 1);
-var import_tree_sitter = __toESM(require("tree-sitter"), 1);
-var import_tree_sitter_javascript = __toESM(require("tree-sitter-javascript"), 1);
-var import_tree_sitter_python = __toESM(require("tree-sitter-python"), 1);
-var import_types11 = 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_types10 = 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 entry of entries) {
-      const full = import_node_path19.default.join(current, entry.name);
-      if (entry.isDirectory()) {
-        if (IGNORED_DIRS.has(entry.name)) continue;
-        if (await isPythonVenvDir(full)) continue;
-        await walk(full);
-      } else if (entry.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path19.default.extname(entry.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_types10.fileId)(serviceName, relPath);
-  if (!graph.hasNode(fileNodeId)) {
-    const language = languageForPath(relPath);
-    const node = {
-      id: fileNodeId,
-      type: import_types10.NodeType.FileNode,
-      service: serviceName,
-      path: relPath,
-      ...language ? { language } : {},
-      discoveredVia: "static"
-    };
-    graph.addNode(fileNodeId, node);
-    nodesAdded++;
-  }
-  const containsId = (0, import_types10.extractedEdgeId)(serviceNodeId, fileNodeId, import_types10.EdgeType.CONTAINS);
-  if (!graph.hasEdge(containsId)) {
-    const edge = {
-      id: containsId,
-      source: serviceNodeId,
-      target: fileNodeId,
-      type: import_types10.EdgeType.CONTAINS,
-      provenance: import_types10.Provenance.EXTRACTED,
-      confidence: (0, import_types10.confidenceForExtracted)("structural"),
-      evidence: { file: relPath }
-    };
-    graph.addEdgeWithKey(containsId, serviceNodeId, fileNodeId, edge);
-    edgesAdded++;
-  }
-  return { fileNodeId, nodesAdded, edgesAdded };
-}
-
-// src/extract/calls/http.ts
+var import_node_path24 = __toESM(require("path"), 1);
+var import_tree_sitter2 = __toESM(require("tree-sitter"), 1);
+var import_tree_sitter_javascript2 = __toESM(require("tree-sitter-javascript"), 1);
+var import_tree_sitter_python2 = __toESM(require("tree-sitter-python"), 1);
+var import_types12 = require("@neat.is/types");
 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) {
@@ -4056,14 +4710,14 @@ function collectStringLiterals(node, out) {
     if (child) collectStringLiterals(child, out);
   }
 }
-var PARSE_CHUNK = 16384;
-function parseSource(parser, source) {
+var PARSE_CHUNK2 = 16384;
+function parseSource2(parser, source) {
   return parser.parse(
-    (index) => index >= source.length ? "" : source.slice(index, index + PARSE_CHUNK)
+    (index) => index >= source.length ? "" : source.slice(index, index + PARSE_CHUNK2)
   );
 }
 function callsFromSource(source, parser, knownHosts) {
-  const tree = parseSource(parser, source);
+  const tree = parseSource2(parser, source);
   const literals = [];
   collectStringLiterals(tree.rootNode, literals);
   const out = [];
@@ -4077,25 +4731,25 @@ function callsFromSource(source, parser, knownHosts) {
   }
   return out;
 }
-function makeJsParser() {
-  const p = new import_tree_sitter.default();
-  p.setLanguage(import_tree_sitter_javascript.default);
+function makeJsParser2() {
+  const p = new import_tree_sitter2.default();
+  p.setLanguage(import_tree_sitter_javascript2.default);
   return p;
 }
-function makePyParser() {
-  const p = new import_tree_sitter.default();
-  p.setLanguage(import_tree_sitter_python.default);
+function makePyParser2() {
+  const p = new import_tree_sitter2.default();
+  p.setLanguage(import_tree_sitter_python2.default);
   return p;
 }
 async function addHttpCallEdges(graph, services) {
-  const jsParser = makeJsParser();
-  const pyParser = makePyParser();
+  const jsParser = makeJsParser2();
+  const pyParser = makePyParser2();
   const knownHosts = /* @__PURE__ */ new Set();
   const hostToNodeId = /* @__PURE__ */ new Map();
   for (const service of services) {
-    knownHosts.add(import_node_path20.default.basename(service.dir));
+    knownHosts.add(import_node_path24.default.basename(service.dir));
     knownHosts.add(service.pkg.name);
-    hostToNodeId.set(import_node_path20.default.basename(service.dir), service.node.id);
+    hostToNodeId.set(import_node_path24.default.basename(service.dir), service.node.id);
     hostToNodeId.set(service.pkg.name, service.node.id);
   }
   let nodesAdded = 0;
@@ -4105,7 +4759,7 @@ async function addHttpCallEdges(graph, services) {
     const seen = /* @__PURE__ */ new Set();
     for (const file of files) {
       if (isTestPath(file.path)) continue;
-      const parser = import_node_path20.default.extname(file.path) === ".py" ? pyParser : jsParser;
+      const parser = import_node_path24.default.extname(file.path) === ".py" ? pyParser : jsParser;
       let sites;
       try {
         sites = callsFromSource(file.content, parser, knownHosts);
@@ -4114,14 +4768,14 @@ async function addHttpCallEdges(graph, services) {
         continue;
       }
       if (sites.length === 0) continue;
-      const relFile = toPosix2(import_node_path20.default.relative(service.dir, file.path));
+      const relFile = toPosix2(import_node_path24.default.relative(service.dir, file.path));
       for (const site of sites) {
         const targetId = hostToNodeId.get(site.host);
         if (!targetId || targetId === service.node.id) continue;
         const dedupKey = `${relFile}|${targetId}`;
         if (seen.has(dedupKey)) continue;
         seen.add(dedupKey);
-        const confidence = (0, import_types11.confidenceForExtracted)("hostname-shape-match");
+        const confidence = (0, import_types12.confidenceForExtracted)("hostname-shape-match");
         const ev = {
           file: relFile,
           line: site.line,
@@ -4135,25 +4789,25 @@ async function addHttpCallEdges(graph, services) {
         );
         nodesAdded += n;
         edgesAdded += e;
-        if (!(0, import_types11.passesExtractedFloor)(confidence)) {
+        if (!(0, import_types12.passesExtractedFloor)(confidence)) {
           noteExtractedDropped({
             source: fileNodeId,
             target: targetId,
-            type: import_types11.EdgeType.CALLS,
+            type: import_types12.EdgeType.CALLS,
             confidence,
             confidenceKind: "hostname-shape-match",
             evidence: ev
           });
           continue;
         }
-        const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, targetId, import_types11.EdgeType.CALLS);
+        const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, targetId, import_types12.EdgeType.CALLS);
         if (!graph.hasEdge(edgeId)) {
           const edge = {
             id: edgeId,
             source: fileNodeId,
             target: targetId,
-            type: import_types11.EdgeType.CALLS,
-            provenance: import_types11.Provenance.EXTRACTED,
+            type: import_types12.EdgeType.CALLS,
+            provenance: import_types12.Provenance.EXTRACTED,
             confidence,
             evidence: ev
           };
@@ -4168,8 +4822,8 @@ async function addHttpCallEdges(graph, services) {
 
 // src/extract/calls/kafka.ts
 init_cjs_shims();
-var import_node_path21 = __toESM(require("path"), 1);
-var import_types12 = require("@neat.is/types");
+var import_node_path25 = __toESM(require("path"), 1);
+var import_types13 = require("@neat.is/types");
 var PRODUCER_TOPIC_RE = /(?:producer|kafkaProducer)[\s\S]{0,40}?\.send\s*\(\s*\{[\s\S]{0,200}?topic\s*:\s*['"`]([^'"`]+)['"`]/g;
 var CONSUMER_TOPIC_RE = /(?:consumer|kafkaConsumer)[\s\S]{0,40}?\.(?:subscribe|run)\s*\(\s*\{[\s\S]{0,200}?topic[s]?\s*:\s*(?:\[\s*)?['"`]([^'"`]+)['"`]/g;
 function findAll(re, text) {
@@ -4190,7 +4844,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
     seen.add(key);
     const line = lineOf(file.content, topic);
     out.push({
-      infraId: (0, import_types12.infraId)("kafka-topic", topic),
+      infraId: (0, import_types13.infraId)("kafka-topic", topic),
       name: topic,
       kind: "kafka-topic",
       edgeType,
@@ -4199,7 +4853,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path21.default.relative(serviceDir, file.path),
+        file: import_node_path25.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -4212,8 +4866,8 @@ function kafkaEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/redis.ts
 init_cjs_shims();
-var import_node_path22 = __toESM(require("path"), 1);
-var import_types13 = require("@neat.is/types");
+var import_node_path26 = __toESM(require("path"), 1);
+var import_types14 = require("@neat.is/types");
 var REDIS_URL_RE = /redis(?:s)?:\/\/(?:[^@'"`\s]+@)?([^:/'"`\s]+)(?::(\d+))?/g;
 function redisEndpointsFromFile(file, serviceDir) {
   const out = [];
@@ -4226,7 +4880,7 @@ function redisEndpointsFromFile(file, serviceDir) {
     seen.add(host);
     const line = lineOf(file.content, host);
     out.push({
-      infraId: (0, import_types13.infraId)("redis", host),
+      infraId: (0, import_types14.infraId)("redis", host),
       name: host,
       kind: "redis",
       edgeType: "CALLS",
@@ -4235,7 +4889,7 @@ function redisEndpointsFromFile(file, serviceDir) {
       // support tier (ADR-066).
       confidenceKind: "url-with-structural-support",
       evidence: {
-        file: import_node_path22.default.relative(serviceDir, file.path),
+        file: import_node_path26.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -4246,8 +4900,8 @@ function redisEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/aws.ts
 init_cjs_shims();
-var import_node_path23 = __toESM(require("path"), 1);
-var import_types14 = require("@neat.is/types");
+var import_node_path27 = __toESM(require("path"), 1);
+var import_types15 = require("@neat.is/types");
 var S3_BUCKET_RE = /Bucket\s*:\s*['"`]([^'"`]+)['"`]/g;
 var DYNAMO_TABLE_RE = /TableName\s*:\s*['"`]([^'"`]+)['"`]/g;
 function hasMarker(text, markers) {
@@ -4271,7 +4925,7 @@ function awsEndpointsFromFile(file, serviceDir) {
     seen.add(key);
     const line = lineOf(file.content, name);
     out.push({
-      infraId: (0, import_types14.infraId)(kind, name),
+      infraId: (0, import_types15.infraId)(kind, name),
       name,
       kind,
       edgeType: "CALLS",
@@ -4280,7 +4934,7 @@ function awsEndpointsFromFile(file, serviceDir) {
       // (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path23.default.relative(serviceDir, file.path),
+        file: import_node_path27.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -4305,13 +4959,14 @@ function awsEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/grpc.ts
 init_cjs_shims();
-var import_node_path24 = __toESM(require("path"), 1);
-var import_types15 = require("@neat.is/types");
+var import_node_path28 = __toESM(require("path"), 1);
+var import_types16 = require("@neat.is/types");
 var GRPC_CLIENT_RE = /new\s+([A-Z][A-Za-z0-9_]*)Client\s*\(\s*['"`]?([^,'"`)]+)?/g;
 var AWS_SDK_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@aws-sdk\/client-([a-z0-9-]+)['"`]/g;
 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) {
@@ -4354,7 +5009,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
     const { kind } = classified;
     const line = lineOf(file.content, m[0]);
     out.push({
-      infraId: (0, import_types15.infraId)(kind, name),
+      infraId: (0, import_types16.infraId)(kind, name),
       name,
       kind,
       edgeType: "CALLS",
@@ -4363,7 +5018,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path24.default.relative(serviceDir, file.path),
+        file: import_node_path28.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -4376,11 +5031,11 @@ function grpcEndpointsFromFile(file, serviceDir) {
 function edgeTypeFromEndpoint(ep) {
   switch (ep.edgeType) {
     case "PUBLISHES_TO":
-      return import_types16.EdgeType.PUBLISHES_TO;
+      return import_types17.EdgeType.PUBLISHES_TO;
     case "CONSUMES_FROM":
-      return import_types16.EdgeType.CONSUMES_FROM;
+      return import_types17.EdgeType.CONSUMES_FROM;
     default:
-      return import_types16.EdgeType.CALLS;
+      return import_types17.EdgeType.CALLS;
   }
 }
 function isAwsKind(kind) {
@@ -4407,7 +5062,7 @@ async function addExternalEndpointEdges(graph, services) {
       if (!graph.hasNode(ep.infraId)) {
         const node = {
           id: ep.infraId,
-          type: import_types16.NodeType.InfraNode,
+          type: import_types17.NodeType.InfraNode,
           name: ep.name,
           // #238 — `aws-*` covers AWS-SDK client kinds (aws-s3, aws-dynamodb,
           // aws-cognito-identity-provider, …); `s3-` / `dynamodb-` cover the
@@ -4419,7 +5074,7 @@ async function addExternalEndpointEdges(graph, services) {
         nodesAdded++;
       }
       const edgeType = edgeTypeFromEndpoint(ep);
-      const confidence = (0, import_types16.confidenceForExtracted)(ep.confidenceKind);
+      const confidence = (0, import_types17.confidenceForExtracted)(ep.confidenceKind);
       const relFile = toPosix2(ep.evidence.file);
       const { fileNodeId, nodesAdded: n, edgesAdded: e } = ensureFileNode(
         graph,
@@ -4429,7 +5084,7 @@ async function addExternalEndpointEdges(graph, services) {
       );
       nodesAdded += n;
       edgesAdded += e;
-      if (!(0, import_types16.passesExtractedFloor)(confidence)) {
+      if (!(0, import_types17.passesExtractedFloor)(confidence)) {
         noteExtractedDropped({
           source: fileNodeId,
           target: ep.infraId,
@@ -4449,7 +5104,7 @@ async function addExternalEndpointEdges(graph, services) {
           source: fileNodeId,
           target: ep.infraId,
           type: edgeType,
-          provenance: import_types16.Provenance.EXTRACTED,
+          provenance: import_types17.Provenance.EXTRACTED,
           confidence,
           evidence: ep.evidence
         };
@@ -4474,16 +5129,16 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path25 = __toESM(require("path"), 1);
-var import_types18 = require("@neat.is/types");
+var import_node_path29 = __toESM(require("path"), 1);
+var import_types19 = require("@neat.is/types");
 
 // src/extract/infra/shared.ts
 init_cjs_shims();
-var import_types17 = require("@neat.is/types");
+var import_types18 = require("@neat.is/types");
 function makeInfraNode(kind, name, provider = "self", extras) {
   return {
-    id: (0, import_types17.infraId)(kind, name),
-    type: import_types17.NodeType.InfraNode,
+    id: (0, import_types18.infraId)(kind, name),
+    type: import_types18.NodeType.InfraNode,
     name,
     provider,
     kind,
@@ -4512,7 +5167,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path25.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path29.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -4521,8 +5176,8 @@ 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_path25.default.join(scanPath, name);
-    if (await exists(abs)) {
+    const abs = import_node_path29.default.join(scanPath, name);
+    if (await exists2(abs)) {
       composePath = abs;
       break;
     }
@@ -4534,13 +5189,13 @@ async function addComposeInfra(graph, scanPath, services) {
   } catch (err) {
     recordExtractionError(
       "infra docker-compose",
-      import_node_path25.default.relative(scanPath, composePath),
+      import_node_path29.default.relative(scanPath, composePath),
       err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path25.default.relative(scanPath, composePath).split(import_node_path25.default.sep).join("/");
+  const evidenceFile = import_node_path29.default.relative(scanPath, composePath).split(import_node_path29.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -4562,15 +5217,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_types18.EdgeType.DEPENDS_ON);
+      const edgeId = (0, import_types5.extractedEdgeId)(sourceId, targetId, import_types19.EdgeType.DEPENDS_ON);
       if (graph.hasEdge(edgeId)) continue;
       const edge = {
         id: edgeId,
         source: sourceId,
         target: targetId,
-        type: import_types18.EdgeType.DEPENDS_ON,
-        provenance: import_types18.Provenance.EXTRACTED,
-        confidence: (0, import_types18.confidenceForExtracted)("structural"),
+        type: import_types19.EdgeType.DEPENDS_ON,
+        provenance: import_types19.Provenance.EXTRACTED,
+        confidence: (0, import_types19.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -4582,9 +5237,9 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path26 = __toESM(require("path"), 1);
-var import_node_fs14 = require("fs");
-var import_types19 = require("@neat.is/types");
+var import_node_path30 = __toESM(require("path"), 1);
+var import_node_fs17 = require("fs");
+var import_types20 = require("@neat.is/types");
 function runtimeImage(content) {
   const lines = content.split("\n");
   let last = null;
@@ -4603,15 +5258,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path26.default.join(service.dir, "Dockerfile");
-    if (!await exists(dockerfilePath)) continue;
+    const dockerfilePath = import_node_path30.default.join(service.dir, "Dockerfile");
+    if (!await exists2(dockerfilePath)) continue;
     let content;
     try {
-      content = await import_node_fs14.promises.readFile(dockerfilePath, "utf8");
+      content = await import_node_fs17.promises.readFile(dockerfilePath, "utf8");
     } catch (err) {
       recordExtractionError(
         "infra dockerfile",
-        import_node_path26.default.relative(scanPath, dockerfilePath),
+        import_node_path30.default.relative(scanPath, dockerfilePath),
         err
       );
       continue;
@@ -4623,17 +5278,26 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const edgeId = (0, import_types5.extractedEdgeId)(service.node.id, node.id, import_types19.EdgeType.RUNS_ON);
+    const relDockerfile = toPosix2(import_node_path30.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_types5.extractedEdgeId)(fileNodeId, node.id, import_types20.EdgeType.RUNS_ON);
     if (!graph.hasEdge(edgeId)) {
       const edge = {
         id: edgeId,
-        source: service.node.id,
+        source: fileNodeId,
         target: node.id,
-        type: import_types19.EdgeType.RUNS_ON,
-        provenance: import_types19.Provenance.EXTRACTED,
-        confidence: (0, import_types19.confidenceForExtracted)("structural"),
+        type: import_types20.EdgeType.RUNS_ON,
+        provenance: import_types20.Provenance.EXTRACTED,
+        confidence: (0, import_types20.confidenceForExtracted)("structural"),
         evidence: {
-          file: import_node_path26.default.relative(scanPath, dockerfilePath).split(import_node_path26.default.sep).join("/")
+          file: toPosix2(import_node_path30.default.relative(scanPath, dockerfilePath))
         }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -4645,21 +5309,21 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 
 // src/extract/infra/terraform.ts
 init_cjs_shims();
-var import_node_fs15 = require("fs");
-var import_node_path27 = __toESM(require("path"), 1);
+var import_node_fs18 = require("fs");
+var import_node_path31 = __toESM(require("path"), 1);
 var RESOURCE_RE = /resource\s+"(aws_[A-Za-z0-9_]+)"\s+"([A-Za-z0-9_-]+)"/g;
 async function walkTfFiles(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await import_node_fs15.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs18.promises.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name) || entry.name === ".terraform") continue;
-      const child = import_node_path27.default.join(start, entry.name);
+      const child = import_node_path31.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_path27.default.join(start, entry.name));
+      out.push(import_node_path31.default.join(start, entry.name));
     }
   }
   return out;
@@ -4668,7 +5332,7 @@ async function addTerraformResources(graph, scanPath) {
   let nodesAdded = 0;
   const files = await walkTfFiles(scanPath);
   for (const file of files) {
-    const content = await import_node_fs15.promises.readFile(file, "utf8");
+    const content = await import_node_fs18.promises.readFile(file, "utf8");
     RESOURCE_RE.lastIndex = 0;
     let m;
     while ((m = RESOURCE_RE.exec(content)) !== null) {
@@ -4686,8 +5350,8 @@ async function addTerraformResources(graph, scanPath) {
 
 // src/extract/infra/k8s.ts
 init_cjs_shims();
-var import_node_fs16 = require("fs");
-var import_node_path28 = __toESM(require("path"), 1);
+var import_node_fs19 = require("fs");
+var import_node_path32 = __toESM(require("path"), 1);
 var import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -4701,15 +5365,15 @@ var K8S_KIND_TO_INFRA_KIND = {
 async function walkYamlFiles2(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await import_node_fs16.promises.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await import_node_fs19.promises.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name)) continue;
-      const child = import_node_path28.default.join(start, entry.name);
+      const child = import_node_path32.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_path28.default.extname(entry.name))) {
-      out.push(import_node_path28.default.join(start, entry.name));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path32.default.extname(entry.name))) {
+      out.push(import_node_path32.default.join(start, entry.name));
     }
   }
   return out;
@@ -4718,7 +5382,7 @@ async function addK8sResources(graph, scanPath) {
   let nodesAdded = 0;
   const files = await walkYamlFiles2(scanPath);
   for (const file of files) {
-    const content = await import_node_fs16.promises.readFile(file, "utf8");
+    const content = await import_node_fs19.promises.readFile(file, "utf8");
     let docs;
     try {
       docs = (0, import_yaml3.parseAllDocuments)(content).map((d) => d.toJSON());
@@ -4753,17 +5417,17 @@ async function addInfra(graph, scanPath, services) {
 }
 
 // src/extract/index.ts
-var import_node_path30 = __toESM(require("path"), 1);
+var import_node_path34 = __toESM(require("path"), 1);
 
 // src/extract/retire.ts
 init_cjs_shims();
-var import_node_fs17 = require("fs");
-var import_node_path29 = __toESM(require("path"), 1);
-var import_types20 = require("@neat.is/types");
+var import_node_fs20 = require("fs");
+var import_node_path33 = __toESM(require("path"), 1);
+var import_types21 = require("@neat.is/types");
 function dropOrphanedFileNodes(graph) {
   const orphans = [];
   graph.forEachNode((id, attrs) => {
-    if (attrs.type !== import_types20.NodeType.FileNode) return;
+    if (attrs.type !== import_types21.NodeType.FileNode) return;
     if (graph.inboundEdges(id).length === 0 && graph.outboundEdges(id).length === 0) {
       orphans.push(id);
     }
@@ -4776,14 +5440,14 @@ function retireExtractedEdgesByMissingFile(graph, scanPath, serviceDirs = []) {
   const bases = [scanPath, ...serviceDirs];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== import_types20.Provenance.EXTRACTED) return;
+    if (edge.provenance !== import_types21.Provenance.EXTRACTED) return;
     const evidenceFile = edge.evidence?.file;
     if (!evidenceFile) return;
-    if (import_node_path29.default.isAbsolute(evidenceFile)) {
-      if (!(0, import_node_fs17.existsSync)(evidenceFile)) toDrop.push(id);
+    if (import_node_path33.default.isAbsolute(evidenceFile)) {
+      if (!(0, import_node_fs20.existsSync)(evidenceFile)) toDrop.push(id);
       return;
     }
-    const found = bases.some((base) => (0, import_node_fs17.existsSync)(import_node_path29.default.join(base, evidenceFile)));
+    const found = bases.some((base) => (0, import_node_fs20.existsSync)(import_node_path33.default.join(base, evidenceFile)));
     if (!found) toDrop.push(id);
   });
   for (const id of toDrop) graph.dropEdge(id);
@@ -4798,6 +5462,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   const services = await discoverServices(scanPath);
   const phase1Nodes = addServiceNodes(graph, services);
   await addServiceAliases(graph, scanPath, services);
+  const fileEnum = await addFiles(graph, services);
+  const importGraph = await addImports(graph, services);
   const phase2 = await addDatabasesAndCompat(graph, services, scanPath);
   const phase3 = await addConfigNodes(graph, services, scanPath);
   const phase4 = await addCallEdges(graph, services);
@@ -4821,7 +5487,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
-    const rejectedPath = import_node_path30.default.join(import_node_path30.default.dirname(opts.errorsPath), "rejected.ndjson");
+    const rejectedPath = import_node_path34.default.join(import_node_path34.default.dirname(opts.errorsPath), "rejected.ndjson");
     try {
       await writeRejectedExtracted(droppedEntries, rejectedPath);
     } catch (err) {
@@ -4831,8 +5497,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
     }
   }
   const result = {
-    nodesAdded: phase1Nodes + phase2.nodesAdded + phase3.nodesAdded + phase4.nodesAdded + phase5.nodesAdded,
-    edgesAdded: phase2.edgesAdded + phase3.edgesAdded + phase4.edgesAdded + phase5.edgesAdded,
+    nodesAdded: phase1Nodes + fileEnum.nodesAdded + importGraph.nodesAdded + phase2.nodesAdded + phase3.nodesAdded + phase4.nodesAdded + phase5.nodesAdded,
+    edgesAdded: fileEnum.edgesAdded + importGraph.edgesAdded + phase2.edgesAdded + phase3.edgesAdded + phase4.edgesAdded + phase5.edgesAdded,
     frontiersPromoted,
     extractionErrors: errorEntries.length,
     errorEntries,
@@ -4855,7 +5521,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
 
 // src/diff.ts
 init_cjs_shims();
-var import_node_fs18 = require("fs");
+var import_node_fs21 = require("fs");
 async function loadSnapshotForDiff(target) {
   if (/^https?:\/\//i.test(target)) {
     const res = await fetch(target);
@@ -4864,7 +5530,7 @@ async function loadSnapshotForDiff(target) {
     }
     return await res.json();
   }
-  const raw = await import_node_fs18.promises.readFile(target, "utf8");
+  const raw = await import_node_fs21.promises.readFile(target, "utf8");
   return JSON.parse(raw);
 }
 function indexEntries(entries) {
@@ -4932,9 +5598,9 @@ function canonicalJson(value) {
 
 // src/persist.ts
 init_cjs_shims();
-var import_node_fs19 = require("fs");
-var import_node_path31 = __toESM(require("path"), 1);
-var import_types21 = require("@neat.is/types");
+var import_node_fs22 = require("fs");
+var import_node_path35 = __toESM(require("path"), 1);
+var import_types22 = require("@neat.is/types");
 var SCHEMA_VERSION = 4;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -4956,12 +5622,12 @@ function migrateV2ToV3(payload) {
     for (const edge of edges) {
       const attrs = edge.attributes;
       if (!attrs || attrs.provenance !== "FRONTIER") continue;
-      attrs.provenance = import_types21.Provenance.OBSERVED;
+      attrs.provenance = import_types22.Provenance.OBSERVED;
       const type = typeof attrs.type === "string" ? attrs.type : void 0;
       const source = typeof attrs.source === "string" ? attrs.source : void 0;
       const target = typeof attrs.target === "string" ? attrs.target : void 0;
       if (type && source && target) {
-        const newId = (0, import_types21.observedEdgeId)(source, target, type);
+        const newId = (0, import_types22.observedEdgeId)(source, target, type);
         attrs.id = newId;
         if (edge.key) edge.key = newId;
       }
@@ -4970,7 +5636,7 @@ function migrateV2ToV3(payload) {
   return { ...payload, schemaVersion: 3 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs19.promises.mkdir(import_node_path31.default.dirname(filePath), { recursive: true });
+  await import_node_fs22.promises.mkdir(import_node_path35.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -4980,13 +5646,13 @@ async function saveGraphToDisk(graph, outPath) {
     graph: graph.export()
   };
   const tmp = `${outPath}.tmp`;
-  await import_node_fs19.promises.writeFile(tmp, JSON.stringify(payload), "utf8");
-  await import_node_fs19.promises.rename(tmp, outPath);
+  await import_node_fs22.promises.writeFile(tmp, JSON.stringify(payload), "utf8");
+  await import_node_fs22.promises.rename(tmp, outPath);
 }
 async function loadGraphFromDisk(graph, outPath) {
   let raw;
   try {
-    raw = await import_node_fs19.promises.readFile(outPath, "utf8");
+    raw = await import_node_fs22.promises.readFile(outPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") return;
     throw err;
@@ -5045,23 +5711,23 @@ function startPersistLoop(graph, outPath, intervalMs = 6e4) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path32 = __toESM(require("path"), 1);
+var import_node_path36 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path32.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path32.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path32.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path32.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path32.default.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: import_node_path36.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path36.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path36.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path36.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path36.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: import_node_path32.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path32.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path32.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path32.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path32.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: import_node_path36.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path36.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path36.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path36.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path36.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -5101,23 +5767,23 @@ function parseExtraProjects(raw) {
 
 // src/registry.ts
 init_cjs_shims();
-var import_node_fs20 = require("fs");
-var import_node_os2 = __toESM(require("os"), 1);
-var import_node_path33 = __toESM(require("path"), 1);
-var import_types22 = require("@neat.is/types");
+var import_node_fs23 = require("fs");
+var import_node_os3 = __toESM(require("os"), 1);
+var import_node_path37 = __toESM(require("path"), 1);
+var import_types23 = require("@neat.is/types");
 function neatHome() {
   const override = process.env.NEAT_HOME;
-  if (override && override.length > 0) return import_node_path33.default.resolve(override);
-  return import_node_path33.default.join(import_node_os2.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path37.default.resolve(override);
+  return import_node_path37.default.join(import_node_os3.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path33.default.join(neatHome(), "projects.json");
+  return import_node_path37.default.join(neatHome(), "projects.json");
 }
 async function readRegistry() {
   const file = registryPath();
   let raw;
   try {
-    raw = await import_node_fs20.promises.readFile(file, "utf8");
+    raw = await import_node_fs23.promises.readFile(file, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
       return { version: 1, projects: [] };
@@ -5125,7 +5791,7 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types22.RegistryFileSchema.parse(parsed);
+  return import_types23.RegistryFileSchema.parse(parsed);
 }
 async function getProject(name) {
   const reg = await readRegistry();
@@ -5327,11 +5993,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_types23.DivergenceTypeSchema.safeParse(c);
+        const r = import_types24.DivergenceTypeSchema.safeParse(c);
         if (!r.success) {
           return reply.code(400).send({
             error: `unknown divergence type "${c}"`,
-            allowed: import_types23.DivergenceTypeSchema.options
+            allowed: import_types24.DivergenceTypeSchema.options
           });
         }
         parsed.push(r.data);
@@ -5544,7 +6210,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req.query.severity) {
-      const sev = import_types23.PolicySeveritySchema.safeParse(req.query.severity);
+      const sev = import_types24.PolicySeveritySchema.safeParse(req.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -5561,7 +6227,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req, reply) => {
     const proj = resolveProject(registry, req, reply, ctx.bootstrap);
     if (!proj) return;
-    const parsed = import_types23.PoliciesCheckBodySchema.safeParse(req.body ?? {});
+    const parsed = import_types24.PoliciesCheckBodySchema.safeParse(req.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -5594,6 +6260,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 });
@@ -5704,8 +6469,8 @@ init_otel_grpc();
 
 // src/search.ts
 init_cjs_shims();
-var import_node_fs21 = require("fs");
-var import_node_path36 = __toESM(require("path"), 1);
+var import_node_fs24 = require("fs");
+var import_node_path40 = __toESM(require("path"), 1);
 var import_node_crypto3 = require("crypto");
 var DEFAULT_LIMIT = 10;
 var NOMIC_DIM = 768;
@@ -5835,7 +6600,7 @@ async function pickEmbedder() {
 }
 async function readCache(cachePath) {
   try {
-    const raw = await import_node_fs21.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;
@@ -5844,8 +6609,8 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, cache) {
-  await import_node_fs21.promises.mkdir(import_node_path36.default.dirname(cachePath), { recursive: true });
-  await import_node_fs21.promises.writeFile(cachePath, JSON.stringify(cache));
+  await import_node_fs24.promises.mkdir(import_node_path40.default.dirname(cachePath), { recursive: true });
+  await import_node_fs24.promises.writeFile(cachePath, JSON.stringify(cache));
 }
 var VectorIndex = class {
   constructor(embedder, cachePath) {
@@ -6025,14 +6790,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_path37.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path37.default.resolve(import_node_path37.default.dirname(legacyOutPath)) : import_node_path37.default.resolve("./neat-out");
-  const defaultScanPath = import_node_path37.default.resolve(process.env.NEAT_SCAN_PATH ?? "./demo");
+  const baseDir = baseDirEnv ? import_node_path41.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path41.default.resolve(import_node_path41.default.dirname(legacyOutPath)) : import_node_path41.default.resolve("./neat-out");
+  const defaultScanPath = import_node_path41.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_path37.default.resolve(projectScan) : void 0, baseDir);
+    await bootProject(registry, name, projectScan ? import_node_path41.default.resolve(projectScan) : void 0, baseDir);
   }
   const host = process.env.HOST ?? "0.0.0.0";
   const port = Number(process.env.PORT ?? 8080);