claudeboard 2.16.0 → 3.1.1

package/agents/orchestrator.js

@@ -1,306 +0,0 @@
-import chalk from "chalk";
-import ora from "ora";
-import fs from "fs";
-import path from "path";
-import { runArchitectAgent } from "./architect.js";
-import { runDeveloperAgent } from "./developer.js";
-import { runQAAgent, runFullAppQA } from "./qa.js";
-import { runAppHealthCheck, ensureDevBuild, packageJsonHash } from "./expo-health.js";
-import { createConnection } from "net";
-
-function isPortOpen(port) {
-  return new Promise(resolve => {
-    const sock = createConnection({ port, host: "127.0.0.1" });
-    sock.setTimeout(600);
-    sock.once("connect", () => { sock.destroy(); resolve(true); });
-    sock.once("error", () => resolve(false));
-    sock.once("timeout", () => resolve(false));
-  });
-}
-import {
-  initBoard,
-  getNextTask,
-  getAllTasks,
-  getStats,
-  addLog,
-  createTask,
-  createEpic,
-  hasTasks,
-  resetStuckTasks,
-} from "./board-client.js";
-import { initSupabaseReader } from "../tools/supabase-reader.js";
-import { runCommand, startProcess, waitForPort } from "../tools/terminal.js";
-
-const PHASES = {
-  ARCHITECTURE: "architecture",
-  DEVELOPMENT: "development",
-  QA_FINAL: "qa_final",
-  COMPLETE: "complete",
-};
-
-export async function runOrchestrator(config) {
-  const {
-    prdPath,
-    projectPath,
-    supabaseUrl,
-    supabaseKey,
-    projectName,
-    appType = "mobile",
-    expoPort = 8081,
-    skipArchitect = false,
-    useIOS = false,
-  } = config;
-
-  // Set env var so expo-health and QA agents know to use iOS simulator
-  if (useIOS) process.env.CLAUDEBOARD_IOS = "1";
-
-  console.log(chalk.cyan("\n╔═══════════════════════════════════════╗"));
-  console.log(chalk.cyan("║") + chalk.bold("  🤖 CLAUDEBOARD ORCHESTRATOR STARTING ") + chalk.cyan("║"));
-  console.log(chalk.cyan("╚═══════════════════════════════════════╝\n"));
-
-  // Init board connection
-  initBoard(supabaseUrl, supabaseKey, projectName);
-  initSupabaseReader(supabaseUrl, supabaseKey);
-
-  // Read PRD
-  const prdContent = fs.readFileSync(prdPath, "utf8");
-  console.log(chalk.dim(`  PRD: ${prdPath} (${prdContent.length} chars)`));
-  console.log(chalk.dim(`  Project: ${projectPath}\n`));
-
-  let techStack = {};
-  let isResume = false;
-
-  // ── DETECT: RESUME or FRESH START ─────────────────────────────────────────
-  const existingTasks = await hasTasks();
-
-  if (existingTasks && !config.forceRestart) {
-    isResume = true;
-    const stuck = await resetStuckTasks();
-    const stats = await getStats();
-
-    console.log(chalk.yellow("  ↩️  Resuming existing session\n"));
-    console.log(chalk.dim(`  Found ${stats.total} tasks — ${stats.done} done, ${stats.todo} todo, ${stats.error} failed`));
-    if (stuck > 0) {
-      console.log(chalk.dim(`  Reset ${stuck} stuck task(s) back to todo`));
-    }
-    console.log();
-  } else {
-    // ── PHASE 1: ARCHITECTURE ────────────────────────────────────────────────
-    if (config.forceRestart) {
-      console.log(chalk.dim("  Force restart — skipping existing tasks (they remain in board)\n"));
-    }
-    console.log(chalk.bold.cyan("[ PHASE 1: ARCHITECTURE ]\n"));
-
-    // ── Detect existing project files (besides the PRD) ───────────────────────
-    let buildOnExisting = false;
-    const EXISTING_CODE_MARKERS = ["package.json", "app.json", "src", "app", "components", "screens"];
-    try {
-      const prdBasename = path.basename(prdPath);
-      const projectFiles = fs.readdirSync(projectPath)
-        .filter(f => !f.startsWith(".") && f !== prdBasename && f !== "node_modules");
-      const hasExistingCode = projectFiles.some(f => EXISTING_CODE_MARKERS.includes(f));
-
-      if (hasExistingCode && !config.forceRestart) {
-        console.log(chalk.yellow("  ⚠  This project already has files:\n"));
-        projectFiles.slice(0, 12).forEach(f => console.log(chalk.dim(`     ${f}`)));
-        if (projectFiles.length > 12) console.log(chalk.dim(`     ... and ${projectFiles.length - 12} more`));
-        console.log();
-
-        const { default: Enquirer } = await import("enquirer");
-        const enquirer = new Enquirer();
-        const answer = await enquirer.prompt({
-          type: "confirm",
-          name: "buildOnExisting",
-          message: "Build tasks on top of the existing project (instead of starting from scratch)?",
-          initial: true,
-        });
-        buildOnExisting = answer.buildOnExisting;
-        console.log();
-      }
-    } catch {}
-
-    const archResult = await runArchitectAgent(prdContent, projectName, {
-      buildOnExisting,
-      projectPath,
-      appType,
-    });
-    techStack = archResult.techStack;
-    console.log(chalk.green(`\n  ✓ ${archResult.totalTasks} tasks created across ${archResult.epics.length} epics\n`));
-  }
-
-  // ── START EXPO ─────────────────────────────────────────────────────────────
-  let expoProcess = null;
-  let expoReady = false;
-  const logFile = path.join(projectPath, ".claudeboard-logs.txt");
-  const logStream = fs.createWriteStream(logFile, { flags: "a" });
-
-  // ── APP HEALTH CHECK: install deps + start dev server + auto-fix errors ───
-  // Runs before development loop so the app is visible from task #1
-  const devPort = appType === "web" ? (expoPort !== 8081 ? expoPort : 5173) : expoPort;
-  const expoHealth = await runAppHealthCheck(projectPath, devPort, appType);
-  expoReady = expoHealth.ready;
-  expoProcess = expoHealth.process;
-
-  // ── PHASE 2: DEVELOPMENT LOOP ─────────────────────────────────────────────
-  console.log(chalk.bold.cyan("[ PHASE 2: DEVELOPMENT ]\n"));
-
-  let consecutiveFailures = 0;
-  const MAX_CONSECUTIVE_FAILURES = 3;
-
-  // Track package.json hash to detect native dependency changes that need a rebuild
-  let lastPkgHash = packageJsonHash(projectPath);
-
-  while (true) {
-    const task = await getNextTask();
-
-    if (!task) {
-      console.log(chalk.green("\n  ✓ All tasks complete!\n"));
-      break;
-    }
-
-    const stats = await getStats();
-    const pct = stats.pct;
-    const bar = "█".repeat(Math.floor(pct / 5)) + "░".repeat(20 - Math.floor(pct / 5));
-    console.log(chalk.dim(`\n  [${bar}] ${pct}% — ${stats.done}/${stats.total} tasks done`));
-    console.log(chalk.bold(`\n  → ${task.title}`));
-    console.log(chalk.dim(`    Epic: ${task.cb_epics?.name || "—"} | ${task.priority} | ${task.type}`));
-
-    // Fetch all tasks for mini-plan context (done + upcoming)
-    const allTasks = await getAllTasks();
-
-    // Run developer agent
-    const devResult = await runDeveloperAgent(task, projectPath, techStack, allTasks);
-
-    if (!devResult.success) {
-      consecutiveFailures++;
-      console.log(chalk.red(`  ✗ Dev failed (${consecutiveFailures} consecutive)`));
-
-      if (consecutiveFailures >= MAX_CONSECUTIVE_FAILURES) {
-        console.log(chalk.yellow("\n  ⚠️  Too many consecutive failures — pausing for human review"));
-        console.log(chalk.yellow("  Check the dashboard for blocked tasks.\n"));
-        break;
-      }
-      continue;
-    }
-
-    consecutiveFailures = 0;
-
-    // ── If this was an Expo fix task, clear the error and re-health-check ────
-    if ((task.title?.toLowerCase().includes("expo") || task.title?.toLowerCase().includes("vite")) && task.type === "bug") {
-      try { fs.unlinkSync(path.join(projectPath, ".claudeboard-expo-error.txt")); } catch {}
-      console.log(chalk.dim("  Dev server fix completed — re-running health check..."));
-      const recheck = await runAppHealthCheck(projectPath, devPort, appType);
-      expoReady = recheck.ready;
-      expoProcess = recheck.process;
-    }
-
-    // ── Detect native dependency changes → rebuild dev build if needed ────────
-    if (useIOS) {
-      const currentHash = packageJsonHash(projectPath);
-      if (currentHash && currentHash !== lastPkgHash) {
-        lastPkgHash = currentHash;
-        console.log(chalk.cyan("  📦 package.json changed — checking if dev build rebuild is needed..."));
-        if (expoProcess) {
-          try { expoProcess.kill(); } catch {}
-          expoProcess = null;
-          expoReady = false;
-        }
-        const buildOk = await ensureDevBuild(projectPath);
-        if (buildOk) {
-          // Restart Metro after rebuild
-          const recheck = await runExpoHealthCheck(projectPath, expoPort);
-          expoReady = recheck.ready;
-          expoProcess = recheck.process;
-        } else {
-          console.log(chalk.yellow("  ✗ Rebuild failed — continuing without live preview"));
-        }
-      }
-    }
-
-    // ── Re-check Expo health if it's supposed to be running but isn't ────────
-    if (expoReady) {
-      const portOpen = await isPortOpen(devPort);
-      if (!portOpen) {
-        console.log(chalk.yellow("  ⚠ Dev server seems to have crashed — running health check..."));
-        const recheck = await runAppHealthCheck(projectPath, devPort, appType);
-        expoReady = recheck.ready;
-        expoProcess = recheck.process;
-      }
-    }
-
-    // Run QA agent (only if expo is running and this is a UI/feature task)
-    const shouldRunQA = expoReady && ["feature", "bug"].includes(task.type);
-
-    if (shouldRunQA) {
-      // Give dev server a moment to hot-reload
-      await new Promise((r) => setTimeout(r, 3000));
-
-      const qaResult = await runQAAgent(task, devResult, projectPath, prdContent, devPort);
-
-      if (!qaResult.passed && qaResult.fixInstructions) {
-        console.log(chalk.yellow("  ↩️  QA failed — sending back to developer..."));
-
-        // Create a fix task right after current
-        await createEpicIfNeeded();
-        const fixedByDev = await runDeveloperAgent(
-          { ...task, title: `FIX: ${task.title}`, description: qaResult.fixInstructions },
-          projectPath,
-          techStack,
-          allTasks,
-          qaResult.fixInstructions
-        );
-
-        if (fixedByDev.success) {
-          await new Promise((r) => setTimeout(r, 3000));
-          await runQAAgent(task, fixedByDev, projectPath, prdContent, devPort);
-        }
-      }
-    }
-
-    // Small delay between tasks
-    await new Promise((r) => setTimeout(r, 500));
-  }
-
-  // ── PHASE 3: FINAL QA ─────────────────────────────────────────────────────
-  if (expoReady) {
-    console.log(chalk.bold.cyan("\n[ PHASE 3: FINAL QA ]\n"));
-    const fullQAReport = await runFullAppQA(projectPath, prdContent, devPort);
-
-    if (fullQAReport.issues.length > 0) {
-      console.log(chalk.yellow(`  ⚠️  Final QA found ${fullQAReport.issues.length} issues:`));
-      fullQAReport.issues.forEach((issue) => {
-        console.log(chalk.dim(`    ${issue.route}: ${issue.note}`));
-      });
-
-      // Create fix tasks for final issues
-      for (const issue of fullQAReport.issues) {
-        await createTask({
-          title: `Final QA fix: ${issue.route}`,
-          description: issue.note,
-          priority: "high",
-          type: "bug",
-        });
-      }
-
-      console.log(chalk.yellow("\n  Fix tasks added to board. Run claudeboard run --skip-architect to continue.\n"));
-    } else {
-      console.log(chalk.green(`  ✓ Full QA passed — ${fullQAReport.screenshotsCaptures} screens checked\n`));
-    }
-  }
-
-  // ── COMPLETE ───────────────────────────────────────────────────────────────
-  const finalStats = await getStats();
-  console.log(chalk.cyan("\n╔═══════════════════════════════════════╗"));
-  console.log(chalk.cyan("║") + chalk.bold.green(`  ✓ COMPLETE — ${finalStats.done}/${finalStats.total} tasks done (${finalStats.pct}%) `) + chalk.cyan("║"));
-  console.log(chalk.cyan("╚═══════════════════════════════════════╝\n"));
-
-  if (expoProcess) {
-    expoProcess.kill();
-    logStream.end();
-  }
-}
-
-async function createEpicIfNeeded() {
-  // Dummy — fix tasks go into a "Fixes" epic
-  // In practice the board-client handles this
-}

