@xano/sdk 1.0.4 → 1.0.5

package/dist/{local-engine-command-HMTQK7MN.js → local-engine-command-73NHWD6V.js}

@@ -1,17 +1,17 @@
 import {
   pinWrittenText
-} from "./chunk-L2GLOJAO.js";
+} from "./chunk-ZHGWR45B.js";
 import {
   acquireEngine,
   restartMismatchedEngine
-} from "./chunk-HHW5AWVD.js";
+} from "./chunk-YI76TURL.js";
 import {
   confirm
-} from "./chunk-4APOHK7Y.js";
+} from "./chunk-AESE434J.js";
 import {
   resolveProjectEntry
-} from "./chunk-VRVKNY4A.js";
-import "./chunk-QV3GXQRE.js";
+} from "./chunk-PIPIA7K7.js";
+import "./chunk-XIABDKFQ.js";
 import "./chunk-3DRXWLJ5.js";
 import "./chunk-X4DVXBFY.js";
 import {
@@ -23,7 +23,7 @@ import {
   stopAllEngines,
   stopEngineNamed,
   stopOrphanedEngineProcesses
-} from "./chunk-O7QOWS6M.js";
+} from "./chunk-RXCT3OCU.js";
 import {
   diskBytes,
   listLegacyCacheDirs,
@@ -32,72 +32,72 @@ import {
   readEngineEntry,
   readPin,
   writePin
-} from "./chunk-D64XUF5Q.js";
-import "./chunk-NA3PXMEF.js";
+} from "./chunk-Z3SNX45M.js";
+import "./chunk-64WWE3EF.js";
 import {
   ENGINE_RELEASES_URL_ENV,
   normalizeEngineVersion,
   resolveEngineRelease,
   usesCustomReleaseManager
-} from "./chunk-CYB7UQA2.js";
+} from "./chunk-JQOX6HW4.js";
 import "./chunk-2TFRR6JV.js";
-import "./chunk-HSEQYBDO.js";
+import "./chunk-HOOOOJJP.js";
 import {
   NO_CREDENTIAL,
   SourceError,
   resolveSource
-} from "./chunk-2AUV6NXK.js";
-import "./chunk-A6QTTJUI.js";
-import "./chunk-MEE5RZ6G.js";
-import "./chunk-3P3HXN76.js";
-import "./chunk-W5ONYLOP.js";
-import "./chunk-KCAL4QYP.js";
+} from "./chunk-JXKO6JT7.js";
+import "./chunk-3BJYQGAZ.js";
+import "./chunk-5XVBT6CQ.js";
+import "./chunk-V4IBHDIY.js";
+import "./chunk-KQLACS4Q.js";
+import "./chunk-4GDEEY2U.js";
 import "./chunk-2MNLRIOX.js";
 import {
   clearEngineRecordsNamed,
   clearEngineRecordsStillMatching,
   listEngineRecords
-} from "./chunk-WL2DSNJV.js";
+} from "./chunk-Q22BMRPF.js";
 import {
   SUPPORTED_PLATFORMS,
   engineRunHome,
   legacyRuntimeDirs,
   localEngineBinDir,
   resolveEnginePlatform
-} from "./chunk-AM4FKL4J.js";
-import "./chunk-UKUIUS3E.js";
+} from "./chunk-PL7AIAWS.js";
+import "./chunk-4QBGE3EO.js";
 import "./chunk-ZYJP6BOO.js";
 import "./chunk-QO6BVGS5.js";
-import "./chunk-3H3EPMFY.js";
-import "./chunk-BUECLQXK.js";
-import "./chunk-CFSFBKHP.js";
+import "./chunk-UJ6ZZJDD.js";
+import "./chunk-QZTJ2556.js";
+import "./chunk-TEBS7FE6.js";
 import {
   yesRerun
-} from "./chunk-FMOEVAGT.js";
+} from "./chunk-Z4VN347O.js";
 import "./chunk-622HUCZT.js";
-import "./chunk-SEUCZZCP.js";
-import "./chunk-E6H5ZEV3.js";
-import "./chunk-HUSH7LRI.js";
-import "./chunk-ZG7E72VI.js";
-import "./chunk-S7E2AHV3.js";
+import "./chunk-G57RYMKB.js";
+import "./chunk-AGD7F7YI.js";
+import "./chunk-F6IKWAIU.js";
+import "./chunk-OGUMHW2X.js";
+import "./chunk-3VX7VAQT.js";
 import "./chunk-ZFDZKNGG.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-3FN2BIGB.js";
