@nclamvn/vibecode-cli 2.2.1 → 3.0.0

package/src/utils/history.js

@@ -0,0 +1,357 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - History & Favorites Utility
+// Phase M8: Command history and favorite prompts management
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Configuration
+// ─────────────────────────────────────────────────────────────────────────────
+
+const HISTORY_DIR = path.join(os.homedir(), '.vibecode');
+const HISTORY_FILE = path.join(HISTORY_DIR, 'history.json');
+const FAVORITES_FILE = path.join(HISTORY_DIR, 'favorites.json');
+const MAX_HISTORY = 100;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// History Functions
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Add a command to history
+ * @param {string} command - The command that was run
+ * @param {string} description - Description of the command
+ * @param {Object} metadata - Additional metadata
+ */
+export async function addToHistory(command, description = '', metadata = {}) {
+  const history = await loadHistory();
+
+  history.unshift({
+    id: Date.now(),
+    command,
+    description,
+    timestamp: new Date().toISOString(),
+    cwd: process.cwd(),
+    ...metadata
+  });
+
+  // Keep only last MAX_HISTORY items
+  if (history.length > MAX_HISTORY) {
+    history.length = MAX_HISTORY;
+  }
+
+  await saveHistory(history);
+}
+
+/**
+ * Load history from disk
+ * @returns {Promise<Array>} History array
+ */
+export async function loadHistory() {
+  try {
+    await fs.mkdir(HISTORY_DIR, { recursive: true });
+    const content = await fs.readFile(HISTORY_FILE, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Save history to disk
+ * @param {Array} history - History array to save
+ */
+export async function saveHistory(history) {
+  await fs.mkdir(HISTORY_DIR, { recursive: true });
+  await fs.writeFile(HISTORY_FILE, JSON.stringify(history, null, 2));
+}
+
+/**
+ * Clear all history
+ */
+export async function clearHistory() {
+  await saveHistory([]);
+}
+
+/**
+ * Search history by query
+ * @param {string} query - Search query
+ * @returns {Promise<Array>} Matching history items
+ */
+export async function searchHistory(query) {
+  const history = await loadHistory();
+  const q = query.toLowerCase();
+
+  return history.filter(item =>
+    item.command.toLowerCase().includes(q) ||
+    (item.description && item.description.toLowerCase().includes(q))
+  );
+}
+
+/**
+ * Get history item by index (1-based)
+ * @param {number} index - Item index (1-based)
+ * @returns {Promise<Object|null>} History item or null
+ */
+export async function getHistoryItem(index) {
+  const history = await loadHistory();
+  return history[index - 1] || null;
+}
+
+/**
+ * Get history stats
+ * @returns {Promise<Object>} History statistics
+ */
+export async function getHistoryStats() {
+  const history = await loadHistory();
+
+  if (history.length === 0) {
+    return { total: 0, oldest: null, newest: null };
+  }
+
+  return {
+    total: history.length,
+    oldest: history[history.length - 1]?.timestamp,
+    newest: history[0]?.timestamp
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Favorites Functions
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Load favorites from disk
+ * @returns {Promise<Array>} Favorites array
+ */
+export async function loadFavorites() {
+  try {
+    await fs.mkdir(HISTORY_DIR, { recursive: true });
+    const content = await fs.readFile(FAVORITES_FILE, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Save favorites to disk
+ * @param {Array} favorites - Favorites array to save
+ */
+export async function saveFavorites(favorites) {
+  await fs.mkdir(HISTORY_DIR, { recursive: true });
+  await fs.writeFile(FAVORITES_FILE, JSON.stringify(favorites, null, 2));
+}
+
+/**
+ * Add a new favorite
+ * @param {string} name - Display name for the favorite
+ * @param {string} command - The command to save
+ * @param {string} description - Description of what it does
+ * @param {Array<string>} tags - Optional tags for searching
+ * @returns {Promise<Object>} Result object
+ */
+export async function addFavorite(name, command, description = '', tags = []) {
+  const favorites = await loadFavorites();
+
+  // Check for duplicate
+  const exists = favorites.some(f => f.command === command);
+  if (exists) {
+    return { success: false, message: 'Already in favorites' };
+  }
+
+  favorites.push({
+    id: Date.now(),
+    name: name || description.substring(0, 30),
+    command,
+    description,
+    tags,
+    createdAt: new Date().toISOString(),
+    usageCount: 0
+  });
+
+  await saveFavorites(favorites);
+  return { success: true, message: 'Added to favorites' };
+}
+
+/**
+ * Remove a favorite by identifier (index or name)
+ * @param {string|number} identifier - Index (1-based) or name/command fragment
+ * @returns {Promise<Object>} Result object
+ */
+export async function removeFavorite(identifier) {
+  const favorites = await loadFavorites();
+
+  let index = -1;
+
+  // Try by index first
+  if (typeof identifier === 'number' || /^\d+$/.test(identifier)) {
+    index = parseInt(identifier) - 1;
+  } else {
+    // Try by name/command
+    index = favorites.findIndex(f =>
+      f.name.toLowerCase().includes(identifier.toLowerCase()) ||
+      f.command.toLowerCase().includes(identifier.toLowerCase())
+    );
+  }
+
+  if (index >= 0 && index < favorites.length) {
+    const removed = favorites.splice(index, 1)[0];
+    await saveFavorites(favorites);
+    return { success: true, removed };
+  }
+
+  return { success: false, message: 'Favorite not found' };
+}
+
+/**
+ * Get a favorite by identifier (index or name)
+ * @param {string|number} identifier - Index (1-based) or name/command fragment
+ * @returns {Promise<Object|null>} Favorite object or null
+ */
+export async function getFavorite(identifier) {
+  const favorites = await loadFavorites();
+
+  // Try by index
+  if (typeof identifier === 'number' || /^\d+$/.test(identifier)) {
+    return favorites[parseInt(identifier) - 1] || null;
+  }
+
+  // Try by name/command
+  return favorites.find(f =>
+    f.name.toLowerCase().includes(identifier.toLowerCase()) ||
+    f.command.toLowerCase().includes(identifier.toLowerCase())
+  ) || null;
+}
+
+/**
+ * Update favorite usage count
+ * @param {number} id - Favorite ID
+ */
+export async function updateFavoriteUsage(id) {
+  const favorites = await loadFavorites();
+  const favorite = favorites.find(f => f.id === id);
+
+  if (favorite) {
+    favorite.usageCount = (favorite.usageCount || 0) + 1;
+    favorite.lastUsed = new Date().toISOString();
+    await saveFavorites(favorites);
+  }
+}
+
+/**
+ * Search favorites by query
+ * @param {string} query - Search query
+ * @returns {Promise<Array>} Matching favorites
+ */
+export async function searchFavorites(query) {
+  const favorites = await loadFavorites();
+  const q = query.toLowerCase();
+
+  return favorites.filter(f =>
+    f.name.toLowerCase().includes(q) ||
+    f.command.toLowerCase().includes(q) ||
+    (f.description && f.description.toLowerCase().includes(q)) ||
+    (f.tags && f.tags.some(t => t.toLowerCase().includes(q)))
+  );
+}
+
+/**
+ * Export favorites as JSON
+ * @returns {Promise<Array>} Favorites array
+ */
+export async function exportFavorites() {
+  return await loadFavorites();
+}
+
+/**
+ * Import favorites from JSON data
+ * @param {Array} data - Favorites data to import
+ * @param {boolean} merge - Whether to merge with existing (true) or replace (false)
+ * @returns {Promise<Object>} Import result
+ */
+export async function importFavorites(data, merge = true) {
+  const existing = merge ? await loadFavorites() : [];
+
+  // Filter out duplicates
+  const newFavorites = data.filter(item =>
+    !existing.some(e => e.command === item.command)
+  );
+
+  // Ensure each imported item has required fields
+  const processedFavorites = newFavorites.map(item => ({
+    id: item.id || Date.now() + Math.random(),
+    name: item.name || item.description?.substring(0, 30) || 'Untitled',
+    command: item.command,
+    description: item.description || '',
+    tags: item.tags || [],
+    createdAt: item.createdAt || new Date().toISOString(),
+    usageCount: item.usageCount || 0
+  }));
+
+  const merged = [...existing, ...processedFavorites];
+  await saveFavorites(merged);
+
+  return { imported: processedFavorites.length, total: merged.length };
+}
+
+/**
+ * Clear all favorites
+ */
+export async function clearFavorites() {
+  await saveFavorites([]);
+}
+
+/**
+ * Get favorites stats
+ * @returns {Promise<Object>} Favorites statistics
+ */
+export async function getFavoritesStats() {
+  const favorites = await loadFavorites();
+
+  if (favorites.length === 0) {
+    return { total: 0, mostUsed: null, totalUsage: 0 };
+  }
+
+  const mostUsed = favorites.reduce((max, f) =>
+    (f.usageCount || 0) > (max.usageCount || 0) ? f : max
+  , favorites[0]);
+
+  const totalUsage = favorites.reduce((sum, f) => sum + (f.usageCount || 0), 0);
+
+  return {
+    total: favorites.length,
+    mostUsed: mostUsed.name,
+    totalUsage
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+
+export default {
+  // History
+  addToHistory,
+  loadHistory,
+  saveHistory,
+  clearHistory,
+  searchHistory,
+  getHistoryItem,
+  getHistoryStats,
+  // Favorites
+  loadFavorites,
+  saveFavorites,
+  addFavorite,
+  removeFavorite,
+  getFavorite,
+  updateFavoriteUsage,
+  searchFavorites,
+  exportFavorites,
+  importFavorites,
+  clearFavorites,
+  getFavoritesStats
+};

package/src/utils/notifications.js

@@ -0,0 +1,343 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Desktop Notifications Utility
+// Phase M7: Cross-platform notification support
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import { execSync, exec } from 'child_process';
+import { platform } from 'os';
+import path from 'path';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Configuration
+// ─────────────────────────────────────────────────────────────────────────────
+
+const NOTIFICATION_TYPES = {
+  success: { icon: '✅', sound: true },
+  error: { icon: '❌', sound: true },
+  warning: { icon: '⚠️', sound: false },
+  info: { icon: 'ℹ️', sound: false },
+  build: { icon: '🏗️', sound: true },
+  deploy: { icon: '🚀', sound: true },
+  test: { icon: '🧪', sound: true },
+  watch: { icon: '👁️', sound: false }
+};
+
+const APP_NAME = 'Vibecode';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Platform Detection
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Get current platform
+ * @returns {'macos'|'linux'|'windows'|'unknown'}
+ */
+function getPlatform() {
+  const p = platform();
+  if (p === 'darwin') return 'macos';
+  if (p === 'linux') return 'linux';
+  if (p === 'win32') return 'windows';
+  return 'unknown';
+}
+
+/**
+ * Check if notifications are supported on current platform
+ * @returns {boolean}
+ */
+export function isNotificationSupported() {
+  const p = getPlatform();
+
+  if (p === 'macos') {
+    return true; // AppleScript always available
+  }
+
+  if (p === 'linux') {
+    try {
+      execSync('which notify-send', { stdio: 'ignore' });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  if (p === 'windows') {
+    return true; // PowerShell always available
+  }
+
+  return false;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Platform-Specific Implementations
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Send notification on macOS using AppleScript
+ */
+function notifyMacOS(title, message, options = {}) {
+  const { sound = false, subtitle = '' } = options;
+
+  // Escape special characters for AppleScript
+  const escapeAS = (str) => str.replace(/"/g, '\\"').replace(/\\/g, '\\\\');
+
+  let script = `display notification "${escapeAS(message)}" with title "${escapeAS(title)}"`;
+
+  if (subtitle) {
+    script += ` subtitle "${escapeAS(subtitle)}"`;
+  }
+
+  if (sound) {
+    script += ' sound name "Glass"';
+  }
+
+  try {
+    execSync(`osascript -e '${script}'`, { stdio: 'ignore' });
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
+/**
+ * Send notification on Linux using notify-send
+ */
+function notifyLinux(title, message, options = {}) {
+  const { icon = 'dialog-information', urgency = 'normal', timeout = 5000 } = options;
+
+  // Escape special characters for shell
+  const escapeShell = (str) => str.replace(/'/g, "'\\''");
+
+  const args = [
+    `'${escapeShell(title)}'`,
+    `'${escapeShell(message)}'`,
+    `--urgency=${urgency}`,
+    `-t ${timeout}`,
+    `-i ${icon}`
+  ];
+
+  try {
+    execSync(`notify-send ${args.join(' ')}`, { stdio: 'ignore' });
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
+/**
+ * Send notification on Windows using PowerShell
+ */
+function notifyWindows(title, message, options = {}) {
+  const { icon = 'Information' } = options;
+
+  // Escape special characters for PowerShell
+  const escapePS = (str) => str.replace(/'/g, "''").replace(/`/g, '``');
+
+  const script = `
+    [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
+    [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] | Out-Null
+
+    $template = @"
+    <toast>
+      <visual>
+        <binding template="ToastText02">
+          <text id="1">${escapePS(title)}</text>
+          <text id="2">${escapePS(message)}</text>
+        </binding>
+      </visual>
+    </toast>
+"@
+
+    $xml = New-Object Windows.Data.Xml.Dom.XmlDocument
+    $xml.LoadXml($template)
+    $toast = [Windows.UI.Notifications.ToastNotification]::new($xml)
+    [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("${APP_NAME}").Show($toast)
+  `;
+
+  try {
+    // Use simpler balloon notification as fallback
+    const simpleScript = `
+      Add-Type -AssemblyName System.Windows.Forms
+      $balloon = New-Object System.Windows.Forms.NotifyIcon
+      $balloon.Icon = [System.Drawing.SystemIcons]::${icon}
+      $balloon.BalloonTipIcon = [System.Windows.Forms.ToolTipIcon]::${icon}
+      $balloon.BalloonTipTitle = '${escapePS(title)}'
+      $balloon.BalloonTipText = '${escapePS(message)}'
+      $balloon.Visible = $true
+      $balloon.ShowBalloonTip(5000)
+      Start-Sleep -Seconds 1
+      $balloon.Dispose()
+    `;
+
+    exec(`powershell -Command "${simpleScript.replace(/\n/g, '; ')}"`, { stdio: 'ignore' });
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Main Notification Function
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Send a desktop notification
+ * @param {string} message - Notification message
+ * @param {string} type - Notification type (success, error, warning, info, build, deploy, test, watch)
+ * @param {Object} options - Additional options
+ * @param {string} options.title - Custom title (default: "Vibecode")
+ * @param {string} options.subtitle - Subtitle (macOS only)
+ * @param {boolean} options.sound - Play sound
+ * @returns {boolean} - Whether notification was sent successfully
+ */
+export function notify(message, type = 'info', options = {}) {
+  const config = NOTIFICATION_TYPES[type] || NOTIFICATION_TYPES.info;
+  const title = options.title || `${config.icon} ${APP_NAME}`;
+  const sound = options.sound !== undefined ? options.sound : config.sound;
+
+  const p = getPlatform();
+
+  switch (p) {
+    case 'macos':
+      return notifyMacOS(title, message, { ...options, sound });
+    case 'linux':
+      return notifyLinux(title, message, options);
+    case 'windows':
+      return notifyWindows(title, message, options);
+    default:
+      return false;
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Convenience Functions
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Notify build completion
+ * @param {boolean} success - Whether build succeeded
+ * @param {string} projectName - Project name
+ * @param {Object} options - Additional options
+ */
+export function notifyBuildComplete(success, projectName = 'Project', options = {}) {
+  const message = success
+    ? `${projectName} built successfully!`
+    : `${projectName} build failed`;
+
+  return notify(message, success ? 'success' : 'error', {
+    title: '🏗️ Build Complete',
+    subtitle: projectName,
+    ...options
+  });
+}
+
+/**
+ * Notify deploy completion
+ * @param {boolean} success - Whether deploy succeeded
+ * @param {string} platform - Deploy platform (vercel, netlify, etc.)
+ * @param {string} url - Deployment URL
+ */
+export function notifyDeployComplete(success, platform = 'Cloud', url = '') {
+  const message = success
+    ? `Deployed to ${platform}!${url ? ` ${url}` : ''}`
+    : `Deploy to ${platform} failed`;
+
+  return notify(message, success ? 'deploy' : 'error', {
+    title: '🚀 Deploy Complete',
+    subtitle: platform
+  });
+}
+
+/**
+ * Notify file change detected (watch mode)
+ * @param {string} filePath - Changed file path
+ * @param {string} event - Event type (change, add, unlink)
+ */
+export function notifyWatchChange(filePath, event = 'change') {
+  const fileName = path.basename(filePath);
+  const eventIcons = {
+    change: '📝',
+    add: '➕',
+    unlink: '🗑️'
+  };
+  const icon = eventIcons[event] || '👁️';
+
+  return notify(`${icon} ${fileName}`, 'watch', {
+    title: '👁️ File Changed',
+    subtitle: event,
+    sound: false
+  });
+}
+
+/**
+ * Notify test completion
+ * @param {boolean} success - Whether tests passed
+ * @param {number} passed - Number of passed tests
+ * @param {number} failed - Number of failed tests
+ */
+export function notifyTestComplete(success, passed = 0, failed = 0) {
+  const message = success
+    ? `All ${passed} tests passed!`
+    : `${failed} test${failed > 1 ? 's' : ''} failed, ${passed} passed`;
+
+  return notify(message, success ? 'success' : 'error', {
+    title: '🧪 Tests Complete'
+  });
+}
+
+/**
+ * Notify error occurred
+ * @param {string} message - Error message
+ * @param {string} context - Error context
+ */
+export function notifyError(message, context = '') {
+  return notify(message, 'error', {
+    title: '❌ Error',
+    subtitle: context
+  });
+}
+
+/**
+ * Notify success
+ * @param {string} message - Success message
+ * @param {string} context - Success context
+ */
+export function notifySuccess(message, context = '') {
+  return notify(message, 'success', {
+    title: '✅ Success',
+    subtitle: context
+  });
+}
+
+/**
+ * Notify agent module completion
+ * @param {number} moduleNum - Module number
+ * @param {number} total - Total modules
+ * @param {boolean} success - Whether module succeeded
+ */
+export function notifyAgentProgress(moduleNum, total, success = true) {
+  const message = success
+    ? `Module ${moduleNum}/${total} completed`
+    : `Module ${moduleNum}/${total} failed`;
+
+  return notify(message, success ? 'info' : 'warning', {
+    title: '🤖 Agent Mode',
+    subtitle: `Progress: ${Math.round((moduleNum / total) * 100)}%`
+  });
+}
+
+// ─────────────────────────────────────════════════════════════════════════════
+// Exports
+// ─────────────────────────────════════════════════════════════════════════════
+
+export default {
+  notify,
+  notifyBuildComplete,
+  notifyDeployComplete,
+  notifyWatchChange,
+  notifyTestComplete,
+  notifyError,
+  notifySuccess,
+  notifyAgentProgress,
+  isNotificationSupported,
+  getPlatform
+};