cursor-guard 4.9.1 → 4.9.8

package/references/vscode-extension/dist/lib/status-bar.js

@@ -1,68 +1,95 @@
-'use strict';
-
-const vscode = require('vscode');
-
-class StatusBarController {
-  constructor(poller) {
-    this._item = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Left, 100);
-    this._item.command = 'cursorGuard.openDashboard';
-    this._item.tooltip = 'Cursor Guard — click to open dashboard';
-    this._setIdle();
-    this._item.show();
-
-    this._sub = poller.onChange(data => this._update(data));
-  }
-
-  _setIdle() {
-    this._item.text = '$(shield) Guard: init...';
-    this._item.backgroundColor = undefined;
-    this._item.color = new vscode.ThemeColor('statusBar.foreground');
-  }
-
-  _update(data) {
-    let hasAlert = false;
-    let watcherRunning = false;
-    let alertFileCount = 0;
-    let projectCount = 0;
-
-    for (const [, p] of data) {
-      projectCount++;
-      const d = p.dashboard;
-      if (!d) continue;
-      if (d.alerts?.active) {
-        hasAlert = true;
-        alertFileCount = d.alerts.latest?.fileCount || 0;
-      }
-      if (d.watcher?.running) watcherRunning = true;
-    }
-
-    if (hasAlert) {
-      this._item.text = `$(bell~spin) Guard: ${alertFileCount} files!`;
-      this._item.backgroundColor = new vscode.ThemeColor('statusBarItem.warningBackground');
-      this._item.color = undefined;
-      this._item.tooltip = `Cursor Guard — ALERT: ${alertFileCount} files changed rapidly. Click to open dashboard.`;
-    } else if (watcherRunning) {
-      this._item.text = '$(shield) Guard: OK';
-      this._item.backgroundColor = undefined;
-      this._item.color = new vscode.ThemeColor('statusBar.foreground');
-      this._item.tooltip = 'Cursor Guard — watcher running, no alerts. Click to open dashboard.';
-    } else if (projectCount > 0) {
-      this._item.text = '$(eye-closed) Guard: Unprotected';
-      this._item.backgroundColor = undefined;
-      this._item.color = new vscode.ThemeColor('statusBar.foreground');
-      this._item.tooltip = 'Cursor Guard — watcher NOT running. Click to open dashboard, or use Command Palette > Start Watcher.';
-    } else {
-      this._item.text = '$(shield) Guard';
-      this._item.backgroundColor = undefined;
-      this._item.color = new vscode.ThemeColor('statusBar.foreground');
-      this._item.tooltip = 'Cursor Guard — no projects detected';
-    }
-  }
-
-  dispose() {
-    this._sub?.dispose();
-    this._item.dispose();
-  }
-}
-
-module.exports = { StatusBarController };
+'use strict';
+
+const vscode = require('vscode');
+
+class StatusBarController {
+  constructor(poller) {
+    this._item = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Left, 100);
+    this._item.command = 'cursorGuard.openDashboard';
+    this._item.tooltip = 'Cursor Guard - click to open dashboard';
+    this._setIdle();
+    this._item.show();
+
+    this._sub = poller.onChange(data => this._update(data));
+  }
+
+  _setIdle() {
+    this._item.text = '$(shield) Guard: init...';
+    this._item.backgroundColor = undefined;
+    this._item.color = new vscode.ThemeColor('statusBar.foreground');
+  }
+
+  _update(data) {
+    let hasPreWarning = false;
+    let hasAlert = false;
+    let watcherRunning = false;
+    let preWarningLabel = '';
+    let alertFileCount = 0;
+    let projectCount = 0;
+
+    for (const [, project] of data) {
+      projectCount++;
+      const dashboard = project.dashboard;
+      if (!dashboard) continue;
+
+      if (dashboard.preWarnings?.active && !hasPreWarning) {
+        hasPreWarning = true;
+        const latest = dashboard.preWarnings.latest;
+        preWarningLabel = latest?.file
+          ? `${latest.file} (${latest.riskPercent || '?'}%)`
+          : `${dashboard.preWarnings.count || 1} pending`;
+      }
+
+      if (dashboard.alerts?.active) {
+        hasAlert = true;
+        alertFileCount = dashboard.alerts.latest?.fileCount || 0;
+      }
+
+      if (dashboard.watcher?.running) watcherRunning = true;
+    }
+
+    if (hasPreWarning) {
+      this._item.text = `$(warning) Guard: Delete Risk`;
+      this._item.backgroundColor = new vscode.ThemeColor('statusBarItem.warningBackground');
+      this._item.color = undefined;
+      this._item.tooltip = `Cursor Guard - pre-warning active: ${preWarningLabel}. Click to open dashboard.`;
+      return;
+    }
+
+    if (hasAlert) {
+      this._item.text = `$(bell~spin) Guard: ${alertFileCount} files!`;
+      this._item.backgroundColor = new vscode.ThemeColor('statusBarItem.warningBackground');
+      this._item.color = undefined;
+      this._item.tooltip = `Cursor Guard - alert: ${alertFileCount} files changed rapidly. Click to open dashboard.`;
+      return;
+    }
+
+    if (watcherRunning) {
+      this._item.text = '$(shield) Guard: OK';
+      this._item.backgroundColor = undefined;
+      this._item.color = new vscode.ThemeColor('statusBar.foreground');
+      this._item.tooltip = 'Cursor Guard - watcher running, no active alerts. Click to open dashboard.';
+      return;
+    }
+
+    if (projectCount > 0) {
+      this._item.text = '$(eye-closed) Guard: Unprotected';
+      this._item.backgroundColor = undefined;
+      this._item.color = new vscode.ThemeColor('statusBar.foreground');
+      this._item.tooltip = 'Cursor Guard - watcher not running. Click to open dashboard or start watcher from the Command Palette.';
+      return;
+    }
+
+    this._item.text = '$(shield) Guard';
+    this._item.backgroundColor = undefined;
+    this._item.color = new vscode.ThemeColor('statusBar.foreground');
+    this._item.tooltip = 'Cursor Guard - no projects detected';
+  }
+
+  dispose() {
+    this._sub?.dispose();
+    this._item.dispose();
+  }
+}
+
+module.exports = { StatusBarController };

