vibecodingmachine-core 2025.12.1-534 → 2025.12.22-2230

package/src/sync/sync-engine.js

@@ -0,0 +1,410 @@
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+const crypto = require('crypto');
+const EventEmitter = require('events');
+
+/**
+ * SyncEngine - Handles bidirectional sync between local files and AWS DynamoDB
+ * 
+ * Features:
+ * - Real-time change detection using file watchers
+ * - Conflict resolution strategies
+ * - Offline queue for disconnected state
+ * - Change history tracking
+ * - Delta sync for efficiency
+ */
+class SyncEngine extends EventEmitter {
+  constructor(options = {}) {
+    super();
+    
+    this.options = {
+      syncInterval: options.syncInterval || 30000, // 30 seconds
+      conflictStrategy: options.conflictStrategy || 'last-write-wins',
+      offlineMode: options.offlineMode || false,
+      ...options
+    };
+    
+    this.computerId = this._getComputerId();
+    this.isOnline = !this.offlineMode;
+    this.isSyncing = false;
+    this.offlineQueue = [];
+    this.lastSyncTime = null;
+    this.changeHistory = [];
+    
+    // AWS clients (will be initialized when needed)
+    this.dynamoClient = null;
+    this.apiClient = null;
+    this.wsClient = null;
+  }
+  
+  /**
+   * Get unique computer ID
+   */
+  _getComputerId() {
+    const hostname = os.hostname();
+    return hostname;
+  }
+  
+  /**
+   * Initialize AWS clients
+   */
+  async initialize() {
+    try {
+      // Initialize DynamoDB client
+      const { DynamoDBClient } = require('@aws-sdk/client-dynamodb');
+      const { DynamoDBDocumentClient } = require('@aws-sdk/lib-dynamodb');
+
+      const region = process.env.AWS_REGION || 'us-east-1';
+      const client = new DynamoDBClient({ region });
+      this.dynamoClient = DynamoDBDocumentClient.from(client);
+
+      // Initialize WebSocket client for real-time updates
+      await this._initializeWebSocket();
+
+      this.emit('initialized');
+      return true;
+    } catch (error) {
+      // If AWS SDK is not installed in this environment (common in local dev),
+      // fall back to offline mode instead of throwing so the CLI remains usable.
+      if (error && error.code === 'MODULE_NOT_FOUND' && /@aws-sdk\//.test(error.message)) {
+        this.options.offlineMode = true;
+        this.isOnline = false;
+        this.emit('warning', { type: 'offline-fallback', message: 'AWS SDK not available, running in offline mode', error });
+        this.emit('initialized');
+        return false;
+      }
+
+      this.emit('error', { type: 'initialization', error });
+      throw error;
+    }
+  }
+  
+  /**
+   * Initialize WebSocket connection for real-time updates
+   */
+  async _initializeWebSocket() {
+    // TODO: Implement WebSocket connection to AWS IoT Core or API Gateway WebSocket
+    // For now, we'll use polling
+    this.emit('websocket-status', { connected: false, reason: 'not-implemented' });
+  }
+  
+  /**
+   * Start sync engine
+   */
+  async start() {
+    if (!this.dynamoClient) {
+      await this.initialize();
+    }
+    
+    // Start periodic sync
+    this.syncInterval = setInterval(() => {
+      this.sync().catch(error => {
+        this.emit('error', { type: 'sync', error });
+      });
+    }, this.options.syncInterval);
+    
+    // Do initial sync
+    await this.sync();
+    
+    this.emit('started');
+  }
+  
+  /**
+   * Stop sync engine
+   */
+  stop() {
+    if (this.syncInterval) {
+      clearInterval(this.syncInterval);
+      this.syncInterval = null;
+    }
+    
+    this.emit('stopped');
+  }
+  
+  /**
+   * Perform sync operation
+   */
+  async sync() {
+    if (this.isSyncing) {
+      return; // Already syncing
+    }
+    
+    this.isSyncing = true;
+    this.emit('sync-start');
+    
+    try {
+      // Check if online
+      if (!this.isOnline) {
+        this.emit('sync-complete', { status: 'offline', queued: this.offlineQueue.length });
+        return;
+      }
+      
+      // Process offline queue first
+      if (this.offlineQueue.length > 0) {
+        await this._processOfflineQueue();
+      }
+      
+      // Fetch remote changes
+      const remoteChanges = await this._fetchRemoteChanges();
+      
+      // Detect local changes
+      const localChanges = await this._detectLocalChanges();
+      
+      // Resolve conflicts
+      const conflicts = this._detectConflicts(localChanges, remoteChanges);
+      if (conflicts.length > 0) {
+        await this._resolveConflicts(conflicts);
+      }
+      
+      // Apply remote changes locally
+      if (remoteChanges.length > 0) {
+        await this._applyRemoteChanges(remoteChanges);
+      }
+      
+      // Push local changes to remote
+      if (localChanges.length > 0) {
+        await this._pushLocalChanges(localChanges);
+      }
+      
+      this.lastSyncTime = Date.now();
+      this.emit('sync-complete', {
+        status: 'success',
+        remoteChanges: remoteChanges.length,
+        localChanges: localChanges.length,
+        conflicts: conflicts.length
+      });
+    } catch (error) {
+      this.emit('sync-complete', { status: 'error', error: error.message });
+      // Don't throw - just emit error event
+      this.emit('error', { type: 'sync', error: error.message });
+    } finally {
+      this.isSyncing = false;
+    }
+  }
+  
+  /**
+   * Fetch remote changes from DynamoDB
+   */
+  async _fetchRemoteChanges() {
+    if (!this.dynamoClient) {
+      this.emit('warning', { type: 'no-dynamo', message: 'DynamoDB client not initialized, skipping remote fetch' });
+      return [];
+    }
+
+    const { ScanCommand } = require('@aws-sdk/lib-dynamodb');
+
+    const tableName = process.env.DYNAMODB_TABLE_NAME || 'vibecodingmachine-requirements';
+    const lastSync = this.lastSyncTime || 0;
+
+    try {
+      // Use Scan with filter instead of Query since we need to check all items
+      // In production, consider using DynamoDB Streams for real-time updates
+      const command = new ScanCommand({
+        TableName: tableName,
+        FilterExpression: '#ts > :lastSync',
+        ExpressionAttributeNames: {
+          '#ts': 'timestamp'
+        },
+        ExpressionAttributeValues: {
+          ':lastSync': lastSync
+        }
+      });
+
+      const response = await this.dynamoClient.send(command);
+      return response.Items || [];
+    } catch (error) {
+      this.emit('error', { type: 'fetch-remote', error });
+      return [];
+    }
+  }
+  
+  /**
+   * Detect local changes
+   */
+  async _detectLocalChanges() {
+    // TODO: Implement file watching and change detection
+    // For now, return empty array
+    return [];
+  }
+  
+  /**
+   * Detect conflicts between local and remote changes
+   */
+  _detectConflicts(localChanges, remoteChanges) {
+    const conflicts = [];
+    
+    for (const local of localChanges) {
+      for (const remote of remoteChanges) {
+        if (local.requirementId === remote.requirementId) {
+          // Same requirement modified both locally and remotely
+          if (local.timestamp !== remote.timestamp) {
+            conflicts.push({ local, remote });
+          }
+        }
+      }
+    }
+    
+    return conflicts;
+  }
+  
+  /**
+   * Resolve conflicts based on strategy
+   */
+  async _resolveConflicts(conflicts) {
+    for (const conflict of conflicts) {
+      this.emit('conflict', conflict);
+      
+      let resolution;
+      switch (this.options.conflictStrategy) {
+        case 'last-write-wins':
+          resolution = conflict.local.timestamp > conflict.remote.timestamp
+            ? conflict.local
+            : conflict.remote;
+          break;
+          
+        case 'manual':
+          // Emit event for manual resolution
+          resolution = await new Promise((resolve) => {
+            this.once('conflict-resolved', resolve);
+          });
+          break;
+          
+        case 'auto-merge':
+          resolution = this._autoMerge(conflict.local, conflict.remote);
+          break;
+          
+        default:
+          resolution = conflict.remote; // Default to remote
+      }
+      
+      // Log conflict resolution
+      this.changeHistory.push({
+        type: 'conflict-resolution',
+        timestamp: Date.now(),
+        conflict,
+        resolution
+      });
+    }
+  }
+  
+  /**
+   * Auto-merge non-overlapping changes
+   */
+  _autoMerge(local, remote) {
+    // Simple merge: combine changes from both
+    return {
+      ...remote,
+      ...local,
+      timestamp: Math.max(local.timestamp, remote.timestamp)
+    };
+  }
+  
+  /**
+   * Apply remote changes locally
+   */
+  async _applyRemoteChanges(changes) {
+    for (const change of changes) {
+      try {
+        // TODO: Apply change to local requirements file
+        this.emit('remote-change-applied', change);
+      } catch (error) {
+        this.emit('error', { type: 'apply-remote', change, error });
+      }
+    }
+  }
+  
+  /**
+   * Push local changes to remote
+   */
+  async _pushLocalChanges(changes) {
+    if (!this.dynamoClient) {
+      this.emit('warning', { type: 'no-dynamo', message: 'DynamoDB client not initialized, queuing local changes' });
+      // Queue all changes for later push
+      this.offlineQueue.push(...changes);
+      return;
+    }
+
+    const { PutCommand } = require('@aws-sdk/lib-dynamodb');
+
+    const tableName = process.env.DYNAMODB_TABLE_NAME || 'vibecodingmachine-requirements';
+
+    for (const change of changes) {
+      try {
+        const command = new PutCommand({
+          TableName: tableName,
+          Item: {
+            computerId: this.computerId,
+            timestamp: Date.now(),
+            ...change
+          }
+        });
+
+        await this.dynamoClient.send(command);
+        this.emit('local-change-pushed', change);
+      } catch (error) {
+        this.emit('error', { type: 'push-local', change, error });
+
+        // Add to offline queue if push fails
+        if (!this.isOnline) {
+          this.offlineQueue.push(change);
+        }
+      }
+    }
+  }
+  
+  /**
+   * Process offline queue
+   */
+  async _processOfflineQueue() {
+    const queue = [...this.offlineQueue];
+    this.offlineQueue = [];
+    
+    for (const change of queue) {
+      try {
+        await this._pushLocalChanges([change]);
+      } catch (error) {
+        // Re-add to queue if still failing
+        this.offlineQueue.push(change);
+      }
+    }
+  }
+  
+  /**
+   * Get sync status
+   */
+  getStatus() {
+    return {
+      computerId: this.computerId,
+      isOnline: this.isOnline,
+      isSyncing: this.isSyncing,
+      lastSyncTime: this.lastSyncTime,
+      queuedChanges: this.offlineQueue.length,
+      conflictStrategy: this.options.conflictStrategy
+    };
+  }
+  
+  /**
+   * Get change history
+   */
+  getHistory(limit = 100) {
+    return this.changeHistory.slice(-limit);
+  }
+  
+  /**
+   * Set online/offline mode
+   */
+  setOnlineMode(isOnline) {
+    this.isOnline = isOnline;
+    this.emit('online-status-changed', { isOnline });
+    
+    if (isOnline && this.offlineQueue.length > 0) {
+      // Trigger sync to process offline queue
+      this.sync().catch(error => {
+        this.emit('error', { type: 'sync', error });
+      });
+    }
+  }
+}
+
+module.exports = SyncEngine;

