claudeboard 2.16.0 → 3.1.1

package/agents/architect.js

@@ -1,166 +0,0 @@
-import { callClaudeJSON } from "./claude-api.js";
-import { createEpic, createTask } from "./board-client.js";
-import fs from "fs";
-import path from "path";
-
-const SYSTEM_MOBILE = `You are a senior mobile app architect specializing in React Native / Expo apps.
-Your job is to read a PRD and produce a complete, ordered task breakdown.
-
-Rules:
-- Think like a real engineering team: setup first, core features, then polish, then QA
-- Each task must be self-contained and implementable by a single developer agent
-- Be specific — tasks like "implement auth" are too vague. Break into: "create login screen UI", "implement Supabase auth hook", "add protected route navigation"
-- Always include: project setup, navigation, data layer, each feature screen, error handling, loading states, and final QA tasks
-- Priority: high = blocking/core, medium = main features, low = polish/nice-to-have
-- Types: config (setup/deps), feature (new screen or functionality), bug (fix), refactor, test (QA task)
-- When building on an existing project: do NOT recreate files that already exist — create tasks that extend or integrate with them`;
-
-const SYSTEM_WEB = `You are a senior web app architect specializing in React + Vite apps.
-Your job is to read a PRD and produce a complete, ordered task breakdown.
-
-Rules:
-- Think like a real engineering team: setup first, core features, then polish, then QA
-- Each task must be self-contained and implementable by a single developer agent
-- Be specific — tasks like "implement auth" are too vague. Break into: "create login page component", "implement Supabase auth hook", "add protected route with React Router"
-- Always include: project setup (Vite + React), routing, data layer, each page/view, error handling, loading states, and final QA tasks
-- Use React Router v6 for routing, TailwindCSS or CSS Modules for styles, Vite as build tool
-- Priority: high = blocking/core, medium = main features, low = polish/nice-to-have
-- Types: config (setup/deps), feature (new page or functionality), bug (fix), refactor, test (QA task)
-- When building on an existing project: do NOT recreate files that already exist — create tasks that extend or integrate with them`;
-
-/**
- * Build a concise snapshot of the existing project:
- * - Top-level file/folder structure
- * - package.json dependencies
- * - app.json expo config (if present)
- */
-function getProjectSnapshot(projectPath) {
-  const lines = [];
-
-  // Top-level structure (exclude hidden files and node_modules)
-  try {
-    const entries = fs.readdirSync(projectPath)
-      .filter(f => !f.startsWith('.') && f !== 'node_modules')
-      .sort();
-    lines.push("### Project structure (top level)");
-    for (const entry of entries) {
-      const fullPath = path.join(projectPath, entry);
-      const isDir = fs.statSync(fullPath).isDirectory();
-      if (isDir) {
-        // List one level deep for key folders
-        const children = fs.readdirSync(fullPath)
-          .filter(f => !f.startsWith('.') && f !== 'node_modules')
-          .slice(0, 15);
-        lines.push(`${entry}/`);
-        for (const child of children) lines.push(`  ${entry}/${child}`);
-      } else {
-        lines.push(entry);
-      }
-    }
-  } catch {}
-
-  // package.json
-  try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectPath, "package.json"), "utf8"));
-    lines.push("\n### package.json dependencies");
-    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-    for (const [name, version] of Object.entries(deps)) {
-      lines.push(`  ${name}: ${version}`);
-    }
-  } catch {}
-
-  // app.json
-  try {
-    const appJson = JSON.parse(fs.readFileSync(path.join(projectPath, "app.json"), "utf8"));
-    lines.push("\n### app.json (expo config)");
-    lines.push(JSON.stringify(appJson.expo || appJson, null, 2).slice(0, 1000));
-  } catch {}
-
-  return lines.join("\n");
-}
-
-export async function runArchitectAgent(prdContent, projectName, options = {}) {
-  const { buildOnExisting = false, projectPath = null, appType = "mobile" } = options;
-  const SYSTEM = appType === "web" ? SYSTEM_WEB : SYSTEM_MOBILE;
-
-  console.log("  Architect analyzing PRD...");
-
-  const projectSnapshot = (buildOnExisting && projectPath)
-    ? getProjectSnapshot(projectPath)
-    : null;
-
-  const existingProjectSection = projectSnapshot
-    ? `\n\nEXISTING PROJECT SNAPSHOT:\n${projectSnapshot}\n\nIMPORTANT: Create tasks that BUILD ON top of what already exists. Do NOT recreate files or setup that is already in place. Analyze the snapshot carefully and only create tasks for what is missing or needs to be extended.`
-    : "";
-
-  const techStackShape = appType === "web"
-    ? `"techStack": {
-    "framework": "vite+react",
-    "routing": "react-router-dom",
-    "stateManagement": "...",
-    "backend": "supabase / firebase / none",
-    "ui": "tailwindcss / css-modules / shadcn-ui",
-    "otherDeps": ["list of npm packages needed"]
-  }`
-    : `"techStack": {
-    "framework": "expo",
-    "navigation": "expo-router or react-navigation",
-    "stateManagement": "...",
-    "backend": "supabase / firebase / none",
-    "ui": "nativewind / tamagui / stylesheet",
-    "otherDeps": ["list of npm packages needed"]
-  }`;
-
-  const result = await callClaudeJSON(SYSTEM, `
-Project: ${projectName}
-
-PRD:
-${prdContent}
-${existingProjectSection}
-
-Return this JSON structure:
-{
-  ${techStackShape},
-  "epics": [
-    {
-      "name": "Epic name (e.g. Project Setup, Authentication, Home Screen)",
-      "order": 1,
-      "tasks": [
-        {
-          "title": "Specific task title",
-          "description": "Detailed description of exactly what needs to be implemented. Include: what file(s) to create/modify, what the component/function should do, any specific requirements from the PRD.",
-          "priority": "high|medium|low",
-          "type": "config|feature|test",
-          "acceptanceCriteria": "How to verify this task is done correctly"
-        }
-      ]
-    }
-  ]
-}
-
-Order epics from first to last in implementation order.
-Include as many tasks as needed for a complete, production-ready mobile app — do not artificially limit the count.`, { maxTokens: 16000 });
-
-  console.log(`  ✓ Architect created ${result.epics.length} epics`);
-
-  // Persist to board
-  let totalTasks = 0;
-  for (let i = 0; i < result.epics.length; i++) {
-    const epicData = result.epics[i];
-    const epicId = await createEpic(epicData.name);
-
-    for (const task of epicData.tasks) {
-      await createTask({
-        epicId,
-        title: task.title,
-        description: `${task.description}\n\nAcceptance: ${task.acceptanceCriteria || ""}`,
-        priority: task.priority,
-        type: task.type,
-      });
-      totalTasks++;
-    }
-  }
-
-  console.log(`  ✓ Created ${totalTasks} tasks in board`);
-  return { techStack: result.techStack, epics: result.epics, totalTasks };
-}

