ft-scout 6.0.4 → 6.0.8

package/bin/src/commands/agent.js

@@ -3,14 +3,14 @@ import path from 'path';
 import { spinner, text, isCancel, select, confirm } from '@clack/prompts';
 import chalk from 'chalk';
 import { simpleGit } from 'simple-git';
-import { generateMultiCodeFix, identifyTargetFiles, analyzeCommandError, generateCodeScanReport, generateFeaturePlan, generateCodeFile, askRepoQuestion, } from '../engine/llm.js';
+import { generateMultiCodeFix, identifyTargetFiles, analyzeCommandError, generateCodeScanReport, generateFeaturePlan, generateCodeFile, askRepoQuestion, getActiveModelInfo, } from '../engine/llm.js';
 import { loadContext, recordHistoryAction, getDirectoryFiles } from '../utils/config.js';
 import { renderMarkdown, safeNote } from '../utils/markdown.js';
 import { normalizeLanguage } from '../utils/language.js';
 import { createPullRequest } from '../engine/git.js';
 import { handleUndo } from './undo.js';
-import { AgentExecutionLoop } from '../engine/agentEngine.js';
-import { verifyAndSelfHealFiles, executeSmartCommand } from '../engine/verifier.js';
+import { AgentExecutionLoop, buildDirectoryTree } from '../engine/agentEngine.js';
+import { verifyAndSelfHealFiles, executeSmartCommand, runProjectVerification } from '../engine/verifier.js';
 import { exec } from 'child_process';
 import { promisify } from 'util';
 const execAsync = promisify(exec);
@@ -233,8 +233,8 @@ export async function handleAgent(goalInput, options) {
         console.log(`\n${chalk.bold.red('Credit Quota Exhausted!')}`);
         console.log(chalk.yellow(tierCheck.reason || 'Credit limit reached for Free Tier.'));
         console.log(chalk.cyan('\nTo continue using Scout CLI AI Agent:'));
-        console.log(`  1. Upgrade to ${chalk.bold.green('Pro Tier ($19/mo)')} in dashboard (${chalk.underline('scout dashboard')})`);
-        console.log(`  2. Or enable ${chalk.bold.magenta('BYOK Mode')} in dashboard to use your custom API key / proxy endpoint.\n`);
+        console.log(` 1. Upgrade to ${chalk.bold.green('Pro Tier ($19/mo)')} in dashboard (${chalk.underline('scout dashboard')})`);
+        console.log(` 2. Or enable ${chalk.bold.magenta('BYOK Mode')} in dashboard to use your custom API key / proxy endpoint.\n`);
         return;
     }
     const creditRes = consumeCredit(1);
@@ -251,7 +251,7 @@ export async function handleAgent(goalInput, options) {
         console.log(`${chalk.dim(`Scout Credit Consumed | ${creditRes.remaining} credits remaining`)}`);
         if (creditRes.isLowCredit) {
             console.log(`\n${chalk.bold.yellow('Low Credit Warning:')} Only ${chalk.bold(creditRes.remaining)} credits remaining on your current plan.`);
-            console.log(`  ${chalk.cyan('Run `scout dashboard` to upgrade your tier or activate BYOK mode.')}\n`);
+            console.log(` ${chalk.cyan('Run `scout dashboard` to upgrade your tier or activate BYOK mode.')}\n`);
         }
     }
     const existingContext = loadContext();
@@ -267,16 +267,26 @@ export async function handleAgent(goalInput, options) {
         language: targetLang,
         projectName,
     });
