ai-sdlc 0.2.0-beta.1 → 0.2.1-alpha.1

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/core/llm-utils.d.ts

@@ -0,0 +1,103 @@
+import { ZodSchema } from 'zod';
+/**
+ * Result of structured response extraction
+ */
+export interface ExtractionResult<T> {
+    success: boolean;
+    data?: T;
+    strategy?: ExtractionStrategy;
+    error?: string;
+    rawResponse?: string;
+}
+/**
+ * Extraction strategies in priority order
+ */
+export type ExtractionStrategy = 'direct_json' | 'markdown_json_block' | 'stripped_json' | 'yaml_fallback';
+/**
+ * Options for structured response extraction
+ */
+export interface ExtractionOptions {
+    /** Maximum retry attempts if extraction fails (default: 0 - no retries) */
+    maxRetries?: number;
+    /** Function to call LLM for retry (required if maxRetries > 0) */
+    retryFn?: (clarificationPrompt: string) => Promise<string>;
+    /** Log raw response on failure for debugging (default: true) */
+    logOnFailure?: boolean;
+}
+/**
+ * Try to extract JSON directly from the response
+ */
+declare function tryDirectJson<T>(response: string, schema: ZodSchema<T>): ExtractionResult<T>;
+/**
+ * Try to extract JSON from markdown code blocks
+ * Supports ```json, ```JSON, and plain ``` blocks
+ */
+declare function tryMarkdownJsonBlock<T>(response: string, schema: ZodSchema<T>): ExtractionResult<T>;
+/**
+ * Try to extract JSON by stripping leading/trailing text
+ * Finds the first { and last } to extract potential JSON
+ */
+declare function tryStrippedJson<T>(response: string, schema: ZodSchema<T>): ExtractionResult<T>;
+/**
+ * Try to parse response as YAML
+ */
+declare function tryYamlFallback<T>(response: string, schema: ZodSchema<T>): ExtractionResult<T>;
+/**
+ * Extract structured response from LLM output using multiple strategies
+ *
+ * Tries extraction strategies in order:
+ * 1. Direct JSON parse (response is pure JSON)
+ * 2. JSON within markdown code blocks (\`\`\`json ... \`\`\`)
+ * 3. JSON with leading/trailing text stripped
+ * 4. YAML format fallback
+ *
+ * If all strategies fail and retries are configured, prompts the LLM
+ * to try again with clearer instructions.
+ *
+ * @param response - Raw LLM response string
+ * @param schema - Zod schema to validate against
+ * @param options - Extraction options including retry configuration
+ * @returns ExtractionResult with success status, data, and metadata
+ *
+ * @example
+ * ```typescript
+ * const ReviewSchema = z.object({
+ *   passed: z.boolean(),
+ *   issues: z.array(z.object({
+ *     severity: z.enum(['blocker', 'critical', 'major', 'minor']),
+ *     description: z.string(),
+ *   })),
+ * });
+ *
+ * const result = await extractStructuredResponse(llmResponse, ReviewSchema, {
+ *   maxRetries: 2,
+ *   retryFn: async (prompt) => await callLLM(prompt),
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Parsed review:', result.data);
+ * } else {
+ *   console.error('Failed to parse:', result.error);
+ * }
+ * ```
+ */
+export declare function extractStructuredResponse<T>(response: string, schema: ZodSchema<T>, options?: ExtractionOptions): Promise<ExtractionResult<T>>;
+/**
+ * Synchronous version of extractStructuredResponse without retry support
+ *
+ * Useful when you don't need retry functionality or are in a synchronous context.
+ *
+ * @param response - Raw LLM response string
+ * @param schema - Zod schema to validate against
+ * @param logOnFailure - Whether to log the raw response on failure (default: true)
+ * @returns ExtractionResult with success status, data, and metadata
+ */
+export declare function extractStructuredResponseSync<T>(response: string, schema: ZodSchema<T>, logOnFailure?: boolean): ExtractionResult<T>;
+export declare const extractionStrategies: {
+    tryDirectJson: typeof tryDirectJson;
+    tryMarkdownJsonBlock: typeof tryMarkdownJsonBlock;
+    tryStrippedJson: typeof tryStrippedJson;
+    tryYamlFallback: typeof tryYamlFallback;
+};
+export {};
+//# sourceMappingURL=llm-utils.d.ts.map

