ai-sprint-kit 2.1.45 → 2.1.48

package/README.md

@@ -6,11 +6,11 @@
 
 ## What is AI Sprint?
 
-AI Sprint transforms Claude Code into a team of **12 specialized AI agents** with **17 powerful commands**. Build production-grade software with security-first, autonomous development.
+AI Sprint transforms Claude Code into a team of **15 specialized AI agents** with **21 powerful commands**. Build production-grade software with security-first, autonomous development.
 
 **Features:**
-- 12 AI Agents (planner, implementer, tester, reviewer, security, devops, docs, debugger, researcher, verifier, browser-tester, deployment-smoke)
-- 17 Slash Commands for full development lifecycle
+- 15 AI Agents (prd-writer, business-analyst, architect, planner, implementer, tester, reviewer, security, devops, docs, debugger, researcher, verifier, browser-tester, deployment-smoke)
+- 21 Slash Commands for full development lifecycle
 - Automation Hooks (auto-format, lint-check, sound notifications)
 - Memory System for persistent context
 - Security-First with built-in SAST, secrets scanning, dependency audit

package/bin/ai-sprint.js

@@ -16,7 +16,12 @@ const {
   copyProContent,
   createAiContextStructure,
   cleanup,
-  checkExisting
+  checkExisting,
+  commandExists,
+  installBun,
+  installRalphTui,
+  checkRalphTui,
+  setupRalphTuiConfig
 } = require('../lib/installer');
 const {
   validateInstallation,
@@ -61,6 +66,62 @@ function question(prompt) {
   });
 }
 
+// Shared function for ralph-tui installation with UI feedback
+// Returns: { success: boolean, bunInstalled: boolean, ralphInstalled: boolean }
+async function installRalphTuiWithUI(targetDir, options = {}) {
+  const { exitOnFail = false } = options;
+
+  // Check if bun is installed
+  const bunSpinner = ora('Checking Bun runtime...').start();
+  const hasBun = await commandExists('bun');
+
+  if (!hasBun) {
+    bunSpinner.text = 'Installing Bun runtime...';
+    const bunInstalled = await installBun();
+    if (bunInstalled) {
+      bunSpinner.succeed('Bun runtime installed');
+    } else {
+      if (exitOnFail) {
+        bunSpinner.fail('Bun installation failed');
+        console.log(chalk.yellow('\nInstall manually: curl -fsSL https://bun.sh/install | bash\n'));
+        process.exit(1);
+      } else {
+        bunSpinner.warn('Bun installation failed. Install manually: curl -fsSL https://bun.sh/install | bash');
+        return { success: false, bunInstalled: false, ralphInstalled: false };
+      }
+    }
+  } else {
+    bunSpinner.succeed('Bun runtime found');
+  }
+
+  // Install ralph-tui
+  const ralphSpinner = ora('Installing ralph-tui...').start();
+  const hasRalph = await checkRalphTui();
+
+  if (!hasRalph) {
+    const ralphInstalled = await installRalphTui();
+    if (ralphInstalled) {
+      ralphSpinner.succeed('ralph-tui installed');
+    } else {
+      if (exitOnFail) {
+        ralphSpinner.fail('ralph-tui installation failed');
+        console.log(chalk.yellow('\nInstall manually: bun install -g ralph-tui\n'));
+        process.exit(1);
+      } else {
+        ralphSpinner.warn('ralph-tui installation failed. Install manually: bun install -g ralph-tui');
+        return { success: false, bunInstalled: true, ralphInstalled: false };
+      }
+    }
+  } else {
+    ralphSpinner.succeed('ralph-tui already installed');
+  }
+
+  // Setup project config
+  await setupRalphTuiConfig(targetDir);
+
+  return { success: true, bunInstalled: !hasBun, ralphInstalled: !hasRalph };
+}
+
 program
   .name('ai-sprint')
   .description('AI Sprint - Autonomous development framework for Claude Code')