package/src/utils/download-with-progress.js

@@ -0,0 +1,92 @@
+const fs = require('fs');
+const { pipeline } = require('stream');
+const { promisify } = require('util');
+const streamPipeline = promisify(pipeline);
+const ora = require('ora');
+
+function progressBar(percent, width) {
+  const fill = Math.round((percent / 100) * width);
+  return '█'.repeat(fill) + '-'.repeat(Math.max(0, width - fill));
+}
+
+function formatEta(sec) {
+  if (!isFinite(sec) || sec === null) return '--:--';
+  const s = Math.max(0, Math.round(sec));
+  const m = Math.floor(s / 60);
+  const ss = s % 60;
+  return `${m}:${ss.toString().padStart(2, '0')}`;
+}
+
+async function downloadWithProgress(url, dest, opts = {}) {
+  const fetch = require('node-fetch');
+  const spinner = opts.spinner || ora();
+  const label = opts.label || 'Downloading...';
+  const onProgress = typeof opts.onProgress === 'function' ? opts.onProgress : null;
+
+  spinner.start(label);
+
+  const res = await fetch(url);
+  if (!res.ok) {
+    spinner.fail(`Download failed: ${res.status} ${res.statusText}`);
+    throw new Error(`Failed to download ${url}: ${res.status}`);
+  }
+  // Stop the spinner so progress prints are not overwritten
+  try { spinner.stop(); } catch (e) {}
+  try { process.stdout.write('\r\x1b[2KDownloading: 0.0 MB'); } catch (e) {}
+
+  const total = Number(res.headers.get('content-length')) || 0;
+  const fileStream = fs.createWriteStream(dest);
+
+  return await new Promise((resolve, reject) => {
+    let downloaded = 0;
+    const start = Date.now();
+    let lastPercent = -1;
+
+    res.body.on('data', (chunk) => {
+      downloaded += chunk.length;
+      if (total) {
+        const percent = Math.round((downloaded / total) * 100);
+        if (percent !== lastPercent) {
+          lastPercent = percent;
+          const mbDownloaded = (downloaded / (1024 * 1024)).toFixed(1);
+          const mbTotal = (total / (1024 * 1024)).toFixed(1);
+          const elapsed = Math.max(0.001, (Date.now() - start) / 1000);
+          const speed = downloaded / elapsed; // bytes/sec
+          const etaSec = (total - downloaded) / (speed || 1);
+          const eta = formatEta(etaSec);
+          const bar = progressBar(percent, 30);
+          // CLI/UI progress
+          if (onProgress) {
+            onProgress({ percent, downloaded, total, mbDownloaded, mbTotal, eta, bar });
+          } else {
+            process.stdout.write(`\r\x1b[2K[${bar}] ${percent}% ${mbDownloaded}MB / ${mbTotal}MB ETA: ${eta}`);
+          }
+        }
+      } else {
+        const mbDownloaded = (downloaded / (1024 * 1024)).toFixed(1);
+        if (onProgress) onProgress({ percent: null, downloaded, total, mbDownloaded });
+        else process.stdout.write(`\r\x1b[2K${label} ${mbDownloaded} MB`);
+      }
+    });
+
+    res.body.on('error', (err) => {
+      spinner.fail('Download error');
+      reject(err);
+    });
+
+    fileStream.on('error', (err) => {
+      spinner.fail('File write error');
+      reject(err);
+    });
+
+    fileStream.on('finish', () => {
+      process.stdout.write('\n');
+      spinner.succeed('Download complete');
+      resolve();
+    });
+
+    res.body.pipe(fileStream);
+  });
+}
+
+module.exports = { downloadWithProgress };

