vibeview 0.37.1 → 0.39.0

package/dist/cli.js

@@ -15,6 +15,9 @@ import {
   listBuilds,
   loadDevConfig,
   newTransitionState,
+  notCheckedSteps,
+  notCheckedSuffix,
+  outcomeOf,
   platformLabel,
   platformWithArticle,
   pressButtonsHelp,
@@ -24,8 +27,10 @@ import {
   readDevStateFile,
   readMetroState,
   recordDevUse,
-  runAgentVerb
-} from "./chunk-NJ2IXB5H.js";
+  runAgentVerb,
+  runStepsNotChecked,
+  stepsNotCheckedLabel
+} from "./chunk-EQN3X62U.js";
 import {
   ApiClient,
   ApiStatusError,
@@ -46,7 +51,7 @@ import {
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-QRJAFBH3.js";
+} from "./chunk-MYXUGCR5.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -61,21 +66,6 @@ import chalk2 from "chalk";
 // src/lib/formatters/human.ts
 import chalk from "chalk";
 
-// src/lib/formatters/not-checked.ts
-function notCheckedSteps(steps) {
-  return (steps ?? []).filter((s) => s.status === "not_checked");
-}
-function runStepsNotChecked(result) {
-  if (typeof result.steps_not_checked === "number") return result.steps_not_checked;
-  return notCheckedSteps(result.steps).length;
-}
-function stepsNotCheckedLabel(n) {
-  return `${n} step${n === 1 ? "" : "s"} not checked`;
-}
-function notCheckedSuffix(status, n) {
-  return status === "passed" && n && n > 0 ? ` (${stepsNotCheckedLabel(n)})` : "";
-}
-
 // src/lib/formatters/cases.ts
 function resultCases(result) {
   if (Array.isArray(result.test_runs)) return result.test_runs;
@@ -90,6 +80,9 @@ function resultCases(result) {
       error_kind_description: failedStep?.error_kind_description ?? null,
       screenshot_signed_url: failedStep?.screenshot_signed_url ?? null,
       url: result.url,
+      quarantined: result.quarantined,
+      not_checked: result.not_checked,
+      not_run: result.not_run,
       steps_not_checked: runStepsNotChecked(result),
       not_checked_steps: notCheckedSteps(result.steps).map((s) => ({
         step: s.step,
@@ -117,19 +110,21 @@ function failureLines(failure) {
 }
 function formatHuman(result, verbose) {
   const lines = [];
-  const icon = result.status === "passed" ? chalk.green("PASS") : chalk.red("FAIL");
+  const outcome = outcomeOf(result);
+  const icon = outcome === "not_checked" ? chalk.gray("NOT CHECKED") : result.status === "passed" ? chalk.green("PASS") : result.status === "failed" && result.quarantined === true ? chalk.yellow("FAIL (quarantined)") : chalk.red("FAIL");
   const duration = result.duration_ms ? `${(result.duration_ms / 1e3).toFixed(1)}s` : "-";
   lines.push("");
   const title = result.suite_name || result.case_name || result.run_id;
   const cases = resultCases(result);
   const notChecked = cases.reduce((n, t) => n + (t.steps_not_checked ?? 0), 0);
-  const runSuffix = notCheckedSuffix(result.status, notChecked);
+  const runSuffix = notCheckedSuffix(outcome, notChecked);
   lines.push(
     `  ${icon}${runSuffix ? chalk.yellow(runSuffix) : ""}  ${chalk.bold(title)}  ${chalk.dim(duration)}`
   );
-  const passed = cases.filter((t) => t.status === "passed").length;
+  const passed = cases.filter((t) => outcomeOf(t) === "passed").length;
+  const notCheckedCases = cases.filter((t) => outcomeOf(t) === "not_checked").length;
   const total = cases.length;
-  const notCheckedNote = notChecked > 0 ? `, ${stepsNotCheckedLabel(notChecked)}` : "";
+  const notCheckedNote = notCheckedCases > 0 ? `, ${notCheckedCases} not checked` : notChecked > 0 ? `, ${stepsNotCheckedLabel(notChecked)}` : "";
   lines.push(`  ${chalk.dim(`${passed}/${total} cases passed${notCheckedNote}`)}`);
   if (result.url) {
     lines.push(`  ${chalk.dim(result.url)}`);
@@ -138,16 +133,19 @@ function formatHuman(result, verbose) {
   if (suiteCases.length > 0) {
     lines.push("");
     for (const tr of suiteCases) {
-      const caseIcon = tr.status === "passed" ? chalk.green("  PASS") : tr.status === "cancelled" || tr.status === "pending" || tr.status === "running" ? chalk.yellow("  SKIP") : chalk.red("  FAIL");
+      const caseOutcome = outcomeOf(tr);
+      const caseIcon = caseOutcome === "not_checked" ? chalk.gray("  NOT CHECKED") : caseOutcome === "not_run" ? chalk.gray("  NOT RUN") : tr.status === "passed" ? chalk.green("  PASS") : tr.status === "failed" && tr.quarantined === true ? chalk.yellow("  FAIL (quarantined)") : tr.status === "cancelled" || tr.status === "pending" || tr.status === "running" ? chalk.yellow("  SKIP") : chalk.red("  FAIL");
       const caseDuration = tr.duration_ms ? `${(tr.duration_ms / 1e3).toFixed(1)}s` : "-";
-      const caseSuffix = notCheckedSuffix(tr.status, tr.steps_not_checked);
+      const caseSuffix = notCheckedSuffix(caseOutcome, tr.steps_not_checked);
       lines.push(
         `  ${caseIcon}${caseSuffix ? chalk.yellow(caseSuffix) : ""}  ${tr.case_name}  ${chalk.dim(caseDuration)}`
       );
       if (tr.url) {
         lines.push(`        ${chalk.dim(tr.url)}`);
       }
-      if (tr.status !== "passed") {
+      if (caseOutcome === "not_checked" || caseOutcome === "not_run") {
+        if (tr.error_message) lines.push(`        ${chalk.dim(tr.error_message)}`);
+      } else if (tr.status !== "passed") {
         lines.push(...failureLines(tr));
       }
     }
@@ -173,7 +171,10 @@ function formatHuman(result, verbose) {
       }
     }
   }
-  if (result.error_message) {
+  if (result.error_message && outcome === "not_checked") {
+    lines.push(`
+  ${chalk.dim(result.error_message)}`);
+  } else if (result.error_message) {
     lines.push(`
   ${chalk.red("Error:")} ${result.error_message}`);
   }
@@ -214,21 +215,29 @@ function caseDetailLines(c) {
   if (out.length) lines.push(`      <system-out>${escapeXml(out.join("\n"))}</system-out>`);
   return lines;
 }
+var isQuarantinedFailure = (t) => t.status === "failed" && t.quarantined === true;
+var NEUTRAL = /* @__PURE__ */ new Set(["not_checked", "not_run"]);
+function neutralMessage(outcome, message) {
+  if (outcome === "not_checked") return `not checked: ${message || "no step was checked"}`;
+  return message || "Not run";
+}
 function formatJunit(result) {
   const suiteName = escapeXml(result.suite_name || result.case_name || result.run_id);
   const cases = resultCases(result);
   const tests = cases.length;
-  const failures = cases.filter((t) => t.status === "failed").length;
+  const failures = cases.filter((t) => t.status === "failed" && !isQuarantinedFailure(t)).length;
   const errors = cases.filter((t) => t.status === "error").length;
+  const skipped = cases.filter((t) => isQuarantinedFailure(t) || NEUTRAL.has(outcomeOf(t))).length;
+  const skippedAttr = skipped > 0 ? ` skipped="${skipped}"` : "";
   const totalTime = result.duration_ms ? (result.duration_ms / 1e3).toFixed(1) : "0";
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const lines = [];
   lines.push('<?xml version="1.0" encoding="UTF-8"?>');
   lines.push(
-    `<testsuites name="vibeview" tests="${tests}" failures="${failures}" errors="${errors}" time="${totalTime}">`
+    `<testsuites name="vibeview" tests="${tests}" failures="${failures}" errors="${errors}"${skippedAttr} time="${totalTime}">`
   );
   lines.push(
-    `  <testsuite name="${suiteName}" tests="${tests}" failures="${failures}" errors="${errors}" time="${totalTime}" timestamp="${timestamp}">`
+    `  <testsuite name="${suiteName}" tests="${tests}" failures="${failures}" errors="${errors}"${skippedAttr} time="${totalTime}" timestamp="${timestamp}">`
   );
   if (result.url || result.build_warning) {
     lines.push("    <properties>");
@@ -245,13 +254,21 @@ function formatJunit(result) {
   for (const tr of cases) {
     const caseName = escapeXml(tr.case_name);
     const caseTime = tr.duration_ms ? (tr.duration_ms / 1e3).toFixed(1) : "0";
-    const detail = caseDetailLines(tr);
-    if (tr.status === "passed" && detail.length === 0) {
+    const outcome = outcomeOf(tr);
+    const detail = caseDetailLines({ ...tr, status: outcome });
+    if (outcome === "passed" && detail.length === 0) {
       lines.push(`    <testcase name="${caseName}" classname="${suiteName}" time="${caseTime}" />`);
       continue;
     }
     lines.push(`    <testcase name="${caseName}" classname="${suiteName}" time="${caseTime}">`);
-    if (tr.status === "failed") {
+    if (isQuarantinedFailure(tr)) {
+      const msg = escapeXml(tr.error_message || "Test failed");
+      lines.push(`      <skipped message="quarantined: ${msg}" />`);
+    } else if (NEUTRAL.has(outcome)) {
+      lines.push(
+        `      <skipped message="${escapeXml(neutralMessage(outcome, tr.error_message))}" />`
+      );
+    } else if (tr.status === "failed") {
       const msg = escapeXml(tr.error_message || "Test failed");
       lines.push(`      <failure message="${msg}" type="TestFailure">${msg}</failure>`);
     } else if (tr.status !== "passed") {
@@ -287,7 +304,7 @@ function formatJunitError(name, message, url) {
   lines.push("</testsuites>");
   return lines.join("\n");
 }
-var MULTI_TERMINAL = /* @__PURE__ */ new Set(["passed", "failed", "error", "cancelled"]);
+var MULTI_TERMINAL = /* @__PURE__ */ new Set(["passed", "failed", "error", "cancelled", "not_checked"]);
 function caseLines(c, classname) {
   const name = escapeXml(c.name);
   const head = `    <testcase name="${name}" classname="${classname}" time="${c.time}"`;
@@ -324,6 +341,21 @@ function formatMultiSuiteJunit(result, opts = {}) {
         url: c.url || void 0,
         steps_not_checked: c.steps_not_checked
       };
+      const outcome = outcomeOf(c);
+      if (NEUTRAL.has(outcome)) {
+        return {
+          ...base,
+          verdict: "skipped",
+          message: neutralMessage(outcome, c.error_message)
+        };
+      }
+      if (c.status === "failed" && c.quarantined === true) {
+        return {
+          ...base,
+          verdict: "skipped",
+          message: `quarantined: ${c.error_message || "Test failed"}`
+        };
+      }
       switch (c.status) {
         case "passed":
           return { ...base, verdict: "passed" };
@@ -395,6 +427,7 @@ function formatMultiSuiteJunit(result, opts = {}) {
 }
 
 // src/lib/poll.ts
+var TERMINAL_STATUSES = ["passed", "failed", "error", "cancelled", "not_checked"];
 function resumeSpinner(spinner, text) {
   if (spinner.isEnabled === false) {
     if (text !== void 0) spinner.text = text;
@@ -492,20 +525,26 @@ async function pollUntilComplete(client, runId, timeoutMs, spinner, onQueueObser
             `${chalk2.cyan("\u25B6")} ${chalk2.bold(tr.case_name || "Case")} started`
           );
         }
-        const isTerminal = ["passed", "failed", "error", "cancelled"].includes(cur);
-        const wasTerminal = prev && ["passed", "failed", "error", "cancelled"].includes(prev);
+        const isTerminal = TERMINAL_STATUSES.includes(cur);
+        const wasTerminal = prev && TERMINAL_STATUSES.includes(prev);
         if (isTerminal && !wasTerminal) {
-          const icon = cur === "passed" ? chalk2.green("\u2713") : cur === "cancelled" ? chalk2.yellow("\u26A0") : chalk2.red("\u2717");
+          const outcome = outcomeOf(tr);
+          const neutral = outcome === "not_checked" || outcome === "not_run";
+          const icon = neutral ? chalk2.gray("\u25CB") : cur === "passed" ? chalk2.green("\u2713") : cur === "cancelled" ? chalk2.yellow("\u26A0") : chalk2.red("\u2717");
+          const label = neutral ? outcome.replace("_", " ") : cur;
           const dur = tr.duration_ms ? ` (${(tr.duration_ms / 1e3).toFixed(1)}s)` : "";
-          printBelowSpinner(spinner, `${icon} ${chalk2.bold(tr.case_name || "Case")} ${cur}${dur}`);
-          if (tr.error_message && cur !== "passed") {
+          printBelowSpinner(
+            spinner,
+            `${icon} ${chalk2.bold(tr.case_name || "Case")} ${label}${dur}`
+          );
+          if (tr.error_message && cur !== "passed" && !neutral) {
             printBelowSpinner(spinner, `    ${chalk2.red(tr.error_message)}`);
           }
         }
         caseStateBefore.set(tr.public_id, cur);
       }
     }
-    if (["passed", "failed", "error", "cancelled"].includes(result.status)) {
+    if (TERMINAL_STATUSES.includes(result.status)) {
       if (printedSteps.size > 0 && Array.isArray(result.steps)) {
         spinner.stop();
         result.steps.forEach((st, i) => {
@@ -555,7 +594,7 @@ async function pollUntilComplete(client, runId, timeoutMs, spinner, onQueueObser
         if (result.type === "suite_run" && Array.isArray(result.test_runs)) {
           const total = result.total_cases ?? result.test_runs.length;
           const done = result.test_runs.filter(
-            (tr) => ["passed", "failed", "error", "cancelled"].includes(tr.status ?? "")
+            (tr) => TERMINAL_STATUSES.includes(tr.status ?? "")
           ).length;
           spinner.text = `Running suite \u2014 ${done}/${total} cases complete...`;
         } else {
@@ -652,10 +691,10 @@ function displayProgressEvent(evt, ctx) {
       break;
     }
     case "run_completed": {
-      const icon = evt.status === "passed" ? chalk2.green("\u2713") : evt.status === "cancelled" ? chalk2.yellow("\u26A0") : chalk2.red("\u2717");
+      const icon = evt.status === "not_checked" ? chalk2.gray("\u25CB") : evt.status === "passed" ? chalk2.green("\u2713") : evt.status === "cancelled" ? chalk2.yellow("\u26A0") : chalk2.red("\u2717");
       spinner.stop();
       process.stderr.write(
-        `${icon} Run ${evt.status}${evt.duration_ms ? ` (${(evt.duration_ms / 1e3).toFixed(1)}s)` : ""}
+        `${icon} Run ${evt.status === "not_checked" ? "not checked" : evt.status}${evt.duration_ms ? ` (${(evt.duration_ms / 1e3).toFixed(1)}s)` : ""}
 `
       );
       resumeSpinner(spinner);
@@ -695,14 +734,30 @@ function outputResult(result, options) {
   }
 }
 function mapExitCode(status) {
-  if (status === "passed") return EXIT_PASS;
+  if (status === "passed" || status === "not_checked") return EXIT_PASS;
   if (status === "failed") return EXIT_TEST_FAIL;
   return EXIT_INFRA_ERROR;
 }
+function isQuarantinedFailure2(result) {
+  return result.status === "failed" && result.quarantined === true;
+}
+function runExitCode(result) {
+  return isQuarantinedFailure2(result) ? EXIT_PASS : mapExitCode(result.status);
+}
 
 // src/lib/run-target.ts
 import chalk3 from "chalk";
 var RUN_PLATFORMS = ["ios", "android", "tvos", "androidtv"];
+var SUITE_FILTER_PLATFORMS = [...RUN_PLATFORMS, "roku"];
+function parseSuitePlatformFilter(value) {
+  if (value === void 0) return void 0;
+  if (!SUITE_FILTER_PLATFORMS.includes(value)) {
+    throw new Error(
+      `--platform must be one of ${SUITE_FILTER_PLATFORMS.join(", ")}, got "${value}"`
+    );
+  }
+  return value;
+}
 function parseRunPlatform(value) {
   if (value === void 0) return void 0;
   if (!RUN_PLATFORMS.includes(value)) {
@@ -802,6 +857,8 @@ ${signal} received.
       device: options.device,
       build: options.build,
       metadata: options.metadata,
+      // Opt-in: always sent, so an older server's CI default never retries.
+      retryFailed: options.retry === true,
       platform: options.platform,
       app: options.app
     });
@@ -838,7 +895,7 @@ ${signal} received.
       response.build_warning ? { ...result, build_warning: response.build_warning } : result,
       options
     );
-    process.exit(mapExitCode(result.status));
+    process.exit(runExitCode(result));
   } catch (err) {
     spinner.fail(err instanceof Error ? err.message : "Unknown error");
     outputRunError(err, options, {
@@ -928,7 +985,9 @@ ${signal} received.
       device_category: opts.device ? void 0 : opts.deviceCategory,
       device_id: opts.device,
       build_id: opts.build,
-      metadata: opts.metadata
+      metadata: opts.metadata,
+      // Opt-in: always sent, so an older server's CI default never retries.
+      retry_failed: opts.retry === true
     });
   } catch (err) {
     spinner.stop();
@@ -989,7 +1048,7 @@ ${chalk5.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
     pending = [];
     if (nextText !== null) spinner.start(nextText);
   };
-  const TERMINAL = /* @__PURE__ */ new Set(["passed", "failed", "error", "cancelled"]);
+  const TERMINAL = /* @__PURE__ */ new Set(["passed", "failed", "error", "cancelled", "not_checked"]);
   let last = null;
   const abandon = async (reason) => {
     flush(null);
@@ -1048,10 +1107,11 @@ ${chalk5.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
       }
       const wasTerminal = prev !== void 0 && TERMINAL.has(prev);
       if (TERMINAL.has(cur) && !wasTerminal) {
-        const mark = cur === "passed" ? chalk5.green("\u2713") : cur === "cancelled" ? chalk5.yellow("\u26A0") : chalk5.red("\u2717");
+        const nothingChecked = outcomeOf(sr) === "not_checked";
+        const mark = nothingChecked ? chalk5.gray("\u25CB") : cur === "passed" ? chalk5.green("\u2713") : cur === "cancelled" ? chalk5.yellow("\u26A0") : chalk5.red("\u2717");
         const link = sr.url ? chalk5.dim(" " + sr.url) : "";
         print(
-          `${mark} ${chalk5.bold(sr.suite_name)} ${cur}: ${sr.passed} passed, ${sr.failed} failed${link}`
+          `${mark} ${chalk5.bold(sr.suite_name)} ${nothingChecked ? "not checked" : cur}: ${suiteCounts(sr)}${link}`
         );
         if (sr.error_message) {
           print(`    ${chalk5.red(sr.error_message)}`);
@@ -1105,39 +1165,48 @@ ${chalk5.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
       0
     );
     const aggregateNote = totalNotChecked > 0 ? chalk5.yellow(` (${stepsNotCheckedLabel(totalNotChecked)})`) : "";
+    const aggregate = outcomeOf(last) === "not_checked" ? "not checked" : last.status;
     process.stdout.write(`
-Aggregate: ${last.status}${aggregateNote}
+Aggregate: ${aggregate}${aggregateNote}
 `);
     for (const sr of last.suite_runs) {
-      const mark = sr.status === "passed" ? chalk5.green("\u2713") : chalk5.red("\u2717");
+      const mark = outcomeOf(sr) === "not_checked" ? chalk5.gray("\u25CB") : 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}
-`
-      );
+      process.stdout.write(`  ${mark} ${sr.suite_name}: ${suiteCounts(sr)}${link}
+`);
       if (sr.error_message) {
         process.stdout.write(`      ${chalk5.red(sr.error_message)}
 `);
       }
       for (const cr of sr.case_runs ?? []) {
-        const caseMark = cr.status === "passed" ? chalk5.green("\u2713") : cr.status === "cancelled" || cr.status === "pending" || cr.status === "running" ? chalk5.yellow("-") : chalk5.red("\u2717");
+        const outcome = outcomeOf(cr);
+        const neutral = outcome === "not_checked" || outcome === "not_run";
+        const caseMark = neutral ? chalk5.gray("\u25CB") : 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)`) : "";
-        const unchecked = notCheckedSuffix(cr.status, cr.steps_not_checked);
+        const unchecked = notCheckedSuffix(outcome, cr.steps_not_checked);
+        const label = neutral ? outcome.replace("_", " ") : cr.status ?? "?";
         process.stdout.write(
-          `      ${caseMark} ${cr.case_name ?? "Case"} ${cr.status ?? "?"}${unchecked ? chalk5.yellow(unchecked) : ""}${dur} ${chalk5.dim(cr.url)}
+          `      ${caseMark} ${cr.case_name ?? "Case"} ${label}${unchecked ? chalk5.yellow(unchecked) : ""}${dur} ${chalk5.dim(cr.url)}
 `
         );
-        if (cr.error_message && cr.status !== "passed") {
+        if (cr.error_message && neutral) {
+          process.stdout.write(`          ${chalk5.dim(cr.error_message)}
+`);
+        } else if (cr.error_message && cr.status !== "passed") {
           process.stdout.write(`          ${chalk5.red(cr.error_message)}
 `);
         }
       }
     }
   }
-  if (last.status === "passed") process.exit(EXIT_PASS);
+  if (last.status === "passed" || last.status === "not_checked") process.exit(EXIT_PASS);
   if (last.status === "failed") process.exit(EXIT_TEST_FAIL);
   process.exit(EXIT_INFRA_ERROR);
 }
+function suiteCounts(sr) {
+  const nc = sr.not_checked_tests ?? 0;
+  return `${sr.passed} passed, ${sr.failed} failed${nc > 0 ? `, ${nc} not checked` : ""}`;
+}
 
 // src/commands/run-test.ts
 import chalk6 from "chalk";
@@ -1206,6 +1275,8 @@ ${signal} received.
       device: options.device,
       build: options.build,
       metadata: options.metadata,
+      // Opt-in: always sent, so an older server's CI default never retries.
+      retryFailed: options.retry === true,
       platform: options.platform,
       app: options.app
     });
@@ -1243,7 +1314,7 @@ ${chalk6.dim("Test:")} ${testId}
       response.build_warning ? { ...result, build_warning: response.build_warning } : result,
       options
     );
-    process.exit(mapExitCode(result.status));
+    process.exit(runExitCode(result));
   } catch (err) {
     spinner.fail(err instanceof Error ? err.message : "Unknown error");
     outputRunError(err, options, {
@@ -1383,11 +1454,11 @@ async function stopCommand(sessionId, opts, deps) {
 import chalk10 from "chalk";
 import { existsSync, readFileSync } from "fs";
 async function readStdin() {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     let data = "";
     const timeout = setTimeout(() => {
       process.stdin.removeAllListeners();
-      resolve(data);
+      resolve2(data);
     }, 5e3);
     process.stdin.setEncoding("utf-8");
     process.stdin.on("data", (chunk) => {
@@ -1395,7 +1466,7 @@ async function readStdin() {
     });
     process.stdin.on("end", () => {
       clearTimeout(timeout);
-      resolve(data);
+      resolve2(data);
     });
     process.stdin.on("error", (err) => {
       clearTimeout(timeout);
@@ -1439,14 +1510,16 @@ function assertHasSteps(steps) {
 async function resolveAppId(client, appRef, platform) {
   if (appRef.includes(".")) {
     if (!platform) {
-      throw new Error(
+      throw new UsageError(
         "When using a package name for --app, you must also specify --platform (ios, android)."
       );
     }
     const apps = await client.listApps();
     const match = apps.find((a) => a.package_name === appRef && a.platform === platform);
     if (!match) {
-      throw new Error(`No app found with package name "${appRef}" and platform "${platform}".`);
+      throw new UsageError(
+        `No app found with package name "${appRef}" and platform "${platform}".`
+      );
     }
     return match.public_id;
   }
@@ -1470,7 +1543,8 @@ async function createTest(options) {
       steps,
       context: options.context,
       mode: "ai",
-      if_exists: options.ifExists
+      if_exists: options.ifExists,
+      group_ids: options.group?.length ? options.group : void 0
     });
     spinner.succeed(
       result.outcome === "updated" ? `Test updated: ${result.name}` : result.outcome === "unchanged" ? `Test already exists, unchanged: ${result.name}` : `Test created: ${result.name}`
@@ -1483,6 +1557,7 @@ async function createTest(options) {
             name: result.name,
             app_id: appPublicId || null,
             outcome: result.outcome ?? null,
+            groups: result.groups ?? [],
             url: testCaseUrl(baseUrl, result.public_id)
           },
           null,
@@ -1498,6 +1573,9 @@ async function createTest(options) {
       if (result.platform) {
         console.log(`  ${chalk10.dim(`Platform: ${result.platform}`)}`);
       }
+      if (result.groups?.length) {
+        console.log(`  ${chalk10.dim(`Groups: ${result.groups.map((g) => g.name).join(", ")}`)}`);
+      }
       console.log(`  ${chalk10.dim(`Steps: ${steps.length}`)}`);
       console.log(chalk10.dim(`  ${testCaseUrl(baseUrl, result.public_id)}
 `));
@@ -1511,6 +1589,153 @@ async function createTest(options) {
   }
 }
 
+// src/commands/import-maestro.ts
+import chalk11 from "chalk";
+import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { basename, extname, join, relative, resolve, sep } from "path";
+import { zipSync } from "fflate";
+var MAX_FOLDER_FLOWS = 200;
+var MAX_FLOW_BYTES = 256 * 1024;
+var MAX_TOTAL_BYTES = 5 * 1024 * 1024;
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git"]);
+function readMaestroUpload(path) {
+  if (!existsSync2(path)) throw new UsageError(`Not found: ${path}`);
+  if (statSync(path).isFile()) {
+    const ext = extname(path).toLowerCase();
+    if (![".yaml", ".yml", ".zip"].includes(ext)) {
+      throw new UsageError(
+        "Pass a Maestro flow (.yaml or .yml), a .zip of your flows folder, or the folder itself."
+      );
+    }
+    const size = statSync(path).size;
+    const cap = ext === ".zip" ? MAX_TOTAL_BYTES : MAX_FLOW_BYTES;
+    if (size > cap) {
+      throw new UsageError(`${path} is larger than ${cap / 1024} KB.`);
+    }
+    return { name: basename(path), bytes: readFileSync2(path) };
+  }
+  const root = resolve(path);
+  const entries = {};
+  let count = 0;
+  let total = 0;
+  const walk = (dir) => {
+    for (const ent of readdirSync(dir, { withFileTypes: true })) {
+      if (ent.isSymbolicLink()) continue;
+      const full = join(dir, ent.name);
+      if (ent.isDirectory()) {
+        if (!SKIP_DIRS.has(ent.name)) walk(full);
+        continue;
+      }
+      if (!ent.isFile() || !/\.ya?ml$/i.test(ent.name)) continue;
+      const rel = relative(root, full).split(sep).join("/");
+      const bytes2 = readFileSync2(full);
+      count += 1;
+      total += bytes2.length;
+      if (count > MAX_FOLDER_FLOWS) {
+        throw new UsageError(`${path} holds more than ${MAX_FOLDER_FLOWS} flow files.`);
+      }
+      if (bytes2.length > MAX_FLOW_BYTES) {
+        throw new UsageError(`${rel} is larger than ${MAX_FLOW_BYTES / 1024} KB.`);
+      }
+      if (total > MAX_TOTAL_BYTES) {
+        throw new UsageError(`The flows in ${path} add up to more than 5 MB.`);
+      }
+      entries[rel] = bytes2;
+    }
+  };
+  walk(root);
+  if (count === 0) throw new UsageError(`No .yaml or .yml flows found in ${path}.`);
+  const bytes = zipSync(entries);
+  if (bytes.length > MAX_TOTAL_BYTES) {
+    throw new UsageError(`The zipped flows in ${path} are larger than 5 MB.`);
+  }
+  return { name: `${basename(root) || "flows"}.zip`, bytes };
+}
+var FLAG_LABEL = {
+  rewrite: "needs rewrite",
+  check: "check",
+  dropped: "not imported"
+};
+var START_STATE_LABEL = {
+  reinstall: "Fresh install",
+  clear_data: "Clean app data",
+  relaunch: "Restart the app",
+  none: "Where the last test stopped"
+};
+function flagLine(f) {
+  const where = [f.file, f.where, f.command].filter(Boolean).join(" \xB7 ");
+  const label = f.severity === "rewrite" ? chalk11.red(FLAG_LABEL.rewrite) : FLAG_LABEL[f.severity];
+  return `    ${label}  ${chalk11.dim(where)}  ${f.message}`;
+}
+function formatImport(result, baseUrl) {
+  const lines = [];
+  const tests = result.tests.filter((t) => t.importable);
+  if (result.created === null) {
+    lines.push(
+      `Preview: ${tests.length} test(s) and ${result.setups.length} setup(s) would be created. Nothing was saved; run again without --dry-run to import.`
+    );
+  } else {
+    lines.push(`Created ${result.created} test(s), setups included.`);
+  }
+  for (const f of result.flags) lines.push(flagLine(f));
+  for (const t of [...result.tests, ...result.setups]) {
+    const meta = [`${t.steps.length} ${t.steps.length === 1 ? "step" : "steps"}`];
+    if (t.setup_keys.length) meta.push(`before this test: ${t.setup_keys.join(", ")}`);
+    if (t.start_state) meta.push(`start: ${START_STATE_LABEL[t.start_state] ?? t.start_state}`);
+    const head = t.importable ? t.name : chalk11.red(`${t.name} (not imported)`);
+    lines.push("", `  ${head}  ${chalk11.dim(`${t.key} \xB7 ${meta.join(" \xB7 ")}`)}`);
+    if (t.created_id) lines.push(`    ${chalk11.dim(testCaseUrl(baseUrl, t.created_id))}`);
+    for (const f of t.flags) lines.push(flagLine(f));
+  }
+  if (result.test_data.length) {
+    lines.push("", "These tests use test data:");
+    for (const d of result.test_data) {
+      const note = d.status === "needs_value" || d.status === "skipped" || d.suggested_value === null ? "add the value under App notes & data" : d.status === "kept" ? "already set, kept" : d.status === "created" ? "added from the flow" : d.secret ? "stored as a secret" : `flow value: ${d.suggested_value}`;
+      lines.push(`  ${d.key}  ${chalk11.dim(note)}`);
+    }
+  }
+  return lines;
+}
+async function importMaestro(path, options) {
+  let upload;
+  try {
+    if (!options.app) throw new UsageError("Pass the app to import into: --app <app id>.");
+    upload = readMaestroUpload(path);
+  } catch (err) {
+    if (options.output === "json") printJsonError(err);
+    throw err;
+  }
+  const { token, baseUrl } = resolveAuth(options);
+  const client = new ApiClient(baseUrl, token);
+  try {
+    const appId = await resolveAppId(client, options.app, options.platform);
+    const spinner = createSpinner(options.dryRun ? "Reading flows..." : "Importing flows...", {
+      silent: options.output === "json"
+    });
+    spinner.start();
+    let result;
+    try {
+      result = await client.importMaestro(upload, {
+        appId,
+        group: options.group,
+        dryRun: options.dryRun === true
+      });
+    } finally {
+      spinner.stop();
+    }
+    if (options.output === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    for (const line of formatImport(result, baseUrl)) console.log(line);
+  } catch (err) {
+    if (options.output === "json") printJsonError(err);
+    console.error(chalk11.red(err instanceof Error ? err.message : "Import failed"));
+    const rejected = err instanceof UsageError || err instanceof NotFoundError || err instanceof ApiStatusError && err.status >= 400 && err.status < 500 ? EXIT_TEST_FAIL : EXIT_INFRA_ERROR;
+    process.exit(errorExitCode(err, rejected));
+  }
+}
+
 // src/commands/login.ts
 import { randomUUID } from "crypto";
 import open from "open";
@@ -1588,7 +1813,7 @@ async function logout() {
 }
 
 // src/commands/dev-status.ts
-import chalk11 from "chalk";
+import chalk12 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})` : ""}` : "";
@@ -1649,7 +1874,7 @@ async function devStatus(opts) {
     console.error(`  url:      ${state.page_url}`);
     console.error(`  started:  ${state.started_at}`);
   }
-  if (metro) console.error(chalk11.dim(`Metro: pid ${metro.pid} on :${metro.port} (CLI-owned)`));
+  if (metro) console.error(chalk12.dim(`Metro: pid ${metro.pid} on :${metro.port} (CLI-owned)`));
   process.exit(0);
 }
 var LIVE_STATUSES = /* @__PURE__ */ new Set(["pending", "queued", "starting", "active"]);
@@ -1674,7 +1899,7 @@ async function reportOrphan(api, state, opts) {
     );
   } else if (live) {
     console.error(
-      chalk11.yellow(
+      chalk12.yellow(
         `\u26A0 The dev process (pid ${state.pid}) has exited, but session ${state.session_id} is still ${status}.`
       )
     );
@@ -1722,12 +1947,12 @@ async function devStop(opts) {
 }
 
 // src/commands/dev-reload.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 function fail(opts, code, message, exit) {
   if (opts.json) {
     console.log(JSON.stringify({ reloaded: false, code, message }));
   } else {
-    console.error(chalk12.red(`error: ${message}`));
+    console.error(chalk13.red(`error: ${message}`));
   }
   process.exit(exit);
 }
@@ -1780,7 +2005,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(chalk12.dim(line))
+    log: (line) => console.error(chalk13.dim(line))
   });
   const started = Date.now();
   try {
@@ -1802,10 +2027,10 @@ async function devReload(opts) {
 }
 
 // src/commands/builds.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 
 // src/lib/formatters/builds.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 var HEADERS = ["ID", "PLATFORM", "STATUS", "CREATED", "COST", "APP"];
 var UNBILLED_STATUSES = /* @__PURE__ */ new Set(["queued", "running"]);
 function formatCostCell(costMicro, status) {
@@ -1813,13 +2038,13 @@ function formatCostCell(costMicro, status) {
   return `$${(Math.max(costMicro, 0) / 1e6).toFixed(2)}`;
 }
 var STATUS_COLOR = {
-  succeeded: chalk13.green,
-  failed: chalk13.red,
-  timed_out: chalk13.red,
-  infra_failed: chalk13.red,
-  canceled: chalk13.dim,
-  running: chalk13.yellow,
-  queued: chalk13.dim
+  succeeded: chalk14.green,
+  failed: chalk14.red,
+  timed_out: chalk14.red,
+  infra_failed: chalk14.red,
+  canceled: chalk14.dim,
+  running: chalk14.yellow,
+  queued: chalk14.dim
 };
 function formatBuildsHuman(builds2) {
   if (builds2.length === 0) {
@@ -1835,13 +2060,13 @@ 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 = [chalk13.bold(join4(padCells(HEADERS)))];
+  const join5 = (cells) => cells.join("  ").trimEnd();
+  const lines = [chalk14.bold(join5(padCells(HEADERS)))];
   for (const row of rows) {
     const padded = padCells(row);
     const colorFn = STATUS_COLOR[row[2]] ?? ((s) => s);
     padded[2] = colorFn(row[2]) + padded[2].slice(row[2].length);
-    lines.push(join4(padded));
+    lines.push(join5(padded));
   }
   return lines.join("\n") + "\n";
 }
@@ -1895,7 +2120,7 @@ async function buildsLogs(id, opts, deps) {
         console.log(JSON.stringify(logs));
       } else {
         if (logs.content) process.stdout.write(logs.content);
-        console.error(chalk14.dim(`status: ${logs.status}`));
+        console.error(chalk15.dim(`status: ${logs.status}`));
       }
       process.exitCode = 0;
       return;
@@ -1992,7 +2217,7 @@ async function buildsDownload(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk14.green(`\u2713 saved ${result.path}`));
+      console.log(chalk15.green(`\u2713 saved ${result.path}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2009,7 +2234,7 @@ async function buildsCancel(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(build));
     } else {
-      console.log(`${chalk14.cyan(build.id)}  ${build.status}`);
+      console.log(`${chalk15.cyan(build.id)}  ${build.status}`);
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2026,7 +2251,7 @@ async function buildsDeleteArtifact(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk14.green(`\u2713 deleted artifact for ${id}`));
+      console.log(chalk15.green(`\u2713 deleted artifact for ${id}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2037,11 +2262,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(chalk14.red(`error: ${message}`));
+  console.error(chalk15.red(`error: ${message}`));
 }
 
 // src/commands/submit.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 function defaultDeps2(client) {
   return {
     createSubmission: client.createSubmission.bind(client),
@@ -2065,7 +2290,7 @@ function submitConfigFor(cwd, platform) {
     cfg = loadDevConfig(cwd);
   } catch (err) {
     console.error(
-      chalk15.yellow(
+      chalk16.yellow(
         `warning: vibeview.json could not be read \u2014 ignoring submit defaults (${err instanceof Error ? err.message : String(err)})`
       )
     );
@@ -2213,12 +2438,12 @@ async function submitCommand(opts, deps) {
       return;
     }
     if (!opts.json) {
-      console.error(`  ${chalk15.cyan(sub.id)}  ${chalk15.dim(`[${sub.platform}]`)}`);
+      console.error(`  ${chalk16.cyan(sub.id)}  ${chalk16.dim(`[${sub.platform}]`)}`);
     }
     const final = await followSubmission(sub, opts, d);
     if (!opts.json && final.status === "succeeded" && (final.release_status ?? releaseStatus) === "draft") {
       console.error(
-        chalk15.dim("release status: draft \u2014 activate it from the Play Console when ready")
+        chalk16.dim("release status: draft \u2014 activate it from the Play Console when ready")
       );
     }
     process.exitCode = final.status === "succeeded" ? 0 : 1;
@@ -2249,11 +2474,11 @@ async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
     });
     emit(opts.json, { event: "preflight", ...result });
     if (!opts.json) {
-      const mark = result.ready ? chalk15.green("\u2713") : chalk15.red("\u2717");
+      const mark = result.ready ? chalk16.green("\u2713") : chalk16.red("\u2717");
       console.error(`${mark} ${result.message}`);
       if (result.ready) {
         console.error(
-          chalk15.dim(
+          chalk16.dim(
             `  next: vibeview build --cloud --production --platform ${platform}, then vibeview submit --platform ${platform} --latest`
           )
         );
@@ -2287,7 +2512,7 @@ async function linkedIdentifier(platform, opts, deps) {
   }
   if (!app.package_name) return void 0;
   if (!opts.json) {
-    console.error(chalk15.dim(`Checking ${app.package_name} (${app.name}, linked in vibeview.json)`));
+    console.error(chalk16.dim(`Checking ${app.package_name} (${app.name}, linked in vibeview.json)`));
   }
   return app.package_name;
 }
@@ -2328,14 +2553,14 @@ async function followSubmission(created, opts, deps) {
         if (opts.json) {
           emit(opts.json, { event: "status", id: created.id, status: "queued" });
         } else {
-          console.error(chalk15.dim("\u23F3 queued \u2014 waiting for a submission slot"));
+          console.error(chalk16.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(`${chalk15.cyan("\u25B6")} submitting`);
+          console.error(`${chalk16.cyan("\u25B6")} submitting`);
         }
       }
       if (log.content) {
@@ -2377,7 +2602,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 ? chalk15.green("\u2713") : chalk15.red("\u2717");
+    const mark = ok ? chalk16.green("\u2713") : chalk16.red("\u2717");
     const duration = formatDuration(final.started_at, final.finished_at);
     let line = `${mark} ${final.status}`;
     if (duration) line += ` (${duration})`;
@@ -2389,11 +2614,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(chalk15.red(`error: ${message}`));
+  console.error(chalk16.red(`error: ${message}`));
 }
 
 // src/commands/versions.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 function defaultDeps3(client) {
   return {
     listAppVersions: client.listAppVersions.bind(client),
@@ -2443,7 +2668,7 @@ async function versionsSet(buildNumber, opts, deps) {
       console.log(JSON.stringify(version));
     } else {
       console.log(
-        chalk16.green(`\u2713 ${version.platform} build number set to ${version.build_number}`) + chalk16.dim(
+        chalk17.green(`\u2713 ${version.platform} build number set to ${version.build_number}`) + chalk17.dim(
           " \u2014 the next autoIncrement production build gets " + (version.build_number + 1)
         )
       );
@@ -2462,19 +2687,19 @@ function formatVersionsHuman(versions2) {
   const rows = versions2.map((v) => [v.platform, String(v.build_number), v.updated_at ?? ""]);
   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 = [chalk16.bold(join4(padCells(HEADERS2)))];
-  for (const row of rows) lines.push(join4(padCells(row)));
+  const join5 = (cells) => cells.join("  ").trimEnd();
+  const lines = [chalk17.bold(join5(padCells(HEADERS2)))];
+  for (const row of rows) lines.push(join5(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(chalk16.red(`error: ${message}`));
+  console.error(chalk17.red(`error: ${message}`));
 }
 
 // src/commands/whoami.ts
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 function defaultDeps4(opts) {
   const { token, baseUrl } = resolveAuth(opts);
   const client = new ApiClient(baseUrl, token);
@@ -2505,33 +2730,33 @@ async function whoAmI(opts, deps) {
       process.exitCode = 0;
       return;
     }
-    console.log(`${chalk17.bold("Logged in as")}  ${me.email}`);
+    console.log(`${chalk18.bold("Logged in as")}  ${me.email}`);
     if (me.memberships.length === 1) {
-      console.log(`${chalk17.bold("Organization")}   ${me.memberships[0].organization_name}`);
+      console.log(`${chalk18.bold("Organization")}   ${me.memberships[0].organization_name}`);
     } else if (me.memberships.length > 1) {
-      console.log(chalk17.bold("Organizations"));
+      console.log(chalk18.bold("Organizations"));
       for (const m of me.memberships) {
         console.log(`  ${m.organization_name} (${m.role})`);
       }
     }
-    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"}`);
+    console.log(`${chalk18.bold("Member role")}    ${me.role ?? "\u2014"}`);
+    console.log(`${chalk18.bold("Token role")}     ${me.token_role ?? "\u2014 (session auth)"}`);
+    console.log(`${chalk18.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"}`
+        `${chalk18.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)}`);
+      console.log(`${chalk18.bold("Expires")}        ${describeExpiry(me.token_expires_at)}`);
     }
     if (me.is_superadmin) {
-      console.log(chalk17.dim("Superadmin (platform-wide; does not raise the org role above)"));
+      console.log(chalk18.dim("Superadmin (platform-wide; does not raise the org role above)"));
     }
     if (me.role === "admin" && me.token_role && me.token_role !== "admin" && me.token_access !== "ci") {
       console.log(
-        chalk17.yellow(
+        chalk18.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 ${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")}.`
+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 ${chalk18.bold("vibeview env set")}) will fail with a permissions error.
+Create an admin API token in the dashboard and use ${chalk18.bold("--token")} or ${chalk18.bold("VIBEVIEW_API_TOKEN")}.`
         )
       );
     }
@@ -2541,15 +2766,15 @@ Create an admin API token in the dashboard and use ${chalk17.bold("--token")} or
     if (opts.json) {
       console.log(JSON.stringify({ event: "error", message }));
     }
-    console.error(chalk17.red(`error: ${message}`));
+    console.error(chalk18.red(`error: ${message}`));
     process.exitCode = errorExitCode(err);
   }
 }
 
 // src/commands/env.ts
 import { chmod, open as open2, readFile as readFileAsync } from "fs/promises";
-import { basename } from "path";
-import chalk18 from "chalk";
+import { basename as basename2 } from "path";
+import chalk19 from "chalk";
 import { password } from "@inquirer/prompts";
 
 // src/lib/gitignore.ts
@@ -2605,7 +2830,7 @@ function defaultDeps5(client) {
     isIgnored: (path) => isGitIgnored(path),
     writeFile: writeSecureFile,
     readFile: (path) => readFileAsync(path),
-    warn: (message) => console.error(chalk18.yellow(`warning: ${message}`))
+    warn: (message) => console.error(chalk19.yellow(`warning: ${message}`))
   };
 }
 async function envList(opts, deps) {
@@ -2636,9 +2861,9 @@ 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 = [chalk18.bold(join4(padCells(HEADERS3)))];
-  for (const row of rows) lines.push(join4(padCells(row)));
+  const join5 = (cells) => cells.join("  ").trimEnd();
+  const lines = [chalk19.bold(join5(padCells(HEADERS3)))];
+  for (const row of rows) lines.push(join5(padCells(row)));
   return lines.join("\n") + "\n";
 }
 async function envSet(name, value, opts, deps) {
@@ -2655,7 +2880,7 @@ async function envSet(name, value, opts, deps) {
     const visibility = resolveVisibility(opts);
     if (opts.file) {
       const content = await d.readFile(opts.file);
-      const filename = basename(opts.file);
+      const filename = basename2(opts.file);
       const result2 = await d.setFileVar({ name, content, filename, visibility, app: opts.app });
       printSetResult(opts, result2);
       process.exitCode = 0;
@@ -2687,7 +2912,7 @@ function printSetResult(opts, result) {
   if (opts.json) {
     console.log(JSON.stringify(result));
   } else {
-    console.log(chalk18.green(`\u2713 set ${result.name} (${result.visibility})`));
+    console.log(chalk19.green(`\u2713 set ${result.name} (${result.visibility})`));
   }
 }
 async function envRm(name, opts, deps) {
@@ -2697,7 +2922,7 @@ async function envRm(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) {
@@ -2729,7 +2954,7 @@ async function envPull(opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "pulled", path: outPath, count: variables.length }));
     } else {
-      console.log(chalk18.green(`\u2713 wrote ${variables.length} variable(s) to ${outPath}`));
+      console.log(chalk19.green(`\u2713 wrote ${variables.length} variable(s) to ${outPath}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2768,7 +2993,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(chalk18.red(`error: ${message}`));
+  console.error(chalk19.red(`error: ${message}`));
 }
 
 // src/commands/credentials.ts
@@ -2779,8 +3004,8 @@ import {
   writeFile as writeFileAsync
 } from "fs/promises";
 import { mkdirSync } from "fs";
-import { basename as basename2, extname, join } from "path";
-import chalk19 from "chalk";
+import { basename as basename3, extname as extname2, join as join2 } from "path";
+import chalk20 from "chalk";
 import { input, password as password2 } from "@inquirer/prompts";
 function clientFor2(opts) {
   const { token, baseUrl } = resolveAuth(opts);
@@ -2853,7 +3078,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(chalk19.yellow(`warning: ${message}`))
+    warn: (message) => console.error(chalk20.yellow(`warning: ${message}`))
   };
 }
 var ANDROID_KIND = "android_keystore";
@@ -2883,10 +3108,10 @@ async function credentialsAdd(opts, deps) {
       "a password is required: run interactively to be prompted (passwords are never accepted as flags)."
     );
   }
-  const name = opts.name ?? basename2(opts.file, extname(opts.file));
+  const name = opts.name ?? basename3(opts.file, extname2(opts.file));
   try {
     const file = await d.readFile(opts.file);
-    const filename = basename2(opts.file);
+    const filename = basename3(opts.file);
     let body;
     if (platform === "android") {
       const storePassword = await d.prompt({ message: "Keystore (store) password", hidden: true });
@@ -2915,14 +3140,14 @@ async function credentialsAdd(opts, deps) {
         file,
         filename,
         profile,
-        profileFilename: basename2(opts.profile)
+        profileFilename: basename3(opts.profile)
       };
     }
     const result = await d.addCredential(body);
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk19.green(`\u2713 added ${result.name} (${result.platform})`));
+      console.log(chalk20.green(`\u2713 added ${result.name} (${result.platform})`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -2948,7 +3173,7 @@ async function credentialsGenerate(opts, deps) {
   const outDir = opts.out ?? process.cwd();
   try {
     d.mkdir(outDir);
-    const expectedPath = join(outDir, `${opts.name}.keystore`);
+    const expectedPath = join2(outDir, `${opts.name}.keystore`);
     if (await d.fileExists(expectedPath)) {
       throw new Error(
         `${expectedPath} already exists \u2014 refusing to overwrite it. Move it away or pass a different --out/--name.`
@@ -2963,7 +3188,7 @@ async function credentialsGenerate(opts, deps) {
       // charge, so a stale CLI can never accidentally opt out of it.
       ...opts.force ? { overwrite: true } : {}
     });
-    const savedTo = join(outDir, basename2(result.filename));
+    const savedTo = join2(outDir, basename3(result.filename));
     if (opts.json) {
       console.log(JSON.stringify({ ...result, saved_to: savedTo }));
     }
@@ -2980,20 +3205,20 @@ async function credentialsGenerate(opts, deps) {
     }
     if (opts.json) {
     } else {
-      console.log(chalk19.green(`\u2713 generated ${result.name} (android)`));
+      console.log(chalk20.green(`\u2713 generated ${result.name} (android)`));
       console.log("");
-      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(`  Keystore saved to: ${chalk20.bold(savedTo)}`);
+      console.log(`  Key alias:         ${chalk20.bold(result.key_alias)}`);
+      console.log(`  Store password:    ${chalk20.bold(result.store_password)}`);
+      console.log(`  Key password:      ${chalk20.bold(result.key_password)}`);
       console.log("");
       console.log(
-        chalk19.yellow(
+        chalk20.yellow(
           "  These are shown ONCE \u2014 VibeView cannot recover the keystore file or its passwords. Back them up somewhere safe."
         )
       );
       console.log(
-        chalk19.yellow(
+        chalk20.yellow(
           "  The credential is already uploaded and active for android and androidtv production builds."
         )
       );
@@ -3019,19 +3244,19 @@ async function generateAppleCredential(platform, opts, d) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk19.green(`\u2713 generated ${result.name} (${result.platform})`));
+      console.log(chalk20.green(`\u2713 generated ${result.name} (${result.platform})`));
       console.log("");
-      console.log(`  Scope:   ${chalk19.bold(result.app_public_id ?? "org-wide")}`);
+      console.log(`  Scope:   ${chalk20.bold(result.app_public_id ?? "org-wide")}`);
       const expires = formatExpires(result);
       if (expires) {
-        console.log(`  Expires: ${chalk19.bold(expires)}`);
+        console.log(`  Expires: ${chalk20.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 ${chalk19.bold(`vibeview credentials download ${result.name}`)} if you need the files locally.`
+        `  Run ${chalk20.bold(`vibeview credentials download ${result.name}`)} if you need the files locally.`
       );
     }
     process.exitCode = 0;
@@ -3072,8 +3297,8 @@ async function credentialsDownload(name, opts, deps) {
       }
       throw err;
     }
-    const savedTo = join(outDir, basename2(material.filename));
-    const profileSavedTo = material.profile_base64 != null ? join(outDir, `${basename2(material.filename, extname(material.filename))}.mobileprovision`) : null;
+    const savedTo = join2(outDir, basename3(material.filename));
+    const profileSavedTo = material.profile_base64 != null ? join2(outDir, `${basename3(material.filename, extname2(material.filename))}.mobileprovision`) : null;
     if (opts.json) {
       console.log(
         JSON.stringify({
@@ -3097,17 +3322,17 @@ async function credentialsDownload(name, opts, deps) {
       await d.chmod(path, 384);
     }
     if (!opts.json) {
-      console.log(chalk19.green(`\u2713 downloaded ${material.name} (${material.platform})`));
+      console.log(chalk20.green(`\u2713 downloaded ${material.name} (${material.platform})`));
       console.log("");
-      console.log(`  Saved to: ${chalk19.bold(savedTo)}`);
+      console.log(`  Saved to: ${chalk20.bold(savedTo)}`);
       if (profileSavedTo !== null) {
-        console.log(`  Profile:  ${chalk19.bold(profileSavedTo)}`);
+        console.log(`  Profile:  ${chalk20.bold(profileSavedTo)}`);
       }
       for (const [key, value] of Object.entries(material.passwords)) {
-        console.log(`  ${key}: ${chalk19.bold(value)}`);
+        console.log(`  ${key}: ${chalk20.bold(value)}`);
       }
       console.log("");
-      console.log(chalk19.yellow("  This download is recorded in your organization's audit log."));
+      console.log(chalk20.yellow("  This download is recorded in your organization's audit log."));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3133,18 +3358,18 @@ async function ascKeyAdd(opts, deps) {
       keyId: opts.keyId,
       issuerId: opts.issuerId,
       file,
-      filename: basename2(opts.file)
+      filename: basename3(opts.file)
     });
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk19.green(`\u2713 added App Store Connect key ${result.name}`));
+      console.log(chalk20.green(`\u2713 added App Store Connect key ${result.name}`));
       console.log("");
-      console.log(`  Key ID:    ${chalk19.bold(result.key_id)}`);
-      console.log(`  Issuer ID: ${chalk19.bold(result.issuer_id)}`);
+      console.log(`  Key ID:    ${chalk20.bold(result.key_id)}`);
+      console.log(`  Issuer ID: ${chalk20.bold(result.issuer_id)}`);
       console.log("");
       console.log(
-        chalk19.yellow(
+        chalk20.yellow(
           "  The .p8 is stored encrypted and will never be shown again \u2014 keep your own copy somewhere safe."
         )
       );
@@ -3178,9 +3403,9 @@ function formatAscKeysHuman(keys) {
   const rows = keys.map((k) => [k.name, k.key_id, k.issuer_id, formatUtcTimestamp(k.created_at)]);
   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)))];
-  for (const row of rows) lines.push(join4(padCells(row)));
+  const join5 = (cells) => cells.join("  ").trimEnd();
+  const lines = [chalk20.bold(join5(padCells(HEADERS3)))];
+  for (const row of rows) lines.push(join5(padCells(row)));
   return lines.join("\n") + "\n";
 }
 async function ascKeyRm(name, opts, deps) {
@@ -3190,7 +3415,7 @@ async function ascKeyRm(name, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", name }));
     } else {
-      console.log(chalk19.green(`\u2713 removed App Store Connect key ${name}`));
+      console.log(chalk20.green(`\u2713 removed App Store Connect key ${name}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3210,17 +3435,17 @@ async function playKeyAdd(opts, deps) {
     const result = await d.addPlayKey({
       ...opts.name !== void 0 ? { name: opts.name } : {},
       file,
-      filename: basename2(opts.file)
+      filename: basename3(opts.file)
     });
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk19.green(`\u2713 added Google Play key ${result.name}`));
+      console.log(chalk20.green(`\u2713 added Google Play key ${result.name}`));
       console.log("");
-      console.log(`  Service account: ${chalk19.bold(result.client_email)}`);
+      console.log(`  Service account: ${chalk20.bold(result.client_email)}`);
       console.log("");
       console.log(
-        chalk19.yellow(
+        chalk20.yellow(
           "  The JSON key is stored encrypted and will never be shown again \u2014 keep your own copy somewhere safe."
         )
       );
@@ -3254,9 +3479,9 @@ function formatPlayKeysHuman(keys) {
   const rows = keys.map((k) => [k.name, k.client_email, formatUtcTimestamp(k.created_at)]);
   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)))];
-  for (const row of rows) lines.push(join4(padCells(row)));
+  const join5 = (cells) => cells.join("  ").trimEnd();
+  const lines = [chalk20.bold(join5(padCells(HEADERS3)))];
+  for (const row of rows) lines.push(join5(padCells(row)));
   return lines.join("\n") + "\n";
 }
 async function playKeyRm(name, opts, deps) {
@@ -3266,7 +3491,7 @@ async function playKeyRm(name, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", name }));
     } else {
-      console.log(chalk19.green(`\u2713 removed Google Play key ${name}`));
+      console.log(chalk20.green(`\u2713 removed Google Play key ${name}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3334,9 +3559,9 @@ 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 = [chalk19.bold(join4(padCells(HEADERS3)))];
-  for (const row of rows) lines.push(join4(padCells(row)));
+  const join5 = (cells) => cells.join("  ").trimEnd();
+  const lines = [chalk20.bold(join5(padCells(HEADERS3)))];
+  for (const row of rows) lines.push(join5(padCells(row)));
   return lines.join("\n") + "\n";
 }
 async function credentialsRm(name, opts, deps) {
@@ -3346,7 +3571,7 @@ async function credentialsRm(name, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", name }));
     } else {
-      console.log(chalk19.green(`\u2713 removed ${name}`));
+      console.log(chalk20.green(`\u2713 removed ${name}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3358,16 +3583,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(chalk19.red(`error: ${message}`));
+    console.error(chalk20.red(`error: ${message}`));
     return;
   }
-  console.error(chalk19.red(`error: ${message}`));
+  console.error(chalk20.red(`error: ${message}`));
   console.error(
-    chalk19.red(
+    chalk20.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(chalk19.red("Recover it NOW from the values below \u2014 they will not be shown again:"));
+  console.error(chalk20.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}`);
@@ -3381,11 +3606,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(chalk19.red(`error: ${message}`));
+  console.error(chalk20.red(`error: ${message}`));
 }
 
 // src/commands/webhooks.ts
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 function clientFor3(opts) {
   const { token, baseUrl } = resolveAuth(opts);
   return new ApiClient(baseUrl, token);
@@ -3416,14 +3641,14 @@ async function webhooksAdd(opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify(result));
     } else {
-      console.log(chalk20.green(`\u2713 added ${result.id} ${result.url}`));
+      console.log(chalk21.green(`\u2713 added ${result.id} ${result.url}`));
       console.log("");
-      console.log(`  Signing secret: ${chalk20.bold(result.secret)}`);
+      console.log(`  Signing secret: ${chalk21.bold(result.secret)}`);
       if (opts.secret !== void 0) {
-        console.log(chalk20.yellow("  (This is the secret you provided.)"));
+        console.log(chalk21.yellow("  (This is the secret you provided.)"));
       }
       console.log(
-        chalk20.yellow("  This secret is shown ONCE and cannot be retrieved again \u2014 store it now.")
+        chalk21.yellow("  This secret is shown ONCE and cannot be retrieved again \u2014 store it now.")
       );
     }
     process.exitCode = 0;
@@ -3453,9 +3678,9 @@ 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 = [chalk20.bold(join4(padCells(HEADERS3)))];
-  for (const row of rows) lines.push(join4(padCells(row)));
+  const join5 = (cells) => cells.join("  ").trimEnd();
+  const lines = [chalk21.bold(join5(padCells(HEADERS3)))];
+  for (const row of rows) lines.push(join5(padCells(row)));
   return lines.join("\n") + "\n";
 }
 async function webhooksList(opts, deps) {
@@ -3480,7 +3705,7 @@ async function webhooksRm(id, opts, deps) {
     if (opts.json) {
       console.log(JSON.stringify({ event: "deleted", id }));
     } else {
-      console.log(chalk20.green(`\u2713 removed ${id}`));
+      console.log(chalk21.green(`\u2713 removed ${id}`));
     }
     process.exitCode = 0;
   } catch (err) {
@@ -3513,13 +3738,13 @@ async function webhooksTest(id, opts, deps) {
         if (opts.json) console.log(JSON.stringify(ld));
         if (ld.status === "succeeded") {
           if (!opts.json) {
-            console.log(chalk20.green(`\u2713 Delivered (HTTP ${ld.response_code})`));
+            console.log(chalk21.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(chalk20.red(`\u2717 Failed (${code}) at ${formatUtcTimestamp(ld.at)}`));
+            console.error(chalk21.red(`\u2717 Failed (${code}) at ${formatUtcTimestamp(ld.at)}`));
           }
           process.exitCode = 1;
         }
@@ -3528,7 +3753,7 @@ async function webhooksTest(id, opts, deps) {
     }
     if (opts.json) console.log(JSON.stringify({ status: "pending" }));
     console.error(
-      chalk20.yellow(
+      chalk21.yellow(
         `Delivery still pending after ${TEST_POLL_BUDGET_MS / 1e3}s \u2014 check \`vibeview webhooks list\` later for the result.`
       )
     );
@@ -3541,7 +3766,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(chalk20.red(`error: ${message}`));
+  console.error(chalk21.red(`error: ${message}`));
 }
 
 // src/commands/list-devices.ts
@@ -3582,7 +3807,7 @@ async function listDevicesCommand(options) {
 }
 
 // src/lib/metadata.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 var MAX_METADATA_BYTES = 16384;
 var MAX_METADATA_DEPTH = 4;
 function measureDepth(value, current = 1) {
@@ -3621,7 +3846,7 @@ function parseMetadata(raw) {
 function readMetadataFile(path) {
   let raw;
   try {
-    raw = readFileSync2(path, "utf8");
+    raw = readFileSync3(path, "utf8");
   } catch (e) {
     throw new Error(`failed to read --metadata-file ${path}: ${e.message}`);
   }
@@ -3633,27 +3858,27 @@ function readMetadataFile(path) {
 }
 
 // src/commands/agent-setup.ts
-import { copyFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
+import { copyFileSync, existsSync as existsSync3, mkdirSync as mkdirSync2 } from "fs";
 import { homedir } from "os";
-import { dirname, join as join2 } from "path";
+import { dirname, join as join3 } from "path";
 import { fileURLToPath } from "url";
 import { spawnSync } from "child_process";
 import { confirm } from "@inquirer/prompts";
-import chalk21 from "chalk";
+import chalk22 from "chalk";
 function resolveShippedSkillPath(fromDir) {
-  for (const rel of ["..", join2("..", "..")]) {
-    const candidate = join2(fromDir, rel, "skills", "vibeview-agent", "SKILL.md");
-    if (existsSync2(candidate)) return candidate;
+  for (const rel of ["..", join3("..", "..")]) {
+    const candidate = join3(fromDir, rel, "skills", "vibeview-agent", "SKILL.md");
+    if (existsSync3(candidate)) return candidate;
   }
   return null;
 }
 function skillInstallDir(project, cwd, home) {
   const base = project ? cwd : home;
-  return join2(base, ".claude", "skills", "vibeview-agent");
+  return join3(base, ".claude", "skills", "vibeview-agent");
 }
 function installSkill(shippedPath, targetDir) {
-  const target = join2(targetDir, "SKILL.md");
-  const existed = existsSync2(target);
+  const target = join3(targetDir, "SKILL.md");
+  const existed = existsSync3(target);
   mkdirSync2(targetDir, { recursive: true });
   copyFileSync(shippedPath, target);
   return existed ? "updated" : "installed";
@@ -3669,23 +3894,23 @@ function registerMcp() {
     encoding: "utf8"
   });
   if (res.status === 0) {
-    console.log(chalk21.green("\u2713 MCP server registered with Claude Code (claude mcp add vibeview)"));
+    console.log(chalk22.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(chalk21.dim("MCP server already registered with Claude Code \u2014 nothing to do"));
+    console.log(chalk22.dim("MCP server already registered with Claude Code \u2014 nothing to do"));
     return;
   }
-  console.error(chalk21.yellow(`\u26A0 could not register the MCP server: ${out.trim() || res.error}`));
-  console.error(chalk21.yellow(`  register it manually: ${MCP_ADD_HINT}`));
+  console.error(chalk22.yellow(`\u26A0 could not register the MCP server: ${out.trim() || res.error}`));
+  console.error(chalk22.yellow(`  register it manually: ${MCP_ADD_HINT}`));
 }
 async function agentSetup(opts) {
   const moduleDir = dirname(fileURLToPath(import.meta.url));
   const shipped = resolveShippedSkillPath(moduleDir);
   if (!shipped) {
     console.error(
-      chalk21.red(
+      chalk22.red(
         "error: could not find the packaged skill (skills/vibeview-agent/SKILL.md) \u2014 is this a complete install of the vibeview package?"
       )
     );
@@ -3694,9 +3919,9 @@ async function agentSetup(opts) {
   }
   const targetDir = skillInstallDir(opts.project ?? false, process.cwd(), homedir());
   const result = installSkill(shipped, targetDir);
-  console.log(chalk21.green(`\u2713 vibeview-agent skill ${result}: ${join2(targetDir, "SKILL.md")}`));
+  console.log(chalk22.green(`\u2713 vibeview-agent skill ${result}: ${join3(targetDir, "SKILL.md")}`));
   console.log(
-    chalk21.dim(
+    chalk22.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."
     )
   );
@@ -3704,7 +3929,7 @@ async function agentSetup(opts) {
     if (!claudeCliAvailable()) {
       if (opts.mcp === true) {
         console.error(
-          chalk21.yellow(`\u26A0 claude CLI not found \u2014 install Claude Code, then run: ${MCP_ADD_HINT}`)
+          chalk22.yellow(`\u26A0 claude CLI not found \u2014 install Claude Code, then run: ${MCP_ADD_HINT}`)
         );
       }
     } else if (opts.mcp === true || process.stdin.isTTY && await confirm({
@@ -3716,7 +3941,7 @@ async function agentSetup(opts) {
   }
   console.log(
     `
-Suggested line for your project's ${chalk21.bold("CLAUDE.md")} (or ${chalk21.bold(
+Suggested line for your project's ${chalk22.bold("CLAUDE.md")} (or ${chalk22.bold(
       "AGENTS.md"
     )} for other agents):
 `
@@ -3724,17 +3949,17 @@ Suggested line for your project's ${chalk21.bold("CLAUDE.md")} (or ${chalk21.bol
   console.log(`  ${CLAUDE_MD_SUGGESTION}
 `);
   console.log(
-    chalk21.dim(
+    chalk22.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"
     )
   );
 }
 
 // src/lib/update-check.ts
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync } from "fs";
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync } from "fs";
 import { homedir as homedir2 } from "os";
-import { dirname as dirname2, join as join3 } from "path";
-var CACHE_FILE = join3(homedir2(), ".vibeview", "update-check.json");
+import { dirname as dirname2, join as join4 } from "path";
+var CACHE_FILE = join4(homedir2(), ".vibeview", "update-check.json");
 var REGISTRY_URL = "https://registry.npmjs.org/vibeview/latest";
 var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
 function isNewerVersion(a, b) {
@@ -3765,7 +3990,7 @@ function updateNotice(current, latest) {
 }
 function readCache(file) {
   try {
-    const parsed = JSON.parse(readFileSync3(file, "utf8"));
+    const parsed = JSON.parse(readFileSync4(file, "utf8"));
     if (typeof parsed?.checked_at === "number" && typeof parsed?.latest === "string") {
       return parsed;
     }
@@ -3848,11 +4073,14 @@ program.command("run-suite <suite-id>").description("Run all test cases in a sui
   "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"
+  "Run the suite on another platform (ios, android, tvos, androidtv): runs your linked app on that platform, else the app 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) => {
+).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)").option(
+  "--retry",
+  "Retry a failed test once, after a fresh start of the app (off by default); a pass on the retry marks the test flaky"
+).option("--no-retry", "Deprecated: retries are off unless --retry is given (accepted, no effect)").action((suiteId, opts) => {
   if (opts.device && opts.deviceCategory) {
     process.stderr.write("error: --device cannot be combined with --device-category\n");
     process.exit(2);
@@ -3880,7 +4108,7 @@ program.command("run-suites").description("Run all suites matching a tag filter"
   []
 ).option("--match <mode>", "any (default) or all", "any").option(
   "--platform <platform>",
-  "Filter matched suites to one platform: ios, android, tvos, androidtv (default: no filter)"
+  "Filter matched suites to one platform: ios, android, tvos, androidtv, roku (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: tv for a TV platform, else phone)",
@@ -3888,13 +4116,16 @@ program.command("run-suites").description("Run all suites matching a tag filter"
 ).option(
   "--device <device_id>",
   "Pin run to a specific device (use `vibeview list-devices` to find one). Conflicts with --device-category."
-).option("--build <id>", "AppBuild id (validated against every matched suite)").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((opts) => {
+).option("--build <id>", "AppBuild id (validated against every matched suite)").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)").option(
+  "--retry",
+  "Retry a failed test once, after a fresh start of the app (off by default); a pass on the retry marks the test flaky"
+).option("--no-retry", "Deprecated: retries are off unless --retry is given (accepted, no effect)").action((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);
+    parseSuitePlatformFilter(opts.platform);
   } catch (err) {
     process.stderr.write(`error: ${err.message}
 `);
@@ -3917,11 +4148,14 @@ program.command("run-test <test-id>").description("Run a single test case").opti
   "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"
+  "Run the test on another platform (ios, android, tvos, androidtv): runs your linked app on that platform, else the app 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) => {
+).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)").option(
+  "--retry",
+  "Retry a failed test once, after a fresh start of the app (off by default); a pass on the retry marks the test flaky"
+).option("--no-retry", "Deprecated: retries are off unless --retry is given (accepted, no effect)").action((testId, opts) => {
   if (opts.device && opts.deviceCategory) {
     process.stderr.write("error: --device cannot be combined with --device-category\n");
     process.exit(2);
@@ -3969,12 +4203,18 @@ program.command("list-devices").description("List devices registered with the pl
 program.command("upload-app <file>").description(
   "Upload an app build (zipped simulator .app for iOS/tvOS, .apk for Android/Android TV, or a Roku channel .zip)"
 ).option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--name <name>", "App name (auto-detected if not provided)").option("--note <text>", "Note stored on the uploaded build (shown in the dashboard)").action((file, opts) => uploadApp(file, opts));
-program.command("create-test [name]").description("Create a standalone AI test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--app <app>", "App ID (public_id) or package name (requires --platform)").option("--platform <platform>", "Platform (ios, android) when using package name for --app").option("--steps <json>", "Test steps as inline JSON array").option("--steps-file <path>", "Path to JSON file containing test steps").option("--context <text>", "Additional context for AI test execution").option("--test-name <name>", "Test case name (alternative to positional arg)").addOption(
+program.command("create-test [name]").description("Create an AI test case, optionally in one or more groups").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--app <app>", "App ID (public_id) or package name (requires --platform)").option("--platform <platform>", "Platform (ios, android) when using package name for --app").option("--steps <json>", "Test steps as inline JSON array").option("--steps-file <path>", "Path to JSON file containing test steps").option("--context <text>", "Additional context for AI test execution").option("--test-name <name>", "Test case name (alternative to positional arg)").option(
+  "--group <id...>",
+  "Group (suite) ID to add the test to; repeat or list several. Same app as --app"
+).addOption(
   new Option(
     "--if-exists <mode>",
-    "When a standalone test with this name already exists for the app: fail, update it, or create a new one alongside it. Default: reuse an identical test, refuse a different one"
+    "When a test with this name already exists for the app (outside any group, or in one of the --group groups): fail, update it, or create a new one alongside it. Default: reuse an identical test, refuse a different one"
   ).choices(["fail", "update", "new"])
 ).action((name, opts) => createTest({ ...opts, testName: name || opts.testName || "CLI Test" }));
+program.command("import-maestro <path>").description(
+  "Import Maestro flows as tests: a flow file, a .zip of your flows folder, or the folder itself"
+).option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--app <app>", "App ID (public_id) or package name (requires --platform)").option("--platform <platform>", "Platform (ios, android) when using package name for --app").option("--group <group>", "Put the imported tests in this group (name or id)").option("--dry-run", "Show what would be imported and every flagged command; save nothing", false).action((path, opts) => importMaestro(path, opts));
 program.command("login").description("Log in to VibeView (interactive)").option("--base-url <url>", "VibeView server URL (defaults to https://vibeview.io)").action((opts) => login(opts));
 program.command("logout").description("Revoke the saved login token and remove it from ~/.vibeview/config.json").action(() => logout());
 program.command("dev").description(
@@ -4147,7 +4387,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-DF3CDWL4.js");
+  const { runMcpServer } = await import("./server-GEY4WZUH.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(