@@ -199,6 +260,26 @@ program
       } else {
         console.log(chalk.gray('\nRun later: ai-sprint setup-mcp\n'));
       }
+
+      // Ask if user wants to install ralph-tui for autonomous loops
+      console.log(chalk.cyan('🔄 Ralph TUI - Autonomous Agent Loop (Optional)\n'));
+      console.log(chalk.gray('Ralph TUI runs AI agents autonomously through task lists'));
+      console.log(chalk.gray('with session persistence, TUI dashboard, and crash recovery.\n'));
+
+      const setupRalph = await question('Install ralph-tui now? (Y/n): ');
+      if (setupRalph.toLowerCase() !== 'n') {
+        console.log();
+        const result = await installRalphTuiWithUI(targetDir, { exitOnFail: false });
+        if (result.success) {
+          console.log(chalk.green('\n✅ ralph-tui configured\n'));
+          console.log(chalk.cyan('Quick start:'));
+          console.log(chalk.gray('  1. Create PRD:  ralph-tui create-prd --chat'));
+          console.log(chalk.gray('  2. Run loop:    ralph-tui run --prd ./prd.json'));
+          console.log(chalk.gray('  3. Check docs:  https://ralph-tui.com/docs\n'));
+        }
+      } else {
+        console.log(chalk.gray('\nRun later: ai-sprint setup-ralph\n'));
+      }
     } catch (error) {
       progress.failStep(2, error.message);
       cloneSpinner.fail('Installation failed');
@@ -216,19 +297,24 @@ program
   .description('Show AI Sprint Pro features')
   .action(() => {
     console.log(chalk.blue.bold('\nAI Sprint Pro Framework\n'));
-    console.log(chalk.cyan('Agents (12):'));
-    console.log(chalk.gray('  planner, implementer, tester, reviewer, security'));
-    console.log(chalk.gray('  devops, docs, debugger, researcher, verifier'));
+    console.log(chalk.cyan('Agents (15):'));
+    console.log(chalk.gray('  prd-writer, business-analyst, architect, planner'));
+    console.log(chalk.gray('  implementer, tester, reviewer, security, devops'));
+    console.log(chalk.gray('  docs, debugger, researcher, verifier'));
     console.log(chalk.gray('  browser-tester, deployment-smoke'));
-    console.log(chalk.cyan('\nCommands (15):'));
-    console.log(chalk.gray('  /ai-sprint-plan, /ai-sprint-code, /ai-sprint-test'));
-    console.log(chalk.gray('  /ai-sprint-review, /ai-sprint-secure, /ai-sprint-deploy'));
-    console.log(chalk.gray('  /ai-sprint-docs, /ai-sprint-debug, /ai-sprint-scan'));
-    console.log(chalk.gray('  /ai-sprint-validate, /ai-sprint-browser-test'));
-    console.log(chalk.gray('  /ai-sprint-orchestrate, /ai-sprint-setup, /ai-sprint-auto'));
+    console.log(chalk.cyan('\nCommands (20):'));
+    console.log(chalk.gray('  /ai-sprint-prd, /ai-sprint-analyze, /ai-sprint-architect'));
+    console.log(chalk.gray('  /ai-sprint-init, /ai-sprint-plan, /ai-sprint-code'));
+    console.log(chalk.gray('  /ai-sprint-test, /ai-sprint-review, /ai-sprint-secure'));
+    console.log(chalk.gray('  /ai-sprint-deploy, /ai-sprint-docs, /ai-sprint-debug'));
+    console.log(chalk.gray('  /ai-sprint-fix, /ai-sprint-scan, /ai-sprint-validate'));
+    console.log(chalk.gray('  /ai-sprint-browser-test, /ai-sprint-orchestrate'));
+    console.log(chalk.gray('  /ai-sprint-setup, /ai-sprint-auto, /ai-sprint-full-cycle'));
+    console.log(chalk.cyan('\nAutonomous Loop:'));
+    console.log(chalk.gray('  ralph-tui (external) - https://ralph-tui.com'));
     console.log(chalk.cyan('\nCLI Commands:'));
     console.log(chalk.gray('  init, list, validate, doctor, update, check-update'));
-    console.log(chalk.gray('  setup-env, setup-mcp, repair, reinstall, init-ci\n'));
+    console.log(chalk.gray('  setup-env, setup-mcp, setup-ralph, repair, reinstall, init-ci\n'));
   });
 
 program
@@ -530,6 +616,28 @@ program
     }
   });
 
