vibeview 0.25.0 → 0.27.0

package/dist/{chunk-RFFCCPGZ.js → chunk-U7FCGMWG.js}

@@ -42,6 +42,21 @@ import { createWriteStream, mkdirSync as mkdirSync2, renameSync, rmSync } from "
 import { basename, join as join2, resolve, sep } from "path";
 import { pipeline } from "stream/promises";
 import { Readable } from "stream";
+var AuthError = class extends Error {
+  constructor(message = "Authentication failed. Check your API token.") {
+    super(message);
+    this.name = "AuthError";
+  }
+};
+function errorExitCode(err, otherwise = 1) {
+  return err instanceof AuthError ? 2 : otherwise;
+}
+function reportCommandError(json, err) {
+  const message = err instanceof Error ? err.message : String(err);
+  if (json) console.log(JSON.stringify({ event: "error", message }));
+  process.stderr.write(`error: ${message}
+`);
+}
 var NotFoundError = class extends Error {
   constructor(message) {
     super(message);
@@ -52,6 +67,8 @@ function extractDetail(text) {
   try {
     const parsed = JSON.parse(text);
     if (parsed && typeof parsed.detail === "string") return parsed.detail;
+    if (parsed && parsed.detail && typeof parsed.detail.message === "string")
+      return parsed.detail.message;
   } catch {
   }
   return void 0;
@@ -96,7 +113,7 @@ var ApiClient = class {
     });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404) throw new NotFoundError(`Not found: ${extractDetail(text) ?? path}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
     }
@@ -168,7 +185,7 @@ var ApiClient = class {
     });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404) throw new NotFoundError(`Not found: ${extractDetail(text) ?? path}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
     }
@@ -188,7 +205,7 @@ var ApiClient = class {
     });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404) throw new NotFoundError(`Not found: ${extractDetail(text) ?? path}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
     }
@@ -347,7 +364,7 @@ var ApiClient = class {
     const resp = await this.fetchOrExplain(url, { method: "GET", headers });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404)
         throw new NotFoundError(`Not found: ${extractDetail(text) ?? `/builds/${id}/artifact`}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
@@ -729,6 +746,9 @@ export {
   loadConfig,
   saveConfig,
   resolveAuth,
+  AuthError,
+  errorExitCode,
+  reportCommandError,
   NotFoundError,
   ApiClient,
   createSpinner,

package/dist/cli.js

@@ -11,16 +11,19 @@ import {
   formatDeviceModelsHuman,
   formatDevicesHuman,
   formatDuration,
+  formatUtcTimestamp,
   killOwnedMetro,
   listBuilds,
   loadDevConfig,
   newTransitionState,
+  platformWithArticle,
+  pressButtonsHelp,
   printOutcomeLine,
   printTransition,
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-GEKYHEWU.js";
+} from "./chunk-46X7UN6Y.js";
 import {
   ApiClient,
   EXIT_INFRA_ERROR,
@@ -29,15 +32,17 @@ import {
   NotFoundError,
   UsageError,
   createSpinner,
+  errorExitCode,
   loadConfig,
+  reportCommandError,
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-RFFCCPGZ.js";
+} from "./chunk-U7FCGMWG.js";
 
 // src/cli.ts
 import { createRequire } from "module";
-import { Command } from "commander";
+import { Command, Option } from "commander";
 
 // src/commands/run-suite.ts
 import chalk3 from "chalk";
@@ -833,10 +838,16 @@ import chalk6 from "chalk";
 async function listSuites(options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
-  const suites = await client.listSuites({
-    tags: options.tag && options.tag.length > 0 ? options.tag : void 0,
-    match: options.match
-  });
+  let suites;
+  try {
+    suites = await client.listSuites({
+      tags: options.tag && options.tag.length > 0 ? options.tag : void 0,
+      match: options.match
+    });
+  } catch (err) {
+    reportCommandError(options.output === "json", err);
+    process.exit(EXIT_INFRA_ERROR);
+  }
   if (options.output === "json") {
     console.log(JSON.stringify(suites, null, 2));
     return;
@@ -861,7 +872,13 @@ import chalk7 from "chalk";
 async function listApps(options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
-  const apps = await client.listApps();
+  let apps;
+  try {
+    apps = await client.listApps();
+  } catch (err) {
+    reportCommandError(options.output === "json", err);
+    process.exit(EXIT_INFRA_ERROR);
+  }
   if (options.output === "json") {
     console.log(JSON.stringify(apps, null, 2));
     return;
@@ -895,7 +912,7 @@ async function stopCommand(sessionId, opts, deps) {
     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}`));
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
     return;
   }
   const state = readDevState(process.cwd());
@@ -1217,7 +1234,7 @@ async function devReload(opts) {
     fail(
       opts,
       "not_roku",
-      `dev-reload is for Roku channels; a ${state.platform} session hot-reloads through Metro on its own.`,
+      `dev-reload is for Roku channels; ${platformWithArticle(state.platform)} session hot-reloads through Metro on its own.`,
       2
     );
   }
@@ -1277,8 +1294,10 @@ import chalk13 from "chalk";
 // src/lib/formatters/builds.ts
 import chalk12 from "chalk";
 var HEADERS = ["ID", "PLATFORM", "STATUS", "CREATED", "COST", "APP"];
-function formatCostCell(costMicro) {
-  return costMicro > 0 ? `$${(costMicro / 1e6).toFixed(2)}` : "";
+var UNBILLED_STATUSES = /* @__PURE__ */ new Set(["queued", "running"]);
+function formatCostCell(costMicro, status) {
+  if (costMicro <= 0 && UNBILLED_STATUSES.has(status)) return "-";
+  return `$${(Math.max(costMicro, 0) / 1e6).toFixed(2)}`;
 }
 var STATUS_COLOR = {
   succeeded: chalk12.green,
@@ -1297,8 +1316,8 @@ function formatBuildsHuman(builds2) {
     b.id,
     b.platform,
     b.status,
-    b.created_at ?? "",
-    formatCostCell(b.cost_micro),
+    formatUtcTimestamp(b.created_at),
+    formatCostCell(b.cost_micro, b.status),
     b.app_public_id ?? ""
   ]);
   const widths = HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
@@ -1349,7 +1368,7 @@ async function buildsList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function buildsLogs(id, opts, deps) {
@@ -1372,7 +1391,7 @@ async function buildsLogs(id, opts, deps) {
     process.exitCode = final.status === "succeeded" ? 0 : 1;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 var MAX_CONSECUTIVE_POLL_FAILURES = 5;
@@ -1465,7 +1484,7 @@ async function buildsDownload(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function buildsCancel(id, opts, deps) {
@@ -1482,7 +1501,7 @@ async function buildsCancel(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function buildsDeleteArtifact(id, opts, deps) {
@@ -1499,7 +1518,7 @@ async function buildsDeleteArtifact(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function printError(opts, err) {
@@ -1691,7 +1710,7 @@ async function submitCommand(opts, deps) {
     process.exitCode = final.status === "succeeded" ? 0 : 1;
   } catch (err) {
     printError2(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
@@ -1722,7 +1741,7 @@ async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
     process.exitCode = result.ready ? 0 : 1;
   } catch (err) {
     printError2(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function resolveLatestBuild(platform, deps) {
@@ -1852,7 +1871,7 @@ async function versionsList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError3(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function versionsSet(buildNumber, opts, deps) {
@@ -1885,7 +1904,7 @@ async function versionsSet(buildNumber, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError3(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 var HEADERS2 = ["PLATFORM", "BUILD NUMBER", "UPDATED"];
@@ -1961,7 +1980,7 @@ Create an admin API token in the dashboard and use ${chalk16.bold("--token")} or
       console.log(JSON.stringify({ event: "error", message }));
     }
     console.error(chalk16.red(`error: ${message}`));
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 
@@ -2039,7 +2058,7 @@ async function envList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatEnvVarsHuman(variables) {
@@ -2088,7 +2107,7 @@ async function envSet(name, value, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function resolveVisibility(opts) {
@@ -2121,7 +2140,7 @@ async function envRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function envPull(opts, deps) {
@@ -2153,7 +2172,7 @@ async function envPull(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function isLossyEnvValue(value) {
@@ -2346,7 +2365,7 @@ async function credentialsAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function credentialsGenerate(opts, deps) {
@@ -2420,7 +2439,7 @@ async function credentialsGenerate(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function generateAppleCredential(platform, opts, d) {
@@ -2456,7 +2475,7 @@ async function generateAppleCredential(platform, opts, d) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function credentialsDownload(name, opts, deps) {
@@ -2531,7 +2550,7 @@ async function credentialsDownload(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function ascKeyAdd(opts, deps) {
@@ -2571,7 +2590,7 @@ async function ascKeyAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function ascKeyList(opts, deps) {
@@ -2586,7 +2605,7 @@ async function ascKeyList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatAscKeysHuman(keys) {
@@ -2594,7 +2613,7 @@ function formatAscKeysHuman(keys) {
     return "No App Store Connect keys found.\n";
   }
   const HEADERS3 = ["NAME", "KEY ID", "ISSUER ID", "CREATED"];
-  const rows = keys.map((k) => [k.name, k.key_id, k.issuer_id, k.created_at ?? ""]);
+  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 join3 = (cells) => cells.join("  ").trimEnd();
@@ -2614,7 +2633,7 @@ async function ascKeyRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function playKeyAdd(opts, deps) {
@@ -2647,7 +2666,7 @@ async function playKeyAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function playKeyList(opts, deps) {
@@ -2662,7 +2681,7 @@ async function playKeyList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatPlayKeysHuman(keys) {
@@ -2670,7 +2689,7 @@ function formatPlayKeysHuman(keys) {
     return "No Google Play keys found.\n";
   }
   const HEADERS3 = ["NAME", "CLIENT EMAIL", "CREATED"];
-  const rows = keys.map((k) => [k.name, k.client_email, k.created_at ?? ""]);
+  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 join3 = (cells) => cells.join("  ").trimEnd();
@@ -2690,7 +2709,7 @@ async function playKeyRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function credentialsList(opts, deps) {
@@ -2711,7 +2730,7 @@ async function credentialsList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatIdentity(c) {
@@ -2730,10 +2749,10 @@ function earliestExpiry(c) {
 function formatExpires(c) {
   const parts = [];
   if (c.profile_expires_at) {
-    if (c.expires_at) parts.push(`cert ${c.expires_at}`);
-    parts.push(`profile ${c.profile_expires_at}`);
+    if (c.expires_at) parts.push(`cert ${formatUtcTimestamp(c.expires_at)}`);
+    parts.push(`profile ${formatUtcTimestamp(c.profile_expires_at)}`);
   } else if (c.expires_at) {
-    parts.push(c.expires_at);
+    parts.push(formatUtcTimestamp(c.expires_at));
   }
   if (parts.length === 0) return "";
   const cell = parts.join(" \xB7 ");
@@ -2770,7 +2789,7 @@ async function credentialsRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function printKeystoreWriteFailure(opts, err, result) {
@@ -2848,14 +2867,14 @@ async function webhooksAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatLastDelivery(ld) {
   if (!ld) return "\u2014";
   if (ld.status === "pending") return "pending";
   const code = ld.response_code != null ? ` (${ld.response_code})` : "";
-  const at = ld.at != null ? ` ${ld.at}` : "";
+  const at = ld.at != null ? ` ${formatUtcTimestamp(ld.at)}` : "";
   return `${ld.status}${code}${at}`;
 }
 function formatWebhooksHuman(webhooks2) {
@@ -2868,7 +2887,7 @@ function formatWebhooksHuman(webhooks2) {
     w.url,
     w.active ? "yes" : "no",
     formatLastDelivery(w.last_delivery),
-    w.created_at
+    formatUtcTimestamp(w.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]));
@@ -2889,7 +2908,7 @@ async function webhooksList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function webhooksRm(id, opts, deps) {
@@ -2904,7 +2923,7 @@ async function webhooksRm(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function parseUtcTimestamp(iso) {
@@ -2938,7 +2957,7 @@ async function webhooksTest(id, opts, deps) {
         } else {
           if (!opts.json) {
             const code = ld.response_code != null ? `HTTP ${ld.response_code}` : "no response";
-            console.error(chalk19.red(`\u2717 Failed (${code}) at ${ld.at}`));
+            console.error(chalk19.red(`\u2717 Failed (${code}) at ${formatUtcTimestamp(ld.at)}`));
           }
           process.exitCode = 1;
         }
@@ -2954,7 +2973,7 @@ async function webhooksTest(id, opts, deps) {
     process.exitCode = 1;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function printError6(opts, err) {
@@ -2977,8 +2996,7 @@ async function listDevicesCommand(options) {
       }
       process.exit(EXIT_PASS);
     } catch (err) {
-      process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}
-`);
+      reportCommandError(options.output === "json", err);
       process.exit(EXIT_INFRA_ERROR);
     }
     return;
@@ -2996,8 +3014,7 @@ async function listDevicesCommand(options) {
     }
     process.exit(EXIT_PASS);
   } catch (err) {
-    process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}
-`);
+    reportCommandError(options.output === "json", err);
     process.exit(EXIT_INFRA_ERROR);
   }
 }
@@ -3270,7 +3287,11 @@ program.command("list-apps").description("List apps in your organization").optio
 program.command("list-builds <app>").description(
   "List an app's uploaded builds, newest first: id, version, platform, debug/release, upload time and note (the ids `dev --build <id>` and `run-test --build` take)"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--json", "Print the builds as a JSON array", false).action((app, opts) => listBuilds(app, opts));
-program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--type <type>", "Filter by device type: ios, android, roku").option("--category <category>", "Filter by category: phone, tablet, tv").option("--status <status>", "Filter by status: available, busy, offline").option(
+program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").addOption(
+  new Option("--type <type>", "Filter by device type").choices(["ios", "android", "roku"])
+).addOption(
+  new Option("--category <category>", "Filter by category").choices(["phone", "tablet", "tv"])
+).addOption(new Option("--status <status>", "Filter by status").choices(["available", "busy"])).option(
   "--models",
   "List the device models you can start instead (the names `dev --model` takes)",
   false
@@ -3292,7 +3313,7 @@ program.command("dev").description(
   parseDeviceCategory
 ).option(
   "--model <name>",
-  'Run on this exact device model, e.g. "iPhone Duo" (see `vibeview list-devices --models`)'
+  'Run on this exact device model, e.g. "iPhone Duo" or "Pixel 9 Pro Fold" (see `vibeview list-devices --models`)'
 ).option("--no-open", "Do not open the browser automatically").option("--debug", "Log raw tunnel lifecycle events (close codes, reconnects) for diagnostics").option("--json", "Emit line-delimited JSON events on stdout instead of human output", false).option(
   "--detach",
   "Run the dev session in the background; prints session info and exits (see `dev-status`, `dev-stop`, and `dev-reload` for Roku)",
@@ -3444,8 +3465,8 @@ 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-6EUBLXKE.js");
-  await runMcpServer(opts);
+  const { runMcpServer } = await import("./server-XJREB7KU.js");
+  await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(
   "Make VibeView discoverable to your coding agent: install the vibeview-agent skill (and optionally register the MCP server with Claude Code)"
@@ -3455,6 +3476,8 @@ for (const cmd of AGENT_COMMANDS) {
   const flagParams = cmd.params.filter((p) => p.cli !== "positional");
   const argSignature = positionalParams.map((p) => p.required ? `<${p.name}>` : `[${p.name}]`).join(" ");
   let command = program.command(argSignature ? `${cmd.verb} ${argSignature}` : cmd.verb).description(cmd.summary);
+  if (cmd.verb === "press") command.addHelpText("after", `
+${pressButtonsHelp()}`);
   for (const param of flagParams) {
     const flagArg = param.type === "number" ? `${param.cli} <n>` : `${param.cli} <value>`;
     command = command.option(flagArg, param.description);

package/dist/{server-6EUBLXKE.js → server-XJREB7KU.js}

@@ -17,14 +17,15 @@ import {
   isDevPlatform,
   loadDevConfig,
   parseBuildId,
+  platformWithArticle,
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-GEKYHEWU.js";
+} from "./chunk-46X7UN6Y.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-RFFCCPGZ.js";
+} from "./chunk-U7FCGMWG.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -87,7 +88,7 @@ var DEV_START_DEF = {
     },
     model: {
       type: "string",
-      description: 'Run on this exact device model, e.g. "iPhone Duo" for the foldable. Names come from list_device_models. Omit for a default phone (or TV on TV platforms).'
+      description: 'Run on this exact device model, e.g. "iPhone Duo" or "Pixel 9 Pro Fold" for a foldable (any model list_device_models marks form_factor "foldable"). Names come from list_device_models. Omit for a default phone (or TV on TV platforms).'
     },
     build_id: {
       type: "number",
@@ -116,7 +117,7 @@ var STOP_SESSION_DEF = {
 };
 var LIST_DEVICE_MODELS_DEF = {
   name: "list_device_models",
-  description: 'List the device models you can start right now (model, OS version, platform, category, and form_factor "foldable" for a device that folds, like the iPhone Duo). Pass a model name to dev_start to run on it.',
+  description: 'List the device models you can start right now (model, OS version, platform, category, and form_factor "foldable" for any device with a hinge \u2014 the iPhone Duo, Android foldables such as the Pixel 9 Pro Fold). Pass a model name to dev_start to run on it.',
   mutating: false,
   properties: {
     device_type: {
@@ -376,7 +377,7 @@ async function handleUploadApp(args, deps) {
   }
   const name = typeof args.name === "string" && args.name ? args.name : void 0;
   const upload = deps.uploadApp ?? (async (f, n) => {
-    const { uploadAppBuild } = await import("./upload-app-E32EZXYQ.js");
+    const { uploadAppBuild } = await import("./upload-app-QUUXKNR2.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -535,7 +536,7 @@ function createDevSessionController(auth, webUrl) {
       }
       if (target.platform !== "roku") {
         throw new Error(
-          `dev_reload is for Roku channels; a ${target.platform} session hot-reloads through Metro on its own`
+          `dev_reload is for Roku channels; ${platformWithArticle(target.platform)} session hot-reloads through Metro on its own`
         );
       }
       if (!target.build) {
@@ -577,7 +578,7 @@ async function createMcpServer(opts) {
     agentTool: client.agentTool.bind(client),
     devSession
   };
-  const server = new McpServer({ name: "vibeview", version: "1.0.0" });
+  const server = new McpServer({ name: "vibeview", version: opts.version ?? "0.0.0" });
   function zodShape(def) {
     const shape = {};
     for (const [key, prop] of Object.entries(def.properties)) {

package/dist/{upload-app-E32EZXYQ.js → upload-app-QUUXKNR2.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "VibeView CLI -- run mobile tests from CI/CD pipelines",
   "mcpName": "io.github.vibeview/vibeview",
   "type": "module",