@dommaker/harness 0.7.3 → 0.7.4

package/README.md

@@ -11,12 +11,14 @@
 | 功能 | 说明 |
 |------|------|
 | **铁律系统** | 16 条内置约束（4 Iron Laws + 10 Guidelines + 2 Tips） |
-| **门禁系统** | 6 种门禁（测试、审查、安全、性能、契约、检查点） |
+| **门禁系统** | 7 种门禁（测试、审查、安全、性能、契约、检查点、验收标准） |
 | **检查点验证** | 验证工作流步骤的结果是否符合预期 |
 | **拦截器** | 抽象拦截框架，自动执行 enforcement |
 | **Session 管理** | 启动检查点 + 结束状态管理 |
 | **预设系统** | 提供 strict/standard/relaxed 三种预设 |
 | **Execution Trace** | 轻量记录约束检查，异常检测，诊断系统 |
+| **Performance Trace** | 性能日志收集，统计分析，异常检测（🆕） |
+| **Failure Classification** | 错误分类，失败记录，等级映射（🆕） |
 | **Spec 验证** | 验证架构文档、模块定义、API 定义 |
 | **项目级自定义约束** | 扩展/覆盖内置约束，无需 fork |
 | **CLI 工具** | 命令行工具执行检查 |
@@ -183,6 +185,7 @@ harness 提供完整的门禁系统，支持多种门禁类型：
 | 性能门禁 | `PerformanceGate` | 响应时间、覆盖率、打包大小检查 |
 | 契约门禁 | `ContractGate` | OpenAPI 契约验证 |
 | 检查点验证 | `CheckpointValidator` | 验证工作流步骤结果 |
+| 验收标准门禁 | `SpecAcceptanceGate` | 验证任务是否满足验收标准 |
 
 **使用门禁**：
 
@@ -194,6 +197,7 @@ import {
   PerformanceGate,
   ContractGate,
   CheckpointValidator,
+  SpecAcceptanceGate,
 } from '@dommaker/harness';
 
 // 测试门控
@@ -519,6 +523,60 @@ class ContractGate {
 }
 ```
 
+### SpecAcceptanceGate
+
+验收标准门禁，用于验证任务是否满足验收标准：
+
+```typescript
+import { SpecAcceptanceGate } from '@dommaker/harness';
+
+// 创建验收门禁
+const acceptanceGate = new SpecAcceptanceGate({
+  tasksPath: './tasks.yml',
+  checkAllTasks: false,
+});
+
+// 检查单个任务
+const result = await acceptanceGate.check({
+  projectPath: '/path/to/project',
+  taskId: 'task-001',
+  tasksPath: './tasks.yml',
+});
+
+// 检查所有任务
+const allResults = await acceptanceGate.check({
+  projectPath: '/path/to/project',
+  checkAllTasks: true,
+});
+
+// 自定义验收条件
+const customGate = new SpecAcceptanceGate({
+  customAcceptanceCriteria: {
+    'has-tests': async (task) => {
+      // 自定义验证逻辑
+      return true;
+    },
+  },
+});
+```
+
+**验收标准格式（tasks.yml）**：
+
+```yaml
+tasks:
+  - id: task-001
+    title: 实现用户登录
+    acceptance_criteria:
+      - id: ac-1
+        description: 用户可以使用邮箱登录
+        type: automated
+        required: true
+      - id: ac-2
+        description: 登录失败显示错误提示
+        type: manual
+        required: true
+```
+
 ### SessionStartup
 
 ```typescript
@@ -682,4 +740,183 @@ harness propose implement --diagnosis <id>
 | 异常检测 | 每日 | 0（未触发）~500（触发） |
 | Agent 诊断 | 按需 | ~2000 |
 
