vibeview 0.25.0 → 0.26.0

package/dist/{chunk-GEKYHEWU.js → chunk-JK3T3AMW.js}

@@ -8,163 +8,9 @@ import {
   uploadAppBuild
 } from "./chunk-RFFCCPGZ.js";
 
-// src/lib/dev-build.ts
-function parseBuildId(raw) {
-  const text = typeof raw === "number" ? String(raw) : typeof raw === "string" ? raw.trim() : "";
-  if (!/^\d+$/.test(text) || Number(text) < 1) {
-    throw new Error(
-      `--build expects a build id (a positive number, see \`vibeview list-builds <app>\`), got "${String(raw)}"`
-    );
-  }
-  return Number(text);
-}
-function buildKind(isDebug) {
-  if (isDebug === true) return "debug";
-  if (isDebug === false) return "release";
-  return "unknown";
-}
-function checkDevBuild(app, buildId, platform) {
-  if (platform === "roku") {
-    throw new Error(
-      "a build id cannot be pinned on roku \u2014 `vibeview dev` packages and sideloads the channel itself"
-    );
-  }
-  if (app.platform !== platform) {
-    throw new Error(`app ${app.public_id} is a ${app.platform} app, not ${platform}`);
-  }
-  const build = app.builds.find((b) => b.id === buildId);
-  if (!build) {
-    throw new Error(
-      `build ${buildId} is not a build of app ${app.public_id} \u2014 see \`vibeview list-builds ${app.public_id}\``
-    );
-  }
-  if (build.is_debug !== true) {
-    const why = build.is_debug === false ? "it runs standalone (a release build, or one with an embedded JS bundle)" : "it could not be identified as a Metro debug build";
-    throw new Error(
-      `build ${buildId} is not a debug build \u2014 ${why}. \`vibeview dev\` needs a ${platform} debug simulator/emulator build without an embedded JS bundle (see \`vibeview list-builds ${app.public_id}\`)`
-    );
-  }
-  return build;
-}
-
-// src/commands/list-builds.ts
-import chalk from "chalk";
-function buildRows(app) {
-  return app.builds.map((b) => ({
-    id: b.id,
-    version: b.version ?? null,
-    build_number: b.build_number ?? null,
-    platform: app.platform,
-    kind: buildKind(b.is_debug),
-    is_debug: b.is_debug ?? null,
-    uploaded_at: b.uploaded_at ?? null,
-    note: b.note ?? null
-  }));
-}
-var HEADERS = ["ID", "VERSION", "PLATFORM", "KIND", "UPLOADED", "NOTE"];
-function formatBuildRowsHuman(app, rows) {
-  if (rows.length === 0) {
-    return `No builds uploaded for ${app.name} (${app.public_id}) \u2014 upload one with \`vibeview upload-app\`.
-`;
-  }
-  const cells = rows.map((r) => [
-    String(r.id),
-    r.version ? `${r.version}${r.build_number ? ` (${r.build_number})` : ""}` : r.build_number ?? "",
-    r.platform,
-    r.kind,
-    r.uploaded_at ?? "",
-    (r.note ?? "").split("\n")[0]
-  ]);
-  const widths = HEADERS.map((h, i) => Math.max(h.length, ...cells.map((c) => c[i].length)));
-  const pad = (row) => row.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
-  const lines = [chalk.bold(pad(HEADERS)), ...cells.map(pad)];
-  return lines.join("\n") + "\n";
-}
-async function listBuilds(appId, opts, deps) {
-  const { token, baseUrl } = resolveAuth(opts);
-  const d = deps ?? { getApp: (id) => new ApiClient(baseUrl, token).getApp(id) };
-  try {
-    const app = await d.getApp(appId);
-    const rows = buildRows(app);
-    if (opts.json) {
-      console.log(JSON.stringify(rows, null, 2));
-    } else {
-      process.stdout.write(formatBuildRowsHuman(app, rows));
-    }
-    process.exitCode = 0;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (opts.json) console.log(JSON.stringify({ event: "error", message }));
-    console.error(chalk.red(`error: ${message}`));
-    process.exitCode = 1;
-  }
-}
-
-// src/lib/dev-state.ts
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
-var STATE_DIR = ".vibeview";
-var STATE_FILE = "dev-state.json";
-function statePath(cwd) {
-  return join(cwd, STATE_DIR, STATE_FILE);
-}
-function isPidAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (err) {
-    return err.code === "EPERM";
-  }
-}
-function ensureGitignored(cwd) {
-  try {
-    const gitignore = join(cwd, ".gitignore");
-    if (!existsSync(gitignore)) return;
-    const content = readFileSync(gitignore, "utf-8");
-    const covered = content.split("\n").map((l) => l.trim()).some((l) => l === ".vibeview" || l === ".vibeview/" || l === "/.vibeview");
-    if (covered) return;
-    const prefix = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
-    writeFileSync(gitignore, `${content}${prefix}
-# VibeView local session state
-.vibeview/
-`);
-  } catch {
-  }
-}
-function writeDevState(cwd, state) {
-  const path = statePath(cwd);
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, JSON.stringify(state, null, 2) + "\n");
-  ensureGitignored(cwd);
-}
-function readDevState(cwd) {
-  let raw;
-  try {
-    raw = readFileSync(statePath(cwd), "utf-8");
-  } catch {
-    return null;
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return null;
-  }
-  if (typeof parsed.pid !== "number" || !isPidAlive(parsed.pid)) {
-    return null;
-  }
-  return parsed;
-}
-function clearDevState(cwd) {
-  const path = statePath(cwd);
-  if (existsSync(path)) {
-    rmSync(path, { force: true });
-  }
-}
-
 // src/lib/dev-config.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { readFileSync, writeFileSync } from "fs";
