ai-sprint-kit 2.1.63 → 2.1.64

package/README.md

@@ -6,11 +6,11 @@
 
 ## What is AI Sprint?
 
-AI Sprint transforms Claude Code into a team of **16 specialized AI agents** with **22 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:**
-- 16 AI Agents (prd-writer, business-analyst, architect, planner, implementer, tester, reviewer, security, devops, docs, debugger, researcher, verifier, browser-tester, deployment-smoke, tdd-developer)
-- 22 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

@@ -18,10 +18,9 @@ const {
   cleanup,
   checkExisting,
   commandExists,
-  installBun,
-  installRalphTui,
-  checkRalphTui,
-  setupRalphTuiConfig,
+  checkDocker,
+  setupRalphTemplate,
+  checkRalphTemplate,
   installAgentBrowser,
   checkAgentBrowser
 } = require('../lib/installer');
@@ -68,60 +67,39 @@ function question(prompt) {
   });
 }
 
-// Shared function for ralph-tui installation with UI feedback
-// Returns: { success: boolean, bunInstalled: boolean, ralphInstalled: boolean }
-async function installRalphTuiWithUI(targetDir, options = {}) {
+// Shared function for ralph-template setup with UI feedback
+// Returns: { success: boolean, dockerAvailable: boolean }
+async function setupRalphWithUI(targetDir, options = {}) {
   const { exitOnFail = false } = options;
 
-  // Check if bun is installed
-  const bunSpinner = ora('Checking Bun runtime...').start();
-  const hasBun = await commandExists('bun');
+  // Check if Docker is available (optional but recommended)
+  const dockerSpinner = ora('Checking Docker...').start();
+  const hasDocker = await checkDocker();
 
-  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 };
-      }
-    }
+  if (hasDocker) {
+    dockerSpinner.succeed('Docker available (sandbox mode enabled)');
   } else {
-    bunSpinner.succeed('Bun runtime found');
+    dockerSpinner.warn('Docker not found (manual mode only)');
+    console.log(chalk.gray('  Install Docker for sandboxed execution: https://docker.com\n'));
   }
 
-  // Install ralph-tui
-  const ralphSpinner = ora('Installing ralph-tui...').start();
-  const hasRalph = await checkRalphTui();
+  // Setup ralph-template files
+  const setupSpinner = ora('Setting up ralph-template...').start();
+  const setupSuccess = await setupRalphTemplate(targetDir);
 
-  if (!hasRalph) {
-    const ralphInstalled = await installRalphTui();
-    if (ralphInstalled) {
-      ralphSpinner.succeed('ralph-tui installed');
+  if (setupSuccess) {
+    setupSpinner.succeed('ralph-template configured');
+  } else {
+    if (exitOnFail) {
+      setupSpinner.fail('ralph-template setup failed');
+      process.exit(1);
     } 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 };
-      }
+      setupSpinner.warn('ralph-template setup incomplete');
+      return { success: false, dockerAvailable: hasDocker };
     }
-  } else {
-    ralphSpinner.succeed('ralph-tui already installed');
   }
 
-  // Setup project config
-  await setupRalphTuiConfig(targetDir);
-
-  return { success: true, bunInstalled: !hasBun, ralphInstalled: !hasRalph };
+  return { success: true, dockerAvailable: hasDocker };
 }
 
 program
@@ -277,21 +255,21 @@ program
         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'));
+      // Ask if user wants to setup ralph-template for autonomous loops
+      console.log(chalk.cyan('🔄 Ralph Template - Autonomous Agent Loop (Optional)\n'));
+      console.log(chalk.gray('Ralph runs Claude in autonomous loops, completing tasks one-by-one'));
+      console.log(chalk.gray('with Docker sandbox isolation (recommended) or manual mode.\n'));
 