package/dist/core/llm-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-utils.d.ts","sourceRoot":"","sources":["../../src/core/llm-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,SAAS,EAAE,MAAM,KAAK,CAAC;AAInC;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,qBAAqB,GACrB,eAAe,GACf,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,iBAAS,aAAa,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GACnB,gBAAgB,CAAC,CAAC,CAAC,CAyBrB;AAED;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GACnB,gBAAgB,CAAC,CAAC,CAAC,CA0BrB;AAED;;;GAGG;AACH,iBAAS,eAAe,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GACnB,gBAAgB,CAAC,CAAC,CAAC,CAqDrB;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GACnB,gBAAgB,CAAC,CAAC,CAAC,CA4DrB;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CA4F9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAC7C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,YAAY,UAAO,GAClB,gBAAgB,CAAC,CAAC,CAAC,CA+CrB;AAGD,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAC"}

package/dist/core/llm-utils.js

@@ -0,0 +1,368 @@
+import { z } from 'zod';
+import yaml from 'js-yaml';
+import { getLogger } from './logger.js';
+/**
+ * Try to extract JSON directly from the response
+ */
+function tryDirectJson(response, schema) {
+    try {
+        const trimmed = response.trim();
+        // Must start with { or [ to be valid JSON
+        if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {
+            return { success: false, error: 'Response does not start with JSON' };
+        }
+        const parsed = JSON.parse(trimmed);
+        const result = schema.safeParse(parsed);
+        if (result.success) {
+            return { success: true, data: result.data, strategy: 'direct_json' };
+        }
+        return {
+            success: false,
+            error: `Schema validation failed: ${result.error.message}`,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: `JSON parse error: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * Try to extract JSON from markdown code blocks
+ * Supports ```json, ```JSON, and plain ``` blocks
+ */
+function tryMarkdownJsonBlock(response, schema) {
+    // Match JSON in code blocks: ```json ... ``` or ``` ... ```
+    const codeBlockRegex = /```(?:json|JSON)?\s*\n?([\s\S]*?)```/g;
+    const matches = [...response.matchAll(codeBlockRegex)];
+    for (const match of matches) {
+        const content = match[1].trim();
+        if (!content)
+            continue;
+        try {
+            const parsed = JSON.parse(content);
+            const result = schema.safeParse(parsed);
+            if (result.success) {
+                return { success: true, data: result.data, strategy: 'markdown_json_block' };
+            }
+        }
+        catch {
+            // Try next match
+            continue;
+        }
+    }
+    return {
+        success: false,
+        error: 'No valid JSON found in markdown code blocks',
+    };
+}
+/**
+ * Try to extract JSON by stripping leading/trailing text
+ * Finds the first { and last } to extract potential JSON
+ */
+function tryStrippedJson(response, schema) {
+    const firstBrace = response.indexOf('{');
+    const lastBrace = response.lastIndexOf('}');
+    if (firstBrace === -1 || lastBrace === -1 || firstBrace >= lastBrace) {
+        // Try array format
+        const firstBracket = response.indexOf('[');
+        const lastBracket = response.lastIndexOf(']');
+        if (firstBracket === -1 || lastBracket === -1 || firstBracket >= lastBracket) {
+            return { success: false, error: 'No JSON object or array found in response' };
+        }
+        try {
+            const jsonStr = response.substring(firstBracket, lastBracket + 1);
+            const parsed = JSON.parse(jsonStr);
+            const result = schema.safeParse(parsed);
+            if (result.success) {
+                return { success: true, data: result.data, strategy: 'stripped_json' };
+            }
+            return {
+                success: false,
+                error: `Schema validation failed: ${result.error.message}`,
+            };
+        }
+        catch (e) {
+            return {
+                success: false,
+                error: `Stripped JSON parse error: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+    }
+    try {
+        const jsonStr = response.substring(firstBrace, lastBrace + 1);
+        const parsed = JSON.parse(jsonStr);
+        const result = schema.safeParse(parsed);
+        if (result.success) {
+            return { success: true, data: result.data, strategy: 'stripped_json' };
+        }
+        return {
+            success: false,
+            error: `Schema validation failed: ${result.error.message}`,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: `Stripped JSON parse error: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * Try to parse response as YAML
+ */
+function tryYamlFallback(response, schema) {
+    try {
+        // First try to extract YAML from code blocks
+        const yamlBlockRegex = /```(?:yaml|YAML|yml|YML)\s*\n?([\s\S]*?)```/g;
+        const matches = [...response.matchAll(yamlBlockRegex)];
+        for (const match of matches) {
+            const content = match[1].trim();
+            if (!content)
+                continue;
+            try {
+                const parsed = yaml.load(content);
+                const result = schema.safeParse(parsed);
+                if (result.success) {
+                    return { success: true, data: result.data, strategy: 'yaml_fallback' };
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        // Try parsing the whole response as YAML (after stripping obvious non-YAML parts)
+        // Skip lines that look like prose (sentences without colons)
+        const lines = response.split('\n');
+        const yamlLines = [];
+        let inYamlSection = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Start of YAML-like content
+            if (trimmed.includes(':') || trimmed.startsWith('-') || inYamlSection) {
+                yamlLines.push(line);
+                inYamlSection = true;
+            }
+            // Empty line might end YAML section if we haven't found valid content
+            if (trimmed === '' && yamlLines.length > 0) {
+                inYamlSection = false;
+            }
+        }
+        if (yamlLines.length > 0) {
+            const yamlContent = yamlLines.join('\n');
+            const parsed = yaml.load(yamlContent);
+            const result = schema.safeParse(parsed);
+            if (result.success) {
+                return { success: true, data: result.data, strategy: 'yaml_fallback' };
+            }
+        }
+        return { success: false, error: 'No valid YAML found in response' };
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: `YAML parse error: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * Generate a clarification prompt for retry attempts
+ */
+function generateClarificationPrompt(schema, attemptNumber, lastError) {
+    // Get schema shape for the prompt
+    let schemaDescription = 'the expected JSON structure';
+    try {
+        if (schema instanceof z.ZodObject) {
+            const shape = schema.shape;
+            const fields = Object.keys(shape).join(', ');
+            schemaDescription = `an object with fields: ${fields}`;
+        }
+    }
+    catch {
+        // Fall back to generic description
+    }
+    return `Your previous response could not be parsed. Attempt ${attemptNumber} failed with: ${lastError}
+
+Please respond with ONLY valid JSON matching ${schemaDescription}.
+
+Rules:
+1. Start your response directly with { or [
+2. Do not include any text before or after the JSON
+3. Ensure all strings are properly escaped
+4. Ensure all required fields are present
+
+Try again:`;
+}
+/**
+ * Extract structured response from LLM output using multiple strategies
+ *
+ * Tries extraction strategies in order:
+ * 1. Direct JSON parse (response is pure JSON)
+ * 2. JSON within markdown code blocks (\`\`\`json ... \`\`\`)
+ * 3. JSON with leading/trailing text stripped
+ * 4. YAML format fallback
+ *
+ * If all strategies fail and retries are configured, prompts the LLM
+ * to try again with clearer instructions.
+ *
+ * @param response - Raw LLM response string
+ * @param schema - Zod schema to validate against
+ * @param options - Extraction options including retry configuration
+ * @returns ExtractionResult with success status, data, and metadata
+ *
+ * @example
+ * ```typescript
+ * const ReviewSchema = z.object({
+ *   passed: z.boolean(),
+ *   issues: z.array(z.object({
+ *     severity: z.enum(['blocker', 'critical', 'major', 'minor']),
+ *     description: z.string(),
+ *   })),
+ * });
+ *
+ * const result = await extractStructuredResponse(llmResponse, ReviewSchema, {
+ *   maxRetries: 2,
+ *   retryFn: async (prompt) => await callLLM(prompt),
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Parsed review:', result.data);
+ * } else {
+ *   console.error('Failed to parse:', result.error);
+ * }
+ * ```
+ */
+export async function extractStructuredResponse(response, schema, options = {}) {
+    const { maxRetries = 0, retryFn, logOnFailure = true } = options;
+    const logger = getLogger();
+    // Store all errors for debugging
+    const errors = [];
+    // Strategy 1: Direct JSON
+    const directResult = tryDirectJson(response, schema);
+    if (directResult.success) {
+        return directResult;
+    }
+    errors.push(`direct_json: ${directResult.error}`);
+    // Strategy 2: Markdown JSON block
+    const markdownResult = tryMarkdownJsonBlock(response, schema);
+    if (markdownResult.success) {
+        return markdownResult;
+    }
+    errors.push(`markdown_json_block: ${markdownResult.error}`);
+    // Strategy 3: Stripped JSON
+    const strippedResult = tryStrippedJson(response, schema);
+    if (strippedResult.success) {
+        return strippedResult;
+    }
+    errors.push(`stripped_json: ${strippedResult.error}`);
+    // Strategy 4: YAML fallback
+    const yamlResult = tryYamlFallback(response, schema);
+    if (yamlResult.success) {
+        return yamlResult;
+    }
+    errors.push(`yaml_fallback: ${yamlResult.error}`);
+    // All strategies failed - try retries if configured
+    if (maxRetries > 0 && retryFn) {
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            logger.info('llm-utils', `Retry attempt ${attempt}/${maxRetries} for structured response extraction`);
+            const clarificationPrompt = generateClarificationPrompt(schema, attempt, errors[errors.length - 1]);
+            try {
+                const retryResponse = await retryFn(clarificationPrompt);
+                // Try all strategies again on retry response
+                const retryDirectResult = tryDirectJson(retryResponse, schema);
+                if (retryDirectResult.success) {
+                    return retryDirectResult;
+                }
+                const retryMarkdownResult = tryMarkdownJsonBlock(retryResponse, schema);
+                if (retryMarkdownResult.success) {
+                    return retryMarkdownResult;
+                }
+                const retryStrippedResult = tryStrippedJson(retryResponse, schema);
+                if (retryStrippedResult.success) {
+                    return retryStrippedResult;
+                }
+                const retryYamlResult = tryYamlFallback(retryResponse, schema);
+                if (retryYamlResult.success) {
+                    return retryYamlResult;
+                }
+                errors.push(`retry_${attempt}: All strategies failed`);
+            }
+            catch (e) {
+                errors.push(`retry_${attempt}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+    // All attempts failed
+    const finalError = `All extraction strategies failed:\n${errors.join('\n')}`;
+    if (logOnFailure) {
+        logger.error('llm-utils', 'Failed to extract structured response', {
+            errors,
+            responsePreview: response.substring(0, 500),
+        });
+    }
+    return {
+        success: false,
+        error: finalError,
+        rawResponse: response,
+    };
+}
+/**
+ * Synchronous version of extractStructuredResponse without retry support
+ *
+ * Useful when you don't need retry functionality or are in a synchronous context.
+ *
+ * @param response - Raw LLM response string
+ * @param schema - Zod schema to validate against
+ * @param logOnFailure - Whether to log the raw response on failure (default: true)
+ * @returns ExtractionResult with success status, data, and metadata
+ */
+export function extractStructuredResponseSync(response, schema, logOnFailure = true) {
+    const logger = getLogger();
+    const errors = [];
+    // Strategy 1: Direct JSON
+    const directResult = tryDirectJson(response, schema);
+    if (directResult.success) {
+        return directResult;
+    }
+    errors.push(`direct_json: ${directResult.error}`);
+    // Strategy 2: Markdown JSON block
+    const markdownResult = tryMarkdownJsonBlock(response, schema);
+    if (markdownResult.success) {
+        return markdownResult;
+    }
+    errors.push(`markdown_json_block: ${markdownResult.error}`);
+    // Strategy 3: Stripped JSON
+    const strippedResult = tryStrippedJson(response, schema);
+    if (strippedResult.success) {
+        return strippedResult;
+    }
+    errors.push(`stripped_json: ${strippedResult.error}`);
+    // Strategy 4: YAML fallback
+    const yamlResult = tryYamlFallback(response, schema);
+    if (yamlResult.success) {
+        return yamlResult;
+    }
+    errors.push(`yaml_fallback: ${yamlResult.error}`);
+    // All attempts failed
+    const finalError = `All extraction strategies failed:\n${errors.join('\n')}`;
+    if (logOnFailure) {
+        logger.error('llm-utils', 'Failed to extract structured response', {
+            errors,
+            responsePreview: response.substring(0, 500),
+        });
+    }
+    return {
+        success: false,
+        error: finalError,
+        rawResponse: response,
+    };
+}
+// Export individual strategies for testing
+export const extractionStrategies = {
+    tryDirectJson,
+    tryMarkdownJsonBlock,
+    tryStrippedJson,
+    tryYamlFallback,
+};
+//# sourceMappingURL=llm-utils.js.map

package/dist/core/llm-utils.js.map

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

package/dist/core/story.d.ts

@@ -1,4 +1,4 @@
-import { Story, StoryFrontmatter, StoryStatus, ReviewAttempt, Config, LockOptions } from '../types/index.js';
+import { Story, StoryFrontmatter, StoryStatus, ReviewAttempt, Config, LockOptions, ReviewResult } from '../types/index.js';
 /**
  * Parse a story markdown file into a Story object
  *
@@ -160,6 +160,16 @@ export declare function getLatestReviewAttempt(story: Story): ReviewAttempt | nu
  * Mark a story as complete (all workflow flags set to true)
  */
 export declare function markStoryComplete(story: Story): Promise<Story>;
+/**
+ * Auto-complete story after review approval
+ * Handles marking story as complete and transitioning to done status
+ *
+ * @param story - The story to auto-complete
+ * @param config - The configuration containing reviewConfig settings
+ * @param reviewResult - The result from the review agent
+ * @returns Updated story if auto-completion occurred, original story otherwise
+ */
+export declare function autoCompleteStoryAfterReview(story: Story, config: Config, reviewResult: ReviewResult): Promise<Story>;
 /**
  * Snapshot max_retries from config to story frontmatter (for mid-cycle config change protection)
  */

package/dist/core/story.d.ts.map

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

package/dist/core/story.js

@@ -2,7 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import matter from 'gray-matter';
 import * as properLockfile from 'proper-lockfile';
-import { FOLDER_TO_STATUS, BLOCKED_DIR, STORIES_FOLDER, STORY_FILENAME, DEFAULT_PRIORITY_GAP } from '../types/index.js';
+import { FOLDER_TO_STATUS, BLOCKED_DIR, STORIES_FOLDER, STORY_FILENAME, DEFAULT_PRIORITY_GAP, ReviewDecision } from '../types/index.js';
 /**
  * Parse a story markdown file into a Story object
  *
@@ -615,6 +615,38 @@ export async function markStoryComplete(story) {
     await writeStory(story);
     return story;
 }
+/**
+ * Auto-complete story after review approval
+ * Handles marking story as complete and transitioning to done status
+ *
+ * @param story - The story to auto-complete
+ * @param config - The configuration containing reviewConfig settings
+ * @param reviewResult - The result from the review agent
+ * @returns Updated story if auto-completion occurred, original story otherwise
+ */
+export async function autoCompleteStoryAfterReview(story, config, reviewResult) {
+    // Only auto-complete if review was approved and config allows it
+    if (reviewResult.decision !== ReviewDecision.APPROVED) {
+        return story;
+    }
+    if (!config.reviewConfig.autoCompleteOnApproval) {
+        return story;
+    }
+    try {
+        // Mark all workflow flags as complete
+        story = await markStoryComplete(story);
+        // Update status to done if currently in-progress
+        if (story.frontmatter.status === 'in-progress') {
+            story = await updateStoryStatus(story, 'done');
+        }
+        return story;
+    }
+    catch (error) {
+        // Log error but don't fail the entire review operation
+        console.error('Failed to auto-complete story after review:', error);
+        return story;
+    }
+}
 /**
  * Snapshot max_retries from config to story frontmatter (for mid-cycle config change protection)
  */