covgate 0.2.0 → 0.2.2

package/src/report/build.js

@@ -46,7 +46,8 @@ function countScopeState(scopes) {
  *   topLevelIssues: any[],
  *   durationMs: number,
  *   startedAt: string,
- *   artifactPaths: { json?: string, markdown?: string }
+ *   artifactPaths: { json?: string, markdown?: string, html?: string },
+ *   changed?: { base: string, relativeFiles: string[] } | null
  * }} options
  */
 export function buildReport({
@@ -57,7 +58,8 @@ export function buildReport({
   topLevelIssues,
   durationMs,
   startedAt,
-  artifactPaths
+  artifactPaths,
+  changed
 }) {
   const errors = topLevelIssues.filter((issue) => issue.severity !== "warning");
   const hasExecutionError = errors.length > 0;
@@ -67,6 +69,9 @@ export function buildReport({
   const state = countScopeState(scopes);
   const failedScopes = scopes.filter((scope) => !scope.passed).map((scope) => scope.name);
   const artifacts = artifactDisplay(config, artifactPaths);
+  const changedSummary = changed
+    ? { enabled: true, base: changed.base, files: changed.relativeFiles }
+    : null;
 
   const sanitizedCommands = commands.map((command) => {
     const record = {
@@ -103,7 +108,8 @@ export function buildReport({
     },
     summary: {
       scopes: scopes.length,
-      passedScopes: scopes.filter((scope) => scope.passed).length,
+      passedScopes: scopes.filter((scope) => scope.passed && !scope.skipped).length,
+      skippedScopes: scopes.filter((scope) => scope.skipped).map((scope) => scope.name),
       failedScopes,
       waivers: state.waivers,
       exclusions: state.exclusions,
@@ -111,6 +117,7 @@ export function buildReport({
       errors: state.errors + errors.length,
       warnings: state.warnings
     },
+    changed: changedSummary,
     issues: topLevelIssues,
     commands: sanitizedCommands,
     scopes,
@@ -131,5 +138,8 @@ export function plannedArtifactPaths(config, noFiles = false) {
   if (config.reports.formats.includes("markdown")) {
     paths.markdown = path.join(config.reports.dir, "report.md");
   }
+  if (config.reports.formats.includes("html")) {
+    paths.html = path.join(config.reports.dir, "report.html");
+  }
   return paths;
 }

package/src/report/html.js

@@ -0,0 +1,257 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+
+const ESCAPE_MAP = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+
+function escapeHtml(value) {
+  return String(value).replace(/[&<>"']/g, (character) => ESCAPE_MAP[character]);
+}
+
+function percent(value) {
+  return value === null || value === undefined ? "N/A" : value.toFixed(2) + "%";
+}
+
+function statusLabel(status) {
+  if (status === "pass") return "通过";
+  if (status === "fail") return "未通过";
+  return "运行失败";
+}
+
+async function readSourceLines(root, relativePath) {
+  try {
+    const text = await readFile(path.resolve(root, relativePath), "utf8");
+    return text.replace(/^\uFEFF/, "").split(/\r?\n/);
+  } catch (error) {
+    return ["// 无法读取源码：" + error.message];
+  }
+}
+
+function metricCard(label, value) {
+  if (!value || !value.applicable) {
+    return '<div class="metric"><span>' + escapeHtml(label) + '</span><strong>N/A</strong></div>';
+  }
+  const klass = value.passed ? "good" : "bad";
+  return (
+    '<div class="metric ' +
+    klass +
+    '"><span>' +
+    escapeHtml(label) +
+    "</span><strong>" +
+    percent(value.percent) +
+    "</strong><small>" +
+    value.covered +
+    "/" +
+    value.total +
+    " · 目标 " +
+    value.threshold +
+    "%</small></div>"
+  );
+}
+
+function lineHtml(number, line, hits) {
+  const hasHit = hits && Object.prototype.hasOwnProperty.call(hits, String(number));
+  const count = hasHit ? Number(hits[String(number)]) : null;
+  const state = !hasHit ? "neutral" : count > 0 ? "covered" : "uncovered";
+  const hitLabel = hasHit ? (count > 0 ? String(count) : "0") : "";
+  return (
+    '<div class="line ' +
+    state +
+    '"><span class="ln">' +
+    number +
+    '</span><span class="hit" title="命中次数">' +
+    escapeHtml(hitLabel) +
+    '</span><span class="code">' +
+    (line ? escapeHtml(line) : "&nbsp;") +
+    "</span></div>"
+  );
+}
+
+const CSS = [
+  ":root{color-scheme:light;--ink:#17202a;--muted:#65707c;--line:#e5e9ed;--bg:#f4f6f8;--panel:#fff;--green:#d9f7e2;--green-strong:#198754;--red:#e5484d;--neutral:#f5f6f7;--accent:#1f6feb}",
+  "*{box-sizing:border-box}",
+  "html,body{margin:0;height:100%}",
+  "body{font-family:ui-sans-serif,-apple-system,BlinkMacSystemFont,'Segoe UI','Microsoft YaHei',sans-serif;background:var(--bg);color:var(--ink)}",
+  ".app{display:flex;height:100vh;overflow:hidden}",
+  ".sidebar{width:340px;min-width:280px;border-right:1px solid var(--line);background:#fbfcfd;display:flex;flex-direction:column}",
+  ".brand{padding:18px 18px 12px;border-bottom:1px solid var(--line)}",
+  ".brand h1{font-size:17px;margin:0 0 6px;letter-spacing:.2px}",
+  ".brand p{margin:0;color:var(--muted);font-size:12px;line-height:1.5}",
+  ".summary{padding:12px 18px;border-bottom:1px solid var(--line);font-size:12px;color:var(--muted);display:flex;flex-wrap:wrap;gap:8px}",
+  ".pill{padding:3px 8px;border-radius:99px;background:#eef1f4;color:#46505b}",
+  ".pill.good{background:var(--green);color:#116a3e}.pill.bad{background:#ffe3e4;color:#a51d22}",
+  ".search{padding:12px 14px 8px}",
+  ".search input{width:100%;padding:8px 10px;border:1px solid var(--line);border-radius:8px;background:#fff;font:inherit;outline:none}",
+  ".search input:focus{border-color:var(--accent);box-shadow:0 0 0 3px #1f6feb1a}",
+  ".file-list{overflow:auto;padding:4px 10px 24px;flex:1}",
+  ".scope-title{font-size:11px;text-transform:uppercase;letter-spacing:.8px;color:#8a94a0;padding:14px 8px 7px;display:flex;justify-content:space-between;gap:8px}",
+  ".scope-title span{font-weight:600;color:#56616d}",
+  ".file-link{display:flex;align-items:center;gap:8px;padding:8px 9px;border-radius:8px;color:var(--ink);text-decoration:none;font-size:13px;line-height:1.3}",
+  ".file-link:hover{background:#eef3f8}",
+  ".file-link.active{background:#e7f0ff;box-shadow:inset 2px 0 var(--accent)}",
+  ".file-link .name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:1;direction:rtl;text-align:left}",
+  ".file-link .pct{font-variant-numeric:tabular-nums;font-size:11px;color:var(--muted)}",
+  ".file-link .pct.ok{color:var(--green-strong)}.file-link .pct.bad{color:var(--red)}",
+  ".empty{padding:14px;font-size:13px;color:var(--muted);line-height:1.6}",
+  ".main{flex:1;min-width:0;display:flex;flex-direction:column;overflow:hidden}",
+  ".topbar{padding:16px 22px;border-bottom:1px solid var(--line);background:var(--panel);display:flex;align-items:center;gap:16px;flex-wrap:wrap}",
+  ".topbar h2{font-size:15px;margin:0;flex:1;min-width:200px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
+  ".changed-badge{font-size:11px;background:#fff3cd;color:#7a5b00;border-radius:99px;padding:3px 8px}",
+  ".metrics{display:flex;gap:8px;flex-wrap:wrap}",
+  ".metric{border:1px solid var(--line);background:#fff;border-radius:8px;padding:6px 10px;min-width:104px;display:flex;flex-direction:column;gap:1px}",
+  ".metric span{font-size:10px;color:var(--muted)}.metric strong{font-size:13px}.metric small{font-size:10px;color:var(--muted)}",
+  ".metric.good strong{color:var(--green-strong)}.metric.bad strong{color:var(--red)}",
+  ".content{overflow:auto;flex:1;padding:22px}",
+  ".file-view{max-width:1500px;margin:0 auto}",
+  ".file-meta{display:flex;gap:12px;flex-wrap:wrap;align-items:center;margin-bottom:12px;color:var(--muted);font-size:12px}",
+  ".file-meta .path{font-family:ui-monospace,SFMono-Regular,Consolas,monospace;color:var(--ink);font-size:13px}",
+  ".legend{display:flex;gap:14px;font-size:11px;color:var(--muted);margin-bottom:12px;flex-wrap:wrap}",
+  ".legend i{display:inline-block;width:18px;height:10px;border:1px solid var(--line);border-radius:2px;vertical-align:-1px;margin-right:4px}",
+  ".legend .covered-bg{background:var(--green)}.legend .uncovered-bg{background:#fff}.legend .neutral-bg{background:var(--neutral)}",
+  ".code-pane{background:#fff;border:1px solid var(--line);border-radius:10px;overflow:auto;font-family:ui-monospace,SFMono-Regular,Consolas,'Liberation Mono',monospace;font-size:12.5px;line-height:1.55;padding:6px 0}",
+  ".line{display:flex;min-width:max-content;white-space:pre;border-bottom:1px solid #f1f3f5}",
+  ".line.covered{background:var(--green)}.line.uncovered{background:#fff;box-shadow:inset 3px 0 var(--red)}.line.neutral{background:var(--neutral);color:#8e99a4}",
+  ".ln{width:60px;flex:0 0 60px;text-align:right;padding-right:12px;color:#8a94a0;user-select:none;border-right:1px solid #0000000d}",
+  ".hit{width:42px;flex:0 0 42px;text-align:right;padding-right:12px;color:#8a94a0;user-select:none;border-right:1px solid #0000000d}",
+  ".line.covered .hit{color:var(--green-strong)}.line.uncovered .hit{color:var(--red)}",
+  ".code-text{padding:0 14px 0 10px;padding:0 14px 0 10px}",
+  ".line .code{padding:0 14px 0 10px}",
+  ".source-note{font-size:12px;color:var(--muted);margin:8px 0 12px}",
+  "@media(max-width:900px){.app{display:block;height:auto}.sidebar{width:auto;height:46vh}.main{height:54vh}.content{padding:12px}}",
+  ""
+].join("\n");
+
+const JS = [
+  "(function(){",
+  "  var links = Array.prototype.slice.call(document.querySelectorAll('.file-link'));",
+  "  var views = Array.prototype.slice.call(document.querySelectorAll('.file-view'));",
+  "  function show(id) {",
+  "    views.forEach(function(view){ view.hidden = view.id !== id; });",
+  "    links.forEach(function(link){ link.classList.toggle('active', link.getAttribute('data-file') === id); });",
+  "    if (id) { try { history.replaceState(null, '', '#' + id); } catch (_) {} }",
+  "  }",
+  "  links.forEach(function(link){",
+  "    link.addEventListener('click', function(event){ event.preventDefault(); show(link.getAttribute('data-file')); });",
+  "  });",
+  "  var search = document.getElementById('fileSearch');",
+  "  if (search) search.addEventListener('input', function(){",
+  "    var term = search.value.trim().toLowerCase();",
+  "    links.forEach(function(link){ link.style.display = !term || link.textContent.toLowerCase().indexOf(term) !== -1 ? '' : 'none'; });",
+  "  });",
+  "  var initial = location.hash ? location.hash.slice(1) : (links[0] && links[0].getAttribute('data-file'));",
+  "  if (initial) show(initial);",
+  "})();"
+].join("\n");
+
+function sidebarScope(scope, files) {
+  const title = escapeHtml(scope.label) + " · " + escapeHtml(scope.name);
+  const metrics = scope.metrics && scope.metrics.lines
+    ? (scope.metrics.lines.applicable ? percent(scope.metrics.lines.percent) : "N/A")
+    : "N/A";
+  const threshold = scope.metrics?.lines?.threshold ?? 100;
+  const rows = files.map((file) => {
+    const line = file.metrics && file.metrics.lines;
+    const value = line && line.percent !== null ? percent(line.percent) : "N/A";
+    const ok = line && line.percent !== null && line.percent >= threshold ? "ok" : "bad";
+    return (
+      '<a class="file-link" data-file="' + file.id + '" href="#' + file.id + '">' +
+      '<span class="name" title="' + escapeHtml(file.path) + '">' + escapeHtml(file.path) + "</span>" +
+      '<span class="pct ' + ok + '">' + value + "</span></a>"
+    );
+  });
+  return (
+    '<div class="scope-title"><span>' + title + "</span><span>" + metrics + "</span></div>" +
+    (rows.length > 0 ? rows.join("") : '<div class="empty">本次变更未涉及该 scope。</div>')
+  );
+}
+
+function fileView(scope, file, index) {
+  const source = file.source || [];
+  const lines = [];
+  for (let lineNumber = 1; lineNumber <= source.length; lineNumber += 1) {
+    lines.push(lineHtml(lineNumber, source[lineNumber - 1], file.lineHits));
+  }
+  const lineMetric = file.metrics && file.metrics.lines;
+  const statLine = lineMetric ? percent(lineMetric.percent) + " (" + lineMetric.covered + "/" + lineMetric.total + ")" : "N/A";
+  const hidden = index === 0 ? "" : " hidden";
+  return (
+    '<section class="file-view" id="' + file.id + '"' + hidden + ">" +
+    '<div class="file-meta"><span class="path">' + escapeHtml(file.path) + "</span>" +
+    "<span>行覆盖 " + statLine + "</span>" +
+    "<span>" + (file.changed ? "本次 Git 变更文件" : "") + "</span></div>" +
+    '<div class="legend"><span><i class="covered-bg"></i>已覆盖</span><span><i class="uncovered-bg"></i>未覆盖</span><span><i class="neutral-bg"></i>非可执行代码</span></div>' +
+    '<div class="code-pane">' + lines.join("") + "</div>" +
+    "</section>"
+  );
+}
+
+/**
+ * @param {any} report
+ * @param {{ root: string }} options
+ */
+export async function renderHtmlReport(report, options) {
+  const root = options.root;
+  const scopeViews = [];
+  const sidebar = [];
+  let fileIndex = 0;
+  for (let scopeIndex = 0; scopeIndex < report.scopes.length; scopeIndex += 1) {
+    const scope = report.scopes[scopeIndex];
+    const files = [];
+    for (const file of scope.files || []) {
+      const source = await readSourceLines(root, file.path);
+      files.push({
+        ...file,
+        id: "file-" + scopeIndex + "-" + fileIndex,
+        source,
+        changed: Boolean(report.changed && report.changed.enabled)
+      });
+      fileIndex += 1;
+    }
+    sidebar.push(sidebarScope(scope, files));
+    scopeViews.push(files);
+  }
+
+  const views = [];
+  for (let scopeIndex = 0; scopeIndex < report.scopes.length; scopeIndex += 1) {
+    for (const file of scopeViews[scopeIndex]) views.push(fileView(report.scopes[scopeIndex], file, views.length));
+  }
+
+  const changed = report.changed && report.changed.enabled
+    ? '<span class="changed-badge">只显示 Git 变更文件 · base ' + escapeHtml(report.changed.base) + "</span>"
+    : "";
+  const status = statusLabel(report.status);
+  const statusClass = report.status === "pass" ? "good" : "bad";
+  const summary = report.scopes.map((scope) => {
+    const lines = scope.metrics && scope.metrics.lines;
+    return metricCard(scope.label, lines);
+  }).join("");
+  const scopeCount = report.scopes.length;
+  const fileCount = report.scopes.reduce((sum, scope) => sum + (scope.files || []).length, 0);
+  const body = views.length > 0
+    ? views.join("")
+    : '<div class="file-view"><div class="empty">没有可展示的源码文件。请检查 sources.include 或本次 Git 变更。</div></div>';
+
+  return [
+    "<!doctype html>",
+    '<html lang="zh-CN"><head><meta charset="utf-8">',
+    '<meta name="viewport" content="width=device-width,initial-scale=1">',
+    "<title>CovGate 覆盖率报告</title>",
+    "<style>" + CSS + "</style></head><body>",
+    '<div class="app">',
+    '<aside class="sidebar"><div class="brand"><h1>CovGate 覆盖率</h1><p>' +
+      escapeHtml(report.generatedAt) + " · " + escapeHtml(report.mode === "check" ? "已有报告" : "本次运行") +
+      "</p></div>" +
+      '<div class="summary"><span class="pill ' + statusClass + '">' + status + "</span>" +
+      '<span class="pill">' + scopeCount + ' scopes</span><span class="pill">' + fileCount + ' files</span>' + changed + "</div>" +
+      '<div class="search"><input id="fileSearch" type="search" placeholder="搜索文件…" aria-label="搜索文件"></div>',
+    '<nav class="file-list">' + sidebar.join("") + "</nav></aside>",
+    '<main class="main"><header class="topbar"><h2>源码覆盖</h2><div class="metrics">' + summary + "</div></header>",
+    '<div class="content">' + body + "</div></main></div>",
+    "<script>" + JS + "</script></body></html>"
+  ].join("\n");
+}

package/src/report/index.js

@@ -1,15 +1,23 @@
 import { writeTextFile } from "../util.js";
 import { buildReport, plannedArtifactPaths } from "./build.js";
+import { renderHtmlReport } from "./html.js";
 import { renderMarkdownReport } from "./markdown.js";
 import { renderTextReport } from "./text.js";
 
-export { buildReport, plannedArtifactPaths, renderMarkdownReport, renderTextReport };
+export {
+  buildReport,
+  plannedArtifactPaths,
+  renderHtmlReport,
+  renderMarkdownReport,
+  renderTextReport
+};
 
 /**
  * @param {any} report
- * @param {{ json?: string, markdown?: string }} paths
+ * @param {{ json?: string, markdown?: string, html?: string }} paths
+ * @param {any} [config]
  */
-export async function writeReportArtifacts(report, paths) {
+export async function writeReportArtifacts(report, paths, config) {
   const errors = [];
   if (paths.json) {
     try {
@@ -25,5 +33,15 @@ export async function writeReportArtifacts(report, paths) {
       errors.push("无法写入 Markdown 报告 " + paths.markdown + ": " + error.message);
     }
   }
+  if (paths.html) {
+    try {
+      const html = await renderHtmlReport(report, {
+        root: config?.root || process.cwd()
+      });
+      await writeTextFile(paths.html, html);
+    } catch (error) {
+      errors.push("无法写入 HTML 报告 " + paths.html + ": " + error.message);
+    }
+  }
   return errors;
 }

package/src/report/markdown.js

@@ -57,7 +57,7 @@ function scopeTableRow(scope) {
         (value.passed ? "✓" : "✗")
     );
   }
-  cells.push(scope.passed ? "✓ 通过" : "✗ 未通过");
+  cells.push(scope.skipped ? "— 未涉及变更" : scope.passed ? "✓ 通过" : "✗ 未通过");
   return "| " + cells.join(" | ") + " |";
 }
 
@@ -111,6 +111,8 @@ export function renderMarkdownReport(report) {
       report.summary.scopes +
       " 个，通过 " +
       report.summary.passedScopes +
+      " 个；跳过 " +
+      report.summary.skippedScopes.length +
       " 个；豁免 " +
       report.summary.waivers +
       " 条；配置排除 " +

package/src/report/text.js

@@ -54,7 +54,7 @@ export function renderTextReport(report, options = {}) {
   if (report.issues.length > 0) lines.push("");
 
   for (const scope of report.scopes) {
-    const symbol = scope.passed ? symbols.pass : symbols.fail;
+    const symbol = scope.skipped ? "○" : scope.passed ? symbols.pass : symbols.fail;
     lines.push(
       symbol +
         " " +
@@ -62,7 +62,7 @@ export function renderTextReport(report, options = {}) {
         " " +
         dim("[" + scope.name + "/" + scope.profile + "]") +
         " " +
-        (scope.passed ? green("通过") : red("未通过"))
+        (scope.skipped ? dim("未涉及本次变更") : scope.passed ? green("通过") : red("未通过"))
     );
 
     const metricParts = [];
@@ -260,6 +260,9 @@ export function renderTextReport(report, options = {}) {
   if (report.artifacts.markdown) {
     lines.push(dim("Markdown 报告: " + report.artifacts.markdown));
   }
+  if (report.artifacts.html) {
+    lines.push(dim("HTML 报告: " + report.artifacts.html));
+  }
   if (report.status !== "pass" && report.summary.failedScopes.length > 0) {
     lines.push(dim("失败 scope: " + report.summary.failedScopes.join(", ")));
   }

package/src/scope.js

@@ -64,10 +64,11 @@ function findOverlaps(ranges) {
  *   root: string,
  *   coverage: { format: string, files: Map<string, any> },
  *   waiverPolicy: any,
+ *   changedKeys?: Set<string> | null,
  *   now?: Date
  * }} options
  */
-export async function evaluateScope({ scope, root, coverage, waiverPolicy, now = new Date() }) {
+export async function evaluateScope({ scope, root, coverage, waiverPolicy, changedKeys = null, now = new Date() }) {
   /** @type {Array<any>} */
   const issues = [];
   /** @type {Array<any>} */
@@ -161,6 +162,33 @@ export async function evaluateScope({ scope, root, coverage, waiverPolicy, now =
     });
   }
 
+  const universeKeys = new Set(expected.keys());
+  if (changedKeys) {
+    for (const key of [...expected.keys()]) {
+      if (!changedKeys.has(key)) expected.delete(key);
+    }
+    if (universeKeys.size > 0 && expected.size === 0) {
+      return {
+        name: scope.name,
+        label: scope.label,
+        profile: scope.profile,
+        thresholds: scope.thresholds,
+        format: coverage.format,
+        files: [],
+        expectedSourceCount: 0,
+        reportedFileCount: coverage.files.size,
+        missingSources: [],
+        extras: [],
+        waivers: [],
+        exclusions,
+        issues,
+        warnings,
+        skipped: true,
+        changedOnly: true
+      };
+    }
+  }
+
   // Read and scan every remaining expected source file. We need this before
   // deciding missing coverage so file-level waivers can suppress that check
   // with a documented reason.
@@ -391,7 +419,7 @@ export async function evaluateScope({ scope, root, coverage, waiverPolicy, now =
   // it helps catch an accidentally narrow include pattern.
   const extras = [];
   for (const [key, file] of coverage.files) {
-    if (expected.has(key) || excludedKeys.has(key) || fileIgnoreKeys.has(key)) continue;
+    if (universeKeys.has(key) || excludedKeys.has(key) || fileIgnoreKeys.has(key)) continue;
     extras.push(file.relPath);
   }
   if (extras.length > 0) {
@@ -435,6 +463,8 @@ export async function evaluateScope({ scope, root, coverage, waiverPolicy, now =
     waivers,
     exclusions,
     issues,
-    warnings
+    warnings,
+    skipped: false,
+    changedOnly: Boolean(changedKeys)
   };
 }

package/src/setup/agent.js

@@ -14,6 +14,7 @@ const AGENT_BLOCK = [
   "- 禁止 `istanbul ignore`、`c8 ignore`、`v8 ignore`、`node:coverage ignore`。",
   "- 确实不可达的代码使用 `covgate-ignore-next-line`、`covgate-ignore-start/end` 或 `covgate-ignore-file`，写具体原因、owner 和 expires。",
   "- 禁止通过扩大 exclude、缩小 sources.include 或删除测试来让门禁通过；这类改动必须由人类评审。",
+  "- 行为变更必须新增或更新覆盖该行为的真实测试；不能把“门禁失败”当作完成理由，也不得用空报告、`--passWithNoTests`、ignore 或降低门槛绕过。",
   "- 失败详情在 `.covgate/report.json` 的 scopes/issues/waivers 中；修复后重跑。",
   "",
   "也可运行 `npm run coverage:gate -- --json`。Agent Stop hook 可调用 `scripts/covgate-agent-gate.ps1`（Windows）或 `scripts/covgate-agent-gate.sh`。",
@@ -30,7 +31,8 @@ const CURSOR_RULE = [
   "# CovGate 覆盖率门禁",
   "",
   "任何代码修改后运行 `npx --no-install covgate run --json`，退出码 0 才能结束。",
-  "客户端必须 100%，服务端至少 95%。禁止原生 ignore；豁免必须写原因、owner、expires。",
+  "客户端必须 100%，服务端至少 95%。行为变更必须补真实测试；门禁失败不能作为完成理由。",
+  "禁止原生 ignore；豁免必须写原因、owner、expires。",
   ""
 ].join("\n");
 

package/src/setup/config.js

@@ -44,45 +44,62 @@ async function pickExcludes(root, sourceGlob) {
 /**
  * @param {{
  *   root: string,
- *   profile: "client" | "server",
- *   sourceGlob: string,
+ *   scopes?: Array<{ name: string, profile: "client" | "server", label?: string, sourceGlob: string }>,
+ *   profile?: "client" | "server",
+ *   sourceGlob?: string,
  *   command: string,
  *   coveragePath: string
  * }} options
  */
 export async function buildStarterConfig({
   root,
+  scopes,
   profile,
   sourceGlob,
   command,
   coveragePath
 }) {
-  const exclude = await pickExcludes(root, sourceGlob);
-  const label = profile === "client" ? "客户端" : "服务端";
+  const specs =
+    scopes && scopes.length > 0
+      ? scopes
+      : [
+          {
+            name: profile,
+            profile,
+            label: profile === "client" ? "客户端" : "服务端",
+            sourceGlob
+          }
+        ];
+  const scopeConfigs = {};
+  for (const spec of specs) {
+    if (!spec.profile || !spec.sourceGlob || !spec.name) continue;
+    const label =
+      spec.label || (spec.profile === "client" ? "客户端" : "服务端");
+    const exclude = await pickExcludes(root, spec.sourceGlob);
+    scopeConfigs[spec.name] = {
+      profile: spec.profile,
+      label,
+      commands: [
+        {
+          name: label + "测试与覆盖率",
+          run: command,
+          timeoutSeconds: 900
+        }
+      ],
+      coverage: {
+        format: "auto",
+        paths: [coveragePath]
+      },
+      sources: {
+        include: [spec.sourceGlob]
+      },
+      exclude
+    };
+  }
   return {
     $schema: "./node_modules/covgate/schema/covgate.schema.json",
     version: 1,
-    scopes: {
-      [profile]: {
-        profile,
-        label,
-        commands: [
-          {
-            name: label + "测试与覆盖率",
-            run: command,
-            timeoutSeconds: 900
-          }
-        ],
-        coverage: {
-          format: "auto",
-          paths: [coveragePath]
-        },
-        sources: {
-          include: [sourceGlob]
-        },
-        exclude
-      }
-    },
+    scopes: scopeConfigs,
     waivers: {
       minReasonLength: 8,
       requireOwner: false,
@@ -91,7 +108,7 @@ export async function buildStarterConfig({
     },
     reports: {
       dir: ".covgate",
-      formats: ["json", "markdown"]
+      formats: ["json", "markdown", "html"]
     }
   };
 }