vibeview 0.28.1 → 0.30.0

package/dist/{chunk-3DKY443B.js → chunk-NOZGZT3G.js}

@@ -13,10 +13,10 @@ import {
   resolveArtifact,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-PBMB6TG4.js";
+} from "./chunk-ZZK7YQSP.js";
 
 // src/lib/dev-config.ts
-import { readFileSync, writeFileSync } from "fs";
+import { readFileSync, renameSync, rmSync, 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_]*$/;
@@ -166,7 +166,58 @@ function validateBuildEnv(env, platformKey) {
   }
 }
 function saveDevConfig(cwd, cfg) {
-  writeFileSync(join(cwd, FILE), JSON.stringify(cfg, null, 2) + "\n");
+  const target = join(cwd, FILE);
+  const tmp = join(cwd, `.${FILE}.${process.pid}.${Date.now()}.tmp`);
+  try {
+    writeFileSync(tmp, JSON.stringify(cfg, null, 2) + "\n");
+    renameSync(tmp, target);
+  } catch (err) {
+    rmSync(tmp, { force: true });
+    throw err;
+  }
+}
+function updateDevConfig(cwd, platform, apply) {
+  const fresh = loadDevConfig(cwd) ?? { defaultPlatform: platform, platforms: {} };
+  if (apply(fresh) === false) return fresh;
+  saveDevConfig(cwd, fresh);
+  return fresh;
+}
+function configLeaves(value, path = [], out = []) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    for (const [k, v] of Object.entries(value)) {
+      configLeaves(v, [...path, k], out);
+    }
+  } else if (value !== void 0) {
+    out.push({ path, value });
+  }
+  return out;
+}
+function applyConfigChanges(target, before, after) {
+  const key = (path) => JSON.stringify(path);
+  const prev = new Map(configLeaves(before ?? {}).map((l) => [key(l.path), l.value]));
+  const root = target;
+  for (const { path, value } of configLeaves(after)) {
+    const old = prev.get(key(path));
+    prev.delete(key(path));
+    if (old !== void 0 && JSON.stringify(old) === JSON.stringify(value)) continue;
+    let node = root;
+    for (const segment of path.slice(0, -1)) {
+      const child = node[segment];
+      if (!child || typeof child !== "object" || Array.isArray(child)) node[segment] = {};
+      node = node[segment];
+    }
+    node[path[path.length - 1]] = value;
+  }
+  for (const k of prev.keys()) {
+    const path = JSON.parse(k);
+    let node = root;
+    for (const segment of path.slice(0, -1)) {
+      node = node && typeof node === "object" ? node[segment] : void 0;
+    }
+    if (node && typeof node === "object") {
+      delete node[path[path.length - 1]];
+    }
+  }
 }
 function describeConfigChanges(before, after) {
   const flat = (value, prefix, out) => {
@@ -220,6 +271,10 @@ function buildSavedConfig(input2) {
     platforms: {
       ...existing?.platforms,
       [platform]: {
+        // Everything else on the entry (`submit` defaults, keys a newer CLI
+        // wrote) is carried forward untouched; the fields below are the ones
+        // `vibeview dev` owns.
+        ...existing?.platforms?.[platform],
         appId,
         deviceCategory: isTv ? void 0 : deviceCategory,
         ...existing?.platforms?.[platform]?.build ? { build: { ...existing.platforms[platform].build } } : {},
@@ -235,6 +290,11 @@ function buildSavedConfig(input2) {
 }
 
 // src/lib/dev-build.ts
+function canUseMetro(build) {
+  if (build.can_use_metro === true || build.can_use_metro === false) return build.can_use_metro;
+  if (build.is_debug === true) return true;
+  return build.is_debug === false ? false : null;
+}
 function parseBuildId(raw) {
   const text = typeof raw === "number" ? String(raw) : typeof raw === "string" ? raw.trim() : "";
   if (!/^\d+$/.test(text) || Number(text) < 1) {
@@ -244,9 +304,10 @@ function parseBuildId(raw) {
   }
   return Number(text);
 }
-function buildKind(isDebug) {
-  if (isDebug === true) return "debug";
-  if (isDebug === false) return "release";
+function buildKind(build) {
+  const usable = build !== null && typeof build === "object" ? canUseMetro(build) : canUseMetro({ is_debug: build });
+  if (usable === true) return "debug";
+  if (usable === false) return "release";
   return "unknown";
 }
 function checkDevBuild(app, buildId, platform, opts = {}) {
@@ -266,10 +327,11 @@ function checkDevBuild(app, buildId, platform, opts = {}) {
       `build ${buildId} is not a build of app ${app.public_id} \u2014 see \`vibeview list-builds ${app.public_id}\``
     );
   }
-  if (!opts.standalone && 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";
+  const usable = canUseMetro(build);
+  if (!opts.standalone && usable !== true) {
+    const why = usable === false ? "it is a release build (or not a React Native build), so it cannot load JavaScript from Metro" : "it could not be identified as a React Native 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}\`)`
+      `build ${buildId} is not a debug build \u2014 ${why}. \`vibeview dev\` needs ${platformWithArticle(platform)} React Native debug simulator/emulator build (see \`vibeview list-builds ${app.public_id}\`); to run this build as it is, with no Metro, use \`vibeview dev --standalone --build ${buildId}\``
     );
   }
   return build;
@@ -283,8 +345,9 @@ function buildRows(app) {
     version: b.version ?? null,
     build_number: b.build_number ?? null,
     platform: app.platform,
-    kind: buildKind(b.is_debug),
+    kind: buildKind(b),
     is_debug: b.is_debug ?? null,
+    can_use_metro: canUseMetro(b),
     uploaded_at: b.uploaded_at ?? null,
     note: b.note ?? null
   }));
@@ -329,7 +392,7 @@ async function listBuilds(appId, opts, deps) {
 }
 
 // src/lib/dev-state.ts
-import { existsSync, mkdirSync, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync, mkdirSync, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
 import { dirname, join as join2 } from "path";
 var STATE_DIR = ".vibeview";
 var STATE_FILE = "dev-state.json";
@@ -399,7 +462,7 @@ function readDevState(cwd) {
 function clearDevState(cwd) {
   const path = statePath(cwd);
   if (existsSync(path)) {
-    rmSync(path, { force: true });
+    rmSync2(path, { force: true });
   }
 }
 
@@ -416,6 +479,108 @@ async function checkMetro(port, timeoutMs = 1500) {
   }
 }
 
+// src/lib/local-config.ts
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync3, renameSync as renameSync2, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "fs";
+import { join as join3 } from "path";
+var DIR = ".vibeview";
+var FILE2 = "local.json";
+function localConfigPath(cwd) {
+  return join3(cwd, DIR, FILE2);
+}
+function loadLocalDevConfig(cwd) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync3(localConfigPath(cwd), "utf-8"));
+  } catch {
+    return {};
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+  const raw = parsed;
+  const out = {};
+  if (isDevPlatform(raw.defaultPlatform)) out.defaultPlatform = raw.defaultPlatform;
+  if (raw.platforms && typeof raw.platforms === "object") {
+    for (const [key, value] of Object.entries(raw.platforms)) {
+      if (!isDevPlatform(key) || !value || typeof value !== "object") continue;
+      const v = value;
+      const entry = {};
+      if (typeof v.appId === "string" && v.appId) entry.appId = v.appId;
+      if (typeof v.deviceCategory === "string" && v.deviceCategory) {
+        entry.deviceCategory = v.deviceCategory;
+      }
+      if (typeof v.metroPort === "number" && Number.isInteger(v.metroPort) && v.metroPort > 0) {
+        entry.metroPort = v.metroPort;
+      }
+      if (Object.keys(entry).length) (out.platforms ??= {})[key] = entry;
+    }
+  }
+  return out;
+}
+function prune(cfg) {
+  const out = {};
+  if (cfg.defaultPlatform) out.defaultPlatform = cfg.defaultPlatform;
+  for (const [key, entry] of Object.entries(cfg.platforms ?? {})) {
+    const kept = Object.fromEntries(
+      Object.entries(entry ?? {}).filter(([, v]) => v !== void 0)
+    );
+    if (Object.keys(kept).length) (out.platforms ??= {})[key] = kept;
+  }
+  return out;
+}
+function saveLocalDevConfig(cwd, cfg) {
+  const pruned = prune(cfg);
+  const target = localConfigPath(cwd);
+  if (!pruned.defaultPlatform && !pruned.platforms) {
+    rmSync3(target, { force: true });
+    return;
+  }
+  mkdirSync2(join3(cwd, DIR), { recursive: true });
+  const tmp = `${target}.${process.pid}.${Date.now()}.tmp`;
+  try {
+    writeFileSync3(tmp, JSON.stringify(pruned, null, 2) + "\n");
+    renameSync2(tmp, target);
+  } catch (err) {
+    rmSync3(tmp, { force: true });
+    throw err;
+  }
+  ensureGitignored(cwd);
+}
+function effectiveDevConfig(committed, local) {
+  if (!committed && !local.defaultPlatform && !local.platforms) return null;
+  const base = committed ? { ...committed, platforms: { ...committed.platforms } } : { defaultPlatform: local.defaultPlatform ?? "ios", platforms: {} };
+  if (local.defaultPlatform) base.defaultPlatform = local.defaultPlatform;
+  for (const [key, entry] of Object.entries(local.platforms ?? {})) {
+    const platform = key;
+    const merged = { ...base.platforms[platform] };
+    if (entry?.appId) merged.appId = entry.appId;
+    if (entry?.deviceCategory) merged.deviceCategory = entry.deviceCategory;
+    if (entry?.metroPort !== void 0) merged.metroPort = entry.metroPort;
+    base.platforms[platform] = merged;
+  }
+  return base;
+}
+function describeLocalChanges(before, after) {
+  const changes = [];
+  const a = prune(before);
+  const b = prune(after);
+  if (a.defaultPlatform !== b.defaultPlatform) {
+    changes.push(
+      b.defaultPlatform ? `defaultPlatform ${b.defaultPlatform}` : `defaultPlatform (removed, was ${a.defaultPlatform})`
+    );
+  }
+  const keys = /* @__PURE__ */ new Set([...Object.keys(a.platforms ?? {}), ...Object.keys(b.platforms ?? {})]);
+  for (const key of keys) {
+    const pa = a.platforms?.[key] ?? {};
+    const pb = b.platforms?.[key] ?? {};
+    for (const field of ["appId", "deviceCategory", "metroPort"]) {
+      if (pa[field] === pb[field]) continue;
+      changes.push(
+        pb[field] === void 0 ? `${key}.${field} (removed, was ${String(pa[field])})` : `${key}.${field} ${String(pb[field])}`
+      );
+    }
+  }
+  return changes;
+}
+
 // src/commands/build.ts
 import { spawn as spawn2 } from "child_process";
 import { createInterface } from "readline";
@@ -427,12 +592,12 @@ import chalk2 from "chalk";
 import { input, select } from "@inquirer/prompts";
 
 // src/lib/project-detect.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3, readdirSync, statSync } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync4, readdirSync, statSync } from "fs";
+import { join as join4 } from "path";
 import ignore from "ignore";
 function readJson(cwd, name) {
   try {
-    return JSON.parse(readFileSync3(join3(cwd, name), "utf-8"));
+    return JSON.parse(readFileSync4(join4(cwd, name), "utf-8"));
   } catch {
     return null;
   }
@@ -447,19 +612,19 @@ function isFile(path) {
 function detectFlavor(cwd) {
   let deps = {};
   try {
-    const pkg = JSON.parse(readFileSync3(join3(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync4(join4(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
   }
   if ("expo" in deps) return "expo";
-  if (existsSync2(join3(cwd, "android", "gradlew")) || iosWorkspaceName(cwd)) return "bare-rn";
-  if (isFile(join3(cwd, "manifest"))) return "roku";
+  if (existsSync2(join4(cwd, "android", "gradlew")) || iosWorkspaceName(cwd)) return "bare-rn";
+  if (isFile(join4(cwd, "manifest"))) return "roku";
   return "unknown";
 }
 function nativeDirShipped(cwd, dir) {
-  if (!existsSync2(join3(cwd, dir))) return false;
+  if (!existsSync2(join4(cwd, dir))) return false;
   try {
-    const ig = ignore().add(readFileSync3(join3(cwd, ".gitignore"), "utf-8"));
+    const ig = ignore().add(readFileSync4(join4(cwd, ".gitignore"), "utf-8"));
     return !ig.ignores(`${dir}/`);
   } catch {
     return true;
@@ -475,7 +640,7 @@ function isManagedExpo(cwd, platform) {
 }
 function iosWorkspaceName(cwd) {
   try {
-    const found = readdirSync(join3(cwd, "ios")).find((f) => f.endsWith(".xcworkspace"));
+    const found = readdirSync(join4(cwd, "ios")).find((f) => f.endsWith(".xcworkspace"));
     return found ? found.replace(/\.xcworkspace$/, "") : null;
   } catch {
     return null;
@@ -484,9 +649,9 @@ function iosWorkspaceName(cwd) {
 var IOS_ARTIFACT = "ios/build/Build/Products/Debug-iphonesimulator/*.app";
 var ANDROID_ARTIFACT = "android/app/build/outputs/apk/debug/*.apk";
 function installCommand(cwd) {
-  if (existsSync2(join3(cwd, "yarn.lock"))) return "yarn install --immutable";
-  if (existsSync2(join3(cwd, "pnpm-lock.yaml"))) return "pnpm install --frozen-lockfile";
-  if (existsSync2(join3(cwd, "package-lock.json"))) return "npm ci";
+  if (existsSync2(join4(cwd, "yarn.lock"))) return "yarn install --immutable";
+  if (existsSync2(join4(cwd, "pnpm-lock.yaml"))) return "pnpm install --frozen-lockfile";
+  if (existsSync2(join4(cwd, "package-lock.json"))) return "npm ci";
   return "yarn install --immutable";
 }
 function managedExpoAndroidCommand(cwd) {
@@ -500,7 +665,7 @@ var ROKU_ZIP_COMMAND = "zip -r out/channel.zip manifest source components images
 function rokuDefaults(cwd) {
   const pkg = readJson(cwd, "package.json");
   const scripts = pkg?.scripts ?? {};
-  const runner = existsSync2(join3(cwd, "yarn.lock")) ? "yarn" : "npm run";
+  const runner = existsSync2(join4(cwd, "yarn.lock")) ? "yarn" : "npm run";
   const packageScript = Object.entries(scripts).find(
     ([name, body]) => !name.startsWith("deploy") && (name.startsWith("package") || body.includes("--package-only") || body.includes("zipPackage"))
   );
@@ -558,7 +723,7 @@ function expoSanitizedName(name) {
   return name.replace(/[\W_]+/g, "").normalize("NFD").replace(/[\u0300-\u036f]/g, "");
 }
 function managedExpoIosName(cwd) {
-  if (existsSync2(join3(cwd, "app.config.js")) || existsSync2(join3(cwd, "app.config.ts"))) {
+  if (existsSync2(join4(cwd, "app.config.js")) || existsSync2(join4(cwd, "app.config.ts"))) {
     return null;
   }
   const raw = readJson(cwd, "app.config.json") ?? readJson(cwd, "app.json");
@@ -703,9 +868,9 @@ async function promptMetroCommand(cwd, platform) {
 
 // src/lib/source-pack.ts
 import { execFile, spawn } from "child_process";
-import { lstatSync, mkdtempSync, readFileSync as readFileSync4, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { lstatSync, mkdtempSync, readFileSync as readFileSync5, rmSync as rmSync4, statSync as statSync2, writeFileSync as writeFileSync4 } from "fs";
 import { tmpdir } from "os";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 import ignore2 from "ignore";
 var NotAGitRepoError = class extends Error {
   constructor(message) {
@@ -731,15 +896,15 @@ async function listSourceFiles(projectRoot) {
   const stdout = await runGitLsFiles(projectRoot);
   const rawPaths = stdout.length ? stdout.split("\0").filter((p) => p.length > 0) : [];
   let filtered = rawPaths;
-  const vvignorePath = join4(projectRoot, ".vvignore");
+  const vvignorePath = join5(projectRoot, ".vvignore");
   if (statOrNull(vvignorePath)?.isFile()) {
-    const ig = ignore2().add(readFileSync4(vvignorePath, "utf-8"));
+    const ig = ignore2().add(readFileSync5(vvignorePath, "utf-8"));
     filtered = filtered.filter((p) => !ig.ignores(p));
   }
   const result = [];
   for (const relPath of filtered) {
     if (isForceExcluded(relPath)) continue;
-    const st = statOrNull(join4(projectRoot, relPath));
+    const st = statOrNull(join5(projectRoot, relPath));
     if (!st) continue;
     result.push(relPath);
   }
@@ -789,7 +954,7 @@ async function packSource(projectRoot, files, opts = {}) {
   let totalBytes = 0;
   const sized = [];
   for (const relPath of files) {
-    const bytes = lstatSync(join4(projectRoot, relPath)).size;
+    const bytes = lstatSync(join5(projectRoot, relPath)).size;
     totalBytes += bytes;
     sized.push({ path: relPath, bytes });
   }
@@ -800,14 +965,14 @@ async function packSource(projectRoot, files, opts = {}) {
       largest
     );
   }
-  const tmpDir = mkdtempSync(join4(tmpdir(), "vibeview-source-pack-"));
-  const cleanup = () => rmSync2(tmpDir, { recursive: true, force: true });
+  const tmpDir = mkdtempSync(join5(tmpdir(), "vibeview-source-pack-"));
+  const cleanup = () => rmSync4(tmpDir, { recursive: true, force: true });
   try {
     const supportsNull = await probeTarNullSupport();
-    const tarPath = join4(tmpDir, "source.tgz");
+    const tarPath = join5(tmpDir, "source.tgz");
     if (supportsNull) {
-      const listPath = join4(tmpDir, "files.list");
-      writeFileSync3(listPath, files.map((f) => `${f}\0`).join(""));
+      const listPath = join5(tmpDir, "files.list");
+      writeFileSync4(listPath, files.map((f) => `${f}\0`).join(""));
       await runTar(["-czf", tarPath, "-C", projectRoot, "--null", "-T", listPath]);
     } else {
       const badName = files.find((f) => f.includes("\n"));
@@ -816,8 +981,8 @@ async function packSource(projectRoot, files, opts = {}) {
           `cannot pack source: filename contains a newline (${JSON.stringify(badName)}) and the installed tar doesn't support --null -T; rename the file or install a tar that supports --null`
         );
       }
-      const listPath = join4(tmpDir, "files.list");
-      writeFileSync3(listPath, files.map((f) => `${f}
+      const listPath = join5(tmpDir, "files.list");
+      writeFileSync4(listPath, files.map((f) => `${f}
 `).join(""));
       await runTar(["-czf", tarPath, "-C", projectRoot, "-T", listPath]);
     }
@@ -837,12 +1002,12 @@ var nullSupportCache = null;
 function probeTarNullSupport() {
   if (!nullSupportCache) {
     nullSupportCache = new Promise((resolve) => {
-      const tmp = mkdtempSync(join4(tmpdir(), "vibeview-tar-probe-"));
-      const listPath = join4(tmp, "empty.list");
-      writeFileSync3(listPath, "");
-      const out = join4(tmp, "probe.tgz");
+      const tmp = mkdtempSync(join5(tmpdir(), "vibeview-tar-probe-"));
+      const listPath = join5(tmp, "empty.list");
+      writeFileSync4(listPath, "");
+      const out = join5(tmp, "probe.tgz");
       execFile("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
-        rmSync2(tmp, { recursive: true, force: true });
+        rmSync4(tmp, { recursive: true, force: true });
         resolve(!err);
       });
     });
@@ -946,30 +1111,28 @@ async function resolveBarePlatform(cwd, cfg, opts) {
   }
   return platform;
 }
-function persistPromptedBuild(cwd, cfg, platform, build) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
-  const entry = next.platforms[platform];
-  if (entry) {
-    entry.build = build;
-  } else {
-    next.platforms[platform] = { build };
-  }
-  saveDevConfig(cwd, next);
-  return next;
+function persistPromptedBuild(cwd, platform, build) {
+  return updateDevConfig(cwd, platform, (next) => {
+    const entry = next.platforms[platform];
+    if (entry) {
+      entry.build = build;
+    } else {
+      next.platforms[platform] = { build };
+    }
+  });
 }
-function persistUploadedAppId(cwd, cfg, platform, build, appId) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
-  const entry = next.platforms[platform];
-  if (!entry) {
-    next.platforms[platform] = { appId, build };
-    saveDevConfig(cwd, next);
-    return;
-  }
-  if (entry.appId !== appId || !entry.build) {
+function persistUploadedAppId(cwd, platform, build, appId) {
+  updateDevConfig(cwd, platform, (next) => {
+    const entry = next.platforms[platform];
+    if (!entry) {
+      next.platforms[platform] = { appId, build };
+      return true;
+    }
+    if (entry.appId === appId && entry.build) return false;
     entry.appId = appId;
-    entry.build = build;
-    saveDevConfig(cwd, next);
-  }
+    if (!entry.build) entry.build = build;
+    return true;
+  });
 }
 async function resolveBuildConfig(cwd, cfgRef, platform, opts) {
   const existing = cfgRef.current?.platforms?.[platform]?.build;
@@ -985,11 +1148,15 @@ async function resolveBuildConfig(cwd, cfgRef, platform, opts) {
   if (!answered) {
     fail(opts, "build config is required to run vibeview build", "config_required");
   }
-  cfgRef.current = persistPromptedBuild(cwd, cfgRef.current, platform, answered);
+  cfgRef.current = persistPromptedBuild(cwd, platform, answered);
   return answered;
 }
-function persistPromptedProductionBuild(cwd, cfg, platform, production) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
+function persistPromptedProductionBuild(cwd, platform, production) {
+  return updateDevConfig(cwd, platform, (next) => {
+    mergeProductionPair(next, platform, production);
+  });
+}
+function mergeProductionPair(next, platform, production) {
   const existingBuild = next.platforms[platform]?.build;
   if (!existingBuild?.command || !existingBuild?.artifact) {
     throw new Error(
@@ -997,8 +1164,6 @@ function persistPromptedProductionBuild(cwd, cfg, platform, production) {
     );
   }
   next.platforms[platform].build = { ...existingBuild, ...production };
-  saveDevConfig(cwd, next);
-  return next;
 }
 async function resolveProductionBuildConfig(cwd, cfgRef, platform, opts) {
   const entry = cfgRef.current?.platforms?.[platform]?.build;
@@ -1016,7 +1181,7 @@ async function resolveProductionBuildConfig(cwd, cfgRef, platform, opts) {
   if (!answered) {
     fail(opts, "a production build config is required for --production", "config_required");
   }
-  cfgRef.current = persistPromptedProductionBuild(cwd, cfgRef.current, platform, answered);
+  cfgRef.current = persistPromptedProductionBuild(cwd, platform, answered);
   return { command: answered.productionCommand, artifact: answered.productionArtifact };
 }
 async function buildCommand(opts, cloudDeps) {
@@ -1036,7 +1201,6 @@ async function buildCommand(opts, cloudDeps) {
     }
     const platform = await resolveBarePlatform(cwd, cfgRef.current, opts);
     const build = await resolveBuildConfig(cwd, cfgRef, platform, opts);
-    const cfg = cfgRef.current;
     const result = await runBuildForPlatform(
       cwd,
       platform,
@@ -1045,7 +1209,7 @@ async function buildCommand(opts, cloudDeps) {
       (l) => console.error(chalk3.dim(l))
     );
     for (const w of result.warnings ?? []) console.error(chalk3.yellow(`\u26A0 ${w}`));
-    persistUploadedAppId(cwd, cfg, platform, build, result.public_id);
+    persistUploadedAppId(cwd, platform, build, result.public_id);
     if (opts.json) {
       console.log(
         JSON.stringify({ app_id: result.public_id, name: result.name, platform: result.platform })
@@ -1148,16 +1312,17 @@ function requireProductionCapable(opts, platform) {
     fail(opts, productionUnsupportedReason(platform));
   }
 }
-function persistPickedAppId(cwd, cfg, platform, appId) {
-  const next = cfg ?? { defaultPlatform: platform, platforms: {} };
-  const entry = next.platforms[platform];
-  if (entry) {
-    entry.appId = appId;
-  } else {
-    next.platforms[platform] = { appId };
-  }
-  saveDevConfig(cwd, next);
-  return next;
+function persistPickedAppId(cwd, platform, appId, opts = {}) {
+  return updateDevConfig(cwd, platform, (next) => {
+    const entry = next.platforms[platform];
+    if (opts.onlyIfUnset && entry?.appId) return false;
+    if (entry) {
+      entry.appId = appId;
+    } else {
+      next.platforms[platform] = { appId };
+    }
+    return true;
+  });
 }
 var APP_PICKER_SENTINEL = {
   CREATE_NEW_APP: "__vibeview_create_new_app__",
@@ -1225,7 +1390,7 @@ async function resolveCloudAppIds(cwd, cfgRef, platforms, opts, listApps) {
       createFromArtifact.add(platform);
       continue;
     }
-    cfgRef.current = persistPickedAppId(cwd, cfgRef.current, platform, appId);
+    cfgRef.current = persistPickedAppId(cwd, platform, appId);
   }
   return createFromArtifact;
 }
@@ -1235,7 +1400,7 @@ function persistResolvedAppIds(cwd, cfgRef, createFromArtifact, finished) {
     const platform = b.platform;
     if (!createFromArtifact.has(platform)) continue;
     if (cfgRef.current?.platforms?.[platform]?.appId) continue;
-    cfgRef.current = persistPickedAppId(cwd, cfgRef.current, platform, b.app_public_id);
+    cfgRef.current = persistPickedAppId(cwd, platform, b.app_public_id, { onlyIfUnset: true });
   }
 }
 function describeAllExclusions(configured) {
@@ -1714,7 +1879,7 @@ your build command must produce a zip \u2014 use the package/zip step, not deplo
 
 // src/commands/dev.ts
 import { spawn as spawn4 } from "child_process";
-import { createWriteStream, mkdirSync as mkdirSync3 } from "fs";
+import { createWriteStream, mkdirSync as mkdirSync4 } from "fs";
 import { dirname as dirname4 } from "path";
 import { createInterface as createInterface3 } from "readline";
 import { select as select3 } from "@inquirer/prompts";
@@ -1910,15 +2075,15 @@ import { spawn as spawn3 } from "child_process";
 import { createInterface as createInterface2 } from "readline";
 
 // src/lib/metro-state.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname2, join as join5 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync6, rmSync as rmSync5, writeFileSync as writeFileSync5 } from "fs";
+import { dirname as dirname2, join as join6 } from "path";
 var STATE_DIR2 = ".vibeview";
 var STATE_FILE2 = "metro-state.json";
 function statePath2(cwd) {
-  return join5(cwd, STATE_DIR2, STATE_FILE2);
+  return join6(cwd, STATE_DIR2, STATE_FILE2);
 }
 function metroLogPath(cwd) {
-  return join5(cwd, STATE_DIR2, "metro.log");
+  return join6(cwd, STATE_DIR2, "metro.log");
 }
 function isPidAlive2(pid) {
   try {
@@ -1930,13 +2095,13 @@ function isPidAlive2(pid) {
 }
 function writeMetroState(cwd, state) {
   const path = statePath2(cwd);
-  mkdirSync2(dirname2(path), { recursive: true });
-  writeFileSync4(path, JSON.stringify(state, null, 2) + "\n");
+  mkdirSync3(dirname2(path), { recursive: true });
+  writeFileSync5(path, JSON.stringify(state, null, 2) + "\n");
 }
 function readMetroState(cwd) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync5(statePath2(cwd), "utf-8"));
+    parsed = JSON.parse(readFileSync6(statePath2(cwd), "utf-8"));
   } catch {
     return null;
   }
@@ -1948,7 +2113,7 @@ function readMetroState(cwd) {
 }
 function clearMetroState(cwd) {
   const path = statePath2(cwd);
-  if (existsSync3(path)) rmSync3(path, { force: true });
+  if (existsSync3(path)) rmSync5(path, { force: true });
 }
 function killOwnedMetro(cwd) {
   const state = readMetroState(cwd);
@@ -2461,17 +2626,19 @@ function requireNonInteractive(json, message) {
 }
 async function ensureConfig(api, opts) {
   const existing = loadDevConfig(process.cwd());
+  const local = loadLocalDevConfig(process.cwd());
+  const effective = effectiveDevConfig(existing, local);
   if (opts.platform && !isDevPlatform(opts.platform)) {
     console.error(chalk4.red(`error: --platform must be one of ${DEV_PLATFORMS.join(", ")}`));
     process.exit(2);
   }
-  if (!opts.platform && !existing?.defaultPlatform) {
+  if (!opts.platform && !effective?.defaultPlatform) {
     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({
+  const platform = opts.platform || effective?.defaultPlatform || await select3({
     message: "Platform to run on",
     choices: platformChoices(process.cwd())
   });
@@ -2508,7 +2675,7 @@ async function ensureConfig(api, opts) {
       }
     }
   }
-  const entry = existing?.platforms?.[platform];
+  const entry = effective?.platforms?.[platform];
   let allApps;
   try {
     allApps = await api.listApps();
@@ -2528,6 +2695,7 @@ ${hint}`);
     process.exit(2);
   }
   let appId = choice.appId;
+  const appFromFlag = Boolean(opts.app) && appId === opts.app;
   let builtThisRun = false;
   if (choice.staleCached) {
     console.error(
@@ -2600,30 +2768,70 @@ ${hint}`);
     });
   }
   const deviceCategory = isTv ? "tv" : opts.deviceCategory || entry?.deviceCategory || "phone";
-  const metroResolved = resolveMetro(
-    existing,
-    platform,
-    opts.metroPort ? parseInt(opts.metroPort, 10) : void 0
-  );
+  const metroPortFlag = opts.metroPort ? parseInt(opts.metroPort, 10) : void 0;
+  const metroResolved = resolveMetro(effective, platform, metroPortFlag);
+  const committedEntry = existing?.platforms?.[platform];
+  const nextLocal = JSON.parse(JSON.stringify(local));
+  const localEntry = (nextLocal.platforms ??= {})[platform] ??= {};
+  let committedAppId = committedEntry?.appId;
+  if (!committedAppId) {
+    committedAppId = appId;
+  } else if (appId !== committedAppId) {
+    if (appFromFlag || local.platforms?.[platform]?.appId !== void 0) {
+      localEntry.appId = appId;
+    } else {
+      committedAppId = appId;
+    }
+  }
+  if (appId === committedAppId) delete localEntry.appId;
+  let committedCategory = committedEntry?.deviceCategory;
+  if (!isTv) {
+    if (!committedCategory) committedCategory = deviceCategory;
+    if (deviceCategory !== committedCategory) localEntry.deviceCategory = deviceCategory;
+    else delete localEntry.deviceCategory;
+  }
+  const committedDefault = existing?.defaultPlatform ?? platform;
+  if (opts.platform) {
+    if (platform !== committedDefault) nextLocal.defaultPlatform = platform;
+    else delete nextLocal.defaultPlatform;
+  }
   const cfg = buildSavedConfig({
     existing,
     platform,
-    appId,
-    deviceCategory,
+    appId: committedAppId,
+    deviceCategory: committedCategory ?? deviceCategory,
     isTv,
-    metroPortFlag: opts.metroPort,
+    // Never the flag: vibeview.json keeps (or, on the first run, seeds) the
+    // shared default; the flag's port is saved locally below.
+    metroPortFlag: void 0,
     isFirstRun,
     firstRunMetro,
     firstRunBuild
   });
+  cfg.defaultPlatform = committedDefault;
+  if (metroPortFlag !== void 0 && PLATFORM_NEEDS_METRO[platform]) {
+    if (metroPortFlag !== resolveMetro(cfg, platform).port) localEntry.metroPort = metroPortFlag;
+    else delete localEntry.metroPort;
+  }
   const commitConfig = () => {
-    saveDevConfig(process.cwd(), cfg);
+    updateDevConfig(process.cwd(), platform, (fresh) => {
+      applyConfigChanges(fresh, existing, cfg);
+    });
     if (existing) {
       const changes = describeConfigChanges(existing, cfg);
       if (changes.length) {
         console.error(chalk4.dim(`Updated vibeview.json: ${changes.join(", ")}`));
       }
     }
+    const localChanges = describeLocalChanges(local, nextLocal);
+    if (localChanges.length) {
+      saveLocalDevConfig(process.cwd(), nextLocal);
+      console.error(
+        chalk4.dim(
+          `Saved to .vibeview/local.json (yours only, not committed): ${localChanges.join(", ")}`
+        )
+      );
+    }
     if (isFirstRun) {
       console.error(chalk4.dim(`Created vibeview.json (platform: ${platform}, app: ${appId}).`));
       const hint = fillLaterHint(
@@ -2633,7 +2841,7 @@ ${hint}`);
       if (hint) console.error(chalk4.dim(hint));
     }
   };
-  const finalMetro = isFirstRun ? resolveMetro(cfg, platform, opts.metroPort ? parseInt(opts.metroPort, 10) : void 0) : metroResolved;
+  const finalMetro = isFirstRun ? resolveMetro(effectiveDevConfig(cfg, nextLocal), platform, metroPortFlag) : metroResolved;
   return {
     platform,
     appId,
@@ -2657,6 +2865,13 @@ async function runDevInProcess(opts) {
     emit(opts.json, { event: "error", code: "invalid_flag", message });
     process.exit(2);
   }
+  const standalone = opts.standalone === true;
+  if (standalone && opts.platform === "roku") {
+    const message = "--standalone is not for roku \u2014 a Roku dev session has no Metro; it re-packages the channel";
+    console.error(chalk4.red(`error: ${message}`));
+    emit(opts.json, { event: "error", code: "invalid_flag", message });
+    process.exit(2);
+  }
   let pinnedBuildId;
   if (typeof opts.build === "string") {
     try {
@@ -2685,7 +2900,7 @@ async function runDevInProcess(opts) {
   const cfg = await ensureConfig(api, opts);
   if (pinnedBuildId !== void 0) {
     try {
-      checkDevBuild(await api.getApp(cfg.appId), pinnedBuildId, cfg.platform);
+      checkDevBuild(await api.getApp(cfg.appId), pinnedBuildId, cfg.platform, { standalone });
     } catch (err) {
       const message = err.message;
       console.error(chalk4.red(`error: ${message}`));
@@ -2721,9 +2936,20 @@ async function runDevInProcess(opts) {
         (l) => console.error(chalk4.dim(l))
       );
       cfg.appId = result.public_id;
-      if (reloaded && reloaded.platforms[cfg.platform] && reloaded.platforms[cfg.platform].appId !== result.public_id) {
-        reloaded.platforms[cfg.platform].appId = result.public_id;
-        saveDevConfig(process.cwd(), reloaded);
+      const localNow = loadLocalDevConfig(process.cwd());
+      const localApp = localNow.platforms?.[cfg.platform];
+      if (localApp?.appId !== void 0) {
+        const committedApp = loadDevConfig(process.cwd())?.platforms?.[cfg.platform]?.appId;
+        if (result.public_id === committedApp) delete localApp.appId;
+        else localApp.appId = result.public_id;
+        saveLocalDevConfig(process.cwd(), localNow);
+      } else {
+        updateDevConfig(process.cwd(), cfg.platform, (fresh) => {
+          const entry = fresh.platforms[cfg.platform];
+          if (!entry || entry.appId === result.public_id) return false;
+          entry.appId = result.public_id;
+          return true;
+        });
       }
     } catch (err) {
       const message = err.message;
@@ -2735,7 +2961,14 @@ async function runDevInProcess(opts) {
   let metroOwnedThisRun = false;
   let rokuBuild;
   let watchIgnore = [];
-  if (PLATFORM_NEEDS_METRO[cfg.platform]) {
+  if (standalone && cfg.platform === "roku") {
+    const message = "--standalone is not for roku \u2014 a Roku dev session has no Metro";
+    console.error(chalk4.red(`error: ${message}`));
+    emit(opts.json, { event: "error", code: "invalid_flag", message });
+    process.exit(2);
+  }
+  if (standalone) {
+  } else if (PLATFORM_NEEDS_METRO[cfg.platform]) {
     const metroPort = cfg.metroPort ?? 8081;
     let metroResult;
     try {
@@ -2743,7 +2976,7 @@ async function runDevInProcess(opts) {
       const captureMetroLine = (line) => {
         try {
           if (!metroLogStream) {
-            mkdirSync3(dirname4(metroLogPath(process.cwd())), { recursive: true });
+            mkdirSync4(dirname4(metroLogPath(process.cwd())), { recursive: true });
             metroLogStream = createWriteStream(metroLogPath(process.cwd()), { flags: "w" });
           }
           metroLogStream.write(line.replace(/^\[metro\] /, "") + "\n");
@@ -2787,7 +3020,7 @@ async function runDevInProcess(opts) {
   }
   console.error(
     chalk4.dim(
-      `Starting ${platformWithArticle(cfg.platform)} dev session for ${cfg.appId}${pinnedBuildId !== void 0 ? ` (build ${pinnedBuildId})` : ""}...`
+      `Starting ${platformWithArticle(cfg.platform)} ${standalone ? "standalone session (no Metro)" : "dev session"} for ${cfg.appId}${pinnedBuildId !== void 0 ? ` (build ${pinnedBuildId})` : ""}...`
     )
   );
   let stopping = false;
@@ -2820,6 +3053,7 @@ async function runDevInProcess(opts) {
         deviceCategory: cfg.deviceCategory,
         model: cfg.model,
         buildId: pinnedBuildId,
+        ...standalone ? { standalone } : {},
         metroPort: cfg.metroPort ?? 8081,
         // startDevSession's own browser-open happens before we've written the
         // state file / emitted session_ready — open it ourselves afterward
@@ -3725,7 +3959,7 @@ function agentExitCode(env) {
 }
 
 // src/commands/agent.ts
-import { writeFileSync as writeFileSync5 } from "fs";
+import { writeFileSync as writeFileSync6 } from "fs";
 var REF_RE = /^@?(e\d+)$/;
 var COORDS_RE = /^(-?\d+),\s*(-?\d+)$/;
 var FlagError = class extends Error {
@@ -3935,7 +4169,7 @@ async function runAgentVerb(cmd, positionals, opts) {
 `);
       process.exit(1);
     }
-    writeFileSync5(outPath, imageBytes);
+    writeFileSync6(outPath, imageBytes);
     if (opts.json) {
       console.log(JSON.stringify(envelope));
     } else {
@@ -3958,8 +4192,10 @@ export {
   DEV_PLATFORMS,
   PLATFORM_NEEDS_METRO,
   isDevPlatform,
+  platformLabel,
   platformWithArticle,
   loadDevConfig,
+  resolveMetro,
   parseBuildId,
   checkDevBuild,
   buildRows,
@@ -3970,6 +4206,8 @@ export {
   readMetroState,
   killOwnedMetro,
   checkMetro,
+  loadLocalDevConfig,
+  effectiveDevConfig,
   buildCommand,
   formatDuration,
   BUILD_TERMINAL_STATUSES,