claudeboard 2.15.4 → 3.1.0

package/bin/cli.js

@@ -1,251 +1,219 @@
 #!/usr/bin/env node
+// bin/cli.js
+const path = require('path');
+const fs   = require('fs');
+const chalk = require('chalk');
+
+const PKG_VERSION = '3.1.0';
+
+// ─────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────
+function header(subtitle) {
+  console.log(chalk.bold.hex('#e3c69a')('ClaudeBoard v3 ✦') + (subtitle ? chalk.dim('  ' + subtitle) : ''));
+  console.log(chalk.dim('Visual orchestrator for Claude Code agent teams'));
+  console.log('');
+}
 
-import { program } from "commander";
-import chalk from "chalk";
-import ora from "ora";
-import { fileURLToPath } from "url";
-import path from "path";
-import fs from "fs";
-import { spawn } from "child_process";
-import open from "open";
-import { createRequire } from "module";
-
-const _require = createRequire(import.meta.url);
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const _pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "../package.json"), "utf8"));
-
+// ─────────────────────────────────────────────────────────────────
+// claudeboard init
+// ─────────────────────────────────────────────────────────────────
+function runInit() {
+  header('init');
+
+  const cwd       = process.cwd();
+  const boardDir  = path.join(cwd, '.claudeboard');
+  const projectName = path.basename(cwd);
+
+  console.log(chalk.dim('Directorio: ') + chalk.cyan(cwd));
+  console.log('');
+
+  // 1. Create .claudeboard/
+  if (!fs.existsSync(boardDir)) {
+    fs.mkdirSync(boardDir, { recursive: true });
+    console.log(chalk.green('✔') + '  Carpeta .claudeboard/ creada');
+  } else {
+    console.log(chalk.yellow('~') + '  .claudeboard/ ya existe — no se sobreescribe');
+  }
 
-const LOGO = `
-${chalk.cyan("╔════════════════════════════════════════════╗")}
-${chalk.cyan("║")}  ${chalk.bold.white("●")} ${chalk.bold.cyan("CLAUDEBOARD")}  ${chalk.dim("powered by High Value, LLC")}  ${chalk.cyan("║")}
-${chalk.cyan("╚════════════════════════════════════════════╝")}
-`;
+  // 2. Write config.json only if missing
+  const configPath = path.join(boardDir, 'config.json');
+  if (!fs.existsSync(configPath)) {
+    fs.writeFileSync(configPath, JSON.stringify({ projectName, createdAt: new Date().toISOString() }, null, 2));
+    console.log(chalk.green('✔') + '  config.json inicializado');
+  }
 
-function loadConfig() {
+  // 3. Update .gitignore
+  const gitignorePath = path.join(cwd, '.gitignore');
+  const ignoreEntry   = '.claudeboard/';
+  let gitignored = false;
   try {
-    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);
+    if (fs.existsSync(gitignorePath)) {
+      const content = fs.readFileSync(gitignorePath, 'utf-8');
+      if (!content.includes(ignoreEntry)) {
+        fs.appendFileSync(gitignorePath, `\n# ClaudeBoard — datos del board (tareas, historial, handoffs)\n${ignoreEntry}\n`);
+        gitignored = true;
+      }
+    } else {
+      fs.writeFileSync(gitignorePath, `# ClaudeBoard — datos del board (tareas, historial, handoffs)\n${ignoreEntry}\n`);
+      gitignored = true;
     }
-    return config;
-  } catch {
-    console.log(chalk.yellow("No .claudeboard.json found. Run: claudeboard init"));
-    process.exit(1);
+    if (gitignored) console.log(chalk.green('✔') + '  .claudeboard/ agregado al .gitignore');
+    else            console.log(chalk.yellow('~') + '  .gitignore ya incluye .claudeboard/');
+  } catch { /* non-fatal */ }
+
+  // 4. Create a starter context.md if missing
+  const contextPath = path.join(boardDir, 'context.md');
+  if (!fs.existsSync(contextPath)) {
+    fs.writeFileSync(contextPath, `# Guías de marca / contexto de "${projectName}"\n\n<!-- Opcional: agregá colores, tipografías, tono de voz, reglas del proyecto. -->\n<!-- Los agentes lo leerán antes de trabajar. -->\n`);
+    console.log(chalk.green('✔') + '  .claudeboard/context.md creado (editalo con tus guías de marca)');
   }
-}
-
-// ─── INIT ────────────────────────────────────────────────────────────────────
-program
-  .command("init")
-  .description("Initialize claudeboard in a project")
-  .action(async () => {
-    console.log(LOGO);
-    const { default: Enquirer } = await import("enquirer");
-    const enquirer = new Enquirer();
-    console.log(chalk.bold("Let's set up your AI engineering team — powered by High Value, LLC.\n"));
-
-    const answers = await enquirer.prompt([
-      { 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" },
-    ]);
-
-    const spinner = ora("Creating config...").start();
-
-    const config = {
-      projectName: answers.projectName,
-      port: parseInt(answers.port),
-      supabaseUrl: answers.supabaseUrl,
-      supabaseKey: answers.supabaseKey,
-      anthropicKey: answers.anthropicKey,
-      projectDir: process.cwd(),
-      createdAt: new Date().toISOString(),
-    };
-
-    fs.writeFileSync(path.join(process.cwd(), ".claudeboard.json"), JSON.stringify(config, null, 2));
-
-    const sqlSrc = path.join(__dirname, "../sql/setup.sql");
-    fs.copyFileSync(sqlSrc, path.join(process.cwd(), "claudeboard-setup.sql"));
-
-    spinner.succeed(chalk.green("Config created!"));
-
-    console.log(`
-${chalk.bold("Next steps:")}
-
-${chalk.cyan("1.")} Run the SQL in your Supabase SQL Editor:
-   ${chalk.dim("→ claudeboard-setup.sql")}
-
-${chalk.cyan("2.")} Start the dashboard:
-   ${chalk.bold("claudeboard start")}
-
-${chalk.cyan("3.")} Run the AI team with your PRD:
-   ${chalk.bold("claudeboard run --prd ./PRD.md --project ./your-app")}
-`);
-  });
 
-// ─── START DASHBOARD ─────────────────────────────────────────────────────────
-program
-  .command("start")
-  .description("Start the dashboard server")
-  .option("-p, --port <port>", "Port number")
-  .action(async (opts) => {
-    console.log(LOGO);
-    const config = loadConfig();
-    const port = opts.port || config.port || 3131;
-    const spinner = ora("Starting dashboard...").start();
-
-    const serverPath = path.join(__dirname, "../dashboard/server.js");
-    const server = spawn("node", [serverPath], {
-      env: {
-        ...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,
-        PROJECT_DIR: config.projectDir || process.cwd(),
-      },
-      stdio: "pipe",
-    });
-
-    server.stdout.on("data", (data) => {
-      if (data.toString().includes("READY")) {
-        spinner.succeed(chalk.green("Dashboard running!"));
-        console.log(`\n  ${chalk.bold("→")} ${chalk.cyan(`http://localhost:${port}`)}\n`);
-        console.log(chalk.dim("  Press Ctrl+C to stop\n"));
-        open(`http://localhost:${port}`);
-      }
-    });
-
-    server.stderr.on("data", (d) => console.error(chalk.red(d.toString())));
-    process.on("SIGINT", () => { server.kill(); process.exit(0); });
-  });
+  console.log('');
+  console.log(chalk.bold('¡Listo! ') + chalk.dim('Corré ') + chalk.cyan('claudeboard') + chalk.dim(' para iniciar el board en este proyecto.'));
+  console.log('');
+}
 
-// ─── RUN AI TEAM ─────────────────────────────────────────────────────────────
-program
-  .command("run")
-  .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("--restart", "Force restart from scratch (ignore existing tasks in board)")
-  .option("--expo-port <port>", "Expo Web port for QA screenshots", "8081")
-  .option("--ios", "Use iOS Simulator instead of Expo Web for QA (requires Xcode)")
-  .action(async (opts) => {
-    console.log(LOGO);
-    const config = loadConfig();
-
-    if (!fs.existsSync(opts.prd)) {
-      console.log(chalk.red(`PRD not found: ${opts.prd}`)); process.exit(1);
-    }
-    if (!fs.existsSync(opts.project)) {
-      console.log(chalk.red(`Project not found: ${opts.project}`)); process.exit(1);
-    }
+// ─────────────────────────────────────────────────────────────────
+// Team selection prompt
+// ─────────────────────────────────────────────────────────────────
+const TEAMS = [
+  { label: '🧑‍💻  Solo Dev    ', desc: '1 agente, enfocado, bajo costo de tokens',          maxAgents: 1 },
+  { label: '👥  Small Team  ', desc: '3 agentes (Lead + 2 especialistas)',                  maxAgents: 3 },
+  { label: '🚀  Full Team   ', desc: '6 agentes (Lead + 5 especialistas)',                  maxAgents: 6 },
+  { label: '🏭  Enterprise  ', desc: '9 agentes (Lead + 8 especialistas, máx paralelismo)', maxAgents: 9 },
+];
+
+function drawMenu(teams, selected, lineCount) {
+  const lines = [chalk.bold('? ') + 'Seleccioná tu equipo de agentes:'];
+  for (let i = 0; i < teams.length; i++) {
+    const t = teams[i];
+    const cursor = i === selected ? chalk.cyan('❯') : ' ';
+    const label  = i === selected ? chalk.bold(t.label) : chalk.dim(t.label);
+    lines.push(`  ${cursor} ${label}  ${chalk.dim(t.desc)}`);
+  }
+  if (lineCount > 0) process.stdout.write(`\x1b[${lineCount}A\x1b[0J`);
+  process.stdout.write(lines.join('\n') + '\n');
+  return lines.length;
+}
 
-    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}`));
-    if (opts.restart) console.log(chalk.yellow(`  Mode      → FORCE RESTART\n`));
-    else console.log(chalk.dim(`  Mode      → auto-resume if tasks exist\n`));
-
-    // ── Verify Claude Code CLI is installed ───────────────────────────────────
-    const { execSync } = await import("child_process");
-    const { resolveClaudePath, installHint } = await import("../agents/claude-resolver.js");
-    const claudePath = resolveClaudePath();
-    if (!claudePath) {
-      console.log(chalk.red("\n  ✗ Claude Code CLI not found!\n"));
-      for (const line of installHint().split("\n")) {
-        console.log(chalk.yellow(`  ${line}`));
+function promptTeamSelection(skipMaxAgents) {
+  if (skipMaxAgents !== undefined || !process.stdin.isTTY) return Promise.resolve(null);
+
+  return new Promise((resolve) => {
+    let selected  = 0;
+    let lineCount = drawMenu(TEAMS, selected, 0);
+
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    function onKey(key) {
+      if      (key === '\x1b[A') { selected = Math.max(0, selected - 1); lineCount = drawMenu(TEAMS, selected, lineCount); }
+      else if (key === '\x1b[B') { selected = Math.min(TEAMS.length - 1, selected + 1); lineCount = drawMenu(TEAMS, selected, lineCount); }
+      else if (key === '\r' || key === '\n') {
+        process.stdin.removeListener('data', onKey);
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write(`\x1b[${lineCount}A\x1b[0J`);
+        const team = TEAMS[selected];
+        process.stdout.write(chalk.bold('✔ ') + 'Equipo: ' + chalk.cyan(team.label.trim()) + chalk.dim('  — ' + team.desc) + '\n');
+        resolve(team);
+      } else if (key === '\x03') {
+        process.stdin.setRawMode(false);
+        process.exit(0);
       }
-      console.log();
-      process.exit(1);
     }
-    try {
-      const version = execSync(`"${claudePath}" --version`, { stdio: "pipe" }).toString().trim();
-      console.log(chalk.dim(`  Claude Code → ${version}  (${claudePath})\n`));
-    } catch {
-      console.log(chalk.dim(`  Claude Code → ${claudePath}\n`));
-    }
-
-    const resolvedProject = path.resolve(opts.project);
-
-    // Persist the project path so `claudeboard start` uses the right directory for Expo
-    const configPath = path.join(process.cwd(), ".claudeboard.json");
-    try {
-      const saved = JSON.parse(fs.readFileSync(configPath, "utf8"));
-      saved.projectDir = resolvedProject;
-      fs.writeFileSync(configPath, JSON.stringify(saved, null, 2));
-    } catch {}
-
-    const { runOrchestrator } = await import("../agents/orchestrator.js");
-
-    await runOrchestrator({
-      prdPath: path.resolve(opts.prd),
-      projectPath: resolvedProject,
-      supabaseUrl: config.supabaseUrl,
-      supabaseKey: config.supabaseKey,
-      projectName: config.projectName,
-      expoPort: parseInt(opts.expoPort),
-      forceRestart: !!opts.restart,
-      useIOS: !!opts.ios,
-    });
+    process.stdin.on('data', onKey);
   });
+}
 
-// ─── IMPORT PRD ──────────────────────────────────────────────────────────────
-program
-  .command("import-prd <file>")
-  .description("Parse PRD → create tasks in board (no agents run)")
-  .action(async (file) => {
-    console.log(LOGO);
-    const config = loadConfig();
+// ─────────────────────────────────────────────────────────────────
+// claudeboard start  (default when no subcommand)
+// ─────────────────────────────────────────────────────────────────
+async function runStart(rawArgs) {
+  // Parse simple flags: --port, --open, --webhook, --max-agents
+  const args    = rawArgs || [];
+  const getFlag = (name, shortName, def) => {
+    const longIdx  = args.indexOf(`--${name}`);
+    const shortIdx = shortName ? args.indexOf(`-${shortName}`) : -1;
+    const idx = longIdx !== -1 ? longIdx : shortIdx;
+    if (idx !== -1 && args[idx + 1] !== undefined) return args[idx + 1];
+    // --name=value form
+    const pair = args.find(a => a.startsWith(`--${name}=`));
+    if (pair) return pair.split('=')[1];
+    return def;
+  };
+  const flagExists = (name) => args.includes(`--${name}`);
+
+  const port        = parseInt(getFlag('port', 'p', '3000'), 10) || 3000;
+  const openBrowser = getFlag('open', null, 'true') !== 'false';
+  const webhook     = getFlag('webhook', null, null);
+  const maxAgentsRaw = getFlag('max-agents', null, undefined);
+
+  // ── Auto-init if .claudeboard/ doesn't exist ──────────────────
+  const cwd = process.cwd();
+  const boardDir = path.join(cwd, '.claudeboard');
+  if (!fs.existsSync(boardDir)) {
+    console.log(chalk.dim('No se encontró .claudeboard/ — inicializando automáticamente…'));
+    console.log('');
+    runInit();
+  }
 
-    if (!fs.existsSync(file)) {
-      console.log(chalk.red(`File not found: ${file}`)); process.exit(1);
-    }
+  header();
+  console.log(chalk.dim('Proyecto: ') + chalk.cyan(path.basename(cwd)) + chalk.dim('  (' + cwd + ')'));
+  console.log('');
 
-    const prdContent = fs.readFileSync(file, "utf8");
-    const { initBoard } = await import("../agents/board-client.js");
-    const { runArchitectAgent } = await import("../agents/architect.js");
+  const team = await promptTeamSelection(maxAgentsRaw);
+  const maxAgents = maxAgentsRaw !== undefined
+    ? (parseInt(maxAgentsRaw, 10) || 1)
+    : (team ? team.maxAgents : 1);
 
-    initBoard(config.supabaseUrl, config.supabaseKey, config.projectName);
-    const result = await runArchitectAgent(prdContent, config.projectName);
+  // Store minimal config (no projectPath — it's always process.cwd())
+  const { setConfig } = require(path.join(__dirname, '..', 'src', 'store'));
+  if (webhook) setConfig({ webhook });
 
-    console.log(chalk.green(`\n  ✓ Created ${result.totalTasks} tasks across ${result.epics.length} epics`));
-    console.log(`\n  Run ${chalk.bold("claudeboard start")} to see your board.\n`);
-  });
+  console.log('');
+  console.log(chalk.dim(`Iniciando en puerto ${port}…`));
+  console.log('');
 
-// ─── STATUS ──────────────────────────────────────────────────────────────────
-program
-  .command("status")
-  .description("Show current board status in terminal")
-  .action(async () => {
-    const config = loadConfig();
-    const { initBoard, getStats } = await import("../agents/board-client.js");
-    initBoard(config.supabaseUrl, config.supabaseKey, config.projectName);
-
-    const stats = await getStats();
-    const bar = "█".repeat(Math.floor(stats.pct / 5)) + "░".repeat(20 - Math.floor(stats.pct / 5));
-
-    console.log(LOGO);
-    console.log(chalk.bold(`  ${config.projectName}\n`));
-    console.log(`  [${chalk.green(bar)}] ${chalk.bold(stats.pct + "%")}`);
-    console.log(`\n  ${chalk.green("✓ Done:")}     ${stats.done}`);
-    console.log(`  ${chalk.yellow("◌ Running:")}  ${stats.in_progress}`);
-    console.log(`  ${chalk.dim("○ Todo:")}     ${stats.todo}`);
-    console.log(`  ${chalk.red("✗ Error:")}    ${stats.error}\n`);
-  });
+  const { createServer } = require(path.join(__dirname, '..', 'src', 'server'));
+  createServer({ port, maxAgents, webhook, openBrowser });
 
-program
-  .name("claudeboard")
-  .description("AI engineering team — from PRD to working app, autonomously — powered by High Value, LLC")
-  .version(_pkg.version);
+  console.log(chalk.dim('Ctrl+C para detener'));
+}
 
-program.parse();
+// ─────────────────────────────────────────────────────────────────
+// Entry point — dispatch subcommand
+// ─────────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const subcommand = args[0];
+
+if (subcommand === '--version' || subcommand === '-v') {
+  console.log(PKG_VERSION);
+} else if (subcommand === '--help' || subcommand === '-h') {
+  console.log(chalk.bold.hex('#e3c69a')('ClaudeBoard v3 ✦') + chalk.dim('  v' + PKG_VERSION));
+  console.log('');
+  console.log(chalk.bold('Uso:'));
+  console.log('  claudeboard init        Inicializa .claudeboard/ en el proyecto actual');
+  console.log('  claudeboard             Inicia el board (en el directorio actual)');
+  console.log('');
+  console.log(chalk.bold('Opciones de start:'));
+  console.log('  -p, --port <n>          Puerto (default: 3000)');
+  console.log('  --max-agents <n>        Cantidad de agentes paralelos (evita el prompt)');
+  console.log('  --open false            No abrir el browser automáticamente');
+  console.log('  --webhook <url>         URL de webhook para notificaciones');
+  console.log('');
+  console.log(chalk.bold('Ejemplo — múltiples proyectos en simultáneo:'));
+  console.log(chalk.dim('  cd ~/projects/app-a && claudeboard --port 3000'));
+  console.log(chalk.dim('  cd ~/projects/app-b && claudeboard --port 3001'));
+} else if (subcommand === 'init') {
+  runInit();
+} else if (!subcommand || subcommand === 'start' || subcommand.startsWith('-')) {
+  // No subcommand or "start" or flags → default to start
+  runStart(args.filter(a => a !== 'start'));
+} else {
+  console.log(chalk.red(`Subcomando desconocido: "${subcommand}"`));
+  console.log(chalk.dim('Corré `claudeboard --help` para ver los comandos disponibles.'));
+  process.exit(1);
+}

package/bin/init-context.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+// bin/init-context.js — copies context template to .claudeboard/context.md in the current project
+const fs = require('fs');
+const path = require('path');
+
+const targetDir = path.join(process.cwd(), '.claudeboard');
+const targetFile = path.join(targetDir, 'context.md');
+const templateFile = path.join(__dirname, '..', 'src', 'context-template.md');
+
+if (!fs.existsSync(targetDir)) {
+  fs.mkdirSync(targetDir, { recursive: true });
+}
+
+if (fs.existsSync(targetFile)) {
+  console.log(`Already exists: ${targetFile}`);
+  console.log('Edit it directly to customize your project context.');
+  process.exit(0);
+}
+
+fs.copyFileSync(templateFile, targetFile);
+console.log(`Created: ${targetFile}`);
+console.log('Edit .claudeboard/context.md to add your project brand guidelines and design tokens.');

package/package.json

@@ -1,57 +1,36 @@
 {
   "name": "claudeboard",
-  "version": "2.15.4",
-  "description": "AI engineering team — from PRD to working mobile app, autonomously",
-  "type": "module",
+  "version": "3.1.0",
+  "description": "Visual orchestrator for Claude Code agent teams",
   "bin": {
-    "claudeboard": "./bin/cli.js"
+    "claudeboard": "bin/cli.js"
   },
   "files": [
     "bin/",
-    "dashboard/",
-    "agents/",
-    "tools/",
-    "sql/",
+    "src/",
+    "public/",
     "README.md"
   ],
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "latest",
-    "@supabase/supabase-js": "^2.43.1",
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "cors": "^2.8.5",
-    "dotenv": "^16.4.5",
-    "enquirer": "^2.4.1",
-    "express": "^4.18.3",
-    "node-pty": "^1.0.0",
-    "open": "^10.1.0",
-    "ora": "^8.0.1",
-    "puppeteer": "^22.8.0",
-    "ws": "^8.17.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
+  "scripts": {
+    "start": "node bin/cli.js"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/highvaluedigital/claudeboard"
-  },
-  "author": "highvaluedigital",
-  "license": "MIT",
   "keywords": [
     "claude",
     "ai",
-    "agent",
-    "coding",
-    "automation",
+    "orchestrator",
+    "agents",
     "dashboard",
-    "mobile",
-    "expo",
-    "react-native",
-    "prd",
-    "engineering"
-  ]
+    "kanban"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^12.0.0",
+    "express": "^4.18.2",
+    "open": "^10.1.0",
+    "ws": "^8.16.0"
+  }
 }