vibeview 0.40.0 → 0.42.0

package/dist/{chunk-MK3WDPVZ.js → chunk-4WIEZBTP.js}

@@ -831,10 +831,23 @@ function detectFlavor(cwd) {
   } catch {
   }
   if ("expo" in deps) return "expo";
-  if (existsSync3(join5(cwd, "android", "gradlew")) || iosWorkspaceName(cwd)) return "bare-rn";
+  if (isFlutterProject(cwd)) return "flutter";
+  const nativeDirs = existsSync3(join5(cwd, "android", "gradlew")) || iosWorkspaceName(cwd);
+  const rnDirs = existsSync3(join5(cwd, "ios")) || existsSync3(join5(cwd, "android"));
+  if ("react-native" in deps && rnDirs) return "bare-rn";
+  if ("@capacitor/core" in deps || CAPACITOR_CONFIGS.some((f) => isFile(join5(cwd, f)))) {
+    return "capacitor";
+  }
+  if (nativeDirs) return isFile(join5(cwd, "package.json")) ? "bare-rn" : "native";
   if (isFile(join5(cwd, "manifest"))) return "roku";
+  if (isFile(join5(cwd, "gradlew")) || xcodeProjects(cwd).length > 0) return "native";
   return "unknown";
 }
+function isFlutterProject(cwd) {
+  const pubspec = readText(join5(cwd, "pubspec.yaml"));
+  return pubspec !== null && /^\s*sdk:\s*flutter\s*(#.*)?$/m.test(pubspec) && !/^\s+plugin:\s*(#.*)?$/m.test(pubspec);
+}
+var CAPACITOR_CONFIGS = ["capacitor.config.ts", "capacitor.config.js", "capacitor.config.json"];
 function nativeDirShipped(cwd, dir) {
   if (!existsSync3(join5(cwd, dir))) return false;
   try {
@@ -862,6 +875,163 @@ function iosWorkspaceName(cwd) {
 }
 var IOS_ARTIFACT = "ios/build/Build/Products/Debug-iphonesimulator/*.app";
 var ANDROID_ARTIFACT = "android/app/build/outputs/apk/debug/*.apk";
+var NATIVE_SEARCH_SKIP = /* @__PURE__ */ new Set(["node_modules", "build", "Pods", "DerivedData"]);
+function topLevelDirs(cwd) {
+  try {
+    return readdirSync2(cwd, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".") && !NATIVE_SEARCH_SKIP.has(e.name)).map((e) => e.name).sort();
+  } catch {
+    return [];
+  }
+}
+var SAFE_SEGMENT = /^[A-Za-z0-9._-]+$/;
+function dirShipped(cwd, rel) {
+  const slash = rel.indexOf("/");
+  const checks = [["", rel]];
+  if (slash !== -1) checks.push([rel.slice(0, slash), rel.slice(slash + 1)]);
+  return checks.every(([dir, path]) => {
+    try {
+      return !ignore().add(readFileSync5(join5(cwd, dir, ".gitignore"), "utf-8")).ignores(`${path}/`);
+    } catch {
+      return true;
+    }
+  });
+}
+function xcodeProjects(cwd) {
+  const found = [];
+  for (const dir of ["", ...topLevelDirs(cwd)]) {
+    try {
+      for (const f of readdirSync2(join5(cwd, dir)).sort()) {
+        const rel = dir ? `${dir}/${f}` : f;
+        if (f.endsWith(".xcodeproj") && dirShipped(cwd, rel)) found.push(rel);
+      }
+    } catch {
+    }
+  }
+  return found;
+}
+function xcodeScheme(cwd, project) {
+  const shared = (() => {
+    try {
+      return readdirSync2(join5(cwd, project, "xcshareddata", "xcschemes")).filter((f) => f.endsWith(".xcscheme")).map((f) => f.replace(/\.xcscheme$/, ""));
+    } catch {
+      return [];
+    }
+  })();
+  if (shared.length === 1) return shared[0];
+  if (shared.length > 1) return null;
+  const pbx = readText(join5(cwd, project, "project.pbxproj"));
+  if (!pbx) return null;
+  const apps = pbx.split("isa = PBXNativeTarget;").slice(1).map((block) => block.slice(0, block.indexOf("};"))).filter((block) => block.includes('productType = "com.apple.product-type.application";')).map((block) => /\bname = ("?)([^";]+)\1;/.exec(block)?.[2]?.trim()).filter((name) => Boolean(name));
+  return apps.length === 1 ? apps[0] : null;
+}
+function shellWord(word) {
+  return /^[A-Za-z0-9._/-]+$/.test(word) ? word : `'${word.replace(/'/g, `'\\''`)}'`;
+}
+function nativeIosDefaults(cwd) {
+  const projects = xcodeProjects(cwd);
+  if (projects.length !== 1) return {};
+  const project = projects[0];
+  const slash = project.lastIndexOf("/");
+  const dir = slash === -1 ? "" : project.slice(0, slash);
+  const base = project.slice(slash + 1).replace(/\.xcodeproj$/, "");
+  const derived = dir && SAFE_SEGMENT.test(dir) ? `${dir}/build` : "build";
+  const artifact = `${derived}/Build/Products/Debug-iphonesimulator/*.app`;
+  const scheme = xcodeScheme(cwd, project);
+  if (!scheme) return { artifact };
+  const pods = isFile(join5(cwd, dir, "Podfile"));
+  if (pods && isFile(join5(cwd, "gradlew"))) return { artifact };
+  const podLeg = pods ? dir ? `cd ${shellWord(dir)} && pod install && cd .. && ` : "pod install && " : "";
+  const target = pods ? `-workspace ${shellWord(dir ? `${dir}/${base}.xcworkspace` : `${base}.xcworkspace`)}` : `-project ${shellWord(project)}`;
+  return {
+    buildCommand: `${podLeg}xcodebuild ${target} -scheme ${shellWord(scheme)} -configuration Debug -sdk iphonesimulator -derivedDataPath ${shellWord(derived)} CODE_SIGNING_ALLOWED=NO`,
+    artifact
+  };
+}
+var GRADLE_LOGIC_DIRS = /* @__PURE__ */ new Set(["buildSrc", "build-logic", "gradle"]);
+var APPLIES_ANDROID_APP = /(?:com\.android\.application|libs\.plugins\.android\.?application)\b(?![^\n]*\bapply\s*\(?\s*false)/i;
+function androidAppModules(root) {
+  return topLevelDirs(root).filter((dir) => {
+    if (!SAFE_SEGMENT.test(dir) || GRADLE_LOGIC_DIRS.has(dir)) return false;
+    const script = readText(join5(root, dir, "build.gradle.kts")) ?? readText(join5(root, dir, "build.gradle"));
+    return script !== null && APPLIES_ANDROID_APP.test(script);
+  });
+}
+function nativeAndroidDefaults(cwd, production) {
+  if (!isFile(join5(cwd, "gradlew"))) {
+    if (!isFile(join5(cwd, "android", "gradlew"))) return {};
+    const inAndroid = androidAppModules(join5(cwd, "android"));
+    const m2 = inAndroid.length === 1 ? inAndroid[0] : "app";
+    return production ? {
+      buildCommand: "cd android && ./gradlew bundleRelease",
+      artifact: `android/${m2}/build/outputs/bundle/release/*.aab`
+    } : {
+      buildCommand: "cd android && ./gradlew assembleDebug",
+      artifact: `android/${m2}/build/outputs/apk/debug/*.apk`
+    };
+  }
+  const modules = androidAppModules(cwd);
+  if (modules.length !== 1) {
+    return {};
+  }
+  const m = modules[0];
+  return production ? {
+    buildCommand: `./gradlew :${m}:bundleRelease`,
+    artifact: `${m}/build/outputs/bundle/release/*.aab`
+  } : {
+    buildCommand: `./gradlew :${m}:assembleDebug`,
+    artifact: `${m}/build/outputs/apk/debug/*.apk`
+  };
+}
+var FLUTTER_ANDROID_ARTIFACT = "build/app/outputs/flutter-apk/app-debug.apk";
+var FLUTTER_IOS_ARTIFACT = "build/ios/iphonesimulator/Runner.app";
+var FLUTTER_ANDROID_PRODUCTION_ARTIFACT = "build/app/outputs/bundle/release/app-release.aab";
+function webBuildCommand(cwd) {
+  const scripts = readJson(cwd, "package.json")?.scripts ?? {};
+  if (typeof scripts.build !== "string") return null;
+  const install = installCommand(cwd);
+  if (install.startsWith("yarn ")) return "yarn build";
+  if (install.startsWith("pnpm ")) return "pnpm build";
+  return "npm run build";
+}
+function gradleWrapperVersion(root) {
+  const props = readText(join5(root, "gradle", "wrapper", "gradle-wrapper.properties"));
+  const m = props && /distributionUrl=.*gradle-(\d+)\.(\d+)/.exec(props);
+  return m ? [Number(m[1]), Number(m[2])] : null;
+}
+function dependencyMajor(cwd, name) {
+  const pkg = readJson(cwd, "package.json");
+  const deps = { ...pkg?.dependencies, ...pkg?.devDependencies };
+  const range = deps[name];
+  const m = typeof range === "string" ? /(\d+)/.exec(range) : null;
+  return m ? Number(m[1]) : null;
+}
+function capacitorDefaults(cwd, platform, production) {
+  const web = webBuildCommand(cwd);
+  const prefix = `${installCommand(cwd)} && ${web ? `${web} && ` : ""}npx cap sync ${platform} && `;
+  if (platform === "android") {
+    const artifact = production ? ANDROID_PRODUCTION_ARTIFACT : ANDROID_ARTIFACT;
+    if (!nativeDirShipped(cwd, "android") || !isFile(join5(cwd, "android", "gradlew"))) {
+      return { artifact };
+    }
+    const major = dependencyMajor(cwd, "@capacitor/android") ?? dependencyMajor(cwd, "@capacitor/core");
+    const wrapper = gradleWrapperVersion(join5(cwd, "android"));
+    const on21 = wrapper ? wrapper[0] > 8 || wrapper[0] === 8 && wrapper[1] >= 5 : major !== null && major >= 7;
+    const java = on21 ? "JAVA_HOME=${JAVA_HOME_21:-$JAVA_HOME} " : "";
+    return {
+      buildCommand: `${prefix}cd android && ${java}./gradlew ${production ? "bundleRelease" : "assembleDebug"}`,
+      artifact
+    };
+  }
+  if (production) return { artifact: IOS_PRODUCTION_ARTIFACT };
+  const project = "ios/App/App.xcodeproj";
+  const scheme = nativeDirShipped(cwd, "ios") ? xcodeScheme(cwd, project) : null;
+  if (!scheme) return { artifact: IOS_ARTIFACT };
+  const target = isFile(join5(cwd, "ios", "App", "Podfile")) ? "-workspace ios/App/App.xcworkspace" : `-project ${project}`;
+  return {
+    buildCommand: `${prefix}xcodebuild ${target} -scheme ${shellWord(scheme)} -configuration Debug -sdk iphonesimulator -derivedDataPath ios/build CODE_SIGNING_ALLOWED=NO`,
+    artifact: IOS_ARTIFACT
+  };
+}
 function installCommand(cwd) {
   const hit = JS_LOCKFILE_INSTALLS.find(([lockfile]) => existsSync3(join5(cwd, lockfile)));
   return hit ? hit[1] : "npm install";
@@ -914,12 +1084,17 @@ function defaultsFor(cwd, platform, evaluatedIosName) {
   const flavor = detectFlavor(cwd);
   if (platform === "roku") return flavor === "roku" ? rokuDefaults(cwd) : {};
   if (flavor === "unknown" || flavor === "roku") return {};
+  if (flavor === "flutter" || flavor === "capacitor" || flavor === "native") {
+    if (platform === "tvos" || platform === "androidtv") return {};
+    return otherFrameworkDefaults(cwd, flavor, platform, false);
+  }
   const metroCommand = flavor === "expo" ? "npx expo start" : "yarn start";
   if (platform === "tvos" || platform === "androidtv") return { metroCommand };
   if (platform === "android") {
     const managed = isManagedExpo(cwd, "android");
+    const wrapper = isFile(join5(cwd, "android", "gradlew"));
     return {
-      buildCommand: managed ? managedExpoAndroidCommand(cwd) : `${bareInstallPrefix(cwd, "android")}cd android && ./gradlew assembleDebug`,
+      buildCommand: managed ? managedExpoAndroidCommand(cwd) : wrapper ? `${bareInstallPrefix(cwd, "android")}cd android && ./gradlew assembleDebug` : void 0,
       artifact: ANDROID_ARTIFACT,
       metroCommand
     };
@@ -939,6 +1114,29 @@ function defaultsFor(cwd, platform, evaluatedIosName) {
     metroCommand
   };
 }
+function otherFrameworkDefaults(cwd, flavor, platform, production) {
+  if (flavor === "flutter") {
+    if (!existsSync3(join5(cwd, platform))) return {};
+    if (platform === "android") {
+      return production ? {
+        buildCommand: "flutter build appbundle --release",
+        artifact: FLUTTER_ANDROID_PRODUCTION_ARTIFACT
+      } : { buildCommand: "flutter build apk --debug", artifact: FLUTTER_ANDROID_ARTIFACT };
+    }
+    return production ? {} : { buildCommand: "flutter build ios --simulator --debug", artifact: FLUTTER_IOS_ARTIFACT };
+  }
+  if (flavor === "capacitor") return capacitorDefaults(cwd, platform, production);
+  if (platform === "android") return nativeAndroidDefaults(cwd, production);
+  if (!production) return nativeIosDefaults(cwd);
+  const ws = iosWorkspaceName(cwd);
+  const scheme = ws ? xcodeScheme(cwd, `ios/${ws}.xcodeproj`) : null;
+  if (!ws) return {};
+  if (!scheme) return { artifact: IOS_PRODUCTION_ARTIFACT };
+  return {
+    buildCommand: `${bareInstallPrefix(cwd, "ios")}${iosArchiveExportCommand(ws, scheme)}`,
+    artifact: IOS_PRODUCTION_ARTIFACT
+  };
+}
 var ANDROID_PRODUCTION_ARTIFACT = "android/app/build/outputs/bundle/release/*.aab";
 function androidProductionCommand(cwd) {
   return `${bareInstallPrefix(cwd, "android")}cd android && ./gradlew bundleRelease`;
@@ -965,9 +1163,9 @@ function managedExpoIosName(cwd, evaluatedName) {
   if (typeof name !== "string") return null;
   return expoSanitizedName(name) || null;
 }
-function iosArchiveExportCommand(ws) {
+function iosArchiveExportCommand(ws, scheme = ws) {
   const archivePath = `ios/build/${ws}.xcarchive`;
-  const archiveCmd = `xcodebuild archive -workspace ios/${ws}.xcworkspace -scheme ${ws} -configuration Release -archivePath ${archivePath} CODE_SIGN_STYLE=Manual \${VIBEVIEW_DEVELOPMENT_TEAM:+"DEVELOPMENT_TEAM=$VIBEVIEW_DEVELOPMENT_TEAM"} \${VIBEVIEW_PROVISIONING_PROFILE:+"PROVISIONING_PROFILE_SPECIFIER=$VIBEVIEW_PROVISIONING_PROFILE"} \${VIBEVIEW_CODE_SIGN_IDENTITY:+"CODE_SIGN_IDENTITY=$VIBEVIEW_CODE_SIGN_IDENTITY"}`;
+  const archiveCmd = `xcodebuild archive -workspace ios/${ws}.xcworkspace -scheme ${shellWord(scheme)} -configuration Release -archivePath ${archivePath} CODE_SIGN_STYLE=Manual \${VIBEVIEW_DEVELOPMENT_TEAM:+"DEVELOPMENT_TEAM=$VIBEVIEW_DEVELOPMENT_TEAM"} \${VIBEVIEW_PROVISIONING_PROFILE:+"PROVISIONING_PROFILE_SPECIFIER=$VIBEVIEW_PROVISIONING_PROFILE"} \${VIBEVIEW_CODE_SIGN_IDENTITY:+"CODE_SIGN_IDENTITY=$VIBEVIEW_CODE_SIGN_IDENTITY"}`;
   const exportCmd = `xcodebuild -exportArchive -archivePath ${archivePath} -exportPath ios/build -exportOptionsPlist "$VIBEVIEW_EXPORT_OPTIONS_PLIST"`;
   return `${archiveCmd} && ${exportCmd}`;
 }
@@ -975,9 +1173,13 @@ function managedExpoIosProductionCommand(cwd, name) {
   return `${installCommand(cwd)} && npx expo prebuild --platform ios && ` + iosArchiveExportCommand(name);
 }
 function productionDefaultsFor(cwd, platform, evaluatedIosName) {
+  const flavor = detectFlavor(cwd);
+  if ((flavor === "flutter" || flavor === "capacitor" || flavor === "native") && platform !== "tvos" && platform !== "roku") {
+    return otherFrameworkDefaults(cwd, flavor, platform === "ios" ? "ios" : "android", true);
+  }
   if (platform === "android" || platform === "androidtv") {
     return {
-      buildCommand: isManagedExpo(cwd, "android") ? managedExpoAndroidProductionCommand(cwd) : androidProductionCommand(cwd),
+      buildCommand: isManagedExpo(cwd, "android") ? managedExpoAndroidProductionCommand(cwd) : flavor !== "bare-rn" || isFile(join5(cwd, "android", "gradlew")) ? androidProductionCommand(cwd) : void 0,
       artifact: ANDROID_PRODUCTION_ARTIFACT
     };
   }

package/dist/cli.js

@@ -30,7 +30,7 @@ import {
   runAgentVerb,
   runStepsNotChecked,
   stepsNotCheckedLabel
-} from "./chunk-MK3WDPVZ.js";
+} from "./chunk-4WIEZBTP.js";
 import {
   ApiClient,
   ApiStatusError,
@@ -657,11 +657,13 @@ function formatToolCall(tc) {
 function runStartedLine(evt) {
   const steps = `${evt.total_steps} step(s)`;
   const model = chalk2.bold(evt.model || "default");
-  if (evt.mode === "replay") return `${chalk2.cyan("\u25B6")} Replay started \u2014 ${steps} (no AI)`;
+  if (evt.mode === "replay") {
+    return `${chalk2.cyan("\u25B6")} No AI run started \u2014 ${steps}, replays only (no AI)`;
+  }
   if (evt.mode === "hybrid") {
-    return `${chalk2.cyan("\u25B6")} Hybrid test started \u2014 ${steps}, replaying the recording, AI fallback model: ${model}`;
+    return `${chalk2.cyan("\u25B6")} Smart run started \u2014 ${steps}, replays recorded and learned paths, AI where needed (model: ${model})`;
   }
-  return `${chalk2.cyan("\u25B6")} AI test started \u2014 ${steps}, model: ${model}`;
+  return `${chalk2.cyan("\u25B6")} AI only run started \u2014 ${steps}, model: ${model}`;
 }
 function displayProgressEvent(evt, ctx) {
   const { spinner } = ctx;
@@ -775,6 +777,37 @@ function parseRunPlatform(value) {
   }
   return value;
 }
+var RUN_MODES = ["hybrid", "ai", "replay"];
+function parseRunMode(value) {
+  if (value === void 0) return void 0;
+  if (!RUN_MODES.includes(value)) {
+    throw new Error(
+      `--mode must be one of ${RUN_MODES.join(", ")} (Smart, AI only, No AI), got "${value}"`
+    );
+  }
+  return value;
+}
+var MAX_TIMEOUT_S = 7200;
+var POSITIVE_INT = /^[1-9][0-9]*$/;
+function parseTimeoutSeconds(value) {
+  const n = POSITIVE_INT.test(value.trim()) ? Number(value.trim()) : NaN;
+  if (!Number.isSafeInteger(n) || n < 1 || n > MAX_TIMEOUT_S) {
+    throw new Error(
+      `--timeout must be a whole number of seconds from 1 to ${MAX_TIMEOUT_S}, got "${value}"`
+    );
+  }
+  return n;
+}
+function parseBuildId(value) {
+  if (value === void 0) return void 0;
+  const n = POSITIVE_INT.test(value.trim()) ? Number(value.trim()) : NaN;
+  if (!Number.isSafeInteger(n)) {
+    throw new Error(
+      `--build must be a build id (a positive whole number, see \`vibeview list-builds\`), got "${value}"`
+    );
+  }
+  return n;
+}
 function refusePlatformWithApp(options) {
   if (options.platform && options.app) {
     throw new Error(
@@ -4079,11 +4112,27 @@ function resolveMetadata(opts) {
     process.exit(2);
   }
 }
+function parseRunFlags(opts) {
+  try {
+    return {
+      mode: parseRunMode(opts.mode),
+      timeout: parseTimeoutSeconds(opts.timeout),
+      build: parseBuildId(opts.build)
+    };
+  } catch (err) {
+    process.stderr.write(`error: ${err.message}
+`);
+    process.exit(2);
+  }
+}
 var program = new Command();
 program.name("vibeview").description(
   "VibeView CLI -- run your app on cloud iOS simulators, Android emulators, Apple TV, Android TV and Roku devices: a React Native dev loop (dev), device control for you or your coding agent (ui-tree, tap, mcp), and tests from CI (run-test, run-suites)"
 ).version(pkg.version);
-program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option(
+  "--mode <mode>",
+  "Execution mode: hybrid (Smart, the default), ai (AI only), replay (No AI)"
+).option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: tv for a TV platform, else phone)",
   parseDeviceCategory
@@ -4112,12 +4161,12 @@ program.command("run-suite <suite-id>").description("Run all test cases in a sui
 `);
     process.exit(2);
   }
+  const runFlags = parseRunFlags(opts);
   const metadata = resolveMetadata(opts);
   return runSuite(suiteId, {
     ...opts,
     metadata,
-    timeout: parseInt(opts.timeout, 10),
-    build: opts.build ? parseInt(opts.build, 10) : void 0
+    ...runFlags
   });
 });
 program.command("run-suites").description("Run all suites matching a tag filter").requiredOption(
@@ -4128,7 +4177,10 @@ program.command("run-suites").description("Run all suites matching a tag filter"
 ).option("--match <mode>", "any (default) or all", "any").option(
   "--platform <platform>",
   "Filter matched suites to one platform: ios, android, tvos, androidtv, roku (default: no filter)"
-).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-suite progress", false).option("--timeout <seconds>", "Per-suite timeout, capped at 2 hours total", "1800").option("--commit-sha <sha>", "Git commit SHA propagated to every SuiteRun").option("--model <model>", "AI model").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-suite progress", false).option("--timeout <seconds>", "Per-suite timeout, capped at 2 hours total", "1800").option("--commit-sha <sha>", "Git commit SHA propagated to every SuiteRun").option("--model <model>", "AI model").option("--provider <provider>", "AI provider").option(
+  "--mode <mode>",
+  "Execution mode: hybrid (Smart, the default), ai (AI only), replay (No AI)"
+).option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: tv for a TV platform, else phone)",
   parseDeviceCategory
@@ -4150,15 +4202,18 @@ program.command("run-suites").description("Run all suites matching a tag filter"
 `);
     process.exit(2);
   }
+  const runFlags = parseRunFlags(opts);
   const metadata = resolveMetadata(opts);
   return runSuites({
     ...opts,
     metadata,
-    timeout: parseInt(opts.timeout, 10),
-    build: opts.build ? parseInt(opts.build, 10) : void 0
+    ...runFlags
   });
 });
-program.command("run-test <test-id>").description("Run a single test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show step details", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+program.command("run-test <test-id>").description("Run a single test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show step details", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option(
+  "--mode <mode>",
+  "Execution mode: hybrid (Smart, the default), ai (AI only), replay (No AI)"
+).option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: tv for a TV platform, else phone)",
   parseDeviceCategory
@@ -4187,12 +4242,12 @@ program.command("run-test <test-id>").description("Run a single test case").opti
 `);
     process.exit(2);
   }
+  const runFlags = parseRunFlags(opts);
   const metadata = resolveMetadata(opts);
   return runTest(testId, {
     ...opts,
     metadata,
-    timeout: parseInt(opts.timeout, 10),
-    build: opts.build ? parseInt(opts.build, 10) : void 0
+    ...runFlags
   });
 });
 program.command("list-suites").description("List available test suites").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option(
@@ -4406,7 +4461,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-56MR4KJW.js");
+  const { runMcpServer } = await import("./server-VPNWTXOY.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(

package/dist/{server-56MR4KJW.js → server-VPNWTXOY.js}

@@ -30,7 +30,7 @@ import {
   renderEnvelope,
   resolveMetro,
   startDevSession
-} from "./chunk-MK3WDPVZ.js";
+} from "./chunk-4WIEZBTP.js";
 import {
   ApiClient,
   NotFoundError,
@@ -48,7 +48,7 @@ var SESSION_ID_PROPERTY = {
 };
 var AI_USE_PROPERTY = {
   type: "string",
-  description: "smart (default): replays saved paths and uses AI only where the screen changed; no_ai: replays only, no usage credit; ai_only: the AI does every step.",
+  description: "smart (default): replays recorded and learned paths, and uses AI only where the screen changed or a step has no path yet; no_ai: replays only, no AI and no usage credit (a step with no path is not checked); ai_only: the AI does every step.",
   enum: ["smart", "no_ai", "ai_only"]
 };
 var AI_USE_MODE = { smart: "hybrid", no_ai: "replay", ai_only: "ai" };
@@ -419,6 +419,9 @@ async function handleRun(kind, args, deps) {
     return errorResult(`error: ${testToolErrorMessage(err)}`);
   }
 }
+function withoutNotRunPrefix(reason) {
+  return reason ? reason.replace(/^Not run:\s*/, "") : reason;
+}
 function notCheckedNote(status, n) {
   if (status !== "passed" || typeof n !== "number" || n <= 0) return "";
   return ` \u2014 ${n} step${n === 1 ? "" : "s"} not checked (no recorded actions; not verified)`;
@@ -461,12 +464,25 @@ function formatRunForAgent(run) {
       lines.push(head);
       for (const r of lane.runs ?? []) {
         const count = r.kind === "group" && typeof r.tests_total === "number" ? ` (${r.tests_passed ?? 0}/${r.tests_total} tests passed${testsNotChecked(r.tests_not_checked)}${quarantinedCount(rowQuarantined(r))})` : "";
-        const q = r.kind === "test" && quarantinedFailure(r.tests?.[0] ?? {}) ? " (quarantined)" : "";
+        const cell = r.kind === "test" ? r.tests?.[0] ?? {} : {};
+        const q = r.kind === "test" && quarantinedFailure(cell) ? " (quarantined)" : "";
+        const why = withoutNotRunPrefix(r.error_message || cell.not_run_reason);
+        const unchecked = r.kind === "test" ? notCheckedNote(outcomeOf(cell), cell.steps_not_checked) : "";
         lines.push(
-          `  ${r.name}: ${agentStatus(r)}${q}${count}${r.error_message ? ` \u2014 ${r.error_message}` : ""}`
+          `  ${r.name}: ${agentStatus(r)}${q}${count}${why ? ` \u2014 ${why}` : ""}${unchecked}`
         );
         if (r.kind !== "group") continue;
         for (const t of r.tests ?? []) {
+          if (t.status === "not_run") {
+            const reason = withoutNotRunPrefix(t.not_run_reason || t.error_message);
+            lines.push(`    ${t.name}: not run${reason ? ` \u2014 ${reason}` : ""}`);
+            continue;
+          }
+          const note = notCheckedNote(outcomeOf(t), t.steps_not_checked);
+          if (note) {
+            lines.push(`    ${t.name}: ${agentStatus(t)}${note}`);
+            continue;
+          }
           if (t.status !== "failed" && t.status !== "error") continue;
           const tq = quarantinedFailure(t) ? " (quarantined)" : "";
           lines.push(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.40.0",
+  "version": "0.42.0",
   "description": "VibeView CLI -- run your app on cloud iOS simulators, Android emulators, Apple TV, Android TV and Roku 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",