vibeview 0.29.0 → 0.31.0

package/dist/cli.js

@@ -15,6 +15,7 @@ import {
   listBuilds,
   loadDevConfig,
   newTransitionState,
+  platformLabel,
   platformWithArticle,
   pressButtonsHelp,
   printOutcomeLine,
@@ -22,7 +23,7 @@ import {
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-T6EQQV6E.js";
+} from "./chunk-P6UIJALK.js";
 import {
   ApiClient,
   ApiStatusError,
@@ -43,14 +44,14 @@ import {
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-PBMB6TG4.js";
+} from "./chunk-ZZK7YQSP.js";
 
 // src/cli.ts
 import { createRequire } from "module";
 import { Command, Option } from "commander";
 
 // src/commands/run-suite.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 
 // src/lib/poll.ts
 import chalk2 from "chalk";
@@ -144,6 +145,10 @@ function formatHuman(result, verbose) {
     lines.push(`
   ${chalk.red("Error:")} ${result.error_message}`);
   }
+  if (result.build_warning && result.status !== "passed") {
+    lines.push(`
+  ${chalk.yellow("Note:")} ${result.build_warning}`);
+  }
   lines.push("");
   return lines.join("\n");
 }
@@ -173,9 +178,16 @@ function formatJunit(result) {
   lines.push(
     `  <testsuite name="${suiteName}" tests="${tests}" failures="${failures}" errors="${errors}" time="${totalTime}" timestamp="${timestamp}">`
   );
-  if (result.url) {
+  if (result.url || result.build_warning) {
     lines.push("    <properties>");
-    lines.push(`      <property name="vibeview.run_url" value="${escapeXml(result.url)}" />`);
+    if (result.url) {
+      lines.push(`      <property name="vibeview.run_url" value="${escapeXml(result.url)}" />`);
+    }
+    if (result.build_warning) {
+      lines.push(
+        `      <property name="vibeview.build_warning" value="${escapeXml(result.build_warning)}" />`
+      );
+    }
     lines.push("    </properties>");
   }
   for (const tr of cases) {
@@ -224,46 +236,97 @@ function formatJunitError(name, message, url) {
   return lines.join("\n");
 }
 var MULTI_TERMINAL = /* @__PURE__ */ new Set(["passed", "failed", "error", "cancelled"]);
+function caseLines(c, classname) {
+  const name = escapeXml(c.name);
+  const head = `    <testcase name="${name}" classname="${classname}" time="${c.time}"`;
+  const out = c.url ? `      <system-out>${escapeXml(c.url)}</system-out>` : null;
+  if (c.verdict === "passed" && !out) return [`${head} />`];
+  const lines = [`${head}>`];
+  const msg = escapeXml(c.message ?? "");
+  if (c.verdict === "failure") {
+    lines.push(`      <failure message="${msg}" type="TestFailure">${msg}</failure>`);
+  } else if (c.verdict === "error") {
+    lines.push(`      <error message="${msg}" type="InfraError">${msg}</error>`);
+  } else if (c.verdict === "skipped") {
+    lines.push(`      <skipped message="${msg}" />`);
+  }
+  if (out) lines.push(out);
+  lines.push("    </testcase>");
+  return lines;
+}
 function formatMultiSuiteJunit(result, opts = {}) {
-  const unfinished = (status) => opts.timedOut !== void 0 && !MULTI_TERMINAL.has(status);
-  const errored = (status) => status === "error" || unfinished(status);
-  const tests = result.suite_runs.reduce((sum, sr) => sum + sr.passed + sr.failed, 0);
-  const failures = result.suite_runs.reduce((sum, sr) => sum + sr.failed, 0);
-  const noSuites = opts.timedOut !== void 0 && result.suite_runs.length === 0;
-  const totalErrors = result.suite_runs.filter((sr) => errored(sr.status)).length + (noSuites ? 1 : 0);
+  const unfinished = (status) => opts.timedOut !== void 0 && !MULTI_TERMINAL.has(status ?? "");
   const timestamp = result.started_at ?? (/* @__PURE__ */ new Date()).toISOString();
+  const suites = result.suite_runs.map((sr) => {
+    const suiteName = sr.suite_name || sr.suite_id;
+    const cases = (sr.case_runs ?? []).map((c) => {
+      const name = c.case_name || c.run_id;
+      const time = c.duration_ms ? (c.duration_ms / 1e3).toFixed(1) : "0";
+      const base = { name, time, url: c.url || void 0 };
+      switch (c.status) {
+        case "passed":
+          return { ...base, verdict: "passed" };
+        case "failed":
+          return {
+            ...base,
+            verdict: "failure",
+            message: c.error_message || "Test failed"
+          };
+        case "error":
+          return {
+            ...base,
+            verdict: "error",
+            message: c.error_message || "Infrastructure error"
+          };
+        case "cancelled":
+          return { ...base, verdict: "skipped", message: c.error_message || "Cancelled" };
+        default:
+          return unfinished(c.status) ? {
+            ...base,
+            verdict: "error",
+            message: `${opts.timedOut} (case was ${c.status ?? "not started"})`
+          } : { ...base, verdict: "skipped", message: "Not run" };
+      }
+    });
+    const suiteError = unfinished(sr.status) ? `${opts.timedOut} (suite was ${sr.status})` : sr.status === "error" ? sr.error_message || "Suite errored" : null;
+    if (suiteError && !cases.some((c) => c.verdict === "error")) {
+      cases.push({ name: suiteName, time: "0", verdict: "error", message: suiteError });
+    }
+    const legacy = sr.case_runs === void 0;
+    const tests2 = legacy ? sr.passed + sr.failed + (suiteError ? 1 : 0) : cases.length;
+    const failures = legacy ? sr.failed : cases.filter((c) => c.verdict === "failure").length;
+    const errors2 = cases.filter((c) => c.verdict === "error").length;
+    const skipped = cases.filter((c) => c.verdict === "skipped").length;
+    return { sr, suiteName, cases, tests: tests2, failures, errors: errors2, skipped };
+  });
+  const noSuites = opts.timedOut !== void 0 && result.suite_runs.length === 0;
+  const sum = (key) => suites.reduce((n, s) => n + s[key], 0);
+  const tests = sum("tests") + (noSuites ? 1 : 0);
+  const errors = sum("errors") + (noSuites ? 1 : 0);
   const lines = [];
   lines.push('<?xml version="1.0" encoding="UTF-8"?>');
   lines.push(
-    `<testsuites name="vibeview-multi" tests="${tests}" failures="${failures}" errors="${totalErrors}">`
+    `<testsuites name="vibeview-multi" tests="${tests}" failures="${sum("failures")}" errors="${errors}" skipped="${sum("skipped")}">`
   );
-  for (const sr of result.suite_runs) {
-    const suiteName = escapeXml(sr.suite_name || sr.suite_id);
-    const suiteTests = sr.passed + sr.failed;
-    const suiteFails = sr.failed;
-    const suiteErrors = errored(sr.status) ? 1 : 0;
+  for (const s of suites) {
+    const suiteName = escapeXml(s.suiteName);
     lines.push(
-      `  <testsuite name="${suiteName}" tests="${suiteTests}" failures="${suiteFails}" errors="${suiteErrors}" timestamp="${timestamp}">`
+      `  <testsuite name="${suiteName}" tests="${s.tests}" failures="${s.failures}" errors="${s.errors}" skipped="${s.skipped}" timestamp="${timestamp}">`
     );
-    if (sr.url) {
+    if (s.sr.url) {
       lines.push("    <properties>");
-      lines.push(`      <property name="vibeview.run_url" value="${escapeXml(sr.url)}" />`);
+      lines.push(`      <property name="vibeview.run_url" value="${escapeXml(s.sr.url)}" />`);
       lines.push("    </properties>");
     }
-    if (unfinished(sr.status)) {
-      const msg = escapeXml(`${opts.timedOut} (suite was ${sr.status})`);
-      lines.push(`    <error message="${msg}" type="InfraError" />`);
-    } else if (suiteErrors > 0) {
-      lines.push(`    <error message="Suite errored" type="InfraError" />`);
-    }
+    for (const c of s.cases) lines.push(...caseLines(c, suiteName));
     lines.push("  </testsuite>");
   }
   if (noSuites) {
-    const msg = escapeXml(opts.timedOut);
+    const name = "vibeview run-suites";
     lines.push(
-      `  <testsuite name="vibeview run-suites" tests="0" failures="0" errors="1" timestamp="${timestamp}">`
+      `  <testsuite name="${name}" tests="1" failures="0" errors="1" skipped="0" timestamp="${timestamp}">`
     );
-    lines.push(`    <error message="${msg}" type="InfraError" />`);
+    lines.push(...caseLines({ name, time: "0", verdict: "error", message: opts.timedOut }, name));
     lines.push("  </testsuite>");
   }
   lines.push("</testsuites>");
@@ -570,6 +633,42 @@ function mapExitCode(status) {
   return EXIT_INFRA_ERROR;
 }
 
+// src/lib/run-target.ts
+import chalk3 from "chalk";
+var RUN_PLATFORMS = ["ios", "android", "tvos", "androidtv"];
+function parseRunPlatform(value) {
+  if (value === void 0) return void 0;
+  if (!RUN_PLATFORMS.includes(value)) {
+    throw new Error(`--platform must be one of ${RUN_PLATFORMS.join(", ")}, got "${value}"`);
+  }
+  return value;
+}
+function refusePlatformWithApp(options) {
+  if (options.platform && options.app) {
+    throw new Error(
+      "--platform and --app cannot be combined: --app already names the app, and so the platform, the run uses. Pass --app <id> to pick an app, or --platform to run the app with the same bundle id / package on that platform."
+    );
+  }
+}
+function printBuildWarning(warning, label) {
+  if (!warning) return;
+  const prefix = label ? `warning (${label}):` : "warning:";
+  process.stderr.write(chalk3.yellow(`${prefix} ${warning}`) + "\n");
+}
+function describeRunTarget(response, options) {
+  const asked = Boolean(options.platform || options.app);
+  if (!response.app_id) {
+    if (asked) {
+      throw new Error(
+        "this VibeView server does not support --platform/--app on test runs yet; the run was stopped rather than run on the test\u2019s own platform"
+      );
+    }
+    return null;
+  }
+  if (!asked) return null;
+  return `${response.app_id} (${platformLabel(response.platform ?? "")})`;
+}
+
 // src/commands/run-suite.ts
 async function runSuite(suiteId, options) {
   const { token, baseUrl } = resolveAuth(options);
@@ -635,17 +734,22 @@ ${signal} received.
       deviceCategory: options.deviceCategory,
       device: options.device,
       build: options.build,
-      metadata: options.metadata
+      metadata: options.metadata,
+      platform: options.platform,
+      app: options.app
     });
     sessionId = response.session_id;
     runId = response.run_id;
+    const target = describeRunTarget(response, options);
     spinner.stop();
     process.stderr.write(
-      `${chalk3.dim("Suite:")} ${suiteId}
-${chalk3.dim("Run:")} ${response.run_id}
-` + (sessionId ? `${chalk3.dim("Session:")} ${sessionId}
+      `${chalk4.dim("Suite:")} ${suiteId}
+` + (target ? `${chalk4.dim("App:")} ${target}
+` : "") + `${chalk4.dim("Run:")} ${response.run_id}
+` + (sessionId ? `${chalk4.dim("Session:")} ${sessionId}
 ` : "")
     );
+    printBuildWarning(response.build_warning);
     spinner.start("Waiting for device...");
     const timeoutMs = (options.timeout ?? 300) * 1e3;
     const result = await pollUntilComplete(
@@ -663,7 +767,10 @@ ${chalk3.dim("Run:")} ${response.run_id}
       process.stdin.setRawMode(false);
       process.stdin.pause();
     }
-    outputResult(result, options);
+    outputResult(
+      response.build_warning ? { ...result, build_warning: response.build_warning } : result,
+      options
+    );
     process.exit(mapExitCode(result.status));
   } catch (err) {
     spinner.fail(err instanceof Error ? err.message : "Unknown error");
@@ -689,7 +796,7 @@ ${chalk3.dim("Run:")} ${response.run_id}
 }
 
 // src/commands/run-suites.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 var AGGREGATE_TIMEOUT_CAP_S = 7200;
 async function runSuites(opts) {
   if (!opts.tag || opts.tag.length === 0) {
@@ -764,13 +871,13 @@ ${signal} received.
       const noMatch = `No suites match tags: ${opts.tag.join(", ")}${suffix}`;
       if (opts.output === "json") printJsonError(noMatch);
       if (opts.output === "junit") console.log(formatJunitError("vibeview run-suites", noMatch));
-      process.stderr.write(chalk4.yellow(`${noMatch}
+      process.stderr.write(chalk5.yellow(`${noMatch}
 `));
       process.exit(EXIT_INFRA_ERROR);
     }
     if (opts.output === "json") printJsonError(err);
     if (opts.output === "junit") console.log(formatJunitError("vibeview run-suites", msg));
-    process.stderr.write(chalk4.red(`Failed to start: ${msg}
+    process.stderr.write(chalk5.red(`Failed to start: ${msg}
 `));
     process.exit(EXIT_INFRA_ERROR);
   }
@@ -779,16 +886,17 @@ ${signal} received.
   const matchedNames = start.matched_suites?.map((s) => s.name) ?? [];
   const totalMatched = start.matched_suite_ids.length;
   process.stderr.write(
-    `${chalk4.dim("Aggregate:")} ${start.aggregate_id}
-${chalk4.dim("Tags:")} ${opts.tag.join(", ")} ${chalk4.dim("(" + (opts.match ?? "any") + ")")}
-${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u2014 " + matchedNames.join(", ") : ""}
+    `${chalk5.dim("Aggregate:")} ${start.aggregate_id}
+${chalk5.dim("Tags:")} ${opts.tag.join(", ")} ${chalk5.dim("(" + (opts.match ?? "any") + ")")}
+${chalk5.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u2014 " + matchedNames.join(", ") : ""}
 `
   );
+  for (const s of start.matched_suites ?? []) printBuildWarning(s.build_warning, s.name);
   const excluded = start.excluded_suites ?? [];
   if (excluded.length) {
     const names = excluded.map((s) => s.name).join(", ");
     process.stderr.write(
-      chalk4.dim(`Excluded ${excluded.length} suite(s) (platform mismatch): ${names}
+      chalk5.dim(`Excluded ${excluded.length} suite(s) (platform mismatch): ${names}
 `)
     );
   }
@@ -802,20 +910,28 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
   const suiteStateBefore = /* @__PURE__ */ new Map();
   const suiteStartedPrinted = /* @__PURE__ */ new Set();
   let lastQueueReason = null;
+  let pending = [];
   const print = (line) => {
+    pending.push(line);
+  };
+  const flush = (nextText) => {
+    const textChanged = nextText !== null && nextText !== spinner.text;
+    if (pending.length === 0 && !textChanged) return;
     spinner.stop();
-    process.stderr.write(line + "\n");
-    spinner.start();
+    for (const line of pending) process.stderr.write(line + "\n");
+    pending = [];
+    if (nextText !== null) spinner.start(nextText);
   };
   const TERMINAL = /* @__PURE__ */ new Set(["passed", "failed", "error", "cancelled"]);
   let last = null;
   const abandon = async (reason) => {
+    flush(null);
     spinner.stop();
     if (process.stdin.isTTY) {
       process.stdin.setRawMode(false);
       process.stdin.pause();
     }
-    process.stderr.write(chalk4.red(`${reason}
+    process.stderr.write(chalk5.red(`${reason}
 `));
     process.stderr.write("Cancelling multi-suite run...\n");
     try {
@@ -823,7 +939,7 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
       process.stderr.write("Cancellation requested.\n");
     } catch (err) {
       const m = err instanceof Error ? err.message : String(err);
-      process.stderr.write(chalk4.yellow(`Could not cancel the run: ${m}
+      process.stderr.write(chalk5.yellow(`Could not cancel the run: ${m}
 `));
     }
     if (opts.output === "json") {
@@ -851,6 +967,7 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
       return abandon(`Could not read the run's status: ${m}`);
     }
     let doneCount = 0;
+    let nextText;
     let queuedChild;
     for (const sr of last.suite_runs) {
       const cur = sr.status;
@@ -860,17 +977,17 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
       }
       if (cur === "running" && !suiteStartedPrinted.has(sr.run_id)) {
         suiteStartedPrinted.add(sr.run_id);
-        print(`${chalk4.cyan("\u25B6")} ${chalk4.bold(sr.suite_name)} started`);
+        print(`${chalk5.cyan("\u25B6")} ${chalk5.bold(sr.suite_name)} started`);
       }
       const wasTerminal = prev !== void 0 && TERMINAL.has(prev);
       if (TERMINAL.has(cur) && !wasTerminal) {
-        const mark = cur === "passed" ? chalk4.green("\u2713") : cur === "cancelled" ? chalk4.yellow("\u26A0") : chalk4.red("\u2717");
-        const link = sr.url ? chalk4.dim(" " + sr.url) : "";
+        const mark = cur === "passed" ? chalk5.green("\u2713") : cur === "cancelled" ? chalk5.yellow("\u26A0") : chalk5.red("\u2717");
+        const link = sr.url ? chalk5.dim(" " + sr.url) : "";
         print(
-          `${mark} ${chalk4.bold(sr.suite_name)} ${cur}: ${sr.passed} passed, ${sr.failed} failed${link}`
+          `${mark} ${chalk5.bold(sr.suite_name)} ${cur}: ${sr.passed} passed, ${sr.failed} failed${link}`
         );
         if (sr.error_message) {
-          print(`    ${chalk4.red(sr.error_message)}`);
+          print(`    ${chalk5.red(sr.error_message)}`);
         }
       }
       suiteStateBefore.set(sr.run_id, cur);
@@ -883,16 +1000,20 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
       const why = queueReasonCopy(q.reason);
       if (why && why !== lastQueueReason) {
         print(
-          `${chalk4.yellow("\u23F3")} ${chalk4.bold(queuedChild.suite_name)} is waiting for a device: ${why}`
+          `${chalk5.yellow("\u23F3")} ${chalk5.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)`;
+      nextText = `Queued \u2014 ${chalk5.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...`;
+      nextText = `Running suites \u2014 ${doneCount}/${totalMatched} complete...`;
+    }
+    if (TERMINAL.has(last.status)) {
+      flush(null);
+      break;
     }
-    if (TERMINAL.has(last.status)) break;
+    flush(nextText);
     await new Promise((r) => setTimeout(r, 2e3));
   }
   if (!last || !TERMINAL.has(last.status)) {
@@ -906,7 +1027,9 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
     process.stdin.pause();
   }
   if (opts.output === "json") {
-    process.stdout.write(JSON.stringify(last, null, 2) + "\n");
+    const buildWarnings = (start.matched_suites ?? []).filter((s) => s.build_warning).map((s) => ({ suite_id: s.id, suite_name: s.name, build_warning: s.build_warning }));
+    const doc = buildWarnings.length ? { ...last, build_warnings: buildWarnings } : last;
+    process.stdout.write(JSON.stringify(doc, null, 2) + "\n");
   } else if (opts.output === "junit") {
     process.stdout.write(formatMultiSuiteJunit(last) + "\n");
   } else {
@@ -914,25 +1037,25 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
 Aggregate: ${last.status}
 `);
     for (const sr of last.suite_runs) {
-      const mark = sr.status === "passed" ? chalk4.green("\u2713") : chalk4.red("\u2717");
-      const link = sr.url ? chalk4.dim(` ${sr.url}`) : "";
+      const mark = sr.status === "passed" ? chalk5.green("\u2713") : chalk5.red("\u2717");
+      const link = sr.url ? chalk5.dim(` ${sr.url}`) : "";
       process.stdout.write(
         `  ${mark} ${sr.suite_name}: ${sr.passed} passed, ${sr.failed} failed${link}
 `
       );
       if (sr.error_message) {
-        process.stdout.write(`      ${chalk4.red(sr.error_message)}
+        process.stdout.write(`      ${chalk5.red(sr.error_message)}
 `);
       }
       for (const cr of sr.case_runs ?? []) {
-        const caseMark = cr.status === "passed" ? chalk4.green("\u2713") : cr.status === "cancelled" || cr.status === "pending" || cr.status === "running" ? chalk4.yellow("-") : chalk4.red("\u2717");
-        const dur = cr.duration_ms ? chalk4.dim(` (${(cr.duration_ms / 1e3).toFixed(1)}s)`) : "";
+        const caseMark = cr.status === "passed" ? chalk5.green("\u2713") : cr.status === "cancelled" || cr.status === "pending" || cr.status === "running" ? chalk5.yellow("-") : chalk5.red("\u2717");
+        const dur = cr.duration_ms ? chalk5.dim(` (${(cr.duration_ms / 1e3).toFixed(1)}s)`) : "";
         process.stdout.write(
-          `      ${caseMark} ${cr.case_name ?? "Case"} ${cr.status ?? "?"}${dur} ${chalk4.dim(cr.url)}
+          `      ${caseMark} ${cr.case_name ?? "Case"} ${cr.status ?? "?"}${dur} ${chalk5.dim(cr.url)}
 `
         );
         if (cr.error_message && cr.status !== "passed") {
-          process.stdout.write(`          ${chalk4.red(cr.error_message)}
+          process.stdout.write(`          ${chalk5.red(cr.error_message)}
 `);
         }
       }
@@ -944,7 +1067,7 @@ Aggregate: ${last.status}
 }
 
 // src/commands/run-test.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 async function runTest(testId, options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
@@ -1009,18 +1132,23 @@ ${signal} received.
       deviceCategory: options.deviceCategory,
       device: options.device,
       build: options.build,
-      metadata: options.metadata
+      metadata: options.metadata,
+      platform: options.platform,
+      app: options.app
     });
     sessionId = response.session_id;
     runId = response.run_id;
+    const target = describeRunTarget(response, options);
     spinner.stop();
     process.stderr.write(
-      `${chalk5.dim("Session:")} ${sessionId || "unknown"}
-${chalk5.dim("Device:")} ${response.device_name || "allocating..."}
-${chalk5.dim("Test:")} ${testId}
-${chalk5.dim("Run:")} ${response.run_id}
+      `${chalk6.dim("Session:")} ${sessionId || "unknown"}
+${chalk6.dim("Device:")} ${response.device_name || "allocating..."}
+${chalk6.dim("Test:")} ${testId}
+` + (target ? `${chalk6.dim("App:")} ${target}
+` : "") + `${chalk6.dim("Run:")} ${response.run_id}
 `
     );
+    printBuildWarning(response.build_warning);
     spinner.start("Waiting for device...");
     const timeoutMs = (options.timeout ?? 300) * 1e3;
     const result = await pollUntilComplete(
@@ -1038,7 +1166,10 @@ ${chalk5.dim("Run:")} ${response.run_id}
       process.stdin.setRawMode(false);
       process.stdin.pause();
     }
-    outputResult(result, options);
+    outputResult(
+      response.build_warning ? { ...result, build_warning: response.build_warning } : result,
+      options
+    );
     process.exit(mapExitCode(result.status));
   } catch (err) {
     spinner.fail(err instanceof Error ? err.message : "Unknown error");
@@ -1064,7 +1195,7 @@ ${chalk5.dim("Run:")} ${response.run_id}
 }
 
 // src/commands/list-suites.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 async function listSuites(options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
@@ -1086,21 +1217,21 @@ async function listSuites(options) {
     console.log("No test suites found.");
     return;
   }
-  console.log(chalk6.bold(`
+  console.log(chalk7.bold(`
   ${suites.length} suite(s)
 `));
   for (const s of suites) {
-    const platform = s.platform ? chalk6.dim(` [${s.platform}]`) : "";
-    const tagsText = s.tags && s.tags.length > 0 ? chalk6.dim(` [${s.tags.map((t) => t.display_name).join(", ")}]`) : "";
+    const platform = s.platform ? chalk7.dim(` [${s.platform}]`) : "";
+    const tagsText = s.tags && s.tags.length > 0 ? chalk7.dim(` [${s.tags.map((t) => t.display_name).join(", ")}]`) : "";
     console.log(
-      `  ${chalk6.cyan(s.id)}  ${s.name}${platform}${tagsText}  (${s.case_count} ${s.case_count === 1 ? "case" : "cases"})`
+      `  ${chalk7.cyan(s.id)}  ${s.name}${platform}${tagsText}  (${s.case_count} ${s.case_count === 1 ? "case" : "cases"})`
     );
   }
   console.log();
 }
 
 // src/commands/list-apps.ts
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 async function listApps(options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
@@ -1119,20 +1250,20 @@ async function listApps(options) {
     console.log("No apps found.");
     return;
   }
-  console.log(chalk7.bold(`
+  console.log(chalk8.bold(`
   ${apps.length} app(s)
 `));
   for (const app of apps) {
-    const platform = chalk7.dim(` [${app.platform}]`);
-    const pkg2 = chalk7.dim(app.package_name);
-    console.log(`  ${chalk7.cyan(app.public_id)}  ${app.name}${platform}  ${pkg2}`);
-    console.log(chalk7.dim(`    ${baseUrl}/apps/${app.public_id}`));
+    const platform = chalk8.dim(` [${app.platform}]`);
+    const pkg2 = chalk8.dim(app.package_name);
+    console.log(`  ${chalk8.cyan(app.public_id)}  ${app.name}${platform}  ${pkg2}`);
+    console.log(chalk8.dim(`    ${baseUrl}/apps/${app.public_id}`));
   }
   console.log();
 }
 
 // src/commands/stop.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 async function stopCommand(sessionId, opts, deps) {
   const id = sessionId?.trim();
   if (!id) throw new UsageError("a session id is required: vibeview stop <session-id>");
@@ -1143,7 +1274,7 @@ async function stopCommand(sessionId, opts, deps) {
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     if (opts.json) console.log(JSON.stringify({ stopped: false, session_id: id, message }));
-    console.error(chalk8.red(`error: ${message}`));
+    console.error(chalk9.red(`error: ${message}`));
     process.exitCode = errorExitCode(err);
     return;
   }
@@ -1176,7 +1307,7 @@ async function stopCommand(sessionId, opts, deps) {
 }
 
 // src/commands/create-test.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 import { existsSync, readFileSync } from "fs";
 async function readStdin() {
   return new Promise((resolve, reject) => {
@@ -1217,6 +1348,18 @@ async function resolveSteps(options) {
   }
   throw new Error("No steps provided. Use --steps, --steps-file, or pipe JSON to stdin.");
 }
+function assertHasSteps(steps) {
+  if (!Array.isArray(steps)) {
+    throw new Error(
+      `Steps must be a JSON array of instructions, e.g. '["Open the app", "Verify the Home screen shows"]'.`
+    );
+  }
+  if (steps.length === 0) {
+    throw new Error(
+      `A test needs at least one step. Pass a JSON array with one or more instructions, e.g. --steps '["Verify the Home screen shows a list of trips"]'.`
+    );
+  }
+}
 async function resolveAppId(client, appRef, platform) {
   if (appRef.includes(".")) {
     if (!platform) {
@@ -1238,6 +1381,7 @@ async function createTest(options) {
   const client = new ApiClient(baseUrl, token);
   try {
     const steps = await resolveSteps(options);
+    assertHasSteps(steps);
     let appPublicId;
     if (options.app) {
       appPublicId = await resolveAppId(client, options.app, options.platform);
@@ -1271,20 +1415,20 @@ async function createTest(options) {
       );
     } else {
       console.log(`
-  ${chalk9.cyan(result.public_id)}  ${result.name}`);
+  ${chalk10.cyan(result.public_id)}  ${result.name}`);
       if (result.app_name) {
-        console.log(`  ${chalk9.dim(`App: ${result.app_name}`)}`);
+        console.log(`  ${chalk10.dim(`App: ${result.app_name}`)}`);
       }
       if (result.platform) {
-        console.log(`  ${chalk9.dim(`Platform: ${result.platform}`)}`);
+        console.log(`  ${chalk10.dim(`Platform: ${result.platform}`)}`);
       }
-      console.log(`  ${chalk9.dim(`Steps: ${steps.length}`)}`);
-      console.log(chalk9.dim(`  ${baseUrl}/tests?tab=standalone
+      console.log(`  ${chalk10.dim(`Steps: ${steps.length}`)}`);
+      console.log(chalk10.dim(`  ${baseUrl}/tests?tab=standalone
 `));
     }
   } catch (err) {
     if (options.output === "json") printJsonError(err);
-    console.error(chalk9.red(err instanceof Error ? err.message : "Failed to create test"));
+    console.error(chalk10.red(err instanceof Error ? err.message : "Failed to create test"));
     process.exit(
       err instanceof ApiStatusError && err.status === 409 ? EXIT_TEST_FAIL : EXIT_INFRA_ERROR
     );
@@ -1368,7 +1512,7 @@ async function logout() {
 }
 
 // src/commands/dev-status.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 function buildLine(info) {
   if (!info || typeof info.app_build_id !== "number") return null;
   const version = info.app_version ? `  version ${info.app_version}${info.app_build_number ? ` (${info.app_build_number})` : ""}` : "";
@@ -1424,7 +1568,7 @@ async function devStatus(opts) {
     console.error(`  url:      ${state.page_url}`);
     console.error(`  started:  ${state.started_at}`);
   }
-  if (metro) console.error(chalk10.dim(`Metro: pid ${metro.pid} on :${metro.port} (CLI-owned)`));
+  if (metro) console.error(chalk11.dim(`Metro: pid ${metro.pid} on :${metro.port} (CLI-owned)`));
   process.exit(0);
 }
 
@@ -1460,12 +1604,12 @@ async function devStop(opts) {
 }
 
 // src/commands/dev-reload.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 function fail(opts, code, message, exit) {
   if (opts.json) {
     console.log(JSON.stringify({ reloaded: false, code, message }));
   } else {
-    console.error(chalk11.red(`error: ${message}`));
+    console.error(chalk12.red(`error: ${message}`));
   }
   process.exit(exit);
 }
@@ -1518,7 +1662,7 @@ async function devReload(opts) {
     api,
     // Build output and the "reloaded in" line are human output: stderr, so
     // stdout stays reserved for the --json result.
-    log: (line) => console.error(chalk11.dim(line))
+    log: (line) => console.error(chalk12.dim(line))
   });
   const started = Date.now();
   try {
@@ -1539,10 +1683,10 @@ async function devReload(opts) {
 }
 
 // src/commands/builds.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 
 // src/lib/formatters/builds.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var HEADERS = ["ID", "PLATFORM", "STATUS", "CREATED", "COST", "APP"];
 var UNBILLED_STATUSES = /* @__PURE__ */ new Set(["queued", "running"]);
 function formatCostCell(costMicro, status) {
@@ -1550,13 +1694,13 @@ function formatCostCell(costMicro, status) {
   return `$${(Math.max(costMicro, 0) / 1e6).toFixed(2)}`;
 }
 var STATUS_COLOR = {
-  succeeded: chalk12.green,
-  failed: chalk12.red,
-  timed_out: chalk12.red,
-  infra_failed: chalk12.red,
-  canceled: chalk12.dim,
-  running: chalk12.yellow,
-  queued: chalk12.dim
+  succeeded: chalk13.green,
+  failed: chalk13.red,
+  timed_out: chalk13.red,
+  infra_failed: chalk13.red,
+  canceled: chalk13.dim,
+  running: chalk13.yellow,
+  queued: chalk13.dim
 };
 function formatBuildsHuman(builds2) {
   if (builds2.length === 0) {
@@ -1573,7 +1717,7 @@ function formatBuildsHuman(builds2) {
   const widths = HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join4 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk12.bold(join4(padCells(HEADERS)))];
+  const lines = [chalk13.bold(join4(padCells(HEADERS)))];
   for (const row of rows) {
     const padded = padCells(row);
     const colorFn = STATUS_COLOR[row[2]] ?? ((s) => s);
@@ -1632,7 +1776,7 @@ async function buildsLogs(id, opts, deps) {
         console.log(JSON.stringify(logs));
       } else {
         if (logs.content) process.stdout.write(logs.content);
-        console.error(chalk13.dim(`status: ${logs.status}`));
+        console.error(chalk14.dim(`status: ${logs.status}`));
       }
       process.exitCode = 0;
       return;
@@ -1729,7 +1873,7 @@ async function buildsDownload(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk13.green(`\u2713 saved ${result.path}`));
+      console.log(chalk14.green(`\u2713 saved ${result.path}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -1746,7 +1890,7 @@ async function buildsCancel(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(build));
     } else {
-      console.log(`${chalk13.cyan(build.id)}  ${build.status}`);
+      console.log(`${chalk14.cyan(build.id)}  ${build.status}`);
     }
     process.exitCode = 0;
   } catch (err) {
@@ -1763,7 +1907,7 @@ async function buildsDeleteArtifact(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk13.green(`\u2713 deleted artifact for ${id}`));
+      console.log(chalk14.green(`\u2713 deleted artifact for ${id}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -1774,11 +1918,11 @@ async function buildsDeleteArtifact(id, opts, deps) {
 function printError(opts, err) {
   const message = err instanceof Error ? err.message : String(err);
   if (opts.json) console.log(JSON.stringify({ event: "error", message }));
-  console.error(chalk13.red(`error: ${message}`));
+  console.error(chalk14.red(`error: ${message}`));
 }
 
 // src/commands/submit.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 function defaultDeps2(client) {
   return {
     createSubmission: client.createSubmission.bind(client),
@@ -1802,7 +1946,7 @@ function submitConfigFor(cwd, platform) {
     cfg = loadDevConfig(cwd);
   } catch (err) {
     console.error(
-      chalk14.yellow(
+      chalk15.yellow(
         `warning: vibeview.json could not be read \u2014 ignoring submit defaults (${err instanceof Error ? err.message : String(err)})`
       )
     );
@@ -1950,12 +2094,12 @@ async function submitCommand(opts, deps) {
       return;
     }
     if (!opts.json) {
-      console.error(`  ${chalk14.cyan(sub.id)}  ${chalk14.dim(`[${sub.platform}]`)}`);
+      console.error(`  ${chalk15.cyan(sub.id)}  ${chalk15.dim(`[${sub.platform}]`)}`);
     }
     const final = await followSubmission(sub, opts, d);
     if (!opts.json && final.status === "succeeded" && (final.release_status ?? releaseStatus) === "draft") {
       console.error(
-        chalk14.dim("release status: draft \u2014 activate it from the Play Console when ready")
+        chalk15.dim("release status: draft \u2014 activate it from the Play Console when ready")
       );
     }
     process.exitCode = final.status === "succeeded" ? 0 : 1;
@@ -1986,11 +2130,11 @@ async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
     });
     emit(opts.json, { event: "preflight", ...result });
     if (!opts.json) {
-      const mark = result.ready ? chalk14.green("\u2713") : chalk14.red("\u2717");
+      const mark = result.ready ? chalk15.green("\u2713") : chalk15.red("\u2717");
       console.error(`${mark} ${result.message}`);
       if (result.ready) {
         console.error(
-          chalk14.dim(
+          chalk15.dim(
             `  next: vibeview build --cloud --production --platform ${platform}, then vibeview submit --platform ${platform} --latest`
           )
         );
@@ -2024,7 +2168,7 @@ async function linkedIdentifier(platform, opts, deps) {
   }
   if (!app.package_name) return void 0;
   if (!opts.json) {
-    console.error(chalk14.dim(`Checking ${app.package_name} (${app.name}, linked in vibeview.json)`));
+    console.error(chalk15.dim(`Checking ${app.package_name} (${app.name}, linked in vibeview.json)`));
   }
   return app.package_name;
 }
@@ -2065,14 +2209,14 @@ async function followSubmission(created, opts, deps) {
         if (opts.json) {
           emit(opts.json, { event: "status", id: created.id, status: "queued" });
         } else {
-          console.error(chalk14.dim("\u23F3 queued \u2014 waiting for a submission slot"));
+          console.error(chalk15.dim("\u23F3 queued \u2014 waiting for a submission slot"));
         }
       } else if (log.status === "running" && !printedRunning) {
         printedRunning = true;
         if (opts.json) {
           emit(opts.json, { event: "status", id: created.id, status: "running" });
         } else {
-          console.error(`${chalk14.cyan("\u25B6")} submitting`);
+          console.error(`${chalk15.cyan("\u25B6")} submitting`);
         }
       }
       if (log.content) {
@@ -2114,7 +2258,7 @@ The submission continues server-side \u2014 see its outcome on the Builds page i
   });
   if (!opts.json) {
     const ok = final.status === "succeeded";
-    const mark = ok ? chalk14.green("\u2713") : chalk14.red("\u2717");
+    const mark = ok ? chalk15.green("\u2713") : chalk15.red("\u2717");
     const duration = formatDuration(final.started_at, final.finished_at);
     let line = `${mark} ${final.status}`;
     if (duration) line += ` (${duration})`;
@@ -2126,11 +2270,11 @@ The submission continues server-side \u2014 see its outcome on the Builds page i
 function printError2(opts, err) {
   const message = err instanceof Error ? err.message : String(err);
   if (opts.json) console.log(JSON.stringify({ event: "error", message }));
-  console.error(chalk14.red(`error: ${message}`));
+  console.error(chalk15.red(`error: ${message}`));
 }
 
 // src/commands/versions.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 function defaultDeps3(client) {
   return {
     listAppVersions: client.listAppVersions.bind(client),
@@ -2180,7 +2324,7 @@ async function versionsSet(buildNumber, opts, deps) {
       console.log(JSON.stringify(version));
     } else {
       console.log(
-        chalk15.green(`\u2713 ${version.platform} build number set to ${version.build_number}`) + chalk15.dim(
+        chalk16.green(`\u2713 ${version.platform} build number set to ${version.build_number}`) + chalk16.dim(
           " \u2014 the next autoIncrement production build gets " + (version.build_number + 1)
         )
       );
@@ -2200,18 +2344,18 @@ function formatVersionsHuman(versions2) {
   const widths = HEADERS2.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join4 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk15.bold(join4(padCells(HEADERS2)))];
+  const lines = [chalk16.bold(join4(padCells(HEADERS2)))];
   for (const row of rows) lines.push(join4(padCells(row)));
   return lines.join("\n") + "\n";
 }
 function printError3(opts, err) {
   const message = err instanceof Error ? err.message : String(err);
   if (opts.json) console.log(JSON.stringify({ event: "error", message }));
-  console.error(chalk15.red(`error: ${message}`));
+  console.error(chalk16.red(`error: ${message}`));
 }
 
 // src/commands/whoami.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 function defaultDeps4(opts) {
   const { token, baseUrl } = resolveAuth(opts);
   const client = new ApiClient(baseUrl, token);
@@ -2223,6 +2367,15 @@ function effectiveRole(role, tokenRole) {
   if (!tokenRole) return role;
   return (RANK[tokenRole] ?? 3) < (RANK[role] ?? 3) ? tokenRole : role;
 }
+function describeExpiry(expiresAt, now = /* @__PURE__ */ new Date()) {
+  if (!expiresAt) return "never";
+  const when = new Date(expiresAt);
+  if (Number.isNaN(when.getTime())) return expiresAt;
+  const date = when.toISOString().slice(0, 10);
+  const days = Math.ceil((when.getTime() - now.getTime()) / 864e5);
+  if (days <= 0) return `${date} (expired)`;
+  return `${date} (in ${days} day${days === 1 ? "" : "s"})`;
+}
 async function whoAmI(opts, deps) {
   const d = deps ?? defaultDeps4(opts);
   try {
@@ -2233,27 +2386,33 @@ async function whoAmI(opts, deps) {
       process.exitCode = 0;
       return;
     }
-    console.log(`${chalk16.bold("Logged in as")}  ${me.email}`);
+    console.log(`${chalk17.bold("Logged in as")}  ${me.email}`);
     if (me.memberships.length === 1) {
-      console.log(`${chalk16.bold("Organization")}   ${me.memberships[0].organization_name}`);
+      console.log(`${chalk17.bold("Organization")}   ${me.memberships[0].organization_name}`);
     } else if (me.memberships.length > 1) {
-      console.log(chalk16.bold("Organizations"));
+      console.log(chalk17.bold("Organizations"));
       for (const m of me.memberships) {
         console.log(`  ${m.organization_name} (${m.role})`);
       }
     }
-    console.log(`${chalk16.bold("Member role")}    ${me.role ?? "\u2014"}`);
-    console.log(`${chalk16.bold("Token role")}     ${me.token_role ?? "\u2014 (session auth)"}`);
-    console.log(`${chalk16.bold("Effective role")} ${effective ?? "\u2014"}`);
+    console.log(`${chalk17.bold("Member role")}    ${me.role ?? "\u2014"}`);
+    console.log(`${chalk17.bold("Token role")}     ${me.token_role ?? "\u2014 (session auth)"}`);
+    console.log(`${chalk17.bold("Effective role")} ${effective ?? "\u2014"}`);
+    if (me.token_access) {
+      console.log(
+        `${chalk17.bold("Access")}         ${me.token_access === "ci" ? "CI only (upload builds, run tests, read results)" : "Full access"}`
+      );
+      console.log(`${chalk17.bold("Expires")}        ${describeExpiry(me.token_expires_at)}`);
+    }
     if (me.is_superadmin) {
-      console.log(chalk16.dim("Superadmin (platform-wide; does not raise the org role above)"));
+      console.log(chalk17.dim("Superadmin (platform-wide; does not raise the org role above)"));
     }
-    if (me.role === "admin" && me.token_role && me.token_role !== "admin") {
+    if (me.role === "admin" && me.token_role && me.token_role !== "admin" && me.token_access !== "ci") {
       console.log(
-        chalk16.yellow(
+        chalk17.yellow(
           `
-Your account is admin, but this CLI token is ${me.token_role}. The effective role is the lower of the two, so admin-only commands (such as ${chalk16.bold("vibeview env set")}) will fail with a permissions error.
-Create an admin API token in the dashboard and use ${chalk16.bold("--token")} or ${chalk16.bold("VIBEVIEW_API_TOKEN")}.`
+Your account is admin, but this CLI token is ${me.token_role}. The effective role is the lower of the two, so admin-only commands (such as ${chalk17.bold("vibeview env set")}) will fail with a permissions error.
+Create an admin API token in the dashboard and use ${chalk17.bold("--token")} or ${chalk17.bold("VIBEVIEW_API_TOKEN")}.`
         )
       );
     }
@@ -2263,7 +2422,7 @@ Create an admin API token in the dashboard and use ${chalk16.bold("--token")} or
     if (opts.json) {
       console.log(JSON.stringify({ event: "error", message }));
     }
-    console.error(chalk16.red(`error: ${message}`));
+    console.error(chalk17.red(`error: ${message}`));
     process.exitCode = errorExitCode(err);
   }
 }
@@ -2271,7 +2430,7 @@ Create an admin API token in the dashboard and use ${chalk16.bold("--token")} or
 // src/commands/env.ts
 import { chmod, open as open2, readFile as readFileAsync } from "fs/promises";
 import { basename } from "path";
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 import { password } from "@inquirer/prompts";
 
 // src/lib/gitignore.ts
@@ -2327,7 +2486,7 @@ function defaultDeps5(client) {
     isIgnored: (path) => isGitIgnored(path),
     writeFile: writeSecureFile,
     readFile: (path) => readFileAsync(path),
-    warn: (message) => console.error(chalk17.yellow(`warning: ${message}`))
+    warn: (message) => console.error(chalk18.yellow(`warning: ${message}`))
   };
 }
 async function envList(opts, deps) {
@@ -2359,7 +2518,7 @@ function formatEnvVarsHuman(variables) {
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join4 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk17.bold(join4(padCells(HEADERS3)))];
+  const lines = [chalk18.bold(join4(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join4(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2409,7 +2568,7 @@ function printSetResult(opts, result) {
   if (opts.json) {
     console.log(JSON.stringify(result));
   } else {
-    console.log(chalk17.green(`\u2713 set ${result.name} (${result.visibility})`));
+    console.log(chalk18.green(`\u2713 set ${result.name} (${result.visibility})`));
   }
 }
 async function envRm(name, opts, deps) {
@@ -2419,7 +2578,7 @@ async function envRm(name, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", name }));
     } else {
-      console.log(chalk17.green(`\u2713 removed ${name}`));
+      console.log(chalk18.green(`\u2713 removed ${name}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2451,7 +2610,7 @@ async function envPull(opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "pulled", path: outPath, count: variables.length }));
     } else {
-      console.log(chalk17.green(`\u2713 wrote ${variables.length} variable(s) to ${outPath}`));
+      console.log(chalk18.green(`\u2713 wrote ${variables.length} variable(s) to ${outPath}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2490,7 +2649,7 @@ function escapeEnvValue(value) {
 function printError4(opts, err) {
   const message = err instanceof Error ? err.message : String(err);
   if (opts.json) console.log(JSON.stringify({ event: "error", message }));
-  console.error(chalk17.red(`error: ${message}`));
+  console.error(chalk18.red(`error: ${message}`));
 }
 
 // src/commands/credentials.ts
@@ -2502,7 +2661,7 @@ import {
 } from "fs/promises";
 import { mkdirSync } from "fs";
 import { basename as basename2, extname, join } from "path";
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 import { input, password as password2 } from "@inquirer/prompts";
 function clientFor2(opts) {
   const { token, baseUrl } = resolveAuth(opts);
@@ -2575,7 +2734,7 @@ function defaultDeps6(client) {
     mkdir: (dir) => mkdirSync(dir, { recursive: true }),
     writeFile: (path, data, mode) => writeFileAsync(path, data, mode !== void 0 ? { mode } : void 0),
     chmod: (path, mode) => chmodAsync(path, mode),
-    warn: (message) => console.error(chalk18.yellow(`warning: ${message}`))
+    warn: (message) => console.error(chalk19.yellow(`warning: ${message}`))
   };
 }
 var ANDROID_KIND = "android_keystore";
@@ -2644,7 +2803,7 @@ async function credentialsAdd(opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk18.green(`\u2713 added ${result.name} (${result.platform})`));
+      console.log(chalk19.green(`\u2713 added ${result.name} (${result.platform})`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2702,20 +2861,20 @@ async function credentialsGenerate(opts, deps) {
     }
     if (opts.json) {
     } else {
-      console.log(chalk18.green(`\u2713 generated ${result.name} (android)`));
+      console.log(chalk19.green(`\u2713 generated ${result.name} (android)`));
       console.log("");
-      console.log(`  Keystore saved to: ${chalk18.bold(savedTo)}`);
-      console.log(`  Key alias:         ${chalk18.bold(result.key_alias)}`);
-      console.log(`  Store password:    ${chalk18.bold(result.store_password)}`);
-      console.log(`  Key password:      ${chalk18.bold(result.key_password)}`);
+      console.log(`  Keystore saved to: ${chalk19.bold(savedTo)}`);
+      console.log(`  Key alias:         ${chalk19.bold(result.key_alias)}`);
+      console.log(`  Store password:    ${chalk19.bold(result.store_password)}`);
+      console.log(`  Key password:      ${chalk19.bold(result.key_password)}`);
       console.log("");
       console.log(
-        chalk18.yellow(
+        chalk19.yellow(
           "  These are shown ONCE \u2014 VibeView cannot recover the keystore file or its passwords. Back them up somewhere safe."
         )
       );
       console.log(
-        chalk18.yellow(
+        chalk19.yellow(
           "  The credential is already uploaded and active for android and androidtv production builds."
         )
       );
@@ -2741,19 +2900,19 @@ async function generateAppleCredential(platform, opts, d) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk18.green(`\u2713 generated ${result.name} (${result.platform})`));
+      console.log(chalk19.green(`\u2713 generated ${result.name} (${result.platform})`));
       console.log("");
-      console.log(`  Scope:   ${chalk18.bold(result.app_public_id ?? "org-wide")}`);
+      console.log(`  Scope:   ${chalk19.bold(result.app_public_id ?? "org-wide")}`);
       const expires = formatExpires(result);
       if (expires) {
-        console.log(`  Expires: ${chalk18.bold(expires)}`);
+        console.log(`  Expires: ${chalk19.bold(expires)}`);
       }
       console.log("");
       console.log(
         `  The certificate and provisioning profile are stored with VibeView and already active for ${result.platform} production builds.`
       );
       console.log(
-        `  Run ${chalk18.bold(`vibeview credentials download ${result.name}`)} if you need the files locally.`
+        `  Run ${chalk19.bold(`vibeview credentials download ${result.name}`)} if you need the files locally.`
       );
     }
     process.exitCode = 0;
@@ -2819,17 +2978,17 @@ async function credentialsDownload(name, opts, deps) {
       await d.chmod(path, 384);
     }
     if (!opts.json) {
-      console.log(chalk18.green(`\u2713 downloaded ${material.name} (${material.platform})`));
+      console.log(chalk19.green(`\u2713 downloaded ${material.name} (${material.platform})`));
       console.log("");
-      console.log(`  Saved to: ${chalk18.bold(savedTo)}`);
+      console.log(`  Saved to: ${chalk19.bold(savedTo)}`);
       if (profileSavedTo !== null) {
-        console.log(`  Profile:  ${chalk18.bold(profileSavedTo)}`);
+        console.log(`  Profile:  ${chalk19.bold(profileSavedTo)}`);
       }
       for (const [key, value] of Object.entries(material.passwords)) {
-        console.log(`  ${key}: ${chalk18.bold(value)}`);
+        console.log(`  ${key}: ${chalk19.bold(value)}`);
       }
       console.log("");
-      console.log(chalk18.yellow("  This download is recorded in your organization's audit log."));
+      console.log(chalk19.yellow("  This download is recorded in your organization's audit log."));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2860,13 +3019,13 @@ async function ascKeyAdd(opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk18.green(`\u2713 added App Store Connect key ${result.name}`));
+      console.log(chalk19.green(`\u2713 added App Store Connect key ${result.name}`));
       console.log("");
-      console.log(`  Key ID:    ${chalk18.bold(result.key_id)}`);
-      console.log(`  Issuer ID: ${chalk18.bold(result.issuer_id)}`);
+      console.log(`  Key ID:    ${chalk19.bold(result.key_id)}`);
+      console.log(`  Issuer ID: ${chalk19.bold(result.issuer_id)}`);
       console.log("");
       console.log(
-        chalk18.yellow(
+        chalk19.yellow(
           "  The .p8 is stored encrypted and will never be shown again \u2014 keep your own copy somewhere safe."
         )
       );
@@ -2901,7 +3060,7 @@ function formatAscKeysHuman(keys) {
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join4 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk18.bold(join4(padCells(HEADERS3)))];
+  const lines = [chalk19.bold(join4(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join4(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2912,7 +3071,7 @@ async function ascKeyRm(name, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", name }));
     } else {
-      console.log(chalk18.green(`\u2713 removed App Store Connect key ${name}`));
+      console.log(chalk19.green(`\u2713 removed App Store Connect key ${name}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2937,12 +3096,12 @@ async function playKeyAdd(opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk18.green(`\u2713 added Google Play key ${result.name}`));
+      console.log(chalk19.green(`\u2713 added Google Play key ${result.name}`));
       console.log("");
-      console.log(`  Service account: ${chalk18.bold(result.client_email)}`);
+      console.log(`  Service account: ${chalk19.bold(result.client_email)}`);
       console.log("");
       console.log(
-        chalk18.yellow(
+        chalk19.yellow(
           "  The JSON key is stored encrypted and will never be shown again \u2014 keep your own copy somewhere safe."
         )
       );
@@ -2977,7 +3136,7 @@ function formatPlayKeysHuman(keys) {
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join4 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk18.bold(join4(padCells(HEADERS3)))];
+  const lines = [chalk19.bold(join4(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join4(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2988,7 +3147,7 @@ async function playKeyRm(name, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", name }));
     } else {
-      console.log(chalk18.green(`\u2713 removed Google Play key ${name}`));
+      console.log(chalk19.green(`\u2713 removed Google Play key ${name}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3057,7 +3216,7 @@ function formatCredentialsHuman(credentials2) {
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join4 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk18.bold(join4(padCells(HEADERS3)))];
+  const lines = [chalk19.bold(join4(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join4(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -3068,7 +3227,7 @@ async function credentialsRm(name, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", name }));
     } else {
-      console.log(chalk18.green(`\u2713 removed ${name}`));
+      console.log(chalk19.green(`\u2713 removed ${name}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3080,16 +3239,16 @@ function printKeystoreWriteFailure(opts, err, result) {
   const message = err instanceof Error ? err.message : String(err);
   if (opts.json) {
     console.log(JSON.stringify({ event: "error", message }));
-    console.error(chalk18.red(`error: ${message}`));
+    console.error(chalk19.red(`error: ${message}`));
     return;
   }
-  console.error(chalk18.red(`error: ${message}`));
+  console.error(chalk19.red(`error: ${message}`));
   console.error(
-    chalk18.red(
+    chalk19.red(
       `The keystore could NOT be saved locally, but the credential "${result.name}" WAS created server-side and its key material can never be re-fetched.`
     )
   );
-  console.error(chalk18.red("Recover it NOW from the values below \u2014 they will not be shown again:"));
+  console.error(chalk19.red("Recover it NOW from the values below \u2014 they will not be shown again:"));
   console.error("");
   console.error(`  Key alias:         ${result.key_alias}`);
   console.error(`  Store password:    ${result.store_password}`);
@@ -3103,11 +3262,11 @@ function printKeystoreWriteFailure(opts, err, result) {
 function printError5(opts, err) {
   const message = err instanceof Error ? err.message : String(err);
   if (opts.json) console.log(JSON.stringify({ event: "error", message }));
-  console.error(chalk18.red(`error: ${message}`));
+  console.error(chalk19.red(`error: ${message}`));
 }
 
 // src/commands/webhooks.ts
-import chalk19 from "chalk";
+import chalk20 from "chalk";
 function clientFor3(opts) {
   const { token, baseUrl } = resolveAuth(opts);
   return new ApiClient(baseUrl, token);
@@ -3138,14 +3297,14 @@ async function webhooksAdd(opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk19.green(`\u2713 added ${result.id} ${result.url}`));
+      console.log(chalk20.green(`\u2713 added ${result.id} ${result.url}`));
       console.log("");
-      console.log(`  Signing secret: ${chalk19.bold(result.secret)}`);
+      console.log(`  Signing secret: ${chalk20.bold(result.secret)}`);
       if (opts.secret !== void 0) {
-        console.log(chalk19.yellow("  (This is the secret you provided.)"));
+        console.log(chalk20.yellow("  (This is the secret you provided.)"));
       }
       console.log(
-        chalk19.yellow("  This secret is shown ONCE and cannot be retrieved again \u2014 store it now.")
+        chalk20.yellow("  This secret is shown ONCE and cannot be retrieved again \u2014 store it now.")
       );
     }
     process.exitCode = 0;
@@ -3176,7 +3335,7 @@ function formatWebhooksHuman(webhooks2) {
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join4 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk19.bold(join4(padCells(HEADERS3)))];
+  const lines = [chalk20.bold(join4(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join4(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -3202,7 +3361,7 @@ async function webhooksRm(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", id }));
     } else {
-      console.log(chalk19.green(`\u2713 removed ${id}`));
+      console.log(chalk20.green(`\u2713 removed ${id}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3235,13 +3394,13 @@ async function webhooksTest(id, opts, deps) {
         if (opts.json) console.log(JSON.stringify(ld));
         if (ld.status === "succeeded") {
           if (!opts.json) {
-            console.log(chalk19.green(`\u2713 Delivered (HTTP ${ld.response_code})`));
+            console.log(chalk20.green(`\u2713 Delivered (HTTP ${ld.response_code})`));
           }
           process.exitCode = 0;
         } else {
           if (!opts.json) {
             const code = ld.response_code != null ? `HTTP ${ld.response_code}` : "no response";
-            console.error(chalk19.red(`\u2717 Failed (${code}) at ${formatUtcTimestamp(ld.at)}`));
+            console.error(chalk20.red(`\u2717 Failed (${code}) at ${formatUtcTimestamp(ld.at)}`));
           }
           process.exitCode = 1;
         }
@@ -3250,7 +3409,7 @@ async function webhooksTest(id, opts, deps) {
     }
     if (opts.json) console.log(JSON.stringify({ status: "pending" }));
     console.error(
-      chalk19.yellow(
+      chalk20.yellow(
         `Delivery still pending after ${TEST_POLL_BUDGET_MS / 1e3}s \u2014 check \`vibeview webhooks list\` later for the result.`
       )
     );
@@ -3263,7 +3422,7 @@ async function webhooksTest(id, opts, deps) {
 function printError6(opts, err) {
   const message = err instanceof Error ? err.message : String(err);
   if (opts.json) console.log(JSON.stringify({ event: "error", message }));
-  console.error(chalk19.red(`error: ${message}`));
+  console.error(chalk20.red(`error: ${message}`));
 }
 
 // src/commands/list-devices.ts
@@ -3361,7 +3520,7 @@ import { dirname, join as join2 } from "path";
 import { fileURLToPath } from "url";
 import { spawnSync } from "child_process";
 import { confirm } from "@inquirer/prompts";
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 function resolveShippedSkillPath(fromDir) {
   for (const rel of ["..", join2("..", "..")]) {
     const candidate = join2(fromDir, rel, "skills", "vibeview-agent", "SKILL.md");
@@ -3389,23 +3548,23 @@ function registerMcp() {
     encoding: "utf8"
   });
   if (res.status === 0) {
-    console.log(chalk20.green("\u2713 MCP server registered with Claude Code (claude mcp add vibeview)"));
+    console.log(chalk21.green("\u2713 MCP server registered with Claude Code (claude mcp add vibeview)"));
     return;
   }
   const out = `${res.stderr ?? ""}${res.stdout ?? ""}`;
   if (out.includes("already exists")) {
-    console.log(chalk20.dim("MCP server already registered with Claude Code \u2014 nothing to do"));
+    console.log(chalk21.dim("MCP server already registered with Claude Code \u2014 nothing to do"));
     return;
   }
-  console.error(chalk20.yellow(`\u26A0 could not register the MCP server: ${out.trim() || res.error}`));
-  console.error(chalk20.yellow("  register it manually: claude mcp add vibeview -- vibeview mcp"));
+  console.error(chalk21.yellow(`\u26A0 could not register the MCP server: ${out.trim() || res.error}`));
+  console.error(chalk21.yellow("  register it manually: claude mcp add vibeview -- vibeview mcp"));
 }
 async function agentSetup(opts) {
   const moduleDir = dirname(fileURLToPath(import.meta.url));
   const shipped = resolveShippedSkillPath(moduleDir);
   if (!shipped) {
     console.error(
-      chalk20.red(
+      chalk21.red(
         "error: could not find the packaged skill (skills/vibeview-agent/SKILL.md) \u2014 is this a complete install of the vibeview package?"
       )
     );
@@ -3414,9 +3573,9 @@ async function agentSetup(opts) {
   }
   const targetDir = skillInstallDir(opts.project ?? false, process.cwd(), homedir());
   const result = installSkill(shipped, targetDir);
-  console.log(chalk20.green(`\u2713 vibeview-agent skill ${result}: ${join2(targetDir, "SKILL.md")}`));
+  console.log(chalk21.green(`\u2713 vibeview-agent skill ${result}: ${join2(targetDir, "SKILL.md")}`));
   console.log(
-    chalk20.dim(
+    chalk21.dim(
       opts.project ? "  Claude Code discovers it automatically for anyone working in this project." : "  Claude Code discovers it automatically in every project on this machine."
     )
   );
@@ -3424,7 +3583,7 @@ async function agentSetup(opts) {
     if (!claudeCliAvailable()) {
       if (opts.mcp === true) {
         console.error(
-          chalk20.yellow(
+          chalk21.yellow(
             "\u26A0 claude CLI not found \u2014 install Claude Code, then run: claude mcp add vibeview -- vibeview mcp"
           )
         );
@@ -3438,7 +3597,7 @@ async function agentSetup(opts) {
   }
   console.log(
     `
-Suggested line for your project's ${chalk20.bold("CLAUDE.md")} (or ${chalk20.bold(
+Suggested line for your project's ${chalk21.bold("CLAUDE.md")} (or ${chalk21.bold(
       "AGENTS.md"
     )} for other agents):
 `
@@ -3446,7 +3605,7 @@ Suggested line for your project's ${chalk20.bold("CLAUDE.md")} (or ${chalk20.bol
   console.log(`  ${CLAUDE_MD_SUGGESTION}
 `);
   console.log(
-    chalk20.dim(
+    chalk21.dim(
       "Other agents (Cursor, Copilot, Codex, ...): install the same skill from GitHub with\n  npx skills add vibeview/skills\nor point them at the skill file above, or add the MCP server per client \u2014\nsee https://vibeview.io/docs/agent-control"
     )
   );
@@ -3568,11 +3727,25 @@ program.command("run-suite <suite-id>").description("Run all test cases in a sui
 ).option(
   "--device <device_id>",
   "Pin run to a specific device (use `vibeview list-devices` to find one). Conflicts with --device-category."
+).option(
+  "--platform <platform>",
+  "Run the suite on another platform (ios, android, tvos, androidtv): runs your app there with the same bundle id / package"
+).option(
+  "--app <app-id>",
+  "Run the suite against this app instead of its own (e.g. another platform build with a different bundle id)"
 ).option("--build <id>", "Specific AppBuild id to run against (defaults to latest)").option("--metadata <json>", "JSON object passed through to webhooks (e.g. PR context)").option("--metadata-file <path>", "Read JSON object from a file (use for nested JSON in CI)").action((suiteId, opts) => {
   if (opts.device && opts.deviceCategory) {
     process.stderr.write("error: --device cannot be combined with --device-category\n");
     process.exit(2);
   }
+  try {
+    parseRunPlatform(opts.platform);
+    refusePlatformWithApp(opts);
+  } catch (err) {
+    process.stderr.write(`error: ${err.message}
+`);
+    process.exit(2);
+  }
   const metadata = resolveMetadata(opts);
   return runSuite(suiteId, {
     ...opts,
@@ -3601,6 +3774,13 @@ program.command("run-suites").description("Run all suites matching a tag filter"
     process.stderr.write("error: --device cannot be combined with --device-category\n");
     process.exit(2);
   }
+  try {
+    parseRunPlatform(opts.platform);
+  } catch (err) {
+    process.stderr.write(`error: ${err.message}
+`);
+    process.exit(2);
+  }
   const metadata = resolveMetadata(opts);
   return runSuites({
     ...opts,
@@ -3616,11 +3796,25 @@ program.command("run-test <test-id>").description("Run a single test case").opti
 ).option(
   "--device <device_id>",
   "Pin run to a specific device (use `vibeview list-devices` to find one). Conflicts with --device-category."
+).option(
+  "--platform <platform>",
+  "Run the test on another platform (ios, android, tvos, androidtv): runs your app there with the same bundle id / package"
+).option(
+  "--app <app-id>",
+  "Run the test against this app instead of its own (e.g. another platform build with a different bundle id)"
 ).option("--build <id>", "Specific AppBuild id to run against (defaults to latest)").option("--metadata <json>", "JSON object passed through to webhooks (e.g. PR context)").option("--metadata-file <path>", "Read JSON object from a file (use for nested JSON in CI)").action((testId, opts) => {
   if (opts.device && opts.deviceCategory) {
     process.stderr.write("error: --device cannot be combined with --device-category\n");
     process.exit(2);
   }
+  try {
+    parseRunPlatform(opts.platform);
+    refusePlatformWithApp(opts);
+  } catch (err) {
+    process.stderr.write(`error: ${err.message}
+`);
+    process.exit(2);
+  }
   const metadata = resolveMetadata(opts);
   return runTest(testId, {
     ...opts,
@@ -3669,7 +3863,10 @@ program.command("dev").description(
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--web-url <url>", "Dashboard URL if different from the API URL (local dev)").option(
   "--platform <platform>",
   "ios, android, tvos, androidtv, or roku (first run is interactive otherwise)"
-).option("--app <app_id>", "Uploaded debug build to run (see `vibeview list-apps`)").option("--metro-port <port>", "Local Metro port (default: 8081, remembered in vibeview.json)").option(
+).option("--app <app_id>", "Uploaded debug build to run (see `vibeview list-apps`)").option(
+  "--metro-port <port>",
+  "Local Metro port (default: 8081, or vibeview.json); remembered for you in .vibeview/local.json"
+).option(
   "--device-category <category>",
   "phone or tablet (default: phone; TV platforms always use tv)",
   parseDeviceCategory
@@ -3831,7 +4028,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-IGY2VPYT.js");
+  const { runMcpServer } = await import("./server-GPFOZOFL.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(