@neat.is/core 0.4.16 → 0.4.17

package/dist/cli.d.cts

@@ -2,6 +2,11 @@
 declare function readPackageVersion(): string;
 declare function printBanner(): void;
 
+interface HttpClient {
+    get<T>(path: string): Promise<T>;
+    post?<T>(path: string, body: unknown): Promise<T>;
+}
+
 interface InitOptions {
     scanPath: string;
     outPath: string;
@@ -54,7 +59,7 @@ declare const CLAUDE_SKILL_CONFIG: {
             command: string;
             args: string[];
             env: {
-                NEAT_API_URL: string;
+                NEAT_CORE_URL: string;
             };
         };
     };
@@ -68,6 +73,11 @@ declare function runSkill(opts: SkillOptions): Promise<{
 }>;
 declare function main(): Promise<void>;
 declare const QUERY_VERBS: Set<string>;
+declare class ProjectResolutionError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+declare function resolveProjectForVerb(client: HttpClient, parsed: ParsedArgs): Promise<string | undefined>;
 declare function runQueryVerb(cmd: string, parsed: ParsedArgs): Promise<number>;
 
-export { CLAUDE_SKILL_CONFIG, type InitOptions, type InitResult, QUERY_VERBS, type SkillOptions, commandPrefix, isNpxInvocation, main, parseArgs, printBanner, readPackageVersion, runInit, runQueryVerb, runSkill, usage };
+export { CLAUDE_SKILL_CONFIG, type InitOptions, type InitResult, ProjectResolutionError, QUERY_VERBS, type SkillOptions, commandPrefix, isNpxInvocation, main, parseArgs, printBanner, readPackageVersion, resolveProjectForVerb, runInit, runQueryVerb, runSkill, usage };

package/dist/cli.d.ts

@@ -2,6 +2,11 @@
 declare function readPackageVersion(): string;
 declare function printBanner(): void;
 
+interface HttpClient {
+    get<T>(path: string): Promise<T>;
+    post?<T>(path: string, body: unknown): Promise<T>;
+}
+
 interface InitOptions {
     scanPath: string;
     outPath: string;
@@ -54,7 +59,7 @@ declare const CLAUDE_SKILL_CONFIG: {
             command: string;
             args: string[];
             env: {
-                NEAT_API_URL: string;
+                NEAT_CORE_URL: string;
             };
         };
     };
@@ -68,6 +73,11 @@ declare function runSkill(opts: SkillOptions): Promise<{
 }>;
 declare function main(): Promise<void>;
 declare const QUERY_VERBS: Set<string>;
+declare class ProjectResolutionError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+declare function resolveProjectForVerb(client: HttpClient, parsed: ParsedArgs): Promise<string | undefined>;
 declare function runQueryVerb(cmd: string, parsed: ParsedArgs): Promise<number>;
 
-export { CLAUDE_SKILL_CONFIG, type InitOptions, type InitResult, QUERY_VERBS, type SkillOptions, commandPrefix, isNpxInvocation, main, parseArgs, printBanner, readPackageVersion, runInit, runQueryVerb, runSkill, usage };
+export { CLAUDE_SKILL_CONFIG, type InitOptions, type InitResult, ProjectResolutionError, QUERY_VERBS, type SkillOptions, commandPrefix, isNpxInvocation, main, parseArgs, printBanner, readPackageVersion, resolveProjectForVerb, runInit, runQueryVerb, runSkill, usage };

package/dist/cli.js

@@ -36,6 +36,7 @@ import {
   normalizeProjectPath,
   pathsForProject,
   promoteFrontierNodes,
+  pruneRegistry,
   removeProject,
   resetGraph,
   retireEdgesByFile,
@@ -44,7 +45,7 @@ import {
   setStatus,
   startPersistLoop,
   startStalenessLoop
-} from "./chunk-XS4CGNRO.js";
+} from "./chunk-LUDSPX5N.js";
 import {
   startOtelGrpcReceiver
 } from "./chunk-GHPHVXYM.js";
