@dommaker/harness 1.8.0 → 1.9.0

package/dist/hooks/pipeline.js

@@ -1,133 +0,0 @@
-"use strict";
-/**
- * HookPipeline — hook 有序执行、错误隔离、采样
- *
- * 执行顺序：before hooks → consumer operation → after hooks
- * 每个 hook 独立 try/catch，单个 hook 失败不影���其他 hook。
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HookPipeline = void 0;
-class HookPipeline {
-    registry;
-    constructor(registry) {
-        this.registry = registry;
-    }
-    /**
-     * 执行指定 phase 的所有 enabled hook
-     *
-     * @param phase hook 时机
-     * @param context 传递给每个 hook 的上下文
-     * @returns 管线执行结果
-     */
-    async run(phase, context) {
-        const hooks = this.registry.getEnabled(phase);
-        const records = [];
-        const blockedBy = [];
-        const warnings = [];
-        let passed = true;
-        for (const hook of hooks) {
-            const record = await this.executeOne(hook, context);
-            records.push(record);
-            if (!record.passed) {
-                if (hook.errorStrategy === 'block') {
-                    passed = false;
-                    blockedBy.push(hook.name);
-                    break; // blocking hook 失败，停止执行后续 hook
-                }
-                // 'warn'：记录警告继续（有效集合仅 block/warn，策略由 HookConfig 必填声明）
-                warnings.push(hook.name);
-            }
-        }
-        return { passed, records, blockedBy, warnings };
-    }
-    /**
-     * 执行 before + after 全套管线
-     *
-     * @param context 上下文
-     * @param operation 业务操作（在 before 和 after 之间执行）
-     * @returns 管线结果 + 操作结果
-     */
-    async runFull(context, operation) {
-        // 1. Before hooks
-        const beforeResult = await this.run('before', context);
-        if (!beforeResult.passed) {
-            return { pipelineResult: beforeResult };
-        }
-        // 2. Execute operation
-        let operationResult;
-        try {
-            operationResult = await operation();
-        }
-        catch (err) {
-            // 操作失败：仍执行 after hooks，但传递错误信息
-            const afterResult = await this.run('after', {
-                ...context,
-                _operationError: err.message,
-            });
-            return {
-                pipelineResult: {
-                    passed: false,
-                    records: [...beforeResult.records, ...afterResult.records],
-                    blockedBy: [...beforeResult.blockedBy, '_operation'],
-                    warnings: [...beforeResult.warnings, ...afterResult.warnings],
-                },
-            };
-        }
-        // 3. After hooks
-        const afterResult = await this.run('after', context);
-        return {
-            pipelineResult: {
-                passed: beforeResult.passed && afterResult.passed,
-                records: [...beforeResult.records, ...afterResult.records],
-                blockedBy: [...beforeResult.blockedBy, ...afterResult.blockedBy],
-                warnings: [...beforeResult.warnings, ...afterResult.warnings],
-            },
-            operationResult,
-        };
-    }
-    /**
-     * 执行单个 hook（带采样和错误隔离）
-     */
-    async executeOne(hook, context) {
-        const startedAt = Date.now();
-        // 采样检查
-        if (hook.sampleRate !== undefined && hook.sampleRate < 1) {
-            if (Math.random() > hook.sampleRate) {
-                return {
-                    hookName: hook.name,
-                    phase: hook.phase,
-                    startedAt,
-                    completedAt: Date.now(),
-                    durationMs: 0,
-                    passed: true,
-                    sampled: true,
-                };
-            }
-        }
-        try {
-            const result = await hook.execute(context);
-            return {
-                hookName: hook.name,
-                phase: hook.phase,
-                startedAt,
-                completedAt: Date.now(),
-                durationMs: Date.now() - startedAt,
-                passed: result.passed !== false,
-                error: result.error,
-            };
-        }
-        catch (err) {
-            return {
-                hookName: hook.name,
-                phase: hook.phase,
-                startedAt,
-                completedAt: Date.now(),
-                durationMs: Date.now() - startedAt,
-                passed: false,
-                error: err.message,
-            };
-        }
-    }
-}
-exports.HookPipeline = HookPipeline;
-//# sourceMappingURL=pipeline.js.map

package/dist/hooks/pipeline.js.map

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

package/dist/hooks/registry.d.ts

@@ -1,70 +0,0 @@
-/**
- * HookRegistry — hook 注册/注销/查询
- *
- * 纯簿记，无执行逻辑。线程不安全（Node.js 单线程）。
- */
-import type { EffectiveHook, HookConfig, HookDefinition, HookPhase } from './types';
-/**
- * 注册表闭环双向校验（H5，复制 checker 闭环模式）
- *
- * 声明（HookConfig，consumer 的 per-hook 配置表）↔ 实现（注册的
- * HookDefinition）加载期双向校验，任一不满足即抛错，拒绝静默缺失：
- * - 引用未注册 → 抛错（声明了配置但没有注册实现 = 死配置）
- * - 注册无定义 → 抛错（注册了实现但没有配置声明 = 死代码）
- * - 重复声明 / 重复注册 → 抛错
- *
- * 断言限构建/测试期调用（harness 无内置 hook 定义，加载期闭环由
- * consumer 在其注册点/测试中调用本函数），不进入运行时热路径，
- * 不破坏 --help/--version 懒加载。消灭「hook 定义不注册 = 死代码」
- * 类 prompt 规矩（studio 侧随动）。
- *
- * @throws 任一方向不满足时抛错
- */
-export declare function assertHookRegistryClosed<C = unknown, R = unknown>(configs: readonly HookConfig[], hooks: readonly HookDefinition<C, R>[]): void;
-export declare class HookRegistry<C = unknown, R = unknown> {
-    private hooks;
-    /**
-     * 注册 hook（同名覆盖）
-     *
-     * 有效 `enabled` / `errorStrategy` 由 HookConfig 填充——配置表是这两个
-     * 语义的唯一声明点（#159），定义与配置名称不一致即抛错。
-     */
-    register(hook: HookDefinition<C, R>, config: HookConfig): void;
-    /**
-     * 批量注册（按 name 配对配置；有实现缺配置声明即抛错）
-     */
-    registerAll(hooks: HookDefinition<C, R>[], configs: readonly HookConfig[]): void;
-    /**
-     * 注销 hook
-     */
-    unregister(name: string): boolean;
-    /**
-     * 获取单个 hook（含有效 enabled / errorStrategy）
-     */
-    get(name: string): EffectiveHook<C, R> | undefined;
-    /**
-     * 获取指定时机、已启用的 hook，按优先级排序
-     */
-    getEnabled(phase: HookPhase): EffectiveHook<C, R>[];
-    /**
-     * 列出所有 hook 名称
-     */
-    listNames(): string[];
-    /**
-     * 列出所有 hook（含禁用）
-     */
-    listAll(): EffectiveHook<C, R>[];
-    /**
-     * 启用/禁用 hook
-     */
-    setEnabled(name: string, enabled: boolean): boolean;
-    /**
-     * 清空所有 hook
-     */
-    clear(): void;
-    /**
-     * Hook 数量
-     */
-    get size(): number;
-}
-//# sourceMappingURL=registry.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -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,111 +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;
-}
-/**
- * 管线执行结果
- */
-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;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"}