ft-scout 6.0.5 → 6.0.8

package/bin/src/discovery/signals.js.map

@@ -1 +1 @@
-{"version":3,"file":"signals.js","sourceRoot":"","sources":["signals.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,cAAc,CAAC,WAAyC;IACvE,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAE5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,+BAA+B;IAC/B,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,MAAM,WAAW,GAAG,WAAW,CAAC,oBAAoB,CAAC;IAErD,IAAI,eAAe,KAAK,CAAC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,GAAG,EAAE,CAAC;QAC9E,MAAM,iBAAiB,GAAG,WAAW,CAAC,iBAAiB,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC;YACb,EAAE,EAAE,oBAAoB;YACxB,OAAO,EAAE,+CAA+C,iBAAiB,4CAA4C;SACpH,CAAC,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,WAAW,CAAC,qBAAqB,EAAE,CAAC;QACxC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,qBAAqB,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC;YACb,EAAE,EAAE,eAAe;YACnB,OAAO,EAAE,wBAAwB,QAAQ,oBAAoB,UAAU,gCAAgC;SACtG,CAAC,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;QACtD,MAAM,eAAe,GAAG,WAAW,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC;YACb,EAAE,EAAE,oBAAoB;YACxB,OAAO,EAAE,4CAA4C,eAAe,+CAA+C;SAClH,CAAC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC"}
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["signals.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,cAAc,CAAC,WAAyC;IACpE,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAE5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,+BAA+B;IAC/B,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,MAAM,WAAW,GAAG,WAAW,CAAC,oBAAoB,CAAC;IAErD,IAAI,eAAe,KAAK,CAAC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,GAAG,EAAE,CAAC;QAC1E,MAAM,iBAAiB,GAAG,WAAW,CAAC,iBAAiB,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,oBAAoB;YACxB,OAAO,EAAE,+CAA+C,iBAAiB,4CAA4C;SACxH,CAAC,CAAC;IACP,CAAC;IAED,0BAA0B;IAC1B,IAAI,WAAW,CAAC,qBAAqB,EAAE,CAAC;QACpC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,qBAAqB,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,eAAe;YACnB,OAAO,EAAE,wBAAwB,QAAQ,oBAAoB,UAAU,gCAAgC;SAC1G,CAAC,CAAC;IACP,CAAC;IAED,+BAA+B;IAC/B,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;QAClD,MAAM,eAAe,GAAG,WAAW,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,oBAAoB;YACxB,OAAO,EAAE,4CAA4C,eAAe,+CAA+C;SACtH,CAAC,CAAC;IACP,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/bin/src/engine/agentEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentEngine.d.ts","sourceRoot":"","sources":["agentEngine.ts"],"names":[],"mappings":"AAMA,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAO7F,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAwG9D;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACF;AAED,eAAO,MAAM,WAAW,EAAE,cAAc,EA2GvC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAChC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAE5B,YAAY,OAAO,CAAC,EAAE,gBAAgB,EAKrC;IAEM,gBAAgB,IAAI,MAAM,EAAE,CAElC;IAEM,UAAU,IAAI,UAAU,EAAE,CAEhC;IAEM,YAAY,IAAI,IAAI,CAI1B;IAED,OAAO,CAAC,YAAY;IA0CP,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAiRzF;IAED,OAAO,CAAC,mBAAmB;YA2Cb,gBAAgB;CAyQ9B"}
+{"version":3,"file":"agentEngine.d.ts","sourceRoot":"","sources":["agentEngine.ts"],"names":[],"mappings":"AAMA,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAO7F,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GACpB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAwG9D;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACL;AAED,eAAO,MAAM,WAAW,EAAE,cAAc,EAgLvC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAK,EAAE,YAAY,SAAI,EAAE,QAAQ,SAAI,GAAG,MAAM,CAyCvG;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,WAAW,CAAa;IAEhC,YAAY,OAAO,CAAC,EAAE,gBAAgB,EAKrC;IAEM,gBAAgB,IAAI,MAAM,EAAE,CAElC;IAEM,UAAU,IAAI,UAAU,EAAE,CAEhC;IAEM,QAAQ,IAAI;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACrB,CAOA;IAEM,YAAY,IAAI,IAAI,CAO1B;IAED,OAAO,CAAC,YAAY;IA6CP,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAgUzF;IAED,OAAO,CAAC,mBAAmB;YA+Cb,gBAAgB;CAuajC"}

package/bin/src/engine/agentEngine.js

@@ -186,6 +186,75 @@ export const AGENT_TOOLS = [
             required: ['pattern'],
         },
     },