+    const modelInfo = getActiveModelInfo();
+    const fallbackPipeline = modelInfo.fallbackChain.slice(1).join(' ➔ ');
     const welcomeBanner = `
 ${chalk.bold.cyan('Scout Autonomous AI Agent')} ${targetLang ? `(${targetLang})` : ''}
+${chalk.bold('Active Model:')} ${chalk.bold.green(modelInfo.currentActiveModel)}
+${chalk.bold('Fallback Pipeline:')} ${chalk.dim(fallbackPipeline)}
+
 ${chalk.dim('Type your goal, or use slash commands:')}
-  ${chalk.cyan('/help')}    - Show agent tools & commands
-  ${chalk.cyan('/clear')}   - Reset conversation context
-  ${chalk.cyan('/undo')}    - Revert last file modifications
-  ${chalk.cyan('/scan')}    - Run vulnerability scan
-  ${chalk.cyan('/plan')}    - Generate implementation roadmap
-  ${chalk.cyan('/exit')}    - Exit session
-  `.trim();
+${chalk.cyan('/help')}    - Show agent tools & commands (14 tools)
+${chalk.cyan('/tree')}    - View workspace directory tree
+${chalk.cyan('/stats')}   - View real-time session & model telemetry
+${chalk.cyan('/test')}    - Run automated project test suite
+${chalk.cyan('/diff')}    - Show git diff of uncommitted changes
+${chalk.cyan('/export')}  - Save session report to .ft/
+${chalk.cyan('/undo')}    - Revert last file modifications
+${chalk.cyan('/clear')}   - Reset conversation context
+${chalk.cyan('/scan')}    - Run vulnerability scan
+${chalk.cyan('/plan')}    - Generate implementation roadmap
+${chalk.cyan('/exit')}    - Exit session
+`.trim();
     safeNote(welcomeBanner, 'Scout Agent Active Session');
     while (true) {
         let rawGoal = undefined;
@@ -293,35 +303,154 @@ ${chalk.dim('Type your goal, or use slash commands:')}
                 validate: (val) => (!val || !val.trim() ? 'Please enter a prompt or /exit to quit' : undefined),
             });
             if (isCancel(userGoalInput)) {
-                safeNote(chalk.yellow('Exiting Scout Agent session. Goodbye!'), '👋 Scout Agent Ended');
+                safeNote(chalk.yellow('Exiting Scout Agent session. see you soon!'), 'Scout Agent Ended');
                 break;
             }
             const trimmedInput = userGoalInput.trim();
             if (['exit', 'quit', 'q', ':q', '/exit', '/quit'].includes(trimmedInput.toLowerCase())) {
-                safeNote(chalk.yellow('Exiting Scout Agent session. Goodbye!'), '👋 Scout Agent Ended');
+                safeNote(chalk.yellow('Exiting Scout Agent session. see you soon!'), 'Scout Agent Ended');
                 break;
             }
             if (trimmedInput.toLowerCase() === '/help') {
                 const helpText = `