package/references/vscode-extension/dist/lib/tree-view.js

@@ -1,114 +1,174 @@
-'use strict';
-
-const vscode = require('vscode');
-
-const C = {
-  green: new vscode.ThemeColor('charts.green'),
-  red: new vscode.ThemeColor('charts.red'),
-  yellow: new vscode.ThemeColor('charts.yellow'),
-  blue: new vscode.ThemeColor('charts.blue'),
-  purple: new vscode.ThemeColor('charts.purple'),
-  orange: new vscode.ThemeColor('charts.orange'),
-};
-
-class GuardTreeView {
-  constructor(poller, dashMgr) {
-    this._poller = poller;
-    this._dashMgr = dashMgr;
-    this._onDidChange = new vscode.EventEmitter();
-    this.onDidChangeTreeData = this._onDidChange.event;
-
-    this._treeView = vscode.window.createTreeView('cursorGuardProjects', {
-      treeDataProvider: this,
-      showCollapseAll: false,
-    });
-
-    this._sub = poller.onChange(() => this._onDidChange.fire());
-  }
-
-  refresh() { this._onDidChange.fire(); }
-  getTreeItem(el) { return el; }
-
-  getChildren(el) {
-    if (!el) return this._getRootItems();
-    if (el.contextValue === 'project') return this._getProjectStatus(el.projectId);
-    return [];
-  }
-
-  _getRootItems() {
-    const data = this._poller.data;
-    if (data.size === 0) {
-      return [_item('No projects detected', 'info', { icon: 'info', color: C.yellow, desc: 'Add .cursor-guard.json' })];
-    }
-    const items = [];
-    for (const [id, p] of data) {
-      const d = p.dashboard;
-      const hasAlert = d?.alerts?.active;
-      const watcherOk = d?.watcher?.running;
-      const color = hasAlert ? C.red : watcherOk ? C.green : C.yellow;
-      const status = hasAlert ? `ALERT ${d.alerts.latest?.fileCount || ''} files` : watcherOk ? 'Protected' : 'Unprotected';
-      const item = _item(p.name || id, 'project', {
-        icon: hasAlert ? 'bell' : watcherOk ? 'shield' : 'eye-closed',
-        color,
-        desc: status,
-        collapsible: vscode.TreeItemCollapsibleState.Expanded,
-      });
-      item.projectId = id;
-      items.push(item);
-    }
-    return items;
-  }
-
-  _getProjectStatus(pid) {
-    const p = this._poller.data.get(pid);
-    if (!p?.dashboard) return [_item('Loading...', 'loading', { icon: 'loading~spin', color: C.blue })];
-    const d = p.dashboard;
-    const items = [];
-
-    if (d.watcher?.running) {
-      const w = _item('Watcher: Running', 'watcher', { icon: 'eye', color: C.green, desc: `PID ${d.watcher.pid || '?'}` });
-      items.push(w);
-    } else {
-      const w = _item('Watcher: Stopped', 'watcher', { icon: 'eye-closed', color: C.red });
-      w.command = { command: 'cursorGuard.startWatcher', title: 'Start Watcher' };
-      w.tooltip = 'Click to start watcher';
-      items.push(w);
-    }
-
-    const gitC = d.counts?.git?.commits || 0;
-    const shadowC = d.counts?.shadow?.snapshots || 0;
-    const lastAgo = d.lastBackup?.git?.relativeTime || 'never';
-    items.push(_item(`Backups: ${gitC + shadowC}`, 'stat', { icon: 'history', color: C.blue, desc: `last ${lastAgo}` }));
-
-    const health = d.health?.status || 'unknown';
-    const hColor = health === 'healthy' ? C.green : health === 'critical' ? C.red : C.yellow;
-    const hIcon = health === 'healthy' ? 'pass-filled' : health === 'critical' ? 'error' : 'warning';
-    items.push(_item(`Health: ${health}`, 'health', { icon: hIcon, color: hColor }));
-
-    const openItem = _item('Open Dashboard', 'action', { icon: 'browser', color: C.blue });
-    openItem.command = { command: 'cursorGuard.openDashboard', title: 'Open' };
-    items.push(openItem);
-
-    const snapItem = _item('Snapshot Now', 'action', { icon: 'device-camera', color: C.purple });
-    snapItem.command = { command: 'cursorGuard.snapshotNow', title: 'Snap' };
-    items.push(snapItem);
-
-    return items;
-  }
-
-  dispose() {
-    this._sub?.dispose();
-    this._treeView.dispose();
-    this._onDidChange.dispose();
-  }
-}
-
-function _item(label, ctx, opts = {}) {
-  const ti = new vscode.TreeItem(label, opts.collapsible || vscode.TreeItemCollapsibleState.None);
-  ti.contextValue = ctx;
-  if (opts.icon) ti.iconPath = new vscode.ThemeIcon(opts.icon, opts.color);
-  if (opts.desc) ti.description = opts.desc;
-  return ti;
-}
-
-module.exports = { GuardTreeView };
+'use strict';
+
+const vscode = require('vscode');
+
+const C = {
+  green: new vscode.ThemeColor('charts.green'),
+  red: new vscode.ThemeColor('charts.red'),
+  yellow: new vscode.ThemeColor('charts.yellow'),
+  blue: new vscode.ThemeColor('charts.blue'),
+  purple: new vscode.ThemeColor('charts.purple'),
+  orange: new vscode.ThemeColor('charts.orange'),
+};
+
+class GuardTreeView {
+  constructor(poller, dashMgr) {
+    this._poller = poller;
+    this._dashMgr = dashMgr;
+    this._onDidChange = new vscode.EventEmitter();
+    this.onDidChangeTreeData = this._onDidChange.event;
+
+    this._treeView = vscode.window.createTreeView('cursorGuardProjects', {
+      treeDataProvider: this,
+      showCollapseAll: false,
+    });
+
+    this._sub = poller.onChange(() => this._onDidChange.fire());
+  }
+
+  refresh() { this._onDidChange.fire(); }
+  getTreeItem(el) { return el; }
+
+  getChildren(el) {
+    if (!el) return this._getRootItems();
+    if (el.contextValue === 'project') return this._getProjectStatus(el.projectId);
+    return [];
+  }
+
+  _getRootItems() {
+    const data = this._poller.data;
+    if (data.size === 0) {
+      return [_item('No projects detected', 'info', {
+        icon: 'info',
+        color: C.yellow,
+        desc: 'Add .cursor-guard.json',
+      })];
+    }
+
+    const items = [];
+    for (const [id, project] of data) {
+      const dashboard = project.dashboard;
+      const hasPreWarning = dashboard?.preWarnings?.active;
+      const hasAlert = dashboard?.alerts?.active;
+      const watcherOk = dashboard?.watcher?.running;
+
+      let color = C.yellow;
+      let status = 'Unprotected';
+      let icon = 'eye-closed';
+
+      if (hasPreWarning) {
+        color = C.orange;
+        icon = 'warning';
+        const latest = dashboard.preWarnings.latest;
+        status = latest?.file
+          ? `Delete risk in ${latest.file}`
+          : `Delete risk (${dashboard.preWarnings.count || 1})`;
+      } else if (hasAlert) {
+        color = C.red;
+        icon = 'bell';
+        status = `Alert ${dashboard.alerts.latest?.fileCount || ''} files`;
+      } else if (watcherOk) {
+        color = C.green;
+        icon = 'shield';
+        status = 'Protected';
+      }
+
+      const item = _item(project.name || id, 'project', {
+        icon,
+        color,
+        desc: status,
+        collapsible: vscode.TreeItemCollapsibleState.Expanded,
+      });
+      item.projectId = id;
+      items.push(item);
+    }
+
+    return items;
+  }
+
+  _getProjectStatus(pid) {
+    const project = this._poller.data.get(pid);
+    if (!project?.dashboard) {
+      return [_item('Loading...', 'loading', { icon: 'loading~spin', color: C.blue })];
+    }
+
+    const dashboard = project.dashboard;
+    const items = [];
+
+    if (dashboard.preWarnings?.active) {
+      const latest = dashboard.preWarnings.latest || {};
+      items.push(_item('Pre-Warning: Active', 'prewarning', {
+        icon: 'warning',
+        color: C.orange,
+        desc: latest.riskPercent ? `${latest.riskPercent}% risk` : undefined,
+      }));
+
+      const detail = latest.file
+        ? `${latest.file} - ${latest.summary || 'Review pending deletion'}`
+        : `${dashboard.preWarnings.count || 1} destructive edit warning(s) pending`;
+      items.push(_item(detail, 'prewarning-detail', {
+        icon: 'note',
+        color: C.orange,
+      }));
+    }
+
+    if (dashboard.watcher?.running) {
+      items.push(_item('Watcher: Running', 'watcher', {
+        icon: 'eye',
+        color: C.green,
+        desc: `PID ${dashboard.watcher.pid || '?'}`,
+      }));
+    } else {
+      const watcherItem = _item('Watcher: Stopped', 'watcher', {
+        icon: 'eye-closed',
+        color: C.red,
+      });
+      watcherItem.command = { command: 'cursorGuard.startWatcher', title: 'Start Watcher' };
+      watcherItem.tooltip = 'Click to start watcher';
+      items.push(watcherItem);
+    }
+
+    const gitCount = dashboard.counts?.git?.commits || 0;
+    const shadowCount = dashboard.counts?.shadow?.snapshots || 0;
+    const lastAgo = dashboard.lastBackup?.git?.relativeTime || 'never';
+    items.push(_item(`Backups: ${gitCount + shadowCount}`, 'stat', {
+      icon: 'history',
+      color: C.blue,
+      desc: `last ${lastAgo}`,
+    }));
+
+    const health = dashboard.health?.status || 'unknown';
+    const healthColor = health === 'healthy' ? C.green : health === 'critical' ? C.red : C.yellow;
+    const healthIcon = health === 'healthy' ? 'pass-filled' : health === 'critical' ? 'error' : 'warning';
+    items.push(_item(`Health: ${health}`, 'health', {
+      icon: healthIcon,
+      color: healthColor,
+    }));
+
+    const openItem = _item('Open Dashboard', 'action', { icon: 'browser', color: C.blue });
+    openItem.command = { command: 'cursorGuard.openDashboard', title: 'Open' };
+    items.push(openItem);
+
+    const snapItem = _item('Snapshot Now', 'action', { icon: 'device-camera', color: C.purple });
+    snapItem.command = { command: 'cursorGuard.snapshotNow', title: 'Snap' };
+    items.push(snapItem);
+
+    return items;
+  }
+
+  dispose() {
+    this._sub?.dispose();
+    this._treeView.dispose();
+    this._onDidChange.dispose();
+  }
+}
+
+function _item(label, ctx, opts = {}) {
+  const treeItem = new vscode.TreeItem(label, opts.collapsible || vscode.TreeItemCollapsibleState.None);
+  treeItem.contextValue = ctx;
+  if (opts.icon) treeItem.iconPath = new vscode.ThemeIcon(opts.icon, opts.color);
+  if (opts.desc) treeItem.description = opts.desc;
+  return treeItem;
+}
+
+module.exports = { GuardTreeView };

