specweave 0.21.3 → 0.22.2

package/dist/src/core/workflow/state-manager.js

@@ -0,0 +1,126 @@
+/**
+ * State Manager - Workflow state tracking and checkpointing
+ *
+ * Manages workflow state, checkpoints, and recovery for autonomous execution.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/state-manager
+ * @since v0.22.0
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+/**
+ * State Manager - Track workflow state and checkpoints
+ */
+export class StateManager {
+    constructor(checkpointDir, maxCheckpoints = 10) {
+        this.checkpointDir = checkpointDir || '.specweave/checkpoints';
+        this.maxCheckpoints = maxCheckpoints;
+    }
+    /**
+     * Save checkpoint
+     *
+     * @param checkpoint - Checkpoint data
+     */
+    async saveCheckpoint(checkpoint) {
+        await fs.ensureDir(this.checkpointDir);
+        const checkpointPath = path.join(this.checkpointDir, `${checkpoint.incrementId}-${checkpoint.id}.json`);
+        await fs.writeJson(checkpointPath, checkpoint, { spaces: 2 });
+        // Cleanup old checkpoints
+        await this.cleanupOldCheckpoints(checkpoint.incrementId);
+    }
+    /**
+     * Load checkpoints for increment
+     *
+     * @param incrementId - Increment ID
+     * @returns Array of checkpoints (sorted by timestamp, newest first)
+     */
+    async loadCheckpoints(incrementId) {
+        if (!await fs.pathExists(this.checkpointDir)) {
+            return [];
+        }
+        const files = await fs.readdir(this.checkpointDir);
+        const checkpointFiles = files.filter(f => f.startsWith(`${incrementId}-`) && f.endsWith('.json'));
+        const checkpoints = [];
+        for (const file of checkpointFiles) {
+            try {
+                const checkpoint = await fs.readJson(path.join(this.checkpointDir, file));
+                checkpoints.push(checkpoint);
+            }
+            catch (error) {
+                // Skip corrupted checkpoints
+                console.warn(`Failed to load checkpoint ${file}:`, error);
+            }
+        }
+        // Sort by timestamp (newest first)
+        return checkpoints.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Get latest checkpoint for increment
+     *
+     * @param incrementId - Increment ID
+     * @returns Latest checkpoint or null
+     */
+    async getLatestCheckpoint(incrementId) {
+        const checkpoints = await this.loadCheckpoints(incrementId);
+        return checkpoints[0] || null;
+    }
+    /**
+     * Delete checkpoint
+     *
+     * @param incrementId - Increment ID
+     * @param checkpointId - Checkpoint ID
+     */
+    async deleteCheckpoint(incrementId, checkpointId) {
+        const checkpointPath = path.join(this.checkpointDir, `${incrementId}-${checkpointId}.json`);
+        if (await fs.pathExists(checkpointPath)) {
+            await fs.remove(checkpointPath);
+        }
+    }
+    /**
+     * Cleanup old checkpoints (keep only N most recent)
+     *
+     * @param incrementId - Increment ID
+     */
+    async cleanupOldCheckpoints(incrementId) {
+        const checkpoints = await this.loadCheckpoints(incrementId);
+        if (checkpoints.length > this.maxCheckpoints) {
+            const toDelete = checkpoints.slice(this.maxCheckpoints);
+            for (const checkpoint of toDelete) {
+                await this.deleteCheckpoint(incrementId, checkpoint.id);
+            }
+        }
+    }
+    /**
+     * Detect infinite loop in phase history
+     *
+     * Checks if the same phase has been visited too many times in a row.
+     *
+     * @param phaseHistory - Recent phase history
+     * @param threshold - Max same-phase repetitions (default: 3)
+     * @returns True if loop detected
+     */
+    detectLoop(phaseHistory, threshold = 3) {
+        if (phaseHistory.length < threshold) {
+            return false;
+        }
+        // Check if last N phases are all the same
+        const recentPhases = phaseHistory.slice(-threshold);
+        const uniquePhases = new Set(recentPhases);
+        return uniquePhases.size === 1;
+    }
+    /**
+     * Record state transition
+     *
+     * (For now, this is a no-op - will be used for analytics/debugging)
+     *
+     * @param transition - State transition record
+     */
+    recordTransition(transition) {
+        // TODO: Implement transition logging
+        // For now, just log to console
+        console.log(`State transition: ${transition.from} → ${transition.to} (${transition.action})`);
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/src/core/workflow/state-manager.js.map

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

package/dist/src/core/workflow/workflow-orchestrator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Workflow Orchestrator - Core orchestration logic for /specweave:next
+ *
+ * Coordinates workflow execution by detecting current phase and
+ * invoking appropriate commands.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/workflow-orchestrator
+ * @since v0.22.0
+ */
+import { WorkflowPhase } from './types.js';
+/**
+ * Workflow execution options
+ */
+export interface WorkflowExecuteOptions {
+    /** Auto-approve actions without prompting (dangerous!) */
+    autonomous?: boolean;
+    /** Show detailed execution information */
+    verbose?: boolean;
+    /** Dry-run mode (preview actions without executing) */
+    dryRun?: boolean;
+    /** Force execution even with low confidence */
+    force?: boolean;
+}
+/**
+ * Workflow execution result
+ */
+export interface WorkflowExecutionResult {
+    /** Execution succeeded */
+    success: boolean;
+    /** Phase that was detected */
+    phase: WorkflowPhase;
+    /** Confidence score for phase detection */
+    confidence: number;
+    /** Action that was taken */
+    action?: string;
+    /** Command that was invoked */
+    command?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Human-readable explanation */
+    reasoning?: string;
+    /** Phase detection evidence */
+    evidence?: string[];
+}
+/**
+ * Workflow Orchestrator - Coordinates intelligent workflow execution
+ *
+ * This is a simplified initial implementation focusing on core phase detection.
+ * Full autonomous execution will be added in future tasks.
+ */
+export declare class WorkflowOrchestrator {
+    private phaseDetector;
+    private activeIncrementManager;
+    constructor();
+    /**
+     * Execute next step in workflow (interactive mode)
+     *
+     * Detects current phase and suggests/executes appropriate action.
+     *
+     * @param incrementId - Optional increment ID (auto-detects if not provided)
+     * @param options - Execution options
+     * @returns Workflow execution result
+     */
+    executeNext(incrementId?: string, options?: WorkflowExecuteOptions): Promise<WorkflowExecutionResult>;
+    /**
+     * Format reasoning from phase detection result
+     */
+    private formatReasoning;
+    /**
+     * Detect current workflow phase for increment
+     *
+     * @param incrementId - Increment ID (auto-detects if not provided)
+     * @returns Phase detection result
+     */
+    private detectCurrentPhase;
+    /**
+     * Auto-detect active increment
+     *
+     * @returns Increment ID or throws if none found
+     */
+    private detectActiveIncrement;
+    /**
+     * Determine action based on phase and confidence
+     *
+     * @param detection - Phase detection result
+     * @param options - Execution options
+     * @returns Suggested action
+     */
+    private determineAction;
+}
+//# sourceMappingURL=workflow-orchestrator.d.ts.map

package/dist/src/core/workflow/workflow-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-orchestrator.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/workflow-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAA0C,MAAM,YAAY,CAAC;AAGnF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,sBAAsB,CAAyB;;IAOvD;;;;;;;;OAQG;IACG,WAAW,CACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC;IA0CnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;;;;OAKG;YACW,kBAAkB;IAiBhC;;;;OAIG;YACW,qBAAqB;IAiBnC;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;CAuExB"}

package/dist/src/core/workflow/workflow-orchestrator.js

@@ -0,0 +1,195 @@
+/**
+ * Workflow Orchestrator - Core orchestration logic for /specweave:next
+ *
+ * Coordinates workflow execution by detecting current phase and
+ * invoking appropriate commands.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/workflow-orchestrator
+ * @since v0.22.0
+ */
+import { PhaseDetector } from './phase-detector.js';
+import { WorkflowPhase } from './types.js';
+import { ActiveIncrementManager } from '../increment/active-increment-manager.js';
+/**
+ * Workflow Orchestrator - Coordinates intelligent workflow execution
+ *
+ * This is a simplified initial implementation focusing on core phase detection.
+ * Full autonomous execution will be added in future tasks.
+ */
+export class WorkflowOrchestrator {
+    constructor() {
+        this.phaseDetector = new PhaseDetector();
+        this.activeIncrementManager = new ActiveIncrementManager();
+    }
+    /**
+     * Execute next step in workflow (interactive mode)
+     *
+     * Detects current phase and suggests/executes appropriate action.
+     *
+     * @param incrementId - Optional increment ID (auto-detects if not provided)
+     * @param options - Execution options
+     * @returns Workflow execution result
+     */
+    async executeNext(incrementId, options = {}) {
+        try {
+            // Phase 1: Detect current workflow phase
+            const detection = await this.detectCurrentPhase(incrementId);
+            // Phase 2: Determine action based on phase and confidence
+            const action = this.determineAction(detection, options);
+            // Format reasoning from detection evidence
+            const reasoning = this.formatReasoning(detection);
+            // Phase 3: Execute action (or return suggestion)
+            if (options.dryRun) {
+                return {
+                    success: true,
+                    phase: detection.phase,
+                    confidence: detection.confidence,
+                    action: action.description,
+                    reasoning: `[DRY RUN] Would execute: ${action.description}\n\n${reasoning}`
+                };
+            }
+            // For now, return suggestion (actual execution will be added in later tasks)
+            return {
+                success: true,
+                phase: detection.phase,
+                confidence: detection.confidence,
+                action: action.description,
+                command: action.command,
+                reasoning
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                phase: WorkflowPhase.UNKNOWN,
+                confidence: 0,
+                error: error instanceof Error ? error.message : String(error),
+                reasoning: 'Failed to detect workflow phase or execute action'
+            };
+        }
+    }
+    /**
+     * Format reasoning from phase detection result
+     */
+    formatReasoning(detection) {
+        const parts = [];
+        // Add suggestion reason if present
+        if (detection.suggestionReason) {
+            parts.push(detection.suggestionReason);
+        }
+        // Add evidence summary
+        if (detection.evidence && detection.evidence.length > 0) {
+            parts.push('\nEvidence:');
+            detection.evidence.forEach(ev => {
+                parts.push(`- ${ev.description} (${(ev.weight * 100).toFixed(0)}% weight)`);
+            });
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Detect current workflow phase for increment
+     *
+     * @param incrementId - Increment ID (auto-detects if not provided)
+     * @returns Phase detection result
+     */
+    async detectCurrentPhase(incrementId) {
+        // If no increment ID provided, try to auto-detect active increment
+        if (!incrementId) {
+            incrementId = await this.detectActiveIncrement();
+        }
+        // Build detection context
+        const context = {
+            userPrompt: 'Detect current workflow phase',
+            incrementId,
+            workingDirectory: process.cwd()
+        };
+        // Detect phase using PhaseDetector
+        return this.phaseDetector.detect(context);
+    }
+    /**
+     * Auto-detect active increment
+     *
+     * @returns Increment ID or throws if none found
+     */
+    async detectActiveIncrement() {
+        const activeIds = this.activeIncrementManager.getActive();
+        if (activeIds.length === 0) {
+            throw new Error('No active increments found. Use /specweave:increment to create one.');
+        }
+        if (activeIds.length === 1) {
+            return activeIds[0];
+        }
+        // Multiple active increments - return primary (first)
+        console.log(`Multiple active increments detected: ${activeIds.join(', ')}`);
+        console.log(`Using primary increment: ${activeIds[0]}`);
+        return activeIds[0];
+    }
+    /**
+     * Determine action based on phase and confidence
+     *
+     * @param detection - Phase detection result
+     * @param options - Execution options
+     * @returns Suggested action
+     */
+    determineAction(detection, options) {
+        const { phase, confidence } = detection;
+        // Low confidence - prompt user
+        if (confidence < 0.7 && !options.force) {
+            return {
+                description: `Phase detection confidence is low (${(confidence * 100).toFixed(0)}%). Please specify action manually.`,
+                command: undefined
+            };
+        }
+        // Map phase to action
+        switch (phase) {
+            case WorkflowPhase.PLAN_GENERATION:
+                return {
+                    description: 'Generate implementation plan',
+                    command: '/specweave:plan'
+                };
+            case WorkflowPhase.IMPLEMENTATION:
+                return {
+                    description: 'Execute tasks',
+                    command: '/specweave:do'
+                };
+            case WorkflowPhase.TESTING:
+                return {
+                    description: 'Run tests',
+                    command: 'npm test'
+                };
+            case WorkflowPhase.REVIEW:
+                return {
+                    description: 'Run quality assessment',
+                    command: '/specweave:qa'
+                };
+            case WorkflowPhase.COMPLETION:
+                return {
+                    description: 'Close increment',
+                    command: '/specweave:done'
+                };
+            case WorkflowPhase.SPEC_WRITING:
+                return {
+                    description: 'Complete spec.md and generate plan',
+                    command: '/specweave:plan'
+                };
+            case WorkflowPhase.TASK_BREAKDOWN:
+                return {
+                    description: 'Create tasks and start implementation',
+                    command: '/specweave:do'
+                };
+            case WorkflowPhase.DOCUMENTATION:
+                return {
+                    description: 'Update living documentation',
+                    command: '/specweave:sync-docs update'
+                };
+            default:
+                return {
+                    description: 'Phase detection unclear - please specify action manually',
+                    command: undefined
+                };
+        }
+    }
+}
+//# sourceMappingURL=workflow-orchestrator.js.map

package/dist/src/core/workflow/workflow-orchestrator.js.map

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

package/dist/src/init/ArchitecturePresenter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Architecture Presenter - Display recommendations with interactive UI
+ *
+ * Presents architecture recommendations with clear rationale and allows
+ * user to accept, reject, or modify the suggestion.
+ *
+ * AC-US5-08: Clear rationale for architecture decision
+ * AC-US5-09: User can accept/reject/modify recommendation
+ */
+import type { ArchitectureRecommendation } from './architecture/types.js';
+import type { TeamRecommendation } from './team/types.js';
+/**
+ * Present architecture recommendation to user with full details
+ *
+ * Shows:
+ * - Architecture type with rationale
+ * - Infrastructure components
+ * - Cost estimates at different scales
+ * - Cloud credits available
+ * - Generated project list
+ * - Team recommendations
+ *
+ * @param architecture - Architecture recommendation from decision engine
+ * @param teams - Team recommendations
+ */
+export declare function presentArchitectureRecommendation(architecture: ArchitectureRecommendation | any, teams: TeamRecommendation | any): void;
+/**
+ * Prompt user to accept, reject, or modify recommendation
+ *
+ * Note: In real implementation, this would use inquirer for interactive prompts
+ * For now, we provide the interface structure
+ */
+export declare function promptAcceptArchitecture(): Promise<'accept' | 'reject' | 'modify'>;
+/**
+ * Prompt user to modify architecture recommendation
+ *
+ * Allows customization of:
+ * - Architecture type
+ * - Infrastructure components
+ * - Project structure
+ */
+export declare function promptModifyArchitecture(architecture: ArchitectureRecommendation): Promise<ArchitectureRecommendation>;
+/**
+ * Present architecture summary after user acceptance
+ */
+export declare function presentArchitectureSummary(architecture: ArchitectureRecommendation): void;
+//# sourceMappingURL=ArchitecturePresenter.d.ts.map

package/dist/src/init/ArchitecturePresenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchitecturePresenter.d.ts","sourceRoot":"","sources":["../../../src/init/ArchitecturePresenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,0BAA0B,GAAG,GAAG,EAC9C,KAAK,EAAE,kBAAkB,GAAG,GAAG,GAC9B,IAAI,CA6GN;AAkBD;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAUxF;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,0BAA0B,GACvC,OAAO,CAAC,0BAA0B,CAAC,CAUrC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,0BAA0B,GAAG,IAAI,CAMzF"}

package/dist/src/init/ArchitecturePresenter.js

@@ -0,0 +1,180 @@
+/**
+ * Architecture Presenter - Display recommendations with interactive UI
+ *
+ * Presents architecture recommendations with clear rationale and allows
+ * user to accept, reject, or modify the suggestion.
+ *
+ * AC-US5-08: Clear rationale for architecture decision
+ * AC-US5-09: User can accept/reject/modify recommendation
+ */
+/**
+ * Present architecture recommendation to user with full details
+ *
+ * Shows:
+ * - Architecture type with rationale
+ * - Infrastructure components
+ * - Cost estimates at different scales
+ * - Cloud credits available
+ * - Generated project list
+ * - Team recommendations
+ *
+ * @param architecture - Architecture recommendation from decision engine
+ * @param teams - Team recommendations
+ */
+export function presentArchitectureRecommendation(architecture, teams) {
+    console.log('\n' + '═'.repeat(70));
+    console.log('  🏗️  ARCHITECTURE RECOMMENDATION');
+    console.log('═'.repeat(70));
+    // Handle array format (legacy architecture decisions)
+    if (Array.isArray(architecture)) {
+        console.log('\n📐 Architecture Decisions:');
+        for (const decision of architecture) {
+            console.log(`\n• ${decision.category}: ${decision.decision}`);
+            console.log(`  ${decision.rationale}`);
+        }
+        // Show team recommendations (legacy format)
+        if (teams) {
+            console.log('\n👥 Team Recommendations:');
+            console.log(`   • Recommended Size: ${teams.recommended} people`);
+            console.log(`   • Range: ${teams.min}-${teams.max} people`);
+            console.log(`   • Roles: ${teams.roles.join(', ')}`);
+            console.log(`\n💡 ${teams.rationale}`);
+        }
+        console.log('\n' + '═'.repeat(70));
+        return;
+    }
+    // Full ArchitectureRecommendation format
+    const arch = architecture;
+    // 1. Architecture Type & Rationale
+    console.log(`\n📐 Architecture Type: ${formatArchitectureType(arch.architecture)}`);
+    console.log(`\n💡 Rationale:`);
+    console.log(`   ${arch.rationale}`);
+    // 2. Infrastructure Components
+    if (arch.infrastructure && arch.infrastructure.length > 0) {
+        console.log(`\n🔧 Infrastructure:`);
+        for (const component of arch.infrastructure) {
+            console.log(`   • ${component}`);
+        }
+    }
+    // 3. Cost Estimates
+    if (arch.costEstimate) {
+        console.log(`\n💰 Cost Estimates:`);
+        console.log(`   • At 1K users:   ${arch.costEstimate.at1K}`);
+        console.log(`   • At 10K users:  ${arch.costEstimate.at10K}`);
+        console.log(`   • At 100K users: ${arch.costEstimate.at100K}`);
+        console.log(`   • At 1M users:   ${arch.costEstimate.at1M}`);
+    }
+    // 4. Cloud Credits
+    if (arch.cloudCredits && arch.cloudCredits.length > 0) {
+        console.log(`\n☁️  Available Cloud Credits:`);
+        for (const credit of arch.cloudCredits.slice(0, 3)) {
+            console.log(`   • ${credit.provider}: ${credit.amount} (${credit.duration})`);
+            if (credit.requirements) {
+                console.log(`     Requirements: ${credit.requirements}`);
+            }
+            if (credit.url) {
+                console.log(`     Apply: ${credit.url}`);
+            }
+        }
+    }
+    // 5. Generated Projects
+    if (arch.projects && arch.projects.length > 0) {
+        console.log(`\n📦 Generated Projects:`);
+        for (const project of arch.projects) {
+            console.log(`   • ${project.name}`);
+            console.log(`     ${project.description}`);
+            if (project.stack && project.stack.length > 0) {
+                console.log(`     Stack: ${project.stack.join(', ')}`);
+            }
+        }
+    }
+    // 6. Team Recommendations
+    if (teams) {
+        console.log(`\n👥 Team Recommendations:`);
+        if (typeof teams.recommended === 'number') {
+            console.log(`   • Recommended Size: ${teams.recommended} people`);
+            console.log(`   • Range: ${teams.min}-${teams.max} people`);
+        }
+        if (teams.roles && teams.roles.length > 0) {
+            console.log(`   • Roles: ${teams.roles.join(', ')}`);
+        }
+        if (teams.rationale) {
+            console.log(`\n💡 ${teams.rationale}`);
+        }
+    }
+    // 7. Alternative Architectures
+    if (arch.alternatives && arch.alternatives.length > 0) {
+        console.log(`\n🔄 Alternative Architectures Considered:`);
+        for (const alt of arch.alternatives) {
+            console.log(`\n   ${formatArchitectureType(alt.architecture)}:`);
+            console.log(`   Pros:`);
+            for (const pro of alt.pros) {
+                console.log(`     ✓ ${pro}`);
+            }
+            console.log(`   Cons:`);
+            for (const con of alt.cons) {
+                console.log(`     ✗ ${con}`);
+            }
+        }
+    }
+    console.log('\n' + '═'.repeat(70));
+}
+/**
+ * Format architecture type for display
+ */
+function formatArchitectureType(type) {
+    const typeMap = {
+        'serverless': 'Serverless (AWS Lambda, Vercel, Supabase)',
+        'traditional-monolith': 'Traditional Monolith (EC2/ECS)',
+        'microservices': 'Microservices (Kubernetes)',
+        'modular-monolith': 'Modular Monolith',
+        'jamstack': 'JAMstack (Static site + APIs)',
+        'hybrid': 'Hybrid Architecture'
+    };
+    return typeMap[type] || type;
+}
+/**
+ * Prompt user to accept, reject, or modify recommendation
+ *
+ * Note: In real implementation, this would use inquirer for interactive prompts
+ * For now, we provide the interface structure
+ */
+export async function promptAcceptArchitecture() {
+    // TODO: Replace with interactive prompt using inquirer
+    // Question: "Do you accept this architecture recommendation?"
+    // Options:
+    //   - "Yes, this looks good (accept)"
+    //   - "No, I want a different architecture (reject)"
+    //   - "Let me customize this recommendation (modify)"
+    // Default to accept for now
+    return 'accept';
+}
+/**
+ * Prompt user to modify architecture recommendation
+ *
+ * Allows customization of:
+ * - Architecture type
+ * - Infrastructure components
+ * - Project structure
+ */
+export async function promptModifyArchitecture(architecture) {
+    // TODO: Replace with interactive prompt using inquirer
+    // Allow user to:
+    // 1. Change architecture type
+    // 2. Add/remove infrastructure components
+    // 3. Customize project list
+    // 4. Adjust cost estimates
+    // For now, return unchanged
+    return architecture;
+}
+/**
+ * Present architecture summary after user acceptance
+ */
+export function presentArchitectureSummary(architecture) {
+    console.log('\n✅ Architecture Confirmed!\n');
+    console.log(`   Type: ${formatArchitectureType(architecture.architecture)}`);
+    console.log(`   Projects: ${architecture.projects.length} projects`);
+    console.log(`   Infrastructure: ${architecture.infrastructure.length} components`);
+    console.log('\n   Your architecture is ready to use.\n');
+}
+//# sourceMappingURL=ArchitecturePresenter.js.map