-### 🛠️ Scout Agent Tools
-- **read_file**: Read content & line ranges of codebase files.
-- **write_file**: Create new files or overwrite existing code.
-- **edit_file**: Search-and-replace exact code snippets.
-- **run_command**: Execute shell commands live (\`npm test\`, \`build\`).
-- **grep_search**: Regex/string search across all files.
-- **glob_search**: Pattern search for workspace files.
+### 🛠️ Scout Autonomous Agent Tools (14 Available)
+- **read_file**: Read content & line ranges of workspace files.
+- **write_file**: Create new files or overwrite code directly.
+- **edit_file**: Search & replace exact target code snippets.
+- **multi_edit_file**: Apply batch snippet replacements in a single step.
+- **run_command**: Execute live terminal commands (\`npm test\`, \`build\`).
+- **tree_view**: Generate visual ASCII directory tree structures.
+- **file_info**: Get file statistics, size, lines, & modification time.
+- **grep_search**: String/regex pattern search across codebase.
+- **glob_search**: Filter workspace files by file pattern.
+- **fetch_url**: Fetch web API documentation or URL content.
+- **git_diff**: Retrieve uncommitted workspace git diff.
+- **ask_user**: Request missing secret credentials or API keys.
+- **task_completed**: Conclude autonomous goal execution with teardown.
 
-### ⚡ Slash Commands
-- \`/help\`: View this assistance screen.
-- \`/diff\`: Display colorized git diff of uncommitted workspace changes.
-- \`/clear\` or \`/compact\`: Clear session context window.
-- \`/undo\`: Revert last changes applied by Scout Agent.
-- \`/scan\`: Perform read-only security & bug scan.
-- \`/plan <idea>\`: Generate feature feasibility roadmap.
-- \`/history\`: View recent Scout actions.
-- \`/exit\`: Quit Scout Agent session.
-        `.trim();
-                safeNote(renderMarkdown(helpText), '⚡ Scout Slash Commands & Tools');
+### 🚀 Interactive Slash Commands
+- \`/help\`: Show this tools & commands guide.
+- \`/tree [dir]\`: Display workspace directory tree structure.
+- \`/status\` or \`/stats\`: Show session telemetry & statistics.
+- \`/test [cmd]\`: Run project verification test suite.
+- \`/explain <file>\`: Get deep architectural breakdown of a file.
+- \`/export\` or \`/save-session\`: Save session report to \`.ft/session-<timestamp>.md\`.
+- \`/diff\`: Display colorized git diff of uncommitted changes.
+- \`/clear\` or \`/compact\`: Reset agent conversation context.
+- \`/undo\`: Revert last file modifications.
+- \`/history\`: View recent Scout action logs.
+- \`/exit\`: End Scout Agent session.
+ `.trim();
+                safeNote(renderMarkdown(helpText), ' Scout Slash Commands & Tools');
+                continue;
+            }
+            if (trimmedInput.toLowerCase().startsWith('/tree')) {
+                const parts = trimmedInput.split(/\s+/);
+                const targetDir = parts[1] || '.';
+                const fullDir = path.resolve(process.cwd(), targetDir);
+                if (!fs.existsSync(fullDir) || !fs.statSync(fullDir).isDirectory()) {
+                    safeNote(chalk.yellow(`Directory not found: "${targetDir}"`), '️ Directory Tree Error');
+                }
+                else {
+                    const treeStr = buildDirectoryTree(fullDir, '', 0, 3);
+                    safeNote(`Directory Tree for "${targetDir}":\n${targetDir}/\n${treeStr}`, ' Workspace Directory Tree');
+                }
+                continue;
+            }
+            if (['/status', '/stats'].includes(trimmedInput.toLowerCase())) {
+                const stats = agentLoop.getStats();
+                const modifiedFiles = agentLoop.getModifiedFiles();
+                const backups = agentLoop.getBackups();
+                const git = simpleGit();
+                let currentBranch = 'main';
+                try {
+                    const branchSummary = await git.branch();
+                    currentBranch = branchSummary.current || 'main';
+                }
+                catch { }
+                const elapsedSec = Math.round(stats.elapsedMs / 1000);
+                const activeModel = getActiveModelInfo();
+                const fallbackStatus = activeModel.lastFallbackInfo
+                    ? `Switched from \`${activeModel.lastFallbackInfo.previousModel}\` ➔ \`${activeModel.lastFallbackInfo.fallbackModel}\` (${activeModel.lastFallbackInfo.reason})`
+                    : 'None (Primary model actively responding)';
+                const statsMd = `
+### 📊 Scout Session & AI Model Telemetry
+- **Active AI Model**: \`${activeModel.currentActiveModel}\`
+- **Primary AI Model**: \`${activeModel.primaryModel}\`
+- **Fallback Chain**: \`${activeModel.fallbackChain.join(' ➔ ')}\`
+- **Last Fallback Event**: ${fallbackStatus}
+- **Active Branch**: \`${currentBranch}\`
+- **Elapsed Session Time**: \`${elapsedSec}s\`
+- **Steps Executed**: \`${stats.totalSteps}\`
+- **Total Tool Calls**: \`${stats.totalToolCalls}\`
+- **Modified Files**: \`${modifiedFiles.length}\` (${modifiedFiles.map(f => `\`${f}\``).join(', ') || 'None'})
+- **Stored File Backups**: \`${backups.length}\`
+`.trim();
+                safeNote(renderMarkdown(statsMd), ' Scout Session & Model Telemetry');
+                continue;
+            }
+            if (trimmedInput.toLowerCase().startsWith('/test')) {
+                const parts = trimmedInput.split(/\s+/);
+                const customCmd = parts.slice(1).join(' ') || options?.verifyCmd;
+                const testSpin = spinner();
+                testSpin.start(`Running project verification test suite ${customCmd ? `(\`${customCmd}\`)` : ''}...`);
+                const testRes = await runProjectVerification(process.cwd(), customCmd);
+                if (testRes.valid) {
+                    testSpin.stop(chalk.green('Project verification tests passed cleanly!'));
+                    safeNote(`${chalk.green(' Verification Passed:')}\n\`\`\`\n${testRes.output.slice(0, 3000)}\n\`\`\``, ' Test Suite Clean');
+                }
+                else {
+                    testSpin.stop(chalk.red('Project verification test suite failed.'));
+                    safeNote(`${chalk.red('️ Verification Failed:')}\n${testRes.errors.join('\n')}\n\`\`\`\n${testRes.output.slice(0, 3000)}\n\`\`\``, ' Test Failure Warning');
+                }
+                continue;
+            }
+            if (trimmedInput.toLowerCase().startsWith('/explain')) {
+                const parts = trimmedInput.split(/\s+/);
+                const targetPath = parts[1];
+                if (!targetPath) {
+                    safeNote(chalk.yellow('Usage: /explain <filePath> (e.g. /explain bin/src/index.ts)'), ' Explain Command');
+                    continue;
+                }
+                const fullP = path.resolve(process.cwd(), targetPath);
+                if (!fs.existsSync(fullP)) {
+                    safeNote(chalk.yellow(`File not found: ${targetPath}`), ' Explain Error');
+                    continue;
+                }
+                const explainSpin = spinner();
+                explainSpin.start(`Analyzing architecture and structure of ${targetPath}...`);
+                const content = fs.readFileSync(fullP, 'utf-8');
+                const explanation = await askRepoQuestion(`Provide a deep architectural breakdown, primary purpose, component breakdown, and code explanation for file "${targetPath}":\n\`\`\`\n${content.slice(0, 6000)}\n\`\`\``, projectName, filesList, '', [], { language: targetLang });
+                explainSpin.stop('Analysis complete.');
+                safeNote(renderMarkdown(explanation), ` Architectural Breakdown: ${targetPath}`);
+                continue;
+            }
+            if (['/export', '/save-session'].includes(trimmedInput.toLowerCase())) {
+                const ftDir = path.join(process.cwd(), '.ft');
+                if (!fs.existsSync(ftDir))
+                    fs.mkdirSync(ftDir, { recursive: true });
+                const timeStamp = new Date().toISOString().replace(/[:.]/g, '-');
+                const sessionPath = path.join(ftDir, `session-${timeStamp}.md`);
+                const stats = agentLoop.getStats();
+                const modifiedFiles = agentLoop.getModifiedFiles();
+                const history = (await import('../utils/config.js')).loadHistory();
+                const exportContent = `# Scout Agent Session Report
+Date: ${new Date().toLocaleString()}
+Project: ${projectName}
+
+## Session Statistics
+- Total Steps: ${stats.totalSteps}
+- Tool Calls: ${stats.totalToolCalls}
+- Modified Files Count: ${modifiedFiles.length}
+
+## Modified Files
+${modifiedFiles.map(f => `- ${f}`).join('\n') || 'None'}
+
+## Action History
+${history.slice(0, 15).map(h => `- [${h.timestamp}] ${h.command}: ${h.description}`).join('\n')}
+`;
+                fs.writeFileSync(sessionPath, exportContent, 'utf-8');
+                safeNote(chalk.green(`Session report saved to: ${chalk.bold.cyan(path.relative(process.cwd(), sessionPath))}`), ' Session Exported');
                 continue;
             }
             if (trimmedInput.toLowerCase() === '/diff') {
@@ -329,22 +458,22 @@ ${chalk.dim('Type your goal, or use slash commands:')}
                     const { execSync } = await import('child_process');
                     const gitDiff = execSync('git diff', { encoding: 'utf-8', cwd: process.cwd() });
                     if (!gitDiff || !gitDiff.trim()) {
-                        safeNote(chalk.green('No uncommitted changes found in the workspace.'), '🔍 Workspace Git Diff');
+                        safeNote(chalk.green('No uncommitted changes found in the workspace.'), ' Workspace Git Diff');
                     }
                     else {
                         const previewLines = gitDiff.split('\n');
                         const truncated = previewLines.length > 200 ? previewLines.slice(0, 200).join('\n') + `\n... [truncated, ${previewLines.length} total lines]` : gitDiff;
-                        safeNote(truncated, '📜 Workspace Git Diff');
+                        safeNote(truncated, ' Workspace Git Diff');
                     }
                 }
                 catch {
-                    safeNote(chalk.yellow('Could not retrieve git diff. Ensure this directory is a git repository.'), '⚠️ Git Diff Failed');
+                    safeNote(chalk.yellow('Could not retrieve git diff. Ensure this directory is a git repository.'), '️ Git Diff Failed');
                 }
                 continue;
             }
             if (['/clear', '/compact'].includes(trimmedInput.toLowerCase())) {
                 agentLoop.resetContext();
-                safeNote(chalk.green('Agent context reset successfully.'), '🧹 Session Context Cleared');
+                safeNote(chalk.green('Agent context reset successfully.'), ' Session Context Cleared');
                 continue;
             }
             if (trimmedInput.toLowerCase() === '/undo') {
@@ -354,7 +483,7 @@ ${chalk.dim('Type your goal, or use slash commands:')}
             if (trimmedInput.toLowerCase() === '/history') {
                 const history = (await import('../utils/config.js')).loadHistory();
                 const historyMd = history.slice(0, 10).map((h) => `- **${h.timestamp}**: \`${h.command}\` — ${h.description}`).join('\n') || 'No action history recorded yet.';
-                safeNote(renderMarkdown(historyMd), '📜 Scout History Log');
+                safeNote(renderMarkdown(historyMd), ' Scout History Log');
                 continue;
             }
             rawGoal = trimmedInput;
@@ -371,7 +500,7 @@ ${chalk.dim('Type your goal, or use slash commands:')}
         const isScanIntent = Boolean(options?.scan || (rawGoal && rawGoal.trim().startsWith('/scan')));
         if (isScanIntent) {
             const s = spinner();
-            s.start('🤖 Scout Agent: Performing read-only bug & vulnerability scan...');
+            s.start(' Scout Agent: Performing read-only bug & vulnerability scan...');
             let codeSample = '';
             const pkgPath = path.join(cwd, 'package.json');
             if (fs.existsSync(pkgPath)) {
@@ -391,13 +520,13 @@ ${chalk.dim('Type your goal, or use slash commands:')}
                 }
             };
             const reportLines = issues.map((iss) => `${chalk.bold.cyan(`[Issue #${iss.id}]`)} ${severityBadge(iss.severity)} ${chalk.bold(iss.title)}\n` +
-                `  • File: ${chalk.yellow(iss.file)}\n` +
-                `  • Detail: ${iss.description}`);
+                ` • File: ${chalk.yellow(iss.file)}\n` +
+                ` • Detail: ${iss.description}`);
             safeNote(`Found ${issues.length} potential issues matching past hotfix patterns:\n\n` +
                 reportLines.join('\n\n') +
-                `\n\n${chalk.bold.green('💡 How to Auto-Fix Any Issue with Agent:')}\n` +
-                `  • Auto-fix Issue #${issues[0]?.id || 1}: ${chalk.bold.cyan(`scout agent --issue ${issues[0]?.id || 1}`)}\n` +
-                `  • Custom prompt auto-fix: ${chalk.bold.cyan('scout agent "Fix null check in src/index.ts"')}`, '🔍 Scout Agent Bug Scan');
+                `\n\n${chalk.bold.green(' How to Auto-Fix Any Issue with Agent:')}\n` +
+                ` • Auto-fix Issue #${issues[0]?.id || 1}: ${chalk.bold.cyan(`scout agent --issue ${issues[0]?.id || 1}`)}\n` +
+                ` • Custom prompt auto-fix: ${chalk.bold.cyan('scout agent "Fix null check in src/index.ts"')}`, ' Scout Agent Bug Scan');
             continue;
         }
         // -------------------------------------------------------------
