@dommaker/harness 1.7.0 → 1.8.0

package/dist/hooks/registry.d.ts

@@ -3,7 +3,7 @@
  *
  * 纯簿记，无执行逻辑。线程不安全（Node.js 单线程）。
  */
-import type { HookConfig, HookDefinition, HookPhase } from './types';
+import type { EffectiveHook, HookConfig, HookDefinition, HookPhase } from './types';
 /**
  * 注册表闭环双向校验（H5，复制 checker 闭环模式）
  *
@@ -25,24 +25,27 @@ export declare class HookRegistry<C = unknown, R = unknown> {
     private hooks;
     /**
      * 注册 hook（同名覆盖）
+     *
+     * 有效 `enabled` / `errorStrategy` 由 HookConfig 填充——配置表是这两个
+     * 语义的唯一声明点（#159），定义与配置名称不一致即抛错。
      */
-    register(hook: HookDefinition<C, R>): void;
+    register(hook: HookDefinition<C, R>, config: HookConfig): void;
     /**
-     * 批量注册
+     * 批量注册（按 name 配对配置；有实现缺配置声明即抛错）
      */
-    registerAll(hooks: HookDefinition<C, R>[]): void;
+    registerAll(hooks: HookDefinition<C, R>[], configs: readonly HookConfig[]): void;
     /**
      * 注销 hook
      */
     unregister(name: string): boolean;
     /**
-     * 获取单个 hook
+     * 获取单个 hook（含有效 enabled / errorStrategy）
      */
-    get(name: string): HookDefinition<C, R> | undefined;
+    get(name: string): EffectiveHook<C, R> | undefined;
     /**
      * 获取指定时机、已启用的 hook，按优先级排序
      */
-    getEnabled(phase: HookPhase): HookDefinition<C, R>[];
+    getEnabled(phase: HookPhase): EffectiveHook<C, R>[];
     /**
      * 列出所有 hook 名称
      */