-**对比 Meta-Harness**：百万级 vs 5500/周，成本降低 **180 倍**。
+**对比 Meta-Harness**：百万级 vs 5500/周，成本降低 **180 倍**。
+
+---
+
+## Performance Trace 系统（v0.4+）
+
+### 概念
+
+Performance Trace 是性能数据的轻量记录，用于：
+- 监控关键操作耗时
+- 检测性能异常（慢操作、超阈值）
+- 统计 Token 使用和上下文大小
+- 为性能优化提供数据基础
+
+### 设计原则
+
+| 原则 | 说明 |
+|------|------|
+| **零 Token 成本** | 记录和统计都不调用 LLM |
+| **文件存储** | 追加写入，单行 JSON 格式 |
+| **异步分析** | 统计每小时执行，异常检测每日执行 |
+| **可配置阈值** | 按操作类型设置不同的性能阈值 |
+
+### Trace 数据结构
+
+```typescript
+interface PerformanceTrace {
+  operation: string;        // 操作名称
+  startTime: number;        // 开始时间戳
+  duration: number;         // 耗时（毫秒）
+  status: 'ok' | 'exceeded' | 'error';
+  threshold?: number;       // 配置的阈值
+  metadata?: Record<string, unknown>;
+}
+```
+
+### API 使用
+
+```typescript
+import { PerformanceCollector, PerformanceAnalyzer } from '@dommaker/harness';
+
+// 创建收集器
+const collector = new PerformanceCollector({
+  logFile: '.harness/logs/performance.log',
+  thresholds: {
+    extract: 1000,    // 提取操作阈值 1s
+    transform: 500,   // 转换操作阈值 500ms
+    invoke: 10000,    // 调用操作阈值 10s
+  },
+});
+
+// 记录操作
+await collector.recordOk('extract', 150, { contextSize: 5000 });
+await collector.recordExceeded('invoke', 12000, 10000, { agent: 'skill-agent' });
+
+// 分析统计
+const analyzer = new PerformanceAnalyzer();
+const summaries = analyzer.summarize(traces);
+const anomalies = analyzer.detectAnomalies(traces);
+
+// 生成报告
+const report = analyzer.generateReport(summaries, anomalies);
+```
+
+### 文件位置
+
+```
+.harness/logs/
+├── performance.log          # 性能日志
+├── performance-summary.json # 统计汇总
+└── tokens.log               # Token 使用日志
+```
+
+### 与 TraceCollector 对比
+
+| 能力 | TraceCollector | PerformanceCollector |
+|------|----------------|---------------------|
+| **监控目标** | 约束检查结果 | 操作耗时 |
+| **监控"什么"** | 对不对 | 快不快 |
+| **异常类型** | 高绕过率、失败率上升 | 慢操作、超阈值 |
+| **存储路径** | `.harness/logs/traces.log` | `.harness/logs/performance.log` |
+
+---
+
+## Failure Classification 系统（v0.4+）
+
+### 概念
+
+Failure Classification 提供通用的错误分类和记录能力，用于：
+- 统一错误分类标准
+- 分级处理失败（L1-L4）
+- 记录失败历史供分析
+
+### 设计原则
+
+| 原则 | 说明 |
+|------|------|
+| **零业务逻辑** | 只提供类型 + 分类 + 记录能力 |
+| **可扩展规则** | 支持自定义分类规则 |
+| **文件存储** | 追加写入，单行 JSON 格式 |
+
+### 错误类型
+
+```typescript
+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',       // Agent 错误
+  TOOL_ERROR = 'TOOL_ERROR',         // 工具错误
+  VALIDATION_ERROR = 'VALIDATION_ERROR', // 验证错误
+  UNKNOWN = 'UNKNOWN',               // 未知错误
+}
+```
+
+### 失败等级
+
+| 等级 | 说明 | 处理策略 |
+|------|------|---------|
+| L1 | 自动重试 | 重试、降级 |
+| L2 | 需要干预 | 人工审核 |
+| L3 | 严重问题 | 开会讨论 |
+| L4 | 致命错误 | 回滚 |
+
+### API 使用
+
+```typescript
+import {
+  ErrorClassifier,
+  FailureRecorder,
+  ErrorType,
+  FailureLevel,
+  classifyError,
+} from '@dommaker/harness';
+
+// 快速分类
+const type = classifyError(new Error('test failed'));
+// type === ErrorType.TEST_FAILED
+
+// 完整分类器
+const classifier = new ErrorClassifier({
+  rules: [
+    {
+      type: ErrorType.CUSTOM_ERROR,
+      keywords: ['custom', 'specific'],
+      level: FailureLevel.L2,
+    },
+  ],
+});
+
+const result = classifier.classify(new Error('custom error'));
+// result.type, result.level, result.matchedRule
+
+// 失败记录
+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(),
+});
+
+// 获取统计
+const stats = await recorder.getStats();
+// { total, byType, byLevel }
+```
+
+### 与 PerformanceCollector 对比
+
+| 能力 | PerformanceCollector | FailureRecorder |
+|------|---------------------|-----------------|
+| **监控目标** | 操作耗时 | 错误分类 |
+| **存储内容** | 性能指标 | 失败记录 |
+| **分析维度** | 慢操作、超阈值 | 错误类型分布、失败等级 |

