ft-scout 7.0.9 → 8.0.0

package/README.md

@@ -1,4 +1,4 @@
-# scout (FrontTerrain CLI v7.0.9)
+# scout (FrontTerrain CLI v8.0.0)
 
 **FrontTerrain (`scout`)** — The Autonomous AI Principal Software Engineer & Codebase Co-Pilot in your terminal.
 
@@ -29,12 +29,17 @@ scout agent "Add persistent score tracking and level progression"
 scout task "Fix typescript build errors in src/utils" -v "npm run build"
 scout goal "Refactor database query logic" -y
 
-# Interactive Scout Agent Session (Persistent chat loop with Slash Commands & full ReAct tool execution)
+### Interactive Scout Agent Session (Persistent chat loop with Slash Commands & full ReAct tool execution)
 scout agent
 
+# Select Interaction Mode: 💬 Text Interaction OR 🎙️ Audio Interaction (Voice STT + TTS)
+# Force Voice Mode directly via CLI flag:
+scout agent -V
+scout agent --voice
+
 # Inside session:
 # Agent Prompt: Add dark mode toggle button
-# Slash commands: /help /tree /stats /test /explain /export /diff /undo /clear /scan /plan /history /exit
+# Slash commands: /help /scratchpad /voice /speak /tree /stats /test /explain /export /diff /undo /clear /scan /plan /history /exit
 
 # Generate and create a new source code file
 scout agent --create src/utils/math.ts "Create helper functions for sum, average, and array chunking"
@@ -89,7 +94,7 @@ scout upgrade
 
 ---
 
-## Scout Autonomous ReAct Tools (16 Tools Available)
+## Scout Autonomous ReAct Tools (18 Tools Available)
 
 | Tool | Description |
 |---|---|
@@ -108,15 +113,28 @@ scout upgrade
 | `ask_user` | Request missing secret credentials or API keys |
 | `open_app` | Launch or focus external applications (browser, terminal, editor, etc.) |
 | `app_action` | Perform interactive actions & navigation inside opened app contexts |
+| `agent_scratchpad` | Update, read, or clear agent working memory, step checklist, & notes (`.ft/scratchpad.md`) |
+| `speak_text` | Read text phrases out loud using Text-to-Speech (TTS) voice synthesis |
 | `task_completed` | Conclude autonomous goal execution with structured teardown report |
 
 ---
 
+## Dual Interaction Modes (Text vs Audio)
+
+When starting interactive sessions in `scout agent`, `scout init` (ask mode), or `scout search`, Scout presents a **2-Option Interaction Selector**:
+1. **Text Interaction**: Standard prompt input -> Text response in terminal.
+2. **Audio Interaction**: Voice command input via microphone Speech-to-Text (STT) -> Text response + Audio response spoken out loud via Text-to-Speech (TTS).
+
+---
+
 ## Interactive Slash Commands in Session
 
 Inside an active `scout agent` interactive session, type any slash command to trigger agent actions:
 
-- `/help` — Display comprehensive guide to all 16 tools and interactive slash commands.
+- `/help` — Display comprehensive guide to all 18 tools and interactive slash commands.
+- `/scratchpad` — View active working memory plan & step checklist (`.ft/scratchpad.md`).
+- `/voice` — Activate microphone Speech-to-Text (STT) listener to speak your prompt into CLI.
+- `/speak <text>` — Read entered text out loud via Text-to-Speech (TTS) voice synthesis.
 - `/tree [dir]` — Render an interactive visual directory tree of any workspace folder.
 - `/status` or `/stats` — View real-time session telemetry (steps executed, tool call count, modified files, elapsed time, branch info).
 - `/test [cmd]` — Auto-detect and run project verification test suite directly inside session context.
@@ -132,6 +150,8 @@ Inside an active `scout agent` interactive session, type any slash command to tr
 
 ## Overhauled Features & Performance
 
