@neat.is/core 0.10.6 → 0.10.7-dev.20261011

package/dist/cli.d.cts

@@ -83,7 +83,7 @@ declare class ProjectResolutionError extends Error {
 }
 declare function isLoopbackEndpoint(endpoint: string): boolean;
 declare function resolveProjectForVerb(client: HttpClient, parsed: ParsedArgs, cwdProject?: string): Promise<string | undefined>;
-type ClientTargetSource = 'profile' | 'env' | 'active' | 'daemon-record' | 'default';
+type ClientTargetSource = 'profile' | 'env' | 'active' | 'daemon-record' | 'sole-daemon' | 'default';
 interface ClientTarget {
     endpoint: string;
     authToken?: string;
@@ -96,6 +96,7 @@ declare function resolveClientTarget(opts?: {
     project?: string;
     profile?: string;
 }): Promise<ClientTarget>;
+declare function loopbackResolutionHint(): Promise<string | undefined>;
 declare function projectForCwd(cwd?: string): Promise<string | undefined>;
 declare function cwdProjectApplies(source: ClientTargetSource): boolean;
 declare function resolveDaemonUrl(project?: string, profile?: string): Promise<string>;
@@ -103,4 +104,4 @@ declare function runQueryVerb(cmd: string, parsed: ParsedArgs): Promise<number>;
 declare function runMonitorVerb(parsed: ParsedArgs): Promise<number>;
 declare function reportFatal(err: unknown, log?: (line: unknown) => void): number;
 
-export { CLAUDE_SKILL_CONFIG, type ClientTarget, type ClientTargetSource, type InitOptions, type InitResult, ProjectResolutionError, QUERY_VERBS, type SkillOptions, UnknownProfileError, commandPrefix, cwdProjectApplies, isLoopbackEndpoint, isNpxInvocation, main, parseArgs, printBanner, projectForCwd, readPackageVersion, reportFatal, resolveClientTarget, resolveDaemonUrl, resolveProjectForVerb, runInit, runMonitorVerb, runQueryVerb, runSkill, usage };
+export { CLAUDE_SKILL_CONFIG, type ClientTarget, type ClientTargetSource, type InitOptions, type InitResult, ProjectResolutionError, QUERY_VERBS, type SkillOptions, UnknownProfileError, commandPrefix, cwdProjectApplies, isLoopbackEndpoint, isNpxInvocation, loopbackResolutionHint, main, parseArgs, printBanner, projectForCwd, readPackageVersion, reportFatal, resolveClientTarget, resolveDaemonUrl, resolveProjectForVerb, runInit, runMonitorVerb, runQueryVerb, runSkill, usage };

package/dist/cli.d.ts

@@ -83,7 +83,7 @@ declare class ProjectResolutionError extends Error {
 }
 declare function isLoopbackEndpoint(endpoint: string): boolean;
 declare function resolveProjectForVerb(client: HttpClient, parsed: ParsedArgs, cwdProject?: string): Promise<string | undefined>;
-type ClientTargetSource = 'profile' | 'env' | 'active' | 'daemon-record' | 'default';
+type ClientTargetSource = 'profile' | 'env' | 'active' | 'daemon-record' | 'sole-daemon' | 'default';
 interface ClientTarget {
     endpoint: string;
     authToken?: string;
@@ -96,6 +96,7 @@ declare function resolveClientTarget(opts?: {
     project?: string;
     profile?: string;
 }): Promise<ClientTarget>;
+declare function loopbackResolutionHint(): Promise<string | undefined>;
 declare function projectForCwd(cwd?: string): Promise<string | undefined>;
 declare function cwdProjectApplies(source: ClientTargetSource): boolean;
 declare function resolveDaemonUrl(project?: string, profile?: string): Promise<string>;
@@ -103,4 +104,4 @@ declare function runQueryVerb(cmd: string, parsed: ParsedArgs): Promise<number>;
 declare function runMonitorVerb(parsed: ParsedArgs): Promise<number>;
 declare function reportFatal(err: unknown, log?: (line: unknown) => void): number;
 
-export { CLAUDE_SKILL_CONFIG, type ClientTarget, type ClientTargetSource, type InitOptions, type InitResult, ProjectResolutionError, QUERY_VERBS, type SkillOptions, UnknownProfileError, commandPrefix, cwdProjectApplies, isLoopbackEndpoint, isNpxInvocation, main, parseArgs, printBanner, projectForCwd, readPackageVersion, reportFatal, resolveClientTarget, resolveDaemonUrl, resolveProjectForVerb, runInit, runMonitorVerb, runQueryVerb, runSkill, usage };
+export { CLAUDE_SKILL_CONFIG, type ClientTarget, type ClientTargetSource, type InitOptions, type InitResult, ProjectResolutionError, QUERY_VERBS, type SkillOptions, UnknownProfileError, commandPrefix, cwdProjectApplies, isLoopbackEndpoint, isNpxInvocation, loopbackResolutionHint, main, parseArgs, printBanner, projectForCwd, readPackageVersion, reportFatal, resolveClientTarget, resolveDaemonUrl, resolveProjectForVerb, runInit, runMonitorVerb, runQueryVerb, runSkill, usage };

package/dist/cli.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  deployHintLines
+} from "./chunk-AEMLUMHC.js";
 import {
   clearDaemonRecord,
   portFromListenAddress,
@@ -8,7 +11,7 @@ import {
   resolveNeatVersion,
   startK8sSubstratePolling,
   writeDaemonRecord
-} from "./chunk-OKM4N7GH.js";
+} from "./chunk-S5S2FYCQ.js";
 import {
   buildSearchIndex,
   searchProviderFromEnv
@@ -68,11 +71,12 @@ import {
   startStalenessLoop,
   upsertConnectorEntry,
   validateConnectorEntry
-} from "./chunk-MW2XYLCS.js";
+} from "./chunk-6K22WGO7.js";
 import {
   ProjectNameCollisionError,
   RegistryError,
   addProject,
+  discoverDaemons,
   findDaemonByProject,
   findProjectByPath,
   getProject,
@@ -5065,7 +5069,7 @@ async function connectorAdd(args, deps) {
   }
   const { replaced } = await upsertConnectorEntry(entry2, deps.home);
   const verb = replaced ? "updated" : "added";
-  const where = project ? `project "${project}"` : "the bootstrapping project";
+  const where = project ? `project "${project}"` : "every project (no --project set)";
   deps.out(`${verb} connector "${id}" (${provider}) for ${where}.`);
   if (push) {
     deps.out("The drain is live \u2014 traces arrive at the daemon's OTLP receiver. No poll or restart needed.");
@@ -5128,7 +5132,7 @@ async function connectorList(deps, filterProject, json = false) {
   }
   deps.out("id	provider	project	credential");
   for (const e of entries) {
-    const project = e.project ?? "(bootstrapping project)";
+    const project = e.project ?? "(every project)";
     const credential = describeCredential(e.credential, deps.env).map((c) => {
       const status = c.status ? ` (${c.status})` : c.kind === "plaintext" ? " (plaintext)" : "";
       return c.field ? `${c.field}=${c.display}${status}` : `${c.display}${status}`;
@@ -6391,6 +6395,8 @@ async function runIncidents(client, input) {
     const blockLines = [];
     for (const ev of ordered) {
       blockLines.push(`  ${ev.timestamp} \u2014 ${ev.service}: ${ev.errorMessage}`);
+      if (ev.exceptionType) blockLines.push(`    exception: ${ev.exceptionType}`);
+      for (const l of deployHintLines(ev)) blockLines.push(`    ${l}`);
       blockLines.push(`    trace=${ev.traceId} span=${ev.spanId}`);
     }
     const target = input.nodeId ?? "the project";
@@ -7242,7 +7248,7 @@ import path15 from "path";
 import readline4 from "readline/promises";
 
 // src/agent-directive.generated.ts
-var AGENT_DIRECTIVE = '## Query NEAT before searching files\n\nThis project has a live NEAT graph: code, data and infrastructure declarations\nfused with runtime traffic, incidents and supported provider telemetry. It can\nshow what exists, what actually ran, where a failure began, and what may break\nwhen a node changes. The graph is deterministic: the agent supplies the model;\nNEAT resolves named nodes and traverses recorded evidence rather than asking an\nLLM to infer architecture from file names.\n\nEvery claim carries provenance and confidence. `EXTRACTED` comes from recognized\nsource or configuration, `OBSERVED` from spans or supported provider signals,\n`INFERRED` from a bridged relationship, and `STALE` marks an observed edge that\nwent quiet. Missing runtime evidence does not prove a path never runs.\n\n**For questions about this system\'s behavior, structure, data dependencies,\nfailures, or change impact, call the MCP `ask` tool (`mcp__neat__ask`) before\nRead/Grep/Glob/Bash.** You do not need an exact node id. `ask` resolves names\nand routes to the relevant graph traversal, returning provenance-tagged facts.\nWhen MCP is unavailable, use the same door through the CLI:\n\n```\nnpx neat.is ask "why is checkout failing?"\nnpx neat.is ask "what breaks if I change the orders table?"\nnpx neat.is ask "what does the payments service depend on at runtime?"\n```\n\nFor a failure, ask first, then call `get_incident_card` on the named service,\nfile or symbol. The card combines the incident, likely cause, blast radius,\npolicies and divergence into a work order. Use `expand` one hop at a time and\n`relate` to test whether the suspected cause and symptom share a signal. Check\nprovenance and confidence before acting.\n\nBefore a change, use `get_blast_radius` and `check_policies` to see dependents\nand advisory architectural rules. Use `get_divergences` to compare declared\nintent with observed behavior, `get_graph_diff` to compare a saved snapshot\nwith the live graph, and `get_recent_stale_edges` when traffic goes quiet.\n`get_dependencies` maps a node\'s outgoing graph; `get_observed_dependencies`\nshows only seen runtime/provider calls. `semantic_search` finds node labels,\nnot arbitrary source text.\n\nRead source when the graph does not model what you need: comments, arbitrary\nstring literals, config details, unsupported syntax, or a repository that has\nnot been extracted or connected. If a graph answer is empty, check the daemon\nwith `npx neat.is list` or restart it with `npx neat.is up`; wire MCP with\n`npx neat.is skill --apply`.\n';
+var AGENT_DIRECTIVE = '## Let NEAT investigate before you search files\n\nThis project has NEAT. It does the investigation for this system so you can\nspend your effort on the code: what exists, what actually ran, where a failure\nbegan, and what a change will reach. It answers from a live graph that fuses\ncode, data and infrastructure declarations with runtime traffic, incidents and\nsupported provider telemetry. The graph is deterministic: you supply the\nreasoning about the fix; NEAT resolves named nodes and traverses recorded\nevidence rather than asking an LLM to infer architecture from file names.\n\nEvery claim carries provenance and confidence. `EXTRACTED` comes from recognized\nsource or configuration, `OBSERVED` from spans or supported provider signals,\n`INFERRED` from a bridged relationship, and `STALE` marks an observed edge that\nwent quiet. Missing runtime evidence does not prove a path never runs.\n\n**For questions about this system\'s behavior, structure, data dependencies,\nfailures, or change impact, call the MCP `ask` tool (`mcp__neat__ask`) before\nRead/Grep/Glob/Bash.** You do not need an exact node id. `ask` resolves names\nand routes to the relevant graph traversal, returning provenance-tagged facts.\nWhen MCP is unavailable, use the same door through the CLI:\n\n```\nnpx neat.is ask "why is checkout failing?"\nnpx neat.is ask "what breaks if I change the orders table?"\nnpx neat.is ask "what does the payments service depend on at runtime?"\n```\n\nFor a failure, call `get_incident_card` on the failing service, file or symbol\n(if you don\'t know which, `ask` what is failing first). The card is the\ninvestigation already done: the incident, its likely cause chain, blast radius,\nthe governing policies and divergence, in one work order. Use `expand` one hop\nat a time and `relate` to test whether the suspected cause and symptom share a\nsignal. Check provenance and confidence before acting.\n\nBefore a change, use `get_blast_radius` and `check_policies` to see dependents\nand advisory architectural rules. Use `get_divergences` to compare declared\nintent with observed behavior, `get_graph_diff` to compare a saved snapshot\nwith the live graph, and `get_recent_stale_edges` when traffic goes quiet.\n`get_dependencies` maps a node\'s outgoing graph; `get_observed_dependencies`\nshows only seen runtime/provider calls. `semantic_search` finds node labels,\nnot arbitrary source text.\n\nRead source when the graph does not model what you need: comments, arbitrary\nstring literals, config details, unsupported syntax, or a repository that has\nnot been extracted or connected. If a graph answer is empty, check the daemon\nwith `npx neat.is list` or restart it with `npx neat.is up`; wire MCP with\n`npx neat.is skill --apply`.\n';
 
 // src/welcome.ts
 var WORDMARK = [
@@ -7257,10 +7263,13 @@ function renderAgentSetupPrompt(project, restPort) {
   const endpoint = restPort === void 0 ? "The daemon endpoint is unavailable; run `npx neat.is up` to start it." : `The local daemon is serving it at http://127.0.0.1:${restPort}.`;
   return `NEAT is set up for project "${project}". ${endpoint}
 
-NEAT models this software system as one graph: code, data, infrastructure,
-runtime traffic, incidents, and supported provider telemetry fused where evidence
-permits. Use it to see what exists, what actually ran, where a failure began, and
-what a change could affect. Missing observations do not prove a path never runs.
+NEAT does the investigation for this system, so you can spend your effort on the
+code. When something fails, call get_incident_card on the failing service, file
+or symbol: one work order with where the failure is, the cause chain (provenance
+on every hop), what a fix reaches, the policies that govern the code, and where
+code and runtime disagree. For anything else about how the system works, ask.
+NEAT answers from a live graph that fuses the code with what actually ran; a
+path it hasn't seen run is not proof the path never runs.
 
 1. Wire NEAT's MCP server into this agent session:
      npx neat.is skill --apply
@@ -7271,8 +7280,10 @@ what a change could affect. Missing observations do not prove a path never runs.
    If the daemon is unreachable, run \`npx neat.is up\`.
 
 ${AGENT_DIRECTIVE}
-As the app or tests run, traces fill the OBSERVED layer. Daemon log:
-neat-out/daemon.log. Reopen this door with \`npx neat.is welcome\`.`;
+Runtime evidence arrives once the app runs with NEAT attached: for Node, load
+.env.neat first (\`set -a; . ./.env.neat; set +a\`); for Python, start under
+\`opentelemetry-instrument\`. Daemon log: neat-out/daemon.log. Reopen this
+door with \`npx neat.is welcome\`.`;
 }
 function printHeader(out) {
   for (const line of WORDMARK) out(line);
@@ -10041,10 +10052,15 @@ async function main() {
     return;
   }
   if (cmd === "sync") {
+    const syncTarget = await resolveClientTarget({
+      ...parsed.project ? { project: parsed.project } : {},
+      ...parsed.profile ? { profile: parsed.profile } : {}
+    });
     const result = await runSync({
       ...parsed.project ? { project: parsed.project } : {},
       ...parsed.to ? { to: parsed.to } : {},
       ...parsed.token ? { token: parsed.token } : {},
+      daemonUrl: syncTarget.endpoint,
       dryRun: parsed.dryRun,
       noInstrument: parsed.noInstrument,
       sourceEdit: parsed.sourceEdit,
@@ -10203,9 +10219,28 @@ async function resolveClientTarget(opts = {}) {
     if (daemon) {
       return { endpoint: `http://localhost:${daemon.record.ports.rest}`, source: "daemon-record" };
     }
+  } else {
+    const live = (await discoverDaemons()).filter((d) => d.live);
+    if (live.length === 1) {
+      return {
+        endpoint: `http://localhost:${live[0].record.ports.rest}`,
+        source: "sole-daemon"
+      };
+    }
   }
   return { endpoint: "http://localhost:8080", source: "default" };
 }
+async function loopbackResolutionHint() {
+  const live = (await discoverDaemons()).filter((d) => d.live);
+  if (live.length === 0) {
+    return "No NEAT daemon is running. Start one with `npx neat.is` in your project (or `neat up`), then re-run \u2014 or set NEAT_API_URL to a daemon.";
+  }
+  if (live.length > 1) {
+    const list = live.map((d) => `  ${d.record.project} \u2192 http://localhost:${d.record.ports.rest}`).join("\n");
+    return "This directory is not a registered NEAT project and several daemons are running, so NEAT cannot pick one. Run from the project directory, pass --project <name>, or set NEAT_API_URL:\n" + list;
+  }
+  return void 0;
+}
 async function projectForCwd(cwd = process.cwd()) {
   try {
     return (await findProjectByPath(cwd))?.name;
@@ -10214,7 +10249,7 @@ async function projectForCwd(cwd = process.cwd()) {
   }
 }
 function cwdProjectApplies(source) {
-  return source === "daemon-record" || source === "default";
+  return source === "daemon-record" || source === "sole-daemon" || source === "default";
 }
 async function resolveDaemonUrl(project, profile) {
   return (await resolveClientTarget({ project, profile })).endpoint;
@@ -10236,6 +10271,11 @@ async function runQueryVerb(cmd, parsed) {
     }
     throw err;
   }
+  if (target.source === "default" && !requestedProject && !cwdProject) {
+    const hint = await loopbackResolutionHint();
+    if (hint) process.stderr.write(`${hint}
+`);
+  }
   const client = createHttpClient(target.endpoint, target.authToken);
   const positional = parsed.positional;
   let makeWork;
@@ -10482,6 +10522,7 @@ export {
   cwdProjectApplies,
   isLoopbackEndpoint,
   isNpxInvocation,
+  loopbackResolutionHint,
   main,
   parseArgs,
   printBanner,