+    {
+        name: 'tree_view',
+        description: 'Generate a visual ASCII/Unicode directory tree of a workspace path to visualize folder structures.',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to directory (default "." for workspace root)' },
+                maxDepth: { type: 'number', description: 'Maximum depth limit for tree traversal (default 3)' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'file_info',
+        description: 'Get file statistics including file size, total line count, file extension, and last modification timestamp.',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to the target file' },
+            },
+            required: ['path'],
+        },
+    },
+    {
+        name: 'multi_edit_file',
+        description: 'Apply multiple code snippet replacements across a file in a single step to execute complex refactoring efficiently.',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to the target file' },
+                edits: {
+                    type: 'array',
+                    description: 'Array of target and replacement pairs to apply sequentially',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            target: { type: 'string', description: 'Exact code snippet to replace' },
+                            replacement: { type: 'string', description: 'New code replacement snippet' },
+                        },
+                        required: ['target', 'replacement'],
+                    },
+                },
+                reason: { type: 'string', description: 'Explanation of why these multi-edits are being applied' },
+            },
+            required: ['path', 'edits'],
+        },
+    },
+    {
+        name: 'fetch_url',
+        description: 'Fetch content or documentation from an external HTTP/HTTPS URL for API docs, technical references, or specs.',
+        parameters: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'The absolute HTTP or HTTPS URL to fetch' },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'git_diff',
+        description: 'View current uncommitted git changes across the workspace or for a target file path.',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Optional relative file path filter' },
+            },
+            required: [],
+        },
+    },
     {
         name: 'ask_user',
         description: 'ONLY use for missing API keys or secret credentials. DO NOT use to ask the user what code to write or to re-confirm their prompt—take immediate autonomous tool action instead.',
@@ -209,6 +278,51 @@ export const AGENT_TOOLS = [
         },
     },
 ];
