@winspan/claude-forge 0.1.1

package/dist/skill-registry/official-sync.js

@@ -0,0 +1,576 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { SkillsConfigManager } from './skills-config.js';
+import { OrchestrationConfigManager } from './orchestration-config.js';
+import { logger } from '../utils/logger.js';
+const SKILLS_DIR = path.join(os.homedir(), '.claude', 'skills');
+/**
+ * 官方技能默认编排关键词映射
+ * sync() 时写入 orchestration-config.json（已存在则跳过）
+ */
+const OFFICIAL_ORCHESTRATION_MAPPINGS = [
+    { skill: 'official-tdd', keywords: ['tdd', 'test-driven', '测试驱动'] },
+    { skill: 'official-debug', keywords: ['debug', '调试', 'bug', '修复', 'fix', 'hotfix'] },
+    { skill: 'official-refactor', keywords: ['refactor', '重构', 'cleanup', 'reorganize', 'restructure'] },
+    { skill: 'official-pr-review', keywords: ['review', '审查', 'pr review', 'code review'] },
+    { skill: 'official-harness-engineering', keywords: ['harness', 'legacy', '遗留代码', '特征测试', 'characterization'] },
+    { skill: 'official-spec-driven-design', keywords: ['spec', 'sdd', 'spec-driven', '规格', '需求文档', 'requirements'] },
+    { skill: 'official-architecture-decision', keywords: ['adr', 'architecture decision', '架构决策', '技术选型'] },
+    { skill: 'official-api-design', keywords: ['api design', 'api 设计', 'restful', 'openapi', '接口设计'] },
+    { skill: 'official-db-schema-design', keywords: ['schema', 'database', '数据库设计', 'migration', '迁移', 'sql'] },
+    { skill: 'official-performance-optimization', keywords: ['performance', '性能', 'optimize', '优化', 'profiling', '瓶颈'] },
+    { skill: 'official-security-hardening', keywords: ['security', '安全', 'owasp', 'hardening', '加固', 'vulnerability', '漏洞'] },
+    { skill: 'official-release-checklist', keywords: ['release', 'deploy', '发布', '上线', 'checklist', '部署'] },
+    { skill: 'official-doc-driven', keywords: ['doc-driven', 'documentation', '文档驱动', '写文档', 'readme'] },
+];
+/**
+ * 内置官方技能 — 覆盖全栈超级个体完整开发流程
+ * 版本号变更时守护进程启动自动更新
+ */
+const OFFICIAL_SKILLS = [
+    {
+        name: 'official-harness-engineering',
+        version: '1.0.0',
+        description: 'Harness Engineering：为遗留代码建立测试防护网再安全修改',
+        tags: ['harness', 'testing', 'legacy', 'refactor'],
+        content: `---
+name: official-harness-engineering
+version: 1.0.0
+description: "Harness Engineering：为遗留代码建立测试防护网再安全修改"
+tags: [harness, testing, legacy, refactor]
+---
+
+# Harness Engineering
+
+在修改任何现有代码前，先建立测试防护网（harness），确保改动不破坏现有行为。
+
+## 与 TDD 的区别
+- TDD 用于新功能开发（先测试后实现）
+- Harness Engineering 用于改动现有代码（先理解后保护再修改）
+
+## 步骤
+
+1. **理解现有行为** — 阅读代码，推断当前实际行为
+   - 找到所有入口点和输出点
+   - 记录边界条件和隐含假设
+
+2. **建立 Characterization Tests（特征测试）**
+   - 测试描述"代码现在做什么"，不是"应该做什么"
+   - 覆盖所有主要代码路径
+   - 全部通过后才能继续
+
+3. **最小化修改** — 在安全网保护下进行改动
+   - 每次只改一处，改完立即运行 harness
+   - 测试失败 = 立即回滚，不要积累未验证的变更
+
+4. **逐步替换** — 新行为用新测试覆盖，旧 harness 逐步退役
+
+## 适用场景
+- 修改没有测试的遗留代码
+- 重构高风险核心模块
+- 接手不熟悉的代码库
+`,
+    },
+    {
+        name: 'official-spec-driven-design',
+        version: '1.0.0',
+        description: 'SDD：先写规格文档再写代码，需求驱动实现',
+        tags: ['sdd', 'spec', 'design', 'requirements'],
+        content: `---
+name: official-spec-driven-design
+version: 1.0.0
+description: "SDD：先写规格文档再写代码，需求驱动实现"
+tags: [sdd, spec, design, requirements]
+---
+
+# Spec-Driven Design（规格驱动开发）
+
+在写任何代码之前，先把规格写清楚。规格是代码的合同。
+
+## 步骤
+
+1. **写 SPEC.md**，包含：
+   - 功能目标（一句话）
+   - 输入/输出定义（含类型和边界）
+   - 不做什么（明确排除项）
+   - 验收标准（可测试的条件列表）
+
+2. **评审规格** — 在写代码前确认规格无歧义
+   - 每条验收标准都能写成测试吗？
+   - 边界条件是否覆盖？
+
+3. **按规格实现** — 代码只做规格里写的事
+   - 遇到规格未覆盖的情况，先更新规格再写代码
+
+4. **验收** — 逐条对照验收标准，全部通过才算完成
+
+## 规则
+- 规格变更必须先于代码变更
+- 实现不得超出规格范围（避免过度设计）
+`,
+    },
+    {
+        name: 'official-architecture-decision',
+        version: '1.0.0',
+        description: '架构决策记录（ADR）：结构化记录重要技术决策',
+        tags: ['architecture', 'adr', 'design', 'decision'],
+        content: `---
+name: official-architecture-decision
+version: 1.0.0
+description: "架构决策记录（ADR）：结构化记录重要技术决策"
+tags: [architecture, adr, design, decision]
+---
+
+# 架构决策记录（ADR）
+
+每个重要的技术决策都应该留下可追溯的记录。
+
+## 何时写 ADR
+- 技术选型（框架、数据库、消息队列）
+- 系统边界划分
+- 接口协议选择
+- 影响超过 1 个模块的设计决策
+
+## ADR 模板
+
+\`\`\`markdown
+# ADR-{编号}: {标题}
+
+## 状态
+Proposed / Accepted / Deprecated
+
+## 背景
+为什么需要做这个决策？当前面临什么问题？
+
+## 决策
+我们选择做什么？
+
+## 备选方案
+考虑过哪些其他方案？为什么没选？
+
+## 后果
+这个决策带来什么好处？有什么代价或风险？
+\`\`\`
+
+## 规则
+- ADR 一旦 Accepted 不得修改，只能新建 ADR 来废弃或替代
+- 存放在项目 \`docs/adr/\` 目录
+`,
+    },
+    {
+        name: 'official-api-design',
+        version: '1.0.0',
+        description: 'API 设计规范：RESTful/RPC 接口设计最佳实践',
+        tags: ['api', 'rest', 'design', 'backend'],
+        content: `---
+name: official-api-design
+version: 1.0.0
+description: "API 设计规范：RESTful/RPC 接口设计最佳实践"
+tags: [api, rest, design, backend]
+---
+
+# API 设计规范
+
+## 设计顺序
+1. 先定义资源和操作（不要先想 URL）
+2. 写 OpenAPI/Protobuf 规格
+3. 用 mock 验证调用方能用
+4. 再实现
+
+## RESTful 规范
+- URL 用名词复数：\`/users\`，不用动词 \`/getUser\`
+- 用 HTTP 动词表达操作：GET/POST/PUT/PATCH/DELETE
+- 错误返回统一结构：\`{ code, message, data }\`
+- 分页用 \`?page=1&size=20\`，返回 \`total\`
+
+## 版本管理
+- URL 版本：\`/api/v1/users\`（推荐）
+- 破坏性变更必须升版本
+
+## 通用原则
+- 幂等性：PUT/DELETE 必须幂等
+- 认证统一走 Authorization header
+- 敏感字段不出现在 URL（用 body）
+- 响应时间 P99 < 200ms，超时统一 30s
+`,
+    },
+    {
+        name: 'official-db-schema-design',
+        version: '1.0.0',
+        description: '数据库 Schema 设计：建模、迁移和演进最佳实践',
+        tags: ['database', 'schema', 'sql', 'migration'],
+        content: `---
+name: official-db-schema-design
+version: 1.0.0
+description: "数据库 Schema 设计：建模、迁移和演进最佳实践"
+tags: [database, schema, sql, migration]
+---
+
+# 数据库 Schema 设计
+
+## 设计原则
+- 先建模（ER 图），再建表
+- 每张表只表达一个实体
+- 外键约束在数据库层面强制
+
+## 命名规范
+- 表名：snake_case 复数（\`user_profiles\`）
+- 主键：\`id\`（自增或 UUID）
+- 时间戳：\`created_at\`、\`updated_at\`（每张表必有）
+- 软删除：\`deleted_at\` nullable
+
+## 索引策略
+- 外键列必须建索引
+- 高频查询的 WHERE 条件列建索引
+- 复合索引遵循最左前缀原则
+
+## 迁移规范
+- 每次变更写迁移文件，不手动改生产库
+- 迁移必须可回滚（写 down migration）
+- 破坏性变更分三步：加新列 → 双写 → 删旧列
+
+## 常见陷阱
+- 不用 \`ENUM\` 类型，用关联表或字符串
+- JSON 列只存真正非结构化数据
+- 避免 EAV 模式（Entity-Attribute-Value）
+`,
+    },
+    {
+        name: 'official-pr-review',
+        version: '1.2.0',
+        description: '结构化 PR 审查：覆盖正确性、安全性和可维护性',
+        tags: ['review', 'pr', 'quality'],
+        content: `---
+name: official-pr-review
+version: 1.2.0
+description: "结构化 PR 审查：覆盖正确性、安全性和可维护性"
+tags: [review, pr, quality]
+---
+
+# Pull Request 审查
+
+## 审查顺序（重要性从高到低）
+
+### 1. 正确性
+- [ ] 逻辑在所有边界条件下正确
+- [ ] 错误处理恰当，异常不被静默吞掉
+- [ ] 无竞态条件或并发问题
+
+### 2. 安全性
+- [ ] 无注入漏洞（SQL、命令、XSS、SSRF）
+- [ ] 敏感数据未被日志记录或暴露
+- [ ] 权限检查在正确的层级
+
+### 3. 性能
+- [ ] 无 N+1 查询
+- [ ] 大数据量场景有分页或流式处理
+
+### 4. 可维护性
+- [ ] 代码可读，命名自文档化
+- [ ] 单一职责，函数不超过 40 行
+
+### 5. 测试
+- [ ] 新功能有对应测试
+- [ ] 边界条件有测试覆盖
+
+## 输出格式
+**[BLOCKER|MAJOR|MINOR]** \`文件:行号\` — 问题 → 建议
+`,
+    },
+    {
+        name: 'official-debug',
+        version: '1.2.0',
+        description: '系统化调试工作流：复现、隔离、修复、验证',
+        tags: ['debug', 'troubleshooting'],
+        content: `---
+name: official-debug
+version: 1.2.0
+description: "系统化调试工作流：复现、隔离、修复、验证"
+tags: [debug, troubleshooting]
+---
+
+# 系统化调试
+
+## 步骤
+
+1. **复现** — 确认 bug 可稳定复现
+   - 记录：环境、输入、期望行为、实际行为
+
+2. **隔离** — 缩小根因范围
+   - 二分法排查代码路径
+   - 检查近期变更（\`git bisect\`）
+   - 加日志，不要靠猜
+
+3. **假设** — 清晰陈述假设再验证，每次只验证一个
+
+4. **修复** — 最小化修复，解决根本原因
+   - 修复前先写一个能复现 bug 的测试
+
+5. **验证** — 原始 bug 消失 + 无回归 + 测试通过
+`,
+    },
+    {
+        name: 'official-performance-optimization',
+        version: '1.0.0',
+        description: '性能优化工作流：先度量再优化，数据驱动',
+        tags: ['performance', 'optimization', 'profiling'],
+        content: `---
+name: official-performance-optimization
+version: 1.0.0
+description: "性能优化工作流：先度量再优化，数据驱动"
+tags: [performance, optimization, profiling]
+---
+
+# 性能优化
+
+## 黄金法则
+**永远先度量，再优化。** 没有数据的优化是猜测。
+
+## 步骤
+
+1. **建立基线** — 用真实数据测量当前性能
+   - 定义指标：延迟（P50/P95/P99）、吞吐量、内存
+
+2. **找瓶颈** — Profile，不要猜
+   - CPU：火焰图；内存：heap 分析；I/O：慢查询日志
+
+3. **优化** — 从收益最大的瓶颈开始
+   - 算法复杂度 > 减少 I/O > 缓存 > 并发
+
+4. **验证** — 对比基线，功能测试全部通过
+
+## 常见优化方向（按收益排序）
+- 数据库：索引、消除 N+1、连接池
+- 缓存：热点数据、计算结果
+- 异步化：I/O 密集型操作
+- 批处理：替代逐条处理
+`,
+    },
+    {
+        name: 'official-security-hardening',
+        version: '1.0.0',
+        description: '安全加固清单：覆盖 OWASP Top 10 和常见安全实践',
+        tags: ['security', 'owasp', 'hardening'],
+        content: `---
+name: official-security-hardening
+version: 1.0.0
+description: "安全加固清单：覆盖 OWASP Top 10 和常见安全实践"
+tags: [security, owasp, hardening]
+---
+
+# 安全加固
+
+## 输入验证
+- 所有外部输入在边界处验证（类型、长度、格式）
+- 参数化查询，禁止字符串拼接 SQL
+- 文件上传：验证类型、大小、存储路径隔离
+
+## 认证与授权
+- 密码：bcrypt/argon2 哈希，禁止 MD5/SHA1
+- Token：短有效期 + refresh token 机制
+- 每个接口显式检查权限，不依赖前端隐藏
+
+## 数据保护
+- 敏感字段（密码、密钥、PII）不写日志
+- HTTPS only，HSTS header
+- 密钥走环境变量，不进代码库
+
+## 依赖安全
+- 定期运行 \`npm audit\` / \`pip audit\` / \`govulncheck\`
+- lockfile 提交到仓库
+
+## 常见漏洞速查
+- XSS：输出时转义，CSP header
+- CSRF：SameSite cookie + CSRF token
+- SSRF：白名单限制外部请求目标
+`,
+    },
+    {
+        name: 'official-release-checklist',
+        version: '1.0.0',
+        description: '发布上线清单：从代码冻结到生产验证的完整流程',
+        tags: ['release', 'deploy', 'checklist', 'devops'],
+        content: `---
+name: official-release-checklist
+version: 1.0.0
+description: "发布上线清单：从代码冻结到生产验证的完整流程"
+tags: [release, deploy, checklist, devops]
+---
+
+# 发布上线清单
+
+## 发布前
+- [ ] 所有测试通过（单元、集成、E2E）
+- [ ] 代码已 review 并合并到主干
+- [ ] 数据库迁移脚本已准备，可回滚
+- [ ] 配置变更已确认（环境变量、feature flag）
+- [ ] 监控告警已配置
+- [ ] 回滚方案已明确
+
+## 发布中
+- [ ] 灰度/金丝雀发布（先放 5% 流量）
+- [ ] 观察关键指标 5 分钟：错误率、P99 延迟
+
+## 发布后
+- [ ] 生产环境冒烟测试
+- [ ] 监控观察 30 分钟
+- [ ] 通知相关方
+
+## 回滚触发条件
+- 错误率上升 > 1%
+- P99 延迟上升 > 50%
+- 出现 CRITICAL 级别日志
+`,
+    },
+    {
+        name: 'official-doc-driven',
+        version: '1.0.0',
+        description: '文档驱动开发：先写文档再写代码，保持文档与代码同步',
+        tags: ['documentation', 'doc-driven', 'readme'],
+        content: `---
+name: official-doc-driven
+version: 1.0.0
+description: "文档驱动开发：先写文档再写代码，保持文档与代码同步"
+tags: [documentation, doc-driven, readme]
+---
+
+# 文档驱动开发
+
+## 核心理念
+如果你无法清晰地写出来，说明你还没想清楚。先写文档，逼自己想清楚再动手。
+
+## 步骤
+
+1. **写 README 先于代码**
+   - 描述模块是什么、解决什么问题
+   - 写出使用示例（即使 API 还不存在）
+   - 示例写起来别扭 = 设计有问题
+
+2. **接口文档先于实现**
+   - 函数签名 + JSDoc/注释先写
+   - 参数、返回值、异常都要说明
+
+3. **保持同步**
+   - 代码变更时同步更新文档
+   - PR 模板加入"文档是否已更新"检查项
+
+## 文档层级
+- README：模块概述 + 快速开始
+- ARCHITECTURE.md：系统设计和关键决策
+- 代码注释：解释"为什么"，不解释"是什么"
+`,
+    },
+];
+export class OfficialSkillSync {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    sync() {
+        const report = { added: [], skipped: [], updated: [] };
+        // 合并内置技能 + 用户自定义技能
+        const userSkills = new SkillsConfigManager().listSkills();
+        const allEntries = [
+            ...OFFICIAL_SKILLS,
+            ...userSkills.map(s => ({ ...s, source: 'user' })),
+        ];
+        for (const entry of allEntries) {
+            const existing = this.registry.get(entry.name);
+            if (existing && (existing.source === 'official' || existing.source === 'user')) {
+                // 磁盘版本 >= 配置版本：已是最新或已被蒸馏升级，跳过
+                if (this.versionGte(existing.version, entry.version)) {
+                    report.skipped.push(entry.name);
+                    continue;
+                }
+                // 磁盘版本 < 代码版本：代码有新版本，覆盖更新
+                this.installSkill(entry);
+                this.registry.register(this.toSkillMeta(entry));
+                report.updated.push(entry.name);
+                logger.info(`[官方同步] 已更新：${entry.name} → v${entry.version}`);
+            }
+            else if (!existing) {
+                this.installSkill(entry);
+                this.registry.register(this.toSkillMeta(entry));
+                report.added.push(entry.name);
+                logger.info(`[官方同步] 已添加：${entry.name}`);
+            }
+            else {
+                report.skipped.push(entry.name);
+            }
+        }
+        if (report.added.length > 0 || report.updated.length > 0) {
+            logger.info(`[官方同步] 同步完成：+${report.added.length} 更新=${report.updated.length} 跳过=${report.skipped.length}`);
+        }
+        // 初始化官方技能的默认编排映射（已存在则跳过，不覆盖用户修改）
+        new OrchestrationConfigManager().initOfficialMappings(OFFICIAL_ORCHESTRATION_MAPPINGS);
+        return report;
+    }
+    /** 版本号比较：a >= b */
+    versionGte(a, b) {
+        const pa = a.split('.').map(Number);
+        const pb = b.split('.').map(Number);
+        for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+            const na = pa[i] ?? 0;
+            const nb = pb[i] ?? 0;
+            if (na > nb)
+                return true;
+            if (na < nb)
+                return false;
+        }
+        return true; // 相等也算 >=
+    }
+    /** 获取所有官方技能名称（供 SkillEvolver 识别） */
+    getOfficialNames() {
+        return OFFICIAL_SKILLS.map(s => s.name);
+    }
+    /** 更新单个官方技能内容（由 SkillEvolver 进化时调用） */
+    updateSkillContent(name, newContent, newVersion) {
+        const existing = this.registry.get(name);
+        if (!existing)
+            return false;
+        const skillDir = path.join(SKILLS_DIR, name);
+        if (!fs.existsSync(skillDir))
+            return false;
+        // 写入前校验：必须是合法的 SKILL.md（以 --- 开头且包含 name: 字段）
+        const trimmed = newContent.trim();
+        if (!trimmed.startsWith('---') || !trimmed.includes('name:')) {
+            logger.warn(`[官方同步] 拒绝无效内容：${name} 不以 frontmatter 开头`);
+            return false;
+        }
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+        if (fs.existsSync(skillMdPath)) {
+            fs.copyFileSync(skillMdPath, skillMdPath + '.bak');
+        }
+        fs.writeFileSync(skillMdPath, trimmed + '\n', 'utf-8');
+        fs.writeFileSync(path.join(skillDir, '.forge-meta.json'), JSON.stringify({ name, source: 'official', version: newVersion, updatedAt: new Date().toISOString() }, null, 2), 'utf-8');
+        this.registry.register({ ...existing, version: newVersion });
+        logger.info(`[官方同步] 内容已进化：${name} → v${newVersion}`);
+        return true;
+    }
+    installSkill(entry) {
+        const skillDir = path.join(SKILLS_DIR, entry.name);
+        if (!fs.existsSync(skillDir)) {
+            fs.mkdirSync(skillDir, { recursive: true });
+        }
+        fs.writeFileSync(path.join(skillDir, 'SKILL.md'), entry.content, 'utf-8');
+        fs.writeFileSync(path.join(skillDir, '.forge-meta.json'), JSON.stringify({
+            name: entry.name,
+            source: 'official',
+            version: entry.version,
+            installedAt: new Date().toISOString(),
+        }, null, 2), 'utf-8');
+    }
+    toSkillMeta(entry) {
+        return {
+            name: entry.name,
+            version: entry.version,
+            description: entry.description,
+            source: 'official',
+            path: path.join(SKILLS_DIR, entry.name),
+            tags: entry.tags,
+            stats: { callCount: 0, lastUsed: null, successRate: 1, userFeedback: { positive: 0, negative: 0 } },
+        };
+    }
+}
+//# sourceMappingURL=official-sync.js.map