-import "./chunk-JTUKLCXS.js";
+import "./chunk-MYLPOVX6.js";
+import "./chunk-DXUICABI.js";
 import "./chunk-4KHEMC32.js";
 import "./chunk-ROY4YAEQ.js";
-import "./chunk-RX3EMQGN.js";
+import "./chunk-5YBNXNKU.js";
 import "./chunk-WRBKLYSJ.js";
-import "./chunk-DYG5D3FD.js";
-import "./chunk-I2BGYNHD.js";
+import "./chunk-M7GJ6YUF.js";
+import "./chunk-OJPZEUPH.js";
 import "./chunk-AWQ7BQTQ.js";
 import "./chunk-EUUUMY7J.js";
-import "./chunk-MN2PB6WB.js";
-import "./chunk-FPBGAT5D.js";
+import "./chunk-HLQH3AXB.js";
+import "./chunk-JZWUAEMO.js";
 import "./chunk-LLNZGEFK.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-UCQ2VUTG.js";
+import "./chunk-M6ZFSTIZ.js";
 import "./chunk-DGWHAVRG.js";
 import {
   UsageError,
@@ -111,8 +111,8 @@ import {
   unknownSubcommand,
   warn,
   writeJson
-} from "./chunk-SBR2WZXG.js";
-import "./chunk-EESV6NU2.js";
+} from "./chunk-XNZURZ7T.js";
+import "./chunk-XJU6UAFV.js";
 import "./chunk-H2V3N23D.js";
 import "./chunk-3JDU4VRL.js";
 import "./chunk-GPI3OWRE.js";
@@ -120,9 +120,9 @@ import {
   suggest,
   suggestAll
 } from "./chunk-UTI5G6OJ.js";
-import "./chunk-OOGXZL7Z.js";
+import "./chunk-OKNE3TWU.js";
 import "./chunk-5ZSO4T2G.js";
-import "./chunk-XNCP4KYO.js";
+import "./chunk-VQPDATQT.js";
 import "./chunk-TFFGOFVZ.js";
 import "./chunk-LL6ED5IB.js";
 import "./chunk-4BW2SG2N.js";