@@ -50,7 +53,7 @@ export declare class HookRegistry<C = unknown, R = unknown> {
     /**
      * 列出所有 hook（含禁用）
      */
-    listAll(): HookDefinition<C, R>[];
+    listAll(): EffectiveHook<C, R>[];
     /**
      * 启用/禁用 hook
      */

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC/D,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,EAAE,SAAS,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GACrC,IAAI,CAsCN;AAED,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAChD,OAAO,CAAC,KAAK,CAAgD;IAE7D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAI1C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;IAMhD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS;IAInD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAMpD;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,OAAO,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAIjC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAOnD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC/D,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,EAAE,SAAS,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GACrC,IAAI,CAsCN;AAED,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAChD,OAAO,CAAC,KAAK,CAA+C;IAE5D;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAa9D;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAahF;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS;IAIlD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAMnD;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,OAAO,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAIhC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAOnD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/hooks/registry.js

@@ -55,16 +55,31 @@ class HookRegistry {
     hooks = new Map();
     /**
      * 注册 hook（同名覆盖）
+     *
+     * 有效 `enabled` / `errorStrategy` 由 HookConfig 填充——配置表是这两个
+     * 语义的唯一声明点（#159），定义与配置名称不一致即抛错。
      */
-    register(hook) {
-        this.hooks.set(hook.name, { ...hook });
+    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) {
+    registerAll(hooks, configs) {
+        const configByName = new Map(configs.map(c => [c.name, c]));
         for (const hook of hooks) {
-            this.register(hook);
+            const config = configByName.get(hook.name);
+            if (!config) {
+                throw new Error(`[harness] hook 注册失败：hook "${hook.name}" 没有对应的 HookConfig 声明。`);
+            }
+            this.register(hook, config);
         }
     }
     /**
@@ -74,7 +89,7 @@ class HookRegistry {
         return this.hooks.delete(name);
     }
     /**
-     * 获取单个 hook
+     * 获取单个 hook（含有效 enabled / errorStrategy）
      */
     get(name) {
         return this.hooks.get(name);
@@ -84,7 +99,7 @@ class HookRegistry {
      */
     getEnabled(phase) {
         return Array.from(this.hooks.values())
-            .filter(h => h.phase === phase && h.enabled !== false)
+            .filter(h => h.phase === phase && h.enabled)
             .sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
     }
     /**

package/dist/hooks/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAoBH,4DAyCC;AAzDD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,wBAAwB,CACtC,OAA8B,EAC9B,KAAsC;IAEtC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,IAAI,SAAS,CAC1D,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,IAAI,SAAS,CACrD,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,IAAI,aAAa;gBAC7D,gCAAgC,CACjC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,IAAI,mBAAmB;gBAC9D,2BAA2B,CAC5B,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAa,YAAY;IACf,KAAK,GAAqC,IAAI,GAAG,EAAE,CAAC;IAE5D;;;;;OAKG;IACH,QAAQ,CAAC,IAA0B,EAAE,MAAkB;QACrD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,IAAI,UAAU,MAAM,CAAC,IAAI,UAAU,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;YACxB,GAAG,IAAI;YACP,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAA6B,EAAE,OAA8B;QACvE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,CAAC,IAAI,wBAAwB,CAC/D,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAgB;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aACnC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC;aAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY,EAAE,OAAgB;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAlGD,oCAkGC"}

package/dist/hooks/types.d.ts

@@ -9,9 +9,12 @@
  */
 export type HookPhase = 'before' | 'after' | 'around';
 /**
- * Hook 错误处理策略
+ * Hook 错误处理策略（有效集合：'block' | 'warn'）
+ *
+ * #159 起原 'ignore' 退出有效面：策略的唯一声明点是 HookConfig（必填），
+ * 不存在「未声明 strategy」的运行时形态。
  */
-export type HookErrorStrategy = 'block' | 'warn' | 'ignore';
+export type HookErrorStrategy = 'block' | 'warn';
 /**
  * Hook 配置（G7 归一后形状：consumer 侧的 per-hook 声明表）
  *
@@ -19,6 +22,10 @@ export type HookErrorStrategy = 'block' | 'warn' | 'ignore';
  * - 声明（HookConfig）是「定义」侧：引用未注册实现 → 抛错
  * - 注册（HookDefinition）是「实现」侧：注册无对应声明 → 抛错
  *
+ * #159 起本表是 `enabled` / `errorStrategy` 的**唯一声明点**：
+ * HookDefinition 不再携带这两个字段，有效值在注册环节由本表填充
+ * （见 EffectiveHook），声明与实现两处值矛盾在构造上不可能出现。
+ *
  * 对应 studio 侧 per-hook 运行时配置（hooks/config.ts 的 DEFAULTS）语义：
  * blocking:true ↔ errorStrategy 'block'（失败阻断管线），
  * blocking:false ↔ errorStrategy 'warn'（记录警告继续）——无损映射见
@@ -30,12 +37,13 @@ export interface HookConfig {
     /** 是否启用（false 时不进入管线） */
     enabled: boolean;
     /** 错误策略：block=失败阻断管线，warn=记录警告继续 */
-    errorStrategy: 'block' | 'warn';
+    errorStrategy: HookErrorStrategy;
 }
 /**
  * Hook 定义
  *
  * Consumer 自行选择 name（如 'beforeAgentExecute'），harness 只提供管线。
+ * `enabled` / `errorStrategy` 不在此处声明——唯一声明点是 HookConfig（#159）。
  */
 export interface HookDefinition<C = unknown, R = unknown> {
     /** Hook 唯一名称（consumer 定义语义） */
@@ -44,15 +52,23 @@ export interface HookDefinition<C = unknown, R = unknown> {
     phase: HookPhase;
     /** 优先级（越小越先执行，默认 100） */
     priority?: number;
-    /** 错误策略：block=阻断管线, warn=记录警告继续, ignore=静默跳过 */
-    errorStrategy?: HookErrorStrategy;
     /** 采样率 0-1（1=100% 执行，0.1=10% 采样） */
     sampleRate?: number;
-    /** 是否启用 */
-    enabled?: boolean;
     /** 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 执行结果
  */

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

@@ -1 +1 @@
-{"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;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC;AAED;;;;GAIG;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,gDAAgD;IAChD,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB;IAChB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CACjD;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;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"}
+{"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;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/index.d.ts

@@ -39,8 +39,8 @@ export type { PassesGateConfig, PassesGateCheckResult, PassesGateViolation, Test
 export type { StepMeta, ToolMeta, WorkflowMeta, } from './types/cso';
 export { SpecValidator, validateSpec, validateAllSpecs } from './core/spec/validator';
 export type { SpecValidatorConfig, SpecValidationResult, BatchSpecValidationResult, SpecSchemaDefinition, SpecType, SpecValidationError, SchemaLoader, } from './types/spec';
-export { ReviewGate, SecurityGate, PerformanceGate, ContractGate, SpecAcceptanceGate, CommandGate, createCommandGate, getCommandGate, isCommandAllowed, getCommandRiskLevel, DEFAULT_COMMAND_BLACKLIST, createReviewGate, createSecurityGate, createPerformanceGate, createContractGate, createSpecAcceptanceGate, decisionFromResult, GATE_DEFINITIONS, getGate, listRegisteredGates, registeredGateCount, assertGateRegistryClosed, runGates, getEffectiveGates, createCheckerGate, } from './gates';
-export type { GateResult, GateContext, Gate, GateDecision, GateDecisionStatus, GateDefinition, GateRunResult, GatesConfig, PerformanceThresholds, ReviewGateConfig, SecurityGateConfig, PerformanceGateConfig, ContractGateConfig, SpecAcceptanceGateConfig, AcceptanceGateContext, AcceptanceCriteria, CommandBlacklistRule, CommandGateConfig, } from './gates';
+export { ReviewGate, SecurityGate, PerformanceGate, ContractGate, SpecAcceptanceGate, CommandGate, createCommandGate, getCommandGate, isCommandAllowed, getCommandRiskLevel, DEFAULT_COMMAND_BLACKLIST, createReviewGate, createSecurityGate, createPerformanceGate, createContractGate, createSpecAcceptanceGate, decisionFromResult, GATE_DEFINITIONS, getGate, listRegisteredGates, registeredGateCount, assertGateRegistryClosed, runGates, createCheckerGate, } from './gates';
+export type { GateResult, GateContext, Gate, GateDecision, GateDecisionStatus, GateDefinition, GateRunResult, PerformanceThresholds, ReviewGateConfig, SecurityGateConfig, PerformanceGateConfig, ContractGateConfig, SpecAcceptanceGateConfig, AcceptanceGateContext, AcceptanceCriteria, CommandBlacklistRule, CommandGateConfig, } from './gates';
 export { DEFAULT_TRACE_FILE, } from './types/trace';
 export type { ExecutionTrace, TraceFilter, TraceSummary, TraceAnomaly, TraceCollectorConfig, TraceAnalyzerConfig, } from './types/trace';
 export { TraceCollector, getTraceCollector, configureTraceCollector, TraceAnalyzer, createAnalyzer, ContextTracker, } from './monitoring';
@@ -57,7 +57,7 @@ export { getRegistryPath, getToolsDir } from './tools';
 export { getCriticalArtifacts, verifyReleaseArtifacts } from './release';
 export type { ArtifactIntegrityResult } from './release';
 export { HookRegistry, assertHookRegistryClosed, HookPipeline, toErrorStrategy, bootstrapHarness, bootstrapHarnessSync, } from './hooks';
-export type { HookDefinition, HookConfig, HookErrorStrategy, HookExecutionRecord, HookPhase, HookResult, PipelineResult, HarnessBootstrap, } from './hooks';
+export type { HookDefinition, HookConfig, EffectiveHook, HookErrorStrategy, HookExecutionRecord, HookPhase, HookResult, PipelineResult, HarnessBootstrap, } from './hooks';
 export { AgentLifecycle, } from './agents';
 export type { AgentConfig, AgentEvent, AgentState, AgentStatus, EventHandler, FallbackStrategy, } from './agents';
 export type { ProjectConfig, MergedConstraintsConfig, CustomConstraintDefinition, GovernanceConfig, CapabilitiesConfig, ChangelogConfig, ChangelogVersionCheck, TestingGovernanceConfig, ContextFilesConfig, ContextDocsCheck, DocsSyncConfig, DocFreshnessConfig, DocFreshnessCheck, DocDirCheck, DocRegexCountCheck, ConstCountActual, DirCountActual, GrepCountActual, } from './types/project-config';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -22,9 +22,9 @@
  * （ConstraintChecker / constraintChecker / ProjectConfigLoader）不进公共清单。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_TRACE_FILE = exports.createCheckerGate = exports.getEffectiveGates = exports.runGates = exports.assertGateRegistryClosed = exports.registeredGateCount = exports.listRegisteredGates = exports.getGate = exports.GATE_DEFINITIONS = exports.decisionFromResult = exports.createSpecAcceptanceGate = exports.createContractGate = exports.createPerformanceGate = exports.createSecurityGate = exports.createReviewGate = exports.DEFAULT_COMMAND_BLACKLIST = exports.getCommandRiskLevel = exports.isCommandAllowed = exports.getCommandGate = exports.createCommandGate = exports.CommandGate = exports.SpecAcceptanceGate = exports.ContractGate = exports.PerformanceGate = exports.SecurityGate = exports.ReviewGate = exports.validateAllSpecs = exports.validateSpec = exports.SpecValidator = exports.CSOValidator = exports.createPassesGate = exports.PassesGate = exports.CheckpointValidator = exports.renderConstraintsSection = exports.CONSTRAINTS_END_MARKER = exports.CONSTRAINTS_START_MARKER = exports.renderConstraintsByTrigger = exports.CheckCache = exports.checkBeforeExecution = exports.checkConstraints = exports.checkConstraint = exports.lintEffectiveConfig = exports.getEffectiveConstraints = exports.findConstraintsByTrigger = exports.getConstraint = exports.getAllConstraints = exports.PROMPTS = exports.GUIDELINES = exports.IRON_LAWS = exports.ConstraintViolationError = void 0;
-exports.verifyReleaseArtifacts = exports.getCriticalArtifacts = exports.getToolsDir = exports.getRegistryPath = exports.verifyContractPresence = exports.PHASE_SUBJECT_RE = exports.verifyPhaseFormat = exports.TESTS_NONE_RE = exports.TESTED_BY_RE = exports.verifyTddChain = exports.resolveGlobs = exports.classifyCommitFiles = exports.matchAnyGlob = exports.matchGlob = exports.DEFAULT_NONCODE_GLOBS = exports.DEFAULT_TEST_GLOBS = exports.DEFAULT_DECAY_CONFIG = exports.extractCodeStructure = exports.migrateKnowledgeEntries = exports.KnowledgeAudit = exports.KnowledgeHealthScorer = exports.ColdStartImporter = exports.KnowledgeLinter = exports.ReferenceTracker = exports.sanitizeExternalContent = exports.KnowledgeIngest = exports.KnowledgeLifecycle = exports.KnowledgeQuery = exports.FileKnowledgeStore = exports.KnowledgeInjector = exports.SessionManager = exports.TokenEstimator = exports.TokenBudget = exports.createFailureRecorder = exports.FailureRecorder = exports.getFailureLevel = exports.classifyError = exports.createErrorClassifier = exports.ErrorClassifier = exports.DEFAULT_LEVEL_MAPPING = exports.DEFAULT_CLASSIFICATION_RULES = exports.DEFAULT_FAILURE_LOG_FILE = exports.FailureLevel = exports.ErrorType = exports.ContextTracker = exports.createAnalyzer = exports.TraceAnalyzer = exports.configureTraceCollector = exports.getTraceCollector = exports.TraceCollector = void 0;
-exports.AgentLifecycle = exports.bootstrapHarnessSync = exports.bootstrapHarness = exports.toErrorStrategy = exports.HookPipeline = exports.assertHookRegistryClosed = exports.HookRegistry = void 0;
+exports.TraceCollector = exports.DEFAULT_TRACE_FILE = exports.createCheckerGate = exports.runGates = exports.assertGateRegistryClosed = exports.registeredGateCount = exports.listRegisteredGates = exports.getGate = exports.GATE_DEFINITIONS = exports.decisionFromResult = exports.createSpecAcceptanceGate = exports.createContractGate = exports.createPerformanceGate = exports.createSecurityGate = exports.createReviewGate = exports.DEFAULT_COMMAND_BLACKLIST = exports.getCommandRiskLevel = exports.isCommandAllowed = exports.getCommandGate = exports.createCommandGate = exports.CommandGate = exports.SpecAcceptanceGate = exports.ContractGate = exports.PerformanceGate = exports.SecurityGate = exports.ReviewGate = exports.validateAllSpecs = exports.validateSpec = exports.SpecValidator = exports.CSOValidator = exports.createPassesGate = exports.PassesGate = exports.CheckpointValidator = exports.renderConstraintsSection = exports.CONSTRAINTS_END_MARKER = exports.CONSTRAINTS_START_MARKER = exports.renderConstraintsByTrigger = exports.CheckCache = exports.checkBeforeExecution = exports.checkConstraints = exports.checkConstraint = exports.lintEffectiveConfig = exports.getEffectiveConstraints = exports.findConstraintsByTrigger = exports.getConstraint = exports.getAllConstraints = exports.PROMPTS = exports.GUIDELINES = exports.IRON_LAWS = exports.ConstraintViolationError = void 0;
+exports.HookRegistry = exports.verifyReleaseArtifacts = exports.getCriticalArtifacts = exports.getToolsDir = exports.getRegistryPath = exports.verifyContractPresence = exports.PHASE_SUBJECT_RE = exports.verifyPhaseFormat = exports.TESTS_NONE_RE = exports.TESTED_BY_RE = exports.verifyTddChain = exports.resolveGlobs = exports.classifyCommitFiles = exports.matchAnyGlob = exports.matchGlob = exports.DEFAULT_NONCODE_GLOBS = exports.DEFAULT_TEST_GLOBS = exports.DEFAULT_DECAY_CONFIG = exports.extractCodeStructure = exports.migrateKnowledgeEntries = exports.KnowledgeAudit = exports.KnowledgeHealthScorer = exports.ColdStartImporter = exports.KnowledgeLinter = exports.ReferenceTracker = exports.sanitizeExternalContent = exports.KnowledgeIngest = exports.KnowledgeLifecycle = exports.KnowledgeQuery = exports.FileKnowledgeStore = exports.KnowledgeInjector = exports.SessionManager = exports.TokenEstimator = exports.TokenBudget = exports.createFailureRecorder = exports.FailureRecorder = exports.getFailureLevel = exports.classifyError = exports.createErrorClassifier = exports.ErrorClassifier = exports.DEFAULT_LEVEL_MAPPING = exports.DEFAULT_CLASSIFICATION_RULES = exports.DEFAULT_FAILURE_LOG_FILE = exports.FailureLevel = exports.ErrorType = exports.ContextTracker = exports.createAnalyzer = exports.TraceAnalyzer = exports.configureTraceCollector = exports.getTraceCollector = void 0;
+exports.AgentLifecycle = exports.bootstrapHarnessSync = exports.bootstrapHarness = exports.toErrorStrategy = exports.HookPipeline = exports.assertHookRegistryClosed = void 0;
 // ========================================
 // 约束类型（三层体系 + kind 二元）
 // ========================================
@@ -100,7 +100,6 @@ Object.defineProperty(exports, "listRegisteredGates", { enumerable: true, get: f
 Object.defineProperty(exports, "registeredGateCount", { enumerable: true, get: function () { return gates_1.registeredGateCount; } });
 Object.defineProperty(exports, "assertGateRegistryClosed", { enumerable: true, get: function () { return gates_1.assertGateRegistryClosed; } });
 Object.defineProperty(exports, "runGates", { enumerable: true, get: function () { return gates_1.runGates; } });
-Object.defineProperty(exports, "getEffectiveGates", { enumerable: true, get: function () { return gates_1.getEffectiveGates; } });
 Object.defineProperty(exports, "createCheckerGate", { enumerable: true, get: function () { return gates_1.createCheckerGate; } });
 // ========================================
 // 监控（Execution Trace 收集/分析 + 上下文追踪）

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;AAEH,2CAA2C;AAC3C,uBAAuB;AACvB,2CAA2C;AAC3C,iDAE4B;AAD1B,sHAAA,wBAAwB,OAAA;AAc1B,2CAA2C;AAC3C,mBAAmB;AACnB,2CAA2C;AAC3C,8DAOwC;AANtC,wGAAA,SAAS,OAAA;AACT,yGAAA,UAAU,OAAA;AACV,sGAAA,OAAO,OAAA;AACP,gHAAA,iBAAiB,OAAA;AACjB,4GAAA,aAAa,OAAA;AACb,uHAAA,wBAAwB,OAAA;AAE1B,sEAGsC;AAFpC,gIAAA,uBAAuB,OAAA;AACvB,4HAAA,mBAAmB,OAAA;AAIrB,2CAA2C;AAC3C,uCAAuC;AACvC,2CAA2C;AAC3C,sDAIoC;AAHlC,0GAAA,eAAe,OAAA;AACf,2GAAA,gBAAgB,OAAA;AAChB,+GAAA,oBAAoB,OAAA;AAItB,2CAA2C;AAC3C,YAAY;AACZ,2CAA2C;AAC3C,8DAA4D;AAAnD,yGAAA,UAAU,OAAA;AAEnB,kFAAsF;AAA7E,mIAAA,0BAA0B,OAAA;AAEnC,4EAI+C;AAH7C,8HAAA,wBAAwB,OAAA;AACxB,4HAAA,sBAAsB,OAAA;AACtB,8HAAA,wBAAwB,OAAA;AAe1B,gDAK2B;AAJzB,iHAAA,mBAAmB,OAAA;AACnB,wGAAA,UAAU,OAAA;AACV,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA;AAgBd,2CAA2C;AAC3C,uDAAuD;AACvD,2CAA2C;AAC3C,mDAAsF;AAA7E,0GAAA,aAAa,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAWtD,2CAA2C;AAC3C,4BAA4B;AAC5B,2CAA2C;AAC3C,iCA0BiB;AAzBf,mGAAA,UAAU,OAAA;AACV,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,qGAAA,YAAY,OAAA;AACZ,2GAAA,kBAAkB,OAAA;AAClB,oGAAA,WAAW,OAAA;AACX,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AACd,yGAAA,gBAAgB,OAAA;AAChB,4GAAA,mBAAmB,OAAA;AACnB,kHAAA,yBAAyB,OAAA;AACzB,yGAAA,gBAAgB,OAAA;AAChB,2GAAA,kBAAkB,OAAA;AAClB,8GAAA,qBAAqB,OAAA;AACrB,2GAAA,kBAAkB,OAAA;AAClB,iHAAA,wBAAwB,OAAA;AACxB,2GAAA,kBAAkB,OAAA;AAClB,yGAAA,gBAAgB,OAAA;AAChB,gGAAA,OAAO,OAAA;AACP,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,iHAAA,wBAAwB,OAAA;AACxB,iGAAA,QAAQ,OAAA;AACR,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AAuBnB,2CAA2C;AAC3C,oCAAoC;AACpC,2CAA2C;AAC3C,uCAEuB;AADrB,2GAAA,kBAAkB,OAAA;AAUpB,2CAOsB;AANpB,4GAAA,cAAc,OAAA;AACd,+GAAA,iBAAiB,OAAA;AACjB,qHAAA,uBAAuB,OAAA;AACvB,2GAAA,aAAa,OAAA;AACb,4GAAA,cAAc,OAAA;AACd,4GAAA,cAAc,OAAA;AAIhB,2CAA2C;AAC3C,2BAA2B;AAC3B,2CAA2C;AAC3C,qCAYmB;AAXjB,oGAAA,SAAS,OAAA;AACT,uGAAA,YAAY,OAAA;AACZ,mHAAA,wBAAwB,OAAA;AACxB,uHAAA,4BAA4B,OAAA;AAC5B,gHAAA,qBAAqB,OAAA;AACrB,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AACrB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AACf,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AAUvB,2CAA2C;AAC3C,gCAAgC;AAChC,2CAA2C;AAC3C,qCAKmB;AAJjB,sGAAA,WAAW,OAAA;AACX,yGAAA,cAAc,OAAA;AACd,yGAAA,cAAc,OAAA;AACd,4GAAA,iBAAiB,OAAA;AAiBnB,2CAA2C;AAC3C,qBAAqB;AACrB,2CAA2C;AAC3C,yCAcqB;AAbnB,+GAAA,kBAAkB,OAAA;AAClB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,4GAAA,eAAe,OAAA;AACf,oHAAA,uBAAuB,OAAA;AACvB,6GAAA,gBAAgB,OAAA;AAChB,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,kHAAA,qBAAqB,OAAA;AACrB,2GAAA,cAAc,OAAA;AACd,oHAAA,uBAAuB,OAAA;AACvB,iHAAA,oBAAoB,OAAA;AACpB,iHAAA,oBAAoB,OAAA;AAmCtB,2CAA2C;AAC3C,sBAAsB;AACtB,+DAA+D;AAC/D,yCAAyC;AACzC,2CAA2C;AAC3C,6DAa+B;AAZ7B,yHAAA,kBAAkB,OAAA;AAClB,4HAAA,qBAAqB,OAAA;AACrB,gHAAA,SAAS,OAAA;AACT,mHAAA,YAAY,OAAA;AACZ,0HAAA,mBAAmB,OAAA;AACnB,mHAAA,YAAY,OAAA;AACZ,qHAAA,cAAc,OAAA;AACd,mHAAA,YAAY,OAAA;AACZ,oHAAA,aAAa,OAAA;AACb,wHAAA,iBAAiB,OAAA;AACjB,uHAAA,gBAAgB,OAAA;AAChB,6HAAA,sBAAsB,OAAA;AAcxB,2CAA2C;AAC3C,OAAO;AACP,2CAA2C;AAC3C,iCAAuD;AAA9C,wGAAA,eAAe,OAAA;AAAE,oGAAA,WAAW,OAAA;AAErC,2CAA2C;AAC3C,0CAA0C;AAC1C,iEAAiE;AACjE,gEAAgE;AAChE,2CAA2C;AAC3C,qCAAyE;AAAhE,+GAAA,oBAAoB,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAGrD,2CAA2C;AAC3C,WAAW;AACX,2CAA2C;AAC3C,iCAOiB;AANf,qGAAA,YAAY,OAAA;AACZ,iHAAA,wBAAwB,OAAA;AACxB,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,yGAAA,gBAAgB,OAAA;AAChB,6GAAA,oBAAoB,OAAA;AAatB,2CAA2C;AAC3C,aAAa;AACb,2CAA2C;AAC3C,mCAEkB;AADhB,wGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/knowledge/audit-scoring.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 知识库质量审计打分核心（harness#134：D1–D7 纯模块）
+ *
+ * 纯代码检测，零 token 成本，**零 IO**：入参只有条目集合与已取好的环境数据
+ * （消费统计、快照存活率由调用方经 store 取好喂进来），因此打分判定可脱离文件系统测试。
+ * 落盘与修复动作在 `audit.ts` 的引擎侧。
+ *
+ * 7 维度覆盖：结构完整性 / 内容质量 / 去重有效性 / 成熟度健康 / 新鲜度 / 飞轮验证 / 增量存活
+ */
+import type { KnowledgeEntry, SnapshotSurvival } from './types';
+export type AuditRuleName = 'frontmatter-missing' | 'test-data-pollution' | 'daily-audit-noise' | 'event-noise' | 'zero-content-proven' | 'short-content' | 'maturity-inflation' | 'title-duplicate' | 'source-refs-bloat' | 'fragment-cluster' | 'promotion-blocked' | 'orphan-draft' | 'stale-entry' | 'deprecated-domain';
+export type AuditAction = 'archive' | 'demote' | 'flag' | 'reject' | 'trim';
+export interface AuditIssue {
+    rule: AuditRuleName;
+    entryId: string;
+    title: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    action: AuditAction;
+    detail: string;
+}
+export interface DimensionMetrics {
+    score: number;
+    issues: number;
+    details: Record<string, number | string>;
+}
+export interface AuditReport {
+    timestamp: string;
+    totalEntries: number;
+    issues: AuditIssue[];
+    summary: Record<AuditRuleName, number>;
+    dimensions: {
+        structure: DimensionMetrics;
+        content: DimensionMetrics;
+        dedup: DimensionMetrics;
+        maturity: DimensionMetrics;
+        freshness: DimensionMetrics;
+        flywheel: DimensionMetrics;
+        incremental: DimensionMetrics;
+    };
+    autoFixed: number;
+    healthScore: {
+        before: number;
+        after: number;
+    };
+}
+/** 判定阈值（引擎构造入参，也是纯打分的判定口径） */
+export interface AuditOptions {
+    shortContentThreshold?: number;
+    staleDays?: number;
+    promotionBlockDays?: number;
+}
+/** 打分要吃的已取好环境数据——由调用方从存储层取，本模块不碰 fs */
+export interface AuditEnv {
+    /** `.consumption-stats.json` 的 dailyEvents（D6 飞轮）；未提供视为 0 */
+    dailyConsumptionEvents?: number;
+    /** N 天前快照的存活率（D7 增量存活）；未提供 = 无可用快照 */
+    survival?: SnapshotSurvival;
+}
+export declare const DEFAULT_SHORT_CONTENT_THRESHOLD = 50;
+export declare const ZERO_CONTENT_THRESHOLD = 20;
+export declare const DEFAULT_STALE_DAYS = 90;
+export declare const DEFAULT_PROMOTION_BLOCK_DAYS = 30;
+export declare const MAX_SOURCE_REFS = 20;
+/** D7 增量存活取的快照龄期（天） */
+export declare const SURVIVAL_SNAPSHOT_DAYS = 30;
+interface AuditContext {
+    shortContentThreshold: number;
+    staleDays: number;
+    promotionBlockDays: number;
+    allEntries?: KnowledgeEntry[];
+}
+/** 规则 label 正本表（#109，ADR-0002 定义即注册）：派生自 perEntryRules，与规则键集编译期闭环，CLI 展示层直接消费 */
+export declare const AUDIT_RULE_LABELS: Record<AuditRuleName, string>;
+/** 阈值缺省落点（引擎与纯打分共用同一份兜底） */
+export declare function resolveThresholds(options?: AuditOptions): AuditContext;
+/**
+ * 逐条目跑 perEntryRules（#111 收口，#134 纯化）：validate（单条目）、run（全量）与 autoFix 重扫共用。
+ * `population` = 跨条目规则（标题重复 / 碎片集群）的对照集合；不传 = 单条目入库模式，跨条目规则不判定。
+ */
+export declare function scanEntries(entries: KnowledgeEntry[], options: AuditOptions, population?: KnowledgeEntry[]): AuditIssue[];
+/** 规则命中计数：未命中的规则也出零值键（报告面的规则集合与规则表编译期闭环） */
+export declare function summarizeIssues(issues: AuditIssue[]): Record<AuditRuleName, number>;
+export declare function computeDimensions(entries: KnowledgeEntry[], issues: AuditIssue[], env?: AuditEnv): AuditReport['dimensions'];
+export declare function computeIncremental(survival?: SnapshotSurvival): DimensionMetrics;
+export declare function calculateHealthScore(entries: KnowledgeEntry[], issues: AuditIssue[]): number;
+export {};
+//# sourceMappingURL=audit-scoring.d.ts.map

package/dist/knowledge/audit-scoring.d.ts.map

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