package/dist/skill-registry/official-sync.js.map

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

package/dist/skill-registry/orchestration-config.d.ts

@@ -0,0 +1,35 @@
+export interface OrchestrationMapping {
+    skill: string;
+    keywords: string[];
+    /** 关键词命中后实际触发技能调用的次数 */
+    hits?: number;
+    /** 关键词命中但未触发技能调用的次数 */
+    misses?: number;
+    /** 最近一次命中时间（ISO 字符串） */
+    lastHit?: string;
+}
+export interface OrchestrationConfig {
+    mappings: OrchestrationMapping[];
+}
+export declare class OrchestrationConfigManager {
+    private configPath;
+    private static readonly FLUSH_INTERVAL_MS;
+    constructor(configPath?: string);
+    load(): OrchestrationConfig;
+    save(config: OrchestrationConfig): void;
+    /** 立即将缓存写入磁盘（daemon 关闭时调用） */
+    flush(): void;
+    private scheduleFlush;
+    /** 添加或更新一条映射 */
+    upsert(mapping: OrchestrationMapping): void;
+    /** 删除一条映射 */
+    remove(skill: string): boolean;
+    /** 批量初始化官方技能映射（已存在则跳过） */
+    initOfficialMappings(mappings: OrchestrationMapping[]): void;
+    listMappings(): OrchestrationMapping[];
+    /** 记录一次命中（关键词匹配后实际触发了技能调用） */
+    recordHit(skill: string): void;
+    /** 记录一次未命中（关键词匹配但技能未被实际调用） */
+    recordMiss(skill: string): void;
+}
+//# sourceMappingURL=orchestration-config.d.ts.map

package/dist/skill-registry/orchestration-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-config.d.ts","sourceRoot":"","sources":["../../src/skill-registry/orchestration-config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAmBD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;gBAErC,UAAU,SAA4B;IAIlD,IAAI,IAAI,mBAAmB;IAgB3B,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAQvC,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,aAAa;IASrB,gBAAgB;IAChB,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAW3C,aAAa;IACb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAW9B,0BAA0B;IAC1B,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI;IAY5D,YAAY,IAAI,oBAAoB,EAAE;IAItC,8BAA8B;IAC9B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS9B,8BAA8B;IAC9B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAOhC"}