cursor-guard 4.9.1 → 4.9.8

package/references/vscode-extension/dist/dashboard/public/app.js

@@ -60,9 +60,16 @@ const I18N = {
     'alert.action.deleted':  'Deleted',
     'alert.action.renamed':  'Renamed',
     'alert.breakdown':       '{added} added, {modified} modified, {deleted} deleted',
-    'alert.suggestion':      'Check recent changes and consider creating a manual snapshot',
-    'alert.viewFiles':       'View file details ({n} files)',
-    'modal.alertFiles':      'Alert File Details',
+    'alert.suggestion':      'Check recent changes and consider creating a manual snapshot',
+    'alert.viewFiles':       'View file details ({n} files)',
+    'preWarning.title':      'Pre-Warning',
+    'preWarning.none':       'No destructive edit risk detected',
+    'preWarning.active':     'Delete Risk',
+    'preWarning.file':       'File',
+    'preWarning.risk':       'Risk',
+    'preWarning.methods':    'Methods removed',
+    'preWarning.suggestion': 'Review this deletion before applying or restore from the latest snapshot',
+    'modal.alertFiles':      'Alert File Details',
     'modal.col.restore':     'Restore',
     'modal.copyRestore':     'Copy cmd',
     'modal.restorePreDelete':'Restore pre-delete',
@@ -170,8 +177,9 @@ const I18N = {
     'issue.disk_critically_low':        'Disk space critically low ({gb} GB free)',
     'issue.disk_low':                   'Disk space low ({gb} GB free)',
     'issue.git_backup_stale':           'Last git backup is stale ({rel})',
-    'issue.active_alert':               'Active alert: {type} — {count} files in {window}s',
-    'issue.alert_high_velocity':        'High volume of file changes detected. Consider reviewing recent modifications and creating a manual snapshot.',
+    'issue.active_alert':               'Active alert: {type} — {count} files in {window}s',
+    'issue.pre_warning_active':         'Pre-warning active: {summary}',
+    'issue.alert_high_velocity':        'High volume of file changes detected. Consider reviewing recent modifications and creating a manual snapshot.',
 
     'check.Git installed':              'Git installed',
     'check.Git repository':             'Git repository',
@@ -288,9 +296,16 @@ const I18N = {
     'alert.action.deleted':  '删除',
     'alert.action.renamed':  '重命名',
     'alert.breakdown':       '新增 {added} · 修改 {modified} · 删除 {deleted}',
-    'alert.suggestion':      '建议检查近期变更，并考虑手动创建快照',
-    'alert.viewFiles':       '查看文件详情（{n} 个文件）',
-    'modal.alertFiles':      '告警文件详情',
+    'alert.suggestion':      '建议检查近期变更，并考虑手动创建快照',
+    'alert.viewFiles':       '查看文件详情（{n} 个文件）',
+    'preWarning.title':      '事先预警',
+    'preWarning.none':       '未检测到破坏性编辑风险',
+    'preWarning.active':     '删除风险',
+    'preWarning.file':       '文件',
+    'preWarning.risk':       '风险',
+    'preWarning.methods':    '移除的方法数',
+    'preWarning.suggestion': '建议在应用前检查这次删除，或直接从最新快照恢复',
+    'modal.alertFiles':      '告警文件详情',
     'modal.col.restore':     '恢复',
     'modal.copyRestore':     '复制命令',
     'modal.restorePreDelete':'恢复删除前',
@@ -399,7 +414,8 @@ const I18N = {
     'issue.disk_low':                   '磁盘空间不足（{gb} GB 可用）',
     'issue.git_backup_stale':           '最近 Git 备份已过时（{rel}）',
     'issue.active_alert':               '活跃告警：{type}——{count} 个文件在 {window} 秒内变更',
-    'issue.alert_high_velocity':        '检测到大量文件变更，建议检查最近修改并手动创建快照。',
+    'issue.pre_warning_active':         '事先预警生效：{summary}',
+    'issue.alert_high_velocity':        '检测到大量文件变更，建议检查最近修改并手动创建快照。',
 
     'check.Git installed':              'Git 安装状态',
     'check.Git repository':             'Git 仓库',
@@ -557,8 +573,9 @@ const ISSUE_PATTERNS = [
   { re: /^Disk space low \((.+?) GB free\)$/,                       key: 'issue.disk_low', extract: ['gb'] },
   { re: /^Last git backup is stale \((.+?)\)$/,                     key: 'issue.git_backup_stale', extract: ['rel'] },
   { re: /^Active alert: (.+?) — (\d+) files in (\d+)s$/,           key: 'issue.active_alert', extract: ['type', 'count', 'window'] },
-  { re: /^High volume of file changes/,                             key: 'issue.alert_high_velocity' },
-];
+  { re: /^Pre-warning active: (.+)$/,                               key: 'issue.pre_warning_active', extract: ['summary'] },
+  { re: /^High volume of file changes/,                             key: 'issue.alert_high_velocity' },
+];
 
 function translateIssue(text) {
   for (const p of ISSUE_PATTERNS) {
@@ -850,13 +867,14 @@ function renderAll() {
 
 /* ── Rendering: Overview ──────────────────────────────────── */
 
-function renderOverview(d) {
-  renderHealthCard(d.health);
-  renderGitBackupCard(d.lastBackup);
-  renderShadowBackupCard(d.lastBackup);
-  renderWatcherCard(d.watcher);
-  renderAlertCard(d.alerts);
-}
+function renderOverview(d) {
+  renderHealthCard(d.health);
+  renderGitBackupCard(d.lastBackup);
+  renderShadowBackupCard(d.lastBackup);
+  renderPreWarningCard(d.preWarnings);
+  renderWatcherCard(d.watcher);
+  renderAlertCard(d.alerts);
+}
 
 function renderHealthCard(health) {
   const el = $('#card-health');
@@ -889,9 +907,9 @@ function renderGitBackupCard(lastBackup) {
   `;
 }
 
-function renderShadowBackupCard(lastBackup) {
-  const el = $('#card-shadow-backup');
-  const s = lastBackup?.shadow;
+function renderShadowBackupCard(lastBackup) {
+  const el = $('#card-shadow-backup');
+  const s = lastBackup?.shadow;
   if (!s) {
     el.innerHTML = `<div class="card-label">${t('shadowBackup.title')}</div><div class="card-empty">${t('shadowBackup.none')}</div>`;
     return;
@@ -899,12 +917,40 @@ function renderShadowBackupCard(lastBackup) {
   el.innerHTML = `
     <div class="card-label">${t('shadowBackup.title')}</div>
     <div class="card-value">${esc(relativeTime(s.timestamp))}</div>
-    <div class="card-detail text-muted text-sm">${esc(formatTime(s.timestamp))}</div>
-  `;
-}
-
-function renderWatcherCard(watcher) {
-  const el = $('#card-watcher');
+    <div class="card-detail text-muted text-sm">${esc(formatTime(s.timestamp))}</div>
+  `;
+}
+
+function renderPreWarningCard(preWarnings) {
+  const el = $('#card-prewarning');
+  if (!preWarnings?.active) {
+    el.innerHTML = `
+      <div class="card-label">${t('preWarning.title')}</div>
+      <div class="card-status"><span class="status-dot status-healthy"></span><span>${t('preWarning.none')}</span></div>
+    `;
+    return;
+  }
+
+  const warning = preWarnings.latest || {};
+  const file = warning.file || '-';
+  const risk = warning.riskPercent !== undefined ? `${warning.riskPercent}%` : '-';
+  const methods = warning.removedMethodCount || 0;
+
+  el.innerHTML = `
+    <div class="card-label">${t('preWarning.title')}</div>
+    <div class="card-status"><span class="status-dot status-warning"></span><span class="status-text status-warning">${t('preWarning.active')}</span></div>
+    <div class="alert-details">
+      <div class="alert-detail-row"><span class="alert-detail-label">${t('preWarning.file')}</span><span class="text-mono">${esc(file)}</span></div>
+      <div class="alert-detail-row"><span class="alert-detail-label">${t('preWarning.risk')}</span><span>${esc(risk)}</span></div>
+      ${methods > 0 ? `<div class="alert-detail-row"><span class="alert-detail-label">${t('preWarning.methods')}</span><span>${methods}</span></div>` : ''}
+      <div class="alert-detail-row alert-breakdown text-sm">${esc(warning.summary || t('preWarning.suggestion'))}</div>
+      <div class="alert-detail-row alert-suggestion text-sm text-muted">${t('preWarning.suggestion')}</div>
+    </div>
+  `;
+}
+
+function renderWatcherCard(watcher) {
+  const el = $('#card-watcher');
   let st = 'stopped';
   if (watcher?.running) st = 'running';
   else if (watcher?.stale) st = 'stale';

package/references/vscode-extension/dist/dashboard/public/index.html

@@ -44,13 +44,14 @@
     <section id="screen-overview" class="screen">
       <h2 class="section-title" data-i18n="overview.title">Overview</h2>
       <div id="overview-grid" class="card-grid">
-        <div id="card-health" class="card card-health"><div class="skeleton-block"></div></div>
-        <div id="card-git-backup" class="card"><div class="skeleton-block"></div></div>
-        <div id="card-shadow-backup" class="card"><div class="skeleton-block"></div></div>
-        <div id="card-watcher" class="card"><div class="skeleton-block"></div></div>
-        <div id="card-alert" class="card"><div class="skeleton-block"></div></div>
-      </div>
-    </section>
+      <div id="card-health" class="card card-health"><div class="skeleton-block"></div></div>
+      <div id="card-git-backup" class="card"><div class="skeleton-block"></div></div>
+      <div id="card-shadow-backup" class="card"><div class="skeleton-block"></div></div>
+      <div id="card-prewarning" class="card"><div class="skeleton-block"></div></div>
+      <div id="card-watcher" class="card"><div class="skeleton-block"></div></div>
+      <div id="card-alert" class="card"><div class="skeleton-block"></div></div>
+    </div>
+  </section>
 
     <!-- Screen 2: Backups & Recovery ─────────────────────── -->
     <section id="screen-backups" class="screen">

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

@@ -11,18 +11,377 @@ const { Poller } = require('./lib/poller');
 const { SidebarDashboardProvider } = require('./lib/sidebar-webview');
 const { autoSetup } = require('./lib/auto-setup');
 const { guardPath } = require('./lib/paths');
+const { getLocale } = require('./lib/locale');
+
+let dashMgr, poller, statusBar, treeView, webviewProvider, sidebarProvider, _localeStorage;
+const _preWarningBaselines = new Map();
+const _preWarningTimers = new Map();
+const _preWarningFingerprints = new Map();
+const PRE_WARNING_DEBOUNCE_MS = 200;
+const PRE_WARNING_POPUP_COOLDOWN_MS = 5000;
+const PRE_WARNING_AUTO_CONTINUE_MS = 2000;
+const PRE_WARNING_POPUP_TICK_MS = 250;
+const PRE_WARNING_I18N = {
+  'en-US': {
+    'diff.title': 'Cursor Guard Pre-Warning: {file}',
+    'picker.title': 'Cursor Guard Review · auto-continue in {time}',
+    'picker.placeholder': 'Risky deletion detected in {file} · {summary}',
+    'picker.methods': 'methods',
+    'action.undo.label': '$(discard) Undo Change',
+    'action.undo.description': 'Revert this deletion now',
+    'action.undo.detail': 'Safest option. Restore the latest edit batch immediately.',
+    'action.diff.label': '$(diff) View Diff',
+    'action.diff.description': 'Inspect before and after',
+    'action.diff.detail': 'Open a diff view and keep the current edit for now.',
+    'action.keep.label': '$(check) Keep Changes',
+    'action.keep.description': 'Accept this edit',
+    'action.keep.detail': 'Dismiss this warning and continue working.',
+    'status.diffOpen': '$(shield) Cursor Guard review open for {file}',
+    'summary.methods.one': '{n} method removed',
+    'summary.methods.other': '{n} methods removed',
+    'summary.lines.one': '{n} line deleted',
+    'summary.lines.other': '{n} lines deleted',
+    'summary.risk': 'risk {n}%',
+  },
+  'zh-CN': {
+    'diff.title': 'Cursor Guard 预警对比：{file}',
+    'picker.title': 'Cursor Guard \u9884\u8b66 - {time} \u540e\u81ea\u52a8\u7ee7\u7eed',
+    'picker.placeholder': '\u68c0\u6d4b\u5230\u5220\u9664\u98ce\u9669\uff1a{file} - {summary}',
+    'picker.methods': '方法',
+    'action.undo.label': '$(discard) 撤销此次修改',
+    'action.undo.description': '立即回退这次删除',
+    'action.undo.detail': '这是最安全的选择，会马上撤销刚刚这一批编辑。',
+    'action.diff.label': '$(diff) 查看 Diff',
+    'action.diff.description': '先对比再决定',
+    'action.diff.detail': '打开前后差异视图，暂时保留当前修改。',
+    'action.keep.label': '$(check) 保留修改',
+    'action.keep.description': '接受这次编辑',
+    'action.keep.detail': '关闭这次预警并继续当前流程。',
+    'status.diffOpen': '$(shield) Cursor Guard 已打开预警对比：{file}',
+    'summary.methods.one': '删除了 {n} 个方法',
+    'summary.methods.other': '删除了 {n} 个方法',
+    'summary.lines.one': '删除了 {n} 行',
+    'summary.lines.other': '删除了 {n} 行',
+    'summary.risk': '风险 {n}%',
+  },
+};
+
+function _docKey(document) {
+  return document.uri.toString();
+}
+
+function _uiLocale() {
+  return getLocale(_localeStorage);
+}
+
+function _tp(key, params) {
+  const locale = _uiLocale();
+  const dict = PRE_WARNING_I18N[locale] || PRE_WARNING_I18N['en-US'];
+  let value = dict[key] || PRE_WARNING_I18N['en-US'][key] || key;
+  for (const [name, replacement] of Object.entries(params || {})) {
+    value = value.replaceAll(`{${name}}`, String(replacement));
+  }
+  return value;
+}
+
+function _pluralKey(baseKey, count) {
+  return `${baseKey}.${count === 1 ? 'one' : 'other'}`;
+}
+
+function _buildPreWarningSummary(warning) {
+  const parts = [];
+  if (warning.removedMethodCount > 0) {
+    parts.push(_tp(_pluralKey('summary.methods', warning.removedMethodCount), {
+      n: warning.removedMethodCount,
+    }));
+  }
+  if (warning.deletedLines > 0) {
+    parts.push(_tp(_pluralKey('summary.lines', warning.deletedLines), {
+      n: warning.deletedLines,
+    }));
+  }
+  parts.push(_tp('summary.risk', { n: warning.riskPercent || 0 }));
+  return parts.join(_uiLocale() === 'zh-CN' ? '，' : ', ');
+}
+
+function _getPreWarningDeps() {
+  return {
+    loadConfig: require(guardPath('lib', 'utils')).loadConfig,
+    ...require(guardPath('lib', 'core', 'pre-warning')),
+  };
+}
+
+function _getProjectInfo(document) {
+  if (!document || document.uri.scheme !== 'file') return null;
+  const folder = vscode.workspace.getWorkspaceFolder(document.uri);
+  if (!folder) return null;
+  const projectPath = folder.uri.fsPath;
+  const relPath = path.relative(projectPath, document.uri.fsPath).replace(/\\/g, '/');
+  if (!relPath || relPath.startsWith('..')) return null;
+  return { projectPath, relPath };
+}
+
+function _seedBaseline(document) {
+  if (!document || document.uri.scheme !== 'file') return;
+  _preWarningBaselines.set(_docKey(document), document.getText());
+}
+
+function _clearDocPreWarningState(document) {
+  const key = _docKey(document);
+  const timer = _preWarningTimers.get(key);
+  if (timer) clearTimeout(timer);
+  _preWarningTimers.delete(key);
+  _preWarningBaselines.delete(key);
+  _preWarningFingerprints.delete(key);
+}
+
+function _isLikelyDeleteBatch(event) {
+  const deletedChars = event.contentChanges.reduce((sum, change) => {
+    return sum + Math.max(0, change.rangeLength - (change.text || '').length);
+  }, 0);
+  const deletedLines = event.contentChanges.reduce((sum, change) => {
+    return sum + Math.max(0, change.range.end.line - change.range.start.line);
+  }, 0);
+  return deletedChars >= 8
+    || deletedLines > 0
+    || event.contentChanges.some(change => change.rangeLength >= 20 || (change.rangeLength > 0 && !change.text));
+}
+
+async function _openPreWarningDiff(document, previousText) {
+  const beforeDoc = await vscode.workspace.openTextDocument({
+    language: document.languageId,
+    content: previousText,
+  });
+  await vscode.commands.executeCommand(
+    'vscode.diff',
+    beforeDoc.uri,
+    document.uri,
+    _tp('diff.title', { file: path.basename(document.uri.fsPath) })
+  );
+}
+
+function _formatPreWarningCountdown(remainingMs) {
+  return `${Math.max(1, Math.ceil(remainingMs / 1000))}s`;
+}
+
+async function _showPreWarningPopup(document, relPath, previousText, warning, projectPath) {
+  const { clearPreWarning } = _getPreWarningDeps();
+  const summary = _buildPreWarningSummary(warning);
+  const methodHint = Array.isArray(warning.removedMethods) && warning.removedMethods.length > 0
+    ? warning.removedMethods.slice(0, 3).map(m => `${m.name}:${m.lineNumber}`).join(', ')
+    : '';
+  const summaryLine = methodHint
+    ? `${summary} - ${_tp('picker.methods')}: ${methodHint}`
+    : summary;
+
+  return new Promise((resolve) => {
+    const picker = vscode.window.createQuickPick();
+    const items = [
+      {
+        label: '$(discard) Undo Change',
+        description: 'Revert this deletion now',
+        detail: 'Safest option. Restore the latest edit batch immediately.',
+        action: 'undo',
+      },
+      {
+        label: '$(diff) View Diff',
+        description: 'Inspect before and after',
+        detail: 'Open a diff view and keep the current edit for now.',
+        action: 'diff',
+      },
+      {
+        label: '$(check) Keep Changes',
+        description: 'Accept this edit',
+        detail: 'Dismiss this warning and continue working.',
+        action: 'keep',
+      },
+    ];
+
+    let settled = false;
+    let remainingMs = PRE_WARNING_AUTO_CONTINUE_MS;
+    let timer = null;
+
+    const finish = async (action) => {
+      if (settled) return;
+      settled = true;
+      if (timer) clearInterval(timer);
+      try { picker.hide(); } catch { /* ignore */ }
+      picker.dispose();
+
+      if (action === 'undo') {
+        await vscode.window.showTextDocument(document, { preview: false, preserveFocus: false });
+        await vscode.commands.executeCommand('undo');
+        clearPreWarning(projectPath, relPath);
+        if (poller) poller.forceRefresh();
+        resolve('undo');
+        return;
+      }
+
+      if (action === 'diff') {
+        clearPreWarning(projectPath, relPath);
+        if (poller) poller.forceRefresh();
+        await _openPreWarningDiff(document, previousText);
+        vscode.window.setStatusBarMessage(
+          _tp('status.diffOpen', { file: path.basename(relPath) }),
+          2500
+        );
+        resolve('diff');
+        return;
+      }
+
+      clearPreWarning(projectPath, relPath);
+      if (poller) poller.forceRefresh();
+      resolve(action);
+    };
+
+    const updatePicker = () => {
+      picker.title = _tp('picker.title', {
+        time: _formatPreWarningCountdown(remainingMs),
+      });
+      picker.placeholder = _tp('picker.placeholder', {
+        file: relPath,
+        summary: summaryLine,
+      });
+      picker.items = [
+        {
+          label: _tp('action.undo.label'),
+          description: _tp('action.undo.description'),
+          detail: _tp('action.undo.detail'),
+          action: 'undo',
+        },
+        {
+          label: _tp('action.diff.label'),
+          description: _tp('action.diff.description'),
+          detail: _tp('action.diff.detail'),
+          action: 'diff',
+        },
+        {
+          label: _tp('action.keep.label'),
+          description: _tp('action.keep.description'),
+          detail: _tp('action.keep.detail'),
+          action: 'keep',
+        },
+      ];
+      picker.matchOnDescription = true;
+      picker.matchOnDetail = true;
+      picker.ignoreFocusOut = false;
+    };
+
+    picker.onDidAccept(() => {
+      const selected = picker.selectedItems[0];
+      finish(selected?.action || 'keep').catch(() => resolve());
+    });
+    picker.onDidHide(() => {
+      if (!settled) {
+        finish('timeout').catch(() => resolve());
+      }
+    });
+
+    updatePicker();
+    picker.show();
+
+    timer = setInterval(() => {
+      remainingMs -= PRE_WARNING_POPUP_TICK_MS;
+      if (remainingMs <= 0) {
+        finish('timeout').catch(() => resolve());
+        return;
+      }
+      updatePicker();
+    }, PRE_WARNING_POPUP_TICK_MS);
+  });
+}
+
+async function _assessPreWarning(document) {
+  if (!document || document.isClosed || document.uri.scheme !== 'file') return;
+
+  const info = _getProjectInfo(document);
+  if (!info) return;
 
-let dashMgr, poller, statusBar, treeView, webviewProvider, sidebarProvider;
+  const key = _docKey(document);
+  const previousText = _preWarningBaselines.get(key) ?? document.getText();
+  const deps = _getPreWarningDeps();
+  const { cfg } = deps.loadConfig(info.projectPath);
+
+  if (!deps.isPreWarningEnabled(cfg) || deps.shouldExcludePreWarning(info.relPath, cfg)) {
+    deps.clearPreWarning(info.projectPath, info.relPath);
+    _preWarningFingerprints.delete(key);
+    if (poller) poller.forceRefresh();
+    return;
+  }
+
+  const assessment = deps.assessDeletionRisk(previousText, document.getText(), {
+    threshold: cfg.pre_warning_threshold,
+  });
+
+  if (!assessment.triggered) {
+    deps.clearPreWarning(info.projectPath, info.relPath);
+    _preWarningFingerprints.delete(key);
+    if (poller) poller.forceRefresh();
+    return;
+  }
+
+  const warning = {
+    file: info.relPath,
+    mode: cfg.pre_warning_mode,
+    threshold: cfg.pre_warning_threshold,
+    deletedLines: assessment.deletedLines,
+    removedMethodCount: assessment.removedMethodCount,
+    removedMethods: assessment.removedMethods.slice(0, 10),
+    riskPercent: assessment.riskPercent,
+    summary: assessment.summary,
+    deletedLineSamples: assessment.deletedLineSamples,
+  };
+
+  const fingerprint = JSON.stringify([
+    warning.file,
+    warning.deletedLines,
+    warning.removedMethodCount,
+    warning.riskPercent,
+    warning.removedMethods.map(m => m.name).join(','),
+  ]);
+  const last = _preWarningFingerprints.get(key);
+
+  if (cfg.pre_warning_mode === 'popup') {
+    if (last?.suppressed) return;
+    if (last && last.fingerprint === fingerprint && Date.now() - last.at < PRE_WARNING_POPUP_COOLDOWN_MS) {
+      return;
+    }
+  }
+
+  deps.recordPreWarning(info.projectPath, warning, {
+    setActive: cfg.pre_warning_mode === 'dashboard',
+  });
+  if (poller) poller.forceRefresh();
+
+  if (cfg.pre_warning_mode === 'silent') {
+    _preWarningFingerprints.set(key, { fingerprint, at: Date.now(), suppressed: false });
+    console.warn(`[cursor-guard] pre-warning ${info.relPath}: ${warning.summary}`);
+    return;
+  }
+
+  if (cfg.pre_warning_mode === 'popup') {
+    const action = await _showPreWarningPopup(document, info.relPath, previousText, warning, info.projectPath);
+    if (action === 'undo') {
+      _preWarningFingerprints.delete(key);
+      return;
+    }
+    _preWarningFingerprints.set(key, { fingerprint, at: Date.now(), suppressed: true });
+    return;
+  }
+
+  _preWarningFingerprints.set(key, { fingerprint, at: Date.now(), suppressed: false });
+}
 
 async function activate(context) {
   await autoSetup(context, vscode);
+  _localeStorage = context.globalState;
 
   dashMgr = new DashboardManager();
   poller = new Poller(dashMgr);
   statusBar = new StatusBarController(poller);
   treeView = new GuardTreeView(poller, dashMgr);
   webviewProvider = new WebViewProvider(context, dashMgr);
-  sidebarProvider = new SidebarDashboardProvider(poller);
+  sidebarProvider = new SidebarDashboardProvider(poller, context);
 
   context.subscriptions.push(
     vscode.window.registerWebviewViewProvider('cursorGuardDashboard', sidebarProvider),
@@ -127,7 +486,7 @@ async function activate(context) {
         const summary = b.summary ? b.summary.slice(0, 60) : '';
         return {
           label: `$(git-commit) ${time}`,
-          description: `${b.type || 'auto'} · ${files}`,
+          description: `${b.type || 'auto'} - ${files}`,
           detail: summary,
           hash: b.commitHash,
         };
@@ -161,7 +520,7 @@ async function activate(context) {
         } else if (warned > 0) {
           vscode.window.showWarningMessage(`Cursor Guard: ${msg}`);
         } else {
-          vscode.window.showInformationMessage(`Cursor Guard: ${msg} ✓`);
+          vscode.window.showInformationMessage(`Cursor Guard: ${msg}`);
         }
       } catch (e) {
         vscode.window.showErrorMessage(`Cursor Guard Doctor: ${e.message}`);
@@ -189,7 +548,6 @@ async function activate(context) {
     vscode.window.showInformationMessage(`Cursor Guard: dashboard started on port ${dashMgr.port}`);
   }
 
-  // Event-driven UI refresh: FileSystemWatcher triggers immediate poller refresh
   let _fsRefreshTimer = null;
   const _scheduleRefresh = () => {
     if (_fsRefreshTimer) clearTimeout(_fsRefreshTimer);
@@ -201,7 +559,50 @@ async function activate(context) {
   fileWatcher.onDidDelete(_scheduleRefresh);
   context.subscriptions.push(fileWatcher);
 
+  for (const document of vscode.workspace.textDocuments) {
+    _seedBaseline(document);
+  }
+
   context.subscriptions.push(
+    vscode.workspace.onDidOpenTextDocument(document => {
+      _seedBaseline(document);
+    }),
+    vscode.workspace.onDidCloseTextDocument(document => {
+      const info = _getProjectInfo(document);
+      _clearDocPreWarningState(document);
+      if (info) {
+        const { clearPreWarning } = _getPreWarningDeps();
+        clearPreWarning(info.projectPath, info.relPath);
+        if (poller) poller.forceRefresh();
+      }
+    }),
+    vscode.workspace.onDidSaveTextDocument(document => {
+      const info = _getProjectInfo(document);
+      _seedBaseline(document);
+      _preWarningFingerprints.delete(_docKey(document));
+      if (info) {
+        const { clearPreWarning } = _getPreWarningDeps();
+        clearPreWarning(info.projectPath, info.relPath);
+        if (poller) poller.forceRefresh();
+      }
+    }),
+    vscode.workspace.onDidChangeTextDocument(event => {
+      const info = _getProjectInfo(event.document);
+      if (!info || !_isLikelyDeleteBatch(event)) return;
+
+      const key = _docKey(event.document);
+      const existing = _preWarningTimers.get(key);
+      if (existing) clearTimeout(existing);
+
+      const timer = setTimeout(() => {
+        _preWarningTimers.delete(key);
+        _assessPreWarning(event.document).catch(err => {
+          console.warn(`[cursor-guard] pre-warning failed for ${info.relPath}: ${err.message}`);
+        });
+      }, PRE_WARNING_DEBOUNCE_MS);
+
+      _preWarningTimers.set(key, timer);
+    }),
     vscode.workspace.onDidChangeWorkspaceFolders(async () => {
       const restarted = await dashMgr.autoStart(vscode.workspace.workspaceFolders);
       if (restarted && !poller._timer) poller.start();

package/references/vscode-extension/dist/guard-version.json

@@ -1 +1 @@
-{"version":"4.9.1"}
+{"version":"4.9.8"}