@neat.is/core 0.10.1-dev.20260926 → 0.10.1-dev.20260928

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   resolveNeatVersion,
   startK8sSubstratePolling,
   writeDaemonRecord
-} from "./chunk-EJPNEEJA.js";
+} from "./chunk-HVBD4ULO.js";
 import {
   buildSearchIndex
 } from "./chunk-BC53SCT7.js";
@@ -63,6 +63,7 @@ import {
   pruneRegistry,
   readConnectorsConfig,
   readErrorEvents,
+  readRegistry,
   removeConnectorEntry,
   removeDaemonRecord,
   removeProject,
@@ -77,7 +78,7 @@ import {
   startStalenessLoop,
   upsertConnectorEntry,
   validateConnectorEntry
-} from "./chunk-J3VVEB45.js";
+} from "./chunk-CNOJ4T6I.js";
 import {
   startOtelGrpcReceiver
 } from "./chunk-ERE47MCR.js";
@@ -91,9 +92,9 @@ import {
 } from "./chunk-GDGUY4T6.js";
 
 // src/cli.ts
-import path18 from "path";
+import path19 from "path";
 import os5 from "os";
-import { promises as fs16 } from "fs";
+import { promises as fs17 } from "fs";
 
 // src/banner.ts
 import path from "path";
@@ -5245,7 +5246,7 @@ async function clearActiveProfile(home = neatHome()) {
 }
 
 // src/login-sso.ts
-var DEFAULT_CP_URL = "https://neat-control-plane-bg5yqctn2q-nw.a.run.app";
+var DEFAULT_CP_URL = "https://api.neat.is";
 var DEFAULT_WEB_URL = "https://app.neat.is";
 var CALLBACK_TIMEOUT_MS = 5 * 6e4;
 function resolveCpUrl(env = process.env, override) {
@@ -5434,6 +5435,11 @@ async function runSsoLogin(opts, deps) {
       out(`  OTEL_EXPORTER_OTLP_ENDPOINT=${cred.ingestEndpoint}`);
       out(`  OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer ${cred.otelToken}`);
     }
+    out("");
+    out("This directory isn't part of that graph yet \u2014 logging in connected your account,");
+    out("not this repo, and nothing here has been uploaded.");
+    out(`  Manage projects and repos:  ${opts.webUrl}`);
+    out("");
     out("Run `neat logout` to switch back to your local daemon.");
   }
   return 0;