package/agents/board-client.js

@@ -1,126 +0,0 @@
-import { createClient } from "@supabase/supabase-js";
-
-let supabase = null;
-let PROJECT = "default";
-
-export function initBoard(url, key, project) {
-  supabase = createClient(url, key);
-  PROJECT = project;
-}
-
-export async function getNextTask() {
-  const { data } = await supabase
-    .from("cb_tasks")
-    .select("*, cb_epics(name)")
-    .eq("project", PROJECT)
-    .eq("status", "todo")
-    .order("priority_order", { ascending: true })
-    .limit(1)
-    .single();
-  return data || null;
-}
-
-export async function getAllTasks() {
-  const { data } = await supabase
-    .from("cb_tasks")
-    .select("*, cb_epics(name)")
-    .eq("project", PROJECT)
-    .order("priority_order");
-  return data || [];
-}
-
-export async function startTask(id, log) {
-  await supabase.from("cb_tasks").update({ status: "in_progress", started_at: new Date().toISOString() }).eq("id", id);
-  if (log) await addLog(id, log, "start");
-}
-
-export async function completeTask(id, log) {
-  await supabase.from("cb_tasks").update({ status: "done", completed_at: new Date().toISOString() }).eq("id", id);
-  if (log) await addLog(id, log, "complete");
-}
-
-export async function failTask(id, log) {
-  await supabase.from("cb_tasks").update({ status: "error" }).eq("id", id);
-  if (log) await addLog(id, log, "error");
-}
-
-export async function blockTask(id, log) {
-  await supabase.from("cb_tasks").update({ status: "blocked" }).eq("id", id);
-  if (log) await addLog(id, log, "error");
-}
-
-export async function addLog(taskId, message, type = "progress") {
-  await supabase.from("cb_logs").insert({ project: PROJECT, task_id: taskId, message, type });
-}
-
-export async function createEpic(name) {
-  // Check if epic with this name already exists for this project
-  const { data: existing } = await supabase
-    .from("cb_epics")
-    .select("id")
-    .eq("project", PROJECT)
-    .eq("name", name)
-    .single();
-  if (existing) return existing.id;
-  const { data } = await supabase.from("cb_epics").insert({ name, project: PROJECT }).select().single();
-  return data?.id;
-}
-
-export async function createTask({ epicId, title, description, priority = "medium", priorityOrder, type = "feature", status = "todo" }) {
-  const defaultOrder = { high: 1, medium: 2, low: 3 };
-  const { data } = await supabase
-    .from("cb_tasks")
-    .insert({
-      project: PROJECT,
-      epic_id: epicId,
-      title,
-      description,
-      priority,
-      priority_order: priorityOrder ?? defaultOrder[priority] ?? 2,
-      type,
-      status,
-    })
-    .select()
-    .single();
-  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 {
-    total: tasks.length,
-    todo: tasks.filter((t) => t.status === "todo").length,
-    in_progress: tasks.filter((t) => t.status === "in_progress").length,
-    done: tasks.filter((t) => t.status === "done").length,
-    error: tasks.filter((t) => t.status === "error").length,
-    blocked: tasks.filter((t) => t.status === "blocked").length,
-    pct: tasks.length > 0 ? Math.round((tasks.filter((t) => t.status === "done").length / tasks.length) * 100) : 0,
-  };
-}

