claudeboard 2.1.0 → 2.3.0

package/agents/developer.js

@@ -1,10 +1,7 @@
 /**
  * Developer Agent — powered by Claude Agent SDK
- *
- * Instead of calling the Claude API and manually writing files,
- * this agent spawns Claude Code directly in the project directory.
- * Claude Code can read the full codebase, run commands, install deps,
- * fix errors, and iterate — all autonomously.
+ * Replaces the old API-based developer with Claude Code running directly
+ * in the project directory — full codebase access, real shell commands.
  *
  * Requires: npm install -g @anthropic-ai/claude-code
  */
@@ -13,74 +10,83 @@ import { query } from "@anthropic-ai/claude-agent-sdk";
 import { startTask, completeTask, failTask, addLog } from "./board-client.js";
 import { execSync } from "child_process";
 
-// Resolve the global `claude` binary path at startup
+// ── Resolve the global `claude` binary path at startup ────────────────────────
 function resolveClaudePath() {
-  // 1. Explicit override via env var
   if (process.env.CLAUDE_CODE_PATH) return process.env.CLAUDE_CODE_PATH;
-
-  // 2. Ask the shell where `claude` lives (works after: npm install -g @anthropic-ai/claude-code)
-  try {
-    return execSync("which claude", { stdio: "pipe" }).toString().trim();
-  } catch {}
-
-  // 3. Common Homebrew / nvm / fnm paths
-  const candidates = [
+  try { return execSync("which claude", { stdio: "pipe" }).toString().trim(); } catch {}
+  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`,
-  ];
-  for (const p of candidates) {
+  ]) {
     try { execSync(`test -f "${p}"`, { stdio: "pipe" }); return p; } catch {}
   }
+  return null;
+}
 
-  return null; // will surface as CLINotFoundError
+// ── Build a full PATH so node/npm/npx are found inside the subprocess ─────────
+// Exit code 127 = "command not found" — happens when PATH is stripped for global pkgs
+function buildEnv() {
+  let nodeBinDir = "";
+  try { nodeBinDir = execSync("dirname $(which node)", { stdio: "pipe" }).toString().trim(); } catch {}
+
+  const pathParts = [
+    process.env.PATH || "",
+    nodeBinDir,
+    "/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`,
+  ].filter(Boolean);
+
+  const fullPath = [...new Set(pathParts.join(":").split(":"))].join(":");
+  return { ...process.env, PATH: fullPath, HOME: process.env.HOME };
 }
 
 const CLAUDE_PATH = resolveClaudePath();
 
-// Tools Claude Code can use — full developer access
+// ── Tools Claude Code can use ─────────────────────────────────────────────────
 const DEVELOPER_TOOLS = [
-  "Read",        // Read any file in the project
-  "Write",       // Create new files
-  "Edit",        // Edit existing files (surgical, line-level)
-  "MultiEdit",   // Edit multiple files in one shot
-  "Bash",        // Run npm install, npx expo install, tsc, etc.
-  "Glob",        // Find files by pattern (e.g. "**/*.tsx")
-  "Grep",        // Search file contents
-  "TodoWrite",   // Let Claude track its own subtasks
-  "TodoRead",    // Read its own task list
+  "Read", "Write", "Edit", "MultiEdit",
+  "Bash", "Glob", "Grep",
+  "TodoWrite", "TodoRead",
 ];
 
 const DEV_RULES = `
-You are a senior React Native / Expo developer working as part of an autonomous engineering team.
+You are a senior React Native / Expo developer in an autonomous engineering team.
 
 RULES:
 - Write complete, production-ready code — no placeholders, no TODOs
 - Use TypeScript if the project uses it
-- Follow the existing code style and folder structure (read existing files first)
+- Read existing files first to follow the project's patterns
 - Install packages with: npx expo install <package>
-- After writing files, run: npx tsc --noEmit — fix any TypeScript errors
-- If you hit an error, read it and fix it — iterate until it works
-- Do NOT ask questions. Do NOT ask for confirmation. Make your best judgment.
+- After writing files run: npx tsc --noEmit — fix any errors you find
+- If you hit an error, read it carefully and fix it — iterate until it works
+- Do NOT ask questions or ask for confirmation. Make your best judgment.
 - When fully done, print EXACTLY this line: TASK_COMPLETE: <one sentence summary>
 `;
 