package/dist/architecture/constraint-engine.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 架构约束引擎
+ *
+ * 通用能力：加载规则、执行检查、生成报告
+ * 规则定义：由项目提供（.architect/rules.yml）
+ */
+export interface ArchitectureContext {
+    files: string[];
+    diff: string;
+    pr?: {
+        number: number;
+        changedFiles: number;
+        additions: number;
+        deletions: number;
+    };
+}
+export interface ArchitectureViolation {
+    ruleId: string;
+    message: string;
+    files?: string[];
+    severity: 'error' | 'warning';
+}
+export interface ArchitectureResult {
+    passed: boolean;
+    violations: ArchitectureViolation[];
+}
+export interface ArchitectureRule {
+    id: string;
+    type: 'forbidden-pattern' | 'file-count' | 'module-boundary' | 'custom';
+    severity?: 'error' | 'warning';
+    scope?: string;
+    message?: string;
+    patterns?: string[];
+    threshold?: number;
+    script?: string;
+}
+export declare class ArchitectureConstraintEngine {
+    private rules;
+    constructor(rules: ArchitectureRule[]);
+    check(context: ArchitectureContext): Promise<ArchitectureResult>;
+    private checkRule;
+    private checkForbiddenPattern;
+    private checkFileCount;
+    private checkModuleBoundary;
+    private matchGlob;
+}
+export declare function loadArchitectureRules(configPath: string): Promise<ArchitectureRule[]>;
+export declare function runArchitectureCheck(configPath: string, context: ArchitectureContext): Promise<ArchitectureResult>;
+//# sourceMappingURL=constraint-engine.d.ts.map

package/dist/architecture/constraint-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-engine.d.ts","sourceRoot":"","sources":["../../src/architecture/constraint-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,mBAAmB,GAAG,YAAY,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IACxE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,4BAA4B;IAC3B,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,gBAAgB,EAAE;IAEvC,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAcxD,SAAS;IAgBvB,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,SAAS;CAkBlB;AAGD,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB3F;AAiED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}