@@ -5568,10 +5574,10 @@ function createHttpClient(baseUrl, bearerToken, fetchImpl = fetch) {
   const root = baseUrl.replace(/\/$/, "");
   const authHeader = bearerToken && bearerToken.length > 0 ? { authorization: `Bearer ${bearerToken}` } : {};
   return {
-    async get(path19) {
+    async get(path20) {
       let res;
       try {
-        res = await fetchImpl(`${root}${path19}`, {
+        res = await fetchImpl(`${root}${path20}`, {
           headers: { ...authHeader }
         });
       } catch (err) {
@@ -5583,16 +5589,16 @@ function createHttpClient(baseUrl, bearerToken, fetchImpl = fetch) {
         const body = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on GET ${path19}: ${body}`,
+          `${res.status} ${res.statusText} on GET ${path20}: ${body}`,
           body
         );
       }
       return await res.json();
     },
-    async post(path19, body) {
+    async post(path20, body) {
       let res;
       try {
-        res = await fetchImpl(`${root}${path19}`, {
+        res = await fetchImpl(`${root}${path20}`, {
           method: "POST",
           headers: { "content-type": "application/json", ...authHeader },
           body: JSON.stringify(body)
@@ -5606,7 +5612,7 @@ function createHttpClient(baseUrl, bearerToken, fetchImpl = fetch) {
         const text = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on POST ${path19}: ${text}`,
+          `${res.status} ${res.statusText} on POST ${path20}: ${text}`,
           text
         );
       }
@@ -5620,12 +5626,12 @@ function projectPath(project, suffix) {
 }
 async function runRootCause(client, input) {
   const qs = input.errorId ? `?errorId=${encodeURIComponent(input.errorId)}` : "";
-  const path19 = projectPath(
+  const path20 = projectPath(
     input.project,
     `/graph/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
   );
   try {
-    const result = await client.get(path19);
+    const result = await client.get(path20);
     const arrowPath = result.traversalPath.join(" \u2190 ");
     const provenances = result.edgeProvenances.length ? result.edgeProvenances.join(", ") : "(direct, no edges traversed)";
     const summary = `Root cause for ${input.errorNode} is ${result.rootCauseNode}. ` + result.rootCauseReason + (result.fixRecommendation ? ` Recommended fix: ${result.fixRecommendation}.` : "");
@@ -5651,12 +5657,12 @@ async function runRootCause(client, input) {
 }
 async function runBlastRadius(client, input) {
   const qs = input.depth !== void 0 ? `?depth=${input.depth}` : "";
-  const path19 = projectPath(
+  const path20 = projectPath(
     input.project,
     `/graph/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
   );
   try {
-    const result = await client.get(path19);
+    const result = await client.get(path20);
     if (result.totalAffected === 0) {
       return {
         summary: `${result.origin} has no dependents. Nothing else would break if it failed.`
@@ -5690,12 +5696,12 @@ function formatBlastEntry(n) {
 }
 async function runDependencies(client, input) {
   const depth = input.depth ?? 3;
-  const path19 = projectPath(
+  const path20 = projectPath(
     input.project,
     `/graph/dependencies/${encodeURIComponent(input.nodeId)}?depth=${depth}`
   );
   try {
-    const result = await client.get(path19);
+    const result = await client.get(path20);
     if (result.total === 0) {
       return {
         summary: depth === 1 ? `${input.nodeId} has no direct dependencies in the graph.` : `${input.nodeId} has no dependencies (BFS to depth ${depth}).`
@@ -5787,9 +5793,9 @@ function formatDuration(ms) {
   return `${Math.round(h / 24)}d`;
 }
 async function runIncidents(client, input) {
-  const path19 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
+  const path20 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
   try {
-    const body = await client.get(path19);
+    const body = await client.get(path20);
     const events = body.events;
     if (events.length === 0) {
       return {
@@ -6566,6 +6572,8 @@ async function defaultReadSecret(prompt) {
 }
 
 // src/welcome.ts
+import { promises as fs12 } from "fs";
+import path13 from "path";
 import readline4 from "readline/promises";
 var WORDMARK = [
   "\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
@@ -6598,6 +6606,28 @@ function printHeader(out) {
 }
 async function runWelcome(deps = {}) {
   const out = deps.out ?? ((line) => console.log(line));
+  try {
+    return await runFrontDoor(deps, out);
+  } catch (err) {
+    if (isPromptCancelled(err)) {
+      out("");
+      return 130;
+    }
+    throw err;
+  }
+}
+var PromptCancelled = class extends Error {
+  constructor() {
+    super("prompt cancelled");
+    this.name = "PromptCancelled";
+  }
+};
+function isPromptCancelled(err) {
+  if (err instanceof PromptCancelled) return true;
+  const e = err;
+  return e?.code === "ABORT_ERR" || e?.name === "AbortError";
+}
+async function runFrontDoor(deps, out) {
   const readLine = deps.readLine ?? defaultReadLine2;
   const login = deps.login ?? (() => Promise.resolve(0));
   const orchestrator = deps.orchestrator ?? (() => Promise.resolve(0));
@@ -6605,21 +6635,114 @@ async function runWelcome(deps = {}) {
   printHeader(out);
   out("Welcome to NEAT. Let's get you a graph of this system.");
   out("");
-  out("  1) I have a NEAT account \u2014 log in");
-  out("  2) Self-hosted \u2014 set up NEAT on this machine");
+  const keyReader = deps.readKey !== void 0 ? { read: deps.readKey, done: () => {
+  } } : createKeyReader();
+  const picked = keyReader !== null ? await selectOption(out, keyReader, deps.moveCursorUp ?? defaultMoveCursorUp) : await selectByNumber(out, readLine);
+  if (picked === void 0) return runSelfHosted(out, readLine, orchestrator, cwd);
+  if (picked === 0) return login(["--browser"]);
+  return runSelfHosted(out, readLine, orchestrator, cwd);
+}
+var MENU_OPTIONS = [
+  "Log me into Hosted Neat",
+  "I'd like to self-host or use it locally (copy a prompt)"
+];
+async function selectOption(out, reader, moveCursorUp) {
+  let cursor = 0;
+  const render = () => {
+    for (const [i, label] of MENU_OPTIONS.entries()) {
+      out(i === cursor ? `  \u276F ${i + 1}) ${label}` : `    ${i + 1}) ${label}`);
+    }
+  };
+  try {
+    render();
+    out("");
+    out("  \u2191/\u2193 to move \xB7 Enter to choose \xB7 1 or 2 to jump");
+    for (; ; ) {
+      const key = await reader.read();
+      if (key === void 0) return void 0;
+      if (key === "cancel") throw new PromptCancelled();
+      if (key === "enter") return cursor;
+      if (key === "select-1") return 0;
+      if (key === "select-2") return 1;
+      if (key === "up") cursor = (cursor + MENU_OPTIONS.length - 1) % MENU_OPTIONS.length;
+      else if (key === "down") cursor = (cursor + 1) % MENU_OPTIONS.length;
+      else continue;
+      moveCursorUp(MENU_OPTIONS.length + 2);
+      render();
+      out("");
+      out("  \u2191/\u2193 to move \xB7 Enter to choose \xB7 1 or 2 to jump");
+    }
+  } finally {
+    reader.done();
+  }
+}
+async function selectByNumber(out, readLine) {
+  for (const [i, label] of MENU_OPTIONS.entries()) out(`  ${i + 1}) ${label}`);
   out("");
   for (; ; ) {
     const choice = (await readLine("Choose 1 or 2 (default 2): "))?.trim();
-    if (choice === void 0) return runSelfHosted(out, readLine, orchestrator, cwd);
-    if (choice === "1") {
-      return login(["--browser"]);
-    }
-    if (choice === "2" || choice === "") {
-      return runSelfHosted(out, readLine, orchestrator, cwd);
-    }
-    out(`"${choice}" isn't 1 or 2 \u2014 try again, or press Enter for self-hosted.`);
+    if (choice === void 0) return void 0;
+    if (choice === "1") return 0;
+    if (choice === "2" || choice === "") return 1;
+    out(`"${choice}" isn't 1 or 2 \u2014 try again, or press Enter for the local path.`);
   }
 }
+function createKeyReader() {
+  const stdin = process.stdin;
+  if (!stdin.isTTY || typeof stdin.setRawMode !== "function") return null;
+  stdin.setRawMode(true);
+  stdin.resume();
+  let closed = false;
+  let ended = false;
+  const markEnded = () => {
+    ended = true;
+  };
+  stdin.once("end", markEnded);
+  stdin.once("close", markEnded);
+  return {
+    read: () => new Promise((resolve) => {
+      if (ended) {
+        resolve(void 0);
+        return;
+      }
+      const finish = (value) => {
+        stdin.removeListener("data", onData);
+        stdin.removeListener("end", onClosed);
+        stdin.removeListener("close", onClosed);
+        resolve(value);
+      };
+      const onData = (buf) => finish(decodeKey(buf));
+      const onClosed = () => {
+        ended = true;
+        finish(void 0);
+      };
+      stdin.on("data", onData);
+      stdin.once("end", onClosed);
+      stdin.once("close", onClosed);
+    }),
+    done: () => {
+      if (closed) return;
+      closed = true;
+      stdin.removeListener("end", markEnded);
+      stdin.removeListener("close", markEnded);
+      stdin.setRawMode(false);
+      stdin.pause();
+    }
+  };
+}
+function decodeKey(buf) {
+  const s = buf.toString("utf8");
+  if (s === "\x1B[A" || s === "k") return "up";
+  if (s === "\x1B[B" || s === "j") return "down";
+  if (s === "\r" || s === "\n") return "enter";
+  if (s === "1") return "select-1";
+  if (s === "2") return "select-2";
+  if (s === "" || s === "\x1B") return "cancel";
+  return "ignore";
+}
+function defaultMoveCursorUp(rows) {
+  if (rows > 0) process.stdout.write(`\x1B[${rows}A`);
+}
 async function runSelfHosted(out, readLine, orchestrator, cwd) {
   const wantsPrompt = (await readLine("Print a copy-paste setup prompt for your coding agent? [Y/n]: "))?.trim().toLowerCase();
   if (wantsPrompt !== "n" && wantsPrompt !== "no") {
@@ -6639,10 +6762,23 @@ async function shouldShowWelcome(deps = {}) {
   const stdinTTY = deps.stdinIsTTY ?? Boolean(process.stdin.isTTY);
   const stdoutTTY = deps.stdoutIsTTY ?? Boolean(process.stdout.isTTY);
   if (!stdinTTY || !stdoutTTY) return false;
-  const readProfiles = deps.readProfiles ?? (() => readProfilesConfig());
+  const cwd = deps.cwd ?? process.cwd();
+  const readRegistry2 = deps.readRegistry ?? (() => readRegistry());
+  const hasSnapshot = deps.hasSnapshot ?? defaultHasSnapshot;
   try {
-    const { profiles } = await readProfiles();
-    return profiles.length === 0;
+    const here = path13.resolve(cwd);
+    const { projects } = await readRegistry2();
+    if (projects.some((p) => path13.resolve(p.path) === here)) return false;
+    if (await hasSnapshot(here)) return false;
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function defaultHasSnapshot(cwd) {
+  try {
+    const entries = await fs12.readdir(path13.join(cwd, "neat-out"));
+    return entries.some((e) => e.endsWith(".json"));
   } catch {
     return false;
   }
@@ -6658,27 +6794,27 @@ async function defaultReadLine2(prompt) {
 }
 
 // src/hooks-cli.ts
-import path13 from "path";
+import path14 from "path";
 import os2 from "os";
-import { promises as fs12 } from "fs";
+import { promises as fs13 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var HOOK_FILENAME = "neat-search-nudge.mjs";
 var GUIDE_FILENAME = "GRAPH_FIRST.md";
 var GUIDE_INSTALL_NAME = "neat-graph-first.md";
 var HOOK_MATCHER = "Grep|Glob|Bash";
 function moduleDir() {
-  return typeof __dirname !== "undefined" ? __dirname : path13.dirname(fileURLToPath3(import.meta.url));
+  return typeof __dirname !== "undefined" ? __dirname : path14.dirname(fileURLToPath3(import.meta.url));
 }
 async function readSkillAsset(rel) {
   const here = moduleDir();
   const candidates = [
-    path13.resolve(here, "../../claude-skill", rel),
-    path13.resolve(here, "../../../claude-skill", rel),
-    path13.resolve(here, "../claude-skill", rel)
+    path14.resolve(here, "../../claude-skill", rel),
+    path14.resolve(here, "../../../claude-skill", rel),
+    path14.resolve(here, "../claude-skill", rel)
   ];
   for (const candidate of candidates) {
     try {
-      return await fs12.readFile(candidate, "utf8");
+      return await fs13.readFile(candidate, "utf8");
     } catch {
     }
   }
@@ -6688,20 +6824,20 @@ async function readSkillAsset(rel) {
 }
 function neatHome2() {
   const override = process.env.NEAT_HOME;
-  if (override && override.length > 0) return path13.resolve(override);
-  return path13.join(os2.homedir(), ".neat");
+  if (override && override.length > 0) return path14.resolve(override);
+  return path14.join(os2.homedir(), ".neat");
 }
 function claudeSettingsPath() {
   const override = process.env.NEAT_CLAUDE_SETTINGS;
-  if (override && override.length > 0) return path13.resolve(override);
+  if (override && override.length > 0) return path14.resolve(override);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? os2.homedir();
-  return path13.join(home, ".claude", "settings.json");
+  return path14.join(home, ".claude", "settings.json");
 }
 function installedHookPath() {
-  return path13.join(neatHome2(), "hooks", HOOK_FILENAME);
+  return path14.join(neatHome2(), "hooks", HOOK_FILENAME);
 }
 function gateFlagPath() {
-  return path13.join(neatHome2(), "hooks", "gate-enabled");
+  return path14.join(neatHome2(), "hooks", "gate-enabled");
 }
 function isNeatSearchEntry(entry2) {
   return (entry2.hooks ?? []).some(
@@ -6734,14 +6870,14 @@ async function runHooks(opts) {
     const hookScript = await readSkillAsset(`hooks/${HOOK_FILENAME}`);
     const guide = await readSkillAsset(GUIDE_FILENAME);
     const scriptPath = installedHookPath();
-    await fs12.mkdir(path13.dirname(scriptPath), { recursive: true });
-    await fs12.writeFile(scriptPath, hookScript, { mode: 493 });
-    const guidePath = path13.join(neatHome2(), GUIDE_INSTALL_NAME);
-    await fs12.writeFile(guidePath, guide, "utf8");
+    await fs13.mkdir(path14.dirname(scriptPath), { recursive: true });
+    await fs13.writeFile(scriptPath, hookScript, { mode: 493 });
+    const guidePath = path14.join(neatHome2(), GUIDE_INSTALL_NAME);
+    await fs13.writeFile(guidePath, guide, "utf8");
     const settingsFile = claudeSettingsPath();
     let settings = {};
     try {
-      settings = JSON.parse(await fs12.readFile(settingsFile, "utf8"));
+      settings = JSON.parse(await fs13.readFile(settingsFile, "utf8"));
     } catch (err) {
       if (err.code !== "ENOENT") {
         console.error(
@@ -6763,14 +6899,14 @@ async function runHooks(opts) {
       ...settings,
       hooks: { ...hooks, PreToolUse: preToolUse }
     };
-    await fs12.mkdir(path13.dirname(settingsFile), { recursive: true });
-    await fs12.writeFile(settingsFile, JSON.stringify(merged, null, 2) + "\n", "utf8");
+    await fs13.mkdir(path14.dirname(settingsFile), { recursive: true });
+    await fs13.writeFile(settingsFile, JSON.stringify(merged, null, 2) + "\n", "utf8");
     const flag = gateFlagPath();
     if (opts.gate) {
-      await fs12.mkdir(path13.dirname(flag), { recursive: true });
-      await fs12.writeFile(flag, "1\n", "utf8");
+      await fs13.mkdir(path14.dirname(flag), { recursive: true });
+      await fs13.writeFile(flag, "1\n", "utf8");
     } else {
-      await fs12.rm(flag, { force: true });
+      await fs13.rm(flag, { force: true });
     }
     const mode = opts.gate ? "GATE (deny search until you ask the graph)" : "nudge (search still runs)";
     console.log(`neat hooks: installed the search hook in ${opts.gate ? "gate" : "nudge"} mode`);
@@ -6859,8 +6995,8 @@ async function runHooksCommand(args) {
 }
 
 // src/claude-cli.ts
-import path14 from "path";
-import { promises as fs13 } from "fs";
+import path15 from "path";
+import { promises as fs14 } from "fs";
 var NEAT_SECTION_HEADING = "## neat";
 var NEAT_DIRECTIVE_BODY = `This project has NEAT wired in: a live, fused semantic graph of the system \u2014
 code and runtime behaviour (OpenTelemetry) in one model, every fact tagged with
@@ -6894,8 +7030,8 @@ ${NEAT_DIRECTIVE_BODY}
 }
 function claudeMdPath() {
   const override = process.env.NEAT_CLAUDE_MD;
-  if (override && override.length > 0) return path14.resolve(override);
-  return path14.join(process.cwd(), "CLAUDE.md");
+  if (override && override.length > 0) return path15.resolve(override);
+  return path15.join(process.cwd(), "CLAUDE.md");
 }
 function splitAroundSection(raw) {
   const lines = raw.split("\n");
@@ -6923,7 +7059,7 @@ function compose(before, after) {
 }
 async function readIfExists(file) {
   try {
-    return await fs13.readFile(file, "utf8");
+    return await fs14.readFile(file, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") return null;
     throw err;
@@ -6934,8 +7070,8 @@ async function runInstall() {
   const raw = await readIfExists(file) ?? "";
   const { before, after, found } = splitAroundSection(raw);
   const next = compose(before, after);
-  await fs13.mkdir(path14.dirname(file), { recursive: true });
-  await fs13.writeFile(file, next, "utf8");
+  await fs14.mkdir(path15.dirname(file), { recursive: true });
+  await fs14.writeFile(file, next, "utf8");
   const verb = raw.length === 0 ? "created" : found ? "refreshed" : "added";
   console.log(`neat claude: ${verb} the \`${NEAT_SECTION_HEADING}\` section in ${file}`);
   console.log("Your agent will now reach for `neat ask` before Read/Grep/Bash. Restart the");
@@ -6956,7 +7092,7 @@ async function runUninstall() {
   }
   const remaining = [before, after].filter((s) => s.length > 0).join("\n\n");
   const next = remaining.length > 0 ? remaining.replace(/\n*$/, "") + "\n" : "";
-  await fs13.writeFile(file, next, "utf8");
+  await fs14.writeFile(file, next, "utf8");
   console.log(`neat claude: removed the \`${NEAT_SECTION_HEADING}\` section from ${file}.`);
   return { exitCode: 0 };
 }
@@ -6998,9 +7134,9 @@ async function runClaudeCommand(args) {
 }
 
 // src/codex-cli.ts
-import path15 from "path";
+import path16 from "path";
 import os3 from "os";
-import { promises as fs14 } from "fs";
+import { promises as fs15 } from "fs";
 import { isDeepStrictEqual } from "util";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
 var CODEX_MCP_SERVER = {
@@ -7018,14 +7154,14 @@ var NEAT_GRAPH_FIRST_START = "<!-- neat:graph-first -->";
 var NEAT_GRAPH_FIRST_END = "<!-- /neat:graph-first -->";
 function codexConfigPath() {
   const override = process.env.NEAT_CODEX_CONFIG;
-  if (override && override.length > 0) return path15.resolve(override);
+  if (override && override.length > 0) return path16.resolve(override);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? os3.homedir();
-  return path15.join(home, ".codex", "config.toml");
+  return path16.join(home, ".codex", "config.toml");
 }
 function agentsFilePath() {
   const override = process.env.NEAT_CODEX_AGENTS;
-  if (override && override.length > 0) return path15.resolve(override);
-  return path15.join(process.cwd(), "AGENTS.md");
+  if (override && override.length > 0) return path16.resolve(override);
+  return path16.join(process.cwd(), "AGENTS.md");
 }
 function isTableHeader(line) {
   return /^\s*\[\[?[^\]]+\]\]?\s*$/.test(line);
@@ -7159,7 +7295,7 @@ async function runCodex(opts) {
   const agentsPath = agentsFilePath();
   let configRaw = "";
   try {
-    configRaw = await fs14.readFile(configPath, "utf8");
+    configRaw = await fs15.readFile(configPath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       console.error(`neat codex: failed to read ${configPath} \u2014 ${err.message}`);
@@ -7168,7 +7304,7 @@ async function runCodex(opts) {
   }
   let agentsRaw = "";
   try {
-    agentsRaw = await fs14.readFile(agentsPath, "utf8");
+    agentsRaw = await fs15.readFile(agentsPath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       console.error(`neat codex: failed to read ${agentsPath} \u2014 ${err.message}`);
@@ -7208,15 +7344,15 @@ async function runCodex(opts) {
     return { exitCode: 0 };
   }
   if (config.changed) {
-    await fs14.mkdir(path15.dirname(configPath), { recursive: true });
-    await fs14.writeFile(configPath, config.text, "utf8");
+    await fs15.mkdir(path16.dirname(configPath), { recursive: true });
+    await fs15.writeFile(configPath, config.text, "utf8");
     console.log(`neat codex: wrote [mcp_servers.neat] to ${configPath}`);
   } else {
     console.log(`neat codex: ${configPath} already has NEAT's MCP server`);
   }
   if (agents.changed) {
-    await fs14.mkdir(path15.dirname(agentsPath), { recursive: true });
-    await fs14.writeFile(agentsPath, agents.text, "utf8");
+    await fs15.mkdir(path16.dirname(agentsPath), { recursive: true });
+    await fs15.writeFile(agentsPath, agents.text, "utf8");
     console.log(`neat codex: wrote the graph-first block to ${agentsPath}`);
   } else {
     console.log(`neat codex: ${agentsPath} already has the graph-first block`);
@@ -7272,9 +7408,9 @@ async function runCodexCommand(args) {
 }
 
 // src/editors-cli.ts
-import path16 from "path";
+import path17 from "path";
 import os4 from "os";
-import { promises as fs15 } from "fs";
+import { promises as fs16 } from "fs";
 import { isDeepStrictEqual as isDeepStrictEqual2 } from "util";
 import * as jsonc from "jsonc-parser";
 var NEAT_MCP_SERVER = {
@@ -7298,17 +7434,17 @@ function homeDir() {
 }
 function xdgConfigDir() {
   const xdg = process.env.XDG_CONFIG_HOME;
-  return xdg && xdg.length > 0 ? path16.resolve(xdg) : path16.join(homeDir(), ".config");
+  return xdg && xdg.length > 0 ? path17.resolve(xdg) : path17.join(homeDir(), ".config");
 }
 function envOverride(name) {
   const v = process.env[name];
-  return v && v.length > 0 ? path16.resolve(v) : void 0;
+  return v && v.length > 0 ? path17.resolve(v) : void 0;
 }
 var CURSOR_CLIENT = {
   id: "cursor",
   label: "Cursor",
   docsUrl: "https://docs.cursor.com/context/mcp",
-  mcpConfigPath: () => envOverride("NEAT_CURSOR_CONFIG") ?? path16.join(homeDir(), ".cursor", "mcp.json"),
+  mcpConfigPath: () => envOverride("NEAT_CURSOR_CONFIG") ?? path17.join(homeDir(), ".cursor", "mcp.json"),
   mcpContainerKey: "mcpServers",
   format: "json",
   // Cursor still reads a single `.cursorrules` at the project root (the modern
@@ -7320,7 +7456,7 @@ var DEVIN_CLIENT = {
   id: "devin",
   label: "Devin Desktop (Cascade)",
   docsUrl: "https://docs.devin.ai/desktop/cascade/mcp",
-  mcpConfigPath: () => envOverride("NEAT_DEVIN_CONFIG") ?? path16.join(homeDir(), ".codeium", "windsurf", "mcp_config.json"),
+  mcpConfigPath: () => envOverride("NEAT_DEVIN_CONFIG") ?? path17.join(homeDir(), ".codeium", "windsurf", "mcp_config.json"),
   mcpContainerKey: "mcpServers",
   format: "json",
   rulesFileName: ".windsurfrules"
@@ -7329,7 +7465,7 @@ var GEMINI_CLIENT = {
   id: "gemini",
   label: "Gemini CLI",
   docsUrl: "https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md",
-  mcpConfigPath: () => envOverride("NEAT_GEMINI_CONFIG") ?? path16.join(homeDir(), ".gemini", "settings.json"),
+  mcpConfigPath: () => envOverride("NEAT_GEMINI_CONFIG") ?? path17.join(homeDir(), ".gemini", "settings.json"),
   mcpContainerKey: "mcpServers",
   format: "json",
   rulesFileName: "GEMINI.md"
@@ -7338,7 +7474,7 @@ var QWEN_CLIENT = {
   id: "qwen",
   label: "Qwen Code",
   docsUrl: "https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/",
-  mcpConfigPath: () => envOverride("NEAT_QWEN_CONFIG") ?? path16.join(homeDir(), ".qwen", "settings.json"),
+  mcpConfigPath: () => envOverride("NEAT_QWEN_CONFIG") ?? path17.join(homeDir(), ".qwen", "settings.json"),
   mcpContainerKey: "mcpServers",
   format: "json",
   rulesFileName: "QWEN.md"
@@ -7347,7 +7483,7 @@ var AMAZONQ_CLIENT = {
   id: "amazonq",
   label: "Amazon Q Developer CLI",
   docsUrl: "https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html",
-  mcpConfigPath: () => envOverride("NEAT_AMAZONQ_CONFIG") ?? path16.join(homeDir(), ".aws", "amazonq", "mcp.json"),
+  mcpConfigPath: () => envOverride("NEAT_AMAZONQ_CONFIG") ?? path17.join(homeDir(), ".aws", "amazonq", "mcp.json"),
   mcpContainerKey: "mcpServers",
   format: "json"
 };
@@ -7355,7 +7491,7 @@ var ROOCODE_CLIENT = {
   id: "roocode",
   label: "Roo Code",
   docsUrl: "https://roocodeinc.github.io/Roo-Code/features/mcp/using-mcp-in-roo",
-  mcpConfigPath: () => envOverride("NEAT_ROOCODE_CONFIG") ?? path16.join(process.cwd(), ".roo", "mcp.json"),
+  mcpConfigPath: () => envOverride("NEAT_ROOCODE_CONFIG") ?? path17.join(process.cwd(), ".roo", "mcp.json"),
   mcpContainerKey: "mcpServers",
   format: "json"
 };
@@ -7368,9 +7504,9 @@ var ZED_CLIENT = {
     if (override) return override;
     if (process.platform === "win32") {
       const appData = process.env.APPDATA;
-      if (appData && appData.length > 0) return path16.join(appData, "Zed", "settings.json");
+      if (appData && appData.length > 0) return path17.join(appData, "Zed", "settings.json");
     }
-    return path16.join(homeDir(), ".config", "zed", "settings.json");
+    return path17.join(homeDir(), ".config", "zed", "settings.json");
   },
   mcpContainerKey: "context_servers",
   format: "jsonc",
@@ -7380,7 +7516,7 @@ var OPENCODE_CLIENT = {
   id: "opencode",
   label: "OpenCode",
   docsUrl: "https://opencode.ai/docs/mcp-servers/",
-  mcpConfigPath: () => envOverride("NEAT_OPENCODE_CONFIG") ?? path16.join(xdgConfigDir(), "opencode", "opencode.json"),
+  mcpConfigPath: () => envOverride("NEAT_OPENCODE_CONFIG") ?? path17.join(xdgConfigDir(), "opencode", "opencode.json"),
   mcpContainerKey: "mcp",
   format: "json",
   serverEntry: NEAT_OPENCODE_SERVER,
@@ -7390,7 +7526,7 @@ var CRUSH_CLIENT = {
   id: "crush",
   label: "Crush",
   docsUrl: "https://charmbracelet-crush.mintlify.app/configuration/mcp",
-  mcpConfigPath: () => envOverride("NEAT_CRUSH_CONFIG") ?? path16.join(xdgConfigDir(), "crush", "crush.json"),
+  mcpConfigPath: () => envOverride("NEAT_CRUSH_CONFIG") ?? path17.join(xdgConfigDir(), "crush", "crush.json"),
   mcpContainerKey: "mcp",
   format: "json",
   serverEntry: NEAT_CRUSH_SERVER,
@@ -7453,7 +7589,7 @@ async function planMcp(client, mcpPath) {
   const serverEntry = client.serverEntry ?? NEAT_MCP_SERVER;
   let raw = "";
   try {
-    raw = await fs15.readFile(mcpPath, "utf8");
+    raw = await fs16.readFile(mcpPath, "utf8");
   } catch (err) {
     const e = err;
     if (e.code === "ENOENT") {
@@ -7495,7 +7631,7 @@ async function runEditorInstall(client, opts) {
   const mcpPath = client.mcpConfigPath();
   const serverEntry = client.serverEntry ?? NEAT_MCP_SERVER;
   const hasRules = typeof client.rulesFileName === "string";
-  const rulesPath = hasRules ? path16.join(opts.projectDir, client.rulesFileName) : "";
+  const rulesPath = hasRules ? path17.join(opts.projectDir, client.rulesFileName) : "";
   const mcp = await planMcp(client, mcpPath);
   if (mcp === null) return { exitCode: 1 };
   let existingRules = "";
@@ -7504,7 +7640,7 @@ async function runEditorInstall(client, opts) {
   let block = "";
   if (hasRules) {
     try {
-      existingRules = await fs15.readFile(rulesPath, "utf8");
+      existingRules = await fs16.readFile(rulesPath, "utf8");
     } catch (err) {
       if (err.code !== "ENOENT") {
         console.error(`neat ${client.id}: failed to read ${rulesPath} \u2014 ${err.message}`);
@@ -7538,11 +7674,11 @@ async function runEditorInstall(client, opts) {
     );
     return { exitCode: 0 };
   }
-  await fs15.mkdir(path16.dirname(mcpPath), { recursive: true });
-  await fs15.writeFile(mcpPath, mcp.text, "utf8");
+  await fs16.mkdir(path17.dirname(mcpPath), { recursive: true });
+  await fs16.writeFile(mcpPath, mcp.text, "utf8");
   if (hasRules) {
-    await fs15.mkdir(path16.dirname(rulesPath), { recursive: true });
-    await fs15.writeFile(rulesPath, newRules, "utf8");
+    await fs16.mkdir(path17.dirname(rulesPath), { recursive: true });
+    await fs16.writeFile(rulesPath, newRules, "utf8");
   }
   console.log(`neat ${client.id}: wired NEAT into ${client.label}`);
   console.log(`  MCP server: ${mcpPath} (${client.mcpContainerKey}.neat \u2192 npx -y @neat.is/mcp)`);
@@ -8042,7 +8178,7 @@ function sleep(ms, signal) {
 }
 
 // src/cli-verbs.ts
-import path17 from "path";
+import path18 from "path";
 async function resolveProjectEntry(opts) {
   const entries = await listProjects();
   if (opts.project) {
@@ -8052,7 +8188,7 @@ async function resolveProjectEntry(opts) {
   const cwd = opts.cwd ?? process.cwd();
   const resolvedCwd = await normalizeProjectPath(cwd);
   for (const entry2 of entries) {
-    if (resolvedCwd === entry2.path || resolvedCwd.startsWith(`${entry2.path}${path17.sep}`)) {
+    if (resolvedCwd === entry2.path || resolvedCwd.startsWith(`${entry2.path}${path18.sep}`)) {
       return entry2;
     }
   }
@@ -8629,7 +8765,7 @@ async function buildPatchSections(services, project) {
 }
 async function runInit(opts) {
   const written = [];
-  const stat = await fs16.stat(opts.scanPath).catch(() => null);
+  const stat = await fs17.stat(opts.scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) {
     console.error(`neat init: ${opts.scanPath} is not a directory`);
     return { exitCode: 2, writtenFiles: written };
@@ -8638,13 +8774,13 @@ async function runInit(opts) {
   printDiscoveryReport(opts, services);
   const sections = opts.noInstall ? [] : await buildPatchSections(services, opts.project);
   const patch = renderPatch(sections);
-  const patchPath = path18.join(opts.scanPath, "neat.patch");
+  const patchPath = path19.join(opts.scanPath, "neat.patch");
   if (opts.dryRun) {
-    await fs16.writeFile(patchPath, patch, "utf8");
+    await fs17.writeFile(patchPath, patch, "utf8");
     written.push(patchPath);
     console.log(`dry-run: patch written to ${patchPath}`);
-    const gitignorePath = path18.join(opts.scanPath, ".gitignore");
-    const gitignoreExists = await fs16.stat(gitignorePath).then(() => true).catch(() => false);
+    const gitignorePath = path19.join(opts.scanPath, ".gitignore");
+    const gitignoreExists = await fs17.stat(gitignorePath).then(() => true).catch(() => false);
     const verb = gitignoreExists ? "append" : "create";
     console.log(`dry-run: would ${verb} ${gitignorePath} (add neat-out/)`);
     console.log("rerun without --dry-run to register and snapshot.");
@@ -8655,9 +8791,9 @@ async function runInit(opts) {
   const graph = getGraph(graphKey);
   const projectPaths = pathsForProject(
     graphKey,
-    path18.join(opts.scanPath, "neat-out")
+    path19.join(opts.scanPath, "neat-out")
   );
-  const errorsPath = path18.join(path18.dirname(opts.outPath), path18.basename(projectPaths.errorsPath));
+  const errorsPath = path19.join(path19.dirname(opts.outPath), path19.basename(projectPaths.errorsPath));
   const result = await extractFromDirectory(graph, opts.scanPath, { errorsPath });
   await saveGraphToDisk(graph, opts.outPath);
   written.push(opts.outPath);
@@ -8736,7 +8872,7 @@ async function runInit(opts) {
         console.log("Run `npm install` (or your language equivalent) to refresh lockfiles.");
       }
     } else {
-      await fs16.writeFile(patchPath, patch, "utf8");
+      await fs17.writeFile(patchPath, patch, "utf8");
       written.push(patchPath);
     }
   }
@@ -8777,9 +8913,9 @@ var CLAUDE_SKILL_CONFIG = {
 };
 function claudeConfigPath() {
   const override = process.env.NEAT_CLAUDE_CONFIG;
-  if (override && override.length > 0) return path18.resolve(override);
+  if (override && override.length > 0) return path19.resolve(override);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return path18.join(home, ".claude.json");
+  return path19.join(home, ".claude.json");
 }
 async function runSkill(opts) {
   const snippet = JSON.stringify(CLAUDE_SKILL_CONFIG, null, 2) + "\n";
@@ -8791,7 +8927,7 @@ async function runSkill(opts) {
     const target = claudeConfigPath();
     let existing = {};
     try {
-      existing = JSON.parse(await fs16.readFile(target, "utf8"));
+      existing = JSON.parse(await fs17.readFile(target, "utf8"));
     } catch (err) {
       if (err.code !== "ENOENT") {
         console.error(`neat skill: failed to read ${target} \u2014 ${err.message}`);
@@ -8803,8 +8939,8 @@ async function runSkill(opts) {
       ...existing,
       mcpServers: { ...mcp, neat: CLAUDE_SKILL_CONFIG.mcpServers.neat }
     };
-    await fs16.mkdir(path18.dirname(target), { recursive: true });
-    await fs16.writeFile(target, JSON.stringify(merged, null, 2) + "\n", "utf8");
+    await fs17.mkdir(path19.dirname(target), { recursive: true });
+    await fs17.writeFile(target, JSON.stringify(merged, null, 2) + "\n", "utf8");
     console.log(`neat skill: wrote mcpServers.neat to ${target}`);
     console.log("restart Claude Code to pick up the new MCP server.");
     console.log("");
@@ -8830,7 +8966,7 @@ async function runSkill(opts) {
 async function main() {
   const argv = process.argv.slice(2);
   const cmd0 = argv[0];
-  if (cmd0 === "-h" || cmd0 === "--help") {
+  if (argv.some((a) => a === "-h" || a === "--help")) {
     usage5();
     process.exit(0);
   }
@@ -8925,12 +9061,12 @@ async function main() {
       console.error("neat init: --apply and --dry-run are mutually exclusive");
       process.exit(2);
     }
-    const scanPath = path18.resolve(target);
+    const scanPath = path19.resolve(target);
     const projectExplicit = parsed.project !== null;
-    const projectName = projectExplicit ? project : path18.basename(scanPath);
+    const projectName = projectExplicit ? project : path19.basename(scanPath);
     const projectKey = projectExplicit ? project : DEFAULT_PROJECT;
-    const fallback = pathsForProject(projectKey, path18.join(scanPath, "neat-out")).snapshotPath;
-    const outPath = path18.resolve(process.env.NEAT_OUT_PATH ?? fallback);
+    const fallback = pathsForProject(projectKey, path19.join(scanPath, "neat-out")).snapshotPath;
+    const outPath = path19.resolve(process.env.NEAT_OUT_PATH ?? fallback);
     const result = await runInit({
       scanPath,
       outPath,
@@ -8951,21 +9087,21 @@ async function main() {
       usage5();
       process.exit(2);
     }
-    const scanPath = path18.resolve(target);
-    const stat = await fs16.stat(scanPath).catch(() => null);
+    const scanPath = path19.resolve(target);
+    const stat = await fs17.stat(scanPath).catch(() => null);
     if (!stat || !stat.isDirectory()) {
       console.error(`neat watch: ${scanPath} is not a directory`);
       process.exit(2);
     }
-    const projectPaths = pathsForProject(project, path18.join(scanPath, "neat-out"));
-    const outPath = path18.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
-    const errorsPath = path18.resolve(
-      process.env.NEAT_ERRORS_PATH ?? path18.join(path18.dirname(outPath), path18.basename(projectPaths.errorsPath))
+    const projectPaths = pathsForProject(project, path19.join(scanPath, "neat-out"));
+    const outPath = path19.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
+    const errorsPath = path19.resolve(
+      process.env.NEAT_ERRORS_PATH ?? path19.join(path19.dirname(outPath), path19.basename(projectPaths.errorsPath))
     );
-    const staleEventsPath = path18.resolve(
-      process.env.NEAT_STALE_EVENTS_PATH ?? path18.join(path18.dirname(outPath), path18.basename(projectPaths.staleEventsPath))
+    const staleEventsPath = path19.resolve(
+      process.env.NEAT_STALE_EVENTS_PATH ?? path19.join(path19.dirname(outPath), path19.basename(projectPaths.staleEventsPath))
     );
-    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? path18.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
+    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? path19.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
     const handle = await startWatch(getGraph(project), {
       scanPath,
       outPath,
@@ -8974,7 +9110,7 @@ async function main() {
       project,
       // Resolve NEAT_HOME so a `neat watch` picks up connectors added to
       // ~/.neat/connectors.json (#871). Same resolution the rest of the CLI uses.
-      neatHome: process.env.NEAT_HOME ? path18.resolve(process.env.NEAT_HOME) : path18.join(os5.homedir(), ".neat"),
+      neatHome: process.env.NEAT_HOME ? path19.resolve(process.env.NEAT_HOME) : path19.join(os5.homedir(), ".neat"),
       ...embeddingsCachePath ? { embeddingsCachePath } : {},
       host: process.env.HOST ?? "0.0.0.0",
       port: Number(process.env.PORT ?? 8080),
@@ -9156,11 +9292,11 @@ async function main() {
   process.exit(1);
 }
 async function tryOrchestrator(cmd, parsed) {
-  const scanPath = path18.resolve(cmd);
-  const stat = await fs16.stat(scanPath).catch(() => null);
+  const scanPath = path19.resolve(cmd);
+  const stat = await fs17.stat(scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) return null;
   const projectExplicit = parsed.project !== null;
-  const projectName = projectExplicit ? parsed.project : path18.basename(scanPath);
+  const projectName = projectExplicit ? parsed.project : path19.basename(scanPath);
   const result = await runOrchestrator({
     scanPath,
     project: projectName,