@@ -147,7 +147,7 @@ async function runLocalEngineCommand(args, opts = {}) {
     case "cache":
       return runCache(args, opts);
     default:
-      throw unknownSubcommand("local-engine", args.subcommand, args.positionals);
+      throw unknownSubcommand("local", args.subcommand, args.positionals);
   }
 }
 function cachedEngine(env, exclude = /* @__PURE__ */ new Set()) {
@@ -185,7 +185,7 @@ function startedFrom(record) {
 function report(rows, args, orphans = []) {
   if (orphans.length > 0) {
     info(
-      `${orphans.length === 1 ? "A process" : `${orphans.length} processes`} a crashed local engine left running (pid ${orphans.join(", ")}) \u2014 \`xanosdk local-engine stop --all\` stops ${orphans.length === 1 ? "it" : "them"}.`
+      `${orphans.length === 1 ? "A process" : `${orphans.length} processes`} a crashed Xano Engine left running (pid ${orphans.join(", ")}) \u2014 \`xanosdk local stop --all\` stops ${orphans.length === 1 ? "it" : "them"}.`
     );
   }
   if (isMachineOutput(args)) {
@@ -195,7 +195,7 @@ function report(rows, args, orphans = []) {
   }
   const s = stdoutStyle();
   if (rows.length === 0) {
-    process.stdout.write("No local engine is running\n");
+    process.stdout.write("No Xano Engine is running\n");
     return;
   }
   const lines = rows.map((row) => {
@@ -212,9 +212,9 @@ function reportMismatches(rows) {
     const running = from.startsWith("engine ") ? from : `engine ${from}`;
     warn(
       `${row.name} is running ${running}, but the engine cached here is ${cached}.`,
-      "local-engine.stale",
+      "local.stale",
       [
-        `Deploy its project again with \`xanosdk deploy --local-engine\` to restart it on that project's pinned engine, or stop it with \`xanosdk local-engine stop ${row.name}\`.`
+        `Deploy its project again with \`xanosdk deploy --local\` to restart it on that project's pinned engine, or stop it with \`xanosdk local stop ${row.name}\`.`
       ]
     );
   }
@@ -224,22 +224,22 @@ async function runStop(args, opts) {
   const name = args.positionals[0];
   if (args.all && name !== void 0 && name !== "") {
     throw new UsageError(
-      `\`xanosdk local-engine stop\` takes a name or \`--all\`, not both \u2014 \`--all\` already covers "${name}". Drop one of them.`,
-      { hintFor: { command: "local-engine", subcommand: "stop" } }
+      `\`xanosdk local stop\` takes a name or \`--all\`, not both \u2014 \`--all\` already covers "${name}". Drop one of them.`,
+      { hintFor: { command: "local", subcommand: "stop" } }
     );
   }
   if (args.all) return runStopAll(args, opts, env);
   if (name === void 0 || name === "") {
     throw new UsageError(
-      `\`xanosdk local-engine stop\` needs the name of an engine, or \`--all\` for every engine xanosdk started on this machine, across projects. Run \`xanosdk local-engine list\` to see them.`,
-      { hintFor: { command: "local-engine", subcommand: "stop" } }
+      `\`xanosdk local stop\` needs the name of an engine, or \`--all\` for every engine xanosdk started on this machine, across projects. Run \`xanosdk local list\` to see them.`,
+      { hintFor: { command: "local", subcommand: "stop" } }
     );
   }
   const assignment = /^([A-Za-z_][A-Za-z0-9_]*)=/.exec(name);
   if (assignment !== null) {
     throw new UsageError(
-      `"${assignment[1]}=\u2026" is not a local engine name. Run \`xanosdk local-engine list\` to see what is running.`,
-      { hintFor: { command: "local-engine", subcommand: "stop" } }
+      `"${assignment[1]}=\u2026" is not a Xano Engine name. Run \`xanosdk local list\` to see what is running.`,
+      { hintFor: { command: "local", subcommand: "stop" } }
     );
   }
   return runStopNamed(name, args, opts, env);
@@ -250,8 +250,8 @@ async function runStopNamed(name, args, opts, env) {
   if (!outcome.stopped) {
     info(`"${name}" is not running \u2014 nothing to stop${clearedSuffix(outcome)}.`);
     const nearest = entry === void 0 ? void 0 : nearestRunning(name, entry, env, opts);
-    if (nearest !== void 0) detail(`Did you mean \`${nearest}\`? It is running: \`xanosdk local-engine stop ${nearest}\`.`);
-    else detail("Run `xanosdk local-engine list` to see what is running.");
+    if (nearest !== void 0) detail(`Did you mean \`${nearest}\`? It is running: \`xanosdk local stop ${nearest}\`.`);
+    else detail("Run `xanosdk local list` to see what is running.");
     if (isMachineOutput(args)) writeJson({ ...outcome, alreadyStopped: true, ...nearest === void 0 ? {} : { suggestion: nearest } });
     return;
   }
@@ -287,25 +287,25 @@ function reportOrphanSweep(orphans) {
   const n = orphans.stopped.length;
   if (n > 0) {
     success(
-      `Stopped ${n} process${n === 1 ? "" : "es"} a crashed local engine left running (pid ${orphans.stopped.join(", ")}).`
+      `Stopped ${n} process${n === 1 ? "" : "es"} a crashed Xano Engine left running (pid ${orphans.stopped.join(", ")}).`
     );
   }
   if (orphans.stillRunning.length > 0) {
     detail(
-      `Still exiting after the wait: pid ${orphans.stillRunning.join(", ")} \u2014 run \`xanosdk local-engine stop --all\` again in a moment.`
+      `Still exiting after the wait: pid ${orphans.stillRunning.join(", ")} \u2014 run \`xanosdk local stop --all\` again in a moment.`
     );
   }
 }
 function reportStopAll(outcome, staleProjects, args) {
   for (const stop of outcome.stopped) {
     if (stop.stopped) success(`Stopped ${stop.name}${clearedSuffix(stop)}`);
-    else warn(`${stop.name} was listed as running but did not stop${clearedSuffix(stop)}.`, "local-engine.stop-failed");
+    else warn(`${stop.name} was listed as running but did not stop${clearedSuffix(stop)}.`, "local.stop-failed");
   }
   if (outcome.foreign.length > 0) {
     warn(
       `Left running, not started by xanosdk: ${outcome.foreign.join(", ")}`,
-      "local-engine.foreign",
-      ["Name one explicitly \u2014 `xanosdk local-engine stop <name>` \u2014 to stop it anyway."]
+      "local.foreign",
+      ["Name one explicitly \u2014 `xanosdk local stop <name>` \u2014 to stop it anyway."]
     );
   }
   reportOrphanSweep(outcome.orphans);
@@ -314,7 +314,7 @@ function reportStopAll(outcome, staleProjects, args) {
   }
   const swept = outcome.orphans.stopped.length + outcome.orphans.stillRunning.length;
   if (outcome.stopped.length === 0 && outcome.foreign.length === 0 && swept === 0) {
-    info("No local engine is running \u2014 nothing to stop.");
+    info("No Xano Engine is running \u2014 nothing to stop.");
   }
   if (isMachineOutput(args)) {
     writeJson({ ...outcome, staleProjects, alreadyStopped: outcome.stopped.length === 0 && swept === 0 });
@@ -342,20 +342,20 @@ async function resolveLiveEngine(named, opts, doing) {
   if (entry === void 0) {
     throw new SourceError(
       `No engine is cached on this machine, so there is nothing here to ${doing}.
-Run \`xanosdk deploy --local-engine\` to fetch one if you meant to use a local engine.`,
+Run \`xanosdk deploy --local\` to fetch one if you meant to use a Xano Engine.`,
       "gone",
-      "local-engine"
+      "local"
     );
   }
   const resolved = await resolveSource(
-    named === void 0 || named === "" ? { kind: "local-engine" } : { kind: "local-engine", name: named },
+    named === void 0 || named === "" ? { kind: "local" } : { kind: "local", name: named },
     NO_CREDENTIAL,
     // A lifecycle verb manages the engine itself; "deploy still reaches an
     // ephemeral" answers a question nobody running it asked.
     // The name is this verb's bare positional, so a near one is suggested bare.
     { env, listEngines: () => listEngines({ entry, env, run: opts.run }), deployFallback: false, bareName: true }
   );
-  if (resolved.backend.kind !== "local") throw new Error("Internal: a local engine resolved to a hosted backend.");
+  if (resolved.backend.kind !== "local") throw new Error("Internal: a Xano Engine resolved to a hosted backend.");
   return resolved.backend.engine;
 }
 async function runUpdate(args, opts) {
@@ -367,7 +367,7 @@ async function runUpdate(args, opts) {
 Unset it to move the pin, or keep deploying with it set to run that manager's latest.`
     );
   }
-  const read = readPin(dir, { warn: (message) => warn(message, "local-engine.pin-unusable") });
+  const read = readPin(dir, { warn: (message) => warn(message, "local.pin-unusable") });
   if (read === void 0 && resolveProjectEntry(dir) === void 0) {
     throw new Error(
       `No package.json in ${dir}, and it is not a Xano SDK project, so there is no engine pin to move.
@@ -400,19 +400,19 @@ Run this from the project's root.`
     ...opts.spawn === void 0 ? {} : { spawn: opts.spawn }
   });
   const devEnv = replaced === void 0 ? void 0 : await repointDevEnvAfterRestart(dir, replaced);
-  success(`Local engine ${current ?? "(unpinned)"} \u2192 ${target}`);
+  success(`Xano Engine ${current ?? "(unpinned)"} \u2192 ${target}`);
   info(pinWrittenText({ path: pin.path, version: target, created: pin.created, moved: current !== null }));
   if (replaced !== void 0) {
     info(`Restarted ${replaced.name} on ${target}. It starts empty \u2014 run your deploy to seed it.`);
     if (replaced.url !== replaced.previousUrl) {
-      info("New local engine URL:");
+      info("New Xano Engine URL:");
       link(replaced.url);
     }
     if (devEnv !== void 0) {
       detail(`Pointed ${devEnv.label} at the restarted engine (${devEnv.variable}) \u2014 restart your dev server to pick it up.`);
     }
   } else {
-    detail(`No engine is running for this project; the next \`xanosdk deploy --local-engine\` starts ${target}.`);
+    detail(`No engine is running for this project; the next \`xanosdk deploy --local\` starts ${target}.`);
   }
   if (isMachineOutput(args)) {
     writeJson({
@@ -427,7 +427,7 @@ Run this from the project's root.`
 }
 async function repointDevEnvAfterRestart(dir, restarted) {
   if (restarted.previousUrl === void 0) return void 0;
-  const { repointDevEnv } = await import("./dev-env-sync-X636HLMK.js");
+  const { repointDevEnv } = await import("./dev-env-sync-GZ4QQJGV.js");
   try {
     return repointDevEnv(dir, restarted.previousUrl, restarted.url);
   } catch (err) {
@@ -443,14 +443,14 @@ async function requestedEngineVersion(requested, opts, env, purpose) {
       const clearing = purpose === "clear";
       throw new UsageError(
         (err instanceof Error ? err.message : String(err)) + (clearing ? " `cache clear` also takes `override`, or an override's `src-\u2026` id from `cache list`." : ""),
-        { hintFor: { command: "local-engine", subcommand: clearing ? "cache" : "update" } }
+        { hintFor: { command: "local", subcommand: clearing ? "cache" : "update" } }
       );
     }
   }
   const platform = resolveEnginePlatform(opts.platform ?? process.platform, opts.arch ?? process.arch);
   if (platform === void 0) {
     throw new Error(
-      `There is no local engine build for ${opts.platform ?? process.platform} ${opts.arch ?? process.arch} \u2014 it runs on ${SUPPORTED_PLATFORMS.join(", ")} and nothing else, so there is no engine to ${purpose}. \`xanosdk deploy\` reaches an ephemeral from anywhere.`
+      `There is no Xano Engine build for ${opts.platform ?? process.platform} ${opts.arch ?? process.arch} \u2014 it runs on ${SUPPORTED_PLATFORMS.join(", ")} and nothing else, so there is no engine to ${purpose}. \`xanosdk deploy --ephemeral\` reaches an ephemeral from anywhere.`
     );
   }
   const fetch = opts.fetch === void 0 ? {} : { fetch: opts.fetch };
@@ -462,23 +462,23 @@ async function runCache(args, opts) {
   if (action === "list") {
     if (args.engineVersion !== void 0) {
       throw new UsageError(
-        "`xanosdk local-engine cache list` takes no `--version` \u2014 it lists every cached engine. `cache clear --version <v>` is the one that takes it.",
-        { helpFor: { command: "local-engine", subcommand: "cache" } }
+        "`xanosdk local cache list` takes no `--version` \u2014 it lists every cached engine. `cache clear --version <v>` is the one that takes it.",
+        { helpFor: { command: "local", subcommand: "cache" } }
       );
     }
     if (args.legacyRuntime) {
       throw new UsageError(
-        "`xanosdk local-engine cache list` takes no `--legacy-runtime` \u2014 it lists the earlier runtime copy when there is one. `cache clear --legacy-runtime` is the one that takes it.",
-        { helpFor: { command: "local-engine", subcommand: "cache" } }
+        "`xanosdk local cache list` takes no `--legacy-runtime` \u2014 it lists the earlier runtime copy when there is one. `cache clear --legacy-runtime` is the one that takes it.",
+        { helpFor: { command: "local", subcommand: "cache" } }
       );
     }
     return runCacheList(args, opts);
   }
   if (action === "clear") return runCacheClear(args, opts);
   throw new UsageError(
-    `\`xanosdk local-engine cache\`: ${action === void 0 || action === "" ? "no action given" : `unknown action "${action}"`} \u2014 it takes ${CACHE_ACTIONS.join(" or ")}.`,
+    `\`xanosdk local cache\`: ${action === void 0 || action === "" ? "no action given" : `unknown action "${action}"`} \u2014 it takes ${CACHE_ACTIONS.join(" or ")}.`,
     {
-      helpFor: { command: "local-engine", subcommand: "cache" },
+      helpFor: { command: "local", subcommand: "cache" },
       suggestion: action === void 0 ? void 0 : suggest(action, CACHE_ACTIONS)
     }
   );
@@ -506,7 +506,7 @@ async function runCacheList(args, opts) {
   const runtime = runtimeRows(env);
   if (entries.length === 0 && legacy.length === 0 && runtime.length === 0) {
     if (isMachineOutput(args)) writeJson({ entries: [] });
-    else info("No local engine is cached \u2014 `xanosdk deploy --local-engine` fetches one.");
+    else info("No Xano Engine is cached \u2014 `xanosdk deploy --local` fetches one.");
     return;
   }
   let running = [];
@@ -515,7 +515,7 @@ async function runCacheList(args, opts) {
     try {
       running = listEngines({ entry: binary, env, ...opts.run === void 0 ? {} : { run: opts.run } });
     } catch (err) {
-      warn(`Could not list running engines, so none are shown: ${err.message.split("\n")[0]}`, "local-engine.list-failed");
+      warn(`Could not list running engines, so none are shown: ${err.message.split("\n")[0]}`, "local.list-failed");
     }
   }
   const using = enginesByDigest(running, env);
@@ -558,14 +558,14 @@ async function runCacheList(args, opts) {
   });
   printHuman(lines.join("\n") + "\n");
   if (legacy.length > 0) {
-    detail("Old-layout directories are never run \u2014 `xanosdk local-engine cache clear` removes them.");
+    detail("Old-layout directories are never run \u2014 `xanosdk local cache clear` removes them.");
   }
   if (runtime.some((r) => r.source === "runtime")) {
-    detail("The unpacked runtime is what the engines run from \u2014 `xanosdk local-engine cache clear` removes it with the engines.");
+    detail("The unpacked runtime is what the engines run from \u2014 `xanosdk local cache clear` removes it with the engines.");
   }
   if (runtime.some((r) => r.source === "legacy-runtime")) {
     detail(
-      "An earlier runtime copy was left in your own cache directory by an earlier version, and nothing runs from it \u2014 `xanosdk local-engine cache clear --legacy-runtime` removes it."
+      "An earlier runtime copy was left in your own cache directory by an earlier version, and nothing runs from it \u2014 `xanosdk local cache clear --legacy-runtime` removes it."
     );
   }
 }
@@ -594,7 +594,7 @@ async function runCacheClear(args, opts) {
     if (hits.length === 0) {
       const cached = cachedEntries(env).map(entryLabel);
       const near = requested === "override" ? [] : suggestAll(label ?? requested ?? "", cached.filter((c) => !c.startsWith("override")));
-      const clear = (v) => `\`xanosdk local-engine cache clear --version ${v}\``;
+      const clear = (v) => `\`xanosdk local cache clear --version ${v}\``;
       info(
         `${requested === "override" ? "No override engine is cached" : `${label} is not cached`} \u2014 nothing to clear. ` + (cached.length === 0 ? "No engine is cached." : `Cached: ${cached.join(", ")}.`) + (near.length === 0 ? "" : ` Did you mean ${near.join(" or ")}? ${near.map(clear).join(" or ")}.`)
       );
@@ -647,7 +647,7 @@ async function runCacheClear(args, opts) {
   const bytesFreed = items.reduce((sum, item) => sum + item.bytes, 0);
   for (const stop of stopped) {
     if (stop.stopped) success(`Stopped ${stop.name} \u2014 it ran on an engine being removed`);
-    else warn(`${stop.name} was listed as running but did not stop. Stop it with \`xanosdk local-engine stop ${stop.name}\`.`, "local-engine.stop-failed");
+    else warn(`${stop.name} was listed as running but did not stop. Stop it with \`xanosdk local stop ${stop.name}\`.`, "local.stop-failed");
   }
   const what = [
     ...removed.length === 0 ? [] : [label ?? `${removed.length} cached engine director${removed.length === 1 ? "y" : "ies"}`],
@@ -664,12 +664,12 @@ async function runCacheClear(args, opts) {
   }
   if (runtimeBytes > 0 && !runtimeRemoved) {
     warn(
-      `Kept the unpacked runtime (${formatBytes(runtimeBytes)}): ${stillRunning.join(", ")} ${stillRunning.length === 1 ? "is" : "are"} still running on it. Stop every engine (\`xanosdk local-engine stop --all\`), then run \`xanosdk local-engine cache clear\` again.`,
-      "local-engine.runtime-kept"
+      `Kept the unpacked runtime (${formatBytes(runtimeBytes)}): ${stillRunning.join(", ")} ${stillRunning.length === 1 ? "is" : "are"} still running on it. Stop every engine (\`xanosdk local stop --all\`), then run \`xanosdk local cache clear\` again.`,
+      "local.runtime-kept"
     );
   }
   if (stopped.length > 0) {
-    detail("The next `xanosdk deploy --local-engine` fetches its engine again and restarts it.");
+    detail("The next `xanosdk deploy --local` fetches its engine again and restarts it.");
   }
   if (isMachineOutput(args)) {
     writeJson({ stopped: stopped.map((o) => o.name), removed, runtimeRemoved, items, bytesFreed, alreadyGone: false });
@@ -687,7 +687,7 @@ function enginesStillRunning(env, run) {
 async function clearLegacyRuntime(args, env) {
   if (args.engineVersion !== void 0) {
     throw new UsageError("`--legacy-runtime` clears the earlier runtime copy, not a cached version \u2014 drop `--version`.", {
-      hintFor: { command: "local-engine", subcommand: "cache" }
+      hintFor: { command: "local", subcommand: "cache" }
     });
   }
   const dirs = legacyRuntimeDirs(env);
@@ -700,7 +700,7 @@ async function clearLegacyRuntime(args, env) {
   if (!args.yes) {
     const ok = await confirm(`Delete ${dirs.join(", ")} (${formatBytes(bytes)}), the runtime copy an earlier version left?`, {
       flag: "--yes",
-      refusal: { details: { removed: [], bytesFreed: 0 }, ...yesRerun(args, "local-engine cache clear --legacy-runtime") }
+      refusal: { details: { removed: [], bytesFreed: 0 }, ...yesRerun(args, "local cache clear --legacy-runtime") }
     });
     if (!ok) {
       info("Nothing was deleted.");
@@ -724,8 +724,8 @@ function stopEnginesOn(doomed, everything, env, run) {
   } catch (err) {
     warn(
       `Could not list running engines, so none were stopped: ${err.message.split("\n")[0]}
-  Any engine still running on a removed version keeps running \u2014 stop it with \`xanosdk local-engine stop <name>\`.`,
-      "local-engine.list-failed"
+  Any engine still running on a removed version keeps running \u2014 stop it with \`xanosdk local stop <name>\`.`,
+      "local.list-failed"
     );
     return [];
   }
@@ -758,4 +758,4 @@ export {
   runLocalEngineCommand,
   sweepOptions
 };
-//# sourceMappingURL=local-engine-command-HMTQK7MN.js.map
+//# sourceMappingURL=local-engine-command-73NHWD6V.js.map

package/dist/{local-engine-config-5U3SC434.js → local-engine-config-W3KB7RWM.js}

@@ -15,7 +15,7 @@ import {
   localEngineHome,
   resolveEnginePlatform,
   resolveEngineSource
-} from "./chunk-AM4FKL4J.js";
+} from "./chunk-PL7AIAWS.js";
 import "./chunk-X2NL4KUO.js";
 import "./chunk-PZ5AY32C.js";
 export {
@@ -36,4 +36,4 @@ export {
   resolveEnginePlatform,
   resolveEngineSource
 };
-//# sourceMappingURL=local-engine-config-5U3SC434.js.map
+//# sourceMappingURL=local-engine-config-W3KB7RWM.js.map

package/dist/{local-engine-deploy-TXAOYRGF.js → local-engine-deploy-Y4OAWL7K.js}

@@ -3,28 +3,28 @@ import {
   ensureProjectEngine,
   explainUnsupportedEngineImport,
   restartMismatchedEngine
-} from "./chunk-HHW5AWVD.js";
-import "./chunk-O7QOWS6M.js";
-import "./chunk-D64XUF5Q.js";
-import "./chunk-NA3PXMEF.js";
-import "./chunk-CYB7UQA2.js";
+} from "./chunk-YI76TURL.js";
+import "./chunk-RXCT3OCU.js";
+import "./chunk-Z3SNX45M.js";
+import "./chunk-64WWE3EF.js";
+import "./chunk-JQOX6HW4.js";
 import "./chunk-2TFRR6JV.js";
-import "./chunk-HSEQYBDO.js";
-import "./chunk-MEE5RZ6G.js";
-import "./chunk-WL2DSNJV.js";
-import "./chunk-AM4FKL4J.js";
+import "./chunk-HOOOOJJP.js";
+import "./chunk-5XVBT6CQ.js";
+import "./chunk-Q22BMRPF.js";
+import "./chunk-PL7AIAWS.js";
 import "./chunk-ZYJP6BOO.js";
 import "./chunk-QO6BVGS5.js";
-import "./chunk-JTUKLCXS.js";
-import "./chunk-I2BGYNHD.js";
+import "./chunk-DXUICABI.js";
+import "./chunk-OJPZEUPH.js";
 import "./chunk-AWQ7BQTQ.js";
 import "./chunk-EUUUMY7J.js";
-import "./chunk-MN2PB6WB.js";
-import "./chunk-FPBGAT5D.js";
+import "./chunk-HLQH3AXB.js";
+import "./chunk-JZWUAEMO.js";
 import "./chunk-LLNZGEFK.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-SBR2WZXG.js";
+import "./chunk-XNZURZ7T.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -37,4 +37,4 @@ export {
   explainUnsupportedEngineImport,
   restartMismatchedEngine
 };
-//# sourceMappingURL=local-engine-deploy-TXAOYRGF.js.map
+//# sourceMappingURL=local-engine-deploy-Y4OAWL7K.js.map

package/dist/{local-engine-process-6VZ7JJBP.js → local-engine-process-6YPJHKYM.js}

@@ -19,20 +19,20 @@ import {
   stopAllEngines,
   stopEngineNamed,
   stopOrphanedEngineProcesses
-} from "./chunk-O7QOWS6M.js";
-import "./chunk-D64XUF5Q.js";
-import "./chunk-NA3PXMEF.js";
-import "./chunk-CYB7UQA2.js";
-import "./chunk-WL2DSNJV.js";
-import "./chunk-AM4FKL4J.js";
+} from "./chunk-RXCT3OCU.js";
+import "./chunk-Z3SNX45M.js";
+import "./chunk-64WWE3EF.js";
+import "./chunk-JQOX6HW4.js";
+import "./chunk-Q22BMRPF.js";
+import "./chunk-PL7AIAWS.js";
 import "./chunk-ZYJP6BOO.js";
 import "./chunk-QO6BVGS5.js";
-import "./chunk-JTUKLCXS.js";
-import "./chunk-MN2PB6WB.js";
+import "./chunk-DXUICABI.js";
+import "./chunk-HLQH3AXB.js";
 import "./chunk-LLNZGEFK.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-SBR2WZXG.js";
+import "./chunk-XNZURZ7T.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -61,4 +61,4 @@ export {
   stopEngineNamed,
   stopOrphanedEngineProcesses
 };
-//# sourceMappingURL=local-engine-process-6VZ7JJBP.js.map
+//# sourceMappingURL=local-engine-process-6YPJHKYM.js.map

package/dist/{local-engine-state-TJWPWCC4.js → local-engine-state-OCW5YDD7.js}

@@ -11,8 +11,8 @@ import {
   projectKey,
   readLocalEngineState,
   setEngineRecord
-} from "./chunk-WL2DSNJV.js";
-import "./chunk-AM4FKL4J.js";
+} from "./chunk-Q22BMRPF.js";
+import "./chunk-PL7AIAWS.js";
 import "./chunk-ZYJP6BOO.js";
 import "./chunk-QO6BVGS5.js";
 import "./chunk-LLNZGEFK.js";
@@ -32,4 +32,4 @@ export {
   readLocalEngineState,
   setEngineRecord
 };
-//# sourceMappingURL=local-engine-state-TJWPWCC4.js.map
+//# sourceMappingURL=local-engine-state-OCW5YDD7.js.map

package/dist/{local-engine-update-check-R5SPDVEJ.js → local-engine-update-check-X7TZGRFL.js}

@@ -1,23 +1,23 @@
 import {
   normalizeEngineVersion,
   resolveEngineRelease
-} from "./chunk-CYB7UQA2.js";
+} from "./chunk-JQOX6HW4.js";
 import {
   compareSemver,
   parseSemver
 } from "./chunk-2TFRR6JV.js";
 import {
   localEngineHome
-} from "./chunk-AM4FKL4J.js";
-import "./chunk-MN2PB6WB.js";
+} from "./chunk-PL7AIAWS.js";
+import "./chunk-HLQH3AXB.js";
 import {
   atomicWrite
 } from "./chunk-LLNZGEFK.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-MF4W6FHU.js";
 import {
   envFlagSet
 } from "./chunk-X2NL4KUO.js";
-import "./chunk-SBR2WZXG.js";
+import "./chunk-XNZURZ7T.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -145,7 +145,7 @@ function updatePromptText(pin, latest) {
   return `Engine ${withV(latest)} is available (this project is pinned to ${withV(pin)}). Update now? The engine restarts empty, so local rows are dropped and re-seeded, even with --keep-data.`;
 }
 function updateNoticeText(pin, latest) {
-  return `Engine ${withV(latest)} is available (pinned: ${withV(pin)}). Run \`xanosdk local-engine update\` to move to it.`;
+  return `Engine ${withV(latest)} is available (pinned: ${withV(pin)}). Run \`xanosdk local update\` to move to it.`;
 }
 export {
   UPDATE_CHECK_FAILURE_BACKOFF_MS,
@@ -159,4 +159,4 @@ export {
   updateNoticeText,
   updatePromptText
 };
-//# sourceMappingURL=local-engine-update-check-R5SPDVEJ.js.map
+//# sourceMappingURL=local-engine-update-check-X7TZGRFL.js.map