@@ -407,10 +536,10 @@ ${chalk.dim('Type your goal, or use slash commands:')}
         const addIdea = options?.add || options?.plan || (planMatch ? planMatch[1] : undefined);
         if (addIdea && !options?.create) {
             const s = spinner();
-            s.start(`🤖 Scout Agent: Evaluating feasibility & generating roadmap for "${chalk.cyan(addIdea)}"...`);
+            s.start(` Scout Agent: Evaluating feasibility & generating roadmap for "${chalk.cyan(addIdea)}"...`);
             const plan = await generateFeaturePlan(addIdea, projectName, filesList, targetLang, options?.native);
             s.stop('Feasibility assessment & roadmap complete.');
-            safeNote(renderMarkdown(plan), `🚀 Feature Implementation Roadmap: "${addIdea}"`);
+            safeNote(renderMarkdown(plan), ` Feature Implementation Roadmap: "${addIdea}"`);
             continue;
         }
         // -------------------------------------------------------------
@@ -420,20 +549,20 @@ ${chalk.dim('Type your goal, or use slash commands:')}
         const runCmdInput = options?.run || (runMatch ? runMatch[1] : undefined);
         if (runCmdInput) {
             const fullCommand = Array.isArray(runCmdInput) ? runCmdInput.join(' ') : runCmdInput;
-            safeNote(`Running command: ${chalk.bold.cyan(fullCommand)}\n${chalk.dim('Working directory: ' + cwd)}`, '⚡ Scout Shell Execution');
+            safeNote(`Running command: ${chalk.bold.cyan(fullCommand)}\n${chalk.dim('Working directory: ' + cwd)}`, ' Scout Shell Execution');
             const runSpinner = spinner();
             runSpinner.start(`Executing \`${fullCommand}\`...`);
             const res = await executeSmartCommand(fullCommand, cwd, 3000);
             if (res.isBackgroundServer) {
                 runSpinner.stop(chalk.green(`Command \`${fullCommand}\` started in background (PID ${res.pid}).`));
-                safeNote(`${chalk.green('✓')} Background server process started (PID ${res.pid}). Output so far:\n\`\`\`\n${res.output}\n\`\`\``, '✅ Background Execution Active');
+                safeNote(`${chalk.green('')} Background server process started (PID ${res.pid}). Output so far:\n\`\`\`\n${res.output}\n\`\`\``, ' Background Execution Active');
                 continue;
             }
             const exitCode = res.exitCode;
             const fullOutput = res.output;
             if (exitCode === 0) {
                 runSpinner.stop(chalk.green(`Command \`${fullCommand}\` executed successfully (Exit Code 0).`));
-                safeNote(`${chalk.green('✓')} Process completed with exit code 0.`, '✅ Execution Successful');
+                safeNote(`${chalk.green('')} Process completed with exit code 0.`, ' Execution Successful');
                 continue;
             }
             runSpinner.stop(chalk.red(`Command \`${fullCommand}\` failed with exit code ${exitCode}.`));
@@ -442,17 +571,17 @@ ${chalk.dim('Type your goal, or use slash commands:')}
             const analysis = await analyzeCommandError(fullCommand, exitCode, fullOutput, projectName, filesList, targetLang, options?.native);
             diagSpinner.stop(chalk.yellow('Failure diagnosis complete.'));
             const diagMarkdown = `
-### 🔴 Process Failure Diagnosis
+### Process Failure Diagnosis
 Command: \`${fullCommand}\` (Exit Code ${exitCode})
 
-### 🔍 Root Cause Analysis
+### Root Cause Analysis
 ${analysis.rootCause}
 
-### 💡 Suggested Fix
+### Suggested Fix
 ${analysis.suggestedFix}
-${analysis.targetFileToFix ? `\n### 🎯 Suspected File\n\`${analysis.targetFileToFix}\`` : ''}
-      `.trim();
-            safeNote(renderMarkdown(diagMarkdown), '⚠️ Scout AI Failure Diagnosis');
+${analysis.targetFileToFix ? `\n### Suspected File\n\`${analysis.targetFileToFix}\`` : ''}
+ `.trim();
+            safeNote(renderMarkdown(diagMarkdown), '️ Scout AI Failure Diagnosis');
             const shouldFix = await confirm({
                 message: chalk.bold('Would you like Scout Agent to auto-fix the failing code automatically?'),
                 initialValue: true,
@@ -480,7 +609,7 @@ ${analysis.targetFileToFix ? `\n### 🎯 Suspected File\n\`${analysis.targetFile
                     validate: (val) => (!val || !val.trim() ? 'Please provide a prompt describing the file requirements' : undefined),
                 });
                 if (isCancel(userPromptInput)) {
-                    safeNote(chalk.yellow('File creation operation cancelled.'), '✨ Scout File Creation');
+                    safeNote(chalk.yellow('File creation operation cancelled.'), ' Scout File Creation');
                     continue;
                 }
                 finalPrompt = userPromptInput.trim();
