edsger 0.2.3 → 0.2.5

package/dist/prompts/feature-analysis-improvement.js

@@ -0,0 +1,109 @@
+/**
+ * Create a prompt for the analysis agent to improve based on verification feedback
+ */
+export const createImprovementPrompt = (verificationResult, previousAnalysis) => {
+    // Format rejected items with specific feedback and improvement suggestions
+    const rejectedItemsSection = verificationResult.item_verifications
+        .filter((v) => v.verification_status === 'rejected')
+        .map((v, index) => {
+        return `### Rejected Requirement ${index + 1}
+**Checklist Item ID**: ${v.checklist_item_id}
+**Satisfaction Status**: ${v.is_satisfied ? '✅ Satisfied' : '❌ Not Satisfied'}
+**Verification Result**: ❌ REJECTED
+**Reason**: ${v.verification_reason}
+${v.concerns && v.concerns.length > 0 ? `**Specific Concerns**:\n${v.concerns.map((c) => `- ${c}`).join('\n')}` : ''}
+${v.improvement_suggestions && v.improvement_suggestions.length > 0 ? `\n**💡 Improvement Suggestions**:\n${v.improvement_suggestions.map((s) => `- ${s}`).join('\n')}` : ''}
+`;
+    })
+        .join('\n---\n');
+    // Format uncertain items with improvement suggestions
+    const uncertainItemsSection = verificationResult.item_verifications
+        .filter((v) => v.verification_status === 'uncertain')
+        .map((v, index) => {
+        return `### Uncertain Requirement ${index + 1}
+**Checklist Item ID**: ${v.checklist_item_id}
+**Satisfaction Status**: ${v.is_satisfied ? '✅ Satisfied' : '⚠️ Partially Satisfied'}
+**Verification Result**: ⚠️ UNCERTAIN
+**Reason**: ${v.verification_reason}
+${v.concerns && v.concerns.length > 0 ? `**Specific Concerns**:\n${v.concerns.map((c) => `- ${c}`).join('\n')}` : ''}
+${v.improvement_suggestions && v.improvement_suggestions.length > 0 ? `\n**💡 Improvement Suggestions**:\n${v.improvement_suggestions.map((s) => `- ${s}`).join('\n')}` : ''}
+`;
+    })
+        .join('\n---\n');
+    return `# Verification Feedback - Improvements Required
+
+Your previous analysis was verified, and **${verificationResult.rejected_count} checklist requirements were NOT SATISFIED** and **${verificationResult.uncertain_count} requirements are PARTIALLY SATISFIED**.
+
+## Verification Summary
+${verificationResult.summary}
+
+## Results Breakdown
+- ✅ Satisfied: ${verificationResult.confirmed_count}
+- ❌ Not Satisfied: ${verificationResult.rejected_count}
+- ⚠️ Partially Satisfied: ${verificationResult.uncertain_count}
+
+${verificationResult.overall_suggestions && verificationResult.overall_suggestions.length > 0 ? `## 💡 Overall Improvement Suggestions\n\n${verificationResult.overall_suggestions.map((s) => `- ${s}`).join('\n')}\n\n` : ''}
+
+${verificationResult.rejected_count > 0 ? `## ❌ Unsatisfied Requirements\n\n${rejectedItemsSection}` : ''}
+
+${verificationResult.uncertain_count > 0 ? `## ⚠️ Partially Satisfied Requirements\n\n${uncertainItemsSection}` : ''}
+
+## Your Previous Work
+
+### User Stories You Created (${previousAnalysis.created_user_stories.length})
+${previousAnalysis.created_user_stories
+        .map((story, index) => `${index + 1}. **${story.title}**
+   ${story.description}
+   Status: ${story.status || 'draft'}`)
+        .join('\n\n')}
+
+### Test Cases You Created (${previousAnalysis.created_test_cases.length})
+${previousAnalysis.created_test_cases
+        .map((tc, index) => `${index + 1}. **${tc.name}** ${tc.is_critical ? '[CRITICAL]' : '[OPTIONAL]'}
+   ${tc.description}`)
+        .join('\n\n')}
+
+---
+
+## Your Task: Improve Your Artifacts
+
+You need to **revise and improve** your user stories and test cases to satisfy the checklist requirements.
+
+**What You Should Do**:
+
+1. **Review the improvement suggestions** provided above for each rejected/uncertain requirement
+2. **Follow the specific, actionable suggestions** - they tell you exactly what to add or modify
+3. **Add NEW user stories and test cases** as suggested by the verifier
+4. **Improve the quality and specificity** of your artifacts
+5. **Ensure each requirement is adequately covered** based on the feedback
+
+**IMPORTANT Guidelines**:
+- **Pay close attention to the 💡 Improvement Suggestions** - these are specific actions you should take
+- You can **keep your existing user stories and test cases** that are good
+- **Add NEW items** exactly as suggested to satisfy the unsatisfied requirements
+- **Make your artifacts concrete and specific** - they will be verified again
+- The suggestions are your roadmap - follow them to ensure verification passes
+- Ensure your artifacts directly address the checklist requirements
+
+**CRITICAL - Output Format**:
+You MUST return ONLY the JSON object below. Do NOT include any explanatory text, commentary, or markdown before or after the JSON. Return ONLY the JSON in this exact format:
+
+\`\`\`json
+{
+  "analysis": {
+    "feature_id": "...",
+    "status": "success",
+    "summary": "Improved analysis based on verification feedback",
+    "created_user_stories": [
+      // Include ALL user stories (existing + new)
+    ],
+    "created_test_cases": [
+      // Include ALL test cases (existing + new)
+    ],
+    "recommendations": "..."
+  }
+}
+\`\`\`
+
+IMPORTANT: Return ONLY the JSON above. Do not add any text explaining what you did or how you improved the analysis. The JSON should be the complete and only content of your response.`;
+};

