vibecodingmachine-core 2025.12.25-25 → 2026.1.22-1441

package/src/ide-integration/quota-detector.cjs

@@ -1,33 +1,356 @@
-// @vibecodingmachine/core - Quota Detector (CommonJS) - Stub
+// @vibecodingmachine/core - Quota Detector (CommonJS)
 // Handles quota detection for different IDEs using CDP and AppleScript
 
+const CDP = require('chrome-remote-interface');
+const { AppleScriptManager } = require('./applescript-manager.cjs');
+
+/**
+ * Quota Detector for IDE interactions
+ * Detects quota warnings in different IDEs using CDP and AppleScript
+ */
 class QuotaDetector {
   constructor() {
     this.logger = console;
+    this.appleScriptManager = new AppleScriptManager();
+  }
+
+  /**
+   * Timeout utility function
+   * @param {number} ms - Timeout in milliseconds
+   * @param {Promise} promise - Promise to timeout
+   * @returns {Promise} Promise with timeout
+   */
+  timeout(ms, promise) {
+    return Promise.race([
+      promise,
+      new Promise((_, reject) =>
+        setTimeout(() => reject(new Error(`Operation timed out after ${ms}ms`)), ms)
+      )
+    ]);
   }
 
+  /**
+   * Detect quota warnings in an IDE
+   * @param {string} ide - The IDE name ('vscode', 'cursor', 'windsurf')
+   * @returns {Promise<Object>} Quota detection result
+   */
   async detectQuotaWarning(ide = 'vscode') {
-    this.logger.log(`🔍 Quota detection stub for ${ide}`);
-    return {
-      hasQuotaWarning: false,
-      method: 'stub',
-      note: 'Quota detection not implemented in stub'
-    };
+    this.logger.log(`🔍 Starting quota detection for ${ide}...`);
+
+    // Determine the port based on the IDE
+    const port = ide === 'windsurf' ? 9224 : ide === 'cursor' ? 9225 : 9222;
+    const ideName = ide === 'windsurf' ? 'Windsurf' : ide === 'cursor' ? 'Cursor' : 'VS Code';
+
+    this.logger.log(`🔌 Checking ${ideName} on port ${port}...`);
+
+    // For Windsurf, use AppleScript detection since CDP is not supported
+    if (ide === 'windsurf') {
+      this.logger.log('🔍 Windsurf detected - using AppleScript quota detection');
+      return await this.appleScriptManager.detectQuotaWarning(ide);
+    }
+
+    // For VS Code and Cursor, use CDP detection
+    try {
+      this.logger.log(`🔍 Attempting CDP connection to ${ideName} on port ${port}...`);
+
+      // Try to connect to CDP
+      const targets = await this.timeout(5000, CDP.List({ port }));
+
+      if (!targets || targets.length === 0) {
+        this.logger.log(`❌ No CDP targets found on port ${port}`);
+
+        // For Windsurf, fall back to AppleScript
+        if (ide === 'windsurf') {
+          this.logger.log('🔍 Falling back to enhanced AppleScript quota detection...');
+          return await this.appleScriptManager.detectQuotaWarning(ide);
+        }
+
+        return {
+          hasQuotaWarning: false,
+          error: `Could not find ${ideName}. Make sure ${ideName} is running with --remote-debugging-port=${port}`,
+          note: 'CDP connection failed'
+        };
+      }
+
+      this.logger.log(`✅ Found ${targets.length} CDP targets`);
+
+      // For Cursor, prefer the workspace target over settings
+      let workbench;
+      if (ide === 'cursor') {
+        workbench = targets.find(t => t.title !== 'Cursor Settings' && t.type === 'page') ||
+                    targets.find(t => t.url && t.url.includes('workbench')) ||
+                    targets[0];
+      } else {
+        workbench = targets.find(t => t.url && t.url.includes('workbench')) || targets[0];
+      }
+
+      if (!workbench) {
+        this.logger.log(`❌ No suitable workbench target found`);
+        return {
+          hasQuotaWarning: false,
+          error: `No ${ideName} workbench target found.`,
+          note: 'No workbench target available'
+        };
+      }
+
+      this.logger.log(`✅ Selected workbench: ${workbench.title}`);
+
+      // Connect to CDP
+      const client = await this.timeout(10000, CDP({ port, target: workbench }));
+      const { Runtime, Page } = client;
+
+      await this.timeout(5000, Runtime.enable());
+      if (Page && Page.bringToFront) {
+        try {
+          await this.timeout(3000, Page.bringToFront());
+        } catch (error) {
+          this.logger.log(`⚠️ Bring to front failed: ${error.message}`);
+        }
+      }
+
+      // Execute JavaScript to detect quota warnings
+      const detectionScript = `
+        (() => {
+          console.log('🔍 Starting quota detection in ${ideName}...');
+
+          // Common quota warning patterns
+          const quotaPatterns = [
+            'not enough credits',
+            'upgrade to a paid plan',
+            'switch to swe-1-lite',
+            'quota exceeded',
+            'credits exhausted',
+            'payment required',
+            'out of credits',
+            'insufficient credits',
+            'billing required',
+            'subscription needed',
+            'monthly chat messages quota',
+            'upgrade to copilot pro',
+            'allowance to renew',
+            'reached your monthly',
+            'wait for your allowance'
+          ];
+
+          // Function to check if text contains quota warnings
+          function containsQuotaWarning(text) {
+            if (!text) return false;
+            const lowerText = text.toLowerCase();
+            return quotaPatterns.some(pattern => lowerText.includes(pattern));
+          }
+
+          // Method 1: Check all text content in the document
+          const allText = document.body.innerText || document.body.textContent || '';
+          if (containsQuotaWarning(allText)) {
+            console.log('❌ Quota warning detected in document text');
+            return {
+              hasQuotaWarning: true,
+              method: 'document-text',
+              matchedText: allText.substring(0, 200) + '...'
+            };
+          }
+
+          // Method 2: Check specific elements that might contain quota warnings
+          const quotaElements = [
+            // VS Code specific selectors
+            '.monaco-workbench .part.auxiliarybar',
+            '.monaco-workbench .part.sidebar.right',
+            '.monaco-workbench .chat-view',
+            '.monaco-workbench .chat-input',
+
+            // Cursor specific selectors
+            '.aislash-editor-input',
+            '.aislash-chat-container',
+            '.aislash-panel',
+
+            // Generic selectors
+            '[data-testid*="chat"]',
+            '[aria-label*="chat"]',
+            '[class*="chat"]',
+            '[class*="quota"]',
+            '[class*="credits"]',
+            '[class*="billing"]'
+          ];
+
+          for (const selector of quotaElements) {
+            const elements = document.querySelectorAll(selector);
+            for (const element of elements) {
+              const elementText = element.innerText || element.textContent || '';
+              if (containsQuotaWarning(elementText)) {
+                console.log('❌ Quota warning detected in element:', selector);
+                return {
+                  hasQuotaWarning: true,
+                  method: 'element-specific',
+                  selector: selector,
+                  matchedText: elementText.substring(0, 200) + '...'
+                };
+              }
+            }
+          }
+
+          // Method 3: Check for disabled input fields (common when quota is exceeded)
+          const disabledInputs = document.querySelectorAll('input[disabled], textarea[disabled], [contenteditable="true"][aria-disabled="true"]');
+          if (disabledInputs.length > 0) {
+            console.log('⚠️ Found disabled input fields, checking for quota context...');
+
+            // Check if there are quota-related messages near disabled inputs
+            for (const input of disabledInputs) {
+              const parentText = input.parentElement?.innerText || '';
+              if (containsQuotaWarning(parentText)) {
+                console.log('❌ Quota warning detected near disabled input');
+                return {
+                  hasQuotaWarning: true,
+                  method: 'disabled-input-context',
+                  matchedText: parentText.substring(0, 200) + '...'
+                };
+              }
+            }
+          }
+
+          // Method 4: Check for specific UI elements that indicate quota issues
+          const quotaButtons = document.querySelectorAll('button, a, [role="button"]');
+          for (const button of quotaButtons) {
+            const buttonText = button.innerText || button.textContent || '';
+            if (containsQuotaWarning(buttonText)) {
+              console.log('❌ Quota warning detected in button:', buttonText);
+              return {
+                hasQuotaWarning: true,
+                method: 'button-text',
+                matchedText: buttonText
+              };
+            }
+          }
+
+          // Method 5: Check for error messages or notifications
+          const errorElements = document.querySelectorAll('[class*="error"], [class*="warning"], [class*="notification"], [role="alert"]');
+          for (const error of errorElements) {
+            const errorText = error.innerText || error.textContent || '';
+            if (containsQuotaWarning(errorText)) {
+              console.log('❌ Quota warning detected in error element');
+              return {
+                hasQuotaWarning: true,
+                method: 'error-element',
+                matchedText: errorText.substring(0, 200) + '...'
+              };
+            }
+          }
+
+          console.log('✅ No quota warnings detected');
+          return {
+            hasQuotaWarning: false,
+            method: 'cdp-comprehensive',
+            note: 'No quota warnings found in ${ideName}'
+          };
+        })()
+      `;
+
+      const { result } = await this.timeout(10000, Runtime.evaluate({
+        expression: detectionScript,
+        returnByValue: true
+      }));
+
+      const detectionResult = result.value || result.unserializableValue;
+
+      this.logger.log('🔍 CDP quota detection result:', detectionResult);
+
+      if (detectionResult && detectionResult.hasQuotaWarning) {
+        this.logger.log('❌ Quota warning detected via CDP');
+        return {
+          hasQuotaWarning: true,
+          method: detectionResult.method,
+          matchedText: detectionResult.matchedText || 'Quota warning detected via CDP',
+          note: detectionResult.matchedText || 'Quota warning detected via CDP',
+          debug: detectionResult
+        };
+      }
+
+      this.logger.log('✅ No quota warnings detected via CDP');
+      return {
+        hasQuotaWarning: false,
+        method: 'cdp-comprehensive',
+        note: 'No quota warnings found in ' + ideName,
+        debug: detectionResult
+      };
+
+    } catch (error) {
+      this.logger.log(`❌ CDP quota detection failed: ${error.message}`);
+
+      // For Windsurf, fall back to AppleScript
+      if (ide === 'windsurf') {
+        this.logger.log('🔍 Falling back to AppleScript quota detection...');
+        return await this.appleScriptManager.detectQuotaWarning(ide);
+      }
+
+      return {
+        hasQuotaWarning: false,
+        error: error.message,
+        note: `CDP quota detection failed for ${ideName}`
+      };
+    }
   }
 
+  /**
+   * Get available IDEs without quota warnings
+   * @param {Array<string>} ides - Array of IDE names to check
+   * @returns {Promise<Array<string>>} Array of available IDE names
+   */
   async getAvailableIdes(ides = ['vscode', 'cursor', 'windsurf']) {
-    this.logger.log('🔍 Available IDEs stub');
-    return ides;
+    this.logger.log('🔍 Checking available IDEs without quota warnings...');
+
+    const availableIdes = [];
+
+    for (const ide of ides) {
+      try {
+        const quotaResult = await this.detectQuotaWarning(ide);
+
+        if (!quotaResult.hasQuotaWarning) {
+          availableIdes.push(ide);
+          this.logger.log(`✅ ${ide} is available (no quota warnings)`);
+        } else {
+          this.logger.log(`❌ ${ide} has quota warnings: ${quotaResult.note || 'Unknown quota issue'}`);
+        }
+      } catch (error) {
+        this.logger.log(`⚠️ Error checking ${ide}: ${error.message}`);
+        // If we can't check quota, assume the IDE is available
+        availableIdes.push(ide);
+      }
+    }
+
+    this.logger.log(`📋 Available IDEs: ${availableIdes.join(', ')}`);
+    return availableIdes;
   }
 
+  /**
+   * Test quota detection with a test message
+   * @param {string} ide - The IDE name to test
+   * @returns {Promise<Object>} Test result
+   */
   async testQuotaDetection(ide) {
-    this.logger.log(`🧪 Quota detection test stub for ${ide}`);
-    return {
-      ide,
-      success: true,
-      hasQuotaWarning: false,
-      method: 'stub'
-    };
+    this.logger.log(`🧪 Testing quota detection for ${ide}...`);
+
+    try {
+      const quotaResult = await this.detectQuotaWarning(ide);
+
+      this.logger.log(`🧪 Quota detection test result for ${ide}:`, quotaResult);
+
+      return {
+        ide,
+        success: true,
+        hasQuotaWarning: quotaResult.hasQuotaWarning,
+        method: quotaResult.method,
+        note: quotaResult.note,
+        debug: quotaResult
+      };
+    } catch (error) {
+      this.logger.log(`❌ Quota detection test failed for ${ide}: ${error.message}`);
+
+      return {
+        ide,
+        success: false,
+        error: error.message,
+        note: `Quota detection test failed for ${ide}`
+      };
+    }
   }
 }
 