@@ -499,7 +628,7 @@ ${analysis.targetFileToFix ? `\n### 🎯 Suspected File\n\`${analysis.targetFile
                 catch { }
             }
             const s = spinner();
-            s.start(`🤖 Scout Agent: Generating ${targetCreateFiles.length} file(s) (${targetCreateFiles.join(', ')})...`);
+            s.start(` Scout Agent: Generating ${targetCreateFiles.length} file(s) (${targetCreateFiles.join(', ')})...`);
             let hasError = false;
             for (const targetFilePath of targetCreateFiles) {
                 const resolvedPath = path.resolve(cwd, targetFilePath);
@@ -523,14 +652,14 @@ ${analysis.targetFileToFix ? `\n### 🎯 Suspected File\n\`${analysis.targetFile
                 catch (err) {
                     hasError = true;
                     s.stop(chalk.red(`Failed to generate code for ${targetFilePath}.`));
-                    safeNote(chalk.red(`Error: ${err?.message || String(err)}`), '⚠️ Code Generation Error');
+                    safeNote(chalk.red(`Error: ${err?.message || String(err)}`), '️ Code Generation Error');
                     break;
                 }
             }
             if (hasError || createdFilesSummary.length === 0) {
                 if (!hasError) {
                     s.stop(chalk.red('Failed to generate code files.'));
-                    safeNote(chalk.yellow(`Scout AI returned empty code content. Please refine your prompt describing what code to write.`), '⚠️ Empty Code Generated');
+                    safeNote(chalk.yellow(`Scout AI returned empty code content. Please refine your prompt describing what code to write.`), '️ Empty Code Generated');
                 }
                 continue;
             }
