@dommaker/harness 1.1.1 → 1.2.0

package/src/__tests__/trace-analyzer-extra.test.ts

@@ -65,22 +65,21 @@ describe('TraceAnalyzer - 补充覆盖', () => {
   describe('compareWithPrevious', () => {
     it('应该计算环比变化', () => {
       const current: any[] = [
-        { constraintId: 'test', passRate: 0.8, failRate: 0.2, bypassRate: 0.1, level: 'iron_law' },
+        { constraintId: 'test', passRate: 0.8, failRate: 0.2, level: 'iron_law' },
       ];
       const previous: any[] = [
-        { constraintId: 'test', passRate: 0.6, failRate: 0.4, bypassRate: 0.2, level: 'iron_law' },
+        { constraintId: 'test', passRate: 0.6, failRate: 0.4, level: 'iron_law' },
       ];
 
       const result = analyzer.compareWithPrevious(current, previous);
-      
+
       expect(result[0]?.changeFromLastPeriod?.passRateDelta).toBeCloseTo(0.2);
       expect(result[0]?.changeFromLastPeriod?.failRateDelta).toBeCloseTo(-0.2);
-      expect(result[0]?.changeFromLastPeriod?.bypassRateDelta).toBeCloseTo(-0.1);
     });
 
     it('无历史数据应该不设置变化', () => {
       const current: any[] = [
-        { constraintId: 'new_test', passRate: 0.8, failRate: 0.2, bypassRate: 0.1, level: 'iron_law' },
+        { constraintId: 'new_test', passRate: 0.8, failRate: 0.2, level: 'iron_law' },
       ];
       const previous: any[] = [];
 
@@ -93,7 +92,7 @@ describe('TraceAnalyzer - 补充覆盖', () => {
   describe('saveSummary/loadSummary', () => {
     it('应该保存和加载汇总', () => {
       const summaries: any[] = [
-        { constraintId: 'test', passRate: 0.8, failRate: 0.2, bypassRate: 0.1, level: 'iron_law', totalChecks: 10 },
+        { constraintId: 'test', passRate: 0.8, failRate: 0.2, level: 'iron_law', totalChecks: 10 },
       ];
 
       analyzer.saveSummary(summaries);
@@ -157,7 +156,6 @@ describe('TraceAnalyzer - 补充覆盖', () => {
           level: 'iron_law',
           passRate: 0.8,
           failRate: 0.2,
-          bypassRate: 0.1,
           totalChecks: 100,
           recentTrend: 'stable',
         },
@@ -190,46 +188,6 @@ describe('TraceAnalyzer - 补充覆盖', () => {
     });
   });
 
-  describe('findMostCommon', () => {
-    it('应该找出最常见元素', () => {
-      // 通过 bypassReasons 统计来触发
-      const traces: ExecutionTrace[] = [
-        { constraintId: 'common_test', level: 'iron_law', timestamp: 1000, result: 'pass' },
-        { constraintId: 'common_test', level: 'iron_law', timestamp: 2000, result: 'pass', bypassReason: 'reason_a' },
-        { constraintId: 'common_test', level: 'iron_law', timestamp: 3000, result: 'pass', bypassReason: 'reason_a' },
-        { constraintId: 'common_test', level: 'iron_law', timestamp: 4000, result: 'pass', bypassReason: 'reason_b' },
-      ];
-
-      const summaries = analyzer.summarize(traces);
-
-      // 验证汇总结果存在
-      expect(summaries.length).toBeGreaterThan(0);
-    });
-
-    it('应该通过 exceptionApplied 触发 findMostCommon', () => {
-      const traces: ExecutionTrace[] = [
-        { constraintId: 'exc_test', level: 'guideline', timestamp: 1000, result: 'pass', exceptionApplied: 'simple_typo' },
-        { constraintId: 'exc_test', level: 'guideline', timestamp: 2000, result: 'pass', exceptionApplied: 'simple_typo' },
-        { constraintId: 'exc_test', level: 'guideline', timestamp: 3000, result: 'pass', exceptionApplied: 'config_error' },
-      ];
-
-      const summaries = analyzer.summarize(traces);
-      const summary = summaries.find(s => s.constraintId === 'exc_test');
-
-      expect(summary?.exceptionCount).toBe(3);
-      expect(summary?.mostCommonException).toBe('simple_typo');
-    });
-
-    it('无 exception 时 mostCommonException 应该是 undefined', () => {
-      const traces: ExecutionTrace[] = [
-        { constraintId: 'no_exc', level: 'iron_law', timestamp: 1000, result: 'pass' },
-      ];
-
-      const summaries = analyzer.summarize(traces);
-      expect(summaries[0]?.mostCommonException).toBeUndefined();
-    });
-  });
-
   describe('detectAnomalies - 更多异常类型', () => {
     it('应该检测 rising_fail_rate', () => {
       // 前半段全 fail，后半段全 pass → rising 趋势
@@ -253,44 +211,6 @@ describe('TraceAnalyzer - 补充覆盖', () => {
       const risingFail = anomalies.find(a => a.type === 'rising_fail_rate');
       expect(risingFail).toBeDefined();
     });
-
-    it('应该检测 rising_bypass_rate', () => {
-      // 前半段全 fail，后半段混合 pass+bypass → rising 趋势
-      // bypassRate 需要 > 0.1，且 trend === 'rising'
-      const traces: ExecutionTrace[] = [];
-      for (let i = 0; i < 6; i++) {
-        traces.push({ constraintId: 'rising_bypass', level: 'guideline', timestamp: 1000 + i * 100, result: 'fail' });
-      }
-      for (let i = 6; i < 14; i++) {
-        // 后半段有 pass 也有 bypass，使 passRate 上升（rising），同时 bypassRate > 0.1
-        traces.push({ constraintId: 'rising_bypass', level: 'guideline', timestamp: 1000 + i * 100, result: i % 2 === 0 ? 'pass' : 'bypassed' });
-      }
-
-      const summaries = analyzer.summarize(traces);
-      const anomalies = analyzer.detectAnomalies(summaries);
-
-      const risingBypass = anomalies.find(a => a.type === 'rising_bypass_rate');
-      expect(risingBypass).toBeDefined();
-    });
-
-    it('应该检测 exception_overuse', () => {
-      const traces: ExecutionTrace[] = [];
-      for (let i = 0; i < 10; i++) {
-        traces.push({
-          constraintId: 'exc_overuse',
-          level: 'guideline',
-          timestamp: 1000 + i * 100,
-          result: 'pass',
-          exceptionApplied: i < 8 ? 'simple_typo' : undefined,
-        });
-      }
-
-      const summaries = analyzer.summarize(traces);
-      const anomalies = analyzer.detectAnomalies(summaries);
-
-      const excOveruse = anomalies.find(a => a.type === 'exception_overuse');
-      expect(excOveruse).toBeDefined();
-    });
   });
 
   describe('createAnalyzer 工厂函数', () => {
@@ -300,7 +220,7 @@ describe('TraceAnalyzer - 补充覆盖', () => {
     });
 
     it('应该支持自定义配置', () => {
-      const a = createAnalyzer({ thresholds: { bypassRate: 0.05 } });
+      const a = createAnalyzer({ thresholds: { failRate: 0.05 } });
       expect(a).toBeDefined();
     });
   });

package/src/__tests__/trace-analyzer.test.ts

@@ -75,11 +75,11 @@ describe('TraceAnalyzer', () => {
   });
 
   describe('detectAnomalies', () => {
-    it('应该检测高绕过率异常', () => {
+    it('应该检测失败率异常', () => {
       const traces: ExecutionTrace[] = [
-        { constraintId: 'test', level: 'guideline', timestamp: 1000, result: 'bypassed' },
-        { constraintId: 'test', level: 'guideline', timestamp: 2000, result: 'bypassed' },
-        { constraintId: 'test', level: 'guideline', timestamp: 3000, result: 'bypassed' },
+        { constraintId: 'test', level: 'guideline', timestamp: 1000, result: 'fail' },
+        { constraintId: 'test', level: 'guideline', timestamp: 2000, result: 'fail' },
+        { constraintId: 'test', level: 'guideline', timestamp: 3000, result: 'fail' },
         { constraintId: 'test', level: 'guideline', timestamp: 4000, result: 'pass' },
       ];
 
@@ -120,7 +120,6 @@ describe('TraceAnalyzer', () => {
     it('应该支持自定义阈值', () => {
       const customAnalyzer = new TraceAnalyzer(collector, {
         thresholds: {
-          bypassRate: 0.1,
           failRate: 0.2,
         },
       });

package/src/__tests__/trace-collector.test.ts

@@ -104,17 +104,6 @@ describe('TraceCollector', () => {
     });
   });
 
-  describe('recordBypass', () => {
-    it('应该记录绕过 trace', () => {
-      collector.recordBypass('no_bypass_checkpoint', 'iron_law', 'Emergency fix');
-
-      const traces = collector.read();
-      expect(traces.length).toBe(1);
-      expect(traces[0].result).toBe('bypassed');
-      expect(traces[0].bypassReason).toBe('Emergency fix');
-    });
-  });
-
   describe('read', () => {
     it('应该返回所有 traces', () => {
       collector.record({

package/src/__tests__/traces.test.ts

@@ -57,7 +57,7 @@ describe('TraceCollector', () => {
   test('should filter traces by constraint ID', () => {
     collector.recordPass('constraint_a', 'iron_law');
     collector.recordFail('constraint_b', 'guideline');
-    collector.recordBypass('constraint_a', 'iron_law', 'user reason');
+    collector.recordFail('constraint_a', 'iron_law');
 
     const traces = collector.read({ constraintId: 'constraint_a' });
     expect(traces.length).toBe(2);
@@ -226,7 +226,7 @@ describe('TraceAnalyzer', () => {
         constraintId: 'constraint_b',
         level: 'iron_law',
         timestamp: Date.now() - i * 60 * 1000,
-        result: i < 3 ? 'pass' : 'bypassed',
+        result: i < 3 ? 'pass' : 'fail',
       });
     }
 
@@ -243,26 +243,7 @@ describe('TraceAnalyzer', () => {
 
     const summaryB = summaries.find(s => s.constraintId === 'constraint_b');
     expect(summaryB).toBeDefined();
-    expect(summaryB!.bypassRate).toBeCloseTo(0.4, 1);
-  });
-
-  test('should detect high bypass rate anomaly', () => {
-    // 记录高绕过率的 traces
-    for (let i = 0; i < 10; i++) {
-      collector.record({
-        constraintId: 'problematic_constraint',
-        level: 'guideline',
-        timestamp: Date.now(),
-        result: i < 3 ? 'pass' : 'bypassed', // 70% 绕过率
-      });
-    }
-
-    const traces = collector.read();
-    const summaries = analyzer.summarize(traces);
-    const anomalies = analyzer.detectAnomalies(summaries);
-
-    expect(anomalies.length).toBeGreaterThan(0);
-    expect(anomalies.some(a => a.type === 'high_bypass_rate')).toBe(true);
+    expect(summaryB!.failRate).toBeCloseTo(0.4, 1);
   });
 
   test('should detect rising fail rate anomaly', () => {

package/src/cli/commands/CONTEXT.md

@@ -10,7 +10,7 @@ H5（#44）起：
 ## 核心导出
 - `COMMAND_DEFINITIONS`（definitions.ts）— 全部非门禁命令定义（纯数据模块，禁止 import 命令实现）
 - 各命令文件：check / validate / passes-gate / init / report / status / spec / sync-docs / knowledge / sdd / failure / posteval-plan / release / analyze-sessions / update-user-model / constraints / doc-freshness-check / spec-baseline-check
-- 6 门禁命令实现在 `acceptance` / `command` / `contract` / `performance` / `review` / `security`（其 CLI 元数据在 `src/gates/definitions.ts`）
+- 6 门禁命令实现在 `acceptance` / `command` / `contract` / `performance` / `review` / `security`（其 CLI 元数据在 `src/gates/definitions.ts`，形状同为 `CommandDefinition`，ADR-0007）
 
 `constraints` 下挂治理子命令：`constraints report`（使用统计 + 退役候选诊断 + 配置健康 + 注入漂移，`--export` 脱敏）、`constraints retire`（交互选择 + 人确认退役；带 id 直达需显式 `--yes`（#24 人确认闸门），无 `--yes` 报错 + 非零退出码且不落盘；内置落 config.yml retired 元数据，custom 落 custom-constraints.yml 条目 retired 段（#82 D6 一处真相）+ KnowledgeStore 沉淀 + CLAUDE.md 注入段同步）。
 
@@ -31,4 +31,4 @@ H5（#44）起：
 ## 注意事项
 - 新增命令需同步更新 CLAUDE.md / CAPABILITIES.md / src/CONTEXT.md
 - knowledge 命令包含 13 个子操作（list/search/import/decay/stats/upsert/sync-status/sync-rag/audit/snapshot/migrate/index/health）
-- 特殊路由（选项条件、子命令兜底、退出码处理）表达在定义表的 optionRoutes / subcommands / afterRun 字段，bin 是纯通用引擎、不含单命令知识
+- 特殊路由（选项条件、子命令兜底、退出码处理、裸跑语义）表达在定义表的 optionRoutes / subcommands / subcommandStrict / bareRunsAction / afterRun 字段，bin 是纯通用引擎、不含单命令知识

package/src/cli/commands/__tests__/check-skip-output.test.ts

@@ -34,13 +34,16 @@ jest.mock('../../../core/constraints/checker', () => ({
   },
 }));
 
-// Mock ProjectConfigLoader
-jest.mock('../../../core/project-config-loader', () => ({
-  ProjectConfigLoader: jest.fn().mockImplementation(() => ({
-    load: jest.fn(),
-    hasCustomConfig: jest.fn().mockReturnValue(false),
-    mergeConstraints: jest.fn().mockReturnValue({ custom: [], disabled: [] }),
-  })),
+// Mock effective-constraints（ADR-0001：check 经 getMergedConstraintsConfig 走生效集链路）
+jest.mock('../../../core/effective-constraints', () => ({
+  getMergedConstraintsConfig: jest.fn().mockReturnValue({
+    ironLaws: {},
+    guidelines: {},
+    prompts: {},
+    custom: [],
+    disabled: [],
+    unknownIds: [],
+  }),
 }));
 
 // Mock chalk

package/src/cli/commands/__tests__/check.test.ts

@@ -5,7 +5,7 @@
 import { check, listLaws } from '../check';
 import * as fs from 'fs';
 import { constraintChecker } from '../../../core/constraints/checker';
-import { ProjectConfigLoader } from '../../../core/project-config-loader';
+import { getMergedConstraintsConfig } from '../../../core/effective-constraints';
 import { execAsync } from '../../../utils/exec';
 
 // Mock fs
@@ -45,13 +45,16 @@ jest.mock('../../../core/constraints/checker', () => ({
   },
 }));
 
-// Mock ProjectConfigLoader
-jest.mock('../../../core/project-config-loader', () => ({
-  ProjectConfigLoader: jest.fn().mockImplementation(() => ({
-    load: jest.fn(),
-    hasCustomConfig: jest.fn().mockReturnValue(false),
-    mergeConstraints: jest.fn().mockReturnValue({ custom: [], disabled: [] }),
-  })),
+// Mock effective-constraints（ADR-0001：check 经 getMergedConstraintsConfig 走生效集链路）
+jest.mock('../../../core/effective-constraints', () => ({
+  getMergedConstraintsConfig: jest.fn().mockReturnValue({
+    ironLaws: {},
+    guidelines: {},
+    prompts: {},
+    custom: [],
+    disabled: [],
+    unknownIds: [],
+  }),
 }));
 
 // Mock chalk
@@ -65,7 +68,7 @@ jest.mock('chalk', () => ({
 
 const mockFs = fs as jest.Mocked<typeof fs> & { readdirSync: jest.Mock };
 const mockChecker = constraintChecker as jest.Mocked<typeof constraintChecker>;
-const MockProjectConfigLoader = ProjectConfigLoader as jest.MockedClass<typeof ProjectConfigLoader>;
+const mockGetMergedConfig = getMergedConstraintsConfig as jest.MockedFunction<typeof getMergedConstraintsConfig>;
 const mockExecAsync = execAsync as jest.MockedFunction<typeof execAsync>;
 
 describe('check command', () => {
@@ -73,6 +76,15 @@ describe('check command', () => {
 
   beforeEach(() => {
     jest.clearAllMocks();
+    // clearAllMocks 不清实现，显式恢复默认 merged config，避免用例间泄漏
+    mockGetMergedConfig.mockReturnValue({
+      ironLaws: {},
+      guidelines: {},
+      prompts: {},
+      custom: [],
+      disabled: [],
+      unknownIds: [],
+    });
     consoleSpy = jest.spyOn(console, 'log').mockImplementation();
     process.exitCode = 0;
   });
@@ -123,12 +135,14 @@ describe('check command', () => {
     });
 
     it('应该加载自定义约束', async () => {
-      const mockLoader = {
-        load: jest.fn(),
-        hasCustomConfig: jest.fn().mockReturnValue(true),
-        mergeConstraints: jest.fn().mockReturnValue({ custom: [{ id: 'custom', rule: 'test', message: 'test', level: 'iron_law', trigger: 'code_implementation', enforcement: 'checkpoint-required' }], disabled: ['disabled_constraint'] }),
-      };
-      (MockProjectConfigLoader as any).mockImplementation(() => mockLoader);
+      mockGetMergedConfig.mockReturnValue({
+        ironLaws: {},
+        guidelines: {},
+        prompts: {},
+        custom: ['custom'],
+        disabled: ['disabled_constraint'],
+        unknownIds: [],
+      });
 
       mockChecker.checkConstraints.mockResolvedValue({
         passed: true,
@@ -399,23 +413,6 @@ describe('check command', () => {
       expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('记录已足够'));
     });
 
-    it('应该在绕过率高时提示查看详情', async () => {
-      // 20 条记录，15 条 bypassed (75% > 30%)
-      const traces = [
-        ...Array(5).fill('{"result":"pass"}'),
-        ...Array(15).fill('{"result":"bypassed"}'),
-      ].join('\n');
-      mockFs.existsSync.mockImplementation((p: any) => {
-        if (p.includes('traces.log')) return true;
-        if (p.includes('.state.json')) return false;
-        return false;
-      });
-      mockFs.readFileSync.mockReturnValue(traces);
-
-      await check({ preset: 'default', staged: false });
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('异常趋势'));
-    });
-
     it('应该不重复显示已显示的提示', async () => {
       const traces = Array(50).fill('{"result":"pass"}').join('\n');
       mockFs.existsSync.mockReturnValue(true);
@@ -445,43 +442,6 @@ describe('check command', () => {
       expect(output).not.toContain('────────────────');
     });
 
-    it('应该在绕过率低于 30% 时不提示', async () => {
-      // 20 条记录，2 条 bypassed (10% < 30%)
-      const traces = [
-        ...Array(18).fill('{"result":"pass"}'),
-        ...Array(2).fill('{"result":"bypassed"}'),
-      ].join('\n');
-      mockFs.existsSync.mockImplementation((p: any) => {
-        if (p.includes('traces.log')) return true;
-        if (p.includes('.state.json')) return false;
-        return false;
-      });
-      mockFs.readFileSync.mockReturnValue(traces);
-
-      await check({ preset: 'default', staged: false });
-      const output = consoleSpy.mock.calls.map(c => c[0]).join('\n');
-      expect(output).not.toContain('异常趋势');
-    });
-
-    it('应该处理无效 JSON trace 行', async () => {
-      // 20 条记录，部分无效 JSON，部分 bypassed
-      const traces = [
-        ...Array(5).fill('invalid json'),
-        ...Array(5).fill('{"result":"pass"}'),
-        ...Array(10).fill('{"result":"bypassed"}'),
-      ].join('\n');
-      mockFs.existsSync.mockImplementation((p: any) => {
-        if (p.includes('traces.log')) return true;
-        if (p.includes('.state.json')) return false;
-        return false;
-      });
-      mockFs.readFileSync.mockReturnValue(traces);
-
-      await check({ preset: 'default', staged: false });
-      // 15 条有效，10 条 bypassed，bypassRate = 10/20 = 0.5 > 0.3
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('异常趋势'));
-    });
-
     it('应该保存状态文件当有提示时', async () => {
       const traces = Array(50).fill('{"result":"pass"}').join('\n');
       mockFs.existsSync.mockImplementation((p: any) => {

package/src/cli/commands/__tests__/constraints-report.test.ts

@@ -170,7 +170,7 @@ describe('buildConstraintsUsageReport', () => {
     const candidates = diagnoseRetireCandidates([
       {
         id: 'x', level: 'guideline',
-        total: 60, pass: 0, fail: 0, skip: 60, bypassed: 0,
+        total: 60, pass: 0, fail: 0, skip: 60,
         evaluated: 0, failRate: 0,
       },
     ]);

package/src/cli/commands/__tests__/knowledge.test.ts

@@ -2,7 +2,7 @@
  * knowledge 命令测试 — knowledgeAudit
  */
 
-import { knowledgeAudit, knowledgeStats, knowledgeHealth } from '../knowledge';
+import { knowledgeAudit, knowledgeStats, knowledgeHealth, knowledgeSearch } from '../knowledge';
 
 // Mock chalk
 jest.mock('chalk', () => ({
@@ -233,3 +233,92 @@ describe('knowledgeHealth CLI', () => {
     expect(parsed.summary.staleEntries).toBe(1);
   });
 });
+
+/**
+ * knowledgeSearch 回归测试 — harness#63
+ * bug：先按 token budget 截断再文本匹配，新条目（lastReferenced 为空、排序队尾）
+ * 在语料超过 budget 时永远进不了匹配阶段。
+ */
+describe('knowledgeSearch CLI (harness#63)', () => {
+  const fs = require('fs');
+  const os = require('os');
+  const path = require('path');
+  const { FileKnowledgeStore } = require('../../../knowledge/store');
+
+  let tmpProject: string;
+  let knowledgeDir: string;
+  let consoleSpy: jest.SpyInstance;
+
+  const FILLER_COUNT = 25; // 25 × ~800 tokens ≈ 20000 > maxTokens 10000
+  const TARGET_ID = 'PIT-020';
+
+  function makeEntry(overrides: Record<string, any>): any {
+    return {
+      id: 'X-000',
+      type: 'pitfall',
+      title: '条目',
+      content: '内容',
+      maturity: 'proven',
+      layer: 'project',
+      created: '2026-08-01T00:00:00.000Z',
+      lastReferenced: '2026-08-01T00:00:00.000Z',
+      contributors: [],
+      projects: [],
+      tags: [],
+      applicablePhases: [],
+      sourceReferences: [],
+      referencedBy: [],
+      executionResults: [],
+      consumptionMode: 'reference',
+      origin: 'agent',
+      ...overrides,
+    };
+  }
+
+  beforeEach(() => {
+    tmpProject = fs.mkdtempSync(path.join(os.tmpdir(), 'harness-k63-'));
+    knowledgeDir = path.join(tmpProject, '.harness', 'knowledge');
+    fs.mkdirSync(knowledgeDir, { recursive: true });
+    consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+
+    const store = new FileKnowledgeStore({ baseDir: knowledgeDir });
+    // 高成熟度 + 有 lastReferenced 的填充条目排在前面，吃满 token budget
+    for (let i = 0; i < FILLER_COUNT; i++) {
+      store.save(makeEntry({
+        id: `FILL-${String(i).padStart(3, '0')}`,
+        title: `填充条目 ${i}`,
+        content: '填'.repeat(399) + '共同词',
+      }));
+    }
+    // 目标条目：新条目，draft + lastReferenced 为空，排在队尾
+    store.save(makeEntry({
+      id: TARGET_ID,
+      title: '新条目',
+      maturity: 'draft',
+      lastReferenced: '',
+      content: 'autolink 相关条目 共同词',
+    }));
+  });
+
+  afterEach(() => {
+    consoleSpy.mockRestore();
+    fs.rmSync(tmpProject, { recursive: true, force: true });
+  });
+
+  async function searchJson(query: string, limit: number): Promise<any> {
+    await knowledgeSearch(query, { projectPath: tmpProject, json: true, limit });
+    const output = consoleSpy.mock.calls.map((c: any[]) => c[0]).join('\n');
+    return JSON.parse(output);
+  }
+
+  it('语料超过 token budget 时，排在队尾的新条目仍可被搜到', async () => {
+    const result = await searchJson('autolink', 200);
+    expect(result.total).toBe(1);
+    expect(result.entries[0].id).toBe(TARGET_ID);
+  });
+
+  it('超高频关键词的返回数 = 实际匹配数（截断只发生在匹配之后）', async () => {
+    const result = await searchJson('共同词', 200);
+    expect(result.total).toBe(FILLER_COUNT + 1);
+  });
+});

package/src/cli/commands/__tests__/registry.test.ts

@@ -51,11 +51,10 @@ describe('命令注册表闭环', () => {
   });
 
   it('全部实现引用可解析（module 存在且 export 是函数）', () => {
-    const refs = collectRefs(COMMAND_DEFINITIONS);
-    for (const def of GATE_DEFINITIONS) {
-      refs.push(def.cli.action);
-      for (const entry of Object.values(def.cli.subcommands || {})) refs.push(entry);
-    }
+    const refs = collectRefs([
+      ...COMMAND_DEFINITIONS,
+      ...GATE_DEFINITIONS.map(d => d.cli),
+    ]);
     expect(refs.length).toBeGreaterThan(0);
 
     for (const ref of refs) {
@@ -107,7 +106,10 @@ describe('命令注册表闭环', () => {
         }
         for (const child of def.children || []) walk(child);
       };
-      for (const def of COMMAND_DEFINITIONS) walk(def);
+      for (const def of [
+        ...COMMAND_DEFINITIONS,
+        ...GATE_DEFINITIONS.map(d => d.cli),
+      ]) walk(def);
       // sync-docs --check 失败路径确实会请求退出
       expect(exitSpy).toHaveBeenCalled();
     } finally {

package/src/cli/commands/__tests__/status-extra.test.ts

@@ -81,7 +81,7 @@ describe('status command - 补充覆盖', () => {
       ];
       const mockAnalyze = {
         summarize: jest.fn().mockReturnValue([
-          { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 0.2, totalChecks: 10, bypassRate: 0.1 },
+          { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 0.2, failRate: 0.8, totalChecks: 10 },
         ]),
         detectAnomalies: jest.fn().mockReturnValue(mockAnomalies),
       };
@@ -119,8 +119,8 @@ describe('status command - 补充覆盖', () => {
       mockFs.readFileSync.mockReturnValue(mockTraces.map(t => JSON.stringify(t)).join('\n'));
 
       const mockSummaries = [
-        { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 1, totalChecks: 10, bypassRate: 0 },
-        { constraintId: 'no_completion_without_verification', level: 'iron_law', passRate: 0.8, totalChecks: 5, bypassRate: 0 },
+        { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 1, failRate: 0, totalChecks: 10 },
+        { constraintId: 'no_completion_without_verification', level: 'iron_law', passRate: 0.8, failRate: 0.2, totalChecks: 5 },
       ];
       const mockAnalyze = {
         summarize: jest.fn().mockReturnValue(mockSummaries),
@@ -141,7 +141,7 @@ describe('status command - 补充覆盖', () => {
       mockFs.readFileSync.mockReturnValue(mockTraces.map(t => JSON.stringify(t)).join('\n'));
 
       const mockSummaries = [
-        { constraintId: 'capability_sync', level: 'guideline', passRate: 0.9, totalChecks: 20, bypassRate: 0.1 },
+        { constraintId: 'capability_sync', level: 'guideline', passRate: 0.9, failRate: 0.1, totalChecks: 20 },
       ];
       const mockAnalyze = {
         summarize: jest.fn().mockReturnValue(mockSummaries),
@@ -164,8 +164,8 @@ describe('status command - 补充覆盖', () => {
       mockFs.readFileSync.mockReturnValue(mockTraces.map(t => JSON.stringify(t)).join('\n'));
 
       const mockSummaries = [
-        { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 1, totalChecks: 10, bypassRate: 0 },
-        { constraintId: 'capability_sync', level: 'guideline', passRate: 0.9, totalChecks: 20, bypassRate: 0.1 },
+        { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 1, failRate: 0, totalChecks: 10 },
+        { constraintId: 'capability_sync', level: 'guideline', passRate: 0.9, failRate: 0.1, totalChecks: 20 },
       ];
       const mockAnalyze = {
         summarize: jest.fn().mockReturnValue(mockSummaries),

package/src/cli/commands/__tests__/status.test.ts

@@ -87,7 +87,7 @@ describe('status command', () => {
       mockFs.readFileSync.mockReturnValue(mockTraces.map(t => JSON.stringify(t)).join('\n'));
 
       const mockSummarize = jest.fn().mockReturnValue([
-        { constraintId: 'test1', level: 'iron_law', passRate: 1, totalChecks: 1, bypassRate: 0 },
+        { constraintId: 'test1', level: 'iron_law', passRate: 1, failRate: 0, totalChecks: 1 },
       ]);
       const mockAnalyze = {
         summarize: mockSummarize,
@@ -106,7 +106,7 @@ describe('status command', () => {
       mockFs.readFileSync.mockReturnValue(mockTraces.map(t => JSON.stringify(t)).join('\n'));
 
       const mockSummarize = jest.fn().mockReturnValue([
-        { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 1, totalChecks: 5, bypassRate: 0 },
+        { constraintId: 'no_bypass_checkpoint', level: 'iron_law', passRate: 1, failRate: 0, totalChecks: 5 },
       ]);
       const mockAnalyze = {
         summarize: mockSummarize,
@@ -131,7 +131,7 @@ describe('status command', () => {
       ];
       const mockAnalyze = {
         summarize: jest.fn().mockReturnValue([
-          { constraintId: 'test1', level: 'iron_law', passRate: 0.2, totalChecks: 5, bypassRate: 0 },
+          { constraintId: 'test1', level: 'iron_law', passRate: 0.2, failRate: 0.8, totalChecks: 5 },
         ]),
         detectAnomalies: jest.fn().mockReturnValue(mockAnomalies),
       };
@@ -150,7 +150,7 @@ describe('status command', () => {
       mockFs.readFileSync.mockReturnValue(mockTraces.map(t => JSON.stringify(t)).join('\n'));
 
       const mockSummarize = jest.fn().mockReturnValue([
-        { constraintId: 'test1', level: 'iron_law', passRate: 0.8, totalChecks: 10, bypassRate: 0.1 },
+        { constraintId: 'test1', level: 'iron_law', passRate: 0.8, failRate: 0.2, totalChecks: 10 },
       ]);
       const mockAnalyze = {
         summarize: mockSummarize,
@@ -184,7 +184,7 @@ describe('status command', () => {
 
       const mockAnalyze = {
         summarize: jest.fn().mockReturnValue([
-          { constraintId: 'test_guide', level: 'guideline', passRate: 0.9, totalChecks: 10, bypassRate: 0 },
+          { constraintId: 'test_guide', level: 'guideline', passRate: 0.9, failRate: 0.1, totalChecks: 10 },
         ]),
         detectAnomalies: jest.fn().mockReturnValue([]),
       };
@@ -276,7 +276,7 @@ describe('status command', () => {
 
       const mockAnalyze = {
         summarize: jest.fn().mockReturnValue([
-          { constraintId: 'test_guide', level: 'guideline', passRate: 0.6, totalChecks: 10, bypassRate: 0.1 },
+          { constraintId: 'test_guide', level: 'guideline', passRate: 0.6, failRate: 0.4, totalChecks: 10 },
         ]),
         detectAnomalies: jest.fn().mockReturnValue([]),
       };