@dommaker/harness 0.7.2 → 0.7.3

package/README.md

@@ -1,6 +1,6 @@
 # @dommaker/harness
 
-> 通用工程约束框架 - 铁律系统、检查点验证、测试门控、拦截器
+> 通用工程约束框架 - 铁律系统、门禁系统、检查点验证、拦截器
 
 ## 简介
 
@@ -11,12 +11,13 @@
 | 功能 | 说明 |
 |------|------|
 | **铁律系统** | 16 条内置约束（4 Iron Laws + 10 Guidelines + 2 Tips） |
+| **门禁系统** | 6 种门禁（测试、审查、安全、性能、契约、检查点） |
 | **检查点验证** | 验证工作流步骤的结果是否符合预期 |
-| **测试门控** | 禁止自评通过，必须通过真实测试 |
-| **拦截器** | 抽象拦截框架，自动执行 enforcement（v0.7+） |
+| **拦截器** | 抽象拦截框架，自动执行 enforcement |
 | **Session 管理** | 启动检查点 + 结束状态管理 |
 | **预设系统** | 提供 strict/standard/relaxed 三种预设 |
 | **Execution Trace** | 轻量记录约束检查，异常检测，诊断系统 |
+| **Spec 验证** | 验证架构文档、模块定义、API 定义 |
 | **项目级自定义约束** | 扩展/覆盖内置约束，无需 fork |
 | **CLI 工具** | 命令行工具执行检查 |
 
@@ -170,7 +171,110 @@ const cleaner = new CleanStateManager();
 const cleanResult = await cleaner.onSessionEnd(workDir, sessionInfo);
 ```
 
-### 5. 使用拦截器（v0.7+）
+### 7. 门禁系统
+
+harness 提供完整的门禁系统，支持多种门禁类型：
+
+| 门禁 | 类 | 说明 |
+|------|-----|------|
+| 测试门控 | `PassesGate` | 禁止自评通过，必须通过真实测试 |
+| 审查门禁 | `ReviewGate` | 检查 GitHub PR 审查状态 |
+| 安全门禁 | `SecurityGate` | npm audit 安全漏洞扫描 |
+| 性能门禁 | `PerformanceGate` | 响应时间、覆盖率、打包大小检查 |
+| 契约门禁 | `ContractGate` | OpenAPI 契约验证 |
+| 检查点验证 | `CheckpointValidator` | 验证工作流步骤结果 |
+
+**使用门禁**：
+
+```typescript
+import {
+  PassesGate,
+  ReviewGate,
+  SecurityGate,
+  PerformanceGate,
+  ContractGate,
+  CheckpointValidator,
+} from '@dommaker/harness';
+
+// 测试门控
+const passesGate = new PassesGate({ requireEvidence: true });
+const testResult = await passesGate.runTests();
+
+// 审查门禁
+const reviewGate = new ReviewGate({ minReviewers: 2 });
+const reviewResult = await reviewGate.check({
+  projectId: 'my-project',
+  projectPath: '/path/to/project',
+  prNumber: 123,
+});
+
+// 安全门禁
+const securityGate = new SecurityGate({ severityThreshold: 'high' });
+const securityResult = await securityGate.scan({
+  projectId: 'my-project',
+  projectPath: '/path/to/project',
+});
+
+// 性能门禁（带超时）
+const performanceGate = new PerformanceGate({
+  thresholds: {
+    maxResponseTime: 500,
+    minCoverage: 80,
+    maxBundleSize: 1024,
+  },
+  coverageTimeout: 120000,  // 2分钟超时
+});
+const perfResult = await performanceGate.check({
+  projectId: 'my-project',
+  projectPath: '/path/to/project',
+});
+
+// 契约门禁
+const contractGate = new ContractGate({ strict: true });
+const contractResult = await contractGate.check({
+  projectId: 'my-project',
+  projectPath: '/path/to/project',
+  newContractPath: '/path/to/openapi.yaml',
+});
+
+// 检查点验证
+const checkpointValidator = CheckpointValidator.getInstance();
+const checkpointResult = await checkpointValidator.validate(checkpoints, {
+  workdir: '/path/to/project',
+});
+```
+
+**门禁结果**：
+
+```typescript
+interface GateResult {
+  gate: string;           // 门禁类型
+  passed: boolean;        // 是否通过
+  message: string;        // 结果消息
+  details?: {             // 详细信息
+    metrics?: object;     // 性能指标
+    failures?: string[];  // 失败项
+    warnings?: string[];  // 警告项
+  };
+  timestamp: string;      // 时间戳
+  duration?: number;      // 执行时长（毫秒）
+}
+```
+
+**PerformanceGate 超时配置**：
+
+```typescript
+const gate = new PerformanceGate({
+  thresholds: { minCoverage: 80 },
+  coverageTimeout: 60000,   // 覆盖率测试超时（毫秒）
+  benchmarkTimeout: 30000,  // 基准测试超时（毫秒）
+});
+
+// 动态设置超时
+gate.setTimeouts({ coverage: 120000 });
+```
+
+### 8. 使用拦截器
 
 拦截器自动执行 enforcement，无需手动调用检查 API：
 
@@ -371,6 +475,50 @@ class PassesGate {
 }
 ```
 