package/src/utils/electron-update-checker.js

@@ -39,12 +39,19 @@ function formatVersionTimestamp(versionString, date) {
   }
 }
 
+const { shouldCheckUpdates } = require('./env-helpers');
+
 /**
  * Check for Electron app updates from S3 version manifest
  * @param {string} currentVersion - Current version (e.g., '2025.11.26-0519')
  * @returns {Promise<Object>} Update info or null if no update available
  */
 async function checkForElectronUpdates(currentVersion) {
+  if (!shouldCheckUpdates()) {
+    console.log('ℹ️ [UPDATE CHECK] Skipped in development environment');
+    return { hasUpdate: false, currentVersion };
+  }
+
   return new Promise((resolve, reject) => {
     const manifestUrl = `https://d3fh7zgi8horze.cloudfront.net/downloads/version.json?t=${Date.now()}`;
     console.log(`🔍 [UPDATE CHECK] Current version: ${currentVersion}`);

package/src/utils/env-helpers.js

@@ -0,0 +1,54 @@
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * Check if running in development environment
+ * @returns {boolean} True if in development
+ */
+function isDevelopment() {
+    // Check standard environment variables
+    if (process.env.NODE_ENV === 'development' ||
+        process.env.VIBECODINGMACHINE_ENV === 'development' ||
+        process.env.ELECTRON_IS_DEV === '1') {
+        return true;
+    }
+
+    // Check for --dev flag in arguments
+    if (process.argv.includes('--dev')) {
+        return true;
+    }
+
+    // Heuristics for local development
+    // 1. Check if we are in a git repository that looks like the source code
+    // Root of the monorepo usually has 'packages' directory and 'lerna.json' or 'pnpm-workspace.yaml'
+    // But this might be too aggressive if user installs via git clone.
+
+    // 2. Check if electron is running from default app (not packaged)
+    if (process.versions && process.versions.electron) {
+        const electron = require('electron');
+        if (electron.app && !electron.app.isPackaged) {
+            return true;
+        }
+    }
+
+    return false;
+}
+
+/**
+ * Check if we should perform update checks
+ * @returns {boolean} True if update checks are allowed
+ */
+function shouldCheckUpdates() {
+    // Don't check updates in development unless explicitly forced (not implemented yet)
+    if (isDevelopment()) {
+        return false;
+    }
+
+    // Can add more logic here (e.g. disable updates via config)
+    return true;
+}
+
+module.exports = {
+    isDevelopment,
+    shouldCheckUpdates
+};