@@ -3858,6 +3859,8 @@ function usage() {
   console.log("  uninstall <name>");
   console.log("                 Remove a project from the registry. Does not touch");
   console.log("                 neat-out/, policy.json, or any user file.");
+  console.log("  prune          Drop registry entries whose path is gone from disk.");
+  console.log("                 Flags: --json   emit the removed list as JSON");
   console.log("  version        Print the installed @neat.is/core version and exit.");
   console.log("                 Aliases: --version, -v.");
   console.log("  skill          Install or print the Claude Code MCP drop-in.");
@@ -3917,6 +3920,7 @@ function usage() {
   console.log("");
   console.log("environment:");
   console.log("  NEAT_API_URL    base URL for the core REST API (default http://localhost:8080)");
+  console.log("                  alias: NEAT_CORE_URL (the name the MCP server reads)");
   console.log("  NEAT_PROJECT    project name when --project isn't passed");
 }
 var STRING_FLAGS = [
@@ -4228,7 +4232,7 @@ var CLAUDE_SKILL_CONFIG = {
       command: "npx",
       args: ["-y", "@neat.is/mcp"],
       env: {
-        NEAT_API_URL: "http://localhost:8080"
+        NEAT_CORE_URL: "http://localhost:8080"
       }
     }
   }
@@ -4274,6 +4278,9 @@ async function runSkill(opts) {
   console.log("");
   console.log("Manual install: copy mcpServers.neat from --print-config into ~/.claude.json,");
   console.log("then restart Claude Code. See packages/claude-skill/SKILL.md for the tool list.");
+  console.log("");
+  console.log("The MCP server reads NEAT_CORE_URL for the daemon URL \u2014 point it at a");
+  console.log("non-default daemon by editing that value in the generated config.");
   return { exitCode: 0 };
 }
 async function main() {
@@ -4441,6 +4448,19 @@ async function main() {
     console.log("note: neat-out/, policy.json, and other files at the project path were left in place.");
     return;
   }
+  if (cmd === "prune") {
+    const removed = await pruneRegistry({ ttlMs: 0 });
+    if (parsed.json) {
+      console.log(JSON.stringify(removed.map((p) => ({ name: p.name, path: p.path })), null, 2));
+      return;
+    }
+    if (removed.length === 0) {
+      console.log("nothing to prune \u2014 every registered project path still exists.");
+      return;
+    }
+    console.log(`pruned ${removed.length} project${removed.length === 1 ? "" : "s"}: ${removed.map((p) => p.name).join(", ")}`);
+    return;
+  }
   if (cmd === "deploy") {
     const artifact = await runDeploy();
     const block = renderOtelEnvBlock2(artifact.token);
@@ -4528,12 +4548,44 @@ function resolveProjectFlag(parsed) {
   if (env && env.length > 0 && env !== DEFAULT_PROJECT) return env;
   return void 0;
 }
+var ProjectResolutionError = class extends Error {
+  constructor(message, exitCode = 2) {
+    super(message);
+    this.exitCode = exitCode;
+    this.name = "ProjectResolutionError";
+  }
+  exitCode;
+};
+async function resolveProjectForVerb(client, parsed) {
+  const explicit = resolveProjectFlag(parsed);
+  if (explicit) return explicit;
+  const projects = await client.get("/projects");
+  if (projects.some((p) => p.name === DEFAULT_PROJECT)) {
+    return void 0;
+  }
+  if (projects.length === 1) {
+    return projects[0].name;
+  }
+  if (projects.length === 0) {
+    throw new ProjectResolutionError(
+      "No projects are registered with the daemon yet. Run `npx neat.is` in a repo to build a graph first, then re-run this command."
+    );
+  }
+  const names = projects.map((p) => p.name).sort().map((n) => `  ${n}`).join("\n");
+  throw new ProjectResolutionError(
+    `Several projects are registered and none is named "default", so I can't pick one for you.
+Pass --project <name> to choose:
+${names}`
+  );
+}
+function resolveDaemonUrl() {
+  return process.env.NEAT_API_URL ?? process.env.NEAT_CORE_URL ?? "http://localhost:8080";
+}
 async function runQueryVerb(cmd, parsed) {
-  const baseUrl = process.env.NEAT_API_URL ?? "http://localhost:8080";
+  const baseUrl = resolveDaemonUrl();
   const client = createHttpClient(baseUrl, resolveAuthToken());
-  const project = resolveProjectFlag(parsed);
   const positional = parsed.positional;
-  let work;
+  let makeWork;
   switch (cmd) {
     case "root-cause": {
       const node = positional[0];
@@ -4541,7 +4593,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat root-cause: missing <node-id>");
         return 2;
       }
-      work = runRootCause(client, {
+      makeWork = (project) => runRootCause(client, {
         errorNode: node,
         ...parsed.errorId ? { errorId: parsed.errorId } : {},
         ...project ? { project } : {}
@@ -4554,7 +4606,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat blast-radius: missing <node-id>");
         return 2;
       }
-      work = runBlastRadius(client, {
+      makeWork = (project) => runBlastRadius(client, {
         nodeId: node,
         ...parsed.depth !== null ? { depth: parsed.depth } : {},
         ...project ? { project } : {}
@@ -4567,7 +4619,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat dependencies: missing <node-id>");
         return 2;
       }
-      work = runDependencies(client, {
+      makeWork = (project) => runDependencies(client, {
         nodeId: node,
         ...parsed.depth !== null ? { depth: parsed.depth } : {},
         ...project ? { project } : {}
@@ -4580,14 +4632,14 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat observed-dependencies: missing <node-id>");
         return 2;
       }
-      work = runObservedDependencies(client, {
+      makeWork = (project) => runObservedDependencies(client, {
         nodeId: node,
         ...project ? { project } : {}
       });
       break;
     }
     case "incidents": {
-      work = runIncidents(client, {
+      makeWork = (project) => runIncidents(client, {
         ...positional[0] ? { nodeId: positional[0] } : {},
         ...parsed.limit !== null ? { limit: parsed.limit } : {},
         ...project ? { project } : {}
@@ -4600,7 +4652,7 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat search: missing <query>");
         return 2;
       }
-      work = runSearch(client, { query: q, ...project ? { project } : {} });
+      makeWork = (project) => runSearch(client, { query: q, ...project ? { project } : {} });
       break;
     }
     case "diff": {
@@ -4609,14 +4661,14 @@ async function runQueryVerb(cmd, parsed) {
         console.error("neat diff: --against <snapshot-path> is required");
         return 2;
       }
-      work = runDiff(client, {
+      makeWork = (project) => runDiff(client, {
         againstSnapshot: against,
         ...project ? { project } : {}
       });
       break;
     }
     case "stale-edges": {
-      work = runStaleEdges(client, {
+      makeWork = (project) => runStaleEdges(client, {
         ...parsed.limit !== null ? { limit: parsed.limit } : {},
         ...parsed.edgeType ? { edgeType: parsed.edgeType } : {},
         ...project ? { project } : {}
@@ -4635,7 +4687,7 @@ async function runQueryVerb(cmd, parsed) {
           return 2;
         }
       }
-      work = runPolicies(client, {
+      makeWork = (project) => runPolicies(client, {
         ...parsed.node ? { nodeId: parsed.node } : {},
         ...hypothetical ? { hypotheticalAction: hypothetical } : {},
         ...project ? { project } : {}
@@ -4659,7 +4711,7 @@ async function runQueryVerb(cmd, parsed) {
         }
         typeFilter = out;
       }
-      work = runDivergences(client, {
+      makeWork = (project) => runDivergences(client, {
         ...typeFilter ? { type: typeFilter } : {},
         ...parsed.minConfidence !== null ? { minConfidence: parsed.minConfidence } : {},
         ...parsed.node ? { node: parsed.node } : {},
@@ -4672,16 +4724,21 @@ async function runQueryVerb(cmd, parsed) {
       return 2;
   }
   try {
-    const result = await work;
+    const project = await resolveProjectForVerb(client, parsed);
+    const result = await makeWork(project);
     if (parsed.json) process.stdout.write(formatJson(result) + "\n");
     else process.stdout.write(formatHuman(result) + "\n");
     return 0;
   } catch (err) {
+    if (err instanceof ProjectResolutionError) {
+      console.error(`neat ${cmd}: ${err.message}`);
+      return err.exitCode;
+    }
     if (err instanceof HttpError) {
       const detail = err.responseBody.length > 0 ? err.responseBody : err.message;
       console.error(`neat ${cmd}: ${detail.trim()}`);
     } else if (err instanceof TransportError) {
-      console.error(`neat ${cmd}: ${err.message}. Is the daemon running? (NEAT_API_URL=${process.env.NEAT_API_URL ?? "http://localhost:8080"})`);
+      console.error(`neat ${cmd}: ${err.message}. Is the daemon running? (NEAT_API_URL=${resolveDaemonUrl()})`);
     } else {
       console.error(`neat ${cmd}: ${err.message}`);
     }
@@ -4697,6 +4754,7 @@ if (/[\\/]cli\.(?:cjs|js)$/.test(entry) || entry.endsWith("/cli") || entry.endsW
 }
 export {
   CLAUDE_SKILL_CONFIG,
+  ProjectResolutionError,
   QUERY_VERBS,
   commandPrefix,
   isNpxInvocation,
@@ -4704,6 +4762,7 @@ export {
   parseArgs,
   printBanner,
   readPackageVersion,
+  resolveProjectForVerb,
   runInit,
   runQueryVerb,
   runSkill,