@dommaker/harness 1.8.1 → 1.10.0

package/dist/hooks/registry.js

@@ -1,141 +0,0 @@
-"use strict";
-/**
- * HookRegistry — hook 注册/注销/查询
- *
- * 纯簿记，无执行逻辑。线程不安全（Node.js 单线程）。
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HookRegistry = void 0;
-exports.assertHookRegistryClosed = assertHookRegistryClosed;
-/**
- * 注册表闭环双向校验（H5，复制 checker 闭环模式）
- *
- * 声明（HookConfig，consumer 的 per-hook 配置表）↔ 实现（注册的
- * HookDefinition）加载期双向校验，任一不满足即抛错，拒绝静默缺失：
- * - 引用未注册 → 抛错（声明了配置但没有注册实现 = 死配置）
- * - 注册无定义 → 抛错（注册了实现但没有配置声明 = 死代码）
- * - 重复声明 / 重复注册 → 抛错
- *
- * 断言限构建/测试期调用（harness 无内置 hook 定义，加载期闭环由
- * consumer 在其注册点/测试中调用本函数），不进入运行时热路径，
- * 不破坏 --help/--version 懒加载。消灭「hook 定义不注册 = 死代码」
- * 类 prompt 规矩（studio 侧随动）。
- *
- * @throws 任一方向不满足时抛错
- */
-function assertHookRegistryClosed(configs, hooks) {
-    const configNames = new Set();
-    for (const config of configs) {
-        if (configNames.has(config.name)) {
-            throw new Error(`[harness] hook 注册表闭环校验失败：hook 配置 "${config.name}" 重复声明。`);
-        }
-        configNames.add(config.name);
-    }
-    const hookNames = new Set();
-    for (const hook of hooks) {
-        if (hookNames.has(hook.name)) {
-            throw new Error(`[harness] hook 注册表闭环校验失败：hook "${hook.name}" 重复注册。`);
-        }
-        hookNames.add(hook.name);
-    }
-    for (const config of configs) {
-        if (!hookNames.has(config.name)) {
-            throw new Error(`[harness] hook 注册表闭环校验失败：hook 配置 "${config.name}" 引用的实现未注册。` +
-                `请注册同名 HookDefinition，或删除该配置声明。`);
-        }
-    }
-    for (const hook of hooks) {
-        if (!configNames.has(hook.name)) {
-            throw new Error(`[harness] hook 注册表闭环校验失败：hook "${hook.name}" 注册了实现但没有对应配置声明。` +
-                `请补齐 HookConfig 声明，或移除该实现。`);
-        }
-    }
-}
-class HookRegistry {
-    hooks = new Map();
-    /**
-     * 注册 hook（同名覆盖）
-     *
-     * 有效 `enabled` / `errorStrategy` 由 HookConfig 填充——配置表是这两个
-     * 语义的唯一声明点（#159），定义与配置名称不一致即抛错。
-     */
-    register(hook, config) {
-        if (hook.name !== config.name) {
-            throw new Error(`[harness] hook 注册失败：定义 "${hook.name}" 与配置 "${config.name}" 名称不一致。`);
-        }
-        this.hooks.set(hook.name, {
-            ...hook,
-            enabled: config.enabled,
-            errorStrategy: config.errorStrategy,
-        });
-    }
-    /**
-     * 批量注册（按 name 配对配置；有实现缺配置声明即抛错）
-     */
-    registerAll(hooks, configs) {
-        const configByName = new Map(configs.map(c => [c.name, c]));
-        for (const hook of hooks) {
-            const config = configByName.get(hook.name);
-            if (!config) {
-                throw new Error(`[harness] hook 注册失败：hook "${hook.name}" 没有对应的 HookConfig 声明。`);
-            }
-            this.register(hook, config);
-        }
-    }
-    /**
-     * 注销 hook
-     */
-    unregister(name) {
-        return this.hooks.delete(name);
-    }
-    /**
-     * 获取单个 hook（含有效 enabled / errorStrategy）
-     */
-    get(name) {
-        return this.hooks.get(name);
-    }
-    /**
-     * 获取指定时机、已启用的 hook，按优先级排序
-     */
-    getEnabled(phase) {
-        return Array.from(this.hooks.values())
-            .filter(h => h.phase === phase && h.enabled)
-            .sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
-    }
-    /**
-     * 列出所有 hook 名称
-     */
-    listNames() {
-        return Array.from(this.hooks.keys());
-    }
-    /**
-     * 列出所有 hook（含禁用）
-     */
-    listAll() {
-        return Array.from(this.hooks.values());
-    }
-    /**
-     * 启用/禁用 hook
-     */
-    setEnabled(name, enabled) {
-        const hook = this.hooks.get(name);
-        if (!hook)
-            return false;
-        hook.enabled = enabled;
-        return true;
-    }
-    /**
-     * 清空所有 hook
-     */
-    clear() {
-        this.hooks.clear();
-    }
-    /**
-     * Hook 数量
-     */
-    get size() {
-        return this.hooks.size;
-    }
-}
-exports.HookRegistry = HookRegistry;
-//# sourceMappingURL=registry.js.map

