vibeview 0.28.0 → 0.29.0

package/dist/{chunk-2JLTC67A.js → chunk-PBMB6TG4.js}

@@ -191,9 +191,10 @@ var ApiClient = class {
       model: options?.model,
       provider: options?.provider,
       mode: options?.mode,
-      // When pinning a specific device, omit device_category — the backend
-      // rejects the combo.
-      device_category: options?.device ? void 0 : options?.deviceCategory ?? "phone",
+      // Omitted unless asked for: the backend picks tv for a TV suite and
+      // phone otherwise. Never sent with a pinned device (the backend
+      // rejects the combo).
+      device_category: options?.device ? void 0 : options?.deviceCategory,
       device_id: options?.device,
       build_id: options?.build,
       metadata: options?.metadata
@@ -206,7 +207,7 @@ var ApiClient = class {
       model: options?.model,
       provider: options?.provider,
       mode: options?.mode,
-      device_category: options?.device ? void 0 : options?.deviceCategory ?? "phone",
+      device_category: options?.device ? void 0 : options?.deviceCategory,
       device_id: options?.device,
       build_id: options?.build,
       metadata: options?.metadata

package/dist/{chunk-OKOAWGWV.js → chunk-T6EQQV6E.js}

@@ -13,10 +13,10 @@ import {
   resolveArtifact,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-2JLTC67A.js";
+} from "./chunk-PBMB6TG4.js";
 
 // src/lib/dev-config.ts
-import { readFileSync, writeFileSync } from "fs";
+import { readFileSync, renameSync, rmSync, writeFileSync } from "fs";
 import { join } from "path";
 var DEV_PLATFORMS = ["ios", "android", "tvos", "androidtv", "roku"];
 var ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -166,7 +166,58 @@ function validateBuildEnv(env, platformKey) {
   }
 }
 function saveDevConfig(cwd, cfg) {
-  writeFileSync(join(cwd, FILE), JSON.stringify(cfg, null, 2) + "\n");
+  const target = join(cwd, FILE);
+  const tmp = join(cwd, `.${FILE}.${process.pid}.${Date.now()}.tmp`);
+  try {
+    writeFileSync(tmp, JSON.stringify(cfg, null, 2) + "\n");
+    renameSync(tmp, target);
+  } catch (err) {
+    rmSync(tmp, { force: true });
+    throw err;
+  }
+}
+function updateDevConfig(cwd, platform, apply) {
+  const fresh = loadDevConfig(cwd) ?? { defaultPlatform: platform, platforms: {} };
+  if (apply(fresh) === false) return fresh;
+  saveDevConfig(cwd, fresh);
+  return fresh;
+}
+function configLeaves(value, path = [], out = []) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    for (const [k, v] of Object.entries(value)) {
+      configLeaves(v, [...path, k], out);
+    }
+  } else if (value !== void 0) {
+    out.push({ path, value });
+  }
+  return out;
+}
+function applyConfigChanges(target, before, after) {
+  const key = (path) => JSON.stringify(path);
+  const prev = new Map(configLeaves(before ?? {}).map((l) => [key(l.path), l.value]));
+  const root = target;
+  for (const { path, value } of configLeaves(after)) {
+    const old = prev.get(key(path));
+    prev.delete(key(path));
+    if (old !== void 0 && JSON.stringify(old) === JSON.stringify(value)) continue;
+    let node = root;
+    for (const segment of path.slice(0, -1)) {
+      const child = node[segment];
+      if (!child || typeof child !== "object" || Array.isArray(child)) node[segment] = {};
+      node = node[segment];
+    }
+    node[path[path.length - 1]] = value;
+  }
+  for (const k of prev.keys()) {
+    const path = JSON.parse(k);
+    let node = root;
+    for (const segment of path.slice(0, -1)) {
+      node = node && typeof node === "object" ? node[segment] : void 0;
+    }
+    if (node && typeof node === "object") {
+      delete node[path[path.length - 1]];
+    }
+  }
 }
 function describeConfigChanges(before, after) {
   const flat = (value, prefix, out) => {
@@ -220,6 +271,10 @@ function buildSavedConfig(input2) {
     platforms: {
       ...existing?.platforms,
       [platform]: {
+        // Everything else on the entry (`submit` defaults, keys a newer CLI
+        // wrote) is carried forward untouched; the fields below are the ones
+        // `vibeview dev` owns.
+        ...existing?.platforms?.[platform],
         appId,
         deviceCategory: isTv ? void 0 : deviceCategory,
         ...existing?.platforms?.[platform]?.build ? { build: { ...existing.platforms[platform].build } } : {},
@@ -235,6 +290,11 @@ function buildSavedConfig(input2) {
 }
 
 // src/lib/dev-build.ts
+function canUseMetro(build) {
+  if (build.can_use_metro === true || build.can_use_metro === false) return build.can_use_metro;
+  if (build.is_debug === true) return true;
+  return build.is_debug === false ? false : null;
+}
 function parseBuildId(raw) {
   const text = typeof raw === "number" ? String(raw) : typeof raw === "string" ? raw.trim() : "";
   if (!/^\d+$/.test(text) || Number(text) < 1) {
@@ -244,9 +304,10 @@ function parseBuildId(raw) {
   }
   return Number(text);
 }
-function buildKind(isDebug) {
-  if (isDebug === true) return "debug";
-  if (isDebug === false) return "release";
+function buildKind(build) {
+  const usable = build !== null && typeof build === "object" ? canUseMetro(build) : canUseMetro({ is_debug: build });
+  if (usable === true) return "debug";
+  if (usable === false) return "release";
   return "unknown";
 }
 function checkDevBuild(app, buildId, platform, opts = {}) {
@@ -266,10 +327,11 @@ function checkDevBuild(app, buildId, platform, opts = {}) {
       `build ${buildId} is not a build of app ${app.public_id} \u2014 see \`vibeview list-builds ${app.public_id}\``
     );
   }
-  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";
+  const usable = canUseMetro(build);
+  if (!opts.standalone && usable !== true) {
+    const why = usable === false ? "it is a release build (or not a React Native build), so it cannot load JavaScript from Metro" : "it could not be identified as a React Native 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}\`)`
+      `build ${buildId} is not a debug build \u2014 ${why}. \`vibeview dev\` needs ${platformWithArticle(platform)} React Native debug simulator/emulator build (see \`vibeview list-builds ${app.public_id}\`); to run this build as it is, with no Metro, use \`vibeview dev --standalone --build ${buildId}\``
     );
   }
   return build;
@@ -283,8 +345,9 @@ function buildRows(app) {
     version: b.version ?? null,
     build_number: b.build_number ?? null,
     platform: app.platform,
-    kind: buildKind(b.is_debug),
+    kind: buildKind(b),
     is_debug: b.is_debug ?? null,
+    can_use_metro: canUseMetro(b),
     uploaded_at: b.uploaded_at ?? null,
     note: b.note ?? null
   }));
@@ -329,7 +392,7 @@ async function listBuilds(appId, opts, deps) {
 }
 
 // src/lib/dev-state.ts
-import { existsSync, mkdirSync, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync, mkdirSync, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
 import { dirname, join as join2 } from "path";
 var STATE_DIR = ".vibeview";
 var STATE_FILE = "dev-state.json";
@@ -344,18 +407,31 @@ function isPidAlive(pid) {
     return err.code === "EPERM";
   }
 }
+var WHOLE_DIR_LINE = /^(\/?)\.vibeview\/?$/;
 function ensureGitignored(cwd) {
   try {
     const gitignore = join2(cwd, ".gitignore");
     if (!existsSync(gitignore)) return;
     const content = readFileSync2(gitignore, "utf-8");
-    const covered = content.split("\n").map((l) => l.trim()).some((l) => l === ".vibeview" || l === ".vibeview/" || l === "/.vibeview");
-    if (covered) return;
+    const lines = content.split("\n");
+    const trimmed = lines.map((l) => l.trim());
+    if (trimmed.some((l) => /^\/?\.vibeview\/\*$/.test(l))) return;
+    const i = trimmed.findIndex((l) => WHOLE_DIR_LINE.test(l));
+    if (i !== -1) {
+      const anchor = WHOLE_DIR_LINE.exec(trimmed[i])[1];
+      lines.splice(i, 1, `${anchor}.vibeview/*`, `!${anchor}.vibeview/test-spec.json`);
+      writeFileSync2(gitignore, lines.join("\n"));
+      return;
+    }
     const prefix = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
-    writeFileSync2(gitignore, `${content}${prefix}
-# VibeView local session state
-.vibeview/
-`);
+    writeFileSync2(
+      gitignore,
+      `${content}${prefix}
+# VibeView local session state (test-spec.json is committed for CI)
+.vibeview/*
+!.vibeview/test-spec.json
+`
+    );
   } catch {
   }
 }
@@ -386,7 +462,7 @@ function readDevState(cwd) {
 function clearDevState(cwd) {
   const path = statePath(cwd);
   if (existsSync(path)) {
-    rmSync(path, { force: true });
+    rmSync2(path, { force: true });
   }
 }
 
@@ -690,7 +766,7 @@ async function promptMetroCommand(cwd, platform) {
 
 // src/lib/source-pack.ts
 import { execFile, spawn } from "child_process";
-import { lstatSync, mkdtempSync, readFileSync as readFileSync4, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { lstatSync, mkdtempSync, readFileSync as readFileSync4, rmSync as rmSync3, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
 import { tmpdir } from "os";
 import { join as join4 } from "path";
 import ignore2 from "ignore";
@@ -788,7 +864,7 @@ async function packSource(projectRoot, files, opts = {}) {
     );
   }
   const tmpDir = mkdtempSync(join4(tmpdir(), "vibeview-source-pack-"));
-  const cleanup = () => rmSync2(tmpDir, { recursive: true, force: true });
+  const cleanup = () => rmSync3(tmpDir, { recursive: true, force: true });
   try {
     const supportsNull = await probeTarNullSupport();
     const tarPath = join4(tmpDir, "source.tgz");
@@ -829,7 +905,7 @@ function probeTarNullSupport() {
       writeFileSync3(listPath, "");
       const out = join4(tmp, "probe.tgz");
       execFile("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
-        rmSync2(tmp, { recursive: true, force: true });
+        rmSync3(tmp, { recursive: true, force: true });
         resolve(!err);
       });
     });
@@ -933,30 +1009,28 @@ async function resolveBarePlatform(cwd, cfg, opts) {
   }
   return platform;
 }
-function persistPromptedBuild(cwd, cfg, platform, build) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
-  const entry = next.platforms[platform];
-  if (entry) {
-    entry.build = build;
-  } else {
-    next.platforms[platform] = { build };
-  }
-  saveDevConfig(cwd, next);
-  return next;
+function persistPromptedBuild(cwd, platform, build) {
+  return updateDevConfig(cwd, platform, (next) => {
+    const entry = next.platforms[platform];
+    if (entry) {
+      entry.build = build;
+    } else {
+      next.platforms[platform] = { build };
+    }
+  });
 }
-function persistUploadedAppId(cwd, cfg, platform, build, appId) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
-  const entry = next.platforms[platform];
-  if (!entry) {
-    next.platforms[platform] = { appId, build };
-    saveDevConfig(cwd, next);
-    return;
-  }
-  if (entry.appId !== appId || !entry.build) {
+function persistUploadedAppId(cwd, platform, build, appId) {
+  updateDevConfig(cwd, platform, (next) => {
+    const entry = next.platforms[platform];
+    if (!entry) {
+      next.platforms[platform] = { appId, build };
+      return true;
+    }
+    if (entry.appId === appId && entry.build) return false;
     entry.appId = appId;
-    entry.build = build;
-    saveDevConfig(cwd, next);
-  }
+    if (!entry.build) entry.build = build;
+    return true;
+  });
 }
 async function resolveBuildConfig(cwd, cfgRef, platform, opts) {
   const existing = cfgRef.current?.platforms?.[platform]?.build;
@@ -972,11 +1046,15 @@ async function resolveBuildConfig(cwd, cfgRef, platform, opts) {
   if (!answered) {
     fail(opts, "build config is required to run vibeview build", "config_required");
   }
-  cfgRef.current = persistPromptedBuild(cwd, cfgRef.current, platform, answered);
+  cfgRef.current = persistPromptedBuild(cwd, platform, answered);
   return answered;
 }
-function persistPromptedProductionBuild(cwd, cfg, platform, production) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
+function persistPromptedProductionBuild(cwd, platform, production) {
+  return updateDevConfig(cwd, platform, (next) => {
+    mergeProductionPair(next, platform, production);
+  });
+}
+function mergeProductionPair(next, platform, production) {
   const existingBuild = next.platforms[platform]?.build;
   if (!existingBuild?.command || !existingBuild?.artifact) {
     throw new Error(
@@ -984,8 +1062,6 @@ function persistPromptedProductionBuild(cwd, cfg, platform, production) {
     );
   }
   next.platforms[platform].build = { ...existingBuild, ...production };
-  saveDevConfig(cwd, next);
-  return next;
 }
 async function resolveProductionBuildConfig(cwd, cfgRef, platform, opts) {
   const entry = cfgRef.current?.platforms?.[platform]?.build;
@@ -1003,7 +1079,7 @@ async function resolveProductionBuildConfig(cwd, cfgRef, platform, opts) {
   if (!answered) {
     fail(opts, "a production build config is required for --production", "config_required");
   }
-  cfgRef.current = persistPromptedProductionBuild(cwd, cfgRef.current, platform, answered);
+  cfgRef.current = persistPromptedProductionBuild(cwd, platform, answered);
   return { command: answered.productionCommand, artifact: answered.productionArtifact };
 }
 async function buildCommand(opts, cloudDeps) {
@@ -1023,7 +1099,6 @@ async function buildCommand(opts, cloudDeps) {
     }
     const platform = await resolveBarePlatform(cwd, cfgRef.current, opts);
     const build = await resolveBuildConfig(cwd, cfgRef, platform, opts);
-    const cfg = cfgRef.current;
     const result = await runBuildForPlatform(
       cwd,
       platform,
@@ -1032,7 +1107,7 @@ async function buildCommand(opts, cloudDeps) {
       (l) => console.error(chalk3.dim(l))
     );
     for (const w of result.warnings ?? []) console.error(chalk3.yellow(`\u26A0 ${w}`));
-    persistUploadedAppId(cwd, cfg, platform, build, result.public_id);
+    persistUploadedAppId(cwd, platform, build, result.public_id);
     if (opts.json) {
       console.log(
         JSON.stringify({ app_id: result.public_id, name: result.name, platform: result.platform })
@@ -1135,16 +1210,17 @@ function requireProductionCapable(opts, platform) {
     fail(opts, productionUnsupportedReason(platform));
   }
 }
-function persistPickedAppId(cwd, cfg, platform, appId) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
-  const entry = next.platforms[platform];
-  if (entry) {
-    entry.appId = appId;
-  } else {
-    next.platforms[platform] = { appId };
-  }
-  saveDevConfig(cwd, next);
-  return next;
+function persistPickedAppId(cwd, platform, appId, opts = {}) {
+  return updateDevConfig(cwd, platform, (next) => {
+    const entry = next.platforms[platform];
+    if (opts.onlyIfUnset && entry?.appId) return false;
+    if (entry) {
+      entry.appId = appId;
+    } else {
+      next.platforms[platform] = { appId };
+    }
+    return true;
+  });
 }
 var APP_PICKER_SENTINEL = {
   CREATE_NEW_APP: "__vibeview_create_new_app__",
@@ -1212,7 +1288,7 @@ async function resolveCloudAppIds(cwd, cfgRef, platforms, opts, listApps) {
       createFromArtifact.add(platform);
       continue;
     }
-    cfgRef.current = persistPickedAppId(cwd, cfgRef.current, platform, appId);
+    cfgRef.current = persistPickedAppId(cwd, platform, appId);
   }
   return createFromArtifact;
 }
@@ -1222,7 +1298,7 @@ function persistResolvedAppIds(cwd, cfgRef, createFromArtifact, finished) {
     const platform = b.platform;
     if (!createFromArtifact.has(platform)) continue;
     if (cfgRef.current?.platforms?.[platform]?.appId) continue;
-    cfgRef.current = persistPickedAppId(cwd, cfgRef.current, platform, b.app_public_id);
+    cfgRef.current = persistPickedAppId(cwd, platform, b.app_public_id, { onlyIfUnset: true });
   }
 }
 function describeAllExclusions(configured) {
@@ -1897,7 +1973,7 @@ import { spawn as spawn3 } from "child_process";
 import { createInterface as createInterface2 } from "readline";
 
 // src/lib/metro-state.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync5, rmSync as rmSync4, writeFileSync as writeFileSync4 } from "fs";
 import { dirname as dirname2, join as join5 } from "path";
 var STATE_DIR2 = ".vibeview";
 var STATE_FILE2 = "metro-state.json";
@@ -1935,7 +2011,7 @@ function readMetroState(cwd) {
 }
 function clearMetroState(cwd) {
   const path = statePath2(cwd);
-  if (existsSync3(path)) rmSync3(path, { force: true });
+  if (existsSync3(path)) rmSync4(path, { force: true });
 }
 function killOwnedMetro(cwd) {
   const state = readMetroState(cwd);
@@ -2604,7 +2680,9 @@ ${hint}`);
     firstRunBuild
   });
   const commitConfig = () => {
-    saveDevConfig(process.cwd(), cfg);
+    updateDevConfig(process.cwd(), platform, (fresh) => {
+      applyConfigChanges(fresh, existing, cfg);
+    });
     if (existing) {
       const changes = describeConfigChanges(existing, cfg);
       if (changes.length) {
@@ -2644,6 +2722,13 @@ async function runDevInProcess(opts) {
     emit(opts.json, { event: "error", code: "invalid_flag", message });
     process.exit(2);
   }
+  const standalone = opts.standalone === true;
+  if (standalone && opts.platform === "roku") {
+    const message = "--standalone is not for roku \u2014 a Roku dev session has no Metro; it re-packages the channel";
+    console.error(chalk4.red(`error: ${message}`));
+    emit(opts.json, { event: "error", code: "invalid_flag", message });
+    process.exit(2);
+  }
   let pinnedBuildId;
   if (typeof opts.build === "string") {
     try {
@@ -2672,7 +2757,7 @@ async function runDevInProcess(opts) {
   const cfg = await ensureConfig(api, opts);
   if (pinnedBuildId !== void 0) {
     try {
-      checkDevBuild(await api.getApp(cfg.appId), pinnedBuildId, cfg.platform);
+      checkDevBuild(await api.getApp(cfg.appId), pinnedBuildId, cfg.platform, { standalone });
     } catch (err) {
       const message = err.message;
       console.error(chalk4.red(`error: ${message}`));
@@ -2708,10 +2793,12 @@ async function runDevInProcess(opts) {
         (l) => console.error(chalk4.dim(l))
       );
       cfg.appId = result.public_id;
-      if (reloaded && reloaded.platforms[cfg.platform] && reloaded.platforms[cfg.platform].appId !== result.public_id) {
-        reloaded.platforms[cfg.platform].appId = result.public_id;
-        saveDevConfig(process.cwd(), reloaded);
-      }
+      updateDevConfig(process.cwd(), cfg.platform, (fresh) => {
+        const entry = fresh.platforms[cfg.platform];
+        if (!entry || entry.appId === result.public_id) return false;
+        entry.appId = result.public_id;
+        return true;
+      });
     } catch (err) {
       const message = err.message;
       console.error(chalk4.red(`error: ${message}`));
@@ -2722,7 +2809,14 @@ async function runDevInProcess(opts) {
   let metroOwnedThisRun = false;
   let rokuBuild;
   let watchIgnore = [];
-  if (PLATFORM_NEEDS_METRO[cfg.platform]) {
+  if (standalone && cfg.platform === "roku") {
+    const message = "--standalone is not for roku \u2014 a Roku dev session has no Metro";
+    console.error(chalk4.red(`error: ${message}`));
+    emit(opts.json, { event: "error", code: "invalid_flag", message });
+    process.exit(2);
+  }
+  if (standalone) {
+  } else if (PLATFORM_NEEDS_METRO[cfg.platform]) {
     const metroPort = cfg.metroPort ?? 8081;
     let metroResult;
     try {
@@ -2774,7 +2868,7 @@ async function runDevInProcess(opts) {
   }
   console.error(
     chalk4.dim(
-      `Starting ${platformWithArticle(cfg.platform)} dev session for ${cfg.appId}${pinnedBuildId !== void 0 ? ` (build ${pinnedBuildId})` : ""}...`
+      `Starting ${platformWithArticle(cfg.platform)} ${standalone ? "standalone session (no Metro)" : "dev session"} for ${cfg.appId}${pinnedBuildId !== void 0 ? ` (build ${pinnedBuildId})` : ""}...`
     )
   );
   let stopping = false;
@@ -2807,6 +2901,7 @@ async function runDevInProcess(opts) {
         deviceCategory: cfg.deviceCategory,
         model: cfg.model,
         buildId: pinnedBuildId,
+        ...standalone ? { standalone } : {},
         metroPort: cfg.metroPort ?? 8081,
         // startDevSession's own browser-open happens before we've written the
         // state file / emitted session_ready — open it ourselves afterward

package/dist/cli.js

@@ -22,7 +22,7 @@ import {
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-OKOAWGWV.js";
+} from "./chunk-T6EQQV6E.js";
 import {
   ApiClient,
   ApiStatusError,
@@ -38,11 +38,12 @@ import {
   formatUtcTimestamp,
   loadConfig,
   printJsonError,
+  queueReasonCopy,
   reportCommandError,
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-2JLTC67A.js";
+} from "./chunk-PBMB6TG4.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -338,6 +339,7 @@ async function pollUntilComplete(client, runId, timeoutMs, spinner, onQueueObser
   let currentStepLabel = "";
   const printedSteps = /* @__PURE__ */ new Set();
   let cachedDeviceLabel = null;
+  let lastQueueReason = null;
   const caseStateBefore = /* @__PURE__ */ new Map();
   const caseStartedPrinted = /* @__PURE__ */ new Set();
   while (Date.now() < deadline) {
@@ -415,6 +417,11 @@ async function pollUntilComplete(client, runId, timeoutMs, spinner, onQueueObser
         label = "the device pool";
       }
       spinner.text = `Queued \u2014 position ${q.position} in line for ${label}`;
+      const why = queueReasonCopy(q.reason);
+      if (why && why !== lastQueueReason) {
+        printBelowSpinner(spinner, `${chalk2.yellow("\u23F3")} Waiting for a device: ${why}`);
+      }
+      lastQueueReason = why;
     }
     if (progress.length === 0) {
       if (result.status === "pending") {
@@ -434,7 +441,8 @@ async function pollUntilComplete(client, runId, timeoutMs, spinner, onQueueObser
       }
     }
     if (keepAlive && Date.now() - lastLogTime >= 3e4) {
-      const where = result.status === "queued" && result.queue ? ` (position ${result.queue.position} in line for a device)` : "";
+      const why = result.status === "queued" ? queueReasonCopy(result.queue?.reason) : null;
+      const where = result.status === "queued" && result.queue ? ` (position ${result.queue.position} in line for a device${why ? `: ${why}` : ""})` : "";
       process.stderr.write(`Status: ${result.status}${where}...
 `);
       lastLogTime = Date.now();
@@ -742,7 +750,8 @@ ${signal} received.
       model: opts.model,
       provider: opts.provider,
       mode: opts.mode,
-      device_category: opts.device ? void 0 : opts.deviceCategory ?? "phone",
+      // Omitted unless asked for: the backend picks tv for each TV suite.
+      device_category: opts.device ? void 0 : opts.deviceCategory,
       device_id: opts.device,
       build_id: opts.build,
       metadata: opts.metadata
@@ -792,6 +801,7 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
   const deadline = Date.now() + totalTimeout * 1e3;
   const suiteStateBefore = /* @__PURE__ */ new Map();
   const suiteStartedPrinted = /* @__PURE__ */ new Set();
+  let lastQueueReason = null;
   const print = (line) => {
     spinner.stop();
     process.stderr.write(line + "\n");
@@ -870,8 +880,16 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
     if (queuedChild && queuedChild.queue) {
       const q = queuedChild.queue;
       const target = q.specific_device_id ?? "the device pool";
+      const why = queueReasonCopy(q.reason);
+      if (why && why !== lastQueueReason) {
+        print(
+          `${chalk4.yellow("\u23F3")} ${chalk4.bold(queuedChild.suite_name)} is waiting for a device: ${why}`
+        );
+      }
+      lastQueueReason = why;
       spinner.text = `Queued \u2014 ${chalk4.bold(queuedChild.suite_name)} position ${q.position} for ${target} (${doneCount}/${totalMatched} suite(s) complete)`;
     } else {
+      lastQueueReason = null;
       spinner.text = `Running suites \u2014 ${doneCount}/${totalMatched} complete...`;
     }
     if (TERMINAL.has(last.status)) break;
@@ -1767,7 +1785,8 @@ function defaultDeps2(client) {
     getSubmission: client.getSubmission.bind(client),
     getSubmissionLog: client.getSubmissionLog.bind(client),
     listCloudBuilds: client.listCloudBuilds.bind(client),
-    checkStorePreflight: client.checkStorePreflight.bind(client)
+    checkStorePreflight: client.checkStorePreflight.bind(client),
+    getApp: client.getApp.bind(client)
   };
 }
 var POLL_INTERVAL_MS2 = 2e3;
@@ -1892,7 +1911,7 @@ async function submitCommand(opts, deps) {
   }
   if (rollout !== void 0 && releaseStatus !== "inProgress") {
     throw new UsageError(
-      `a rollout fraction requires release status "inProgress" (a staged rollout) \u2014 got "${releaseStatus ?? "completed"}"`
+      `a rollout fraction requires release status "inProgress" (a staged rollout) \u2014 got "${releaseStatus ?? (track === "production" ? "draft" : "completed")}"`
     );
   }
   if (releaseStatus === "inProgress" && rollout === void 0) {
@@ -1946,12 +1965,19 @@ async function submitCommand(opts, deps) {
   }
 }
 async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
-  const identifier = androidFamily ? opts.package : opts.bundleId;
+  const flagged = androidFamily ? opts.package : opts.bundleId;
+  const usage = androidFamily ? `--check needs the package name to look up: --package <name> (e.g. --package io.example.app)` : `--check needs the bundle identifier to look up: --bundle-id <id> (e.g. --bundle-id io.example.app)`;
+  let identifier = flagged;
   if (!identifier) {
-    throw new UsageError(
-      androidFamily ? `--check needs the package name to look up: --package <name> (e.g. --package io.example.app)` : `--check needs the bundle identifier to look up: --bundle-id <id> (e.g. --bundle-id io.example.app)`
-    );
+    try {
+      identifier = await linkedIdentifier(platform, opts, deps);
+    } catch (err) {
+      printError2(opts, err);
+      process.exitCode = errorExitCode(err);
+      return;
+    }
   }
+  if (!identifier) throw new UsageError(usage);
   try {
     const result = await deps.checkStorePreflight({
       platform,
@@ -1976,6 +2002,32 @@ async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
     process.exitCode = errorExitCode(err);
   }
 }
+async function linkedIdentifier(platform, opts, deps) {
+  if (!deps.getApp) return void 0;
+  let appId;
+  try {
+    appId = loadDevConfig(process.cwd())?.platforms?.[platform]?.appId;
+  } catch {
+    return void 0;
+  }
+  if (!appId) return void 0;
+  let app;
+  try {
+    app = await deps.getApp(appId);
+  } catch (err) {
+    if (err instanceof NotFoundError) {
+      throw new Error(
+        `the app linked in vibeview.json for ${platform} (${appId}) no longer exists \u2014 ` + (platform === "android" || platform === "androidtv" ? "pass --package <name>" : "pass --bundle-id <id>")
+      );
+    }
+    throw err;
+  }
+  if (!app.package_name) return void 0;
+  if (!opts.json) {
+    console.error(chalk14.dim(`Checking ${app.package_name} (${app.name}, linked in vibeview.json)`));
+  }
+  return app.package_name;
+}
 async function resolveLatestBuild(platform, deps) {
   const { builds: builds2 } = await deps.listCloudBuilds({
     platform,
@@ -3511,7 +3563,7 @@ program.name("vibeview").description(
 ).version(pkg.version);
 program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
-  "Device category: phone, tablet, tv (default: phone when --device is not set)",
+  "Device category: phone, tablet, tv (default: tv for a TV platform, else phone)",
   parseDeviceCategory
 ).option(
   "--device <device_id>",
@@ -3539,7 +3591,7 @@ program.command("run-suites").description("Run all suites matching a tag filter"
   "Filter matched suites to one platform: ios, android, tvos, androidtv (default: no filter)"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-suite progress", false).option("--timeout <seconds>", "Per-suite timeout, capped at 2 hours total", "1800").option("--commit-sha <sha>", "Git commit SHA propagated to every SuiteRun").option("--model <model>", "AI model").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
-  "Device category: phone, tablet, tv (default: phone when --device is not set)",
+  "Device category: phone, tablet, tv (default: tv for a TV platform, else phone)",
   parseDeviceCategory
 ).option(
   "--device <device_id>",
@@ -3559,7 +3611,7 @@ program.command("run-suites").description("Run all suites matching a tag filter"
 });
 program.command("run-test <test-id>").description("Run a single test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show step details", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
-  "Device category: phone, tablet, tv (default: phone when --device is not set)",
+  "Device category: phone, tablet, tv (default: tv for a TV platform, else phone)",
   parseDeviceCategory
 ).option(
   "--device <device_id>",
@@ -3630,11 +3682,15 @@ program.command("dev").description(
   false
 ).option(
   "--build [id]",
-  "Bare: build and upload first (uses platforms.<platform>.build from vibeview.json). With an id: run that uploaded debug build instead of the newest one (see `vibeview list-builds <app>`)",
+  "Bare: build and upload first (uses platforms.<platform>.build from vibeview.json). With an id: run that uploaded debug build instead of the newest one (any build with --standalone) (see `vibeview list-builds <app>`)",
   false
 ).option(
   "--watch [seconds]",
   "Roku only: auto-reload after file changes settle (default: 2 seconds of quiet)"
+).option(
+  "--standalone",
+  "Run the build as it is, with no Metro and no tunnel (a release, CI or cloud build); without --build <id>, the newest release build. Code changes do not hot-reload",
+  false
 ).action((opts) => dev(opts));
 program.command("build").description("Run your configured build command and upload the result (see vibeview.json)").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option(
   "--platform <platform>",
@@ -3669,13 +3725,13 @@ program.command("submit").description(
   "ios/tvos only: which stored App Store Connect key to use (default when exactly one \u2014 see `vibeview credentials asc-key add`)"
 ).option(
   "--release-status <status>",
-  "android/androidtv only: Play release status \u2014 completed (default), draft, or inProgress"
+  "android/androidtv only: Play release status \u2014 completed, draft, or inProgress (default: draft on the production track, completed on the others)"
 ).option(
   "--rollout <fraction>",
   "android/androidtv only: staged-rollout fraction, 0 < f < 1 (requires --release-status inProgress)"
 ).option(
   "--check",
-  "Only check store readiness: does the store know this app with your stored key? Takes --platform plus --bundle-id (ios/tvos) or --package (android/androidtv); no build needed. Exit 0 when ready",
+  "Only check store readiness: does the store know this app with your stored key? Takes --platform plus --bundle-id (ios/tvos) or --package (android/androidtv), defaulting to the app linked in vibeview.json; no build needed. Exit 0 when ready",
   false
 ).option("--bundle-id <id>", "ios/tvos, with --check: the bundle identifier to look up").option("--no-wait", "Print the submission id and exit without waiting for completion").option("--json", "Emit line-delimited JSON events on stdout instead of human output", false).action((opts) => submitCommand(opts));
 var builds = program.command("builds").description("Manage cloud builds (see `vibeview build --cloud`)");
@@ -3775,7 +3831,7 @@ program.command("dev-reload").description(
 program.command("mcp").description(
   "Run an MCP stdio server exposing the agent verbs (tap, swipe, type, ...) plus dev_start/dev_stop/dev_reload as tools"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").action(async (opts) => {
-  const { runMcpServer } = await import("./server-6SRFOQ6B.js");
+  const { runMcpServer } = await import("./server-IGY2VPYT.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(

package/dist/{server-6SRFOQ6B.js → server-IGY2VPYT.js}

@@ -21,12 +21,12 @@ import {
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-OKOAWGWV.js";
+} from "./chunk-T6EQQV6E.js";
 import {
   ApiClient,
   NotFoundError,
   resolveAuth
-} from "./chunk-2JLTC67A.js";
+} from "./chunk-PBMB6TG4.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -539,7 +539,7 @@ async function handleUploadApp(args, deps) {
   }
   const name = typeof args.name === "string" && args.name ? args.name : void 0;
   const upload = deps.uploadApp ?? (async (f, n) => {
-    const { uploadAppBuild } = await import("./upload-app-WROTRZCA.js");
+    const { uploadAppBuild } = await import("./upload-app-FEZG23NU.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });

package/dist/{upload-app-WROTRZCA.js → upload-app-FEZG23NU.js}

@@ -3,7 +3,7 @@ import {
   describeBuild,
   uploadApp,
   uploadAppBuild
-} from "./chunk-2JLTC67A.js";
+} from "./chunk-PBMB6TG4.js";
 export {
   describeBuild,
   uploadApp,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "VibeView CLI -- run your app on cloud iOS simulators, Android emulators, Apple TV, Android TV and Roku (beta) devices: a React Native dev loop, device control for you or your coding agent (CLI or MCP), and tests from CI",
   "mcpName": "io.github.vibeview/vibeview",
   "type": "module",