+program
+  .command('setup-ralph')
+  .description('Install and configure ralph-tui for autonomous loops')
+  .option('-d, --dir <directory>', 'Target directory', process.cwd())
+  .action(async (options) => {
+    console.log(chalk.blue.bold('\n🔄 Ralph TUI Setup\n'));
+
+    // Use shared installation function (exits on failure)
+    await installRalphTuiWithUI(options.dir, { exitOnFail: true });
+
+    console.log(chalk.green.bold('\n✅ ralph-tui configured\n'));
+    console.log(chalk.cyan('Quick start:'));
+    console.log(chalk.gray('  1. Create PRD:  ralph-tui create-prd --chat'));
+    console.log(chalk.gray('  2. Run loop:    ralph-tui run --prd ./prd.json'));
+    console.log(chalk.gray('  3. Check docs:  https://ralph-tui.com/docs\n'));
+
+    console.log(chalk.cyan('AI Sprint integration:'));
+    console.log(chalk.gray('  • Custom skill:    ai_context/ralph-tui/skills/ai-sprint-prd/'));
+    console.log(chalk.gray('  • Custom template: ai_context/ralph-tui/ai-sprint-template.hbs'));
+    console.log(chalk.gray('  • Config:          .ralph-tui/config.toml\n'));
+  });
+
 program
   .command('reinstall')
   .description('Clean reinstall AI Sprint Kit')

package/lib/installer.js

