claudeboard 1.1.0 → 1.5.0

package/agents/board-client.js

@@ -77,6 +77,33 @@ export async function createTask({ epicId, title, description, priority = "mediu
   return data;
 }
 
+/**
+ * Check if this project already has tasks in the board
+ * Used to detect resume vs fresh start
+ */
+export async function hasTasks() {
+  const { data, error } = await supabase
+    .from("cb_tasks")
+    .select("id")
+    .eq("project", PROJECT)
+    .limit(1);
+  return Array.isArray(data) && data.length > 0;
+}
+
+/**
+ * Reset any stuck "in_progress" tasks back to "todo"
+ * Called on resume so the agent re-picks them up
+ */
+export async function resetStuckTasks() {
+  const { data } = await supabase
+    .from("cb_tasks")
+    .update({ status: "todo", started_at: null })
+    .eq("project", PROJECT)
+    .eq("status", "in_progress")
+    .select();
+  return data?.length || 0;
+}
+
 export async function getStats() {
   const tasks = await getAllTasks();
   return {

package/agents/claude-api.js

@@ -4,7 +4,7 @@
  */
 
 const MODEL = "claude-sonnet-4-20250514";
-const MAX_TOKENS = 8096;
+const MAX_TOKENS = 16000; // Increased — large codegen responses need more tokens
 
 function getHeaders() {
   const key = process.env.ANTHROPIC_API_KEY;
@@ -59,18 +59,35 @@ export async function callClaude(systemPrompt, userMessage, options = {}) {
 
 /**
  * Call Claude API expecting JSON response
- * Returns parsed object or throws
+ * Robust: tries 3 extraction strategies + auto-repair for truncated responses
  */
 export async function callClaudeJSON(systemPrompt, userMessage, options = {}) {
   const sys = systemPrompt + "\n\nYou MUST respond with valid JSON only. No markdown, no explanation, no backticks. Pure JSON.";
-  const { text } = await callClaude(sys, userMessage, options);
+  const { text } = await callClaude(sys, userMessage, { ...options, maxTokens: options.maxTokens || MAX_TOKENS });
 
+  // Try 1: direct parse after stripping backticks
   try {
-    const clean = text.replace(/```json|```/g, "").trim();
+    const clean = text.replace(/```json\n?|```/g, "").trim();
     return JSON.parse(clean);
-  } catch (err) {
-    throw new Error(`Failed to parse JSON from Claude: ${text.slice(0, 200)}`);
-  }
+  } catch {}
+
+  // Try 2: extract first { } or [ ] block
+  try {
+    const match = text.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
+    if (match) return JSON.parse(match[1]);
+  } catch {}
+
+  // Try 3: ask Claude to repair truncated/broken JSON
+  try {
+    const repair = await callClaude(
+      "You are a JSON repair tool. Fix this broken or truncated JSON. Return ONLY valid JSON, nothing else, no backticks.",
+      `Broken JSON:\n${text.slice(0, 8000)}`
+    );
+    const clean = repair.text.replace(/```json\n?|```/g, "").trim();
+    return JSON.parse(clean);
+  } catch {}
+
+  throw new Error(`Failed to parse JSON after 3 attempts. Preview: ${text.slice(0, 300)}`);
 }
 
 /**

package/agents/orchestrator.js

@@ -13,6 +13,8 @@ import {
   addLog,
   createTask,
   createEpic,
+  hasTasks,
+  resetStuckTasks,
 } from "./board-client.js";
 import { initSupabaseReader } from "../tools/supabase-reader.js";
 import { runCommand, startProcess, waitForPort } from "../tools/terminal.js";
@@ -49,15 +51,31 @@ export async function runOrchestrator(config) {
   console.log(chalk.dim(`  Project: ${projectPath}\n`));
 
   let techStack = {};
+  let isResume = false;
 
-  // ── PHASE 1: ARCHITECTURE ──────────────────────────────────────────────────
-  if (!skipArchitect) {
+  // ── 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"));
     const archResult = await runArchitectAgent(prdContent, projectName);
     techStack = archResult.techStack;
     console.log(chalk.green(`\n  ✓ ${archResult.totalTasks} tasks created across ${archResult.epics.length} epics\n`));
-  } else {
-    console.log(chalk.dim("  Skipping architect (tasks already exist)\n"));
   }
 
   // ── START EXPO ─────────────────────────────────────────────────────────────

package/bin/cli.js

@@ -62,6 +62,7 @@ program
       supabaseUrl: answers.supabaseUrl,
       supabaseKey: answers.supabaseKey,
       anthropicKey: answers.anthropicKey,
+      projectDir: process.cwd(),
       createdAt: new Date().toISOString(),
     };
 
@@ -106,6 +107,7 @@ program
         ANTHROPIC_API_KEY: config.anthropicKey || process.env.ANTHROPIC_API_KEY || "",
         PORT: String(port),
         PROJECT_NAME: config.projectName,
+        PROJECT_DIR: config.projectDir || process.cwd(),
       },
       stdio: "pipe",
     });
@@ -129,7 +131,7 @@ program
   .description("Run the AI engineering team on your project")
   .requiredOption("--prd <path>", "Path to PRD markdown file")
   .requiredOption("--project <path>", "Path to your app project directory")
-  .option("--skip-architect", "Skip architecture phase (tasks already exist)")
+  .option("--restart", "Force restart from scratch (ignore existing tasks in board)")
   .option("--expo-port <port>", "Expo Web port for QA screenshots", "8081")
   .action(async (opts) => {
     console.log(LOGO);
@@ -145,7 +147,9 @@ program
     console.log(chalk.bold(`  AI Team starting for: ${chalk.cyan(config.projectName)}\n`));
     console.log(chalk.dim(`  Dashboard → http://localhost:${config.port}`));
     console.log(chalk.dim(`  PRD       → ${opts.prd}`));
-    console.log(chalk.dim(`  Project   → ${opts.project}\n`));
+    console.log(chalk.dim(`  Project   → ${opts.project}`));
+    if (opts.restart) console.log(chalk.yellow(`  Mode      → FORCE RESTART\n`));
+    else console.log(chalk.dim(`  Mode      → auto-resume if tasks exist\n`));
 
     const { runOrchestrator } = await import("../agents/orchestrator.js");
 
@@ -156,7 +160,7 @@ program
       supabaseKey: config.supabaseKey,
       projectName: config.projectName,
       expoPort: parseInt(opts.expoPort),
-      skipArchitect: !!opts.skipArchitect,
+      forceRestart: !!opts.restart,
     });
   });