claudeboard 2.16.0 → 3.1.1

package/agents/expo-health.js

@@ -1,727 +0,0 @@
-import { callClaudeJSON } from "./claude-api.js";
-import { runCommand } from "../tools/terminal.js";
-import { createTask, createEpic, addLog } from "./board-client.js";
-import chalk from "chalk";
-import fs from "fs";
-import path from "path";
-import crypto from "crypto";
-import { createRequire } from "module";
-import { createConnection } from "net";
-import { spawn as _spawn, execSync } from "child_process";
-
-const require = createRequire(import.meta.url);
-// On Windows, use shell:true to avoid spawn EINVAL with .cmd wrappers
-const isWin = process.platform === "win32";
-const NPX = "npx";
-const SPAWN_OPTS_BASE = isWin ? { shell: true } : {};
-const MAX_FIX_ATTEMPTS = 5;
-const BUILD_HASH_FILE = ".claudeboard-build-hash.txt";
-const BUILD_TIMEOUT_MS = 10 * 60 * 1000; // 10 min max for expo run:ios
-
-/**
- * Expo Health Check Agent — runs BEFORE the development loop.
- *
- * Strategy:
- * 1. Try npm install (--legacy-peer-deps, then --force if needed)
- * 2. If install fails with ETARGET/missing version → ask Claude for fix → apply → retry
- * 3. If iOS mode: ensure a dev build exists in the simulator (builds if needed)
- * 4. Start Expo, wait for Metro to be truly ready (not just port open)
- * 5. If Metro crashes with module/dep errors → ask Claude → apply → retry
- * 6. If still broken after MAX attempts → inject a BLOCKER task into the board
- *    so the developer agent fixes it before any other task runs
- *
- * Returns { ready: boolean, process: ChildProcess|null }
- */
-export async function runExpoHealthCheck(projectPath, port = 8081) {
-  console.log(chalk.bold.cyan("\n[ EXPO HEALTH CHECK ]\n"));
-
-  if (!fs.existsSync(path.join(projectPath, "package.json"))) {
-    console.log(chalk.dim("  No package.json — skipping"));
-    return { ready: false, process: null };
-  }
-
-  // ── 1. Install ─────────────────────────────────────────────────────────────
-  const installOk = await installDeps(projectPath);
-  if (!installOk) {
-    await injectFixTask(projectPath, "npm install fails — cannot start Expo",
-      "npm install fails with ETARGET or unresolvable version conflicts. " +
-      "Audit package.json, fix all version constraints to be compatible with " +
-      "the installed Expo SDK, then run npm install --legacy-peer-deps."
-    );
-    console.log(chalk.yellow("  ✗ Install failed — injected fix task into board\n"));
-    return { ready: false, process: null };
-  }
-
-  // ── 2. Dev build (iOS mode only) ───────────────────────────────────────────
-  const useIOS = process.env.CLAUDEBOARD_IOS === "1" || isSimulatorAvailableSync();
-  if (useIOS) {
-    const buildOk = await ensureDevBuild(projectPath);
-    if (!buildOk) {
-      await injectFixTask(projectPath,
-        "FIX: Dev build failed — fix native compilation errors",
-        "npx expo run:ios failed. Fix any native dependency or Podfile issues so the app compiles.\n" +
-        "Run: npx expo run:ios --simulator and fix all errors."
-      );
-      console.log(chalk.yellow("  ✗ Dev build failed — injected fix task into board\n"));
-      return { ready: false, process: null };
-    }
-  }
-
-  // ── 3. Start Expo + verify Metro is error-free ─────────────────────────────
-  for (let attempt = 1; attempt <= MAX_FIX_ATTEMPTS; attempt++) {
-    console.log(chalk.dim(`  Starting Expo (attempt ${attempt}/${MAX_FIX_ATTEMPTS})...`));
-
-    const result = await tryStartExpo(projectPath, port);
-
-    if (result.ready) {
-      console.log(chalk.green(`  ✓ Expo running cleanly on port ${port}\n`));
-      return { ready: true, process: result.process };
-    }
-
-    const error = result.error;
-    console.log(chalk.yellow(`  ✗ Expo error: ${error?.split("\n")[0]?.slice(0, 120)}`));
-
-    if (attempt === MAX_FIX_ATTEMPTS) break;
-
-    // Ask Claude for a fix and apply it
-    const fixed = await applyExpoFix(projectPath, error);
-    if (!fixed) break;
-    console.log(chalk.dim("  Fix applied — retrying..."));
-  }
-
-  // All attempts failed — inject task so developer agent fixes it
-  const lastError = await getLastExpoError(projectPath);
-  await injectFixTask(projectPath,
-    "FIX: Expo fails to start — resolve dependency errors",
-    `Expo cannot start due to dependency errors. Fix ALL issues so the app boots without errors.\n\n` +
-    `Last error:\n${lastError}\n\n` +
-    `Steps:\n` +
-    `1. Read package.json and identify incompatible versions\n` +
-    `2. Fix react-native-worklets, react-native-reanimated and any other conflicting packages\n` +
-    `3. Run: npm install --legacy-peer-deps\n` +
-    `4. Verify with: npx expo start --web --port ${port} (should not crash)\n` +
-    `5. If imports fail (Unable to resolve module), remove or replace the problematic import`
-  );
-
-  console.log(chalk.yellow("  ✗ Expo broken — injected fix task (will be worked on first)\n"));
-  return { ready: false, process: null };
-}
-
-// ── Dev Build management ───────────────────────────────────────────────────
-
-/**
- * Compute a short hash of package.json to detect dependency changes.
- */
-export function packageJsonHash(projectPath) {
-  try {
-    const content = fs.readFileSync(path.join(projectPath, "package.json"), "utf8");
-    return crypto.createHash("md5").update(content).digest("hex").slice(0, 12);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Returns true if a rebuild is needed:
- * - No saved hash (never built), OR
- * - package.json changed since last build
- */
-export function needsRebuild(projectPath) {
-  const hashFile = path.join(projectPath, BUILD_HASH_FILE);
-  if (!fs.existsSync(hashFile)) return true;
-  try {
-    const saved = fs.readFileSync(hashFile, "utf8").trim();
-    return saved !== packageJsonHash(projectPath);
-  } catch {
-    return true;
-  }
-}
-
-/**
- * Persist the current package.json hash after a successful build.
- */
-function saveBuildHash(projectPath) {
-  try {
-    const hash = packageJsonHash(projectPath);
-    if (hash) fs.writeFileSync(path.join(projectPath, BUILD_HASH_FILE), hash, "utf8");
-  } catch {}
-}
-
-/**
- * Check if the app's dev build is already installed in the booted simulator.
- */
-function isDevBuildInstalled(projectPath) {
-  try {
-    const bundleId = getBundleId(projectPath);
-    if (!bundleId) return false;
-    const output = execSync(`xcrun simctl get_app_container booted "${bundleId}" 2>&1`, { encoding: "utf8" });
-    return output.trim().length > 0 && !output.includes("No such file");
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Read the iOS bundle identifier from app.json / app.config.js.
- * Falls back to deriving it from the project slug.
- */
-function getBundleId(projectPath) {
-  try {
-    const appJsonPath = path.join(projectPath, "app.json");
-    if (fs.existsSync(appJsonPath)) {
-      const cfg = JSON.parse(fs.readFileSync(appJsonPath, "utf8"));
-      const bundleId = cfg?.expo?.ios?.bundleIdentifier;
-      if (bundleId) return bundleId;
-      // Derive from slug if no explicit bundleIdentifier
-      const slug = cfg?.expo?.slug;
-      if (slug) return `com.anonymous.${slug.replace(/[^a-zA-Z0-9]/g, "")}`;
-    }
-  } catch {}
-  return null;
-}
-
-/**
- * Boot the first available iOS simulator if none is booted.
- */
-function ensureSimulatorBooted() {
-  try {
-    const booted = execSync("xcrun simctl list devices booted 2>&1", { encoding: "utf8" });
-    if (booted.includes("Booted")) return true;
-
-    // Find a suitable device to boot
-    const devices = execSync("xcrun simctl list devices available 2>&1", { encoding: "utf8" });
-    const match = devices.match(/iPhone \d[^(]*\(([A-F0-9-]{36})\)/i);
-    if (!match) return false;
-
-    console.log(chalk.dim(`  Booting simulator ${match[1]}...`));
-    execSync(`xcrun simctl boot "${match[1]}" 2>&1`, { encoding: "utf8" });
-    // Give the simulator a moment to fully boot
-    execSync("sleep 5");
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Build and install the dev build in the simulator using `expo run:ios`.
- * Only rebuilds when package.json changed or the app is not installed.
- * Returns true on success, false on failure.
- */
-export async function ensureDevBuild(projectPath) {
-  const installed = isDevBuildInstalled(projectPath);
-  const rebuild = needsRebuild(projectPath);
-
-  if (installed && !rebuild) {
-    console.log(chalk.dim("  ✓ Dev build up to date — skipping rebuild"));
-    return true;
-  }
-
-  const reason = !installed ? "app not installed" : "dependencies changed";
-  console.log(chalk.cyan(`  Building dev build (${reason})...`));
-  console.log(chalk.dim("  This may take several minutes on first run."));
-
-  // Make sure a simulator is running
-  const simReady = ensureSimulatorBooted();
-  if (!simReady) {
-    console.log(chalk.yellow("  ✗ No iOS simulator available"));
-    return false;
-  }
-
-  return new Promise((resolve) => {
-    let output = "";
-    let resolved = false;
-
-    const done = (ok) => {
-      if (resolved) return;
-      resolved = true;
-      if (ok) {
-        saveBuildHash(projectPath);
-        console.log(chalk.green("  ✓ Dev build installed in simulator"));
-      }
-      resolve(ok);
-    };
-
-    const timeout = setTimeout(() => {
-      console.log(chalk.yellow("  ✗ Dev build timed out after 10 minutes"));
-      done(false);
-    }, BUILD_TIMEOUT_MS);
-
-    try {
-      const proc = _spawn(NPX, ["expo", "run:ios", "--simulator"], {
-        ...SPAWN_OPTS_BASE,
-        cwd: projectPath,
-        env: { ...process.env, CI: "1", EXPO_NO_INTERACTIVE: "1" },
-        stdio: "pipe",
-      });
-
-      const onData = (d) => {
-        const text = d.toString();
-        output += text;
-        // Log progress lines that are meaningful
-        const lines = text.split("\n").filter(l => l.trim() && !l.includes("\u001b["));
-        for (const line of lines) {
-          if (
-            line.includes("Installing") ||
-            line.includes("Building") ||
-            line.includes("Compiling") ||
-            line.includes("Linking") ||
-            line.includes("error:") ||
-            line.includes("warning:")
-          ) {
-            console.log(chalk.dim(`    ${line.trim().slice(0, 100)}`));
-          }
-        }
-
-        if (
-          text.includes("Installed on") ||
-          text.includes("Opening on") ||
-          text.includes("Successfully built") ||
-          text.includes("BUILD SUCCEEDED")
-        ) {
-          clearTimeout(timeout);
-          done(true);
-        }
-
-        if (
-          text.includes("BUILD FAILED") ||
-          text.includes("error: ") ||
-          text.includes("Command failed")
-        ) {
-          // Wait a bit to collect full error output
-          setTimeout(() => {
-            clearTimeout(timeout);
-            saveLastError(projectPath, output.slice(-3000));
-            done(false);
-          }, 2000);
-        }
-      };
-
-      proc.stdout.on("data", onData);
-      proc.stderr.on("data", onData);
-
-      proc.on("close", (code) => {
-        clearTimeout(timeout);
-        if (!resolved) {
-          if (code === 0) {
-            done(true);
-          } else {
-            saveLastError(projectPath, output.slice(-3000));
-            done(false);
-          }
-        }
-      });
-
-    } catch (e) {
-      clearTimeout(timeout);
-      done(false);
-    }
-  });
-}
-
-// ── npm install with progressive fallback ─────────────────────────────────
-async function installDeps(projectPath) {
-  const pkg = JSON.parse(fs.readFileSync(path.join(projectPath, "package.json"), "utf8"));
-  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-
-  // Step 1: legacy-peer-deps
-  console.log(chalk.dim("  npm install --legacy-peer-deps..."));
-  let result = await runCommand("npm install --legacy-peer-deps 2>&1", projectPath, 180000);
-  if (!hasFatalNpmError(result.stdout)) {
-    console.log(chalk.dim("  ✓ Dependencies installed"));
-    return true;
-  }
-
-  const error1 = result.stdout;
-  console.log(chalk.yellow(`  ⚠ Install error: ${getFatalError(error1)}`));
-
-  // Step 2: ask Claude to fix version conflicts
-  console.log(chalk.dim("  Asking Claude to resolve version conflicts..."));
-  const fix = await askClaudeForInstallFix(deps, error1);
-  if (fix?.commands?.length) {
-    console.log(chalk.dim(`  Diagnosis: ${fix.diagnosis}`));
-    for (const cmd of fix.commands) {
-      console.log(chalk.dim(`  → ${cmd}`));
-      await runCommand(cmd + " 2>&1", projectPath, 180000);
-    }
-    // Retry install
-    result = await runCommand("npm install --legacy-peer-deps 2>&1", projectPath, 180000);
-    if (!hasFatalNpmError(result.stdout)) {
-      console.log(chalk.dim("  ✓ Dependencies installed after fix"));
-      return true;
-    }
-  }
-
-  // Step 3: --force (last resort)
-  console.log(chalk.dim("  Retrying with --force..."));
-  result = await runCommand("npm install --force 2>&1", projectPath, 180000);
-  if (!hasFatalNpmError(result.stdout)) {
-    console.log(chalk.dim("  ✓ Dependencies installed (--force)"));
-    return true;
-  }
-
-  return false;
-}
-
-// ── Start Expo and wait until Metro is TRULY ready (no errors) ─────────────
-// We wait up to 60s. Success = "Metro waiting on" AND no error lines.
-// Failure = any "Unable to resolve module", "Cannot find module", etc.
-async function tryStartExpo(projectPath, port) {
-  return new Promise((resolve) => {
-    let output = "";
-    let resolved = false;
-    let proc = null;
-
-    const done = (ready, error) => {
-      if (resolved) return;
-      resolved = true;
-      if (!ready && proc) { try { proc.kill(); } catch {} proc = null; }
-      // Save error for later
-      if (!ready && error) saveLastError(projectPath, error);
-      resolve({ ready, process: proc, error });
-    };
-
-    const timeout = setTimeout(() =>
-      done(false, `Expo did not become ready within 60s.\n${output.slice(-800)}`), 60000);
-
-    try {
-      // iOS mode: use dev build (--go is intentionally omitted so the installed dev build opens)
-      const useIOS = process.env.CLAUDEBOARD_IOS === "1" || isSimulatorAvailableSync();
-      const expoArgs = useIOS
-        ? ["expo", "start", "--ios", "--port", String(port)]
-        : ["expo", "start", "--web", "--port", String(port)];
-      
-      proc = _spawn(NPX, expoArgs, {
-        ...SPAWN_OPTS_BASE,
-        cwd: projectPath,
-        env: (() => { const e = { ...process.env, CI: "1", EXPO_NO_INTERACTIVE: "1", EXPO_NO_DOTENV: "0" }; delete e.ANTHROPIC_API_KEY; return e; })(),
-        stdio: "pipe",
-      });
-
-      const checkError = (text) => {
-        if (
-          text.includes("Unable to resolve module") ||
-          text.includes("Cannot find module") ||
-          text.includes("Error: Unable") ||
-          text.includes("Module not found") ||
-          text.includes("SyntaxError") ||
-          text.includes("ENOENT: no such file")
-        ) {
-          clearTimeout(timeout);
-          setTimeout(() => done(false, output.slice(-2000)), 1500); // collect full error
-        }
-      };
-
-      proc.stdout.on("data", (d) => {
-        const text = d.toString();
-        output += text;
-        // Metro ready signal — but wait 3s to make sure no errors follow
-        if (
-          text.includes("Metro waiting on") ||
-          text.includes(`http://localhost:${port}`) ||
-          text.includes("Bundling complete") ||
-          text.includes("Web is waiting on") ||
-          text.includes("Opening on iOS") ||
-          text.includes("Installed on iOS") ||
-          text.includes("Building JavaScript bundle")
-        ) {
-          setTimeout(() => {
-            // If we haven't already failed, declare success
-            if (!resolved) { clearTimeout(timeout); done(true, null); }
-          }, 3000);
-        }
-        checkError(text);
-      });
-
-      proc.stderr.on("data", (d) => {
-        const text = d.toString();
-        output += text;
-        checkError(text);
-      });
-
-      proc.on("close", (code) => {
-        clearTimeout(timeout);
-        if (!resolved) done(false, `Expo exited (code ${code})\n${output.slice(-1000)}`);
-      });
-
-    } catch (e) {
-      clearTimeout(timeout);
-      done(false, e.message);
-    }
-  });
-}
-
-// ── Ask Claude how to fix a runtime Expo error ────────────────────────────
-async function applyExpoFix(projectPath, errorText) {
-  const pkg = JSON.parse(fs.readFileSync(path.join(projectPath, "package.json"), "utf8"));
-  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-
-  let verdict;
-  try {
-    verdict = await callClaudeJSON(
-      "You are a React Native / Expo dependency expert. Respond only with valid JSON.",
-      `Expo failed to start with this error:
-\`\`\`
-${errorText}
-\`\`\`
-
-Current dependencies:
-${JSON.stringify(deps, null, 2)}
-
-Provide the exact commands to fix this. 
-For "Unable to resolve module X from file Y": the fix is usually to install the missing package or fix its version.
-For react-native-worklets version conflict: install react-native-worklets@latest.
-
-Respond with JSON:
-{
-  "diagnosis": "one sentence",
-  "commands": ["npm install ...", "..."],
-  "confidence": 0-100
-}`
-    );
-  } catch { return false; }
-
-  if (!verdict?.commands?.length || verdict.confidence < 30) return false;
-
-  console.log(chalk.dim(`  Diagnosis: ${verdict.diagnosis}`));
-  for (const cmd of verdict.commands) {
-    console.log(chalk.dim(`  → ${cmd}`));
-    await runCommand(cmd + " 2>&1", projectPath, 120000);
-  }
-  return true;
-}
-
-// ── Ask Claude how to fix npm install failures ────────────────────────────
-async function askClaudeForInstallFix(deps, errorText) {
-  try {
-    return await callClaudeJSON(
-      "You are a React Native dependency expert. Respond only with valid JSON.",
-      `npm install failed:
-${errorText}
-
-Dependencies: ${JSON.stringify(deps, null, 2)}
-
-Provide exact commands to resolve the version conflict.
-For ETARGET (version not found): suggest the nearest valid version.
-For peer dep conflicts: suggest compatible versions for all conflicting packages.
-
-JSON: { "diagnosis": "...", "commands": ["..."], "confidence": 0-100 }`
-    );
-  } catch { return null; }
-}
-
-// ── Create a high-priority fix task in the board ──────────────────────────
-async function injectFixTask(projectPath, title, description) {
-  try {
-    // Make sure the epic exists
-    const epicId = await createEpic("⚠ Expo Fix Required", "expo-fix");
-    await createTask({
-      epicId,
-      title,
-      description,
-      priority: "high",
-      priorityOrder: 0, // Run FIRST
-      type: "bug",
-      status: "todo",
-    });
-    console.log(chalk.yellow(`  ➕ Injected task: "${title}"`));
-  } catch (e) {
-    console.log(chalk.dim(`  Could not inject task: ${e.message}`));
-  }
-}
-
-// ── Save/read last error to disk for later reference ─────────────────────
-function saveLastError(projectPath, error) {
-  try {
-    fs.writeFileSync(path.join(projectPath, ".claudeboard-expo-error.txt"), error, "utf8");
-  } catch {}
-}
-
-async function getLastExpoError(projectPath) {
-  try {
-    const f = path.join(projectPath, ".claudeboard-expo-error.txt");
-    return fs.existsSync(f) ? fs.readFileSync(f, "utf8").slice(-1500) : "Unknown error";
-  } catch { return "Unknown error"; }
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────
-function hasFatalNpmError(output) {
-  return output.includes("npm error code ETARGET") ||
-    output.includes("notarget No matching version") ||
-    (output.includes("npm error") && output.includes("ERESOLVE") && output.includes("unable to resolve"));
-}
-
-function getFatalError(output) {
-  return output.split("\n").find(l => l.includes("npm error") && !l.includes("peer")) || output.slice(-200);
-}
-
-// ── iOS Simulator detection ───────────────────────────────────────────────────
-function isSimulatorAvailableSync() {
-  try {
-    const output = execSync("xcrun simctl list devices booted 2>&1", { encoding: "utf8" });
-    if (output.includes("Booted")) return true;
-    const runtimes = execSync("xcrun simctl list runtimes 2>&1", { encoding: "utf8" });
-    return runtimes.includes("iOS") && !runtimes.includes("unavailable");
-  } catch {
-    return false;
-  }
-}
-
-// Take a screenshot of the iOS simulator
-export async function screenshotSimulator(outputPath) {
-  try {
-    execSync(`xcrun simctl io booted screenshot "${outputPath}"`, { stdio: "pipe" });
-    const data = fs.readFileSync(outputPath);
-    return { success: true, base64: data.toString("base64"), path: outputPath };
-  } catch (e) {
-    return { success: false, error: e.message };
-  }
-}
-
-// Tap on the iOS simulator at given coordinates
-export async function tapSimulator(x, y) {
-  try {
-    execSync(`xcrun simctl io booted tap ${x} ${y}`, { stdio: "pipe" });
-    return true;
-  } catch { return false; }
-}
-
-// ── Vite Health Check (web apps) ─────────────────────────────────────────────
-
-/**
- * Ensure Vite is installed in the project, then start the dev server.
- * Returns { ready: boolean, process: ChildProcess|null }
- */
-export async function runViteHealthCheck(projectPath, port = 5173) {
-  console.log(chalk.bold.cyan("\n[ VITE HEALTH CHECK ]\n"));
-
-  if (!fs.existsSync(path.join(projectPath, "package.json"))) {
-    console.log(chalk.dim("  No package.json — skipping"));
-    return { ready: false, process: null };
-  }
-
-  // Install deps
-  const installOk = await installDeps(projectPath);
-  if (!installOk) {
-    await injectFixTask(projectPath, "npm install fails — cannot start Vite",
-      "npm install fails with version conflicts. Fix all version constraints in package.json, then run npm install --legacy-peer-deps."
-    );
-    console.log(chalk.yellow("  ✗ Install failed — injected fix task into board\n"));
-    return { ready: false, process: null };
-  }
-
-  // Ensure vite is available
-  const pkgRaw = fs.readFileSync(path.join(projectPath, "package.json"), "utf8");
-  const pkg = JSON.parse(pkgRaw);
-  const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-  if (!allDeps["vite"]) {
-    console.log(chalk.dim("  Vite not found — installing vite + @vitejs/plugin-react..."));
-    await runCommand("npm install --save-dev vite @vitejs/plugin-react 2>&1", projectPath, 120000);
-  }
-
-  // Start Vite dev server
-  for (let attempt = 1; attempt <= MAX_FIX_ATTEMPTS; attempt++) {
-    console.log(chalk.dim(`  Starting Vite (attempt ${attempt}/${MAX_FIX_ATTEMPTS})...`));
-    const result = await tryStartVite(projectPath, port);
-
-    if (result.ready) {
-      console.log(chalk.green(`  ✓ Vite running on http://localhost:${port}\n`));
-      return { ready: true, process: result.process };
-    }
-
-    const error = result.error;
-    console.log(chalk.yellow(`  ✗ Vite error: ${error?.split("\n")[0]?.slice(0, 120)}`));
-
-    if (attempt === MAX_FIX_ATTEMPTS) break;
-
-    const fixed = await applyExpoFix(projectPath, error);
-    if (!fixed) break;
-    console.log(chalk.dim("  Fix applied — retrying..."));
-  }
-
-  const lastError = await getLastExpoError(projectPath);
-  await injectFixTask(projectPath,
-    "FIX: Vite fails to start — resolve dependency errors",
-    `Vite dev server cannot start. Fix all issues so the app boots without errors.\n\nLast error:\n${lastError}\n\nSteps:\n1. Read package.json and identify incompatible versions\n2. Run: npm install --legacy-peer-deps\n3. Verify with: npx vite --port ${port}`
-  );
-
-  console.log(chalk.yellow("  ✗ Vite broken — injected fix task\n"));
-  return { ready: false, process: null };
-}
-
-async function tryStartVite(projectPath, port) {
-  return new Promise((resolve) => {
-    let output = "";
-    let resolved = false;
-    let proc = null;
-
-    const done = (ready, error) => {
-      if (resolved) return;
-      resolved = true;
-      if (!ready && proc) { try { proc.kill(); } catch {} proc = null; }
-      if (!ready && error) saveLastError(projectPath, error);
-      resolve({ ready, process: proc, error });
-    };
-
-    const timeout = setTimeout(() =>
-      done(false, `Vite did not become ready within 60s.\n${output.slice(-800)}`), 60000);
-
-    try {
-      proc = _spawn(NPX, ["vite", "--port", String(port), "--host", "localhost"], {
-        ...SPAWN_OPTS_BASE,
-        cwd: projectPath,
-        env: (() => { const e = { ...process.env }; delete e.ANTHROPIC_API_KEY; return e; })(),
-        stdio: "pipe",
-      });
-
-      const checkError = (text) => {
-        if (
-          text.includes("Cannot find module") ||
-          text.includes("error during build") ||
-          text.includes("Failed to resolve")
-        ) {
-          clearTimeout(timeout);
-          setTimeout(() => done(false, output.slice(-2000)), 1500);
-        }
-      };
-
-      proc.stdout.on("data", (d) => {
-        const text = d.toString();
-        output += text;
-        if (
-          text.includes("Local:") ||
-          text.includes(`localhost:${port}`) ||
-          text.includes("ready in")
-        ) {
-          setTimeout(() => {
-            if (!resolved) { clearTimeout(timeout); done(true, null); }
-          }, 2000);
-        }
-        checkError(text);
-      });
-
-      proc.stderr.on("data", (d) => {
-        const text = d.toString();
-        output += text;
-        checkError(text);
-      });
-
-      proc.on("close", (code) => {
-        clearTimeout(timeout);
-        if (!resolved) done(false, `Vite exited (code ${code})\n${output.slice(-1000)}`);
-      });
-
-    } catch (e) {
-      clearTimeout(timeout);
-      done(false, e.message);
-    }
-  });
-}
-
-// ── Generic app health check — delegates to Expo or Vite ─────────────────────
-export async function runAppHealthCheck(projectPath, port, appType = "mobile") {
-  if (appType === "web") {
-    return runViteHealthCheck(projectPath, port || 5173);
-  }
-  return runExpoHealthCheck(projectPath, port || 8081);
-}