vibeview 0.33.0 → 0.34.0

package/dist/{chunk-D3OZPFJ3.js → chunk-TPZG7NCU.js}

@@ -384,6 +384,80 @@ function buildLabel(b) {
   if (b.note) parts.push(JSON.stringify(b.note.length > 60 ? `${b.note.slice(0, 57)}...` : b.note));
   return `${b.id} (${parts.join(", ")})`;
 }
+function startedBuild(b) {
+  return {
+    id: b.id,
+    version: b.version ?? null,
+    build_number: b.build_number ?? null,
+    kind: buildKind(b),
+    uploaded_at: b.uploaded_at ?? null,
+    note: b.note ?? null
+  };
+}
+function otherDebugBuilds(app, installedId) {
+  const builds = debugBuildsNewestFirst(app);
+  const installed = app.builds.find((b) => b.id === installedId);
+  const seen = /* @__PURE__ */ new Set();
+  if (installed) seen.add(installed.version ?? "");
+  const out = [];
+  for (const b of builds) {
+    if (b.id === installedId) continue;
+    const key = b.version ?? "";
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(b);
+  }
+  return out;
+}
+function preferDevBuild(app, pinned, project) {
+  if (pinned !== void 0 || !app) return { buildId: pinned, reason: null };
+  const picked = pickDevBuild(app, project?.version ?? null);
+  return picked?.reason ? { buildId: picked.build.id, reason: picked.reason } : { buildId: void 0, reason: null };
+}
+function describeDevBuild(app, session, pick, project) {
+  const installedId = session?.app_build_id ?? pick.buildId ?? null;
+  const installed = app?.builds.find((b) => b.id === installedId);
+  const build = installed ? startedBuild(installed) : typeof installedId === "number" ? {
+    id: installedId,
+    version: session?.app_version ?? null,
+    build_number: session?.app_build_number ?? null,
+    kind: "unknown",
+    uploaded_at: null,
+    note: null
+  } : null;
+  return {
+    build,
+    reason: pick.reason,
+    pinned: pick.pinned,
+    other_debug_builds: app ? otherDebugBuilds(app, installedId).map(startedBuild) : [],
+    project
+  };
+}
+function buildLines(choice, opts) {
+  const lines = [];
+  if (!choice) return lines;
+  if (choice.build) lines.push(`build: ${buildLabel(choice.build)}`);
+  if (choice.reason) lines.push(`picked that build because ${choice.reason}`);
+  const project = choice.project;
+  if (!opts.standalone && !choice.pinned && !choice.reason && project && !project.version) {
+    const why = project.versionUnreadable ? ` (${project.versionUnreadable})` : "";
+    lines.push(
+      `couldn't read this project's app version${why}, so this is the newest debug build, not necessarily one of this version`
+    );
+  }
+  if (choice.other_debug_builds.length > 0) {
+    lines.push(
+      `other debug builds: ${choice.other_debug_builds.map((b) => buildLabel(b)).join("; ")} \u2014 pass ${opts.flag} to run one`
+    );
+  }
+  const rn = project?.reactNative;
+  if (!opts.standalone && rn) {
+    lines.push(
+      `this project: react-native ${rn}${project?.version ? `, version ${project.version}` : ""}. If the app shows a red error screen right after it starts (for example "React Native version mismatch", or "undefined is not a function" inside a native module), the build may have been made from other native code than this project \u2014 try a build of this project (${opts.flag}, see ${opts.listBuilds}).`
+    );
+  }
+  return lines;
+}
 
 // src/commands/list-builds.ts
 import chalk from "chalk";
@@ -628,7 +702,18 @@ function describeLocalChanges(before, after) {
   return changes;
 }
 
+// src/commands/build.ts
+import { spawn as spawn2 } from "child_process";
+import { createInterface } from "readline";
+import { select as select2 } from "@inquirer/prompts";
+import chalk3 from "chalk";
+
+// src/lib/dev-setup.ts
+import chalk2 from "chalk";
+import { input, select } from "@inquirer/prompts";
+
 // src/lib/project-detect.ts
+import { execFile } from "child_process";
 import { existsSync as existsSync2, readFileSync as readFileSync4, readdirSync, statSync } from "fs";
 import { join as join4 } from "path";
 import ignore from "ignore";
@@ -828,16 +913,64 @@ function pbxprojText(cwd) {
     return null;
   }
 }