package/src/ide-integration/quota-detector.js

@@ -124,7 +124,12 @@ export class QuotaDetector {
             'out of credits',
             'insufficient credits',
             'billing required',
-            'subscription needed'
+            'subscription needed',
+            'monthly chat messages quota',
+            'upgrade to copilot pro',
+            'allowance to renew',
+            'reached your monthly',
+            'wait for your allowance'
           ];
 
           // Function to check if text contains quota warnings

package/src/index.cjs

@@ -20,10 +20,26 @@ const auditLogger = require('./utils/audit-logger.cjs');
 const { GCloudAuth } = require('./utils/gcloud-auth.cjs');
 const requirementHelpers = require('./utils/requirement-helpers.js');
 const requirementsParser = require('./utils/requirements-parser.js');
+const requirementNumbering = require('./requirement-numbering.js');
+const gitBranchManager = require('./utils/git-branch-manager.js');
 const updateChecker = require('./utils/update-checker.js');
 const electronUpdateChecker = require('./utils/electron-update-checker.js');
+const { errorReporter, ErrorReporter } = require('./utils/error-reporter.js');
 const localization = require('./localization/index.js');
 
+// Health Tracking (Foundational)
+const { ValidationError, FileSystemError } = require('./health-tracking/errors.js');
+const { JSONStorage, DEFAULT_STORAGE_FILE, DEFAULT_HEALTH_DATA } = require('./health-tracking/json-storage.js');
+const { StorageInterface } = require('./health-tracking/storage-interface.js');
+const validators = require('./health-tracking/validators.js');
+
+// Health Tracking (User Story 1)
+const { InteractionRecorder, MAX_INTERACTIONS, DEFAULT_IDE_RECORD } = require('./health-tracking/interaction-recorder.js');
+const { IDEHealthTracker, MAX_RESPONSE_TIMES, CONSECUTIVE_FAILURE_THRESHOLD } = require('./health-tracking/ide-health-tracker.js');
+
+// Health Tracking (User Story 2)
+const { HealthReporter } = require('./health-tracking/health-reporter.js');
+
 module.exports = {
   CDPManager,
   AppleScriptManager,
@@ -45,7 +61,26 @@ module.exports = {
   ...auditLogger,
   ...requirementHelpers,
   ...requirementsParser,
+  ...requirementNumbering,
+  ...gitBranchManager,
   ...updateChecker,
   ...electronUpdateChecker,
-  ...localization
+  errorReporter,
+  ErrorReporter,
+  ...localization,
+  // Health Tracking
+  ValidationError,
+  FileSystemError,
+  JSONStorage,
+  DEFAULT_STORAGE_FILE,
+  DEFAULT_HEALTH_DATA,
+  StorageInterface,
+  ...validators,
+  InteractionRecorder,
+  MAX_INTERACTIONS,
+  DEFAULT_IDE_RECORD,
+  IDEHealthTracker,
+  MAX_RESPONSE_TIMES,
+  CONSECUTIVE_FAILURE_THRESHOLD,
+  HealthReporter
 };

package/src/index.js

@@ -12,6 +12,7 @@ export * from './utils/repo-helpers.js';
 export * from './utils/config-helpers.js';
 export * from './utils/requirement-helpers.js';
 export * from './utils/requirements-parser.js';
+export * from './requirement-numbering.js';
 
 // Compliance
 const CompliancePrompt = require('./compliance/compliance-prompt.js');
@@ -24,3 +25,22 @@ export { ChatInterface } from './ui/ChatInterface.js';
 
 // Localization
 export * from './localization/index.js';
+
+// Error Reporting
+export * from './utils/error-reporter.js';
+
+// Admin Utilities
+export * from './utils/admin-utils.js';
+
+// Health Tracking (Foundational)
+export { ValidationError, FileSystemError } from './health-tracking/errors.js';
+export { JSONStorage, DEFAULT_STORAGE_FILE, DEFAULT_HEALTH_DATA } from './health-tracking/json-storage.js';
+export { StorageInterface } from './health-tracking/storage-interface.js';
+export * from './health-tracking/validators.js';
+
+// Health Tracking (User Story 1)
+export { InteractionRecorder, MAX_INTERACTIONS, DEFAULT_IDE_RECORD } from './health-tracking/interaction-recorder.js';
+export { IDEHealthTracker, MAX_RESPONSE_TIMES, CONSECUTIVE_FAILURE_THRESHOLD } from './health-tracking/ide-health-tracker.js';
+
+// Health Tracking (User Story 2)
+export { HealthReporter } from './health-tracking/health-reporter.js';

package/src/localization/translations/en.js

@@ -303,6 +303,18 @@ module.exports = {
   'interactive.sync.now': 'Sync Now',
   'interactive.logout': 'Logout',
   'interactive.exit': 'Exit',
+  'interactive.feedback': 'Feedback',
+  'interactive.feedback.title': 'Vibe Coding Machine Feedback',
+  'interactive.feedback.instructions': 'Your feedback helps us make Vibe Coding Machine better! Please let us know what you think.',
+  'interactive.feedback.email': 'Email (optional):',
+  'interactive.feedback.comment': 'Comment:',
+  'interactive.feedback.comment.instructions': 'Enter your comments below (press Enter twice on an empty line to finish):',
+  'interactive.feedback.comment.required': 'Comment is required',
+  'interactive.feedback.submitting': 'Submitting feedback',
+  'interactive.feedback.success': 'Feedback submitted successfully!',
+  'interactive.feedback.error': 'Failed to submit feedback',
+  'interactive.feedback.error.network': 'Network error - please check your internet connection or try again later.',
+  'interactive.feedback.cancelled': 'Feedback cancelled',
   'interactive.initialize': 'Initialize repository (.vibecodingmachine)',
   'interactive.goodbye': 'Goodbye! Be dreaming about what requirements to add!',
   'interactive.confirm.exit': 'Are you sure you want to exit? (x/y/N)',
@@ -323,7 +335,7 @@ module.exports = {
   'provider.available': 'Available',
   'provider.resets.in': 'Resets in',
   'provider.rate.limit.resets': 'Rate limit resets in',
-  'provider.instructions': '↑/↓ move selection    j/k reorder    e enable    d disable    Space toggle    Enter save/select    Esc cancel',
+  'provider.instructions': '↑/↓ move selection    j/k reorder    e enable    d disable    i install    Space toggle    Enter save/select    Esc cancel',
   'provider.status.available': 'Available',
   'provider.status.quota.infinite': 'Quota: Infinite',
   'provider.status.available.resets': 'available • resets in',
@@ -344,6 +356,8 @@ module.exports = {
 
   // System Information
   'system.repo': 'Repo:',
+  'system.git.branch': 'Branch:',
+  'system.git.status.dirty': '(modified)',
   'system.computer.name': 'Computer Name:',
 
   // Configuration Dialogs

package/src/localization/translations/es.js

@@ -303,6 +303,18 @@ module.exports = {
   'interactive.sync.now': 'Sincronizar Ahora',
   'interactive.logout': 'Cerrar Sesión',
   'interactive.exit': 'Salir',
+  'interactive.feedback': 'Comentarios',
+  'interactive.feedback.title': 'Comentarios de Vibe Coding Machine',
+  'interactive.feedback.instructions': '¡Tus comentarios nos ayudan a mejorar Vibe Coding Machine! Por favor, dinos qué piensas.',
+  'interactive.feedback.email': 'Correo electrónico (opcional):',
+  'interactive.feedback.comment': 'Comentario:',
+  'interactive.feedback.comment.instructions': 'Ingresa tus comentarios a continuación (presiona Enter dos veces en una línea vacía para terminar):',
+  'interactive.feedback.comment.required': 'El comentario es obligatorio',
+  'interactive.feedback.submitting': 'Enviando comentarios',
+  'interactive.feedback.success': '¡Comentarios enviados con éxito!',
+  'interactive.feedback.error': 'No se pudieron enviar los comentarios',
+  'interactive.feedback.error.network': 'Error de red: por favor, verifica tu conexión a internet o inténtalo de nuevo más tarde.',
+  'interactive.feedback.cancelled': 'Comentarios cancelados',
   'interactive.initialize': 'Inicializar repositorio (.vibecodingmachine)',
   'interactive.goodbye': '¡Adiós! ¡Sigue soñando sobre qué requisitos agregar!',
   'interactive.confirm.exit': '¿Estás seguro de que quieres salir? (x/y/N)',
@@ -344,6 +356,8 @@ module.exports = {
 
   // System Information
   'system.repo': 'Repositorio:',
+  'system.git.branch': 'Rama:',
+  'system.git.status.dirty': '(modificado)',
   'system.computer.name': 'Nombre de Computadora:',
 
   // Configuration Dialogs