vigthoria-cli 1.6.17 → 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.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");
@@ -543,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: {
@@ -612,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 {
@@ -663,7 +663,7 @@ class ChatCommand {
     async runSimplePrompt(prompt) {
         this.lastActionableUserInput = prompt;
         this.messages.push({ role: 'user', content: this.buildExecutionPrompt(prompt) });
-        const spinner = this.jsonOutput ? null : (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);
             if (spinner)
@@ -722,7 +722,7 @@ class ChatCommand {
         this.saveSession();
         const maxTurns = 10;
         for (let turn = 0; turn < maxTurns; turn += 1) {
-            const spinner = this.jsonOutput ? null : (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);
                 if (spinner)
@@ -935,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();

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/package.json

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