ai-sdlc 0.3.0 → 0.3.1-alpha.0

package/dist/cli/commands.d.ts

@@ -61,12 +61,19 @@ export declare function run(options: {
     dryRun?: boolean;
     continue?: boolean;
     story?: string;
+    batch?: string;
+    epic?: string;
+    maxConcurrent?: string;
+    concurrent?: string;
     step?: string;
     maxIterations?: string;
     watch?: boolean;
     force?: boolean;
     worktree?: boolean;
     clean?: boolean;
+    keepWorktrees?: boolean;
+    merge?: boolean;
+    mergeStrategy?: string;
 }): Promise<void>;
 /**
  * Phase information for RPIV display

package/dist/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.js

@@ -5,7 +5,7 @@ import * as readline from 'readline';
 import { spawnSync } from 'child_process';
 import { getSdlcRoot, loadConfig, initConfig, validateWorktreeBasePath, DEFAULT_WORKTREE_CONFIG } from '../core/config.js';
 import { initializeKanban, kanbanExists, assessState, getBoardStats, findStoryBySlug, findStoriesByStatus } from '../core/kanban.js';
-import { createStory, parseStory, resetRPIVCycle, isAtMaxRetries, unblockStory, getStory, findStoryById, updateStoryField, writeStory, sanitizeStoryId, autoCompleteStoryAfterReview, incrementImplementationRetryCount, getEffectiveMaxImplementationRetries, isAtMaxImplementationRetries, updateStoryStatus } from '../core/story.js';
+import { createStory, parseStory, resetRPIVCycle, isAtMaxRetries, unblockStory, getStory, findStoryById, updateStoryField, writeStory, sanitizeStoryId, autoCompleteStoryAfterReview, incrementImplementationRetryCount, resetImplementationRetryCount, getEffectiveMaxImplementationRetries, isAtMaxImplementationRetries, updateStoryStatus } from '../core/story.js';
 import { GitWorktreeService, getLastCompletedPhase, getNextPhase } from '../core/worktree.js';
 import { ReviewDecision } from '../types/index.js';
 import { getThemedChalk } from '../core/theme.js';
@@ -287,6 +287,35 @@ function validateAutoStoryOptions(options) {
             '  - ai-sdlc run --story <id> --step <phase> (single phase)');
     }
 }
+/**
+ * Validates flag combinations for --batch conflicts
+ * @throws Error if conflicting flags are detected
+ */
+function validateBatchOptions(options) {
+    if (!options.batch) {
+        return; // No batch flag, nothing to validate
+    }
+    // --batch and --story are mutually exclusive
+    if (options.story) {
+        throw new Error('Cannot combine --batch with --story flag.\n' +
+            'Use either:\n' +
+            '  - ai-sdlc run --batch S-001,S-002,S-003 (batch processing)\n' +
+            '  - ai-sdlc run --auto --story <id> (single story)');
+    }
+    // --batch and --watch are mutually exclusive
+    if (options.watch) {
+        throw new Error('Cannot combine --batch with --watch flag.\n' +
+            'Use either:\n' +
+            '  - ai-sdlc run --batch S-001,S-002,S-003 (batch processing)\n' +
+            '  - ai-sdlc run --watch (daemon mode)');
+    }
+    // --batch and --continue are mutually exclusive
+    if (options.continue) {
+        throw new Error('Cannot combine --batch with --continue flag.\n' +
+            'Batch mode does not support resuming from checkpoints.\n' +
+            'Use: ai-sdlc run --batch S-001,S-002,S-003');
+    }
+}
 /**
  * Determines if a specific phase should be executed based on story state
  * @param story The story to check
@@ -587,6 +616,149 @@ export async function preFlightConflictCheck(targetStory, sdlcRoot, options) {
         return { proceed: true, warnings: ['Conflict detection failed'] };
     }
 }
+/**
+ * Process multiple stories sequentially through full SDLC
+ * Internal function used by batch mode
+ */
+async function processBatchInternal(storyIds, sdlcRoot, options) {
+    const startTime = Date.now();
+    const config = loadConfig();
+    const c = getThemedChalk(config);
+    const { formatBatchProgress, formatBatchSummary, logStoryCompletion, promptContinueOnError } = await import('./batch-processor.js');
+    const result = {
+        total: storyIds.length,
+        succeeded: 0,
+        failed: 0,
+        skipped: 0,
+        errors: [],
+        duration: 0,
+    };
+    console.log();
+    console.log(c.bold('═══ Starting Batch Processing ═══'));
+    console.log(c.dim(`  Stories: ${storyIds.join(', ')}`));
+    console.log(c.dim(`  Dry run: ${options.dryRun ? 'yes' : 'no'}`));
+    console.log();
+    // Process each story sequentially
+    for (let i = 0; i < storyIds.length; i++) {
+        const storyId = storyIds[i];
+        // Get story and check status
+        let story;
+        try {
+            story = getStory(sdlcRoot, storyId);
+        }
+        catch (error) {
+            result.failed++;
+            result.errors.push({
+                storyId,
+                error: `Story not found: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            console.log(c.error(`[${i + 1}/${storyIds.length}] ✗ Story not found: ${storyId}`));
+            console.log();
+            // Ask if user wants to continue (or abort in non-interactive)
+            const shouldContinue = await promptContinueOnError(storyId, c);
+            if (!shouldContinue) {
+                console.log(c.warning('Batch processing aborted.'));
+                break;
+            }
+            continue;
+        }
+        // Skip if already done
+        if (story.frontmatter.status === 'done') {
+            result.skipped++;
+            console.log(c.dim(`[${i + 1}/${storyIds.length}] ⊘ Skipping ${storyId} (already completed)`));
+            console.log();
+            continue;
+        }
+        // Show progress header
+        const progress = {
+            currentIndex: i,
+            total: storyIds.length,
+            currentStory: story,
+        };
+        console.log(c.info(formatBatchProgress(progress)));
+        console.log();
+        // Dry-run mode: just show what would be done
+        if (options.dryRun) {
+            console.log(c.dim('  Would process story through full SDLC'));
+            console.log(c.dim(`  Status: ${story.frontmatter.status}`));
+            console.log();
+            result.succeeded++;
+            continue;
+        }
+        // Process story through full SDLC by recursively calling run()
+        // We set auto: true to ensure full SDLC execution
+        try {
+            await run({
+                auto: true,
+                story: storyId,
+                dryRun: false,
+                worktree: options.worktree,
+                force: options.force,
+            });
+            // Check if story completed successfully (moved to done)
+            const finalStory = getStory(sdlcRoot, storyId);
+            if (finalStory.frontmatter.status === 'done') {
+                result.succeeded++;
+                logStoryCompletion(storyId, true, c);
+            }
+            else {
+                // Story didn't reach done state - treat as failure
+                result.failed++;
+                result.errors.push({
+                    storyId,
+                    error: `Story did not complete (status: ${finalStory.frontmatter.status})`,
+                });
+                logStoryCompletion(storyId, false, c);
+                // Ask if user wants to continue (or abort in non-interactive)
+                const shouldContinue = await promptContinueOnError(storyId, c);
+                if (!shouldContinue) {
+                    console.log(c.warning('Batch processing aborted.'));
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            result.failed++;
+            result.errors.push({
+                storyId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            logStoryCompletion(storyId, false, c);
+            // Ask if user wants to continue (or abort in non-interactive)
+            const shouldContinue = await promptContinueOnError(storyId, c);
+            if (!shouldContinue) {
+                console.log(c.warning('Batch processing aborted.'));
+                break;
+            }
+        }
+        console.log();
+    }
+    // Display final summary
+    result.duration = Date.now() - startTime;
+    const summaryLines = formatBatchSummary(result);
+    summaryLines.forEach((line) => {
+        if (line.includes('✓')) {
+            console.log(c.success(line));
+        }
+        else if (line.includes('✗')) {
+            console.log(c.error(line));
+        }
+        else if (line.includes('⊘')) {
+            console.log(c.warning(line));
+        }
+        else if (line.startsWith('  -')) {
+            console.log(c.dim(line));
+        }
+        else {
+            console.log(line);
+        }
+    });
+    // Return non-zero exit code if any failures occurred
+    if (result.failed > 0) {
+        process.exitCode = 1;
+    }
+    return result;
+}
 /**
  * Run the workflow (process one action or all)
  */
@@ -626,6 +798,115 @@ export async function run(options) {
         await startDaemon({ maxIterations: maxIterationsOverride });
         return; // Daemon runs indefinitely
     }
+    // Handle concurrent mode
+    if (options.concurrent) {
+        const concurrency = parseInt(options.concurrent, 10);
+        // Validate concurrency value
+        if (isNaN(concurrency) || concurrency <= 0) {
+            console.log(c.warning(`Warning: Invalid --concurrent value "${options.concurrent}". Defaulting to 1 (single-story mode).`));
+            // Fall through to normal single-story mode
+        }
+        else if (concurrency > 1) {
+            // Import orchestrator and run concurrent mode
+            const { Orchestrator } = await import('../core/orchestrator.js');
+            const { findStoriesByStatus } = await import('../core/kanban.js');
+            // Query database for ready stories, sorted by priority
+            const readyStories = findStoriesByStatus(sdlcRoot, 'ready');
+            if (readyStories.length === 0) {
+                console.log(c.info('No ready stories found. Add stories to the ready column in the kanban board.'));
+                return;
+            }
+            // Limit to available stories
+            const storiesToRun = readyStories.slice(0, Math.min(concurrency, readyStories.length));
+            console.log(c.info(`🚀 Running ${storiesToRun.length} stories concurrently (concurrency: ${concurrency})`));
+            // Create orchestrator and execute
+            const orchestrator = new Orchestrator({
+                concurrency,
+                shutdownTimeout: 10000,
+                keepWorktrees: options.keepWorktrees,
+            });
+            const results = await orchestrator.execute(storiesToRun);
+            // Report results
+            const succeeded = results.filter((r) => r.success).length;
+            const failed = results.filter((r) => !r.success).length;
+            console.log('');
+            console.log(c.info('═══════════════════════════════════════════'));
+            console.log(c.info('Concurrent Execution Summary'));
+            console.log(c.info('═══════════════════════════════════════════'));
+            console.log(c.success(`✅ Succeeded: ${succeeded}`));
+            if (failed > 0) {
+                console.log(c.error(`❌ Failed: ${failed}`));
+            }
+            console.log('');
+            // Exit with error code if any failed
+            if (failed > 0) {
+                process.exit(1);
+            }
+            return;
+        }
+    }
+    // Handle epic mode
+    if (options.epic) {
+        const { processEpic } = await import('./epic-processor.js');
+        const maxConcurrent = options.maxConcurrent ? parseInt(options.maxConcurrent, 10) : undefined;
+        // Parse merge strategy if provided
+        const mergeStrategy = options.mergeStrategy;
+        const exitCode = await processEpic({
+            epicId: options.epic,
+            maxConcurrent,
+            dryRun: options.dryRun,
+            force: options.force,
+            keepWorktrees: options.keepWorktrees,
+            merge: options.merge,
+            mergeStrategy,
+        });
+        process.exit(exitCode);
+    }
+    // Handle batch mode
+    if (options.batch) {
+        // Validate batch options first
+        try {
+            validateBatchOptions(options);
+        }
+        catch (error) {
+            console.log(c.error(`Error: ${error instanceof Error ? error.message : String(error)}`));
+            return;
+        }
+        // Import batch validation modules
+        const { parseStoryIdList, deduplicateStoryIds, validateStoryIds } = await import('./batch-validator.js');
+        // Parse and validate story IDs
+        const rawStoryIds = parseStoryIdList(options.batch);
+        if (rawStoryIds.length === 0) {
+            console.log(c.error('Error: Empty batch - no story IDs provided'));
+            console.log(c.dim('Usage: ai-sdlc run --batch S-001,S-002,S-003'));
+            return;
+        }
+        // Deduplicate story IDs
+        const storyIds = deduplicateStoryIds(rawStoryIds);
+        if (storyIds.length < rawStoryIds.length) {
+            const duplicateCount = rawStoryIds.length - storyIds.length;
+            console.log(c.dim(`Note: Removed ${duplicateCount} duplicate story ID(s)`));
+        }
+        // Validate all stories exist before processing
+        const validation = validateStoryIds(storyIds, sdlcRoot);
+        if (!validation.valid) {
+            console.log(c.error('Error: Batch validation failed'));
+            console.log();
+            for (const error of validation.errors) {
+                console.log(c.error(`  - ${error.message}`));
+            }
+            console.log();
+            console.log(c.dim('Fix the errors above and try again.'));
+            return;
+        }
+        // Process the batch using internal function
+        await processBatchInternal(storyIds, sdlcRoot, {
+            dryRun: options.dryRun,
+            worktree: options.worktree,
+            force: options.force,
+        });
+        return; // Batch processing complete
+    }
     // Valid step names for --step option
     const validSteps = ['refine', 'research', 'plan', 'implement', 'review'];
     // Validate --step option early
@@ -1693,6 +1974,9 @@ async function executeAction(action, sdlcRoot) {
                     story = await autoCompleteStoryAfterReview(story, config, reviewResult);
                     // Log auto-completion if it occurred
                     if (reviewResult.decision === ReviewDecision.APPROVED && config.reviewConfig.autoCompleteOnApproval) {
+                        // Reset implementation retry count on successful review approval
+                        await resetImplementationRetryCount(story);
+                        storyLogger?.log('INFO', 'Implementation retry count reset after review approval');
                         spinner.text = c.success('Review approved - auto-completing story');
                         storyLogger?.log('INFO', `Story auto-completed after review approval: "${story.frontmatter.title}"`);
                         // Auto-create PR in automated mode