@@ -35,7 +35,9 @@ async function copyProContent(sourceDir, targetDir, force = false) {
   const items = [
     { src: '.claude', dest: '.claude' },
     // ai_context is NOT copied - preserve user's plans, reports, memory
-    { src: 'CLAUDE.md', dest: 'CLAUDE.md' },
+    // EXCEPT ralph-tui config which contains skills and templates for ralph-tui integration
+    { src: 'ai_context/ralph-tui', dest: 'ai_context/ralph-tui' },
+    // CLAUDE.md handled specially below - append instead of replace
     { src: 'README.md', dest: 'AI-SPRINT-README.md' },
     { src: 'docs', dest: '.claude/docs' },
     { src: 'scripts', dest: '.claude/scripts' }
@@ -61,6 +63,47 @@ async function copyProContent(sourceDir, targetDir, force = false) {
 
     await fs.cp(srcPath, destPath, { recursive: true, force: true });
   }
+
+  // Handle CLAUDE.md specially - append if exists, create if not
+  await handleClaudeMd(sourceDir, targetDir);
+}
+
+/**
+ * Handle CLAUDE.md - append AI Sprint content if file exists, create if not
+ * @param {string} sourceDir - Cloned repo path
+ * @param {string} targetDir - User's project directory
+ */
+async function handleClaudeMd(sourceDir, targetDir) {
+  const srcPath = path.join(sourceDir, 'CLAUDE.md');
+  const destPath = path.join(targetDir, 'CLAUDE.md');
+
+  try {
+    await fs.access(srcPath);
+  } catch {
+    return; // Source doesn't exist, skip
+  }
+
+  const aiSprintContent = await fs.readFile(srcPath, 'utf-8');
+  const separator = '\n\n---\n\n# AI Sprint Kit Framework\n\n';
+
+  try {
+    // Check if CLAUDE.md exists
+    const existingContent = await fs.readFile(destPath, 'utf-8');
+
+    // Check if AI Sprint content already added
+    if (existingContent.includes('# AI Sprint Kit Framework') ||
+        existingContent.includes('AI Sprint - Security-first')) {
+      // Already has AI Sprint content, skip
+      return;
+    }
+
+    // Append AI Sprint content to existing file
+    const mergedContent = existingContent.trimEnd() + separator + aiSprintContent;
+    await fs.writeFile(destPath, mergedContent);
+  } catch {
+    // CLAUDE.md doesn't exist, create new
+    await fs.copyFile(srcPath, destPath);
+  }
 }
 
 /**
@@ -74,7 +117,9 @@ async function createAiContextStructure(targetDir) {
     'plans',
     'reports',
     'codebase',
-    'memory'
+    'memory',
+    'ralph-tui',
+    'ralph-tui/sessions'
   ];
 
   for (const dir of dirs) {
@@ -132,10 +177,114 @@ async function checkExisting(targetDir) {
   }
 }
 
+/**
+ * Check if a command exists
+ * @param {string} cmd - Command to check
+ * @returns {Promise<boolean>}
+ */
+async function commandExists(cmd) {
+  try {
+    await execFileAsync('which', [cmd]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Install Bun runtime
+ * @returns {Promise<boolean>} - Whether installation succeeded
+ */
+async function installBun() {
+  try {
+    // Use curl to install bun
+    const { exec } = require('child_process');
+    const { promisify } = require('util');
+    const execAsync = promisify(exec);
+
+    await execAsync('curl -fsSL https://bun.sh/install | bash');
+
+    // Check if bun is now available
+    const bunPath = path.join(process.env.HOME, '.bun', 'bin', 'bun');
+    try {
+      await fs.access(bunPath);
+      return true;
+    } catch {
+      return false;
+    }
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Install ralph-tui globally via bun
+ * @returns {Promise<boolean>} - Whether installation succeeded
+ */
+async function installRalphTui() {
+  try {
+    // Try system bun first
+    let bunCmd = 'bun';
+    if (!await commandExists('bun')) {
+      // Try home directory bun
+      bunCmd = path.join(process.env.HOME, '.bun', 'bin', 'bun');
+      try {
+        await fs.access(bunCmd);
+      } catch {
+        return false;
+      }
+    }
+
+    await execFileAsync(bunCmd, ['install', '-g', 'ralph-tui']);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if ralph-tui is installed
+ * @returns {Promise<boolean>}
+ */
+async function checkRalphTui() {
+  return commandExists('ralph-tui');
+}
+
+/**
+ * Setup ralph-tui configuration in project
+ * @param {string} targetDir - User's project directory
+ */
+async function setupRalphTuiConfig(targetDir) {
+  const ralphTuiDir = path.join(targetDir, '.ralph-tui');
+  const configSource = path.join(targetDir, 'ai_context', 'ralph-tui', 'config.toml');
+  const configDest = path.join(ralphTuiDir, 'config.toml');
+
+  // Create .ralph-tui directory
+  await fs.mkdir(ralphTuiDir, { recursive: true });
+
+  // Copy config if source exists and dest doesn't
+  try {
+    await fs.access(configSource);
+    try {
+      await fs.access(configDest);
+      // Config exists, don't overwrite
+    } catch {
+      await fs.copyFile(configSource, configDest);
+    }
+  } catch {
+    // Source doesn't exist, skip
+  }
+}
+
 module.exports = {
   cloneProRepo,
   copyProContent,
   createAiContextStructure,
   cleanup,
-  checkExisting
+  checkExisting,
+  commandExists,
+  installBun,
+  installRalphTui,
+  checkRalphTui,
+  setupRalphTuiConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sprint-kit",
-  "version": "2.1.45",
+  "version": "2.1.48",
   "description": "CLI installer for AI Sprint autonomous development framework - requires license",
   "main": "lib/installer.js",
   "bin": {