@neat.is/core 0.6.3-dev.20260727 → 0.6.4

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   routeSpanToProject,
   startDaemon
-} from "./chunk-PWIT35Z4.js";
+} from "./chunk-22X2YM5H.js";
 import {
   ProjectNameCollisionError,
   addProject,
@@ -37,7 +37,7 @@ import {
   thresholdForEdgeType,
   touchLastSeen,
   writeAtomically
-} from "./chunk-L64CATKE.js";
+} from "./chunk-UCDXHLCJ.js";
 import {
   startOtelGrpcReceiver
 } from "./chunk-7QXN726V.js";

package/dist/neatd.cjs

@@ -2285,6 +2285,41 @@ async function writeExtractionErrors(errors, errorsPath) {
   const lines = errors.map((e) => JSON.stringify(e)).join("\n") + "\n";
   await import_node_fs4.promises.appendFile(errorsPath, lines, "utf8");
 }
+function extractionHealthPathFor(errorsPath) {
+  const dir = import_node_path4.default.dirname(errorsPath);
+  const suffix = import_node_path4.default.basename(errorsPath).replace(/^errors/, "").replace(/\.ndjson$/, "");
+  return import_node_path4.default.join(dir, `extraction-health${suffix}.json`);
+}
+var HEALTH_FILE_SAMPLE = 100;
+async function writeExtractionHealth(errors, healthPath, now = (/* @__PURE__ */ new Date()).toISOString()) {
+  const byProducer = {};
+  for (const e of errors) byProducer[e.producer] = (byProducer[e.producer] ?? 0) + 1;
+  const coverage = {
+    skippedFiles: errors.length,
+    byProducer,
+    files: errors.slice(0, HEALTH_FILE_SAMPLE).map((e) => e.file),
+    updatedAt: now
+  };
+  await import_node_fs4.promises.mkdir(import_node_path4.default.dirname(healthPath), { recursive: true });
+  await import_node_fs4.promises.writeFile(healthPath, JSON.stringify(coverage), "utf8");
+}
+async function readExtractionHealth(healthPath) {
+  let raw;
+  try {
+    raw = await import_node_fs4.promises.readFile(healthPath, "utf8");
+  } catch {
+    return void 0;
+  }
+  try {
+    const obj = JSON.parse(raw);
+    if (typeof obj?.skippedFiles !== "number" || !obj.byProducer || !Array.isArray(obj.files)) {
+      return void 0;
+    }
+    return obj;
+  } catch {
+    return void 0;
+  }
+}
 var droppedSink = [];
 function noteExtractedDropped(edge) {
   droppedSink.push(edge);
@@ -3236,14 +3271,16 @@ function reconcileObservedRelPath(graph, serviceName, relPath) {
   return best ?? relPath;
 }
 function ensureObservedFileNode(graph, serviceName, serviceNodeId, callSite) {
-  const relPath = reconcileObservedRelPath(graph, serviceName, callSite.relPath);
-  const fileNodeId = (0, import_types6.fileId)(serviceName, relPath);
+  const svcAttrs = graph.hasNode(serviceNodeId) ? graph.getNodeAttributes(serviceNodeId) : void 0;
+  const canonicalService = svcAttrs && svcAttrs.type === import_types6.NodeType.ServiceNode && typeof svcAttrs.name === "string" ? svcAttrs.name : serviceName;
+  const relPath = reconcileObservedRelPath(graph, canonicalService, callSite.relPath);
+  const fileNodeId = (0, import_types6.fileId)(canonicalService, relPath);
   if (!graph.hasNode(fileNodeId)) {
     const language = languageForExt(relPath);
     const node = {
       id: fileNodeId,
       type: import_types6.NodeType.FileNode,
-      service: serviceName,
+      service: canonicalService,
       path: relPath,
       ...language ? { language } : {},
       ...callSite.originalRelPath ? { originalPath: callSite.originalRelPath } : {},
@@ -8352,6 +8389,15 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
       );
     }
   }
+  if (opts.errorsPath) {
+    try {
+      await writeExtractionHealth(errorEntries, extractionHealthPathFor(opts.errorsPath));
+    } catch (err) {
+      console.warn(
+        `[neat] failed to write extraction health sidecar: ${err.message}`
+      );
+    }
+  }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
     const rejectedPath = import_node_path43.default.join(import_node_path43.default.dirname(opts.errorsPath), "rejected.ndjson");
@@ -9326,6 +9372,67 @@ function registryLockPath() {
 function daemonPidPath() {
   return import_node_path48.default.join(neatHome(), "neatd.pid");
 }
+function daemonsDir() {
+  return import_node_path48.default.join(neatHome(), "daemons");
+}
+function isFiniteInt(v) {
+  return typeof v === "number" && Number.isFinite(v);
+}
+function parseDaemonRecord(raw) {
+  let obj;
+  try {
+    obj = JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+  if (typeof obj !== "object" || obj === null) return void 0;
+  const r = obj;
+  const ports = r.ports;
+  if (typeof r.project !== "string" || typeof r.projectPath !== "string" || !isFiniteInt(r.pid) || r.status !== "running" && r.status !== "stopped" || typeof r.startedAt !== "string" || typeof r.neatVersion !== "string" || !ports || !isFiniteInt(ports.rest) || !isFiniteInt(ports.otlp) || !isFiniteInt(ports.web)) {
+    return void 0;
+  }
+  return {
+    project: r.project,
+    projectPath: r.projectPath,
+    pid: r.pid,
+    status: r.status,
+    ports: { rest: ports.rest, otlp: ports.otlp, web: ports.web },
+    startedAt: r.startedAt,
+    neatVersion: r.neatVersion
+  };
+}
+var defaultDiscoveryProbe = { isPidAlive: isPidAliveDefault };
+async function discoverDaemons(probe = defaultDiscoveryProbe) {
+  const dir = daemonsDir();
+  let names;
+  try {
+    names = await import_node_fs28.promises.readdir(dir);
+  } catch (err) {
+    if (err.code === "ENOENT") return [];
+    throw err;
+  }
+  const out = [];
+  for (const name of names) {
+    if (!name.endsWith(".json")) continue;
+    const file = import_node_path48.default.join(dir, name);
+    let raw;
+    try {
+      raw = await import_node_fs28.promises.readFile(file, "utf8");
+    } catch {
+      continue;
+    }
+    const record = parseDaemonRecord(raw);
+    if (!record) continue;
+    const live = record.status === "running" && probe.isPidAlive(record.pid);
+    out.push({ record, live, source: file });
+  }
+  out.sort((a, b) => a.record.project.localeCompare(b.record.project));
+  return out;
+}
+async function findDaemonByProject(name, probe = defaultDiscoveryProbe) {
+  const discovered = await discoverDaemons(probe);
+  return discovered.find((d) => d.record.project === name);
+}
 function isPidAliveDefault(pid) {
   try {
     process.kill(pid, 0);
@@ -9835,7 +9942,11 @@ function resolveProject(registry, req2, reply, bootstrap, singleProject) {
       void reply.code(503).send({ ready: false, project: name, status: "broken" });
       return null;
     }
-    void reply.code(404).send({ error: "project not found", project: name });
+    void reply.code(404).send({
+      error: "project not found",
+      project: name,
+      hint: "This daemon does not host that project. GET /projects lists what it serves (see hostedHere)."
+    });
     return null;
   }
   return ctx;
@@ -9873,6 +9984,9 @@ function registerRoutes(scope, ctx) {
       const proj = resolveProject(registry, req2, reply, ctx.bootstrap, ctx.singleProject);
       if (!proj) return;
       const uptimeMs = Date.now() - startedAt;
+      const coverage = await readExtractionHealth(
+        extractionHealthPathFor(proj.paths.errorsPath)
+      );
       return {
         ok: true,
         project: proj.name,
@@ -9883,7 +9997,8 @@ function registerRoutes(scope, ctx) {
         uptime: Math.floor(uptimeMs / 1e3),
         nodeCount: proj.graph.order,
         edgeCount: proj.graph.size,
-        lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
+        lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
+        ...coverage ? { coverage } : {}
       };
     });
   }
@@ -10525,12 +10640,17 @@ async function buildApi(opts) {
         // The daemon is serving this project, so it's active unless its
         // bootstrap broke. ('bootstrapping' still reads as active — the project
         // is the one to land on; its graph route answers 503 until ready.)
-        status: phase === "broken" ? "broken" : "active"
+        status: phase === "broken" ? "broken" : "active",
+        hostedHere: true
       };
       return [entry2];
     }
     try {
-      return await listProjects();
+      const entries = await listProjects();
+      return entries.map((entry2) => ({
+        ...entry2,
+        hostedHere: registry.has(entry2.name)
+      }));
     } catch (err) {
       return reply.code(500).send({
         error: "failed to read project registry",
@@ -10544,7 +10664,21 @@ async function buildApi(opts) {
       if (!entry2) {
         return reply.code(404).send({ error: "project not found", project: req2.params.project });
       }
-      return { project: entry2 };
+      const hostedHere = registry.has(entry2.name);
+      if (!hostedHere) {
+        const owner = await findDaemonByProject(entry2.name).catch(() => void 0);
+        if (owner) {
+          return {
+            project: { ...entry2, hostedHere },
+            servedBy: {
+              path: owner.record.projectPath,
+              restPort: owner.record.ports.rest,
+              live: owner.live
+            }
+          };
+        }
+      }
+      return { project: { ...entry2, hostedHere } };
     } catch (err) {
       return reply.code(500).send({
         error: "failed to read project registry",