ft-scout 6.0.5 → 6.0.9

package/.firebase/hosting.d2Vi.cache

@@ -1,4 +1,4 @@
 styles.css,1786204910943,fe2eddb0ceda69648e303dd15d177d897a09709b9762c2642a77983e34bbcfe8
 ScoutFavicon.png,1786186569805,41a9ca9abf7acd2976e78c72a72285b49cc0e64b2b5eeb2c2b88c69628fc618a
-app.js,1786198646003,5c06219757fc4b42b489c55ac2b1ce35873c3a12a2b52719bf82ad0b2cf4538f
-index.html,1788543253040,c443266c40c786db17dacd2da3704e230df6f963bdbf8b2e052a566a3e7dca17
+index.html,1788596486237,ec8226afef8a16537189dd912cd5adb786bd62fcd557860366c230a7a48f20b9
+app.js,1788596486243,fd2d07d0c1332e6687680809c62f602842518c61bfb207dac80cdc5718315793

package/README.md

@@ -1,4 +1,4 @@
-# scout (FrontTerrain CLI v6.0.5)
+# scout (FrontTerrain CLI v6.0.9)
 
 **FrontTerrain (`scout`)** — The Autonomous AI Principal Software Engineer & Codebase Co-Pilot in your terminal.
 
@@ -20,38 +20,32 @@ npm install -g ft-scout@latest
 
 Once installed, use `scout` or `ft` in any project directory:
 
