cursor-guard 4.9.8 → 4.9.9

package/README.md

@@ -5,7 +5,8 @@
 
 Protects your code from accidental AI overwrite or deletion in [Cursor](https://cursor.com).
 
-**[中文文档](README.zh-CN.md)**
+**[中文文档](README.zh-CN.md)**  
+**Release / 发版（maintainers & AI）:** [docs/RELEASE.md](docs/RELEASE.md)
 
 ---
 
@@ -467,6 +468,12 @@ The skill activates on these signals:
 
 ## Changelog
 
+### v4.9.9 — Dedicated release guide (`docs/RELEASE.md`)
+
+- **Docs**: New bilingual **[docs/RELEASE.md](docs/RELEASE.md)** for maintainers, developers, and AI agents (full procedure, Windows `gh` + UTF-8 `--notes-file`, npm OTP)
+- **Docs**: README / README.zh-CN link to the guide from the header and the release-checklist section; `npm run release:checklist` footer points to the same file
+- **Packaging**: `docs/RELEASE.md` added to npm `files` so it ships with the package
+
 ### v4.9.8 — Release docs, checklist script, sidebar brand asset
 
 - **Docs**: Bilingual **Release checklist** sections in README / README.zh-CN; steps tied to root `package.json` `version` so VSIX file name, Git tag, and npm stay consistent
@@ -628,6 +635,8 @@ The skill activates on these signals:
 
 **Single source of truth**: the `version` field in the **repository root** `package.json`. Running `references/vscode-extension/build-vsix.js` copies that value into the extension `package.json` and `guard-version.json`, so the VSIX and npm tarball stay aligned.
 
+**Full guide (bilingual, for humans and AI agents):** [docs/RELEASE.md](docs/RELEASE.md) — includes **Windows `gh` + UTF-8**: use `--notes-file` for GitHub Release bodies so Chinese text does not become mojibake.
+
 ### Generate a filled-in table (recommended)
 
 From the repository root:

package/README.zh-CN.md

@@ -5,7 +5,8 @@
 
 保护你的代码免受 [Cursor](https://cursor.com) AI 代理意外覆写或删除。
 
-**[English](README.md)**
+**[English](README.md)**  
+**发版流程（维护者 / 其他开发者 / AI）：** [docs/RELEASE.md](docs/RELEASE.md)
 
 ---
 
@@ -467,6 +468,12 @@ code --install-extension .
 
 ## 更新日志
 
+### v4.9.9 — 独立发版指南 docs/RELEASE.md
+
+- **文档**：新增中英双语 **[docs/RELEASE.md](docs/RELEASE.md)**，面向维护者、其他开发者及 **AI 助手**（完整步骤、Windows 下 `gh` 与 UTF-8 `--notes-file`、npm OTP 等）
+- **文档**：README / README.zh-CN 顶部与发版小节增加指向该指南的链接；`npm run release:checklist` 输出末尾提示同一文件
+- **打包**：`docs/RELEASE.md` 已加入 npm `files`，随包分发
+
 ### v4.9.8 — 发版文档、清单脚本、侧边栏品牌资源
 
 - **文档**：在 README / README.zh-CN 增加双语**发版检查清单**，步骤与根目录 `package.json` 的 `version` 绑定，避免 VSIX 名、Git 标签、npm 版本各写各的
@@ -627,6 +634,8 @@ code --install-extension .
 
 **唯一版本源**：仓库**根目录** `package.json` 里的 **`version`**。执行 `references/vscode-extension/build-vsix.js` 时，会把同一版本写入扩展内的 `package.json` 与 `guard-version.json`，因此 VSIX 与 npm 包版本一致。
 
+**完整发版指南（中英双语，给人看也给 AI 执行）：** [docs/RELEASE.md](docs/RELEASE.md) — 内含 **Windows 下 GitHub CLI**：Release 正文请用 UTF-8 文件 + `gh … --notes-file`，避免中文乱码。
+
 ### 生成已填好版本号的表格（推荐）
 
 在仓库根目录执行：

package/ROADMAP.md

@@ -3,8 +3,8 @@
 > 本文档描述 cursor-guard 从 V2 到 V7 的长期演进方向。
 > 每一代向下兼容，低版本功能永远不废弃。
 >
-> **当前版本**：`V4.9.8`
-> **文档状态**：`V2` ~ `V4.9.8` 已完成交付（含 V5 intent/audit 基础），`V5` 主体规划中
+> **当前版本**：`V4.9.9`
+> **文档状态**：`V2` ~ `V4.9.9` 已完成交付（含 V5 intent/audit 基础），`V5` 主体规划中
 
 ## 阅读导航
 
@@ -734,6 +734,12 @@ V4 经过 4 轮系统性代码审查，修复了以下关键问题：
 }
 ```
 
+### V4.9.9：独立发版指南（人 + AI）✅
+| 能力 | 说明 |
+|------|------|
+| **docs/RELEASE.md** | 中英双语完整发版流程：版本源、VSIX、Git、GitHub Release、npm OTP；**Windows 下 `gh` 须用 UTF-8 文件 + `--notes-file`** 避免 Release 正文乱码；专设「给其他 AI 助手」摘要 |
+| **入口** | README / README.zh-CN 顶部与发版小节链接；`print-release-checklist.js` 末尾提示；`package.json` `files` 纳入该文档以便 npm  tarball 携带 |
+
 ### V4.9.8：发版流程文档化 + 侧边栏品牌占位 ✅
 | 能力 | 说明 |
 |------|------|
@@ -1620,7 +1626,8 @@ V4.3.5 ─────  ✅ Summary 增量 diff-tree 修复 + 变更列堆叠布
 V4.4.0 ─────  ✅ V4 收官：首次快照 summary + doctor 完整性/retention 检查 + init 升级检测
 V4.9.0 ─────  ✅ 事件驱动 watcher + 实时侧边栏计时
 V4.9.5 ─────  ✅ 修复 `.git` 写入导致的疯狂自触发备份
-V4.9.8 ─────  ✅ 发版清单（README 双语 + checklist 脚本）+ 侧边栏品牌图  ← 当前版本
+V4.9.9 ─────  ✅ docs/RELEASE.md 发版指南（人 + AI）+ gh UTF-8 说明  ← 当前版本
+V4.9.8 ─────  ✅ 发版清单（README 双语 + checklist 脚本）+ 侧边栏品牌图
 V4.9.7 ─────  ✅ 预警体验打磨 + 语言同步 + watcher 单例保护
                │
                │  前提：MVP 已跑通，需要把提示从“能用”打磨到“适合常开”
@@ -1710,4 +1717,4 @@ V7 的"可验证治理"是这条产品线的逻辑终点——该保护的都保
 ---
 
 *最后更新：2026-03-22*
-*版本：v1.8（V4.9.8，在 V4.9.7 基础上增加发版流程文档与侧边栏品牌资源；历史能力含事件驱动 watcher、自触发备份反馈环修复、`pre_warning` 事先预警 MVP）*
+*版本：v1.9（V4.9.9，增加 docs/RELEASE.md 双语发版指南与 README 入口；历史含 V4.9.8 发版清单与侧边栏品牌、事件驱动 watcher、`pre_warning` 等）*

package/docs/RELEASE.md

@@ -0,0 +1,196 @@
+# Release guide / 发版流程指南
+
+**Audience / 读者**：本仓库维护者、其他开发者、以及需要代为执行发版步骤的 **AI 助手**（Agent）。  
+**Repo / 仓库**：<https://github.com/zhangqiang8vipp/cursor-guard>
+
+**Jump / 跳转**：[English](#english-for-maintainers-and-ai-agents) · [中文（维护者与 AI）](#中文维护者与-ai-助手)
+
+---
+
+## English (for maintainers and AI agents)
+
+### Single source of truth
+
+- All release versions come from the **repository root** `package.json` → field **`version`** (semver, e.g. `4.9.8`).
+- `references/vscode-extension/build-vsix.js` reads that value and writes the same version into:
+  - `references/vscode-extension/dist/package.json`
+  - `references/vscode-extension/dist/guard-version.json`
+- The **npm** package name is `cursor-guard@<version>`. The **VSIX** file name is always `cursor-guard-ide-<version>.vsix`.
+
+Never hand-type an old version in release notes while the repo already has a higher `version`.
+
+### Quick machine-readable checklist
+
+From the repo root:
+
+```bash
+npm run release:checklist
+```
+
+Copy the printed table into your tracker. It is always aligned with the current `package.json`.
+
+### Step-by-step release procedure
+
+1. **Bump version**  
+   Edit root `package.json` → `version`. Optionally sync `package-lock.json` (`npm install` or manual bump of the top-level `version` fields).
+
+2. **Run tests (recommended)**  
+   ```bash
+   npm test
+   ```
+
+3. **Build the VSIX**  
+   ```bash
+   cd references/vscode-extension
+   node build-vsix.js
+   cd dist
+   npx --yes @vscode/vsce package --no-dependencies
+   ```  
+   Output: `references/vscode-extension/dist/cursor-guard-ide-<version>.vsix`.
+
+4. **Commit**  
+   Include source changes, updated `dist/` if your workflow commits it, and the new `.vsix` if you ship it from the repo. Use a clear message, e.g. `release: vX.Y.Z — …`.
+
+5. **Tag and push**  
+   ```bash
+   git tag -a vX.Y.Z -m "vX.Y.Z"
+   git push origin <default-branch>
+   git push origin vX.Y.Z
+   ```
+
+6. **GitHub Release + attach VSIX**  
+   - Create a release for tag `vX.Y.Z` and attach `cursor-guard-ide-X.Y.Z.vsix`.  
+   - **Windows + GitHub CLI (`gh`) — avoid mojibake in release notes**  
+     On Windows, passing long Chinese (or mixed) text inline with `gh release edit --notes "..."` often corrupts encoding (garbled text on GitHub).  
+     **Always** put the body in a **UTF-8** file and use:
+     ```bash
+     gh release create vX.Y.Z path/to/cursor-guard-ide-X.Y.Z.vsix --title "Cursor Guard vX.Y.Z" --notes-file RELEASE_NOTES.md
+     ```
+     or for an existing release:
+     ```bash
+     gh release edit vX.Y.Z --notes-file RELEASE_NOTES.md
+     ```
+     Save `RELEASE_NOTES.md` as UTF-8 in VS Code / Cursor (default). Keep the release **title** ASCII-only if your shell is unreliable with Unicode.  
+   - This repo’s `.gitignore` includes `.release-notes-*.md` so temporary note files are not committed by mistake.
+
+7. **Maintenance branches (optional)**  
+   If you use branches like `release/v4.8.x`, fast-forward them to the current default branch when your policy requires it.
+
+8. **npm publish**  
+   From the repo root:
+   ```bash
+   npm publish --access public
+   ```  
+   If npm returns **EOTP**, open the URL it prints, complete authentication in the browser, then run `npm publish` again. AI agents cannot complete OTP for you.
+
+9. **VS Code Marketplace (optional)**  
+   Not required for GitHub Release + VSIX. If you publish there, use a personal access token and `npx @vscode/vsce publish` from `references/vscode-extension/dist` (see VS Code publishing docs).
+
+### Hints for AI agents
+
+- Read root `package.json` → `version` before claiming a release number.  
+- Prefer `npm run release:checklist` over inventing version strings.  
+- After editing release notes on Windows, use **`gh … --notes-file`** with a UTF-8 file; do not rely on huge `--notes "…"` strings in PowerShell.  
+- Do not echo npm OTP URLs as “user must visit” without also explaining they must complete the flow in a real browser.  
+- Never paste publish tokens into chat logs.
+
+---
+
+## 中文（维护者与 AI 助手）
+
+### 唯一版本源
+
+- 一切发版版本号以**仓库根目录** `package.json` 的 **`version`** 为准（semver，例如 `4.9.8`）。
+- 执行 `references/vscode-extension/build-vsix.js` 时，会把同一版本写入扩展构建产物中的 `package.json` 与 `guard-version.json`。
+- **npm** 包为 `cursor-guard@<version>`；**VSIX** 固定命名为 `cursor-guard-ide-<version>.vsix`。
+
+仓库已是新版本时，不要在对外说明里仍写旧的版本号（例如仍写 4.9.5）。
+
+### 一键打印检查表
+
+在仓库根目录：
+
+```bash
+npm run release:checklist
+```
+
+将终端输出复制到你的发版记录即可，内容与当前 `package.json` 一致。
+
+### 发版步骤（建议顺序）
+
+1. **改版本号**  
+   修改根目录 `package.json` 的 `version`。如需，同步 `package-lock.json` 顶部版本字段或执行 `npm install` 更新锁文件。
+
+2. **测试（建议）**  
+   ```bash
+   npm test
+   ```
+
+3. **构建 VSIX**  
+   ```bash
+   cd references/vscode-extension
+   node build-vsix.js
+   cd dist
+   npx --yes @vscode/vsce package --no-dependencies
+   ```  
+   得到：`references/vscode-extension/dist/cursor-guard-ide-<version>.vsix`。
+
+4. **Git 提交**  
+   按你们仓库习惯包含源码与 `dist/`（若纳入版本控制）及新的 `.vsix`。提交信息建议含 `release: vX.Y.Z`。
+
+5. **打标签并推送**  
+   ```bash
+   git tag -a vX.Y.Z -m "vX.Y.Z"
+   git push origin <默认分支>
+   git push origin vX.Y.Z
+   ```
+
+6. **GitHub Release 并上传 VSIX**  
+   - 为标签 `vX.Y.Z` 创建 Release，上传对应 VSIX。  
+   - **Windows 上使用 `gh` 写中文说明时务必注意编码**  
+     在 PowerShell 里用很长的 `gh release edit --notes "……中文……"` 容易导致 GitHub 上显示**乱码**。  
+     **正确做法**：把正文保存为 **UTF-8** 的 Markdown 文件（如 `RELEASE_NOTES.md`，用 Cursor/VS Code 保存即可），然后执行：
+     ```bash
+     gh release create vX.Y.Z ./references/vscode-extension/dist/cursor-guard-ide-X.Y.Z.vsix --title "Cursor Guard vX.Y.Z" --notes-file RELEASE_NOTES.md
+     ```
+     或已有 Release 时：
+     ```bash
+     gh release edit vX.Y.Z --notes-file RELEASE_NOTES.md
+     ```
+     **标题**建议只用 ASCII（如 `Cursor Guard v4.9.8`），避免控制台编码问题。  
+   - 本仓库 `.gitignore` 已忽略 `.release-notes-*.md`，避免临时说明文件被误提交。
+
+7. **release 维护分支（可选）**  
+   若使用 `release/v4.8.x` 等分支，按团队策略决定是否快进到当前默认分支。
+
+8. **npm 发布**  
+   在仓库根目录：
+   ```bash
+   npm publish --access public
+   ```  
+   若提示 **OTP / 二次验证**，在浏览器完成 npm 提示的认证后**再执行一次** `npm publish`。AI 无法代替你完成浏览器验证。
+
+9. **VS Code 扩展市场（可选）**  
+   非必须；多数用户通过 GitHub Release + VSIX 安装即可。若上架市场，需 PAT 与 `vsce publish`（见官方文档）。
+
+### 给其他 AI 助手的摘要
+
+- 发版前先读根目录 `package.json` 的 `version`，不要臆造版本号。  
+- 优先执行 `npm run release:checklist` 生成与仓库一致的步骤表。  
+- 在 Windows 上更新 GitHub Release 正文时，用 **`gh … --notes-file`** + UTF-8 文件，避免在命令行里直接塞长中文。  
+- 不要在对话中粘贴 npm / GitHub 令牌；OTP 必须用户本人在浏览器完成。
+
+---
+
+## Related files / 相关文件
+
+| File | Purpose |
+|------|---------|
+| `scripts/print-release-checklist.js` | Implements `npm run release:checklist` |
+| `references/vscode-extension/build-vsix.js` | Assembles `dist/` and syncs version from root `package.json` |
+| `README.md` / `README.zh-CN.md` | Short “Release checklist” sections + link here |
+| `.gitignore` | Ignores `.release-notes-*.md` |
+
+---
+
+*Last updated / 最后更新: 2026-03-22（v4.9.9：随包分发与 README 入口）*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-guard",
-  "version": "4.9.8",
+  "version": "4.9.9",
   "description": "Protects code from accidental AI overwrite or deletion in Cursor IDE — mandatory pre-write snapshots, review-before-apply, local Git safety net, and deterministic recovery. | 保护代码免受 Cursor AI 代理意外覆写或删除——强制写前快照、预览再执行、本地 Git 安全网、确定性恢复。",
   "keywords": [
     "cursor",
@@ -38,6 +38,7 @@
     "SKILL.md",
     "README.md",
     "README.zh-CN.md",
+    "docs/RELEASE.md",
     "ROADMAP.md",
     "LICENSE",
     "references/auto-backup.ps1",

package/references/dashboard/public/app.js

@@ -60,16 +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)',
-    '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',
+    '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',
@@ -177,9 +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.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.',
+    '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',
@@ -296,16 +296,16 @@ const I18N = {
     'alert.action.deleted':  '删除',
     'alert.action.renamed':  '重命名',
     'alert.breakdown':       '新增 {added} · 修改 {modified} · 删除 {deleted}',
-    'alert.suggestion':      '建议检查近期变更，并考虑手动创建快照',
-    'alert.viewFiles':       '查看文件详情（{n} 个文件）',
-    'preWarning.title':      '事先预警',
-    'preWarning.none':       '未检测到破坏性编辑风险',
-    'preWarning.active':     '删除风险',
-    'preWarning.file':       '文件',
-    'preWarning.risk':       '风险',
-    'preWarning.methods':    '移除的方法数',
-    'preWarning.suggestion': '建议在应用前检查这次删除，或直接从最新快照恢复',
-    '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':'恢复删除前',
@@ -414,8 +414,8 @@ const I18N = {
     'issue.disk_low':                   '磁盘空间不足（{gb} GB 可用）',
     'issue.git_backup_stale':           '最近 Git 备份已过时（{rel}）',
     'issue.active_alert':               '活跃告警：{type}——{count} 个文件在 {window} 秒内变更',
-    'issue.pre_warning_active':         '事先预警生效：{summary}',
-    'issue.alert_high_velocity':        '检测到大量文件变更，建议检查最近修改并手动创建快照。',
+    'issue.pre_warning_active':         '事先预警生效：{summary}',
+    'issue.alert_high_velocity':        '检测到大量文件变更，建议检查最近修改并手动创建快照。',
 
     'check.Git installed':              'Git 安装状态',
     'check.Git repository':             'Git 仓库',
@@ -573,9 +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: /^Pre-warning active: (.+)$/,                               key: 'issue.pre_warning_active', extract: ['summary'] },
-  { 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) {
@@ -867,14 +867,14 @@ function renderAll() {
 
 /* ── Rendering: Overview ──────────────────────────────────── */
 
-function renderOverview(d) {
-  renderHealthCard(d.health);
-  renderGitBackupCard(d.lastBackup);
-  renderShadowBackupCard(d.lastBackup);
-  renderPreWarningCard(d.preWarnings);
-  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');
@@ -907,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;
@@ -917,40 +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 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');
+    <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';
@@ -1295,18 +1295,18 @@ function renderProtection(scope) {
 
   el.innerHTML = `
     <div class="protection-grid">
-      <div class="pattern-card">
+      <div class="pattern-card pattern-card--protect">
         <h4>${t('protection.protect')}</h4>
         ${isAll
-          ? `<p class="text-muted text-sm">${t('protection.allFiles')}</p>`
-          : `<ul class="pattern-list">${protectList.map(p => `<li class="pattern-item">${esc(p)}</li>`).join('')}</ul>`
+          ? `<p class="pattern-empty pattern-empty--protect text-sm">${t('protection.allFiles')}</p>`
+          : `<ul class="pattern-list">${protectList.map(p => `<li class="pattern-item pattern-item--protect">${esc(p)}</li>`).join('')}</ul>`
         }
       </div>
-      <div class="pattern-card">
+      <div class="pattern-card pattern-card--ignore">
         <h4>${t('protection.ignore')}</h4>
         ${ignoreList.length === 0
-          ? `<p class="text-muted text-sm">${t('protection.noIgnore')}</p>`
-          : `<ul class="pattern-list">${ignoreList.map(p => `<li class="pattern-item">${esc(p)}</li>`).join('')}</ul>`
+          ? `<p class="pattern-empty pattern-empty--ignore text-sm">${t('protection.noIgnore')}</p>`
+          : `<ul class="pattern-list">${ignoreList.map(p => `<li class="pattern-item pattern-item--ignore">${esc(p)}</li>`).join('')}</ul>`
         }
       </div>
     </div>