@@ -550,31 +679,31 @@ ${analysis.targetFileToFix ? `\n### 🎯 Suspected File\n\`${analysis.targetFile
                 native: options?.native,
             });
             if (healRes.verifiedFiles.length > 0) {
-                safeNote(chalk.green(`✓ Automated Verification Confirmed: ${healRes.verifiedFiles.length} file(s) syntax & build verified clean!`), '✅ Code Verification Clean');
+                safeNote(chalk.green(` Automated Verification Confirmed: ${healRes.verifiedFiles.length} file(s) syntax & build verified clean!`), ' Code Verification Clean');
             }
             if (healRes.remainingErrors.length > 0) {
-                safeNote(chalk.yellow(`⚠️ Remaining verification issues:\n${healRes.remainingErrors.join('\n')}`), '⚠️ Verification Warning');
+                safeNote(chalk.yellow(`️ Remaining verification issues:\n${healRes.remainingErrors.join('\n')}`), '️ Verification Warning');
             }
-            const filePreviews = createdFilesSummary.map((f) => `#### 📄 \`${f.path}\`\n${f.description}\n\`\`\`\n${f.code.slice(0, 400)}${f.code.length > 400 ? '\n... (truncated)' : ''}\n\`\`\``).join('\n\n');
+            const filePreviews = createdFilesSummary.map((f) => `#### \`${f.path}\`\n${f.description}\n\`\`\`\n${f.code.slice(0, 400)}${f.code.length > 400 ? '\n... (truncated)' : ''}\n\`\`\``).join('\n\n');
             const teardownContent = `
-### 📄 Created Files (${createdFilesSummary.length})
+### Created Files (${createdFilesSummary.length})
 ${createdFilesSummary.map(f => ` • \`${f.path}\``).join('\n')}
 
-### 💡 Overview & Previews
+### Overview & Previews
 ${filePreviews}
