vibeview 0.27.0 → 0.28.0

package/dist/{chunk-46X7UN6Y.js → chunk-OKOAWGWV.js}

@@ -6,10 +6,14 @@ import {
   UsageError,
   createSpinner,
   errorExitCode,
+  formatUtcTimestamp,
   loadConfig,
+  prepareUploadArtifact,
+  queueReasonCopy,
+  resolveArtifact,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-U7FCGMWG.js";
+} from "./chunk-2JLTC67A.js";
 
 // src/lib/dev-config.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -164,6 +168,30 @@ function validateBuildEnv(env, platformKey) {
 function saveDevConfig(cwd, cfg) {
   writeFileSync(join(cwd, FILE), JSON.stringify(cfg, null, 2) + "\n");
 }
+function describeConfigChanges(before, after) {
+  const flat = (value, prefix, out) => {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      for (const [k, v] of Object.entries(value)) {
+        flat(v, prefix ? `${prefix}.${k}` : k, out);
+      }
+    } else if (value !== void 0) {
+      out.set(prefix, typeof value === "string" ? value : JSON.stringify(value));
+    }
+    return out;
+  };
+  const a = flat(before, "", /* @__PURE__ */ new Map());
+  const b = flat(after, "", /* @__PURE__ */ new Map());
+  const changes = [];
+  for (const [key, next] of b) {
+    const prev = a.get(key);
+    if (prev === void 0) changes.push(`${key} (added) ${next}`);
+    else if (prev !== next) changes.push(`${key} ${prev} \u2192 ${next}`);
+  }
+  for (const [key, prev] of a) {
+    if (!b.has(key)) changes.push(`${key} (removed, was ${prev})`);
+  }
+  return changes;
+}
 function resolveMetro(cfg, platform, portFlag) {
   const entry = cfg?.platforms?.[platform];
   return {
@@ -221,7 +249,7 @@ function buildKind(isDebug) {
   if (isDebug === false) return "release";
   return "unknown";
 }
-function checkDevBuild(app, buildId, platform) {
+function checkDevBuild(app, buildId, platform, opts = {}) {
   if (platform === "roku") {
     throw new Error(
       "a build id cannot be pinned on roku \u2014 `vibeview dev` packages and sideloads the channel itself"
@@ -238,7 +266,7 @@ function checkDevBuild(app, buildId, platform) {
       `build ${buildId} is not a build of app ${app.public_id} \u2014 see \`vibeview list-builds ${app.public_id}\``
     );
   }
-  if (build.is_debug !== true) {
+  if (!opts.standalone && build.is_debug !== true) {
     const why = build.is_debug === false ? "it runs standalone (a release build, or one with an embedded JS bundle)" : "it could not be identified as a Metro debug build";
     throw new Error(
       `build ${buildId} is not a debug build \u2014 ${why}. \`vibeview dev\` needs ${platformWithArticle(platform)} debug simulator/emulator build without an embedded JS bundle (see \`vibeview list-builds ${app.public_id}\`)`
@@ -249,17 +277,6 @@ function checkDevBuild(app, buildId, platform) {
 
 // src/commands/list-builds.ts
 import chalk from "chalk";
-
-// src/lib/formatters/time.ts
-function formatUtcTimestamp(iso) {
-  if (!iso) return "";
-  const hasZone = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(iso);
-  const d = new Date(hasZone ? iso : `${iso}Z`);
-  if (Number.isNaN(d.getTime())) return iso;
-  return `${d.toISOString().slice(0, 19).replace("T", " ")} UTC`;
-}
-
-// src/commands/list-builds.ts
 function buildRows(app) {
   return app.builds.map((b) => ({
     id: b.id,
@@ -392,81 +409,24 @@ import { createInterface } from "readline";
 import { select as select2 } from "@inquirer/prompts";
 import chalk3 from "chalk";
 
-// src/lib/artifact.ts
-import { existsSync as existsSync2, mkdtempSync, readdirSync, rmSync as rmSync2, statSync } from "fs";
-import { spawnSync } from "child_process";
-import { tmpdir } from "os";
-import { basename, dirname as dirname2, isAbsolute, join as join3 } from "path";
-function resolveArtifact(cwd, pattern) {
-  const abs = isAbsolute(pattern) ? pattern : join3(cwd, pattern);
-  if (!basename(abs).includes("*")) {
-    if (!existsSync2(abs)) {
-      throw new Error(
-        `artifact not found: ${pattern} (looked at ${abs}) \u2014 did the build produce it?`
-      );
-    }
-    return abs;
-  }
-  const dir = dirname2(abs);
-  const re = new RegExp("^" + basename(abs).split("*").map(escapeRegExp).join(".*") + "$");
-  let entries;
-  try {
-    entries = readdirSync(dir);
-  } catch {
-    throw new Error(`artifact not found: ${pattern} (directory ${dir} does not exist)`);
-  }
-  const matches = entries.filter((e) => re.test(e)).map((e) => join3(dir, e)).sort((a, b) => statSync(b).mtimeMs - statSync(a).mtimeMs);
-  if (matches.length === 0) {
-    throw new Error(`artifact not found: no match for ${pattern} in ${dir}`);
-  }
-  return matches[0];
-}
-function escapeRegExp(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function prepareUploadArtifact(path) {
-  if (!(statSync(path).isDirectory() && path.endsWith(".app"))) {
-    return { uploadPath: path, cleanup: () => {
-    } };
-  }
-  const tmp = mkdtempSync(join3(tmpdir(), "vibeview-zip-"));
-  const out = join3(tmp, `${basename(path)}.zip`);
-  const res = spawnSync("zip", ["-qry", out, basename(path)], { cwd: dirname2(path) });
-  if (res.error) {
-    rmSync2(tmp, { recursive: true, force: true });
-    const errorCode = res.error.code;
-    const errorMsg = res.error.message;
-    throw new Error(
-      `failed to zip ${path}: spawn zip ${errorCode} \u2014 ${errorMsg} \u2014 is the \`zip\` command installed?`
-    );
-  }
-  if (res.status !== 0) {
-    rmSync2(tmp, { recursive: true, force: true });
-    throw new Error(
-      `failed to zip ${path}: ${res.stderr?.toString().trim() || `zip exited ${res.status}`}`
-    );
-  }
-  return { uploadPath: out, cleanup: () => rmSync2(tmp, { recursive: true, force: true }) };
-}
-
 // src/lib/dev-setup.ts
 import chalk2 from "chalk";
 import { input, select } from "@inquirer/prompts";
 
 // src/lib/project-detect.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync3, readdirSync, statSync } from "fs";
+import { join as join3 } from "path";
 import ignore from "ignore";
 function readJson(cwd, name) {
   try {
-    return JSON.parse(readFileSync3(join4(cwd, name), "utf-8"));
+    return JSON.parse(readFileSync3(join3(cwd, name), "utf-8"));
   } catch {
     return null;
   }
 }
 function isFile(path) {
   try {
-    return statSync2(path).isFile();
+    return statSync(path).isFile();
   } catch {
     return false;
   }
@@ -474,19 +434,19 @@ function isFile(path) {
 function detectFlavor(cwd) {
   let deps = {};
   try {
-    const pkg = JSON.parse(readFileSync3(join4(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync3(join3(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
   }
   if ("expo" in deps) return "expo";
-  if (existsSync3(join4(cwd, "android", "gradlew")) || iosWorkspaceName(cwd)) return "bare-rn";
-  if (isFile(join4(cwd, "manifest"))) return "roku";
+  if (existsSync2(join3(cwd, "android", "gradlew")) || iosWorkspaceName(cwd)) return "bare-rn";
+  if (isFile(join3(cwd, "manifest"))) return "roku";
   return "unknown";
 }
 function nativeDirShipped(cwd, dir) {
-  if (!existsSync3(join4(cwd, dir))) return false;
+  if (!existsSync2(join3(cwd, dir))) return false;
   try {
-    const ig = ignore().add(readFileSync3(join4(cwd, ".gitignore"), "utf-8"));
+    const ig = ignore().add(readFileSync3(join3(cwd, ".gitignore"), "utf-8"));
     return !ig.ignores(`${dir}/`);
   } catch {
     return true;
@@ -502,7 +462,7 @@ function isManagedExpo(cwd, platform) {
 }
 function iosWorkspaceName(cwd) {
   try {
-    const found = readdirSync2(join4(cwd, "ios")).find((f) => f.endsWith(".xcworkspace"));
+    const found = readdirSync(join3(cwd, "ios")).find((f) => f.endsWith(".xcworkspace"));
     return found ? found.replace(/\.xcworkspace$/, "") : null;
   } catch {
     return null;
@@ -511,9 +471,9 @@ function iosWorkspaceName(cwd) {
 var IOS_ARTIFACT = "ios/build/Build/Products/Debug-iphonesimulator/*.app";
 var ANDROID_ARTIFACT = "android/app/build/outputs/apk/debug/*.apk";
 function installCommand(cwd) {
-  if (existsSync3(join4(cwd, "yarn.lock"))) return "yarn install --immutable";
-  if (existsSync3(join4(cwd, "pnpm-lock.yaml"))) return "pnpm install --frozen-lockfile";
-  if (existsSync3(join4(cwd, "package-lock.json"))) return "npm ci";
+  if (existsSync2(join3(cwd, "yarn.lock"))) return "yarn install --immutable";
+  if (existsSync2(join3(cwd, "pnpm-lock.yaml"))) return "pnpm install --frozen-lockfile";
+  if (existsSync2(join3(cwd, "package-lock.json"))) return "npm ci";
   return "yarn install --immutable";
 }
 function managedExpoAndroidCommand(cwd) {
@@ -527,7 +487,7 @@ var ROKU_ZIP_COMMAND = "zip -r out/channel.zip manifest source components images
 function rokuDefaults(cwd) {
   const pkg = readJson(cwd, "package.json");
   const scripts = pkg?.scripts ?? {};
-  const runner = existsSync3(join4(cwd, "yarn.lock")) ? "yarn" : "npm run";
+  const runner = existsSync2(join3(cwd, "yarn.lock")) ? "yarn" : "npm run";
   const packageScript = Object.entries(scripts).find(
     ([name, body]) => !name.startsWith("deploy") && (name.startsWith("package") || body.includes("--package-only") || body.includes("zipPackage"))
   );
@@ -585,7 +545,7 @@ function expoSanitizedName(name) {
   return name.replace(/[\W_]+/g, "").normalize("NFD").replace(/[\u0300-\u036f]/g, "");
 }
 function managedExpoIosName(cwd) {
-  if (existsSync3(join4(cwd, "app.config.js")) || existsSync3(join4(cwd, "app.config.ts"))) {
+  if (existsSync2(join3(cwd, "app.config.js")) || existsSync2(join3(cwd, "app.config.ts"))) {
     return null;
   }
   const raw = readJson(cwd, "app.config.json") ?? readJson(cwd, "app.json");
@@ -730,9 +690,9 @@ async function promptMetroCommand(cwd, platform) {
 
 // src/lib/source-pack.ts
 import { execFile, spawn } from "child_process";
-import { lstatSync, mkdtempSync as mkdtempSync2, readFileSync as readFileSync4, rmSync as rmSync3, statSync as statSync3, writeFileSync as writeFileSync3 } from "fs";
-import { tmpdir as tmpdir2 } from "os";
-import { join as join5 } from "path";
+import { lstatSync, mkdtempSync, readFileSync as readFileSync4, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { tmpdir } from "os";
+import { join as join4 } from "path";
 import ignore2 from "ignore";
 var NotAGitRepoError = class extends Error {
   constructor(message) {
@@ -758,7 +718,7 @@ async function listSourceFiles(projectRoot) {
   const stdout = await runGitLsFiles(projectRoot);
   const rawPaths = stdout.length ? stdout.split("\0").filter((p) => p.length > 0) : [];
   let filtered = rawPaths;
-  const vvignorePath = join5(projectRoot, ".vvignore");
+  const vvignorePath = join4(projectRoot, ".vvignore");
   if (statOrNull(vvignorePath)?.isFile()) {
     const ig = ignore2().add(readFileSync4(vvignorePath, "utf-8"));
     filtered = filtered.filter((p) => !ig.ignores(p));
@@ -766,7 +726,7 @@ async function listSourceFiles(projectRoot) {
   const result = [];
   for (const relPath of filtered) {
     if (isForceExcluded(relPath)) continue;
-    const st = statOrNull(join5(projectRoot, relPath));
+    const st = statOrNull(join4(projectRoot, relPath));
     if (!st) continue;
     result.push(relPath);
   }
@@ -816,7 +776,7 @@ async function packSource(projectRoot, files, opts = {}) {
   let totalBytes = 0;
   const sized = [];
   for (const relPath of files) {
-    const bytes = lstatSync(join5(projectRoot, relPath)).size;
+    const bytes = lstatSync(join4(projectRoot, relPath)).size;
     totalBytes += bytes;
     sized.push({ path: relPath, bytes });
   }
@@ -827,13 +787,13 @@ async function packSource(projectRoot, files, opts = {}) {
       largest
     );
   }
-  const tmpDir = mkdtempSync2(join5(tmpdir2(), "vibeview-source-pack-"));
-  const cleanup = () => rmSync3(tmpDir, { recursive: true, force: true });
+  const tmpDir = mkdtempSync(join4(tmpdir(), "vibeview-source-pack-"));
+  const cleanup = () => rmSync2(tmpDir, { recursive: true, force: true });
   try {
     const supportsNull = await probeTarNullSupport();
-    const tarPath = join5(tmpDir, "source.tgz");
+    const tarPath = join4(tmpDir, "source.tgz");
     if (supportsNull) {
-      const listPath = join5(tmpDir, "files.list");
+      const listPath = join4(tmpDir, "files.list");
       writeFileSync3(listPath, files.map((f) => `${f}\0`).join(""));
       await runTar(["-czf", tarPath, "-C", projectRoot, "--null", "-T", listPath]);
     } else {
@@ -843,12 +803,12 @@ async function packSource(projectRoot, files, opts = {}) {
           `cannot pack source: filename contains a newline (${JSON.stringify(badName)}) and the installed tar doesn't support --null -T; rename the file or install a tar that supports --null`
         );
       }
-      const listPath = join5(tmpDir, "files.list");
+      const listPath = join4(tmpDir, "files.list");
       writeFileSync3(listPath, files.map((f) => `${f}
 `).join(""));
       await runTar(["-czf", tarPath, "-C", projectRoot, "-T", listPath]);
     }
-    const sizeBytes = statSync3(tarPath).size;
+    const sizeBytes = statSync2(tarPath).size;
     return { tarPath, sizeBytes, cleanup };
   } catch (err) {
     cleanup();
@@ -864,12 +824,12 @@ var nullSupportCache = null;
 function probeTarNullSupport() {
   if (!nullSupportCache) {
     nullSupportCache = new Promise((resolve) => {
-      const tmp = mkdtempSync2(join5(tmpdir2(), "vibeview-tar-probe-"));
-      const listPath = join5(tmp, "empty.list");
+      const tmp = mkdtempSync(join4(tmpdir(), "vibeview-tar-probe-"));
+      const listPath = join4(tmp, "empty.list");
       writeFileSync3(listPath, "");
-      const out = join5(tmp, "probe.tgz");
+      const out = join4(tmp, "probe.tgz");
       execFile("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
-        rmSync3(tmp, { recursive: true, force: true });
+        rmSync2(tmp, { recursive: true, force: true });
         resolve(!err);
       });
     });
@@ -1552,7 +1512,9 @@ async function waitForCloudBuilds(builds, opts, deps) {
         id: final.id,
         status: final.status,
         cost_micro: final.cost_micro,
-        error_summary: final.error_summary
+        error_summary: final.error_summary,
+        app_build_id: final.app_build_id ?? null,
+        app_public_id: final.app_public_id ?? null
       });
       finalized.add(build.id);
     }
@@ -1740,7 +1702,7 @@ your build command must produce a zip \u2014 use the package/zip step, not deplo
 // src/commands/dev.ts
 import { spawn as spawn4 } from "child_process";
 import { createWriteStream, mkdirSync as mkdirSync3 } from "fs";
-import { dirname as dirname5 } from "path";
+import { dirname as dirname4 } from "path";
 import { createInterface as createInterface3 } from "readline";
 import { select as select3 } from "@inquirer/prompts";
 import chalk4 from "chalk";
@@ -1935,15 +1897,15 @@ import { spawn as spawn3 } from "child_process";
 import { createInterface as createInterface2 } from "readline";
 
 // src/lib/metro-state.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync5, rmSync as rmSync4, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname3, join as join6 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname2, join as join5 } from "path";
 var STATE_DIR2 = ".vibeview";
 var STATE_FILE2 = "metro-state.json";
 function statePath2(cwd) {
-  return join6(cwd, STATE_DIR2, STATE_FILE2);
+  return join5(cwd, STATE_DIR2, STATE_FILE2);
 }
 function metroLogPath(cwd) {
-  return join6(cwd, STATE_DIR2, "metro.log");
+  return join5(cwd, STATE_DIR2, "metro.log");
 }
 function isPidAlive2(pid) {
   try {
@@ -1955,7 +1917,7 @@ function isPidAlive2(pid) {
 }
 function writeMetroState(cwd, state) {
   const path = statePath2(cwd);
-  mkdirSync2(dirname3(path), { recursive: true });
+  mkdirSync2(dirname2(path), { recursive: true });
   writeFileSync4(path, JSON.stringify(state, null, 2) + "\n");
 }
 function readMetroState(cwd) {
@@ -1973,7 +1935,7 @@ function readMetroState(cwd) {
 }
 function clearMetroState(cwd) {
   const path = statePath2(cwd);
-  if (existsSync4(path)) rmSync4(path, { force: true });
+  if (existsSync3(path)) rmSync3(path, { force: true });
 }
 function killOwnedMetro(cwd) {
   const state = readMetroState(cwd);
@@ -2081,7 +2043,7 @@ async function waitFor(cond, timeoutMs, everyMs) {
 
 // src/lib/reload-loop.ts
 import { watch } from "fs";
-import { basename as basename2, dirname as dirname4 } from "path";
+import { basename, dirname as dirname3 } from "path";
 function createReloadLoop(deps) {
   let inFlight = null;
   let pendingFollowUp = false;
@@ -2162,16 +2124,16 @@ function isIgnoredWatchPath(relPath, artifact, userIgnore = []) {
   if (IGNORED_FILES.includes(rel)) return true;
   if (userIgnore.some((entry) => isUnderPath(rel, entry))) return true;
   const artifactPattern = artifact.replace(/\\/g, "/").replace(/^\.\//, "");
-  const artifactDir = dirname4(artifactPattern);
+  const artifactDir = dirname3(artifactPattern);
   if (artifactDir !== "." && (rel === artifactDir || rel.startsWith(`${artifactDir}/`))) {
     return true;
   }
-  if (dirname4(rel) !== artifactDir) return false;
-  const name = basename2(artifactPattern);
-  const re = new RegExp(`^${name.split("*").map(escapeRegExp2).join(".*")}$`);
-  return re.test(basename2(rel));
+  if (dirname3(rel) !== artifactDir) return false;
+  const name = basename(artifactPattern);
+  const re = new RegExp(`^${name.split("*").map(escapeRegExp).join(".*")}$`);
+  return re.test(basename(rel));
 }
-function escapeRegExp2(s) {
+function escapeRegExp(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function watchProjectFiles(cwd, artifact, userIgnore = []) {
@@ -2196,13 +2158,18 @@ function parseWatchSeconds(flag) {
   }
   return seconds;
 }
+function queuedLine(position, reasonMessage) {
+  const where = position ? ` (position ${position})` : "";
+  const why = reasonMessage ?? "Every device is busy.";
+  return `\u23F3 ${why} Waiting in the queue${where}, Ctrl-C to give up.`;
+}
 function emit(json, evt) {
   if (json) console.log(JSON.stringify(evt));
 }
 async function startDevSession(cfg, onEvent = () => {
 }, onTunnelState) {
   const api = new ApiClient(cfg.baseUrl, cfg.token);
-  const usesTunnel = PLATFORM_NEEDS_METRO[cfg.platform];
+  const usesTunnel = PLATFORM_NEEDS_METRO[cfg.platform] && !cfg.standalone;
   const pool = cfg.model ? resolveDeviceModel(await api.listDeviceModels(), cfg.platform, cfg.model) : null;
   const created = await api.createSession(
     devSessionCreateBody(pool ? { ...cfg, deviceCategory: pool.category, model: pool.model } : cfg)
@@ -2232,7 +2199,9 @@ async function startDevSession(cfg, onEvent = () => {
         event: "queued",
         session_id: sessionId,
         position: started.position ?? null,
-        queue_entry_id: queueEntryId
+        queue_entry_id: queueEntryId,
+        queue_reason: started.queue_reason ?? null,
+        message: queueReasonCopy(started.queue_reason)
       });
       await pollWhileQueued(api, sessionId, QUEUE_WAIT_MS);
       queueEntryId = null;
@@ -2288,7 +2257,7 @@ async function startDevSession(cfg, onEvent = () => {
       reportedWarnings.add(w);
       onEvent({ event: "warning", message: w });
     }
-    return { sessionId, pageUrl, stop: () => stopSession(0), reportedWarnings };
+    return { sessionId, pageUrl, stop: () => stopSession(0), reportedWarnings, session: active };
   } catch (err) {
     await stopSession(1);
     throw err;
@@ -2299,8 +2268,9 @@ function devSessionCreateBody(cfg) {
     device_type: PLATFORM_DEVICE[cfg.platform].deviceType,
     device_category: cfg.deviceCategory,
     app_id: cfg.appId,
-    // Roku has no JS bundle to serve, so there is nothing to tunnel.
-    tunnel: PLATFORM_NEEDS_METRO[cfg.platform],
+    // Roku has no JS bundle to serve, so there is nothing to tunnel; a
+    // standalone session runs the build as it is, without Metro.
+    tunnel: PLATFORM_NEEDS_METRO[cfg.platform] && !cfg.standalone,
     ...cfg.model ? { model: cfg.model } : {},
     ...cfg.buildId ? { build_id: cfg.buildId } : {}
   };
@@ -2314,15 +2284,45 @@ function resolveDeviceModel(pools, platform, model) {
   const match = candidates.find((p) => p.model === wanted) ?? candidates.find((p) => p.model.toLowerCase() === wanted.toLowerCase());
   if (match) return match;
   const names = [...new Set(candidates.map((p) => p.model))].sort();
+  const guess = closestModelName(wanted, names);
   throw new Error(
-    names.length ? `no ${platform} device model named "${model}" \u2014 available: ${names.join(", ")} (see \`vibeview list-devices --models\`)` : `no ${platform} devices are available right now`
+    names.length ? `no ${platform} device model named "${model}"` + (guess ? ` (did you mean "${guess}"?)` : "") + ` \u2014 available: ${names.join(", ")} (see \`vibeview list-devices --models\`)` : `no ${platform} devices are available right now`
   );
 }
+function closestModelName(wanted, names) {
+  const squash = (s) => s.toLowerCase().replace(/[^a-z0-9]/g, "");
+  const words = (s) => new Set(s.toLowerCase().match(/[a-z0-9]+/g) ?? []);
+  const w = squash(wanted);
+  if (!w) return null;
+  const unique = (list) => list.length === 1 ? list[0] : null;
+  const same = names.filter((n) => squash(n) === w);
+  if (same.length) return unique(same);
+  const containing = names.filter((n) => squash(n).includes(w) || w.includes(squash(n)));
+  if (containing.length) return unique(containing);
+  const wantedWords = words(wanted);
+  let best = 0;
+  let bestNames = [];
+  for (const n of names) {
+    let shared = 0;
+    for (const word of words(n)) if (wantedWords.has(word)) shared++;
+    if (shared > best) {
+      best = shared;
+      bestNames = [n];
+    } else if (shared === best && shared > 0) {
+      bestNames.push(n);
+    }
+  }
+  return best >= 2 ? unique(bestNames) : null;
+}
 var BLOCKING_WARNING_PREFIXES = ["No debug build", "App install failed", "App not found"];
 function findBlockingWarning(info) {
   return (info.warnings ?? []).find((w) => BLOCKING_WARNING_PREFIXES.some((p) => w.includes(p)));
 }
 var QUEUE_WAIT_MS = 30 * 6e4;
+function sessionEndedMessage(info, when) {
+  const reason = info.status === "failed" && info.failure_reason ? `: ${info.failure_reason}` : "";
+  return `session ${info.status} ${when}${reason}`;
+}
 async function pollWhileQueued(api, sessionId, timeoutMs, intervalMs = 3e3) {
   const deadline = Date.now() + timeoutMs;
   for (; ; ) {
@@ -2330,7 +2330,7 @@ async function pollWhileQueued(api, sessionId, timeoutMs, intervalMs = 3e3) {
     const blocking = findBlockingWarning(info);
     if (blocking) throw new Error(blocking);
     if (info.status === "stopped" || info.status === "failed") {
-      throw new Error(`session ${info.status} while waiting for a device`);
+      throw new Error(sessionEndedMessage(info, "while waiting for a device"));
     }
     if (info.status !== "pending" && info.status !== "queued") return info;
     if (Date.now() > deadline) {
@@ -2349,7 +2349,7 @@ async function pollUntilTunnelReady(api, sessionId, timeoutMs, intervalMs = 2e3)
     if (blocking) throw new Error(blocking);
     if (info.tunnel_url) return info;
     if (info.status === "stopped" || info.status === "failed") {
-      throw new Error(`session ${info.status} before the tunnel came up`);
+      throw new Error(sessionEndedMessage(info, "before the tunnel came up"));
     }
     if (Date.now() > deadline) throw new Error("timed out waiting for the device to start");
     await new Promise((r) => setTimeout(r, intervalMs));
@@ -2368,7 +2368,7 @@ async function pollUntilActive(api, sessionId, timeoutMs, intervalMs = 2e3, onIn
     }
     if (info.status === "active" && !info.app_install_pending) return info;
     if (info.status === "stopped" || info.status === "failed") {
-      throw new Error(`session ${info.status} before it became active`);
+      throw new Error(sessionEndedMessage(info, "before it became active"));
     }
     if (Date.now() > deadline) {
       throw new Error("timed out waiting for the session to become active");
@@ -2418,6 +2418,19 @@ function validateAppChoice(requested, fromFlag, apps) {
   if (apps.some((a) => a.public_id === requested)) return { appId: requested };
   return fromFlag ? { staleFlag: requested } : { staleCached: requested };
 }
+function staleAppFlagError(requested, platform, allApps) {
+  const other = allApps.find((a) => a.public_id === requested);
+  if (other) {
+    return {
+      message: `app "${requested}" is ${platformWithArticle(other.platform)} app, not ${platformWithArticle(platform)} app.`,
+      hint: `Run \`vibeview dev --platform ${other.platform} --app ${requested}\`, or \`vibeview dev --platform ${platform}\` without --app to pick ${platformWithArticle(platform)} app.`
+    };
+  }
+  return {
+    message: `app "${requested}" not found \u2014 it may have been deleted.`,
+    hint: "Run `vibeview dev` without --app to pick from the list."
+  };
+}
 function buildAppStrategy(apps, buildFlag, json, isTTY) {
   if (buildFlag) return "build";
   if (apps.length === 0) return "build";
@@ -2495,11 +2508,9 @@ async function ensureConfig(api, opts) {
   const apps = appsForPlatform(allApps, platform);
   const choice = validateAppChoice(opts.app || entry?.appId, Boolean(opts.app), apps);
   if (choice.staleFlag) {
-    const message = `app "${choice.staleFlag}" not found \u2014 it may have been deleted.`;
-    console.error(
-      chalk4.red(`error: ${message}`) + `
-Run \`vibeview dev\` without --app to pick from the list.`
-    );
+    const { message, hint } = staleAppFlagError(choice.staleFlag, platform, allApps);
+    console.error(chalk4.red(`error: ${message}`) + `
+${hint}`);
     emit(opts.json, { event: "error", message });
     process.exit(2);
   }
@@ -2594,6 +2605,12 @@ Run \`vibeview dev\` without --app to pick from the list.`
   });
   const commitConfig = () => {
     saveDevConfig(process.cwd(), cfg);
+    if (existing) {
+      const changes = describeConfigChanges(existing, cfg);
+      if (changes.length) {
+        console.error(chalk4.dim(`Updated vibeview.json: ${changes.join(", ")}`));
+      }
+    }
     if (isFirstRun) {
       console.error(chalk4.dim(`Created vibeview.json (platform: ${platform}, app: ${appId}).`));
       const hint = fillLaterHint(
@@ -2713,7 +2730,7 @@ async function runDevInProcess(opts) {
       const captureMetroLine = (line) => {
         try {
           if (!metroLogStream) {
-            mkdirSync3(dirname5(metroLogPath(process.cwd())), { recursive: true });
+            mkdirSync3(dirname4(metroLogPath(process.cwd())), { recursive: true });
             metroLogStream = createWriteStream(metroLogPath(process.cwd()), { flags: "w" });
           }
           metroLogStream.write(line.replace(/^\[metro\] /, "") + "\n");
@@ -2806,12 +2823,7 @@ async function runDevInProcess(opts) {
             console.error(chalk4.yellow(`\u26A0 ${evt.message}`));
           }
         } else if (evt.event === "queued") {
-          const where = evt.position ? ` (position ${evt.position})` : "";
-          console.error(
-            chalk4.yellow(
-              `\u23F3 every device is busy \u2014 waiting in the queue${where}, Ctrl-C to give up`
-            )
-          );
+          console.error(chalk4.yellow(queuedLine(evt.position, evt.message)));
         } else if (evt.event === "tunnel_connected") {
           everConnected = true;
           console.error(chalk4.green("\u2713 tunnel connected \u2014 edit away, Fast Refresh is live"));
@@ -3056,7 +3068,7 @@ function formatDevicesHuman(devices) {
   const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
   const lines = [chalk5.bold(fmt(HEADERS2))];
   for (const row of rows.sort(rowSort)) {
-    const statusColored = row[5] === "available" ? chalk5.green(row[5]) : row[5] === "busy" ? chalk5.yellow(row[5]) : chalk5.dim(row[5]);
+    const statusColored = row[5] === "available" ? chalk5.green(row[5]) : row[5] === "busy" || row[5] === "updating" ? chalk5.yellow(row[5]) : chalk5.dim(row[5]);
     lines.push(fmt([row[0], row[1], row[2], row[3], row[4], statusColored]));
   }
   return lines.join("\n") + "\n";
@@ -3070,42 +3082,96 @@ function filterDeviceModels(models, opts) {
     os_version: m.os_version,
     device_type: m.device_type,
     category: m.category,
-    form_factor: m.form_factor ?? null
+    form_factor: m.form_factor ?? null,
+    // MCP only: an agent has no other way to see whether a model is free.
+    ...opts.availability && typeof m.free === "number" && typeof m.total === "number" ? { free: m.free, total: m.total } : {}
   }));
 }
 var MODEL_HEADERS = ["MODEL", "OS", "TYPE", "CATEGORY", "FORM FACTOR"];
-function formatDeviceModelsHuman(models) {
+function formatDeviceModelsHuman(models, opts = {}) {
   if (models.length === 0) {
     return "No device models available right now.\n";
   }
-  const rows = models.map((m) => [m.model, m.os_version, m.device_type, m.category, m.form_factor ?? "-"]).sort(
+  const headers = [...MODEL_HEADERS, ...opts.availability ? ["FREE", "BUSY"] : []];
+  const rows = models.map((m) => [
+    m.model,
+    m.os_version,
+    m.device_type,
+    m.category,
+    m.form_factor ?? "-",
+    ...opts.availability ? availabilityCells(m) : []
+  ]).sort(
     (a, b) => a[2].localeCompare(b[2]) || a[3].localeCompare(b[3]) || a[0].localeCompare(b[0]) || a[1].localeCompare(b[1])
   );
-  const widths = MODEL_HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
-  return [chalk5.bold(fmt(MODEL_HEADERS)), ...rows.map(fmt)].join("\n") + "\n";
+  return [chalk5.bold(fmt(headers)), ...rows.map(fmt)].join("\n") + "\n";
+}
+function availabilityCells(m) {
+  if (typeof m.free !== "number" || typeof m.total !== "number") return ["?", "?"];
+  return [String(m.free), String(Math.max(0, m.total - m.free))];
 }
 
 // src/agent/registry.ts
-var PRESS_BUTTONS_BY_PLATFORM = [
-  ["iPhone / iPad", ["home", "back", "lock", "siri"]],
-  ["Android phone / tablet", ["home", "back", "lock"]],
-  [
-    "Apple TV / Android TV",
-    ["dpad_up", "dpad_down", "dpad_left", "dpad_right", "dpad_center", "back", "home"]
+var PRESS_BUTTONS = {
+  ios: ["home", "back", "lock", "siri", "enter"],
+  android: ["home", "back", "lock", "enter"],
+  appleTv: [
+    "dpad_up",
+    "dpad_down",
+    "dpad_left",
+    "dpad_right",
+    "dpad_center",
+    "back",
+    "home",
+    "menu"
+  ],
+  androidTv: [
+    "dpad_up",
+    "dpad_down",
+    "dpad_left",
+    "dpad_right",
+    "dpad_center",
+    "back",
+    "home",
+    "enter"
   ],
-  [
-    "Roku (beta)",
-    ["up", "down", "left", "right", "select", "back", "(dpad_* also work; home is not forwarded)"]
+  roku: [
+    "dpad_up",
+    "dpad_down",
+    "dpad_left",
+    "dpad_right",
+    "dpad_center",
+    "back",
+    "enter",
+    "up",
+    "down",
+    "left",
+    "right",
+    "select",
+    "backspace",
+    "play",
+    "rewind",
+    "forward",
+    "replay",
+    "info"
   ]
+};
+var PRESS_PLATFORM_LABELS = [
+  ["ios", "iPhone / iPad"],
+  ["android", "Android phone / tablet"],
+  ["appleTv", "Apple TV"],
+  ["androidTv", "Android TV"],
+  ["roku", "Roku (beta)"]
 ];
+var PRESS_BUTTONS_BY_PLATFORM = PRESS_PLATFORM_LABELS.map(([key, label]) => [label, PRESS_BUTTONS[key]]);
+function pressButtonLines(indent) {
+  return PRESS_BUTTONS_BY_PLATFORM.map(
+    ([platform, buttons]) => `${indent}${platform}: ${buttons.join(", ")}`
+  );
+}
 function pressButtonsHelp() {
-  return [
-    "Valid buttons:",
-    ...PRESS_BUTTONS_BY_PLATFORM.map(
-      ([platform, buttons]) => `  ${platform}: ${buttons.join(", ")}`
-    )
-  ].join("\n");
+  return ["Valid buttons:", ...pressButtonLines("  ")].join("\n");
 }
 var AGENT_COMMANDS = [
   {
@@ -3401,7 +3467,7 @@ var AGENT_COMMANDS = [
         cli: "positional",
         type: "string",
         required: true,
-        description: "Button to press. iPhone/iPad: home, back, lock, siri. Android: home, back, lock. Apple TV / Android TV: dpad_up, dpad_down, dpad_left, dpad_right, dpad_center, back, home. Roku: up, down, left, right, select, back (dpad_* also work; home is not forwarded)."
+        description: `Button to press. ${pressButtonLines("").join(". ")}.`
       }
     ]
   },
@@ -3883,7 +3949,6 @@ export {
   loadDevConfig,
   parseBuildId,
   checkDevBuild,
-  formatUtcTimestamp,
   buildRows,
   formatBuildRowsHuman,
   listBuilds,