+// ── Main export ───────────────────────────────────────────────────────────────
 export async function runDeveloperAgent(task, projectPath, techStack, retryContext = null) {
   console.log(`  🤖  Claude Code working on: ${task.title}`);
-  if (CLAUDE_PATH) {
-    console.log(`     CLI: ${CLAUDE_PATH}`);
-  } else {
+
+  if (!CLAUDE_PATH) {
     const hint = "Claude Code CLI not found. Run: npm install -g @anthropic-ai/claude-code";
     await startTask(task.id, hint);
     await failTask(task.id, hint);
     console.error(`\n  ✗ ${hint}\n`);
     return { success: false, error: hint };
   }
+
+  console.log(`     CLI: ${CLAUDE_PATH}`);
   await startTask(task.id, `Claude Code starting: ${task.title}`);
 
   const retryNote = retryContext
-    ? `\n\n⚠️ RETRY — Previous attempt failed or QA flagged issues:\n${retryContext}\n\nFix these specific issues.`
+    ? `\n\n⚠️ RETRY — Previous attempt failed. Fix these issues:\n${retryContext}`
     : "";
 
   const techNote = techStack && Object.keys(techStack).length > 0
@@ -116,39 +122,31 @@ ${retryNote}
         permissionMode: "bypassPermissions",
         allowedTools: DEVELOPER_TOOLS,
         maxTurns: 80,
-        ...(CLAUDE_PATH ? { pathToClaudeCodeExecutable: CLAUDE_PATH } : {}),
+        pathToClaudeCodeExecutable: CLAUDE_PATH,
         systemPrompt: {
           type: "preset",
           preset: "claude_code",
           append: DEV_RULES,
         },
-        env: {
-          ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
-        },
+        env: buildEnv(),
       },
     })) {
 
-      // ── Assistant messages ─────────────────────────────────────────────────
+      // Assistant messages — log tools and text
       if (message.type === "assistant") {
         for (const block of message.message.content) {
-
           if (block.type === "text" && block.text?.trim()) {
             const text = block.text.trim();
-
-            // Detect completion signal
             if (text.includes("TASK_COMPLETE:")) {
               completed = true;
               summary = text.split("TASK_COMPLETE:")[1]?.trim().split("\n")[0] || task.title;
             }
-
-            // Log meaningful progress
             if (text.length > 20) {
               const preview = text.split("\n")[0].slice(0, 120);
               await addLog(task.id, preview, "progress");
               console.log(`     ${preview}`);
             }
           }
-
           if (block.type === "tool_use") {
             toolCallCount++;
             const log = formatToolLog(block);
@@ -160,14 +158,13 @@ ${retryNote}
         }
       }
 
-      // ── Result ─────────────────────────────────────────────────────────────
+      // Result — task finished or errored
       if (message.type === "result") {
         if (message.subtype === "success") {
           if (!completed && message.result?.includes("TASK_COMPLETE:")) {
             completed = true;
             summary = message.result.split("TASK_COMPLETE:")[1]?.trim().split("\n")[0] || task.title;
           }
-
           const finalSummary = summary || `Implemented: ${task.title}`;
           await completeTask(task.id, `✓ ${finalSummary} (${toolCallCount} tool calls)`);
           console.log(`  ✓ Done: ${task.title} — ${toolCallCount} tool calls`);
@@ -178,7 +175,7 @@ ${retryNote}
             await completeTask(task.id, `✓ ${summary} (hit turn limit)`);
             return { success: true, summary };
           }
-          const err = "Reached max turns without completing — increase maxTurns or break task into smaller pieces";
+          const err = "Reached max turns (80) — consider breaking this task into smaller pieces";
           await failTask(task.id, err);
           return { success: false, error: err };
 
@@ -189,11 +186,11 @@ ${retryNote}
         }
       }
 
-      // ── System init ────────────────────────────────────────────────────────
+      // System init — log session info
       if (message.type === "system" && message.subtype === "init") {
-        const sessionShort = message.session_id?.slice(0, 8) || "?";
-        console.log(`     📡 Session ${sessionShort} | ${message.tools?.length || 0} tools | ${message.model}`);
-        await addLog(task.id, `Claude Code session ${sessionShort} in ${projectPath}`, "start");
+        const s = message.session_id?.slice(0, 8) || "?";
+        console.log(`     📡 Session ${s} | ${message.tools?.length || 0} tools | ${message.model}`);
+        await addLog(task.id, `Session ${s} started`, "start");
       }
     }
 
@@ -202,7 +199,6 @@ ${retryNote}
       await completeTask(task.id, `✓ ${summary}`);
       return { success: true, summary };
     }
-
     const err = "Session ended without result";
     await failTask(task.id, err);
     return { success: false, error: err };
@@ -210,15 +206,11 @@ ${retryNote}
   } catch (err) {
     const msg = err.message || String(err);
     console.error(`  ✗ Error:`, msg.slice(0, 200));
-
-    // Missing CLI — helpful message
-    if (msg.includes("CLINotFoundError") || msg.includes("ENOENT") || msg.includes("claude-code")) {
+    if (msg.includes("CLINotFoundError") || msg.includes("ENOENT")) {
       const hint = "Claude Code CLI not installed. Run: npm install -g @anthropic-ai/claude-code";
       await failTask(task.id, hint);
-      console.error(`\n  ⚠️  ${hint}\n`);
       return { success: false, error: hint };
     }
-
     await failTask(task.id, msg.slice(0, 500));
     return { success: false, error: msg };
   }
@@ -226,15 +218,16 @@ ${retryNote}
 
 function formatToolLog(block) {
   const { name, input = {} } = block;
+  const p = input.file_path || input.path || "";
   switch (name) {
-    case "Read":       return `Read: ${input.file_path || input.path || ""}`;
-    case "Write":      return `Write: ${input.file_path || input.path || ""}`;
+    case "Read":      return `Read: ${p}`;
+    case "Write":     return `Write: ${p}`;
     case "Edit":
-    case "MultiEdit":  return `Edit: ${input.file_path || input.path || ""}`;
-    case "Bash":       return `Run: ${(input.command || "").slice(0, 80)}`;
-    case "Glob":       return `Glob: ${input.pattern || ""}`;
-    case "Grep":       return `Grep: "${(input.pattern || "").slice(0, 40)}"`;
-    case "TodoWrite":  return `Planning subtasks...`;
-    default:           return null;
+    case "MultiEdit": return `Edit: ${p}`;
+    case "Bash":      return `Run: ${(input.command || "").slice(0, 80)}`;
+    case "Glob":      return `Glob: ${input.pattern || ""}`;
+    case "Grep":      return `Grep: "${(input.pattern || "").slice(0, 40)}"`;
+    case "TodoWrite": return `Planning...`;
+    default:          return null;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeboard",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "AI engineering team — from PRD to working mobile app, autonomously",
   "type": "module",
   "bin": {