+import { join } from "path";
 var DEV_PLATFORMS = ["ios", "android", "tvos", "androidtv", "roku"];
 var ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var PLATFORM_NEEDS_METRO = {
@@ -178,10 +24,25 @@ var FILE = "vibeview.json";
 function isDevPlatform(p) {
   return typeof p === "string" && DEV_PLATFORMS.includes(p);
 }
+var PLATFORM_LABELS = {
+  ios: "iOS",
+  android: "Android",
+  tvos: "tvOS",
+  androidtv: "Android TV",
+  roku: "Roku"
+};
+function platformLabel(platform) {
+  return isDevPlatform(platform) ? PLATFORM_LABELS[platform] : platform;
+}
+function platformWithArticle(platform) {
+  const label = platformLabel(platform);
+  const article = /^[aeiou]/i.test(label) ? "an" : "a";
+  return `${article} ${label}`;
+}
 function loadDevConfig(cwd) {
   let raw;
   try {
-    raw = readFileSync2(join2(cwd, FILE), "utf-8");
+    raw = readFileSync(join(cwd, FILE), "utf-8");
   } catch {
     return null;
   }
@@ -298,7 +159,7 @@ function validateBuildEnv(env, platformKey) {
   }
 }
 function saveDevConfig(cwd, cfg) {
-  writeFileSync2(join2(cwd, FILE), JSON.stringify(cfg, null, 2) + "\n");
+  writeFileSync(join(cwd, FILE), JSON.stringify(cfg, null, 2) + "\n");
 }
 function resolveMetro(cfg, platform, portFlag) {
   const entry = cfg?.platforms?.[platform];
@@ -342,6 +203,162 @@ function buildSavedConfig(input2) {
   };
 }
 
+// src/lib/dev-build.ts
+function parseBuildId(raw) {
+  const text = typeof raw === "number" ? String(raw) : typeof raw === "string" ? raw.trim() : "";
+  if (!/^\d+$/.test(text) || Number(text) < 1) {
+    throw new Error(
+      `--build expects a build id (a positive number, see \`vibeview list-builds <app>\`), got "${String(raw)}"`
+    );
+  }
+  return Number(text);
+}
+function buildKind(isDebug) {
+  if (isDebug === true) return "debug";
+  if (isDebug === false) return "release";
+  return "unknown";
+}
+function checkDevBuild(app, buildId, platform) {
+  if (platform === "roku") {
+    throw new Error(
+      "a build id cannot be pinned on roku \u2014 `vibeview dev` packages and sideloads the channel itself"
+    );
+  }
+  if (app.platform !== platform) {
+    throw new Error(
+      `app ${app.public_id} is ${platformWithArticle(app.platform)} app, not ${platformLabel(platform)}`
+    );
+  }
+  const build = app.builds.find((b) => b.id === buildId);
+  if (!build) {
+    throw new Error(
+      `build ${buildId} is not a build of app ${app.public_id} \u2014 see \`vibeview list-builds ${app.public_id}\``
+    );
+  }
+  if (build.is_debug !== true) {
+    const why = build.is_debug === false ? "it runs standalone (a release build, or one with an embedded JS bundle)" : "it could not be identified as a Metro debug build";
+    throw new Error(
+      `build ${buildId} is not a debug build \u2014 ${why}. \`vibeview dev\` needs ${platformWithArticle(platform)} debug simulator/emulator build without an embedded JS bundle (see \`vibeview list-builds ${app.public_id}\`)`
+    );
+  }
+  return build;
+}
+
+// src/commands/list-builds.ts
+import chalk from "chalk";
+function buildRows(app) {
+  return app.builds.map((b) => ({
+    id: b.id,
+    version: b.version ?? null,
+    build_number: b.build_number ?? null,
+    platform: app.platform,
+    kind: buildKind(b.is_debug),
+    is_debug: b.is_debug ?? null,
+    uploaded_at: b.uploaded_at ?? null,
+    note: b.note ?? null
+  }));
+}
+var HEADERS = ["ID", "VERSION", "PLATFORM", "KIND", "UPLOADED", "NOTE"];
+function formatBuildRowsHuman(app, rows) {
+  if (rows.length === 0) {
+    return `No builds uploaded for ${app.name} (${app.public_id}) \u2014 upload one with \`vibeview upload-app\`.
+`;
+  }
+  const cells = rows.map((r) => [
+    String(r.id),
+    r.version ? `${r.version}${r.build_number ? ` (${r.build_number})` : ""}` : r.build_number ?? "",
+    r.platform,
+    r.kind,
+    r.uploaded_at ?? "",
+    (r.note ?? "").split("\n")[0]
+  ]);
+  const widths = HEADERS.map((h, i) => Math.max(h.length, ...cells.map((c) => c[i].length)));
+  const pad = (row) => row.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
+  const lines = [chalk.bold(pad(HEADERS)), ...cells.map(pad)];
+  return lines.join("\n") + "\n";
+}
+async function listBuilds(appId, opts, deps) {
+  const { token, baseUrl } = resolveAuth(opts);
+  const d = deps ?? { getApp: (id) => new ApiClient(baseUrl, token).getApp(id) };
+  try {
+    const app = await d.getApp(appId);
+    const rows = buildRows(app);
+    if (opts.json) {
+      console.log(JSON.stringify(rows, null, 2));
+    } else {
+      process.stdout.write(formatBuildRowsHuman(app, rows));
+    }
+    process.exitCode = 0;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (opts.json) console.log(JSON.stringify({ event: "error", message }));
+    console.error(chalk.red(`error: ${message}`));
+    process.exitCode = 1;
+  }
+}
+
+// src/lib/dev-state.ts
+import { existsSync, mkdirSync, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "fs";
+import { dirname, join as join2 } from "path";
+var STATE_DIR = ".vibeview";
+var STATE_FILE = "dev-state.json";
+function statePath(cwd) {
+  return join2(cwd, STATE_DIR, STATE_FILE);
+}
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err.code === "EPERM";
+  }
+}
+function ensureGitignored(cwd) {
+  try {
+    const gitignore = join2(cwd, ".gitignore");
+    if (!existsSync(gitignore)) return;
+    const content = readFileSync2(gitignore, "utf-8");
+    const covered = content.split("\n").map((l) => l.trim()).some((l) => l === ".vibeview" || l === ".vibeview/" || l === "/.vibeview");
+    if (covered) return;
+    const prefix = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+    writeFileSync2(gitignore, `${content}${prefix}
+# VibeView local session state
+.vibeview/
+`);
+  } catch {
+  }
+}
+function writeDevState(cwd, state) {
+  const path = statePath(cwd);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync2(path, JSON.stringify(state, null, 2) + "\n");
+  ensureGitignored(cwd);
+}
+function readDevState(cwd) {
+  let raw;
+  try {
+    raw = readFileSync2(statePath(cwd), "utf-8");
+  } catch {
+    return null;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  if (typeof parsed.pid !== "number" || !isPidAlive(parsed.pid)) {
+    return null;
+  }
+  return parsed;
+}
+function clearDevState(cwd) {
+  const path = statePath(cwd);
+  if (existsSync(path)) {
+    rmSync(path, { force: true });
+  }
+}
+
 // src/lib/metro-check.ts
 async function checkMetro(port, timeoutMs = 1500) {
   try {
@@ -871,7 +888,7 @@ function runTar(args) {
 var CLOUD_PLATFORMS = ["ios", "android", "tvos", "androidtv"];
 var PRODUCTION_SIGNING_PLATFORMS = ["ios", "android", "androidtv", "tvos"];
 function productionUnsupportedReason(platform) {
-  return `--production doesn't support ${platform} \u2014 production signing supports ${PRODUCTION_SIGNING_PLATFORMS.join(", ")}`;
+  return `--production doesn't support ${platformLabel(platform)} \u2014 production signing supports ${PRODUCTION_SIGNING_PLATFORMS.join(", ")}`;
 }
 function isCloudPlatform(p) {
   return CLOUD_PLATFORMS.includes(p);
@@ -898,7 +915,7 @@ async function runBuildForPlatform(cwd, platform, build, opts, log, deps = { upl
     const { result } = await deps.upload(uploadPath, opts);
     if (result.platform !== platform) {
       throw new Error(
-        `you built an ${result.platform} app (${result.name}) but the target platform is ${platform} \u2014 check platforms.${platform}.build in vibeview.json`
+        `you built ${platformWithArticle(result.platform)} app (${result.name}) but the target platform is ${platformLabel(platform)} \u2014 check platforms.${platform}.build in vibeview.json`
       );
     }
     return result;
@@ -1135,7 +1152,7 @@ function requireCloudCapable(opts, platform) {
   if (!isCloudPlatform(platform)) {
     fail(
       opts,
-      `cloud builds don't support ${platform} \u2014 pass one of ${CLOUD_PLATFORMS.join(", ")}`
+      `cloud builds don't support ${platformLabel(platform)} \u2014 pass one of ${CLOUD_PLATFORMS.join(", ")}`
     );
   }
 }
@@ -2393,13 +2410,9 @@ function buildAppStrategy(apps, buildFlag, json, isTTY) {
   if (json || !isTTY) return "pick";
   return "ask";
 }
-function requireNonInteractive(json) {
+function requireNonInteractive(json, message) {
   if (!json) return;
-  emit(json, {
-    event: "error",
-    code: "config_required",
-    message: "pass --platform and run once interactively, or commit vibeview.json"
-  });
+  emit(json, { event: "error", code: "config_required", message });
   process.exit(1);
 }
 async function ensureConfig(api, opts) {
@@ -2409,7 +2422,10 @@ async function ensureConfig(api, opts) {
     process.exit(2);
   }
   if (!opts.platform && !existing?.defaultPlatform) {
-    requireNonInteractive(opts.json);
+    requireNonInteractive(
+      opts.json,
+      `--platform is required (no vibeview.json default yet) \u2014 pass --platform <${DEV_PLATFORMS.join("|")}>, or run once interactively to set a default.`
+    );
   }
   const platform = opts.platform || existing?.defaultPlatform || await select3({
     message: "Platform to run on",
@@ -2441,9 +2457,7 @@ async function ensureConfig(api, opts) {
   let isFirstRun = false;
   if (!existing) {
     isFirstRun = true;
-    if (opts.json) {
-      requireNonInteractive(opts.json);
-    } else if (process.stdin.isTTY) {
+    if (!opts.json && process.stdin.isTTY) {
       firstRunBuild = await promptBuildConfig(process.cwd(), platform);
       if (PLATFORM_NEEDS_METRO[platform]) {
         firstRunMetro = await promptMetroCommand(process.cwd(), platform);
@@ -2524,7 +2538,10 @@ Run \`vibeview dev\` without --app to pick from the list.`
       emit(opts.json, { event: "error", code: "app_deleted", message });
       process.exit(1);
     }
-    requireNonInteractive(opts.json);
+    requireNonInteractive(
+      opts.json,
+      `--app is required \u2014 no app configured for ${platform} yet; pass --app <id> (see \`vibeview list-apps\`), or run interactively to pick one.`
+    );
     if (!process.stdin.isTTY) {
       console.error(
         chalk4.red(
@@ -2559,6 +2576,7 @@ Run \`vibeview dev\` without --app to pick from the list.`
   });
   saveDevConfig(process.cwd(), cfg);
   if (isFirstRun) {
+    console.error(chalk4.dim(`Created vibeview.json (platform: ${platform}, app: ${appId}).`));
     const hint = fillLaterHint(
       { build: !firstRunBuild, metro: PLATFORM_NEEDS_METRO[platform] && !firstRunMetro },
       platform
@@ -2708,7 +2726,7 @@ async function runDevInProcess(opts) {
   }
   console.error(
     chalk4.dim(
-      `Starting a ${cfg.platform} dev session for ${cfg.appId}${pinnedBuildId !== void 0 ? ` (build ${pinnedBuildId})` : ""}...`
+      `Starting ${platformWithArticle(cfg.platform)} dev session for ${cfg.appId}${pinnedBuildId !== void 0 ? ` (build ${pinnedBuildId})` : ""}...`
     )
   );
   let stopping = false;
@@ -3360,7 +3378,7 @@ var AGENT_COMMANDS = [
     // Foldable devices only.
     verb: "set-posture",
     tool: "set_posture",
-    summary: "Fold or unfold a foldable device (iPhone Duo): a preset (closed, partial, open) or an exact hinge angle in degrees (--angle 0-180) \u2014 pass exactly one. Reports the posture it settled in, the angle, and which screen is lit. Errors on a device without a hinge.",
+    summary: "Fold or unfold a foldable device (form factor `foldable` in `list-devices --models` \u2014 the iPhone Duo, Android foldables such as the Pixel 9 Pro Fold): a preset (closed, partial, open) or an exact hinge angle in degrees (--angle 0-180) \u2014 pass exactly one. Reports the posture it settled in, the angle, and which screen is lit. Errors on a device without a hinge.",
     mutating: true,
     params: [
       {
@@ -3386,7 +3404,7 @@ var AGENT_COMMANDS = [
     // portrait <-> landscape and accepts only 90. Refused on TV devices.
     verb: "rotate",
     tool: "rotate",
-    summary: "Rotate the device. A phone toggles between portrait and landscape; a foldable (iPhone Duo) turns a quarter clockwise, or by --degrees 180/270. Reports the new orientation. Not available on TV devices.",
+    summary: "Rotate the device. A phone (and an Android foldable) toggles between portrait and landscape; the iPhone Duo turns a quarter clockwise, or by --degrees 180/270. Reports the new orientation. Not available on TV devices.",
     mutating: true,
     params: [
       {
@@ -3394,7 +3412,7 @@ var AGENT_COMMANDS = [
         cli: "--degrees",
         type: "number",
         required: false,
-        description: "Foldable only: 90 (default, a quarter turn clockwise), 180, or 270 (a quarter turn back). A phone accepts only 90."
+        description: "iPhone Duo only: 90 (default, a quarter turn clockwise), 180, or 270 (a quarter turn back). Other devices accept only 90."
       }
     ]
   },
@@ -3806,6 +3824,11 @@ async function runAgentVerb(cmd, positionals, opts) {
 }
 
 export {
+  DEV_PLATFORMS,
+  PLATFORM_NEEDS_METRO,
+  isDevPlatform,
+  platformWithArticle,
+  loadDevConfig,
   parseBuildId,
   checkDevBuild,
   buildRows,
@@ -3815,10 +3838,6 @@ export {
   clearDevState,
   readMetroState,
   killOwnedMetro,
-  DEV_PLATFORMS,
-  PLATFORM_NEEDS_METRO,
-  isDevPlatform,
-  loadDevConfig,
   checkMetro,
   buildCommand,
   formatDuration,

package/dist/cli.js

@@ -15,12 +15,13 @@ import {
   listBuilds,
   loadDevConfig,
   newTransitionState,
+  platformWithArticle,
   printOutcomeLine,
   printTransition,
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-GEKYHEWU.js";
+} from "./chunk-JK3T3AMW.js";
 import {
   ApiClient,
   EXIT_INFRA_ERROR,
@@ -1217,7 +1218,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
     );
   }
@@ -3292,7 +3293,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,7 +3445,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-6EUBLXKE.js");
+  const { runMcpServer } = await import("./server-KYDTXPRZ.js");
   await runMcpServer(opts);
 });
 program.command("agent-setup").description(

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

@@ -17,10 +17,11 @@ import {
   isDevPlatform,
   loadDevConfig,
   parseBuildId,
+  platformWithArticle,
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-GEKYHEWU.js";
+} from "./chunk-JK3T3AMW.js";
 import {
   ApiClient,
   resolveAuth
@@ -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: {
@@ -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) {

package/package.json

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

package/skills/vibeview-agent/SKILL.md

@@ -38,10 +38,17 @@ https://vibeview.io/docs/preparing-your-build.
    ```
 2. Start Metro in the React Native project (`yarn start` or equivalent) and
    leave it running.
-3. Start a dev session in the background and get structured output:
+3. Start a dev session in the background and get structured output. No
+   `vibeview.json` yet in this project (first run here)? Pass `--platform`
+   and `--app` explicitly — non-interactive runs never prompt, so both must
+   be given up front (`--app` is `app_id` from step 1's upload output):
    ```bash
-   vibeview dev --detach --json
+   vibeview dev --platform ios --app <app_id> --detach --json
    ```
+   Once `vibeview.json` exists (this run or an earlier one), a bare
+   `vibeview dev --detach --json` reruns the same platform/app. A
+   `{"event":"error","code":"config_required",...}` line names exactly what's
+   still missing (usually `--platform` or `--app`) — pass it and retry.
 4. Parse the `session_ready` line from stdout:
    ```json
    {"event":"session_ready","session_id":"...","url":"...","pid":1234}
@@ -156,20 +163,29 @@ it rather than letting it appear unexplained in their `git status`.
   (`dpad_up`/`dpad_down`/`dpad_left`/`dpad_right`/`dpad_center`), or move
   focus directly with `tap-focused` (moves focus AND activates) / `focus`
   (moves focus only, no activation).
-- **Foldable (iPhone Duo)**: start on it by model name —
-  `vibeview dev --detach --json --model "iPhone Duo"` (MCP: `dev_start` with
-  `model`). Exact names come from `vibeview list-devices --models` (MCP:
-  `list_device_models`); a foldable is marked `foldable`. It starts closed, on
-  the cover screen. Fold with a preset or an exact hinge angle, and rotate:
+- **Foldables**: any model `vibeview list-devices --models` (MCP:
+  `list_device_models`) marks form factor `foldable` — the iPhone Duo,
+  Android foldables such as the Pixel 9 Pro Fold. Start on one by its exact
+  model name from that list, e.g.
+  `vibeview dev --detach --json --model "iPhone Duo"` or
+  `vibeview dev --platform android --detach --json --model "Pixel 9 Pro Fold"`
+  (MCP: `dev_start` with `model`). It starts closed, on the cover screen. Fold with a preset
+  or an exact hinge angle, and rotate:
   ```bash
   vibeview set-posture open --session <id>        # closed | partial | open
   vibeview set-posture --angle 75 --session <id>  # 0 (shut) to 180 (flat)
-  vibeview rotate --session <id>                  # quarter turn clockwise
-  vibeview rotate --degrees 270 --session <id>    # quarter turn back (180: half)
+  vibeview rotate --session <id>                  # Duo: quarter turn clockwise
+  vibeview rotate --degrees 270 --session <id>    # Duo: quarter turn back (180: half)
   ```
   Each response says where the device ended up — posture, angle and which
-  screen is lit (`cover` or `inner`; the device decides — a small angle can
-  keep the inner screen lit on the way down), or the new orientation. Folding
+  screen is lit (`cover` or `inner`; the device decides — on the Duo a small
+  angle can keep the inner screen lit on the way down), or the new
+  orientation. The posture names come from each device's own angle ranges,
+  so trust the reported `posture` over the angle you asked for: the Duo
+  reads 120-169 as `partial`, 170 up as `open`, and 1-119 by direction of
+  travel; an Android foldable uses its own ranges (the Pixel 9 Pro Fold: below
+  30 `closed`, 30-149 `partial`, 150 up `open`) and its inner screen whenever
+  it is not closed. An Android foldable rotates like a phone. Folding
   switches screens of different sizes and rotating turns the picture, so run
   `ui-tree` afterwards — old refs are stale. On other phones and tablets
   `rotate` toggles portrait/landscape (only 90 is accepted); TV devices don't
@@ -243,8 +259,8 @@ human-readable text.
 | `clear-text` | — | Clear the text in the currently focused input field. |
 | `press` | `<button>` | Press a device button or perform a system gesture (home, back, d-pad, etc). |
 | `open-url` | `<url>` | Open a deep link or URL in the app under test. |
-| `set-posture` | `<closed\|partial\|open>` or `--angle <0-180>` | Fold or unfold a foldable device (iPhone Duo) to a preset or an exact hinge angle — exactly one. Reports posture, angle and lit screen. Errors on a device without a hinge. |
-| `rotate` | `[--degrees <90\|180\|270>]` | Rotate the device and report the new orientation. Phones/tablets toggle portrait/landscape (90 only); a foldable turns a quarter clockwise by default. Not on TV. |
+| `set-posture` | `<closed\|partial\|open>` or `--angle <0-180>` | Fold or unfold a foldable device (form factor `foldable`: the iPhone Duo, Android foldables) to a preset or an exact hinge angle — exactly one. Reports posture, angle and lit screen. Errors on a device without a hinge. |
+| `rotate` | `[--degrees <90\|180\|270>]` | Rotate the device and report the new orientation. Phones/tablets and Android foldables toggle portrait/landscape (90 only); the iPhone Duo turns a quarter clockwise by default. Not on TV. |
 | `wait` | `[--ms <n>]` | Wait for a specified number of seconds before continuing (default: 2s). |
 | `find` | `<text>` `[--below <text>] [--above <text>] [--near <text>]` | Find an element by text with optional spatial constraints. |
 | `tap-focused` | `<ref>` | TV: move focus to an element and press SELECT in one step. |