package/dist/architecture/constraint-engine.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * 架构约束引擎
+ *
+ * 通用能力：加载规则、执行检查、生成报告
+ * 规则定义：由项目提供（.architect/rules.yml）
+ */
+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.ArchitectureConstraintEngine = void 0;
+exports.loadArchitectureRules = loadArchitectureRules;
+exports.runArchitectureCheck = runArchitectureCheck;
+class ArchitectureConstraintEngine {
+    rules;
+    constructor(rules) {
+        this.rules = rules;
+    }
+    async check(context) {
+        const violations = [];
+        for (const rule of this.rules) {
+            const result = await this.checkRule(rule, context);
+            violations.push(...result);
+        }
+        return {
+            passed: violations.filter(v => v.severity === 'error').length === 0,
+            violations,
+        };
+    }
+    async checkRule(rule, context) {
+        switch (rule.type) {
+            case 'forbidden-pattern':
+                return this.checkForbiddenPattern(rule, context);
+            case 'file-count':
+                return this.checkFileCount(rule, context);
+            case 'module-boundary':
+                return this.checkModuleBoundary(rule, context);
+            default:
+                return [];
+        }
+    }
+    checkForbiddenPattern(rule, context) {
+        const violations = [];
+        const patterns = rule.patterns || [];
+        for (const file of context.files) {
+            // 检查文件路径是否匹配 scope
+            if (rule.scope && !this.matchGlob(file, rule.scope)) {
+                continue;
+            }
+            // 检查文件名是否包含禁止模式
+            for (const pattern of patterns) {
+                if (file.toLowerCase().includes(pattern.toLowerCase())) {
+                    violations.push({
+                        ruleId: rule.id,
+                        message: rule.message || `File contains forbidden pattern: ${pattern}`,
+                        files: [file],
+                        severity: rule.severity || 'error',
+                    });
+                }
+            }
+        }
+        return violations;
+    }
+    checkFileCount(rule, context) {
+        const threshold = rule.threshold || 3;
+        const count = context.files.length;
+        if (count > threshold) {
+            return [{
+                    ruleId: rule.id,
+                    message: rule.message || `Too many files changed (${count} > ${threshold}). Reuse check required.`,
+                    severity: rule.severity || 'warning',
+                }];
+        }
+        return [];
+    }
+    checkModuleBoundary(rule, context) {
+        // TODO: 实现模块边界检查
+        return [];
+    }
+    matchGlob(file, pattern) {
+        // 简化的 glob 匹配
+        let regexPattern = pattern;
+        // 处理 **/ 开头（匹配任意前缀路径）
+        if (regexPattern.startsWith('**/')) {
+            regexPattern = '(?:.*/)?' + regexPattern.slice(3);
+        }
+        // 处理 /**/（匹配任意中间路径）和 **（匹配任意字符）
+        regexPattern = regexPattern
+            .replace(/\/\*\*\//g, '/(?:.*/)?') // /**/ -> /(?:.*/)?
+            .replace(/\*\*/g, '.*') // ** -> .*
+            .replace(/\*/g, '[^/]*'); // * -> [^/]*
+        const regex = new RegExp(regexPattern);
+        return regex.test(file);
+    }
+}
+exports.ArchitectureConstraintEngine = ArchitectureConstraintEngine;
+// 加载规则的工厂函数（支持 YAML 或 JSON）
+async function loadArchitectureRules(configPath) {
+    const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+    const content = await fs.readFile(configPath, 'utf-8');
+    // 简单 YAML 解析（不依赖外部库）
+    let config;
+    if (configPath.endsWith('.json')) {
+        config = JSON.parse(content);
+    }
+    else {
+        // 简单 YAML 解析：提取 rules 数组
+        config = parseSimpleYaml(content);
+    }
+    return config.rules || [];
+}
+// 简单的 YAML 子集解析器
+function parseSimpleYaml(content) {
+    const lines = content.split('\n');
+    const result = { rules: [] };
+    let currentRule = null;
+    let currentArray = null;
+    let indentLevel = 0;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // 跳过注释和空行
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        // 检测缩进级别
+        const leadingSpace = line.length - line.trimStart().length;
+        // 新规则开始
+        if (trimmed.startsWith('- id:')) {
+            if (currentRule && result.rules) {
+                result.rules.push(currentRule);
+            }
+            currentRule = { id: trimmed.replace('- id:', '').trim() };
+            currentArray = null;
+            indentLevel = leadingSpace;
+        }
+        // 规则属性
+        else if (currentRule && trimmed.includes(':')) {
+            const colonIndex = trimmed.indexOf(':');
+            const key = trimmed.slice(0, colonIndex).trim();
+            const value = trimmed.slice(colonIndex + 1).trim();
+            if (key === 'patterns') {
+                currentArray = [];
+                currentRule[key] = currentArray;
+            }
+            else if (value) {
+                // 去除引号
+                const cleanValue = value.replace(/^["']|["']$/g, '');
+                if (key === 'threshold') {
+                    currentRule[key] = parseInt(cleanValue, 10);
+                }
+                else if (key === 'severity') {
+                    currentRule[key] = cleanValue;
+                }
+                else {
+                    currentRule[key] = cleanValue;
+                }
+            }
+        }
+        // 数组元素
+        else if (currentArray && trimmed.startsWith('- ')) {
+            const value = trimmed.slice(2).trim().replace(/^["']|["']$/g, '');
+            currentArray.push(value);
+        }
+    }
+    // 添加最后一个规则
+    if (currentRule && result.rules) {
+        result.rules.push(currentRule);
+    }
+    return result;
+}
+// CLI 入口
+async function runArchitectureCheck(configPath, context) {
+    const rules = await loadArchitectureRules(configPath);
+    const engine = new ArchitectureConstraintEngine(rules);
+    return engine.check(context);
+}
+//# sourceMappingURL=constraint-engine.js.map

package/dist/architecture/constraint-engine.js.map

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

package/dist/architecture/cross-project-checker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 跨工程接口契约检查
+ *
+ * 检测多工程开发时的接口不一致问题
+ */
+export interface CrossProjectViolation {
+    type: 'api-mismatch' | 'doc-code-mismatch' | 'breaking-change' | 'missing-implementation';
+    severity: 'error' | 'warning';
+    message: string;
+    fromProject: string;
+    toProject: string;
+    details: {
+        interfaceName?: string;
+        fieldName?: string;
+        expectedType?: string;
+        actualType?: string;
+        location?: string;
+    };
+}
+export interface CrossProjectContext {
+    baseBranch: string;
+    changedProjects: string[];
+    changedFiles: string[];
+}
+/**
+ * 检查跨工程接口一致性
+ */
+export declare function checkCrossProjectContracts(context: CrossProjectContext): Promise<CrossProjectViolation[]>;
+/**
+ * 检查文档-代码一致性
+ * 场景：文档写了接口，代码没实现
+ */
+export declare function checkDocCodeConsistency(docPath: string, projects: string[]): Promise<CrossProjectViolation[]>;
+//# sourceMappingURL=cross-project-checker.d.ts.map

package/dist/architecture/cross-project-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-project-checker.d.ts","sourceRoot":"","sources":["../../src/architecture/cross-project-checker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,wBAAwB,CAAC;IAC1F,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAsBD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAalC;AAyGD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA4ClC"}