package/agents/qa.js

@@ -1,336 +0,0 @@
-import { query } from "@anthropic-ai/claude-agent-sdk";
-import { addLog, completeTask, failTask } from "./board-client.js";
-import { runCommand } from "../tools/terminal.js";
-import { screenshotExpoWeb } from "../tools/screenshot.js";
-import { screenshotSimulator } from "./expo-health.js";
-import { callClaudeWithImage } from "./claude-api.js";
-import { listFiles, readFile } from "../tools/filesystem.js";
-import chalk from "chalk";
-import path from "path";
-import fs from "fs";
-import { createConnection } from "net";
-import { resolveClaudePath, buildEnv } from "./claude-resolver.js";
-
-const CLAUDE_PATH = resolveClaudePath();
-
-const QA_TOOLS = ["Read", "Glob", "Grep", "Bash"];
-
-// ── Main QA entry point ───────────────────────────────────────────────────────
-export async function runQAAgent(task, devResult, projectPath, prdContent, expoPort = 8081) {
-  console.log(`  🔍  QA checking: ${task.title}`);
-  await addLog(task.id, "QA starting", "progress");
-
-  // ── 1. Check for truncated files (cheap, no Claude needed) ────────────────
-  const truncated = await checkForTruncatedFiles(task, projectPath);
-  if (truncated.length > 0) {
-    const msg = `Incomplete files detected: ${truncated.join(", ")}`;
-    await addLog(task.id, msg, "error");
-    return {
-      passed: false,
-      issues: truncated,
-      fixInstructions: `These files are truncated/incomplete:\n${truncated.join("\n")}\n\nRe-implement them completely.`,
-    };
-  }
-
-  // ── 2. Check Metro health (if Expo is running) ────────────────────────────
-  const expoRunning = await isPortOpen(expoPort);
-  if (expoRunning) {
-    const metroErr = await getMetroError(projectPath);
-    if (metroErr) {
-      await addLog(task.id, `Metro error: ${metroErr.slice(0, 100)}`, "error");
-      return {
-        passed: false,
-        issues: [`Metro crash: ${metroErr.slice(0, 200)}`],
-        fixInstructions: `Metro is crashing:\n${metroErr}\n\nFix this so the app loads on device without errors.`,
-      };
-    }
-  }
-
-  // ── 3. Take screenshot — iOS simulator first, fallback to web ────────────
-  let screenshotBase64 = null;
-  let screenshotPath = null;
-  if (expoRunning) {
-    await addLog(task.id, "Taking screenshot...", "progress");
-    const screenshotDir = path.join(projectPath, ".claudeboard-screenshots");
-    if (!fs.existsSync(screenshotDir)) fs.mkdirSync(screenshotDir, { recursive: true });
-
-    // Try iOS simulator first (more accurate for native apps)
-    const simPath = path.join(screenshotDir, `sim_${task.id}_${Date.now()}.png`);
-    const simShot = await screenshotSimulator(simPath);
-    if (simShot.success) {
-      screenshotBase64 = simShot.base64;
-      screenshotPath = simShot.path;
-      await addLog(task.id, "📱 iOS simulator screenshot taken", "progress");
-    } else {
-      // Fallback to Expo Web screenshot
-      const shot = await screenshotExpoWeb(expoPort, screenshotDir);
-      if (shot.success && shot.base64) {
-        screenshotBase64 = shot.base64;
-        screenshotPath = shot.path;
-      }
-    }
-  }
-
-  // ── 4. Ask Claude Code to review the implementation ──────────────────────
-  const qaResult = await runClaudeCodeQA(task, projectPath, prdContent, expoRunning, screenshotBase64, screenshotPath);
-
-  if (qaResult.passed) {
-    await addLog(task.id, `✓ QA passed: ${qaResult.summary}`, "complete");
-    console.log(`  ✓ QA passed: ${task.title}`);
-  } else {
-    await addLog(task.id, `✗ QA failed: ${qaResult.summary}`, "error");
-    console.log(`  ✗ QA failed: ${task.title} — ${qaResult.issues?.slice(0, 2).join(", ")}`);
-  }
-
-  return qaResult;
-}
-
-// ── Claude Code QA review ─────────────────────────────────────────────────────
-async function runClaudeCodeQA(task, projectPath, prdContent, expoRunning, screenshotBase64, screenshotPath) {
-  const screenshotNote = screenshotBase64
-    ? `A screenshot of the app (from iOS Simulator or Expo Web) has been saved to: ${screenshotPath}\nRead it with the Read tool and evaluate the visual result — check layout, text, colors, spacing.`
-    : expoRunning
-      ? "Expo is running but screenshot failed — evaluate code only."
-      : "Expo is not running — evaluate code quality only (TypeScript, completeness, correctness).";
-
-  const prompt = `You are a senior QA engineer reviewing a React Native / Expo implementation.
-
-TASK THAT WAS IMPLEMENTED:
-Title: ${task.title}
-Description: ${task.description}
-
-${screenshotNote}
-
-YOUR JOB:
-1. Run: npx tsc --noEmit 2>&1 | head -50
-   - If TypeScript errors exist → FAIL with specific error details
-2. Find and read the files related to this task (use Glob + Read)
-   - Check for: incomplete implementations, missing imports, wrong logic
-3. ${screenshotBase64 ? "Read the screenshot file and check if the UI matches what was expected" : "Evaluate the code for correctness based on the description"}
-
-PASS criteria:
-- TypeScript is clean (no errors)
-- Files are complete (not truncated)  
-- Implementation matches the task description
-
-FAIL criteria:
-- TypeScript errors
-- Files clearly incomplete or truncated
-- Implementation completely missing or wrong
-
-When done, output EXACTLY one of these lines:
-QA_PASS: <one sentence summary of what was verified>
-QA_FAIL: <specific reason> | FIX: <exact instructions for the developer>`;
-
-  if (!CLAUDE_PATH) {
-    console.log("  ⚠ Claude Code not found — skipping QA");
-    return { passed: true, summary: "Skipped (Claude Code not found)", issues: [] };
-  }
-
-  try {
-    let output = "";
-    let passed = null;
-    let summary = "";
-    let fixInstructions = "";
-
-    for await (const message of query({
-      prompt,
-      options: {
-        cwd: projectPath,
-        tools: QA_TOOLS,
-        permissionMode: "bypassPermissions",
-        maxTurns: 20,
-        pathToClaudeCodeExecutable: CLAUDE_PATH,
-        env: buildEnv(),
-      },
-    })) {
-      if (message.type === "assistant") {
-        for (const block of message.message?.content || []) {
-          if (block.type === "text") {
-            const text = block.text;
-            output += text + "\n";
-
-            if (text.includes("QA_PASS:")) {
-              passed = true;
-              summary = text.split("QA_PASS:")[1]?.trim().split("\n")[0] || task.title;
-            } else if (text.includes("QA_FAIL:")) {
-              passed = false;
-              const parts = text.split("QA_FAIL:")[1]?.split("| FIX:") || [];
-              summary = parts[0]?.trim() || "QA failed";
-              fixInstructions = parts[1]?.trim() || summary;
-            }
-          }
-          if (block.type === "tool_use") {
-            await addLog(task.id, `QA: ${block.name} ${JSON.stringify(block.input).slice(0, 60)}`, "progress");
-          }
-        }
-      }
-
-      if (message.type === "result") {
-        // Check result text too
-        const text = message.result || "";
-        if (!passed && text.includes("QA_PASS:")) {
-          passed = true;
-          summary = text.split("QA_PASS:")[1]?.trim().split("\n")[0] || task.title;
-        } else if (passed === null && text.includes("QA_FAIL:")) {
-          passed = false;
-          const parts = text.split("QA_FAIL:")[1]?.split("| FIX:") || [];
-          summary = parts[0]?.trim() || "QA failed";
-          fixInstructions = parts[1]?.trim() || summary;
-        }
-        // Default to pass if Claude Code ran but didn't signal explicitly
-        if (passed === null) passed = true;
-      }
-    }
-
-    return {
-      passed: passed ?? true,
-      summary: summary || task.title,
-      issues: passed ? [] : [summary],
-      fixInstructions: passed ? null : fixInstructions,
-    };
-
-  } catch (e) {
-    // If Claude Code fails for any reason, don't block development
-    console.log(`  ⚠ QA error: ${e.message?.slice(0, 80)} — skipping`);
-    return { passed: true, summary: "QA skipped (error)", issues: [] };
-  }
-}
-
-// ── Full app QA after all tasks complete ──────────────────────────────────────
-export async function runFullAppQA(projectPath, prdContent, expoPort = 8081) {
-  console.log("\n  🔍  Running full app QA...");
-
-  if (!await isPortOpen(expoPort)) {
-    console.log("  ⚠️  Expo not running — skipping visual QA");
-    return { passed: true, routes: [], screenshotsCaptures: 0, issues: [] };
-  }
-
-  const appDir = path.join(projectPath, "app");
-  if (!fs.existsSync(appDir)) return { passed: true, routes: [], screenshotsCaptures: 0, issues: [] };
-
-  const routeFiles = listFiles(appDir, [".tsx", ".ts"])
-    .filter(f => !f.includes("_layout") && !f.includes("_error"))
-    .map(f => "/" + path.relative(appDir, f).replace(/\.(tsx|ts)$/, "").replace(/index$/, ""));
-
-  const screenshotDir = path.join(projectPath, ".claudeboard-screenshots", "full-qa");
-  if (!fs.existsSync(screenshotDir)) fs.mkdirSync(screenshotDir, { recursive: true });
-
-  const screenshots = [];
-  const issues = [];
-  const prdSummary = prdContent.slice(0, 1200);
-
-  for (const route of routeFiles) {
-    // Try iOS simulator screenshot first, fallback to Expo Web
-    const useIOS = process.env.CLAUDEBOARD_IOS === "1";
-    let shot = null;
-
-    if (useIOS) {
-      const simPath = path.join(screenshotDir, `sim_fullqa_${route.replace(/\//g, "_")}_${Date.now()}.png`);
-      const simShot = await screenshotSimulator(simPath);
-      if (simShot.success) shot = simShot;
-    }
-
-    if (!shot) {
-      const webShot = await screenshotExpoWeb(expoPort, screenshotDir, route);
-      if (webShot.success) shot = webShot;
-    }
-
-    if (!shot) {
-      await new Promise(r => setTimeout(r, 800));
-      continue;
-    }
-
-    screenshots.push({ route, ...shot });
-    console.log(chalk.dim(`    Screenshot: ${route}`));
-
-    // ── Visual analysis with Claude ───────────────────────────────────────
-    try {
-      const { text } = await callClaudeWithImage(
-        "You are a senior mobile QA engineer reviewing screenshots of a React Native / Expo app. Be concise and critical.",
-        `Screen route: ${route}
-
-PRD context (what the app should do):
-${prdSummary}
-
-Review this screenshot and identify ONLY real issues such as:
-- Broken or overlapping layout
-- Empty states that should have content
-- Placeholder text (lorem ipsum, "TODO", "Coming soon", etc.)
-- Visible error messages or red screens
-- Missing navigation or broken UI components
-- Text cut off or unreadable
-
-If the screen looks complete and correct, respond with: OK
-If there are issues, respond with: ISSUE: <brief description>
-Do NOT flag minor styling preferences. Only flag broken or clearly incomplete functionality.`,
-        shot.base64
-      );
-
-      const trimmed = text.trim();
-      if (trimmed.startsWith("ISSUE:")) {
-        const note = trimmed.replace("ISSUE:", "").trim();
-        issues.push({ route, note });
-        console.log(chalk.yellow(`    ⚠ ${route}: ${note}`));
-      } else {
-        console.log(chalk.dim(`    ✓ ${route}: OK`));
-      }
-    } catch (e) {
-      console.log(chalk.dim(`    ⚠ Visual analysis failed for ${route}: ${e.message?.slice(0, 60)}`));
-    }
-
-    await new Promise(r => setTimeout(r, 800));
-  }
-
-  return { passed: issues.length === 0, routes: routeFiles, screenshotsCaptures: screenshots.length, issues };
-}
-
-// ── Detect truncated files ─────────────────────────────────────────────────────
-async function checkForTruncatedFiles(task, projectPath) {
-  const issues = [];
-  const keywords = task.title.toLowerCase().split(" ").filter(w => w.length > 4);
-  const files = listFiles(projectPath, [".ts", ".tsx"]).filter(f => {
-    const rel = path.relative(projectPath, f).toLowerCase();
-    if (rel.includes("node_modules") || rel.includes(".claudeboard")) return false;
-    return keywords.some(kw => rel.includes(kw));
-  });
-
-  for (const f of files) {
-    const content = readFile(f);
-    if (!content) continue;
-    const rel = path.relative(projectPath, f);
-    const lastLines = content.split("\n").slice(-5).join("\n").trim();
-    const openBraces  = (content.match(/\{/g) || []).length;
-    const closeBraces = (content.match(/\}/g) || []).length;
-    const truncated =
-      lastLines.endsWith("{") || lastLines.endsWith("(") || lastLines.endsWith(",") ||
-      openBraces > closeBraces + 3 ||
-      (content.length < 80 && (rel.includes("store") || rel.includes("hook") || rel.includes("screen")));
-    if (truncated) issues.push(`${rel} (ends: "${lastLines.slice(-80)}")`);
-  }
-  return issues;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-function isPortOpen(port) {
-  return new Promise(resolve => {
-    const sock = createConnection({ port, host: "127.0.0.1" });
-    sock.setTimeout(800);
-    sock.once("connect", () => { sock.destroy(); resolve(true); });
-    sock.once("error", () => resolve(false));
-    sock.once("timeout", () => resolve(false));
-  });
-}
-
-async function getMetroError(projectPath) {
-  try {
-    const f = path.join(projectPath, ".claudeboard-expo-error.txt");
-    if (!fs.existsSync(f)) return null;
-    const stat = fs.statSync(f);
-    if (Date.now() - stat.mtimeMs > 5 * 60 * 1000) return null; // older than 5min
-    const content = fs.readFileSync(f, "utf8");
-    return content.includes("Unable to resolve") || content.includes("Cannot find module")
-      ? content.slice(-800)
-      : null;
-  } catch { return null; }
-}