-### Agentic AI Actions & Interactive Sessions
+### Autonomous AI Agent & Interactive Sessions
 
 ```bash
-# Autonomous Multi-Step AI Agent (Direct prompt execution, full context inspection, automated test/build verification)
+# Autonomous Multi-Step AI Agent (Direct goal execution, context inspection, automated test/build verification)
 scout agent "Build a responsive snake game in HTML and JS with smooth animations"
-scout agent "Add score high-score persistent storage and level progression"
+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)
 scout agent
+
 # Inside session:
 # Agent Prompt: Add dark mode toggle button
-# Slash commands: /help /diff /clear /compact /undo /scan /plan /history /exit
+# Slash commands: /help /tree /stats /test /explain /export /diff /undo /clear /scan /plan /history /exit
 
 # Generate and create a new source code file
-scout create src/utils/math.ts "Create helper functions for sum, average, and array chunking"
-scout gen src/components/Header.tsx "Create a responsive React navigation header"
-
-# Prompt-Driven Auto-Fix & Debugging
-scout fix "Fix null pointer check in calculateTotal function"
-scout fix -f src/sampleBug.ts "Handle optional prices defensively" -y
-scout fix -i 1
+scout agent --create src/utils/math.ts "Create helper functions for sum, average, and array chunking"
 
 # Run terminal/shell commands with automated AI error diagnosis & self-healing
-scout run npm test
-scout exec tsc
-scout run python main.py
+scout agent --run npm test
+scout agent --run tsc
 
-# Interactive Agentic AI Chat session
-scout chat
-scout chat --web --lang spanish
+# Feasibility roadmap & bug scan
+scout agent --scan
+scout agent --plan "Add rate limiting to API endpoints"
 
 # Revert Scout's last action & restore backed-up file contents
 scout undo
@@ -71,23 +65,17 @@ scout init [repoUrl] -l hi
 scout brief
 
 # Bug & code quality scan report (read-only)
-scout scan
+scout risky
 
-# Feasibility + step-by-step implementation roadmap for a new feature
-scout add "Add rate limiting to API endpoints"
+# Security & dependency / supply-chain audit
+scout audit
 
 # Architecture, performance, and DSA-level suggestions
 scout recommend
 
-# Security & dependency / supply-chain audit
-scout audit
-
 # Show knowledge holders of a specific directory or file (from git history)
 scout owners <path>
 
-# Show a code fragility map based on churn and hotfixes
-scout risky
-
 # Live internet search for live web context & up-to-date documentation
 scout search "Next.js 15 App Router"
 scout web "Tailwind CSS v4" --ask --lang french
@@ -101,17 +89,52 @@ scout upgrade
 
 ---
 
-## Key v6.0.5 Capabilities
-
-- **High-Agency Autonomous ReAct Loop (`scout agent`)**: Takes immediate action using `write_file`, `edit_file`, `run_command`, `read_file`, `grep_search`, and `glob_search` without prompt duplication or double-asking.
-- **Fail-Fast Quota & Concurrency Protection**: Enforces strict single-request concurrency queueing (`LLM_CONCURRENCY=1`) and immediate fail-fast handling on account quota exhaustion (`insufficient_quota`), preventing wasteful retry loops across fallback models.
-- **Interactive `/diff` Slash Command**: Type `/diff` anytime during an interactive `scout agent` session to view colorized, real-time git diffs of uncommitted workspace changes.
-- **Full File Context Inspection**: Loads complete line-numbered reference context (up to 250 lines) into active memory during file auto-discovery for precision editing and bug fixing.
-- **Automated Verification & Self-Healing**: Validates JavaScript, TypeScript, Python, Rust, Go, JSON, and embedded `<script>` HTML tags using compiler checks (`node --check`, `tsc`, `py_compile`, etc.). Automatically diagnoses and self-heals syntax or test errors before concluding.
-- **3-Tier Robust Snippet Editing (`edit_file`)**: Edits files using exact matching, trailing-space normalization, and full line-trim matching (ignoring indentation differences). Automatically falls back to `write_file` if snippet targets mismatch.
-- **AI File Generation (`scout create`)**: Specify a target path and prompt requirement to create production-ready files with automated syntax verification.
-- **Terminal Execution & Failure Diagnosis (`scout run`)**: Run tests, builds, or scripts live. If a command fails, Scout pinpoints the root cause and auto-fixes the failing code.
-- **Safety & Instant Revert (`scout undo`)**: Every code modification or file creation is backed up with timestamped history, enabling 1-command rollback.
+## 🛠️ Scout Autonomous ReAct Tools (14 Tools Available)
+
+| Tool | Description |
+|---|---|
+| `read_file` | Read content & line ranges of workspace files |
+| `write_file` | Create new files or overwrite existing source code |
+| `edit_file` | Search & replace exact target code snippets |
+| `multi_edit_file` | Apply batch snippet replacements in a single atomic tool call |
+| `run_command` | Execute live terminal commands (`npm test`, `tsc`, `pytest`) |
+| `tree_view` | Generate visual ASCII directory tree structures for workspace paths |
+| `file_info` | Get file metadata, exact line counts, size, & modification timestamps |
+| `grep_search` | String/regex pattern search across entire codebase |
+| `glob_search` | Filter workspace files by file glob patterns |
+| `fetch_url` | Fetch web API documentation, specs, or external web URLs |
+| `git_diff` | Query uncommitted workspace git diff directly inside execution loop |
+| `ask_user` | Request missing secret credentials or API keys |
+| `task_completed` | Conclude autonomous goal execution with structured teardown report |
+
+---
+
+## 🚀 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 14 tools and interactive slash commands.
+- `/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.
+- `/explain <file>` — Request a deep architectural breakdown and code explanation of a specific file.
+- `/export` or `/save-session` — Export full session report and action history to `.ft/session-<timestamp>.md`.
+- `/diff` — Display colorized git diff of uncommitted workspace changes.
+- `/clear` or `/compact` — Clear session conversation context window.
+- `/undo` — Instant 1-command revert of file modifications applied by Scout.
+- `/history` — View recent Scout action logs.
+- `/exit` — Quit Scout Agent session gracefully.
+
+---
+
+## 🌟 Overhauled Features & Performance
+
+- **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.
+- **Session Telemetry & Analytics**: Live step counter, tool call counter, and elapsed time estimation during ReAct loop execution.
+- **Automated Verification & Self-Healing**: Validates JS, TS, Python, Rust, Go, JSON, and embedded `<script>` HTML tags. Auto-diagnoses compiler errors and applies self-healing code fixes before finishing.
+- **Post-Execution Review Menu**: Choose from **Keep Changes**, **Run Verification Tests**, **Create Pull Request**, **Export Session Report**, or **Revert Changes** after goal completion.
+- **1-Command Rollback (`scout undo`)**: Every file modification is backed up with timestamped history for zero-risk experimentation.
 
 ---
 

package/bin/ft.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 process.env.CHARSET = 'utf8';
 import('./src/index.js');

package/bin/src/commands/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["agent.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,QAIpD;AAED,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAO/C;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsDlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACvE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACnC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAoF5F;AAED,wBAAgB,yBAAyB,CACxC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,SAAS,EAAE,MAAM,EAAE,GACjB,MAAM,EAAE,CAgGV;AAID,wBAAsB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,iBAonB3E"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["agent.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACvB;AAKD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,QAIpD;AAED,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAO/C;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsDlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACvE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAoF5F;AAED,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,SAAS,EAAE,MAAM,EAAE,GACpB,MAAM,EAAE,CAgGV;AAED,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAkFxF;AAED,wBAAsB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,iBA89B3E"}