gameforge-cli 0.1.0 → 0.2.0

package/dist/index.js

@@ -29,6 +29,8 @@ const TechSpecialist_1 = require("./agents/specialists/TechSpecialist");
 const CreativeSpecialist_1 = require("./agents/specialists/CreativeSpecialist");
 const Orchestrator_1 = require("./core/Orchestrator");
 const debugLogger_1 = require("./utils/debugLogger");
+const issueReviewer_1 = require("./utils/issueReviewer");
+const Modifier_1 = require("./agents/core/Modifier");
 dotenv_1.default.config();
 const program = new commander_1.Command();
 program
@@ -77,6 +79,13 @@ program
     });
     console.log(picocolors_1.default.dim('Usage: gameforge create --template <id>\n'));
 });
+program
+    .command('modify <sessionId>')
+    .description('Modify an existing game design document')
+    .option('-d, --debug', 'Enable debug logging to file')
+    .action(async (sessionId, options) => {
+    await runModifyFlow(sessionId, options);
+});
 program.parse();
 async function runCreationFlow(options) {
     console.clear();
@@ -142,12 +151,19 @@ async function runCreationFlow(options) {
         // Phase 1: Discovery
         console.log(picocolors_1.default.cyan('\n📋 Phase 1: Discovery\n'));
         stateMachine.transition(StateMachine_1.GameForgePhase.DISCOVERY);
+        costTracker.startPhase('discovery');
         const inquisitor = new Inquisitor_1.Inquisitor(apiKey, costTracker, modelSelector);
         const questions = getInquisitorQuestions(options.template);
         const transcript = await inquisitor.execute(questions);
         transcript.forEach(entry => {
             stateMachine.addTranscriptEntry(entry.question, entry.answer, entry.autoGenerated);
         });
+        // End discovery phase and show cost
+        const discoveryCost = costTracker.endPhase();
+        if (discoveryCost && discoveryCost.operations > 0) {
+            console.log(picocolors_1.default.green('\n✓ Discovery complete'));
+            costTracker.printPhaseSummary(discoveryCost);
+        }
         // Gate 1: Review Concept
         console.log(picocolors_1.default.cyan('\n📊 Concept Review\n'));
         stateMachine.transition(StateMachine_1.GameForgePhase.REVIEW_CONCEPT);
@@ -161,6 +177,7 @@ async function runCreationFlow(options) {
         // Phase 2: Architecture
         console.log(picocolors_1.default.cyan('\n🏗️  Phase 2: Architecture\n'));
         stateMachine.transition(StateMachine_1.GameForgePhase.ARCHITECTURE);
+        costTracker.startPhase('architecture');
         const spinner = (0, ora_1.default)('Generating Game Bible...').start();
         const architect = new Architect_1.Architect(apiKey, costTracker, modelSelector);
         let bible = await architect.execute(transcript, (message) => {
@@ -173,6 +190,11 @@ async function runCreationFlow(options) {
         }
         stateMachine.updateBible(bible);
         spinner.succeed('Game Bible generated');
+        // End architecture phase and show cost
+        const architectureCost = costTracker.endPhase();
+        if (architectureCost) {
+            costTracker.printPhaseSummary(architectureCost);
+        }
         // Save checkpoint
         await sessionManager.saveCheckpoint(sessionId, stateMachine.getState(), 'after_architecture');
         // Gate 2: Review Data
@@ -188,7 +210,8 @@ async function runCreationFlow(options) {
         // Phase 3: Production (Specialists)
         console.log(picocolors_1.default.cyan('\n🎨 Phase 3: Production\n'));
         stateMachine.transition(StateMachine_1.GameForgePhase.PRODUCTION);
-        const orchestrator = new Orchestrator_1.SpecialistOrchestrator(2); // Concurrency of 2
+        costTracker.startPhase('production');
+        const orchestrator = new Orchestrator_1.SpecialistOrchestrator();
         const specialists = [
             { name: 'Creative Direction', agent: new CreativeSpecialist_1.CreativeSpecialist(apiKey, costTracker, modelSelector) },
             { name: 'Feature Specifications', agent: new FeatureSpecialist_1.FeatureSpecialist(apiKey, costTracker, modelSelector) },
@@ -196,9 +219,16 @@ async function runCreationFlow(options) {
             { name: 'Technical Specifications', agent: new TechSpecialist_1.TechSpecialist(apiKey, costTracker, modelSelector) }
         ];
         let markdownSections = await orchestrator.runAllSpecialists(bible, specialists);
+        // End production phase and show cost
+        const productionCost = costTracker.endPhase();
+        if (productionCost) {
+            console.log(picocolors_1.default.green('\n✓ Production complete'));
+            costTracker.printPhaseSummary(productionCost);
+        }
         // Phase 4: Validation
         console.log(picocolors_1.default.cyan('\n✅ Phase 4: Validation\n'));
         stateMachine.transition(StateMachine_1.GameForgePhase.VALIDATION);
+        costTracker.startPhase('validation');
         // Run consistency check
         const consistencyAgent = new Consistency_1.ConsistencyAgent();
         let currentConsistencyIssues = consistencyAgent.validate(bible);
@@ -210,106 +240,86 @@ async function runCreationFlow(options) {
             chaosSpinner.text = `Chaos Agent: ${message}`;
         });
         chaosSpinner.succeed(`Found ${currentChaosIssues.length} design issues`);
-        // Gate 3: Review Issues with Fix Option
-        const MAX_FIX_ATTEMPTS = 3;
-        let fixAttempts = 0;
+        // End validation phase and show cost
+        const validationCost = costTracker.endPhase();
+        if (validationCost) {
+            costTracker.printPhaseSummary(validationCost);
+        }
+        // Gate 3: Review Issues One by One
+        stateMachine.transition(StateMachine_1.GameForgePhase.REVIEW_ISSUES);
         let fixesApplied = false;
-        while (true) {
-            stateMachine.transition(StateMachine_1.GameForgePhase.REVIEW_ISSUES);
-            const totalIssues = currentConsistencyIssues.length + currentChaosIssues.length;
-            if (totalIssues > 0) {
-                console.log(picocolors_1.default.yellow(`\n⚠️  ${totalIssues} issues found:`));
-                currentConsistencyIssues.slice(0, 3).forEach((issue) => {
-                    console.log(picocolors_1.default.dim(`  - [${issue.severity}] ${issue.message}`));
-                });
-                currentChaosIssues.slice(0, 3).forEach((issue) => {
-                    console.log(picocolors_1.default.dim(`  - [${issue.severity}] ${issue.description}`));
-                });
-                if (totalIssues > 6) {
-                    console.log(picocolors_1.default.dim(`  ... and ${totalIssues - 6} more issues`));
-                }
-                if (fixAttempts > 0) {
-                    console.log(picocolors_1.default.cyan(`\n(Fix attempt ${fixAttempts}/${MAX_FIX_ATTEMPTS} complete)`));
+        const totalIssues = currentConsistencyIssues.length + currentChaosIssues.length;
+        if (totalIssues > 0) {
+            console.log(picocolors_1.default.yellow(`\n⚠️  ${totalIssues} issues found. Let's review them one by one.\n`));
+            // Review each issue one by one
+            const reviewed = await (0, issueReviewer_1.reviewIssuesOneByOne)(currentConsistencyIssues, currentChaosIssues);
+            // If user selected any issues to fix
+            if (reviewed.toFix.length > 0) {
+                const proceed = await confirmGate(`Fix ${reviewed.toFix.length} selected issue(s)?`);
+                if (proceed) {
+                    fixesApplied = true;
+                    console.log(picocolors_1.default.cyan(`\n🔧 Fixing ${reviewed.toFix.length} issues...\n`));
+                    costTracker.startPhase('remediation');
+                    const remediationSpinner = (0, ora_1.default)('Running Remediation Agent...').start();
+                    const remediationAgent = new Remediation_1.Remediation(apiKey, costTracker, modelSelector);
+                    try {
+                        // Convert to IssueWithNotes format for Remediation
+                        const issuesToFix = (0, issueReviewer_1.convertToIssuesWithNotes)(reviewed);
+                        const result = await remediationAgent.execute(bible, issuesToFix, (message) => {
+                            remediationSpinner.text = `Remediation: ${message}`;
+                        });
+                        remediationSpinner.succeed(`Fixed ${result.fixedIssues.length} issues`);
+                        // End remediation phase and show cost
+                        const remediationCost = costTracker.endPhase();
+                        if (remediationCost) {
+                            costTracker.printPhaseSummary(remediationCost);
+                        }
+                        if (result.fixedIssues.length > 0) {
+                            console.log(picocolors_1.default.green('\nFixes applied:'));
+                            result.fixedIssues.forEach((fix) => {
+                                console.log(picocolors_1.default.dim(`  ✓ ${fix}`));
+                            });
+                        }
+                        if (result.unfixableIssues.length > 0) {
+                            console.log(picocolors_1.default.yellow('\nCould not fix:'));
+                            result.unfixableIssues.forEach((issue) => {
+                                console.log(picocolors_1.default.dim(`  ✗ ${issue}`));
+                            });
+                        }
+                        // Update bible
+                        bible = result.updatedBible;
+                        stateMachine.updateBible(bible);
+                    }
+                    catch (error) {
+                        remediationSpinner.fail('Remediation failed');
+                        console.error(picocolors_1.default.red('Error during remediation:'), error);
+                        const continueAnyway = await confirmGate('Continue to save despite remediation failure?');
+                        if (!continueAnyway) {
+                            console.log(picocolors_1.default.yellow('Exiting...'));
+                            return;
+                        }
+                    }
                 }
             }
-            else {
-                console.log(picocolors_1.default.green('\n✓ All issues resolved!'));
-            }
-            // Determine action based on state
-            let action;
-            if (totalIssues === 0) {
-                const proceed = await confirmGate('Save and export GDD?');
-                action = proceed ? 'save' : 'exit';
-            }
-            else if (fixAttempts >= MAX_FIX_ATTEMPTS) {
-                console.log(picocolors_1.default.yellow(`\nMaximum fix attempts (${MAX_FIX_ATTEMPTS}) reached.`));
-                const proceed = await confirmGate('Save and export GDD with remaining issues?');
-                action = proceed ? 'save' : 'exit';
-            }
-            else {
-                action = await selectReviewAction();
-            }
-            if (action === 'exit') {
+            // Final confirmation to save
+            const saveConfirm = await confirmGate('Save and export GDD?');
+            if (!saveConfirm) {
                 console.log(picocolors_1.default.yellow('Exiting...'));
                 return;
             }
-            if (action === 'save') {
-                break;
-            }
-            // action === 'fix': Run remediation
-            fixAttempts++;
-            fixesApplied = true;
-            console.log(picocolors_1.default.cyan(`\n🔧 Fixing issues (attempt ${fixAttempts}/${MAX_FIX_ATTEMPTS})...\n`));
-            const remediationSpinner = (0, ora_1.default)('Running Remediation Agent...').start();
-            const remediationAgent = new Remediation_1.Remediation(apiKey, costTracker, modelSelector);
-            try {
-                const result = await remediationAgent.execute(bible, currentConsistencyIssues, currentChaosIssues, (message) => { remediationSpinner.text = `Remediation: ${message}`; });
-                remediationSpinner.succeed(`Fixed ${result.fixedIssues.length} issues`);
-                if (result.fixedIssues.length > 0) {
-                    console.log(picocolors_1.default.green('\nFixes applied:'));
-                    result.fixedIssues.forEach(fix => {
-                        console.log(picocolors_1.default.dim(`  ✓ ${fix}`));
-                    });
-                }
-                if (result.unfixableIssues.length > 0) {
-                    console.log(picocolors_1.default.yellow('\nCould not fix:'));
-                    result.unfixableIssues.forEach(issue => {
-                        console.log(picocolors_1.default.dim(`  ✗ ${issue}`));
-                    });
-                }
-                // Update bible
-                bible = result.updatedBible;
-                stateMachine.updateBible(bible);
-                // Transition back to production for re-validation
-                stateMachine.transition(StateMachine_1.GameForgePhase.PRODUCTION);
-                // Re-run validation
-                console.log(picocolors_1.default.cyan('\n🔄 Re-validating...\n'));
-                stateMachine.transition(StateMachine_1.GameForgePhase.VALIDATION);
-                const newConsistencyAgent = new Consistency_1.ConsistencyAgent();
-                currentConsistencyIssues = newConsistencyAgent.validate(bible);
-                console.log(picocolors_1.default.yellow(`Found ${currentConsistencyIssues.length} consistency issues`));
-                chaosSpinner = (0, ora_1.default)('Re-running Chaos Agent...').start();
-                const newChaosAgent = new Chaos_1.Chaos(apiKey, costTracker, modelSelector);
-                currentChaosIssues = await newChaosAgent.execute(bible, (message) => {
-                    chaosSpinner.text = `Chaos Agent: ${message}`;
-                });
-                chaosSpinner.succeed(`Found ${currentChaosIssues.length} design issues`);
-            }
-            catch (error) {
-                remediationSpinner.fail('Remediation failed');
-                console.error(picocolors_1.default.red('Error during remediation:'), error);
-                const continueAnyway = await confirmGate('Continue to save despite remediation failure?');
-                if (!continueAnyway) {
-                    console.log(picocolors_1.default.yellow('Exiting...'));
-                    return;
-                }
-                break;
+        }
+        else {
+            console.log(picocolors_1.default.green('\n✓ No issues found!'));
+            const proceed = await confirmGate('Save and export GDD?');
+            if (!proceed) {
+                console.log(picocolors_1.default.yellow('Exiting...'));
+                return;
             }
         }
         // If fixes were applied, re-run specialists to regenerate markdown
         if (fixesApplied) {
             console.log(picocolors_1.default.cyan('\n🔄 Regenerating documentation with fixed Bible...\n'));
-            markdownSections = await orchestrator.runAllSpecialists(bible, specialists);
+            markdownSections = await orchestrator.runAllSpecialists(bible, specialists, { skipDisambiguation: true });
         }
         // Save all outputs
         console.log(picocolors_1.default.cyan('\n💾 Saving outputs...\n'));
@@ -333,7 +343,9 @@ async function runCreationFlow(options) {
         console.log(picocolors_1.default.green('\n✅ Complete!\n'));
         console.log(picocolors_1.default.dim(`Session ID: ${sessionId}`));
         console.log(picocolors_1.default.dim(`Output directory: ${projectDir}`));
-        console.log(picocolors_1.default.dim(`Total cost: $${report.total.toFixed(2)} (${report.operations} operations)`));
+        // Show per-phase cost breakdown
+        costTracker.printFinalBreakdown();
+        console.log(picocolors_1.default.dim(`Total cost: $${report.total.toFixed(4)} (${report.operations} operations)`));
         console.log(picocolors_1.default.dim(`Budget remaining: $${report.remaining.toFixed(2)}\n`));
         if (debugLogger_1.debugLogger.isEnabled()) {
             console.log(picocolors_1.default.yellow(`🐛 Debug log saved to: ${debugLogger_1.debugLogger.getLogFilePath()}\n`));
@@ -441,19 +453,6 @@ async function confirmGate(message) {
     });
     return response.confirm;
 }
-async function selectReviewAction() {
-    const response = await enquirer_1.default.prompt({
-        type: 'select',
-        name: 'action',
-        message: 'What would you like to do?',
-        choices: [
-            { name: 'save', message: 'Save and export GDD' },
-            { name: 'fix', message: 'Fix issues and re-validate' },
-            { name: 'exit', message: 'Exit without saving' }
-        ]
-    });
-    return response.action;
-}
 async function listSessions() {
     console.log(picocolors_1.default.cyan('\n📋 Saved Sessions\n'));
     const sessionManager = new SessionManager_1.SessionManager();
@@ -678,9 +677,10 @@ async function resumeFlow(idOrCheckpoint, options = {}) {
 async function continueToProduction(stateMachine, bible, apiKey, costTracker, modelSelector, fileManager, sessionId, sessionManager) {
     // Phase 3: Production (Specialists)
     console.log(picocolors_1.default.cyan('\n🎨 Phase 3: Production\n'));
+    costTracker.startPhase('production');
     // Note: Caller should have already transitioned to PRODUCTION phase
     const projectId = sessionId;
-    const orchestrator = new Orchestrator_1.SpecialistOrchestrator(2);
+    const orchestrator = new Orchestrator_1.SpecialistOrchestrator();
     const specialists = [
         { name: 'Creative Direction', agent: new CreativeSpecialist_1.CreativeSpecialist(apiKey, costTracker, modelSelector) },
         { name: 'Feature Specifications', agent: new FeatureSpecialist_1.FeatureSpecialist(apiKey, costTracker, modelSelector) },
@@ -688,9 +688,16 @@ async function continueToProduction(stateMachine, bible, apiKey, costTracker, mo
         { name: 'Technical Specifications', agent: new TechSpecialist_1.TechSpecialist(apiKey, costTracker, modelSelector) }
     ];
     let markdownSections = await orchestrator.runAllSpecialists(bible, specialists);
+    // End production phase and show cost
+    const productionCost = costTracker.endPhase();
+    if (productionCost) {
+        console.log(picocolors_1.default.green('\n✓ Production complete'));
+        costTracker.printPhaseSummary(productionCost);
+    }
     // Phase 4: Validation
     console.log(picocolors_1.default.cyan('\n✅ Phase 4: Validation\n'));
     stateMachine.transition(StateMachine_1.GameForgePhase.VALIDATION);
+    costTracker.startPhase('validation');
     const consistencyAgent = new Consistency_1.ConsistencyAgent();
     let currentConsistencyIssues = consistencyAgent.validate(bible);
     console.log(picocolors_1.default.yellow(`Found ${currentConsistencyIssues.length} consistency issues`));
@@ -698,106 +705,86 @@ async function continueToProduction(stateMachine, bible, apiKey, costTracker, mo
     const chaosAgent = new Chaos_1.Chaos(apiKey, costTracker, modelSelector);
     let currentChaosIssues = await chaosAgent.execute(bible);
     chaosSpinner.succeed(`Found ${currentChaosIssues.length} design issues`);
-    // Gate 3: Review Issues with Fix Option
-    const MAX_FIX_ATTEMPTS = 3;
-    let fixAttempts = 0;
+    // End validation phase and show cost
+    const validationCost = costTracker.endPhase();
+    if (validationCost) {
+        costTracker.printPhaseSummary(validationCost);
+    }
+    // Gate 3: Review Issues One by One
+    stateMachine.transition(StateMachine_1.GameForgePhase.REVIEW_ISSUES);
     let fixesApplied = false;
-    while (true) {
-        stateMachine.transition(StateMachine_1.GameForgePhase.REVIEW_ISSUES);
-        const totalIssues = currentConsistencyIssues.length + currentChaosIssues.length;
-        if (totalIssues > 0) {
-            console.log(picocolors_1.default.yellow(`\n⚠️  ${totalIssues} issues found:`));
-            currentConsistencyIssues.slice(0, 3).forEach((issue) => {
-                console.log(picocolors_1.default.dim(`  - [${issue.severity}] ${issue.message}`));
-            });
-            currentChaosIssues.slice(0, 3).forEach((issue) => {
-                console.log(picocolors_1.default.dim(`  - [${issue.severity}] ${issue.description}`));
-            });
-            if (totalIssues > 6) {
-                console.log(picocolors_1.default.dim(`  ... and ${totalIssues - 6} more issues`));
-            }
-            if (fixAttempts > 0) {
-                console.log(picocolors_1.default.cyan(`\n(Fix attempt ${fixAttempts}/${MAX_FIX_ATTEMPTS} complete)`));
+    const totalIssues = currentConsistencyIssues.length + currentChaosIssues.length;
+    if (totalIssues > 0) {
+        console.log(picocolors_1.default.yellow(`\n⚠️  ${totalIssues} issues found. Let's review them one by one.\n`));
+        // Review each issue one by one
+        const reviewed = await (0, issueReviewer_1.reviewIssuesOneByOne)(currentConsistencyIssues, currentChaosIssues);
+        // If user selected any issues to fix
+        if (reviewed.toFix.length > 0) {
+            const proceed = await confirmGate(`Fix ${reviewed.toFix.length} selected issue(s)?`);
+            if (proceed) {
+                fixesApplied = true;
+                console.log(picocolors_1.default.cyan(`\n🔧 Fixing ${reviewed.toFix.length} issues...\n`));
+                costTracker.startPhase('remediation');
+                const remediationSpinner = (0, ora_1.default)('Running Remediation Agent...').start();
+                const remediationAgent = new Remediation_1.Remediation(apiKey, costTracker, modelSelector);
+                try {
+                    // Convert to IssueWithNotes format for Remediation
+                    const issuesToFix = (0, issueReviewer_1.convertToIssuesWithNotes)(reviewed);
+                    const result = await remediationAgent.execute(bible, issuesToFix, (message) => {
+                        remediationSpinner.text = `Remediation: ${message}`;
+                    });
+                    remediationSpinner.succeed(`Fixed ${result.fixedIssues.length} issues`);
+                    // End remediation phase and show cost
+                    const remediationCost = costTracker.endPhase();
+                    if (remediationCost) {
+                        costTracker.printPhaseSummary(remediationCost);
+                    }
+                    if (result.fixedIssues.length > 0) {
+                        console.log(picocolors_1.default.green('\nFixes applied:'));
+                        result.fixedIssues.forEach((fix) => {
+                            console.log(picocolors_1.default.dim(`  ✓ ${fix}`));
+                        });
+                    }
+                    if (result.unfixableIssues.length > 0) {
+                        console.log(picocolors_1.default.yellow('\nCould not fix:'));
+                        result.unfixableIssues.forEach((issue) => {
+                            console.log(picocolors_1.default.dim(`  ✗ ${issue}`));
+                        });
+                    }
+                    // Update bible
+                    bible = result.updatedBible;
+                    stateMachine.updateBible(bible);
+                }
+                catch (error) {
+                    remediationSpinner.fail('Remediation failed');
+                    console.error(picocolors_1.default.red('Error during remediation:'), error);
+                    const continueAnyway = await confirmGate('Continue to save despite remediation failure?');
+                    if (!continueAnyway) {
+                        console.log(picocolors_1.default.yellow('Exiting...'));
+                        return;
+                    }
+                }
             }
         }
-        else {
-            console.log(picocolors_1.default.green('\n✓ All issues resolved!'));
-        }
-        // Determine action based on state
-        let action;
-        if (totalIssues === 0) {
-            const proceed = await confirmGate('Save and export GDD?');
-            action = proceed ? 'save' : 'exit';
-        }
-        else if (fixAttempts >= MAX_FIX_ATTEMPTS) {
-            console.log(picocolors_1.default.yellow(`\nMaximum fix attempts (${MAX_FIX_ATTEMPTS}) reached.`));
-            const proceed = await confirmGate('Save and export GDD with remaining issues?');
-            action = proceed ? 'save' : 'exit';
-        }
-        else {
-            action = await selectReviewAction();
-        }
-        if (action === 'exit') {
+        // Final confirmation to save
+        const saveConfirm = await confirmGate('Save and export GDD?');
+        if (!saveConfirm) {
             console.log(picocolors_1.default.yellow('Exiting...'));
             return;
         }
-        if (action === 'save') {
-            break;
-        }
-        // action === 'fix': Run remediation
-        fixAttempts++;
-        fixesApplied = true;
-        console.log(picocolors_1.default.cyan(`\n🔧 Fixing issues (attempt ${fixAttempts}/${MAX_FIX_ATTEMPTS})...\n`));
-        const remediationSpinner = (0, ora_1.default)('Running Remediation Agent...').start();
-        const remediationAgent = new Remediation_1.Remediation(apiKey, costTracker, modelSelector);
-        try {
-            const result = await remediationAgent.execute(bible, currentConsistencyIssues, currentChaosIssues, (message) => { remediationSpinner.text = `Remediation: ${message}`; });
-            remediationSpinner.succeed(`Fixed ${result.fixedIssues.length} issues`);
-            if (result.fixedIssues.length > 0) {
-                console.log(picocolors_1.default.green('\nFixes applied:'));
-                result.fixedIssues.forEach(fix => {
-                    console.log(picocolors_1.default.dim(`  ✓ ${fix}`));
-                });
-            }
-            if (result.unfixableIssues.length > 0) {
-                console.log(picocolors_1.default.yellow('\nCould not fix:'));
-                result.unfixableIssues.forEach(issue => {
-                    console.log(picocolors_1.default.dim(`  ✗ ${issue}`));
-                });
-            }
-            // Update bible
-            bible = result.updatedBible;
-            stateMachine.updateBible(bible);
-            // Transition back to production for re-validation
-            stateMachine.transition(StateMachine_1.GameForgePhase.PRODUCTION);
-            // Re-run validation
-            console.log(picocolors_1.default.cyan('\n🔄 Re-validating...\n'));
-            stateMachine.transition(StateMachine_1.GameForgePhase.VALIDATION);
-            const newConsistencyAgent = new Consistency_1.ConsistencyAgent();
-            currentConsistencyIssues = newConsistencyAgent.validate(bible);
-            console.log(picocolors_1.default.yellow(`Found ${currentConsistencyIssues.length} consistency issues`));
-            chaosSpinner = (0, ora_1.default)('Re-running Chaos Agent...').start();
-            const newChaosAgent = new Chaos_1.Chaos(apiKey, costTracker, modelSelector);
-            currentChaosIssues = await newChaosAgent.execute(bible, (message) => {
-                chaosSpinner.text = `Chaos Agent: ${message}`;
-            });
-            chaosSpinner.succeed(`Found ${currentChaosIssues.length} design issues`);
-        }
-        catch (error) {
-            remediationSpinner.fail('Remediation failed');
-            console.error(picocolors_1.default.red('Error during remediation:'), error);
-            const continueAnyway = await confirmGate('Continue to save despite remediation failure?');
-            if (!continueAnyway) {
-                console.log(picocolors_1.default.yellow('Exiting...'));
-                return;
-            }
-            break;
+    }
+    else {
+        console.log(picocolors_1.default.green('\n✓ No issues found!'));
+        const proceed = await confirmGate('Save and export GDD?');
+        if (!proceed) {
+            console.log(picocolors_1.default.yellow('Exiting...'));
+            return;
         }
     }
     // If fixes were applied, re-run specialists to regenerate markdown
     if (fixesApplied) {
         console.log(picocolors_1.default.cyan('\n🔄 Regenerating documentation with fixed Bible...\n'));
-        markdownSections = await orchestrator.runAllSpecialists(bible, specialists);
+        markdownSections = await orchestrator.runAllSpecialists(bible, specialists, { skipDisambiguation: true });
     }
     // Save all outputs
     console.log(picocolors_1.default.cyan('\n💾 Saving outputs...\n'));
@@ -818,7 +805,9 @@ async function continueToProduction(stateMachine, bible, apiKey, costTracker, mo
     console.log(picocolors_1.default.green('\n✅ Complete!\n'));
     console.log(picocolors_1.default.dim(`Session ID: ${sessionId}`));
     console.log(picocolors_1.default.dim(`Output directory: ${projectDir}`));
-    console.log(picocolors_1.default.dim(`Total cost: $${report.total.toFixed(2)} (${report.operations} operations)`));
+    // Show per-phase cost breakdown
+    costTracker.printFinalBreakdown();
+    console.log(picocolors_1.default.dim(`Total cost: $${report.total.toFixed(4)} (${report.operations} operations)`));
     console.log(picocolors_1.default.dim(`Budget remaining: $${report.remaining.toFixed(2)}\n`));
     if (debugLogger_1.debugLogger.isEnabled()) {
         console.log(picocolors_1.default.yellow(`🐛 Debug log saved to: ${debugLogger_1.debugLogger.getLogFilePath()}\n`));
@@ -827,4 +816,155 @@ async function continueToProduction(stateMachine, bible, apiKey, costTracker, mo
     console.log(picocolors_1.default.dim('View this session anytime with:'));
     console.log(picocolors_1.default.dim(`  gameforge session ${sessionId}\n`));
 }
+async function runModifyFlow(sessionId, options) {
+    console.clear();
+    console.log(picocolors_1.default.cyan('\n╔══════════════════════════════════════╗'));
+    console.log(picocolors_1.default.cyan('║   GameForge CLI - Modify Document    ║'));
+    console.log(picocolors_1.default.cyan('╚══════════════════════════════════════╝\n'));
+    // Enable debug logging if requested
+    if (options.debug) {
+        debugLogger_1.debugLogger.enable();
+        debugLogger_1.debugLogger.log('Starting modify flow for session: ' + sessionId);
+    }
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        console.error(picocolors_1.default.red('Error: ANTHROPIC_API_KEY environment variable is not set'));
+        console.log(picocolors_1.default.dim('\nSet your API key:'));
+        console.log(picocolors_1.default.dim('  export ANTHROPIC_API_KEY=your-key-here\n'));
+        return;
+    }
+    const sessionManager = new SessionManager_1.SessionManager();
+    const fileManager = new fileManager_1.FileManager();
+    // Load latest checkpoint for this session
+    console.log(picocolors_1.default.cyan('Loading session...\n'));
+    try {
+        const latest = await sessionManager.getLatestCheckpoint(sessionId);
+        if (!latest || !latest.state.bible) {
+            console.error(picocolors_1.default.red(`No existing GDD found for session: ${sessionId}`));
+            console.log(picocolors_1.default.dim('\nList all sessions with: gameforge sessions\n'));
+            return;
+        }
+        let bible = latest.state.bible;
+        console.log(picocolors_1.default.green(`✓ Loaded GDD: ${bible.meta?.title || 'Untitled'}`));
+        console.log(picocolors_1.default.dim(`  Genre: ${bible.meta?.genre || 'Unknown'}`));
+        console.log(picocolors_1.default.dim(`  Features: ${bible.features?.length || 0}`));
+        console.log(picocolors_1.default.dim(`  Session: ${sessionId}\n`));
+        // Set up cost tracking with remaining budget from checkpoint
+        const budgetLimit = latest.state.budgetLimit || 5.0;
+        const costTracker = new costTracker_1.CostTracker(budgetLimit);
+        const modelSelector = new modelSelector_1.ModelSelector();
+        // Prompt for modification description
+        const response = await enquirer_1.default.prompt({
+            type: 'input',
+            name: 'modification',
+            message: 'Describe the changes you want to make:'
+        });
+        const modification = response.modification.trim();
+        if (!modification) {
+            console.log(picocolors_1.default.yellow('\nNo modification provided. Exiting.'));
+            return;
+        }
+        // Apply modification via Modifier agent
+        console.log(picocolors_1.default.cyan('\n🔧 Applying modifications...\n'));
+        costTracker.startPhase('remediation'); // Use 'remediation' as closest phase type
+        const modifier = new Modifier_1.Modifier(apiKey, costTracker, modelSelector);
+        const modifySpinner = (0, ora_1.default)('Processing modification request...').start();
+        const result = await modifier.execute(bible, modification, (message) => {
+            modifySpinner.text = `Modifier: ${message}`;
+        });
+        modifySpinner.succeed('Modifications applied');
+        // End modification phase and show cost
+        const modificationCost = costTracker.endPhase();
+        if (modificationCost) {
+            costTracker.printPhaseSummary(modificationCost);
+        }
+        // Show summary of changes
+        if (result.changesSummary.length > 0) {
+            console.log(picocolors_1.default.green('\nChanges made:'));
+            result.changesSummary.forEach((change) => {
+                console.log(picocolors_1.default.dim(`  ✓ ${change}`));
+            });
+        }
+        if (result.errors.length > 0) {
+            console.log(picocolors_1.default.yellow('\nWarnings/Errors:'));
+            result.errors.forEach((err) => {
+                console.log(picocolors_1.default.dim(`  ⚠ ${err}`));
+            });
+        }
+        bible = result.updatedBible;
+        // Confirm and regenerate documentation
+        const proceed = await confirmGate('\nRegenerate documentation with these changes?');
+        if (!proceed) {
+            console.log(picocolors_1.default.yellow('Changes discarded.'));
+            return;
+        }
+        // Run specialists to regenerate markdown
+        console.log(picocolors_1.default.cyan('\n🎨 Regenerating documentation...\n'));
+        costTracker.startPhase('production');
+        const orchestrator = new Orchestrator_1.SpecialistOrchestrator();
+        const specialists = [
+            { name: 'Creative Direction', agent: new CreativeSpecialist_1.CreativeSpecialist(apiKey, costTracker, modelSelector) },
+            { name: 'Feature Specifications', agent: new FeatureSpecialist_1.FeatureSpecialist(apiKey, costTracker, modelSelector) },
+            { name: 'Entity Specifications', agent: new EntitySpecialist_1.EntitySpecialist(apiKey, costTracker, modelSelector) },
+            { name: 'Technical Specifications', agent: new TechSpecialist_1.TechSpecialist(apiKey, costTracker, modelSelector) }
+        ];
+        const markdownSections = await orchestrator.runAllSpecialists(bible, specialists, {
+            skipDisambiguation: true
+        });
+        // End specialists phase
+        const specialistsCost = costTracker.endPhase();
+        if (specialistsCost) {
+            costTracker.printPhaseSummary(specialistsCost);
+        }
+        // Run validation for gap analysis
+        console.log(picocolors_1.default.cyan('\n🔍 Running validation...\n'));
+        costTracker.startPhase('validation');
+        const consistencyAgent = new Consistency_1.ConsistencyAgent();
+        const consistencyIssues = consistencyAgent.validate(bible);
+        const chaosSpinner = (0, ora_1.default)('Running Chaos Agent...').start();
+        const chaosAgent = new Chaos_1.Chaos(apiKey, costTracker, modelSelector);
+        const chaosIssues = await chaosAgent.execute(bible, (message) => {
+            chaosSpinner.text = `Chaos Agent: ${message}`;
+        });
+        chaosSpinner.succeed(`Found ${chaosIssues.length} design issues`);
+        const validationCost = costTracker.endPhase();
+        if (validationCost) {
+            costTracker.printPhaseSummary(validationCost);
+        }
+        // Save outputs
+        console.log(picocolors_1.default.cyan('\n💾 Saving outputs...\n'));
+        const projectDir = await fileManager.initialize(sessionId);
+        await fileManager.saveGameBible(projectDir, bible);
+        await fileManager.saveCoverPage(projectDir, bible);
+        for (const [sectionName, content] of markdownSections) {
+            await fileManager.saveMarkdown(projectDir, sectionName, content);
+        }
+        await fileManager.saveGapAnalysis(projectDir, chaosIssues, consistencyIssues);
+        await fileManager.saveCombinedGDD(projectDir, bible, markdownSections, chaosIssues, consistencyIssues);
+        // Save checkpoint
+        const stateMachine = new StateMachine_1.StateMachine(budgetLimit);
+        stateMachine.restoreState(latest.state);
+        stateMachine.updateBible(bible);
+        await sessionManager.saveCheckpoint(sessionId, stateMachine.getState(), 'after_modification');
+        // Final output
+        const report = costTracker.getReport();
+        console.log(picocolors_1.default.green('\n✅ Modification complete!\n'));
+        console.log(picocolors_1.default.dim(`Session ID: ${sessionId}`));
+        console.log(picocolors_1.default.dim(`Output directory: ${projectDir}`));
+        costTracker.printFinalBreakdown();
+        console.log(picocolors_1.default.dim(`Total cost: $${report.total.toFixed(4)} (${report.operations} operations)`));
+        console.log(picocolors_1.default.dim(`Budget remaining: $${report.remaining.toFixed(2)}\n`));
+        if (debugLogger_1.debugLogger.isEnabled()) {
+            console.log(picocolors_1.default.yellow(`🐛 Debug log saved to: ${debugLogger_1.debugLogger.getLogFilePath()}\n`));
+            debugLogger_1.debugLogger.disable();
+        }
+    }
+    catch (error) {
+        console.error(picocolors_1.default.red('Error during modification:'), error);
+        if (debugLogger_1.debugLogger.isEnabled()) {
+            debugLogger_1.debugLogger.log('Modification flow failed: ' + String(error));
+            debugLogger_1.debugLogger.disable();
+        }
+    }
+}
 //# sourceMappingURL=index.js.map