+export function buildDirectoryTree(dirPath, prefix = '', currentDepth = 0, maxDepth = 3) {
+    if (currentDepth >= maxDepth)
+        return `${prefix}└── ... [depth limit reached]\n`;
+    if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory())
+        return '';
+    let result = '';
+    let entries = [];
+    try {
+        entries = fs.readdirSync(dirPath).filter((e) => !['.git', 'node_modules', '.ft', 'dist', 'bin/src/index.js'].includes(e));
+    }
+    catch {
+        return '';
+    }
+    entries.sort((a, b) => {
+        try {
+            const aIsDir = fs.statSync(path.join(dirPath, a)).isDirectory();
+            const bIsDir = fs.statSync(path.join(dirPath, b)).isDirectory();
+            if (aIsDir && !bIsDir)
+                return -1;
+            if (!aIsDir && bIsDir)
+                return 1;
+        }
+        catch { }
+        return a.localeCompare(b);
+    });
+    entries.forEach((entry, idx) => {
+        const isLast = idx === entries.length - 1;
+        const connector = isLast ? '└── ' : '├── ';
+        const childPath = path.join(dirPath, entry);
+        let isDir = false;
+        try {
+            isDir = fs.statSync(childPath).isDirectory();
+        }
+        catch { }
+        if (isDir) {
+            result += `${prefix}${connector}${entry}/\n`;
+            const childPrefix = prefix + (isLast ? '    ' : '│   ');
+            result += buildDirectoryTree(childPath, childPrefix, currentDepth + 1, maxDepth);
+        }
+        else {
+            result += `${prefix}${connector}${entry}\n`;
+        }
+    });
+    return result;
+}
 export class AgentExecutionLoop {
     cwd;
     historyMessages = [];
@@ -217,6 +331,9 @@ export class AgentExecutionLoop {
     autoApprove;
     maxSteps;
     projectName;
+    startTime = Date.now();
+    totalToolCalls = 0;
+    currentStep = 0;
     constructor(options) {
         this.cwd = process.cwd();
         this.autoApprove = Boolean(options?.autoApprove);
@@ -229,10 +346,21 @@ export class AgentExecutionLoop {
     getBackups() {
         return this.backups;
     }
+    getStats() {
+        return {
+            totalSteps: this.currentStep,
+            totalToolCalls: this.totalToolCalls,
+            modifiedFilesCount: this.modifiedFiles.size,
+            elapsedMs: Date.now() - this.startTime,
+        };
+    }
     resetContext() {
         this.historyMessages = [];
         this.modifiedFiles.clear();
         this.backups = [];
+        this.startTime = Date.now();
+        this.totalToolCalls = 0;
+        this.currentStep = 0;
     }
     systemPrompt() {
         const filesList = getDirectoryFiles(this.cwd).slice(0, 100);
@@ -248,23 +376,26 @@ Core Directives & Behavioral Guidelines:
 1. HIGH AGENCY & AUTONOMY: You act autonomously through step-by-step tool invocation to solve complex coding tasks, debug issues, build features, create projects from scratch, or answer architectural questions.
 2. MULTILINGUAL & INTENT COMPREHENSION: Understand user intent in any language (English, Hinglish like "likho", "bnao", "code karo", "fix karo", "samjha do", Hindi, Spanish, etc.).
 3. AUTONOMOUS TARGET FILE DISCOVERY: You have full autonomy to locate, inspect, and modify target workspace files. When given a goal without an explicit file path, use auto-discovered target files, \`grep_search\`, or \`glob_search\` to locate relevant code before editing.
-4. COMPLETE FILE CREATION & EDITING: Whenever asked to write, edit, create, implement, or fix code, YOU MUST CREATE / MODIFY ALL NECESSARY FILES required to completely fulfill the prompt (e.g. main source files, component files, styles, configs, tests, documentation). CALL \`write_file\` or \`edit_file\` for EVERY necessary file to save changes directly to disk in the workspace! Always provide a clear \`reason\` argument for why the edit is made.
-5. RUN & VERIFY COMMANDS: Execute shell commands, tests, builds, and formatters using \`run_command\`. If a command or build fails, read the full error log, diagnose the root cause, and auto-fix the failing code immediately.
-6. NO CODE TRUNCATION OR PLACEHOLDERS: Maintain 100% code integrity. NEVER replace existing code or HTML tags with placeholder comments (e.g. \`<!-- remaining content -->\` or \`// TODO: rest of code\`) or stripped skeleton structures. Always output complete, functional code.
-7. REFORMATTING MINIFIED / LARGE FILES: When asked to format, beautify, or un-minify HTML, JS, CSS, or JSON files, DO NOT attempt to rewrite the file content manually using \`write_file\` or \`edit_file\` (which causes token truncation and content loss). ALWAYS use \`run_command\` to execute CLI formatters (e.g. \`npx prettier --write <file>\`, \`npx html-beautify -r <file>\`, \`npx js-beautify <file>\`, or run a quick Node script) to reformat files in-place on disk.
-8. FROM-SCRATCH PROJECT CREATION & AUTOMATED TESTING PROTOCOL: When asked to build/create a project from scratch:
+4. ACTION-FIRST & DIRECT EXECUTION PRIORITY: When given a goal to fix, edit, modify, or create files, TAKE CODE MODIFICATION ACTIONS (\`write_file\`, \`edit_file\`, or \`run_command\`) IMMEDIATELY within the first 1-3 steps! DO NOT waste multiple steps reading unrelated asset files, sound generators, raw text files, init files, or requirements files unless specifically requested by the user.
+5. PRE-LOADED CONTEXT RULE: If target files or auto-discovered files are already previewed in your context window history, DO NOT call \`read_file\` or \`list_dir\` on them again! Proceed directly to writing/editing code.
+6. COMPLETE FILE CREATION & EDITING: Whenever asked to write, edit, create, implement, or fix code, YOU MUST CREATE / MODIFY ALL NECESSARY FILES required to completely fulfill the prompt (e.g. main source files, component files, styles, configs, tests, documentation). CALL \`write_file\` or \`edit_file\` for EVERY necessary file to save changes directly to disk in the workspace! Always provide a clear \`reason\` argument for why the edit is made.
+7. RUN & VERIFY COMMANDS: Execute shell commands, tests, builds, and formatters using \`run_command\`. If a command or build fails, read the full error log, diagnose the root cause, and auto-fix the failing code immediately.
+8. NO CODE TRUNCATION OR PLACEHOLDERS: Maintain 100% code integrity. NEVER replace existing code or HTML tags with placeholder comments (e.g. \`<!-- remaining content -->\` or \`// TODO: rest of code\`) or stripped skeleton structures. Always output complete, functional code.
+9. REFORMATTING MINIFIED / LARGE FILES: When asked to format, beautify, or un-minify HTML, JS, CSS, or JSON files, DO NOT attempt to rewrite the file content manually using \`write_file\` or \`edit_file\` (which causes token truncation and content loss). ALWAYS use \`run_command\` to execute CLI formatters (e.g. \`npx prettier --write <file>\`, \`npx html-beautify -r <file>\`, \`npx js-beautify <file>\`, or run a quick Node script) to reformat files in-place on disk.
+10. FROM-SCRATCH PROJECT CREATION & AUTOMATED TESTING PROTOCOL: When asked to build/create a project from scratch:
  a. Scaffold Architecture: Create configuration/manifest files (\`package.json\`, \`tsconfig.json\`, \`pyproject.toml\`, etc.) and folder structure using \`write_file\` or \`run_command\`.
  b. Write Source Implementation: Create all necessary source files with fully functional, complete, production-ready code (no skeleton placeholders or TODOs).
  c. Write Automated Tests: Create comprehensive unit/integration test suite files (e.g. \`test/*.test.ts\`, \`tests/test_*.py\`, etc.).
  d. Execute Tests & Build Verification: Run test suites and builds via \`run_command\` (e.g. \`npm test\`, \`npx vitest run\`, \`pytest\`, \`cargo test\`, \`go test ./...\`).
  e. Self-Heal & Pass: If tests or builds fail, inspect output logs, edit files using \`edit_file\` or \`write_file\` to resolve errors, re-run tests until 100% passing, and only call \`task_completed\` when all checks pass cleanly.
-9. CRITICAL TERMINATION RULE: As soon as you have finished creating/modifying the necessary files, running verification checks, or answering the user request, YOU MUST CALL \`task_completed\` tool immediately with a clear summary of your work.
-10. PRODUCTION-GRADE CODE QUALITY: Every line of code you write or edit MUST be clean, elegant, modular, production-ready, highly readable, self-documenting, formatted, and strictly typed.
-11. HIGH AUTONOMY & NO DOUBLE PROMPTING: NEVER call \`ask_user\` to ask what code to write, what features to implement, or to re-confirm the prompt. Take immediate autonomous action using \`write_file\`, \`edit_file\`, \`run_command\`, \`read_file\`, or \`grep_search\` using best software engineering practices. ONLY call \`ask_user\` if a critical secret credential (API key/password) is strictly required.
-12. EDITING & DEBUGGING MASTERY PROTOCOL:
+11. CRITICAL TERMINATION RULE: As soon as you have finished creating/modifying the necessary files, running verification checks, or answering the user request, YOU MUST CALL \`task_completed\` tool immediately with a clear summary of your work.
+12. PRODUCTION-GRADE CODE QUALITY: Every line of code you write or edit MUST be clean, elegant, modular, production-ready, highly readable, self-documenting, formatted, and strictly typed.
+13. HIGH AUTONOMY & NO DOUBLE PROMPTING: NEVER call \`ask_user\` to ask what code to write, what features to implement, or to re-confirm the prompt. Take immediate autonomous action using \`write_file\`, \`edit_file\`, \`run_command\`, \`read_file\`, or \`grep_search\` using best software engineering practices. ONLY call \`ask_user\` if a critical secret credential (API key/password) is strictly required.
+14. EDITING & DEBUGGING MASTERY PROTOCOL:
  a. Full Context Reading: When editing or fixing bugs in existing files, inspect full code context. For files under 250 lines, reference the complete file content before modifying.
  b. Guaranteed Edit Success: Use \`edit_file\` for precise snippet updates. If \`edit_file\` returns a target snippet mismatch error, IMMEDIATELY call \`write_file\` with the complete corrected file code so the edit is 100% applied without getting stuck!
  c. Automated Error Diagnostics: After editing, check compiler/syntax outputs and test runner logs. If an error is detected, auto-heal the code immediately before concluding.
+15. THOUGHT TRANSPARENCY PROTOCOL: In EVERY step before calling any tools or ending a turn, you MUST provide a clear 1-2 sentence explanation in your text response describing your current reasoning, what file/action you are taking, and why you are taking it.
 
 When returning tool calls, use standard OpenAI function calling format or JSON tool call payload format:
 \`\`\`json
@@ -278,33 +409,61 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
     async executeGoal(userGoal) {
         this.resetContext();
         this.historyMessages.push({ role: 'system', content: this.systemPrompt() });
-        // Autonomous Target File Discovery: Find relevant workspace files matching terms in userGoal
+        // Robust Target File Discovery: Extract file paths/names directly from userGoal without destroying backslashes
         const filesList = getDirectoryFiles(this.cwd);
-        const stopWords = new Set([
-            'the', 'a', 'an', 'in', 'is', 'for', 'to', 'of', 'and', 'or', 'on', 'at', 'by', 'from',
-            'with', 'this', 'that', 'it', 'code', 'file', 'files', 'fix', 'add', 'make', 'create',
-            'update', 'change', 'modify', 'edit', 'write', 'implement', 'bro', 'please', 'scout',
-            'agent', 'bug', 'error', 'issue', 'help', 'app', 'project', 'script', 'function',
-            'folder', 'dir', 'directory', 'testing', 'inside', 'open', 'vs', 'vscode', 'py', 'python',
-            'new', 'build', 'run', 'test', 'suite'
-        ]);
-        const words = userGoal.split(/[\s,;:\/\\]+/).map((w) => w.replace(/["'(),;:!]/g, '').trim());
         const matchedFiles = [];
-        // 1. Check direct path or filename matches
-        for (const word of words) {
-            if (word && word.includes('.') && !word.startsWith('.')) {
-                const fullP = path.resolve(this.cwd, word);
-                if (fs.existsSync(fullP) && fs.statSync(fullP).isFile()) {
-                    const relP = path.relative(this.cwd, fullP).replace(/\\/g, '/');
-                    if (!matchedFiles.includes(relP))
-                        matchedFiles.push(relP);
+        const isIgnoredFile = (filePath) => {
+            const norm = filePath.replace(/\\/g, '/').toLowerCase();
+            const ext = path.extname(norm);
+            const ignoredExts = ['.pyc', '.pyo', '.png', '.jpg', '.jpeg', '.gif', '.ico', '.exe', '.bin', '.dll', '.so', '.dylib', '.zip', '.tar', '.gz'];
+            return (norm.includes('__pycache__/') ||
+                norm.includes('.git/') ||
+                norm.includes('node_modules/') ||
+                norm.includes('.ft/') ||
+                ignoredExts.includes(ext));
+        };
+        // Match potential paths (e.g. C:\path\to\file.py, pacman_game/game_map.py, game_map.py)
+        const pathMatches = userGoal.match(/(?:[a-zA-Z]:[\\/][^\s"':;,]+|\.?[\\/][^\s"':;,]+\.[a-zA-Z0-9]+|[a-zA-Z0-9_\-./\\]+\.[a-zA-Z0-9]+)/g) || [];
+        for (const rawPath of pathMatches) {
+            const cleanP = rawPath.replace(/^["'()]+|["'()]+$/g, '').trim();
+            if (!cleanP || cleanP.length < 3)
+                continue;
+            const fullP = path.isAbsolute(cleanP) ? cleanP : path.resolve(this.cwd, cleanP);
+            if (fs.existsSync(fullP) && fs.statSync(fullP).isFile()) {
+                const relP = path.relative(this.cwd, fullP).replace(/\\/g, '/');
+                if (!isIgnoredFile(relP) && !matchedFiles.includes(relP))
+                    matchedFiles.push(relP);
+            }
+            else {
+                // Check if any file in filesList matches or ends with the extracted relative path or filename
+                const normToken = cleanP.replace(/\\/g, '/').toLowerCase();
+                const baseName = path.basename(normToken);
+                for (const f of filesList) {
+                    if (isIgnoredFile(f))
+                        continue;
+                    const normF = f.replace(/\\/g, '/').toLowerCase();
+                    if (normF === normToken || normF.endsWith('/' + normToken) || (baseName.includes('.') && normF.endsWith('/' + baseName))) {
+                        if (!matchedFiles.includes(f))
+                            matchedFiles.push(f);
+                    }
                 }
             }
         }
-        // 2. If no direct path matched, search workspace file names for high-confidence keyword matches
+        // Keyword fallback if no direct path matched
         if (matchedFiles.length === 0) {
+            const stopWords = new Set([
+                'the', 'a', 'an', 'in', 'is', 'for', 'to', 'of', 'and', 'or', 'on', 'at', 'by', 'from',
+                'with', 'this', 'that', 'it', 'code', 'file', 'files', 'fix', 'add', 'make', 'create',
+                'update', 'change', 'modify', 'edit', 'write', 'implement', 'bro', 'please', 'scout',
+                'agent', 'bug', 'error', 'issue', 'help', 'app', 'project', 'script', 'function',
+                'folder', 'dir', 'directory', 'testing', 'inside', 'open', 'vs', 'vscode', 'py', 'python',
+                'new', 'build', 'run', 'test', 'suite'
+            ]);
+            const words = userGoal.split(/[\s,;:\/\\]+/).map((w) => w.replace(/["'(),;:!]/g, '').trim());
             const keywords = words.filter((w) => w.length >= 3 && !stopWords.has(w.toLowerCase()));
             for (const f of filesList) {
+                if (isIgnoredFile(f))
+                    continue;
                 if (matchedFiles.length >= 3)
                     break;
                 const normF = f.replace(/\\/g, '/').toLowerCase();
@@ -334,7 +493,7 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
                         : lines.slice(0, 100).map((l, i) => `${i + 1} | ${l}`).join('\n') + `\n... [truncated, file has ${lines.length} lines. Call read_file to view remaining lines]`;
                     this.historyMessages.push({
                         role: 'user',
-                        content: `[Reference Workspace Context - Auto-discovered file "${file}" (${lines.length} lines)]:\n\`\`\`\n${previewSnippet}\n\`\`\`\nNote: Use this complete file content as reference context for editing, debugging, or fulfilling the user goal.`,
+                        content: `[Reference Workspace Context - Pre-loaded target file "${file}" (${lines.length} lines)]:\n\`\`\`\n${previewSnippet}\n\`\`\`\nCRITICAL DIRECTIVE: The target file "${file}" is ALREADY fully pre-loaded into your reference context above. DO NOT call read_file or list_dir for this file again! Immediately begin calling write_file, edit_file, or run_command to satisfy the user goal.`,
                     });
                 }
                 catch {
@@ -353,9 +512,11 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
         console.log(chalk.gray(`Estimated completion time: ${estTimeText} (Max ${this.maxSteps} steps)`));
         let step = 0;
         let finalSummary = '';
+        let consecutiveReads = 0;
         const stepDurations = [];
         while (step < this.maxSteps) {
             step++;
+            this.currentStep = step;
             const stepStartTime = Date.now();
             const avgStepMs = stepDurations.length > 0
                 ? stepDurations.reduce((a, b) => a + b, 0) / stepDurations.length
@@ -400,6 +561,11 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
                 }
                 const msg = sanitizeMessage(choice.message);
                 this.historyMessages.push(msg);
+                // Render assistant's thought/reasoning text if provided on this turn
+                const textContent = msg.content || '';
+                if (textContent.trim()) {
+                    safeNote(renderMarkdown(textContent), `Scout Thought (Step ${step})`);
+                }
                 // Check native tool calls
                 if (msg.tool_calls && msg.tool_calls.length > 0) {
                     stepSpinner.stop(chalk.green(`Step ${step}: Scout issued ${msg.tool_calls.length} tool call(s).`));
@@ -417,6 +583,18 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
                                 tool_call_id: tc.id,
                                 content: `Tool Execution Result (${fnName}):\n${toolResult.result}`,
                             });
+                            if (fnName === 'read_file' || fnName === 'list_dir' || fnName === 'glob_search' || fnName === 'grep_search') {
+                                consecutiveReads++;
+                                if (consecutiveReads >= 2) {
+                                    this.historyMessages.push({
+                                        role: 'user',
+                                        content: 'SYSTEM ACTION NUDGE: You have issued multiple read/exploration tool calls in a row. Stop reading files now and execute write_file, edit_file, or run_command immediately to satisfy the user goal.',
+                                    });
+                                }
+                            }
+                            else if (fnName === 'write_file' || fnName === 'edit_file' || fnName === 'run_command') {
+                                consecutiveReads = 0;
+                            }
                             if (fnName === 'task_completed') {
                                 finalSummary = args.summary || toolResult.result;
                                 if (this.modifiedFiles.size > 0) {
@@ -436,7 +614,6 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
                     continue;
                 }
                 // Check text response or fallback JSON tool call
-                const textContent = msg.content || '';
                 stepSpinner.stop(chalk.blue(`Step ${step} thinking complete.`));
                 const parsedJsonTool = this.extractJsonToolCall(textContent);
                 if (parsedJsonTool) {
@@ -521,7 +698,11 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
             }
             return { tool, args };
         }
-        const knownTools = ['read_file', 'write_file', 'edit_file', 'run_command', 'list_dir', 'grep_search', 'glob_search', 'ask_user', 'task_completed'];
+        const knownTools = [
+            'read_file', 'write_file', 'edit_file', 'run_command', 'list_dir',
+            'grep_search', 'glob_search', 'tree_view', 'file_info', 'multi_edit_file',
+            'fetch_url', 'git_diff', 'ask_user', 'task_completed'
+        ];
         for (const toolName of knownTools) {
             const tagRegex = new RegExp(`<${toolName}>([\\s\\S]*?)<\\/${toolName}>`, 'i');
             const match = content.match(tagRegex);
@@ -550,8 +731,37 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
         return null;
     }
     async dispatchToolCall(name, args) {
-        const badge = chalk.bgCyan.black.bold(` ️ TOOL: ${name} `);
-        console.log(`\n${badge} ${chalk.dim(JSON.stringify(args))}`);
+        this.totalToolCalls++;
+        let actionDesc = '';
+        if (name === 'read_file')
+            actionDesc = `Reading file: ${args.path || ''}`;
+        else if (name === 'write_file')
+            actionDesc = `Writing/Creating file: ${args.path || ''}`;
+        else if (name === 'edit_file')
+            actionDesc = `Editing file: ${args.path || ''}`;
+        else if (name === 'multi_edit_file')
+            actionDesc = `Multi-editing file: ${args.path || ''}`;
+        else if (name === 'run_command')
+            actionDesc = `Executing command: ${args.command || args.cmd || ''}`;
+        else if (name === 'list_dir')
+            actionDesc = `Listing directory: ${args.path || '.'}`;
+        else if (name === 'tree_view')
+            actionDesc = `Generating directory tree: ${args.path || '.'}`;
+        else if (name === 'file_info')
+            actionDesc = `Inspecting file stats: ${args.path || ''}`;
+        else if (name === 'grep_search')
+            actionDesc = `Searching pattern: "${args.query || args.pattern || ''}"`;
+        else if (name === 'glob_search')
+            actionDesc = `Finding files: "${args.pattern || ''}"`;
+        else if (name === 'fetch_url')
+            actionDesc = `Fetching URL: ${args.url || ''}`;
+        else if (name === 'git_diff')
+            actionDesc = `Retrieving workspace git diff`;
+        else if (name === 'task_completed')
+            actionDesc = `Task finished`;
+        const badge = chalk.bgCyan.black.bold(` 🛠️ TOOL: ${name} `);
+        const descText = actionDesc ? chalk.yellow.bold(` → ${actionDesc}`) : '';
+        console.log(`\n${badge}${descText} ${chalk.dim(JSON.stringify(args))}`);
         switch (name) {
             case 'read_file': {
                 const targetPath = String(args.path || '').trim();
@@ -748,6 +958,132 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
                 const matched = allFiles.filter((f) => f.toLowerCase().includes(pattern) || path.basename(f).toLowerCase().endsWith(pattern.replace('*', '')));
                 return { result: `Glob search "${pattern}" matched ${matched.length} file(s):\n${matched.slice(0, 30).join('\n')}` };
             }
+            case 'tree_view': {
+                const relPath = String(args.path || '.').trim();
+                const maxDepth = Number(args.maxDepth) || 3;
+                const fullDir = path.resolve(this.cwd, relPath);
+                if (!fs.existsSync(fullDir) || !fs.statSync(fullDir).isDirectory()) {
+                    return { result: `Directory not found for tree_view: "${relPath}"` };
+                }
+                const treeStr = buildDirectoryTree(fullDir, '', 0, maxDepth);
+                return { result: `Directory Tree for "${relPath}":\n${relPath}/\n${treeStr}` };
+            }
+            case 'file_info': {
+                const targetPath = String(args.path || '').trim();
+                const fullPath = path.isAbsolute(targetPath) ? targetPath : path.resolve(this.cwd, targetPath);
+                if (!fs.existsSync(fullPath)) {
+                    return { result: `Error: Path "${targetPath}" does not exist.` };
+                }
+                const stat = fs.statSync(fullPath);
+                if (stat.isDirectory()) {
+                    const entries = fs.readdirSync(fullPath);
+                    return { result: `Directory Stats: "${targetPath}"\n • Total Entries: ${entries.length}\n • Created: ${stat.birthtime.toISOString()}\n • Modified: ${stat.mtime.toISOString()}` };
+                }
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                const lineCount = content.split('\n').length;
+                const ext = path.extname(targetPath) || 'none';
+                return {
+                    result: `File Info: "${targetPath}"\n` +
+                        ` • Size: ${(stat.size / 1024).toFixed(2)} KB (${stat.size} bytes)\n` +
+                        ` • Total Lines: ${lineCount}\n` +
+                        ` • Extension: ${ext}\n` +
+                        ` • Last Modified: ${stat.mtime.toISOString()}\n` +
+                        ` • Absolute Path: ${fullPath}`
+                };
+            }
+            case 'multi_edit_file': {
+                const targetPath = String(args.path || '').trim();
+                const edits = Array.isArray(args.edits) ? args.edits : [];
+                const reason = String(args.reason || args.description || 'Applied multiple code snippet edits.');
+                if (edits.length === 0) {
+                    return { result: `Error: No edits provided for multi_edit_file on "${targetPath}".` };
+                }
+                const fullPath = path.isAbsolute(targetPath) ? targetPath : path.resolve(this.cwd, targetPath);
+                if (!fs.existsSync(fullPath)) {
+                    return { result: `Error: File "${targetPath}" does not exist.` };
+                }
+                let currentContent = fs.readFileSync(fullPath, 'utf-8');
+                const origContent = currentContent;
+                let appliedCount = 0;
+                const errors = [];
+                for (let i = 0; i < edits.length; i++) {
+                    const ed = edits[i];
+                    let target = String(ed.target || '');
+                    let replacement = String(ed.replacement || '');
+                    if (target.includes('\\n') && !target.includes('\n'))
+                        target = target.replace(/\\n/g, '\n').replace(/\\t/g, '\t');
+                    if (replacement.includes('\\n') && !replacement.includes('\n'))
+                        replacement = replacement.replace(/\\n/g, '\n').replace(/\\t/g, '\t');
+                    const replaceRes = robustSnippetReplace(currentContent, target, replacement);
+                    if (replaceRes.success) {
+                        currentContent = replaceRes.updatedContent;
+                        appliedCount++;
+                    }
+                    else {
+                        errors.push(`Edit #${i + 1} failed: ${replaceRes.error}`);
+                    }
+                }
+                if (appliedCount === 0) {
+                    return { result: `Error: All ${edits.length} multi-edits failed on "${targetPath}":\n${errors.join('\n')}` };
+                }
+                this.backups.push({ filePath: targetPath, originalContent: origContent });
+                fs.writeFileSync(fullPath, currentContent, 'utf-8');
+                this.modifiedFiles.add(targetPath);
+                safeNote(` • File: ${chalk.bold.cyan(targetPath)}\n` +
+                    ` • Multi-edits applied: ${chalk.bold.green(appliedCount + '/' + edits.length)}\n` +
+                    ` • Why: ${reason}`, ` Applied ${appliedCount} edits to ${targetPath}`);
+                const syntaxCheck = await checkFileSyntax(targetPath, this.cwd);
+                let syntaxNotice = syntaxCheck.valid ? 'Syntax check passed cleanly.' : `\n\n️ AUTOMATED SYNTAX ERROR DETECTED:\n${syntaxCheck.errors.join('\n')}`;
+                return {
+                    result: `Successfully applied ${appliedCount}/${edits.length} edit snippet(s) to "${targetPath}". Rationale: ${reason}.${errors.length > 0 ? ` Warnings: ${errors.join('; ')}` : ''} ${syntaxNotice}`
+                };
+            }
+            case 'fetch_url': {
+                const targetUrl = String(args.url || '').trim();
+                if (!targetUrl.startsWith('http://') && !targetUrl.startsWith('https://')) {
+                    return { result: `Error: Invalid URL scheme. URL must start with http:// or https://` };
+                }
+                const fetchSpin = spinner();
+                fetchSpin.start(chalk.cyan(` Fetching web URL ${targetUrl}...`));
+                try {
+                    const resp = await fetch(targetUrl, { headers: { 'User-Agent': 'Scout-CLI-Agent/6.0' } });
+                    if (!resp.ok) {
+                        fetchSpin.stop(chalk.red(`Failed to fetch URL: HTTP ${resp.status} ${resp.statusText}`));
+                        return { result: `HTTP Error ${resp.status}: ${resp.statusText}` };
+                    }
+                    let bodyText = await resp.text();
+                    fetchSpin.stop(chalk.green(` Fetched URL ${targetUrl} (${bodyText.length} chars)`));
+                    if (bodyText.includes('<html') || bodyText.includes('<body')) {
+                        bodyText = bodyText
+                            .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+                            .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+                            .replace(/<[^>]+>/g, ' ')
+                            .replace(/\s+/g, ' ')
+                            .trim();
+                    }
+                    const preview = bodyText.slice(0, 6000) + (bodyText.length > 6000 ? `\n... [truncated, ${bodyText.length} total chars]` : '');
+                    return { result: `Content fetched from ${targetUrl}:\n\n${preview}` };
+                }
+                catch (err) {
+                    fetchSpin.stop(chalk.red(`Fetch error for ${targetUrl}: ${err?.message || String(err)}`));
+                    return { result: `Fetch error: ${err?.message || String(err)}` };
+                }
+            }
+            case 'git_diff': {
+                const targetPath = args.path ? String(args.path).trim() : '';
+                try {
+                    const { execSync } = await import('child_process');
+                    const diffCmd = targetPath ? `git diff -- "${targetPath}"` : 'git diff';
+                    const diffOutput = execSync(diffCmd, { encoding: 'utf-8', cwd: this.cwd });
+                    if (!diffOutput || !diffOutput.trim()) {
+                        return { result: 'No uncommitted git changes found in workspace.' };
+                    }
+                    return { result: `Git Diff Output:\n${diffOutput.slice(0, 8000)}` };
+                }
+                catch (err) {
+                    return { result: `Could not retrieve git diff: ${err?.message || String(err)}` };
+                }
+            }
             case 'ask_user': {
                 const questionText = String(args.question || args.prompt || 'Please provide input:').trim();
                 const askSpin = spinner();