@neat.is/core 0.4.20-dev.20260620 → 0.4.20-dev.20260622

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   readDaemonRecord
-} from "./chunk-ZV7GHZ2D.js";
+} from "./chunk-62ELQVIP.js";
 import {
   buildSearchIndex
 } from "./chunk-XOOCA5T7.js";
@@ -10,6 +10,7 @@ import {
   PolicyViolationsLog,
   ProjectNameCollisionError,
   Projects,
+  SCHEMA_VERSION,
   addCallEdges,
   addConfigNodes,
   addDatabasesAndCompat,
@@ -52,7 +53,7 @@ import {
   signalDaemonStop,
   startPersistLoop,
   startStalenessLoop
-} from "./chunk-Q5EDVWKZ.js";
+} from "./chunk-GNAX2CBF.js";
 import {
   startOtelGrpcReceiver
 } from "./chunk-MTXF77TN.js";
@@ -1307,6 +1308,7 @@ export const onRequest = defineMiddleware(async (context, next) => {
 `;
 
 // src/installers/javascript.ts
+import { resolve as resolveRegistry } from "@neat.is/instrumentation-registry";
 var SDK_PACKAGES = [
   { name: "@opentelemetry/api", version: "^1.9.0" },
   { name: "@opentelemetry/sdk-node", version: "^0.57.0" },
@@ -1431,6 +1433,34 @@ function hasNextDependency(pkg) {
 function allDeps(pkg) {
   return { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
 }
+var WEB_FRAMEWORK_DEPS = [
+  "express",
+  "fastify",
+  "koa",
+  "@hapi/hapi",
+  "hapi",
+  "restify",
+  "connect",
+  "@nestjs/core",
+  "next",
+  "hono",
+  "elysia",
+  "polka",
+  "micro"
+];
+function looksLikeWebApp(pkg) {
+  const deps = allDeps(pkg);
+  return WEB_FRAMEWORK_DEPS.some((name) => name in deps);
+}
+function uninstrumentedLibraries(pkg) {
+  const deps = allDeps(pkg);
+  const out = [];
+  for (const [name, version] of Object.entries(deps)) {
+    const entry2 = resolveRegistry(name, version);
+    if (entry2 && entry2.coverage === "gap") out.push(name);
+  }
+  return out;
+}
 var REMIX_ENTRY_CANDIDATES = [
   "app/entry.server.ts",
   "app/entry.server.tsx",
@@ -1510,6 +1540,9 @@ var SRC_INDEX_CANDIDATES = INDEX_EXTENSIONS.map((ext) => `src/index${ext}`);
 var SRC_NAMED_CANDIDATES = ["server", "main", "app"].flatMap(
   (name) => INDEX_EXTENSIONS.map((ext) => `src/${name}${ext}`)
 );
+var ROOT_NAMED_CANDIDATES = ["server", "app", "main"].flatMap(
+  (name) => INDEX_EXTENSIONS.map((ext) => `${name}${ext}`)
+);
 var SCRIPT_LAUNCHERS = /* @__PURE__ */ new Set([
   "node",
   "ts-node",
@@ -1584,6 +1617,10 @@ async function resolveEntry(serviceDir, pkg) {
     const candidate = path5.join(serviceDir, rel);
     if (await exists(candidate)) return candidate;
   }
+  for (const rel of ROOT_NAMED_CANDIDATES) {
+    const candidate = path5.join(serviceDir, rel);
+    if (await exists(candidate)) return candidate;
+  }
   for (const name of INDEX_CANDIDATES) {
     const candidate = path5.join(serviceDir, name);
     if (await exists(candidate)) return candidate;
@@ -2758,8 +2795,17 @@ async function applyInstallersOver(services, project, options = {}) {
         if (!installPlans.has(key)) installPlans.set(key, cmd);
       }
     } else if (outcome.outcome === "already-instrumented") already++;
-    else if (outcome.outcome === "lib-only") libOnly++;
-    else if (outcome.outcome === "browser-bundle") {
+    else if (outcome.outcome === "lib-only") {
+      libOnly++;
+      if (svc.pkg && looksLikeWebApp(svc.pkg)) {
+        const svcName = path7.basename(svc.dir);
+        console.warn(
+          `neat: runtime layer won't engage for ${svcName}: no entry point found.
+  ${svc.dir} depends on a web framework but neat couldn't resolve an entry to instrument.
+  Add a "start" script to package.json, or point neat at the entry file directly.`
+        );
+      }
+    } else if (outcome.outcome === "browser-bundle") {
       browserBundle++;
       console.log(`skipping ${svc.dir}: browser bundle; browser-OTel support lands in a future release.`);
     } else if (outcome.outcome === "react-native") {
@@ -2818,6 +2864,19 @@ async function applyInstallersOver(services, project, options = {}) {
   See docs/installer-scope.md \u2192 "Manual setup for out-of-scope runtimes"`
       );
     }
+    if (svc.pkg && (outcome.outcome === "instrumented" || outcome.outcome === "already-instrumented")) {
+      const gaps = uninstrumentedLibraries(svc.pkg);
+      if (gaps.length > 0) {
+        const svcName = path7.basename(svc.dir);
+        const list = gaps.join(", ");
+        const verb = gaps.length === 1 ? "this library" : "these libraries";
+        console.warn(
+          `neat: calls to ${list} won't be observed by default in ${svcName}.
+  ${verb} aren't in the default instrumentation set, so they produce no OBSERVED edges.
+  Run \`neat list-uninstrumented\` to review them, then \`neat extend\` to capture them.`
+        );
+      }
+    }
   }
   const packageManagerInstalls = [];
   for (const cmd of installPlans.values()) {
@@ -3840,7 +3899,10 @@ async function checkDaemonHealth(baseUrl) {
 }
 function snapshotForGraph(persisted) {
   return {
-    schemaVersion: 3,
+    // Stamp the live schema version the daemon validates against on the
+    // receiving `/snapshot` merge. Tracking the constant keeps the push
+    // aligned with the current snapshot shape across schema migrations.
+    schemaVersion: SCHEMA_VERSION,
     exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
     graph: persisted.graph.export()
   };