@xanots/sdk 0.0.8 → 0.0.10

package/dist/{chunk-SNO3KHCY.js → chunk-ACCBOMCB.js}

@@ -1,19 +1,21 @@
+import {
+  ENV_SPELLINGS
+} from "./chunk-CTD5ZCV6.js";
+import {
+  readLockFile,
+  writeLockFile
+} from "./chunk-OYMR5AMJ.js";
 import {
   UsageError,
   extraArguments,
   missingArgument,
-  removedSubcommand,
   renderGlobalHelp,
   renderHelpFor,
   unknownCommand,
   unknownFlag,
   unknownHelpTopic,
   unknownSubcommand
-} from "./chunk-JQLR64UC.js";
-import {
-  readLockFile,
-  writeLockFile
-} from "./chunk-OYMR5AMJ.js";
+} from "./chunk-F6CYJ7TN.js";
 import {
   detail,
   info,
@@ -24,13 +26,13 @@ import {
   Xano,
   assertSeedIds,
   coerceSeedRowValues
-} from "./chunk-FEQTQ6PM.js";
+} from "./chunk-VKSOTZK3.js";
 import {
   getCommand,
   getSubcommand,
   isCommand,
   suggest
-} from "./chunk-OKNSR7MT.js";
+} from "./chunk-DIA7CT7J.js";
 import {
   FILTER_NAMES,
   KNOWLEDGE_DIR,
@@ -44,7 +46,7 @@ import {
   pathSegment,
   serializeBundle,
   tableColumns
-} from "./chunk-64QK6JEK.js";
+} from "./chunk-LBYWGMOA.js";
 import {
   WORKSPACE_KEY,
   createLockContext,
@@ -61,7 +63,7 @@ import {
 // src/emit/cli.ts
 import { pathToFileURL as pathToFileURL3, fileURLToPath as fileURLToPath3 } from "url";
 import { existsSync, readdirSync as readdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
-import { basename, dirname, join as join2, relative as relative2, resolve } from "path";
+import { basename, dirname, isAbsolute, join as join2, relative as relative2, resolve } from "path";
 import { createRequire } from "module";
 
 // src/workspace/seed.ts
@@ -338,7 +340,7 @@ function parsePort(raw) {
   }
   return n;
 }
-var NOUN_COMMANDS = /* @__PURE__ */ new Set(["sandbox", "profile", "ephemeral", "workspace", "marketplace", "test"]);
+var NOUN_COMMANDS = /* @__PURE__ */ new Set(["profile", "ephemeral", "workspace", "marketplace", "test"]);
 function helpTargetFor(command, subcommand) {
   if (command === void 0 || !isCommand(command)) return void 0;
   return subcommand !== void 0 && getSubcommand(command, subcommand) !== void 0 ? { command, subcommand } : { command };
@@ -383,7 +385,7 @@ function parseArgs(argv) {
   let check = false;
   let bundle;
   let reset = false;
-  let dest;
+  let env;
   let kind;
   let concurrency;
   let test = false;
@@ -411,6 +413,7 @@ function parseArgs(argv) {
   let name;
   const ai = [];
   const marketplace = [];
+  let from;
   let framework;
   let theme;
   let radius;
@@ -421,7 +424,9 @@ function parseArgs(argv) {
   let icons;
   let force = false;
   let noInstall = false;
-  let noVerify = false;
+  let skipLiveness = false;
+  let skipRoundtrip = false;
+  let identityOnly = false;
   let requireMicroservices = false;
   let report;
   let allowSeedInStatic = false;
@@ -471,10 +476,14 @@ function parseArgs(argv) {
       bundle = arg.slice("--bundle=".length);
     } else if (arg === "--reset") {
       reset = true;
-    } else if (arg === "--dest") {
-      dest = parseDest(rest[++i]);
-    } else if (arg.startsWith("--dest=")) {
-      dest = parseDest(arg.slice("--dest=".length));
+    } else if (arg === "--env" || arg.startsWith("--env=")) {
+      const value = arg === "--env" ? rest[++i] : arg.slice("--env=".length);
+      if (value === void 0 || value === "") {
+        throw new UsageError(`--env expects an environment: ${ENV_SPELLINGS}.`, {
+          helpFor: helpTargetFor(command, subcommand)
+        });
+      }
+      env = value;
     } else if (arg === "--kind") {
       kind = parseKind(rest[++i]);
     } else if (arg.startsWith("--kind=")) {
@@ -596,6 +605,15 @@ function parseArgs(argv) {
       icons = rest[++i];
     } else if (arg.startsWith("--icons=")) {
       icons = arg.slice("--icons=".length);
+    } else if (arg === "--from" || arg.startsWith("--from=")) {
+      const value = arg === "--from" ? rest[++i] : arg.slice("--from=".length);
+      if (value === void 0 || value === "") {
+        throw new UsageError(
+          "--from expects a source: workspace, ephemeral:<name>, or a path to a bundle .json.",
+          { helpFor: helpTargetFor(command, subcommand) }
+        );
+      }
+      from = value;
     } else if (arg === "--marketplace" || arg.startsWith("--marketplace=")) {
       const raw = arg === "--marketplace" ? rest[++i] : arg.slice("--marketplace=".length);
       for (const p of (raw ?? "").split(",")) {
@@ -614,8 +632,17 @@ function parseArgs(argv) {
       noInstall = true;
     } else if (arg === "--allow-seed-in-static") {
       allowSeedInStatic = true;
+    } else if (arg === "--skip-liveness") {
+      skipLiveness = true;
+    } else if (arg === "--skip-roundtrip") {
+      skipRoundtrip = true;
+    } else if (arg === "--identity-only") {
+      identityOnly = true;
     } else if (arg === "--no-verify") {
-      noVerify = true;
+      throw new UsageError(
+        `\`--no-verify\` was split into three flags that each name what they skip: \`--skip-liveness\` (deploy: waiting for the deploy to come up), \`--skip-roundtrip\` (init --from: the offline re-export check), and \`--identity-only\` (lock prune: loading the entry file).`,
+        { helpFor: helpTargetFor(command, subcommand) }
+      );
     } else if (arg === "--require-microservices") {
       requireMicroservices = true;
     } else if (arg === "--dry-run") {
@@ -652,6 +679,12 @@ function parseArgs(argv) {
         `\`--profile\` was removed \u2014 deploy now authenticates via OAuth. Run \`xanots login\` once (or set XANO_REFRESH_TOKEN for CI).`,
         { helpFor: helpTargetFor(command, subcommand) }
       );
+    } else if (arg === "--dest" || arg.startsWith("--dest=")) {
+      const value = arg.startsWith("--dest=") ? arg.slice("--dest=".length) : rest[i + 1];
+      throw new UsageError(
+        `\`--dest\` is now \`--env\`${value === void 0 || value.startsWith("-") ? "" : ` (\`--env ${value}\`)`}, because it only ever selected an environment to READ \u2014 \`deploy\` and \`release\` each reach exactly one environment and take no flag for it. Environments are ${ENV_SPELLINGS}.`,
+        { helpFor: helpTargetFor(command, subcommand) }
+      );
     } else if (arg === "--workspace" || arg.startsWith("--workspace=")) {
       throw new UsageError(
         `\`--workspace\` was removed. Every command acts on the workspace its credential is bound to \u2014 pinned at \`xanots login\`, or set as \`workspace_id\` in a meta API token credential. Run \`xanots workspace details\` to see which one that is.`,
@@ -660,7 +693,7 @@ function parseArgs(argv) {
     } else if (arg === "--prune" || arg === "--confirm-workspace" || arg.startsWith("--confirm-workspace=") || arg === "--adopt-workspace") {
       const flag = arg.split("=")[0];
       throw new UsageError(
-        `\`${flag}\` was removed along with \`xanots workspace deploy\` \u2014 deploy targets are selected with \`xanots deploy --dest <ephemeral|sandbox>\`.`,
+        `\`${flag}\` was removed along with \`xanots workspace deploy\` \u2014 \`xanots deploy\` writes to an ephemeral environment, and takes no destination flag.`,
         { helpFor: helpTargetFor(command, subcommand) }
       );
     } else if (arg === "--help" || arg === "-h") {
@@ -696,7 +729,7 @@ function parseArgs(argv) {
     check,
     bundle,
     reset,
-    dest,
+    env,
     kind,
     concurrency,
     test,
@@ -724,6 +757,7 @@ function parseArgs(argv) {
     name,
     ai,
     marketplace,
+    from,
     force,
     noInstall,
     framework,
@@ -734,7 +768,9 @@ function parseArgs(argv) {
     fontMono,
     fontHeading,
     icons,
-    noVerify,
+    skipLiveness,
+    skipRoundtrip,
+    identityOnly,
     requireMicroservices,
     report,
     allowSeedInStatic,
@@ -768,10 +804,6 @@ function parseFormat(raw) {
   if (raw === "json" || raw === "multidoc") return raw;
   throw new Error(`--format must be "json" or "multidoc" (got "${raw ?? ""}").`);
 }
-function parseDest(raw) {
-  if (raw === "sandbox" || raw === "ephemeral" || raw === "workspace") return raw;
-  throw new Error(`--dest must be "ephemeral", "sandbox" or "workspace" (got "${raw ?? ""}").`);
-}
 function parseKind(raw) {
   if (raw === "unit" || raw === "workflow") return raw;
   throw new Error(`--kind must be "unit" or "workflow" (got "${raw ?? ""}").`);
@@ -839,12 +871,26 @@ function suggestSiblingFile(path) {
     return void 0;
   }
 }
+function findEntryInAncestor(file) {
+  if (isAbsolute(file)) return void 0;
+  let dir = dirname(resolve(file));
+  for (; ; ) {
+    const parent = dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+    if (existsSync(resolve(dir, file))) return dir;
+  }
+}
 async function loadDefault(file) {
   const path = resolve(file);
   if (!existsSync(path)) {
-    throw new UsageError(`Cannot find entry file "${file}" (resolved to ${path}).`, {
-      suggestion: suggestSiblingFile(path)
-    });
+    const elsewhere = findEntryInAncestor(file);
+    const where = elsewhere !== void 0 ? `A relative entry resolves against the current directory (${process.cwd()}), and "${file}" does exist under ${elsewhere} \u2014 run xanots from there.` : `A relative entry resolves against the current directory (${process.cwd()}).`;
+    throw new UsageError(
+      `Cannot find entry file "${file}" (resolved to ${path}).` + (isAbsolute(file) ? "" : `
+  ${where}`),
+      { suggestion: suggestSiblingFile(path) }
+    );
   }
   const url = pathToFileURL3(path).href;
   const isTypeScript = /\.[mc]?ts$/.test(file);
@@ -933,9 +979,12 @@ function warnOrphans(orphans, dropped, cededCanonicals, previous, observed) {
   }
 }
 async function run(argv) {
-  if (argv[0] === "onboard") {
-    const { runOnboardCommand } = await import("./onboard-command-EHOHKQQU.js");
-    return runOnboardCommand(argv.slice(1));
+  if (argv[0] === "init") {
+    const web = argv.indexOf("--web", 1);
+    if (web !== -1) {
+      const { runInitWebCommand } = await import("./init-web-3JNFG6GI.js");
+      return runInitWebCommand([...argv.slice(1, web), ...argv.slice(web + 1)]);
+    }
   }
   const helpRequest = resolveHelpRequest(argv);
   if (helpRequest) {
@@ -955,11 +1004,11 @@ async function run(argv) {
     return;
   }
   if (command === "init") {
-    const { runInitCommand } = await import("./init-command-4MG3UKUO.js");
+    const { runInitCommand } = await import("./init-command-MAXULNAD.js");
     return runInitCommand(args);
   }
   if (command === "completion") {
-    const { isCompletionShell, runCompletionCommand, COMPLETION_SHELLS } = await import("./completion-A6BZ3XGU.js");
+    const { isCompletionShell, runCompletionCommand, COMPLETION_SHELLS } = await import("./completion-WF46272M.js");
     const shell = args.positionals[0];
     if (shell === void 0 || !isCompletionShell(shell)) {
       throw new UsageError(
@@ -970,79 +1019,61 @@ async function run(argv) {
     return runCompletionCommand(shell);
   }
   if (command === "upgrade") {
-    const { runUpgradeCommand } = await import("./upgrade-command-XFOAWDI3.js");
+    const { runUpgradeCommand } = await import("./upgrade-command-FB5QJ363.js");
     return runUpgradeCommand(args);
   }
   if (command === "lock") {
-    const { runLockCommand } = await import("./lock-commands-Y4S4NUCE.js");
+    const { runLockCommand } = await import("./lock-commands-DQ7CUMIV.js");
     return runLockCommand(args);
   }
   if (command === "login") {
-    const { runLoginCommand } = await import("./login-command-DFCURZLC.js");
+    const { runLoginCommand } = await import("./login-command-Z6CHTA57.js");
     return runLoginCommand(args);
   }
   if (command === "logout") {
-    const { runLogoutCommand } = await import("./logout-command-WXVZQCAV.js");
+    const { runLogoutCommand } = await import("./logout-command-ER6IKAYJ.js");
     return runLogoutCommand(args);
   }
   if (command === "deploy") {
-    const { runDeployCommand } = await import("./deploy-command-QZ3GNLAD.js");
+    const { runDeployCommand } = await import("./deploy-command-QTIVA22A.js");
     return runDeployCommand(args);
   }
   if (command === "ephemeral") {
-    const { runEphemeralCommand } = await import("./ephemeral-command-DL7EY4LL.js");
+    const { runEphemeralCommand } = await import("./ephemeral-command-U4AQ3TXX.js");
     return runEphemeralCommand(args);
   }
   if (command === "release") {
-    const { runReleaseCommand } = await import("./release-command-DN75G5GJ.js");
+    const { runReleaseCommand } = await import("./release-command-YUBTNHVX.js");
     return runReleaseCommand(args);
   }
-  if (command === "sandbox") {
-    if (args.subcommand === "deploy") {
-      throw removedSubcommand("sandbox", "deploy");
-    }
-    if (args.subcommand === "details") {
-      const { runSandboxDetailsCommand } = await import("./sandbox-details-command-EDO56IY3.js");
-      return runSandboxDetailsCommand(args);
-    }
-    if (args.subcommand === "export") {
-      const { runSandboxExportCommand } = await import("./sandbox-export-command-MO6DEZ7Z.js");
-      return runSandboxExportCommand(args);
-    }
-    if (args.subcommand === "codegen") {
-      const { runCodegenCommand } = await import("./codegen-command-U2W72DLG.js");
-      return runCodegenCommand(args, { kind: "sandbox" });
-    }
-    throw unknownSubcommand("sandbox", args.subcommand);
-  }
   if (command === "test") {
-    const { runTestCommand } = await import("./test-command-RRNNJ45I.js");
+    const { runTestCommand } = await import("./test-command-YAZLKLGQ.js");
     return runTestCommand(args);
   }
   if (command === "workspace") {
-    const { runWorkspaceCommand } = await import("./workspace-command-QCFELEGR.js");
+    const { runWorkspaceCommand } = await import("./workspace-command-43P42FBP.js");
     return runWorkspaceCommand(args);
   }
-  if (command === "codegen") {
-    const { runCodegenCommand } = await import("./codegen-command-U2W72DLG.js");
-    return runCodegenCommand(args, { kind: "file" });
+  if (command === "status") {
+    const { runStatusCommand } = await import("./status-command-AL47VG7H.js");
+    return runStatusCommand(args);
+  }
+  if (command === "whoami") {
+    const { runProfileCommand } = await import("./profile-command-LJSBDV2L.js");
+    return runProfileCommand(args);
   }
   if (command === "profile") {
     if (args.subcommand !== "me") {
       throw unknownSubcommand("profile", args.subcommand);
     }
-    const { runProfileCommand } = await import("./profile-command-QJAAUZIV.js");
-    return runProfileCommand(args);
-  }
-  if (command === "whoami") {
-    const { runProfileCommand } = await import("./profile-command-QJAAUZIV.js");
+    const { runProfileCommand } = await import("./profile-command-LJSBDV2L.js");
     return runProfileCommand(args);
   }
   if (command === "marketplace") {
     if (!["list", "search", "details", "install"].includes(args.subcommand ?? "")) {
       throw unknownSubcommand("marketplace", args.subcommand);
     }
-    const marketplace = await import("./marketplace-command-BCOAAN2I.js");
+    const marketplace = await import("./marketplace-command-P4IPLJ6J.js");
     if (args.subcommand === "list") return marketplace.runMarketplaceListCommand(args);
     if (args.subcommand === "search") return marketplace.runMarketplaceSearchCommand(args);
     if (args.subcommand === "details") return marketplace.runMarketplaceDetailsCommand(args);
@@ -1051,9 +1082,9 @@ async function run(argv) {
   if (command === "push") {
     throw unknownCommand("push");
   }
-  if (command === "validate") {
-    const { runValidateCommand } = await import("./validate-command-GLF5ZOOW.js");
-    return runValidateCommand(args);
+  if (command === "preflight") {
+    const { runPreflightCommand } = await import("./preflight-command-GZ2GE5RN.js");
+    return runPreflightCommand(args);
   }
   if (command !== "compile" && command !== "export" && command !== "paths" && command !== "routes") {
     throw unknownCommand(command);
@@ -1084,7 +1115,7 @@ async function run(argv) {
 }
 async function refreshAgentGuidance() {
   try {
-    const { refreshAgentFiles } = await import("./agent-file-refresh-4W37DGXS.js");
+    const { refreshAgentFiles } = await import("./agent-file-refresh-QNKN5RYD.js");
     const refreshed = refreshAgentFiles({
       projectDir: process.cwd(),
       sdkVersion: readVersion()
@@ -1116,7 +1147,7 @@ async function runCompile(args) {
   const def = await loadDefault(file);
   if (Xano.isXano(def)) {
     throw new Error(
-      `Module "${file}" default-exports a workspace \u2014 use \`xanots export\` (or \`xanots paths\`) for a workspace entry. \`compile\` takes a single object def (a query, function, table, \u2026) and prints its JSON artifact.`
+      `Module "${file}" default-exports a workspace \u2014 use \`xanots export\` (or \`xanots routes\`) for a workspace entry. \`compile\` takes a single object def (a query, function, table, \u2026) and prints its JSON artifact.`
     );
   }
   if (!def || typeof def !== "object" || typeof def.name !== "string") {
@@ -1200,7 +1231,7 @@ async function runPaths(args) {
       return;
     }
     if (unresolved.length === 0) {
-      const { renderRouteManifest } = await import("./routes-manifest-SP3ZXLMR.js");
+      const { renderRouteManifest } = await import("./routes-manifest-PWZHDOI5.js");
       const source = renderRouteManifest(
         resolved.map((r) => ({ name: r.name, verb: r.verb, canonical: r.canonical })),
         describableServers.length > 0 ? { servers: describableServers, channels: channelRows } : void 0
@@ -1212,7 +1243,7 @@ async function runPaths(args) {
         const current = existsSync(args.emit) ? readFileSync3(args.emit, "utf8") : void 0;
         if (current !== source) {
           throw new Error(
-            `--strict: ${args.emit} is ${current === void 0 ? "missing" : "out of date"}. Run \`xanots paths <entry> --emit ${args.emit}\` and commit the result \u2014 a stale route manifest keeps compiling while the endpoints have moved.`
+            `--strict: ${args.emit} is ${current === void 0 ? "missing" : "out of date"}. Run \`xanots routes <entry> --emit ${args.emit}\` and commit the result \u2014 a stale route manifest keeps compiling while the endpoints have moved.`
           );
         }
         info(`${args.emit} is up to date (${count}).`);
@@ -1232,7 +1263,7 @@ async function runPaths(args) {
   if (unresolved.length > 0) {
     const names = unresolved.map((r) => `"${r.name}"`).join(", ");
     throw new Error(
-      `paths: cannot resolve the api group's canonical URL token for ${unresolved.length} query(ies): ${names}. Set an explicit \`apiGroup({ canonical })\`, or run \`xanots export ${file} --lock\` once (it mints a unique canonical and freezes it in xano.lock) beside the entry, then re-run \`xanots paths\`.`
+      `paths: cannot resolve the api group's canonical URL token for ${unresolved.length} query(ies): ${names}. Set an explicit \`apiGroup({ canonical })\`, or run \`xanots export ${file} --lock\` once (it mints a unique canonical and freezes it in xano.lock) beside the entry, then re-run \`xanots routes\`.`
     );
   }
 }
@@ -1317,4 +1348,4 @@ export {
   exportBundleJson,
   compileBundle
 };
-//# sourceMappingURL=chunk-SNO3KHCY.js.map
+//# sourceMappingURL=chunk-ACCBOMCB.js.map

package/dist/{chunk-4PTSTDIG.js → chunk-AIZKXUNP.js}

@@ -1,6 +1,6 @@
 import {
   UsageError
-} from "./chunk-JQLR64UC.js";
+} from "./chunk-F6CYJ7TN.js";
 import {
   style
 } from "./chunk-EZG76F7R.js";
@@ -56,4 +56,4 @@ export {
   confirm,
   promptLine
 };
-//# sourceMappingURL=chunk-4PTSTDIG.js.map
+//# sourceMappingURL=chunk-AIZKXUNP.js.map

package/dist/{chunk-P5C2YKAM.js → chunk-ANUDXFEX.js}

@@ -36,7 +36,7 @@ function renderPackageJson({ appName, sdkVersion }, preset, choice = defaultThem
       // delete-and-recreate instead of rename-in-place. The lock has to be
       // adopted BEFORE the identities matter — by the time a rename lands
       // against data anyone cares about, the guids have already drifted and
-      // recovery is `xanots lock adopt`. The scaffold is the earliest possible
+      // recovery is `xanots lock import`. The scaffold is the earliest possible
       // moment, so it opts in from the first export (issue #26). Once the file
       // exists every export uses it, flag or not.
       "xano:export": `${check} && xanots export ./xano/index.ts --out workspace.json --lock`,
@@ -226,7 +226,9 @@ npm run xano:deploy     # build the frontend, then ship it with the backend
 - \`npm run xano:deploy\` deploys the backend and the built frontend to a live
   **ephemeral** environment and prints its URL. Run it again to refresh the same
   environment; if it expired, a fresh one is created and the new URL is called out.
-- Deploying to your throwaway singleton sandbox instead: \`xanots deploy ./xano/index.ts --dest sandbox\`.
+- \`xanots status\` says who you are signed in as, which workspace you are bound to, and
+  which environment this project last deployed to \u2014 its URL, and when it expires. You
+  never have to remember the environment's name.
 - \`npm run xano:test\` runs the tests the DEPLOYED environment carries \u2014 the \`tests\`
   on a query/function/middleware and any \`workflowTest()\`. It compiles nothing, so
   deploy first. A failing suite exits 5, distinct from a crash. \`xanots deploy
@@ -243,7 +245,7 @@ public URLs).
 
 It is created by \`npm run xano:export\` or \`npm run xano:deploy\`, and **must be
 committed**. Adopt it from the first export: once identities have drifted, the
-recovery path is \`xanots lock adopt <live-bundle.json> --lock=xano/xano.lock\`
+recovery path is \`xanots lock import <live-bundle.json> --lock=xano/xano.lock\`
 against the deployed workspace.
 
 \`\`\`bash
@@ -252,7 +254,7 @@ npm run xano:check      # CI: fail if the export would change xano.lock
 
 To rename an object: rename it in code, run \`npm run xano:export\` (stderr prints
 the exact fix-up), run \`xanots lock rename <kind> <old> <new> --lock=xano/xano.lock\`,
-then export again. \`lock rename\` and \`lock adopt\` need that flag here \u2014 they take no
+then export again. \`lock rename\` and \`lock import\` need that flag here \u2014 they take no
 entry file, so they look for the lock in the current directory, while
 \`lock prune ./xano/index.ts\` derives it from the entry like \`export\` does.
 
@@ -267,7 +269,7 @@ body \u2014 change a def and the frontend types follow.
 > file with \`tsx <file.ts>\` **from inside the project root** \u2014 not \`tsx -e\`, not
 > bare \`node file.ts\`, and not from another directory (they mis-resolve the
 > intra-workspace \`.js\` imports and the \`@xanots/sdk\` specifier). Or use
-> \`xanots paths xano/index.ts\` to list every endpoint's verb + path.
+> \`xanots routes xano/index.ts\` to list every endpoint's verb + path.
 
 ## The frontend
 
@@ -450,17 +452,8 @@ kind.
 ### Event-driven objects
 
 A scheduled \`task\`, an \`mcpServer\`, and every trigger **fire normally on an
-ephemeral** \u2014 \`deploy\`'s default destination \u2014 so test them by deploying and
-letting them run.
-
-Under \`--dest sandbox\` they **deploy but do not fire**: they import cleanly, never
-execute, and there's no way to fire one manually (a table insert/update/delete does
-NOT run its trigger). Only synchronously-invoked objects \u2014 queries, functions, and
-the agents an endpoint calls with \`s.ai.agent.run\` \u2014 run there. If you must stay on
-the sandbox, factor the body into a \`defineFunction\` you can also call directly
-(e.g. from a query via \`s.function.run\`) and put the assertions on THAT \u2014 a
-\`tests\` entry on the function, or a \`workflowTest\` that calls it. See
-\`llms.txt\` for the full guidance.
+ephemeral** \u2014 where \`deploy\` sends them \u2014 so test them by deploying and letting
+them run.
 
 ## Wire the frontend
 
@@ -478,15 +471,13 @@ Keep the client bundle lean (**split route metadata from stack-heavy authoring**
   \u2014 drags that whole graph in. For those, don't import the def in the browser:
   declare its \`{ path, verb }\` as plain metadata (see the \`ROUTES\` example in
   \`api.ts\`) and verify it against the compiled bundle with
-  \`npx xanots paths xano/index.ts\`.
+  \`npx xanots routes xano/index.ts\`.
 `;
 }
 function describeOrigin(o) {
   switch (o.source) {
     case "workspace":
       return `workspace ${o.origin}`;
-    case "sandbox":
-      return "the sandbox workspace";
     case "ephemeral":
       return `ephemeral "${o.origin}"`;
     case "file":
@@ -500,7 +491,7 @@ function renderCodegenMarker({ sdkVersion }, origin, generatedAt, report) {
       origin: origin.origin,
       sdkVersion,
       generatedAt,
-      note: "Written by `xanots \u2026 codegen`. Its presence lets a re-run refresh xano/ in place.",
+      note: "Written by `xanots init --from`. Its presence lets a re-run refresh xano/ in place.",
       // The findings, so parity is trackable release over release and gateable
       // in CI without scraping stderr. Omitted rather than written empty when
       // the caller has none to record.
@@ -536,11 +527,11 @@ npm run xano:deploy     # typecheck, build the frontend, ship both
 
 ## Read this before deploying
 
-- **\`xano/\` is disposable.** Re-running \`xanots \u2026 codegen\` on this directory
+- **\`xano/\` is disposable.** Re-running \`xanots init --from\` on this directory
   rewrites it wholesale \u2014 no merge, no diff, no preservation of hand edits. The rest of
   the project (this README, \`package.json\`, \`frontend/\`) is yours and is left alone.
 - **Deploying is a full replace.** The import path clears the target workspace and
-  re-imports. Send this only to an **ephemeral or sandbox** environment \u2014 never to a
+  re-imports. Send this only to an **ephemeral** environment \u2014 never to a
   workspace holding data you care about. That is why \`npm run xano:deploy\` targets an
   ephemeral env and there is no deploy-to-your-real-workspace command.
 - **This is schema only.** Table rows are not carried, and neither are payload sections
@@ -555,7 +546,7 @@ ${secrets}
 npm run dev            # run the starter frontend
 npm run typecheck      # the whole project, both halves
 npm run xano:export    # compile the backend to workspace.json (don't commit it)
-npx xanots paths xano/index.ts   # list every endpoint's verb + path
+npx xanots routes xano/index.ts   # list every endpoint's verb + path
 \`\`\`
 
 [\`frontend/src/lib/api.ts\`](frontend/src/lib/api.ts) shows the one contract: derive
@@ -644,7 +635,7 @@ function codegenLanding({ appName }, origin) {
       ],
       [
         { text: "List the endpoints: " },
-        { code: "npx xanots paths xano/index.ts" },
+        { code: "npx xanots routes xano/index.ts" },
         { text: ", then wire them up in " },
         { code: "frontend/src/lib/api.ts" },
         { text: "." }
@@ -821,7 +812,7 @@ function renderApiTs() {
 //     those s.*/c.* factory calls run at module load and can't be tree-shaken out.
 //   \u2022 For such a stack-heavy endpoint, don't import its def in the browser at all \u2014
 //     declare its { path, verb } in the ROUTES table below and verify it against
-//     the compiled bundle with \`npx xanots paths xano/index.ts\`.
+//     the compiled bundle with \`npx xanots routes xano/index.ts\`.
 //
 // This starter has no endpoints yet. Once you add one in xano/, wire it like:
 //
@@ -847,7 +838,7 @@ function renderApiTs() {
 //   }
 //
 // The stack-heavy escape hatch \u2014 plain metadata, no def import, no bundle cost.
-// Keep it in sync with \`npx xanots paths xano/index.ts\` (it prints verb + path):
+// Keep it in sync with \`npx xanots routes xano/index.ts\` (it prints verb + path):
 //
 //   export const ROUTES = {
 //     triageRequest: { path: "/api:notes/triage_request", verb: "POST" },
@@ -887,4 +878,4 @@ export {
   renderCnUtil,
   renderApiTs
 };
-//# sourceMappingURL=chunk-P5C2YKAM.js.map
+//# sourceMappingURL=chunk-ANUDXFEX.js.map

package/dist/chunk-CTD5ZCV6.js

@@ -0,0 +1,28 @@
+import {
+  UsageError
+} from "./chunk-F6CYJ7TN.js";
+
+// src/emit/env-selector.ts
+var ENV_SPELLINGS = "workspace, ephemeral, or ephemeral:<name>";
+function parseEnvSelector(raw) {
+  if (raw === "workspace") return { kind: "workspace" };
+  if (raw === "ephemeral") return { kind: "ephemeral" };
+  if (raw.startsWith("ephemeral:")) {
+    const name = raw.slice("ephemeral:".length);
+    return name === "" ? void 0 : { kind: "ephemeral", name };
+  }
+  return void 0;
+}
+function unknownEnv(flag, raw, helpFor) {
+  return new UsageError(
+    `${flag} does not take "${raw}". Environments are ${ENV_SPELLINGS} (\`xanots ephemeral list\` shows the names; bare \`ephemeral\` is the one this project last deployed to).`,
+    { helpFor }
+  );
+}
+
+export {
+  ENV_SPELLINGS,
+  parseEnvSelector,
+  unknownEnv
+};
+//# sourceMappingURL=chunk-CTD5ZCV6.js.map

package/dist/{chunk-5HCDZ2XN.js → chunk-DBFU47BJ.js}

@@ -1,7 +1,7 @@
 import {
   deepEqual,
   normalize
-} from "./chunk-ZOYMZZ3S.js";
+} from "./chunk-3INK4Y4E.js";
 
 // src/deploy/live-diff.ts
 function rows(bundle, key) {
@@ -254,4 +254,4 @@ export {
   sharedSchemaChanges,
   compareToLive
 };
-//# sourceMappingURL=chunk-5HCDZ2XN.js.map
+//# sourceMappingURL=chunk-DBFU47BJ.js.map