-function localAppIdentity(cwd, platform) {
+var readExpoConfig = (cwd) => {
+  const cli = join4(cwd, "node_modules", "expo", "bin", "cli");
+  if (!existsSync2(cli)) {
+    return Promise.reject(new Error("Expo is not installed in this project (node_modules/expo)"));
+  }
+  return new Promise((resolve, reject) => {
+    execFile(
+      process.execPath,
+      [cli, "config", "--json", "--type", "public"],
+      {
+        cwd,
+        timeout: 3e4,
+        maxBuffer: 8 * 1024 * 1024,
+        env: { ...process.env, EXPO_NO_TELEMETRY: "1", CI: "1" }
+      },
+      (err, stdout, stderr) => {
+        if (err) {
+          const why = String(stderr || err.message).split("\n").map((l) => l.trim()).find((l) => l.length > 0);
+          reject(new Error(`expo config failed${why ? `: ${why}` : ""}`));
+          return;
+        }
+        try {
+          const parsed = JSON.parse(stdout);
+          if (parsed && typeof parsed === "object") resolve(parsed);
+          else reject(new Error("expo config printed no config"));
+        } catch {
+          reject(new Error("expo config printed something that is not JSON"));
+        }
+      }
+    );
+  });
+};
+async function localAppIdentity(cwd, platform, readConfig = readExpoConfig) {
   const rn = readJson(cwd, "node_modules/react-native/package.json");
   const reactNative = typeof rn?.version === "string" ? rn.version : null;
   const android = platform === "android" || platform === "androidtv";
   const ios = platform === "ios" || platform === "tvos";
   let version = null;
   let bundleId = null;
-  const dynamic = existsSync2(join4(cwd, "app.config.js")) || existsSync2(join4(cwd, "app.config.ts"));
-  const raw = dynamic ? null : readJson(cwd, "app.config.json") ?? readJson(cwd, "app.json");
-  const expo = raw ? "expo" in raw ? raw.expo : raw : null;
+  let versionUnreadable = null;
+  const dynamicName = ["app.config.ts", "app.config.js", "app.config.mjs", "app.config.cjs"].find(
+    (f) => existsSync2(join4(cwd, f))
+  );
+  const staticRaw = readJson(cwd, "app.config.json") ?? readJson(cwd, "app.json");
+  const isExpo = Boolean(dynamicName) || staticRaw !== null && "expo" in staticRaw || existsSync2(join4(cwd, "node_modules", "expo", "package.json"));
+  let expo = null;
+  if (isExpo && (dynamicName || existsSync2(join4(cwd, "node_modules", "expo", "bin", "cli")))) {
+    try {
+      expo = await readConfig(cwd);
+    } catch (err) {
+      if (dynamicName) {
+        versionUnreadable = `${dynamicName} is dynamic and could not be evaluated: ${err instanceof Error ? err.message : String(err)}`;
+      }
+    }
+  }
+  if (expo === null && !dynamicName && staticRaw) {
+    expo = "expo" in staticRaw ? staticRaw.expo : staticRaw;
+  }
   if (expo && typeof expo === "object") {
     const cfg = expo;
     if (typeof cfg.version === "string") version = cfg.version;
@@ -859,18 +992,10 @@ function localAppIdentity(cwd, platform) {
       bundleId ??= uniqueMatch(pbx, /PRODUCT_BUNDLE_IDENTIFIER = ([^;]+);/g);
     }
   }
-  return { reactNative, version, bundleId };
+  return { reactNative, version, bundleId, versionUnreadable: version ? null : versionUnreadable };
 }
 
-// src/commands/build.ts
-import { spawn as spawn2 } from "child_process";
-import { createInterface } from "readline";
-import { select as select2 } from "@inquirer/prompts";
-import chalk3 from "chalk";
-
 // src/lib/dev-setup.ts
-import chalk2 from "chalk";
-import { input, select } from "@inquirer/prompts";
 function platformChoices(cwd) {
   const choices = [
     { value: "ios", name: "iOS simulator" },
@@ -968,7 +1093,7 @@ async function promptMetroCommand(cwd, platform) {
 }
 
 // src/lib/source-pack.ts
-import { execFile, spawn } from "child_process";
+import { execFile as execFile2, spawn } from "child_process";
 import { lstatSync, mkdtempSync, readFileSync as readFileSync5, rmSync as rmSync4, statSync as statSync2, writeFileSync as writeFileSync4 } from "fs";
 import { tmpdir } from "os";
 import { join as join5 } from "path";
@@ -1107,7 +1232,7 @@ function probeTarNullSupport() {
       const listPath = join5(tmp, "empty.list");
       writeFileSync4(listPath, "");
       const out = join5(tmp, "probe.tgz");
-      execFile("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
+      execFile2("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
         rmSync4(tmp, { recursive: true, force: true });
         resolve(!err);
       });
@@ -2448,6 +2573,13 @@ function queuedLine(position, reasonMessage) {
   const why = reasonMessage ?? "Every device is busy.";
   return `\u23F3 ${why} Waiting in the queue${where}, Ctrl-C to give up.`;
 }
+function devBuildLines(choice, standalone) {
+  return buildLines(choice, {
+    standalone,
+    flag: "--build <id>",
+    listBuilds: "vibeview list-builds"
+  });
+}
 function emit(json, evt) {
   if (json) console.log(JSON.stringify(evt));
 }
@@ -2456,8 +2588,30 @@ async function startDevSession(cfg, onEvent = () => {
   const api = new ApiClient(cfg.baseUrl, cfg.token);
   const usesTunnel = PLATFORM_NEEDS_METRO[cfg.platform] && !cfg.standalone;
   const pool = cfg.model ? resolveDeviceModel(await api.listDeviceModels(), cfg.platform, cfg.model) : null;
+  let app = null;
+  let project = null;
+  let pick = {
+    buildId: cfg.buildId,
+    reason: null
+  };
+  if (usesTunnel && cfg.projectDir) {
+    try {
+      app = cfg.app ?? await api.getApp(cfg.appId);
+    } catch {
+      app = null;
+    }
+    try {
+      project = await localAppIdentity(cfg.projectDir, cfg.platform);
+    } catch {
+      project = null;
+    }
+    pick = preferDevBuild(app, cfg.buildId, project);
+  }
+  const body = { ...cfg, buildId: pick.buildId };
   const created = await api.createSession(
-    devSessionCreateBody(pool ? { ...cfg, deviceCategory: pool.category, model: pool.model } : cfg)
+    devSessionCreateBody(
+      pool ? { ...body, deviceCategory: pool.category, model: pool.model } : body
+    )
   );
   const sessionId = created.session_id;
   let stopping = false;
@@ -2573,7 +2727,8 @@ async function startDevSession(cfg, onEvent = () => {
       stop: () => stopSession(0),
       reportedWarnings,
       session: active,
-      lapsedReason: () => leaseLapsedReason(Date.now() - lastLeaseAt)
+      lapsedReason: () => leaseLapsedReason(Date.now() - lastLeaseAt),
+      build: usesTunnel && cfg.projectDir ? describeDevBuild(app, active, { ...pick, pinned: cfg.buildId !== void 0 }, project) : null
     };
   } catch (err) {
     await stopSession(1);
@@ -3192,6 +3347,7 @@ async function runDevInProcess(opts) {
         deviceCategory: cfg.deviceCategory,
         model: cfg.model,
         buildId: pinnedBuildId,
+        projectDir: process.cwd(),
         ...standalone ? { standalone } : {},
         metroPort: cfg.metroPort ?? 8081,
         // startDevSession's own browser-open happens before we've written the
@@ -3249,6 +3405,8 @@ async function runDevInProcess(opts) {
       }
     );
     const keysLine = rokuBuild ? `Press ${chalk4.bold("r")} to reload the channel, ${chalk4.bold("q")} or Ctrl-C to end the session.` : "Ctrl-C to end the session.";
+    for (const line of devBuildLines(handle.build, standalone))
+      console.error(chalk4.dim(`  ${line}`));
     console.error(`
   Watch and interact: ${chalk4.cyan(handle.pageUrl)}
   ${keysLine}
@@ -3266,7 +3424,8 @@ async function runDevInProcess(opts) {
       event: "session_ready",
       session_id: handle.sessionId,
       url: handle.pageUrl,
-      pid: process.pid
+      pid: process.pid,
+      build: handle.build ?? null
     });
     if (opts.open !== false) await openBrowser(handle.pageUrl).catch(() => {
     });
@@ -3398,6 +3557,8 @@ async function dev(opts) {
         } else {
           console.error(chalk4.dim(`Using ${resolveAuth(opts).baseUrl}`));
           console.error(chalk4.green(`\u2713 dev session started in the background (pid ${parsed.pid})`));
+          for (const line2 of devBuildLines(parsed.build, false))
+            console.error(chalk4.dim(`  ${line2}`));
           console.error(`
   Watch and interact: ${chalk4.cyan(parsed.url)}`);
           console.error(chalk4.dim(`  vibeview dev-status  \u2014 check on it`));
@@ -4056,12 +4217,12 @@ var AGENT_COMMANDS = [
 
 // src/agent/render.ts
 import chalk6 from "chalk";
-function renderEnvelope(env) {
+function renderEnvelope(env, label = env.tool) {
   const lines = [];
   if (env.ok) {
-    lines.push(chalk6.green(`ok`) + chalk6.dim(` (${env.tool})`));
+    lines.push(chalk6.green(`ok`) + chalk6.dim(` (${label})`));
   } else {
-    lines.push(chalk6.red(`error`) + chalk6.dim(` (${env.tool})`));
+    lines.push(chalk6.red(`error`) + chalk6.dim(` (${label})`));
   }
   lines.push(...resultLines(env.result));
   if (env.observation) {
@@ -4367,7 +4528,7 @@ async function runAgentVerb(cmd, positionals, opts) {
         JSON.stringify({ ...envelope, result: { written_to: outPath, bytes: imageBytes.length } })
       );
     } else {
-      process.stderr.write(renderEnvelope(envelope) + "\n");
+      process.stderr.write(renderEnvelope(envelope, cmd.verb) + "\n");
       console.log(outPath);
     }
     process.exit(agentExitCode(envelope));
@@ -4376,7 +4537,7 @@ async function runAgentVerb(cmd, positionals, opts) {
   if (opts.json) {
     console.log(JSON.stringify(envelope));
   } else {
-    console.log(renderEnvelope(envelope));
+    console.log(renderEnvelope(envelope, cmd.verb));
     if (cmd.verb === "press" && !envelope.ok) process.stderr.write(pressButtonsHelp() + "\n");
   }
   process.exit(agentExitCode(envelope));
@@ -4391,11 +4552,9 @@ export {
   loadDevConfig,
   resolveMetro,
   parseBuildId,
-  buildKind,
   checkDevBuild,
-  debugBuildsNewestFirst,
-  pickDevBuild,
-  buildLabel,
+  describeDevBuild,
+  buildLines,
   buildRows,
   formatBuildRowsHuman,
   listBuilds,
@@ -4407,7 +4566,6 @@ export {
   checkMetro,
   loadLocalDevConfig,
   effectiveDevConfig,
-  localAppIdentity,
   buildCommand,
   formatDuration,
   BUILD_TERMINAL_STATUSES,

package/dist/cli.js

@@ -24,7 +24,7 @@ import {
   readDevStateFile,
   readMetroState,
   runAgentVerb
-} from "./chunk-D3OZPFJ3.js";
+} from "./chunk-TPZG7NCU.js";
 import {
   ApiClient,
   ApiStatusError,
@@ -60,10 +60,25 @@ 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;
-  const failedStep = result.steps?.find((s) => s.status !== "passed");
+  const failedStep = result.steps?.find((s) => s.status === "failed" || s.status === "error");
   return [
     {
       case_name: result.case_name || result.run_id,
@@ -73,7 +88,12 @@ function resultCases(result) {
       error_kind: failedStep?.error_kind ?? null,
       error_kind_description: failedStep?.error_kind_description ?? null,
       screenshot_signed_url: failedStep?.screenshot_signed_url ?? null,
-      url: result.url
+      url: result.url,
+      steps_not_checked: runStepsNotChecked(result),
+      not_checked_steps: notCheckedSteps(result.steps).map((s) => ({
+        step: s.step,
+        note: s.note ?? null
+      }))
     }
   ];
 }
@@ -100,11 +120,16 @@ function formatHuman(result, verbose) {
   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;
-  lines.push(`  ${icon}  ${chalk.bold(title)}  ${chalk.dim(duration)}`);
   const cases = resultCases(result);
+  const notChecked = cases.reduce((n, t) => n + (t.steps_not_checked ?? 0), 0);
+  const runSuffix = notCheckedSuffix(result.status, notChecked);
+  lines.push(
+    `  ${icon}${runSuffix ? chalk.yellow(runSuffix) : ""}  ${chalk.bold(title)}  ${chalk.dim(duration)}`
+  );
   const passed = cases.filter((t) => t.status === "passed").length;
   const total = cases.length;
-  lines.push(`  ${chalk.dim(`${passed}/${total} cases passed`)}`);
+  const notCheckedNote = notChecked > 0 ? `, ${stepsNotCheckedLabel(notChecked)}` : "";
+  lines.push(`  ${chalk.dim(`${passed}/${total} cases passed${notCheckedNote}`)}`);
   if (result.url) {
     lines.push(`  ${chalk.dim(result.url)}`);
   }
@@ -114,7 +139,10 @@ function formatHuman(result, verbose) {
     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 caseDuration = tr.duration_ms ? `${(tr.duration_ms / 1e3).toFixed(1)}s` : "-";
-      lines.push(`  ${caseIcon}  ${tr.case_name}  ${chalk.dim(caseDuration)}`);
+      const caseSuffix = notCheckedSuffix(tr.status, 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)}`);
       }
@@ -129,7 +157,7 @@ function formatHuman(result, verbose) {
       lines.push(`  ${chalk.bold(result.case_name)}`);
     }
     for (const step of result.steps) {
-      const stepIcon = step.status === "passed" ? chalk.green("  PASS") : chalk.red("  FAIL");
+      const stepIcon = step.status === "passed" ? chalk.green("  PASS") : step.status === "not_checked" ? chalk.yellow("  NOT CHECKED") : chalk.red("  FAIL");
       const stepDuration = step.duration_ms ? `${(step.duration_ms / 1e3).toFixed(1)}s` : "-";
       lines.push(`  ${stepIcon}  ${step.step}  ${chalk.dim(stepDuration)}`);
       if (verbose && step.actions && step.actions.length > 0) {
@@ -137,7 +165,9 @@ function formatHuman(result, verbose) {
           lines.push(`        ${chalk.dim(formatAction(action))}`);
         }
       }
-      if (step.status !== "passed") {
+      if (step.status === "not_checked") {
+        if (step.note) lines.push(`        ${chalk.dim(step.note)}`);
+      } else if (step.status !== "passed") {
         lines.push(...failureLines(step));
       }
     }
@@ -156,13 +186,33 @@ function formatHuman(result, verbose) {
 
 // src/lib/formatters/json.ts
 function formatJson(result) {
-  return JSON.stringify(result, null, 2);
+  const doc = Array.isArray(result.test_runs) ? result : { ...result, steps_not_checked: runStepsNotChecked(result) };
+  return JSON.stringify(doc, null, 2);
 }
 
 // src/lib/formatters/junit.ts
 function escapeXml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
+function caseDetailLines(c) {
+  const n = c.status === "passed" ? c.steps_not_checked ?? 0 : 0;
+  const lines = [];
+  if (n > 0) {
+    lines.push("      <properties>");
+    lines.push(`        <property name="steps_not_checked" value="${n}" />`);
+    lines.push("      </properties>");
+  }
+  const out = [];
+  if (c.url) out.push(c.url);
+  if (n > 0) {
+    out.push(`${stepsNotCheckedLabel(n)}:`);
+    for (const s of c.not_checked_steps ?? []) {
+      out.push(`- ${s.step}${s.note ? ` (${s.note})` : ""}`);
+    }
+  }
+  if (out.length) lines.push(`      <system-out>${escapeXml(out.join("\n"))}</system-out>`);
+  return lines;
+}
 function formatJunit(result) {
   const suiteName = escapeXml(result.suite_name || result.case_name || result.run_id);
   const cases = resultCases(result);
@@ -194,8 +244,8 @@ 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 out = tr.url ? `      <system-out>${escapeXml(tr.url)}</system-out>` : null;
-    if (tr.status === "passed" && !out) {
+    const detail = caseDetailLines(tr);
+    if (tr.status === "passed" && detail.length === 0) {
       lines.push(`    <testcase name="${caseName}" classname="${suiteName}" time="${caseTime}" />`);
       continue;
     }
@@ -207,7 +257,7 @@ function formatJunit(result) {
       const msg = escapeXml(tr.error_message || "Infrastructure error");
       lines.push(`      <error message="${msg}" type="InfraError">${msg}</error>`);
     }
-    if (out) lines.push(out);
+    lines.push(...detail);
     lines.push("    </testcase>");
   }
   lines.push("  </testsuite>");
@@ -240,8 +290,12 @@ var MULTI_TERMINAL = /* @__PURE__ */ new Set(["passed", "failed", "error", "canc
 function caseLines(c, classname) {
   const name = escapeXml(c.name);
   const head = `    <testcase name="${name}" classname="${classname}" time="${c.time}"`;
-  const out = c.url ? `      <system-out>${escapeXml(c.url)}</system-out>` : null;
-  if (c.verdict === "passed" && !out) return [`${head} />`];
+  const detail = caseDetailLines({
+    status: c.verdict,
+    url: c.url,
+    steps_not_checked: c.steps_not_checked
+  });
+  if (c.verdict === "passed" && detail.length === 0) return [`${head} />`];
   const lines = [`${head}>`];
   const msg = escapeXml(c.message ?? "");
   if (c.verdict === "failure") {
@@ -251,7 +305,7 @@ function caseLines(c, classname) {
   } else if (c.verdict === "skipped") {
     lines.push(`      <skipped message="${msg}" />`);
   }
-  if (out) lines.push(out);
+  lines.push(...detail);
   lines.push("    </testcase>");
   return lines;
 }
@@ -263,7 +317,12 @@ function formatMultiSuiteJunit(result, opts = {}) {
     const cases = (sr.case_runs ?? []).map((c) => {
       const name = c.case_name || c.run_id;
       const time = c.duration_ms ? (c.duration_ms / 1e3).toFixed(1) : "0";
-      const base = { name, time, url: c.url || void 0 };
+      const base = {
+        name,
+        time,
+        url: c.url || void 0,
+        steps_not_checked: c.steps_not_checked
+      };
       switch (c.status) {
         case "passed":
           return { ...base, verdict: "passed" };
@@ -1039,8 +1098,13 @@ ${chalk5.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
   } else if (opts.output === "junit") {
     process.stdout.write(formatMultiSuiteJunit(last) + "\n");
   } else {
+    const totalNotChecked = last.suite_runs.reduce(
+      (n, sr) => n + (sr.case_runs ?? []).reduce((m, cr) => m + (cr.steps_not_checked ?? 0), 0),
+      0
+    );
+    const aggregateNote = totalNotChecked > 0 ? chalk5.yellow(` (${stepsNotCheckedLabel(totalNotChecked)})`) : "";
     process.stdout.write(`
-Aggregate: ${last.status}
+Aggregate: ${last.status}${aggregateNote}
 `);
     for (const sr of last.suite_runs) {
       const mark = sr.status === "passed" ? chalk5.green("\u2713") : chalk5.red("\u2717");
@@ -1056,8 +1120,9 @@ Aggregate: ${last.status}
       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 dur = cr.duration_ms ? chalk5.dim(` (${(cr.duration_ms / 1e3).toFixed(1)}s)`) : "";
+        const unchecked = notCheckedSuffix(cr.status, cr.steps_not_checked);
         process.stdout.write(
-          `      ${caseMark} ${cr.case_name ?? "Case"} ${cr.status ?? "?"}${dur} ${chalk5.dim(cr.url)}
+          `      ${caseMark} ${cr.case_name ?? "Case"} ${cr.status ?? "?"}${unchecked ? chalk5.yellow(unchecked) : ""}${dur} ${chalk5.dim(cr.url)}
 `
         );
         if (cr.error_message && cr.status !== "passed") {
@@ -4079,7 +4144,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-GHCQHKYX.js");
+  const { runMcpServer } = await import("./server-RDGEVJD4.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(

package/dist/{server-GHCQHKYX.js → server-RDGEVJD4.js}

@@ -4,15 +4,14 @@ import {
   DEV_PLATFORMS,
   PLATFORM_DEVICE,
   PLATFORM_NEEDS_METRO,
-  buildKind,
-  buildLabel,
+  buildLines,
   buildRows,
   buildToolCall,
   checkDevBuild,
   checkMetro,
   createRokuPush,
-  debugBuildsNewestFirst,
   decodeScreenshotResult,
+  describeDevBuild,
   effectiveDevConfig,
   filterDeviceModels,
   formatBuildRowsHuman,
@@ -20,15 +19,13 @@ import {
   isDevPlatform,
   loadDevConfig,
   loadLocalDevConfig,
-  localAppIdentity,
   parseBuildId,
-  pickDevBuild,
   platformWithArticle,
   readDevState,
   renderEnvelope,
   resolveMetro,
   startDevSession
-} from "./chunk-D3OZPFJ3.js";
+} from "./chunk-TPZG7NCU.js";
 import {
   ApiClient,
   NotFoundError,
@@ -117,7 +114,7 @@ var DEV_START_DEF = {
     },
     build_id: {
       type: "number",
-      description: 'Run this uploaded build of the app (an id from list_builds). Without standalone it must be a debug build (kind "debug"); with standalone any build of the app works. Omitted: the newest debug build, or with standalone the newest release build. Not for roku.'
+      description: `Run this uploaded build of the app (an id from list_builds). Without standalone it must be a debug build (kind "debug"); with standalone any build of the app works. Omitted: the newest debug build (preferring one of the local project's own app version over a newer one of another version), or with standalone the newest release build. Not for roku.`
     },
     standalone: {
       type: "boolean",
@@ -240,6 +237,9 @@ async function readSession(deps, sessionId) {
 function isEndedStatus(status) {
   return status === "stopped" || status === "failed";
 }
+function capitalize(text) {
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
 function endedLine(ended) {
   const why = ended.reason ? `: ${ended.reason}` : "";
   return `session ${ended.sessionId} has ended (${ended.status}${why})`;
@@ -329,7 +329,7 @@ async function handleToolCall(toolName, args, deps, extra = {}) {
   if (cmd.verb === "screenshot" && envelope.ok) {
     return screenshotToolResult(envelope, args);
   }
-  return textResult(renderEnvelope(envelope), envelope, !envelope.ok);
+  return textResult(renderEnvelope(envelope, toolNameFor(cmd.verb)), envelope, !envelope.ok);
 }
 function screenshotToolResult(envelope, args) {
   const { image, preview } = splitScreenshotResult(envelope.result);
@@ -351,7 +351,7 @@ function screenshotToolResult(envelope, args) {
     ...envelope,
     result: { written_to: outPath, bytes: imageBytes.length }
   };
-  const lines = [`${renderEnvelope(sanitized)}
+  const lines = [`${renderEnvelope(sanitized, "screenshot")}
 screenshot written to ${outPath}`];
   let inlineBlock = null;
   if (args.inline === true) {
@@ -457,7 +457,7 @@ async function handleDevStart(args, deps, extra = {}) {
     const lines = [`${standalone ? "session" : "dev session"} started: ${payload.session_id}`];
     const device = result.device ? deviceLine(result.device) : null;
     if (device) lines.push(device);
-    lines.push(...buildLines(result, standalone));
+    lines.push(...buildLines2(result, standalone));
     if (typeof result.queuedSeconds === "number") {
       lines.push(`waited ${Math.round(result.queuedSeconds)} s in the queue for a device`);
     }
@@ -467,35 +467,17 @@ async function handleDevStart(args, deps, extra = {}) {
     return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
   }
 }
-function buildLines(result, standalone) {
-  const lines = [];
-  if (result.build) {
-    lines.push(`build: ${buildLabel(result.build)}`);
-  }
-  if (result.buildReason) lines.push(`picked that build because ${result.buildReason}`);
-  const others = result.otherBuilds ?? [];
-  if (others.length > 0) {
-    lines.push(
-      `other debug builds: ${others.map((b) => buildLabel(b)).join("; ")} \u2014 pass build_id to run one`
-    );
-  }
-  const rn = result.project?.reactNative;
-  if (!standalone && rn) {
-    lines.push(
-      `this project: react-native ${rn}. If the app shows "React Native version mismatch", the build was made with another React Native: run a build made from this project (build_id, see list_builds).`
-    );
-  }
-  return lines;
-}
-function startedBuild(b) {
-  return {
-    id: b.id,
-    version: b.version ?? null,
-    build_number: b.build_number ?? null,
-    kind: buildKind(b),
-    uploaded_at: b.uploaded_at ?? null,
-    note: b.note ?? null
-  };
+function buildLines2(result, standalone) {
+  return buildLines(
+    {
+      build: result.build ?? null,
+      reason: result.buildReason ?? null,
+      pinned: result.pinned === true,
+      other_debug_builds: result.otherBuilds ?? [],
+      project: result.project ?? null
+    },
+    { standalone, flag: "build_id", listBuilds: "list_builds" }
+  );
 }
 function deviceLine(d) {
   const name = d.model || d.name;
@@ -631,7 +613,7 @@ async function handleDevStop(deps) {
   }
   if (!current) {
     return textResult(
-      ended ? `no dev session was running \u2014 ${endedLine(ended)} already` : "no dev session was running",
+      ended ? `no dev session was running \u2014 it had already ended. ${capitalize(endedLine(ended))}` : "no dev session was running",
       { session_id: null, stopped: false }
     );
   }
@@ -823,22 +805,8 @@ function createDevSessionController(auth, webUrl) {
       if (buildId !== void 0) {
         checkDevBuild(app, buildId, cfg.platform, { standalone });
       }
-      const project = usesMetro ? localAppIdentity(process.cwd(), cfg.platform) : null;
-      let buildReason = null;
-      if (buildId === void 0 && usesMetro) {
-        const picked = pickDevBuild(app, project?.version ?? null);
-        if (picked?.reason) {
-          buildId = picked.build.id;
-          buildReason = picked.reason;
-        }
-      }
       const isTv = PLATFORM_DEVICE[cfg.platform].tv;
       const warnings = [];
-      if (project?.bundleId && app.package_name && project.bundleId !== app.package_name) {
-        warnings.push(
-          `this project's ${isTv || cfg.platform.startsWith("android") ? "package name" : "bundle id"} is ${project.bundleId}, but app ${app.public_id} is ${app.package_name} \u2014 check that dev_start runs the app this project builds (list_apps)`
-        );
-      }
       const progress = startProgress(cfg.onProgress);
       let started = null;
       try {
@@ -853,6 +821,11 @@ function createDevSessionController(auth, webUrl) {
             // A named model decides the category itself (startDevSession).
             model: cfg.model,
             buildId,
+            // The build choice (a debug build of this project's version over
+            // a newer one of another) and its report live in startDevSession,
+            // shared with `vibeview dev` and `--detach`.
+            app,
+            ...usesMetro ? { projectDir: process.cwd() } : {},
             ...standalone ? { standalone } : {},
             metroPort,
             open: false,
@@ -880,23 +853,26 @@ function createDevSessionController(auth, webUrl) {
       handle = started;
       platform = cfg.platform;
       ended = null;
-      const installedId = handle.session?.app_build_id ?? buildId ?? null;
-      const installed = app.builds.find((b) => b.id === installedId);
-      const others = usesMetro ? debugBuildsNewestFirst(app).filter((b) => b.id !== installedId) : [];
+      const choice = handle.build ?? describeDevBuild(
+        app,
+        handle.session,
+        { buildId, reason: null, pinned: buildId !== void 0 },
+        null
+      );
+      const project = choice.project;
+      if (project?.bundleId && app.package_name && project.bundleId !== app.package_name) {
+        warnings.push(
+          `this project's ${isTv || cfg.platform.startsWith("android") ? "package name" : "bundle id"} is ${project.bundleId}, but app ${app.public_id} is ${app.package_name} \u2014 check that dev_start runs the app this project builds (list_apps)`
+        );
+      }
       return {
         sessionId: handle.sessionId,
         pageUrl: handle.pageUrl,
         device: startedDevice(handle.session),
-        build: installed ? startedBuild(installed) : typeof installedId === "number" ? {
-          id: installedId,
-          version: handle.session?.app_version ?? null,
-          build_number: handle.session?.app_build_number ?? null,
-          kind: "unknown",
-          uploaded_at: null,
-          note: null
-        } : null,
-        buildReason,
-        otherBuilds: others.slice(0, 3).map(startedBuild),
+        build: choice.build,
+        buildReason: choice.reason,
+        pinned: choice.pinned,
+        otherBuilds: usesMetro ? choice.other_debug_builds : [],
         project,
         queuedSeconds: progress.queuedSeconds(),
         warnings
@@ -1117,7 +1093,7 @@ export {
   MCP_INSTRUCTIONS,
   SHUTDOWN_TIMEOUT_MS,
   START_PROGRESS_INTERVAL_MS,
-  buildLines,
+  buildLines2 as buildLines,
   buildToolDefinitions,
   createDevSessionController,
   createShutdown,

package/package.json

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

package/skills/vibeview-agent/SKILL.md

@@ -51,11 +51,18 @@ https://vibeview.io/docs/preparing-your-build.
    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}
+   {"event":"session_ready","session_id":"...","url":"...","pid":1234,"build":{...}}
    ```
    Use `session_id` as `--session <id>` on every verb below. The event
    fires once the session accepts commands (device up, app installed) —
-   no need to poll `dev-status` first. If the app ships no native changes
+   no need to poll `dev-status` first. `build` says which build was
+   installed (`build.build`), why (`build.reason`: it prefers a debug build
+   of the project's own app version over a newer one of another version),
+   and the newest debug build of each other version (`build.other_debug_builds`).
+   If the app shows a red error screen right after start ("React Native
+   version mismatch", or "undefined is not a function" in a native module),
+   the build may be from other native code — rerun with `--build <id>` of
+   one of those. If the app ships no native changes
    since the last run, skip step 1 and just do steps 2–4.
 5. **Immediately tell the developer the session `url`** — "watch or take
    over at any time: `<url>`". The page is a live, fully interactive view
@@ -244,6 +251,9 @@ streaming minutes even when idle:
 ```bash
 vibeview dev-stop
 ```
+If the `dev --detach` process is killed or the computer sleeps, its session
+ends on its own within about 90 seconds (unless a browser tab is watching
+it) — but don't rely on that; stop it.
 A session you did not start with `dev` (one created through the API, the
 sandbox, or a collaboration link) is stopped by id:
 ```bash
@@ -312,7 +322,7 @@ steps the CLI does with plain shell commands:
 |----------|------|---------|
 | `upload_app` | `file` (required path), `name` | Upload a build (zipped iOS/tvOS simulator `.app`, Android/Android TV `.apk`, Roku channel `.zip`). The MCP equivalent of `vibeview upload-app`, so step 1 of the loop needs no shell. Returns the `app_id` to pass to `dev_start`. |
 | `list_apps` | `platform` | List the org's apps (app id, name, platform, bundle id). The MCP equivalent of `vibeview list-apps` — use it to find an app someone else uploaded. |
-| `dev_start` | `platform` (required: `ios`/`android`/`tvos`/`androidtv`/`roku`), `app`, `metro_port`, `model`, `build_id`, `standalone` | Start a session held open by the MCP server. The MCP equivalent of `vibeview dev --detach`; `model` picks an exact device model (e.g. `"iPhone Duo"`); `build_id` runs that build instead of the newest debug one (see `list_builds`). `standalone: true` runs any build as it is with no Metro — a release, CI or cloud build (without `build_id`: the newest release build). An app for another platform is refused before a device is taken. Returns `page_url` — relay it to the developer immediately, same as step 5 of the loop — the device it got (model, OS, category; posture and lit screen on a foldable), and the build it installed (id, version, upload time) with the app's other debug builds. A red "React Native version mismatch" screen means that build was made with another React Native than the project: pick one made from this project with `build_id`. While every device is busy it waits in the queue, sending progress. |
+| `dev_start` | `platform` (required: `ios`/`android`/`tvos`/`androidtv`/`roku`), `app`, `metro_port`, `model`, `build_id`, `standalone` | Start a session held open by the MCP server. The MCP equivalent of `vibeview dev --detach`; `model` picks an exact device model (e.g. `"iPhone Duo"`); `build_id` runs that build instead of the newest debug one (see `list_builds`). `standalone: true` runs any build as it is with no Metro — a release, CI or cloud build (without `build_id`: the newest release build). An app for another platform is refused before a device is taken. Returns `page_url` — relay it to the developer immediately, same as step 5 of the loop — the device it got (model, OS, category; posture and lit screen on a foldable), and the build it installed (id, version, upload time) with the app's other debug builds. It chooses the build the way `vibeview dev` does (a debug build of the project's own version over a newer one of another version) and says when it can't read the project's version. A red error screen right after start ("React Native version mismatch", or "undefined is not a function" in a native module) may mean the build was made from other native code: try one of the listed other builds with `build_id`. While every device is busy it waits in the queue, sending progress. |
 | `list_device_models` | `device_type` | List the device models you can start (model, OS, platform, category, `foldable` marker, and how many are free/busy). The MCP equivalent of `vibeview list-devices --models`. |
 | `list_builds` | `app` (required) | List an app's uploaded builds with their kind (`debug`/`release`/`unknown`). The MCP equivalent of `vibeview list-builds`. |
 | `dev_stop` | — | Stop the session `dev_start` started. The MCP equivalent of `vibeview dev-stop`. Says "no dev session was running" when there was none. |
@@ -329,5 +339,7 @@ targets that session instead of whatever `vibeview dev --detach` state exists
 in the project directory. Only one such session can be held at a time
 (`dev_start` fails if one is already running), and it stays live — billing
 streaming minutes — until `dev_stop` or the MCP connection ends (the server
-stops it when the client quits or closes the connection; a killed server
-can't). Always call `dev_stop` when you finish verifying.
+stops it when the client quits or closes the connection; if the server is
+killed or the computer sleeps, the session ends within about 90 seconds
+unless a browser tab is watching it). Always call `dev_stop` when you
+finish verifying.