+- **Working Memory Scratchpad (`.ft/scratchpad.md`)**: Maintains working memory notes, step-by-step checklists, and plan state across execution loops.
+- **Native STT & TTS Voice Engine**: Micro-browser Web Speech API STT and OS native speech synthesis (PowerShell System.Speech on Windows, `say` on Mac) with zero extra API keys required.
 - **High-Agency Multi-File Scaffolding**: Automatically creates, implements, tests, and verifies multi-file codebases from scratch.
 - **Atomic Multi-Snippet Editing (`multi_edit_file`)**: Executes multiple code replacements in a single turn for complex multi-point refactoring.
 - **App Control & Desktop Automation (`open_app`, `app_action`)**: Seamlessly launch, navigate, and automate external apps, web browsers, terminals, and code editors.

package/bin/src/index.js

@@ -32,13 +32,13 @@ program
     .name('scout')
     .alias('ft')
     .description('FrontTerrain — The Onboarding Co-Pilot for New Codebases')
-    .version('7.0.9');
+    .version('8.0.0');
 // Header UI on execution with FrontTerrain proprietary logo & version auto-checker
 program.hook('preAction', async (_thisCommand, actionCommand) => {
-    intro(renderBranding('7.0.9'));
+    intro(renderBranding('8.0.0'));
     const cmdName = actionCommand ? actionCommand.name() : '';
     if (cmdName !== 'upgrade') {
-        await checkForUpdates('7.0.9');
+        await checkForUpdates('8.0.0');
     }
     // Auth Guard: enforce authentication for all commands except login, signup, upgrade, help, dashboard, auth, status
     const EXEMPT_COMMANDS = ['login', 'signin', 'signup', 'register', 'upgrade', 'help', 'dashboard', 'web-ui', 'gui', 'auth', 'status', 'quota', 'usage', 'credits'];
@@ -233,7 +233,7 @@ program
     .command('upgrade')
     .description('Check for updates and auto-upgrade Scout to the latest version')
     .action(async () => {
-    await checkForUpdates('7.0.9', true);
+    await checkForUpdates('8.0.0', true);
     outro(chalk.cyan('Upgrade check complete.'));
 });
 program

package/bin/src/utils/branding.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-export function renderBranding(version = '7.0.9') {
+export function renderBranding(version = '8.0.0') {
     const logo = chalk.cyan.bold(' ███████╗████████╗') + '   ' + chalk.cyan.bold('███████╗  ██████╗ ██████╗  ██╗  ██╗████████╗') + '\n' +
         chalk.cyan.bold(' ██╔════╝╚══██╔══╝') + '   ' + chalk.cyan.bold('██╔════╝ ██╔════╝██╔═══██╗ ██║  ██║╚══██╔══╝') + '\n' +
         chalk.cyan.bold(' █████╗     ██║ ') + '   ' + chalk.cyan.bold('  ███████╗ ██║     ██║   ██║ ██║  ██║   ██║ ') + '\n' +

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ft-scout",
-    "version": "7.0.9",
+    "version": "8.0.0",
     "type": "module",
     "description": "FrontTerrain — The Onboarding Co-Pilot for New Codebases",
     "main": "index.js",

package/web/app.js

@@ -1,5 +1,5 @@
 /* ==========================================================================
-   FrontTerrain Scout — Multi-Page Application Engine v7.0.9
+   FrontTerrain Scout — Multi-Page Application Engine v8.0.0
    ========================================================================== */
 
 const FIREBASE_CONFIG = {
@@ -452,7 +452,7 @@ function initTerminalSimulator() {
 `;
         } else if (lower.includes('status')) {
             response.innerHTML = `
-<span class="term-green">✔ Scout CLI Engine: v7.0.9 Online</span><br>
+<span class="term-green">✔ Scout CLI Engine: v8.0.0 Online</span><br>
 ↳ User: <strong>${escapeHtml(state.user ? state.user.name : 'Guest Session')}</strong><br>
 ↳ Active Subscription: <strong>${escapeHtml(TIER_DETAILS[state.currentTier].name)}</strong><br>
 ↳ Credit Quota: <strong>${state.byokEnabled ? 'BYOK Mode (Unlimited)' : `${state.creditsUsed} / ${state.creditsTotal} Credits Used`}</strong><br>

package/web/styles.css

@@ -1,5 +1,5 @@
 /* ==========================================================================
-   FrontTerrain Scout — Design System & Visual Engine v7.0.9
+   FrontTerrain Scout — Design System & Visual Engine v8.0.0
    Inspired by HappyRobot, Linear.app & Vercel aesthetics
    ========================================================================== */