package/dist/hooks/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"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"}

package/dist/hooks/types.d.ts

@@ -1,113 +0,0 @@
-/**
- * Hooks 类型定义
- *
- * 通用 hook 管线：注册、排序、错误隔离、采样。
- * 无业务逻辑，consumer 自行定义 hook 名称和语义。
- */
-/**
- * Hook 执行时机
- */
-export type HookPhase = 'before' | 'after' | 'around';
-/**
- * Hook 错误处理策略（有效集合：'block' | 'warn'）
- *
- * #159 起原 'ignore' 退出有效面：策略的唯一声明点是 HookConfig（必填），
- * 不存在「未声明 strategy」的运行时形态。
- */
-export type HookErrorStrategy = 'block' | 'warn';
-/**
- * Hook 配置（G7 归一后形状：consumer 侧的 per-hook 声明表）
- *
- * 声明与实现构成注册表闭环（assertHookRegistryClosed 双向校验）：
- * - 声明（HookConfig）是「定义」侧：引用未注册实现 → 抛错
- * - 注册（HookDefinition）是「实现」侧：注册无对应声明 → 抛错
- *
- * #159 起本表是 `enabled` / `errorStrategy` 的**唯一声明点**：
- * HookDefinition 不再携带这两个字段，有效值在注册环节由本表填充
- * （见 EffectiveHook），声明与实现两处值矛盾在构造上不可能出现。
- *
- * 对应 studio 侧 per-hook 运行时配置（hooks/config.ts 的 DEFAULTS）语义：
- * blocking:true ↔ errorStrategy 'block'（失败阻断管线），
- * blocking:false ↔ errorStrategy 'warn'（记录警告继续）——无损映射见
- * config.ts 的 toErrorStrategy。
- */
-export interface HookConfig {
-    /** Hook 唯一名称（须与注册的 HookDefinition.name 一致） */
-    name: string;
-    /** 是否启用（false 时不进入管线） */
-    enabled: boolean;
-    /** 错误策略：block=失败阻断管线，warn=记录警告继续 */
-    errorStrategy: HookErrorStrategy;
-}
-/**
- * Hook 定义
- *
- * Consumer 自行选择 name（如 'beforeAgentExecute'），harness 只提供管线。
- * `enabled` / `errorStrategy` 不在此处声明——唯一声明点是 HookConfig（#159）。
- */
-export interface HookDefinition<C = unknown, R = unknown> {
-    /** Hook 唯一名称（consumer 定义语义） */
-    name: string;
-    /** 执行时机 */
-    phase: HookPhase;
-    /** 优先级（越小越先执行，默认 100） */
-    priority?: number;
-    /** 采样率 0-1（1=100% 执行，0.1=10% 采样） */
-    sampleRate?: number;
-    /** Hook 执行函数 */
-    execute: (context: C) => Promise<HookResult<R>>;
-}
-/**
- * 有效 hook = HookDefinition + 注册环节由 HookConfig 填充的有效值
- *
- * 管线与注册表的判定（启用过滤、block/warn 分派）只读本类型，
- * 值来源单一（HookConfig），不存在第二声明点。
- */
-export interface EffectiveHook<C = unknown, R = unknown> extends HookDefinition<C, R> {
-    /** 是否启用（来自 HookConfig.enabled） */
-    enabled: boolean;
-    /** 错误策略（来自 HookConfig.errorStrategy） */
-    errorStrategy: HookErrorStrategy;
-}
-/**
- * Hook 执行结果
- */
-export interface HookResult<R = unknown> {
-    /** 是否通过（blocking hook 必须返回 false 才阻断） */
-    passed: boolean;
-    /** 结果数据 */
-    data?: R;
-    /** 错误信息 */
-    error?: string;
-    /** 元数据（consumer 自行定义） */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Hook 执行记录
- */
-export interface HookExecutionRecord {
-    hookName: string;
-    phase: HookPhase;
-    startedAt: number;
-    completedAt: number;
-    durationMs: number;
-    passed: boolean;
-    error?: string;
-    sampled?: boolean;
-    /** 未执行标记之二：enabled:false 被 runOne 跳过（实现体零调用，镜像 sampled 先例） */
-    skipped?: boolean;
-}
-/**
- * 管线执行结果
- */
-export interface PipelineResult {
-    /** 是否全部通过（blocking hook 任一失败 = false） */
-    passed: boolean;
-    /** 各 hook 执行记录 */
-    records: HookExecutionRecord[];
-    /** 失败的 blocking hook 名称列表 */
-    blockedBy: string[];
-    /** 警告 hook 名称列表 */
-    warnings: string[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACtD,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CACjD;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IACnF,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB;IAClB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/hooks/types.js

@@ -1,9 +0,0 @@
-"use strict";
-/**
- * Hooks 类型定义
- *
- * 通用 hook 管线：注册、排序、错误隔离、采样。
- * 无业务逻辑，consumer 自行定义 hook 名称和语义。
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/src/__tests__/hooks-pipeline.test.ts

@@ -1,201 +0,0 @@
-/**
- * HookRegistry + HookPipeline 测试（Phase 1）
- *
- * #159 起 `enabled` / `errorStrategy` 由 HookConfig 唯一声明，
- * 注册时以配置填充有效值；HookDefinition 不再携带这两个字段。
- */
-import { describe, it, expect, beforeEach } from '@jest/globals';
-import { HookRegistry } from '../hooks/registry';
-import { HookPipeline } from '../hooks/pipeline';
-import type { HookConfig, HookDefinition } from '../hooks/types';
-
-interface TestContext {
-  value: string;
-  calls: string[];
-}
-
-function makeHook(
-  name: string,
-  opts: Partial<HookDefinition<TestContext, unknown>> = {}
-): HookDefinition<TestContext, unknown> {
-  return {
-    name,
-    phase: 'before',
-    priority: 100,
-    execute: async (ctx) => {
-      ctx.calls.push(name);
-      return { passed: true };
-    },
-    ...opts,
-  };
-}
-
-function makeConfig(name: string, overrides: Partial<HookConfig> = {}): HookConfig {
-  return { name, enabled: true, errorStrategy: 'block', ...overrides };
-}
-
-describe('HookRegistry', () => {
-  let registry: HookRegistry<TestContext, unknown>;
-
-  beforeEach(() => {
-    registry = new HookRegistry();
-  });
-
-  it('应注册 hook', () => {
-    registry.register(makeHook('test'), makeConfig('test'));
-    expect(registry.get('test')).toBeDefined();
-  });
-
-  it('同名注册应覆盖', () => {
-    registry.register(makeHook('test', { priority: 50 }), makeConfig('test'));
-    registry.register(makeHook('test', { priority: 90 }), makeConfig('test'));
-    expect(registry.get('test')?.priority).toBe(90);
-  });
-
-  it('应获取已启用的 hook 按优先级排序', () => {
-    registry.register(makeHook('low', { priority: 200 }), makeConfig('low'));
-    registry.register(makeHook('high', { priority: 10 }), makeConfig('high'));
-    registry.register(makeHook('mid', { priority: 100 }), makeConfig('mid'));
-    registry.register(makeHook('disabled'), makeConfig('disabled', { enabled: false }));
-
-    const enabled = registry.getEnabled('before');
-    expect(enabled.map(h => h.name)).toEqual(['high', 'mid', 'low']);
-  });
-
-  it('应注销 hook', () => {
-    registry.register(makeHook('test'), makeConfig('test'));
-    expect(registry.unregister('test')).toBe(true);
-    expect(registry.get('test')).toBeUndefined();
-  });
-
-  it('应设置启用/禁用', () => {
-    registry.register(makeHook('test'), makeConfig('test'));
-    expect(registry.setEnabled('test', false)).toBe(true);
-    expect(registry.getEnabled('before').length).toBe(0);
-    expect(registry.setEnabled('test', true)).toBe(true);
-    expect(registry.getEnabled('before').length).toBe(1);
-  });
-
-  it('应正确统计数量', () => {
-    expect(registry.size).toBe(0);
-    registry.register(makeHook('a'), makeConfig('a'));
-    registry.register(makeHook('b'), makeConfig('b'));
-    expect(registry.size).toBe(2);
-  });
-});
-
-describe('HookPipeline', () => {
-  let registry: HookRegistry<TestContext, unknown>;
-  let pipeline: HookPipeline<TestContext>;
-
-  beforeEach(() => {
-    registry = new HookRegistry();
-    pipeline = new HookPipeline(registry);
-  });
-
-  it('应执行所有 before hook', async () => {
-    const ctx: TestContext = { value: '', calls: [] };
-    registry.register(makeHook('h1'), makeConfig('h1'));
-    registry.register(makeHook('h2'), makeConfig('h2'));
-
-    const result = await pipeline.run('before', ctx);
-
-    expect(result.passed).toBe(true);
-    expect(ctx.calls).toEqual(['h1', 'h2']);
-    expect(result.records.length).toBe(2);
-  });
-
-  it('blocking hook 失败应停止后续', async () => {
-    const ctx: TestContext = { value: '', calls: [] };
-    registry.register(makeHook('pass1'), makeConfig('pass1'));
-    registry.register(makeHook('block', {
-      execute: async () => ({ passed: false, error: 'blocked' }),
-    }), makeConfig('block', { errorStrategy: 'block' }));
-    registry.register(makeHook('never_runs'), makeConfig('never_runs'));
-
-    const result = await pipeline.run('before', ctx);
-
-    expect(result.passed).toBe(false);
-    expect(result.blockedBy).toEqual(['block']);
-    // block hook 的 execute 被覆盖，不 push calls
-    expect(ctx.calls).toEqual(['pass1']);
-    expect(ctx.calls).not.toContain('never_runs');
-  });
-
-  it('warn hook 失败应继续但记录警告', async () => {
-    const ctx: TestContext = { value: '', calls: [] };
-    registry.register(makeHook('warn_hook', {
-      execute: async () => ({ passed: false, error: 'warning' }),
-    }), makeConfig('warn_hook', { errorStrategy: 'warn' }));
-    registry.register(makeHook('should_still_run'), makeConfig('should_still_run'));
-
-    const result = await pipeline.run('before', ctx);
-
-    expect(result.passed).toBe(true);
-    expect(result.warnings).toEqual(['warn_hook']);
-    expect(ctx.calls).toContain('should_still_run');
-  });
-
-  it('hook 抛异常应被捕获', async () => {
-    const ctx: TestContext = { value: '', calls: [] };
-    registry.register(makeHook('throws', {
-      execute: async () => { throw new Error('crash'); },
-    }), makeConfig('throws', { errorStrategy: 'warn' }));
-    registry.register(makeHook('after_crash', { priority: 200 }), makeConfig('after_crash'));
-
-    const result = await pipeline.run('before', ctx);
-
-    expect(result.records[0].error).toContain('crash');
-    expect(ctx.calls).toContain('after_crash');
-  });
-
-  it('runFull 应在 before/after 之间执行操作', async () => {
-    const ctx: TestContext = { value: '', calls: [] };
-    registry.register(makeHook('before_hook'), makeConfig('before_hook'));
-
-    const afterHook = makeHook('after_hook', { phase: 'after' });
-    registry.register(afterHook, makeConfig('after_hook'));
-
-    const { pipelineResult, operationResult } = await pipeline.runFull(ctx, async () => {
-      ctx.calls.push('operation');
-      return 'done';
-    });
-
-    expect(pipelineResult.passed).toBe(true);
-    expect(operationResult).toBe('done');
-    expect(ctx.calls).toEqual(['before_hook', 'operation', 'after_hook']);
-  });
-
-  it('before hook 失败不应执行操作', async () => {
-    const ctx: TestContext = { value: '', calls: [] };
-    registry.register(makeHook('block', {
-      execute: async () => ({ passed: false }),
-    }), makeConfig('block', { errorStrategy: 'block' }));
-
-    const { pipelineResult, operationResult } = await pipeline.runFull(ctx, async () => {
-      ctx.calls.push('should_not_run');
-      return 'nope';
-    });
-
-    expect(pipelineResult.passed).toBe(false);
-    expect(operationResult).toBeUndefined();
-    expect(ctx.calls).not.toContain('should_not_run');
-  });
-
-  it('空注册表应返回通过', async () => {
-    const result = await pipeline.run('before', { value: '', calls: [] });
-    expect(result.passed).toBe(true);
-    expect(result.records).toEqual([]);
-  });
-
-  it('应忽略配置禁用的 hook', async () => {
-    const ctx: TestContext = { value: '', calls: [] };
-    registry.register(makeHook('enabled'), makeConfig('enabled'));
-    registry.register(makeHook('disabled'), makeConfig('disabled', { enabled: false }));
-
-    await pipeline.run('before', ctx);
-
-    expect(ctx.calls).toEqual(['enabled']);
-    expect(ctx.calls).not.toContain('disabled');
-  });
-});

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

@@ -1,158 +0,0 @@
-/**
- * check 命令注入漂移警告测试（ADR-0001 决策 7，P6）
- *
- * 警告不阻断：漂移项目跑 check 仍 0 退出；版本漂移单独显眼警告；
- * 无漂移零输出。使用真实临时目录（漂移检测读真实 fs），
- * 仅 mock checker（直接判过）与 git 调用。
- */
-
-import * as fs from 'fs';
-import { captureIO, type CapturingIO } from '../../command-contract';
-import * as path from 'path';
-import { check } from '../check';
-import { renderConstraintsSection } from '../../../core/constraints/injection-renderer';
-import { getEffectiveConstraints } from '../../../core/effective-constraints';
-import { createProjectFixture } from '../../../test-setup/project-fixture';
-
-// 命令 per-run 构造 checker（harness#88）：构造替身即控制 checkConstraints 返回值
-const mockChecker = { checkConstraints: jest.fn() };
-jest.mock('../../../core/constraints/checker', () => ({
-  ConstraintChecker: jest.fn(function () {
-    return mockChecker;
-  }),
-}));
-
-// 命令 per-run 锚根构造收集器（harness#139）：构造替身即拦截 trace 落盘
-jest.mock('../../../monitoring/traces', () => ({
-  TraceCollector: jest.fn(function () {
-    return { record: jest.fn() };
-  }),
-}));
-
-jest.mock('../../../utils/exec', () => ({
-  execAsync: jest.fn().mockResolvedValue({ stdout: '', stderr: '' }),
-}));
-
-jest.mock('child_process', () => ({
-  exec: jest.fn(),
-  execSync: jest.fn(() => Buffer.from('')),
-}));
-
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const REAL_VERSION = require('../../../../package.json').version as string;
-
-function writeClaudeMd(root: string, version: string): void {
-  const section =
-    '## Governance Rules\n' + renderConstraintsSection(getEffectiveConstraints(root), version);
-  fs.writeFileSync(path.join(root, 'CLAUDE.md'), `# Test Project\n\n${section}`, 'utf-8');
-}
-
-describe('check 命令注入漂移警告', () => {
-  let io: CapturingIO;
-
-  beforeEach(() => {
-
-    io = captureIO();
-    jest.clearAllMocks();
-    mockChecker.checkConstraints.mockResolvedValue({
-      passed: true,
-      ironLaws: [],
-      guidelines: [],
-      warningCount: 0,
-    });
-  });
-
-  const outputText = () => io.outText();
-
-  it('版本漂移：黄色警告块 + ⚠️⚠️ 版本行，但不阻断（exit 未调用，仍判通过）', async () => {
-    const root = createProjectFixture({ name: 'harness-check-drift-test' });
-    writeClaudeMd(root, '0.0.1-old');
-
-    const result = await check({ preset: 'standard', staged: false, projectPath: root }, io);
-
-    const output = outputText();
-    expect(output).toContain('约束注入漂移');
-    expect(output).toContain('⚠️⚠️');
-    expect(output).toContain('agent 上下文中的规则与已安装 harness 版本不一致');
-    expect(output).toContain('0.0.1-old');
-    expect(output).toContain('npx @dommaker/harness init');
-    // 不阻断：检查仍通过、未调用 process.exit
-    expect(output).toContain('约束检查通过');
-    expect(result.kind).toBe('ok');
-  });
-
-  it('内容漂移：手改一条 → 警告块含缺失/多余计数，exit 未调用', async () => {
-    const root = createProjectFixture({ name: 'harness-check-drift-test' });
-    writeClaudeMd(root, REAL_VERSION);
-    const claudeMdPath = path.join(root, 'CLAUDE.md');
-    const content = fs.readFileSync(claudeMdPath, 'utf-8');
-    const originalLine = content.split('\n').find(l => l.startsWith('- **'))!;
-    fs.writeFileSync(claudeMdPath, content.replace(originalLine, originalLine.replace(/: .+$/, ': 篡改')), 'utf-8');
-
-    const result = await check({ preset: 'standard', staged: false, projectPath: root }, io);
-
-    const output = outputText();
-    expect(output).toContain('内容漂移: 缺失 1 条 / 多余 1 条');
-    expect(output).toContain('约束检查通过');
-    expect(result.kind).toBe('ok');
-  });
-
-  it('无漂移：零警告输出（不增加噪音）', async () => {
-    const root = createProjectFixture({ name: 'harness-check-drift-test' });
-    writeClaudeMd(root, REAL_VERSION);
-
-    const result = await check({ preset: 'standard', staged: false, projectPath: root }, io);
-
-    const output = outputText();
-    expect(output).not.toContain('注入漂移');
-    expect(output).toContain('约束检查通过');
-    expect(result.kind).toBe('ok');
-  });
-
-  it('未注入（无 CLAUDE.md）：不警告', async () => {
-    const root = createProjectFixture({ name: 'harness-check-drift-test' });
-
-    const result = await check({ preset: 'standard', staged: false, projectPath: root }, io);
-
-    expect(outputText()).not.toContain('注入漂移');
-    expect(result.kind).toBe('ok');
-  });
-
-  // ── 生效集来源与漂移比对的同一性（ADR-0023 步骤 4.5）──────────────────
-  // 改前 CLI 给 -p 塞了缺省值 'standard'，「没传」与「传了」不可区分，
-  // 于是「--preset 仅在无自定义配置时覆盖」这条规则恒被触发：项目 config.yml 的
-  // preset 静默失效，而漂移侧按 config.yml 算 → 两边稳定对不上（该报的漂移不报）。
-
-  it('config.yml 的 preset 不再被 CLI 缺省顶掉：不带 -p 按 relaxed 执法且零漂移', async () => {
-    const root = createProjectFixture({
-      name: 'harness-check-drift-relaxed',
-      config: 'preset: relaxed\n',
-    });
-    writeClaudeMd(root, REAL_VERSION); // getEffectiveConstraints(root) 走 config.yml = relaxed
-
-    const result = await check({ staged: false, projectPath: root }, io);
-
-    // relaxed 裁掉的内置条目会出现在「已禁用约束」行——改前 CLI 塞了 standard，这行根本不出现
-    const output = outputText();
-    expect(output).toContain('已禁用约束:');
-    expect(output).not.toContain('内容漂移');
-    expect(output).toContain('约束检查通过');
-    expect(result.kind).toBe('ok');
-  });
-
-  it('显式 -p 时，漂移比对用的就是本 run 实际执法的那份', async () => {
-    const root = createProjectFixture({
-      name: 'harness-check-drift-override',
-      config: 'preset: relaxed\n',
-    });
-    writeClaudeMd(root, REAL_VERSION); // 段里是 relaxed 的少数条目
-
-    await check({ preset: 'standard', staged: false, projectPath: root }, io);
-
-    // standard 不裁条目（无「已禁用约束」行），且期望段 = 本 run 执法的 standard
-    // → 段里条目只少不多，报「缺失 N 条 / 多余 0 条」
-    const output = outputText();
-    expect(output).not.toContain('已禁用约束:');
-    expect(output).toMatch(/内容漂移: 缺失 [1-9]\d* 条 \/ 多余 0 条/);
-  });
-});