percher 1.1.0 → 1.2.0

package/dist/bin/percher.js

@@ -4751,7 +4751,7 @@ var init_build_env_prefixes = __esm(() => {
 });
 
 // ../client/dist/config.js
-import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync4, renameSync, writeFileSync as writeFileSync4 } from "node:fs";
+import { chmodSync, closeSync, existsSync as existsSync4, fchmodSync, mkdirSync as mkdirSync4, openSync, readFileSync as readFileSync4, renameSync, rmSync as rmSync2, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir } from "node:os";
 import { dirname as dirname4, join as join6 } from "node:path";
 function home() {
@@ -4800,12 +4800,32 @@ function readAnonClaims() {
 }
 function saveConfig(partial2) {
   const p = configPath();
-  mkdirSync4(dirname4(p), { recursive: true });
+  mkdirSync4(dirname4(p), { recursive: true, mode: 448 });
+  if (process.platform !== "win32") {
+    chmodSync(dirname4(p), 448);
+    if (existsSync4(p))
+      chmodSync(p, 384);
+  }
   const current = readFile2();
   const merged = { ...current, ...partial2 };
   const tmp = `${p}.tmp-${process.pid}-${Date.now()}`;
-  writeFileSync4(tmp, JSON.stringify(merged, null, 2), "utf8");
-  renameSync(tmp, p);
+  let fd;
+  let created = false;
+  try {
+    fd = openSync(tmp, "wx", 384);
+    created = true;
+    if (process.platform !== "win32")
+      fchmodSync(fd, 384);
+    writeFileSync4(fd, JSON.stringify(merged, null, 2), "utf8");
+    closeSync(fd);
+    fd = undefined;
+    renameSync(tmp, p);
+  } finally {
+    if (fd !== undefined)
+      closeSync(fd);
+    if (created)
+      rmSync2(tmp, { force: true });
+  }
 }
 function getAnonClaim(app) {
   return readAnonClaims()[app] ?? null;
@@ -4830,7 +4850,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@percher/client",
-    version: "1.1.0",
+    version: "1.2.0",
     description: "Official TypeScript SDK for Percher: deploy apps, manage env vars, stream logs, and automate hosting workflows.",
     keywords: [
       "percher",
@@ -5384,10 +5404,11 @@ class AppsResource {
   deleteIconImage(appRef) {
     return this.http.deleteJson(`/apps/${encodeURIComponent(appRef)}/icon/image`);
   }
-  uploadPreviewImage(appRef, bytes, mime) {
+  uploadPreviewImage(appRef, bytes, mime, orientation) {
     const ab = new ArrayBuffer(bytes.byteLength);
     new Uint8Array(ab).set(bytes);
-    return this.http.postBinary(`/apps/${encodeURIComponent(appRef)}/preview/image`, new Blob([ab]), { "Content-Type": mime });
+    const query = orientation ? `?orientation=${orientation}` : "";
+    return this.http.postBinary(`/apps/${encodeURIComponent(appRef)}/preview/image${query}`, new Blob([ab]), { "Content-Type": mime });
   }
   deletePreviewImage(appRef) {
     return this.http.deleteJson(`/apps/${encodeURIComponent(appRef)}/preview/image`);
@@ -6262,6 +6283,55 @@ var init_env_file = __esm(() => {
   };
 });
 
+// ../client/dist/telemetry-consent.js
+import { chmodSync as chmodSync2, mkdirSync as mkdirSync5, readFileSync as readFileSync5, renameSync as renameSync2, rmSync as rmSync3, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname5, join as join7 } from "node:path";
+function consentPath() {
+  return join7(dirname5(configPath()), "telemetry.json");
+}
+function envOptOut() {
+  if (process.env.PERCHER_NO_TELEMETRY === "1" || process.env.PERCHER_NO_TELEMETRY === "true") {
+    return "PERCHER_NO_TELEMETRY";
+  }
+  if (process.env.DO_NOT_TRACK === "1")
+    return "DO_NOT_TRACK";
+  return null;
+}
+function readStored() {
+  try {
+    const parsed = JSON.parse(readFileSync5(consentPath(), "utf8"));
+    if (typeof parsed?.enabled === "boolean" && typeof parsed.decidedAt === "string" && typeof parsed.version === "string") {
+      return { enabled: parsed.enabled, decidedAt: parsed.decidedAt, version: parsed.version };
+    }
+  } catch {}
+  return null;
+}
+function telemetryState() {
+  const optOut = envOptOut();
+  const stored = readStored();
+  return { enabled: optOut === null && stored?.enabled === true, envOptOut: optOut, stored };
+}
+function saveTelemetryAnswer(enabled, version2) {
+  const p = consentPath();
+  mkdirSync5(dirname5(p), { recursive: true, mode: 448 });
+  if (process.platform !== "win32")
+    chmodSync2(dirname5(p), 448);
+  const answer = { enabled, decidedAt: new Date().toISOString(), version: version2 };
+  const tmp = `${p}.tmp-${process.pid}-${Date.now()}`;
+  try {
+    writeFileSync5(tmp, `${JSON.stringify(answer, null, 2)}
+`, { mode: 384, flag: "wx" });
+    if (process.platform !== "win32")
+      chmodSync2(tmp, 384);
+    renameSync2(tmp, p);
+  } finally {
+    rmSync3(tmp, { force: true });
+  }
+}
+var init_telemetry_consent = __esm(() => {
+  init_config();
+});
+
 // ../client/dist/index.js
 var init_dist = __esm(() => {
   init_build_env_prefixes();
@@ -6272,6 +6342,7 @@ var init_dist = __esm(() => {
   init_apps();
   init_auth();
   init_logs();
+  init_telemetry_consent();
 });
 
 // ../../node_modules/.bun/ignore@7.0.5/node_modules/ignore/index.js
@@ -10582,7 +10653,7 @@ var require_util = __commonJS((exports) => {
     return path;
   }
   exports.normalize = normalize2;
-  function join18(aRoot, aPath) {
+  function join19(aRoot, aPath) {
     if (aRoot === "") {
       aRoot = ".";
     }
@@ -10614,7 +10685,7 @@ var require_util = __commonJS((exports) => {
     }
     return joined;
   }
-  exports.join = join18;
+  exports.join = join19;
   exports.isAbsolute = function(aPath) {
     return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
   };
@@ -10787,7 +10858,7 @@ var require_util = __commonJS((exports) => {
           parsed.path = parsed.path.substring(0, index + 1);
         }
       }
-      sourceURL = join18(urlGenerate(parsed), sourceURL);
+      sourceURL = join19(urlGenerate(parsed), sourceURL);
     }
     return normalize2(sourceURL);
   }
@@ -92667,13 +92738,13 @@ function iconColourHex(token) {
 }
 // ../shared/dist/legal.js
 var LEGAL_DOCUMENT_VERSIONS = {
-  terms: "1.0.2",
+  terms: "1.0.3",
   aup: "1.0.1",
-  privacy: "1.0.2",
-  cookies: "1.0.3",
-  dpa: "1.0",
-  subprocessors: "1.0.2",
-  dataPortability: "1.0"
+  privacy: "1.0.4",
+  cookies: "1.0.4",
+  dpa: "1.1",
+  subprocessors: "1.2",
+  dataPortability: "1.0.4"
 };
 var CURRENT_TERMS_VERSION = LEGAL_DOCUMENT_VERSIONS.terms;
 // ../shared/dist/legal-changes.js
@@ -92796,6 +92867,7 @@ var SWITCHES = [
   },
   bool("PERCHER_ALLOW_NO_CAPTCHA", ["dashboard"], "allow production without Turnstile", ONE),
   bool("PERCHER_ALLOW_UNVERIFIED_SIGNUP", ["dashboard"], "allow production without Resend", ONE),
+  bool("PERCHER_DASHBOARD_SECRET_BUILD", ["dashboard"], "allow an ephemeral BetterAuth key during `next build` only, never at runtime", ONE),
   bool("PERCHER_ALLOW_NO_ALERTING", ["api"], "boot without an alert channel", ONE),
   {
     kind: "presence",
@@ -106437,7 +106509,7 @@ var ENV_NAME_SHAPE = "UPPER_SNAKE_CASE, at most 256 characters";
 var buildSchema = exports_external.object({
   command: exports_external.string().optional(),
   output: exports_external.string().refine((v) => !v.startsWith("/"), "must be a relative path (no leading slash)").optional(),
-  pass_env: exports_external.array(exports_external.string().regex(ENV_NAME_RE2, `must be a valid env var name (${ENV_NAME_SHAPE})`).refine((name) => !name.startsWith("BUILDKIT_"), "BUILDKIT_* names are reserved by Percher and cannot be passed to the build")).max(50, "at most 50 build env vars can be exposed").optional()
+  pass_env: exports_external.array(exports_external.string().regex(ENV_NAME_RE2, `must be a valid env var name (${ENV_NAME_SHAPE})`).refine((name) => !name.startsWith("BUILDKIT_") && name !== "PERCHER_BUILD_SECRET_DIGEST", "BUILDKIT_* and PERCHER_BUILD_SECRET_DIGEST are reserved by Percher and cannot be passed to the build")).max(50, "at most 50 build env vars can be exposed").optional()
 }).strict();
 var webSchema = exports_external.object({
   port: exports_external.number().int().min(1024).max(65535),
@@ -107774,20 +107846,32 @@ function manifestStarter({ name, themeColorHex }) {
     theme_color: themeColorHex
   }, null, 2);
 }
-function serviceWorkerStarter() {
-  return `// sw.js — minimal offline shell. Drop in at your app root and serve from /sw.js.
-const CACHE = "app-shell-v1";
-const SHELL = ["/"];
+function serviceWorkerStarter(assets = []) {
+  if (assets.some((path) => !path.startsWith("/") || path.startsWith("//") || path.includes("\\"))) {
+    throw new Error("Offline assets must be same-origin absolute paths");
+  }
+  return `// sw.js — public offline shell. Serve from /sw.js.
+// Add public assets, e.g. ["/offline.html", "/app.js", "/app.css"]. Never add private pages or API data.
+// Include "/" only if the page is public and identical for signed-in and anonymous visitors.
+// Bump CACHE whenever the asset list or its content changes. Test an offline reload.
+const CACHE = "percher-public-shell-v1";
+const SHELL = ${JSON.stringify(assets)};
 
 self.addEventListener("install", (event) => {
-  event.waitUntil(caches.open(CACHE).then((cache) => cache.addAll(SHELL)));
+  event.waitUntil(caches.open(CACHE).then((cache) => Promise.all(SHELL.map(async (path) => {
+    const response = await fetch(path, { credentials: "omit", redirect: "error" });
+    if (!response.ok || /private|no-store/i.test(response.headers.get("cache-control") || "")) {
+      throw new Error("Offline asset is unavailable or private: " + path);
+    }
+    await cache.put(path, response);
+  }))));
   self.skipWaiting();
 });
 
 self.addEventListener("activate", (event) => {
   event.waitUntil(
     caches.keys().then((keys) =>
-      Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k))),
+      Promise.all(keys.filter((k) => k.startsWith("percher-public-shell-") && k !== CACHE).map((k) => caches.delete(k))),
     ),
   );
   self.clients.claim();
@@ -107795,8 +107879,10 @@ self.addEventListener("activate", (event) => {
 
 self.addEventListener("fetch", (event) => {
   if (event.request.method !== "GET") return;
+  const url = new URL(event.request.url);
+  if (url.origin !== self.location.origin || !SHELL.includes(url.pathname + url.search)) return;
   event.respondWith(
-    caches.match(event.request).then((cached) => cached || fetch(event.request)),
+    caches.open(CACHE).then((cache) => cache.match(event.request)).then((cached) => cached || fetch(event.request)),
   );
 });`;
 }
@@ -107965,17 +108051,17 @@ async function claim(ctx, input = {}) {
   };
 }
 // ../core/dist/commands/create.js
-import { join as join8, resolve as resolve5 } from "node:path";
+import { join as join9, resolve as resolve5 } from "node:path";
 
 // ../core/dist/templates.js
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, readdirSync, readFileSync as readFileSync5, statSync, writeFileSync as writeFileSync5 } from "node:fs";
-import { basename as basename2, join as join7, normalize, relative as relative2, resolve as resolve4 } from "node:path";
-var __dirname = "C:\\dev\\Percher\\packages\\core\\dist";
+import { existsSync as existsSync5, mkdirSync as mkdirSync6, readdirSync, readFileSync as readFileSync6, statSync, writeFileSync as writeFileSync6 } from "node:fs";
+import { basename as basename2, join as join8, normalize, relative as relative2, resolve as resolve4 } from "node:path";
+var __dirname = "D:\\dev\\Percher-codex-clone\\packages\\core\\dist";
 var TEMPLATES_DIR = resolve4(import.meta.dirname ?? __dirname, "../templates");
 var PLACEHOLDER = "__APP_NAME__";
 function listTemplates() {
   return readdirSync(TEMPLATES_DIR).filter((name) => {
-    const full = join7(TEMPLATES_DIR, name);
+    const full = join8(TEMPLATES_DIR, name);
     return statSync(full).isDirectory();
   });
 }
@@ -107992,13 +108078,13 @@ function scaffoldTemplate(input) {
       throw new Error(`Target directory "${absTarget}" is not empty. Use --force to overwrite.`);
     }
   }
-  const srcDir = join7(TEMPLATES_DIR, template);
+  const srcDir = join8(TEMPLATES_DIR, template);
   const files = [];
   function copyDir(src, dest) {
-    mkdirSync5(dest, { recursive: true });
+    mkdirSync6(dest, { recursive: true });
     for (const entry of readdirSync(src)) {
-      const srcPath = join7(src, entry);
-      const destPath = join7(dest, entry);
+      const srcPath = join8(src, entry);
+      const destPath = join8(dest, entry);
       const rel = relative2(absTarget, normalize(destPath));
       if (rel.startsWith("..") || resolve4(destPath) === resolve4(absTarget, "..", basename2(absTarget))) {
         throw new Error(`Template contains path traversal: ${entry}`);
@@ -108009,11 +108095,11 @@ function scaffoldTemplate(input) {
         if (existsSync5(destPath) && !force) {
           continue;
         }
-        let content = readFileSync5(srcPath, "utf-8");
+        let content = readFileSync6(srcPath, "utf-8");
         content = content.replaceAll(PLACEHOLDER, appName);
         content = content.replace(/\r\n/g, `
 `);
-        writeFileSync5(destPath, content, "utf-8");
+        writeFileSync6(destPath, content, "utf-8");
         files.push(relative2(absTarget, destPath).replace(/\\/g, "/"));
       }
     }
@@ -108046,7 +108132,7 @@ async function create(ctx, input) {
       });
     }
   } else {
-    targetDir = join8(ctx.cwd, input.name);
+    targetDir = join9(ctx.cwd, input.name);
   }
   try {
     const result = scaffoldTemplate({
@@ -108101,6 +108187,144 @@ async function dashboard(ctx, input = {}) {
   await ctx.openUrl(url2);
   return url2;
 }
+// ../core/dist/untrusted.js
+import { relative as relative3 } from "node:path";
+function boundedSeconds(value, maxSeconds = 86400) {
+  if (typeof value !== "number" || !Number.isFinite(value))
+    return null;
+  if (value <= 0 || value > maxSeconds)
+    return null;
+  return Math.ceil(value);
+}
+function boundedCount(value, max = 1e6) {
+  if (typeof value !== "number" || !Number.isInteger(value))
+    return null;
+  if (value < 0 || value > max)
+    return null;
+  return value;
+}
+var ISO_INSTANT = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?(?:Z|([+-])(\d{2}):(\d{2}))$/;
+function daysInMonth(year, month) {
+  return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+function isoInstant(value, opts = {}) {
+  if (typeof value !== "string")
+    return null;
+  const match = ISO_INSTANT.exec(value);
+  if (!match)
+    return null;
+  const [, y, mo, d, h, mi, s, , offH, offM] = match;
+  const year = Number(y);
+  const month = Number(mo);
+  const day = Number(d);
+  if (month < 1 || month > 12)
+    return null;
+  if (day < 1 || day > daysInMonth(year, month))
+    return null;
+  if (Number(h) > 23 || Number(mi) > 59)
+    return null;
+  if (s !== undefined && Number(s) > 59)
+    return null;
+  if (offH !== undefined && (Number(offH) > 14 || Number(offM) > 59))
+    return null;
+  const ms = new Date(value).getTime();
+  if (Number.isNaN(ms))
+    return null;
+  const now = (opts.now ?? Date.now)();
+  const delta = ms - now;
+  if (delta < -(opts.maxPastMs ?? 60 * 60000))
+    return null;
+  if (delta > (opts.maxFutureMs ?? 48 * 60 * 60000))
+    return null;
+  return value;
+}
+var ERROR_CODE = /^[A-Z][A-Z0-9_]{0,63}$/;
+function errorCode(value) {
+  return typeof value === "string" && ERROR_CODE.test(value) ? value : null;
+}
+function quotaKind(value) {
+  return value === "live" || value === "preview" ? value : null;
+}
+function isEnvKey(value) {
+  return typeof value === "string" && /^[A-Za-z_][A-Za-z0-9_]{0,127}$/.test(value);
+}
+function envKeyList(value, max = 50) {
+  if (!Array.isArray(value))
+    return [];
+  return [...new Set(value.filter(isEnvKey))].slice(0, max);
+}
+var MINTED_ID = /^[a-z0-9][a-z0-9_-]{0,39}$/;
+function idToken(value) {
+  return typeof value === "string" && MINTED_ID.test(value) ? value : null;
+}
+function appRef(value) {
+  return idToken(value);
+}
+var CONFIG_KEY_SEGMENT = /^[A-Za-z0-9_][A-Za-z0-9_-]{0,63}$/;
+function configKeyPath(segments, maxDepth = 8) {
+  if (!Array.isArray(segments) || segments.length === 0)
+    return null;
+  const parts = [];
+  for (const segment of segments.slice(0, maxDepth)) {
+    if (typeof segment === "number") {
+      if (!Number.isInteger(segment) || segment < 0 || segment > 9999)
+        break;
+      parts.push(String(segment));
+      continue;
+    }
+    if (typeof segment !== "string" || !CONFIG_KEY_SEGMENT.test(segment))
+      break;
+    parts.push(segment);
+  }
+  return parts.length > 0 ? parts.join(".") : null;
+}
+function boundedLine(value, max = 1e7) {
+  if (typeof value !== "number" || !Number.isInteger(value))
+    return null;
+  if (value < 1 || value > max)
+    return null;
+  return value;
+}
+function parseRemoteEnvProblems(value, max = 50) {
+  if (!Array.isArray(value))
+    return [];
+  const out = [];
+  const scanLimit = Math.min(value.length, max * 20);
+  for (let i = 0;i < scanLimit; i++) {
+    const entry = value[i];
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry))
+      continue;
+    const { key, file: file2, line } = entry;
+    if (!isEnvKey(key) || !isSafeRelativePath(file2))
+      continue;
+    const parsedLine = boundedLine(line);
+    out.push({ key, file: file2, ...parsedLine !== null ? { line: parsedLine } : {} });
+    if (out.length >= max)
+      break;
+  }
+  return out;
+}
+var PATH_SEGMENT = /^[A-Za-z0-9._@+ ()'[\]-]+$/;
+var RESERVED_DEVICE_NAME = /^(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i;
+function isSafeRelativePath(value) {
+  if (typeof value !== "string" || value.length === 0 || value.length > 1024)
+    return false;
+  if (value.includes("\x00"))
+    return false;
+  const segments = value.replace(/\\/g, "/").split("/");
+  return segments.every((s) => {
+    if (s === "." || s === ".." || !PATH_SEGMENT.test(s))
+      return false;
+    if (/[ .]$/.test(s))
+      return false;
+    return !RESERVED_DEVICE_NAME.test(s);
+  });
+}
+function projectRelative(cwd, abs) {
+  const rel = relative3(cwd, abs);
+  return isSafeRelativePath(rel) ? rel : null;
+}
+
 // ../core/dist/commands/data.js
 var dataInputSchema = exports_external.object({
   app: exports_external.string().optional(),
@@ -108126,7 +108350,9 @@ async function data(ctx, input = {}) {
   } catch (err) {
     const code = err.code;
     if (code === "PB_AUTH_FAILED") {
-      warning = `Could not authenticate with PocketBase — collections + stats unavailable. Try \`percher data reset-superuser ${name}\` to rotate the credentials.`;
+      const ref = appRef(name) ?? "<app>";
+      const verdict = err.extra?.verdict;
+      warning = verdict === "rejected" ? `Percher has no working PocketBase admin credentials for this app; collections and counts are unavailable. The app owner can issue new ones with \`percher data reset-superuser ${ref}\`.` : `PocketBase authentication failed; collections and counts are unavailable. Retry \`percher data ${ref}\`; if this continues, contact support.`;
     } else {
       throw err;
     }
@@ -108253,7 +108479,7 @@ function isTransientPollError(err) {
   if (isTransientNetworkError(err))
     return true;
   if (err instanceof PercherApiError)
-    return err.status === 502 || err.status === 503 || err.status === 504;
+    return err.status === 429 || err.status === 502 || err.status === 503 || err.status === 504;
   return err instanceof TypeError && /terminated/i.test(err.message);
 }
 async function pollDeployment(opts) {
@@ -108287,7 +108513,7 @@ async function pollDeployment(opts) {
           throw err;
         if (attempt === 1) {
           streakStartedAt = Date.now();
-          opts.ctx.status("Lost contact with Percher; retrying while the deploy continues...");
+          opts.ctx.status(err instanceof PercherApiError && err.status === 429 ? "Percher asked this client to slow down; retrying while the deploy continues..." : "Lost contact with Percher; retrying while the deploy continues...");
         }
         if (Date.now() - startedAt > timeoutMs)
           opts.onTimeout(deployment);
@@ -108321,143 +108547,204 @@ async function drainNewEvents(opts, deployId, seenEventIds) {
   } catch {}
 }
 
-// ../core/dist/untrusted.js
-import { relative as relative3 } from "node:path";
-function boundedSeconds(value, maxSeconds = 86400) {
-  if (typeof value !== "number" || !Number.isFinite(value))
-    return null;
-  if (value <= 0 || value > maxSeconds)
-    return null;
-  return Math.ceil(value);
-}
-function boundedCount(value, max = 1e6) {
-  if (typeof value !== "number" || !Number.isInteger(value))
-    return null;
-  if (value < 0 || value > max)
-    return null;
-  return value;
-}
-var ISO_INSTANT = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?(?:Z|([+-])(\d{2}):(\d{2}))$/;
-function daysInMonth(year, month) {
-  return new Date(Date.UTC(year, month, 0)).getUTCDate();
-}
-function isoInstant(value, opts = {}) {
-  if (typeof value !== "string")
-    return null;
-  const match = ISO_INSTANT.exec(value);
-  if (!match)
-    return null;
-  const [, y, mo, d, h, mi, s, , offH, offM] = match;
-  const year = Number(y);
-  const month = Number(mo);
-  const day = Number(d);
-  if (month < 1 || month > 12)
-    return null;
-  if (day < 1 || day > daysInMonth(year, month))
-    return null;
-  if (Number(h) > 23 || Number(mi) > 59)
-    return null;
-  if (s !== undefined && Number(s) > 59)
-    return null;
-  if (offH !== undefined && (Number(offH) > 14 || Number(offM) > 59))
-    return null;
-  const ms = new Date(value).getTime();
-  if (Number.isNaN(ms))
-    return null;
-  const now = (opts.now ?? Date.now)();
-  const delta = ms - now;
-  if (delta < -(opts.maxPastMs ?? 60 * 60000))
-    return null;
-  if (delta > (opts.maxFutureMs ?? 48 * 60 * 60000))
-    return null;
-  return value;
-}
-var ERROR_CODE = /^[A-Z][A-Z0-9_]{0,63}$/;
-function errorCode(value) {
-  return typeof value === "string" && ERROR_CODE.test(value) ? value : null;
-}
-function quotaKind(value) {
-  return value === "live" || value === "preview" ? value : null;
-}
-function isEnvKey(value) {
-  return typeof value === "string" && /^[A-Za-z_][A-Za-z0-9_]{0,127}$/.test(value);
-}
-function envKeyList(value, max = 50) {
-  if (!Array.isArray(value))
-    return [];
-  return [...new Set(value.filter(isEnvKey))].slice(0, max);
-}
-var MINTED_ID = /^[a-z0-9][a-z0-9_-]{0,39}$/;
-function idToken(value) {
-  return typeof value === "string" && MINTED_ID.test(value) ? value : null;
-}
-function appRef(value) {
-  return idToken(value);
-}
-var CONFIG_KEY_SEGMENT = /^[A-Za-z0-9_][A-Za-z0-9_-]{0,63}$/;
-function configKeyPath(segments, maxDepth = 8) {
-  if (!Array.isArray(segments) || segments.length === 0)
-    return null;
-  const parts = [];
-  for (const segment of segments.slice(0, maxDepth)) {
-    if (typeof segment === "number") {
-      if (!Number.isInteger(segment) || segment < 0 || segment > 9999)
-        break;
-      parts.push(String(segment));
-      continue;
-    }
-    if (typeof segment !== "string" || !CONFIG_KEY_SEGMENT.test(segment))
-      break;
-    parts.push(segment);
+// ../core/dist/structured-error-codes.js
+var MAPPINGS = {
+  PB_PROVISION_FAILED: {
+    errorClass: "pb_provision_failed",
+    phase: "infra",
+    cause: "pb_provision_failed",
+    title: "Database admin setup failed",
+    explanation: () => "The platform could not set up the database admin account.",
+    suggestion: "Publishing again after the platform failure is resolved is safe."
+  },
+  BUILD_SECRET_KEY_UNAVAILABLE: {
+    errorClass: "build_secrets_unavailable",
+    phase: "infra",
+    cause: "build_secret_key_unavailable",
+    title: "Percher could not protect build secrets",
+    explanation: () => "Percher's key for build secrets is unavailable, so it refused the build rather than run it without them. This is a platform issue and does not count against your app.",
+    suggestion: "Contact support. Removing the non-public keys from [build] pass_env lets the build run without them."
+  },
+  BUILD_SECRETS_UNSUPPORTED_NIXPACKS: {
+    errorClass: "build_secrets_unavailable",
+    phase: "infra",
+    cause: "build_secrets_unsupported_nixpacks",
+    title: "This builder cannot mount build secrets",
+    explanation: () => "Percher is building this app with its fallback builder, which cannot keep build secrets out of the image, so it refused the build. It does not count against your app.",
+    suggestion: "Remove the non-public keys from [build] pass_env, or deploy again later."
+  },
+  SHARED_NETWORK_FORBIDDEN: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "shared_network_forbidden",
+    title: "Percher refused unsafe network placement",
+    explanation: () => "This app is still on Percher's shared bridge. Percher refused to start another container there. This is a platform issue and does not count against your app.",
+    suggestion: "Contact support. A Percher operator must migrate the app to its own network before you retry."
+  },
+  PLATFORM_DISK_LOW: {
+    errorClass: "platform_at_capacity",
+    phase: "infra",
+    cause: "disk_headroom_exhausted",
+    title: "Platform storage is too low",
+    explanation: () => "Percher paused new deploys: the platform is nearly out of disk. Not your app — nothing to change. Deployed apps keep running; only new deploys are paused.",
+    suggestion: "The operator is alerted automatically. Run `percher publish` again in ~15 min; this failure does not count against your app. Still failing after an hour: https://percher.app/status"
+  },
+  PLATFORM_DISK_UNKNOWN: {
+    errorClass: "platform_at_capacity",
+    phase: "infra",
+    cause: "disk_state_unreadable",
+    title: "Platform storage state is unknown",
+    explanation: () => "Percher paused new deploys: it can't read how much disk is left, and won't assume there's room. Not your app. Deployed apps have not been stopped by this.",
+    suggestion: "Run `percher publish` again in ~5 min; this failure does not count against your app. Still failing after 15 min: https://percher.app/status"
+  },
+  PLAN_POOL_EXCEEDED: {
+    errorClass: "plan_pool_exceeded",
+    phase: "start",
+    cause: "plan_pool_exceeded",
+    title: "Plan resource pool is full",
+    explanation: (raw) => raw ? `${trimMessage(raw)} The platform is fine — the account is at its plan's limit.` : "This deploy would commit more RAM, vCPU or disk than your plan's pool allows across all your apps. The platform is fine — the account is at its limit.",
+    suggestion: "Reduce `[resources]` in this app's percher.toml, delete an app you no longer need, or upgrade at https://percher.app/account/billing. Retrying unchanged will fail the same way."
+  },
+  PLACEMENT_UNDETERMINED: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "placement_undetermined",
+    title: "Percher could not place your app's container",
+    explanation: (raw) => raw ? `${trimMessage(raw)} This is a platform-side read of Percher's own container placement, not anything in your app.` : "Percher could not read which internal network this app's current containers are on, and refused to guess rather than risk splitting the app from its database across two networks.",
+    suggestion: "Nothing to change in your app. Retry in a minute; if it persists, the platform is having trouble reaching its container daemon and Percher's operators are alerted."
+  },
+  PLATFORM_MEMORY_LOW: {
+    errorClass: "platform_at_capacity",
+    phase: "infra",
+    cause: "box_admission_rejected",
+    title: "Platform is at capacity",
+    explanation: (raw) => raw ? `Percher couldn't fit this deploy on the box right now: ${trimMessage(raw)} Not your app — nothing to change. Deployed apps keep running.` : "Percher couldn't fit this deploy on the box right now — the admission gate refused to start the container. Not your app — nothing to change. Deployed apps keep running.",
+    suggestion: "Run `percher publish` again in a few minutes; capacity frees up as other deploys finish, and this failure does not count against your app. Still failing after an hour: https://percher.app/status"
+  },
+  PB_BRIDGE_UNAVAILABLE: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "pb_bridge_unreachable",
+    title: "PocketBase is unreachable from the platform",
+    explanation: (raw) => raw ? `Percher could not reach your app's database through its internal bridge: ${trimMessage(raw)}. This is a platform-side issue — your data and your code are both fine.` : "Percher could not reach your app's database through its internal bridge. This is a platform-side issue — your data and your code are both fine.",
+    suggestion: "Wait a minute and run `percher publish` again; this failure does not count against your app. Your data was not touched — the platform could not read it, which is not the same as it being missing. Still failing after 15 min: https://percher.app/status"
+  },
+  PB_ROTATION_UNVERIFIED: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "pb_rotation_unverified",
+    title: "PocketBase admin password was rotated but not confirmed",
+    explanation: (raw) => raw ? `${trimMessage(raw)} The rotation itself ran, so the previously stored admin password may now be stale. Your app data was not modified — only the admin credential changed.` : "Percher rotated your app's PocketBase admin password, then could not confirm the rotation. The previously stored admin password may now be stale. Your app data was not modified — only the admin credential changed.",
+    suggestion: "Run the superuser reset again (`percher data reset-superuser` or the dashboard's reset button) — the rotation is idempotent, and a successful re-run stores a fresh working credential. This failure does not count against your app."
+  },
+  PB_OPERATION_BUSY: {
+    errorClass: "pb_operation_busy",
+    phase: "start",
+    cause: "pb_backup_restore_busy",
+    title: "PocketBase is finishing another data operation",
+    explanation: (raw) => raw ? `${trimMessage(raw)} The operation is scoped to this app and must finish before Percher can create the deploy checkpoint.` : "PocketBase is already creating a backup or restoring data for this app, so Percher could not create the deploy checkpoint yet.",
+    suggestion: "Wait for the current backup, export or restore to finish, then publish again. If no operation is visible after a few minutes, contact support before retrying repeatedly."
+  },
+  CANARY_FAILED: {
+    errorClass: "runtime_crash",
+    phase: "start",
+    cause: "canary_failed",
+    title: "Your app went live, then failed its post-deploy check",
+    explanation: (raw) => raw ? `${trimMessage(raw)} The container started and passed its health check, so this is something that only shows up once the app is serving real requests.` : "Percher swapped your new version in, then its own public URL did not answer correctly. The container started and passed its health check, so this is something that only shows up once the app is serving real requests.",
+    suggestion: "Run `percher doctor` — it re-probes the container and the public route and will say which half is failing. The container log from the moment it was rolled back is in the build log below. Retrying unchanged will usually fail the same way."
+  },
+  APP_DATA_MOUNT_CONFLICT: {
+    errorClass: "app_data_mount_conflict",
+    phase: "start",
+    cause: "app_data_mount_conflict",
+    title: "Your image has a file where Percher mounts /app/data",
+    explanation: () => "The image built, but Docker could not start the container: every Percher app gets its persistent data volume mounted at /app/data, and this image has a file (or a link to one) at /app or /app/data, so that directory cannot be created.",
+    suggestion: "Install the binary somewhere else, such as /usr/local/bin/app, and point ENTRYPOINT/CMD at it. If the project has a file named `data` at its root, rename it. Retrying unchanged will fail the same way."
+  },
+  WORKER_UNAVAILABLE: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "worker_fetch_failed",
+    title: "Build worker is unreachable",
+    explanation: (raw) => raw ? `The Percher build worker did not respond in time: ${trimMessage(raw)}. This is a platform-side issue, not your code.` : "The Percher build worker did not respond in time. This is a platform-side issue, not your code.",
+    suggestion: "Wait 30 seconds and run `percher publish` again. If retry #2 also fails, pause 5 minutes before the next attempt — back-to-back retries during a partial outage just waste your time. After 3 spaced-out retries, check status.percher.app or contact support. Your build never started."
+  },
+  WORKER_UNAVAILABLE_PERSISTENT: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "worker_circuit_breaker_open",
+    title: "Build worker is in a crash loop",
+    explanation: () => "The Percher build worker has failed repeatedly in the last minute and the platform's circuit breaker has flipped open. Retrying immediately would just queue more failures.",
+    suggestion: "Wait 2-3 minutes for the platform to recover, then retry. If it persists past 5 minutes check status.percher.app or contact support — this is a platform incident, not your code."
+  },
+  BUILD_TIMEOUT: {
+    errorClass: "build_failed",
+    phase: "build",
+    cause: "build_timeout",
+    title: "Build timed out",
+    explanation: () => "The build ran longer than the 10-minute platform limit and was aborted.",
+    suggestion: "Common causes: a slow `postinstall` hook, very large dependency tree, or a Dockerfile that pulls a huge base image. Try `bun install` locally and check what's slow. If it's legitimately a heavy build, contact support to discuss raising the limit for your account."
+  },
+  BUILD_FAILED: {
+    errorClass: "build_failed",
+    phase: "build",
+    cause: "build_nonzero_exit",
+    title: "Build failed",
+    explanation: (raw) => raw ? `The build process returned a non-zero exit code: ${trimMessage(raw)}. Read the build log below for the exact error.` : "The build process returned a non-zero exit code. Read the build log below for the exact error.",
+    suggestion: "Run your build locally to reproduce: `bun install && bun run build`. The error in the build log usually points to a missing dependency, a TypeScript/syntax error, or a misconfigured framework setting."
+  },
+  WORKER_ERROR: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "worker_internal_error",
+    title: "Platform error inside the build worker",
+    explanation: (raw) => raw ? `The build worker hit an internal error: ${trimMessage(raw)}. This is a Percher bug, not your code.` : "The build worker hit an internal error. This is a Percher bug, not your code.",
+    suggestion: "Retry once — transient platform errors usually clear within a minute. If it repeats, please report it: include the deploy ID and we'll investigate. Your account is not at fault."
+  },
+  WORKER_ENDPOINT_MISSING: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "worker_endpoint_missing",
+    title: "Platform worker is mid-upgrade",
+    explanation: (raw) => raw ? `${trimMessage(raw)} The platform's worker process predates an endpoint this request needs — a rolling-deploy skew, not your code.` : "The platform's worker process predates an endpoint this request needs — a rolling-deploy skew, not your code.",
+    suggestion: "Retry in a few minutes; the operator finishes the platform deploy worker-first. This failure does not count against your app."
+  },
+  DEPLOY_STALLED: {
+    errorClass: "infra_unavailable",
+    phase: "infra",
+    cause: "deploy_stalled",
+    title: "Deploy stalled",
+    explanation: () => "The platform abandoned this deploy — likely because the API or build worker restarted mid-build. Your code is fine; the build never finished.",
+    suggestion: "Run `percher publish` again. The new deploy will start fresh. If you see this repeatedly across multiple publishes, check status.percher.app — it implies a recurring platform issue."
   }
-  return parts.length > 0 ? parts.join(".") : null;
-}
-function boundedLine(value, max = 1e7) {
-  if (typeof value !== "number" || !Number.isInteger(value))
+};
+function classifyByErrorCode(code, rawMessage) {
+  if (!code)
     return null;
-  if (value < 1 || value > max)
+  const mapping = MAPPINGS[code];
+  if (!mapping)
     return null;
-  return value;
-}
-function parseRemoteEnvProblems(value, max = 50) {
-  if (!Array.isArray(value))
-    return [];
-  const out = [];
-  const scanLimit = Math.min(value.length, max * 20);
-  for (let i = 0;i < scanLimit; i++) {
-    const entry = value[i];
-    if (typeof entry !== "object" || entry === null || Array.isArray(entry))
-      continue;
-    const { key, file: file2, line } = entry;
-    if (!isEnvKey(key) || !isSafeRelativePath(file2))
-      continue;
-    const parsedLine = boundedLine(line);
-    out.push({ key, file: file2, ...parsedLine !== null ? { line: parsedLine } : {} });
-    if (out.length >= max)
-      break;
-  }
-  return out;
-}
-var PATH_SEGMENT = /^[A-Za-z0-9._@+ ()'[\]-]+$/;
-var RESERVED_DEVICE_NAME = /^(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i;
-function isSafeRelativePath(value) {
-  if (typeof value !== "string" || value.length === 0 || value.length > 1024)
-    return false;
-  if (value.includes("\x00"))
-    return false;
-  const segments = value.replace(/\\/g, "/").split("/");
-  return segments.every((s) => {
-    if (s === "." || s === ".." || !PATH_SEGMENT.test(s))
-      return false;
-    if (/[ .]$/.test(s))
-      return false;
-    return !RESERVED_DEVICE_NAME.test(s);
-  });
+  return {
+    title: mapping.title,
+    explanation: mapping.explanation(rawMessage),
+    suggestion: mapping.suggestion,
+    errorClass: mapping.errorClass,
+    phase: mapping.phase,
+    cause: mapping.cause,
+    relevantFiles: [],
+    missingEnvVars: []
+  };
 }
-function projectRelative(cwd, abs) {
-  const rel = relative3(cwd, abs);
-  return isSafeRelativePath(rel) ? rel : null;
+function trimMessage(raw) {
+  const firstLine = raw.split(`
+`)[0] ?? "";
+  return firstLine.length > 200 ? `${firstLine.slice(0, 200)}…` : firstLine;
 }
+var PB_PROVISION_FAILED_ASK = {
+  prompt: "The platform could not set up the database admin account. Publishing again after the platform failure is resolved is safe.",
+  reasonCode: "pb_provision_failed",
+  retryable: true
+};
 
 // ../core/dist/recovery.js
 function recoveryNone(opts = {}) {
@@ -108688,12 +108975,25 @@ function unprovenPlatformClaim(failure) {
 }
 function recoveryFromErrorClass(errorClass, failure) {
   switch (errorClass) {
+    case "build_secrets_unavailable":
+      return recoveryAsk({
+        prompt: "Percher cannot protect build secrets for this build. Should I remove the non-public keys from [build] pass_env and publish again, or wait and publish later?",
+        options: [
+          "remove non-public keys from [build] pass_env and publish again",
+          "wait and publish later"
+        ],
+        reasonCode: "build_secrets_unavailable"
+      });
     case "missing_env":
       return recoveryEnv({
         app: failure.appName,
         keys: failure.missingEnvVars ?? [],
         reasonCode: "missing_env"
       });
+    case "pb_provision_failed":
+      if (failure.classSource !== "code")
+        return unprovenPlatformClaim(failure);
+      return recoveryAsk(PB_PROVISION_FAILED_ASK);
     case "infra_unavailable":
       if (failure.classSource !== "code")
         return unprovenPlatformClaim(failure);
@@ -108786,7 +109086,7 @@ function recoveryFromErrorClass(errorClass, failure) {
 
 // ../core/dist/commands/publish-failure.js
 init_dist();
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 
 // ../core/dist/error-classifier.js
 function extractEnvVarsFromLog(combined) {
@@ -108804,6 +109104,19 @@ function extractModuleFromLog(combined) {
   return match?.[1];
 }
 var patterns = [
+  {
+    pattern: /PB_PROVISION_FAILED|the platform could not set up the database admin account/i,
+    result: {
+      title: "Database admin setup failed",
+      explanation: "The platform could not set up the database admin account.",
+      suggestion: "Publishing again after the platform failure is resolved is safe.",
+      errorClass: "pb_provision_failed",
+      phase: "infra",
+      cause: "pb_provision_failed",
+      relevantFiles: [],
+      missingEnvVars: []
+    }
+  },
   {
     pattern: /DEPLOY_STALLED:/,
     result: {
@@ -109172,171 +109485,9 @@ ${buildLog ?? ""}`;
   return null;
 }
 
-// ../core/dist/structured-error-codes.js
-var MAPPINGS = {
-  PLATFORM_DISK_LOW: {
-    errorClass: "platform_at_capacity",
-    phase: "infra",
-    cause: "disk_headroom_exhausted",
-    title: "Platform storage is too low",
-    explanation: () => "Percher paused new deploys: the platform is nearly out of disk. Not your app — nothing to change. Deployed apps keep running; only new deploys are paused.",
-    suggestion: "The operator is alerted automatically. Run `percher publish` again in ~15 min; this failure does not count against your app. Still failing after an hour: https://percher.app/status"
-  },
-  PLATFORM_DISK_UNKNOWN: {
-    errorClass: "platform_at_capacity",
-    phase: "infra",
-    cause: "disk_state_unreadable",
-    title: "Platform storage state is unknown",
-    explanation: () => "Percher paused new deploys: it can't read how much disk is left, and won't assume there's room. Not your app. Deployed apps have not been stopped by this.",
-    suggestion: "Run `percher publish` again in ~5 min; this failure does not count against your app. Still failing after 15 min: https://percher.app/status"
-  },
-  PLAN_POOL_EXCEEDED: {
-    errorClass: "plan_pool_exceeded",
-    phase: "start",
-    cause: "plan_pool_exceeded",
-    title: "Plan resource pool is full",
-    explanation: (raw) => raw ? `${trimMessage(raw)} The platform is fine — the account is at its plan's limit.` : "This deploy would commit more RAM, vCPU or disk than your plan's pool allows across all your apps. The platform is fine — the account is at its limit.",
-    suggestion: "Reduce `[resources]` in this app's percher.toml, delete an app you no longer need, or upgrade at https://percher.app/account/billing. Retrying unchanged will fail the same way."
-  },
-  PLACEMENT_UNDETERMINED: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "placement_undetermined",
-    title: "Percher could not place your app's container",
-    explanation: (raw) => raw ? `${trimMessage(raw)} This is a platform-side read of Percher's own container placement, not anything in your app.` : "Percher could not read which internal network this app's current containers are on, and refused to guess rather than risk splitting the app from its database across two networks.",
-    suggestion: "Nothing to change in your app. Retry in a minute; if it persists, the platform is having trouble reaching its container daemon and Percher's operators are alerted."
-  },
-  PLATFORM_MEMORY_LOW: {
-    errorClass: "platform_at_capacity",
-    phase: "infra",
-    cause: "box_admission_rejected",
-    title: "Platform is at capacity",
-    explanation: (raw) => raw ? `Percher couldn't fit this deploy on the box right now: ${trimMessage(raw)} Not your app — nothing to change. Deployed apps keep running.` : "Percher couldn't fit this deploy on the box right now — the admission gate refused to start the container. Not your app — nothing to change. Deployed apps keep running.",
-    suggestion: "Run `percher publish` again in a few minutes; capacity frees up as other deploys finish, and this failure does not count against your app. Still failing after an hour: https://percher.app/status"
-  },
-  PB_BRIDGE_UNAVAILABLE: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "pb_bridge_unreachable",
-    title: "PocketBase is unreachable from the platform",
-    explanation: (raw) => raw ? `Percher could not reach your app's database through its internal bridge: ${trimMessage(raw)}. This is a platform-side issue — your data and your code are both fine.` : "Percher could not reach your app's database through its internal bridge. This is a platform-side issue — your data and your code are both fine.",
-    suggestion: "Wait a minute and run `percher publish` again; this failure does not count against your app. Your data was not touched — the platform could not read it, which is not the same as it being missing. Still failing after 15 min: https://percher.app/status"
-  },
-  PB_ROTATION_UNVERIFIED: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "pb_rotation_unverified",
-    title: "PocketBase admin password was rotated but not confirmed",
-    explanation: (raw) => raw ? `${trimMessage(raw)} The rotation itself ran, so the previously stored admin password may now be stale. Your app data was not modified — only the admin credential changed.` : "Percher rotated your app's PocketBase admin password, then could not confirm the rotation. The previously stored admin password may now be stale. Your app data was not modified — only the admin credential changed.",
-    suggestion: "Run the superuser reset again (`percher data reset-superuser` or the dashboard's reset button) — the rotation is idempotent, and a successful re-run stores a fresh working credential. This failure does not count against your app."
-  },
-  PB_OPERATION_BUSY: {
-    errorClass: "pb_operation_busy",
-    phase: "start",
-    cause: "pb_backup_restore_busy",
-    title: "PocketBase is finishing another data operation",
-    explanation: (raw) => raw ? `${trimMessage(raw)} The operation is scoped to this app and must finish before Percher can create the deploy checkpoint.` : "PocketBase is already creating a backup or restoring data for this app, so Percher could not create the deploy checkpoint yet.",
-    suggestion: "Wait for the current backup, export or restore to finish, then publish again. If no operation is visible after a few minutes, contact support before retrying repeatedly."
-  },
-  CANARY_FAILED: {
-    errorClass: "runtime_crash",
-    phase: "start",
-    cause: "canary_failed",
-    title: "Your app went live, then failed its post-deploy check",
-    explanation: (raw) => raw ? `${trimMessage(raw)} The container started and passed its health check, so this is something that only shows up once the app is serving real requests.` : "Percher swapped your new version in, then its own public URL did not answer correctly. The container started and passed its health check, so this is something that only shows up once the app is serving real requests.",
-    suggestion: "Run `percher doctor` — it re-probes the container and the public route and will say which half is failing. The container log from the moment it was rolled back is in the build log below. Retrying unchanged will usually fail the same way."
-  },
-  APP_DATA_MOUNT_CONFLICT: {
-    errorClass: "app_data_mount_conflict",
-    phase: "start",
-    cause: "app_data_mount_conflict",
-    title: "Your image has a file where Percher mounts /app/data",
-    explanation: () => "The image built, but Docker could not start the container: every Percher app gets its persistent data volume mounted at /app/data, and this image has a file (or a link to one) at /app or /app/data, so that directory cannot be created.",
-    suggestion: "Install the binary somewhere else, such as /usr/local/bin/app, and point ENTRYPOINT/CMD at it. If the project has a file named `data` at its root, rename it. Retrying unchanged will fail the same way."
-  },
-  WORKER_UNAVAILABLE: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "worker_fetch_failed",
-    title: "Build worker is unreachable",
-    explanation: (raw) => raw ? `The Percher build worker did not respond in time: ${trimMessage(raw)}. This is a platform-side issue, not your code.` : "The Percher build worker did not respond in time. This is a platform-side issue, not your code.",
-    suggestion: "Wait 30 seconds and run `percher publish` again. If retry #2 also fails, pause 5 minutes before the next attempt — back-to-back retries during a partial outage just waste your time. After 3 spaced-out retries, check status.percher.app or contact support. Your build never started."
-  },
-  WORKER_UNAVAILABLE_PERSISTENT: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "worker_circuit_breaker_open",
-    title: "Build worker is in a crash loop",
-    explanation: () => "The Percher build worker has failed repeatedly in the last minute and the platform's circuit breaker has flipped open. Retrying immediately would just queue more failures.",
-    suggestion: "Wait 2-3 minutes for the platform to recover, then retry. If it persists past 5 minutes check status.percher.app or contact support — this is a platform incident, not your code."
-  },
-  BUILD_TIMEOUT: {
-    errorClass: "build_failed",
-    phase: "build",
-    cause: "build_timeout",
-    title: "Build timed out",
-    explanation: () => "The build ran longer than the 10-minute platform limit and was aborted.",
-    suggestion: "Common causes: a slow `postinstall` hook, very large dependency tree, or a Dockerfile that pulls a huge base image. Try `bun install` locally and check what's slow. If it's legitimately a heavy build, contact support to discuss raising the limit for your account."
-  },
-  BUILD_FAILED: {
-    errorClass: "build_failed",
-    phase: "build",
-    cause: "build_nonzero_exit",
-    title: "Build failed",
-    explanation: (raw) => raw ? `The build process returned a non-zero exit code: ${trimMessage(raw)}. Read the build log below for the exact error.` : "The build process returned a non-zero exit code. Read the build log below for the exact error.",
-    suggestion: "Run your build locally to reproduce: `bun install && bun run build`. The error in the build log usually points to a missing dependency, a TypeScript/syntax error, or a misconfigured framework setting."
-  },
-  WORKER_ERROR: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "worker_internal_error",
-    title: "Platform error inside the build worker",
-    explanation: (raw) => raw ? `The build worker hit an internal error: ${trimMessage(raw)}. This is a Percher bug, not your code.` : "The build worker hit an internal error. This is a Percher bug, not your code.",
-    suggestion: "Retry once — transient platform errors usually clear within a minute. If it repeats, please report it: include the deploy ID and we'll investigate. Your account is not at fault."
-  },
-  WORKER_ENDPOINT_MISSING: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "worker_endpoint_missing",
-    title: "Platform worker is mid-upgrade",
-    explanation: (raw) => raw ? `${trimMessage(raw)} The platform's worker process predates an endpoint this request needs — a rolling-deploy skew, not your code.` : "The platform's worker process predates an endpoint this request needs — a rolling-deploy skew, not your code.",
-    suggestion: "Retry in a few minutes; the operator finishes the platform deploy worker-first. This failure does not count against your app."
-  },
-  DEPLOY_STALLED: {
-    errorClass: "infra_unavailable",
-    phase: "infra",
-    cause: "deploy_stalled",
-    title: "Deploy stalled",
-    explanation: () => "The platform abandoned this deploy — likely because the API or build worker restarted mid-build. Your code is fine; the build never finished.",
-    suggestion: "Run `percher publish` again. The new deploy will start fresh. If you see this repeatedly across multiple publishes, check status.percher.app — it implies a recurring platform issue."
-  }
-};
-function classifyByErrorCode(code, rawMessage) {
-  if (!code)
-    return null;
-  const mapping = MAPPINGS[code];
-  if (!mapping)
-    return null;
-  return {
-    title: mapping.title,
-    explanation: mapping.explanation(rawMessage),
-    suggestion: mapping.suggestion,
-    errorClass: mapping.errorClass,
-    phase: mapping.phase,
-    cause: mapping.cause,
-    relevantFiles: [],
-    missingEnvVars: []
-  };
-}
-function trimMessage(raw) {
-  const firstLine = raw.split(`
-`)[0] ?? "";
-  return firstLine.length > 200 ? `${firstLine.slice(0, 200)}…` : firstLine;
-}
-
 // ../core/dist/commands/publish-failure.js
 function tomlPathFor(cwd) {
-  return join9(cwd, "percher.toml");
+  return join10(cwd, "percher.toml");
 }
 async function buildFailureError(ctx, app, deployment, signal) {
   let buildLogTail;
@@ -109521,13 +109672,13 @@ async function deploysInspect(ctx, input) {
 }
 // ../core/dist/commands/dev.js
 import { existsSync as existsSync8 } from "node:fs";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 
 // ../core/dist/tarball.js
 var import_ignore = __toESM(require_ignore(), 1);
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync6, statSync as statSync2 } from "node:fs";
-import { join as join10, relative as relative4, sep as sep2 } from "node:path";
+import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync7, statSync as statSync2 } from "node:fs";
+import { join as join11, relative as relative4, sep as sep2 } from "node:path";
 import { Readable } from "node:stream";
 import { createGzip } from "node:zlib";
 function isFilesOptions(options) {
@@ -109551,7 +109702,7 @@ var ALWAYS_IGNORE_SECRETS = [".env", ".env.*"];
 function* walk(dir, baseDir, ig) {
   const entries = readdirSync2(dir);
   for (const name of entries) {
-    const full = join10(dir, name);
+    const full = join11(dir, name);
     const rel = relative4(baseDir, full).split(sep2).join("/");
     if (ig.ignores(rel))
       continue;
@@ -109640,20 +109791,20 @@ async function createTarball(options) {
   }
   const ig = import_ignore.default();
   ig.add(DEFAULT_IGNORE);
-  const gitignorePath = join10(options.cwd, ".gitignore");
+  const gitignorePath = join11(options.cwd, ".gitignore");
   if (existsSync6(gitignorePath)) {
-    ig.add(readFileSync6(gitignorePath, "utf8"));
+    ig.add(readFileSync7(gitignorePath, "utf8"));
   }
-  const percherignorePath = join10(options.cwd, ".percherignore");
+  const percherignorePath = join11(options.cwd, ".percherignore");
   if (existsSync6(percherignorePath)) {
-    ig.add(readFileSync6(percherignorePath, "utf8"));
+    ig.add(readFileSync7(percherignorePath, "utf8"));
   }
   if (options.extraIgnore)
     ig.add(options.extraIgnore);
   ig.add(ALWAYS_IGNORE_SECRETS);
   const fileBuffers = [];
   for (const rel of walk(options.cwd, options.cwd, ig)) {
-    const data2 = readFileSync6(join10(options.cwd, rel));
+    const data2 = readFileSync7(join11(options.cwd, rel));
     fileBuffers.push({ path: rel, size: data2.length, data: data2 });
   }
   return buildTarball(fileBuffers);
@@ -109675,8 +109826,8 @@ function createTarballFromFiles(files, _config) {
 
 // ../core/dist/watcher.js
 var import_ignore2 = __toESM(require_ignore(), 1);
-import { existsSync as existsSync7, readFileSync as readFileSync7, watch } from "node:fs";
-import { join as join11, sep as sep3 } from "node:path";
+import { existsSync as existsSync7, readFileSync as readFileSync8, watch } from "node:fs";
+import { join as join12, sep as sep3 } from "node:path";
 var DEFAULT_IGNORE2 = [
   "node_modules",
   ".git",
@@ -109696,9 +109847,9 @@ function createWatcher(options) {
   const debounceMs = options.debounceMs ?? 500;
   const ig = import_ignore2.default();
   ig.add(DEFAULT_IGNORE2);
-  const gitignorePath = join11(options.cwd, ".gitignore");
+  const gitignorePath = join12(options.cwd, ".gitignore");
   if (existsSync7(gitignorePath)) {
-    ig.add(readFileSync7(gitignorePath, "utf8"));
+    ig.add(readFileSync8(gitignorePath, "utf8"));
   }
   if (options.extraIgnore)
     ig.add(options.extraIgnore);
@@ -109736,7 +109887,7 @@ var devInputSchema = exports_external.object({
   app: exports_external.string().optional()
 });
 async function loadConfig2(ctx, appOverride) {
-  const tomlPath = join12(ctx.cwd, "percher.toml");
+  const tomlPath = join13(ctx.cwd, "percher.toml");
   if (!existsSync8(tomlPath)) {
     throw new PercherCoreError("No percher.toml found. Run: percher init", {
       code: "dev.no-app",
@@ -109932,7 +110083,7 @@ async function diff(ctx, input = {}) {
 }
 // ../core/dist/commands/doctor.js
 import { existsSync as existsSync9 } from "node:fs";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 
 // ../core/dist/toml-recovery.js
 function tomlErrorToRecoveryProblems(err) {
@@ -110233,7 +110384,7 @@ async function doctor(ctx, input = {}) {
     });
     return summarize(checks3, { appProvided: !!input.app });
   }
-  const tomlPath = join13(ctx.cwd, "percher.toml");
+  const tomlPath = join14(ctx.cwd, "percher.toml");
   const tomlExists = existsSync9(tomlPath);
   let tomlValid = false;
   let tomlProblems;
@@ -111249,8 +111400,8 @@ var forgejoSetupWebhookInputSchema = exports_external.object({
   app: exports_external.string().optional().describe("App name (overrides percher.toml)")
 });
 // ../core/dist/commands/generate.js
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join14 } from "node:path";
+import { existsSync as existsSync10, mkdirSync as mkdirSync7, writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join15 } from "node:path";
 var generateInputSchema = exports_external.object({
   cwd: exports_external.string().optional()
 });
@@ -111336,7 +111487,7 @@ function generateTypeScript(config2) {
 }
 async function generate(ctx, input = {}) {
   const cwd = input.cwd ?? ctx.cwd;
-  const tomlPath = join14(cwd, "percher.toml");
+  const tomlPath = join15(cwd, "percher.toml");
   if (!existsSync10(tomlPath)) {
     throw new PercherCoreError("No percher.toml found", {
       code: "dev.no-app",
@@ -111346,14 +111497,14 @@ async function generate(ctx, input = {}) {
   const config2 = await parseFile(tomlPath);
   const files = [];
   const envExample = generateEnvExample(config2);
-  writeFileSync6(join14(cwd, ".env.example"), envExample);
+  writeFileSync7(join15(cwd, ".env.example"), envExample);
   files.push(".env.example");
   const tsTypes = generateTypeScript(config2);
-  writeFileSync6(join14(cwd, "percher.generated.d.ts"), tsTypes);
+  writeFileSync7(join15(cwd, "percher.generated.d.ts"), tsTypes);
   files.push("percher.generated.d.ts");
   const agentInstructions = generateAgentInstructions(config2);
-  mkdirSync6(join14(cwd, ".percher"), { recursive: true });
-  writeFileSync6(join14(cwd, ".percher", "agent-instructions.md"), agentInstructions);
+  mkdirSync7(join15(cwd, ".percher"), { recursive: true });
+  writeFileSync7(join15(cwd, ".percher", "agent-instructions.md"), agentInstructions);
   files.push(".percher/agent-instructions.md");
   return { files };
 }
@@ -111559,11 +111710,17 @@ async function hookRevoke(ctx, input) {
   await ctx.client.hooks.revoke(app.id, input.id);
 }
 // ../core/dist/commands/import-project.js
-import { existsSync as existsSync11, readFileSync as readFileSync8, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join15 } from "node:path";
+import { existsSync as existsSync11, readFileSync as readFileSync9, writeFileSync as writeFileSync8 } from "node:fs";
+import { join as join16 } from "node:path";
 
 // ../core/dist/static-docker.js
 var STATIC_DOCKER_PORT = 8080;
+var INIT_TEMPLATE_FRAMEWORKS = new Set([
+  "astro",
+  "preact",
+  "solid",
+  "vite"
+]);
 function renderStaticFrameworkDockerfile(input) {
   return `# Multi-stage build: a Bun stage compiles the static bundle, then a
 # minimal Caddy image serves it. This project uses runtime = "docker"
@@ -111581,7 +111738,7 @@ RUN bun install && bun run build
 # Build pinned Caddy source with refreshed security modules. The scratch
 # runtime carries no shell, package manager, or file capabilities and listens
 # on the unprivileged port :${STATIC_DOCKER_PORT}.
-FROM golang:1.26.7-alpine3.23@sha256:b17af760035fc2f338eed92d448a6c67f2d45438844fc6c60678fa5f99e44b57 AS caddy-source
+FROM golang:1.26.9-alpine3.23@sha256:6750308561953d451210ed1a8086d36c8c8bdcbf672d38d9d0d424b8a7a0216c AS caddy-source
 ADD --checksum=sha256:78e660d838e45c0b8c89338b325946238f153641aa9925df9ef2ad5e8eced31b \\
   https://github.com/caddyserver/caddy/commit/b2693fb63a30e6d7be0972c3645e9a2c0a500e93.patch /tmp/caddy-cel-go.patch
 RUN go mod download github.com/caddyserver/caddy/v2@v2.11.4 \\
@@ -111591,9 +111748,15 @@ WORKDIR /src
 RUN apk add --no-cache patch \\
  && patch -p1 < /tmp/caddy-cel-go.patch \\
  && go get github.com/go-chi/chi/v5@v5.3.0 github.com/google/cel-go@v0.29.2 \\
-      github.com/klauspost/compress@v1.18.7 go.opentelemetry.io/otel@v1.44.0 \\
-      golang.org/x/crypto@v0.55.0 golang.org/x/net@v0.58.0 \\
-      golang.org/x/text@v0.41.0 google.golang.org/grpc@v1.83.2 \\
+      github.com/klauspost/compress@v1.18.7 go.opentelemetry.io/otel@v1.45.0 \\
+      go.opentelemetry.io/otel/sdk/log@v0.21.0 \\
+      go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc@v0.21.0 \\
+      go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp@v0.21.0 \\
+      go.opentelemetry.io/otel/exporters/stdout/stdoutlog@v0.21.0 \\
+      go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc@v1.45.0 \\
+      go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp@v1.45.0 \\
+      golang.org/x/crypto@v0.57.0 golang.org/x/net@v0.60.0 \\
+      golang.org/x/text@v0.42.0 google.golang.org/grpc@v1.83.2 \\
  && go mod tidy \\
  && CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o /out/caddy ./cmd/caddy \\
  && printf '%s\\n' \\
@@ -111631,6 +111794,15 @@ ${body}
 }
 `;
 }
+var TEMPLATE_GO_PINS = readGoPins(renderStaticFrameworkDockerfile({ outputDir: "dist" }));
+function readGoPins(dockerfile) {
+  const modules = {};
+  for (const m of dockerfile.matchAll(/([a-z0-9-]+(?:\.[a-z0-9-]+)+\/[^\s@\\]+)@v(\d[^\s\\]*)/g)) {
+    if (m[1] && m[2])
+      modules[m[1]] = m[2];
+  }
+  return { go: /^FROM golang:(\d+\.\d+\.\d+)/m.exec(dockerfile)?.[1] ?? null, modules };
+}
 
 // ../core/dist/commands/import-project.js
 var importInputSchema = exports_external.object({
@@ -111638,9 +111810,9 @@ var importInputSchema = exports_external.object({
   app: exports_external.string().optional().describe("App name to import into")
 });
 function detectProvider(cwd) {
-  if (existsSync11(join15(cwd, "vercel.json")))
+  if (existsSync11(join16(cwd, "vercel.json")))
     return "vercel";
-  if (existsSync11(join15(cwd, "netlify.toml")))
+  if (existsSync11(join16(cwd, "netlify.toml")))
     return "netlify";
   return null;
 }
@@ -111976,7 +112148,7 @@ function mapVercelFramework(framework) {
   return map2[framework ?? ""] ?? { runtime: "node" };
 }
 function parseVercelJson(cwd) {
-  const raw = readFileSync8(join15(cwd, "vercel.json"), "utf-8");
+  const raw = readFileSync9(join16(cwd, "vercel.json"), "utf-8");
   const config2 = JSON.parse(raw);
   const warnings = [];
   const envVars = [];
@@ -112032,12 +112204,12 @@ health = "/api/health"
   return { toml, warnings, envVars, staticBuild, redirects, headers };
 }
 function parseNetlifyToml(cwd) {
-  const raw = readFileSync8(join15(cwd, "netlify.toml"), "utf-8");
+  const raw = readFileSync9(join16(cwd, "netlify.toml"), "utf-8");
   const warnings = [];
   const envVars = [];
   const buildCommand = raw.match(/command\s*=\s*"([^"]+)"/)?.[1] ?? "bun run build";
   const publishDir = raw.match(/publish\s*=\s*"([^"]+)"/)?.[1] ?? "dist";
-  const hasPackageJson = existsSync11(join15(cwd, "package.json"));
+  const hasPackageJson = existsSync11(join16(cwd, "package.json"));
   const looksLikeStaticOutput = publishDir === "dist" || publishDir === "build" || publishDir === "public";
   let toml = `[app]
 name = "imported-app"
@@ -112085,23 +112257,23 @@ health = "/health"
     }
   }
   const sidecarPath = (name) => {
-    const root = join15(cwd, name);
+    const root = join16(cwd, name);
     if (existsSync11(root))
       return root;
-    const published = join15(cwd, publishDir, name);
+    const published = join16(cwd, publishDir, name);
     return existsSync11(published) ? published : null;
   };
   const redirectCollector = newRedirectCollector();
   const redirectsPath = sidecarPath("_redirects");
   if (redirectsPath) {
-    parseNetlifyRedirectsFile(readFileSync8(redirectsPath, "utf-8"), redirectCollector, warnings);
+    parseNetlifyRedirectsFile(readFileSync9(redirectsPath, "utf-8"), redirectCollector, warnings);
   }
   parseNetlifyTomlRedirects(raw, redirectCollector, warnings);
   const redirects = finishRedirects(redirectCollector, warnings, "netlify");
   const headerTable = {};
   const headersPath = sidecarPath("_headers");
   if (headersPath) {
-    parseNetlifyHeadersFile(readFileSync8(headersPath, "utf-8"), headerTable, warnings);
+    parseNetlifyHeadersFile(readFileSync9(headersPath, "utf-8"), headerTable, warnings);
   }
   const headers = finishHeaders(headerTable, warnings, "_headers");
   if (/^\s*\[\[headers\]\]/m.test(raw)) {
@@ -112170,11 +112342,11 @@ ${serialize(extras)}`;
       mapped.headerPaths = Object.keys(headers).length;
     }
   }
-  const tomlPath = join15(ctx.cwd, "percher.toml");
+  const tomlPath = join16(ctx.cwd, "percher.toml");
   if (existsSync11(tomlPath)) {
     result.warnings.unshift("percher.toml already exists — overwriting with imported config");
   }
-  writeFileSync7(tomlPath, toml);
+  writeFileSync8(tomlPath, toml);
   const scaffoldedFiles = [];
   if (result.staticBuild) {
     const targets = [
@@ -112188,12 +112360,12 @@ ${serialize(extras)}`;
       }
     ];
     for (const { name, content } of targets) {
-      const target = join15(ctx.cwd, name);
+      const target = join16(ctx.cwd, name);
       if (existsSync11(target)) {
         result.warnings.push(`${name} already exists — left untouched. The imported config expects a multi-stage static build; merge by hand if needed.`);
         continue;
       }
-      writeFileSync7(target, content, "utf-8");
+      writeFileSync8(target, content, "utf-8");
       scaffoldedFiles.push(name);
     }
   }
@@ -112215,12 +112387,12 @@ function parsesAsPercherToml(source) {
   }
 }
 // ../core/dist/commands/init.js
-import { existsSync as existsSync13, writeFileSync as writeFileSync8 } from "node:fs";
-import { basename as basename3, join as join17 } from "node:path";
+import { existsSync as existsSync13, writeFileSync as writeFileSync9 } from "node:fs";
+import { basename as basename3, join as join18 } from "node:path";
 
 // ../core/dist/detect.js
-import { existsSync as existsSync12, readFileSync as readFileSync9 } from "node:fs";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync12, readFileSync as readFileSync10 } from "node:fs";
+import { join as join17 } from "node:path";
 function readPackageJson(src) {
   const raw = src.text("package.json");
   if (raw === null)
@@ -112392,10 +112564,10 @@ function detectFromSource(src) {
 }
 async function detectFramework(cwd) {
   const src = {
-    has: (...names) => names.some((n) => existsSync12(join16(cwd, n))),
+    has: (...names) => names.some((n) => existsSync12(join17(cwd, n))),
     text: (name) => {
       try {
-        return readFileSync9(join16(cwd, name), "utf8");
+        return readFileSync10(join17(cwd, name), "utf8");
       } catch {
         return null;
       }
@@ -112404,7 +112576,7 @@ async function detectFramework(cwd) {
   return detectFromSource(src);
 }
 function refineBunRuntime(detected, cwd) {
-  if (detected.runtime === "node" && (existsSync12(join16(cwd, "bun.lockb")) || existsSync12(join16(cwd, "bun.lock")))) {
+  if (detected.runtime === "node" && (existsSync12(join17(cwd, "bun.lockb")) || existsSync12(join17(cwd, "bun.lock")))) {
     return { ...detected, runtime: "bun" };
   }
   return detected;
@@ -112549,7 +112721,7 @@ function scanEnvVars(_cwd) {
   return {};
 }
 async function init(ctx, input = {}) {
-  const path = join17(ctx.cwd, "percher.toml");
+  const path = join18(ctx.cwd, "percher.toml");
   const exists = existsSync13(path);
   if (exists && !input.force) {
     throw new PercherCoreError("percher.toml already exists", {
@@ -112594,7 +112766,7 @@ async function init(ctx, input = {}) {
   if (Object.keys(envVars).length > 0) {
     config2.env = envVars;
   }
-  writeFileSync8(path, serialize(config2), "utf8");
+  writeFileSync9(path, serialize(config2), "utf8");
   const scaffoldedFiles = [];
   if (detected?.staticBuild) {
     const targets = [
@@ -112610,10 +112782,10 @@ async function init(ctx, input = {}) {
       }
     ];
     for (const { name: name2, content } of targets) {
-      const target = join17(ctx.cwd, name2);
+      const target = join18(ctx.cwd, name2);
       if (existsSync13(target) && !input.force)
         continue;
-      writeFileSync8(target, content, "utf8");
+      writeFileSync9(target, content, "utf8");
       scaffoldedFiles.push(name2);
     }
   }
@@ -113690,7 +113862,7 @@ function collectWarnings2(collections, rlsPolicies, unsupported) {
 }
 // ../core/dist/commands/migrate-supabase-rewrite.js
 import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname6, join as join20, relative as relative7, resolve as resolve9, sep as sep5 } from "node:path";
+import { dirname as dirname7, join as join21, relative as relative7, resolve as resolve9, sep as sep5 } from "node:path";
 
 // ../core/dist/commands/migrate-supabase-recipes.js
 var AUTH_RECIPES = {
@@ -113956,7 +114128,7 @@ function isSupabaseClientModule(source) {
 // ../core/dist/commands/migrate-supabase-status.js
 var import_cross_spawn = __toESM(require_cross_spawn(), 1);
 import { readFile as readFile4 } from "node:fs/promises";
-import { join as join19, relative as relative6, resolve as resolve8 } from "node:path";
+import { join as join20, relative as relative6, resolve as resolve8 } from "node:path";
 
 // ../core/dist/commands/migrate-supabase-sdk.js
 var import_jscodeshift2 = __toESM(require_core3(), 1);
@@ -114893,7 +115065,7 @@ function applyRewrite(path, replacement, kind, pattern, note, flags, state) {
 // ../core/dist/commands/migrate-supabase-walker.js
 var import_ignore3 = __toESM(require_ignore(), 1);
 import { mkdir as mkdir2, readdir, readFile as readFile3, stat as stat2, writeFile as writeFile2 } from "node:fs/promises";
-import { dirname as dirname5, isAbsolute as isAbsolute3, join as join18, relative as relative5, resolve as resolve7, sep as sep4 } from "node:path";
+import { dirname as dirname6, isAbsolute as isAbsolute3, join as join19, relative as relative5, resolve as resolve7, sep as sep4 } from "node:path";
 var REWRITABLE_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
 var DEFAULT_EXCLUDES = [
   "node_modules",
@@ -115045,7 +115217,7 @@ async function* walkTree(dir, rootAbs, ig) {
     return;
   }
   for (const name of entries) {
-    const abs = join18(dir, name);
+    const abs = join19(dir, name);
     const rel = relative5(rootAbs, abs).split(sep4).join("/");
     if (rel.length > 0 && ig.ignores(rel))
       continue;
@@ -115207,7 +115379,7 @@ async function writeWalkResult(input) {
     if (rel.length === 0 || isParentTraversal || isAbsolute3(rel)) {
       throw new Error(`writeWalkResult refused path-traversing file "${file2.relativePath}" → "${abs}" (would escape targetDir "${targetAbs}").`);
     }
-    await mkdir2(dirname5(abs), { recursive: true });
+    await mkdir2(dirname6(abs), { recursive: true });
     await writeFile2(abs, file2.rewritten, "utf8");
     written.push(file2.relativePath);
   }
@@ -115482,7 +115654,7 @@ function buildPrompt(state, failing, warning, build) {
 async function readManualRlsCount(rootAbs) {
   for (const dir of ["migration-preview", "."]) {
     try {
-      const notes = await readFile4(join19(rootAbs, dir, "MIGRATION_NOTES.md"), "utf8");
+      const notes = await readFile4(join20(rootAbs, dir, "MIGRATION_NOTES.md"), "utf8");
       const m = notes.match(/\*\*RLS policies:\*\*\s*\d+\s*\((\d+)\s*need manual review\)/);
       if (m?.[1] !== undefined)
         return Number.parseInt(m[1], 10);
@@ -115494,7 +115666,7 @@ async function readManualRlsCount(rootAbs) {
 async function runProjectBuild(rootAbs) {
   let hasBuildScript = false;
   try {
-    const pkg = JSON.parse(await readFile4(join19(rootAbs, "package.json"), "utf8"));
+    const pkg = JSON.parse(await readFile4(join20(rootAbs, "package.json"), "utf8"));
     hasBuildScript = typeof pkg.scripts?.build === "string";
   } catch {
     return { ran: false, passed: false, detail: "No readable package.json — nothing to build." };
@@ -115526,7 +115698,7 @@ ${tail}` : ""}`
 async function detectPackageManager(rootAbs) {
   const has = async (name) => {
     try {
-      await readFile4(join19(rootAbs, name), "utf8");
+      await readFile4(join20(rootAbs, name), "utf8");
       return true;
     } catch {
       return false;
@@ -115656,8 +115828,8 @@ async function rewriteSupabaseClient(ctx, input) {
     flags.push(...scaffold.flags);
   }
   const reportNeeded = hadRewrites || flags.length > 0 || walk2.skipped.length > 0;
-  const backupDir = apply && changed.length > 0 ? join20(rootAbs, "migration-preview", "backup") : null;
-  const rewriteTarget = apply ? rootAbs : input.outputDir ? resolve9(ctx.cwd, input.outputDir) : join20(rootAbs, "migration-preview", "rewritten");
+  const backupDir = apply && changed.length > 0 ? join21(rootAbs, "migration-preview", "backup") : null;
+  const rewriteTarget = apply ? rootAbs : input.outputDir ? resolve9(ctx.cwd, input.outputDir) : join21(rootAbs, "migration-preview", "rewritten");
   const filesWritten = [];
   let clientModuleWritten = null;
   try {
@@ -115677,19 +115849,19 @@ async function rewriteSupabaseClient(ctx, input) {
         changedOnly: true
       });
       for (const rel of out.written) {
-        filesWritten.push(relative7(ctx.cwd, join20(rewriteTarget, rel)));
+        filesWritten.push(relative7(ctx.cwd, join21(rewriteTarget, rel)));
       }
       if (scaffold?.clientModule) {
-        const moduleAbs = join20(rewriteTarget, scaffold.clientModule.relativePath);
-        await mkdir3(dirname6(moduleAbs), { recursive: true });
+        const moduleAbs = join21(rewriteTarget, scaffold.clientModule.relativePath);
+        await mkdir3(dirname7(moduleAbs), { recursive: true });
         await writeFile3(moduleAbs, scaffold.clientModule.content, "utf8");
         clientModuleWritten = relative7(ctx.cwd, moduleAbs).split(sep5).join("/");
         filesWritten.push(clientModuleWritten);
       }
     }
     if (reportNeeded) {
-      const reportAbs = join20(rootAbs, "migration-preview", "REWRITE_NOTES.md");
-      await mkdir3(dirname6(reportAbs), { recursive: true });
+      const reportAbs = join21(rootAbs, "migration-preview", "REWRITE_NOTES.md");
+      await mkdir3(dirname7(reportAbs), { recursive: true });
       const analysis = analyzeMigration(walk2.files.map((f) => ({
         relativePath: f.relativePath,
         kind: f.kind,
@@ -115941,7 +116113,7 @@ function failure3(rootAbs, mode, err, suggestion) {
 }
 // ../core/dist/commands/migrate-supabase-schema.js
 import { mkdir as mkdir4, writeFile as writeFile4 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join21, relative as relative8, resolve as resolve10 } from "node:path";
+import { isAbsolute as isAbsolute4, join as join22, relative as relative8, resolve as resolve10 } from "node:path";
 
 // ../core/dist/commands/migrate-supabase-scripts.js
 function generateDataImportScripts(preview) {
@@ -116461,10 +116633,10 @@ async function writePreviewFiles(ctx, outputDir, preview) {
   const schemaJson = renderSchemaJson(preview);
   const notesMd = renderMigrationNotes(preview);
   const scripts = generateDataImportScripts(preview);
-  const schemaPath = join21(outputDir, "pb_schema.json");
-  const notesPath = join21(outputDir, "MIGRATION_NOTES.md");
-  const migratePath = join21(outputDir, "pb_migrate.js");
-  const storagePath = join21(outputDir, "pb_migrate_storage.js");
+  const schemaPath = join22(outputDir, "pb_schema.json");
+  const notesPath = join22(outputDir, "MIGRATION_NOTES.md");
+  const migratePath = join22(outputDir, "pb_migrate.js");
+  const storagePath = join22(outputDir, "pb_migrate_storage.js");
   await writeFile4(schemaPath, schemaJson, "utf8");
   await writeFile4(notesPath, notesMd, "utf8");
   await writeFile4(migratePath, scripts.pbMigrate, "utf8");
@@ -116697,7 +116869,7 @@ async function previewList(ctx, input = {}) {
 // ../core/dist/commands/publish.js
 init_dist();
 import { existsSync as existsSync15 } from "node:fs";
-import { join as join24 } from "node:path";
+import { join as join25 } from "node:path";
 
 // ../shared/dist/pow.js
 import { createHash as createHash3 } from "node:crypto";
@@ -117101,8 +117273,8 @@ async function runDeployWithRetry(opts) {
 
 // ../core/dist/commands/env-scan.js
 init_dist();
-import { readdirSync as readdirSync3, readFileSync as readFileSync10, statSync as statSync3 } from "node:fs";
-import { join as join22 } from "node:path";
+import { readdirSync as readdirSync3, readFileSync as readFileSync11, statSync as statSync3 } from "node:fs";
+import { join as join23 } from "node:path";
 function platformInjectedClientEnvKeys(config2) {
   const data2 = config2.data;
   if (!data2)
@@ -117160,7 +117332,7 @@ function scanForMissingBuildEnvRefs(cwd, existingKeys) {
       continue;
     let content;
     try {
-      content = readFileSync10(join22(cwd, rel), "utf8");
+      content = readFileSync11(join23(cwd, rel), "utf8");
     } catch {
       continue;
     }
@@ -117192,7 +117364,7 @@ function* walkDir(dir, base) {
   for (const name of entries) {
     if (SKIP_DIRS.has(name))
       continue;
-    const full = join22(dir, name);
+    const full = join23(dir, name);
     let st;
     try {
       st = statSync3(full);
@@ -117209,6 +117381,47 @@ function* walkDir(dir, base) {
 
 // ../core/dist/commands/publish-api-error.js
 init_dist();
+
+// ../core/dist/commands/publish-rate-limit.js
+var RATE_LIMIT_CODES = new Set([
+  "DEPLOY_RATE_LIMIT",
+  "DEPLOY_RATE_LIMITED",
+  "RATE_LIMIT_EXCEEDED"
+]);
+function matchRateLimit(err) {
+  if (!RATE_LIMIT_CODES.has(err.code))
+    return null;
+  const wait = boundedSeconds(err.extra?.retryAfterSec);
+  return {
+    title: "Rate limit hit",
+    explanation: err.message,
+    suggestion: "Wait a few minutes and try again. If you need a higher cap, upgrade at https://percher.app/account/billing.",
+    recovery: recoveryAsk({
+      prompt: `Percher is rate-limiting deploys for this app${wait ? `; wait at least ${wait}s` : " — the window is up to an hour"}. This is a burst/hourly limit, not the daily deploy quota. Wait and retry, or upgrade the plan for a higher cap — which would you like?`,
+      options: ["wait and retry", "upgrade", "cancel"],
+      reasonCode: "quota_exceeded"
+    }),
+    summary: `Rate limit hit: ${err.message}`
+  };
+}
+function matchConnectionRateLimit(err) {
+  if (err.code !== "OAUTH_GRANT_RATE_LIMITED")
+    return null;
+  const wait = boundedSeconds(err.extra?.retryAfterSec) ?? 60;
+  return {
+    title: "Connection rate limit hit",
+    explanation: err.message,
+    suggestion: `Wait ${wait}s, then publish again. Nothing in the app needs to change.`,
+    recovery: recoveryAsk({
+      prompt: `Percher is limiting requests on this connection; wait at least ${wait}s, then publish again. Nothing in the app needs to change. Wait and retry, or cancel?`,
+      options: ["wait and retry", "cancel"],
+      reasonCode: "quota_exceeded"
+    }),
+    summary: `Connection rate limit hit. Retry in ${wait}s.`
+  };
+}
+
+// ../core/dist/commands/publish-api-error.js
 var DEPLOY_GATE_CODES = new Set([
   "RETRY_LIMIT_REACHED",
   "REQUIRED_ENV_MISSING",
@@ -117228,6 +117441,9 @@ function classifyPublishApiError(err, input) {
   const rateLimit = matchRateLimit(err);
   if (rateLimit)
     return buildResult(rateLimit, input);
+  const connectionLimit = matchConnectionRateLimit(err);
+  if (connectionLimit)
+    return buildResult(connectionLimit, input);
   const concurrent = matchConcurrentLimit(err);
   if (concurrent)
     return buildResult(concurrent, input);
@@ -117313,27 +117529,6 @@ function matchPlanLimit(err) {
     summary: `Plan limit reached: ${err.message}`
   };
 }
-var RATE_LIMIT_CODES = new Set([
-  "DEPLOY_RATE_LIMIT",
-  "DEPLOY_RATE_LIMITED",
-  "RATE_LIMIT_EXCEEDED"
-]);
-function matchRateLimit(err) {
-  if (!RATE_LIMIT_CODES.has(err.code))
-    return null;
-  const wait = boundedSeconds(err.extra?.retryAfterSec);
-  return {
-    title: "Rate limit hit",
-    explanation: err.message,
-    suggestion: "Wait a few minutes and try again. If you need a higher cap, upgrade at https://percher.app/account/billing.",
-    recovery: recoveryAsk({
-      prompt: `Percher is rate-limiting deploys for this app${wait ? `; wait at least ${wait}s` : " — the window is up to an hour"}. This is a burst/hourly limit, not the daily deploy quota. Wait and retry, or upgrade the plan for a higher cap — which would you like?`,
-      options: ["wait and retry", "upgrade", "cancel"],
-      reasonCode: "quota_exceeded"
-    }),
-    summary: `Rate limit hit: ${err.message}`
-  };
-}
 var PLATFORM_DISK_CODES2 = new Set(["PLATFORM_DISK_LOW", "PLATFORM_DISK_UNKNOWN"]);
 function matchPlatformDisk(err) {
   if (!PLATFORM_DISK_CODES2.has(err.code))
@@ -117691,22 +117886,22 @@ function inFlightPublishResult(p, why) {
 }
 
 // ../core/dist/commands/publish-node.js
-import { existsSync as existsSync14, readFileSync as readFileSync11 } from "node:fs";
-import { join as join23 } from "node:path";
+import { existsSync as existsSync14, readFileSync as readFileSync12 } from "node:fs";
+import { join as join24 } from "node:path";
 function resolveNodeVersion(cwd) {
-  const nvmrc = join23(cwd, ".nvmrc");
+  const nvmrc = join24(cwd, ".nvmrc");
   if (existsSync14(nvmrc)) {
     try {
-      const v = readFileSync11(nvmrc, "utf8").trim();
+      const v = readFileSync12(nvmrc, "utf8").trim();
       if (v)
         return { value: v, source: ".nvmrc" };
     } catch {}
   }
-  const pkgPath = join23(cwd, "package.json");
+  const pkgPath = join24(cwd, "package.json");
   if (!existsSync14(pkgPath))
     return null;
   try {
-    const pkg = JSON.parse(readFileSync11(pkgPath, "utf8"));
+    const pkg = JSON.parse(readFileSync12(pkgPath, "utf8"));
     const engines = pkg?.engines?.node;
     if (typeof engines === "string" && engines.length > 0) {
       return { value: engines, source: "engines.node" };
@@ -117714,6 +117909,34 @@ function resolveNodeVersion(cwd) {
   } catch {}
   return { value: DEFAULT_NODE_VERSION_LABEL, source: "default" };
 }
+function emitPreflight(ctx, config2, tarball) {
+  const lines = [];
+  const fw = config2.app.framework ?? (config2.app.runtime === "docker" ? "Dockerfile" : config2.app.runtime);
+  lines.push(`Detected: ${fw} (runtime=${config2.app.runtime})`);
+  if (config2.app.runtime === "bun") {
+    lines.push("Bun:      1.x (default)");
+  } else if (config2.app.runtime === "node") {
+    const node = resolveNodeVersion(tarball.cwd);
+    if (node) {
+      lines.push(`Node:     ${node.value} (${node.source})`);
+    }
+  }
+  if (config2.build?.command) {
+    lines.push(`Build:    ${config2.build.command}`);
+  }
+  if (config2.web?.health) {
+    lines.push(`Health:   ${config2.web.health}`);
+  }
+  if (config2.web?.port) {
+    lines.push(`Port:     ${config2.web.port}`);
+  }
+  const sizeKb = (tarball.bytes / 1024).toFixed(1);
+  lines.push(`Bundle:   ${tarball.fileCount} files, ${sizeKb} KB`);
+  lines.push(`Target:   ${config2.app.name}`);
+  for (const line of lines) {
+    ctx.status(line);
+  }
+}
 
 // ../core/dist/commands/publish.js
 var publishInputSchema = exports_external.object({
@@ -117729,7 +117952,7 @@ var publishInputSchema = exports_external.object({
 var SUSPICIOUS_BYTES = 50 * 1024 * 1024;
 var SUSPICIOUS_FILES = 1e4;
 function tomlPathFor2(cwd) {
-  return join24(cwd, "percher.toml");
+  return join25(cwd, "percher.toml");
 }
 async function buildReplacedResult2(opts) {
   const { ctx, app, deployment, tarball, cwd } = opts;
@@ -117885,7 +118108,7 @@ ${bullets}`,
       bundle: { fileCount: 0, bytes: 0 }
     };
   }
-  if (preParsedConfig && !input.dryRun && !existsSync15(join24(ctx.cwd, "percher.toml"))) {
+  if (preParsedConfig && !input.dryRun && !existsSync15(join25(ctx.cwd, "percher.toml"))) {
     return {
       status: "failed",
       fileCount: 0,
@@ -118202,7 +118425,8 @@ async function finalizeDeploy(opts) {
       }
     });
   } catch (err) {
-    if (err instanceof DeployPollLostContactError)
+    const serverError = err instanceof PercherApiError && err.status >= 500 && err.status < 600;
+    if (err instanceof DeployPollLostContactError || serverError)
       return inFlightPublishResult(inFlight(), "lost_contact");
     if (!timedOut)
       throw err;
@@ -118521,7 +118745,7 @@ async function handleAnonymousPublish(ctx, config2, input, tarball) {
 async function loadOrGenerate(ctx, preParsed) {
   if (preParsed)
     return structuredClone(preParsed);
-  const tomlPath = join24(ctx.cwd, "percher.toml");
+  const tomlPath = join25(ctx.cwd, "percher.toml");
   if (!existsSync15(tomlPath)) {
     ctx.status("No percher.toml found — detecting framework...");
     const generated = await init(ctx);
@@ -118545,32 +118769,6 @@ async function ensureApp2(ctx, config2) {
     throw err;
   }
 }
-function emitPreflight(ctx, config2, tarball) {
-  const lines = [];
-  const fw = config2.app.framework ?? (config2.app.runtime === "docker" ? "Dockerfile" : config2.app.runtime);
-  lines.push(`Detected: ${fw} (runtime=${config2.app.runtime})`);
-  if (config2.app.runtime === "node" || config2.app.runtime === "bun") {
-    const node = resolveNodeVersion(tarball.cwd);
-    if (node) {
-      lines.push(`Node:     ${node.value} (${node.source})`);
-    }
-  }
-  if (config2.build?.command) {
-    lines.push(`Build:    ${config2.build.command}`);
-  }
-  if (config2.web?.health) {
-    lines.push(`Health:   ${config2.web.health}`);
-  }
-  if (config2.web?.port) {
-    lines.push(`Port:     ${config2.web.port}`);
-  }
-  const sizeKb = (tarball.bytes / 1024).toFixed(1);
-  lines.push(`Bundle:   ${tarball.fileCount} files, ${sizeKb} KB`);
-  lines.push(`Target:   ${config2.app.name}`);
-  for (const line of lines) {
-    ctx.status(line);
-  }
-}
 // ../core/dist/commands/publish-from-repo.js
 init_dist();
 var publishFromRepoInputSchema = exports_external.object({
@@ -118601,7 +118799,7 @@ var publishInlineInputSchema = exports_external.object({
 // ../core/dist/commands/push.js
 init_dist();
 import { existsSync as existsSync16 } from "node:fs";
-import { join as join25 } from "node:path";
+import { join as join26 } from "node:path";
 var pushInputSchema = exports_external.object({
   dryRun: exports_external.boolean().optional(),
   force: exports_external.boolean().optional(),
@@ -118612,7 +118810,7 @@ var SUSPICIOUS_BYTES2 = 50 * 1024 * 1024;
 var SUSPICIOUS_FILES2 = 1e4;
 var PLACEHOLDER_PREFIXES = ["add-your-", "your-key-here"];
 async function loadOrGenerate2(ctx) {
-  const tomlPath = join25(ctx.cwd, "percher.toml");
+  const tomlPath = join26(ctx.cwd, "percher.toml");
   if (!existsSync16(tomlPath)) {
     ctx.status("No percher.toml found — detecting framework...");
     const result = await init(ctx);
@@ -118724,7 +118922,7 @@ async function push(ctx, input = {}, internals = {}) {
       fileCount: tarball.fileCount,
       recovery: RECOVERY_NONE,
       summary: `Dry run for ${config2.app.name}: ${tarball.fileCount} files, ${(tarball.bytes / 1024).toFixed(1)} KB — no deploy performed.`,
-      configPath: join25(ctx.cwd, "percher.toml"),
+      configPath: join26(ctx.cwd, "percher.toml"),
       bundle: { fileCount: tarball.fileCount, bytes: tarball.bytes }
     };
   }
@@ -118912,7 +119110,7 @@ ${deployment.errorMessage}` : "";
     fileCount: tarball.fileCount,
     recovery: RECOVERY_NONE,
     summary,
-    configPath: join25(ctx.cwd, "percher.toml"),
+    configPath: join26(ctx.cwd, "percher.toml"),
     bundle: { fileCount: tarball.fileCount, bytes: tarball.bytes }
   };
 }
@@ -119241,8 +119439,8 @@ function failureResult(error48) {
   };
 }
 // ../core/dist/commands/rename.js
-import { existsSync as existsSync17, readFileSync as readFileSync12, writeFileSync as writeFileSync9 } from "node:fs";
-import { join as join26 } from "node:path";
+import { existsSync as existsSync17, readFileSync as readFileSync13, writeFileSync as writeFileSync10 } from "node:fs";
+import { join as join27 } from "node:path";
 var renameInputSchema = exports_external.object({
   app: exports_external.string().optional(),
   name: exports_external.string().min(3).max(40)
@@ -119262,17 +119460,17 @@ async function rename3(ctx, input) {
   };
 }
 function updateLocalTomlName(cwd, oldName, newName) {
-  const p = join26(cwd, "percher.toml");
+  const p = join27(cwd, "percher.toml");
   if (!existsSync17(p))
     return false;
   try {
-    const src = readFileSync12(p, "utf8");
+    const src = readFileSync13(p, "utf8");
     if (parse5(src).app.name !== oldName)
       return false;
     const next = src.replace(new RegExp(`(name\\s*=\\s*")${oldName}(")`), `$1${newName}$2`);
     if (next === src || parse5(next).app.name !== newName)
       return false;
-    writeFileSync9(p, next);
+    writeFileSync10(p, next);
     return true;
   } catch {
     return false;
@@ -119281,9 +119479,9 @@ function updateLocalTomlName(cwd, oldName, newName) {
 // ../core/dist/commands/reproduce.js
 init_dist();
 var import_cross_spawn3 = __toESM(require_cross_spawn(), 1);
-import { mkdtempSync, writeFileSync as writeFileSync10 } from "node:fs";
+import { mkdtempSync, writeFileSync as writeFileSync11 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 function runProcessExit(cmd, args, opts = {}) {
   return new Promise((resolve11, reject) => {
     const child = import_cross_spawn3.default(cmd, args, {
@@ -119377,9 +119575,9 @@ async function reproduce(ctx, input) {
     const envMap = await ctx.client.env.list(app.id);
     currentAppEnvKeys = Object.keys(envMap).sort();
   } catch {}
-  const tmpDir = mkdtempSync(join27(tmpdir(), `percher-reproduce-${input.deployId}-`));
-  const tarballPath = join27(tmpDir, "source.tar.gz");
-  writeFileSync10(tarballPath, bytes);
+  const tmpDir = mkdtempSync(join28(tmpdir(), `percher-reproduce-${input.deployId}-`));
+  const tarballPath = join28(tmpDir, "source.tar.gz");
+  writeFileSync11(tarballPath, bytes);
   let extracted = false;
   try {
     extracted = await runProcessExit("tar", ["-xzf", tarballPath, "-C", tmpDir]) === 0;
@@ -119977,6 +120175,7 @@ var SOURCE_EXTS2 = new Set([
   ".py"
 ]);
 var DEFAULT_MAX_FILE_BYTES = 1024 * 1024;
+var IMPORT_META_CONSTANTS = new Set(["DEV", "PROD", "MODE", "BASE_URL", "SSR"]);
 // ../core/dist/plans.js
 var PB_INITIAL_FOOTPRINT_MB = 256;
 var EGRESS_GB_PER_MONTH = {
@@ -120183,6 +120382,15 @@ async function writeLine2(ctx, line) {
     writer.releaseLock();
   }
 }
+async function writeErrLine(ctx, line) {
+  const writer = ctx.stderr.getWriter();
+  try {
+    await writer.write(new TextEncoder().encode(`${line}
+`));
+  } finally {
+    writer.releaseLock();
+  }
+}
 async function writeUnknownCommand(ctx, name) {
   const writer = ctx.stderr.getWriter();
   try {
@@ -121578,6 +121786,7 @@ function registerDeploysCommands(cli, ctx, argv) {
       rebuild: Boolean(options.rebuild)
     });
     await writeLine2(ctx, `${import_picocolors8.default.green("✓")} rolled back to ${result.rolledBackTo.slice(0, 10)} (status: ${result.status})`);
+    await writeLine2(ctx, "Env vars are not rolled back; the current values stay.");
   });
   cli.command("reproduce <deployId>", "Download a deploy's source and reproduce the build locally").option("--app <name>", "App name (defaults to percher.toml app.name)").action(async (deployId, options) => {
     const result = await reproduce(ctx, {
@@ -121656,6 +121865,8 @@ function registerDeploysCommands(cli, ctx, argv) {
     for (const v of list) {
       const message = v.message.split(`
 `)[0]?.trim() ?? "";
+      const note = Array.from((v.note ?? "").replace(/[\p{Cc}\p{Cf}\p{Cs}\p{Zl}\p{Zp}]/gu, " ").replace(/\s+/g, " ").trim());
+      const noteLabel = note.length > 80 ? `${note.slice(0, 79).join("")}…` : note.join("");
       const channelLabels = {
         cli: "CLI",
         mcp: "MCP",
@@ -121670,7 +121881,7 @@ function registerDeploysCommands(cli, ctx, argv) {
       const marker = target && target.mode !== "in-window" ? target.mode === "rebuild" ? "[rebuild required]" : "[not a rollback target]" : null;
       if (marker && target)
         reasons.set(marker, target.explanation);
-      await writeLine2(ctx, `${v.sha}  ${v.timestamp}  ${message}${suffix}${marker ? `  ${marker}` : ""}`);
+      await writeLine2(ctx, `${v.sha}  ${v.timestamp}  ${message}${noteLabel ? `  · ${noteLabel}` : ""}${suffix}${marker ? `  ${marker}` : ""}`);
     }
     for (const [marker, explanation] of reasons) {
       await writeLine2(ctx, `
@@ -122376,8 +122587,209 @@ async function renderHumanStatus(ctx, result) {
   }
 }
 
-// src/commands/token.ts
+// src/commands/telemetry.ts
+init_dist();
 var import_picocolors16 = __toESM(require_picocolors(), 1);
+
+// src/telemetry.ts
+init_dist();
+import { createInterface } from "node:readline";
+// package.json
+var package_default2 = {
+  name: "percher",
+  version: "1.2.0",
+  description: "CLI for the Percher hosting platform — publish apps with one command",
+  type: "module",
+  bin: {
+    percher: "./dist/bin/percher.js"
+  },
+  main: "./dist/src/index.js",
+  types: "./dist/src/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/src/index.d.ts",
+      import: "./dist/src/index.js",
+      default: "./dist/src/index.js"
+    }
+  },
+  files: [
+    "dist",
+    "THIRD-PARTY-NOTICES.txt"
+  ],
+  publishConfig: {
+    access: "public"
+  },
+  scripts: {
+    build: `tsc -p tsconfig.json && tsc-alias -p tsconfig.json && bun build bin/percher.ts --outfile dist/bin/percher.js --target node --format esm --metafile=bundle-meta.json && node ../../scripts/bundle-notices.mjs . bundle-meta.json && node scripts/copy-templates.mjs && node -e "require('fs').chmodSync('dist/bin/percher.js',0o755)"`,
+    test: "bun test",
+    typecheck: "tsc --noEmit"
+  },
+  dependencies: {
+    "@percher/client": "^1.2.0",
+    "@percher/core": "^1.2.0",
+    "@percher/toml": "^1.0.3",
+    cac: "^7.0.0",
+    picocolors: "^1.1.1"
+  },
+  devDependencies: {
+    "bun-types": "^1.1.0",
+    "tsc-alias": "^1.8.17"
+  },
+  engines: {
+    bun: ">=1.0.0",
+    node: ">=22.0.0"
+  },
+  license: "FSL-1.1-MIT",
+  author: "Mattias Malmborg",
+  repository: {
+    type: "git",
+    url: "https://github.com/mattiasmalmborg/percher"
+  },
+  keywords: [
+    "hosting",
+    "deploy",
+    "cli",
+    "paas",
+    "bun",
+    "ai"
+  ]
+};
+
+// src/telemetry.ts
+var VERSION = package_default2.version;
+function trackEvent(command, result, errorType) {
+  if (!telemetryState().enabled)
+    return;
+  const body = JSON.stringify({
+    cliVersion: VERSION,
+    command,
+    result,
+    errorType,
+    os: `${process.platform}-${process.arch}`,
+    bunVersion: typeof Bun !== "undefined" ? Bun.version : undefined
+  });
+  fetch(`${resolveApiUrl()}/telemetry/cli`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body,
+    signal: AbortSignal.timeout(3000)
+  }).catch(() => {});
+}
+function lineAsker(input, output, onInterrupt = () => process.exit(130)) {
+  return (question, signal) => new Promise((resolve11) => {
+    const rl = createInterface({
+      input,
+      output,
+      terminal: input.isTTY === true
+    });
+    let settled = false;
+    const finish = (answer) => {
+      if (settled)
+        return;
+      settled = true;
+      signal.removeEventListener("abort", onAbort);
+      if (answer === null)
+        output.write(`
+`);
+      resolve11(answer);
+      rl.close();
+    };
+    const onAbort = () => finish(null);
+    signal.addEventListener("abort", onAbort, { once: true });
+    rl.on("line", (line) => finish(line));
+    rl.on("close", () => finish(null));
+    rl.on("SIGINT", () => {
+      finish(null);
+      onInterrupt();
+    });
+    rl.setPrompt(question);
+    rl.prompt();
+    if (signal.aborted)
+      finish(null);
+  });
+}
+var askOnStdin = lineAsker(process.stdin, process.stderr);
+var ANSWER_TIMEOUT_MS = 20000;
+var CI_VARS = ["CONTINUOUS_INTEGRATION", "BUILD_NUMBER", "TF_BUILD", "JENKINS_URL"];
+var AGENT_VARS = [
+  "CLAUDECODE",
+  "CURSOR_AGENT",
+  "CURSOR_TRACE_ID",
+  "CODEX_SANDBOX",
+  "CODEX_CI",
+  "GITHUB_ACTIONS"
+];
+function isUnattended(env) {
+  const ci = env.CI;
+  if (ci !== undefined && ci !== "" && ci !== "0" && ci !== "false")
+    return true;
+  return [...CI_VARS, ...AGENT_VARS].some((key) => Boolean(env[key]));
+}
+var realTimer = (fire, ms) => {
+  const handle = setTimeout(fire, ms);
+  return () => clearTimeout(handle);
+};
+async function askTelemetryConsentOnce(ctx, argv, command, question) {
+  if (command === "telemetry" || argv.includes("--json"))
+    return;
+  if (ctx.stdinIsInteractive !== true || !question.stderrIsTTY)
+    return;
+  if (isUnattended(ctx.env))
+    return;
+  const state = telemetryState();
+  if (state.envOptOut || state.stored)
+    return;
+  const timeout = new AbortController;
+  const cancel = (question.setTimer ?? realTimer)(() => timeout.abort(), ANSWER_TIMEOUT_MS);
+  let answer;
+  try {
+    answer = await question.ask("Send anonymous usage statistics to Percher? (y/N) ", timeout.signal);
+  } finally {
+    cancel();
+  }
+  if (answer === null)
+    return;
+  const enabled = /^y(es)?$/i.test(answer.trim());
+  try {
+    saveTelemetryAnswer(enabled, VERSION);
+  } catch {
+    await writeErrLine(ctx, "Could not save the answer; you will be asked again.");
+    return;
+  }
+  await writeErrLine(ctx, enabled ? "Usage statistics on. Turn off: percher telemetry off" : "Usage statistics off. Turn on: percher telemetry on");
+}
+function telemetryStatusLine(state = telemetryState()) {
+  const stored = state.stored ? `stored answer: ${state.stored.enabled ? "on" : "off"}` : null;
+  if (state.envOptOut) {
+    return `Telemetry: off (env opt-out: ${state.envOptOut}${stored ? `; ${stored}` : ""})`;
+  }
+  if (state.stored)
+    return `Telemetry: ${state.stored.enabled ? "on" : "off"} (stored answer)`;
+  return "Telemetry: off (undecided)";
+}
+
+// src/commands/telemetry.ts
+function registerTelemetryCommands(cli, ctx) {
+  cli.command("telemetry [action]", "Anonymous usage statistics: on | off | status").action(async (action) => {
+    if (action === "on" || action === "off") {
+      try {
+        saveTelemetryAnswer(action === "on", VERSION);
+      } catch {
+        await writeErrLine(ctx, `${import_picocolors16.default.red("✗")} Could not save the answer.`);
+        throw new SilentExitError;
+      }
+    } else if (action !== undefined && action !== "status") {
+      await writeErrLine(ctx, `${import_picocolors16.default.red("✗")} Usage: percher telemetry on|off|status`);
+      throw new SilentExitError;
+    }
+    const state = telemetryState();
+    const overridden = action === "on" && state.envOptOut !== null;
+    await writeLine2(ctx, `${telemetryStatusLine(state)}${overridden ? "; the environment variable still wins." : ""}`);
+  });
+}
+
+// src/commands/token.ts
+var import_picocolors17 = __toESM(require_picocolors(), 1);
 var VALID_SCOPES = ["deploy", "env", "read", "full"];
 function scopeLabel(scopes, appName) {
   const s = scopes && scopes.length > 0 ? scopes.join("+") : "full";
@@ -122386,22 +122798,22 @@ function scopeLabel(scopes, appName) {
 function registerTokenCommands(cli, ctx) {
   cli.command("token [action] [arg]", "Manage API tokens: create | list | revoke").option("--scope <scope>", "(create) deploy | env | read | full (default: full, account-wide unless --app)").option("--app <name>", "(create) bind the token to a single app").option("--ttl-days <n>", "(create) token lifetime in days (default 90, max 365)").action(async (action, arg, options) => {
     if (!ctx.client.token) {
-      await writeLine2(ctx, `${import_picocolors16.default.red("✗")} Not logged in. Run: percher login`);
+      await writeLine2(ctx, `${import_picocolors17.default.red("✗")} Not logged in. Run: percher login`);
       throw new SilentExitError;
     }
     if (action === "create") {
       if (!arg) {
-        await writeLine2(ctx, `${import_picocolors16.default.red("✗")} A name is required. Usage: percher token create <name> [--scope deploy] [--app <name>]`);
+        await writeLine2(ctx, `${import_picocolors17.default.red("✗")} A name is required. Usage: percher token create <name> [--scope deploy] [--app <name>]`);
         throw new SilentExitError;
       }
       const scope = options.scope ?? "full";
       if (!VALID_SCOPES.includes(scope)) {
-        await writeLine2(ctx, `${import_picocolors16.default.red("✗")} Invalid --scope "${options.scope}". Use one of: ${VALID_SCOPES.join(", ")}.`);
+        await writeLine2(ctx, `${import_picocolors17.default.red("✗")} Invalid --scope "${options.scope}". Use one of: ${VALID_SCOPES.join(", ")}.`);
         throw new SilentExitError;
       }
       const ttlDays = options.ttlDays !== undefined ? Number(options.ttlDays) : undefined;
       if (ttlDays !== undefined && (!Number.isInteger(ttlDays) || ttlDays <= 0)) {
-        await writeLine2(ctx, `${import_picocolors16.default.red("✗")} --ttl-days must be a positive whole number.`);
+        await writeLine2(ctx, `${import_picocolors17.default.red("✗")} --ttl-days must be a positive whole number.`);
         throw new SilentExitError;
       }
       const created = await tokenCreate(ctx, {
@@ -122410,36 +122822,36 @@ function registerTokenCommands(cli, ctx) {
         app: options.app,
         ttlDays
       });
-      await writeLine2(ctx, `${import_picocolors16.default.green("✓")} Token created: ${import_picocolors16.default.bold(created.name)}  ${import_picocolors16.default.dim(`(${scopeLabel(created.scopes, created.appName)})`)}`);
+      await writeLine2(ctx, `${import_picocolors17.default.green("✓")} Token created: ${import_picocolors17.default.bold(created.name)}  ${import_picocolors17.default.dim(`(${scopeLabel(created.scopes, created.appName)})`)}`);
       await writeLine2(ctx, "");
-      await writeLine2(ctx, `  ${import_picocolors16.default.bold(created.token)}`);
-      await writeLine2(ctx, import_picocolors16.default.yellow("  ↑ Store this now — the secret is shown only once and can't be retrieved."));
+      await writeLine2(ctx, `  ${import_picocolors17.default.bold(created.token)}`);
+      await writeLine2(ctx, import_picocolors17.default.yellow("  ↑ Store this now — the secret is shown only once and can't be retrieved."));
       await writeLine2(ctx, "");
-      await writeLine2(ctx, import_picocolors16.default.dim("  Use it in CI / an agent:"));
-      await writeLine2(ctx, import_picocolors16.default.dim(`    PERCHER_TOKEN=${created.token} bunx percher publish`));
+      await writeLine2(ctx, import_picocolors17.default.dim("  Use it in CI / an agent:"));
+      await writeLine2(ctx, import_picocolors17.default.dim(`    PERCHER_TOKEN=${created.token} bunx percher publish`));
       return;
     }
     if (action === "list") {
       const tokens = await tokenList(ctx);
       if (tokens.length === 0) {
-        await writeLine2(ctx, import_picocolors16.default.dim("No API tokens."));
+        await writeLine2(ctx, import_picocolors17.default.dim("No API tokens."));
         return;
       }
       for (const t of tokens) {
         const expires = t.expiresAt ? `expires ${new Date(t.expiresAt).toISOString().slice(0, 10)}` : "no expiry";
-        await writeLine2(ctx, `${import_picocolors16.default.bold(t.id)}  ${t.name.padEnd(20)} ${import_picocolors16.default.dim(scopeLabel(t.scopes, t.appName))}  ${import_picocolors16.default.dim(expires)}`);
+        await writeLine2(ctx, `${import_picocolors17.default.bold(t.id)}  ${t.name.padEnd(20)} ${import_picocolors17.default.dim(scopeLabel(t.scopes, t.appName))}  ${import_picocolors17.default.dim(expires)}`);
       }
       await writeLine2(ctx, "");
-      await writeLine2(ctx, import_picocolors16.default.dim("Revoke one with: percher token revoke <id>"));
+      await writeLine2(ctx, import_picocolors17.default.dim("Revoke one with: percher token revoke <id>"));
       return;
     }
     if (action === "revoke") {
       if (!arg) {
-        await writeLine2(ctx, `${import_picocolors16.default.red("✗")} A token id is required. Usage: percher token revoke <id> (list ids with \`percher token list\`).`);
+        await writeLine2(ctx, `${import_picocolors17.default.red("✗")} A token id is required. Usage: percher token revoke <id> (list ids with \`percher token list\`).`);
         throw new SilentExitError;
       }
       await tokenRevoke(ctx, { id: arg });
-      await writeLine2(ctx, `${import_picocolors16.default.green("✓")} Token revoked.`);
+      await writeLine2(ctx, `${import_picocolors17.default.green("✓")} Token revoked.`);
       return;
     }
     throw new Error(`Unknown token action "${action ?? ""}". Use: create | list | revoke.`);
@@ -122450,17 +122862,17 @@ function registerTokenCommands(cli, ctx) {
 }
 
 // src/commands/transfers.ts
-var import_picocolors17 = __toESM(require_picocolors(), 1);
+var import_picocolors18 = __toESM(require_picocolors(), 1);
 function registerTransfersCommands(cli, ctx) {
   cli.command("transfer [emailOrTransferId]", "Transfer ownership of an app: `transfer <email>` initiates; `transfer --cancel <id>` cancels; `transfer --list` shows history").option("--app <name>", "App name (overrides percher.toml)").option("--cancel", "Cancel a pending transfer by id (positional arg is the transferId)").option("--list", "List the transfer history for this app").action(async (emailOrTransferId, options) => {
     if (options.list) {
       const rows = await transferListForApp(ctx, { app: options.app });
       if (rows.length === 0) {
-        await writeLine2(ctx, import_picocolors17.default.dim("No transfers for this app."));
+        await writeLine2(ctx, import_picocolors18.default.dim("No transfers for this app."));
         return;
       }
       for (const r of rows) {
-        const status2 = r.status === "pending" ? import_picocolors17.default.yellow("pending") : r.status === "accepted" ? import_picocolors17.default.green("accepted") : import_picocolors17.default.dim(r.status);
+        const status2 = r.status === "pending" ? import_picocolors18.default.yellow("pending") : r.status === "accepted" ? import_picocolors18.default.green("accepted") : import_picocolors18.default.dim(r.status);
         await writeLine2(ctx, `${r.id}  ${status2.padEnd(20)}  → ${r.toEmail}  (${r.createdAt})`);
       }
       return;
@@ -122473,7 +122885,7 @@ function registerTransfersCommands(cli, ctx) {
         app: options.app,
         transferId: emailOrTransferId
       });
-      await writeLine2(ctx, `${import_picocolors17.default.green("✓")} Cancelled transfer ${emailOrTransferId}`);
+      await writeLine2(ctx, `${import_picocolors18.default.green("✓")} Cancelled transfer ${emailOrTransferId}`);
       return;
     }
     if (!emailOrTransferId) {
@@ -122483,17 +122895,17 @@ function registerTransfersCommands(cli, ctx) {
       app: options.app,
       email: emailOrTransferId
     });
-    await writeLine2(ctx, `${import_picocolors17.default.green("✓")} Transfer initiated to ${initiated.toEmail} (id ${initiated.id})`);
-    await writeLine2(ctx, import_picocolors17.default.dim(`Expires ${new Date(initiated.expiresAt).toLocaleDateString()}. The recipient must accept via 'percher transfers accept ${initiated.id}'.`));
+    await writeLine2(ctx, `${import_picocolors18.default.green("✓")} Transfer initiated to ${initiated.toEmail} (id ${initiated.id})`);
+    await writeLine2(ctx, import_picocolors18.default.dim(`Expires ${new Date(initiated.expiresAt).toLocaleDateString()}. The recipient must accept via 'percher transfers accept ${initiated.id}'.`));
     if (initiated.notes) {
-      await writeLine2(ctx, import_picocolors17.default.yellow(`  ⚠  ${initiated.notes}`));
+      await writeLine2(ctx, import_picocolors18.default.yellow(`  ⚠  ${initiated.notes}`));
     }
   });
   cli.command("transfers [action] [transferId]", "Incoming ownership transfers: list (default) | accept <transferId> | decline <transferId>").action(async (action, transferId) => {
     if (action === undefined || action === "list") {
       const rows = await transfersIncoming(ctx, {});
       if (rows.length === 0) {
-        await writeLine2(ctx, import_picocolors17.default.dim("No pending incoming transfers."));
+        await writeLine2(ctx, import_picocolors18.default.dim("No pending incoming transfers."));
         return;
       }
       for (const r of rows) {
@@ -122506,7 +122918,7 @@ function registerTransfersCommands(cli, ctx) {
         throw new Error("Usage: percher transfers accept <transferId>");
       }
       const accepted = await transfersAccept(ctx, { transferId });
-      await writeLine2(ctx, `${import_picocolors17.default.green("✓")} You now own ${import_picocolors17.default.cyan(accepted.appName)}. Run 'percher open ${accepted.appName}' to see it.`);
+      await writeLine2(ctx, `${import_picocolors18.default.green("✓")} You now own ${import_picocolors18.default.cyan(accepted.appName)}. Run 'percher open ${accepted.appName}' to see it.`);
       return;
     }
     if (action === "decline") {
@@ -122514,7 +122926,7 @@ function registerTransfersCommands(cli, ctx) {
         throw new Error("Usage: percher transfers decline <transferId>");
       }
       await transfersDecline(ctx, { transferId });
-      await writeLine2(ctx, `${import_picocolors17.default.green("✓")} Declined transfer ${transferId}.`);
+      await writeLine2(ctx, `${import_picocolors18.default.green("✓")} Declined transfer ${transferId}.`);
       return;
     }
     throw new Error(`Unknown transfers action "${action}". Use list | accept <id> | decline <id>.`);
@@ -122543,9 +122955,9 @@ async function openUrl(url2) {
 
 // src/prompt.ts
 import { stdin as input, stdout as output } from "node:process";
-import { createInterface } from "node:readline/promises";
+import { createInterface as createInterface2 } from "node:readline/promises";
 async function prompt(question, options) {
-  const rl = createInterface({ input, output });
+  const rl = createInterface2({ input, output });
   try {
     const suffix = options?.default ? ` [${options.default}]` : "";
     const answer = await rl.question(`${question}${suffix} `);
@@ -122555,111 +122967,6 @@ async function prompt(question, options) {
   }
 }
 
-// src/telemetry.ts
-init_dist();
-// package.json
-var package_default2 = {
-  name: "percher",
-  version: "1.1.0",
-  description: "CLI for the Percher hosting platform — publish apps with one command",
-  type: "module",
-  bin: {
-    percher: "./dist/bin/percher.js"
-  },
-  main: "./dist/src/index.js",
-  types: "./dist/src/index.d.ts",
-  exports: {
-    ".": {
-      types: "./dist/src/index.d.ts",
-      import: "./dist/src/index.js",
-      default: "./dist/src/index.js"
-    }
-  },
-  files: [
-    "dist",
-    "THIRD-PARTY-NOTICES.txt"
-  ],
-  publishConfig: {
-    access: "public"
-  },
-  scripts: {
-    build: `tsc -p tsconfig.json && tsc-alias -p tsconfig.json && bun build bin/percher.ts --outfile dist/bin/percher.js --target node --format esm --metafile=bundle-meta.json && node ../../scripts/bundle-notices.mjs . bundle-meta.json && node scripts/copy-templates.mjs && node -e "require('fs').chmodSync('dist/bin/percher.js',0o755)"`,
-    test: "bun test",
-    typecheck: "tsc --noEmit"
-  },
-  dependencies: {
-    "@percher/client": "^1.1.0",
-    "@percher/core": "^1.1.0",
-    "@percher/toml": "^1.0.3",
-    cac: "^7.0.0",
-    picocolors: "^1.1.1"
-  },
-  devDependencies: {
-    "bun-types": "^1.1.0",
-    "tsc-alias": "^1.8.17"
-  },
-  engines: {
-    bun: ">=1.0.0",
-    node: ">=22.0.0"
-  },
-  license: "FSL-1.1-MIT",
-  author: "Mattias Malmborg",
-  repository: {
-    type: "git",
-    url: "https://github.com/mattiasmalmborg/percher"
-  },
-  keywords: [
-    "hosting",
-    "deploy",
-    "cli",
-    "paas",
-    "bun",
-    "ai"
-  ]
-};
-
-// src/telemetry.ts
-var VERSION = package_default2.version;
-function isDisabled() {
-  return process.env.PERCHER_NO_TELEMETRY === "1" || process.env.PERCHER_NO_TELEMETRY === "true" || process.env.DO_NOT_TRACK === "1";
-}
-function trackEvent(command, result, errorType) {
-  if (isDisabled())
-    return;
-  const body = JSON.stringify({
-    cliVersion: VERSION,
-    command,
-    result,
-    errorType,
-    os: `${process.platform}-${process.arch}`,
-    bunVersion: typeof Bun !== "undefined" ? Bun.version : undefined
-  });
-  fetch(`${resolveApiUrl()}/telemetry/cli`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body,
-    signal: AbortSignal.timeout(3000)
-  }).catch(() => {});
-}
-async function showTelemetryNotice() {
-  if (isDisabled())
-    return;
-  const { homedir: homedir2 } = await import("node:os");
-  const { existsSync: existsSync18, mkdirSync: mkdirSync7, writeFileSync: writeFileSync11 } = await import("node:fs");
-  const { join: join28 } = await import("node:path");
-  const configDir = join28(homedir2(), ".percher");
-  const markerFile = join28(configDir, ".telemetry-notice-shown");
-  if (existsSync18(markerFile))
-    return;
-  console.error("Percher sends non-account-linked usage stats (CLI version, command, result, error type, OS, Bun version).");
-  console.error(`Disable with PERCHER_NO_TELEMETRY=1 or DO_NOT_TRACK=1
-`);
-  try {
-    mkdirSync7(configDir, { recursive: true });
-    writeFileSync11(markerFile, new Date().toISOString());
-  } catch {}
-}
-
 // src/context.ts
 async function createCliContext() {
   const client = new PercherClient({ clientVersion: `percher-cli/${VERSION}` });
@@ -122693,52 +123000,52 @@ async function createCliContext() {
 
 // src/output.ts
 init_dist();
-var import_picocolors18 = __toESM(require_picocolors(), 1);
+var import_picocolors19 = __toESM(require_picocolors(), 1);
 async function renderError(stderr, error48) {
   const writer = stderr.getWriter();
   const encoder = new TextEncoder;
   const lines = [];
   if (error48 instanceof PercherTomlError) {
-    lines.push(`${import_picocolors18.default.red(`error (${error48.code}):`)} ${error48.message}`);
+    lines.push(`${import_picocolors19.default.red(`error (${error48.code}):`)} ${error48.message}`);
     if (error48.tomlLine !== undefined) {
-      lines.push(import_picocolors18.default.dim(`  at percher.toml line ${error48.tomlLine}`));
+      lines.push(import_picocolors19.default.dim(`  at percher.toml line ${error48.tomlLine}`));
     }
     for (const issue2 of error48.issues ?? []) {
-      lines.push(`${import_picocolors18.default.dim("  · ") + import_picocolors18.default.yellow(issue2.path.join("."))}: ${issue2.message}`);
+      lines.push(`${import_picocolors19.default.dim("  · ") + import_picocolors19.default.yellow(issue2.path.join("."))}: ${issue2.message}`);
     }
   } else if (error48 instanceof SunsetError) {
     if (error48.gateCode === "platform_delete_gated") {
-      lines.push(`${import_picocolors18.default.yellow("Percher is shutting down — deletes are paused.")}`);
+      lines.push(`${import_picocolors19.default.yellow("Percher is shutting down — deletes are paused.")}`);
       lines.push(error48.message);
-      lines.push(import_picocolors18.default.dim(`  To delete and permanently forfeit your export window, confirm with your password in the dashboard: ${error48.dashboardUrl}`));
-      lines.push(import_picocolors18.default.dim("  The CLI cannot perform this delete during sunset — it must go through the dashboard."));
+      lines.push(import_picocolors19.default.dim(`  To delete and permanently forfeit your export window, confirm with your password in the dashboard: ${error48.dashboardUrl}`));
+      lines.push(import_picocolors19.default.dim("  The CLI cannot perform this delete during sunset — it must go through the dashboard."));
     } else {
-      lines.push(`${import_picocolors18.default.yellow("Percher is in read-only mode ahead of shutdown.")}`);
+      lines.push(`${import_picocolors19.default.yellow("Percher is in read-only mode ahead of shutdown.")}`);
       lines.push(error48.message);
-      lines.push(import_picocolors18.default.dim(`  Your apps keep running. Export them any time from the dashboard: ${error48.dashboardUrl}`));
+      lines.push(import_picocolors19.default.dim(`  Your apps keep running. Export them any time from the dashboard: ${error48.dashboardUrl}`));
     }
-    lines.push(import_picocolors18.default.dim(`  Final data deletion: ${error48.finalDeletionDate}`));
+    lines.push(import_picocolors19.default.dim(`  Final data deletion: ${error48.finalDeletionDate}`));
   } else if (error48 instanceof PercherApiError) {
     if (error48.status === 502 || error48.status === 503) {
-      lines.push(`${import_picocolors18.default.red("error:")} Percher API is temporarily unavailable (HTTP ${error48.status}). Try again in a few seconds.`);
+      lines.push(`${import_picocolors19.default.red("error:")} Percher API is temporarily unavailable (HTTP ${error48.status}). Try again in a few seconds.`);
     } else {
-      lines.push(`${import_picocolors18.default.red("error:")} ${error48.message}`);
-      lines.push(import_picocolors18.default.dim(`  ${error48.code} (HTTP ${error48.status})`));
+      lines.push(`${import_picocolors19.default.red("error:")} ${error48.message}`);
+      lines.push(import_picocolors19.default.dim(`  ${error48.code} (HTTP ${error48.status})`));
     }
     if (error48.requestId)
-      lines.push(import_picocolors18.default.dim(`  request: ${error48.requestId}`));
+      lines.push(import_picocolors19.default.dim(`  request: ${error48.requestId}`));
   } else if (error48 instanceof PercherCoreError) {
-    lines.push(`${import_picocolors18.default.red(`error (${error48.code}):`)} ${error48.message}`);
+    lines.push(`${import_picocolors19.default.red(`error (${error48.code}):`)} ${error48.message}`);
     if (error48.hint)
-      lines.push(import_picocolors18.default.dim(`  ${error48.hint}`));
+      lines.push(import_picocolors19.default.dim(`  ${error48.hint}`));
   } else if (error48 instanceof Error) {
-    lines.push(`${import_picocolors18.default.red("unexpected error:")} ${error48.message}`);
+    lines.push(`${import_picocolors19.default.red("unexpected error:")} ${error48.message}`);
     if (error48.stack)
-      lines.push(import_picocolors18.default.dim(error48.stack.split(`
+      lines.push(import_picocolors19.default.dim(error48.stack.split(`
 `).slice(1, 4).join(`
 `)));
   } else {
-    lines.push(`${import_picocolors18.default.red("unexpected error:")} ${String(error48)}`);
+    lines.push(`${import_picocolors19.default.red("unexpected error:")} ${String(error48)}`);
   }
   try {
     await writer.write(encoder.encode(`${lines.join(`
@@ -122750,7 +123057,7 @@ async function renderError(stderr, error48) {
 }
 
 // src/version-check.ts
-var import_picocolors19 = __toESM(require_picocolors(), 1);
+var import_picocolors20 = __toESM(require_picocolors(), 1);
 function isNewerStableVersion(latest, current) {
   const stable = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
   if (typeof latest !== "string" || latest.length > 64 || current.length > 64 || !stable.test(latest) || !stable.test(current))
@@ -122777,16 +123084,16 @@ async function checkForUpdates() {
     const data2 = await res.json();
     const latest = data2.version;
     if (isNewerStableVersion(latest, VERSION)) {
-      console.error(import_picocolors19.default.yellow(`
+      console.error(import_picocolors20.default.yellow(`
 Update available: ${VERSION} → ${latest}`));
-      console.error(import_picocolors19.default.dim(`Run: bunx percher@latest
+      console.error(import_picocolors20.default.dim(`Run: bunx percher@latest
 `));
     }
   } catch {}
 }
 
 // src/index.ts
-async function run(argv, ctxOverride) {
+async function run(argv, ctxOverride, options = {}) {
   const cli = cac("percher");
   const ctx = ctxOverride ?? await createCliContext();
   registerAppsCommands(cli, ctx);
@@ -122802,6 +123109,7 @@ async function run(argv, ctxOverride) {
   registerMigrateCommands(cli, ctx);
   registerSharingCommands(cli, ctx);
   registerStatusCommands(cli, ctx);
+  registerTelemetryCommands(cli, ctx);
   registerTokenCommands(cli, ctx);
   registerTransfersCommands(cli, ctx);
   registerAdminCommands(cli, ctx);
@@ -122809,10 +123117,14 @@ async function run(argv, ctxOverride) {
   cli.version(VERSION);
   const command = argv[0] ?? "help";
   try {
-    await showTelemetryNotice();
     cli.parse(["percher", "percher", ...argv], { run: false });
     const requested = argv[0];
     if (cli.matchedCommand) {
+      await askTelemetryConsentOnce(ctx, argv, cli.matchedCommand.name, {
+        ask: options.askTelemetry ?? askOnStdin,
+        stderrIsTTY: options.stderrIsTTY ?? process.stderr.isTTY === true,
+        setTimer: options.setTimer
+      });
       await cli.runMatchedCommand();
     } else if (requested === undefined || requested === "help") {
       cli.outputHelp();