package/agents/claude-api.js

@@ -1,124 +0,0 @@
-/**
- * Core Claude API caller for all agents
- * All agents use claude-sonnet-4-20250514 with specific system prompts and tools
- */
-
-const MODEL = "claude-sonnet-4-20250514";
-const MAX_TOKENS = 16000; // Max output tokens — input context window is 200k, no limits there
-
-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
- */
-export async function callClaude(systemPrompt, userMessage, options = {}) {
-  const body = {
-    model: MODEL,
-    max_tokens: options.maxTokens || MAX_TOKENS,
-    system: systemPrompt,
-    messages: [{ role: "user", content: userMessage }],
-  };
-
-  if (options.tools) body.tools = options.tools;
-
-  const response = await fetch("https://api.anthropic.com/v1/messages", {
-    method: "POST",
-    headers: getHeaders(),
-    body: JSON.stringify(body),
-  });
-
-  if (!response.ok) {
-    const err = await response.text();
-    throw new Error(`Claude API error ${response.status}: ${err}`);
-  }
-
-  const data = await response.json();
-
-  // Extract text content
-  const text = data.content
-    .filter((b) => b.type === "text")
-    .map((b) => b.text)
-    .join("");
-
-  return { text, raw: data };
-}
-
-/**
- * Call Claude API expecting JSON response
- * 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, maxTokens: options.maxTokens || MAX_TOKENS });
-
-  // Try 1: direct parse after stripping backticks
-  try {
-    const clean = text.replace(/```json\n?|```/g, "").trim();
-    return JSON.parse(clean);
-  } 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)}`);
-}
-
-/**
- * Call Claude with an image (for visual QA)
- */
-export async function callClaudeWithImage(systemPrompt, userMessage, imageBase64, mediaType = "image/png") {
-  const body = {
-    model: MODEL,
-    max_tokens: MAX_TOKENS,
-    system: systemPrompt,
-    messages: [
-      {
-        role: "user",
-        content: [
-          {
-            type: "image",
-            source: { type: "base64", media_type: mediaType, data: imageBase64 },
-          },
-          { type: "text", text: userMessage },
-        ],
-      },
-    ],
-  };
-
-  const response = await fetch("https://api.anthropic.com/v1/messages", {
-    method: "POST",
-    headers: getHeaders(),
-    body: JSON.stringify(body),
-  });
-
-  const data = await response.json();
-  const text = data.content?.filter((b) => b.type === "text").map((b) => b.text).join("") || "";
-  return { text, raw: data };
-}

package/agents/claude-resolver.js

