vigthoria-cli 1.6.16 → 1.6.18

package/dist/commands/auth.js

@@ -8,8 +8,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
 const inquirer_1 = __importDefault(require("inquirer"));
+const logger_js_1 = require("../utils/logger.js");
 const api_js_1 = require("../utils/api.js");
 class AuthCommand {
     config;
@@ -73,7 +73,7 @@ class AuthCommand {
                 validate: (input) => input.length >= 6 || 'Password must be at least 6 characters',
             },
         ]);
-        const spinner = (0, ora_1.default)('Logging in...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Logging in...').start();
         const success = await this.api.login(credentials.email, credentials.password);
         spinner.stop();
         if (success) {
@@ -96,7 +96,7 @@ class AuthCommand {
         await this.loginWithToken(token);
     }
     async loginWithToken(token) {
-        const spinner = (0, ora_1.default)('Validating token...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Validating token...').start();
         const success = await this.api.loginWithToken(token);
         spinner.stop();
         if (success) {
@@ -173,7 +173,7 @@ class AuthCommand {
         });
         console.log();
         // API status
-        const spinner = (0, ora_1.default)('Checking API status...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Checking API status...').start();
         const apiStatus = await this.api.getHealthStatus();
         spinner.stop();
         console.log(chalk_1.default.white('API Status:'));
@@ -198,7 +198,7 @@ class AuthCommand {
         else {
             console.log(chalk_1.default.gray('  Self-hosted Models: ') + chalk_1.default.gray('disabled'));
         }
-        const capabilitySpinner = (0, ora_1.default)('Checking live capability truth...').start();
+        const capabilitySpinner = (0, logger_js_1.createSpinner)('Checking live capability truth...').start();
         const capabilityStatus = await this.api.getCapabilityTruthStatus({
             workspacePath: process.cwd(),
             projectPath: process.cwd(),

package/dist/commands/bridge.js

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BridgeCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
+const logger_js_1 = require("../utils/logger.js");
 const api_js_1 = require("../utils/api.js");
 class BridgeCommand {
     api;
@@ -13,7 +13,7 @@ class BridgeCommand {
         this.api = new api_js_1.APIClient(config, logger);
     }
     async status() {
-        const spinner = (0, ora_1.default)('Checking DevTools Bridge...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Checking DevTools Bridge...').start();
         const bridge = await this.api.getDevtoolsBridgeStatus();
         spinner.stop();
         console.log();

package/dist/commands/chat.d.ts

@@ -32,6 +32,7 @@ export declare class ChatCommand {
     private currentModel;
     private modelExplicitlySelected;
     private autoApprove;
+    private agentToolEvidence;
     private operatorMode;
     private workflowTarget;
     private savePlanToVigFlow;

package/dist/commands/chat.js

@@ -38,11 +38,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChatCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const readline = __importStar(require("readline"));
+const logger_js_1 = require("../utils/logger.js");
 const api_js_1 = require("../utils/api.js");
 const tools_js_1 = require("../utils/tools.js");
 const session_js_1 = require("../utils/session.js");
@@ -67,6 +67,8 @@ class ChatCommand {
     currentModel = 'code';
     modelExplicitlySelected = false;
     autoApprove = false;
+    // Phase 5: Agent quality gate — track tool usage for evidence thresholds
+    agentToolEvidence = { discovery: 0, mutation: 0, searchFailed: 0 };
     operatorMode = false;
     workflowTarget = null;
     savePlanToVigFlow = false;
@@ -195,6 +197,10 @@ class ChatCommand {
     }
     buildTaskShapingInstructions(prompt) {
         const instructions = [];
+        // Platform-aware routing hints
+        if (os.platform() === 'win32') {
+            instructions.push('Platform: Windows. Use list_dir, glob, read_file, and the grep tool for searching.', 'The grep tool handles Windows automatically — do not use bash to call grep, findstr, or Select-String manually.', 'Do not use bash for Unix commands (cat, head, tail, awk, sed, wc).', 'Use read_file to inspect file contents instead of shell commands.', 'All file paths use forward slashes internally.');
+        }
         if (this.isDiagnosticPrompt(prompt)) {
             instructions.push('Diagnostic mode is active.', 'Treat this as a debugging task, not a generic code review or feature request.', 'Start with concrete evidence: logs, runtime errors, config, launch files, and exact symbol references.', 'If log files exist, inspect them before proposing fixes.', 'Do not claim a file, definition, asset, or symbol is missing until you verify that with tools.', 'If a prior diagnosis mentioned a missing symbol or YAML entry, re-check the actual files before repeating it.', 'Prefer grep plus read_file around the exact references involved in the failure.', 'Separate your reasoning into: Evidence, Confirmed Cause, and Remaining Hypotheses.', 'Do not suggest speculative fixes when the current evidence contradicts them.');
         }
@@ -537,7 +543,7 @@ class ChatCommand {
         const runtimeContext = await this.getPromptRuntimeContext(prompt);
         const resolvedWorkflow = await this.api.resolveVigFlowWorkflow(selector);
         const invocationMode = this.operatorMode ? 'operator' : this.agentMode ? 'agent' : 'chat';
-        const spinner = this.jsonOutput ? null : (0, ora_1.default)({ text: `Running workflow ${resolvedWorkflow.name}...`, spinner: 'clock' }).start();
+        const spinner = this.jsonOutput ? null : (0, logger_js_1.createSpinner)({ text: `Running workflow ${resolvedWorkflow.name}...`, spinner: 'clock' }).start();
         try {
             const execution = await this.api.runVigFlowWorkflow(resolvedWorkflow.id, {
                 data: {
@@ -606,7 +612,7 @@ class ChatCommand {
             return;
         }
         const runtimeContext = await this.getPromptRuntimeContext(prompt);
-        const spinner = this.jsonOutput ? null : (0, ora_1.default)({ text: 'Thinking like an operator...', spinner: 'clock' }).start();
+        const spinner = this.jsonOutput ? null : (0, logger_js_1.createSpinner)({ text: 'Thinking like an operator...', spinner: 'clock' }).start();
         const executionPrompt = this.buildExecutionPrompt(prompt);
         const workflowType = this.isDiagnosticPrompt(prompt) ? 'analysis_only' : 'full_autonomy';
         try {
@@ -657,10 +663,11 @@ class ChatCommand {
     async runSimplePrompt(prompt) {
         this.lastActionableUserInput = prompt;
         this.messages.push({ role: 'user', content: this.buildExecutionPrompt(prompt) });
-        const spinner = (0, ora_1.default)({ text: 'Thinking...', spinner: 'clock' }).start();
+        const spinner = this.jsonOutput ? null : (0, logger_js_1.createSpinner)({ text: 'Thinking...', spinner: 'clock' }).start();
         try {
             const response = await this.api.chat(this.getMessagesForModel(), this.currentModel);
-            spinner.stop();
+            if (spinner)
+                spinner.stop();
             const finalText = response.message.trim();
             if (finalText) {
                 console.log(finalText);
@@ -669,7 +676,8 @@ class ChatCommand {
             this.saveSession();
         }
         catch (error) {
-            spinner.fail('Failed to get response');
+            if (spinner)
+                spinner.fail('Failed to get response');
             this.logger.error(error.message);
         }
     }
@@ -707,21 +715,37 @@ class ChatCommand {
         }
         this.lastActionableUserInput = prompt;
         this.directToolContinuationCount = 0;
+        this.agentToolEvidence = { discovery: 0, mutation: 0, searchFailed: 0 };
         this.tools.clearSessionApprovals();
         this.ensureAgentSystemPrompt();
         this.messages.push({ role: 'user', content: this.buildScopedUserPrompt(prompt) });
         this.saveSession();
         const maxTurns = 10;
         for (let turn = 0; turn < maxTurns; turn += 1) {
-            const spinner = (0, ora_1.default)({ text: turn === 0 ? 'Planning...' : 'Continuing...', spinner: 'clock' }).start();
+            const spinner = this.jsonOutput ? null : (0, logger_js_1.createSpinner)({ text: turn === 0 ? 'Planning...' : 'Continuing...', spinner: 'clock' }).start();
             try {
                 const response = await this.api.chat(this.getMessagesForModel(), this.currentModel);
-                spinner.stop();
+                if (spinner)
+                    spinner.stop();
                 const assistantMessage = response.message || '';
                 this.messages.push({ role: 'assistant', content: assistantMessage });
                 const toolCalls = this.extractToolCalls(assistantMessage);
                 const visibleText = this.stripToolPayloads(assistantMessage).trim();
                 if (toolCalls.length === 0) {
+                    // Phase 5: Quality gate — if the agent tries to conclude on the first
+                    // turn without any discovery, push it to gather evidence first.
+                    if (turn === 0 && this.agentToolEvidence.discovery === 0 && this.isDiagnosticPrompt(prompt)) {
+                        this.messages.push({
+                            role: 'system',
+                            content: [
+                                'Quality gate: you concluded without using any discovery tools (list_dir, glob, read_file, grep).',
+                                'Before answering a diagnostic or audit question, you MUST inspect the project with tools.',
+                                'Use list_dir and read_file to gather concrete evidence, then provide your answer.',
+                            ].join('\n'),
+                        });
+                        this.directToolContinuationCount += 1;
+                        continue;
+                    }
                     const finalContent = this.resolveDirectModeCompletion(prompt, visibleText);
                     if (this.jsonOutput) {
                         console.log(JSON.stringify({
@@ -750,7 +774,8 @@ class ChatCommand {
                 this.saveSession();
             }
             catch (error) {
-                spinner.fail('Agent request failed');
+                if (spinner)
+                    spinner.fail('Agent request failed');
                 if (this.jsonOutput) {
                     process.exitCode = 1;
                     console.log(JSON.stringify({
@@ -910,7 +935,7 @@ class ChatCommand {
         this.v3IterationCount = 0;
         this.v3ToolCallCount = 0;
         this.v3LastActivity = Date.now();
-        const spinner = this.jsonOutput ? null : (0, ora_1.default)({
+        const spinner = this.jsonOutput ? null : (0, logger_js_1.createSpinner)({
             text: routingPolicy.cloudSelected ? 'Routing heavy task to Vigthoria Cloud...' : 'Routing to V3 Agent...',
             spinner: 'clock',
         }).start();
@@ -971,6 +996,18 @@ class ChatCommand {
                 }
                 this.logger.error(errorMessage);
                 this.messages.push({ role: 'assistant', content: errorMessage });
+                if (this.jsonOutput) {
+                    process.exitCode = 1;
+                    console.log(JSON.stringify({
+                        success: false,
+                        mode: 'agent',
+                        model: routingPolicy.selectedModel,
+                        partial: false,
+                        content: '',
+                        error: errorMessage,
+                        metadata: { executionPath: 'v3-agent', previewGate },
+                    }, null, 2));
+                }
                 return true;
             }
             if (!this.jsonOutput && previewGate?.required && previewGate?.passed !== true && workspaceHasOutput) {
@@ -1028,6 +1065,18 @@ class ChatCommand {
             const errorMessage = `Agent mode requires the V3 workflow and will not fall back to the legacy CLI loop. ${error.message}`;
             this.logger.error(errorMessage);
             this.messages.push({ role: 'assistant', content: errorMessage });
+            if (this.jsonOutput) {
+                process.exitCode = 1;
+                console.log(JSON.stringify({
+                    success: false,
+                    mode: 'agent',
+                    model: routingPolicy.selectedModel,
+                    partial: false,
+                    content: '',
+                    error: errorMessage,
+                    metadata: { executionPath: 'v3-agent' },
+                }, null, 2));
+            }
             return true;
         }
     }
@@ -1437,10 +1486,20 @@ class ChatCommand {
     }
     buildContinuationPrompt() {
         const diagnosticMode = this.isDiagnosticPrompt(this.lastActionableUserInput);
+        const { discovery, mutation, searchFailed } = this.agentToolEvidence;
+        const evidenceLines = [];
+        if (discovery < 2) {
+            evidenceLines.push(`Quality gate: only ${discovery} discovery tool(s) used so far (list_dir, glob, read_file, grep). Use at least 2 before concluding.`);
+        }
+        if (searchFailed > 0) {
+            evidenceLines.push(`Warning: ${searchFailed} search tool call(s) failed. Do not treat failed searches as evidence that something is missing.`);
+        }
         return [
             `Tool results received for direct mode step ${this.directToolContinuationCount + 1}.`,
             `Original user request: ${this.lastActionableUserInput}`,
             `Project root boundary: ${this.currentProjectPath}`,
+            `Evidence collected: ${discovery} discovery, ${mutation} mutation, ${searchFailed} search failures.`,
+            ...evidenceLines,
             'Do not declare success until the exact user question has been answered with tool-backed evidence.',
             'If a user is asking which file is correct or most recent, keep inspecting until you can justify the answer from actual results.',
             diagnosticMode ? 'Because this is a debugging task, prefer logs, runtime evidence, and exact symbol references over generic fixes.' : 'Keep working from concrete tool results.',
@@ -1604,16 +1663,47 @@ class ChatCommand {
             if (!this.jsonOutput) {
                 console.log(chalk_1.default.cyan(`⚙ Executing: ${call.tool}`));
             }
-            const result = await this.tools.execute(call);
+            let result = await this.tools.execute(call);
+            // Phase 2: If a search tool failed (search_failed), retry with alternate approach
+            const searchStatus = result.metadata?.searchStatus;
+            if (call.tool === 'grep' && searchStatus === 'search_failed') {
+                if (!this.jsonOutput) {
+                    console.log(chalk_1.default.yellow(`⚠ Search backend failed, retrying with alternate method...`));
+                }
+                // Force Node-native fallback by re-executing with a note
+                const fallbackResult = await this.tools.execute({
+                    tool: 'grep',
+                    args: { ...call.args, _fallback: 'node-native' },
+                });
+                if (fallbackResult.success || fallbackResult.metadata?.searchStatus !== 'search_failed') {
+                    result = fallbackResult;
+                }
+            }
             const summary = this.formatToolResult(call, result);
             if (!this.jsonOutput) {
                 console.log(result.success ? chalk_1.default.gray(summary) : chalk_1.default.red(summary));
             }
             this.messages.push({ role: 'system', content: summary });
+            // Phase 5: Track tool evidence for quality gates
+            const finalStatus = result.metadata?.searchStatus;
+            if (finalStatus === 'search_failed') {
+                this.agentToolEvidence.searchFailed += 1;
+            }
+            else if (/^(read_file|list_dir|glob|grep|git|repo|fetch_url)$/.test(call.tool)) {
+                this.agentToolEvidence.discovery += 1;
+            }
+            else if (/^(write_file|edit_file|bash|ssh_exec)$/.test(call.tool)) {
+                this.agentToolEvidence.mutation += 1;
+            }
         }
     }
     formatToolResult(call, result) {
-        const parts = [`Tool ${call.tool} ${result.success ? 'succeeded' : 'failed'}.`];
+        const parts = [`Tool ${call.tool} ${result.success ? 'succeeded' : 'FAILED'}.`];
+        // Include search status classification for the agent to reason about
+        const searchStatus = result.metadata?.searchStatus;
+        if (searchStatus) {
+            parts.push(`Search status: ${searchStatus}`);
+        }
         if (result.output) {
             parts.push(`Output:\n${this.truncateText(result.output)}`);
         }

package/dist/commands/deploy.js

@@ -53,7 +53,7 @@ exports.DeployCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const ora_1 = __importDefault(require("ora"));
+const logger_js_1 = require("../utils/logger.js");
 const inquirer_1 = __importDefault(require("inquirer"));
 class DeployCommand {
     config;
@@ -127,7 +127,7 @@ class DeployCommand {
      * Deploy to preview URL (free)
      */
     async deployToPreview(projectPath) {
-        const spinner = (0, ora_1.default)('Deploying to preview...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Deploying to preview...').start();
         try {
             const projectDir = projectPath || process.cwd();
             const projectInfo = this.detectProjectInfo(projectDir);
@@ -160,7 +160,7 @@ class DeployCommand {
      * Deploy to Vigthoria subdomain
      */
     async deployToSubdomain(subdomain, projectPath) {
-        const spinner = (0, ora_1.default)(`Deploying to ${subdomain}.vigthoria.io...`).start();
+        const spinner = (0, logger_js_1.createSpinner)(`Deploying to ${subdomain}.vigthoria.io...`).start();
         try {
             // Validate subdomain format
             if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(subdomain) || subdomain.length < 3) {
@@ -213,7 +213,7 @@ class DeployCommand {
      * Deploy to custom domain
      */
     async deployToCustomDomain(domain, projectPath) {
-        const spinner = (0, ora_1.default)(`Setting up ${domain}...`).start();
+        const spinner = (0, logger_js_1.createSpinner)(`Setting up ${domain}...`).start();
         try {
             const projectDir = projectPath || process.cwd();
             const projectInfo = this.detectProjectInfo(projectDir);
@@ -303,7 +303,7 @@ class DeployCommand {
      * Show hosting plans
      */
     async showPlans() {
-        const spinner = (0, ora_1.default)('Fetching hosting plans...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Fetching hosting plans...').start();
         try {
             const response = await fetch(`${this.apiBase}/api/hosting/plans`, {
                 headers: this.getAuthHeaders()
@@ -344,7 +344,7 @@ class DeployCommand {
      */
     async list() {
         this.requireAuth();
-        const spinner = (0, ora_1.default)('Fetching deployments...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Fetching deployments...').start();
         try {
             const response = await fetch(`${this.apiBase}/api/hosting/domains`, {
                 headers: this.getAuthHeaders()
@@ -384,7 +384,7 @@ class DeployCommand {
      */
     async status(domain) {
         this.requireAuth();
-        const spinner = (0, ora_1.default)('Checking status...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Checking status...').start();
         try {
             const endpoint = domain
                 ? `${this.apiBase}/api/hosting/domain/${encodeURIComponent(domain)}/status`
@@ -411,7 +411,7 @@ class DeployCommand {
      */
     async verify(domain) {
         this.requireAuth();
-        const spinner = (0, ora_1.default)(`Verifying DNS for ${domain}...`).start();
+        const spinner = (0, logger_js_1.createSpinner)(`Verifying DNS for ${domain}...`).start();
         try {
             const response = await fetch(`${this.apiBase}/api/hosting/domain/verify`, {
                 method: 'POST',
@@ -454,7 +454,7 @@ class DeployCommand {
             console.log(chalk_1.default.yellow('\n⚠️ Removal cancelled.\n'));
             return;
         }
-        const spinner = (0, ora_1.default)(`Removing ${domain}...`).start();
+        const spinner = (0, logger_js_1.createSpinner)(`Removing ${domain}...`).start();
         try {
             const response = await fetch(`${this.apiBase}/api/hosting/domain/${encodeURIComponent(domain)}`, {
                 method: 'DELETE',

package/dist/commands/edit.js

@@ -8,8 +8,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EditCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
 const inquirer_1 = __importDefault(require("inquirer"));
+const logger_js_1 = require("../utils/logger.js");
 const api_js_1 = require("../utils/api.js");
 const files_js_1 = require("../utils/files.js");
 class EditCommand {
@@ -52,7 +52,7 @@ class EditCommand {
             instruction = answer.instruction;
         }
         // Generate edit
-        const spinner = (0, ora_1.default)({
+        const spinner = (0, logger_js_1.createSpinner)({
             text: 'Generating changes...',
             spinner: 'dots',
         }).start();
@@ -109,7 +109,7 @@ Return the complete modified code:`,
         this.logger.section(`Fixing: ${file.relativePath}`);
         console.log(chalk_1.default.gray(`Fix type: ${options.type} | Language: ${file.language}`));
         console.log();
-        const spinner = (0, ora_1.default)({
+        const spinner = (0, logger_js_1.createSpinner)({
             text: `Analyzing for ${options.type} issues...`,
             spinner: 'dots',
         }).start();

package/dist/commands/explain.js

@@ -8,9 +8,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExplainCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
 const marked_1 = require("marked");
 const marked_terminal_1 = require("marked-terminal");
+const logger_js_1 = require("../utils/logger.js");
 const api_js_1 = require("../utils/api.js");
 const files_js_1 = require("../utils/files.js");
 class ExplainCommand {
@@ -61,7 +61,7 @@ class ExplainCommand {
         });
         console.log(chalk_1.default.gray('─'.repeat(60)));
         console.log();
-        const spinner = (0, ora_1.default)({
+        const spinner = (0, logger_js_1.createSpinner)({
             text: 'Analyzing code...',
             spinner: 'dots',
         }).start();

package/dist/commands/generate.js

@@ -10,8 +10,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenerateCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
 const inquirer_1 = __importDefault(require("inquirer"));
+const logger_js_1 = require("../utils/logger.js");
 const api_js_1 = require("../utils/api.js");
 const files_js_1 = require("../utils/files.js");
 class GenerateCommand {
@@ -40,7 +40,7 @@ class GenerateCommand {
             console.log(chalk_1.default.cyan('Pro Mode: Planning → Generating → Quality Check'));
         }
         console.log();
-        const spinner = (0, ora_1.default)({
+        const spinner = (0, logger_js_1.createSpinner)({
             text: proMode ? 'Phase 1: Planning project structure...' : 'Generating code...',
             spinner: 'dots',
         }).start();

package/dist/commands/repo.js

@@ -54,7 +54,7 @@ exports.RepoCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const ora_1 = __importDefault(require("ora"));
+const logger_js_1 = require("../utils/logger.js");
 const inquirer_1 = __importDefault(require("inquirer"));
 const archiver_1 = __importDefault(require("archiver"));
 const fs_1 = require("fs");
@@ -313,7 +313,7 @@ class RepoCommand {
             console.log(chalk_1.default.red(`\n❌ Path does not exist: ${projectPath}\n`));
             return;
         }
-        const spinner = (0, ora_1.default)('Analyzing project...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Analyzing project...').start();
         try {
             const projectInfo = this.detectProjectInfo(projectPath);
             spinner.succeed(`Project detected: ${chalk_1.default.cyan(projectInfo.name)}`);
@@ -363,7 +363,7 @@ class RepoCommand {
                 console.log(chalk_1.default.yellow('\n⚠️  Push cancelled.\n'));
                 return;
             }
-            const uploadSpinner = (0, ora_1.default)('Preparing project files...').start();
+            const uploadSpinner = (0, logger_js_1.createSpinner)('Preparing project files...').start();
             const files = this.collectProjectFiles(projectPath);
             if (files.length === 0) {
                 throw new Error('No readable text files found to push');
@@ -409,7 +409,7 @@ class RepoCommand {
      */
     async pull(projectName, options = {}) {
         this.requireAuth();
-        const spinner = (0, ora_1.default)(`Fetching project: ${projectName}...`).start();
+        const spinner = (0, logger_js_1.createSpinner)(`Fetching project: ${projectName}...`).start();
         try {
             const repo = await this.resolveRepoByName(projectName);
             const response = await this.repoFetch('/api/repo/pull', {
@@ -437,7 +437,7 @@ class RepoCommand {
                     return;
                 }
             }
-            const downloadSpinner = (0, ora_1.default)('Downloading project files...').start();
+            const downloadSpinner = (0, logger_js_1.createSpinner)('Downloading project files...').start();
             // Create output directory
             fs.mkdirSync(outputPath, { recursive: true });
             // If we have a download URL, fetch and extract
@@ -496,7 +496,7 @@ class RepoCommand {
      */
     async list(options = {}) {
         this.requireAuth();
-        const spinner = (0, ora_1.default)('Fetching your projects...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Fetching your projects...').start();
         try {
             const repos = await this.getMyRepos();
             const filteredRepos = options.visibility
@@ -596,7 +596,7 @@ class RepoCommand {
         this.requireAuth();
         const projectPath = process.cwd();
         const projectInfo = this.detectProjectInfo(projectPath);
-        const spinner = (0, ora_1.default)('Checking sync status...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Checking sync status...').start();
         try {
             const response = await fetch(`${this.apiBase}/api/repo/status/${encodeURIComponent(projectInfo.name)}`, {
                 method: 'GET',
@@ -644,7 +644,7 @@ class RepoCommand {
      */
     async share(projectName, options = {}) {
         this.requireAuth();
-        const spinner = (0, ora_1.default)('Generating share link...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Generating share link...').start();
         try {
             const response = await fetch(`${this.apiBase}/api/repo/share`, {
                 method: 'POST',
@@ -686,7 +686,7 @@ class RepoCommand {
             console.log(chalk_1.default.yellow('\n⚠️  Delete cancelled.\n'));
             return;
         }
-        const spinner = (0, ora_1.default)('Deleting project...').start();
+        const spinner = (0, logger_js_1.createSpinner)('Deleting project...').start();
         try {
             const response = await fetch(`${this.apiBase}/api/repo/projects/${encodeURIComponent(projectName)}`, {
                 method: 'DELETE',
@@ -712,7 +712,7 @@ class RepoCommand {
         // Parse project URL or name
         const projectIdMatch = projectUrl.match(/preview\/(\d+)/);
         const projectId = projectIdMatch ? projectIdMatch[1] : projectUrl;
-        const spinner = (0, ora_1.default)(`Cloning project...`).start();
+        const spinner = (0, logger_js_1.createSpinner)(`Cloning project...`).start();
         try {
             const response = await fetch(`${this.apiBase}/api/repo/clone/${projectId}`, {
                 method: 'GET',

package/dist/commands/review.js

@@ -8,9 +8,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReviewCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
 const marked_1 = require("marked");
 const marked_terminal_1 = require("marked-terminal");
+const logger_js_1 = require("../utils/logger.js");
 const api_js_1 = require("../utils/api.js");
 const files_js_1 = require("../utils/files.js");
 class ReviewCommand {
@@ -42,7 +42,7 @@ class ReviewCommand {
         this.logger.section(`Reviewing: ${file.relativePath}`);
         console.log(chalk_1.default.gray(`Language: ${file.language} | Lines: ${file.lines}`));
         console.log();
-        const spinner = (0, ora_1.default)({
+        const spinner = (0, logger_js_1.createSpinner)({
             text: 'Analyzing code quality...',
             spinner: 'dots',
         }).start();

package/dist/index.js

@@ -346,12 +346,17 @@ async function main() {
     });
     // Fix command - Fix code issues
     program
-        .command('fix <file>')
+        .command('fix [file]')
         .alias('f')
         .description('Fix issues in a file')
         .option('-t, --type <type>', 'Fix type (bugs, style, security, performance)', 'bugs')
         .option('--apply', 'Automatically apply fixes', false)
         .action(async (file, options) => {
+        if (!file) {
+            logger.error('Usage: vigthoria fix <file> [--type bugs|style|security|performance] [--apply]');
+            process.exitCode = 1;
+            return;
+        }
         const edit = new edit_js_1.EditCommand(config, logger);
         await edit.fix(file, options);
     });

package/dist/utils/api.d.ts

@@ -237,6 +237,11 @@ export declare class APIClient {
     private isLikelyWindowsPath;
     private resolveServerBindableWorkspacePath;
     private buildLocalWorkspaceSummary;
+    /**
+     * Collect text file contents from the workspace for V3 agent hydration.
+     * Budget: up to ~2 MB total, per-file cap 200 KB, skip binary extensions.
+     */
+    collectWorkspaceFileContents(rootPath: string, filePaths: string[]): Record<string, string>;
     hasAgentWorkspaceOutput(context?: Record<string, any>): boolean;
     getAgentWorkspaceSnapshot(rootPath: string): {
         fileCount: number;

package/dist/utils/api.js

@@ -593,26 +593,37 @@ class APIClient {
                 error: artifacts.error || 'Frontend preview gate could not collect frontend artifacts.',
             };
         }
-        const html = artifacts.html;
-        const css = artifacts.css || '';
-        const js = artifacts.js || '';
+        // Cap artifact sizes to prevent 413 Payload Too Large
+        const PREVIEW_MAX_ARTIFACT_BYTES = 500 * 1024;
+        const html = artifacts.html.slice(0, PREVIEW_MAX_ARTIFACT_BYTES);
+        const css = (artifacts.css || '').slice(0, PREVIEW_MAX_ARTIFACT_BYTES);
+        const js = (artifacts.js || '').slice(0, PREVIEW_MAX_ARTIFACT_BYTES);
         const errors = [];
         for (const baseUrl of this.getTemplateServiceBaseUrls()) {
             try {
+                const proofPayload = JSON.stringify({
+                    vision: String(context.rawPrompt || message || '').slice(0, 2000),
+                    html,
+                    css,
+                    js,
+                    entryPath: artifacts.htmlPath,
+                    workspaceName: path_1.default.basename(rootPath),
+                });
+                // Skip preview proof if payload is still too large (> 4 MB)
+                if (Buffer.byteLength(proofPayload, 'utf8') > 4 * 1024 * 1024) {
+                    return {
+                        required: true,
+                        passed: true,
+                        error: 'Preview proof skipped: payload exceeds size limit.',
+                    };
+                }
                 const response = await fetch(`${baseUrl}/preview-proof`, {
                     method: 'POST',
                     headers: {
                         'Content-Type': 'application/json',
                         Accept: 'application/json',
                     },
-                    body: JSON.stringify({
-                        vision: String(context.rawPrompt || message || ''),
-                        html,
-                        css,
-                        js,
-                        entryPath: artifacts.htmlPath,
-                        workspaceName: path_1.default.basename(rootPath),
-                    }),
+                    body: proofPayload,
                 });
                 if (!response.ok) {
                     const errorText = await response.text().catch(() => '');
@@ -1553,6 +1564,9 @@ menu {
             if (fs_1.default.existsSync(readmePath)) {
                 summary.readmeExcerpt = fs_1.default.readFileSync(readmePath, 'utf8').slice(0, 2500);
             }
+            // Hydrate workspace: include actual file contents so the V3 server
+            // can populate the remote workspace before the agent starts.
+            summary.workspaceFiles = this.collectWorkspaceFileContents(rootPath, snapshot.paths);
             return summary;
         }
         catch (error) {
@@ -1560,6 +1574,52 @@ menu {
             return null;
         }
     }
+    /**
+     * Collect text file contents from the workspace for V3 agent hydration.
+     * Budget: up to ~2 MB total, per-file cap 200 KB, skip binary extensions.
+     */
+    collectWorkspaceFileContents(rootPath, filePaths) {
+        const MAX_TOTAL_BYTES = 2 * 1024 * 1024;
+        const MAX_FILE_BYTES = 200 * 1024;
+        const BINARY_EXTENSIONS = new Set([
+            '.png', '.jpg', '.jpeg', '.gif', '.bmp', '.ico', '.svg', '.webp', '.avif',
+            '.mp3', '.mp4', '.wav', '.ogg', '.webm', '.flac', '.aac',
+            '.zip', '.gz', '.tar', '.rar', '.7z', '.bz2',
+            '.exe', '.dll', '.so', '.dylib', '.bin', '.dat',
+            '.woff', '.woff2', '.ttf', '.eot', '.otf',
+            '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
+            '.db', '.sqlite', '.sqlite3',
+            '.pyc', '.pyo', '.class', '.o', '.obj',
+            '.DS_Store', '.lock',
+        ]);
+        const result = {};
+        let totalBytes = 0;
+        for (const relativePath of filePaths) {
+            if (totalBytes >= MAX_TOTAL_BYTES)
+                break;
+            const ext = path_1.default.extname(relativePath).toLowerCase();
+            if (BINARY_EXTENSIONS.has(ext))
+                continue;
+            if (/(^|[\/\\])\.(git|hg)([\/\\]|$)/.test(relativePath))
+                continue;
+            const absolutePath = path_1.default.join(rootPath, relativePath);
+            try {
+                const stat = fs_1.default.statSync(absolutePath);
+                if (!stat.isFile() || stat.size > MAX_FILE_BYTES || stat.size === 0)
+                    continue;
+                const content = fs_1.default.readFileSync(absolutePath, 'utf8');
+                // Skip likely binary content (high ratio of non-printable chars)
+                if (/[\x00-\x08\x0e-\x1f]/.test(content.slice(0, 512)))
+                    continue;
+                result[relativePath] = content;
+                totalBytes += Buffer.byteLength(content, 'utf8');
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+        return result;
+    }
     hasAgentWorkspaceOutput(context = {}) {
         try {
             const root = this.resolveAgentTargetPath(context);
@@ -2231,6 +2291,30 @@ document.addEventListener('DOMContentLoaded', () => {
                     serverWorkspaceRoot = event.workspace_root.trim();
                 }
                 this.captureV3AgentStreamMutation(event, streamedFiles, serverWorkspaceRoot);
+                // Empty workspace guard: if the remote agent lists its root
+                // and finds nothing while our local workspace has files, the
+                // workspace was not hydrated. Abort early with a clear error
+                // instead of letting the agent spin on an empty directory.
+                if (event.type === 'tool_result'
+                    && event.name === 'list_directory'
+                    && event.success === true
+                    && serverWorkspaceRoot
+                    && typeof event.output === 'string') {
+                    const listOutput = event.output.trim();
+                    const looksEmpty = listOutput === `[${serverWorkspaceRoot}]`
+                        || listOutput === `[${serverWorkspaceRoot}/]`
+                        || listOutput === `[${serverWorkspaceRoot}]\\n`
+                        || /^\[\/tmp\/vig-remote-server-[^\]]+\]\s*$/.test(listOutput);
+                    if (looksEmpty) {
+                        const localPath = this.resolveAgentTargetPath(context);
+                        const localHasFiles = localPath && fs_1.default.existsSync(localPath) && this.hasAgentWorkspaceOutput({ ...context, projectPath: localPath, targetPath: localPath });
+                        if (localHasFiles) {
+                            throw new Error('Remote workspace is empty — the V3 server did not receive your project files. '
+                                + 'Your local workspace has files but the remote agent sees an empty directory. '
+                                + 'This is a workspace sync failure. Falling back to local agent loop.');
+                        }
+                    }
+                }
                 if (typeof context.onStreamEvent === 'function') {
                     try {
                         context.onStreamEvent(event);
@@ -3096,32 +3180,87 @@ document.addEventListener('DOMContentLoaded', () => {
         }
     }
     async getV3AgentHealth() {
-        const endpoint = this.getV3AgentRunUrl(this.getV3AgentBaseUrls()[0]).replace('/api/agent/run', '/health');
-        try {
-            const response = await fetch(endpoint, {
-                method: 'GET',
-                headers: await this.getV3AgentHeaders(),
-            });
-            if (!response.ok) {
+        const baseUrl = this.getV3AgentBaseUrls()[0];
+        // Try multiple health endpoint patterns — the V3 backend may expose
+        // different paths depending on whether it's local (8030) or remote.
+        const candidates = [
+            `${baseUrl}/api/v3-agent/health`,
+            `${baseUrl}/api/health`,
+            `${baseUrl}/health`,
+        ];
+        const headers = await this.getV3AgentHeaders();
+        for (const endpoint of candidates) {
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), 8000);
+                const response = await fetch(endpoint, {
+                    method: 'GET',
+                    headers,
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (response.ok) {
+                    const data = await response.json().catch(() => ({}));
+                    return {
+                        name: 'V3 Agent',
+                        endpoint,
+                        ok: true,
+                        details: { health: data },
+                    };
+                }
+                // 404 means this path doesn't exist — try next candidate
+                if (response.status === 404)
+                    continue;
+                // 405 Method Not Allowed — endpoint exists but rejects GET.
+                // Treat as reachable since the run endpoint (POST) will work.
+                if (response.status === 405) {
+                    return {
+                        name: 'V3 Agent',
+                        endpoint,
+                        ok: true,
+                        details: { health: { reachable: true, note: 'Health endpoint returned 405 but run endpoint is available' } },
+                    };
+                }
+                // Other error
                 throw new Error(`V3 health ${response.status}`);
             }
-            const data = await response.json();
-            const ok = data?.status === 'ok' || data?.healthy === true;
-            return {
-                name: 'V3 Agent',
-                endpoint,
-                ok,
-                details: { health: data },
-            };
+            catch (error) {
+                if (error instanceof Error && error.message.startsWith('V3 health')) {
+                    return {
+                        name: 'V3 Agent',
+                        endpoint,
+                        ok: false,
+                        error: error.message,
+                    };
+                }
+                // Network/timeout error — try next candidate
+            }
         }
-        catch (error) {
-            return {
-                name: 'V3 Agent',
-                endpoint,
-                ok: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
+        // Last resort: probe the run endpoint with OPTIONS
+        const runUrl = this.getV3AgentRunUrl(baseUrl);
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 5000);
+            const probe = await fetch(runUrl, { method: 'OPTIONS', headers, signal: controller.signal });
+            clearTimeout(timer);
+            if (probe.ok || probe.status === 204 || probe.status === 405) {
+                return {
+                    name: 'V3 Agent',
+                    endpoint: runUrl,
+                    ok: true,
+                    details: { health: { reachable: true, method: 'OPTIONS' } },
+                };
+            }
         }
+        catch {
+            // final attempt failed
+        }
+        return {
+            name: 'V3 Agent',
+            endpoint: candidates[0],
+            ok: false,
+            error: 'No V3 agent health endpoint responded.',
+        };
     }
     async getHyperLoopHealth() {
         const endpoint = process.env.VIGTHORIA_HYPERLOOP_URL || 'http://127.0.0.1:8020/api/hyperloop/health';

package/dist/utils/logger.d.ts

@@ -1,6 +1,13 @@
 /**
  * Logger utility for Vigthoria CLI
  */
+import { type Options as OraOptions, type Ora } from 'ora';
+export type { Ora };
+/**
+ * Create an ora spinner that writes to stderr so it never
+ * pollutes stdout JSON output or triggers PowerShell error styling.
+ */
+export declare function createSpinner(textOrOpts: string | OraOptions): Ora;
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'success';
 export declare class Logger {
     private verbose;

package/dist/utils/logger.js

@@ -7,7 +7,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
+exports.createSpinner = createSpinner;
 const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+/**
+ * Create an ora spinner that writes to stderr so it never
+ * pollutes stdout JSON output or triggers PowerShell error styling.
+ */
+function createSpinner(textOrOpts) {
+    const opts = typeof textOrOpts === 'string' ? { text: textOrOpts } : textOrOpts;
+    return (0, ora_1.default)({ ...opts, stream: process.stderr });
+}
 class Logger {
     verbose = false;
     setVerbose(verbose) {

package/dist/utils/tools.d.ts

@@ -15,6 +15,7 @@
  */
 import { Logger } from './logger.js';
 export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+export type SearchStatus = 'search_matches_found' | 'search_no_matches' | 'search_failed';
 export interface ToolResult {
     success: boolean;
     output?: string;
@@ -23,6 +24,7 @@ export interface ToolResult {
     canRetry?: boolean;
     undoable?: boolean;
     metadata?: {
+        searchStatus?: SearchStatus;
         [key: string]: any;
     };
 }
@@ -145,6 +147,26 @@ export declare class AgenticTools {
      */
     private bash;
     private grep;
+    /**
+     * Windows grep: rg > Select-String > Node-native
+     */
+    private grepWindows;
+    /**
+     * Unix grep: rg > system grep (BSD/GNU)
+     */
+    private grepUnix;
+    /**
+     * Search using ripgrep (rg) — works on all platforms
+     */
+    private grepWithRg;
+    /**
+     * Search using PowerShell Select-String (Windows)
+     */
+    private grepWithSelectString;
+    /**
+     * Pure Node.js recursive file search — reliable on all platforms, no external deps
+     */
+    private grepNodeNative;
     private listDir;
     private glob;
     private git;

package/dist/utils/tools.js

@@ -995,48 +995,270 @@ class AgenticTools {
     }
     grep(args) {
         const searchPath = args.path ? this.resolvePath(args.path) : this.cwd;
-        const include = args.include || '*';
-        const os = require('os');
-        // macOS uses BSD grep which has different options than GNU grep
-        const isMac = os.platform() === 'darwin';
+        const osModule = require('os');
+        const platform = osModule.platform();
+        // If forced fallback, go directly to Node-native
+        if (args._fallback === 'node-native') {
+            return this.grepNodeNative(args, searchPath);
+        }
+        // Try external search tools first (rg > grep/Select-String), fall back to Node-native
+        if (platform === 'win32') {
+            return this.grepWindows(args, searchPath);
+        }
+        return this.grepUnix(args, searchPath, platform);
+    }
+    /**
+     * Windows grep: rg > Select-String > Node-native
+     */
+    grepWindows(args, searchPath) {
+        // 1. Try ripgrep (rg) first — best cross-platform search tool
+        try {
+            (0, child_process_1.execSync)('rg --version', { encoding: 'utf-8', timeout: 5000, stdio: 'pipe' });
+            return this.grepWithRg(args, searchPath);
+        }
+        catch { /* rg not available */ }
+        // 2. Try PowerShell Select-String
+        try {
+            return this.grepWithSelectString(args, searchPath);
+        }
+        catch { /* Select-String failed */ }
+        // 3. Fall back to Node-native recursive file scanner
+        return this.grepNodeNative(args, searchPath);
+    }
+    /**
+     * Unix grep: rg > system grep (BSD/GNU)
+     */
+    grepUnix(args, searchPath, platform) {
+        // Try ripgrep first if available
+        try {
+            (0, child_process_1.execSync)('rg --version', { encoding: 'utf-8', timeout: 5000, stdio: 'pipe' });
+            return this.grepWithRg(args, searchPath);
+        }
+        catch { /* rg not available, fall through to system grep */ }
+        const isMac = platform === 'darwin';
         let cmd;
         if (isMac) {
-            // BSD grep: use -r for recursive, -n for line numbers
-            // Note: BSD grep doesn't support --color=never, just omit it
-            if (args.include) {
-                cmd = `grep -rn --include="${args.include}" "${args.pattern}" "${searchPath}"`;
-            }
-            else {
-                cmd = `grep -rn "${args.pattern}" "${searchPath}"`;
-            }
+            cmd = args.include
+                ? `grep -rn --include="${args.include}" "${args.pattern}" "${searchPath}"`
+                : `grep -rn "${args.pattern}" "${searchPath}"`;
         }
         else {
-            // GNU grep (Linux)
-            if (args.include) {
-                cmd = `grep -rn --color=never --include="${args.include}" "${args.pattern}" "${searchPath}"`;
-            }
-            else {
-                cmd = `grep -rn --color=never "${args.pattern}" "${searchPath}"`;
+            cmd = args.include
+                ? `grep -rn --color=never --include="${args.include}" "${args.pattern}" "${searchPath}"`
+                : `grep -rn --color=never "${args.pattern}" "${searchPath}"`;
+        }
+        try {
+            const output = (0, child_process_1.execSync)(cmd, {
+                cwd: this.cwd,
+                encoding: 'utf-8',
+                maxBuffer: 5 * 1024 * 1024,
+                timeout: 30000,
+                env: { ...process.env, GREP_OPTIONS: '' },
+            });
+            return {
+                success: true,
+                output: output.trim(),
+                metadata: { searchStatus: 'search_matches_found' },
+            };
+        }
+        catch (error) {
+            // Distinguish real "no matches" (exit 1 + no stderr) from command failure
+            const stderr = (error.stderr || '').toString();
+            if (error.status === 1 && !stderr.trim()) {
+                return {
+                    success: true,
+                    output: 'No matches found',
+                    metadata: { searchStatus: 'search_no_matches' },
+                };
             }
+            // Real failure: command not found, permission denied, etc.
+            return {
+                success: false,
+                error: stderr || error.message,
+                suggestion: 'The grep command failed. Install ripgrep (rg) for best cross-platform search.',
+                canRetry: true,
+                metadata: { searchStatus: 'search_failed' },
+            };
+        }
+    }
+    /**
+     * Search using ripgrep (rg) — works on all platforms
+     */
+    grepWithRg(args, searchPath) {
+        let cmd = `rg -n --no-heading`;
+        if (args.include) {
+            cmd += ` -g "${args.include}"`;
         }
+        cmd += ` "${args.pattern}" "${searchPath}"`;
         try {
             const output = (0, child_process_1.execSync)(cmd, {
                 cwd: this.cwd,
                 encoding: 'utf-8',
                 maxBuffer: 5 * 1024 * 1024,
                 timeout: 30000,
-                env: { ...process.env, GREP_OPTIONS: '' }, // Prevent user's grep options from interfering
             });
-            return { success: true, output: output.trim() };
+            return {
+                success: true,
+                output: output.trim(),
+                metadata: { searchStatus: 'search_matches_found', backend: 'ripgrep' },
+            };
         }
         catch (error) {
-            if (error.status === 1) {
-                // No matches found
-                return { success: true, output: 'No matches found' };
+            if (error.status === 1 && !(error.stderr || '').toString().trim()) {
+                return {
+                    success: true,
+                    output: 'No matches found',
+                    metadata: { searchStatus: 'search_no_matches', backend: 'ripgrep' },
+                };
             }
-            return { success: false, error: error.message };
+            throw error; // Let caller try next backend
         }
     }
+    /**
+     * Search using PowerShell Select-String (Windows)
+     */
+    grepWithSelectString(args, searchPath) {
+        // Normalize path for PowerShell
+        const psPath = searchPath.replace(/\//g, '\\');
+        const includeFilter = args.include
+            ? `-Include "${args.include}"`
+            : `-Include *`;
+        const escapedPattern = args.pattern.replace(/'/g, "''");
+        const cmd = `powershell -NoProfile -Command "Get-ChildItem -Path '${psPath}' -Recurse -File ${includeFilter} | Select-String -Pattern '${escapedPattern}' | ForEach-Object { $_.Path + ':' + $_.LineNumber + ':' + $_.Line }"`;
+        try {
+            const output = (0, child_process_1.execSync)(cmd, {
+                cwd: this.cwd,
+                encoding: 'utf-8',
+                maxBuffer: 5 * 1024 * 1024,
+                timeout: 60000,
+            });
+            const trimmed = output.trim();
+            if (!trimmed) {
+                return {
+                    success: true,
+                    output: 'No matches found',
+                    metadata: { searchStatus: 'search_no_matches', backend: 'select-string' },
+                };
+            }
+            return {
+                success: true,
+                output: trimmed,
+                metadata: { searchStatus: 'search_matches_found', backend: 'select-string' },
+            };
+        }
+        catch (error) {
+            const stderr = (error.stderr || '').toString();
+            // Select-String returns exit code 1 for no matches when used in pipeline
+            if (error.status === 1 && !stderr.trim()) {
+                return {
+                    success: true,
+                    output: 'No matches found',
+                    metadata: { searchStatus: 'search_no_matches', backend: 'select-string' },
+                };
+            }
+            throw error; // Let caller try next backend
+        }
+    }
+    /**
+     * Pure Node.js recursive file search — reliable on all platforms, no external deps
+     */
+    grepNodeNative(args, searchPath) {
+        const { minimatch } = (() => {
+            try {
+                return require('minimatch');
+            }
+            catch {
+                return { minimatch: null };
+            }
+        })();
+        const results = [];
+        let regex;
+        try {
+            regex = new RegExp(args.pattern, 'i');
+        }
+        catch {
+            // If pattern is not valid regex, treat as literal
+            regex = new RegExp(args.pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'i');
+        }
+        const includeGlob = args.include || null;
+        const maxResults = 500;
+        const skipDirs = new Set(['node_modules', '.git', 'dist', 'build', '__pycache__', '.next', 'vendor', '.venv']);
+        const walk = (dir) => {
+            if (results.length >= maxResults)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return; // Permission denied or inaccessible
+            }
+            for (const entry of entries) {
+                if (results.length >= maxResults)
+                    break;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (!skipDirs.has(entry.name)) {
+                        walk(fullPath);
+                    }
+                    continue;
+                }
+                if (!entry.isFile())
+                    continue;
+                // Check include pattern
+                if (includeGlob) {
+                    const matches = minimatch
+                        ? minimatch(entry.name, includeGlob)
+                        : entry.name.endsWith(includeGlob.replace('*', ''));
+                    if (!matches)
+                        continue;
+                }
+                // Skip binary files by extension
+                const ext = path.extname(entry.name).toLowerCase();
+                const binaryExts = new Set(['.png', '.jpg', '.jpeg', '.gif', '.ico', '.woff', '.woff2', '.ttf', '.eot', '.zip', '.tar', '.gz', '.exe', '.dll', '.so', '.dylib', '.pdf', '.mp3', '.mp4', '.wav', '.avi', '.mov']);
+                if (binaryExts.has(ext))
+                    continue;
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf-8');
+                    const lines = content.split('\n');
+                    for (let i = 0; i < lines.length; i++) {
+                        if (regex.test(lines[i])) {
+                            const relativePath = path.relative(this.cwd, fullPath).replace(/\\/g, '/');
+                            results.push(`${relativePath}:${i + 1}:${lines[i]}`);
+                            if (results.length >= maxResults)
+                                break;
+                        }
+                    }
+                }
+                catch {
+                    // Skip files that can't be read (binary, encoding issues, etc.)
+                }
+            }
+        };
+        try {
+            walk(searchPath);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `File search failed: ${error.message}`,
+                metadata: { searchStatus: 'search_failed', backend: 'node-native' },
+            };
+        }
+        if (results.length === 0) {
+            return {
+                success: true,
+                output: 'No matches found',
+                metadata: { searchStatus: 'search_no_matches', backend: 'node-native' },
+            };
+        }
+        const truncationNote = results.length >= maxResults ? `\n...[truncated at ${maxResults} matches]` : '';
+        return {
+            success: true,
+            output: results.join('\n') + truncationNote,
+            metadata: { searchStatus: 'search_matches_found', backend: 'node-native' },
+        };
+    }
     listDir(args) {
         const dirPath = this.resolvePath(args.path);
         if (!fs.existsSync(dirPath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vigthoria-cli",
-  "version": "1.6.16",
+  "version": "1.6.18",
   "description": "Vigthoria Coder CLI - AI-powered terminal coding assistant",
   "main": "dist/index.js",
   "files": [