package/dist/prompts/feature-analysis.js

@@ -48,7 +48,7 @@ CRITICAL: You are NOT a software engineer. You should NEVER write code, build pr
 - Consider different user perspectives and scenarios
 
 **CRITICAL - Result Format**:
-You MUST end your response with a JSON object containing the analysis results in this EXACT format:
+You MUST return ONLY a JSON object with your analysis results. Do NOT include any explanatory text before or after the JSON. Return ONLY the JSON in this EXACT format:
 
 \`\`\`json
 {

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

@@ -0,0 +1,5 @@
+import { ChecklistVerificationResult } from '../phases/technical-design-verification/index.js';
+/**
+ * Create a prompt for the technical design agent to improve based on verification feedback
+ */
+export declare const createTechnicalDesignImprovementPrompt: (verificationResult: ChecklistVerificationResult, previousDesign: string) => string;

package/dist/prompts/technical-design-improvement.js

@@ -0,0 +1,93 @@
+/**
+ * Create a prompt for the technical design agent to improve based on verification feedback
+ */
+export const createTechnicalDesignImprovementPrompt = (verificationResult, previousDesign) => {
+    // Format rejected items with specific feedback and improvement suggestions
+    const rejectedItemsSection = verificationResult.item_verifications
+        .filter((v) => v.verification_status === 'rejected')
+        .map((v, index) => {
+        return `### Rejected Requirement ${index + 1}
+**Checklist Item ID**: ${v.checklist_item_id}
+**Satisfaction Status**: ${v.is_satisfied ? '✅ Satisfied' : '❌ Not Satisfied'}
+**Verification Result**: ❌ REJECTED
+**Reason**: ${v.verification_reason}
+${v.concerns && v.concerns.length > 0 ? `**Specific Concerns**:\n${v.concerns.map((c) => `- ${c}`).join('\n')}` : ''}
+${v.improvement_suggestions && v.improvement_suggestions.length > 0 ? `\n**💡 Improvement Suggestions**:\n${v.improvement_suggestions.map((s) => `- ${s}`).join('\n')}` : ''}
+`;
+    })
+        .join('\n---\n');
+    // Format uncertain items with improvement suggestions
+    const uncertainItemsSection = verificationResult.item_verifications
+        .filter((v) => v.verification_status === 'uncertain')
+        .map((v, index) => {
+        return `### Uncertain Requirement ${index + 1}
+**Checklist Item ID**: ${v.checklist_item_id}
+**Satisfaction Status**: ${v.is_satisfied ? '✅ Satisfied' : '⚠️ Partially Satisfied'}
+**Verification Result**: ⚠️ UNCERTAIN
+**Reason**: ${v.verification_reason}
+${v.concerns && v.concerns.length > 0 ? `**Specific Concerns**:\n${v.concerns.map((c) => `- ${c}`).join('\n')}` : ''}
+${v.improvement_suggestions && v.improvement_suggestions.length > 0 ? `\n**💡 Improvement Suggestions**:\n${v.improvement_suggestions.map((s) => `- ${s}`).join('\n')}` : ''}
+`;
+    })
+        .join('\n---\n');
+    return `# Verification Feedback - Design Improvements Required
+
+Your previous technical design was verified, and **${verificationResult.rejected_count} checklist requirements were NOT SATISFIED** and **${verificationResult.uncertain_count} requirements are PARTIALLY SATISFIED**.
+
+## Verification Summary
+${verificationResult.summary}
+
+## Results Breakdown
+- ✅ Satisfied: ${verificationResult.confirmed_count}
+- ❌ Not Satisfied: ${verificationResult.rejected_count}
+- ⚠️ Partially Satisfied: ${verificationResult.uncertain_count}
+
+${verificationResult.overall_suggestions && verificationResult.overall_suggestions.length > 0 ? `## 💡 Overall Improvement Suggestions\n\n${verificationResult.overall_suggestions.map((s) => `- ${s}`).join('\n')}\n\n` : ''}
+
+${verificationResult.rejected_count > 0 ? `## ❌ Unsatisfied Requirements\n\n${rejectedItemsSection}` : ''}
+
+${verificationResult.uncertain_count > 0 ? `## ⚠️ Partially Satisfied Requirements\n\n${uncertainItemsSection}` : ''}
+
+## Your Previous Technical Design
+
+${previousDesign}
+
+---
+
+## Your Task: Improve Your Technical Design
+
+You need to **revise and improve** your technical design document to satisfy the checklist requirements.
+
+**What You Should Do**:
+
+1. **Review the improvement suggestions** provided above for each rejected/uncertain requirement
+2. **Follow the specific, actionable suggestions** - they tell you exactly what to add or modify
+3. **Expand and enhance** the technical design document as suggested by the verifier
+4. **Add missing sections, diagrams, or specifications** as indicated
+5. **Ensure each requirement is adequately covered** based on the feedback
+
+**IMPORTANT Guidelines**:
+- **Pay close attention to the 💡 Improvement Suggestions** - these are specific actions you should take
+- You can **keep the good parts** of your existing design
+- **Add NEW sections and details** exactly as suggested to satisfy the unsatisfied requirements
+- **Be specific and technical** - your design will be verified again
+- The suggestions are your roadmap - follow them to ensure verification passes
+- Ensure your design directly addresses the checklist requirements with sufficient technical depth
+
+**CRITICAL - Output Format**:
+You MUST return ONLY the JSON object below. Do NOT include any explanatory text, commentary, or markdown before or after the JSON. Return ONLY the JSON in this exact format:
+
+\`\`\`json
+{
+  "technical_design_result": {
+    "feature_id": "...",
+    "status": "success",
+    "summary": "Improved technical design based on verification feedback",
+    "technical_design": "The COMPLETE improved technical design document in markdown format",
+    "recommendations": "..."
+  }
+}
+\`\`\`
+
+IMPORTANT: Return ONLY the JSON above. Do not add any text explaining what you did or how you improved the design. The JSON should be the complete and only content of your response.`;
+};

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

