claudeboard 1.0.0 → 1.3.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

@@ -6,6 +6,22 @@
 const MODEL = "claude-sonnet-4-20250514";
 const MAX_TOKENS = 8096;
 
+function getHeaders() {
+  const key = process.env.ANTHROPIC_API_KEY;
+  if (!key) {
+    throw new Error(
+      "ANTHROPIC_API_KEY not set.\n" +
+      "Run: claudeboard init  (and enter your API key)\n" +
+      "Or:  export ANTHROPIC_API_KEY=sk-ant-..."
+    );
+  }
+  return {
+    "Content-Type": "application/json",
+    "x-api-key": key,
+    "anthropic-version": "2023-06-01",
+  };
+}
+
 /**
  * Call Claude API and get text response
  */
@@ -21,7 +37,7 @@ export async function callClaude(systemPrompt, userMessage, options = {}) {
 
   const response = await fetch("https://api.anthropic.com/v1/messages", {
     method: "POST",
-    headers: { "Content-Type": "application/json" },
+    headers: getHeaders(),
     body: JSON.stringify(body),
   });
 
@@ -81,7 +97,7 @@ export async function callClaudeWithImage(systemPrompt, userMessage, imageBase64
 
   const response = await fetch("https://api.anthropic.com/v1/messages", {
     method: "POST",
-    headers: { "Content-Type": "application/json" },
+    headers: getHeaders(),
     body: JSON.stringify(body),
   });
 

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

@@ -19,7 +19,17 @@ ${chalk.cyan("╚═════════════════════
 
 function loadConfig() {
   try {
-    return JSON.parse(fs.readFileSync(path.join(process.cwd(), ".claudeboard.json"), "utf8"));
+    const config = JSON.parse(fs.readFileSync(path.join(process.cwd(), ".claudeboard.json"), "utf8"));
+    // Inject API key into environment automatically
+    if (config.anthropicKey) {
+      process.env.ANTHROPIC_API_KEY = config.anthropicKey;
+    }
+    if (!process.env.ANTHROPIC_API_KEY) {
+      console.log(chalk.yellow("⚠️  ANTHROPIC_API_KEY not found."));
+      console.log(chalk.dim("   Run claudeboard init again, or: export ANTHROPIC_API_KEY=sk-ant-..."));
+      process.exit(1);
+    }
+    return config;
   } catch {
     console.log(chalk.yellow("No .claudeboard.json found. Run: claudeboard init"));
     process.exit(1);
@@ -40,6 +50,7 @@ program
       { type: "input", name: "projectName", message: "Project name:", initial: path.basename(process.cwd()) },
       { type: "input", name: "supabaseUrl", message: "Supabase URL:", hint: "https://xxxx.supabase.co" },
       { type: "input", name: "supabaseKey", message: "Supabase anon key:" },
+      { type: "password", name: "anthropicKey", message: "Anthropic API key:", hint: "sk-ant-..." },
       { type: "input", name: "port", message: "Dashboard port:", initial: "3131" },
     ]);
 
@@ -50,6 +61,7 @@ program
       port: parseInt(answers.port),
       supabaseUrl: answers.supabaseUrl,
       supabaseKey: answers.supabaseKey,
+      anthropicKey: answers.anthropicKey,
       createdAt: new Date().toISOString(),
     };
 
@@ -91,6 +103,7 @@ program
         ...process.env,
         SUPABASE_URL: config.supabaseUrl,
         SUPABASE_KEY: config.supabaseKey,
+        ANTHROPIC_API_KEY: config.anthropicKey || process.env.ANTHROPIC_API_KEY || "",
         PORT: String(port),
         PROJECT_NAME: config.projectName,
       },
@@ -116,7 +129,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);
@@ -132,7 +145,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");
 
@@ -143,7 +158,7 @@ program
       supabaseKey: config.supabaseKey,
       projectName: config.projectName,
       expoPort: parseInt(opts.expoPort),
-      skipArchitect: !!opts.skipArchitect,
+      forceRestart: !!opts.restart,
     });
   });