edsger 0.77.0 → 0.78.0

package/dist/phases/user-psychology/prompts.js

@@ -1,41 +0,0 @@
-import { processConditionals, resolveSkill, } from '../../services/skill-resolver.js';
-import { OUTPUT_CONTRACTS } from '../output-contracts.js';
-export const createUserPsychologySystemPrompt = async (hasCodebase = false, projectDir) => {
-    const skill = await resolveSkill('phase/user-psychology', { projectDir });
-    if (!skill) {
-        throw new Error('Failed to load skill: phase/user-psychology');
-    }
-    let { prompt } = skill;
-    prompt = processConditionals(prompt, { hasCodebase });
-    return `${prompt}
-
-${OUTPUT_CONTRACTS['user-psychology']}`;
-};
-export const createUserPsychologyPromptWithContext = (productId, contextInfo, hasCodebase = false) => {
-    const codebaseInstructions = hasCodebase
-        ? `
-**Step 1 - Explore the codebase FIRST**: Before writing any persona or job, use your file reading tools to actually open this project. Look at:
-- README.md, CLAUDE.md, package.json for what the product claims to be
-- Landing pages, marketing copy, documentation
-- The 3-5 highest-leverage source files / features
-- Any UI flows that hint at the user's workflow
-
-**Step 2 - Build the profile**: Now, using what you discovered AND the context below:`
-        : `
-**Build the profile**: Using the product context below:`;
-    return `Please produce a rigorous user psychology profile for product ID: ${productId}
-
-${contextInfo}
-
-## Analysis Instructions
-${codebaseInstructions}
-1. Apply all 6 frameworks defined in your system prompt (Personas, JTBD, Pain Points, Motivations, Behavior Triggers, Messaging Angles).
-2. Every persona, job, and pain you produce must be traceable to a specific feature, file, or context line — cite the evidence inline.
-3. Cover at least one EMOTIONAL and one SOCIAL job in jobs_to_be_done — not only functional ones.
-4. Pain points must be written in the USER'S voice ("I keep losing track of…"), not yours ("users struggle with…").
-5. Messaging angles must each tie back to a specific persona name and a specific JTBD statement.
-
-**CRITICAL**: No placeholders. No "[insert role]". No generic "users want to be productive." Be concrete or be silent.
-
-Return ONLY the JSON response as specified in your instructions.`;
-};

package/dist/phases/user-stories-analysis/agent.d.ts

@@ -1,9 +0,0 @@
-import { type EdsgerConfig, type WithExecutionSessionId } from '../../types/index.js';
-interface ParsedAnalysisResult {
-    analysis?: any;
-    error?: string;
-}
-export type AnalysisQueryResult = Record<string, unknown> & WithExecutionSessionId;
-export declare function parseAnalysisResult(responseText: string): ParsedAnalysisResult;
-export declare function executeUserStoriesAnalysisQuery(currentPrompt: string, systemPrompt: string, config: EdsgerConfig, verbose?: boolean): Promise<AnalysisQueryResult | null>;
-export {};

package/dist/phases/user-stories-analysis/agent.js