-      const setupRalph = await question('Install ralph-tui now? (Y/n): ');
+      const setupRalph = await question('Setup ralph-template now? (Y/n): ');
       if (setupRalph.toLowerCase() !== 'n') {
         console.log();
-        const result = await installRalphTuiWithUI(targetDir, { exitOnFail: false });
+        const result = await setupRalphWithUI(targetDir, { exitOnFail: false });
         if (result.success) {
-          console.log(chalk.green('\n✅ ralph-tui configured\n'));
+          console.log(chalk.green('\n✅ ralph-template 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.gray('  1. Create PRD:  cd ralph && claude @START_PROMPT.md "your idea"'));
+          console.log(chalk.gray('  2. Run loop:    ./ralph/afk-ralph.sh 10'));
+          console.log(chalk.gray('  3. Manual mode: claude @ralph/PROMPT_MANUAL.md\n'));
         }
       } else {
         console.log(chalk.gray('\nRun later: ai-sprint setup-ralph\n'));
@@ -327,7 +305,7 @@ program
     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.gray('  ralph-template (built-in) - ./ralph/afk-ralph.sh'));
     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, setup-ralph, repair, reinstall, init-ci\n'));
@@ -634,24 +612,25 @@ program
 
 program
   .command('setup-ralph')
-  .description('Install and configure ralph-tui for autonomous loops')
+  .description('Setup ralph-template for autonomous loops')
   .option('-d, --dir <directory>', 'Target directory', process.cwd())
   .action(async (options) => {
-    console.log(chalk.blue.bold('\n🔄 Ralph TUI Setup\n'));
+    console.log(chalk.blue.bold('\n🔄 Ralph Template Setup\n'));
 
-    // Use shared installation function (exits on failure)
-    await installRalphTuiWithUI(options.dir, { exitOnFail: true });
+    // Use shared setup function (exits on failure)
+    await setupRalphWithUI(options.dir, { exitOnFail: true });
 
-    console.log(chalk.green.bold('\n✅ ralph-tui configured\n'));
+    console.log(chalk.green.bold('\n✅ ralph-template 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'));
+    console.log(chalk.gray('  1. Create PRD:  cd ralph && claude @START_PROMPT.md "your idea"'));
+    console.log(chalk.gray('  2. Run loop:    ./ralph/afk-ralph.sh 10'));
+    console.log(chalk.gray('  3. Manual mode: claude @ralph/PROMPT_MANUAL.md\n'));
+
+    console.log(chalk.cyan('Files:'));
+    console.log(chalk.gray('  • Loop script:     ralph/afk-ralph.sh'));
+    console.log(chalk.gray('  • Loop prompt:     ralph/PROMPT.md'));
+    console.log(chalk.gray('  • Manual prompt:   ralph/PROMPT_MANUAL.md'));
+    console.log(chalk.gray('  • PRD kickstart:   ralph/START_PROMPT.md\n'));
   });
 
 program

package/lib/installer.js

@@ -35,8 +35,8 @@ async function copyProContent(sourceDir, targetDir, force = false) {
   const items = [
     { src: '.claude', dest: '.claude' },
     // ai_context is NOT copied - preserve user's plans, reports, memory
-    // EXCEPT ralph-tui config which contains skills and templates for ralph-tui integration
-    { src: 'ai_context/ralph-tui', dest: 'ai_context/ralph-tui' },
+    // ralph-template files (bash scripts + prompts)
+    { src: 'ralph', dest: 'ralph' },
     // CLAUDE.md handled specially below - append instead of replace
     { src: 'README.md', dest: 'AI-SPRINT-README.md' },
     { src: 'docs', dest: '.claude/docs' },
@@ -117,9 +117,7 @@ async function createAiContextStructure(targetDir) {
     'plans',
     'reports',
     'codebase',
-    'memory',
-    'ralph-tui',
-    'ralph-tui/sessions'
+    'memory'
   ];
 
   for (const dir of dirs) {
@@ -192,50 +190,59 @@ async function commandExists(cmd) {
 }
 
 /**
- * Install Bun runtime
- * @returns {Promise<boolean>} - Whether installation succeeded
+ * Check if Docker is available
+ * @returns {Promise<boolean>}
  */
-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;
-  }
+async function checkDocker() {
+  return commandExists('docker');
 }
 
 /**
- * Install ralph-tui globally via bun
- * @returns {Promise<boolean>} - Whether installation succeeded
+ * Setup ralph-template in project (copy bash scripts and prompts)
+ * @param {string} targetDir - User's project directory
+ * @returns {Promise<boolean>} - Whether setup succeeded
  */
-async function installRalphTui() {
+async function setupRalphTemplate(targetDir) {
   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');
+    const ralphDir = path.join(targetDir, 'ralph');
+    
+    // Create ralph directory if not exists
+    await fs.mkdir(ralphDir, { recursive: true });
+    
+    // The ralph files should already be copied from pro/ralph/ during install
+    // Just verify they exist
+    const requiredFiles = ['afk-ralph.sh', 'PROMPT.md', 'START_PROMPT.md'];
+    for (const file of requiredFiles) {
       try {
-        await fs.access(bunCmd);
+        await fs.access(path.join(ralphDir, file));
       } catch {
-        return false;
+        // File missing, copy from .claude/templates/ralph if available
+        const templatePath = path.join(targetDir, '.claude', 'templates', 'ralph', file);
+        try {
+          await fs.access(templatePath);
+          await fs.copyFile(templatePath, path.join(ralphDir, file));
+        } catch {
+          // Template not found either, this is OK - files will be added later
+        }
       }
     }
-
-    await execFileAsync(bunCmd, ['install', '-g', 'ralph-tui']);
+    
+    // Make afk-ralph.sh executable
+    const scriptPath = path.join(ralphDir, 'afk-ralph.sh');
+    try {
+      await fs.chmod(scriptPath, 0o755);
+    } catch {
+      // Ignore chmod errors on Windows
+    }
+    
+    // Create progress.txt if not exists
+    const progressPath = path.join(ralphDir, 'progress.txt');
+    try {
+      await fs.access(progressPath);
+    } catch {
+      await fs.writeFile(progressPath, '# Progress Log\n\nAutomatically updated by Ralph loop.\n');
+    }
+    
     return true;
   } catch {
     return false;
@@ -243,11 +250,18 @@ async function installRalphTui() {
 }
 
 /**
- * Check if ralph-tui is installed
+ * Check if ralph-template is set up
+ * @param {string} targetDir - User's project directory
  * @returns {Promise<boolean>}
  */
-async function checkRalphTui() {
-  return commandExists('ralph-tui');
+async function checkRalphTemplate(targetDir) {
+  try {
+    const scriptPath = path.join(targetDir, 'ralph', 'afk-ralph.sh');
+    await fs.access(scriptPath);
+    return true;
+  } catch {
+    return false;
+  }
 }
 
 /**
@@ -272,32 +286,6 @@ async function checkAgentBrowser() {
   return commandExists('agent-browser');
 }
 
-/**
- * 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,
@@ -305,10 +293,9 @@ module.exports = {
   cleanup,
   checkExisting,
   commandExists,
-  installBun,
-  installRalphTui,
-  checkRalphTui,
-  setupRalphTuiConfig,
+  checkDocker,
+  setupRalphTemplate,
+  checkRalphTemplate,
   installAgentBrowser,
   checkAgentBrowser
 };

package/package.json

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