edsger 0.77.0 → 0.78.0

package/dist/phases/technical-design/index.js

@@ -1,456 +0,0 @@
-import { query } from '@anthropic-ai/claude-agent-sdk';
-import { updateTechnicalDesign } from '../../api/issues/index.js';
-import { DEFAULT_MODEL } from '../../constants.js';
-import { logIssuePhaseEvent } from '../../services/audit-logs.js';
-import { formatChecklistsForContext, } from '../../services/checklist.js';
-import { extractChecklistItems, runPhaseCoaching, } from '../../services/coaching/index.js';
-import { formatFeedbacksForContext, getFeedbacksForPhase, } from '../../services/feedbacks.js';
-import { formatTechnicalDesignContext } from '../../utils/formatters.js';
-import { extractJsonFromResponse } from '../../utils/json-extractor.js';
-import { logDebug, logError, logInfo } from '../../utils/logger.js';
-import { performVerificationCycle } from '../technical-design-verification/index.js';
-import { fetchTechnicalDesignContext } from './context.js';
-import { buildDesignResult, buildNoResultsError, buildVerificationFailureResult, } from './outcome.js';
-import { createTechnicalDesignPromptWithContext, createTechnicalDesignSystemPrompt, } from './prompts.js';
-function userMessage(content) {
-    return {
-        type: 'user',
-        message: { role: 'user', content },
-    };
-}
-async function* prompt(analysisPrompt) {
-    yield userMessage(analysisPrompt);
-    await new Promise((res) => {
-        setTimeout(res, 10000);
-    });
-}
-export const generateTechnicalDesign = async (options, config, checklistContext) => {
-    const { issueId, verbose } = options;
-    if (verbose) {
-        logInfo(`Starting technical design generation for issue ID: ${issueId}`);
-    }
-    try {
-        // Fetch and prepare context
-        const context = await prepareDesignContext(issueId, checklistContext, verbose);
-        const systemPrompt = await createTechnicalDesignSystemPrompt(config, issueId);
-        const initialDesignPrompt = context.designPrompt;
-        const maxIterations = options.maxVerificationIterations || 10;
-        let currentIteration = 0;
-        let currentPrompt = initialDesignPrompt;
-        let structuredDesignResult = null;
-        let verificationResult = null;
-        if (verbose) {
-            logInfo('Starting Claude Code query with pre-fetched information...');
-        }
-        // Track execution agent session ID for coaching loop
-        let executionSessionId = '';
-        // Iterative improvement loop: design → coaching → verification → improve → re-design
-        while (currentIteration < maxIterations) {
-            currentIteration++;
-            if (verbose && currentIteration > 1) {
-                logInfo(`\n🔄 Iteration ${currentIteration}/${maxIterations}: Improving design based on verification feedback...`);
-            }
-            // Log iteration start (for iterations after the first)
-            if (currentIteration > 1) {
-                await logIssuePhaseEvent({
-                    issueId,
-                    eventType: 'phase_started',
-                    phase: 'technical_design',
-                    result: 'info',
-                    metadata: {
-                        iteration: currentIteration,
-                        max_iterations: maxIterations,
-                        re_design: true,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, verbose);
-            }
-            // Execute design query (resume session if we have one from coaching)
-            const queryResult = await executeDesignQuery(currentPrompt, systemPrompt, config, verbose, executionSessionId || undefined);
-            // No result produced, break out
-            if (!queryResult?.data?.technical_design) {
-                if (verbose) {
-                    logError('⚠️  Design generation failed in this iteration');
-                }
-                break;
-            }
-            // Capture session ID for coaching loop and future iterations
-            executionSessionId = queryResult.sessionId;
-            // Update with new design result
-            structuredDesignResult = queryResult.data;
-            // Log design completion for this iteration
-            await logIssuePhaseEvent({
-                issueId,
-                eventType: 'phase_completed',
-                phase: 'technical_design',
-                result: 'success',
-                metadata: {
-                    iteration: currentIteration,
-                    max_iterations: maxIterations,
-                    design_step: 'completed',
-                    execution_session_id: executionSessionId,
-                    timestamp: new Date().toISOString(),
-                },
-            }, verbose);
-            // Save technical design immediately after generation
-            if (verbose) {
-                logInfo(`💾 Saving technical design (iteration ${currentIteration})...`);
-            }
-            await updateTechnicalDesign(issueId, structuredDesignResult.technical_design, verbose);
-            // Coaching loop: self-rate → coach → improve → repeat (between execute and verify)
-            const coaching = await runPhaseCoaching({
-                issueId,
-                phase: 'technical_design',
-                phaseResult: { execution_session_id: executionSessionId },
-                checklistItems: extractChecklistItems(checklistContext),
-                onImproved: async (_sessionId, responseText) => {
-                    // Extract improved design from agent response (must be valid JSON)
-                    const jsonMatch = responseText.match(/```json\s*\n([\s\S]*?)\n\s*```/);
-                    try {
-                        const jsonStr = jsonMatch ? jsonMatch[1] : responseText;
-                        const parsed = JSON.parse(jsonStr);
-                        const design = parsed.technical_design_result?.technical_design;
-                        if (design && typeof design === 'string') {
-                            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                            structuredDesignResult.technical_design = design;
-                            await updateTechnicalDesign(issueId, design, verbose);
-                        }
-                        else {
-                            logError('Coaching improvement response missing technical_design field. Keeping previous design.');
-                        }
-                    }
-                    catch {
-                        logError('Coaching improvement response is not valid JSON. Keeping previous design.');
-                    }
-                },
-                verbose,
-            });
-            executionSessionId = coaching.executionSessionId || executionSessionId;
-            // Perform verification cycle
-            const verificationCycle = await performVerificationCycle({
-                technicalDesign: structuredDesignResult.technical_design,
-                checklistContext: checklistContext || null,
-                feedbacksContext: context.feedbacksContext,
-                issueId,
-                issueName: context.issueName,
-                issueDescription: context.issueDescription,
-                config,
-                currentIteration,
-                maxIterations,
-                verbose,
-            });
-            ({ verificationResult } = verificationCycle);
-            // If verification passed, exit
-            if (verificationCycle.passed) {
-                if (verbose) {
-                    logInfo('✅ Verification passed! Technical design saved.');
-                }
-                break;
-            }
-            // Verification failed
-            if (currentIteration < maxIterations && verificationCycle.nextPrompt) {
-                // We have more iterations - retry with improvement prompt
-                if (verbose) {
-                    logInfo(`🔄 Will improve and save design in next iteration (${maxIterations - currentIteration} attempts remaining)`);
-                }
-                // When resuming a session, the agent already has full context.
-                // Strip the redundant "Your Previous Technical Design" section
-                // to avoid bloating the prompt with duplicate content.
-                if (executionSessionId) {
-                    currentPrompt = stripPreviousDesignSection(verificationCycle.nextPrompt);
-                }
-                else {
-                    currentPrompt = verificationCycle.nextPrompt;
-                }
-            }
-            else {
-                // Max iterations reached or no next prompt - exit loop
-                if (verbose) {
-                    logInfo('⚠️  Max iterations reached. Last design version saved.');
-                }
-                break;
-            }
-        }
-        // Handle results
-        if (!structuredDesignResult?.technical_design) {
-            return buildNoResultsError(issueId);
-        }
-        // Check if verification failed after all iterations
-        if (verificationResult &&
-            verificationResult.rejected_count > 0 &&
-            checklistContext &&
-            checklistContext.checklists.length > 0) {
-            logError(`❌ Final result: Checklist verification FAILED after ${currentIteration} iterations`);
-            logError(`   Technical design saved for manual review`);
-            return buildVerificationFailureResult(issueId, structuredDesignResult.technical_design, verificationResult, currentIteration);
-        }
-        // Return success result with session ID for coaching at phase-executor level
-        const result = buildDesignResult(issueId, structuredDesignResult.technical_design, structuredDesignResult.summary ||
-            'Technical design generated successfully', currentIteration);
-        return {
-            ...result,
-            data: {
-                ...result.data,
-                execution_session_id: executionSessionId || undefined,
-            },
-        };
-    }
-    catch (error) {
-        logError(`Technical design generation failed: ${error instanceof Error ? error.message : String(error)}`);
-        return {
-            issueId,
-            technicalDesign: null,
-            status: 'error',
-            summary: `Generation failed: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-};
-/**
- * Prepare all context information needed for design
- */
-// eslint-disable-next-line complexity -- assembles context from many data sources with fallback handling
-async function prepareDesignContext(issueId, checklistContext, verbose) {
-    if (verbose) {
-        logInfo('Fetching technical design context via MCP endpoints...');
-    }
-    const context = await fetchTechnicalDesignContext(issueId, verbose);
-    const { content: contextInfo, downloadedImages } = await formatTechnicalDesignContext(context);
-    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;
-    let feedbacksContext = null;
-    // Check if there's existing technical design
-    const existingTechnicalDesign = context.issue.technical_design;
-    const hasExistingDesign = !!existingTechnicalDesign && existingTechnicalDesign.trim().length > 0;
-    // Add existing technical design to context if it exists
-    if (hasExistingDesign && verbose) {
-        logInfo('📋 Found existing technical design - will perform incremental update if feedbacks exist');
-    }
-    // Add feedbacks context to the design prompt
-    try {
-        feedbacksContext = await getFeedbacksForPhase({ issueId, verbose }, 'technical-design');
-        if (verbose) {
-            logInfo(`📋 Feedbacks fetched successfully: ${feedbacksContext.feedbacks.length} feedbacks found`);
-            if (feedbacksContext.feedbacks.length > 0) {
-                logInfo('📝 Feedbacks details:');
-                feedbacksContext.feedbacks.forEach((fb, idx) => {
-                    logInfo(`   ${idx + 1}. [${fb.feedback_type}] ${fb.title} (priority: ${fb.priority}, resolved: ${fb.is_resolved || false})`);
-                    logInfo(`      Content: ${fb.content.substring(0, 150)}...`);
-                    if (fb.target_type) {
-                        logInfo(`      🎯 Target Type: ${fb.target_type}`);
-                    }
-                    if (fb.document_type) {
-                        logInfo(`      📄 Document: ${fb.document_type}`);
-                    }
-                    if (fb.line_number) {
-                        logInfo(`      📏 Line: ${fb.line_number}`);
-                    }
-                    else if (fb.line_range_start && fb.line_range_end) {
-                        logInfo(`      📏 Lines: ${fb.line_range_start}-${fb.line_range_end}`);
-                    }
-                    if (fb.context_snippet) {
-                        logInfo(`      Referenced: ${fb.context_snippet.substring(0, 100)}...`);
-                    }
-                });
-            }
-        }
-        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 design context`);
-                logInfo(`📄 Feedbacks section length: ${feedbacksInfo.length} characters`);
-            }
-        }
-        else if (verbose) {
-            logInfo('ℹ️  No unresolved feedbacks found for this phase');
-        }
-    }
-    catch (error) {
-        // Don't fail if feedbacks fetch fails - just log and continue
-        if (verbose) {
-            logError(`❌ Failed to fetch feedbacks: ${error instanceof Error ? error.message : String(error)}`);
-            if (error instanceof Error && error.stack) {
-                logError(`   Stack: ${error.stack}`);
-            }
-        }
-    }
-    // Add checklist context to the design prompt
-    if (checklistContext && checklistContext.checklists.length > 0) {
-        const checklistInfo = formatChecklistsForContext(checklistContext);
-        finalContextInfo = `${finalContextInfo}\n\n${checklistInfo}`;
-        if (verbose) {
-            logInfo(`Added ${checklistContext.checklists.length} checklists to design context`);
-        }
-    }
-    // Decide on prompt mode based on existing design and feedbacks
-    const isIncrementalUpdate = hasExistingDesign && hasFeedbacks;
-    if (verbose) {
-        logInfo('\n📋 Design Mode Decision:');
-        logInfo(`   - Has existing design: ${hasExistingDesign}`);
-        logInfo(`   - Has feedbacks: ${hasFeedbacks} (${feedbacksContext?.feedbacks.length || 0} feedbacks)`);
-        const redesignOrNew = hasExistingDesign
-            ? '🔄 Full Redesign'
-            : '✨ New Design';
-        logInfo(`   - Mode: ${isIncrementalUpdate ? '🔄 Incremental Update' : redesignOrNew}`);
-        if (isIncrementalUpdate && feedbacksContext) {
-            logInfo('\n🎯 Feedbacks that will be addressed:');
-            feedbacksContext.feedbacks.forEach((fb, idx) => {
-                const lowPriorityBadge = fb.priority >= 5 ? '🟡' : '🟢';
-                const midPriorityBadge = fb.priority >= 7 ? '🟠' : lowPriorityBadge;
-                const priorityBadge = fb.priority >= 9 ? '🔴' : midPriorityBadge;
-                logInfo(`   ${idx + 1}. [${fb.feedback_type}] ${fb.title} ${priorityBadge}`);
-                logInfo(`      ${fb.content.substring(0, 100)}${fb.content.length > 100 ? '...' : ''}`);
-            });
-        }
-    }
-    const designPrompt = createTechnicalDesignPromptWithContext(issueId, finalContextInfo, existingTechnicalDesign, isIncrementalUpdate);
-    return {
-        issueName: context.issue.name,
-        issueDescription: context.issue.description || undefined,
-        designPrompt,
-        hasExistingDesign,
-        hasFeedbacks,
-        feedbacksContext,
-    };
-}
-/**
- * Strip the "Your Previous Technical Design" section from the improvement prompt.
- * When resuming a session, the agent already has the design in its history.
- */
-function stripPreviousDesignSection(systemPrompt) {
-    // Remove content between deterministic markers (added in prompts.ts)
-    return systemPrompt.replace(/<!-- PREVIOUS_DESIGN_START -->[\s\S]*?<!-- PREVIOUS_DESIGN_END -->/, '');
-}
-/**
- * Execute design query and parse result
- */
-// eslint-disable-next-line complexity -- agent loop with message type handling and result extraction
-async function executeDesignQuery(designPrompt, systemPrompt, config, verbose, resumeSessionId) {
-    let lastAssistantResponse = '';
-    let structuredDesignResult = null;
-    let sessionId = resumeSessionId || '';
-    if (verbose) {
-        logInfo(resumeSessionId
-            ? '🤖 Resuming design agent session...'
-            : '🤖 Starting design agent query...');
-    }
-    // Use Claude Code SDK without MCP servers - all info is pre-fetched
-    for await (const message of query({
-        prompt: resumeSessionId
-            ? designPrompt
-            : prompt(designPrompt),
-        options: {
-            systemPrompt: resumeSessionId
-                ? undefined
-                : {
-                    type: 'preset',
-                    preset: 'claude_code',
-                    append: systemPrompt,
-                },
-            model: DEFAULT_MODEL,
-            maxTurns: 1000,
-            permissionMode: 'bypassPermissions',
-            ...(resumeSessionId ? { resume: resumeSessionId } : {}),
-        },
-    })) {
-        if (verbose) {
-            logInfo(`   Received message type: ${message.type}`);
-        }
-        // Stream the technical design generation process
-        if (message.type === 'assistant') {
-            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') {
-                    logDebug(`🔧 ${content.name}: ${content.input.description || 'Running...'}`, verbose);
-                }
-            }
-            continue;
-        }
-        if (message.type === 'result') {
-            sessionId = message.session_id || sessionId;
-            if (message.subtype === 'success') {
-                logInfo('\n🎨 Technical design generation completed, parsing results...');
-                try {
-                    const responseText = message.result || lastAssistantResponse;
-                    const jsonResult = extractJsonFromResponse(responseText, '"technical_design_result"');
-                    if (jsonResult?.technical_design_result) {
-                        structuredDesignResult =
-                            jsonResult.technical_design_result;
-                    }
-                    else {
-                        throw new Error('Invalid JSON structure');
-                    }
-                }
-                catch (error) {
-                    logError(`Failed to parse structured design result: ${error}`);
-                    // Extract technical design from response if JSON parsing fails
-                    const extractedDesign = extractTechnicalDesignFromResponse(message.result || lastAssistantResponse);
-                    structuredDesignResult = {
-                        status: extractedDesign ? 'success' : 'error',
-                        technical_design: extractedDesign,
-                        summary: extractedDesign
-                            ? 'Technical design generated successfully'
-                            : 'Failed to generate technical design',
-                    };
-                }
-            }
-            else {
-                logError(`\n⚠️  Technical design generation incomplete: ${message.subtype}`);
-                if (message.subtype === 'error_max_turns') {
-                    logError('💡 Try increasing timeout or reducing complexity');
-                }
-            }
-        }
-    }
-    if (!structuredDesignResult) {
-        return null;
-    }
-    return { data: structuredDesignResult, sessionId };
-}
-const extractTechnicalDesignFromResponse = (response) => {
-    // Try to extract technical design content from the response
-    // Look for markdown sections that contain technical design
-    const lines = response.split('\n');
-    let inTechnicalDesign = false;
-    const technicalDesignLines = [];
-    for (const originalLine of lines) {
-        const line = originalLine.toLowerCase();
-        // Look for technical design section headers
-        if (line.includes('technical design') ||
-            line.includes('architecture') ||
-            line.includes('# design') ||
-            line.includes('## technical')) {
-            inTechnicalDesign = true;
-            technicalDesignLines.push(originalLine);
-            continue;
-        }
-        if (inTechnicalDesign) {
-            // Continue until we hit another major section or JSON
-            if (line.startsWith('{') && line.includes('"technical_design_result"')) {
-                break;
-            }
-            technicalDesignLines.push(originalLine);
-        }
-    }
-    if (technicalDesignLines.length > 0) {
-        return technicalDesignLines.join('\n').trim();
-    }
-    // Ultimate fallback: return the whole response if it seems to contain design content
-    if (response.length > 100 &&
-        (response.toLowerCase().includes('architecture') ||
-            response.toLowerCase().includes('component') ||
-            response.toLowerCase().includes('database'))) {
-        return response.trim();
-    }
-    return null;
-};

