@neat.is/core 0.4.14 → 0.4.16

package/dist/cli.js

@@ -57,13 +57,47 @@ import {
 } from "./chunk-6CO7C4IU.js";
 
 // src/cli.ts
-import path8 from "path";
-import { promises as fs7, readFileSync } from "fs";
+import path9 from "path";
+import { promises as fs7 } from "fs";
+
+// src/banner.ts
+import path from "path";
+import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
+function readPackageVersion() {
+  const here = typeof __dirname !== "undefined" ? __dirname : path.dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    path.resolve(here, "../package.json"),
+    path.resolve(here, "../../package.json")
+  ];
+  for (const candidate of candidates) {
+    try {
+      const raw = readFileSync(candidate, "utf8");
+      const parsed = JSON.parse(raw);
+      if (parsed.name === "@neat.is/core" && typeof parsed.version === "string") {
+        return parsed.version;
+      }
+    } catch {
+    }
+  }
+  return "unknown";
+}
+function printBanner() {
+  console.log("\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");
+  console.log("\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D");
+  console.log("\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ");
+  console.log("\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ");
+  console.log("\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ");
+  console.log("\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ");
+  console.log("");
+  console.log("  Network Expressive Architecting Tool");
+  console.log(`  neat.is  \xB7  v${readPackageVersion()}  \xB7  Apache 2.0`);
+  console.log("");
+}
 
 // src/gitignore.ts
 import { promises as fs } from "fs";
