@dommaker/harness 0.8.3 → 0.10.0

package/dist/knowledge/lint.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * 知识库 Lint（健康检查）
+ *
+ * 检查项：
+ * - 索引不一致（自动修复）
+ * - 孤儿条目（无引用、无验证）
+ * - 矛盾检测（同主题相反结论）
+ * - 过时检测（6 月未引用的 draft）
+ * - 重复/相似条目
+ * - 成熟度衰减
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeLinter = void 0;
+class KnowledgeLinter {
+    store;
+    tracker;
+    constructor(store, tracker) {
+        this.store = store;
+        this.tracker = tracker;
+    }
+    /**
+     * 执行完整 Lint 检查
+     */
+    run(autoFix = false) {
+        const entries = this.store.list({ excludeArchived: false });
+        const issues = [];
+        // 各项检查
+        issues.push(...this.checkIndexConsistency(entries));
+        issues.push(...this.checkOrphans(entries));
+        issues.push(...this.checkOutdated(entries));
+        issues.push(...this.checkDuplicates(entries));
+        issues.push(...this.checkContradictions(entries));
+        // 自动修复
+        let fixed = 0;
+        if (autoFix) {
+            fixed = this.autoFix(issues);
+        }
+        // 统计
+        const summary = {
+            orphan: 0,
+            contradiction: 0,
+            outdated: 0,
+            duplicate: 0,
+            index_inconsistent: 0,
+        };
+        for (const issue of issues) {
+            summary[issue.type]++;
+        }
+        return {
+            timestamp: new Date().toISOString(),
+            totalEntries: entries.length,
+            issues,
+            fixed,
+            summary,
+        };
+    }
+    /**
+     * 检查索引一致性
+     */
+    checkIndexConsistency(entries) {
+        const issues = [];
+        const index = this.store['readIndex']();
+        // 检查索引中的条目是否都有对应文件
+        for (const indexEntry of index) {
+            const fileEntry = this.store.get(indexEntry.id);
+            if (!fileEntry) {
+                issues.push({
+                    type: 'index_inconsistent',
+                    entryId: indexEntry.id,
+                    severity: 'medium',
+                    description: `索引条目 ${indexEntry.id} 无对应文件`,
+                    suggestion: '从索引中移除或重建索引',
+                });
+            }
+        }
+        // 检查磁盘上的文件是否都在索引中
+        const indexIds = new Set(index.map(e => e.id));
+        const diskEntries = this.store['readEntriesFromDisk']();
+        for (const entry of diskEntries) {
+            if (!indexIds.has(entry.id)) {
+                issues.push({
+                    type: 'index_inconsistent',
+                    entryId: entry.id,
+                    severity: 'medium',
+                    description: `条目 ${entry.id} 不在索引中`,
+                    suggestion: '重建索引',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * 检查孤儿条目（无引用、无验证）
+     */
+    checkOrphans(entries) {
+        const issues = [];
+        for (const entry of entries) {
+            if (entry.maturity === 'archived')
+                continue;
+            const refs = this.tracker.getReferencesForEntry(entry.id);
+            const hasReferences = refs.length > 0;
+            const hasContributors = entry.contributors.length > 0;
+            const hasProjects = entry.projects.length > 0;
+            if (!hasReferences && !hasContributors && !hasProjects && entry.maturity === 'draft') {
+                issues.push({
+                    type: 'orphan',
+                    entryId: entry.id,
+                    severity: 'low',
+                    description: `条目 ${entry.id} (${entry.title}) 无引用、无贡献者、无项目验证`,
+                    suggestion: '考虑归档或标记为需要验证',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * 检查过时条目（6 月未引用的 draft）
+     */
+    checkOutdated(entries) {
+        const issues = [];
+        const sixMonthsAgo = new Date();
+        sixMonthsAgo.setMonth(sixMonthsAgo.getMonth() - 6);
+        for (const entry of entries) {
+            if (entry.maturity === 'archived')
+                continue;
+            const lastRef = entry.lastReferenced ? new Date(entry.lastReferenced) : null;
+            const created = new Date(entry.created);
+            const relevantDate = lastRef || created;
+            if (relevantDate < sixMonthsAgo && entry.maturity === 'draft') {
+                issues.push({
+                    type: 'outdated',
+                    entryId: entry.id,
+                    severity: 'medium',
+                    description: `条目 ${entry.id} (${entry.title}) 超过 6 个月未引用且为 draft`,
+                    suggestion: '考虑归档或提升成熟度',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * 检查重复/相似条目
+     */
+    checkDuplicates(entries) {
+        const issues = [];
+        const seen = new Map();
+        for (const entry of entries) {
+            if (entry.maturity === 'archived')
+                continue;
+            // 基于 title + type 去重（大小写不敏感）
+            const key = `${entry.type}:${entry.title.toLowerCase().trim()}`;
+            const existing = seen.get(key) || [];
+            existing.push(entry);
+            seen.set(key, existing);
+        }
+        for (const [key, group] of seen) {
+            if (group.length > 1) {
+                for (const entry of group) {
+                    issues.push({
+                        type: 'duplicate',
+                        entryId: entry.id,
+                        severity: 'low',
+                        description: `条目 ${entry.id} (${entry.title}) 与同类型同标题的其他条目重复`,
+                        suggestion: `考虑合并: ${group.map(e => e.id).join(', ')}`,
+                    });
+                }
+            }
+        }
+        return issues;
+    }
+    /**
+     * 检查矛盾（同主题相反结论）
+     *
+     * 简单实现：同 tag 组合下成熟度冲突
+     */
+    checkContradictions(entries) {
+        const issues = [];
+        const byTagGroup = new Map();
+        // 按 tag 组合分组
+        for (const entry of entries) {
+            if (entry.maturity === 'archived')
+                continue;
+            if (entry.tags.length === 0)
+                continue;
+            const tagKey = entry.tags.sort().join(',');
+            const existing = byTagGroup.get(tagKey) || [];
+            existing.push(entry);
+            byTagGroup.set(tagKey, existing);
+        }
+        // 检查同 tag 组合内是否有成熟度差异大的条目
+        for (const [tagKey, group] of byTagGroup) {
+            if (group.length < 2)
+                continue;
+            const maturityOrder = ['draft', 'verified', 'proven'];
+            const levels = group.map(e => maturityOrder.indexOf(e.maturity));
+            const maxLevel = Math.max(...levels);
+            const minLevel = Math.min(...levels);
+            // 成熟度差异 >= 2 级（如 proven vs draft）
+            if (maxLevel - minLevel >= 2) {
+                const lowEntries = group.filter((_, i) => levels[i] === minLevel);
+                for (const entry of lowEntries) {
+                    issues.push({
+                        type: 'contradiction',
+                        entryId: entry.id,
+                        severity: 'high',
+                        description: `条目 ${entry.id} (${entry.title}) 与同标签的高成熟度条目存在潜在矛盾`,
+                        suggestion: `审查标签 [${tagKey}] 下的所有条目，确认或更新`,
+                    });
+                }
+            }
+        }
+        return issues;
+    }
+    /**
+     * 自动修复可修复的问题
+     */
+    autoFix(issues) {
+        let fixed = 0;
+        for (const issue of issues) {
+            if (issue.type === 'index_inconsistent') {
+                this.store.rebuildIndex();
+                fixed++;
+                break; // rebuildIndex 修复所有索引问题
+            }
+            if (issue.type === 'outdated' && issue.entryId) {
+                this.store.update(issue.entryId, { maturity: 'archived' });
+                fixed++;
+            }
+        }
+        return fixed;
+    }
+}
+exports.KnowledgeLinter = KnowledgeLinter;
+//# sourceMappingURL=lint.js.map

package/dist/knowledge/lint.js.map

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

package/dist/knowledge/query.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Knowledge Query Engine
+ *
+ * Budget-aware query layer over KnowledgeStore.
+ * Supports filtering, sorting by maturity, and result caching.
+ */
+import type { QueryBudget, QueryResult, QueryFilter } from './types';
+import { KnowledgeStore } from './store';
+export declare class KnowledgeQuery {
+    private store;
+    private cache;
+    constructor(store: KnowledgeStore);
+    /**
+     * Query knowledge entries within a token budget.
+     *
+     * - Filters by budget.focusTypes (and optional extra filter)
+     * - Sorts: maturity desc → lastReferenced desc
+     * - Truncates to budget.maxEntries and budget.maxTokens
+     * - Caches results per phase+budget key (TTL 5 min)
+     */
+    query(budget: QueryBudget, filter?: QueryFilter): QueryResult;
+    /**
+     * Estimate token count for a piece of text.
+     * Rule of thumb: 1 CJK char ≈ 2 tokens, 1 ASCII char ≈ 0.25 tokens.
+     */
+    estimateTokens(text: string): number;
+    /** Clear the query cache. */
+    clearCache(): void;
+    private sortEntries;
+    private applyBudget;
+    private cacheKey;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/knowledge/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/knowledge/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAKV,WAAW,EACX,WAAW,EACX,WAAW,EAEZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAqBzC,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,KAAK,CAAiC;gBAElC,KAAK,EAAE,cAAc;IAIjC;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW;IAuB7D;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAapC,6BAA6B;IAC7B,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/knowledge/query.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Knowledge Query Engine
+ *
+ * Budget-aware query layer over KnowledgeStore.
+ * Supports filtering, sorting by maturity, and result caching.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeQuery = void 0;
+// ── Constants ──────────────────────────────────────────────
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+const MATURITY_RANK = {
+    proven: 3,
+    verified: 2,
+    draft: 1,
+    archived: 0,
+};
+// ── Query Engine ───────────────────────────────────────────
+class KnowledgeQuery {
+    store;
+    cache = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * Query knowledge entries within a token budget.
+     *
+     * - Filters by budget.focusTypes (and optional extra filter)
+     * - Sorts: maturity desc → lastReferenced desc
+     * - Truncates to budget.maxEntries and budget.maxTokens
+     * - Caches results per phase+budget key (TTL 5 min)
+     */
+    query(budget, filter) {
+        const cacheKey = this.cacheKey(budget, filter);
+        const cached = this.cache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+            return { ...cached.result, fromCache: true };
+        }
+        // Merge focusTypes from budget into filter
+        const mergedFilter = {
+            ...filter,
+            types: budget.focusTypes.length > 0 ? budget.focusTypes : filter?.types,
+            excludeArchived: filter?.excludeArchived ?? true,
+        };
+        const candidates = this.store.list(mergedFilter);
+        const sorted = this.sortEntries(candidates);
+        const { entries, tokensUsed, truncated } = this.applyBudget(sorted, budget);
+        const result = { entries, tokensUsed, truncated, fromCache: false };
+        this.cache.set(cacheKey, { result, timestamp: Date.now() });
+        return result;
+    }
+    /**
+     * Estimate token count for a piece of text.
+     * Rule of thumb: 1 CJK char ≈ 2 tokens, 1 ASCII char ≈ 0.25 tokens.
+     */
+    estimateTokens(text) {
+        let tokens = 0;
+        for (const ch of text) {
+            // CJK Unified Ideographs + common CJK ranges
+            if (/[一-鿿㐀-䶿豈-﫿]/.test(ch)) {
+                tokens += 2;
+            }
+            else {
+                tokens += 0.25;
+            }
+        }
+        return Math.ceil(tokens);
+    }
+    /** Clear the query cache. */
+    clearCache() {
+        this.cache.clear();
+    }
+    // ── Internal ───────────────────────────────────────────────
+    sortEntries(entries) {
+        return [...entries].sort((a, b) => {
+            // Primary: maturity descending
+            const maturityDiff = MATURITY_RANK[b.maturity] - MATURITY_RANK[a.maturity];
+            if (maturityDiff !== 0)
+                return maturityDiff;
+            // Secondary: lastReferenced descending (most recently used first)
+            return (b.lastReferenced || '').localeCompare(a.lastReferenced || '');
+        });
+    }
+    applyBudget(entries, budget) {
+        const result = [];
+        let tokensUsed = 0;
+        for (const entry of entries) {
+            if (result.length >= budget.maxEntries)
+                break;
+            const entryTokens = this.estimateTokens(entry.content) + this.estimateTokens(entry.title);
+            if (tokensUsed + entryTokens > budget.maxTokens)
+                break;
+            result.push(entry);
+            tokensUsed += entryTokens;
+        }
+        return {
+            entries: result,
+            tokensUsed,
+            truncated: result.length < entries.length,
+        };
+    }
+    cacheKey(budget, filter) {
+        return JSON.stringify({ budget, filter });
+    }
+}
+exports.KnowledgeQuery = KnowledgeQuery;
+//# sourceMappingURL=query.js.map

package/dist/knowledge/query.js.map

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

package/dist/knowledge/reference-tracker.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Reference Tracker
+ *
+ * Tracks which decisions reference which knowledge entries.
+ * Storage: append-only JSONL at .harness/knowledge/references.jsonl
+ */
+import { KnowledgeStore } from './store';
+export declare class ReferenceTracker {
+    private filePath;
+    private store;
+    constructor(store: KnowledgeStore, baseDir?: string);
+    /**
+     * Record that a decision referenced a set of knowledge entries.
+     */
+    record(decisionId: string, entryIds: string[]): void;
+    /**
+     * Get all decision IDs that referenced a given entry.
+     */
+    getReferencesForEntry(entryId: string): string[];
+    /**
+     * Get all entry IDs referenced by a given decision.
+     */
+    getReferencesForDecision(decisionId: string): string[];
+    /**
+     * Batch-update referencedBy fields on all knowledge entries.
+     * Scans all reference records and populates entry.referencedBy.
+     */
+    updateReferencedBy(): void;
+    private readAll;
+}
+//# sourceMappingURL=reference-tracker.d.ts.map

package/dist/knowledge/reference-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-tracker.d.ts","sourceRoot":"","sources":["../../src/knowledge/reference-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAMzC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAiB;gBAElB,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM;IAMnD;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IASpD;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAOhD;;OAEG;IACH,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAMtD;;;OAGG;IACH,kBAAkB,IAAI,IAAI;IAyB1B,OAAO,CAAC,OAAO;CAYhB"}

package/dist/knowledge/reference-tracker.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Reference Tracker
+ *
+ * Tracks which decisions reference which knowledge entries.
+ * Storage: append-only JSONL at .harness/knowledge/references.jsonl
+ */
+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.ReferenceTracker = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const REFERENCES_FILE = 'references.jsonl';
+// ── Reference Tracker ──────────────────────────────────────
+class ReferenceTracker {
+    filePath;
+    store;
+    constructor(store, baseDir) {
+        const dir = baseDir || '.harness/knowledge';
+        this.filePath = path.join(dir, REFERENCES_FILE);
+        this.store = store;
+    }
+    /**
+     * Record that a decision referenced a set of knowledge entries.
+     */
+    record(decisionId, entryIds) {
+        const record = {
+            decisionId,
+            entryIds,
+            timestamp: new Date().toISOString(),
+        };
+        fs.appendFileSync(this.filePath, JSON.stringify(record) + '\n', 'utf-8');
+    }
+    /**
+     * Get all decision IDs that referenced a given entry.
+     */
+    getReferencesForEntry(entryId) {
+        const records = this.readAll();
+        return records
+            .filter(r => r.entryIds.includes(entryId))
+            .map(r => r.decisionId);
+    }
+    /**
+     * Get all entry IDs referenced by a given decision.
+     */
+    getReferencesForDecision(decisionId) {
+        const records = this.readAll();
+        const record = records.find(r => r.decisionId === decisionId);
+        return record ? record.entryIds : [];
+    }
+    /**
+     * Batch-update referencedBy fields on all knowledge entries.
+     * Scans all reference records and populates entry.referencedBy.
+     */
+    updateReferencedBy() {
+        const records = this.readAll();
+        const entryToDecisions = new Map();
+        for (const record of records) {
+            for (const entryId of record.entryIds) {
+                if (!entryToDecisions.has(entryId)) {
+                    entryToDecisions.set(entryId, new Set());
+                }
+                entryToDecisions.get(entryId).add(record.decisionId);
+            }
+        }
+        for (const [entryId, decisions] of entryToDecisions) {
+            const entry = this.store.get(entryId);
+            if (entry) {
+                this.store.update(entryId, {
+                    referencedBy: [...decisions],
+                });
+            }
+        }
+    }
+    // ── Internal ───────────────────────────────────────────────
+    readAll() {
+        if (!fs.existsSync(this.filePath))
+            return [];
+        try {
+            const raw = fs.readFileSync(this.filePath, 'utf-8');
+            return raw
+                .split('\n')
+                .filter(line => line.trim())
+                .map(line => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+exports.ReferenceTracker = ReferenceTracker;
+//# sourceMappingURL=reference-tracker.js.map

package/dist/knowledge/reference-tracker.js.map

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

package/dist/knowledge/store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Knowledge Store
+ *
+ * File-based storage for knowledge entries.
+ * Each entry is a markdown file with YAML frontmatter.
+ * An index.json provides fast listing without reading all files.
+ */
+import type { KnowledgeEntry, QueryFilter } from './types';
+interface StoreConfig {
+    baseDir: string;
+}
+export declare class KnowledgeStore {
+    private baseDir;
+    constructor(config?: Partial<StoreConfig>);
+    get(id: string): KnowledgeEntry | undefined;
+    list(filter?: QueryFilter): KnowledgeEntry[];
+    save(entry: KnowledgeEntry): void;
+    delete(id: string): boolean;
+    update(id: string, partial: Partial<KnowledgeEntry>): KnowledgeEntry | undefined;
+    rebuildIndex(): void;
+    /**
+     * 从磁盘读取所有条目（不依赖索引）
+     * 用于 Lint 检查索引一致性
+     */
+    readEntriesFromDisk(): KnowledgeEntry[];
+    private ensureDirectory;
+    private entryPath;
+    private findFile;
+    private listFiles;
+    private readFile;
+    private parseFile;
+    private toFrontmatter;
+    private toIndexEntry;
+    private indexToEntry;
+    private matchesFilter;
+    private readIndex;
+    private writeIndex;
+    private updateIndexEntry;
+    private removeFromIndex;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/knowledge/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAc,WAAW,EAAgB,MAAM,SAAS,CAAC;AAKrF,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAOzC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAM3C,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,EAAE;IAW5C,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAQjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ3B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,GAAG,SAAS;IAUhF,YAAY,IAAI,IAAI;IAYpB;;;OAGG;IACH,mBAAmB,IAAI,cAAc,EAAE;IAcvC,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,eAAe;CAIxB"}