@@ -0,0 +1,11 @@
+import { EdsgerConfig } from '../types/index.js';
+import { ChecklistPhaseContext } from '../services/checklist.js';
+export declare const createTechnicalDesignVerificationSystemPrompt: (_config: EdsgerConfig) => string;
+export interface TechnicalDesignVerificationPromptOptions {
+    checklistContext: ChecklistPhaseContext;
+    featureId: string;
+    featureName: string;
+    featureDescription?: string;
+    technicalDesign: string;
+}
+export declare const createTechnicalDesignVerificationPrompt: (options: TechnicalDesignVerificationPromptOptions) => string;

package/dist/prompts/technical-design-verification.js

@@ -0,0 +1,134 @@
+export const createTechnicalDesignVerificationSystemPrompt = (_config) => {
+    return `You are an independent quality assurance auditor specializing in technical design review. Your role is to critically evaluate whether a technical design document satisfies checklist requirements.
+
+**Your Mission**: Verify Technical Design Against Requirements
+- Review the checklist requirements
+- Examine the technical design document
+- Determine if the design adequately addresses each requirement
+- Be CRITICAL and look for gaps, inconsistencies, or missing elements
+- Quality matters - don't accept bare minimum
+
+**Verification Approach**:
+1. **Understand the Requirement**: Read each checklist item and understand what it requires
+2. **Examine the Design**: Look at the technical design document content
+3. **Match Requirements to Design**: Determine if the design addresses the requirement
+4. **Assess Quality**: Ask yourself:
+   - Does the design directly address this requirement?
+   - Is the coverage specific and concrete, or vague and generic?
+   - Is there sufficient depth and technical detail?
+   - Are there any gaps or missing elements?
+   - Does it meet the standard expected for this requirement?
+
+**Verification Standards**:
+- ✅ **CONFIRMED**: The design clearly and adequately satisfies the requirement
+- ❌ **REJECTED**: The requirement is not addressed, or addressed insufficiently
+- ⚠️ **UNCERTAIN**: The design partially addresses the requirement but with gaps or ambiguity
+
+**Your Mindset**:
+- Be thorough and systematic
+- Focus on what the design actually contains, not what was claimed
+- Quality matters - ensure requirements are truly met
+- Look for what's MISSING, not just what's present
+- Be fair but rigorous
+
+**CRITICAL - Output Format**:
+You MUST respond with a JSON object in this EXACT format:
+
+\`\`\`json
+{
+  "verification": {
+    "all_verified": true/false,
+    "total_items": number,
+    "confirmed_count": number,
+    "rejected_count": number,
+    "uncertain_count": number,
+    "item_verifications": [
+      {
+        "checklist_item_id": "uuid",
+        "is_satisfied": true/false,
+        "verification_status": "confirmed|rejected|uncertain",
+        "verification_reason": "Detailed explanation of your verification decision",
+        "concerns": ["Optional array of specific concerns or gaps found"],
+        "improvement_suggestions": ["Specific, actionable suggestions for improvement (for rejected/uncertain items)"]
+      }
+    ],
+    "summary": "Overall summary of verification findings",
+    "overall_suggestions": ["High-level suggestions for improving the overall design (if there are failures)"]
+  }
+}
+\`\`\`
+
+**For rejected/uncertain items**: Provide specific, actionable improvement_suggestions such as:
+- "Add architectural diagram showing component interactions"
+- "Include detailed API specifications for X endpoint"
+- "Expand security considerations to cover Y attack vector"
+- "Add database schema design for Z table"
+
+Be thorough, be critical, be fair. Your verification protects quality.`;
+};
+export const createTechnicalDesignVerificationPrompt = (options) => {
+    const { checklistContext, featureId, featureName, featureDescription, technicalDesign, } = options;
+    // Format all checklist items with their requirements
+    const checklistItemsSection = checklistContext.checklists
+        .flatMap((checklist) => checklist.items.map((item) => {
+        return `### Checklist Item: ${item.title}
+**ID**: ${item.id}
+**Checklist**: ${checklist.name} (${checklist.role})
+**Requirement**: ${item.description}
+**Required**: ${item.is_required ? 'Yes' : 'No'}
+**Type**: ${item.item_type}
+`;
+    }))
+        .join('\n---\n');
+    const totalChecklistItems = checklistContext.checklists.reduce((sum, checklist) => sum + checklist.items.length, 0);
+    return `# Technical Design Verification Task
+
+You are verifying that a technical design document satisfies checklist requirements.
+
+## Feature Context
+
+**Feature**: ${featureName}
+**Feature ID**: ${featureId}
+**Description**: ${featureDescription || 'No description'}
+
+## Technical Design Document
+
+${technicalDesign}
+
+## Checklist Requirements to Verify (${totalChecklistItems})
+
+${checklistItemsSection}
+
+---
+
+## Your Verification Task
+
+For EACH checklist item above:
+
+1. **Understand the Requirement**: What does this checklist item require?
+
+2. **Examine the Design**: Look at the technical design document above
+
+3. **Determine Coverage**: Does the design adequately address this requirement?
+   - Does it directly address the requirement?
+   - Is the coverage concrete and specific?
+   - Is there sufficient technical depth and detail?
+   - Are there any gaps or missing elements?
+
+4. **Make Your Determination**:
+   - **CONFIRMED** (is_satisfied: true): The design clearly and adequately satisfies this requirement
+   - **REJECTED** (is_satisfied: false): The requirement is not addressed, or addressed insufficiently
+   - **UNCERTAIN** (is_satisfied: false): The design partially addresses the requirement but with gaps
+
+5. **Document Your Reasoning**: Provide specific, detailed reasons for your decision
+
+6. **Provide Improvement Suggestions** (for rejected/uncertain items):
+   - Be specific and actionable
+   - Suggest what sections or details should be added to the design
+   - Indicate what should be expanded or modified
+   - Give concrete examples when possible
+
+Remember: Focus on what the design actually contains, not on claims. Be thorough and fair.
+
+Provide your verification results in the required JSON format with improvement_suggestions for any rejected or uncertain items.`;
+};