@@ -1,105 +0,0 @@
-import { query } from '@anthropic-ai/claude-agent-sdk';
-import { DEFAULT_MODEL } from '../../constants.js';
-import { logDebug, logError, logInfo } from '../../utils/logger.js';
-export function parseAnalysisResult(responseText) {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let jsonResult = null;
-        const jsonBlockMatch = responseText.match(/```json\s*\n([\s\S]*?)\n\s*```/);
-        if (jsonBlockMatch) {
-            jsonResult = JSON.parse(jsonBlockMatch[1]);
-        }
-        else {
-            jsonResult = JSON.parse(responseText);
-        }
-        if (jsonResult && jsonResult.analysis) {
-            return { analysis: jsonResult.analysis };
-        }
-        return { error: 'Invalid JSON structure' };
-    }
-    catch (error) {
-        return {
-            error: `JSON parsing failed: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-}
-function userMessage(content) {
-    return {
-        type: 'user',
-        message: { role: 'user', content },
-    };
-}
-// eslint-disable-next-line @typescript-eslint/require-await -- async generator required by SDK interface
-async function* prompt(analysisPrompt) {
-    yield userMessage(analysisPrompt);
-}
-export async function executeUserStoriesAnalysisQuery(currentPrompt, systemPrompt, config, verbose) {
-    let lastAssistantResponse = '';
-    let structuredAnalysisResult = null;
-    let executionSessionId = '';
-    for await (const message of query({
-        prompt: prompt(currentPrompt),
-        options: {
-            systemPrompt: {
-                type: 'preset',
-                preset: 'claude_code',
-                append: systemPrompt,
-            },
-            model: DEFAULT_MODEL,
-            maxTurns: 1000,
-            permissionMode: 'bypassPermissions',
-        },
-    })) {
-        if (verbose) {
-            logInfo(`Received message type: ${message.type}`);
-        }
-        if (message.type === 'assistant' && message.message?.content) {
-            for (const content of message.message.content) {
-                if (content.type === 'text') {
-                    lastAssistantResponse += `${content.text}\n`;
-                    logDebug(`🤖 ${content.text}`, verbose);
-                }
-                else if (content.type === 'tool_use') {
-                    const input = (content.input ?? {});
-                    logDebug(`🔧 ${content.name}: ${input.description ?? 'Running...'}`, verbose);
-                }
-            }
-        }
-        if (message.type === 'result') {
-            executionSessionId = message.session_id || executionSessionId;
-            if (message.subtype === 'success') {
-                logInfo('\n📊 User stories analysis completed, parsing results...');
-                const responseText = message.result || lastAssistantResponse;
-                const parsed = parseAnalysisResult(responseText);
-                if (parsed.error) {
-                    logError(`Failed to parse structured analysis result: ${parsed.error}`);
-                    structuredAnalysisResult = {
-                        status: 'error',
-                        summary: 'Failed to parse analysis results from Claude Code response',
-                        created_user_stories: [],
-                    };
-                }
-                else {
-                    structuredAnalysisResult = parsed.analysis;
-                }
-            }
-            else {
-                logError(`\n⚠️ Analysis incomplete: ${message.subtype}`);
-                if (message.subtype === 'error_max_turns') {
-                    logError('💡 Try increasing timeout or reducing complexity');
-                }
-                if (lastAssistantResponse) {
-                    const parsed = parseAnalysisResult(lastAssistantResponse);
-                    if (!parsed.error) {
-                        structuredAnalysisResult = parsed.analysis;
-                    }
-                }
-            }
-        }
-    }
-    if (structuredAnalysisResult) {
-        structuredAnalysisResult.execution_session_id =
-            executionSessionId || undefined;
-    }
-    return structuredAnalysisResult;
-}

package/dist/phases/user-stories-analysis/context.d.ts

@@ -1,15 +0,0 @@
-import { type ProductInfo } from '../../api/products.js';
-import { type ChecklistPhaseContext } from '../../services/checklist.js';
-import type { IssueInfo, TestCase, UserStory } from '../../types/issues.js';
-export interface UserStoriesAnalysisContext {
-    issue: IssueInfo;
-    product: ProductInfo;
-    existing_user_stories: UserStory[];
-    existing_test_cases: TestCase[];
-}
-export declare function fetchUserStoriesAnalysisContext(issueId: string, verbose?: boolean): Promise<UserStoriesAnalysisContext>;
-export declare function prepareUserStoriesAnalysisContext(issueId: string, checklistContext: ChecklistPhaseContext | null | undefined, verbose?: boolean): Promise<{
-    issueContext: UserStoriesAnalysisContext;
-    analysisPrompt: string;
-    hasFeedbacks: boolean;
-}>;

package/dist/phases/user-stories-analysis/context.js

@@ -1,86 +0,0 @@
-import { getIssue, getTestCases, getUserStories, } from '../../api/issues/index.js';
-import { getProduct } from '../../api/products.js';
-import { formatChecklistsForContext, } from '../../services/checklist.js';
-import { formatFeedbacksForContext, getFeedbacksForPhase, } from '../../services/feedbacks.js';
-import { logError, logInfo } from '../../utils/logger.js';
-import { formatUserStoriesAnalysisContext } from './formatters.js';
-import { createUserStoriesAnalysisPromptWithContext, createUserStoriesFeedbackFocusedPromptWithContext, } from './prompts.js';
-export async function fetchUserStoriesAnalysisContext(issueId, verbose) {
-    try {
-        if (verbose) {
-            logInfo(`Fetching user stories analysis context for issue: ${issueId}`);
-        }
-        const [issue, existingUserStories, existingTestCases] = await Promise.all([
-            getIssue(issueId, verbose),
-            getUserStories(issueId, verbose),
-            getTestCases(issueId, verbose),
-        ]);
-        const product = await getProduct(issue.product_id, verbose);
-        if (verbose) {
-            logInfo(`✅ User stories analysis context fetched successfully:`);
-            logInfo(`   Issue: ${issue.name}`);
-            logInfo(`   Product: ${product.name}`);
-            logInfo(`   Existing User Stories: ${existingUserStories.length}`);
-            logInfo(`   Existing Test Cases: ${existingTestCases.length}`);
-        }
-        return {
-            issue,
-            product,
-            existing_user_stories: existingUserStories,
-            existing_test_cases: existingTestCases,
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logError(`Failed to fetch user stories analysis context: ${errorMessage}`);
-        throw new Error(`Context fetch failed: ${errorMessage}`);
-    }
-}
-export async function prepareUserStoriesAnalysisContext(issueId, checklistContext, verbose) {
-    if (verbose) {
-        logInfo('Fetching user stories analysis context via MCP endpoints...');
-    }
-    const issueContext = await fetchUserStoriesAnalysisContext(issueId, verbose);
-    const { content: contextInfo, downloadedImages } = await formatUserStoriesAnalysisContext(issueContext);
-    if (verbose && downloadedImages.length > 0) {
-        logInfo(`Downloaded ${downloadedImages.length} images for Claude Code:`);
-        downloadedImages.forEach((img) => {
-            logInfo(`  - ${img.url} -> ${img.localPath}`);
-        });
-    }
-    let finalContextInfo = contextInfo;
-    let hasFeedbacks = false;
-    // Add feedbacks context
-    try {
-        const feedbacksContext = await getFeedbacksForPhase({ issueId, verbose }, 'user-stories-analysis');
-        if (feedbacksContext.feedbacks.length > 0) {
-            hasFeedbacks = true;
-            const feedbacksInfo = await formatFeedbacksForContext(feedbacksContext);
-            finalContextInfo = `${finalContextInfo}\n\n${feedbacksInfo}`;
-            if (verbose) {
-                logInfo(`Added ${feedbacksContext.feedbacks.length} human feedbacks to context`);
-            }
-        }
-    }
-    catch (error) {
-        if (verbose) {
-            logInfo(`Note: Could not fetch feedbacks (${error instanceof Error ? error.message : String(error)})`);
-        }
-    }
-    // Add checklist context
-    if (checklistContext && checklistContext.checklists.length > 0) {
-        const checklistInfo = formatChecklistsForContext(checklistContext);
-        finalContextInfo = `${finalContextInfo}\n\n${checklistInfo}`;
-        if (verbose) {
-            logInfo(`Added ${checklistContext.checklists.length} checklists to analysis context`);
-        }
-    }
-    const hasExistingArtifacts = issueContext.existing_user_stories.length > 0;
-    const analysisPrompt = hasFeedbacks && hasExistingArtifacts
-        ? createUserStoriesFeedbackFocusedPromptWithContext(issueId, finalContextInfo)
-        : createUserStoriesAnalysisPromptWithContext(issueId, finalContextInfo);
-    if (verbose && hasFeedbacks && hasExistingArtifacts) {
-        logInfo('Using feedback-focused prompt (re-run with human feedbacks detected)');
-    }
-    return { issueContext, analysisPrompt, hasFeedbacks };
-}

package/dist/phases/user-stories-analysis/formatters.d.ts

@@ -1,6 +0,0 @@
-import { type DownloadedImage } from '../../utils/image-downloader.js';
-import { type UserStoriesAnalysisContext } from './context.js';
-export declare function formatUserStoriesAnalysisContext(context: UserStoriesAnalysisContext): Promise<{
-    content: string;
-    downloadedImages: DownloadedImage[];
-}>;

package/dist/phases/user-stories-analysis/formatters.js

@@ -1,32 +0,0 @@
-import { formatUserStories } from '../../utils/formatters.js';
-import { downloadImagesForClaudeCode, } from '../../utils/image-downloader.js';
-export async function formatUserStoriesAnalysisContext(context) {
-    const { processedMarkdown, downloadedImages } = await downloadImagesForClaudeCode(context.issue.description || 'No description provided', context.issue.id);
-    const content = `# User Stories Analysis Context
-
-## Issue Information
-- **ID**: ${context.issue.id}
-- **Name**: ${context.issue.name}
-- **Description**:
-${processedMarkdown}
-
-${downloadedImages.length > 0 ? '**IMPORTANT**: The description contains images that have been downloaded locally. Please use the Read tool to view these images to fully understand the requirements.' : ''}
-
-- **Current Status**: ${context.issue.status}
-
-## Product Information
-- **Product**: ${context.product.name}
-- **Product ID**: ${context.product.id}
-- **Description**: ${context.product.description || 'No product description'}
-
-## Existing User Stories (${context.existing_user_stories.length})
-${formatUserStories(context.existing_user_stories)}
-
-## Current Technical Design
-${context.issue.technical_design || 'No technical design available yet'}
-
----
-
-**Analysis Instructions**: Based on the above issue information and existing user stories, conduct comprehensive business analysis to create professional, detailed user stories that add business value.`;
-    return { content, downloadedImages };
-}

package/dist/phases/user-stories-analysis/index.d.ts

@@ -1,9 +0,0 @@
-import { type ChecklistPhaseContext } from '../../services/checklist.js';
-import { type EdsgerConfig } from '../../types/index.js';
-import { type UserStoriesAnalysisResult } from './outcome.js';
-export interface UserStoriesAnalysisOptions {
-    issueId: string;
-    verbose?: boolean;
-    maxVerificationIterations?: number;
-}
-export declare const analyseUserStories: (options: UserStoriesAnalysisOptions, config: EdsgerConfig, checklistContext?: ChecklistPhaseContext | null) => Promise<UserStoriesAnalysisResult>;

package/dist/phases/user-stories-analysis/index.js

@@ -1,175 +0,0 @@
-import { logIssuePhaseEvent } from '../../services/audit-logs.js';
-import { extractChecklistItems, runPhaseCoaching, } from '../../services/coaching/index.js';
-import { logError, logInfo, logWarning } from '../../utils/logger.js';
-import { performVerificationCycle } from '../issue-analysis-verification/index.js';
-import { executeUserStoriesAnalysisQuery, parseAnalysisResult, } from './agent.js';
-import { prepareUserStoriesAnalysisContext } from './context.js';
-import { buildUserStoriesAnalysisResult, deleteSpecificUserStories, deleteUserStoryArtifacts, getAllDraftUserStoryIds, resetReadyUserStoriesToDraft, saveUserStoriesAsDraft, updateUserStoriesToReady, } from './outcome.js';
-import { createUserStoriesAnalysisSystemPrompt } from './prompts.js';
-export const analyseUserStories = async (options, config, checklistContext) => {
-    const { issueId, verbose } = options;
-    if (verbose) {
-        logInfo(`Starting user stories analysis for issue ID: ${issueId}`);
-    }
-    try {
-        // Reset pending_approval user stories to draft so AI can manage them on re-run
-        const resetCount = await resetReadyUserStoriesToDraft(issueId, verbose);
-        if (verbose && resetCount > 0) {
-            logInfo(`✅ Reset ${resetCount} pending_approval user stories to draft for re-analysis`);
-        }
-        const context = await prepareUserStoriesAnalysisContext(issueId, checklistContext, verbose);
-        const systemPrompt = await createUserStoriesAnalysisSystemPrompt();
-        const initialAnalysisPrompt = context.analysisPrompt;
-        const maxIterations = options.maxVerificationIterations || 10;
-        let currentIteration = 0;
-        let currentPrompt = initialAnalysisPrompt;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let structuredAnalysisResult = null;
-        let verificationResult = null;
-        if (verbose) {
-            logInfo('Starting Claude Code query for user stories analysis...');
-        }
-        let currentDraftUserStoryIds = [];
-        while (currentIteration < maxIterations) {
-            currentIteration++;
-            if (verbose && currentIteration > 1) {
-                logInfo(`\n🔄 Iteration ${currentIteration}/${maxIterations}: Improving user stories based on verification feedback...`);
-            }
-            if (currentIteration > 1) {
-                await logIssuePhaseEvent({
-                    issueId,
-                    eventType: 'phase_started',
-                    phase: 'user_stories_analysis',
-                    result: 'info',
-                    metadata: {
-                        iteration: currentIteration,
-                        max_iterations: maxIterations,
-                        re_analysis: true,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, verbose);
-            }
-            structuredAnalysisResult = await executeUserStoriesAnalysisQuery(currentPrompt, systemPrompt, config, verbose);
-            if (!structuredAnalysisResult) {
-                break;
-            }
-            await logIssuePhaseEvent({
-                issueId,
-                eventType: 'phase_completed',
-                phase: 'user_stories_analysis',
-                result: 'success',
-                metadata: {
-                    iteration: currentIteration,
-                    max_iterations: maxIterations,
-                    analysis_step: 'completed',
-                    user_stories_count: structuredAnalysisResult.created_user_stories?.length || 0,
-                    deleted_user_stories_count: structuredAnalysisResult.deleted_user_story_ids?.length || 0,
-                    timestamp: new Date().toISOString(),
-                },
-            }, verbose);
-            // Handle deletions identified by AI
-            if (structuredAnalysisResult.deleted_user_story_ids?.length > 0) {
-                if (verbose) {
-                    logInfo('🗑️  Processing user story deletions identified by AI...');
-                }
-                await deleteSpecificUserStories(issueId, structuredAnalysisResult.deleted_user_story_ids || [], structuredAnalysisResult.deletion_reasons || {}, verbose);
-            }
-            // Save user stories as draft
-            const { userStoryIds } = await saveUserStoriesAsDraft(issueId, structuredAnalysisResult.created_user_stories || [], verbose);
-            currentDraftUserStoryIds = userStoryIds;
-            // Coaching loop between execute and verify
-            await runPhaseCoaching({
-                issueId,
-                phase: 'user_stories_analysis',
-                phaseResult: structuredAnalysisResult,
-                checklistItems: extractChecklistItems(checklistContext),
-                onImproved: async (_sessionId, responseText) => {
-                    const parsed = parseAnalysisResult(responseText);
-                    if (parsed.analysis) {
-                        await deleteUserStoryArtifacts(currentDraftUserStoryIds, verbose);
-                        const { userStoryIds: newUserStoryIds } = await saveUserStoriesAsDraft(issueId, parsed.analysis.created_user_stories || [], verbose);
-                        currentDraftUserStoryIds = newUserStoryIds;
-                        structuredAnalysisResult = parsed.analysis;
-                    }
-                    else {
-                        logWarning(`Coaching improvement response could not be parsed for user-stories-analysis. Keeping previous drafts. ${parsed.error || ''}`);
-                    }
-                },
-                verbose,
-            });
-            // Perform verification cycle
-            const verificationCycle = await performVerificationCycle({
-                structuredAnalysisResult: {
-                    ...structuredAnalysisResult,
-                    created_test_cases: [],
-                },
-                checklistContext: checklistContext || null,
-                context: context.issueContext,
-                config,
-                currentIteration,
-                maxIterations,
-                issueId,
-                verbose,
-            });
-            ({ verificationResult } = verificationCycle);
-            if (verificationCycle.passed) {
-                if (verbose) {
-                    logInfo('✅ Verification passed! Updating all draft user stories to pending_approval status...');
-                }
-                // Update ALL remaining draft stories (both kept old ones and newly created)
-                const allDraftIds = await getAllDraftUserStoryIds(issueId, verbose);
-                await updateUserStoriesToReady(allDraftIds, verbose);
-                break;
-            }
-            if (currentIteration < maxIterations && verificationCycle.nextPrompt) {
-                if (verbose) {
-                    logInfo('🗑️  Deleting draft user stories for re-analysis...');
-                }
-                await deleteUserStoryArtifacts(currentDraftUserStoryIds, verbose);
-                currentPrompt = verificationCycle.nextPrompt;
-            }
-            else {
-                if (verbose) {
-                    logInfo('⚠️  Max iterations reached. Draft user stories kept for manual review.');
-                }
-                break;
-            }
-        }
-        if (!structuredAnalysisResult) {
-            throw new Error('No analysis results received');
-        }
-        // If no checklist was used, update all draft artifacts to pending_approval
-        if (!checklistContext ||
-            checklistContext.checklists.length === 0 ||
-            !verificationResult) {
-            const allDraftIds = await getAllDraftUserStoryIds(issueId, verbose);
-            if (allDraftIds.length > 0) {
-                if (verbose) {
-                    logInfo('✅ No checklist verification needed. Updating all draft user stories to pending_approval status...');
-                }
-                await updateUserStoriesToReady(allDraftIds, verbose);
-            }
-        }
-        if (verificationResult &&
-            verificationResult.rejected_count > 0 &&
-            checklistContext &&
-            checklistContext.checklists.length > 0) {
-            logError(`❌ Final result: Checklist verification FAILED after ${currentIteration} iterations`);
-            logError(`   Draft user stories (${currentDraftUserStoryIds.length}) kept for manual review`);
-            throw new Error(`Checklist verification failed after ${currentIteration} iterations`);
-        }
-        return buildUserStoriesAnalysisResult(issueId, context.issueContext, structuredAnalysisResult, currentIteration);
-    }
-    catch (error) {
-        logError(`User stories analysis failed: ${error instanceof Error ? error.message : String(error)}`);
-        return {
-            issueId,
-            productInfo: null,
-            issueInfo: null,
-            existingUserStories: [],
-            createdUserStories: [],
-            summary: `Analysis failed: ${error instanceof Error ? error.message : String(error)}`,
-            status: 'error',
-        };
-    }
-};

package/dist/phases/user-stories-analysis/outcome.d.ts

@@ -1,27 +0,0 @@
-import { type UserStoriesAnalysisContext } from './context.js';
-export declare function resetReadyUserStoriesToDraft(issueId: string, verbose?: boolean): Promise<number>;
-export declare function getAllDraftUserStoryIds(issueId: string, verbose?: boolean): Promise<string[]>;
-export declare function deleteUserStoryArtifacts(userStoryIds: string[], verbose?: boolean): Promise<void>;
-export declare function deleteSpecificUserStories(issueId: string, deletedUserStoryIds: string[], deletionReasons: Record<string, string>, verbose?: boolean): Promise<void>;
-export declare function updateUserStoriesToReady(userStoryIds: string[], verbose?: boolean): Promise<void>;
-export declare function saveUserStoriesAsDraft(issueId: string, createdUserStories: any[], verbose?: boolean): Promise<{
-    userStoryIds: string[];
-}>;
-export interface UserStoriesAnalysisResult {
-    issueId: string;
-    productInfo: unknown;
-    issueInfo: unknown;
-    existingUserStories: any[];
-    createdUserStories: any[];
-    summary: string;
-    status: 'pending' | 'success' | 'error';
-    data?: {
-        checklist_results?: any[];
-        checklist_item_results?: any[];
-        verification_result?: any;
-        iterations?: number;
-        deleted_user_story_ids?: string[];
-        deletion_reasons?: Record<string, string>;
-    };
-}
-export declare function buildUserStoriesAnalysisResult(issueId: string, context: UserStoriesAnalysisContext, structuredAnalysisResult: any, currentIteration: number): UserStoriesAnalysisResult;

package/dist/phases/user-stories-analysis/outcome.js

@@ -1,146 +0,0 @@
-import { batchDeleteUserStories, batchUpdateUserStoryStatus, getUserStories, } from '../../api/issues/index.js';
-import { callMcpEndpoint } from '../../api/mcp-client.js';
-import { logError, logInfo } from '../../utils/logger.js';
-export async function resetReadyUserStoriesToDraft(issueId, verbose) {
-    const stories = await getUserStories(issueId, false);
-    const readyStoryIds = stories
-        .filter((story) => story.status === 'pending_approval')
-        .map((story) => story.id);
-    if (readyStoryIds.length === 0) {
-        return 0;
-    }
-    if (verbose) {
-        logInfo(`🔄 Resetting ${readyStoryIds.length} ready user stories to draft for re-analysis...`);
-    }
-    await batchUpdateUserStoryStatus(readyStoryIds, 'draft', verbose);
-    return readyStoryIds.length;
-}
-export async function getAllDraftUserStoryIds(issueId, verbose) {
-    const stories = await getUserStories(issueId, false);
-    const draftIds = stories
-        .filter((story) => story.status === 'draft')
-        .map((story) => story.id);
-    if (verbose) {
-        logInfo(`Found ${draftIds.length} draft user stories for issue`);
-    }
-    return draftIds;
-}
-export async function deleteUserStoryArtifacts(userStoryIds, verbose) {
-    if (userStoryIds.length > 0) {
-        if (verbose) {
-            logInfo(`Deleting ${userStoryIds.length} user stories due to verification failure...`);
-        }
-        await batchDeleteUserStories(userStoryIds, verbose);
-    }
-}
-function isValidUUID(id) {
-    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-    return uuidRegex.test(id);
-}
-export async function deleteSpecificUserStories(issueId, deletedUserStoryIds, deletionReasons, verbose) {
-    const currentUserStories = await getUserStories(issueId, false);
-    const userStoryStatusMap = new Map(currentUserStories.map((story) => [story.id, story.status]));
-    const validUserStoryIds = deletedUserStoryIds.filter((id) => {
-        if (!isValidUUID(id)) {
-            logError(`Invalid user story UUID format: ${id}`);
-            return false;
-        }
-        const status = userStoryStatusMap.get(id);
-        if (!status) {
-            logError(`User story not found: ${id}`);
-            return false;
-        }
-        if (status !== 'draft') {
-            logError(`Cannot delete user story ${id}: status is '${status}', only 'draft' items can be deleted`);
-            return false;
-        }
-        return true;
-    });
-    if (validUserStoryIds.length > 0) {
-        if (verbose) {
-            logInfo(`Deleting ${validUserStoryIds.length} draft user stories identified by AI...`);
-            validUserStoryIds.forEach((id) => {
-                const reason = deletionReasons[id] || 'No reason provided';
-                logInfo(`  - ${id}: ${reason}`);
-            });
-        }
-        await batchDeleteUserStories(validUserStoryIds, verbose);
-    }
-}
-export async function updateUserStoriesToReady(userStoryIds, verbose) {
-    if (userStoryIds.length > 0) {
-        if (verbose) {
-            logInfo(`Updating ${userStoryIds.length} user stories from draft to pending_approval...`);
-        }
-        await batchUpdateUserStoryStatus(userStoryIds, 'pending_approval', verbose);
-    }
-}
-export async function saveUserStoriesAsDraft(issueId, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-createdUserStories, verbose) {
-    const userStoryIds = [];
-    if (createdUserStories && createdUserStories.length > 0) {
-        if (verbose) {
-            logInfo(`Saving ${createdUserStories.length} user stories as draft...`);
-        }
-        try {
-            const result = (await callMcpEndpoint('user_stories/create', {
-                issue_id: issueId,
-                user_stories: createdUserStories.map((story) => ({
-                    title: story.title,
-                    description: story.description,
-                    status: 'draft',
-                })),
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            }));
-            if (result.created_user_stories) {
-                userStoryIds.push(
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                ...result.created_user_stories.map((story) => story.id));
-                if (verbose) {
-                    logInfo(`✅ Saved ${userStoryIds.length} user stories as draft`);
-                }
-            }
-        }
-        catch (error) {
-            logError(`Failed to save user stories: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    return { userStoryIds };
-}
-export function buildUserStoriesAnalysisResult(issueId, context, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-structuredAnalysisResult, currentIteration) {
-    const { created_user_stories, deleted_user_story_ids, deletion_reasons, checklist_results, checklist_item_results, } = structuredAnalysisResult;
-    return {
-        issueId,
-        productInfo: context.product,
-        issueInfo: context.issue,
-        existingUserStories: context.existing_user_stories.map((story) => ({
-            ...story,
-            status: story.status === 'pending_approval' ? 'pending_approval' : 'draft',
-            created_at: story.created_at || new Date().toISOString(),
-            updated_at: story.updated_at || new Date().toISOString(),
-        })),
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        createdUserStories: (created_user_stories || []).map((story) => ({
-            id: '',
-            title: story.title,
-            description: story.description,
-            status: 'draft',
-            created_at: new Date().toISOString(),
-            updated_at: new Date().toISOString(),
-        })),
-        summary: structuredAnalysisResult.summary ||
-            `User stories analysis completed${currentIteration > 1 ? ` after ${currentIteration} iterations` : ''}`,
-        status: structuredAnalysisResult.status === 'success' ? 'success' : 'error',
-        data: {
-            checklist_results,
-            checklist_item_results,
-            verification_result: structuredAnalysisResult.verification_result,
-            iterations: currentIteration,
-            deleted_user_story_ids: deleted_user_story_ids || [],
-            deletion_reasons: deletion_reasons || {},
-        },
-    };
-}