deepspace 0.11.0 → 0.13.0

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 // src/cli/cli.ts
-import { defineCommand as defineCommand13, runMain, runCommand } from "citty";
+import { defineCommand as defineCommand14, runMain, runCommand, renderUsage } from "citty";
 import { sync as spawnSync8 } from "cross-spawn";
-import { readFileSync as readFileSync28, existsSync as existsSync25 } from "fs";
+import { readFileSync as readFileSync28, existsSync as existsSync26 } from "fs";
 import { dirname as dirname10, join as join24 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
@@ -44,6 +44,13 @@ import * as p2 from "@clack/prompts";
 import { isAbsolute } from "path";
 
 // src/cli/lib/cli-format.ts
+var ANSI_RE = /\[[0-9;]*m/g;
+function stripAnsi(s) {
+  return s.replace(ANSI_RE, "");
+}
+function forTerminal(s) {
+  return process.stdout.isTTY ? s : stripAnsi(s);
+}
 function shQuote(s) {
   return `'${s.replace(/'/g, "'\\''")}'`;
 }
@@ -176,7 +183,10 @@ var API_ERROR_HINTS = {
   test_account_cannot_be_collaborator: "Test accounts cannot be added as collaborators. Use a real DeepSpace account.",
   user_not_found: "No DeepSpace user with that email. They need to log in to DeepSpace at least once (`deepspace auth login`, or sign in to any app) before they can be referenced by email.",
   insufficient_credits: "Out of credits. Inviting a new collaborator by email sends them a transactional email billed to your account \u2014 top up your credits and try again.",
-  invite_email_failed: "The invite email could not be sent. You were not charged \u2014 please try again in a moment."
+  // "Try again" alone sends callers into a loop when the address itself is the
+  // problem — the send is what failed, and an undeliverable address fails the
+  // same way every time.
+  invite_email_failed: "The invite itself was not created and the charge was voided \u2014 nothing to undo. Retrying helps only if the send was transient; check the address is real and deliverable first. An email is needed ONLY for someone with no DeepSpace account yet: an existing user is added instantly, so having them sign in once and re-running this skips email entirely. If a retry now reports `already_invited` with no email sent, cancel the stuck invite (`deepspace app collaborators cancel <email>`) and invite again."
 };
 function formatCliError(err) {
   const message = err instanceof Error ? err.message : String(err);
@@ -222,6 +232,18 @@ function wrapCommandErrors(cmd) {
 }
 
 // src/cli/lib/command-suggestions.ts
+function splitTokenPath(token, table) {
+  const parts = token.trim().split(/\s+/);
+  if (parts.length < 2) return null;
+  let node = table;
+  for (const part of parts) {
+    const next = node?.[part];
+    if (!next) return null;
+    node = next.subCommands;
+  }
+  return parts;
+}
+var DESTRUCTIVE_VERBS = /* @__PURE__ */ new Set(["rm", "delete", "remove", "drop", "clear", "undeploy", "kill"]);
 function editDistance(a, b) {
   const left = a.toLowerCase();
   const right = b.toLowerCase();
@@ -263,12 +285,15 @@ function findUnknownCommand(argv, rootCommands) {
     if (!table || token.startsWith("-")) return null;
     const command = table[token];
     if (!command) {
-      const relativeSuggestion = closestCommandPath(token, table);
+      const split = splitTokenPath(token, table);
+      const relativeSuggestion = split ?? closestCommandPath(token, table);
       if (!relativeSuggestion) return null;
       return {
         attemptedPath: ["deepspace", ...accepted, token],
         helpPath: ["deepspace", ...accepted],
-        suggestion: ["deepspace", ...accepted, ...relativeSuggestion]
+        suggestion: ["deepspace", ...accepted, ...relativeSuggestion],
+        executable: !DESTRUCTIVE_VERBS.has(relativeSuggestion.at(-1) ?? ""),
+        ...split ? { quotedToken: true } : {}
       };
     }
     accepted.push(token);
@@ -709,7 +734,7 @@ async function provisionProfile(jwt) {
   }
 }
 function sleep(ms) {
-  return new Promise((resolve18) => setTimeout(resolve18, ms));
+  return new Promise((resolve19) => setTimeout(resolve19, ms));
 }
 function base64url(bytes) {
   return bytes.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
@@ -929,6 +954,7 @@ import { dirname as dirname2, join as join5, resolve as resolve3 } from "path";
 // src/cli/lib/git/process.ts
 import { sync as spawnSync } from "cross-spawn";
 var MAX_GIT_BUFFER = 512 * 1024 * 1024;
+var GIT_TIMEOUT_MS = 3e5;
 var GitError = class extends Error {
   constructor(message, code) {
     super(message);
@@ -937,10 +963,16 @@ var GitError = class extends Error {
   }
 };
 function runGit(cwd, args, opts = {}) {
+  const timeout = opts.timeoutMs ?? GIT_TIMEOUT_MS;
   const result = spawnSync("git", args, {
     cwd,
     input: opts.input,
     maxBuffer: MAX_GIT_BUFFER,
+    timeout,
+    // SIGKILL, not the default SIGTERM: a child that ignores or traps TERM
+    // would otherwise keep running for its full duration and the "timeout"
+    // would bound nothing.
+    killSignal: "SIGKILL",
     stdio: ["pipe", "pipe", "pipe"],
     env: {
       ...process.env,
@@ -949,6 +981,12 @@ function runGit(cwd, args, opts = {}) {
       ...opts.env ?? {}
     }
   });
+  if (result.error?.code === "ETIMEDOUT") {
+    throw new GitError(
+      `git ${args[0]} did not finish within ${Math.round(timeout / 1e3)}s and was stopped. If this was a push, the history is probably too large to transfer \u2014 see \`deepspace push\` for the size limits; otherwise retry, and report it with \`deepspace feedback\` if it persists.`,
+      "git_timeout"
+    );
+  }
   if (result.error) {
     const code = result.error.code;
     if (code === "ENOENT") {
@@ -2531,16 +2569,31 @@ function formatSchemaLintFindings(findings) {
 }
 
 // src/cli/lib/port.ts
-import { createServer } from "net";
+import { createServer, Socket } from "net";
 var DEFAULT_PORT = 5173;
-function checkPortAvailable(port, host = "0.0.0.0") {
-  return new Promise((resolve18) => {
-    const srv = createServer();
-    srv.once("error", () => resolve18(false));
-    srv.once("listening", () => srv.close(() => resolve18(true)));
-    srv.listen(port, host);
+function isPortListening(port, host, timeoutMs = 500) {
+  const target2 = host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host;
+  return new Promise((resolve19) => {
+    const socket = new Socket();
+    const done = (listening) => {
+      socket.destroy();
+      resolve19(listening);
+    };
+    socket.setTimeout(timeoutMs);
+    socket.once("connect", () => done(true));
+    socket.once("timeout", () => done(false));
+    socket.once("error", () => done(false));
+    socket.connect(port, target2);
   });
 }
+async function waitForPortListening(port, host, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await isPortListening(port, host)) return true;
+    await new Promise((resolve19) => setTimeout(resolve19, 250));
+  }
+  return false;
+}
 function resolvePort(arg) {
   const raw = arg ?? process.env.DEEPSPACE_PORT;
   if (!raw) return DEFAULT_PORT;
@@ -2552,6 +2605,8 @@ function resolvePort(arg) {
 }
 
 // src/cli/commands/dev.ts
+var DEFAULT_DEV_HOST = "0.0.0.0";
+var READINESS_TIMEOUT_MS = 12e4;
 var DEPLOY_URL = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 function noAppDirMessage(start, children) {
   const lines = [`No wrangler.toml found at or above ${start}.`];
@@ -2587,6 +2642,11 @@ var dev_default = defineDeepspaceCommand({
       type: "string",
       description: `Port to bind (default ${DEFAULT_PORT}, or $DEEPSPACE_PORT)`,
       required: false
+    },
+    host: {
+      type: "string",
+      description: `Interface to bind (default ${DEFAULT_DEV_HOST} \u2014 reachable from outside a container)`,
+      required: false
     }
   },
   async run({ args }) {
@@ -2595,6 +2655,7 @@ var dev_default = defineDeepspaceCommand({
     };
     preflightNodeVersion("dev start");
     const wranglerEnv = typeof args.env === "string" && args.env.trim() ? args.env.trim() : void 0;
+    const host = typeof args.host === "string" && args.host.trim() ? args.host.trim() : DEFAULT_DEV_HOST;
     const start = resolve7(args.dir ?? ".");
     const appDir = findAppDir(start);
     if (!appDir) {
@@ -2658,6 +2719,7 @@ var dev_default = defineDeepspaceCommand({
     say(`Logged in as ${payload.name ?? payload.email}`);
     if (wranglerEnv) say(`Wrangler env: ${wranglerEnv}`);
     say(`Port: ${port}`);
+    if (host !== DEFAULT_DEV_HOST) say(`Host: ${host}`);
     let generatedSecretsCache;
     const appIdForSecrets = readAppId(appDir, wranglerEnv);
     if (appIdForSecrets) {
@@ -2685,7 +2747,7 @@ var dev_default = defineDeepspaceCommand({
       { sharedDevVarsCache }
     );
     preflightWindowsWorkerd(appDir);
-    if (!await checkPortAvailable(port)) {
+    if (await isPortListening(port, host)) {
       const killArgv = port === DEFAULT_PORT ? ["deepspace", "dev", "kill"] : ["deepspace", "dev", "kill", "--port", String(port)];
       const killCmd = killArgv.join(" ");
       wranglerConfig.cleanup();
@@ -2696,12 +2758,34 @@ Free it with \`${killCmd}\`, or start on another port: \`deepspace dev start --p
         { extra: { port } }
       );
     }
+    const url = `http://${host === DEFAULT_DEV_HOST ? "localhost" : host}:${port}`;
     say("Starting dev server...\n");
-    const vite = spawn("npx", ["vite", "--port", String(port), "--strictPort", "--host"], {
-      cwd: appDir,
-      stdio: "inherit",
-      env: wranglerViteEnv(process.env, wranglerConfig, { DEEPSPACE_PORT: String(port) })
-    });
+    const vite = spawn(
+      "npx",
+      ["vite", "--port", String(port), "--strictPort", "--host", host],
+      {
+        cwd: appDir,
+        stdio: "inherit",
+        env: wranglerViteEnv(process.env, wranglerConfig, { DEEPSPACE_PORT: String(port) })
+      }
+    );
+    if (args.json) {
+      void waitForPortListening(port, host, READINESS_TIMEOUT_MS).then((ready) => {
+        console.log(
+          JSON.stringify(
+            ready ? { ok: true, ready: true, url, port, host, appDir } : {
+              ok: false,
+              code: "dev_server_not_ready",
+              error: `The dev server did not answer on ${url} within ${READINESS_TIMEOUT_MS / 1e3}s.`,
+              url,
+              port,
+              host,
+              appDir
+            }
+          )
+        );
+      });
+    }
     let stopping = false;
     const stop = () => {
       stopping = true;
@@ -2723,7 +2807,7 @@ Free it with \`${killCmd}\`, or start on another port: \`deepspace dev start --p
         extra: { port, appDir, exitCode: code }
       });
     }
-    return { data: { port, appDir, wranglerEnv: wranglerEnv ?? null } };
+    return { data: { port, host, url, appDir, wranglerEnv: wranglerEnv ?? null } };
   }
 });
 
@@ -3679,8 +3763,8 @@ var clear = defineDeepspaceCommand({
         failures.push({ email: a.email, error: err.message });
       }
     }
-    const deleted = targets.filter((target) => !failures.some((failure) => failure.email === target.email));
-    removeTestAccounts(deleted.map((target) => target.id), deleted.map((target) => target.email));
+    const deleted = targets.filter((target2) => !failures.some((failure) => failure.email === target2.email));
+    removeTestAccounts(deleted.map((target2) => target2.id), deleted.map((target2) => target2.email));
     if (failures.length > 0) {
       throw new Refusal(
         `Deleted ${ok2}/${targets.length} test account(s).
@@ -3712,6 +3796,96 @@ import * as p12 from "@clack/prompts";
 import { defineCommand as defineCommand3 } from "citty";
 import { resolve as resolve12 } from "path";
 
+// src/cli/lib/edge-propagation.ts
+var NOT_SERVING = ["Assets have not yet deployed", "No app configured"];
+async function waitForEdgePropagation(url, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  let attempt = 0;
+  let streak = 0;
+  while (Date.now() < deadline) {
+    attempt++;
+    try {
+      const response = await fetch(url, { redirect: "manual" });
+      const body = await response.text();
+      if (!NOT_SERVING.some((marker) => body.includes(marker))) {
+        streak++;
+        if (streak >= 3) return true;
+        await new Promise((resolve19) => setTimeout(resolve19, 1500));
+        continue;
+      }
+      streak = 0;
+    } catch {
+      streak = 0;
+    }
+    const waitMs = Math.min(8e3, 1e3 * 2 ** (attempt - 1));
+    await new Promise((resolve19) => setTimeout(resolve19, waitMs));
+  }
+  return false;
+}
+
+// src/shared/app-files.ts
+var MAX_APP_FILE_BYTES = 1024 * 1024 * 1024;
+var MAX_UPLOAD_REQUEST_BYTES = 25 * 1024 * 1024;
+var UPLOAD_PART_BYTES = 20 * 1024 * 1024;
+var MAX_UPLOAD_PARTS = Math.ceil(MAX_APP_FILE_BYTES / UPLOAD_PART_BYTES);
+var MAX_BASE64_UPLOAD_BYTES = Math.floor(MAX_UPLOAD_REQUEST_BYTES * 3 / 4);
+function planUploadParts(totalBytes, partSize) {
+  const parts = [];
+  for (let start = 0; start < totalBytes; start += partSize) {
+    parts.push({
+      partNumber: parts.length + 1,
+      start,
+      end: Math.min(start + partSize, totalBytes)
+    });
+  }
+  return parts;
+}
+var MAX_DEPLOY_ASSET_FILE_BYTES = 25 * 1024 * 1024;
+var DANGEROUS_MIME_TYPES = /* @__PURE__ */ new Set([
+  "text/html",
+  "application/xhtml+xml",
+  "image/svg+xml",
+  "application/xml",
+  "text/xml",
+  "application/javascript",
+  "text/javascript",
+  "application/ecmascript",
+  "text/ecmascript"
+]);
+function activeContentMessage(mimeType) {
+  return `${mimeType} is not accepted: the files API serves your app's own origin, so stored HTML/SVG/JavaScript would execute there with your users' sessions. Ship it as a build asset under \`public/\` instead, where it is served as part of your app rather than as user-uploaded content.`;
+}
+function formatBytes(bytes) {
+  if (bytes >= 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GiB`;
+  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+  if (bytes >= 1024) return `${Math.round(bytes / 1024)} KiB`;
+  return `${bytes} B`;
+}
+function encodeKeyPath(key) {
+  return key.split("/").map(encodeURIComponent).join("/");
+}
+function oversizeMessage(bytes, limit = MAX_APP_FILE_BYTES) {
+  return `That file is ${formatBytes(bytes)}; the limit is ${formatBytes(limit)} per file.`;
+}
+function describeFilesFailure(status3, body) {
+  const trimmed = body.trim();
+  if (trimmed.startsWith("{")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (parsed.error) return parsed.error;
+    } catch {
+    }
+  }
+  if (status3 === 413) {
+    return `The upload is too large. Files are limited to ${formatBytes(MAX_APP_FILE_BYTES)}, and one request may carry ${formatBytes(MAX_UPLOAD_REQUEST_BYTES)} \u2014 a larger request is rejected by the network before the app receives it.`;
+  }
+  if (status3 === 411) return "The upload did not declare its length.";
+  if (status3 === 401 || status3 === 403) return "Not authorized to write these files.";
+  if (status3 === 415) return "That file type is not accepted.";
+  if (status3 >= 500) return `The files service failed (HTTP ${status3}). Retry shortly.`;
+  return `Upload failed (HTTP ${status3}).`;
+}
+
 // src/cli/commands/deploy/build.ts
 import * as p6 from "@clack/prompts";
 import { execSync as execSync2 } from "child_process";
@@ -4031,7 +4205,14 @@ var RESERVED_RUN_WORKER_FIRST = /* @__PURE__ */ new Set([
   "/_documentation",
   "/_documentation/*",
   "/_documentation-root",
-  "/_documentation-root/*"
+  "/_documentation-root/*",
+  // Agent-protocol paths: the worker must see them so they cannot fall through
+  // to the SPA shell (templates/base/src/server/http-routes.ts reserves them).
+  "/llms.txt",
+  "/llms-full.txt",
+  "/.well-known/mcp",
+  "/.well-known/mcp.json",
+  "/.well-known/mcp/*"
 ]);
 async function buildDeployBundle(options) {
   const { appDir, appName, envName, sharedDevVarsCache, output, spinner: spinner2 } = options;
@@ -4165,6 +4346,12 @@ function resolveDeployRunWorkerFirst(config) {
   const routes = extractRunWorkerFirst(config);
   return routes;
 }
+function oversizedAssetRefusal(assets) {
+  const tooBig = assets.find((asset) => asset.size > MAX_DEPLOY_ASSET_FILE_BYTES);
+  if (!tooBig) return null;
+  return `${tooBig.path} is ${formatBytes(tooBig.size)}; the per-file limit for deploy assets is ${formatBytes(MAX_DEPLOY_ASSET_FILE_BYTES)}. ${LARGE_MEDIA_HOME}`;
+}
+var LARGE_MEDIA_HOME = "Large media belongs in your app files (`deepspace app files put`), not in the deploy bundle \u2014 move it out of `public/` and reference it at runtime.";
 function collectAssets(dir) {
   const assets = [];
   const walk = (currentDir, prefix) => {
@@ -4821,7 +5008,7 @@ function isThinPackRejection(result) {
 function isRecoverablePushFailure(status3) {
   return status3 === "non_fast_forward" || status3 === "ref_conflict";
 }
-function classifyPushTransportFailure(error) {
+function classifyPushTransportFailure(error, cwd) {
   const message = error instanceof Error ? error.message : String(error);
   if (/(?:HTTP |error: )409\b/i.test(message)) {
     return {
@@ -4841,6 +5028,9 @@ function classifyPushTransportFailure(error) {
       error: "The cloud repo rate-limited this push. Wait a few seconds, then retry."
     };
   }
+  if (/(?:HTTP |error: )413\b/i.test(message)) {
+    return { code: "push_too_large", error: pushTooLargeMessage(cwd) };
+  }
   return null;
 }
 function pushToSpace(cwd, token, refspec, opts = {}) {
@@ -4865,18 +5055,29 @@ function pushToSpace(cwd, token, refspec, opts = {}) {
 }
 var OVERSIZED_PUSH_RE = /too large|exceeds|\bLFS\b/i;
 var SERVER_OBJECT_CAP_BYTES = 20 * 1024 * 1024;
-var OVERSIZED_PUSH_FIX = `Find the offending object with \`git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectsize) %(rest)' | sort -k2 -n | tail\`, then .gitignore it (or move it to Git LFS) and re-commit.`;
-function formatBytes(bytes) {
-  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
-  if (bytes >= 1024) return `${Math.round(bytes / 1024)} KiB`;
-  return `${bytes} B`;
-}
-function oversizedPushFix(cwd, cap = SERVER_OBJECT_CAP_BYTES) {
-  const objects = cwd ? findOversizedObjects(cwd, cap) : [];
-  if (objects.length === 0) return OVERSIZED_PUSH_FIX;
+var SERVER_PACK_CAP_BYTES = 32 * 1024 * 1024;
+var PUSH_CEILINGS = `${formatBytes(SERVER_OBJECT_CAP_BYTES)} per file, ${formatBytes(SERVER_PACK_CAP_BYTES)} per push`;
+var OVERSIZED_PUSH_FIX = `Find the offending object with \`git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectsize) %(rest)' | sort -k2 -n | tail\`.`;
+function removeFromHistoryAdvice(path) {
+  const file = path ? shQuote(path) : "<file>";
+  return `Media belongs in the app's files rather than Git history \u2014 \`deepspace app files put ${file}\` stores it in the app's own allocation and serves it over HTTP. Then get it out of both the push and the bundle, in this order: (1) move it OUT of \`public/\` \u2014 .gitignore keeps it out of Git but not out of the deploy bundle, which uploads every file under \`public/\`; (2) if the commits that carry it are still local, \`git reset --soft <last pushed commit>\`, then \`git restore --staged ${file}\` \u2014 reset --soft moves HEAD only and leaves the file staged, so skipping this step re-commits the same blob; (3) commit what remains, then push \u2014 if git says "nothing to commit", that commit held only the file, so skip straight to the push and "Everything up-to-date" means you are done. If it already reached pushed history, rewrite it out instead (\`git filter-repo --path ${file} --invert-paths\`).`;
+}
+function fixForObjects(objects) {
+  if (objects.length === 0) return `${OVERSIZED_PUSH_FIX} ${removeFromHistoryAdvice(null)}`;
   const one = objects.length === 1;
   const named = objects.map((object) => `${object.path} (${formatBytes(object.bytes)})`).join(", ");
-  return `The oversized ${one ? "file is" : "files are"} ${named}. Remove ${one ? "it" : "them"} from history (\`git rm --cached ${one ? shQuote(objects[0].path) : "<path>"}\`, add to .gitignore, re-commit) or track ${one ? "it" : "them"} with Git LFS.`;
+  return `The oversized ${one ? "file is" : "files are"} ${named}. ${removeFromHistoryAdvice(one ? objects[0].path : null)}`;
+}
+function oversizedPushFix(cwd, cap = SERVER_OBJECT_CAP_BYTES) {
+  return fixForObjects(cwd ? findOversizedObjects(cwd, cap) : []);
+}
+function pushTooLargeMessage(cwd) {
+  const ceilings = `The cloud repo refused this push as too large (HTTP 413). The ceilings are ${formatBytes(SERVER_OBJECT_CAP_BYTES)} per file and ${formatBytes(SERVER_PACK_CAP_BYTES)} of compressed history per push. Large media never compresses, so every clone would pay for it forever.`;
+  const objects = cwd ? findOversizedObjects(cwd, SERVER_OBJECT_CAP_BYTES) : [];
+  if (objects.length === 0) {
+    return `${ceilings} No single file is over the per-file cap, so this is the volume of history \u2014 push it in smaller batches (\`git push space <earlier-commit>:refs/heads/<branch>\` first, then the rest). ${OVERSIZED_PUSH_FIX}`;
+  }
+  return `${ceilings} ${fixForObjects(objects)}`;
 }
 function pushFailureMessage(label, push, cwd) {
   const reason = push.reason ?? push.summary ?? "";
@@ -4966,7 +5167,7 @@ function remotePublicRefs(cwd, remote) {
 function remoteBranchOid(cwd, remote, branch) {
   return remotePublicRefs(cwd, remote).find((ref) => ref.name === `refs/heads/${branch}`)?.oid ?? null;
 }
-function localTransferRefs(cwd, prefix, target) {
+function localTransferRefs(cwd, prefix, target2) {
   const output = runGit(cwd, [
     "for-each-ref",
     "--format=%(refname) %(objectname)",
@@ -4974,7 +5175,7 @@ function localTransferRefs(cwd, prefix, target) {
   ]).stdout.toString("utf-8");
   return output.split("\n").map((line) => line.trim()).filter(Boolean).map((line) => {
     const [name, oid] = line.split(/\s+/, 2);
-    return { name: `${target}/${name.slice(`${prefix}/`.length)}`, oid };
+    return { name: `${target2}/${name.slice(`${prefix}/`.length)}`, oid };
   }).filter((ref) => /^[0-9a-f]{40}$/.test(ref.oid));
 }
 
@@ -5087,7 +5288,7 @@ async function syncDeployRepository(options) {
         }
       } else if (pushResult.status === "rejected") {
         output.die(
-          `Cloud repo rejected ${branch}${pushResult.reason ? `: ${pushResult.reason}` : ""}. Resolve the rejection and publish the commit before deploying.`,
+          `${pushFailureMessage("Cloud repo push", pushResult, appDir)} Publish the commit before deploying.`,
           "vc_push_rejected"
         );
       } else {
@@ -5131,7 +5332,7 @@ async function syncDeployRepository(options) {
       sourceRevision = claimed.revision;
     }
   } catch (error) {
-    const failure = deployRepositoryFailure(error);
+    const failure = deployRepositoryFailure(error, appDir);
     output.die(failure.error, failure.code);
   }
   return { commitOid, recoverable, deployKey, source, sourceRevision, baseReleaseId };
@@ -5158,8 +5359,8 @@ function classifyRemoteState(appDir, token, branch, localTip, remote) {
 function errorMessage3(error) {
   return error instanceof Error ? error.message : String(error);
 }
-function deployRepositoryFailure(error) {
-  const transportFailure = classifyPushTransportFailure(error);
+function deployRepositoryFailure(error, cwd) {
+  const transportFailure = classifyPushTransportFailure(error, cwd);
   if (transportFailure) return transportFailure;
   const code = errorCode(error);
   const message = errorMessage3(error);
@@ -5169,15 +5370,18 @@ function deployRepositoryFailure(error) {
     error: `Version-control sync failed: ${message}`
   };
 }
+var PUSH_RETRY_BUDGET_MS = 12e4;
 async function pushWithTransientRetry(push) {
   const backoffMs = [500, 1500, 3500];
+  const deadline = Date.now() + PUSH_RETRY_BUDGET_MS;
   for (let attempt = 0; ; attempt++) {
     try {
       return push();
     } catch (error) {
       const message = errorMessage3(error);
-      if (/(?:HTTP |error: )(?:429|503)\b/i.test(message) && attempt < backoffMs.length) {
-        await new Promise((resolve18) => setTimeout(resolve18, backoffMs[attempt]));
+      const transient = /(?:HTTP |error: )(?:429|503)\b/i.test(message);
+      if (transient && attempt < backoffMs.length && Date.now() + backoffMs[attempt] < deadline) {
+        await new Promise((resolve19) => setTimeout(resolve19, backoffMs[attempt]));
         continue;
       }
       throw error;
@@ -5342,7 +5546,7 @@ async function deployBuiltBundle(options) {
     );
   }
   if (body.onBehalfOfOwner) {
-    p10.log.warn(`Deployed on behalf of owner ${body.onBehalfOfOwner}`);
+    p10.log.warn("This release is attributed to the app's owner, not to your account.");
   }
   if (body.staleBaseGuard === "skipped") {
     p10.log.warn(
@@ -5423,10 +5627,11 @@ async function uploadDeployAssets(options) {
     p10.log.info(`Assets: ${byHash.size} file(s), all already uploaded`);
     return;
   }
-  const missingBytes = missing.reduce((total, asset) => total + asset.size, 0);
+  const missingBytes = missing.reduce((total2, asset) => total2 + asset.size, 0);
   p10.log.info(
     `Assets: ${byHash.size} file(s), uploading ${missing.length} (${Math.ceil(missingBytes / 1024)} KiB); the rest are already stored`
   );
+  const total = missing.length;
   let uploaded = 0;
   const next = () => missing.pop();
   const worker = async () => {
@@ -5455,7 +5660,7 @@ async function uploadDeployAssets(options) {
         );
       }
       uploaded++;
-      spinner2.message(`Uploading assets \u2014 ${uploaded}/${uploaded + missing.length}...`);
+      spinner2.message(`Uploading assets \u2014 ${uploaded}/${total}...`);
     }
   };
   try {
@@ -5521,7 +5726,7 @@ async function postWithRetry(url, makeInit, {
       lastError = error;
     }
     if (attempt < attempts) {
-      await new Promise((resolve18) => setTimeout(resolve18, Math.min(8e3, 500 * 2 ** (attempt - 1))));
+      await new Promise((resolve19) => setTimeout(resolve19, Math.min(8e3, 500 * 2 ** (attempt - 1))));
     }
   }
   if (lastResponse) return lastResponse;
@@ -5686,7 +5891,11 @@ var DEPLOY_URL3 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 var deploy_default = defineCommand3({
   meta: {
     name: "deploy",
-    description: "Build and deploy your DeepSpace app"
+    // The per-file ceiling belongs in --help: it was previously discoverable
+    // only by hitting it, after the build and the push had already run. The
+    // per-deploy total is deliberately absent — it is env-configurable, so any
+    // number stated here would be wrong for some environment.
+    description: `Build and deploy your DeepSpace app (assets: ${formatBytes(MAX_DEPLOY_ASSET_FILE_BYTES)} per file)`
   },
   args: {
     dir: {
@@ -5782,6 +5991,20 @@ var deploy_default = defineCommand3({
       output
     });
     const sourceState = await getAppSource(DEPLOY_URL3, token, appId);
+    const spinner2 = createSpinner();
+    const bundle = await buildDeployBundle({
+      appDir,
+      appName,
+      envName,
+      sharedDevVarsCache: secretsCache.linked !== null,
+      output,
+      spinner: spinner2
+    });
+    const oversized = oversizedAssetRefusal(bundle.assets);
+    if (oversized) {
+      spinner2.stop("Deploy failed");
+      output.die(oversized, "assets_too_large");
+    }
     const repository = await syncDeployRepository({
       deployUrl: DEPLOY_URL3,
       appDir,
@@ -5792,15 +6015,6 @@ var deploy_default = defineCommand3({
       output,
       sourceState
     });
-    const spinner2 = createSpinner();
-    const bundle = await buildDeployBundle({
-      appDir,
-      appName,
-      envName,
-      sharedDevVarsCache: secretsCache.linked !== null,
-      output,
-      spinner: spinner2
-    });
     const secrets = prepareDeploySecrets({
       appDir,
       envName,
@@ -5826,7 +6040,7 @@ var deploy_default = defineCommand3({
     });
     if (body.url) {
       spinner2.message("Waiting for edge propagation...");
-      const ready = await waitForAssetsReady(body.url, 9e4);
+      const ready = await waitForEdgePropagation(body.url, 9e4);
       if (!ready) {
         spinner2.stop("Deployed (edge propagation still in progress after 90s)");
         p12.log.warn(
@@ -5891,30 +6105,6 @@ function blankSelectorRefusal(args) {
 function staleBaseGuardFields(body) {
   return body.staleBaseGuard === "skipped" ? { staleBaseGuard: "skipped" } : {};
 }
-async function waitForAssetsReady(url, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  let attempt = 0;
-  let streak = 0;
-  while (Date.now() < deadline) {
-    attempt++;
-    try {
-      const response = await fetch(url, { redirect: "manual" });
-      const body = await response.text();
-      if (!body.includes("Assets have not yet deployed") && !body.includes("No app configured")) {
-        streak++;
-        if (streak >= 3) return true;
-        await new Promise((resolve18) => setTimeout(resolve18, 1500));
-        continue;
-      }
-      streak = 0;
-    } catch {
-      streak = 0;
-    }
-    const waitMs = Math.min(8e3, 1e3 * 2 ** (attempt - 1));
-    await new Promise((resolve18) => setTimeout(resolve18, waitMs));
-  }
-  return false;
-}
 function errorMessage6(error) {
   return error instanceof Error ? error.message : String(error);
 }
@@ -5954,6 +6144,19 @@ function requireAppIdArg(explicit) {
   }
   return id;
 }
+function liveAppUrl(app2) {
+  return app2.status === "active" && app2.deployedAt !== null ? app2.url : null;
+}
+async function listApps(deployUrl, token) {
+  const { apps } = await apiFetch(deployUrl, token, "/api/apps");
+  if (!Array.isArray(apps)) {
+    throw new InputError(
+      `The deploy service at ${deployUrl} returned an unexpected response shape for the app list \u2014 check DEEPSPACE_DEPLOY_URL (is this the service the app lives on?).`,
+      "invalid_response"
+    );
+  }
+  return apps;
+}
 function matchAppSelector(apps, selector) {
   const byId = apps.find((app2) => app2.appId === selector);
   if (byId) return byId.appId;
@@ -5963,14 +6166,7 @@ function matchAppSelector(apps, selector) {
 }
 async function resolveAppSelector(deployUrl, token, selector) {
   if (STRICT_APP_ID_RE.test(selector)) return selector;
-  const { apps } = await apiFetch(deployUrl, token, "/api/apps");
-  if (!Array.isArray(apps)) {
-    throw new InputError(
-      `The deploy service at ${deployUrl} returned an unexpected response shape for the app list \u2014 check DEEPSPACE_DEPLOY_URL (is this the service the app lives on?).`,
-      "invalid_response"
-    );
-  }
-  const id = matchAppSelector(apps, selector);
+  const id = matchAppSelector(await listApps(deployUrl, token), selector);
   if (id) return id;
   const shared = await resolveAppIdByName(deployUrl, token, selector);
   if (shared) return shared;
@@ -6053,7 +6249,7 @@ function assertAppTargetResolvable(appArg, options = {}) {
 async function warnIfPhantomApp(deployUrl, token, appId, explicit) {
   if (!explicit || !STRICT_APP_ID_RE.test(explicit.trim())) return;
   try {
-    const { apps } = await apiFetch(deployUrl, token, "/api/apps");
+    const apps = await listApps(deployUrl, token);
     if (!apps.some((app2) => app2.appId === appId)) {
       process.stderr.write(
         `warning: ${appId} is not among your apps. If it exists and you have access (collaborator/admin), the server will use it; if it doesn't exist, this will register it as a NEW app under your account \u2014 check the id if that's not what you meant (a subdomain name also works with -a).
@@ -6167,7 +6363,6 @@ var whoami_default = defineDeepspaceCommand({
     if (!args.json) {
       console.log(`Name:       ${payload.name ?? "(none)"}`);
       console.log(`Email:      ${payload.email ?? "(none)"}`);
-      console.log(`UserID:     ${payload.sub ?? "(none)"}`);
       console.log(`Type:       ${accountType}`);
       if (payload.iss) console.log(`Issuer:     ${payload.iss}`);
       console.log(`Dashboard:  ${DASHBOARD_URL}`);
@@ -6199,7 +6394,7 @@ var apps_default = defineDeepspaceCommand({
   },
   async run({ args }) {
     const token = await ensureToken();
-    const { apps } = await apiFetch(DEPLOY_URL5, token, "/api/apps");
+    const apps = await listApps(DEPLOY_URL5, token);
     if (!args.json) {
       if (!apps.length) {
         console.log("No apps yet. Create one with `npx create-deepspace <name>` and `deepspace deploy`.");
@@ -6207,16 +6402,18 @@ var apps_default = defineDeepspaceCommand({
         const rows = [...apps].sort(
           (left, right) => Number(right.status !== "undeployed") - Number(left.status !== "undeployed")
         );
+        const roleOf = (a) => a.role ?? "owner";
+        const roleWidth = Math.max(4, ...rows.map((a) => roleOf(a).length));
         const nameWidth = Math.max(4, ...rows.map((a) => (a.name ?? "\u2014").length));
         const statusWidth = Math.max(6, ...rows.map((a) => a.status.length));
         const idWidth = Math.max(6, ...rows.map((a) => a.appId.length));
         console.log(
-          `${"NAME".padEnd(nameWidth)}  ${"STATUS".padEnd(statusWidth)}  ${"APP ID".padEnd(idWidth)}  URL`
+          `${"NAME".padEnd(nameWidth)}  ${"STATUS".padEnd(statusWidth)}  ${"ROLE".padEnd(roleWidth)}  ${"APP ID".padEnd(idWidth)}  URL`
         );
         for (const a of rows) {
-          const url = a.url ?? "(not deployed)";
+          const url = liveAppUrl(a) ?? "(not deployed)";
           console.log(
-            `${(a.name ?? "\u2014").padEnd(nameWidth)}  ${a.status.padEnd(statusWidth)}  ${a.appId.padEnd(idWidth)}  ${url}`
+            `${(a.name ?? "\u2014").padEnd(nameWidth)}  ${a.status.padEnd(statusWidth)}  ${roleOf(a).padEnd(roleWidth)}  ${a.appId.padEnd(idWidth)}  ${url}`
           );
         }
       }
@@ -7621,11 +7818,11 @@ function fmtDate(iso) {
 }
 async function confirm4(message) {
   process.stdout.write(`${message} [y/N] `);
-  return new Promise((resolve18) => {
+  return new Promise((resolve19) => {
     process.stdin.setEncoding("utf-8");
     process.stdin.once("data", (data) => {
       const answer = data.toString().trim().toLowerCase();
-      resolve18(answer === "y" || answer === "yes");
+      resolve19(answer === "y" || answer === "yes");
     });
   });
 }
@@ -7913,8 +8110,401 @@ var domain_default = defineCommand5({
   subCommands: { search, buy, list: list2, status, attach, detach, renew }
 });
 
-// src/cli/commands/collaborators.ts
+// src/cli/commands/app-files.ts
 import { defineCommand as defineCommand6 } from "citty";
+import { basename as basename4, resolve as resolve15 } from "path";
+import { existsSync as existsSync21, statSync as statSync2 } from "fs";
+
+// src/cli/lib/app-files-api.ts
+import { createWriteStream, openAsBlob, statSync } from "fs";
+import { basename as basename3, extname } from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+import { randomUUID as randomUUID2 } from "crypto";
+var CONTENT_TYPES = {
+  ".avif": "image/avif",
+  ".css": "text/css",
+  ".csv": "text/csv",
+  ".gif": "image/gif",
+  ".htm": "text/html",
+  ".html": "text/html",
+  ".ico": "image/x-icon",
+  ".jpeg": "image/jpeg",
+  ".jpg": "image/jpeg",
+  ".js": "text/javascript",
+  ".json": "application/json",
+  ".md": "text/markdown",
+  ".mjs": "text/javascript",
+  ".svg": "image/svg+xml",
+  ".mp3": "audio/mpeg",
+  ".mp4": "video/mp4",
+  ".otf": "font/otf",
+  ".pdf": "application/pdf",
+  ".png": "image/png",
+  ".txt": "text/plain",
+  ".wasm": "application/wasm",
+  ".wav": "audio/wav",
+  ".webm": "video/webm",
+  ".webp": "image/webp",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".zip": "application/zip"
+};
+function contentTypeFor(path) {
+  return CONTENT_TYPES[extname(path).toLowerCase()] ?? "application/octet-stream";
+}
+function filesPath(appId, rest = "") {
+  return `/api/app-files/${appId}${rest}`;
+}
+async function request(baseUrl, token, path, init = {}) {
+  let res;
+  try {
+    res = await fetch(`${baseUrl}${path}`, {
+      ...init,
+      headers: { Authorization: `Bearer ${token}`, ...init.headers ?? {} }
+    });
+  } catch (err) {
+    throw new ApiError(
+      `Could not reach the DeepSpace platform at ${baseUrl}: ${err instanceof Error ? err.message : String(err)}. Check your connection (and DEEPSPACE_PLATFORM_URL), then retry.`,
+      0,
+      "network_error",
+      path
+    );
+  }
+  if (res.ok) return res;
+  const text2 = await res.text();
+  let code;
+  try {
+    code = JSON.parse(text2.trim()).code;
+  } catch {
+  }
+  throw new ApiError(
+    describeFilesFailure(res.status, text2),
+    res.status,
+    // Same slug the worker emits for the same condition — the edge cutting an
+    // oversized request short is not a different failure from the worker
+    // refusing it, and two codes made it look like one.
+    code ?? (res.status === 413 ? "too_large" : res.status >= 500 ? "server_error" : "http_error"),
+    path
+  );
+}
+async function readJson(res, path) {
+  const text2 = await res.text();
+  try {
+    return JSON.parse(text2);
+  } catch {
+    throw new ApiError(
+      `The DeepSpace platform returned a malformed (non-JSON) response.`,
+      res.status,
+      "invalid_response",
+      path
+    );
+  }
+}
+async function multipartBody(localPath, fileName, contentType) {
+  const boundary = `----deepspace${randomUUID2().replace(/-/g, "")}`;
+  const safeName = fileName.replace(/["\\\r\n]/g, "_");
+  const head = `--${boundary}\r
+Content-Disposition: form-data; name="file"; filename="${safeName}"\r
+Content-Type: ${contentType}\r
+\r
+`;
+  const file = await openAsBlob(localPath, { type: contentType });
+  return {
+    blob: new Blob([head, file, `\r
+--${boundary}--\r
+`]),
+    contentType: `multipart/form-data; boundary=${boundary}`
+  };
+}
+async function uploadAppFile(baseUrl, token, appId, localPath, key, onProgress) {
+  const path = filesPath(appId, `/upload?key=${encodeKeyPath(key)}`);
+  const size = statSync(localPath).size;
+  if (size > MAX_APP_FILE_BYTES) {
+    throw new ApiError(oversizeMessage(size), 0, "too_large", path);
+  }
+  const declaredType = contentTypeFor(localPath);
+  if (DANGEROUS_MIME_TYPES.has(declaredType)) {
+    throw new ApiError(activeContentMessage(declaredType), 0, "active_content", path);
+  }
+  if (size > UPLOAD_PART_BYTES) {
+    return uploadInParts(baseUrl, token, appId, localPath, key, size, onProgress);
+  }
+  const { blob, contentType } = await multipartBody(localPath, basename3(localPath), declaredType);
+  const res = await request(baseUrl, token, path, {
+    method: "POST",
+    headers: { "Content-Type": contentType },
+    body: blob
+  });
+  const body = await readJson(res, path);
+  onProgress?.(size, size, 1, 1);
+  return { key: body.key, name: body.name, size, parts: 1 };
+}
+function isRetryable(err) {
+  if (!(err instanceof ApiError)) return false;
+  return err.status === 0 || err.status === 429 || err.status >= 500;
+}
+async function uploadInParts(baseUrl, token, appId, localPath, key, size, onProgress) {
+  const contentType = contentTypeFor(localPath);
+  const initPath = filesPath(appId, `/multipart?key=${encodeKeyPath(key)}`);
+  const session = await readJson(
+    await request(baseUrl, token, initPath, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ name: basename3(localPath), mimeType: contentType, size })
+    }),
+    initPath
+  );
+  const query = `uploadKey=${encodeKeyPath(session.uploadKey)}&uploadId=${encodeURIComponent(session.uploadId)}`;
+  if (!Number.isSafeInteger(session.partSize) || session.partSize < 1) {
+    throw new ApiError(
+      `The platform advertised an unusable part size (${session.partSize}).`,
+      0,
+      "invalid_response",
+      initPath
+    );
+  }
+  const plan = planUploadParts(size, session.partSize);
+  const file = await openAsBlob(localPath, { type: contentType });
+  const uploaded = [];
+  try {
+    for (const part of plan) {
+      const partPath = filesPath(appId, `/multipart/part?${query}&partNumber=${part.partNumber}`);
+      const send = () => request(baseUrl, token, partPath, {
+        method: "PUT",
+        body: file.slice(part.start, part.end, contentType)
+      });
+      const res = await send().catch(async (err) => {
+        if (!isRetryable(err)) throw err;
+        return send();
+      });
+      uploaded.push(await readJson(res, partPath));
+      onProgress?.(part.end, size, part.partNumber, plan.length);
+    }
+    const completePath = filesPath(appId, `/multipart/complete?${query}`);
+    const body = await readJson(
+      await request(baseUrl, token, completePath, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ parts: uploaded })
+      }),
+      completePath
+    );
+    return { key: body.key, name: body.name, size, parts: plan.length };
+  } catch (err) {
+    await request(baseUrl, token, filesPath(appId, `/multipart?${query}`), {
+      method: "DELETE"
+    }).catch(() => void 0);
+    throw err;
+  }
+}
+async function listAppFiles(baseUrl, token, appId, query) {
+  const path = filesPath(appId, `?${query}`);
+  return readJson(await request(baseUrl, token, path), path);
+}
+async function deleteAppFile(baseUrl, token, appId, key) {
+  const path = filesPath(appId, `/${encodeKeyPath(key)}`);
+  const res = await request(baseUrl, token, path, { method: "DELETE" });
+  const body = await readJson(res, path);
+  return { existed: body.existed !== false };
+}
+async function downloadAppFile(baseUrl, token, appId, key, destination) {
+  const path = filesPath(appId, `/${encodeKeyPath(key)}`);
+  const res = await request(baseUrl, token, path);
+  if (!res.body) {
+    throw new ApiError("The server returned an empty response", 502, "invalid_response", path);
+  }
+  let bytes = 0;
+  await pipeline(
+    Readable.fromWeb(res.body),
+    async function* (chunks) {
+      for await (const chunk of chunks) {
+        bytes += chunk.length;
+        yield chunk;
+      }
+    },
+    createWriteStream(destination)
+  );
+  return { bytes, contentType: res.headers.get("content-type") ?? "application/octet-stream" };
+}
+
+// src/cli/commands/app-files.ts
+var DEPLOY_URL8 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
+var PLATFORM_URL = process.env.DEEPSPACE_PLATFORM_URL ?? PLATFORM_URLS.platform;
+async function target(app2) {
+  const token = await ensureToken();
+  const appId = await resolveAppTarget(DEPLOY_URL8, token, app2);
+  return { token, appId };
+}
+var MAX_LIST_LIMIT = 1e3;
+function parseLimit(raw) {
+  const limit = Number(raw ?? 100);
+  if (!Number.isInteger(limit) || limit < 1 || limit > MAX_LIST_LIMIT) {
+    throw new Refusal(`--limit must be a whole number from 1 to ${MAX_LIST_LIMIT}.`, "invalid_limit");
+  }
+  return limit;
+}
+function requireKey(raw) {
+  const key = raw.trim().replace(/^\/+/, "");
+  if (!key) throw new Refusal("A key is required (for example `logo.png`).", "invalid_key");
+  if (key.split("/").some((segment) => segment === ".." || segment === ".")) {
+    throw new Refusal(
+      `"${raw}" contains a path traversal segment. Keys are relative to the app, e.g. \`img/hero.jpg\`.`,
+      "invalid_key"
+    );
+  }
+  return key;
+}
+function appPrefixOf(key) {
+  const segments = key.split("/");
+  return segments.length > 2 ? `${segments[0]}/${segments[1]}/` : "";
+}
+function relativeKey(key, prefix) {
+  return prefix && key.startsWith(prefix) ? key.slice(prefix.length) : key;
+}
+function servedPath(key) {
+  return `/api/files/${encodeKeyPath(key)}?scope=app`;
+}
+var put = defineDeepspaceCommand({
+  meta: {
+    name: "put",
+    description: `Upload a file to the app\u2019s files (${formatBytes(MAX_APP_FILE_BYTES)} per file)`
+  },
+  args: {
+    file: { type: "positional", description: "Local file to upload", required: true },
+    key: { type: "string", description: "Key to store it under (default: the file name)" },
+    app: { type: "string", description: "App id or live name (defaults to ./wrangler.toml)" }
+  },
+  async run({ args }) {
+    const localPath = resolve15(String(args.file));
+    if (!existsSync21(localPath) || !statSync2(localPath).isFile()) {
+      throw new Refusal(`No such file: ${args.file}`, "file_not_found");
+    }
+    const key = requireKey(args.key ?? basename4(localPath));
+    const { token, appId } = await target(args.app);
+    const spinner2 = args.json ? null : createSpinner();
+    let started = false;
+    const result = await uploadAppFile(
+      PLATFORM_URL,
+      token,
+      appId,
+      localPath,
+      key,
+      (sent, total, part, parts) => {
+        if (parts === 1 || !spinner2) return;
+        if (!started) {
+          spinner2.start(`Uploading ${key} in ${parts} parts`);
+          started = true;
+        }
+        spinner2.message(
+          `${key} \u2014 part ${part}/${parts} (${formatBytes(sent)} of ${formatBytes(total)})`
+        );
+      }
+    ).finally(() => {
+      if (started) spinner2?.stop();
+    });
+    if (!args.json) {
+      const how = result.parts > 1 ? ` in ${result.parts} parts` : "";
+      console.log(`\u2713 ${key} (${formatBytes(result.size)})${how}`);
+      console.log(`  Served from your app at ${servedPath(result.key)}`);
+    }
+    return {
+      data: {
+        appId,
+        key,
+        storedKey: result.key,
+        size: result.size,
+        parts: result.parts,
+        path: servedPath(result.key)
+      }
+    };
+  }
+});
+var list3 = defineDeepspaceCommand({
+  meta: { name: "list", description: "List the app\u2019s files" },
+  args: {
+    prefix: { type: "string", description: "Only keys starting with this prefix" },
+    limit: {
+      type: "string",
+      description: `Max entries, 1-${MAX_LIST_LIMIT} (default 100)`,
+      default: "100"
+    },
+    app: { type: "string", description: "App id or live name (defaults to ./wrangler.toml)" }
+  },
+  async run({ args }) {
+    const limit = parseLimit(args.limit);
+    const { token, appId } = await target(args.app);
+    const query = new URLSearchParams({ limit: String(limit) });
+    if (args.prefix) query.set("prefix", String(args.prefix));
+    const result = await listAppFiles(PLATFORM_URL, token, appId, query);
+    const prefix = result.files.length ? appPrefixOf(result.files[0].key) : "";
+    const files = result.files.map((file) => ({
+      key: relativeKey(file.key, prefix),
+      size: file.size,
+      uploaded: file.uploaded,
+      path: servedPath(file.key)
+    }));
+    if (!args.json) {
+      if (files.length === 0) {
+        console.log("No files. Upload one with `deepspace app files put <file>`.");
+      } else {
+        const keyWidth = Math.max(3, ...files.map((file) => file.key.length));
+        console.log(`${"KEY".padEnd(keyWidth)}  ${"SIZE".padStart(9)}  UPLOADED`);
+        for (const file of files) {
+          console.log(
+            `${file.key.padEnd(keyWidth)}  ${formatBytes(file.size).padStart(9)}  ${file.uploaded.slice(0, 10)}`
+          );
+        }
+        const more = limit < MAX_LIST_LIMIT ? "raise --limit or narrow with --prefix" : "narrow with --prefix";
+        if (result.truncated) console.log(`(truncated at ${limit} \u2014 ${more})`);
+      }
+    }
+    return { data: { appId, files, truncated: result.truncated } };
+  }
+});
+var get = defineDeepspaceCommand({
+  meta: { name: "get", description: "Download one file" },
+  args: {
+    key: { type: "positional", description: "Key to download", required: true },
+    out: { type: "string", description: "Write here (default: the key\u2019s file name)" },
+    app: { type: "string", description: "App id or live name (defaults to ./wrangler.toml)" }
+  },
+  async run({ args }) {
+    const key = requireKey(String(args.key));
+    const destination = resolve15(String(args.out ?? basename4(key)));
+    const { token, appId } = await target(args.app);
+    const result = await downloadAppFile(PLATFORM_URL, token, appId, key, destination);
+    if (!args.json) console.log(`\u2713 ${key} \u2192 ${destination} (${formatBytes(result.bytes)})`);
+    return { data: { appId, key, out: destination, size: result.bytes, contentType: result.contentType } };
+  }
+});
+var rm = defineDeepspaceCommand({
+  meta: { name: "rm", description: "Delete one file" },
+  args: {
+    key: { type: "positional", description: "Key to delete", required: true },
+    app: { type: "string", description: "App id or live name (defaults to ./wrangler.toml)" }
+  },
+  async run({ args }) {
+    const key = requireKey(String(args.key));
+    const { token, appId } = await target(args.app);
+    const { existed } = await deleteAppFile(PLATFORM_URL, token, appId, key);
+    if (!existed) {
+      throw new Refusal(
+        `No file at ${key} \u2014 nothing was deleted. Check the key with \`deepspace app files list\`.`,
+        "file_not_found"
+      );
+    }
+    if (!args.json) console.log(`\u2713 deleted ${key}`);
+    return { data: { appId, key, deleted: true } };
+  }
+});
+var app_files_default = defineCommand6({
+  meta: { name: "files", description: "Upload and manage the app\u2019s files (images, media)" },
+  subCommands: { put, list: list3, get, rm }
+});
+
+// src/cli/commands/collaborators.ts
+import { defineCommand as defineCommand7 } from "citty";
 
 // src/server/auth/testAccounts.ts
 var TEST_ACCOUNT_EMAIL_SUFFIX = "@deepspace.test";
@@ -7924,18 +8514,18 @@ function isTestAccountEmail(email) {
 
 // src/cli/commands/collaborators.ts
 var API_URL5 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
-var DEPLOY_URL8 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
+var DEPLOY_URL9 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 function api2(token, path, init) {
   return apiFetch(API_URL5, token, path, init);
 }
-var list3 = defineDeepspaceCommand({
+var list4 = defineDeepspaceCommand({
   meta: { name: "list", description: "List collaborators on your app" },
   args: {
     app: { type: "string", alias: "a", description: "App id or name (defaults to ./wrangler.toml)" }
   },
   async run({ args }) {
     const token = await ensureToken();
-    const app2 = await resolveAppTarget(DEPLOY_URL8, token, args.app);
+    const app2 = await resolveAppTarget(DEPLOY_URL9, token, args.app);
     const { collaborators, pending = [] } = await api2(token, `/api/app-collaborators/${encodeURIComponent(app2)}`);
     if (!collaborators.length && !pending.length) {
       if (!args.json) {
@@ -7973,7 +8563,7 @@ var add = defineDeepspaceCommand({
   async run({ args }) {
     const email = String(args.email);
     const token = await ensureToken();
-    const app2 = await resolveAppTarget(DEPLOY_URL8, token, args.app);
+    const app2 = await resolveAppTarget(DEPLOY_URL9, token, args.app);
     if (isTestAccountEmail(email)) {
       throw new Refusal(
         "Test accounts (@deepspace.test) cannot be added as collaborators. Use a real DeepSpace account.",
@@ -8015,13 +8605,13 @@ var remove = defineDeepspaceCommand({
   async run({ args }) {
     const email = String(args.email);
     const token = await ensureToken();
-    const app2 = await resolveAppTarget(DEPLOY_URL8, token, args.app);
+    const app2 = await resolveAppTarget(DEPLOY_URL9, token, args.app);
     const { collaborators } = await api2(
       token,
       `/api/app-collaborators/${encodeURIComponent(app2)}`
     );
-    const target = email.trim().toLowerCase();
-    const found = collaborators.find((c) => c.emailDisplay.toLowerCase() === target);
+    const target2 = email.trim().toLowerCase();
+    const found = collaborators.find((c) => c.emailDisplay.toLowerCase() === target2);
     if (!found) {
       throw new Refusal(`${email} is not a collaborator on ${app2}`, "not_a_collaborator", {
         action: cliAction("deepspace", "app", "collaborators", "list", "--app", app2)
@@ -8045,13 +8635,13 @@ var cancel3 = defineDeepspaceCommand({
   async run({ args }) {
     const email = String(args.email);
     const token = await ensureToken();
-    const app2 = await resolveAppTarget(DEPLOY_URL8, token, args.app);
+    const app2 = await resolveAppTarget(DEPLOY_URL9, token, args.app);
     const { pending = [] } = await api2(
       token,
       `/api/app-collaborators/${encodeURIComponent(app2)}`
     );
-    const target = email.trim().toLowerCase();
-    const found = pending.find((p34) => p34.email.toLowerCase() === target);
+    const target2 = email.trim().toLowerCase();
+    const found = pending.find((p34) => p34.email.toLowerCase() === target2);
     if (!found) {
       throw new Refusal(`${email} has no pending invite on ${app2}`, "no_pending_invite", {
         action: cliAction("deepspace", "app", "collaborators", "list", "--app", app2)
@@ -8066,16 +8656,16 @@ var cancel3 = defineDeepspaceCommand({
     return { data: { cancelled: found } };
   }
 });
-var collaborators_default = defineCommand6({
+var collaborators_default = defineCommand7({
   meta: { name: "collaborators", description: "Manage who can deploy your app" },
-  subCommands: { list: list3, add, remove, cancel: cancel3 }
+  subCommands: { list: list4, add, remove, cancel: cancel3 }
 });
 
 // src/cli/commands/transfer.ts
-import { defineCommand as defineCommand7 } from "citty";
+import { defineCommand as defineCommand8 } from "citty";
 import * as p14 from "@clack/prompts";
 var API_URL6 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
-var DEPLOY_URL9 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
+var DEPLOY_URL10 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 var offer = defineDeepspaceCommand({
   meta: { name: "offer", description: "Offer this app to another DeepSpace user" },
   args: {
@@ -8089,7 +8679,7 @@ var offer = defineDeepspaceCommand({
   async run({ args }) {
     const email = String(args.email);
     const token = await ensureToken();
-    const app2 = await resolveAppTarget(DEPLOY_URL9, token, args.app);
+    const app2 = await resolveAppTarget(DEPLOY_URL10, token, args.app);
     const pending = await apiFetch(
       API_URL6,
       token,
@@ -8141,7 +8731,7 @@ var status2 = defineDeepspaceCommand({
   },
   async run({ args }) {
     const token = await ensureToken();
-    const app2 = await resolveAppTarget(DEPLOY_URL9, token, args.app);
+    const app2 = await resolveAppTarget(DEPLOY_URL10, token, args.app);
     const { transfer } = await apiFetch(API_URL6, token, `/api/app-transfers/${encodeURIComponent(app2)}`);
     if (!transfer) {
       if (!args.json) console.log(`No pending transfer for ${app2}.`);
@@ -8168,7 +8758,7 @@ var accept = defineDeepspaceCommand({
       const msg = err instanceof Error ? err.message : String(err);
       throw new Refusal(msg, msg.startsWith("No app id") ? "not_in_app_repo" : "invalid_app");
     }
-    await apiFetch(DEPLOY_URL9, token, `/api/apps/${encodeURIComponent(app2)}/transfer/accept`, {
+    await apiFetch(DEPLOY_URL10, token, `/api/apps/${encodeURIComponent(app2)}/transfer/accept`, {
       method: "POST"
     });
     if (!args.json) {
@@ -8186,37 +8776,37 @@ var cancel4 = defineDeepspaceCommand({
   },
   async run({ args }) {
     const token = await ensureToken();
-    const app2 = await resolveAppTarget(DEPLOY_URL9, token, args.app);
+    const app2 = await resolveAppTarget(DEPLOY_URL10, token, args.app);
     await apiFetch(API_URL6, token, `/api/app-transfers/${encodeURIComponent(app2)}`, { method: "DELETE" });
     if (!args.json) console.log(`\u2713 Transfer offer for ${app2} cancelled.`);
     return { data: { app: app2, cancelled: true } };
   }
 });
-var transfer_default = defineCommand7({
+var transfer_default = defineCommand8({
   meta: { name: "transfer", description: "Transfer app ownership to another user" },
   subCommands: { offer, status: status2, accept, cancel: cancel4 }
 });
 
 // src/cli/commands/integrations.ts
-import { defineCommand as defineCommand8 } from "citty";
+import { defineCommand as defineCommand9 } from "citty";
 
 // src/cli/commands/_invoke-impl.ts
 import { readFileSync as readFileSync22 } from "fs";
 import * as p15 from "@clack/prompts";
 var API_URL7 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
 var DEFAULT_TIMEOUT_MS = 12e4;
-function parseTarget(target) {
-  if (!target || typeof target !== "string") {
+function parseTarget(target2) {
+  if (!target2 || typeof target2 !== "string") {
     throw new Refusal(
       "Missing target. Expected '<integration>/<endpoint>' (e.g. 'openai/chat-completion').",
       "missing_target",
       { action: cliAction("deepspace", "integrations", "list") }
     );
   }
-  const parts = target.split("/");
+  const parts = target2.split("/");
   if (parts.length !== 2 || !parts[0] || !parts[1]) {
     throw new Refusal(
-      `Bad target '${target}'. Expected '<integration>/<endpoint>' (e.g. 'openai/chat-completion').`,
+      `Bad target '${target2}'. Expected '<integration>/<endpoint>' (e.g. 'openai/chat-completion').`,
       "bad_target",
       { action: cliAction("deepspace", "integrations", "list") }
     );
@@ -8436,7 +9026,7 @@ async function runInvoke(args) {
 }
 
 // src/cli/commands/integrations.ts
-var list4 = defineDeepspaceCommand({
+var list5 = defineDeepspaceCommand({
   meta: {
     name: "list",
     description: "List all available integrations"
@@ -8507,13 +9097,13 @@ var invoke = defineDeepspaceCommand({
     });
   }
 });
-var integrations_default = defineCommand8({
+var integrations_default = defineCommand9({
   meta: {
     name: "integrations",
     description: "List, inspect, and invoke platform integrations"
   },
   subCommands: {
-    list: list4,
+    list: list5,
     info,
     invoke
   }
@@ -8521,7 +9111,7 @@ var integrations_default = defineCommand8({
 
 // src/cli/commands/feedback.ts
 import * as p16 from "@clack/prompts";
-import { existsSync as existsSync21, readFileSync as readFileSync23 } from "fs";
+import { existsSync as existsSync22, readFileSync as readFileSync23 } from "fs";
 import { dirname as dirname8, join as join20 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { release } from "os";
@@ -8549,7 +9139,7 @@ function readCliVersion() {
       join20(here, "..", "..", "..", "package.json")
     ];
     for (const path of candidates) {
-      if (!existsSync21(path)) continue;
+      if (!existsSync22(path)) continue;
       const pkg2 = JSON.parse(readFileSync23(path, "utf-8"));
       if (pkg2.name === "deepspace" && pkg2.version) return pkg2.version;
     }
@@ -8745,7 +9335,7 @@ Context: deepspace ${payload.cliVersion} \xB7 ${payload.nodeVersion} \xB7 ${payl
 });
 
 // src/cli/commands/secrets.ts
-import { defineCommand as defineCommand9 } from "citty";
+import { defineCommand as defineCommand10 } from "citty";
 import { readFileSync as readFileSync24 } from "fs";
 
 // src/cli/lib/citty-args.ts
@@ -8779,7 +9369,7 @@ function parseCursorArg(raw) {
 }
 
 // src/cli/commands/secrets.ts
-var DEPLOY_URL10 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
+var DEPLOY_URL11 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 var COMMON_ARGS = {
   app: {
     type: "string",
@@ -8849,7 +9439,7 @@ function warnIfDebugRoutesEnabled(secrets) {
 }
 var APPLY_HINT = "Run `deepspace deploy` to apply \u2014 secrets take effect at deploy time.";
 var LOCAL_DEV_HINT = "Running `deepspace dev start`? Restart it to load the change locally.";
-var list5 = defineCommand9({
+var list6 = defineCommand10({
   meta: { name: "list", description: "List masked secrets in a config" },
   args: {
     ...COMMON_ARGS,
@@ -8862,7 +9452,7 @@ var list5 = defineCommand9({
   async run({ args }) {
     try {
       const t = await resolveTarget(args);
-      const { secrets } = await listSecrets(DEPLOY_URL10, t.token, t.appId, t.configName);
+      const { secrets } = await listSecrets(DEPLOY_URL11, t.token, t.appId, t.configName);
       if (args.json) {
         console.log(JSON.stringify({ ok: true, appId: t.appId, config: t.configName, secrets }));
         return;
@@ -8879,7 +9469,7 @@ var list5 = defineCommand9({
     }
   }
 });
-var set = defineCommand9({
+var set = defineCommand10({
   meta: { name: "set", description: "Set secrets from KEY=value pairs" },
   args: {
     ...COMMON_ARGS,
@@ -8907,9 +9497,9 @@ var set = defineCommand9({
       }
       if (Object.keys(secrets).length === 1) {
         const [[k, v]] = Object.entries(secrets);
-        await setSecret(DEPLOY_URL10, t.token, t.appId, t.configName, k, v);
+        await setSecret(DEPLOY_URL11, t.token, t.appId, t.configName, k, v);
       } else {
-        await uploadSecrets(DEPLOY_URL10, t.token, t.appId, t.configName, secrets, false);
+        await uploadSecrets(DEPLOY_URL11, t.token, t.appId, t.configName, secrets, false);
       }
       const n = Object.keys(secrets).length;
       ok(
@@ -8928,7 +9518,7 @@ var set = defineCommand9({
     }
   }
 });
-var get = defineCommand9({
+var get2 = defineCommand10({
   meta: { name: "get", description: "Get a secret; pass --plain to print the value" },
   args: {
     ...COMMON_ARGS,
@@ -8940,11 +9530,11 @@ var get = defineCommand9({
       const t = await resolveTarget(args);
       const key = validateSecretName(args.key);
       if (args.plain) {
-        const { value } = await getSecretPlain(DEPLOY_URL10, t.token, t.appId, t.configName, key);
+        const { value } = await getSecretPlain(DEPLOY_URL11, t.token, t.appId, t.configName, key);
         process.stdout.write(process.stdout.isTTY ? value + "\n" : value);
         return;
       }
-      const { secrets } = await listSecrets(DEPLOY_URL10, t.token, t.appId, t.configName);
+      const { secrets } = await listSecrets(DEPLOY_URL11, t.token, t.appId, t.configName);
       const item = secrets.find((s) => s.key === key);
       if (!item)
         fail(new InputError(`Secret "${key}" not found in ${t.configName}`, "secret_not_found"));
@@ -8964,7 +9554,7 @@ var get = defineCommand9({
     }
   }
 });
-var del2 = defineCommand9({
+var del2 = defineCommand10({
   meta: { name: "delete", description: "Delete one or more secrets" },
   args: {
     ...COMMON_ARGS,
@@ -8979,7 +9569,7 @@ var del2 = defineCommand9({
       for (const key of keys) {
         const name = validateSecretName(key);
         try {
-          await deleteSecret(DEPLOY_URL10, t.token, t.appId, t.configName, name);
+          await deleteSecret(DEPLOY_URL11, t.token, t.appId, t.configName, name);
           deleted++;
         } catch (err) {
           if (err?.status === 404) absent++;
@@ -8998,7 +9588,7 @@ var del2 = defineCommand9({
     }
   }
 });
-var upload = defineCommand9({
+var upload = defineCommand10({
   meta: { name: "upload", description: "Upload secrets from a dotenv or JSON file" },
   args: {
     ...COMMON_ARGS,
@@ -9020,7 +9610,7 @@ var upload = defineCommand9({
       const secrets = parseSecretsUpload(content);
       if (Object.keys(secrets).length === 0)
         fail(new InputError("No secrets found in the input.", "empty_input"));
-      await uploadSecrets(DEPLOY_URL10, t.token, t.appId, t.configName, secrets, args.replace);
+      await uploadSecrets(DEPLOY_URL11, t.token, t.appId, t.configName, secrets, args.replace);
       const uploaded = Object.keys(secrets);
       ok(
         args.json === true,
@@ -9035,7 +9625,7 @@ var upload = defineCommand9({
     }
   }
 });
-var download = defineCommand9({
+var download = defineCommand10({
   meta: { name: "download", description: "Download a config\u2019s secrets (dotenv/json/shell)" },
   args: {
     ...COMMON_ARGS,
@@ -9057,14 +9647,14 @@ var download = defineCommand9({
           )
         );
       }
-      const { secrets } = await fetchSecretsValues(DEPLOY_URL10, t.token, t.appId, t.configName);
+      const { secrets } = await fetchSecretsValues(DEPLOY_URL11, t.token, t.appId, t.configName);
       process.stdout.write(formatSecretsDownload(secrets, format));
     } catch (err) {
       fail(err);
     }
   }
 });
-var pull = defineCommand9({
+var pull = defineCommand10({
   meta: { name: "pull", description: "Refresh the .dev.vars cache from the app store" },
   args: { ...COMMON_ARGS },
   async run({ args }) {
@@ -9080,7 +9670,7 @@ var pull = defineCommand9({
         );
       const t = await resolveTarget(args);
       const ownerId = decodeJwtPayload(t.token).sub;
-      const pulled = await pullAppSecretsCache(DEPLOY_URL10, t.token, t.appId, t.configName);
+      const pulled = await pullAppSecretsCache(DEPLOY_URL11, t.token, t.appId, t.configName);
       if (!pulled) {
         ok(
           args.json === true,
@@ -9107,13 +9697,13 @@ var pull = defineCommand9({
     }
   }
 });
-var configsList = defineCommand9({
+var configsList = defineCommand10({
   meta: { name: "list", description: "List the app\u2019s configs" },
   args: { ...COMMON_ARGS },
   async run({ args }) {
     try {
       const t = await resolveTarget(args);
-      const { configs: configs2 } = await listConfigs(DEPLOY_URL10, t.token, t.appId);
+      const { configs: configs2 } = await listConfigs(DEPLOY_URL11, t.token, t.appId);
       ok(args.json === true, { appId: t.appId, configs: configs2 }, () => {
         if (configs2.length === 0) {
           console.log("No configs yet \u2014 the first `secrets set` creates one.");
@@ -9128,7 +9718,7 @@ var configsList = defineCommand9({
     }
   }
 });
-var configsCreate = defineCommand9({
+var configsCreate = defineCommand10({
   meta: { name: "create", description: "Create a config (optionally copying another)" },
   args: {
     ...COMMON_ARGS,
@@ -9140,7 +9730,7 @@ var configsCreate = defineCommand9({
       const t = await resolveTarget(args);
       const name = validateConfigName(args.name);
       const copyFrom = args["copy-from"] || void 0;
-      const { configs: configs2 } = await listConfigs(DEPLOY_URL10, t.token, t.appId);
+      const { configs: configs2 } = await listConfigs(DEPLOY_URL11, t.token, t.appId);
       if (configs2.some((c) => c.name === name)) {
         if (copyFrom) {
           fail(
@@ -9157,7 +9747,7 @@ var configsCreate = defineCommand9({
         );
         return;
       }
-      await createConfig(DEPLOY_URL10, t.token, t.appId, name, copyFrom);
+      await createConfig(DEPLOY_URL11, t.token, t.appId, name, copyFrom);
       ok(
         args.json === true,
         { appId: t.appId, config: name, created: true, ...copyFrom ? { copyFrom } : {} },
@@ -9168,7 +9758,7 @@ var configsCreate = defineCommand9({
     }
   }
 });
-var configsDelete = defineCommand9({
+var configsDelete = defineCommand10({
   meta: { name: "delete", description: "Delete a config and all of its secrets" },
   args: {
     ...COMMON_ARGS,
@@ -9178,7 +9768,7 @@ var configsDelete = defineCommand9({
     try {
       const t = await resolveTarget(args);
       const name = validateConfigName(args.name);
-      await deleteConfig(DEPLOY_URL10, t.token, t.appId, name);
+      await deleteConfig(DEPLOY_URL11, t.token, t.appId, name);
       ok(
         args.json === true,
         { appId: t.appId, config: name, deleted: true },
@@ -9189,16 +9779,16 @@ var configsDelete = defineCommand9({
     }
   }
 });
-var configs = defineCommand9({
+var configs = defineCommand10({
   meta: { name: "configs", description: "Manage the app\u2019s secrets configs" },
   subCommands: { list: configsList, create: configsCreate, delete: configsDelete }
 });
-var secrets_default = defineCommand9({
+var secrets_default = defineCommand10({
   meta: { name: "secrets", description: "Manage the app\u2019s secrets store" },
   subCommands: {
-    list: list5,
+    list: list6,
     set,
-    get,
+    get: get2,
     delete: del2,
     upload,
     download,
@@ -9270,9 +9860,9 @@ var init_default = defineDeepspaceCommand({
 });
 
 // src/cli/commands/status.ts
-import { defineCommand as defineCommand10 } from "citty";
+import { defineCommand as defineCommand11 } from "citty";
 import * as p17 from "@clack/prompts";
-import { existsSync as existsSync22, readFileSync as readFileSync25 } from "fs";
+import { existsSync as existsSync23, readFileSync as readFileSync25 } from "fs";
 function timeAgo(iso) {
   const ms = Date.now() - Date.parse(iso);
   if (!Number.isFinite(ms) || ms < 0) return iso;
@@ -9305,7 +9895,7 @@ function resolveStatusApp(appDir, wranglerEnv) {
   if (!resolved.ok) throw new InputError(resolved.reason, "invalid_env");
   return { appName: resolved.name, appId: readAppId(appDir, wranglerEnv) };
 }
-var status_default = defineCommand10({
+var status_default = defineCommand11({
   meta: {
     name: "status",
     description: "One screenful of current state: session, app, workspace, and live release"
@@ -9357,7 +9947,7 @@ var status_default = defineCommand10({
       json.services = urls;
       if (urlOverrides.length > 0) json.urlOverrides = urlOverrides;
     }
-    facts.loggedIn = existsSync22(SESSION_PATH);
+    facts.loggedIn = existsSync23(SESSION_PATH);
     let userId = null;
     if (!facts.loggedIn) {
       lines.push(["Session", "not logged in"]);
@@ -9454,24 +10044,36 @@ var status_default = defineCommand10({
             const failure = statusRemoteFailure(error);
             lines.push([label, failure.human]);
             json[key] = failure.json;
-          }, reportRelease2 = function(rel) {
+          }, reportLive2 = function(rel, entry) {
+            if (rel === null) {
+              lines.push(["Live", "never deployed"]);
+              json.live = null;
+              return;
+            }
             const byYou = userId !== null && rel.actor === userId;
-            lines.push([
-              "Live",
-              `release #${rel.seq} (${rel.kind} of ${rel.commitOid?.slice(0, 10) ?? "unknown source"}, ${timeAgo(rel.createdAt)}${byYou ? ", by you" : ""})` + (rel.url ? ` \xB7 ${rel.url}` : "")
-            ]);
-            json.live = {
+            const release2 = `release #${rel.seq} (${rel.kind} of ${rel.commitOid?.slice(0, 10) ?? "unknown source"}, ${timeAgo(rel.createdAt)}${byYou ? ", by you" : ""})`;
+            const details = {
               seq: rel.seq,
               kind: rel.kind,
               commitOid: rel.commitOid,
               createdAt: rel.createdAt,
-              url: rel.url,
               byYou,
               source: rel.source,
               sourceRevision: rel.sourceRevision
             };
+            if (!entry) {
+              lines.push(["Live", `${release2} \xB7 serving state not visible from your account`]);
+              json.live = { ...details, serving: null, url: null };
+              return;
+            }
+            const url = liveAppUrl(entry);
+            lines.push([
+              "Live",
+              url ? `${release2} \xB7 ${url}` : `not serving \u2014 ${entry.status}, last ${release2}`
+            ]);
+            json.live = { ...details, serving: url !== null, url };
           };
-          var reportWorkspace = reportWorkspace2, reportRemoteFailure = reportRemoteFailure2, reportRelease = reportRelease2;
+          var reportWorkspace = reportWorkspace2, reportRemoteFailure = reportRemoteFailure2, reportLive = reportLive2;
           const api4 = repoApi(deployBaseUrl(), token, appId);
           const sourceResult = await observeRemote(getAppSource(deployBaseUrl(), token, appId));
           const source = sourceResult.ok ? sourceResult.value.source : null;
@@ -9491,10 +10093,11 @@ var status_default = defineCommand10({
             lines.push(["Source", "unclaimed \xB7 next normal deploy defaults to DeepSpace"]);
             json.source = null;
           }
-          const [refsResult, wsResult, releaseResult] = await Promise.all([
+          const [refsResult, wsResult, releaseResult, appsResult] = await Promise.all([
             githubSource ? Promise.resolve({ ok: true, value: null }) : observeRemote(api4.getRefs()),
             facts.workspaceId && !githubSource ? observeRemote(api4.getWorkspace(facts.workspaceId).then((r) => r.view)) : Promise.resolve({ ok: true, value: null }),
-            observeRemote(api4.latestRelease().then((r) => r.release))
+            observeRemote(api4.latestRelease().then((r) => r.release)),
+            observeRemote(listApps(deployBaseUrl(), token))
           ]);
           if (facts.workspaceId) {
             if (githubSource) {
@@ -9523,12 +10126,8 @@ var status_default = defineCommand10({
             }
           }
           if (!releaseResult.ok) reportRemoteFailure2("Live", "live", releaseResult.error);
-          else if (releaseResult.value === null) {
-            lines.push(["Live", "never deployed"]);
-            json.live = null;
-          } else {
-            reportRelease2(releaseResult.value);
-          }
+          else if (!appsResult.ok) reportRemoteFailure2("Live", "live", appsResult.error);
+          else reportLive2(releaseResult.value, appsResult.value.find((a) => a.appId === appId));
         }
         spinner2?.stop("Cloud state checked.");
       }
@@ -9571,7 +10170,7 @@ function workspaceBranchPushRefusal(branch) {
 var push_default = defineDeepspaceCommand({
   meta: {
     name: "push",
-    description: "Push local git commits to the app's cloud repo"
+    description: `Push local git commits to the app's cloud repo (${PUSH_CEILINGS})`
   },
   args: {
     branch: {
@@ -9596,8 +10195,8 @@ var push_default = defineDeepspaceCommand({
     const branchArg = args.branch === void 0 ? void 0 : String(args.branch);
     const appArg = typeof args.app === "string" ? args.app : void 0;
     const force = args.force === true;
+    const appDir = findAppDir();
     try {
-      const appDir = findAppDir();
       if (!appDir)
         throw new Refusal(
           "No wrangler.toml found \u2014 run from inside an app directory.",
@@ -9726,7 +10325,7 @@ var push_default = defineDeepspaceCommand({
       }
       const recoverable = isRecoverablePushFailure(result.status);
       const rejectReason = result.reason ?? result.summary;
-      const errorMsg = ok2 ? null : result.status === "ref_conflict" ? `The cloud repo's ${branch} moved while you worked (${rejectReason}). Run \`deepspace pull --app ${shQuote(appId)} --branch ${shQuote(branch)}\` to integrate, then push again.` : result.status === "rejected" ? `The cloud repo rejected ${branch}: ${rejectReason}.` + (OVERSIZED_PUSH_RE.test(rejectReason) ? ` ${oversizedPushFix(appDir)}` : "") : `The cloud repo's ${branch} has commit(s) your local ${branch} doesn't. Run \`deepspace pull --app ${shQuote(appId)} --branch ${shQuote(branch)}\` and merge (or rebase), then push. Avoid --force here \u2014 it's guarded and will refuse rather than silently drop a peer's commits.`;
+      const errorMsg = ok2 ? null : result.status === "ref_conflict" ? `The cloud repo's ${branch} moved while you worked (${rejectReason}). Run \`deepspace pull --app ${shQuote(appId)} --branch ${shQuote(branch)}\` to integrate, then push again.` : result.status === "rejected" ? pushFailureMessage(`The cloud repo rejected ${branch}`, result, appDir ?? void 0) : `The cloud repo's ${branch} has commit(s) your local ${branch} doesn't. Run \`deepspace pull --app ${shQuote(appId)} --branch ${shQuote(branch)}\` and merge (or rebase), then push. Avoid --force here \u2014 it's guarded and will refuse rather than silently drop a peer's commits.`;
       if (!args.json && ok2) p18.log.info(`App: ${appId}`);
       const action = recoverable ? pullRecoveryAction(pullRecoveryCwd, appId, branch) : void 0;
       if (!ok2) {
@@ -9739,7 +10338,7 @@ var push_default = defineDeepspaceCommand({
       return { data: { status: result.status, appId, branch, oid: tipOid } };
     } catch (err) {
       if (err instanceof Refusal) throw err;
-      const transportFailure = classifyPushTransportFailure(err);
+      const transportFailure = classifyPushTransportFailure(err, appDir ?? void 0);
       if (transportFailure) {
         throw new Refusal(transportFailure.error, transportFailure.code);
       }
@@ -10031,14 +10630,14 @@ var pull_default = defineDeepspaceCommand({
 
 // src/cli/commands/clone.ts
 import * as p20 from "@clack/prompts";
-import { existsSync as existsSync23, readdirSync as readdirSync6, rmSync as rmSync5 } from "fs";
-import { resolve as resolve15, basename as basename3, join as join21 } from "path";
+import { existsSync as existsSync24, readdirSync as readdirSync6, rmSync as rmSync5 } from "fs";
+import { resolve as resolve16, basename as basename5, join as join21 } from "path";
 function cleanFailedCloneDir(dir) {
   let entries;
   try {
     entries = readdirSync6(dir);
   } catch {
-    return existsSync23(dir) ? ["<unreadable>"] : [];
+    return existsSync24(dir) ? ["<unreadable>"] : [];
   }
   if (entries.length === 1 && entries[0] === ".git") {
     try {
@@ -10051,7 +10650,7 @@ function cleanFailedCloneDir(dir) {
   return entries;
 }
 function validateCloneTarget(dir) {
-  if (!existsSync23(dir)) return false;
+  if (!existsSync24(dir)) return false;
   let entries;
   try {
     entries = readdirSync6(dir);
@@ -10086,7 +10685,7 @@ var clone_default = defineDeepspaceCommand({
   async run({ args }) {
     assertAppTargetResolvable(String(args.app));
     const selector = String(args.app).trim();
-    const dir = resolve15(String(args.dir ?? selector));
+    const dir = resolve16(String(args.dir ?? selector));
     const dirPreexisted = validateCloneTarget(dir);
     const spinner2 = args.json ? null : createSpinner();
     spinner2?.start(`Resolving ${selector}\u2026`);
@@ -10129,7 +10728,7 @@ var clone_default = defineDeepspaceCommand({
     const head = resolveCommit(dir, "HEAD");
     const branch = currentBranch(dir);
     spinner2?.stop(
-      `Cloned ${selector} (${branches.length} ${branches.length === 1 ? "branch" : "branches"}) into ${basename3(dir)}/ at ${head?.slice(0, 10) ?? "(unborn)"}.`
+      `Cloned ${selector} (${branches.length} ${branches.length === 1 ? "branch" : "branches"}) into ${basename5(dir)}/ at ${head?.slice(0, 10) ?? "(unborn)"}.`
     );
     if (!args.json && !branch) {
       p20.log.warn("HEAD is detached \u2014 check `git branch -a`.");
@@ -10152,7 +10751,28 @@ var clone_default = defineDeepspaceCommand({
 
 // src/cli/commands/releases.ts
 import * as p21 from "@clack/prompts";
-var DEPLOY_URL11 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
+
+// src/cli/lib/actor-labels.ts
+var API_URL9 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
+async function actorLabels(token, appId) {
+  const labels = /* @__PURE__ */ new Map();
+  try {
+    const { sub, email } = decodeJwtPayload(token);
+    if (sub && email) labels.set(sub, `${email} (you)`);
+  } catch {
+  }
+  try {
+    const { collaborators } = await apiFetch(API_URL9, token, `/api/app-collaborators/${encodeURIComponent(appId)}`);
+    for (const c of collaborators) {
+      if (!labels.has(c.userId)) labels.set(c.userId, c.emailDisplay);
+    }
+  } catch {
+  }
+  return labels;
+}
+
+// src/cli/commands/releases.ts
+var DEPLOY_URL12 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 var releases_default = defineDeepspaceCommand({
   meta: {
     name: "releases",
@@ -10187,18 +10807,19 @@ var releases_default = defineDeepspaceCommand({
     const spinner2 = args.json ? null : createSpinner();
     spinner2?.start("Loading release history\u2026");
     const token = await ensureToken();
-    const appId = await resolveAppTarget(DEPLOY_URL11, token, appArg, { wranglerEnv: envArg });
-    const { releases } = await repoApi(DEPLOY_URL11, token, appId).listReleases(limit);
+    const appId = await resolveAppTarget(DEPLOY_URL12, token, appArg, { wranglerEnv: envArg });
+    const { releases } = await repoApi(DEPLOY_URL12, token, appId).listReleases(limit);
     spinner2?.stop(`Loaded ${releases.length} ${releases.length === 1 ? "release" : "releases"}.`);
     if (!args.json) {
       if (releases.length === 0) {
         p21.log.info("No releases yet \u2014 the history starts with the next `deepspace deploy`.");
       } else {
+        const actors = await actorLabels(token, appId);
         for (const r of releases) {
           const source = r.commitOid ? `commit ${r.commitOid.slice(0, 10)}` : "(no source recorded)";
           const rollback = r.rollbackAvailable ? "rollback available" : "rollback unavailable";
           console.log(
-            `#${r.seq}  ${r.id}  ${r.kind.padEnd(8)}  ${r.createdAt}  ${r.actor}  ${source}  ${rollback}`
+            `#${r.seq}  ${r.id}  ${r.kind.padEnd(8)}  ${r.createdAt}  ${actors.get(r.actor) ?? r.actor}  ${source}  ${rollback}`
           );
         }
         p21.log.info(
@@ -10220,7 +10841,7 @@ Retry in a moment, or re-run with --allow-do-deletion to accept the risk.`,
     "do_guard_unavailable"
   );
 }
-var DEPLOY_URL12 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
+var DEPLOY_URL13 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 function pickPreviousRelease(releases) {
   if (releases.length === 0) {
     return { error: "No releases recorded yet \u2014 nothing to roll back to.", code: "no_releases" };
@@ -10282,8 +10903,8 @@ var rollback_default = defineDeepspaceCommand({
     const spinner2 = args.json ? null : createSpinner();
     spinner2?.start("Preparing rollback\u2026");
     const token = await ensureToken();
-    const appId = await resolveAppTarget(DEPLOY_URL12, token, appArg, { wranglerEnv: envArg });
-    const api4 = repoApi(DEPLOY_URL12, token, appId);
+    const appId = await resolveAppTarget(DEPLOY_URL13, token, appArg, { wranglerEnv: envArg });
+    const api4 = repoApi(DEPLOY_URL13, token, appId);
     let releaseId = args.release ? String(args.release).trim() : "";
     if (!releaseId) {
       const { releases } = await api4.listReleases(2);
@@ -10294,7 +10915,7 @@ var rollback_default = defineDeepspaceCommand({
     spinner2?.message(`Rolling back to ${releaseId}\u2026`);
     let result;
     try {
-      result = await apiFetch(DEPLOY_URL12, token, `/api/deploy/${appId}/rollback`, {
+      result = await apiFetch(DEPLOY_URL13, token, `/api/deploy/${appId}/rollback`, {
         method: "POST",
         body: JSON.stringify({
           releaseId,
@@ -10321,10 +10942,20 @@ Re-run with --allow-do-deletion to accept the data loss.`,
         "invalid_response"
       );
     }
-    spinner2?.stop(`Rolled back to ${result.rolledBackTo ?? releaseId}.`);
+    let edgePropagating = false;
+    if (result.url) {
+      spinner2?.message("Waiting for edge propagation...");
+      edgePropagating = !await waitForEdgePropagation(result.url, 9e4);
+    }
+    spinner2?.stop(
+      edgePropagating ? `Rolled back to ${result.rolledBackTo ?? releaseId} (edge propagation still in progress after 90s).` : `Rolled back to ${result.rolledBackTo ?? releaseId}.`
+    );
     const doClassGuard = result.doClassGuard === "unverified" ? "unverified" : void 0;
     if (!args.json) {
-      if (result.url) p22.log.success(`Live at: ${result.url}`);
+      if (result.url) {
+        if (edgePropagating) p22.log.warn(`URL: ${result.url} (accepted; serving not yet verified)`);
+        else p22.log.success(`Live at: ${result.url}`);
+      }
       if (result.bundleRetained === false) {
         p22.log.warn(
           "The rollback is live, but its bundle was concurrently retired and is not available for a future rollback."
@@ -10348,6 +10979,7 @@ Re-run with --allow-do-deletion to accept the data loss.`,
         url: result.url ?? null,
         versionId: result.versionId ?? null,
         wranglerEnv: wranglerEnv ?? null,
+        ...edgePropagating ? { edgePropagating: true } : {},
         ...doClassGuard ? { doClassGuard } : {}
       }
     };
@@ -10355,11 +10987,11 @@ Re-run with --allow-do-deletion to accept the data loss.`,
 });
 
 // src/cli/commands/workspace.ts
-import { defineCommand as defineCommand11 } from "citty";
+import { defineCommand as defineCommand12 } from "citty";
 
 // src/cli/commands/workspace/new.ts
 import * as p25 from "@clack/prompts";
-import { isAbsolute as isAbsolute6, resolve as resolve16 } from "path";
+import { isAbsolute as isAbsolute6, resolve as resolve17 } from "path";
 
 // src/cli/commands/workspace/analysis.ts
 import * as p23 from "@clack/prompts";
@@ -10484,7 +11116,7 @@ function printOverlaps(overlaps, json) {
 
 // src/cli/commands/workspace/local.ts
 import * as p24 from "@clack/prompts";
-import { mkdirSync as mkdirSync7, readFileSync as readFileSync26, realpathSync as realpathSync5, renameSync as renameSync2, statSync, writeFileSync as writeFileSync9 } from "fs";
+import { mkdirSync as mkdirSync7, readFileSync as readFileSync26, realpathSync as realpathSync5, renameSync as renameSync2, statSync as statSync3, writeFileSync as writeFileSync9 } from "fs";
 import { dirname as dirname9, isAbsolute as isAbsolute5, join as join22, relative as relative2, sep as sep2 } from "path";
 var WORKSPACE_MARKER = "deepspace-workspace.json";
 function excludeWorktreeDir(appDir, dir) {
@@ -10573,7 +11205,7 @@ function materializeWorkspaceWorktree(appDir, worktreeRoot, branch, startPoint,
 function inOwnLinkedWorktree(appDir, id) {
   if (workspaceIdFromBranch(currentBranch(appDir)) !== id) return false;
   try {
-    return statSync(join22(repoToplevel(appDir), ".git")).isFile();
+    return statSync3(join22(repoToplevel(appDir), ".git")).isFile();
   } catch {
     return false;
   }
@@ -10919,7 +11551,7 @@ var newWorkspaceCommand = defineDeepspaceCommand({
       idempotencyKey: mintIdempotencyKey()
     });
     const dirInput = typeof args.dir === "string" ? args.dir.trim() : "";
-    const worktreeRoot = dirInput ? isAbsolute6(dirInput) ? dirInput : resolve16(appDir, dirInput) : defaultWorkspaceRoot(appDir, id);
+    const worktreeRoot = dirInput ? isAbsolute6(dirInput) ? dirInput : resolve17(appDir, dirInput) : defaultWorkspaceRoot(appDir, id);
     const dir = appDirInWorktree(appDir, worktreeRoot);
     try {
       materializeWorkspaceWorktree(appDir, worktreeRoot, branch, baseOid, id);
@@ -10957,8 +11589,8 @@ var newWorkspaceCommand = defineDeepspaceCommand({
 
 // src/cli/commands/workspace/attach.ts
 import * as p26 from "@clack/prompts";
-import { existsSync as existsSync24, readdirSync as readdirSync7, rmSync as rmSync6 } from "fs";
-import { isAbsolute as isAbsolute7, resolve as resolve17 } from "path";
+import { existsSync as existsSync25, readdirSync as readdirSync7, rmSync as rmSync6 } from "fs";
+import { isAbsolute as isAbsolute7, resolve as resolve18 } from "path";
 function finishedWorkspaceMessage(id, view) {
   const workspace = view.workspace;
   if (workspace.status === "landed") {
@@ -10967,7 +11599,7 @@ function finishedWorkspaceMessage(id, view) {
   return `Workspace ${id} is ${workspace.status} \u2014 its ref is retained briefly (fetch ${workspace.ref} to inspect), but attach only works on active workspaces.`;
 }
 function cleanFailedFreshAttachDir(dir) {
-  if (!existsSync24(dir)) return [];
+  if (!existsSync25(dir)) return [];
   let entries;
   try {
     entries = readdirSync7(dir);
@@ -11043,7 +11675,7 @@ var attachWorkspaceCommand = defineDeepspaceCommand({
         );
       }
       const requestedDir = typeof args.dir === "string" ? args.dir.trim() : "";
-      const worktreeRoot = requestedDir ? isAbsolute7(requestedDir) ? requestedDir : resolve17(appDir, requestedDir) : defaultWorkspaceRoot(appDir, id);
+      const worktreeRoot = requestedDir ? isAbsolute7(requestedDir) ? requestedDir : resolve18(appDir, requestedDir) : defaultWorkspaceRoot(appDir, id);
       const dir2 = appDirInWorktree(appDir, worktreeRoot);
       if (resolveCommit(appDir, `refs/heads/${branch}`)) {
         throw new Refusal(
@@ -11082,11 +11714,11 @@ var attachWorkspaceCommand = defineDeepspaceCommand({
         extra: { status: view.workspace.status }
       });
     }
-    const dir = resolve17(
+    const dir = resolve18(
       process.cwd(),
       (typeof args.dir === "string" ? args.dir.trim() : "") || `ws-${id.slice(3).toLowerCase()}`
     );
-    if (existsSync24(dir)) {
+    if (existsSync25(dir)) {
       spinner2?.stop("Target exists.");
       throw new Refusal(`${dir} already exists \u2014 pass a different directory.`, "dir_exists");
     }
@@ -11232,27 +11864,6 @@ var syncWorkspaceCommand = defineDeepspaceCommand({
 
 // src/cli/commands/workspace/list.ts
 import * as p28 from "@clack/prompts";
-
-// src/cli/lib/actor-labels.ts
-var API_URL9 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
-async function actorLabels(token, appId) {
-  const labels = /* @__PURE__ */ new Map();
-  try {
-    const { sub, email } = decodeJwtPayload(token);
-    if (sub && email) labels.set(sub, `${email} (you)`);
-  } catch {
-  }
-  try {
-    const { collaborators } = await apiFetch(API_URL9, token, `/api/app-collaborators/${encodeURIComponent(appId)}`);
-    for (const c of collaborators) {
-      if (!labels.has(c.userId)) labels.set(c.userId, c.emailDisplay);
-    }
-  } catch {
-  }
-  return labels;
-}
-
-// src/cli/commands/workspace/list.ts
 function withWorkspaceOverlaps(views, overlapsById) {
   return views.map((view) => ({
     ...view,
@@ -11830,7 +12441,7 @@ var dropWorkspaceCommand = defineDeepspaceCommand({
 });
 
 // src/cli/commands/workspace.ts
-var workspace_default = defineCommand11({
+var workspace_default = defineCommand12({
   meta: {
     name: "workspace",
     description: "Durable parallel-agent workspaces (new/attach/sync/list/status/land/drop)"
@@ -12001,7 +12612,7 @@ var activity_default = defineDeepspaceCommand({
 });
 
 // src/cli/commands/git-credential.ts
-import { defineCommand as defineCommand12 } from "citty";
+import { defineCommand as defineCommand13 } from "citty";
 function parseFields(input) {
   const fields = /* @__PURE__ */ new Map();
   for (const line of input.split("\n")) {
@@ -12050,7 +12661,7 @@ async function readStdin() {
   for await (const chunk of process.stdin) data += chunk;
   return data;
 }
-var git_credential_default = defineCommand12({
+var git_credential_default = defineCommand13({
   meta: {
     name: "git-credential",
     description: "Git credential helper (installed automatically; not for direct use)"
@@ -12168,8 +12779,8 @@ function reportSource(appId, state, json) {
 async function moveToGitHub(input) {
   const { appDir, appId, token, deployUrl, state, remoteArg } = input;
   const selected = requireGitHubRemote(appDir, remoteArg);
-  const target = { provider: "github", repository: selected.repository };
-  if (sameSource(state.source, target)) return { source: target, revision: state.revision };
+  const target2 = { provider: "github", repository: selected.repository };
+  if (sameSource(state.source, target2)) return { source: target2, revision: state.revision };
   if (state.source?.provider === "deepspace") {
     requireLocalHead(appDir);
     const api4 = repoApi(deployUrl, token, appId);
@@ -12225,7 +12836,7 @@ async function moveToGitHub(input) {
       );
     }
     return setAppSource(deployUrl, token, appId, {
-      source: target,
+      source: target2,
       expectedRevision: state.revision,
       refs: wanted,
       ...releaseExpectation(latest)
@@ -12233,17 +12844,17 @@ async function moveToGitHub(input) {
   }
   requirePublishedHead(appDir, selected, appId);
   return setAppSource(deployUrl, token, appId, {
-    source: target,
+    source: target2,
     expectedRevision: state.revision
   });
 }
 async function moveToDeepSpace(input) {
   const { appDir, appId, token, deployUrl, state, remoteArg } = input;
-  const target = { provider: "deepspace" };
-  if (sameSource(state.source, target)) return { source: target, revision: state.revision };
+  const target2 = { provider: "deepspace" };
+  if (sameSource(state.source, target2)) return { source: target2, revision: state.revision };
   if (state.source?.provider !== "github") {
     return setAppSource(deployUrl, token, appId, {
-      source: target,
+      source: target2,
       expectedRevision: state.revision
     });
   }
@@ -12277,7 +12888,7 @@ async function moveToDeepSpace(input) {
     );
   }
   return setAppSource(deployUrl, token, appId, {
-    source: target,
+    source: target2,
     expectedRevision: state.revision,
     branch,
     commitOid: oid,
@@ -12905,10 +13516,10 @@ function reportMigration(migration, json) {
 // src/cli/cli.ts
 var __dirname = dirname10(fileURLToPath3(import.meta.url));
 var pkg = JSON.parse(readFileSync28(join24(__dirname, "..", "package.json"), "utf-8"));
-if (process.platform === "linux" && !process.env.SSL_CERT_FILE && existsSync25("/etc/ssl/certs/ca-certificates.crt")) {
+if (process.platform === "linux" && !process.env.SSL_CERT_FILE && existsSync26("/etc/ssl/certs/ca-certificates.crt")) {
   process.env.SSL_CERT_FILE = "/etc/ssl/certs/ca-certificates.crt";
 }
-var create2 = defineCommand13({
+var create2 = defineCommand14({
   meta: {
     name: "create",
     description: "Create a new DeepSpace app (runs create-deepspace; all flags are forwarded)"
@@ -12947,19 +13558,20 @@ var create2 = defineCommand13({
   }
 });
 var rename = (cmd, name) => ({ ...cmd, meta: { ...cmd.meta ?? {}, name } });
-var auth = defineCommand13({
+var auth = defineCommand14({
   meta: { name: "auth", description: "Session: login, logout, whoami" },
   subCommands: { login: login_default, logout: logout_default, whoami: whoami_default }
 });
-var app = defineCommand13({
+var app = defineCommand14({
   meta: {
     name: "app",
-    description: "The app itself: create, init, list, source, migrate, undeploy, transfer, collaborators, domain, usage"
+    description: "The app itself: create, init, list, files, source, migrate, undeploy, transfer, collaborators, domain, usage"
   },
   subCommands: {
     create: create2,
     init: init_default,
     list: rename(apps_default, "list"),
+    files: app_files_default,
     undeploy: undeploy_default,
     transfer: transfer_default,
     collaborators: collaborators_default,
@@ -12969,11 +13581,11 @@ var app = defineCommand13({
     migrate: migrate_default
   }
 });
-var devGroup = defineCommand13({
+var devGroup = defineCommand14({
   meta: { name: "dev", description: "Local development" },
   subCommands: { start: rename(dev_default, "start"), kill: kill_default }
 });
-var testGroup = defineCommand13({
+var testGroup = defineCommand14({
   meta: { name: "test", description: "App tests and test tooling" },
   subCommands: {
     run: rename(test_default, "run"),
@@ -12981,7 +13593,7 @@ var testGroup = defineCommand13({
     accounts: rename(test_accounts_default, "accounts")
   }
 });
-var main = defineCommand13({
+var main = defineCommand14({
   meta: {
     name: "deepspace",
     version: pkg.version,
@@ -13021,7 +13633,7 @@ function commandTree() {
   return main.subCommands ?? {};
 }
 function unknownCommandMessage(unknown) {
-  return `Unknown command: ${unknown.attemptedPath.join(" ")} \u2014 did you mean \`${unknown.suggestion.join(" ")}\`?`;
+  return `Unknown command: ${humanCommand(unknown.attemptedPath)} \u2014 did you mean \`${humanCommand(unknown.suggestion)}\`?` + (unknown.quotedToken ? " The whole command arrived as one quoted argument; pass each word separately." : "");
 }
 function assertKnownCommandPath(argv) {
   const unknown = findUnknownCommand(argv, commandTree());
@@ -13030,7 +13642,7 @@ function assertKnownCommandPath(argv) {
     `${unknownCommandMessage(unknown)}
 Run \`${unknown.helpPath.join(" ")} --help\` for the command list.`
   );
-  printAction({ cwd: process.cwd(), argv: unknown.suggestion });
+  if (unknown.executable) printAction({ cwd: process.cwd(), argv: unknown.suggestion });
   process.exit(1);
 }
 var rawArgs = process.argv.slice(2);
@@ -13052,7 +13664,7 @@ if (rawArgs.includes("--json") && !wantsHelp) {
         ok: false,
         code: "unknown_command",
         error: unknownCommandMessage(unknown),
-        action: { cwd: process.cwd(), argv: unknown.suggestion }
+        ...unknown.executable ? { action: { cwd: process.cwd(), argv: unknown.suggestion } } : {}
       })
     );
     process.exit(1);
@@ -13061,16 +13673,20 @@ if (rawArgs.includes("--json") && !wantsHelp) {
     stopActiveSpinner();
     const cittyCode = err instanceof Error && err.name === "CLIError" ? err.code : void 0;
     const code = cittyCode === "EARG" ? "missing_argument" : cittyCode === "E_UNKNOWN_COMMAND" ? "unknown_command" : cittyCode === "E_NO_COMMAND" ? "no_command" : errorCode(err);
-    const message = (err instanceof Error ? err.message : String(err)).replace(
-      // eslint-disable-next-line no-control-regex
-      /\u001b\[[0-9;]*m/g,
-      ""
-    );
+    const message = stripAnsi(err instanceof Error ? err.message : String(err));
     console.log(JSON.stringify({ ok: false, error: message, ...code ? { code } : {} }));
     process.exit(1);
   });
 } else {
   assertKnownCommandPath(rawArgs);
-  runMain(wrapCommandErrors(main));
+  runMain(wrapCommandErrors(main), {
+    showUsage: async (cmd, parent) => {
+      try {
+        console.log(forTerminal(await renderUsage(cmd, parent)) + "\n");
+      } catch (error) {
+        console.error(error);
+      }
+    }
+  });
 }
 //# sourceMappingURL=cli.js.map