-      `.trim();
-            safeNote(renderMarkdown(teardownContent), '✨ Scout File Creation Teardown');
+ `.trim();
+            safeNote(renderMarkdown(teardownContent), ' Scout File Creation Teardown');
             if (options?.yes || !process.stdout.isTTY) {
-                safeNote(`${chalk.green('✓')} Saved ${chalk.bold.cyan(affectedFiles.length + ' file(s)')} on branch ${chalk.bold.green(currentBranch)}.\n` +
-                    `💡 ${chalk.dim('You can revert this creation anytime by running:')} ${chalk.cyan('scout undo')}`, '✅ Creation Confirmed');
+                safeNote(`${chalk.green('')} Saved ${chalk.bold.cyan(affectedFiles.length + ' file(s)')} on branch ${chalk.bold.green(currentBranch)}.\n` +
+                    ` ${chalk.dim('You can revert this creation anytime by running:')} ${chalk.cyan('scout undo')}`, ' Creation Confirmed');
                 continue;
             }
             const actionChoice = await select({
                 message: chalk.bold('Review Scout Agent\'s generated file(s). What would you like to do?'),
                 options: [
-                    { value: 'keep', label: '✅ Keep Files', hint: `Retain newly created files directly on current branch (${currentBranch})` },
-                    { value: 'pr', label: '🔀 Create Pull Request', hint: 'Push created files to a new branch & open a Pull Request' },
-                    { value: 'revert', label: '↩️ Revert / Delete Files', hint: 'Remove created files immediately' },
+                    { value: 'keep', label: ' Keep Files', hint: `Retain newly created files directly on current branch (${currentBranch})` },
+                    { value: 'pr', label: ' Create Pull Request', hint: 'Push created files to a new branch & open a Pull Request' },
+                    { value: 'revert', label: '️ Revert / Delete Files', hint: 'Remove created files immediately' },
                 ],
             });
             if (isCancel(actionChoice) || actionChoice === 'revert') {
@@ -594,12 +723,12 @@ ${filePreviews}
                     commitMessage: `feat: Create ${affectedFiles.join(', ')}`,
                 });
                 prSpinner.stop('Pull Request workflow processed.');
-                safeNote(`${chalk.green('✓')} ${prRes.message}\n` +
-                    `💡 ${chalk.dim('You remain on active branch:')} ${chalk.cyan(currentBranch)}`, '🔀 Pull Request Status');
+                safeNote(`${chalk.green('')} ${prRes.message}\n` +
+                    ` ${chalk.dim('You remain on active branch:')} ${chalk.cyan(currentBranch)}`, ' Pull Request Status');
                 continue;
             }
-            safeNote(`${chalk.green('✓')} Saved ${chalk.bold.cyan(affectedFiles.length + ' file(s)')} on branch ${chalk.bold.green(currentBranch)}.\n` +
-                `💡 ${chalk.dim('You can revert this creation anytime by running:')} ${chalk.cyan('scout undo')}`, '✅ Creation Confirmed');
+            safeNote(`${chalk.green('')} Saved ${chalk.bold.cyan(affectedFiles.length + ' file(s)')} on branch ${chalk.bold.green(currentBranch)}.\n` +
+                ` ${chalk.dim('You can revert this creation anytime by running:')} ${chalk.cyan('scout undo')}`, ' Creation Confirmed');
             continue;
         }
         // -------------------------------------------------------------
@@ -615,11 +744,11 @@ ${filePreviews}
             }
         }
         if (!finalGoal || !finalGoal.trim()) {
-            safeNote(chalk.yellow('No active goal specified.'), '🤖 Scout Agent');
+            safeNote(chalk.yellow('No active goal specified.'), ' Scout Agent');
             continue;
         }
-        safeNote(`${chalk.bold.cyan('🤖 Scout Autonomous Execution Initialized')}\n` +
-            `${chalk.dim('Goal:')} ${finalGoal}`, '⚡ Scout Agent Execution');
+        safeNote(`${chalk.bold.cyan(' Scout Autonomous Execution Initialized')}\n` +
+            `${chalk.dim('Goal:')} ${finalGoal}`, ' Scout Agent Execution');
         const execResult = await agentLoop.executeGoal(finalGoal);
         const modifiedFiles = agentLoop.getModifiedFiles();
         const backups = agentLoop.getBackups();
@@ -643,29 +772,31 @@ ${filePreviews}
             });
         }
         const teardownMd = `
-### 🎯 Agent Goal
+### Agent Goal
 ${finalGoal}
 
-### 📄 Modified File(s)
+### Modified File(s)
 ${modifiedFiles.map((f) => ` • \`${f}\``).join('\n') || ' • None'}
 
-### 💡 Execution Summary
+### Execution Summary
 ${execResult.summary}
