cursor-guard 4.9.9 → 4.9.15

package/references/vscode-extension/extension.js

@@ -1,704 +1,780 @@
-'use strict';
-
-const vscode = require('vscode');
-const fs = require('fs');
-const path = require('path');
-const { DashboardManager } = require('./lib/dashboard-manager');
-const { WebViewProvider } = require('./lib/webview-provider');
-const { StatusBarController } = require('./lib/status-bar');
-const { GuardTreeView } = require('./lib/tree-view');
-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;
-
-  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, context);
-
-  context.subscriptions.push(
-    vscode.window.registerWebviewViewProvider('cursorGuardDashboard', sidebarProvider),
-
-    vscode.commands.registerCommand('cursorGuard.openDashboard', async () => {
-      if (!dashMgr.running) {
-        const action = await vscode.window.showWarningMessage(
-          'Cursor Guard: Dashboard server not running.',
-          'Start Server', 'Cancel'
-        );
-        if (action === 'Start Server') {
-          const folders = vscode.workspace.workspaceFolders;
-          if (folders) {
-            await dashMgr.ensureRunning(folders.map(f => f.uri.fsPath));
-          }
-          if (!dashMgr.running) {
-            vscode.window.showErrorMessage('Cursor Guard: failed to start dashboard server.');
-            return;
-          }
-        } else {
-          return;
-        }
-      }
-      webviewProvider.show();
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.snapshotNow', async () => {
-      const folders = vscode.workspace.workspaceFolders;
-      if (!folders || folders.length === 0) return;
-      const projectPath = folders[0].uri.fsPath;
-      const result = await dashMgr.snapshotNow(projectPath);
-      if (result?.status === 'created') {
-        const n = result.changedCount ?? 0;
-        const msg =
-          n > 0
-            ? `Cursor Guard: snapshot created (${n} file change(s))`
-            : 'Cursor Guard: snapshot created (restore point saved; no file changes since last snapshot)';
-        vscode.window.showInformationMessage(msg);
-      } else if (result?.status === 'unchanged' || result?.status === 'skipped') {
-        vscode.window.showInformationMessage(
-          `Cursor Guard: no snapshot created (${result.reason || 'unchanged'})`
-        );
-      } else if (result?.status === 'error') {
-        vscode.window.showWarningMessage(`Cursor Guard: ${result.error}`);
-      } else {
-        vscode.window.showWarningMessage(`Cursor Guard: snapshot returned status "${result?.status || 'unknown'}"`);
-      }
-      poller.forceRefresh();
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.startWatcher', async () => {
-      const folders = vscode.workspace.workspaceFolders;
-      if (!folders || folders.length === 0) {
-        vscode.window.showWarningMessage('Cursor Guard: no workspace folder open.');
-        return;
-      }
-      const projectPath = folders[0].uri.fsPath;
-      const existingPid = dashMgr.getWatcherPid(projectPath);
-      if (existingPid) {
-        vscode.window.showInformationMessage(`Cursor Guard: watcher already running (PID ${existingPid})`);
-        return;
-      }
-      const pid = dashMgr.startWatcher(projectPath);
-      if (pid) {
-        vscode.window.showInformationMessage(`Cursor Guard: watcher started (PID ${pid})`);
-        setTimeout(() => poller.forceRefresh(), 2000);
-      } else {
-        vscode.window.showWarningMessage('Cursor Guard: failed to start watcher');
-      }
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.stopWatcher', async () => {
-      const folders = vscode.workspace.workspaceFolders;
-      if (!folders || folders.length === 0) return;
-      const projectPath = folders[0].uri.fsPath;
-      const stopped = dashMgr.stopWatcher(projectPath);
-      if (stopped) {
-        vscode.window.showInformationMessage('Cursor Guard: watcher stopped');
-        setTimeout(() => poller.forceRefresh(), 1000);
-      } else {
-        vscode.window.showWarningMessage('Cursor Guard: no running watcher found');
-      }
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.refreshTree', () => {
-      poller.forceRefresh();
-      treeView.refresh();
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.quickRestore', async () => {
-      const folders = vscode.workspace.workspaceFolders;
-      if (!folders || folders.length === 0) return;
-      if (!dashMgr.running) {
-        vscode.window.showWarningMessage('Cursor Guard: dashboard not running. Cannot list backups.');
-        return;
-      }
-      const projects = await dashMgr.fetchApi('/api/projects');
-      if (!projects || projects.length === 0) return;
-      const pid = projects[0].id;
-      const pageData = await dashMgr.getFullPageData(pid);
-      const backups = (pageData?.backups || []).slice(0, 8);
-      if (backups.length === 0) {
-        vscode.window.showInformationMessage('Cursor Guard: no backups available to restore from.');
-        return;
-      }
-      const items = backups.map(b => {
-        const time = b.timestamp ? new Date(b.timestamp).toLocaleString() : '?';
-        const files = b.filesChanged ? `${b.filesChanged} files` : '';
-        const summary = b.summary ? b.summary.slice(0, 60) : '';
-        return {
-          label: `$(git-commit) ${time}`,
-          description: `${b.type || 'auto'} - ${files}`,
-          detail: summary,
-          hash: b.commitHash,
-        };
-      });
-      const selected = await vscode.window.showQuickPick(items, {
-        placeHolder: 'Select a backup to restore from',
-        title: 'Cursor Guard: Quick Restore',
-      });
-      if (selected && selected.hash) {
-        const url = `${dashMgr.baseUrl}?token=${dashMgr.token}`;
-        vscode.env.openExternal(vscode.Uri.parse(url));
-        vscode.window.showInformationMessage(
-          `Cursor Guard: opening dashboard for restore. Selected backup: ${selected.hash.slice(0, 7)}`
-        );
-      }
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.doctor', async () => {
-      const folders = vscode.workspace.workspaceFolders;
-      if (!folders || folders.length === 0) return;
-      const projectPath = folders[0].uri.fsPath;
-      try {
-        const { runDiagnostics } = require(guardPath('lib', 'core', 'doctor'));
-        const result = runDiagnostics(projectPath);
-        const passed = result.checks.filter(c => c.status === 'PASS').length;
-        const warned = result.checks.filter(c => c.status === 'WARN').length;
-        const failed = result.checks.filter(c => c.status === 'FAIL').length;
-        const msg = `Doctor: ${passed} passed, ${warned} warnings, ${failed} failed`;
-        if (failed > 0) {
-          vscode.window.showErrorMessage(`Cursor Guard: ${msg}`);
-        } else if (warned > 0) {
-          vscode.window.showWarningMessage(`Cursor Guard: ${msg}`);
-        } else {
-          vscode.window.showInformationMessage(`Cursor Guard: ${msg}`);
-        }
-      } catch (e) {
-        vscode.window.showErrorMessage(`Cursor Guard Doctor: ${e.message}`);
-      }
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.addToProtect', (uri) => {
-      _modifyGuardConfig(uri, 'protect');
-    }),
-
-    vscode.commands.registerCommand('cursorGuard.addToIgnore', (uri) => {
-      _modifyGuardConfig(uri, 'ignore');
-    }),
-
-    statusBar,
-    poller,
-    treeView,
-    webviewProvider,
-    sidebarProvider,
-  );
-
-  const started = await dashMgr.autoStart(vscode.workspace.workspaceFolders);
-  if (started) {
-    poller.start();
-    vscode.window.showInformationMessage(`Cursor Guard: dashboard started on port ${dashMgr.port}`);
-  }
-
-  let _fsRefreshTimer = null;
-  const _scheduleRefresh = () => {
-    if (_fsRefreshTimer) clearTimeout(_fsRefreshTimer);
-    _fsRefreshTimer = setTimeout(() => poller.forceRefresh(), 1500);
-  };
-  const fileWatcher = vscode.workspace.createFileSystemWatcher('**/*', false, false, false);
-  fileWatcher.onDidChange(_scheduleRefresh);
-  fileWatcher.onDidCreate(_scheduleRefresh);
-  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();
-      poller.forceRefresh();
-    })
-  );
-}
-
-async function _modifyGuardConfig(uri, field) {
-  const folders = vscode.workspace.workspaceFolders;
-  if (!folders || folders.length === 0) {
-    vscode.window.showWarningMessage('Cursor Guard: no workspace folder open.');
-    return;
-  }
-
-  let targetUri = uri;
-  if (!targetUri) {
-    const editor = vscode.window.activeTextEditor;
-    if (editor) targetUri = editor.document.uri;
-  }
-  if (!targetUri) {
-    vscode.window.showWarningMessage('Cursor Guard: no file or folder selected.');
-    return;
-  }
-
-  const wsRoot = folders[0].uri.fsPath;
-  const configPath = path.join(wsRoot, '.cursor-guard.json');
-  const targetPath = targetUri.fsPath;
-
-  const relative = path.relative(wsRoot, targetPath).replace(/\\/g, '/');
-  if (!relative || relative.startsWith('..')) {
-    vscode.window.showWarningMessage('Cursor Guard: selected path is outside the workspace.');
-    return;
-  }
-
-  let isDir = false;
-  try { isDir = fs.statSync(targetPath).isDirectory(); } catch { /* file */ }
-  const pattern = isDir ? `${relative}/**` : relative;
-
-  const action = field === 'protect' ? 'Add to Protected' : 'Exclude from Protection';
-  const pick = await vscode.window.showQuickPick(
-    [
-      { label: pattern, description: isDir ? 'directory glob' : 'exact file' },
-      { label: `${path.basename(targetPath)}`, description: 'filename only (matches anywhere)' },
-      ...(isDir ? [] : [{ label: `*.${path.extname(targetPath).slice(1)}`, description: 'file extension' }]),
-      { label: '$(edit) Custom pattern...', description: 'enter your own glob', custom: true },
-    ],
-    { placeHolder: `${action}: choose a pattern`, title: `Cursor Guard: ${action}` }
-  );
-  if (!pick) return;
-
-  let chosenPattern = pick.label;
-  if (pick.custom) {
-    const input = await vscode.window.showInputBox({
-      prompt: `Enter a glob pattern to ${field === 'protect' ? 'protect' : 'exclude'}`,
-      value: pattern,
-    });
-    if (!input) return;
-    chosenPattern = input;
-  }
-
-  let config = {};
-  if (fs.existsSync(configPath)) {
-    try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch { config = {}; }
-  }
-
-  if (!Array.isArray(config[field])) config[field] = [];
-
-  if (config[field].includes(chosenPattern)) {
-    vscode.window.showInformationMessage(`Cursor Guard: "${chosenPattern}" already in ${field} list.`);
-    return;
-  }
-
-  config[field].push(chosenPattern);
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-
-  const label = field === 'protect' ? 'Protected' : 'Excluded';
-  vscode.window.showInformationMessage(`Cursor Guard: "${chosenPattern}" added to ${label} list.`);
-
-  if (poller) poller.forceRefresh();
-}
-
-function deactivate() {
-  if (poller) poller.dispose();
-  if (statusBar) statusBar.dispose();
-  if (treeView) treeView.dispose();
-  if (webviewProvider) webviewProvider.dispose();
-  if (sidebarProvider) sidebarProvider.dispose();
-  if (dashMgr) dashMgr.dispose();
-}
-
-module.exports = { activate, deactivate };
+'use strict';
+
+const vscode = require('vscode');
+const fs = require('fs');
+const path = require('path');
+const { DashboardManager } = require('./lib/dashboard-manager');
+const { WebViewProvider } = require('./lib/webview-provider');
+const { StatusBarController } = require('./lib/status-bar');
+const { GuardTreeView } = require('./lib/tree-view');
+const { Poller } = require('./lib/poller');
+const { SidebarDashboardProvider } = require('./lib/sidebar-webview');
+const { autoSetup, installAgentSkill, detectIdeDir, getExtensionRoot } = 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;
+
+  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 });
+}
+
+/** After autoSetup: toast when something changed, or once when Skill path is ready (locale-aware). */
+function notifyGuardSkillSetup(vscode, context, setup) {
+  const locale = getLocale(context.globalState);
+  const isZh = locale === 'zh-CN';
+  const openLabel = isZh ? '打开 Skill 目录' : 'Open Skill Folder';
+  const { actions = [], skillPath } = setup || {};
+
+  const offerOpen = (msg) => {
+    if (!skillPath) {
+      vscode.window.showInformationMessage(msg);
+      return;
+    }
+    vscode.window.showInformationMessage(msg, openLabel).then((sel) => {
+      if (sel === openLabel) vscode.env.openExternal(vscode.Uri.file(skillPath));
+    });
+  };
+
+  if (actions.length > 0) {
+    const detail = actions.join(isZh ? '、' : ', ');
+    const msg = isZh
+      ? `Cursor Guard：已自动完成首装（${detail}）。Agent 可使用用户目录下的 cursor-guard Skill。`
+      : `Cursor Guard: first-time setup complete (${detail}). Agent Skill lives in your user skills folder (cursor-guard).`;
+    offerOpen(msg);
+    return;
+  }
+
+  if (skillPath && !context.globalState.get('cursorGuard.skillIdleHintShown')) {
+    void context.globalState.update('cursorGuard.skillIdleHintShown', true);
+    const msg = isZh
+      ? `Cursor Guard：Agent Skill 已在安装扩展时自动配置（${skillPath}）。命令面板可执行「Install Agent Skill」重新安装或打开目录。`
+      : `Cursor Guard: Agent Skill was auto-configured when you installed this extension (${skillPath}). Command Palette: "Install Agent Skill" to reinstall or open the folder.`;
+    offerOpen(msg);
+  }
+}
+
+async function activate(context) {
+  const setup = await autoSetup(context, vscode);
+  _localeStorage = context.globalState;
+  notifyGuardSkillSetup(vscode, context, setup);
+
+  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, context);
+
+  context.subscriptions.push(
+    vscode.window.registerWebviewViewProvider('cursorGuardDashboard', sidebarProvider),
+
+    vscode.commands.registerCommand('cursorGuard.openDashboard', async () => {
+      if (!dashMgr.running) {
+        const action = await vscode.window.showWarningMessage(
+          'Cursor Guard: Dashboard server not running.',
+          'Start Server', 'Cancel'
+        );
+        if (action === 'Start Server') {
+          const folders = vscode.workspace.workspaceFolders;
+          if (folders) {
+            await dashMgr.ensureRunning(folders.map(f => f.uri.fsPath));
+          }
+          if (!dashMgr.running) {
+            vscode.window.showErrorMessage('Cursor Guard: failed to start dashboard server.');
+            return;
+          }
+        } else {
+          return;
+        }
+      }
+      webviewProvider.show();
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.snapshotNow', async () => {
+      const folders = vscode.workspace.workspaceFolders;
+      if (!folders || folders.length === 0) return;
+      const projectPath = folders[0].uri.fsPath;
+      const result = await dashMgr.snapshotNow(projectPath);
+      if (result?.status === 'created') {
+        const n = result.changedCount ?? 0;
+        const msg = result.bookmark
+          ? 'Cursor Guard: bookmark snapshot saved (tree unchanged — timeline records intent & time).'
+          : n > 0
+            ? `Cursor Guard: snapshot created (${n} file change(s))`
+            : 'Cursor Guard: snapshot created (restore point saved; no file changes since last snapshot)';
+        vscode.window.showInformationMessage(msg);
+      } else if (result?.status === 'unchanged' || result?.status === 'skipped') {
+        vscode.window.showInformationMessage(
+          `Cursor Guard: no snapshot created (${result.reason || 'unchanged'})`
+        );
+      } else if (result?.status === 'error') {
+        vscode.window.showWarningMessage(`Cursor Guard: ${result.error}`);
+      } else {
+        vscode.window.showWarningMessage(`Cursor Guard: snapshot returned status "${result?.status || 'unknown'}"`);
+      }
+      poller.forceRefresh();
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.startWatcher', async () => {
+      const folders = vscode.workspace.workspaceFolders;
+      if (!folders || folders.length === 0) {
+        vscode.window.showWarningMessage('Cursor Guard: no workspace folder open.');
+        return;
+      }
+      const projectPath = folders[0].uri.fsPath;
+      const existingPid = dashMgr.getWatcherPid(projectPath);
+      if (existingPid) {
+        vscode.window.showInformationMessage(`Cursor Guard: watcher already running (PID ${existingPid})`);
+        return;
+      }
+      const pid = dashMgr.startWatcher(projectPath);
+      if (pid) {
+        vscode.window.showInformationMessage(`Cursor Guard: watcher started (PID ${pid})`);
+        setTimeout(() => poller.forceRefresh(), 2000);
+      } else {
+        vscode.window.showWarningMessage('Cursor Guard: failed to start watcher');
+      }
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.stopWatcher', async () => {
+      const folders = vscode.workspace.workspaceFolders;
+      if (!folders || folders.length === 0) return;
+      const projectPath = folders[0].uri.fsPath;
+      const stopped = dashMgr.stopWatcher(projectPath);
+      if (stopped) {
+        vscode.window.showInformationMessage('Cursor Guard: watcher stopped');
+        setTimeout(() => poller.forceRefresh(), 1000);
+      } else {
+        vscode.window.showWarningMessage('Cursor Guard: no running watcher found');
+      }
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.refreshTree', () => {
+      poller.forceRefresh();
+      treeView.refresh();
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.quickRestore', async () => {
+      const folders = vscode.workspace.workspaceFolders;
+      if (!folders || folders.length === 0) return;
+      if (!dashMgr.running) {
+        vscode.window.showWarningMessage('Cursor Guard: dashboard not running. Cannot list backups.');
+        return;
+      }
+      const projects = await dashMgr.fetchApi('/api/projects');
+      if (!projects || projects.length === 0) return;
+      const pid = projects[0].id;
+      const pageData = await dashMgr.getFullPageData(pid);
+      const backups = (pageData?.backups || []).slice(0, 8);
+      if (backups.length === 0) {
+        vscode.window.showInformationMessage('Cursor Guard: no backups available to restore from.');
+        return;
+      }
+      const items = backups.map(b => {
+        const time = b.timestamp ? new Date(b.timestamp).toLocaleString() : '?';
+        const files = b.filesChanged ? `${b.filesChanged} files` : '';
+        const summary = b.summary ? b.summary.slice(0, 60) : '';
+        return {
+          label: `$(git-commit) ${time}`,
+          description: `${b.type || 'auto'} - ${files}`,
+          detail: summary,
+          hash: b.commitHash,
+        };
+      });
+      const selected = await vscode.window.showQuickPick(items, {
+        placeHolder: 'Select a backup to restore from',
+        title: 'Cursor Guard: Quick Restore',
+      });
+      if (selected && selected.hash) {
+        const url = `${dashMgr.baseUrl}?token=${dashMgr.token}`;
+        vscode.env.openExternal(vscode.Uri.parse(url));
+        vscode.window.showInformationMessage(
+          `Cursor Guard: opening dashboard for restore. Selected backup: ${selected.hash.slice(0, 7)}`
+        );
+      }
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.doctor', async () => {
+      const folders = vscode.workspace.workspaceFolders;
+      if (!folders || folders.length === 0) return;
+      const projectPath = folders[0].uri.fsPath;
+      try {
+        const { runDiagnostics } = require(guardPath('lib', 'core', 'doctor'));
+        const result = runDiagnostics(projectPath);
+        const passed = result.checks.filter(c => c.status === 'PASS').length;
+        const warned = result.checks.filter(c => c.status === 'WARN').length;
+        const failed = result.checks.filter(c => c.status === 'FAIL').length;
+        const msg = `Doctor: ${passed} passed, ${warned} warnings, ${failed} failed`;
+        if (failed > 0) {
+          vscode.window.showErrorMessage(`Cursor Guard: ${msg}`);
+        } else if (warned > 0) {
+          vscode.window.showWarningMessage(`Cursor Guard: ${msg}`);
+        } else {
+          vscode.window.showInformationMessage(`Cursor Guard: ${msg}`);
+        }
+      } catch (e) {
+        vscode.window.showErrorMessage(`Cursor Guard Doctor: ${e.message}`);
+      }
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.setupSkill', async () => {
+      const extRoot = getExtensionRoot(context);
+      const { homePath, dirName } = detectIdeDir(vscode);
+      let r;
+      try {
+        r = installAgentSkill(extRoot, homePath, dirName);
+      } catch (e) {
+        vscode.window.showErrorMessage(`Cursor Guard: Install Agent Skill failed — ${e.message}`);
+        return;
+      }
+      const loc = getLocale(context.globalState);
+      const isZh = loc === 'zh-CN';
+      const openLabel = isZh ? '打开 Skill 目录' : 'Open Skill Folder';
+      if (!r.skillPath && r.actions.length === 0) {
+        vscode.window.showWarningMessage(
+          isZh
+            ? 'Cursor Guard：扩展包内未找到 SKILL.md，无法安装 Agent Skill。'
+            : 'Cursor Guard: bundled SKILL.md not found; cannot install Agent Skill.'
+        );
+        return;
+      }
+      if (r.actions.length > 0) {
+        const detail = r.actions.join(isZh ? '、' : ', ');
+        const msg = isZh
+          ? `Cursor Guard：已更新 Agent Skill（${detail}）。路径：${r.skillPath}`
+          : `Cursor Guard: Agent Skill updated (${detail}). Path: ${r.skillPath}`;
+        vscode.window.showInformationMessage(msg, openLabel).then((sel) => {
+          if (sel === openLabel && r.skillPath) vscode.env.openExternal(vscode.Uri.file(r.skillPath));
+        });
+      } else {
+        const msg = isZh
+          ? `Cursor Guard：Agent Skill 已就绪，无需变更（${r.skillPath}）。`
+          : `Cursor Guard: Agent Skill already up to date (${r.skillPath}).`;
+        vscode.window.showInformationMessage(msg, openLabel).then((sel) => {
+          if (sel === openLabel && r.skillPath) vscode.env.openExternal(vscode.Uri.file(r.skillPath));
+        });
+      }
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.addToProtect', (uri) => {
+      _modifyGuardConfig(uri, 'protect');
+    }),
+
+    vscode.commands.registerCommand('cursorGuard.addToIgnore', (uri) => {
+      _modifyGuardConfig(uri, 'ignore');
+    }),
+
+    statusBar,
+    poller,
+    treeView,
+    webviewProvider,
+    sidebarProvider,
+  );
+
+  const started = await dashMgr.autoStart(vscode.workspace.workspaceFolders);
+  if (started) {
+    poller.start();
+    vscode.window.showInformationMessage(`Cursor Guard: dashboard started on port ${dashMgr.port}`);
+  }
+
+  let _fsRefreshTimer = null;
+  const _scheduleRefresh = () => {
+    if (_fsRefreshTimer) clearTimeout(_fsRefreshTimer);
+    _fsRefreshTimer = setTimeout(() => poller.forceRefresh(), 1500);
+  };
+  const fileWatcher = vscode.workspace.createFileSystemWatcher('**/*', false, false, false);
+  fileWatcher.onDidChange(_scheduleRefresh);
+  fileWatcher.onDidCreate(_scheduleRefresh);
+  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();
+      poller.forceRefresh();
+    })
+  );
+}
+
+async function _modifyGuardConfig(uri, field) {
+  const folders = vscode.workspace.workspaceFolders;
+  if (!folders || folders.length === 0) {
+    vscode.window.showWarningMessage('Cursor Guard: no workspace folder open.');
+    return;
+  }
+
+  let targetUri = uri;
+  if (!targetUri) {
+    const editor = vscode.window.activeTextEditor;
+    if (editor) targetUri = editor.document.uri;
+  }
+  if (!targetUri) {
+    vscode.window.showWarningMessage('Cursor Guard: no file or folder selected.');
+    return;
+  }
+
+  const wsRoot = folders[0].uri.fsPath;
+  const configPath = path.join(wsRoot, '.cursor-guard.json');
+  const targetPath = targetUri.fsPath;
+
+  const relative = path.relative(wsRoot, targetPath).replace(/\\/g, '/');
+  if (!relative || relative.startsWith('..')) {
+    vscode.window.showWarningMessage('Cursor Guard: selected path is outside the workspace.');
+    return;
+  }
+
+  let isDir = false;
+  try { isDir = fs.statSync(targetPath).isDirectory(); } catch { /* file */ }
+  const pattern = isDir ? `${relative}/**` : relative;
+
+  const action = field === 'protect' ? 'Add to Protected' : 'Exclude from Protection';
+  const pick = await vscode.window.showQuickPick(
+    [
+      { label: pattern, description: isDir ? 'directory glob' : 'exact file' },
+      { label: `${path.basename(targetPath)}`, description: 'filename only (matches anywhere)' },
+      ...(isDir ? [] : [{ label: `*.${path.extname(targetPath).slice(1)}`, description: 'file extension' }]),
+      { label: '$(edit) Custom pattern...', description: 'enter your own glob', custom: true },
+    ],
+    { placeHolder: `${action}: choose a pattern`, title: `Cursor Guard: ${action}` }
+  );
+  if (!pick) return;
+
+  let chosenPattern = pick.label;
+  if (pick.custom) {
+    const input = await vscode.window.showInputBox({
+      prompt: `Enter a glob pattern to ${field === 'protect' ? 'protect' : 'exclude'}`,
+      value: pattern,
+    });
+    if (!input) return;
+    chosenPattern = input;
+  }
+
+  let config = {};
+  if (fs.existsSync(configPath)) {
+    try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch { config = {}; }
+  }
+
+  if (!Array.isArray(config[field])) config[field] = [];
+
+  if (config[field].includes(chosenPattern)) {
+    vscode.window.showInformationMessage(`Cursor Guard: "${chosenPattern}" already in ${field} list.`);
+    return;
+  }
+
+  config[field].push(chosenPattern);
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+  const label = field === 'protect' ? 'Protected' : 'Excluded';
+  vscode.window.showInformationMessage(`Cursor Guard: "${chosenPattern}" added to ${label} list.`);
+
+  if (poller) poller.forceRefresh();
+}
+
+function deactivate() {
+  if (poller) poller.dispose();
+  if (statusBar) statusBar.dispose();
+  if (treeView) treeView.dispose();
+  if (webviewProvider) webviewProvider.dispose();
+  if (sidebarProvider) sidebarProvider.dispose();
+  if (dashMgr) dashMgr.dispose();
+}
+
+module.exports = { activate, deactivate };