-import path from "path";
+import path2 from "path";
 var NEAT_OUT_LINE = "neat-out/";
 var NEAT_HEADER = "# NEAT \u2014 machine-local snapshots and events";
 function isNeatOutLine(line) {
@@ -71,7 +105,7 @@ function isNeatOutLine(line) {
   return trimmed === "neat-out/" || trimmed === "neat-out";
 }
 async function ensureNeatOutIgnored(projectDir) {
-  const file = path.join(projectDir, ".gitignore");
+  const file = path2.join(projectDir, ".gitignore");
   let existing = null;
   try {
     existing = await fs.readFile(file, "utf8");
@@ -193,7 +227,7 @@ function formatIncompat(inc) {
 
 // src/watch.ts
 import fs2 from "fs";
-import path2 from "path";
+import path3 from "path";
 import chokidar from "chokidar";
 var ALL_PHASES = [
   "services",
@@ -206,8 +240,8 @@ var ALL_PHASES = [
 ];
 function classifyChange(relPath) {
   const phases = /* @__PURE__ */ new Set();
-  const base = path2.basename(relPath).toLowerCase();
-  const segments = relPath.split(path2.sep).map((s) => s.toLowerCase());
+  const base = path3.basename(relPath).toLowerCase();
+  const segments = relPath.split(path3.sep).map((s) => s.toLowerCase());
   if (base === "package.json" || base === "requirements.txt" || base === "pyproject.toml" || base === "setup.py") {
     phases.add("services");
     phases.add("aliases");
@@ -328,9 +362,9 @@ function countWatchableDirs(scanPath, limit) {
     for (const e of entries) {
       if (count >= limit) return;
       if (!e.isDirectory()) continue;
-      if (IGNORED_WATCH_PATHS.some((re) => re.test(path2.join(dir, e.name) + path2.sep))) continue;
+      if (IGNORED_WATCH_PATHS.some((re) => re.test(path3.join(dir, e.name) + path3.sep))) continue;
       count++;
-      if (depth < 2) visit(path2.join(dir, e.name), depth + 1);
+      if (depth < 2) visit(path3.join(dir, e.name), depth + 1);
     }
   };
   visit(scanPath, 0);
@@ -348,8 +382,8 @@ async function startWatch(graph, opts) {
   const projectName = opts.project ?? DEFAULT_PROJECT;
   await loadGraphFromDisk(graph, opts.outPath);
   const detachEventBus = attachGraphToEventBus(graph, { project: projectName });
-  const policyFilePath = path2.join(opts.scanPath, "policy.json");
-  const policyViolationsPath = path2.join(path2.dirname(opts.outPath), "policy-violations.ndjson");
+  const policyFilePath = path3.join(opts.scanPath, "policy.json");
+  const policyViolationsPath = path3.join(path3.dirname(opts.outPath), "policy-violations.ndjson");
   let policies = [];
   try {
     policies = await loadPolicyFile(policyFilePath);
@@ -400,7 +434,7 @@ async function startWatch(graph, opts) {
   assertBindAuthority(host, auth.authToken);
   const port = opts.port ?? 8080;
   const otelPort = opts.otelPort ?? 4318;
-  const cachePath = opts.embeddingsCachePath ?? path2.join(path2.dirname(opts.outPath), "embeddings.json");
+  const cachePath = opts.embeddingsCachePath ?? path3.join(path3.dirname(opts.outPath), "embeddings.json");
   let searchIndex;
   try {
     searchIndex = await buildSearchIndex(graph, { cachePath });
@@ -418,7 +452,7 @@ async function startWatch(graph, opts) {
       // Paths are derived from the explicit options the watch caller passes
       // — pathsForProject is only used to fill in the embeddings/snapshot
       // fields so the registry shape is complete.
-      ...pathsForProject(projectName, path2.dirname(opts.outPath)),
+      ...pathsForProject(projectName, path3.dirname(opts.outPath)),
       snapshotPath: opts.outPath,
       errorsPath: opts.errorsPath,
       staleEventsPath: opts.staleEventsPath
@@ -505,9 +539,9 @@ async function startWatch(graph, opts) {
   };
   const onPath = (absPath) => {
     if (shouldIgnore(absPath)) return;
-    const rel = path2.relative(opts.scanPath, absPath);
+    const rel = path3.relative(opts.scanPath, absPath);
     if (!rel || rel.startsWith("..")) return;
-    pendingPaths.add(rel.split(path2.sep).join("/"));
+    pendingPaths.add(rel.split(path3.sep).join("/"));
     const phases = classifyChange(rel);
     if (phases.size === 0) {
       for (const p of ALL_PHASES) pending.add(p);
@@ -561,7 +595,7 @@ async function startWatch(graph, opts) {
 
 // src/deploy/detect.ts
 import { promises as fs3 } from "fs";
-import path3 from "path";
+import path4 from "path";
 import { spawn } from "child_process";
 import { randomBytes } from "crypto";
 function generateToken() {
@@ -661,7 +695,7 @@ async function runDeploy(opts = {}) {
   const token = generateToken();
   switch (substrate) {
     case "docker-compose": {
-      const artifactPath = path3.join(cwd, "docker-compose.neat.yml");
+      const artifactPath = path4.join(cwd, "docker-compose.neat.yml");
       const contents = emitDockerCompose(cwd);
       await fs3.writeFile(artifactPath, contents, "utf8");
       return {
@@ -669,11 +703,11 @@ async function runDeploy(opts = {}) {
         artifactPath,
         token,
         contents,
-        startCommand: `NEAT_AUTH_TOKEN=${token} docker compose -f ${path3.basename(artifactPath)} up -d`
+        startCommand: `NEAT_AUTH_TOKEN=${token} docker compose -f ${path4.basename(artifactPath)} up -d`
       };
     }
     case "systemd": {
-      const artifactPath = path3.join(cwd, "neat.service");
+      const artifactPath = path4.join(cwd, "neat.service");
       const contents = emitSystemdUnit(cwd);
       await fs3.writeFile(artifactPath, contents, "utf8");
       return {
@@ -705,7 +739,7 @@ ${contents}EOF
 
 // src/installers/javascript.ts
 import { promises as fs4 } from "fs";
-import path4 from "path";
+import path5 from "path";
 import semver from "semver";
 
 // src/installers/templates.ts
@@ -1251,11 +1285,11 @@ var OTEL_ENV = {
   value: "http://localhost:4318/projects/<project>/v1/traces"
 };
 function serviceNodeName(pkg, serviceDir) {
-  return pkg.name ?? path4.basename(serviceDir);
+  return pkg.name ?? path5.basename(serviceDir);
 }
 function projectToken(pkg, serviceDir, project) {
   if (project && project.length > 0) return project;
-  return pkg.name ?? path4.basename(serviceDir);
+  return pkg.name ?? path5.basename(serviceDir);
 }
 async function readJsonFile(p) {
   try {
@@ -1268,16 +1302,16 @@ async function readJsonFile(p) {
 async function detectRuntimeKind(pkgRoot, pkg) {
   const deps = allDeps(pkg);
   if ("react-native" in deps || "expo" in deps) return "react-native";
-  const appJson = await readJsonFile(path4.join(pkgRoot, "app.json"));
+  const appJson = await readJsonFile(path5.join(pkgRoot, "app.json"));
   if (appJson && typeof appJson === "object" && "expo" in appJson) {
     return "react-native";
   }
-  if (await exists(path4.join(pkgRoot, "vite.config.js")) || await exists(path4.join(pkgRoot, "vite.config.ts")) || await exists(path4.join(pkgRoot, "vite.config.mjs")) || "vite" in deps) {
+  if (await exists(path5.join(pkgRoot, "vite.config.js")) || await exists(path5.join(pkgRoot, "vite.config.ts")) || await exists(path5.join(pkgRoot, "vite.config.mjs")) || "vite" in deps) {
     return "browser-bundle";
   }
-  if (await exists(path4.join(pkgRoot, "wrangler.toml"))) return "cloudflare-workers";
-  if (await exists(path4.join(pkgRoot, "bun.lockb"))) return "bun";
-  if (await exists(path4.join(pkgRoot, "deno.json")) || await exists(path4.join(pkgRoot, "deno.lock"))) {
+  if (await exists(path5.join(pkgRoot, "wrangler.toml"))) return "cloudflare-workers";
+  if (await exists(path5.join(pkgRoot, "bun.lockb"))) return "bun";
+  if (await exists(path5.join(pkgRoot, "deno.json")) || await exists(path5.join(pkgRoot, "deno.lock"))) {
     return "deno";
   }
   const engines = pkg.engines ?? {};
@@ -1286,7 +1320,7 @@ async function detectRuntimeKind(pkgRoot, pkg) {
 }
 async function readPackageJson(serviceDir) {
   try {
-    const raw = await fs4.readFile(path4.join(serviceDir, "package.json"), "utf8");
+    const raw = await fs4.readFile(path5.join(serviceDir, "package.json"), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -1330,7 +1364,7 @@ function needsVersionUpgrade(installed, expected) {
 var NEXT_CONFIG_CANDIDATES = ["next.config.js", "next.config.ts", "next.config.mjs"];
 async function findNextConfig(serviceDir) {
   for (const name of NEXT_CONFIG_CANDIDATES) {
-    const candidate = path4.join(serviceDir, name);
+    const candidate = path5.join(serviceDir, name);
     if (await exists(candidate)) return candidate;
   }
   return null;
@@ -1357,7 +1391,7 @@ function hasRemixDependency(pkg) {
 }
 async function findRemixEntry(serviceDir) {
   for (const rel of REMIX_ENTRY_CANDIDATES) {
-    const candidate = path4.join(serviceDir, rel);
+    const candidate = path5.join(serviceDir, rel);
     if (await exists(candidate)) return candidate;
   }
   return null;
@@ -1369,14 +1403,14 @@ function hasSvelteKitDependency(pkg) {
 }
 async function findSvelteKitHooks(serviceDir) {
   for (const rel of SVELTEKIT_HOOKS_CANDIDATES) {
-    const candidate = path4.join(serviceDir, rel);
+    const candidate = path5.join(serviceDir, rel);
     if (await exists(candidate)) return candidate;
   }
   return null;
 }
 async function findSvelteKitConfig(serviceDir) {
   for (const rel of SVELTEKIT_CONFIG_CANDIDATES) {
-    const candidate = path4.join(serviceDir, rel);
+    const candidate = path5.join(serviceDir, rel);
     if (await exists(candidate)) return candidate;
   }
   return null;
@@ -1387,7 +1421,7 @@ function hasNuxtDependency(pkg) {
 }
 async function findNuxtConfig(serviceDir) {
   for (const name of NUXT_CONFIG_CANDIDATES) {
-    const candidate = path4.join(serviceDir, name);
+    const candidate = path5.join(serviceDir, name);
     if (await exists(candidate)) return candidate;
   }
   return null;
@@ -1398,7 +1432,7 @@ function hasAstroDependency(pkg) {
 }
 async function findAstroConfig(serviceDir) {
   for (const name of ASTRO_CONFIG_CANDIDATES) {
-    const candidate = path4.join(serviceDir, name);
+    const candidate = path5.join(serviceDir, name);
     if (await exists(candidate)) return candidate;
   }
   return null;
@@ -1412,7 +1446,7 @@ function parseNextMajor(range) {
   return Number.isFinite(n) ? n : null;
 }
 async function isTypeScriptProject(serviceDir) {
-  return exists(path4.join(serviceDir, "tsconfig.json"));
+  return exists(path5.join(serviceDir, "tsconfig.json"));
 }
 var INDEX_EXTENSIONS = [".ts", ".tsx", ".js", ".mjs", ".cjs"];
 var INDEX_CANDIDATES = INDEX_EXTENSIONS.map((ext) => `index${ext}`);
@@ -1458,7 +1492,7 @@ function entryFromScript(script) {
 }
 async function resolveEntry(serviceDir, pkg) {
   if (typeof pkg.main === "string" && pkg.main.length > 0) {
-    const candidate = path4.resolve(serviceDir, pkg.main);
+    const candidate = path5.resolve(serviceDir, pkg.main);
     if (await exists(candidate)) return candidate;
   }
   if (pkg.bin) {
@@ -1472,36 +1506,36 @@ async function resolveEntry(serviceDir, pkg) {
       if (typeof first === "string") binEntry = first;
     }
     if (binEntry) {
-      const candidate = path4.resolve(serviceDir, binEntry);
+      const candidate = path5.resolve(serviceDir, binEntry);
       if (await exists(candidate)) return candidate;
     }
   }
   const startEntry = entryFromScript(pkg.scripts?.start);
   if (startEntry) {
-    const candidate = path4.resolve(serviceDir, startEntry);
+    const candidate = path5.resolve(serviceDir, startEntry);
     if (await exists(candidate)) return candidate;
   }
   const devEntry = entryFromScript(pkg.scripts?.dev);
   if (devEntry) {
-    const candidate = path4.resolve(serviceDir, devEntry);
+    const candidate = path5.resolve(serviceDir, devEntry);
     if (await exists(candidate)) return candidate;
   }
   for (const rel of SRC_INDEX_CANDIDATES) {
-    const candidate = path4.join(serviceDir, rel);
+    const candidate = path5.join(serviceDir, rel);
     if (await exists(candidate)) return candidate;
   }
   for (const rel of SRC_NAMED_CANDIDATES) {
-    const candidate = path4.join(serviceDir, rel);
+    const candidate = path5.join(serviceDir, rel);
     if (await exists(candidate)) return candidate;
   }
   for (const name of INDEX_CANDIDATES) {
-    const candidate = path4.join(serviceDir, name);
+    const candidate = path5.join(serviceDir, name);
     if (await exists(candidate)) return candidate;
   }
   return null;
 }
 function dispatchEntry(entryFile, pkg) {
-  const ext = path4.extname(entryFile).toLowerCase();
+  const ext = path5.extname(entryFile).toLowerCase();
   if (ext === ".ts" || ext === ".tsx") return "ts";
   if (ext === ".mjs") return "esm";
   if (ext === ".cjs") return "cjs";
@@ -1518,9 +1552,9 @@ function otelInitContents(flavor) {
   return OTEL_INIT_CJS;
 }
 function injectionLine(flavor, entryFile, otelInitFile) {
-  let rel = path4.relative(path4.dirname(entryFile), otelInitFile);
+  let rel = path5.relative(path5.dirname(entryFile), otelInitFile);
   if (!rel.startsWith(".")) rel = `./${rel}`;
-  rel = rel.split(path4.sep).join("/");
+  rel = rel.split(path5.sep).join("/");
   if (flavor === "cjs") return `require('${rel}')`;
   if (flavor === "esm") return `import '${rel}'`;
   const tsRel = rel.replace(/\.ts$/, "");
@@ -1533,23 +1567,23 @@ function lineIsOtelInjection(line) {
 }
 async function detectsSrcLayout(serviceDir) {
   const [hasSrcApp, hasSrcPages, hasRootApp, hasRootPages] = await Promise.all([
-    exists(path4.join(serviceDir, "src", "app")),
-    exists(path4.join(serviceDir, "src", "pages")),
-    exists(path4.join(serviceDir, "app")),
-    exists(path4.join(serviceDir, "pages"))
+    exists(path5.join(serviceDir, "src", "app")),
+    exists(path5.join(serviceDir, "src", "pages")),
+    exists(path5.join(serviceDir, "app")),
+    exists(path5.join(serviceDir, "pages"))
   ]);
   return (hasSrcApp || hasSrcPages) && !hasRootApp && !hasRootPages;
 }
 async function planNext(serviceDir, pkg, manifestPath, nextConfigPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
   const srcLayout = await detectsSrcLayout(serviceDir);
-  const baseDir = srcLayout ? path4.join(serviceDir, "src") : serviceDir;
-  const instrumentationFile = path4.join(baseDir, useTs ? "instrumentation.ts" : "instrumentation.js");
-  const instrumentationNodeFile = path4.join(
+  const baseDir = srcLayout ? path5.join(serviceDir, "src") : serviceDir;
+  const instrumentationFile = path5.join(baseDir, useTs ? "instrumentation.ts" : "instrumentation.js");
+  const instrumentationNodeFile = path5.join(
     baseDir,
     useTs ? "instrumentation.node.ts" : "instrumentation.node.js"
   );
-  const envNeatFile = path4.join(baseDir, ".env.neat");
+  const envNeatFile = path5.join(baseDir, ".env.neat");
   const existingDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
   const dependencyEdits = [];
   for (const sdk of SDK_PACKAGES) {
@@ -1654,7 +1688,7 @@ function buildDependencyEdits(pkg, manifestPath) {
   return edits;
 }
 async function queueEnvNeat(serviceDir, pkg, project, generatedFiles) {
-  const envNeatFile = path4.join(serviceDir, ".env.neat");
+  const envNeatFile = path5.join(serviceDir, ".env.neat");
   if (!await exists(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
@@ -1689,7 +1723,7 @@ function fileImportsOtelHook(raw, specifiers) {
 }
 async function planRemix(serviceDir, pkg, manifestPath, entryFile, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelServerFile = path4.join(
+  const otelServerFile = path5.join(
     serviceDir,
     useTs ? "app/otel.server.ts" : "app/otel.server.js"
   );
@@ -1746,11 +1780,11 @@ async function planRemix(serviceDir, pkg, manifestPath, entryFile, project) {
 }
 async function planSvelteKit(serviceDir, pkg, manifestPath, hooksFile, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelInitFile = path4.join(
+  const otelInitFile = path5.join(
     serviceDir,
     useTs ? "src/otel-init.ts" : "src/otel-init.js"
   );
-  const resolvedHooksFile = hooksFile ?? path4.join(serviceDir, useTs ? "src/hooks.server.ts" : "src/hooks.server.js");
+  const resolvedHooksFile = hooksFile ?? path5.join(serviceDir, useTs ? "src/hooks.server.ts" : "src/hooks.server.js");
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
   const entrypointEdits = [];
@@ -1812,11 +1846,11 @@ async function planSvelteKit(serviceDir, pkg, manifestPath, hooksFile, project)
 }
 async function planNuxt(serviceDir, pkg, manifestPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelPluginFile = path4.join(
+  const otelPluginFile = path5.join(
     serviceDir,
     useTs ? "server/plugins/otel.ts" : "server/plugins/otel.js"
   );
-  const otelInitFile = path4.join(
+  const otelInitFile = path5.join(
     serviceDir,
     useTs ? "server/plugins/otel-init.ts" : "server/plugins/otel-init.js"
   );
@@ -1867,19 +1901,19 @@ async function planNuxt(serviceDir, pkg, manifestPath, project) {
 var ASTRO_MIDDLEWARE_CANDIDATES = ["src/middleware.ts", "src/middleware.js"];
 async function findAstroMiddleware(serviceDir) {
   for (const rel of ASTRO_MIDDLEWARE_CANDIDATES) {
-    const candidate = path4.join(serviceDir, rel);
+    const candidate = path5.join(serviceDir, rel);
     if (await exists(candidate)) return candidate;
   }
   return null;
 }
 async function planAstro(serviceDir, pkg, manifestPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const otelInitFile = path4.join(
+  const otelInitFile = path5.join(
     serviceDir,
     useTs ? "src/otel-init.ts" : "src/otel-init.js"
   );
   const existingMiddleware = await findAstroMiddleware(serviceDir);
-  const middlewareFile = existingMiddleware ?? path4.join(serviceDir, useTs ? "src/middleware.ts" : "src/middleware.js");
+  const middlewareFile = existingMiddleware ?? path5.join(serviceDir, useTs ? "src/middleware.ts" : "src/middleware.js");
   const dependencyEdits = buildDependencyEdits(pkg, manifestPath);
   const generatedFiles = [];
   const entrypointEdits = [];
@@ -1975,7 +2009,7 @@ async function findFrameworkDispatch(serviceDir, pkg, manifestPath, project) {
 }
 async function plan(serviceDir, opts) {
   const pkg = await readPackageJson(serviceDir);
-  const manifestPath = path4.join(serviceDir, "package.json");
+  const manifestPath = path5.join(serviceDir, "package.json");
   const project = opts?.project;
   const empty = {
     language: "javascript",
@@ -2010,8 +2044,8 @@ async function plan(serviceDir, opts) {
     return { ...empty, libOnly: true };
   }
   const flavor = dispatchEntry(entryFile, pkg);
-  const otelInitFile = path4.join(path4.dirname(entryFile), otelInitFilename(flavor));
-  const envNeatFile = path4.join(serviceDir, ".env.neat");
+  const otelInitFile = path5.join(path5.dirname(entryFile), otelInitFilename(flavor));
+  const envNeatFile = path5.join(serviceDir, ".env.neat");
   const existingDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
   const dependencyEdits = [];
   for (const sdk of SDK_PACKAGES) {
@@ -2080,13 +2114,13 @@ async function plan(serviceDir, opts) {
   };
 }
 function isAllowedWritePath(serviceDir, target) {
-  const rel = path4.relative(serviceDir, target);
+  const rel = path5.relative(serviceDir, target);
   if (rel.startsWith("..")) return false;
-  const base = path4.basename(target);
+  const base = path5.basename(target);
   if (base === "package.json") return true;
   if (base === ".env.neat") return true;
   if (/^otel-init\.(?:js|cjs|mjs|ts)$/.test(base)) return true;
-  const relPosix = rel.split(path4.sep).join("/");
+  const relPosix = rel.split(path5.sep).join("/");
   if (/^instrumentation(?:\.node)?\.(?:js|cjs|mjs|ts)$/.test(base)) {
     if (relPosix === base) return true;
     if (relPosix === `src/${base}`) return true;
@@ -2103,7 +2137,7 @@ function isAllowedWritePath(serviceDir, target) {
   return false;
 }
 async function writeAtomic(file, contents) {
-  await fs4.mkdir(path4.dirname(file), { recursive: true });
+  await fs4.mkdir(path5.dirname(file), { recursive: true });
   const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
   await fs4.writeFile(tmp, contents, "utf8");
   await fs4.rename(tmp, file);
@@ -2287,7 +2321,7 @@ async function rollback(installPlan, originals, createdFiles) {
     ...removed.map((f) => `removed:  ${f}`),
     ""
   ];
-  const rollbackPath = path4.join(installPlan.serviceDir, "neat-rollback.patch");
+  const rollbackPath = path5.join(installPlan.serviceDir, "neat-rollback.patch");
   await fs4.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 function injectInstrumentationHook(raw) {
@@ -2317,7 +2351,7 @@ var javascriptInstaller = {
 
 // src/installers/python.ts
 import { promises as fs5 } from "fs";
-import path5 from "path";
+import path6 from "path";
 var SDK_PACKAGES2 = [
   { name: "opentelemetry-distro", version: ">=0.49b0" },
   { name: "opentelemetry-exporter-otlp", version: ">=1.28.0" }
@@ -2338,7 +2372,7 @@ async function exists2(p) {
 async function detect2(serviceDir) {
   const markers = ["requirements.txt", "pyproject.toml", "setup.py"];
   for (const m of markers) {
-    if (await exists2(path5.join(serviceDir, m))) return true;
+    if (await exists2(path6.join(serviceDir, m))) return true;
   }
   return false;
 }
@@ -2348,7 +2382,7 @@ function reqPackageName(line) {
   return head.replace(/[<>=!~].*$/, "").toLowerCase();
 }
 async function planRequirementsTxtEdits(serviceDir) {
-  const file = path5.join(serviceDir, "requirements.txt");
+  const file = path6.join(serviceDir, "requirements.txt");
   if (!await exists2(file)) return null;
   const raw = await fs5.readFile(file, "utf8");
   const presentNames = new Set(
@@ -2358,7 +2392,7 @@ async function planRequirementsTxtEdits(serviceDir) {
   return { manifest: file, missing: [...missing] };
 }
 async function planProcfileEdits(serviceDir) {
-  const procfile = path5.join(serviceDir, "Procfile");
+  const procfile = path6.join(serviceDir, "Procfile");
   if (!await exists2(procfile)) return [];
   const raw = await fs5.readFile(procfile, "utf8");
   const edits = [];
@@ -2447,7 +2481,7 @@ async function apply2(installPlan) {
       if (raw === void 0) {
         throw new Error(`python installer: cannot read ${file} during apply`);
       }
-      const base = path5.basename(file);
+      const base = path6.basename(file);
       if (base === "requirements.txt") {
         const edits = installPlan.dependencyEdits.filter((e) => e.file === file);
         if (edits.length > 0) {
@@ -2486,7 +2520,7 @@ async function rollback2(installPlan, originals) {
     ...restored.map((f) => `restored: ${f}`),
     ""
   ];
-  const rollbackPath = path5.join(installPlan.serviceDir, "neat-rollback.patch");
+  const rollbackPath = path6.join(installPlan.serviceDir, "neat-rollback.patch");
   await fs5.writeFile(rollbackPath, lines.join("\n"), "utf8");
 }
 var pythonInstaller = {
@@ -2611,7 +2645,7 @@ function renderPatch(sections) {
 import { promises as fs6 } from "fs";
 import http from "http";
 import net from "net";
-import path6 from "path";
+import path7 from "path";
 import { spawn as spawn2 } from "child_process";
 import readline from "readline";
 async function extractAndPersist(opts) {
@@ -2620,7 +2654,7 @@ async function extractAndPersist(opts) {
   const graphKey = opts.projectExplicit ? opts.project : DEFAULT_PROJECT;
   resetGraph(graphKey);
   const graph = getGraph(graphKey);
-  const projectPaths = pathsForProject(graphKey, path6.join(opts.scanPath, "neat-out"));
+  const projectPaths = pathsForProject(graphKey, path7.join(opts.scanPath, "neat-out"));
   const extraction = await extractFromDirectory(graph, opts.scanPath, {
     errorsPath: projectPaths.errorsPath
   });
@@ -2674,7 +2708,7 @@ async function applyInstallersOver(services, project, options = {}) {
       console.log(`skipping ${svc.dir}: browser bundle; browser-OTel support lands in a future release.`);
     } else if (outcome.outcome === "react-native") {
       reactNative++;
-      const svcName = path6.basename(svc.dir);
+      const svcName = path7.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as React Native / Expo
   The installer doesn't cover this runtime deterministically.
@@ -2685,7 +2719,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "bun") {
       bun++;
-      const svcName = path6.basename(svc.dir);
+      const svcName = path7.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Bun
   The installer doesn't cover this runtime deterministically.
@@ -2696,7 +2730,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "deno") {
       deno++;
-      const svcName = path6.basename(svc.dir);
+      const svcName = path7.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Deno
   The installer doesn't cover this runtime deterministically.
@@ -2707,7 +2741,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "cloudflare-workers") {
       cloudflareWorkers++;
-      const svcName = path6.basename(svc.dir);
+      const svcName = path7.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Cloudflare Workers
   The installer doesn't cover this runtime deterministically.
@@ -2718,7 +2752,7 @@ async function applyInstallersOver(services, project, options = {}) {
       );
     } else if (outcome.outcome === "electron") {
       electron++;
-      const svcName = path6.basename(svc.dir);
+      const svcName = path7.basename(svc.dir);
       console.log(
         `neat: ${svc.dir} detected as Electron
   The installer doesn't cover this runtime deterministically.
@@ -2892,10 +2926,10 @@ function formatPortCollisionMessage(port) {
   ];
 }
 function spawnDaemonDetached() {
-  const here = path6.dirname(new URL(import.meta.url).pathname);
+  const here = path7.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path6.join(here, "neatd.cjs"),
-    path6.join(here, "neatd.js")
+    path7.join(here, "neatd.cjs"),
+    path7.join(here, "neatd.js")
   ];
   let entry2 = null;
   const fsSync = __require("fs");
@@ -2959,6 +2993,7 @@ async function runOrchestrator(opts) {
     result.exitCode = 2;
     return result;
   }
+  printBanner();
   console.log(`neat: ${opts.scanPath}`);
   console.log("");
   const persisted = await extractAndPersist({
@@ -2969,6 +3004,13 @@ async function runOrchestrator(opts) {
   const { graph, services, languages } = persisted;
   result.steps.discovery = { services: services.length, languages };
   console.log(`discovered ${services.length} service(s) across ${languages.length} language(s)`);
+  if (services.length === 0) {
+    console.error(
+      `neat: no services found in ${opts.scanPath} \u2014 run from inside your project root, or \`npx neat.is <path>\``
+    );
+    result.exitCode = 2;
+    return result;
+  }
   let runApply = !opts.noInstrument;
   if (runApply && !opts.yes && process.stdout.isTTY && process.stdin.isTTY) {
     runApply = await promptYesNo("instrument your services and open the dashboard?");
@@ -3092,10 +3134,16 @@ function printSummary(result, graph, dashboardUrl) {
   for (const [t, c] of [...byEdge.entries()].sort()) console.log(`  ${t}: ${c}`);
   console.log("");
   console.log(`dashboard: ${dashboardUrl}`);
+  const token = process.env.NEAT_AUTH_TOKEN;
+  if (typeof token === "string" && token.length > 0) {
+    console.log(`auth token: ${token}`);
+  } else {
+    console.log("running locally \u2014 open the dashboard, no token needed");
+  }
 }
 
 // src/cli-verbs.ts
-import path7 from "path";
+import path8 from "path";
 
 // src/cli-client.ts
 import { Provenance as Provenance2 } from "@neat.is/types";
@@ -3123,10 +3171,10 @@ function createHttpClient(baseUrl, bearerToken) {
   const root = baseUrl.replace(/\/$/, "");
   const authHeader = bearerToken && bearerToken.length > 0 ? { authorization: `Bearer ${bearerToken}` } : {};
   return {
-    async get(path9) {
+    async get(path10) {
       let res;
       try {
-        res = await fetch(`${root}${path9}`, {
+        res = await fetch(`${root}${path10}`, {
           headers: { ...authHeader }
         });
       } catch (err) {
@@ -3138,16 +3186,16 @@ function createHttpClient(baseUrl, bearerToken) {
         const body = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on GET ${path9}: ${body}`,
+          `${res.status} ${res.statusText} on GET ${path10}: ${body}`,
           body
         );
       }
       return await res.json();
     },
-    async post(path9, body) {
+    async post(path10, body) {
       let res;
       try {
-        res = await fetch(`${root}${path9}`, {
+        res = await fetch(`${root}${path10}`, {
           method: "POST",
           headers: { "content-type": "application/json", ...authHeader },
           body: JSON.stringify(body)
@@ -3161,7 +3209,7 @@ function createHttpClient(baseUrl, bearerToken) {
         const text = await res.text().catch(() => "");
         throw new HttpError(
           res.status,
-          `${res.status} ${res.statusText} on POST ${path9}: ${text}`,
+          `${res.status} ${res.statusText} on POST ${path10}: ${text}`,
           text
         );
       }
@@ -3175,12 +3223,12 @@ function projectPath(project, suffix) {
 }
 async function runRootCause(client, input) {
   const qs = input.errorId ? `?errorId=${encodeURIComponent(input.errorId)}` : "";
-  const path9 = projectPath(
+  const path10 = projectPath(
     input.project,
     `/graph/root-cause/${encodeURIComponent(input.errorNode)}${qs}`
   );
   try {
-    const result = await client.get(path9);
+    const result = await client.get(path10);
     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}.` : "");
@@ -3206,12 +3254,12 @@ async function runRootCause(client, input) {
 }
 async function runBlastRadius(client, input) {
   const qs = input.depth !== void 0 ? `?depth=${input.depth}` : "";
-  const path9 = projectPath(
+  const path10 = projectPath(
     input.project,
     `/graph/blast-radius/${encodeURIComponent(input.nodeId)}${qs}`
   );
   try {
-    const result = await client.get(path9);
+    const result = await client.get(path10);
     if (result.totalAffected === 0) {
       return {
         summary: `${result.origin} has no downstream dependencies. Nothing else would break if it failed.`
@@ -3245,12 +3293,12 @@ function formatBlastEntry(n) {
 }
 async function runDependencies(client, input) {
   const depth = input.depth ?? 3;
-  const path9 = projectPath(
+  const path10 = projectPath(
     input.project,
     `/graph/dependencies/${encodeURIComponent(input.nodeId)}?depth=${depth}`
   );
   try {
-    const result = await client.get(path9);
+    const result = await client.get(path10);
     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}).`
@@ -3331,9 +3379,9 @@ function formatDuration(ms) {
   return `${Math.round(h / 24)}d`;
 }
 async function runIncidents(client, input) {
-  const path9 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
+  const path10 = input.nodeId ? projectPath(input.project, `/incidents/${encodeURIComponent(input.nodeId)}`) : projectPath(input.project, "/incidents");
   try {
-    const body = await client.get(path9);
+    const body = await client.get(path10);
     const events = body.events;
     if (events.length === 0) {
       return {
@@ -3623,7 +3671,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}${path7.sep}`)) {
+    if (resolvedCwd === entry2.path || resolvedCwd.startsWith(`${entry2.path}${path8.sep}`)) {
       return entry2;
     }
   }
@@ -3774,8 +3822,24 @@ async function runSync(opts) {
 
 // src/cli.ts
 import { DivergenceTypeSchema } from "@neat.is/types";
+function isNpxInvocation() {
+  if (process.env.npm_command === "exec") return true;
+  const execpath = process.env.npm_execpath ?? "";
+  if (execpath.includes("npx")) return true;
+  const entry2 = process.argv[1] ?? "";
+  if (entry2.includes("/_npx/") || entry2.includes("\\_npx\\")) return true;
+  return false;
+}
+function commandPrefix() {
+  return isNpxInvocation() ? "npx neat.is" : "neat";
+}
 function usage() {
-  console.log("usage: neat <command> [args] [--project <name>]");
+  const neat = commandPrefix();
+  console.log("Installed via npx? Prefix commands with `npx neat.is`, or install once: `npm i -g neat.is`.");
+  console.log("");
+  console.log(`usage: ${neat} <command> [args] [--project <name>]`);
+  console.log("");
+  console.log(`Run \`${neat}\` with no command from inside your project to go zero-to-graph in one step.`);
   console.log("");
   console.log("lifecycle commands:");
   console.log("  init <path>    One-time install: discover, extract, register, plan SDK install.");
@@ -3815,30 +3879,30 @@ function usage() {
   console.log("");
   console.log("query commands (mirror the MCP tools, ADR-050):");
   console.log("  root-cause <node-id>             Walk inbound edges to find what broke first.");
-  console.log("                                   example: neat root-cause service:<name>");
+  console.log(`                                   example: ${neat} root-cause service:<name>`);
   console.log("  blast-radius <node-id>           BFS outbound \u2014 what would break if this dies.");
-  console.log("                                   example: neat blast-radius database:<host>");
+  console.log(`                                   example: ${neat} blast-radius database:<host>`);
   console.log("  dependencies <node-id>           Transitive outbound dependencies.");
   console.log("                                   Flags: --depth N (default 3, max 10)");
-  console.log("                                   example: neat dependencies service:<name> --depth 2");
+  console.log(`                                   example: ${neat} dependencies service:<name> --depth 2`);
   console.log("  observed-dependencies <node-id>  OBSERVED-only outbound edges (runtime traffic).");
-  console.log("                                   example: neat observed-dependencies service:<name>");
+  console.log(`                                   example: ${neat} observed-dependencies service:<name>`);
   console.log("  incidents [<node-id>]            Recent error events; per-node when an id is given.");
   console.log("                                   Flags: --limit N (default 20)");
-  console.log("                                   example: neat incidents service:<name> --limit 5");
+  console.log(`                                   example: ${neat} incidents service:<name> --limit 5`);
   console.log("  search <query>                   Semantic (or substring) match on node names/ids.");
-  console.log('                                   example: neat search "checkout"');
+  console.log(`                                   example: ${neat} search "checkout"`);
   console.log("  diff --against <snapshot>        Compare the live graph to a saved snapshot.");
-  console.log("                                   example: neat diff --against ./snapshots/baseline.json");
+  console.log(`                                   example: ${neat} diff --against ./snapshots/baseline.json`);
   console.log("  stale-edges                      Recent OBSERVED \u2192 STALE transitions.");
   console.log("                                   Flags: --limit N, --edge-type CALLS|CONNECTS_TO|...");
-  console.log("                                   example: neat stale-edges --edge-type CALLS");
+  console.log(`                                   example: ${neat} stale-edges --edge-type CALLS`);
   console.log("  policies                         Current policy violations.");
   console.log("                                   Flags: --node <id>, --hypothetical-action <json>");
-  console.log("                                   example: neat policies --node service:<name> --json");
+  console.log(`                                   example: ${neat} policies --node service:<name> --json`);
   console.log("  divergences                      Where code (EXTRACTED) and production (OBSERVED) disagree.");
   console.log("                                   Flags: --type <list>, --min-confidence <0..1>, --node <id>");
-  console.log("                                   example: neat divergences --min-confidence 0.7");
+  console.log(`                                   example: ${neat} divergences --min-confidence 0.7`);
   console.log("");
   console.log("flags:");
   console.log('  --project <name>   Name the project this command targets. Default: "default".');
@@ -3982,40 +4046,10 @@ function assignFlag(out, field, value) {
   ;
   out[field] = value;
 }
-function readPackageVersion() {
-  const here = typeof __dirname !== "undefined" ? __dirname : path8.dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    path8.resolve(here, "../package.json"),
-    path8.resolve(here, "../../package.json")
-  ];
-  for (const candidate of candidates) {
-    try {
-      const raw = readFileSync(candidate, "utf8");
-      const parsed = JSON.parse(raw);
-      if (parsed.name === "@neat.is/core" && typeof parsed.version === "string") {
-        return parsed.version;
-      }
-    } catch {
-    }
-  }
-  return "unknown";
-}
 function printVersion() {
   process.stdout.write(`${readPackageVersion()}
 `);
 }
-function printBanner() {
-  console.log("\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");
-  console.log("\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D");
-  console.log("\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ");
-  console.log("\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ");
-  console.log("\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ");
-  console.log("\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ");
-  console.log("");
-  console.log("  Network Expressive Architecting Tool");
-  console.log(`  neat.is  \xB7  v${readPackageVersion()}  \xB7  Apache 2.0`);
-  console.log("");
-}
 function printDiscoveryReport(opts, services) {
   const languages = [...new Set(services.map((s) => s.node.language))].sort();
   const mode = opts.dryRun ? "dry-run" : opts.apply ? "apply" : "patch-only";
@@ -4063,12 +4097,12 @@ async function runInit(opts) {
   printDiscoveryReport(opts, services);
   const sections = opts.noInstall ? [] : await buildPatchSections(services, opts.project);
   const patch = renderPatch(sections);
-  const patchPath = path8.join(opts.scanPath, "neat.patch");
+  const patchPath = path9.join(opts.scanPath, "neat.patch");
   if (opts.dryRun) {
     await fs7.writeFile(patchPath, patch, "utf8");
     written.push(patchPath);
     console.log(`dry-run: patch written to ${patchPath}`);
-    const gitignorePath = path8.join(opts.scanPath, ".gitignore");
+    const gitignorePath = path9.join(opts.scanPath, ".gitignore");
     const gitignoreExists = await fs7.stat(gitignorePath).then(() => true).catch(() => false);
     const verb = gitignoreExists ? "append" : "create";
     console.log(`dry-run: would ${verb} ${gitignorePath} (add neat-out/)`);
@@ -4080,9 +4114,9 @@ async function runInit(opts) {
   const graph = getGraph(graphKey);
   const projectPaths = pathsForProject(
     graphKey,
-    path8.join(opts.scanPath, "neat-out")
+    path9.join(opts.scanPath, "neat-out")
   );
-  const errorsPath = path8.join(path8.dirname(opts.outPath), path8.basename(projectPaths.errorsPath));
+  const errorsPath = path9.join(path9.dirname(opts.outPath), path9.basename(projectPaths.errorsPath));
   const result = await extractFromDirectory(graph, opts.scanPath, { errorsPath });
   await saveGraphToDisk(graph, opts.outPath);
   written.push(opts.outPath);
@@ -4201,9 +4235,9 @@ var CLAUDE_SKILL_CONFIG = {
 };
 function claudeConfigPath() {
   const override = process.env.NEAT_CLAUDE_CONFIG;
-  if (override && override.length > 0) return path8.resolve(override);
+  if (override && override.length > 0) return path9.resolve(override);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return path8.join(home, ".claude.json");
+  return path9.join(home, ".claude.json");
 }
 async function runSkill(opts) {
   const snippet = JSON.stringify(CLAUDE_SKILL_CONFIG, null, 2) + "\n";
@@ -4227,7 +4261,7 @@ async function runSkill(opts) {
       ...existing,
       mcpServers: { ...mcp, neat: CLAUDE_SKILL_CONFIG.mcpServers.neat }
     };
-    await fs7.mkdir(path8.dirname(target), { recursive: true });
+    await fs7.mkdir(path9.dirname(target), { recursive: true });
     await fs7.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.");
@@ -4243,16 +4277,24 @@ async function runSkill(opts) {
   return { exitCode: 0 };
 }
 async function main() {
-  const [, , cmd, ...rest] = process.argv;
-  if (!cmd || cmd === "-h" || cmd === "--help") {
+  const argv = process.argv.slice(2);
+  const cmd0 = argv[0];
+  if (cmd0 === "-h" || cmd0 === "--help") {
     usage();
     process.exit(0);
   }
-  if (cmd === "--version" || cmd === "-v" || cmd === "version") {
+  if (cmd0 === "--version" || cmd0 === "-v" || cmd0 === "version") {
     printVersion();
     process.exit(0);
   }
-  const parsed = parseArgs(rest);
+  const argvParsed = parseArgs(argv);
+  if (argvParsed.positional.length === 0) {
+    const orchestratorCode2 = await tryOrchestrator(process.cwd(), argvParsed);
+    if (orchestratorCode2 !== null && orchestratorCode2 !== 0) process.exit(orchestratorCode2);
+    return;
+  }
+  const cmd = argvParsed.positional[0];
+  const parsed = { ...argvParsed, positional: argvParsed.positional.slice(1) };
   const { positional, apply: apply3, dryRun, noInstall } = parsed;
   const project = parsed.project ?? DEFAULT_PROJECT;
   if (cmd === "init") {
@@ -4266,12 +4308,12 @@ async function main() {
       console.error("neat init: --apply and --dry-run are mutually exclusive");
       process.exit(2);
     }
-    const scanPath = path8.resolve(target);
+    const scanPath = path9.resolve(target);
     const projectExplicit = parsed.project !== null;
-    const projectName = projectExplicit ? project : path8.basename(scanPath);
+    const projectName = projectExplicit ? project : path9.basename(scanPath);
     const projectKey = projectExplicit ? project : DEFAULT_PROJECT;
-    const fallback = pathsForProject(projectKey, path8.join(scanPath, "neat-out")).snapshotPath;
-    const outPath = path8.resolve(process.env.NEAT_OUT_PATH ?? fallback);
+    const fallback = pathsForProject(projectKey, path9.join(scanPath, "neat-out")).snapshotPath;
+    const outPath = path9.resolve(process.env.NEAT_OUT_PATH ?? fallback);
     const result = await runInit({
       scanPath,
       outPath,
@@ -4292,21 +4334,21 @@ async function main() {
       usage();
       process.exit(2);
     }
-    const scanPath = path8.resolve(target);
+    const scanPath = path9.resolve(target);
     const stat = await fs7.stat(scanPath).catch(() => null);
     if (!stat || !stat.isDirectory()) {
       console.error(`neat watch: ${scanPath} is not a directory`);
       process.exit(2);
     }
-    const projectPaths = pathsForProject(project, path8.join(scanPath, "neat-out"));
-    const outPath = path8.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
-    const errorsPath = path8.resolve(
-      process.env.NEAT_ERRORS_PATH ?? path8.join(path8.dirname(outPath), path8.basename(projectPaths.errorsPath))
+    const projectPaths = pathsForProject(project, path9.join(scanPath, "neat-out"));
+    const outPath = path9.resolve(process.env.NEAT_OUT_PATH ?? projectPaths.snapshotPath);
+    const errorsPath = path9.resolve(
+      process.env.NEAT_ERRORS_PATH ?? path9.join(path9.dirname(outPath), path9.basename(projectPaths.errorsPath))
     );
-    const staleEventsPath = path8.resolve(
-      process.env.NEAT_STALE_EVENTS_PATH ?? path8.join(path8.dirname(outPath), path8.basename(projectPaths.staleEventsPath))
+    const staleEventsPath = path9.resolve(
+      process.env.NEAT_STALE_EVENTS_PATH ?? path9.join(path9.dirname(outPath), path9.basename(projectPaths.staleEventsPath))
     );
-    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? path8.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
+    const embeddingsCachePath = process.env.NEAT_EMBEDDINGS_CACHE_PATH ? path9.resolve(process.env.NEAT_EMBEDDINGS_CACHE_PATH) : void 0;
     const handle = await startWatch(getGraph(project), {
       scanPath,
       outPath,
@@ -4452,11 +4494,11 @@ async function main() {
   process.exit(1);
 }
 async function tryOrchestrator(cmd, parsed) {
-  const scanPath = path8.resolve(cmd);
+  const scanPath = path9.resolve(cmd);
   const stat = await fs7.stat(scanPath).catch(() => null);
   if (!stat || !stat.isDirectory()) return null;
   const projectExplicit = parsed.project !== null;
-  const projectName = projectExplicit ? parsed.project : path8.basename(scanPath);
+  const projectName = projectExplicit ? parsed.project : path9.basename(scanPath);
   const result = await runOrchestrator({
     scanPath,
     project: projectName,
@@ -4656,11 +4698,15 @@ if (/[\\/]cli\.(?:cjs|js)$/.test(entry) || entry.endsWith("/cli") || entry.endsW
 export {
   CLAUDE_SKILL_CONFIG,
   QUERY_VERBS,
+  commandPrefix,
+  isNpxInvocation,
+  main,
   parseArgs,
   printBanner,
   readPackageVersion,
   runInit,
   runQueryVerb,
-  runSkill
+  runSkill,
+  usage
 };
 //# sourceMappingURL=cli.js.map