package/dist/prompts/technical-design.js

@@ -52,7 +52,7 @@ CRITICAL: You are NOT a software engineer who writes code. You are a technical a
 - Include clear implementation guidance
 
 **CRITICAL - Result Format**:
-You MUST end your response with a JSON object containing the technical design results in this EXACT format:
+You MUST return ONLY a JSON object with your technical design results. Do NOT include any explanatory text before or after the JSON. Return ONLY the JSON in this EXACT format:
 
 \`\`\`json
 {

package/dist/services/audit-logs.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Feature Audit Logs Service
+ * Provides functions to log feature lifecycle events to the database
+ */
+export interface LogPhaseEventParams {
+    featureId: string;
+    eventType: 'phase_started' | 'phase_completed' | 'phase_failed';
+    phase: 'feature_analysis' | 'technical_design' | 'code_implementation' | 'functional_testing';
+    result?: 'success' | 'error' | 'warning' | 'info';
+    metadata?: Record<string, any>;
+    errorMessage?: string;
+}
+export interface LogChecklistEventParams {
+    featureId: string;
+    eventType: 'checklist_validated' | 'checklist_verified';
+    checklistId: string;
+    result?: 'success' | 'error' | 'warning' | 'info';
+    metadata?: Record<string, any>;
+}
+export interface LogVerificationEventParams {
+    featureId: string;
+    phase: 'feature_analysis' | 'technical_design' | 'code_implementation' | 'functional_testing';
+    iteration: number;
+    result: 'success' | 'error';
+    verificationData: {
+        confirmed_count: number;
+        rejected_count: number;
+        uncertain_count: number;
+        rejected_items?: Array<{
+            checklist_item_id: string;
+            reason: string;
+            concerns?: string[];
+            improvement_suggestions?: string[];
+        }>;
+        uncertain_items?: Array<{
+            checklist_item_id: string;
+            reason: string;
+            concerns?: string[];
+            improvement_suggestions?: string[];
+        }>;
+        summary?: string;
+        overall_suggestions?: string[];
+    };
+}
+/**
+ * Log a phase event (start, completion, or failure)
+ */
+export declare function logFeaturePhaseEvent(mcpServerUrl: string, mcpToken: string, params: LogPhaseEventParams, verbose?: boolean): Promise<string | null>;
+/**
+ * Log a checklist validation event
+ */
+export declare function logFeatureChecklistEvent(mcpServerUrl: string, mcpToken: string, params: LogChecklistEventParams, verbose?: boolean): Promise<string | null>;
+/**
+ * Log a verification event (dual-agent verification result)
+ */
+export declare function logFeatureVerificationEvent(mcpServerUrl: string, mcpToken: string, params: LogVerificationEventParams, verbose?: boolean): Promise<string | null>;
+/**
+ * Get feature timeline (all audit logs)
+ */
+export declare function getFeatureTimeline(mcpServerUrl: string, mcpToken: string, featureId: string, verbose?: boolean): Promise<any[]>;

package/dist/services/audit-logs.js

@@ -0,0 +1,115 @@
+/**
+ * Feature Audit Logs Service
+ * Provides functions to log feature lifecycle events to the database
+ */
+import { callMcpEndpoint } from '../api/mcp-client.js';
+import { logInfo, logError } from '../utils/logger.js';
+/**
+ * Log a phase event (start, completion, or failure)
+ */
+export async function logFeaturePhaseEvent(mcpServerUrl, mcpToken, params, verbose) {
+    try {
+        const result = await callMcpEndpoint(mcpServerUrl, mcpToken, 'feature_audit_logs/create', {
+            feature_id: params.featureId,
+            event_type: params.eventType,
+            phase: params.phase,
+            source: 'pipeline',
+            result: params.result || 'info',
+            metadata: params.metadata || {},
+            error_message: params.errorMessage || null,
+        });
+        if (verbose) {
+            logInfo(`✅ Logged ${params.eventType} for phase ${params.phase}`);
+        }
+        return result?.id || null;
+    }
+    catch (error) {
+        // Always log errors, not just in verbose mode
+        logError(`Failed to log phase event: ${error instanceof Error ? error.message : String(error)}`);
+        if (verbose && error instanceof Error && error.stack) {
+            logError(`Stack trace: ${error.stack}`);
+        }
+        return null;
+    }
+}
+/**
+ * Log a checklist validation event
+ */
+export async function logFeatureChecklistEvent(mcpServerUrl, mcpToken, params, verbose) {
+    try {
+        const result = await callMcpEndpoint(mcpServerUrl, mcpToken, 'feature_audit_logs/create', {
+            feature_id: params.featureId,
+            event_type: params.eventType,
+            source: 'pipeline',
+            result: params.result || 'success',
+            metadata: {
+                checklist_id: params.checklistId,
+                ...(params.metadata || {}),
+            },
+        });
+        if (verbose) {
+            logInfo(`✅ Logged ${params.eventType} for checklist ${params.checklistId}`);
+        }
+        return result?.id || null;
+    }
+    catch (error) {
+        // Always log errors, not just in verbose mode
+        logError(`Failed to log checklist event: ${error instanceof Error ? error.message : String(error)}`);
+        if (verbose && error instanceof Error && error.stack) {
+            logError(`Stack trace: ${error.stack}`);
+        }
+        return null;
+    }
+}
+/**
+ * Log a verification event (dual-agent verification result)
+ */
+export async function logFeatureVerificationEvent(mcpServerUrl, mcpToken, params, verbose) {
+    try {
+        const eventType = params.result === 'success'
+            ? 'verification_passed'
+            : 'verification_failed';
+        const result = await callMcpEndpoint(mcpServerUrl, mcpToken, 'feature_audit_logs/create', {
+            feature_id: params.featureId,
+            event_type: eventType,
+            phase: params.phase,
+            source: 'pipeline',
+            result: params.result,
+            metadata: {
+                iteration: params.iteration,
+                ...params.verificationData,
+            },
+        });
+        if (verbose) {
+            logInfo(`✅ Logged verification ${params.result} for phase ${params.phase} (iteration ${params.iteration})`);
+        }
+        return result?.id || null;
+    }
+    catch (error) {
+        // Always log errors, not just in verbose mode
+        logError(`Failed to log verification event: ${error instanceof Error ? error.message : String(error)}`);
+        if (verbose && error instanceof Error && error.stack) {
+            logError(`Stack trace: ${error.stack}`);
+        }
+        return null;
+    }
+}
+/**
+ * Get feature timeline (all audit logs)
+ */
+export async function getFeatureTimeline(mcpServerUrl, mcpToken, featureId, verbose) {
+    try {
+        const result = await callMcpEndpoint(mcpServerUrl, mcpToken, 'feature_audit_logs/list', {
+            feature_id: featureId,
+        });
+        return result?.logs || [];
+    }
+    catch (error) {
+        // Always log errors, not just in verbose mode
+        logError(`Failed to get feature timeline: ${error instanceof Error ? error.message : String(error)}`);
+        if (verbose && error instanceof Error && error.stack) {
+            logError(`Stack trace: ${error.stack}`);
+        }
+        return [];
+    }
+}

package/dist/services/checklist.d.ts

@@ -2,6 +2,7 @@
  * Checklist service for pipeline integration
  */
 import { PipelinePhaseOptions } from '../types/pipeline.js';
+export type { PipelinePhaseOptions };
 export interface ChecklistItem {
     id: string;
     title: string;

package/dist/types/index.d.ts

@@ -30,6 +30,7 @@ export interface CliOptions {
     implement?: string;
     test?: string;
     workflow?: boolean;
+    refactor?: boolean;
 }
 export type ReviewSeverity = 'error' | 'warning';
 export type ExitCode = 0 | 1;
@@ -55,6 +56,24 @@ export interface FeatureAnalysisResult {
             value?: any;
             notes?: string;
         }>;
+        verification_result?: {
+            all_verified: boolean;
+            total_items: number;
+            confirmed_count: number;
+            rejected_count: number;
+            uncertain_count: number;
+            item_verifications: Array<{
+                checklist_item_id: string;
+                is_satisfied: boolean;
+                verification_status: 'confirmed' | 'rejected' | 'uncertain';
+                verification_reason: string;
+                concerns?: string[];
+                improvement_suggestions?: string[];
+            }>;
+            summary: string;
+            overall_suggestions?: string[];
+        };
+        iterations?: number;
     };
 }
 export interface FeatureData {