ft-scout 3.0.9 → 4.0.1

package/bin/src/engine/verifier.js

@@ -0,0 +1,275 @@
+import fs from 'fs';
+import path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import chalk from 'chalk';
+import { spinner } from '@clack/prompts';
+import { generateCodeFix } from './llm.js';
+const execAsync = promisify(exec);
+/**
+ * Perform automated syntax, type, and compilation check on a target file
+ */
+export async function checkFileSyntax(filePath, cwd) {
+    const fullPath = path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
+    if (!fs.existsSync(fullPath) || !fs.statSync(fullPath).isFile()) {
+        return { valid: false, errors: [`File not found: ${filePath}`], output: `File not found: ${filePath}` };
+    }
+    const ext = path.extname(filePath).toLowerCase();
+    // 1. JSON Syntax Check
+    if (ext === '.json') {
+        try {
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            JSON.parse(content);
+            return { valid: true, errors: [], output: 'Valid JSON syntax.' };
+        }
+        catch (err) {
+            return { valid: false, errors: [`JSON Syntax Error: ${err?.message || String(err)}`], output: err?.message || String(err) };
+        }
+    }
+    // 2. JavaScript / TypeScript Check
+    if (['.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx'].includes(ext)) {
+        const hasTsConfig = fs.existsSync(path.join(cwd, 'tsconfig.json'));
+        if (hasTsConfig && ['.ts', '.tsx'].includes(ext)) {
+            try {
+                const { stdout, stderr } = await execAsync('npx tsc --noEmit', { cwd, maxBuffer: 10 * 1024 * 1024 });
+                return { valid: true, errors: [], output: stdout || 'TypeScript compilation clean.' };
+            }
+            catch (err) {
+                const errOut = (err.stdout || '') + '\n' + (err.stderr || '') + '\n' + (err.message || '');
+                const lines = errOut.split('\n');
+                const fileErrors = lines.filter((l) => l.includes(filePath) || l.includes(path.basename(filePath)));
+                const relevantOut = fileErrors.length > 0 ? fileErrors.join('\n') : errOut.slice(0, 3000);
+                return { valid: false, errors: [relevantOut], output: errOut.slice(0, 4000) };
+            }
+        }
+        try {
+            const { stderr } = await execAsync(`node --check "${fullPath}"`, { cwd });
+            if (stderr && stderr.includes('SyntaxError')) {
+                return { valid: false, errors: [stderr], output: stderr };
+            }
+            return { valid: true, errors: [], output: 'Node syntax check passed.' };
+        }
+        catch (err) {
+            const errOut = (err.stderr || '') || (err.stdout || '') || err.message || String(err);
+            return { valid: false, errors: [errOut], output: errOut };
+        }
+    }
+    // 3. Python Syntax Check
+    if (ext === '.py') {
+        try {
+            const pyCmd = process.platform === 'win32' ? 'python' : 'python3';
+            const { stdout, stderr } = await execAsync(`${pyCmd} -m py_compile "${fullPath}"`, { cwd });
+            return { valid: true, errors: [], output: stdout || 'Python syntax clean.' };
+        }
+        catch (err) {
+            const errOut = (err.stderr || '') || (err.stdout || '') || err.message || String(err);
+            return { valid: false, errors: [errOut], output: errOut };
+        }
+    }
+    // 4. Go Syntax Check
+    if (ext === '.go') {
+        try {
+            const { stdout, stderr } = await execAsync(`go vet "${fullPath}"`, { cwd });
+            return { valid: true, errors: [], output: stdout || 'Go check clean.' };
+        }
+        catch (err) {
+            const errOut = (err.stderr || '') || (err.stdout || '') || err.message || String(err);
+            return { valid: false, errors: [errOut], output: errOut };
+        }
+    }
+    // 5. Rust Syntax Check
+    if (ext === '.rs') {
+        try {
+            const { stdout, stderr } = await execAsync(`cargo check`, { cwd });
+            return { valid: true, errors: [], output: stdout || 'Cargo check clean.' };
+        }
+        catch (err) {
+            const errOut = (err.stderr || '') || (err.stdout || '') || err.message || String(err);
+            return { valid: false, errors: [errOut], output: errOut };
+        }
+    }
+    return { valid: true, errors: [], output: 'File extension has no standalone compiler check.' };
+}
+/**
+ * Execute custom verification command or package build check
+ */
+export async function runProjectVerification(cwd, verifyCmd) {
+    if (verifyCmd && verifyCmd.trim()) {
+        try {
+            const { stdout, stderr } = await execAsync(verifyCmd.trim(), { cwd, maxBuffer: 10 * 1024 * 1024 });
+            return { valid: true, errors: [], output: (stdout || '') + (stderr ? `\n${stderr}` : '') };
+        }
+        catch (err) {
+            const combined = (err.stdout || '') + '\n' + (err.stderr || '') + '\n' + (err.message || '');
+            return { valid: false, errors: [combined.slice(0, 4000)], output: combined.slice(0, 8000) };
+        }
+    }
+    const pkgPath = path.join(cwd, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            if (pkg.scripts && pkg.scripts.build && !pkg.scripts.build.includes('no test specified')) {
+                try {
+                    const { stdout, stderr } = await execAsync('npm run build', { cwd, maxBuffer: 10 * 1024 * 1024 });
+                    return { valid: true, errors: [], output: stdout || 'npm run build clean.' };
+                }
+                catch (err) {
+                    const combined = (err.stdout || '') + '\n' + (err.stderr || '') + '\n' + (err.message || '');
+                    return { valid: false, errors: [combined.slice(0, 4000)], output: combined.slice(0, 8000) };
+                }
+            }
+        }
+        catch { }
+    }
+    return { valid: true, errors: [], output: 'No build verification command executed.' };
+}
+/**
+ * Auto-fix and recheck files iteratively until errors are resolved or max retries reached
+ */
+export async function verifyAndSelfHealFiles(targetFiles, cwd, projectName, filesList, options) {
+    const maxRetries = options?.maxRetries || 3;
+    const verifiedFiles = [];
+    const remainingErrors = [];
+    for (const file of targetFiles) {
+        let attempts = 0;
+        let isClean = false;
+        while (attempts < maxRetries) {
+            attempts++;
+            const checkRes = await checkFileSyntax(file, cwd);
+            if (checkRes.valid) {
+                isClean = true;
+                break;
+            }
+            // Error detected! Auto-fix and recheck!
+            const vSpin = spinner();
+            vSpin.start(chalk.yellow(`🔍 Error detected in ${file}. Running auto-fix attempt ${attempts}/${maxRetries}...`));
+            const fullPath = path.isAbsolute(file) ? file : path.resolve(cwd, file);
+            let currentContent = '';
+            try {
+                currentContent = fs.readFileSync(fullPath, 'utf-8');
+            }
+            catch {
+                remainingErrors.push(`Could not read file ${file} for auto-fix.`);
+                break;
+            }
+            try {
+                const fixResult = await generateCodeFix(`Fix syntax, runtime, or logical error in file "${file}":\n${checkRes.errors.join('\n')}`, projectName, filesList, file, currentContent, options?.language, options?.native);
+                if (fixResult.fixedCode && fixResult.fixedCode.trim()) {
+                    fs.writeFileSync(fullPath, fixResult.fixedCode, 'utf-8');
+                }
+                // Recheck file after applying fix!
+                const recheck = await checkFileSyntax(file, cwd);
+                if (recheck.valid) {
+                    vSpin.stop(chalk.green(`✓ Fix confirmed! ${file} is now error-free (Verified on attempt ${attempts}).`));
+                    isClean = true;
+                    break;
+                }
+                else {
+                    vSpin.stop(chalk.yellow(`⚠️ Fix applied to ${file}, but recheck found remaining error. Retrying (${attempts}/${maxRetries})...`));
+                }
+            }
+            catch (fixErr) {
+                vSpin.stop(chalk.red(`Failed fix attempt on ${file}: ${fixErr?.message || String(fixErr)}`));
+            }
+        }
+        if (isClean) {
+            verifiedFiles.push(file);
+        }
+        else {
+            remainingErrors.push(`File ${file} failed verification after ${maxRetries} self-healing attempt(s).`);
+        }
+    }
+    // Check overall project build verification if custom verifyCmd or tsconfig exists
+    if (options?.verifyCmd || fs.existsSync(path.join(cwd, 'tsconfig.json'))) {
+        const projCheck = await runProjectVerification(cwd, options?.verifyCmd);
+        if (!projCheck.valid) {
+            remainingErrors.push(`Project build/test verification failed:\n${projCheck.errors.join('\n')}`);
+        }
+    }
+    return {
+        success: remainingErrors.length === 0,
+        verifiedFiles,
+        remainingErrors,
+    };
+}
+/**
+ * Executes a shell command smartly: fast commands return exit code immediately,
+ * while persistent server/daemon processes (e.g. node server.js, npm start) are left running in background
+ * so Scout Agent does not hang.
+ */
+export function executeSmartCommand(cmd, cwd, initialWaitMs = 3000, maxWaitMs = 20000) {
+    return new Promise((resolve) => {
+        const proc = exec(cmd, { cwd });
+        const outputBuffers = [];
+        let hasResolved = false;
+        const isLikelyServer = /\b(?:node|nodemon|python|python3|flask|uvicorn|vite|next|http-server|live-server|serve|pm2|npm\s+(?:start|run\s+dev|run\s+server))\b/i.test(cmd) ||
+            /\b(?:server|app|main|index|dev|watch)\.(?:js|ts|py|go)\b/i.test(cmd) ||
+            /\b(?:--watch|-w|watch)\b/i.test(cmd);
+        proc.stdout?.on('data', (data) => {
+            outputBuffers.push(data.toString());
+        });
+        proc.stderr?.on('data', (data) => {
+            outputBuffers.push(data.toString());
+        });
+        proc.on('close', (code) => {
+            if (!hasResolved) {
+                hasResolved = true;
+                clearTimeout(timer);
+                resolve({
+                    exitCode: code ?? 0,
+                    output: outputBuffers.join(''),
+                    isBackgroundServer: false,
+                    pid: proc.pid,
+                });
+            }
+        });
+        proc.on('error', (err) => {
+            if (!hasResolved) {
+                hasResolved = true;
+                clearTimeout(timer);
+                resolve({
+                    exitCode: 1,
+                    output: `Process Error: ${err.message}`,
+                    isBackgroundServer: false,
+                });
+            }
+        });
+        const timer = setTimeout(() => {
+            if (hasResolved)
+                return;
+            const currentOutput = outputBuffers.join('');
+            const hasServerKeywords = /\b(?:listening|running|started|connected|ready|port|http:\/\/|https:\/\/)\b/i.test(currentOutput);
+            if (isLikelyServer || hasServerKeywords) {
+                hasResolved = true;
+                try {
+                    proc.unref();
+                }
+                catch { }
+                resolve({
+                    exitCode: 0,
+                    output: (currentOutput || 'Server process started successfully.') + `\n[Process is running continuously in background (PID ${proc.pid})].`,
+                    isBackgroundServer: true,
+                    pid: proc.pid,
+                });
+            }
+            else {
+                setTimeout(() => {
+                    if (!hasResolved) {
+                        hasResolved = true;
+                        try {
+                            proc.unref();
+                        }
+                        catch { }
+                        resolve({
+                            exitCode: 0,
+                            output: outputBuffers.join('') + `\n[Command took over ${maxWaitMs / 1000}s, continuing in background (PID ${proc.pid})].`,
+                            isBackgroundServer: true,
+                            pid: proc.pid,
+                        });
+                    }
+                }, Math.max(1000, maxWaitMs - initialWaitMs));
+            }
+        }, initialWaitMs);
+    });
+}
+//# sourceMappingURL=verifier.js.map

package/bin/src/engine/verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["verifier.ts"],"names":[],"mappings":"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"}

package/bin/src/index.js

@@ -24,12 +24,12 @@ program
     .name('scout')
     .alias('ft')
     .description('FrontTerrain — The Onboarding Co-Pilot for New Codebases')
-    .version('3.0.9');
+    .version('4.0.1');
 // Header UI on execution with FrontTerrain proprietary logo & version auto-checker
 program.hook('preAction', async (_thisCommand, actionCommand) => {
-    intro(renderBranding('3.0.9'));
+    intro(renderBranding('4.0.1'));
     if (actionCommand && actionCommand.name() !== 'upgrade') {
-        await checkForUpdates('3.0.9');
+        await checkForUpdates('4.0.1');
     }
 });
 // PostAction hook for Discovery Layer (runs on successful command completion)
@@ -182,7 +182,7 @@ program
     .command('upgrade')
     .description('Check for updates and auto-upgrade Scout to the latest version')
     .action(async () => {
-    await checkForUpdates('3.0.9', true);
+    await checkForUpdates('4.0.1', true);
     outro(chalk.cyan('Upgrade check complete.'));
 });
 program.parse(process.argv);

package/bin/src/utils/branding.js

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

package/package.json

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