package/dist/phases/technical-design/outcome.d.ts

@@ -1,25 +0,0 @@
-import { type ChecklistVerificationResult } from '../technical-design-verification/agent.js';
-export interface TechnicalDesignResult {
-    issueId: string;
-    technicalDesign: string | null;
-    status: 'success' | 'error';
-    summary: string;
-    verificationResult?: ChecklistVerificationResult;
-    iterations?: number;
-    data?: {
-        checklist_item_results?: any[];
-        [key: string]: any;
-    };
-}
-/**
- * Build successful design result
- */
-export declare function buildDesignResult(issueId: string, technicalDesign: string, summary: string, iterations: number, checklistItemResults?: any[]): TechnicalDesignResult;
-/**
- * Build verification failure result
- */
-export declare function buildVerificationFailureResult(issueId: string, technicalDesign: string, verificationResult: ChecklistVerificationResult, iterations: number): TechnicalDesignResult;
-/**
- * Build error result when no design was generated
- */
-export declare function buildNoResultsError(issueId: string): TechnicalDesignResult;

package/dist/phases/technical-design/outcome.js

@@ -1,41 +0,0 @@
-/**
- * Build successful design result
- */
-export function buildDesignResult(issueId, technicalDesign, summary, iterations, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-checklistItemResults) {
-    return {
-        issueId,
-        technicalDesign,
-        status: 'success',
-        summary,
-        iterations,
-        data: checklistItemResults
-            ? { checklist_item_results: checklistItemResults }
-            : undefined,
-    };
-}
-/**
- * Build verification failure result
- */
-export function buildVerificationFailureResult(issueId, technicalDesign, verificationResult, iterations) {
-    return {
-        issueId,
-        technicalDesign,
-        status: 'error',
-        summary: `Checklist verification failed after ${iterations} iterations: ${verificationResult.summary}`,
-        verificationResult,
-        iterations,
-    };
-}
-/**
- * Build error result when no design was generated
- */
-export function buildNoResultsError(issueId) {
-    return {
-        issueId,
-        technicalDesign: null,
-        status: 'error',
-        summary: 'Failed to generate technical design - no valid result received',
-    };
-}

package/dist/phases/technical-design/prompts.d.ts

@@ -1,8 +0,0 @@
-import { type EdsgerConfig } from '../../types/index.js';
-import { type ChecklistVerificationResult } from '../technical-design-verification/agent.js';
-export declare const createTechnicalDesignSystemPrompt: (_config: EdsgerConfig, mcpServerUrl?: string, mcpToken?: string, issueId?: string, projectDir?: string) => Promise<string>;
-export declare const createTechnicalDesignPromptWithContext: (issueId: string, contextInfo: string, existingTechnicalDesign?: string | null, isIncrementalUpdate?: boolean) => string;
-/**
- * Create a prompt for the technical design agent to improve based on verification feedback
- */
-export declare const createTechnicalDesignImprovementPrompt: (verificationResult: ChecklistVerificationResult, previousDesign: string) => string;