@@ -1,167 +0,0 @@
-/**
- * claude-resolver.js — Cross-platform Claude Code CLI detection
- *
- * Problem: On Windows, Claude Desktop installs a `claude.exe` that shadows
- * the Claude Code CLI installed via `npm install -g @anthropic-ai/claude-code`.
- * `which`/`where` may return the Desktop binary instead of the CLI.
- *
- * Strategy:
- *   1. Honor CLAUDE_CODE_PATH env var (explicit override)
- *   2. npm-based detection (most reliable — finds the npm-installed binary directly)
- *   3. which/where — but validate it's not the Desktop app
- *   4. Hardcoded platform-specific fallback paths
- */
-
-import { execSync } from "child_process";
-import path from "path";
-import fs from "fs";
-
-const isWin = process.platform === "win32";
-const pathSep = isWin ? ";" : ":";
-
-/**
- * Returns true if the candidate path looks like the Claude Code CLI
- * and NOT the Claude Desktop app binary.
- */
-function isClaudeCodePath(p) {
-  if (!p) return false;
-  const lower = p.toLowerCase().replace(/\\/g, "/");
-  // Desktop app on Windows: usually under AppData/Local/AnthropicClaude/
-  if (lower.includes("anthropicclaude")) return false;
-  if (lower.includes("anthropic claude")) return false;
-  // Desktop app on macOS: /Applications/Claude.app/...
-  if (lower.includes("claude.app/")) return false;
-  return true;
-}
-
-/**
- * Resolves the path to the Claude Code CLI binary.
- * Handles Windows / macOS / Linux, and the Desktop-vs-CLI shadowing conflict.
- */
-export function resolveClaudePath() {
-  // 1. Explicit override always wins
-  if (process.env.CLAUDE_CODE_PATH) return process.env.CLAUDE_CODE_PATH;
-
-  // 2. npm global bin detection — bypasses PATH shadowing entirely
-  try {
-    const npmRoot = execSync("npm root -g", { stdio: "pipe", timeout: 5000 })
-      .toString().trim();
-    // npmRoot: /usr/local/lib/node_modules  or  C:\Users\<user>\AppData\Roaming\npm\node_modules
-    // The global bin dir is one level up from node_modules
-    const npmBinDir = path.dirname(npmRoot);
-    const candidates = isWin
-      ? [
-          path.join(npmBinDir, "claude.cmd"),
-          path.join(npmBinDir, "claude"),
-        ]
-      : [path.join(npmBinDir, "claude")];
-    for (const c of candidates) {
-      if (fs.existsSync(c)) return c;
-    }
-  } catch {}
-
-  // 3. which / where — validate it's not the Desktop app
-  try {
-    const raw = execSync(isWin ? "where claude" : "which claude", {
-      stdio: "pipe",
-      timeout: 5000,
-    }).toString().trim();
-    // `where` on Windows may return multiple lines; take the first valid one
-    const lines = raw.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
-    for (const candidate of lines) {
-      if (isClaudeCodePath(candidate)) return candidate;
-    }
-  } catch {}
-
-  // 4. Hardcoded platform-specific fallback paths
-  if (isWin) {
-    const appData = process.env.APPDATA || "";
-    for (const p of [
-      path.join(appData, "npm", "claude.cmd"),
-      path.join(appData, "npm", "claude"),
-    ]) {
-      if (fs.existsSync(p)) return p;
-    }
-  } else {
-    for (const p of [
-      "/opt/homebrew/bin/claude",
-      "/usr/local/bin/claude",
-      `${process.env.HOME}/.nvm/versions/node/current/bin/claude`,
-      `${process.env.HOME}/.npm-global/bin/claude`,
-    ]) {
-      try {
-        execSync(`test -f "${p}"`, { stdio: "pipe" });
-        return p;
-      } catch {}
-    }
-  }
-
-  return null;
-}
-
-/**
- * Builds a cross-platform environment for subprocesses so that node/npm/npx
- * are always resolvable inside Claude Code's shell.
- * Also strips ANTHROPIC_API_KEY so Claude uses the user's subscription.
- */
-export function buildEnv() {
-  // Use the current process's node binary dir — reliable on all platforms
-  const nodeBinDir = path.dirname(process.execPath);
-
-  const extraPaths = isWin
-    ? [
-        process.env.APPDATA ? path.join(process.env.APPDATA, "npm") : "",
-        process.env.LOCALAPPDATA
-          ? path.join(process.env.LOCALAPPDATA, "Microsoft", "WindowsApps")
-          : "",
-      ]
-    : [
-        "/opt/homebrew/bin",
-        "/opt/homebrew/sbin",
-        "/usr/local/bin",
-        "/usr/bin",
-        "/bin",
-        `${process.env.HOME}/.npm-global/bin`,
-        `${process.env.HOME}/.nvm/versions/node/current/bin`,
-      ];
-
-  const pathParts = [
-    process.env.PATH || "",
-    nodeBinDir,
-    ...extraPaths,
-  ].filter(Boolean);
-
-  const fullPath = [
-    ...new Set(pathParts.join(pathSep).split(pathSep).filter(Boolean)),
-  ].join(pathSep);
-
-  const env = { ...process.env, PATH: fullPath };
-  if (!isWin) env.HOME = process.env.HOME;
-  // Remove API key so Claude Code uses the Claude subscription (not API credits)
-  delete env.ANTHROPIC_API_KEY;
-  return env;
-}
-
-/**
- * Returns a human-readable installation hint for the current platform.
- */
-export function installHint() {
-  if (isWin) {
-    return [
-      "Claude Code CLI not found or shadowed by Claude Desktop.",
-      "",
-      "Install the CLI:  npm install -g @anthropic-ai/claude-code",
-      "Then run:         claude",
-      "",
-      "If already installed, set the explicit path to avoid conflicts:",
-      "  set CLAUDE_CODE_PATH=C:\\Users\\<you>\\AppData\\Roaming\\npm\\claude.cmd",
-      "  claudeboard run ...",
-    ].join("\n");
-  }
-  return [
-    "Claude Code CLI not found.",
-    "",
-    "Install:  npm install -g @anthropic-ai/claude-code",
-    "Then run: claude",
-  ].join("\n");
-}