ai-sdlc 0.2.0-alpha.6 → 0.2.0-alpha.61

package/dist/agents/orchestrator.js

@@ -0,0 +1,443 @@
+/**
+ * Sequential Task Orchestrator
+ *
+ * Orchestrates implementation by running each task as an isolated agent,
+ * preventing context window exhaustion and enabling intelligent retry/recovery.
+ */
+import { spawnSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { parseImplementationTasks } from '../core/task-parser.js';
+import { getTaskProgress, updateTaskProgress, initializeTaskProgress, readStoryFile, } from '../core/task-progress.js';
+import { runSingleTaskAgent } from './single-task.js';
+import { getLogger } from '../core/logger.js';
+const logger = getLogger();
+/**
+ * Default orchestrator options
+ */
+const DEFAULT_OPTIONS = {
+    maxRetriesPerTask: 2,
+    commitAfterEachTask: true,
+    stopOnFirstFailure: true,
+    dryRun: false,
+};
+/**
+ * Build minimal context for a single task
+ *
+ * Extracts relevant acceptance criteria, existing file contents, and project conventions.
+ * Truncates if context exceeds reasonable size (~2000 chars for projectPatterns).
+ *
+ * @param task - Task to build context for
+ * @param storyContent - Full story content
+ * @param workingDirectory - Working directory for task execution
+ * @returns Minimal task context
+ */
+export function buildTaskContext(task, storyContent, workingDirectory) {
+    // Extract acceptance criteria section
+    const acceptanceCriteria = [];
+    const acMatch = storyContent.match(/##\s+Acceptance\s+Criteria\s*\n([\s\S]*?)(?=\n##|$)/i);
+    if (acMatch) {
+        const acSection = acMatch[1];
+        const lines = acSection.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('-') || trimmed.startsWith('*')) {
+                // Remove checkbox and bullet
+                const criterion = trimmed.replace(/^[-*]\s+\[[ x]\]\s*/, '').replace(/^[-*]\s+/, '');
+                if (criterion) {
+                    acceptanceCriteria.push(criterion);
+                }
+            }
+        }
+    }
+    // Filter acceptance criteria to only those relevant to task files
+    const taskFiles = task.files || [];
+    const relevantCriteria = acceptanceCriteria.filter((criterion) => {
+        // Include if criterion mentions any task file
+        return taskFiles.some((file) => {
+            const fileName = path.basename(file);
+            const fileBaseName = fileName.replace(/\.(ts|tsx|js|jsx)$/, '');
+            return (criterion.includes(file) ||
+                criterion.includes(fileName) ||
+                criterion.includes(fileBaseName));
+        });
+    });
+    // If no specific matches, include first 3 criteria as general context
+    const finalCriteria = relevantCriteria.length > 0 ? relevantCriteria : acceptanceCriteria.slice(0, 3);
+    // Read existing files
+    const existingFiles = [];
+    for (const file of taskFiles) {
+        const filePath = path.join(workingDirectory, file);
+        if (fs.existsSync(filePath)) {
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                existingFiles.push({ path: file, content });
+            }
+            catch (error) {
+                logger.warn('orchestrator', `Failed to read file ${file}: ${error.message}`);
+            }
+        }
+    }
+    // Extract project conventions (brief summary)
+    let projectPatterns = '';
+    const conventionsMatch = storyContent.match(/##\s+(Technical\s+Specification|Project\s+Conventions)\s*\n([\s\S]*?)(?=\n##|$)/i);
+    if (conventionsMatch) {
+        projectPatterns = conventionsMatch[2].trim();
+    }
+    // Truncate if too long
+    const MAX_PATTERN_LENGTH = 2000;
+    if (projectPatterns.length > MAX_PATTERN_LENGTH) {
+        projectPatterns =
+            projectPatterns.substring(0, MAX_PATTERN_LENGTH) + '\n\n[... truncated for length]';
+    }
+    return {
+        task,
+        acceptanceCriteria: finalCriteria,
+        existingFiles,
+        projectPatterns,
+        workingDirectory,
+    };
+}
+/**
+ * Evaluate task result and categorize failure type
+ *
+ * Returns:
+ * - 'success': Task completed successfully
+ * - 'recoverable': Failure that can be retried (timeout, transient error, verification failed)
+ * - 'unrecoverable': Failure that should stop orchestration (deps not met, impossible task, max retries)
+ *
+ * @param result - Result from single-task agent execution
+ * @param attemptCount - Number of attempts made so far (including this one)
+ * @param maxRetries - Maximum retry attempts allowed
+ * @returns Failure category
+ */
+export function evaluateTaskResult(result, attemptCount, maxRetries) {
+    if (result.success) {
+        return 'success';
+    }
+    const error = result.error || '';
+    const lowerError = error.toLowerCase();
+    // Check if max retries exceeded (becomes unrecoverable)
+    if (attemptCount > maxRetries) {
+        logger.warn('orchestrator', `Task ${result.task.id} exceeded max retries (${maxRetries})`);
+        return 'unrecoverable';
+    }
+    // Unrecoverable: Dependencies not met
+    if (lowerError.includes('dependency') ||
+        lowerError.includes('depends on') ||
+        lowerError.includes('prerequisite')) {
+        return 'unrecoverable';
+    }
+    // Unrecoverable: Impossible task or design flaw
+    if (lowerError.includes('impossible') ||
+        lowerError.includes('cannot be done') ||
+        lowerError.includes('design flaw')) {
+        return 'unrecoverable';
+    }
+    // Unrecoverable: Files outside scope modified
+    if (result.scopeViolation && result.scopeViolation.length > 0) {
+        logger.warn('orchestrator', `Task ${result.task.id} modified files outside scope: ${result.scopeViolation.join(', ')}`);
+        return 'unrecoverable';
+    }
+    // Recoverable: Timeout
+    if (lowerError.includes('timeout') || lowerError.includes('timed out')) {
+        return 'recoverable';
+    }
+    // Recoverable: Transient API error
+    if (lowerError.includes('rate limit') ||
+        lowerError.includes('network') ||
+        lowerError.includes('connection') ||
+        lowerError.includes('api error')) {
+        return 'recoverable';
+    }
+    // Recoverable: Verification failed (tests/lint/build)
+    if (!result.verificationPassed ||
+        lowerError.includes('test') ||
+        lowerError.includes('lint') ||
+        lowerError.includes('build')) {
+        return 'recoverable';
+    }
+    // Recoverable: Unclear requirements (agent needs clarification)
+    if (lowerError.includes('unclear') ||
+        lowerError.includes('need') ||
+        lowerError.includes('missing file') ||
+        result.missingDependencies) {
+        return 'recoverable';
+    }
+    // Default to recoverable for unknown errors (give it a chance to retry)
+    return 'recoverable';
+}
+/**
+ * Get next task to execute based on dependencies and progress
+ *
+ * Returns task with status 'pending' or 'in_progress' whose dependencies are all completed.
+ * Detects circular dependencies and throws error.
+ *
+ * @param tasks - All tasks from implementation plan
+ * @param progress - Current task progress
+ * @returns Next eligible task or null if none available
+ * @throws Error if circular dependency detected
+ */
+export function getNextTask(tasks, progress) {
+    // Build progress map for quick lookup
+    const progressMap = new Map();
+    for (const p of progress) {
+        progressMap.set(p.taskId, p.status);
+    }
+    // Find tasks eligible for execution
+    const eligibleTasks = tasks.filter((task) => {
+        const status = progressMap.get(task.id);
+        // Only consider pending or in_progress tasks
+        if (status !== 'pending' && status !== 'in_progress') {
+            return false;
+        }
+        // Check if all dependencies are completed
+        const deps = task.dependencies || [];
+        const allDepsCompleted = deps.every((depId) => progressMap.get(depId) === 'completed');
+        return allDepsCompleted;
+    });
+    // Prioritize in_progress tasks (resume interrupted work)
+    const inProgressTask = eligibleTasks.find((task) => progressMap.get(task.id) === 'in_progress');
+    if (inProgressTask) {
+        return inProgressTask;
+    }
+    // Return first pending task
+    const pendingTask = eligibleTasks.find((task) => progressMap.get(task.id) === 'pending');
+    if (pendingTask) {
+        return pendingTask;
+    }
+    // No eligible tasks - check for circular dependencies
+    const incompleteTasks = tasks.filter((task) => {
+        const status = progressMap.get(task.id);
+        return status !== 'completed' && status !== 'failed';
+    });
+    if (incompleteTasks.length > 0) {
+        // We have incomplete tasks but none are eligible - likely circular dependency
+        const taskIds = incompleteTasks.map((t) => t.id).join(', ');
+        throw new Error(`Circular dependency detected: tasks [${taskIds}] cannot be executed due to unmet dependencies`);
+    }
+    return null;
+}
+/**
+ * Commit task completion to git
+ *
+ * Stages modified files, creates commit with standard message format.
+ * Verifies no files outside task scope were modified.
+ *
+ * @param task - Task that was completed
+ * @param filesChanged - Files modified by task
+ * @param storyId - Story ID for commit message
+ * @param workingDir - Working directory
+ * @throws Error if git operations fail
+ */
+async function commitTaskCompletion(task, filesChanged, storyId, workingDir) {
+    if (filesChanged.length === 0) {
+        logger.warn('orchestrator', `Task ${task.id} completed but no files changed, skipping commit`);
+        return;
+    }
+    // Validate file paths
+    const declaredFiles = task.files || [];
+    const violations = filesChanged.filter((f) => !declaredFiles.includes(f));
+    if (violations.length > 0) {
+        throw new Error(`Task ${task.id} modified files outside declared scope: ${violations.join(', ')}`);
+    }
+    // Stage files using safe git invocation
+    const addResult = spawnSync('git', ['add', ...filesChanged], {
+        cwd: workingDir,
+        encoding: 'utf8',
+    });
+    if (addResult.error) {
+        throw new Error(`Failed to stage files: ${addResult.error.message}`);
+    }
+    if (addResult.status !== 0) {
+        const stderr = addResult.stderr || addResult.stdout || '';
+        throw new Error(`Failed to stage files: ${stderr}`);
+    }
+    // Create commit
+    const commitMessage = `feat(${storyId}): Complete task ${task.id} - ${task.description}`;
+    const commitResult = spawnSync('git', ['commit', '-m', commitMessage], {
+        cwd: workingDir,
+        encoding: 'utf8',
+    });
+    if (commitResult.error) {
+        throw new Error(`Failed to commit: ${commitResult.error.message}`);
+    }
+    if (commitResult.status !== 0) {
+        const stderr = commitResult.stderr || commitResult.stdout || '';
+        throw new Error(`Failed to commit: ${stderr}`);
+    }
+    logger.info('orchestrator', `Committed task ${task.id}: ${commitMessage}`);
+}
+/**
+ * Run implementation orchestrator
+ *
+ * Main orchestration loop:
+ * 1. Parse tasks from plan
+ * 2. Load/initialize progress
+ * 3. Loop: get next task → run agent → evaluate → commit → repeat
+ * 4. Return summary result
+ *
+ * @param storyPath - Absolute path to story.md file
+ * @param sdlcRoot - SDLC root directory
+ * @param options - Orchestrator options
+ * @returns Orchestration result summary
+ */
+export async function runImplementationOrchestrator(storyPath, sdlcRoot, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const workingDir = path.dirname(storyPath);
+    logger.info('orchestrator', 'Starting implementation orchestration', {
+        storyPath,
+        options: opts,
+    });
+    // Parse tasks from plan
+    const storyContent = await readStoryFile(storyPath);
+    const tasks = parseImplementationTasks(storyContent);
+    if (tasks.length === 0) {
+        logger.warn('orchestrator', 'No tasks found in implementation plan');
+        return {
+            success: true,
+            tasksCompleted: 0,
+            tasksFailed: 0,
+            tasksRemaining: 0,
+            failedTasks: [],
+            totalAgentInvocations: 0,
+        };
+    }
+    logger.info('orchestrator', `Found ${tasks.length} tasks in plan`);
+    // Load or initialize progress
+    let progress = await getTaskProgress(storyPath);
+    if (progress.length === 0) {
+        logger.info('orchestrator', 'Initializing task progress tracking');
+        await initializeTaskProgress(storyPath, tasks.map((t) => t.id));
+        progress = await getTaskProgress(storyPath);
+    }
+    // Extract story ID from path
+    const storyId = path.basename(path.dirname(storyPath));
+    // Track statistics
+    // Count already-completed tasks from previous runs
+    const alreadyCompleted = progress.filter((p) => p.status === 'completed').length;
+    const alreadyFailed = progress.filter((p) => p.status === 'failed').length;
+    let tasksCompleted = alreadyCompleted;
+    let tasksFailed = alreadyFailed;
+    let totalAgentInvocations = 0;
+    const failedTasks = [];
+    const retryCount = new Map();
+    // Main orchestration loop
+    while (true) {
+        // Get next eligible task
+        let nextTask;
+        try {
+            nextTask = getNextTask(tasks, progress);
+        }
+        catch (error) {
+            // Circular dependency or other fatal error
+            logger.error('orchestrator', 'Failed to get next task', { error: error.message });
+            return {
+                success: false,
+                tasksCompleted,
+                tasksFailed: tasks.length - tasksCompleted,
+                tasksRemaining: tasks.length - tasksCompleted - tasksFailed,
+                failedTasks,
+                totalAgentInvocations,
+            };
+        }
+        if (!nextTask) {
+            // No more eligible tasks
+            break;
+        }
+        logger.info('orchestrator', `Executing task ${nextTask.id}: ${nextTask.description}`);
+        // Mark task in progress
+        await updateTaskProgress(storyPath, nextTask.id, 'in_progress');
+        // Build task context
+        const taskContext = buildTaskContext(nextTask, storyContent, workingDir);
+        // Execute task agent (or simulate in dry run)
+        let result;
+        if (opts.dryRun) {
+            logger.info('orchestrator', `[DRY RUN] Would execute task ${nextTask.id}`);
+            result = {
+                success: true,
+                task: nextTask,
+                filesChanged: nextTask.files || [],
+                verificationPassed: true,
+            };
+        }
+        else {
+            result = await runSingleTaskAgent(taskContext);
+        }
+        totalAgentInvocations++;
+        const attempts = (retryCount.get(nextTask.id) || 0) + 1;
+        retryCount.set(nextTask.id, attempts);
+        // Evaluate result
+        const evaluation = evaluateTaskResult(result, attempts, opts.maxRetriesPerTask);
+        if (evaluation === 'success') {
+            // Task succeeded
+            await updateTaskProgress(storyPath, nextTask.id, 'completed');
+            tasksCompleted++;
+            // Commit if enabled
+            if (opts.commitAfterEachTask && !opts.dryRun) {
+                try {
+                    await commitTaskCompletion(nextTask, result.filesChanged, storyId, workingDir);
+                }
+                catch (error) {
+                    logger.error('orchestrator', `Failed to commit task ${nextTask.id}`, {
+                        error: error.message,
+                    });
+                    // Continue despite commit failure
+                }
+            }
+            logger.info('orchestrator', `Task ${nextTask.id} completed successfully`);
+        }
+        else if (evaluation === 'recoverable') {
+            // Recoverable failure - retry if under max attempts
+            if (attempts <= opts.maxRetriesPerTask) {
+                logger.warn('orchestrator', `Task ${nextTask.id} failed (recoverable), will retry (attempt ${attempts}/${opts.maxRetriesPerTask})`);
+                // Keep status as 'in_progress' to retry
+            }
+            else {
+                // Max retries exceeded
+                await updateTaskProgress(storyPath, nextTask.id, 'failed', result.error || 'Max retries exceeded');
+                tasksFailed++;
+                failedTasks.push({
+                    taskId: nextTask.id,
+                    error: result.error || 'Max retries exceeded',
+                    attempts,
+                });
+                logger.error('orchestrator', `Task ${nextTask.id} failed after ${attempts} attempts`);
+                if (opts.stopOnFirstFailure) {
+                    logger.error('orchestrator', 'Stopping orchestration due to unrecoverable failure');
+                    break;
+                }
+            }
+        }
+        else {
+            // Unrecoverable failure
+            await updateTaskProgress(storyPath, nextTask.id, 'failed', result.error || 'Unrecoverable failure');
+            tasksFailed++;
+            failedTasks.push({
+                taskId: nextTask.id,
+                error: result.error || 'Unrecoverable failure',
+                attempts,
+            });
+            logger.error('orchestrator', `Task ${nextTask.id} failed (unrecoverable)`);
+            if (opts.stopOnFirstFailure) {
+                logger.error('orchestrator', 'Stopping orchestration due to unrecoverable failure');
+                break;
+            }
+        }
+        // Reload progress for next iteration
+        progress = await getTaskProgress(storyPath);
+    }
+    // Calculate remaining tasks
+    const tasksRemaining = tasks.length - tasksCompleted - tasksFailed;
+    const result = {
+        success: tasksFailed === 0 && tasksRemaining === 0,
+        tasksCompleted,
+        tasksFailed,
+        tasksRemaining,
+        failedTasks,
+        totalAgentInvocations,
+    };
+    logger.info('orchestrator', 'Orchestration complete', result);
+    return result;
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/agents/orchestrator.js.map

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

package/dist/agents/planning.d.ts

@@ -3,7 +3,7 @@ import { AgentOptions } from './research.js';
 /**
  * System prompt for the planning agent
  */
-export declare const PLANNING_SYSTEM_PROMPT = "You are a technical planning specialist. Your job is to create detailed, step-by-step implementation plans for user stories.\n\nWhen creating a plan, you should:\n1. Break the work into phases (setup, implementation, testing, etc.)\n2. Create specific, actionable tasks within each phase\n3. Use checkbox format for tracking progress\n4. Consider test-driven development (write tests first)\n5. Include verification steps\n\nOutput your plan in markdown format with checkboxes. Each task should be small enough to complete in one focused session.";
+export declare const PLANNING_SYSTEM_PROMPT = "You are a technical planning specialist. Your job is to create detailed, step-by-step implementation plans for user stories.\n\nWhen creating a plan, you should:\n1. Break the work into phases (setup, implementation, testing, etc.)\n2. Create specific, actionable tasks within each phase\n3. Use checkbox format for tracking progress\n4. Consider test-driven development (write tests first)\n5. Include verification steps\n\nOutput your plan in markdown format with checkboxes. Each task should be small enough to complete in one focused session.\n\n## Task Format\n\nWhen creating implementation plans, output tasks using this structured format:\n\n## Implementation Tasks\n\n- [ ] **T1**: {clear, actionable task description}\n  - Files: {comma-separated file paths in backticks}\n  - Dependencies: {comma-separated task IDs or \"none\"}\n\nExample:\n- [ ] **T1**: Create authentication service\n  - Files: `src/services/auth.ts`, `src/types/auth.ts`\n  - Dependencies: none\n\n- [ ] **T2**: Add authentication middleware\n  - Files: `src/middleware/auth.ts`\n  - Dependencies: T1\n\n- [ ] **T3**: Implement login endpoint\n  - Files: `src/routes/auth.ts`\n  - Dependencies: T1, T2\n\nRules:\n- Use sequential task IDs: T1, T2, T3, etc.\n- Keep descriptions concise and actionable (start with a verb)\n- List all files that will be created or modified\n- Specify dependencies by task ID, or \"none\" if no dependencies\n- Files and Dependencies lines are optional but recommended for clarity\n- Tasks can have multiple dependencies (comma-separated)\n- Ensure no circular dependencies exist in the task graph";
 /**
  * TDD-specific planning instructions
  * When TDD is enabled, this is appended to the planning prompt to ensure

package/dist/agents/planning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/agents/planning.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB,uiBASuF,CAAC;AAE3H;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,+xCAyBuB,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,kBAAkB,EAAE,OAAO,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CA+CR;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA8CtB"}
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/agents/planning.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB,+kDAyCuB,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,+xCAyBuB,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,kBAAkB,EAAE,OAAO,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CA+CR;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAmEtB"}

package/dist/agents/planning.js

@@ -1,5 +1,6 @@
 import { parseStory, appendToSection, updateStoryField } from '../core/story.js';
 import { runAgentQuery } from '../core/client.js';
+import { getLogger } from '../core/logger.js';
 import path from 'path';
 /**
  * System prompt for the planning agent
@@ -13,7 +14,39 @@ When creating a plan, you should:
 4. Consider test-driven development (write tests first)
 5. Include verification steps
 
-Output your plan in markdown format with checkboxes. Each task should be small enough to complete in one focused session.`;
+Output your plan in markdown format with checkboxes. Each task should be small enough to complete in one focused session.
+
+## Task Format
+
+When creating implementation plans, output tasks using this structured format:
+
+## Implementation Tasks
+
+- [ ] **T1**: {clear, actionable task description}
+  - Files: {comma-separated file paths in backticks}
+  - Dependencies: {comma-separated task IDs or "none"}
+
+Example:
+- [ ] **T1**: Create authentication service
+  - Files: \`src/services/auth.ts\`, \`src/types/auth.ts\`
+  - Dependencies: none
+
+- [ ] **T2**: Add authentication middleware
+  - Files: \`src/middleware/auth.ts\`
+  - Dependencies: T1
+
+- [ ] **T3**: Implement login endpoint
+  - Files: \`src/routes/auth.ts\`
+  - Dependencies: T1, T2
+
+Rules:
+- Use sequential task IDs: T1, T2, T3, etc.
+- Keep descriptions concise and actionable (start with a verb)
+- List all files that will be created or modified
+- Specify dependencies by task ID, or "none" if no dependencies
+- Files and Dependencies lines are optional but recommended for clarity
+- Tasks can have multiple dependencies (comma-separated)
+- Ensure no circular dependencies exist in the task graph`;
 /**
  * TDD-specific planning instructions
  * When TDD is enabled, this is appended to the planning prompt to ensure
@@ -102,9 +135,15 @@ Format the plan with markdown checkboxes like:
  * Creates a step-by-step implementation plan from the research findings.
  */
 export async function runPlanningAgent(storyPath, sdlcRoot, options = {}) {
+    const logger = getLogger();
+    const startTime = Date.now();
     const story = parseStory(storyPath);
     const changesMade = [];
     const workingDir = path.dirname(sdlcRoot);
+    logger.info('planning', 'Starting planning phase', {
+        storyId: story.frontmatter.id,
+        hasReworkContext: !!options.reworkContext,
+    });
     try {
         // Load config to check if TDD is enabled globally
         const { loadConfig } = await import('../core/config.js');
@@ -114,6 +153,7 @@ export async function runPlanningAgent(storyPath, sdlcRoot, options = {}) {
         const prompt = buildPlanningPrompt(story, tddEnabledInConfig, options.reworkContext);
         if (story.frontmatter.tdd_enabled ?? tddEnabledInConfig) {
             changesMade.push('TDD mode enabled - plan will use Red-Green-Refactor structure');
+            logger.debug('planning', 'TDD mode enabled for planning');
         }
         const planContent = await runAgentQuery({
             prompt,
@@ -122,11 +162,16 @@ export async function runPlanningAgent(storyPath, sdlcRoot, options = {}) {
             onProgress: options.onProgress,
         });
         // Append plan to the story
-        appendToSection(story, 'Implementation Plan', planContent);
+        await appendToSection(story, 'Implementation Plan', planContent);
         changesMade.push('Added implementation plan');
         // Mark plan as complete
-        updateStoryField(story, 'plan_complete', true);
+        await updateStoryField(story, 'plan_complete', true);
         changesMade.push('Marked plan_complete: true');
+        logger.info('planning', 'Planning phase complete', {
+            storyId: story.frontmatter.id,
+            durationMs: Date.now() - startTime,
+            planLength: planContent.length,
+        });
         return {
             success: true,
             story: parseStory(storyPath), // Re-read to get updated content
@@ -134,11 +179,17 @@ export async function runPlanningAgent(storyPath, sdlcRoot, options = {}) {
         };
     }
     catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error('planning', 'Planning phase failed', {
+            storyId: story.frontmatter.id,
+            durationMs: Date.now() - startTime,
+            error: errorMessage,
+        });
         return {
             success: false,
             story,
             changesMade,
-            error: error instanceof Error ? error.message : String(error),
+            error: errorMessage,
         };
     }
 }

package/dist/agents/planning.js.map

@@ -1 +1 @@
-{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../src/agents/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;0HASoF,CAAC;AAE3H;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;6DAyBoB,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAY,EACZ,kBAA2B,EAC3B,aAAsB;IAEtB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,WAAW,IAAI,kBAAkB,CAAC;IAEvE,IAAI,MAAM,GAAG;;SAEN,KAAK,CAAC,WAAW,CAAC,KAAK;;;EAG9B,KAAK,CAAC,OAAO,EAAE,CAAC;IAEhB,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,IAAI;;;EAGZ,aAAa;;;;;6EAK8D,CAAC;IAC5E,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI;;EAEZ,yBAAyB,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,IAAI;;;;;;;;;;;;;;;;IAgBR,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,QAAgB,EAChB,UAAwB,EAAE;IAE1B,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,kDAAkD;QAClD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,KAAK,CAAC;QAExD,wDAAwD;QACxD,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAErF,IAAI,KAAK,CAAC,WAAW,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC;YACxD,WAAW,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC;YACtC,MAAM;YACN,YAAY,EAAE,sBAAsB;YACpC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QAEH,2BAA2B;QAC3B,eAAe,CAAC,KAAK,EAAE,qBAAqB,EAAE,WAAW,CAAC,CAAC;QAC3D,WAAW,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAE9C,wBAAwB;QACxB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;QAC/C,WAAW,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAE/C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,iCAAiC;YAC/D,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK;YACL,WAAW;YACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../src/agents/planning.ts"],"names":[],"mappings":"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"}

package/dist/agents/refinement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refinement.d.ts","sourceRoot":"","sources":["../../src/agents/refinement.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiB7C;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAsEtB"}
+{"version":3,"file":"refinement.d.ts","sourceRoot":"","sources":["../../src/agents/refinement.ts"],"names":[],"mappings":"AAGA,OAAO,EAAS,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiB7C;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA2FtB"}