ai-sdlc 0.2.0-alpha.21 → 0.2.0-alpha.23

package/dist/agents/research.js

@@ -3,6 +3,7 @@ import path from 'path';
 import { glob } from 'glob';
 import { parseStory, appendToSection, updateStoryField } from '../core/story.js';
 import { runAgentQuery } from '../core/client.js';
+import { getLogger } from '../core/logger.js';
 const RESEARCH_SYSTEM_PROMPT = `You are a technical research specialist. Your job is to research how to implement a user story by analyzing the existing codebase and external best practices.
 
 When researching a story, you should:
@@ -13,6 +14,118 @@ When researching a story, you should:
 5. Note any dependencies or prerequisites
 
 Output your research findings in markdown format. Be specific about file paths and code patterns.`;
+/**
+ * Keywords that indicate a story is purely internal and does not require web research.
+ * These keywords suggest refactoring, code organization, or internal maintenance tasks.
+ */
+const WEB_RESEARCH_INTERNAL_KEYWORDS = [
+    'refactor internal',
+    'move function',
+    'rename variable',
+    'rename function',
+    'move utility',
+    'internal refactor',
+    'move code',
+    'reorganize internal',
+];
+/**
+ * Keywords that indicate external dependencies or integrations requiring web research.
+ * These keywords suggest the need for library documentation, API references, or best practices.
+ */
+const WEB_RESEARCH_EXTERNAL_KEYWORDS = [
+    'integrate',
+    'api',
+    'library',
+    'framework',
+    'best practices',
+    'npm package',
+    'external',
+    'third-party',
+    'sdk',
+    'documentation',
+    'webhook',
+    'rest api',
+    'graphql',
+    'oauth',
+    'authentication provider',
+];
+/**
+ * Web research prompt template for supplementary research phase.
+ * Instructs the agent on tool usage, FAR evaluation, and output formatting.
+ */
+const WEB_RESEARCH_PROMPT_TEMPLATE = (storyTitle, storyContent, codebaseContext) => `You are performing supplementary web research for a software development story.
+
+**Story Title**: ${storyTitle}
+
+**Story Content**:
+${storyContent}
+
+**Codebase Context** (already analyzed):
+${codebaseContext}... [truncated]
+
+---
+
+## Web Research Instructions
+
+You have access to these web research tools:
+
+1. **Context7** (if available) - Use FIRST for library/framework documentation
+   - Best for: npm packages, Python libraries, popular frameworks
+   - Example: "Search Context7 for React Query documentation on data fetching"
+
+2. **WebSearch** - Use for community knowledge and best practices
+   - Best for: Stack Overflow patterns, blog posts, tutorials
+   - Example: "Search the web for TypeScript error handling best practices"
+
+3. **WebFetch** - Use to read specific authoritative URLs
+   - Best for: Official documentation, specific articles
+   - Example: "Fetch https://docs.anthropic.com/claude/reference"
+
+## Research Strategy
+
+- Try Context7 FIRST for any npm packages or popular frameworks mentioned in the story
+- Fall back to WebSearch for general solutions and community patterns
+- Use WebFetch only when you have specific authoritative URLs to read
+- Limit research to 3-5 high-quality sources to avoid information overload
+- Focus on actionable information that directly addresses the story requirements
+
+## Output Format
+
+For EACH finding, provide:
+
+### [Topic Name]
+**Source**: [Context7 - Library Name] or [Web Search Result] or [URL]
+**FAR Score**: Factuality: [1-5], Actionability: [1-5], Relevance: [1-5]
+**Justification**: [Why these scores? How does this help the story?]
+
+[Finding content with code examples, patterns, or instructions]
+
+---
+
+## FAR Scale Definitions
+
+**Factuality (1-5)**: How accurate and verifiable is the information?
+- 1: Unverified/speculative
+- 3: Community knowledge (Stack Overflow, blogs)
+- 5: Official documentation or peer-reviewed
+
+**Actionability (1-5)**: Can this be directly applied to the task?
+- 1: Abstract concepts only
+- 3: General patterns or approaches
+- 5: Copy-paste code examples or step-by-step instructions
+
+**Relevance (1-5)**: How closely does this match the story requirements?
+- 1: Tangentially related
+- 3: Related but not specific to story
+- 5: Directly addresses a story acceptance criterion
+
+## Important Notes
+
+- If web tools are unavailable (offline, not configured), simply state: "Web research tools unavailable - skipping web research"
+- If a finding contradicts patterns in the codebase context, note the discrepancy and defer to local patterns
+- Focus on NEW information not already present in codebase analysis
+
+Begin web research now. Provide 3-5 high-quality findings with FAR evaluations.`;
 /**
  * Research Agent
  *
@@ -25,6 +138,8 @@ export async function runResearchAgent(storyPath, sdlcRoot, options = {}) {
     try {
         // Gather codebase context
         const codebaseContext = await gatherCodebaseContext(sdlcRoot);
+        // Sanitize codebase context before including in prompt (prevent prompt injection)
+        const sanitizedContext = sanitizeCodebaseContext(codebaseContext);
         // Build the prompt, including rework context if this is a refinement iteration
         let prompt = `Please research how to implement this story:
 
@@ -34,7 +149,7 @@ Story content:
 ${story.content}
 
 Codebase context:
-${codebaseContext}`;
+${sanitizedContext}`;
         if (options.reworkContext) {
             prompt += `
 
@@ -62,11 +177,33 @@ Format your response as markdown for the Research section of the story.`;
             workingDirectory: path.dirname(sdlcRoot),
             onProgress: options.onProgress,
         });
-        // Append research to the story
-        await appendToSection(story, 'Research', researchContent);
-        changesMade.push('Added research findings');
-        // Mark research as complete
-        await updateStoryField(story, 'research_complete', true);
+        // Sanitize research content before storage (prevent ANSI/markdown injection)
+        const sanitizedResearch = sanitizeWebResearchContent(researchContent);
+        // Append codebase research to the story
+        await appendToSection(story, 'Research', sanitizedResearch);
+        changesMade.push('Added codebase research findings');
+        // Phase 2: Web Research (conditional)
+        if (shouldPerformWebResearch(story, sanitizedContext)) {
+            const webResearchContent = await performWebResearch(story, sanitizedContext, path.dirname(sdlcRoot), options.onProgress);
+            if (webResearchContent.trim()) {
+                // Sanitize web research content before storage (prevent ANSI/markdown injection)
+                const sanitizedWebResearch = sanitizeWebResearchContent(webResearchContent);
+                // Re-parse story to get updated content after codebase research
+                const updatedStory = parseStory(storyPath);
+                await appendToSection(updatedStory, 'Research', '\n## Web Research Findings\n\n' + sanitizedWebResearch);
+                changesMade.push('Added web research findings');
+            }
+            else {
+                getLogger().info('web-research', 'Web research returned empty - tools may be unavailable');
+                changesMade.push('Web research skipped: tools unavailable');
+            }
+        }
+        else {
+            changesMade.push('Web research skipped: no external dependencies detected');
+        }
+        // Mark research as complete - re-parse to get latest content including web research
+        const finalStory = parseStory(storyPath);
+        await updateStoryField(finalStory, 'research_complete', true);
         changesMade.push('Marked research_complete: true');
         return {
             success: true,
@@ -138,4 +275,262 @@ async function gatherCodebaseContext(sdlcRoot) {
     }
     return context.join('\n\n') || 'No codebase context available.';
 }
+/**
+ * Determine if web research would add value based on story content and codebase context.
+ *
+ * Web research is triggered when:
+ * 1. External dependencies are referenced (libraries, APIs, frameworks)
+ * 2. Unfamiliar APIs/patterns are mentioned
+ * 3. Library-specific documentation is needed
+ * 4. Best practices are requested
+ *
+ * Web research is skipped when:
+ * - Topic is purely internal (refactoring, moving code, internal utilities)
+ * - No external dependencies mentioned
+ */
+export function shouldPerformWebResearch(story, codebaseContext) {
+    const content = story.content.toLowerCase();
+    const title = story.frontmatter.title.toLowerCase();
+    const combinedText = `${title} ${content}`;
+    // Skip if purely internal keywords are dominant
+    for (const keyword of WEB_RESEARCH_INTERNAL_KEYWORDS) {
+        if (combinedText.includes(keyword)) {
+            // Sanitize keyword for logging (prevent log injection)
+            getLogger().info('web-research', `Skipping web research: purely internal topic detected (${sanitizeForLogging(keyword)})`);
+            return false;
+        }
+    }
+    // Trigger if external library/API/framework mentioned
+    for (const keyword of WEB_RESEARCH_EXTERNAL_KEYWORDS) {
+        if (combinedText.includes(keyword)) {
+            // Sanitize keyword for logging (prevent log injection)
+            getLogger().info('web-research', `Web research triggered: external keyword detected (${sanitizeForLogging(keyword)})`);
+            return true;
+        }
+    }
+    // Check for package.json mentions (suggests npm dependencies)
+    if (codebaseContext.includes('package.json') &&
+        (combinedText.includes('npm') || combinedText.includes('install') || combinedText.includes('dependency'))) {
+        getLogger().info('web-research', 'Web research triggered: npm dependency context detected');
+        return true;
+    }
+    // Default: skip web research for codebase-only topics
+    getLogger().info('web-research', 'Skipping web research: no external dependencies detected');
+    return false;
+}
+/**
+ * Maximum input length to prevent DoS attacks.
+ * Set to 10,000 chars to accommodate long research findings
+ * while preventing memory exhaustion from malicious inputs.
+ */
+const MAX_INPUT_LENGTH = 10000;
+/**
+ * Maximum log string length for readability and security.
+ * Prevents log injection and maintains log file readability.
+ */
+const MAX_LOG_LENGTH = 200;
+/**
+ * Sanitize web research content for safe storage and display.
+ * Removes ANSI escape sequences, control characters, and potential injection vectors.
+ *
+ * Security rationale: Web research content comes from external sources (LLM, web tools)
+ * and must be sanitized before storage to prevent:
+ * - ANSI injection (terminal control sequence attacks)
+ * - Markdown injection (malicious formatting)
+ * - Control character injection (null bytes, bell characters, etc.)
+ *
+ * @param text - Raw web research content from external source
+ * @returns Sanitized text safe for storage in markdown files
+ */
+export function sanitizeWebResearchContent(text) {
+    if (!text)
+        return '';
+    // Enforce maximum length to prevent DoS
+    if (text.length > MAX_INPUT_LENGTH) {
+        text = text.substring(0, MAX_INPUT_LENGTH);
+    }
+    // Remove ANSI CSI sequences (colors, cursor movement) - e.g., \x1B[31m
+    text = text.replace(/\x1B\[[^a-zA-Z\x1B]*[a-zA-Z]?/g, '');
+    // Remove OSC sequences (hyperlinks, window titles) - terminated by BEL (\x07) or ST (\x1B\\)
+    text = text.replace(/\x1B\][^\x07]*\x07/g, '');
+    text = text.replace(/\x1B\][^\x1B]*\x1B\\/g, '');
+    // Remove any remaining standalone escape characters
+    text = text.replace(/\x1B/g, '');
+    // Remove control characters (0x00-0x08, 0x0B-0x0C, 0x0E-0x1F, 0x7F-0x9F)
+    // eslint-disable-next-line no-control-regex
+    text = text.replace(/[\x00-\x08\x0B-\x0C\x0E-\x1F\x7F-\x9F]/g, '');
+    // Normalize Unicode to prevent homograph attacks and ensure consistent representation
+    text = text.normalize('NFC');
+    // Validate markdown structure - escape dangerous patterns
+    // Triple backticks could be used to break out of code blocks
+    text = text.replace(/```/g, '\\`\\`\\`');
+    return text;
+}
+/**
+ * Sanitize text for logging to prevent log injection attacks.
+ * Replaces newlines with spaces and truncates for readability.
+ *
+ * Security rationale: Log injection attacks use newlines to inject fake log entries.
+ * By replacing newlines with spaces, we ensure each log() call produces exactly one log line.
+ *
+ * @param text - Raw text that will be logged
+ * @returns Sanitized text safe for logging (single line, truncated)
+ */
+export function sanitizeForLogging(text) {
+    if (!text)
+        return '';
+    // Remove ANSI escape sequences
+    text = text.replace(/\x1B\[[^a-zA-Z\x1B]*[a-zA-Z]?/g, '');
+    text = text.replace(/\x1B\][^\x07]*\x07/g, '');
+    text = text.replace(/\x1B\][^\x1B]*\x1B\\/g, '');
+    text = text.replace(/\x1B/g, '');
+    // Replace newlines and carriage returns with spaces to prevent log injection
+    text = text.replace(/[\n\r]/g, ' ');
+    // Truncate to reasonable length for logs
+    if (text.length > MAX_LOG_LENGTH) {
+        text = text.substring(0, MAX_LOG_LENGTH) + '...';
+    }
+    return text.trim();
+}
+/**
+ * Sanitize codebase context before including in LLM prompts.
+ * Escapes dangerous patterns that could cause prompt injection.
+ *
+ * Security rationale: Codebase files may contain malicious content from:
+ * - Compromised dependencies
+ * - Malicious commits
+ * - Untrusted contributors
+ *
+ * We must prevent prompt injection by escaping patterns that could:
+ * - Terminate the prompt early (triple backticks)
+ * - Inject commands or instructions
+ * - Confuse the LLM's understanding of structure
+ *
+ * @param text - Raw codebase context
+ * @returns Sanitized text safe for LLM prompts
+ */
+export function sanitizeCodebaseContext(text) {
+    if (!text)
+        return '';
+    // Remove ANSI escape sequences
+    text = text.replace(/\x1B\[[^a-zA-Z\x1B]*[a-zA-Z]?/g, '');
+    text = text.replace(/\x1B\][^\x07]*\x07/g, '');
+    text = text.replace(/\x1B\][^\x1B]*\x1B\\/g, '');
+    text = text.replace(/\x1B/g, '');
+    // Escape triple backticks to prevent breaking out of code blocks
+    text = text.replace(/```/g, '\\`\\`\\`');
+    // Validate UTF-8 boundaries at truncation points
+    // If we need to truncate, ensure we don't split multi-byte characters
+    if (text.length > MAX_INPUT_LENGTH) {
+        // Use substring which is UTF-16 safe, then validate
+        let truncated = text.substring(0, MAX_INPUT_LENGTH);
+        // Check if we split a surrogate pair (0xD800-0xDFFF)
+        const lastCharCode = truncated.charCodeAt(truncated.length - 1);
+        if (lastCharCode >= 0xD800 && lastCharCode <= 0xDFFF) {
+            // We split a surrogate pair, remove the incomplete character
+            truncated = truncated.substring(0, truncated.length - 1);
+        }
+        text = truncated;
+    }
+    return text;
+}
+/**
+ * Parse FAR evaluation from web research finding text.
+ * Expected format from LLM:
+ * **FAR Score**: Factuality: 5, Actionability: 4, Relevance: 5
+ * **Justification**: Official documentation provides...
+ *
+ * Returns default scores (2, 2, 2) with parsingSucceeded: false if parsing fails.
+ * Default of 2 (rather than 3) indicates uncertainty rather than average quality.
+ *
+ * @param finding - Web research finding text to parse
+ * @returns FARScore with parsed or default values and parsing status
+ */
+export function evaluateFAR(finding) {
+    // Enforce maximum length to prevent ReDoS attacks
+    if (finding.length > MAX_INPUT_LENGTH) {
+        finding = finding.substring(0, MAX_INPUT_LENGTH);
+    }
+    try {
+        // Look for FAR score pattern
+        const scoreMatch = finding.match(/\*\*FAR Score\*\*:.*?Factuality:\s*(\d+).*?Actionability:\s*(\d+).*?Relevance:\s*(\d+)/i);
+        const justificationMatch = finding.match(/\*\*Justification\*\*:\s*(.+?)(?:\n\n|\n#|$)/is);
+        if (scoreMatch && justificationMatch) {
+            const factuality = parseInt(scoreMatch[1], 10);
+            const actionability = parseInt(scoreMatch[2], 10);
+            const relevance = parseInt(scoreMatch[3], 10);
+            const justification = justificationMatch[1].trim();
+            // Validate scores are in range 1-5
+            if ([factuality, actionability, relevance].every(s => s >= 1 && s <= 5)) {
+                return {
+                    factuality,
+                    actionability,
+                    relevance,
+                    justification,
+                    parsingSucceeded: true,
+                };
+            }
+            else {
+                getLogger().warn('web-research', 'FAR scores out of valid range (1-5), using defaults');
+            }
+        }
+        else if (scoreMatch && !justificationMatch) {
+            getLogger().warn('web-research', 'FAR justification missing, using defaults');
+        }
+        else if (!scoreMatch && justificationMatch) {
+            getLogger().warn('web-research', 'FAR scores not found in finding, using defaults');
+        }
+        else {
+            getLogger().warn('web-research', 'FAR scores and justification not found in finding, using defaults');
+        }
+        // If parsing failed, return default scores (2/5 indicates uncertainty)
+        return {
+            factuality: 2,
+            actionability: 2,
+            relevance: 2,
+            justification: 'FAR scores could not be parsed from finding. Default scores (2/5) applied.',
+            parsingSucceeded: false,
+        };
+    }
+    catch (error) {
+        getLogger().error('web-research', 'Error parsing FAR scores', { error });
+        return {
+            factuality: 2,
+            actionability: 2,
+            relevance: 2,
+            justification: 'Error parsing FAR evaluation',
+            parsingSucceeded: false,
+        };
+    }
+}
+/**
+ * Perform web research using Context7/WebSearch/WebFetch.
+ * Returns formatted markdown with FAR evaluations, or empty string if all tools unavailable.
+ */
+async function performWebResearch(story, codebaseContext, workingDir, onProgress) {
+    const logger = getLogger();
+    logger.info('web-research', 'Starting web research phase', { storyId: story.frontmatter.id });
+    try {
+        const sanitizedContext = sanitizeCodebaseContext(codebaseContext.substring(0, 2000));
+        const webResearchPrompt = WEB_RESEARCH_PROMPT_TEMPLATE(story.frontmatter.title, story.content, sanitizedContext);
+        const webResearchResult = await runAgentQuery({
+            prompt: webResearchPrompt,
+            systemPrompt: 'You are a web research specialist. Use available tools to find authoritative documentation and best practices.',
+            workingDirectory: workingDir,
+            onProgress,
+        });
+        // Check if web tools were unavailable
+        if (webResearchResult.toLowerCase().includes('web research tools unavailable')) {
+            logger.info('web-research', 'Web research tools unavailable, skipping');
+            return '';
+        }
+        logger.info('web-research', 'Web research completed successfully');
+        return webResearchResult;
+    }
+    catch (error) {
+        logger.error('web-research', 'Web research failed', { error });
+        // Gracefully degrade - return empty string to continue with codebase-only research
+        return '';
+    }
+}
 //# sourceMappingURL=research.js.map

package/dist/agents/research.js.map

@@ -1 +1 @@
-{"version":3,"file":"research.js","sourceRoot":"","sources":["../../src/agents/research.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../src/agents/research.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAc,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAyB,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,sBAAsB,GAAG;;;;;;;;;kGASmE,CAAC;AAEnG;;;GAGG;AACH,MAAM,8BAA8B,GAAG;IACrC,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,mBAAmB;IACnB,WAAW;IACX,qBAAqB;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,8BAA8B,GAAG;IACrC,WAAW;IACX,KAAK;IACL,SAAS;IACT,WAAW;IACX,gBAAgB;IAChB,aAAa;IACb,UAAU;IACV,aAAa;IACb,KAAK;IACL,eAAe;IACf,SAAS;IACT,UAAU;IACV,SAAS;IACT,OAAO;IACP,yBAAyB;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,4BAA4B,GAAG,CAAC,UAAkB,EAAE,YAAoB,EAAE,eAAuB,EAAE,EAAE,CAAC;;mBAEzF,UAAU;;;EAG3B,YAAY;;;EAGZ,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFAgE+D,CAAC;AASjF;;;;;GAKG;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;IAEjC,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,eAAe,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAE9D,kFAAkF;QAClF,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,eAAe,CAAC,CAAC;QAElE,+EAA+E;QAC/E,IAAI,MAAM,GAAG;;SAER,KAAK,CAAC,WAAW,CAAC,KAAK;;;EAG9B,KAAK,CAAC,OAAO;;;EAGb,gBAAgB,EAAE,CAAC;QAEjB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,IAAI;;;EAGd,OAAO,CAAC,aAAa;;;;;kDAK2B,CAAC;QAC/C,CAAC;QAED,MAAM,IAAI;;;;;;;;;wEAS0D,CAAC;QAErE,MAAM,eAAe,GAAG,MAAM,aAAa,CAAC;YAC1C,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,6EAA6E;QAC7E,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,eAAe,CAAC,CAAC;QAEtE,wCAAwC;QACxC,MAAM,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC5D,WAAW,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAErD,sCAAsC;QACtC,IAAI,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC;YACtD,MAAM,kBAAkB,GAAG,MAAM,kBAAkB,CACjD,KAAK,EACL,gBAAgB,EAChB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EACtB,OAAO,CAAC,UAAU,CACnB,CAAC;YAEF,IAAI,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9B,iFAAiF;gBACjF,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;gBAE5E,gEAAgE;gBAChE,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBAC3C,MAAM,eAAe,CAAC,YAAY,EAAE,UAAU,EAAE,gCAAgC,GAAG,oBAAoB,CAAC,CAAC;gBACzG,WAAW,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,wDAAwD,CAAC,CAAC;gBAC3F,WAAW,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QAC9E,CAAC;QAED,oFAAoF;QACpF,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAC9D,WAAW,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAEnD,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;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAAC,QAAgB;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,iCAAiC;IACjC,MAAM,YAAY,GAAG;QACnB,cAAc;QACd,eAAe;QACf,gBAAgB;QAChB,YAAY;QACZ,QAAQ;KACT,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,OAAO;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC;aACpF,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM,KAAK,GAAG,OAAO;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpB,OAAO,CAAC,IAAI,CAAC,6CAA6C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,2BAA2B,EAAE;YAC1D,GAAG,EAAE,UAAU;YACf,MAAM,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,UAAU,CAAC;SACnD,CAAC,CAAC;QAEH,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,yBAAyB,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,gCAAgC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAY,EAAE,eAAuB;IAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;IAE3C,gDAAgD;IAChD,KAAK,MAAM,OAAO,IAAI,8BAA8B,EAAE,CAAC;QACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,uDAAuD;YACvD,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,0DAA0D,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3H,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,KAAK,MAAM,OAAO,IAAI,8BAA8B,EAAE,CAAC;QACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,uDAAuD;YACvD,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,sDAAsD,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACvH,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC;QACxC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAC9G,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,yDAAyD,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,0DAA0D,CAAC,CAAC;IAC7F,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B;;;GAGG;AACH,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,wCAAwC;IACxC,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACnC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC7C,CAAC;IAED,uEAAuE;IACvE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;IAE1D,6FAA6F;IAC7F,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IAEjD,oDAAoD;IACpD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEjC,yEAAyE;IACzE,4CAA4C;IAC5C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,yCAAyC,EAAE,EAAE,CAAC,CAAC;IAEnE,sFAAsF;IACtF,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE7B,0DAA0D;IAC1D,6DAA6D;IAC7D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,+BAA+B;IAC/B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;IAC1D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEjC,6EAA6E;IAC7E,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAEpC,yCAAyC;IACzC,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,+BAA+B;IAC/B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;IAC1D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEjC,iEAAiE;IACjE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEzC,iDAAiD;IACjD,sEAAsE;IACtE,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACnC,oDAAoD;QACpD,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAEpD,qDAAqD;QACrD,MAAM,YAAY,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAChE,IAAI,YAAY,IAAI,MAAM,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;YACrD,6DAA6D;YAC7D,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,kDAAkD;IAClD,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACtC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,yFAAyF,CAAC,CAAC;QAC5H,MAAM,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAE3F,IAAI,UAAU,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAsB,CAAC;YACpE,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAsB,CAAC;YACvE,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAsB,CAAC;YACnE,MAAM,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEnD,mCAAmC;YACnC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACxE,OAAO;oBACL,UAAU;oBACV,aAAa;oBACb,SAAS;oBACT,aAAa;oBACb,gBAAgB,EAAE,IAAI;iBACvB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,qDAAqD,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;aAAM,IAAI,UAAU,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7C,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,2CAA2C,CAAC,CAAC;QAChF,CAAC;aAAM,IAAI,CAAC,UAAU,IAAI,kBAAkB,EAAE,CAAC;YAC7C,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,iDAAiD,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACN,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,mEAAmE,CAAC,CAAC;QACxG,CAAC;QAED,uEAAuE;QACvE,OAAO;YACL,UAAU,EAAE,CAAC;YACb,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,4EAA4E;YAC3F,gBAAgB,EAAE,KAAK;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,OAAO;YACL,UAAU,EAAE,CAAC;YACb,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,8BAA8B;YAC7C,gBAAgB,EAAE,KAAK;SACxB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAC/B,KAAY,EACZ,eAAuB,EACvB,UAAkB,EAClB,UAAkC;IAElC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,6BAA6B,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IAE9F,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACrF,MAAM,iBAAiB,GAAG,4BAA4B,CACpD,KAAK,CAAC,WAAW,CAAC,KAAK,EACvB,KAAK,CAAC,OAAO,EACb,gBAAgB,CACjB,CAAC;QAEF,MAAM,iBAAiB,GAAG,MAAM,aAAa,CAAC;YAC5C,MAAM,EAAE,iBAAiB;YACzB,YAAY,EAAE,gHAAgH;YAC9H,gBAAgB,EAAE,UAAU;YAC5B,UAAU;SACX,CAAC,CAAC;QAEH,sCAAsC;QACtC,IAAI,iBAAiB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,0CAA0C,CAAC,CAAC;YACxE,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,qCAAqC,CAAC,CAAC;QACnE,OAAO,iBAAiB,CAAC;IAE3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,mFAAmF;QACnF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/agents/review.ts"],"names":[],"mappings":"AAOA,OAAO,EAAS,WAAW,EAAE,YAAY,EAAE,WAAW,EAA8E,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkH5K;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CA0BlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAOrE;AAiBD;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAsVrJ;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA+F1F;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;CACvD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA0PvB;AAgCD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAgItB"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/agents/review.ts"],"names":[],"mappings":"AAQA,OAAO,EAAS,WAAW,EAAE,YAAY,EAAE,WAAW,EAA8E,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkH5K;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CA0BlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAOrE;AAiBD;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAsVrJ;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA+F1F;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;CACvD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA+QvB;AAgCD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAgItB"}

package/dist/agents/review.js

@@ -4,6 +4,7 @@ import fs from 'fs';
 import { z } from 'zod';
 import { parseStory, updateStoryStatus, appendToSection, updateStoryField, isAtMaxRetries, appendReviewHistory, snapshotMaxRetries, getEffectiveMaxRetries } from '../core/story.js';
 import { runAgentQuery } from '../core/client.js';
+import { getLogger } from '../core/logger.js';
 import { loadConfig, DEFAULT_TIMEOUTS } from '../core/config.js';
 import { ReviewDecision, ReviewSeverity } from '../types/index.js';
 import { sanitizeInput, truncateText } from '../cli/formatting.js';
@@ -526,9 +527,15 @@ export function generateReviewSummary(issues, terminalWidth) {
  * Now returns structured ReviewResult with pass/fail and issues.
  */
 export async function runReviewAgent(storyPath, sdlcRoot, options) {
+    const logger = getLogger();
+    const startTime = Date.now();
     const story = parseStory(storyPath);
     const changesMade = [];
     const workingDir = path.dirname(sdlcRoot);
+    logger.info('review', 'Starting review phase', {
+        storyId: story.frontmatter.id,
+        retryCount: story.frontmatter.retry_count || 0,
+    });
     // Security: Validate working directory before any operations
     try {
         validateWorkingDirectory(workingDir);
@@ -724,6 +731,13 @@ ${passed ? '✅ **PASSED** - All reviews approved' : '❌ **FAILED** - Issues mu
             changesMade.push(`Reviews failed with ${allIssues.length} issue(s) - rework required`);
             // Don't mark reviews_complete, this will trigger rework
         }
+        logger.info('review', 'Review phase complete', {
+            storyId: story.frontmatter.id,
+            durationMs: Date.now() - startTime,
+            passed,
+            decision,
+            issueCount: allIssues.length,
+        });
         return {
             success: true,
             story: parseStory(storyPath),
@@ -739,6 +753,11 @@ ${passed ? '✅ **PASSED** - All reviews approved' : '❌ **FAILED** - Issues mu
     catch (error) {
         // Review agent failure - return FAILED decision (doesn't count as retry)
         const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.error('review', 'Review phase failed', {
+            storyId: story.frontmatter.id,
+            durationMs: Date.now() - startTime,
+            error: errorMsg,
+        });
         return {
             success: false,
             story,