beth-copilot 1.0.3 → 1.0.5

package/bin/cli.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'url';
 import { dirname, join, relative } from 'path';
 import { existsSync, mkdirSync, readdirSync, statSync, copyFileSync, readFileSync, writeFileSync } from 'fs';
 import { createRequire } from 'module';
+import { execSync, spawn } from 'child_process';
 
 const require = createRequire(import.meta.url);
 const __filename = fileURLToPath(import.meta.url);
@@ -74,6 +75,131 @@ async function checkForUpdates() {
   }
 }
 
+function isBacklogCliInstalled() {
+  try {
+    execSync('backlog --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isBeadsInstalled() {
+  try {
+    execSync('bd --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isBeadsInitialized(cwd) {
+  // Check if .beads directory exists in the project
+  return existsSync(join(cwd, '.beads'));
+}
+
+async function promptYesNo(question) {
+  const readline = await import('readline');
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  
+  return new Promise((resolve) => {
+    rl.question(`${question} (y/N) `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+async function installBacklogCli() {
+  log('\nInstalling backlog.md CLI...', COLORS.cyan);
+  
+  return new Promise((resolve) => {
+    const child = spawn('npm', ['install', '-g', 'backlog.md'], {
+      stdio: 'inherit',
+      shell: true
+    });
+    
+    child.on('close', (code) => {
+      if (code === 0) {
+        logSuccess('backlog.md CLI installed successfully!');
+        resolve(true);
+      } else {
+        logWarning('Failed to install backlog.md CLI. You can install it manually:');
+        logInfo('npm i -g backlog.md');
+        logInfo('  or');
+        logInfo('bun i -g backlog.md');
+        resolve(false);
+      }
+    });
+    
+    child.on('error', () => {
+      logWarning('Failed to install backlog.md CLI. You can install it manually:');
+      logInfo('npm i -g backlog.md');
+      resolve(false);
+    });
+  });
+}
+
+async function installBeads() {
+  log('\nInstalling beads CLI...', COLORS.cyan);
+  logInfo('curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash');
+  
+  return new Promise((resolve) => {
+    const child = spawn('bash', ['-c', 'curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash'], {
+      stdio: 'inherit',
+      shell: true
+    });
+    
+    child.on('close', (code) => {
+      if (code === 0) {
+        logSuccess('beads CLI installed successfully!');
+        resolve(true);
+      } else {
+        logError('Failed to install beads CLI.');
+        logInfo('Install manually: curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash');
+        logInfo('Learn more: https://github.com/steveyegge/beads');
+        resolve(false);
+      }
+    });
+    
+    child.on('error', () => {
+      logError('Failed to install beads CLI.');
+      logInfo('Install manually: curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash');
+      resolve(false);
+    });
+  });
+}
+
+async function initializeBeads(cwd) {
+  log('\nInitializing beads in project...', COLORS.cyan);
+  
+  return new Promise((resolve) => {
+    const child = spawn('bd', ['init'], {
+      stdio: 'inherit',
+      shell: true,
+      cwd
+    });
+    
+    child.on('close', (code) => {
+      if (code === 0) {
+        logSuccess('beads initialized successfully!');
+        resolve(true);
+      } else {
+        logWarning('Failed to initialize beads. Run manually: bd init');
+        resolve(false);
+      }
+    });
+    
+    child.on('error', () => {
+      logWarning('Failed to initialize beads. Run manually: bd init');
+      resolve(false);
+    });
+  });
+}
+
 function showHelp() {
   console.log(`
 ${COLORS.bright}Beth${COLORS.reset} - AI Orchestrator for GitHub Copilot
@@ -86,6 +212,7 @@ ${COLORS.bright}Options:${COLORS.reset}
   --force                             Overwrite existing files
   --skip-backlog                      Don't create Backlog.md
   --skip-mcp                          Don't create mcp.json.example
+  --skip-beads                        Skip beads check (not recommended)
 
 ${COLORS.bright}Examples:${COLORS.reset}
   npx beth-copilot init               Set up Beth in current project
@@ -95,14 +222,15 @@ ${COLORS.bright}What gets installed:${COLORS.reset}
   .github/agents/                     8 specialized AI agents
   .github/skills/                     6 domain knowledge modules
   .github/copilot-instructions.md     Copilot configuration
+  .vscode/settings.json               Recommended VS Code settings
   AGENTS.md                           Workflow documentation
   Backlog.md                          Task tracking file
   mcp.json.example                    Optional MCP server config
 
 ${COLORS.bright}After installation:${COLORS.reset}
   1. Open project in VS Code
-  2. Enable Agent mode in Copilot Chat
-  3. Type @Beth and tell her what you need
+  2. Open Copilot Chat (Ctrl+Alt+I / Cmd+Alt+I)
+  3. Type @Beth to start working
 
 ${COLORS.bright}Documentation:${COLORS.reset}
   https://github.com/stephschofield/beth
@@ -139,7 +267,7 @@ function copyDirRecursive(src, dest, options = {}) {
 }
 
 async function init(options = {}) {
-  const { force = false, skipBacklog = false, skipMcp = false } = options;
+  const { force = false, skipBacklog = false, skipMcp = false, skipBeads = false } = options;
   const cwd = process.cwd();
   
   // Check for updates
@@ -218,6 +346,28 @@ ${COLORS.cyan}"I don't do excuses. I do results."${COLORS.reset}
     }
   }
 
+  // Copy .vscode/settings.json (recommended settings for agent mode)
+  const vscodeSrc = join(TEMPLATES_DIR, '.vscode');
+  const vscodeDest = join(cwd, '.vscode');
+  
+  if (existsSync(vscodeSrc)) {
+    if (!existsSync(vscodeDest)) {
+      mkdirSync(vscodeDest, { recursive: true });
+    }
+    
+    const settingsSrc = join(vscodeSrc, 'settings.json');
+    const settingsDest = join(vscodeDest, 'settings.json');
+    
+    if (existsSync(settingsSrc)) {
+      if (existsSync(settingsDest) && !force) {
+        logWarning('Skipped (exists): .vscode/settings.json');
+      } else {
+        copyFileSync(settingsSrc, settingsDest);
+        copiedFiles.push('.vscode/settings.json');
+      }
+    }
+  }
+
   // Summary
   console.log('');
   if (copiedFiles.length > 0) {
@@ -227,13 +377,77 @@ ${COLORS.cyan}"I don't do excuses. I do results."${COLORS.reset}
     logWarning('No files were copied. Use --force to overwrite existing files.');
   }
 
+  // Check for beads CLI (REQUIRED for Beth)
+  if (!skipBeads) {
+    console.log('');
+    log('Checking beads (required for task tracking)...', COLORS.cyan);
+    
+    if (!isBeadsInstalled()) {
+      logWarning('beads CLI is not installed.');
+      logInfo('Beth requires beads for task tracking. Agents use it to coordinate work.');
+      logInfo('Learn more: https://github.com/steveyegge/beads');
+      console.log('');
+      
+      const shouldInstallBeads = await promptYesNo('Install beads CLI now? (required)');
+      if (shouldInstallBeads) {
+        const installed = await installBeads();
+        if (!installed) {
+          logError('beads installation failed. Beth requires beads to function.');
+          logInfo('Install manually and run "beth init" again.');
+          process.exit(1);
+        }
+      } else {
+        logError('beads is required for Beth to function.');
+        logInfo('Install beads and run "beth init" again:');
+        logInfo('  curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash');
+        process.exit(1);
+      }
+    } else {
+      logSuccess('beads CLI is installed');
+    }
+    
+    // Initialize beads in the project if not already done
+    if (!isBeadsInitialized(cwd)) {
+      logInfo('beads not initialized in this project.');
+      const shouldInitBeads = await promptYesNo('Initialize beads now?');
+      if (shouldInitBeads) {
+        await initializeBeads(cwd);
+      } else {
+        logWarning('Remember to run "bd init" before using Beth.');
+      }
+    } else {
+      logSuccess('beads is initialized in this project');
+    }
+  } else {
+    logWarning('Skipped beads check (--skip-beads). Beth may not function correctly.');
+  }
+
+  // Check for backlog.md CLI (optional)
+  if (!skipBacklog && !isBacklogCliInstalled()) {
+    console.log('');
+    logWarning('backlog.md CLI is not installed (optional).');
+    logInfo('The CLI provides TUI boards, web UI, and task management commands.');
+    logInfo('Learn more: https://github.com/MrLesk/Backlog.md');
+    console.log('');
+    
+    const shouldInstall = await promptYesNo('Would you like to install the backlog.md CLI globally?');
+    if (shouldInstall) {
+      await installBacklogCli();
+    } else {
+      logInfo('Skipped. You can install it later with: npm i -g backlog.md');
+    }
+  } else if (!skipBacklog) {
+    logSuccess('backlog.md CLI is already installed');
+  }
+
   // Next steps
   console.log(`
 ${COLORS.bright}Next steps:${COLORS.reset}
   1. Open this project in VS Code
-  2. Ensure GitHub Copilot + Copilot Chat are installed
-  3. Switch to ${COLORS.cyan}Agent mode${COLORS.reset} in Copilot Chat
-  4. Type ${COLORS.cyan}@Beth${COLORS.reset} and tell her what you need
+  2. Open Copilot Chat (${COLORS.cyan}Ctrl+Alt+I${COLORS.reset} / ${COLORS.cyan}Cmd+Alt+I${COLORS.reset})
+  3. Type ${COLORS.cyan}@Beth${COLORS.reset} to start - she's your orchestrator
+
+${COLORS.bright}Pro tip:${COLORS.reset} Start every session with ${COLORS.cyan}@Beth${COLORS.reset} and let her route work to the right specialists.
 
 ${COLORS.bright}Documentation:${COLORS.reset}
   https://github.com/stephschofield/beth
@@ -244,7 +458,7 @@ ${COLORS.cyan}"They broke my wings and forgot I had claws."${COLORS.reset}
 
 // Input validation constants
 const ALLOWED_COMMANDS = ['init', 'help', '--help', '-h'];
-const ALLOWED_FLAGS = ['--force', '--skip-backlog', '--skip-mcp'];
+const ALLOWED_FLAGS = ['--force', '--skip-backlog', '--skip-mcp', '--skip-beads'];
 const MAX_ARG_LENGTH = 50;
 
 // Validate and sanitize input
@@ -273,6 +487,7 @@ const options = {
   force: args.includes('--force'),
   skipBacklog: args.includes('--skip-backlog'),
   skipMcp: args.includes('--skip-mcp'),
+  skipBeads: args.includes('--skip-beads'),
 };
 
 // Validate unknown flags

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beth-copilot",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Beth - A ruthless, hyper-competent AI orchestrator for GitHub Copilot multi-agent workflows",
   "keywords": [
     "github-copilot",

package/templates/.vscode/settings.json

@@ -0,0 +1,16 @@
+{
+  // Beth Agent System - Recommended Settings
+  // These settings enable full agent orchestration capabilities
+
+  // Required: Allow Beth to delegate work to specialist agents
+  "chat.customAgentInSubagent.enabled": true,
+
+  // Enable agent mode in Copilot Chat
+  "chat.agent.enabled": true,
+
+  // Enable thinking/reasoning for complex tasks
+  "github.copilot.chat.agent.thinkingTool": true,
+
+  // Consistent locale for agent responses
+  "github.copilot.chat.localeOverride": "en"
+}

package/templates/AGENTS.md

@@ -1,70 +1,95 @@
-# Agent Instructions
-
-This project uses [Backlog.md](https://github.com/MrLesk/Backlog.md) for issue tracking.
-
-## Quick Setup
-
-```bash
-# Install (choose one)
-bun i -g backlog.md
-npm i -g backlog.md
-brew install backlog-md
-
-# Initialize in your project
-backlog init "Project Name"
-
-# Shell completion (optional)
-backlog completion install
-```
-
-## Quick Reference
-
-```bash
-# Create a task
-backlog task create "Task title" -d "Description"
-
-# List tasks
-backlog task list --plain
-
-# View Kanban board (TUI)
-backlog board
-
-# Web UI
-backlog browser
-
-# Configure settings
-backlog config
-```
-
-## Workflow
-
-1. Check available work: `backlog task list`
-2. Claim work: `backlog task edit <id> --status "In Progress"`
-3. Do the work
-4. Complete: `backlog task edit <id> --status "Done"`
-5. Commit and push
-
-## Landing the Plane (Session Completion)
-
-**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
-
-**MANDATORY WORKFLOW:**
-
-1. **Update Backlog.md** - Move completed tasks, add new items for follow-up work
-2. **Run quality gates** (if code changed) - Tests, linters, builds
-3. **PUSH TO REMOTE** - This is MANDATORY:
-   ```bash
-   git add -A
-   git commit -m "description of work"
-   git pull --rebase
-   git push
-   git status  # MUST show "up to date with origin"
-   ```
-4. **Verify** - All changes committed AND pushed
-5. **Hand off** - Provide context for next session
-
-**CRITICAL RULES:**
-- Work is NOT complete until `git push` succeeds
-- NEVER stop before pushing - that leaves work stranded locally
-- NEVER say "ready to push when you are" - YOU must push
-- If push fails, resolve and retry until it succeeds
+# Agent Instructions
+
+This project uses a **dual tracking system**:
+
+| Tool | Audience | Purpose |
+|------|----------|---------|
+| [beads](https://github.com/steveyegge/beads) (`bd`) | Agents | Active work, dependencies, blockers, structured memory |
+| [Backlog.md](Backlog.md) | Humans | Completed work archive, decisions, readable changelog |
+
+**The rule:** beads is always current. Backlog.md gets updated when work completes.
+
+## Quick Setup
+
+```bash
+# Install beads
+curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
+
+# Initialize in your project
+bd init
+
+# Run doctor to verify setup
+bd doctor
+```
+
+## Quick Reference
+
+```bash
+# Simple task
+bd create "Issue title" --description="What needs to be done" -l in_progress
+
+# Epic for complex work
+bd create "Feature name" --type epic -p 1
+
+# Subtask with parent
+bd create "Subtask" --parent <epic-id>
+
+# Task with dependency
+bd create "Blocked task" --deps "<blocker-id>"
+
+# List issues / see what's ready
+bd list
+bd ready
+
+# View dependencies
+bd dep tree <id>
+
+# Close an issue
+bd close <id>
+```
+
+## Workflow
+
+### Simple Tasks
+1. `bd create "Task" -l in_progress`
+2. Do the work
+3. `bd close <id>`
+4. Update Backlog.md if significant
+5. Commit and push
+
+### Complex Work (Multi-Agent)
+1. `bd create "Feature" --type epic -p 1`
+2. Break into subtasks with `--parent` and `--deps`
+3. `bd ready` to find unblocked work
+4. Route to specialists with issue IDs
+5. Close subtasks as they complete
+6. `bd epic close-eligible` when all children done
+7. Update Backlog.md with summary
+8. Commit and push
+
+## Landing the Plane (Session Completion)
+
+**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
+
+**MANDATORY WORKFLOW:**
+
+1. **Close beads issues** - `bd close <id>` for completed work
+2. **Create follow-up issues** - `bd create` for any remaining work
+3. **Update Backlog.md** - Add summary to Completed section for significant work
+4. **Run quality gates** (if code changed) - Tests, linters, builds
+5. **PUSH TO REMOTE** - This is MANDATORY:
+   ```bash
+   git add -A
+   git commit -m "description of work"
+   git pull --rebase
+   git push
+   git status  # MUST show "up to date with origin"
+   ```
+6. **Verify** - All changes committed AND pushed
+7. **Hand off** - Provide context for next session
+
+**CRITICAL RULES:**
+- Work is NOT complete until `git push` succeeds
+- NEVER stop before pushing - that leaves work stranded locally
+- NEVER say "ready to push when you are" - YOU must push
+- If push fails, resolve and retry until it succeeds