@xanots/sdk 0.0.9 → 0.0.10

package/dist/cli.d.ts

@@ -27,7 +27,7 @@ interface NonPublicSeedValue {
 interface ParsedArgs {
     command: string | undefined;
     /**
-     * The verb of a noun-verb command (`sandbox deploy`, `profile me`): here
+     * The verb of a noun-verb command (`workspace export`, `profile me`): here
      * `command` is the noun and `subcommand` is the verb.
      * Undefined for the single-token verbs (`compile`/`export`/`lock`/…).
      */
@@ -73,14 +73,17 @@ interface ParsedArgs {
     /** `--reset`: accepted but redundant — every deploy is a full replace now. */
     reset: boolean;
     /**
-     * `--dest`: which environment to address.
+     * `test --env <target>`: which environment to read — `workspace`,
+     * `ephemeral`, or `ephemeral:<name>`. Kept as the raw string and resolved by
+     * `env-selector.ts`, the one module that knows the grammar, so `init --from`
+     * and this cannot drift on how an environment is spelled.
      *
-     * The parser accepts all three because `test` reads all three. `workspace` is
-     * refused by the commands that WRITE (`deploy`, `release`) at dispatch, with
-     * the explanation — not here, where the message could only say "bad value"
-     * for something that is a deliberate product boundary rather than a typo.
+     * `deploy` and `release` each reach exactly one environment and declare no
+     * flag for it; they refuse this at dispatch with the reason rather than a
+     * "bad value" here, since a full-replace import into a real workspace is a
+     * product boundary rather than a typo.
      */
-    dest: "sandbox" | "ephemeral" | "workspace" | undefined;
+    env: string | undefined;
     /** `test --kind unit|workflow`: narrow to one test family (default: both). */
     kind: "unit" | "workflow" | undefined;
     /** `test run-all --concurrency <n>`: how many tests to run at once (default 1). */
@@ -95,7 +98,7 @@ interface ParsedArgs {
      * frontend gets the typed path/verb contract without the SDK runtime.
      */
     emit: string | undefined;
-    /** `deploy --static <dir>`: archive this directory and deploy it to the sandbox's static host. */
+    /** `deploy --static <dir>`: archive this directory and deploy it to the environment's static host. */
     static: string | undefined;
     /**
      * `deploy --static-env KEY=VALUE` (repeatable): public config baked into EVERY
@@ -152,22 +155,22 @@ interface ParsedArgs {
     paste: boolean;
     /** `login --scope "<space list>"`: OAuth scopes to request (default: the built-in xano-cli set). */
     scope: string | undefined;
-    /** `validate --runtime`: after import + round-trip, run each deployed function and report. */
+    /** `preflight --runtime`: after import + round-trip, run each deployed function and report. */
     runtime: boolean;
-    /** `validate --capture`: write each round-tripped function's fetched JSON (candidate fixtures). */
+    /** `preflight --capture`: write each round-tripped function's fetched JSON (candidate fixtures). */
     capture: boolean;
-    /** `validate --verbose`: print full diffs / raw engine detail instead of a projected summary. */
+    /** `preflight --verbose`: print full diffs / raw engine detail instead of a projected summary. */
     verbose: boolean;
-    /** `validate --instance <url>`: override XANO_VALIDATE_INSTANCE for this run. */
+    /** `preflight --instance <url>`: override XANO_VALIDATE_INSTANCE for this run. */
     instance: string | undefined;
-    /** `sandbox export --format <json|multidoc>`: which artifact to emit (validated at parse time). */
+    /** `ephemeral export --format <json|multidoc>`: which artifact to emit (validated at parse time). */
     format: "json" | "multidoc" | undefined;
-    /** `sandbox export --path <p>`: output location (`-` for stdout; a dir or a full file path). */
+    /** `<env> export --path <p>`: output location (`-` for stdout; a dir or a full file path). */
     path: string | undefined;
-    /** `sandbox export --name <n>`: output basename override (default `sandbox`). Also the `init`/`codegen` app name (default: target dir basename). */
+    /** `<env> export --name <n>`: output basename override. Also the `init` app name (default: target dir basename). */
     name: string | undefined;
     /**
-     * `init`/`codegen` `--ai <preset>` (repeatable, comma-separated): AI-assistant instruction
+     * `init` `--ai <preset>` (repeatable, comma-separated): AI-assistant instruction
      * files to scaffold (`claude`/`codex`/`cursor`/`none`). Empty = prompt in a TTY,
      * else write none. Validated in the init command, not at parse time.
      */
@@ -182,45 +185,68 @@ interface ParsedArgs {
      */
     marketplace: string[];
     /**
-     * `init`/`codegen` `--framework <id>`: which frontend to scaffold
+     * `init --from <source>`: where `xano/` comes from — `workspace`,
+     * `ephemeral:<name>`, or a path to a bundle JSON already on disk. Undefined
+     * writes the empty-but-valid starter backend instead.
+     *
+     * Kept as the raw string here and resolved in `init-command.ts`, so the one
+     * place that knows the spellings is the one that reports a bad one.
+     */
+    from: string | undefined;
+    /**
+     * `init` `--framework <id>`: which frontend to scaffold
      * (`react`/`svelte`). Undefined = prompt in a TTY, else the default.
      * Validated in `frontend-presets.ts`, not at parse time.
      */
     framework: string | undefined;
     /**
-     * `init`/`codegen` `--theme <id>`: the shadcn/ui palette to render into the
+     * `init` `--theme <id>`: the shadcn/ui palette to render into the
      * scaffold's stylesheet — a `<base>` or `<base>-<accent>` pair, a registry
      * theme URL, or a path to a registry item JSON file. Undefined = plain
      * shadcn. Validated in `theme-presets.ts`, not at parse time.
      */
     theme: string | undefined;
-    /** `init`/`codegen` `--radius <len>`: corner radius override, bare number = rem. */
+    /** `init` `--radius <len>`: corner radius override, bare number = rem. */
     radius: string | undefined;
     /**
-     * `init`/`codegen` `--dark <mode>`: what switches the scaffold into its dark
+     * `init` `--dark <mode>`: what switches the scaffold into its dark
      * palette — `system` (default), `toggle`, or `off`.
      */
     dark: string | undefined;
-    /** `init`/`codegen` `--font <id>`: the body typeface (Tailwind's `--font-sans`). */
+    /** `init` `--font <id>`: the body typeface (Tailwind's `--font-sans`). */
     font: string | undefined;
-    /** `init`/`codegen` `--font-mono <id>`: the code typeface. */
+    /** `init` `--font-mono <id>`: the code typeface. */
     fontMono: string | undefined;
-    /** `init`/`codegen` `--font-heading <id>`: the heading typeface; absent inherits the body face. */
+    /** `init` `--font-heading <id>`: the heading typeface; absent inherits the body face. */
     fontHeading: string | undefined;
-    /** `init`/`codegen` `--icons <id>`: the icon set (`lucide` default, `tabler`, `phosphor`). */
+    /** `init` `--icons <id>`: the icon set (`lucide` default, `tabler`, `phosphor`). */
     icons: string | undefined;
-    /** `init`/`codegen` `--force`: scaffold into a non-empty target directory (overwrite our own files). */
+    /** `init` `--force`: scaffold into a non-empty target directory (overwrite our own files). */
     force: boolean;
-    /** `init`/`codegen` `--no-install`: skip the post-scaffold `npm install`. For `codegen` this also means the round trip cannot be verified, since loading the tree needs its dependencies. */
+    /** `init` `--no-install`: skip the post-scaffold `npm install`. Under `--from` this also means the round trip cannot be verified, since loading the tree needs its dependencies. */
     noInstall: boolean;
     /**
-     * `deploy --no-verify`: skip the post-deploy liveness checks. Everything is
-     * still deployed; XanoTS just doesn't wait to confirm it came up — neither
+     * `deploy --skip-liveness`: skip the post-deploy liveness checks. Everything
+     * is still deployed; XanoTS just doesn't wait to confirm it came up — neither
      * that the edge is serving *this* static build (via `X-Xano-Canonical`) nor
      * that the workspace's microservices reached a ready state. Useful for fast
      * iterative deploys or when the deployed URL isn't reachable from the CLI host.
      */
-    noVerify: boolean;
+    skipLiveness: boolean;
+    /**
+     * `init --from … --skip-roundtrip`: skip the offline check that the tree just
+     * written re-exports as the bundle it was decoded from. Entirely local — no
+     * network, no deploy, no workspace mutation — which is why it is not the same
+     * flag as {@link skipLiveness} despite both once being spelled `--no-verify`.
+     */
+    skipRoundtrip: boolean;
+    /**
+     * `lock prune --identity-only`: drop the named entries without loading the
+     * entry file. The third thing `--no-verify` used to mean, and the least
+     * related to the other two: nothing is verified either way, the question is
+     * whether the workspace is evaluated at all.
+     */
+    identityOnly: boolean;
     /**
      * `deploy --require-microservices`: fail the deploy when a microservice has
      * not reported ready by the end of the wait, not just when the engine says it
@@ -230,7 +256,7 @@ interface ParsedArgs {
      */
     requireMicroservices: boolean;
     /**
-     * `codegen --report <grouped|full|json>`: how the findings are rendered.
+     * `init --from … --report <grouped|full|json>`: how the findings are rendered.
      *
      * `grouped` (the default) prints one line per distinct root cause with a count
      * and a collapsed object list; `full` prints every site; `json` prints the
@@ -383,7 +409,7 @@ interface CompiledBundle {
 }
 /**
  * Thin wrapper over {@link compileBundle} for the many callers that only need the
- * bundle text (export, validate, sandbox-export). Seed content is not built here.
+ * bundle text (export, preflight). Seed content is not built here.
  */
 declare function exportBundleJson(args: ParsedArgs): Promise<string>;
 /**

package/dist/cli.js

@@ -8,14 +8,15 @@ import {
   resolveHelpRequest,
   resolveLockPath,
   run
-} from "./chunk-K3YSQDXJ.js";
-import "./chunk-JQLR64UC.js";
+} from "./chunk-ACCBOMCB.js";
+import "./chunk-CTD5ZCV6.js";
 import "./chunk-OYMR5AMJ.js";
+import "./chunk-F6CYJ7TN.js";
 import "./chunk-GNPVYOPB.js";
 import "./chunk-EZG76F7R.js";
-import "./chunk-UDL46O35.js";
-import "./chunk-OKNSR7MT.js";
-import "./chunk-QONOJO45.js";
+import "./chunk-VKSOTZK3.js";
+import "./chunk-DIA7CT7J.js";
+import "./chunk-LBYWGMOA.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
 import "./chunk-7JDT4PBU.js";

package/dist/codegen-command-GB3H2KQ7.js

@@ -0,0 +1,46 @@
+import {
+  blameGeneratedFile,
+  fetchWorkspaceBundle,
+  isMissingDependencyError,
+  runInitFromCommand,
+  verifyCrashEntry
+} from "./chunk-I7DQDJAM.js";
+import "./chunk-3INK4Y4E.js";
+import "./chunk-ZQ2PKR6R.js";
+import "./chunk-K5IOND4K.js";
+import "./chunk-QKM4U5UK.js";
+import "./chunk-FE5I6S6N.js";
+import "./chunk-7ZYW652H.js";
+import "./chunk-ZUTSMMAG.js";
+import "./chunk-X4DVXBFY.js";
+import "./chunk-3IGNIP6R.js";
+import "./chunk-YYFXVYPX.js";
+import "./chunk-KA6G2L7U.js";
+import "./chunk-ZSYZTGJH.js";
+import "./chunk-75Z74TA7.js";
+import "./chunk-LU7TRWMC.js";
+import "./chunk-YBC3IKMF.js";
+import "./chunk-ANUDXFEX.js";
+import "./chunk-Q77KNEUL.js";
+import "./chunk-4BXJGVZ3.js";
+import "./chunk-P6TAVLOX.js";
+import "./chunk-ACCBOMCB.js";
+import "./chunk-CTD5ZCV6.js";
+import "./chunk-OYMR5AMJ.js";
+import "./chunk-F6CYJ7TN.js";
+import "./chunk-GNPVYOPB.js";
+import "./chunk-EZG76F7R.js";
+import "./chunk-VKSOTZK3.js";
+import "./chunk-DIA7CT7J.js";
+import "./chunk-LBYWGMOA.js";
+import "./chunk-WHOJWOSV.js";
+import "./chunk-5XZ744TS.js";
+import "./chunk-7JDT4PBU.js";
+export {
+  blameGeneratedFile,
+  fetchWorkspaceBundle,
+  isMissingDependencyError,
+  runInitFromCommand,
+  verifyCrashEntry
+};
+//# sourceMappingURL=codegen-command-GB3H2KQ7.js.map

package/dist/{completion-A6BZ3XGU.js → completion-WF46272M.js}

@@ -6,7 +6,7 @@ import {
   liveCommandNames,
   liveSubcommandNames,
   visibleFlags
-} from "./chunk-OKNSR7MT.js";
+} from "./chunk-DIA7CT7J.js";
 
 // src/emit/completion.ts
 var COMPLETION_SHELLS = ["bash", "zsh", "fish"];
@@ -296,4 +296,4 @@ export {
   renderCompletion,
   runCompletionCommand
 };
-//# sourceMappingURL=completion-A6BZ3XGU.js.map
+//# sourceMappingURL=completion-WF46272M.js.map

package/dist/{config-NL33PN4D.js → config-476F3PT5.js}

@@ -81,4 +81,4 @@ export {
   resolveValidateConfig,
   verifyToken
 };
-//# sourceMappingURL=config-NL33PN4D.js.map
+//# sourceMappingURL=config-476F3PT5.js.map

package/dist/{deploy-command-5TTI4TUP.js → deploy-command-QTIVA22A.js}

@@ -1,52 +1,49 @@
 import {
   importWorkspaceArchive
-} from "./chunk-6AAT2AYQ.js";
+} from "./chunk-WP4OZZV4.js";
 import {
   assertBundleInput,
   loadBundleText
-} from "./chunk-KSV7VOEX.js";
+} from "./chunk-W24FJHPD.js";
+import {
+  microserviceLine,
+  readyRatio,
+  waitForMicroservices
+} from "./chunk-3UABJA4X.js";
 import {
   createEphemeral,
   getEphemeral,
   isEphemeralDisabled,
   isExpired,
-  tenantBaseUrl,
   waitUntilReady
-} from "./chunk-6DHBYBTO.js";
-import {
-  getEnvironment,
-  readEphemeralState,
-  setEnvironment
-} from "./chunk-MDXR5E5Q.js";
+} from "./chunk-VNQM3V2C.js";
 import {
   openBrowser
 } from "./chunk-W5NOKYEG.js";
 import {
-  microserviceLine,
-  readyRatio,
-  waitForMicroservices
-} from "./chunk-NDZFBZHC.js";
+  isMachineOutput,
+  writeJson
+} from "./chunk-NUQCEOKA.js";
+import {
+  getEnvironment,
+  readEphemeralState,
+  setEnvironment
+} from "./chunk-K5IOND4K.js";
 import {
   getAccessToken
-} from "./chunk-3QW5NFZJ.js";
-import "./chunk-BKDJN76G.js";
+} from "./chunk-QKM4U5UK.js";
+import "./chunk-FE5I6S6N.js";
 import {
   encodeWorkspaceArchive
 } from "./chunk-ZUTSMMAG.js";
 import "./chunk-X4DVXBFY.js";
-import {
-  isMachineOutput,
-  writeJson
-} from "./chunk-NUQCEOKA.js";
-import {
-  fetchOrExplain,
-  httpFailure
-} from "./chunk-3IGNIP6R.js";
-import "./chunk-K3YSQDXJ.js";
-import {
-  assertWritableDest
-} from "./chunk-JQLR64UC.js";
+import "./chunk-3IGNIP6R.js";
+import "./chunk-ACCBOMCB.js";
+import "./chunk-CTD5ZCV6.js";
 import "./chunk-OYMR5AMJ.js";
+import {
+  assertNoEnv
+} from "./chunk-F6CYJ7TN.js";
 import "./chunk-GNPVYOPB.js";
 import {
   blank,
@@ -62,9 +59,9 @@ import {
   warn,
   withSpinner
 } from "./chunk-EZG76F7R.js";
-import "./chunk-UDL46O35.js";
-import "./chunk-OKNSR7MT.js";
-import "./chunk-QONOJO45.js";
+import "./chunk-VKSOTZK3.js";
+import "./chunk-DIA7CT7J.js";
+import "./chunk-LBYWGMOA.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
 import "./chunk-7JDT4PBU.js";
@@ -74,9 +71,8 @@ import { basename } from "path";
 var EXIT_STATIC_FAILED = 3;
 var EXIT_MICROSERVICE_NOT_READY = 4;
 var EXIT_TESTS_UNREACHABLE = 6;
-var SANDBOX_TIMEOUT_MS = 3e4;
 function microserviceCheck(args) {
-  return { noVerify: args.noVerify, requireReady: args.requireMicroservices };
+  return { skip: args.skipLiveness, requireReady: args.requireMicroservices };
 }
 function buildStaticEnv(baseUrl, staticEnv) {
   const env = {};
@@ -94,28 +90,6 @@ function deriveDisplay(bundleText, cwd) {
   }
   return basename(cwd) || "xanots-app";
 }
-async function resolveSandboxBaseUrl(auth) {
-  const url = new URL("/api:meta/sandbox/me", auth.instance);
-  const res = await fetchOrExplain(
-    url.href,
-    {
-      headers: { accept: "application/json", Authorization: `Bearer ${auth.access_token}` },
-      signal: AbortSignal.timeout(SANDBOX_TIMEOUT_MS)
-    },
-    "resolve sandbox",
-    SANDBOX_TIMEOUT_MS
-  );
-  const text = await res.text();
-  if (!res.ok) throw new Error(httpFailure("resolve sandbox", res, text));
-  let tenant = {};
-  try {
-    tenant = JSON.parse(text);
-  } catch {
-    throw new Error(`resolve sandbox: could not parse the ${url.pathname} response as JSON:
-${text}`);
-  }
-  return tenantBaseUrl(tenant, auth.instance);
-}
 async function assertNoSeedLeaks(dir, values, allow) {
   if (values.length === 0) return;
   const unscannable = [
@@ -127,7 +101,7 @@ async function assertNoSeedLeaks(dir, values, allow) {
     );
     for (const column of unscannable) detail(column);
   }
-  const { findSeedLeaks } = await import("./static-host-D6KS7X45.js");
+  const { findSeedLeaks } = await import("./static-host-3WMV7IZO.js");
   const leaks = findSeedLeaks(dir, values);
   if (leaks.length === 0) return;
   const lines = leaks.map((l) => `  ${l.file} \u2014 ${l.table}.${l.column}`);
@@ -147,9 +121,9 @@ If the data is deliberately public demo content, pass --allow-seed-in-static.`
 function deployTarget(auth) {
   detail(`on ${hostLabel(auth.instance)} \xB7 workspace ${auth.workspaceId}`);
 }
-async function runDeployedTests(auth, dest, summary, args) {
+async function runDeployedTests(auth, summary, args) {
   try {
-    return await runTestsOrThrow(auth, dest, summary, args);
+    return await runTestsOrThrow(auth, summary, args);
   } catch (err) {
     warn("The deploy stands, but its tests could not be run:");
     detail(err instanceof Error ? err.message : String(err));
@@ -157,20 +131,19 @@ async function runDeployedTests(auth, dest, summary, args) {
     return void 0;
   }
 }
-async function runTestsOrThrow(auth, dest, summary, args) {
-  const { runSuite, EXIT_TESTS_FAILED } = await import("./test-command-2F5LKMI6.js");
-  let target;
-  if (dest === "ephemeral") {
-    if (summary.url === void 0) {
-      warn("Skipped --test: the ephemeral reported no base URL to run against.");
-      return void 0;
-    }
-    const name = summary.ephemeral?.name;
-    target = { base: summary.url, workspaceId: 1, label: name ? `ephemeral ${name}` : "the ephemeral", env: name };
-  } else {
-    const { resolveMetaTarget } = await import("./env-target-4T7AT347.js");
-    target = await resolveMetaTarget(auth, { dest: "sandbox" });
+async function runTestsOrThrow(auth, summary, args) {
+  const { runSuite, EXIT_TESTS_FAILED } = await import("./test-command-YAZLKLGQ.js");
+  if (summary.url === void 0) {
+    warn("Skipped --test: the ephemeral reported no base URL to run against.");
+    return void 0;
   }
+  const name = summary.ephemeral?.name;
+  const target = {
+    base: summary.url,
+    workspaceId: 1,
+    label: name ? `ephemeral ${name}` : "the ephemeral",
+    env: name
+  };
   const outcomes = await runSuite(auth, target, {
     kind: args.kind,
     concurrency: args.concurrency,
@@ -199,8 +172,7 @@ async function runTestsOrThrow(auth, dest, summary, args) {
   };
 }
 async function runDeployCommand(args) {
-  assertWritableDest(args.dest, "deploy");
-  const dest = args.dest ?? "ephemeral";
+  assertNoEnv(args.env, "deploy");
   const startedAt = Date.now();
   if (args.reset) info("`--reset` is redundant \u2014 deploy is always a full replace.");
   assertBundleInput(args, { command: "deploy" });
@@ -224,8 +196,8 @@ async function runDeployCommand(args) {
     const staticEnv = buildStaticEnv(env.baseUrl, args.staticEnv);
     const explicit = Object.keys(args.staticEnv).length > 0;
     try {
-      const target = dest === "ephemeral" ? { baseUrl: env.baseUrl, workspaceId: 1, label: env.label } : { baseUrl: auth.instance, workspaceId: auth.workspaceId, label: void 0 };
-      staticSummary = await deployStaticTo(staticDir, auth, target, staticEnv, explicit, args.staticHost, args.noVerify, args.staticRouting);
+      const target = { baseUrl: env.baseUrl, workspaceId: 1, label: env.label };
+      staticSummary = await deployStaticTo(staticDir, auth, target, staticEnv, explicit, args.staticHost, args.skipLiveness, args.staticRouting);
     } catch (err) {
       warn("The static-host upload failed \u2014 the backend deploy stands:");
       detail(err instanceof Error ? err.message : String(err));
@@ -235,12 +207,19 @@ async function runDeployCommand(args) {
       process.exitCode = EXIT_STATIC_FAILED;
     }
   };
-  const summary = dest === "sandbox" ? await deploySandbox(auth, archive, source, microserviceCheck(args), startedAt, publishStatic) : await deployEphemeral(auth, { archive, bundle, source, args, startedAt, publishStatic });
+  const summary = await deployEphemeral(auth, {
+    archive,
+    bundle,
+    source,
+    args,
+    startedAt,
+    publishStatic
+  });
   if (staticSummary !== void 0) summary.static = staticSummary;
-  if (dest === "ephemeral" && summary.created === false && staticSummary?.url !== void 0) {
+  if (summary.created === false && staticSummary?.url !== void 0) {
     detail("This static URL is new \u2014 a re-deploy replaces the environment's hosting, so the previous one no longer serves.");
   }
-  if (args.test) summary.testRun = await runDeployedTests(auth, dest, summary, args);
+  if (args.test) summary.testRun = await runDeployedTests(auth, summary, args);
   if (args.open) openDeployed(summary);
   if (isMachineOutput(args)) writeJson(summary);
 }
@@ -253,17 +232,6 @@ function openDeployed(summary) {
   detail(`Opening ${url}`);
   openBrowser(url);
 }
-async function deploySandbox(auth, archive, source, check, startedAt, publishStatic) {
-  step(`Deploying ${source} \u2192 sandbox (full replace)`);
-  deployTarget(auth);
-  const baseUrl = await resolveSandboxBaseUrl(auth);
-  await publishStatic?.({ baseUrl, label: void 0 });
-  await withSpinner(IMPORTING_LABEL, () => importWorkspaceArchive(auth, { baseUrl, archive }));
-  success(`Backend deployed to sandbox${elapsedSuffix(startedAt)}`);
-  link(baseUrl);
-  const microservices = await verifyMicroservices(auth, baseUrl, check);
-  return { dest: "sandbox", url: baseUrl, ...microservices ? { microservices } : {} };
-}
 var WAITING_LABEL = "Waiting for microservices\u2026";
 var IMPORTING_LABEL = "Uploading and importing the workspace\u2026";
 function waitingLabel(microservices) {
@@ -271,7 +239,7 @@ function waitingLabel(microservices) {
   return startable === 0 ? WAITING_LABEL : `${WAITING_LABEL} (${ready}/${startable} ready)`;
 }
 async function verifyMicroservices(auth, baseUrl, opts, waitOpts = {}) {
-  if (opts.noVerify) return void 0;
+  if (opts.skip) return void 0;
   const spin = spinner(WAITING_LABEL);
   let result;
   try {
@@ -305,7 +273,7 @@ async function verifyMicroservices(auth, baseUrl, opts, waitOpts = {}) {
   }
   for (const m of microservices) detail(microserviceLine(m));
   if (timedOut && !hadFailure) {
-    detail("Re-check with `xanots ephemeral get <env>`, or skip this wait next time with --no-verify.");
+    detail("Re-check with `xanots ephemeral get <env>`, or skip this wait next time with --skip-liveness.");
     if (!opts.requireReady) {
       detail("Fail the deploy on this instead of warning: --require-microservices.");
     }
@@ -317,9 +285,9 @@ function failDeploy() {
 }
 function ephemeralDisabledError(source) {
   return new Error(
-    `Ephemeral environments are not enabled on this instance, so \`--dest ephemeral\` (the default) has nothing to create.
-Deploy to the sandbox instead: \`xanots deploy --dest sandbox ${source}\`.
-\u26A0 With \`--dest sandbox\`, \`--static\` publishes the frontend to your OWN (parent) workspace \u2014 the sandbox tenant does not serve static hosting \u2014 so it replaces whatever that workspace is hosting.`
+    `Ephemeral environments are not enabled on this instance, so there is nothing for \`xanots deploy ${source}\` to create \u2014 they are the only environment it writes to.
+Ask whoever administers the instance to enable them.
+Until then \`xanots export\` still writes the bundle, and \`xanots preflight\` still checks the round-trip, without needing one.`
   );
 }
 async function deployEphemeral(auth, ctx) {
@@ -392,7 +360,7 @@ async function deployEphemeral(auth, ctx) {
   await publishStatic?.({ baseUrl, label: `ephemeral ${target.name}` });
   if (publishStatic !== void 0) {
     detail(
-      "The frontend URL changes on every ephemeral deploy (the import clears static hosting) and the replace re-seeds the environment. For a stable URL while iterating, deploy with `--dest sandbox` \u2014 its frontend lands on your own workspace, which no import clears."
+      "The frontend URL changes on every deploy (the import clears static hosting) and the replace re-seeds the environment \u2014 bookmarks and shared links from the previous run stop serving."
     );
   }
   const microservices = await verifyMicroservices(auth, baseUrl, microserviceCheck(args));
@@ -404,8 +372,8 @@ async function deployEphemeral(auth, ctx) {
     ...microservices ? { microservices } : {}
   };
 }
-async function deployStaticTo(dir, auth, target, env, explicit, host, noVerify, routing) {
-  const { deployStaticHost } = await import("./static-host-D6KS7X45.js");
+async function deployStaticTo(dir, auth, target, env, explicit, host, skipLiveness, routing) {
+  const { deployStaticHost } = await import("./static-host-3WMV7IZO.js");
   const where = target.label && target.label !== "" ? target.label : `workspace #${target.workspaceId}`;
   step(`Deploying static frontend ${dir} \u2192 ${where}${host ? ` (host: ${host})` : ""}`);
   const sh = await deployStaticHost({ host, dir, workspaceId: target.workspaceId, baseUrl: target.baseUrl, accessToken: auth.access_token, env, routing });
@@ -424,7 +392,7 @@ async function deployStaticTo(dir, auth, target, env, explicit, host, noVerify,
   }
   success("Static host deployed");
   if (sh.url) link(sh.url);
-  if (noVerify || sh.url === void 0 || sh.canonical === void 0) {
+  if (skipLiveness || sh.url === void 0 || sh.canonical === void 0) {
     return { url: sh.url };
   }
   const { verifyRollout } = await import("./verify-rollout-FAVQ6EJY.js");
@@ -434,7 +402,7 @@ async function deployStaticTo(dir, auth, target, env, explicit, host, noVerify,
     success("Frontend is live");
   } else {
     warn("Could not confirm the frontend is live within the wait window \u2014 the build uploaded and should come online shortly.");
-    detail(`Re-check by opening ${sh.url}, or skip this wait next time with --no-verify.`);
+    detail(`Re-check by opening ${sh.url}, or skip this wait next time with --skip-liveness.`);
   }
   return { url: sh.url, verified: live };
 }
@@ -448,4 +416,4 @@ export {
   runDeployedTests,
   verifyMicroservices
 };
-//# sourceMappingURL=deploy-command-5TTI4TUP.js.map
+//# sourceMappingURL=deploy-command-QTIVA22A.js.map