-    `.trim();
-        safeNote(renderMarkdown(teardownMd), '🤖 Scout Agent Teardown Report');
+ `.trim();
+        safeNote(renderMarkdown(teardownMd), ' Scout Agent Teardown Report');
         if (modifiedFiles.length === 0)
             continue;
         if (options?.yes || !process.stdout.isTTY) {
-            safeNote(`${chalk.green('✓')} Agent changes retained on ${modifiedFiles.length} file(s) (Branch: ${chalk.bold.green(currentBranch)}).\n` +
-                `💡 ${chalk.dim('You can revert anytime by running:')} ${chalk.cyan('scout undo')}`, '✅ Agent Execution Confirmed');
+            safeNote(`${chalk.green('')} Agent changes retained on ${modifiedFiles.length} file(s) (Branch: ${chalk.bold.green(currentBranch)}).\n` +
+                ` ${chalk.dim('You can revert anytime by running:')} ${chalk.cyan('scout undo')}`, ' Agent Execution Confirmed');
             continue;
         }
         const actionChoice = await select({
             message: chalk.bold('Review Scout Agent result. What would you like to do?'),
             options: [
-                { value: 'keep', label: '✅ Keep Changes', hint: `Retain agent changes on current branch (${currentBranch})` },
-                { value: 'pr', label: '🔀 Create Pull Request', hint: 'Push fix to a new branch & open a Pull Request' },
-                { value: 'revert', label: '↩️ Revert Changes', hint: 'Restore original code immediately' },
+                { value: 'keep', label: ' Keep Changes', hint: `Retain agent changes on current branch (${currentBranch})` },
+                { value: 'test', label: ' Run Verification Tests', hint: 'Execute test suite to confirm zero regressions' },
+                { value: 'pr', label: ' Create Pull Request', hint: 'Push fix to a new branch & open a Pull Request' },
+                { value: 'export', label: ' Export Session Report', hint: 'Save detailed session teardown report to .ft/' },
+                { value: 'revert', label: '️ Revert Changes', hint: 'Restore original code immediately' },
             ],
         });
         if (actionChoice === 'revert') {
@@ -675,6 +806,47 @@ ${execResult.summary}
             revSpinner.stop('Changes reverted successfully.');
             continue;
         }
+        if (actionChoice === 'test') {
+            const testSpin = spinner();
+            testSpin.start('Running project verification test suite...');
+            const testRes = await runProjectVerification(process.cwd(), options?.verifyCmd);
+            if (testRes.valid) {
+                testSpin.stop(chalk.green('Project verification tests passed cleanly!'));
+                safeNote(`${chalk.green(' Verification Passed:')}\n\`\`\`\n${testRes.output.slice(0, 3000)}\n\`\`\``, ' Test Suite Clean');
+            }
+            else {
+                testSpin.stop(chalk.red('Project verification test suite failed.'));
+                safeNote(`${chalk.red('️ Verification Failed:')}\n${testRes.errors.join('\n')}\n\`\`\`\n${testRes.output.slice(0, 3000)}\n\`\`\``, ' Test Failure Warning');
+            }
+            continue;
+        }
+        if (actionChoice === 'export') {
+            const ftDir = path.join(process.cwd(), '.ft');
+            if (!fs.existsSync(ftDir))
+                fs.mkdirSync(ftDir, { recursive: true });
+            const timeStamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const sessionPath = path.join(ftDir, `session-${timeStamp}.md`);
+            const stats = agentLoop.getStats();
+            const exportContent = `# Scout Agent Session Report
+Date: ${new Date().toLocaleString()}
+Project: ${projectName}
+Goal: ${finalGoal}
+
+## Session Statistics
+- Total Steps: ${stats.totalSteps}
+- Tool Calls: ${stats.totalToolCalls}
+- Modified Files Count: ${modifiedFiles.length}
+
+## Modified Files
+${modifiedFiles.map(f => `- ${f}`).join('\n') || 'None'}
+
+## Execution Summary
+${execResult.summary}
+`;
+            fs.writeFileSync(sessionPath, exportContent, 'utf-8');
+            safeNote(chalk.green(`Session report saved to: ${chalk.bold.cyan(path.relative(process.cwd(), sessionPath))}`), ' Session Exported');
+            continue;
+        }
         if (actionChoice === 'pr') {
             const prSpinner = spinner();
             prSpinner.start('Creating Pull Request...');
@@ -685,12 +857,12 @@ ${execResult.summary}
                 commitMessage: `feat: ${finalGoal}`,
             });
             prSpinner.stop('Pull Request workflow processed.');
-            safeNote(`${chalk.green('✓')} ${prRes.message}\n` +
-                `💡 ${chalk.dim('You remain on active branch:')} ${chalk.cyan(currentBranch)}`, '🔀 Pull Request Status');
+            safeNote(`${chalk.green('')} ${prRes.message}\n` +
+                ` ${chalk.dim('You remain on active branch:')} ${chalk.cyan(currentBranch)}`, ' Pull Request Status');
             continue;
         }
-        safeNote(`${chalk.green('✓')} Agent changes retained on ${modifiedFiles.length} file(s) (Branch: ${chalk.bold.green(currentBranch)}).\n` +
-            `💡 ${chalk.dim('You can revert these changes anytime by running:')} ${chalk.cyan('scout undo')}`, '✅ Agent Workflow Finished');
+        safeNote(`${chalk.green('')} Agent changes retained on ${modifiedFiles.length} file(s) (Branch: ${chalk.bold.green(currentBranch)}).\n` +
+            ` ${chalk.dim('You can revert these changes anytime by running:')} ${chalk.cyan('scout undo')}`, ' Agent Workflow Finished');
     }
 }
 //# sourceMappingURL=agent.js.map