@dommaker/harness 1.3.0 → 1.5.0

package/src/gates/command.ts

@@ -5,6 +5,7 @@
  * 检查命令是否安全，防止执行危险操作
  */
 
+import { pass, gateResult } from './types';
 import type { GateResult, CommandGateConfig, CommandBlacklistRule, Gate, GateContext, GateDecision } from './types';
 import { decisionFromResult } from './decision';
 
@@ -232,32 +233,25 @@ export class CommandGate implements Gate {
     const startTime = Date.now();
 
     if (!this.config.enabled) {
-      return {
-        gate: 'command',
-        passed: true,
-        message: '命令门禁已禁用',
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return pass('command', '命令门禁已禁用', startTime);
     }
 
     const result = this.checkBlacklist(command);
 
-    return {
-      gate: 'command',
-      passed: result.allowed,
-      message: result.allowed
+    return gateResult(
+      'command',
+      result.allowed,
+      result.allowed
         ? this.formatSuccessMessage(result)
         : this.formatBlockMessage(result),
-      details: {
+      startTime,
+      {
         blocked: result.blocked,
         warnings: result.warnings,
         audits: result.audits,
         command,
-      },
-      timestamp: new Date().toISOString(),
-      duration: Date.now() - startTime,
-    };
+      }
+    );
   }
 
   /**

package/src/gates/contract.ts

@@ -9,6 +9,7 @@
 
 import * as fs from 'fs/promises';
 import * as path from 'path';
+import { pass, fail, fromError } from './types';
 import type { GateResult, GateContext, ContractGateConfig, Gate, GateDecision } from './types';
 import { decisionFromResult } from './decision';
 
@@ -43,13 +44,7 @@ export class ContractGate implements Gate {
     const startTime = Date.now();
 
     if (!this.config.enabled) {
-      return {
-        gate: 'contract',
-        passed: true,
-        message: '契约门禁已禁用',
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return pass('contract', '契约门禁已禁用', startTime);
     }
 
     try {
@@ -60,34 +55,20 @@ export class ContractGate implements Gate {
       try {
         await fs.access(contractPath);
       } catch {
-        return {
-          gate: 'contract',
-          passed: true,
-          message: '未找到契约文件，跳过检查',
-          details: {
-            contractPath,
-            suggestion: '创建 OpenAPI 规范文件',
-          },
-          timestamp: new Date().toISOString(),
-          duration: Date.now() - startTime,
-        };
+        return pass('contract', '未找到契约文件，跳过检查', startTime, {
+          contractPath,
+          suggestion: '创建 OpenAPI 规范文件',
+        });
       }
 
       // 验证契约格式
       const validation = await this.validateContract(contractPath);
 
       if (!validation.valid) {
-        return {
-          gate: 'contract',
-          passed: false,
-          message: `契约格式无效: ${validation.errors.join(', ')}`,
-          details: {
-            contractPath,
-            errors: validation.errors,
-          },
-          timestamp: new Date().toISOString(),
-          duration: Date.now() - startTime,
-        };
+        return fail('contract', `契约格式无效: ${validation.errors.join(', ')}`, startTime, {
+          contractPath,
+          errors: validation.errors,
+        });
       }
 
       // 检查破坏性变更（如果提供了旧契约）
@@ -98,42 +79,22 @@ export class ContractGate implements Gate {
         );
 
         if (breakingChanges.length > 0 && !this.config.allowBreakingChanges) {
-          return {
-            gate: 'contract',
-            passed: false,
-            message: `发现破坏性变更: ${breakingChanges.length} 个`,
-            details: {
-              contractPath,
-              oldContractPath: context.oldContractPath,
-              breakingChanges,
-              suggestion: '更新 API 版本或保持向后兼容',
-            },
-            timestamp: new Date().toISOString(),
-            duration: Date.now() - startTime,
-          };
+          return fail('contract', `发现破坏性变更: ${breakingChanges.length} 个`, startTime, {
+            contractPath,
+            oldContractPath: context.oldContractPath,
+            breakingChanges,
+            suggestion: '更新 API 版本或保持向后兼容',
+          });
         }
       }
 
-      return {
-        gate: 'contract',
-        passed: true,
-        message: '契约检查通过',
-        details: {
-          contractPath,
-          endpoints: validation.endpoints,
-          version: validation.version,
-        },
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return pass('contract', '契约检查通过', startTime, {
+        contractPath,
+        endpoints: validation.endpoints,
+        version: validation.version,
+      });
     } catch (error: any) {
-      return {
-        gate: 'contract',
-        passed: false,
-        message: `契约检查失败: ${error.message}`,
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return fromError('contract', '契约检查失败', error, startTime);
     }
   }
 

package/src/gates/performance.ts

@@ -16,6 +16,7 @@
 import { execAsync } from '../utils/exec';
 import * as fs from 'fs/promises';
 import * as path from 'path';
+import { pass, gateResult, fromError } from './types';
 import type { GateResult, GateContext, PerformanceGateConfig, PerformanceThresholds, Gate, GateDecision } from './types';
 import { decisionFromResult } from './decision';
 
@@ -70,13 +71,7 @@ export class PerformanceGate implements Gate {
     const startTime = Date.now();
 
     if (!this.config.enabled) {
-      return {
-        gate: 'performance',
-        passed: true,
-        message: '性能门禁已禁用',
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return pass('performance', '性能门禁已禁用', startTime);
     }
 
     try {
@@ -122,11 +117,12 @@ export class PerformanceGate implements Gate {
         ? `性能检查通过: ${this.formatMetrics(metrics)}`
         : failures.join('; ');
 
-      return {
-        gate: 'performance',
+      return gateResult(
+        'performance',
         passed,
-        message: warnings.length > 0 ? `${message} (警告: ${warnings.join('; ')})` : message,
-        details: {
+        warnings.length > 0 ? `${message} (警告: ${warnings.join('; ')})` : message,
+        startTime,
+        {
           metrics: {
             responseTime: metrics.responseTime,
             memoryUsage: metrics.memoryUsage,
@@ -136,18 +132,10 @@ export class PerformanceGate implements Gate {
           thresholds,
           failures,
           warnings,
-        },
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+        }
+      );
     } catch (error: any) {
-      return {
-        gate: 'performance',
-        passed: false,
-        message: `性能检查失败: ${error.message}`,
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return fromError('performance', '性能检查失败', error, startTime);
     }
   }
 

package/src/gates/review.ts

@@ -8,6 +8,7 @@
  */
 
 import { execAsync } from '../utils/exec';
+import { gateResult, fromError } from './types';
 import type { GateResult, GateContext, ReviewGateConfig, Gate, GateDecision } from './types';
 import { decisionFromResult } from './decision';
 
@@ -50,13 +51,7 @@ export class ReviewGate implements Gate {
       // 否则尝试从 git 获取
       return this.checkLocalGit(context);
     } catch (error: any) {
-      return {
-        gate: 'review',
-        passed: false,
-        message: `审查检查失败: ${error.message}`,
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return fromError('review', '审查检查失败', error, startTime);
     }
   }
 
@@ -86,33 +81,25 @@ export class ReviewGate implements Gate {
         approvals.length >= this.config.minReviewers &&
         (!this.config.blockOnChangesRequested || changesRequested.length === 0);
 
-      return {
-        gate: 'review',
+      return gateResult(
+        'review',
         passed,
-        message: passed
+        passed
           ? `审查通过: ${approvals.length} 个审批`
           : `审查未通过: ${approvals.length}/${this.config.minReviewers} 审批, ${changesRequested.length} 个变更请求`,
-        details: {
+        startTime,
+        {
           approvals: approvals.length,
           changesRequested: changesRequested.length,
           pending: pending.length,
           minReviewers: this.config.minReviewers,
-        },
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+        }
+      );
     } catch (error: any) {
       // gh CLI 不可用或 PR 不存在
-      return {
-        gate: 'review',
-        passed: false,
-        message: `无法获取 PR 状态: ${error.message}`,
-        details: {
-          suggestion: '确保已安装 gh CLI 并配置了 GitHub token',
-        },
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return fromError('review', '无法获取 PR 状态', error, startTime, {
+        suggestion: '确保已安装 gh CLI 并配置了 GitHub token',
+      });
     }
   }
 
@@ -138,28 +125,21 @@ export class ReviewGate implements Gate {
       const hasUnpushed = unpushed.trim().length > 0;
 
       // 本地模式无法验证审查，返回警告
-      return {
-        gate: 'review',
-        passed: !this.config.requireApproval,
-        message: this.config.requireApproval
+      return gateResult(
+        'review',
+        !this.config.requireApproval,
+        this.config.requireApproval
           ? '本地模式无法验证审查，请通过 PR 进行代码审查'
           : '审查要求未启用，跳过检查',
-        details: {
+        startTime,
+        {
           lastCommit: logOutput,
           hasUnpushedCommits: hasUnpushed,
           requireApproval: this.config.requireApproval,
-        },
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+        }
+      );
     } catch (error: any) {
-      return {
-        gate: 'review',
-        passed: false,
-        message: `Git 检查失败: ${error.message}`,
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return fromError('review', 'Git 检查失败', error, startTime);
     }
   }
 

package/src/gates/security.ts

@@ -8,6 +8,7 @@
  */
 
 import { execAsync } from '../utils/exec';
+import { pass, gateResult, fromError } from './types';
 import type { GateResult, GateContext, SecurityGateConfig, Gate, GateDecision } from './types';
 import { decisionFromResult } from './decision';
 
@@ -43,13 +44,7 @@ export class SecurityGate implements Gate {
     const startTime = Date.now();
 
     if (!this.config.enabled) {
-      return {
-        gate: 'security',
-        passed: true,
-        message: '安全门禁已禁用',
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return pass('security', '安全门禁已禁用', startTime);
     }
 
     try {
@@ -65,13 +60,14 @@ export class SecurityGate implements Gate {
 
       const passed = this.isPassed(analysis);
 
-      return {
-        gate: 'security',
+      return gateResult(
+        'security',
         passed,
-        message: passed
+        passed
           ? '安全扫描通过'
           : `发现 ${analysis.critical} 个严重漏洞, ${analysis.high} 个高危漏洞`,
-        details: {
+        startTime,
+        {
           critical: analysis.critical,
           high: analysis.high,
           moderate: analysis.moderate,
@@ -79,18 +75,10 @@ export class SecurityGate implements Gate {
           total: analysis.total,
           vulnerabilities: analysis.vulnerabilities.slice(0, 10), // 只返回前 10 个
           scanCommand,
-        },
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+        }
+      );
     } catch (error: any) {
-      return {
-        gate: 'security',
-        passed: false,
-        message: `安全扫描失败: ${error.message}`,
-        timestamp: new Date().toISOString(),
-        duration: Date.now() - startTime,
-      };
+      return fromError('security', '安全扫描失败', error, startTime);
     }
   }
 

package/src/gates/types.ts

@@ -1,5 +1,5 @@
 /**
- * 门禁类型定义
+ * 门禁类型定义 + GateResult 构造器
  */
 
 /**
@@ -17,6 +17,65 @@ export interface GateResult {
   duration?: number;
 }
 
+/**
+ * GateResult 构造器：报告层的唯一落点
+ *
+ * gate/passed/message 逐次手写最容易漏的是 duration（无类型可救，字段是可选的）；
+ * 时间戳与耗时口径也由此统一。无 details 时不出该键（与手写形状一致）。
+ */
+export function gateResult(
+  gate: string,
+  passed: boolean,
+  message: string,
+  startedAt: number,
+  details?: Record<string, any>
+): GateResult {
+  return {
+    gate,
+    passed,
+    message,
+    ...(details ? { details } : {}),
+    timestamp: new Date().toISOString(),
+    duration: Date.now() - startedAt,
+  };
+}
+
+/** 通过报告 */
+export function pass(
+  gate: string,
+  message: string,
+  startedAt: number,
+  details?: Record<string, any>
+): GateResult {
+  return gateResult(gate, true, message, startedAt, details);
+}
+
+/** 未通过报告 */
+export function fail(
+  gate: string,
+  message: string,
+  startedAt: number,
+  details?: Record<string, any>
+): GateResult {
+  return gateResult(gate, false, message, startedAt, details);
+}
+
+/**
+ * 异常报告：message = `${label}: ${原因}`
+ *
+ * 非 Error 抛出物按 String() 取原因（原 `error.message` 会得到 undefined）。
+ */
+export function fromError(
+  gate: string,
+  label: string,
+  error: unknown,
+  startedAt: number,
+  details?: Record<string, any>
+): GateResult {
+  const reason = error instanceof Error ? error.message : String(error);
+  return fail(gate, `${label}: ${reason}`, startedAt, details);
+}
+
 /**
  * 门禁决策三态（守卫/门禁统一，G1）
  *
@@ -145,15 +204,21 @@ export interface ContractGateConfig {
 }
 
 /**
- * 验收标准门禁配置
+ * 验收标准门禁配置（单一正本，harness#101：并入原 acceptance.ts 宽版的 e2e 字段）
  */
 export interface SpecAcceptanceGateConfig {
-  /** tasks.yml 路径 */
+  /** tasks.yml 路径；相对值按 check 上下文的 projectPath 解析，缺省 `<projectPath>/tasks.yml` */
   tasksPath?: string;
   /** 是否检查所有任务 */
   checkAllTasks?: boolean;
   /** 自定义验收条件 */
   customAcceptanceCriteria?: Record<string, (task: any) => Promise<boolean>>;
+  /** E2E 测试命令模板 */
+  e2eTestCommand?: string;
+  /** E2E 测试超时时间（毫秒） */
+  e2eTestTimeout?: number;
+  /** 项目路径 */
+  projectPath?: string;
 }
 
 /**
@@ -164,12 +229,12 @@ export interface AcceptanceGateContext {
   projectPath: string;
   /** 任务 ID */
   taskId?: string;
-  /** tasks.yml 路径 */
+  /** tasks.yml 路径；相对值按 projectPath 解析 */
   tasksPath?: string;
 }
 
 /**
- * 验收标准
+ * 验收标准（旧格式，向后兼容）
  */
 export interface AcceptanceCriteria {
   id: string;

package/src/hooks/CONTEXT.md

@@ -13,7 +13,7 @@ H5（#44）起增加两个机制（G2/G7）：
 - `assertHookRegistryClosed` — 注册表闭环双向校验（构建/测试期）
 - `HookConfig`（type）— per-hook 配置声明（归一后形状）
 - `toErrorStrategy` — blocking → errorStrategy 无损映射（G7）
-- `bootstrapHarness` / `bootstrapHarnessSync` — Harness 启动引导
+- `bootstrapHarness` / `bootstrapHarnessSync` — Harness 启动引导；也是 trace 记录器的组合根：`new ConstraintChecker(getTraceCollector())`（harness#88，core 不上行依赖 monitoring，故由本层接线）
 
 ## 依赖关系
 - 依赖 `src/types/` Hook 相关类型

package/src/hooks/bootstrap.ts

@@ -10,11 +10,14 @@
  * const harness = await bootstrapHarness('/path/to/project');
  * // harness.checker, harness.config, harness.hooks, harness.sessions
  * ```
+ *
+ * checker 的 trace 记录器在此接线（harness#88：core 不上行依赖 monitoring）。
  */
 
 import { ConstraintChecker } from '../core/constraints/checker';
 import { SessionManager } from '../context/session-manager';
 import { ProjectConfigLoader } from '../core/project-config-loader';
+import { getTraceCollector } from '../monitoring/traces';
 import { HookRegistry } from './registry';
 import { HookPipeline } from './pipeline';
 import type { MergedConstraintsConfig } from '../types/project-config';
@@ -72,7 +75,7 @@ export async function bootstrapHarness(
   const { mergedConstraints } = await loadConfigAsync(resolvedPath);
 
   // 2. 初始化核心组件
-  const checker = ConstraintChecker.getInstance();
+  const checker = new ConstraintChecker(getTraceCollector());
 
   const sessions = new SessionManager(resolvedPath);
   const hooks = new HookRegistry();
@@ -108,7 +111,7 @@ export function bootstrapHarnessSync(
   loader.load();
   const mergedConstraints = loader.mergeConstraints();
 
-  const checker = ConstraintChecker.getInstance();
+  const checker = new ConstraintChecker(getTraceCollector());
 
   const sessions = new SessionManager(resolvedPath);
   const hooks = new HookRegistry();

package/src/index.ts

@@ -103,11 +103,9 @@ export type {
   PassesGateResult,
   PassesGateCheckResult,
   PassesGateViolation,
-  PassesGateExtension,
   TestResult,
   DynamicTask,
   TaskTestResult,
-  ExtensionTestResult,
 } from './types/passes-gate';
 export type {
   StepMeta,
@@ -137,8 +135,6 @@ export type {
   TaskStepStatus,
   SessionInfo,
 } from './types/session';
-// 与 passes-gate 同名类型的 session 版（沿用既有别名）
-export { DynamicTask as ExtendedDynamicTask, TaskTestResult as ExtendedTaskTestResult } from './types/session';
 
 // ========================================
 // Spec 验证（已接线的 spec 故事：validator + SpecAcceptanceGate）

package/src/knowledge/CONTEXT.md

@@ -17,13 +17,14 @@
 - 所有模式支持 `decayAt` 硬过期
 
 ## 核心导出
-- `KnowledgeStore` — 知识条目 CRUD + 结构化存储
+- `KnowledgeStore` — 知识条目 CRUD + 结构化存储；`saveAll()` 批量写入（循环内只更新内存索引、结束一次 writeIndex，harness#107）
 - `KnowledgeQuery` — 语义搜索 + 类型/标签过滤 + `queryByMode()` + `consume(taskContext)`；`query()` 是 budget 截断管线（仅用于 prompt 注入），`search()` 是全语料文本搜索（先匹配→排序→limit，交互搜索专用，勿用 query() 代替）
 - `KnowledgeLifecycle` — per-mode 生命周期管理
 - `KnowledgeIngest` — 知识摄取引擎（含 ingest gate 质量门）+ `ingestExternal()` 外部内容摄入
 - `sanitizeExternalContent` — 外部内容安全清洗（过滤注入模式 + 长度限制）
 - `migrateKnowledgeEntries` — AS-021 迁移工具（为现有条目添加 consumptionMode/origin）
-- `KnowledgeAudit` — 6 维度质量审计引擎
+- `KnowledgeAudit` — 7 维度质量审计引擎。per-entry 规则记录带 `scope: 'active' | 'all'`（active = 不判定 archived 条目）；人口过滤由 `ruleDetail()` 统一执行，规则内禁止再写 `entry.maturity === 'archived'` 早返回。规则中文 label 正本在规则定义的 `label` 字段（harness#109，ADR-0002 定义即注册），`AUDIT_RULE_LABELS` 派生导出、与 `AuditRuleName` 编译期闭环，CLI 展示层直接消费、禁止另建 label 表
+- `flywheel-metrics`（包内，不进导出面）— 知识飞轮指标唯一实现：`evaluateFlywheel(env)` 出 canonical 比例、`genuineRefs()` 出 synthetic 过滤口径，audit D6 / `knowledge stats` / `knowledge health` 三处共消费（ADR-0013）
 - `ReferenceTracker` — 知识引用关系图谱
 - `KnowledgeLinter` — 知识质量检查(完整性/一致性/时效性)
 - `ColdStartImporter` — 冷启动知识导入
@@ -32,20 +33,24 @@
 
 ## 依赖关系
 - 依赖 `src/types/` 知识相关类型
+- 依赖 `src/utils/frontmatter` — markdown frontmatter 解析/序列化的唯一正本（harness#89：store、migration、index-generator、ingest 共用同一套语法判定，不再各写正则）
 - 依赖 `src/context/types`（ContextUsageSnapshot 等类型；不依赖 monitoring——知识健康评分由本目录 doctor.ts 的 KnowledgeHealthScorer 承载）
 - 被 `src/cli/commands/knowledge.ts` CLI 消费（含 `migrate` 子命令）
 
 ## 约定
+- 知识条目文件的 frontmatter 语法只由 `src/utils/frontmatter` 定义（harness#89）：缺头/空 meta = `absent`（合法输入，按非条目静默处理）；未闭合/YAML 非法 = `malformed`（必须显式上报后按消费方语义恢复——migration 落 `errors`、store 与 index-generator 打一行 stderr 后跳过或走 best-effort），禁止静默丢条目；canonical 字段序是 `store.toFrontmatter` 的私有策略，`join` 只管包裹格式
 - 知识条目有明确的生命周期状态（按 consumptionMode 分化）
 - 约束退役（`harness constraints retire`，人确认）时写入 KnowledgeStore：规则原文 + 退役原因 + 历史统计
 - Linter 检查完整性/一致性/时效性三个维度
-- Audit 6 维度评分：D1结构 D2内容 D3去重 D4成熟度 D5新鲜度 D6飞轮
+- Audit 7 维度评分：D1结构 D2内容 D3去重 D4成熟度 D5新鲜度 D6飞轮 D7增量存活
 - Ingest gate: ingestEntry() 先经 audit.validate() 检查，reject 不入库
 - 外部内容三层防御：ingest sanitization + retrieval marking + prompt constraint
 - 消费饱和度替代固定 TTL 用于 signal 过期判断
+- **飞轮指标只有一个实现**（ADR-0013）：`refCoverage` / `avgRefs` / `consumptionHitRate` 一律出自 `flywheel-metrics.evaluateFlywheel()`，canonical 分子 = `genuineRefs()` 过滤后的真实消费引用（`search|test-agent|prompt-inject|monitor|analyst|...:<date>` 自动化按天记账键不算消费，`unknown:` 注入键算消费）。audit D6 / `knowledge stats` / `knowledge health` 只在展示层做单位与字段名映射（百分比取整、一位小数、`avgRefs`→`avgRefCount`），人口筛选留在各调用方。新增消费方禁止自行数 `referencedBy.length`。
 
 ## 注意事项
 - Phase 1+4 实现的知识引擎核心
 - 约束"退役不删除"——retire 落盘 config.yml `enabled: false` + retired 元数据，保留规则原文 + 退役原因 + 历史统计（可回滚）
 - `MaturityLevel` 包含 6 个值: draft/verified/proven/archived/active/deprecated
 - `excludeArchived` 同时排除 archived 和 deprecated
+- 仍有两处按**原始** `referencedBy.length` 判定，不属飞轮指标、ADR-0013 明确列为范围外：`lifecycle.ts` 的 signal 饱和 / reference 激活（退役阈值调整另票）、`knowledge health` 的 D1「verified 零引用」线索提示（逐条 issue 线索，非聚合分子）

package/src/knowledge/__tests__/audit-labels.test.ts

@@ -0,0 +1,44 @@
+/**
+ * 审计规则 label 闭环测试（架构评审 A6，#109）
+ *
+ * label 正本在 audit.ts 规则定义上（定义即注册），AUDIT_RULE_LABELS 派生自规则表。
+ * 新增规则无 label → 编译期/本测试期即失败，CLI 不再静默回落英文键名。
+ */
+
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { KnowledgeAudit, AUDIT_RULE_LABELS } from '../audit';
+import type { AuditRuleName } from '../audit';
+
+function makeTmpDir(): string {
+  return fs.mkdtempSync(path.join(os.tmpdir(), 'audit-labels-test-'));
+}
+
+describe('AUDIT_RULE_LABELS', () => {
+  let tmpDir: string;
+
+  beforeEach(() => {
+    tmpDir = makeTmpDir();
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('应与运行期 summary 的规则键集完全一致（双向闭环）', () => {
+    const report = new KnowledgeAudit({ baseDir: tmpDir }).run();
+    const summaryKeys = Object.keys(report.summary).sort();
+    const labelKeys = (Object.keys(AUDIT_RULE_LABELS) as AuditRuleName[]).sort();
+    expect(labelKeys).toEqual(summaryKeys);
+  });
+
+  it('每条规则都有非空中文 label，event-noise / deprecated-domain 不再缺失', () => {
+    for (const [rule, label] of Object.entries(AUDIT_RULE_LABELS)) {
+      expect(label.trim().length).toBeGreaterThan(0);
+      expect(label).not.toBe(rule); // 不允许回落英文键名
+    }
+    expect(AUDIT_RULE_LABELS['event-noise']).toBe('运维事件噪音');
+    expect(AUDIT_RULE_LABELS['deprecated-domain']).toBe('废弃领域残留');
+  });
+});