@dommaker/harness 0.7.2 → 0.7.4

package/dist/failure/classifier.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * 错误分类器
+ *
+ * 纯函数分类能力，不包含业务逻辑
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorClassifier = void 0;
+exports.createErrorClassifier = createErrorClassifier;
+exports.classifyError = classifyError;
+exports.getFailureLevel = getFailureLevel;
+const types_1 = require("./types");
+/**
+ * 错误分类器
+ *
+ * 用法：
+ * ```typescript
+ * const classifier = new ErrorClassifier();
+ * const result = classifier.classify(new Error('test failed'));
+ * // result.type === ErrorType.TEST_FAILED
+ * ```
+ */
+class ErrorClassifier {
+    rules;
+    levelMapping;
+    constructor(config) {
+        // 合并默认规则和自定义规则
+        this.rules = config?.rules
+            ? [...config.rules, ...types_1.DEFAULT_CLASSIFICATION_RULES]
+            : types_1.DEFAULT_CLASSIFICATION_RULES;
+        // 合并默认等级映射和自定义映射
+        this.levelMapping = {
+            ...types_1.DEFAULT_LEVEL_MAPPING,
+            ...config?.levelMapping,
+        };
+    }
+    /**
+     * 分类错误
+     */
+    classify(error) {
+        const message = error.message.toLowerCase();
+        const name = error.name?.toLowerCase() || '';
+        // 遍历规则，按优先级匹配
+        for (const rule of this.rules) {
+            if (this.matchRule(message, name, rule)) {
+                return {
+                    type: rule.type,
+                    level: rule.level ?? this.levelMapping[rule.type],
+                    matchedRule: rule,
+                    originalError: error,
+                };
+            }
+        }
+        // 未知错误
+        return {
+            type: types_1.ErrorType.UNKNOWN,
+            level: this.levelMapping[types_1.ErrorType.UNKNOWN],
+            originalError: error,
+        };
+    }
+    /**
+     * 获取错误类型对应的失败等级
+     */
+    getLevel(type) {
+        return this.levelMapping[type] ?? types_1.FailureLevel.L2;
+    }
+    /**
+     * 添加自定义规则
+     */
+    addRule(rule) {
+        // 自定义规则插入到前面，优先匹配
+        this.rules.unshift(rule);
+    }
+    /**
+     * 获取所有规则
+     */
+    getRules() {
+        return [...this.rules];
+    }
+    /**
+     * 匹配规则
+     */
+    matchRule(message, name, rule) {
+        // 检查关键词
+        if (rule.keywords && rule.keywords.length > 0) {
+            const textToMatch = `${message} ${name}`;
+            const hasKeyword = rule.keywords.some((kw) => textToMatch.includes(kw.toLowerCase()));
+            if (hasKeyword) {
+                return true;
+            }
+        }
+        // 检查正则模式
+        if (rule.patterns && rule.patterns.length > 0) {
+            const textToMatch = `${message} ${name}`;
+            const hasPattern = rule.patterns.some((pattern) => pattern.test(textToMatch));
+            if (hasPattern) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+exports.ErrorClassifier = ErrorClassifier;
+/**
+ * 创建错误分类器
+ */
+function createErrorClassifier(config) {
+    return new ErrorClassifier(config);
+}
+/**
+ * 快速分类错误（无需创建实例）
+ */
+function classifyError(error) {
+    const classifier = new ErrorClassifier();
+    return classifier.classify(error).type;
+}
+/**
+ * 快速获取失败等级
+ */
+function getFailureLevel(type) {
+    return types_1.DEFAULT_LEVEL_MAPPING[type] ?? types_1.FailureLevel.L2;
+}
+//# sourceMappingURL=classifier.js.map

package/dist/failure/classifier.js.map

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

package/dist/failure/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 失败处理模块
+ *
+ * 提供通用的错误分类和记录能力
+ * 不包含业务逻辑
+ */
+export * from './types';
+export { ErrorClassifier, createErrorClassifier, classifyError, getFailureLevel, type ErrorClassifierConfig, } from './classifier';
+export { FailureRecorder, createFailureRecorder, type FailureRecorderConfig, } from './recorder';
+//# sourceMappingURL=index.d.ts.map

package/dist/failure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/failure/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC"}

package/dist/failure/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * 失败处理模块
+ *
+ * 提供通用的错误分类和记录能力
+ * 不包含业务逻辑
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFailureRecorder = exports.FailureRecorder = exports.getFailureLevel = exports.classifyError = exports.createErrorClassifier = exports.ErrorClassifier = void 0;
+// 类型
+__exportStar(require("./types"), exports);
+// 分类器
+var classifier_1 = require("./classifier");
+Object.defineProperty(exports, "ErrorClassifier", { enumerable: true, get: function () { return classifier_1.ErrorClassifier; } });
+Object.defineProperty(exports, "createErrorClassifier", { enumerable: true, get: function () { return classifier_1.createErrorClassifier; } });
+Object.defineProperty(exports, "classifyError", { enumerable: true, get: function () { return classifier_1.classifyError; } });
+Object.defineProperty(exports, "getFailureLevel", { enumerable: true, get: function () { return classifier_1.getFailureLevel; } });
+// 记录器
+var recorder_1 = require("./recorder");
+Object.defineProperty(exports, "FailureRecorder", { enumerable: true, get: function () { return recorder_1.FailureRecorder; } });
+Object.defineProperty(exports, "createFailureRecorder", { enumerable: true, get: function () { return recorder_1.createFailureRecorder; } });
+//# sourceMappingURL=index.js.map

package/dist/failure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/failure/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,KAAK;AACL,0CAAwB;AAExB,MAAM;AACN,2CAMsB;AALpB,6GAAA,eAAe,OAAA;AACf,mHAAA,qBAAqB,OAAA;AACrB,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AAIjB,MAAM;AACN,uCAIoB;AAHlB,2GAAA,eAAe,OAAA;AACf,iHAAA,qBAAqB,OAAA"}

package/dist/failure/recorder.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 失败记录器
+ *
+ * 文件存储，追加写入，零 Token 成本
+ */
+import type { FailureRecord } from './types';
+/**
+ * 失败记录器配置
+ */
+export interface FailureRecorderConfig {
+    /** 日志文件路径 */
+    logFile: string;
+    /** 单文件最大大小（字节），默认 10MB */
+    maxFileSize?: number;
+    /** 保留历史文件数，默认 5 */
+    maxHistoryFiles?: number;
+}
+/**
+ * 失败记录器
+ *
+ * 用法：
+ * ```typescript
+ * const recorder = new FailureRecorder({ logFile: '.harness/logs/failures.log' });
+ * await recorder.record({
+ *   type: ErrorType.TEST_FAILED,
+ *   level: FailureLevel.L1,
+ *   message: 'Test failed',
+ *   timestamp: Date.now(),
+ * });
+ * ```
+ */
+export declare class FailureRecorder {
+    private logFile;
+    private maxFileSize;
+    private maxHistoryFiles;
+    constructor(config: FailureRecorderConfig);
+    /**
+     * 记录失败
+     */
+    record(record: FailureRecord): Promise<void>;
+    /**
+     * 批量记录
+     */
+    recordBatch(records: FailureRecord[]): Promise<void>;
+    /**
+     * 获取历史记录
+     */
+    getHistory(limit?: number): Promise<FailureRecord[]>;
+    /**
+     * 按类型获取记录
+     */
+    getByType(type: string, limit?: number): Promise<FailureRecord[]>;
+    /**
+     * 按等级获取记录
+     */
+    getByLevel(level: string, limit?: number): Promise<FailureRecord[]>;
+    /**
+     * 获取统计信息
+     */
+    getStats(): Promise<{
+        total: number;
+        byType: Record<string, number>;
+        byLevel: Record<string, number>;
+    }>;
+    /**
+     * 清空记录
+     */
+    clear(): Promise<void>;
+    /**
+     * 文件滚动
+     */
+    private rotateIfNeeded;
+}
+/**
+ * 创建失败记录器
+ */
+export declare function createFailureRecorder(config: FailureRecorderConfig): FailureRecorder;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/failure/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/failure/recorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,EAAE,qBAAqB;IAYzC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAiB1D;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWvE;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWzE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IAkBF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;YACW,cAAc;CAkC7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAC5B,eAAe,CAEjB"}

package/dist/failure/recorder.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * 失败记录器
+ *
+ * 文件存储，追加写入，零 Token 成本
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailureRecorder = void 0;
+exports.createFailureRecorder = createFailureRecorder;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 失败记录器
+ *
+ * 用法：
+ * ```typescript
+ * const recorder = new FailureRecorder({ logFile: '.harness/logs/failures.log' });
+ * await recorder.record({
+ *   type: ErrorType.TEST_FAILED,
+ *   level: FailureLevel.L1,
+ *   message: 'Test failed',
+ *   timestamp: Date.now(),
+ * });
+ * ```
+ */
+class FailureRecorder {
+    logFile;
+    maxFileSize;
+    maxHistoryFiles;
+    constructor(config) {
+        this.logFile = config.logFile;
+        this.maxFileSize = config.maxFileSize ?? 10 * 1024 * 1024; // 10MB
+        this.maxHistoryFiles = config.maxHistoryFiles ?? 5;
+        // 确保目录存在
+        const dir = path.dirname(this.logFile);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    /**
+     * 记录失败
+     */
+    async record(record) {
+        // 检查文件大小，必要时滚动
+        await this.rotateIfNeeded();
+        // 追加写入（单行 JSON）
+        const line = JSON.stringify(record) + '\n';
+        fs.appendFileSync(this.logFile, line, 'utf-8');
+    }
+    /**
+     * 批量记录
+     */
+    async recordBatch(records) {
+        for (const record of records) {
+            await this.record(record);
+        }
+    }
+    /**
+     * 获取历史记录
+     */
+    async getHistory(limit) {
+        if (!fs.existsSync(this.logFile)) {
+            return [];
+        }
+        const content = fs.readFileSync(this.logFile, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        const records = lines.map((line) => JSON.parse(line));
+        if (limit && limit > 0) {
+            return records.slice(-limit);
+        }
+        return records;
+    }
+    /**
+     * 按类型获取记录
+     */
+    async getByType(type, limit) {
+        const records = await this.getHistory();
+        const filtered = records.filter((r) => r.type === type);
+        if (limit && limit > 0) {
+            return filtered.slice(-limit);
+        }
+        return filtered;
+    }
+    /**
+     * 按等级获取记录
+     */
+    async getByLevel(level, limit) {
+        const records = await this.getHistory();
+        const filtered = records.filter((r) => r.level === level);
+        if (limit && limit > 0) {
+            return filtered.slice(-limit);
+        }
+        return filtered;
+    }
+    /**
+     * 获取统计信息
+     */
+    async getStats() {
+        const records = await this.getHistory();
+        const byType = {};
+        const byLevel = {};
+        for (const record of records) {
+            byType[record.type] = (byType[record.type] ?? 0) + 1;
+            byLevel[record.level] = (byLevel[record.level] ?? 0) + 1;
+        }
+        return {
+            total: records.length,
+            byType,
+            byLevel,
+        };
+    }
+    /**
+     * 清空记录
+     */
+    async clear() {
+        if (fs.existsSync(this.logFile)) {
+            fs.writeFileSync(this.logFile, '', 'utf-8');
+        }
+    }
+    /**
+     * 文件滚动
+     */
+    async rotateIfNeeded() {
+        if (!fs.existsSync(this.logFile)) {
+            return;
+        }
+        const stats = fs.statSync(this.logFile);
+        if (stats.size < this.maxFileSize) {
+            return;
+        }
+        // 滚动文件
+        const dir = path.dirname(this.logFile);
+        const ext = path.extname(this.logFile);
+        const base = path.basename(this.logFile, ext);
+        // 删除最旧的历史文件
+        const oldestHistory = path.join(dir, `${base}.${this.maxHistoryFiles}${ext}`);
+        if (fs.existsSync(oldestHistory)) {
+            fs.unlinkSync(oldestHistory);
+        }
+        // 重命名现有历史文件
+        for (let i = this.maxHistoryFiles - 1; i >= 1; i--) {
+            const oldFile = path.join(dir, `${base}.${i}${ext}`);
+            const newFile = path.join(dir, `${base}.${i + 1}${ext}`);
+            if (fs.existsSync(oldFile)) {
+                fs.renameSync(oldFile, newFile);
+            }
+        }
+        // 重命名当前文件
+        const firstHistory = path.join(dir, `${base}.1${ext}`);
+        fs.renameSync(this.logFile, firstHistory);
+    }
+}
+exports.FailureRecorder = FailureRecorder;
+/**
+ * 创建失败记录器
+ */
+function createFailureRecorder(config) {
+    return new FailureRecorder(config);
+}
+//# sourceMappingURL=recorder.js.map

package/dist/failure/recorder.js.map

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

package/dist/failure/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 失败处理类型定义
+ *
+ * 提供通用的错误分类和失败记录类型
+ * 不包含业务逻辑，只定义数据结构
+ */
+/**
+ * 错误类型枚举
+ */
+export declare enum ErrorType {
+    TEST_FAILED = "TEST_FAILED",
+    GATE_FAILED = "GATE_FAILED",
+    DEPENDENCY_BLOCKED = "DEPENDENCY_BLOCKED",
+    CONTEXT_OVERFLOW = "CONTEXT_OVERFLOW",
+    TIMEOUT = "TIMEOUT",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    AGENT_ERROR = "AGENT_ERROR",
+    TOOL_ERROR = "TOOL_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * 失败等级
+ *
+ * L1: 自动处理（重试、降级）
+ * L2: 需要干预（人工审核）
+ * L3: 严重问题（开会讨论）
+ * L4: 致命错误（回滚）
+ */
+export declare enum FailureLevel {
+    L1 = "L1",
+    L2 = "L2",
+    L3 = "L3",
+    L4 = "L4"
+}
+/**
+ * 错误分类规则
+ */
+export interface ErrorClassificationRule {
+    /** 匹配的错误类型 */
+    type: ErrorType;
+    /** 正则匹配模式 */
+    patterns?: RegExp[];
+    /** 关键词匹配（不区分大小写） */
+    keywords?: string[];
+    /** 失败等级 */
+    level?: FailureLevel;
+    /** 规则描述 */
+    description?: string;
+}
+/**
+ * 失败记录
+ */
+export interface FailureRecord {
+    /** 错误类型 */
+    type: ErrorType;
+    /** 失败等级 */
+    level: FailureLevel;
+    /** 错误消息 */
+    message: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 元数据 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 分类结果
+ */
+export interface ClassificationResult {
+    /** 错误类型 */
+    type: ErrorType;
+    /** 失败等级 */
+    level: FailureLevel;
+    /** 匹配的规则（如果有） */
+    matchedRule?: ErrorClassificationRule;
+    /** 原始错误 */
+    originalError: Error;
+}
+/**
+ * 默认错误分类规则
+ *
+ * 注意：规则按顺序匹配，更具体的规则应该放在前面
+ */
+export declare const DEFAULT_CLASSIFICATION_RULES: ErrorClassificationRule[];
+/**
+ * 错误类型到失败等级的默认映射
+ */
+export declare const DEFAULT_LEVEL_MAPPING: Record<ErrorType, FailureLevel>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/failure/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,gBAAgB,qBAAqB;IACrC,OAAO,YAAY;CACpB;AAED;;;;;;;GAOG;AACH,oBAAY,YAAY;IACtB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;CACV;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW;IACX,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW;IACX,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW;IACX,KAAK,EAAE,YAAY,CAAC;IACpB,iBAAiB;IACjB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,WAAW;IACX,aAAa,EAAE,KAAK,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,uBAAuB,EA2DjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,SAAS,EAAE,YAAY,CAWjE,CAAC"}

package/dist/failure/types.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * 失败处理类型定义
+ *
+ * 提供通用的错误分类和失败记录类型
+ * 不包含业务逻辑，只定义数据结构
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LEVEL_MAPPING = exports.DEFAULT_CLASSIFICATION_RULES = exports.FailureLevel = exports.ErrorType = void 0;
+/**
+ * 错误类型枚举
+ */
+var ErrorType;
+(function (ErrorType) {
+    ErrorType["TEST_FAILED"] = "TEST_FAILED";
+    ErrorType["GATE_FAILED"] = "GATE_FAILED";
+    ErrorType["DEPENDENCY_BLOCKED"] = "DEPENDENCY_BLOCKED";
+    ErrorType["CONTEXT_OVERFLOW"] = "CONTEXT_OVERFLOW";
+    ErrorType["TIMEOUT"] = "TIMEOUT";
+    ErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorType["AGENT_ERROR"] = "AGENT_ERROR";
+    ErrorType["TOOL_ERROR"] = "TOOL_ERROR";
+    ErrorType["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ErrorType["UNKNOWN"] = "UNKNOWN";
+})(ErrorType || (exports.ErrorType = ErrorType = {}));
+/**
+ * 失败等级
+ *
+ * L1: 自动处理（重试、降级）
+ * L2: 需要干预（人工审核）
+ * L3: 严重问题（开会讨论）
+ * L4: 致命错误（回滚）
+ */
+var FailureLevel;
+(function (FailureLevel) {
+    FailureLevel["L1"] = "L1";
+    FailureLevel["L2"] = "L2";
+    FailureLevel["L3"] = "L3";
+    FailureLevel["L4"] = "L4";
+})(FailureLevel || (exports.FailureLevel = FailureLevel = {}));
+/**
+ * 默认错误分类规则
+ *
+ * 注意：规则按顺序匹配，更具体的规则应该放在前面
+ */
+exports.DEFAULT_CLASSIFICATION_RULES = [
+    // 更具体的规则优先
+    {
+        type: ErrorType.GATE_FAILED,
+        keywords: ['gate', 'checkpoint', 'constraint'],
+        level: FailureLevel.L2,
+        description: '门禁检查失败',
+    },
+    {
+        type: ErrorType.DEPENDENCY_BLOCKED,
+        keywords: ['dependency', 'blocked', 'dependency_fail'],
+        level: FailureLevel.L3,
+        description: '依赖阻塞',
+    },
+    {
+        type: ErrorType.CONTEXT_OVERFLOW,
+        keywords: ['context overflow', 'token limit', 'context exceed'],
+        level: FailureLevel.L2,
+        description: '上下文溢出',
+    },
+    {
+        type: ErrorType.TIMEOUT,
+        keywords: ['timeout', 'timed out', 'deadline'],
+        patterns: [/timeout/i, /timed?\s*out/i],
+        level: FailureLevel.L1,
+        description: '超时',
+    },
+    {
+        type: ErrorType.NETWORK_ERROR,
+        keywords: ['network', 'connection', 'econnrefused', 'enotfound', 'socket'],
+        level: FailureLevel.L1,
+        description: '网络错误',
+    },
+    {
+        type: ErrorType.AGENT_ERROR,
+        keywords: ['agent error', 'model error', 'rate limit', 'quota exceeded'],
+        level: FailureLevel.L2,
+        description: 'Agent 错误',
+    },
+    {
+        type: ErrorType.TOOL_ERROR,
+        keywords: ['tool error', 'skill error', 'executor error'],
+        level: FailureLevel.L1,
+        description: '工具错误',
+    },
+    {
+        type: ErrorType.VALIDATION_ERROR,
+        keywords: ['validation error', 'invalid', 'schema error'],
+        level: FailureLevel.L2,
+        description: '验证错误',
+    },
+    // 通用规则放在后面
+    {
+        type: ErrorType.TEST_FAILED,
+        keywords: ['test', 'assertion', 'expect'],
+        patterns: [/test.*fail/i, /assertion/i, /expect.*fail/i],
+        level: FailureLevel.L1,
+        description: '测试失败',
+    },
+];
+/**
+ * 错误类型到失败等级的默认映射
+ */
+exports.DEFAULT_LEVEL_MAPPING = {
+    [ErrorType.TEST_FAILED]: FailureLevel.L1,
+    [ErrorType.GATE_FAILED]: FailureLevel.L2,
+    [ErrorType.DEPENDENCY_BLOCKED]: FailureLevel.L3,
+    [ErrorType.CONTEXT_OVERFLOW]: FailureLevel.L2,
+    [ErrorType.TIMEOUT]: FailureLevel.L1,
+    [ErrorType.NETWORK_ERROR]: FailureLevel.L1,
+    [ErrorType.AGENT_ERROR]: FailureLevel.L2,
+    [ErrorType.TOOL_ERROR]: FailureLevel.L1,
+    [ErrorType.VALIDATION_ERROR]: FailureLevel.L2,
+    [ErrorType.UNKNOWN]: FailureLevel.L2,
+};
+//# sourceMappingURL=types.js.map