+### ReviewGate
+
+```typescript
+class ReviewGate {
+  constructor(config: ReviewGateConfig);
+  
+  check(context: GateContext): Promise<GateResult>;
+  setMinReviewers(count: number): void;
+}
+```
+
+### SecurityGate
+
+```typescript
+class SecurityGate {
+  constructor(config: SecurityGateConfig);
+  
+  scan(context: GateContext): Promise<GateResult>;
+}
+```
+
+### PerformanceGate
+
+```typescript
+class PerformanceGate {
+  constructor(config: PerformanceGateConfig);
+  
+  check(context: GateContext): Promise<GateResult>;
+  runBenchmark(context: GateContext): Promise<BenchmarkResult>;
+  setThresholds(thresholds: Partial<PerformanceThresholds>): void;
+  setTimeouts(options: { coverage?: number; benchmark?: number }): void;
+}
+```
+
+### ContractGate
+
+```typescript
+class ContractGate {
+  constructor(config: ContractGateConfig);
+  
+  check(context: GateContext): Promise<GateResult>;
+}
+```
+
 ### SessionStartup
 
 ```typescript

package/dist/gates/contract.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 契约门禁
+ *
+ * 检查 API 契约：
+ * - OpenAPI Schema 验证
+ * - 破坏性变更检测
+ * - 版本兼容性
+ */
+import type { GateResult, GateContext, ContractGateConfig } from './types';
+/**
+ * 契约门禁
+ */
+export declare class ContractGate {
+    private config;
+    constructor(config?: Partial<ContractGateConfig>);
+    /**
+     * 检查契约
+     */
+    check(context: GateContext): Promise<GateResult>;
+    /**
+     * 验证契约格式
+     */
+    private validateContract;
+    /**
+     * 检测破坏性变更
+     */
+    private detectBreakingChanges;
+    /**
+     * 提取端点列表
+     */
+    private extractEndpoints;
+    /**
+     * 设置契约路径
+     */
+    setContractPath(path: string): void;
+    /**
+     * 获取配置
+     */
+    getConfig(): Required<ContractGateConfig>;
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/gates/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/gates/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAI3E;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA+B;gBAEjC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IASpD;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAkGtD;;OAEG;YACW,gBAAgB;IA0D9B;;OAEG;YACW,qBAAqB;IAmCnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,kBAAkB,CAAC;CAG1C"}

package/dist/gates/contract.js

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * 契约门禁
+ *
+ * 检查 API 契约：
+ * - OpenAPI Schema 验证
+ * - 破坏性变更检测
+ * - 版本兼容性
+ */
+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.ContractGate = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * 契约门禁
+ */
+class ContractGate {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            strict: config.strict ?? true,
+            allowBreakingChanges: config.allowBreakingChanges ?? false,
+            contractPath: config.contractPath ?? 'openapi.yaml',
+        };
+    }
+    /**
+     * 检查契约
+     */
+    async check(context) {
+        const startTime = Date.now();
+        if (!this.config.enabled) {
+            return {
+                gate: 'contract',
+                passed: true,
+                message: '契约门禁已禁用',
+                timestamp: new Date().toISOString(),
+                duration: Date.now() - startTime,
+            };
+        }
+        try {
+            const contractPath = context.newContractPath ??
+                path.join(context.projectPath, this.config.contractPath);
+            // 检查契约文件是否存在
+            try {
+                await fs.access(contractPath);
+            }
+            catch {
+                return {
+                    gate: 'contract',
+                    passed: true,
+                    message: '未找到契约文件，跳过检查',
+                    details: {
+                        contractPath,
+                        suggestion: '创建 OpenAPI 规范文件',
+                    },
+                    timestamp: new Date().toISOString(),
+                    duration: Date.now() - startTime,
+                };
+            }
+            // 验证契约格式
+            const validation = await this.validateContract(contractPath);
+            if (!validation.valid) {
+                return {
+                    gate: 'contract',
+                    passed: false,
+                    message: `契约格式无效: ${validation.errors.join(', ')}`,
+                    details: {
+                        contractPath,
+                        errors: validation.errors,
+                    },
+                    timestamp: new Date().toISOString(),
+                    duration: Date.now() - startTime,
+                };
+            }
+            // 检查破坏性变更（如果提供了旧契约）
+            if (context.oldContractPath) {
+                const breakingChanges = await this.detectBreakingChanges(context.oldContractPath, contractPath);
+                if (breakingChanges.length > 0 && !this.config.allowBreakingChanges) {
+                    return {
+                        gate: 'contract',
+                        passed: false,
+                        message: `发现破坏性变更: ${breakingChanges.length} 个`,
+                        details: {
+                            contractPath,
+                            oldContractPath: context.oldContractPath,
+                            breakingChanges,
+                            suggestion: '更新 API 版本或保持向后兼容',
+                        },
+                        timestamp: new Date().toISOString(),
+                        duration: Date.now() - startTime,
+                    };
+                }
+            }
+            return {
+                gate: 'contract',
+                passed: true,
+                message: '契约检查通过',
+                details: {
+                    contractPath,
+                    endpoints: validation.endpoints,
+                    version: validation.version,
+                },
+                timestamp: new Date().toISOString(),
+                duration: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return {
+                gate: 'contract',
+                passed: false,
+                message: `契约检查失败: ${error.message}`,
+                timestamp: new Date().toISOString(),
+                duration: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * 验证契约格式
+     */
+    async validateContract(contractPath) {
+        const errors = [];
+        let endpoints = 0;
+        let version;
+        try {
+            const content = await fs.readFile(contractPath, 'utf-8');
+            let spec;
+            // 解析 YAML 或 JSON
+            if (contractPath.endsWith('.yaml') || contractPath.endsWith('.yml')) {
+                // 简化的 YAML 解析（只提取基本信息）
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    if (line.startsWith('openapi:') || line.startsWith('swagger:')) {
+                        version = line.split(':')[1]?.trim();
+                    }
+                    if (line.match(/^\s*\/\w+/)) {
+                        endpoints++;
+                    }
+                }
+            }
+            else {
+                spec = JSON.parse(content);
+                version = spec.openapi || spec.swagger;
+                if (spec.paths) {
+                    endpoints = Object.keys(spec.paths).length;
+                }
+            }
+            // 基本验证
+            if (!version) {
+                errors.push('缺少 openapi/swagger 版本');
+            }
+            if (endpoints === 0) {
+                errors.push('没有定义任何端点');
+            }
+            return {
+                valid: errors.length === 0,
+                errors,
+                endpoints,
+                version,
+            };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                errors: [`解析失败: ${error.message}`],
+                endpoints: 0,
+            };
+        }
+    }
+    /**
+     * 检测破坏性变更
+     */
+    async detectBreakingChanges(oldPath, newPath) {
+        const changes = [];
+        try {
+            const oldContent = await fs.readFile(oldPath, 'utf-8');
+            const newContent = await fs.readFile(newPath, 'utf-8');
+            // 提取端点列表
+            const oldEndpoints = this.extractEndpoints(oldContent);
+            const newEndpoints = this.extractEndpoints(newContent);
+            // 检查删除的端点
+            for (const endpoint of oldEndpoints) {
+                if (!newEndpoints.includes(endpoint)) {
+                    changes.push({
+                        type: 'endpoint_removed',
+                        description: `端点 ${endpoint} 已删除`,
+                        path: endpoint,
+                    });
+                }
+            }
+            // 检查新增的端点（不是破坏性变更）
+            // 检查方法变更
+            // 简化实现，实际应该完整比较
+            return changes;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 提取端点列表
+     */
+    extractEndpoints(content) {
+        const endpoints = [];
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const match = line.match(/^\s*\/[\w/-]+:/);
+            if (match) {
+                endpoints.push(match[0].replace(':', '').trim());
+            }
+        }
+        return endpoints;
+    }
+    /**
+     * 设置契约路径
+     */
+    setContractPath(path) {
+        this.config.contractPath = path;
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.ContractGate = ContractGate;
+//# sourceMappingURL=contract.js.map

package/dist/gates/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/gates/contract.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAAqC;AACrC,+BAAiC;AACjC,gDAAkC;AAClC,2CAA6B;AAG7B,MAAM,SAAS,GAAG,IAAA,gBAAS,EAAC,oBAAI,CAAC,CAAC;AAElC;;GAEG;AACH,MAAa,YAAY;IACf,MAAM,CAA+B;IAE7C,YAAY,SAAsC,EAAE;QAClD,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;YAC7B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,KAAK;YAC1D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,cAAc;SACpD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,SAAS;gBAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACjC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe;gBAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAE3D,aAAa;YACb,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;oBACL,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,IAAI;oBACZ,OAAO,EAAE,cAAc;oBACvB,OAAO,EAAE;wBACP,YAAY;wBACZ,UAAU,EAAE,iBAAiB;qBAC9B;oBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACjC,CAAC;YACJ,CAAC;YAED,SAAS;YACT,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;YAE7D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,OAAO;oBACL,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,KAAK;oBACb,OAAO,EAAE,WAAW,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAClD,OAAO,EAAE;wBACP,YAAY;wBACZ,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B;oBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACjC,CAAC;YACJ,CAAC;YAED,oBAAoB;YACpB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,CACtD,OAAO,CAAC,eAAe,EACvB,YAAY,CACb,CAAC;gBAEF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;oBACpE,OAAO;wBACL,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,KAAK;wBACb,OAAO,EAAE,YAAY,eAAe,CAAC,MAAM,IAAI;wBAC/C,OAAO,EAAE;4BACP,YAAY;4BACZ,eAAe,EAAE,OAAO,CAAC,eAAe;4BACxC,eAAe;4BACf,UAAU,EAAE,kBAAkB;yBAC/B;wBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACjC,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE;oBACP,YAAY;oBACZ,SAAS,EAAE,UAAU,CAAC,SAAS;oBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;iBAC5B;gBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACjC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,WAAW,KAAK,CAAC,OAAO,EAAE;gBACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,YAAoB;QAMjD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,OAA2B,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,IAAI,IAAS,CAAC;YAEd,iBAAiB;YACjB,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpE,uBAAuB;gBACvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC/D,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;oBACvC,CAAC;oBACD,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC5B,SAAS,EAAE,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC3B,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;gBACvC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;gBAC7C,CAAC;YACH,CAAC;YAED,OAAO;YACP,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;YAED,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;gBAC1B,MAAM;gBACN,SAAS;gBACT,OAAO;aACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,SAAS,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,OAAe,EACf,OAAe;QAEf,MAAM,OAAO,GAA+D,EAAE,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAEvD,SAAS;YACT,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACvD,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAEvD,UAAU;YACV,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;gBACpC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACrC,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,kBAAkB;wBACxB,WAAW,EAAE,MAAM,QAAQ,MAAM;wBACjC,IAAI,EAAE,QAAQ;qBACf,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,mBAAmB;YACnB,SAAS;YACT,gBAAgB;YAEhB,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAe;QACtC,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC3C,IAAI,KAAK,EAAE,CAAC;gBACV,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAY;QAC1B,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AAlPD,oCAkPC"}

package/dist/gates/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 门禁系统导出
+ *
+ * 统一导出所有门禁类型
+ */
+export type { GateResult, GateContext, PerformanceThresholds, ReviewGateConfig, SecurityGateConfig, PerformanceGateConfig, ContractGateConfig, } from './types';
+export { ReviewGate } from './review';
+export { SecurityGate } from './security';
+export { PerformanceGate } from './performance';
+export { ContractGate } from './contract';
+import { ReviewGate } from './review';
+import { SecurityGate } from './security';
+import { PerformanceGate } from './performance';
+import { ContractGate } from './contract';
+import type { ReviewGateConfig, SecurityGateConfig, PerformanceGateConfig, ContractGateConfig } from './types';
+export declare function createReviewGate(config?: Partial<ReviewGateConfig>): ReviewGate;
+export declare function createSecurityGate(config?: Partial<SecurityGateConfig>): SecurityGate;
+export declare function createPerformanceGate(config?: Partial<PerformanceGateConfig>): PerformanceGate;
+export declare function createContractGate(config?: Partial<ContractGateConfig>): ContractGate;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAE/E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,YAAY,CAErF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,eAAe,CAE9F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,YAAY,CAErF"}

package/dist/gates/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * 门禁系统导出
+ *
+ * 统一导出所有门禁类型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractGate = exports.PerformanceGate = exports.SecurityGate = exports.ReviewGate = void 0;
+exports.createReviewGate = createReviewGate;
+exports.createSecurityGate = createSecurityGate;
+exports.createPerformanceGate = createPerformanceGate;
+exports.createContractGate = createContractGate;
+// 门禁类导出
+var review_1 = require("./review");
+Object.defineProperty(exports, "ReviewGate", { enumerable: true, get: function () { return review_1.ReviewGate; } });
+var security_1 = require("./security");
+Object.defineProperty(exports, "SecurityGate", { enumerable: true, get: function () { return security_1.SecurityGate; } });
+var performance_1 = require("./performance");
+Object.defineProperty(exports, "PerformanceGate", { enumerable: true, get: function () { return performance_1.PerformanceGate; } });
+var contract_1 = require("./contract");
+Object.defineProperty(exports, "ContractGate", { enumerable: true, get: function () { return contract_1.ContractGate; } });
+// 便捷工厂函数
+const review_2 = require("./review");
+const security_2 = require("./security");
+const performance_2 = require("./performance");
+const contract_2 = require("./contract");
+function createReviewGate(config) {
+    return new review_2.ReviewGate(config);
+}
+function createSecurityGate(config) {
+    return new security_2.SecurityGate(config);
+}
+function createPerformanceGate(config) {
+    return new performance_2.PerformanceGate(config);
+}
+function createContractGate(config) {
+    return new contract_2.ContractGate(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/gates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gates/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA+BH,4CAEC;AAED,gDAEC;AAED,sDAEC;AAED,gDAEC;AAhCD,QAAQ;AACR,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AACrB,6CAAgD;AAAvC,8GAAA,eAAe,OAAA;AACxB,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AAErB,SAAS;AACT,qCAAsC;AACtC,yCAA0C;AAC1C,+CAAgD;AAChD,yCAA0C;AAQ1C,SAAgB,gBAAgB,CAAC,MAAkC;IACjE,OAAO,IAAI,mBAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAoC;IACrE,OAAO,IAAI,uBAAY,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAuC;IAC3E,OAAO,IAAI,6BAAe,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAoC;IACrE,OAAO,IAAI,uBAAY,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/gates/performance.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 性能门禁
+ *
+ * 检查性能指标：
+ * - 响应时间
+ * - 内存使用
+ * - 测试覆盖率
+ * - 打包大小
+ *
+ * 改进：
+ * - 添加超时机制
+ * - 改进错误处理
+ * - 返回详细的错误信息
+ */
+import type { GateResult, GateContext, PerformanceGateConfig, PerformanceThresholds } from './types';
+/**
+ * 性能门禁配置
+ */
+export interface ExtendedPerformanceGateConfig extends PerformanceGateConfig {
+    /** 覆盖率测试超时（毫秒） */
+    coverageTimeout?: number;
+    /** 基准测试超时（毫秒） */
+    benchmarkTimeout?: number;
+}
+/**
+ * 性能门禁
+ */
+export declare class PerformanceGate {
+    private config;
+    constructor(config?: Partial<ExtendedPerformanceGateConfig>);
+    /**
+     * 检查性能
+     */
+    check(context: GateContext): Promise<GateResult>;
+    /**
+     * 收集性能指标
+     */
+    private collectMetrics;
+    /**
+     * 收集测试覆盖率（带超时）
+     */
+    private collectCoverage;
+    /**
+     * 收集打包大小
+     */
+    private collectBundleSize;
+    /**
+     * 格式化指标输出
+     */
+    private formatMetrics;
+    /**
+     * 运行基准测试（带超时）
+     */
+    runBenchmark(context: GateContext): Promise<{
+        avgResponseTime: number;
+        avgMemoryUsage: number;
+        minResponseTime: number;
+        maxResponseTime: number;
+        error?: string;
+    }>;
+    /**
+     * 单次基准测试（带超时）
+     */
+    private singleBenchmark;
+    /**
+     * 设置阈值
+     */
+    setThresholds(thresholds: Partial<PerformanceThresholds>): void;
+    /**
+     * 设置超时时间
+     */
+    setTimeouts(options: {
+        coverage?: number;
+        benchmark?: number;
+    }): void;
+    /**
+     * 获取配置
+     */
+    getConfig(): Required<ExtendedPerformanceGateConfig>;
+}
+//# sourceMappingURL=performance.d.ts.map

package/dist/gates/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/gates/performance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWrG;;GAEG;AACH,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E,kBAAkB;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA0C;gBAE5C,MAAM,GAAE,OAAO,CAAC,6BAA6B,CAAM;IAY/D;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAqFtD;;OAEG;YACW,cAAc;IA6C5B;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC;QAChD,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAmCF;;OAEG;YACW,eAAe;IAkB7B;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAKR;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,6BAA6B,CAAC;CAGrD"}