package/references/vscode-extension/dist/lib/utils.js

@@ -133,19 +133,23 @@ const VALID_GIT_RETENTION_MODES = ['days', 'count'];
 
 const DEFAULT_IGNORE = ['.cursor/skills/**'];
 
-const DEFAULT_CONFIG = {
-  protect: [],
-  ignore: [...DEFAULT_IGNORE],
-  secrets_patterns: DEFAULT_SECRETS,
-  backup_strategy: 'git',
+const DEFAULT_CONFIG = {
+  protect: [],
+  ignore: [...DEFAULT_IGNORE],
+  secrets_patterns: DEFAULT_SECRETS,
+  backup_strategy: 'git',
   auto_backup_interval_seconds: 60,
   pre_restore_backup: 'always',
   retention: { mode: 'days', days: 30, max_count: 100, max_size_mb: 500 },
-  git_retention: { enabled: false, mode: 'count', days: 30, max_count: 200 },
-  proactive_alert: true,
-  alert_thresholds: { files_per_window: 20, window_seconds: 10, cooldown_seconds: 60 },
-  always_watch: false,
-};
+  git_retention: { enabled: false, mode: 'count', days: 30, max_count: 200 },
+  proactive_alert: true,
+  alert_thresholds: { files_per_window: 20, window_seconds: 10, cooldown_seconds: 60 },
+  always_watch: false,
+  enable_pre_warning: false,
+  pre_warning_threshold: 30,
+  pre_warning_mode: 'popup',
+  pre_warning_exclude_patterns: [],
+};
 
 function loadConfig(projectDir) {
   const cfgPath = path.join(projectDir, '.cursor-guard.json');
@@ -234,16 +238,38 @@ function loadConfig(projectDir) {
       if (typeof raw.alert_thresholds.cooldown_seconds === 'number' && raw.alert_thresholds.cooldown_seconds > 0)
         cfg.alert_thresholds.cooldown_seconds = raw.alert_thresholds.cooldown_seconds;
     }
-    if (raw.always_watch === true) {
-      cfg.always_watch = true;
-    } else if (raw.always_watch !== undefined && raw.always_watch !== false) {
-      warnings.push(`always_watch should be a boolean, got ${JSON.stringify(raw.always_watch)} — using default (false)`);
-    }
-    return { cfg, loaded: true, error: null, warnings };
-  } catch (e) {
-    return { cfg, loaded: false, error: e.message };
-  }
-}
+    if (raw.always_watch === true) {
+      cfg.always_watch = true;
+    } else if (raw.always_watch !== undefined && raw.always_watch !== false) {
+      warnings.push(`always_watch should be a boolean, got ${JSON.stringify(raw.always_watch)} — using default (false)`);
+    }
+    if (raw.enable_pre_warning === true) {
+      cfg.enable_pre_warning = true;
+    } else if (raw.enable_pre_warning !== undefined && raw.enable_pre_warning !== false) {
+      warnings.push(`enable_pre_warning should be a boolean, got ${JSON.stringify(raw.enable_pre_warning)} — using default (false)`);
+    }
+    if (typeof raw.pre_warning_threshold === 'number') {
+      if (raw.pre_warning_threshold >= 1 && raw.pre_warning_threshold <= 100) {
+        cfg.pre_warning_threshold = raw.pre_warning_threshold;
+      } else {
+        warnings.push(`pre_warning_threshold should be 1-100, got ${JSON.stringify(raw.pre_warning_threshold)} — using default (${cfg.pre_warning_threshold})`);
+      }
+    }
+    if (typeof raw.pre_warning_mode === 'string') {
+      if (['popup', 'dashboard', 'silent'].includes(raw.pre_warning_mode)) {
+        cfg.pre_warning_mode = raw.pre_warning_mode;
+      } else {
+        warnings.push(`Unknown pre_warning_mode "${raw.pre_warning_mode}", using default "${cfg.pre_warning_mode}"`);
+      }
+    }
+    if (Array.isArray(raw.pre_warning_exclude_patterns)) {
+      cfg.pre_warning_exclude_patterns = sanitizeStringArray(raw.pre_warning_exclude_patterns, 'pre_warning_exclude_patterns');
+    }
+    return { cfg, loaded: true, error: null, warnings };
+  } catch (e) {
+    return { cfg, loaded: false, error: e.message };
+  }
+}
 
 // ── Git helpers ─────────────────────────────────────────────────