@co-engram/core 0.1.0

package/dist/dreaming/trash.js

@@ -0,0 +1,466 @@
+/**
+ * 记忆回收站（Trash Sweep）
+ *
+ * 神经科学类比：遗忘不等于物理销毁——已被"遗忘"的突触在一段时间内仍可被找回。
+ * 此模块把"已 forgotten 超过 N 天"的 engram 从主索引物理移动到 `.trash/YYYY-MM/`，
+ * 既给了恢复窗口,又降低了 FTS / 图遍历对陈旧数据的扫描成本。
+ *
+ * 设计约束：
+ *   - 文件系统操作：rename / mkdir。优先 git mv（若仓库为 git 仓库）,否则退化为 fs.rename。
+ *   - 不动 synapse 引用：允许 dangling（其他 engram 仍可能指向被回收的 id）。
+ *     这是有意的：未来若 restore,引用自动恢复有效。
+ *   - purge（物理删除）独立阶段,默认 365 天后才删,且需要显式开启。
+ *   - engram 是单文件 (.md),移动一个文件即可;同时更新 engram-index.json
+ *     以保证主索引不再列出已回收的条目。
+ *
+ * 时间戳策略：
+ *   使用 engram 文件的 mtime 作为"最后被触碰时刻"的近似。
+ *   原因：forgotten 状态切换走 `updateLifecycle`,不写 updatedAt；mtime 是最接近真相的信号。
+ *   已知缺陷：任何对文件的写入都会刷新 mtime。对 forgotten engram 来说,这种写入很少发生,
+ *   所以近似在 90%+ 场景下是准确的。后续如需精确,可加 `forgottenAt` 字段。
+ *
+ * @module @co-engram/core/dreaming
+ */
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, renameSync, rmSync, statSync, } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { isGitRepo } from "../storage/git.js";
+import { readEngramFile } from "../storage/engram-store.js";
+import { slugify } from "../types/slugify.js";
+/** Trash 根目录名（相对仓库根） */
+export const TRASH_DIR_NAME = ".trash";
+/** 默认进入回收站阈值：forgotten 后 30 天 */
+export const DEFAULT_TRASH_AFTER_DAYS = 30;
+/** 默认物理删除阈值：进入回收站后 365 天 */
+export const DEFAULT_TRASH_PURGE_AFTER_DAYS = 365;
+/**
+ * 计算某个月份分区名（YYYY-MM）
+ *
+ * 使用 UTC 以避免本地时区在跨日边界的不一致。
+ */
+export function formatTrashPartition(date) {
+    const y = date.getUTCFullYear();
+    const m = String(date.getUTCMonth() + 1).padStart(2, "0");
+    return `${y}-${m}`;
+}
+/**
+ * 计算 engram 在 trash 分区下的相对路径
+ *
+ * 输入：原 engram 相对路径（如 "testing/adb/foo.md"）,分区名 "2026-06"
+ * 输出：".trash/2026-06/testing/adb/foo.md"
+ *
+ * 注：trash 下不再分 content/meta/synapses 子目录（单文件布局）。
+ */
+export function deriveTrashFilePath(relativePath, partition) {
+    return `${TRASH_DIR_NAME}/${partition}/${relativePath}`;
+}
+/** 旧版三路径 API（兼容调用方/测试）：派生 trash 下的镜像路径 */
+export function deriveTrashFilePaths(relativePath, partition) {
+    const base = `${TRASH_DIR_NAME}/${partition}`;
+    const fileBase = relativePath.replace(/\.md$/, "");
+    return {
+        content: `${base}/engrams/content/${fileBase}.md`,
+        meta: `${base}/engrams/meta/${fileBase}.yaml`,
+        synapses: `${base}/engrams/synapses/${fileBase}.yaml`,
+    };
+}
+/**
+ * 执行 trash sweep
+ *
+ * 流程：
+ *   1. 扫描所有 engram,过滤出 status=forgotten
+ *   2. 对每个 forgotten engram,读文件 mtime,判断是否 ≥ afterDays
+ *   3. 满足条件 → 计算分区（按当前时间）→ 移动单文件到 .trash/<partition>/<relativePath>
+ *   4. （可选）扫描 .trash/ 中已存在且 ≥ purgeAfterDays 的分区,物理删除
+ *
+ * 安全保证：
+ *   - 目标路径已存在时跳过（避免覆盖）
+ *   - 移动失败时记录到 skipped,不抛
+ */
+export function sweepToTrash(repo, options = {}) {
+    const now = options.nowIso ? new Date(options.nowIso) : new Date();
+    const afterDays = options.afterDays ?? DEFAULT_TRASH_AFTER_DAYS;
+    const purgeAfterDays = options.purgeAfterDays ?? DEFAULT_TRASH_PURGE_AFTER_DAYS;
+    const dryRun = options.dryRun ?? false;
+    const thresholdMs = afterDays * 24 * 60 * 60 * 1000;
+    const purgeMs = purgeAfterDays > 0
+        ? purgeAfterDays * 24 * 60 * 60 * 1000
+        : Number.POSITIVE_INFINITY;
+    const trashed = [];
+    const skipped = [];
+    let scanned = 0;
+    // === 阶段 1: forgotten → trash ===
+    const entries = [...repo.listEngramIndex()].sort((a, b) => a.id < b.id ? -1 : 1);
+    for (const entry of entries) {
+        const engram = repo.readEngram(entry.id);
+        if (engram.status !== "forgotten")
+            continue;
+        scanned += 1;
+        const fileAbs = join(repo.rootPath, entry.path);
+        if (!existsSync(fileAbs)) {
+            skipped.push({ id: engram.id, reason: "engram file missing" });
+            continue;
+        }
+        const mtime = statSync(fileAbs).mtimeMs;
+        const ageMs = now.getTime() - mtime;
+        if (ageMs < thresholdMs) {
+            skipped.push({
+                id: engram.id,
+                reason: `only ${Math.floor(ageMs / (24 * 60 * 60 * 1000))} days old (< ${afterDays})`,
+            });
+            continue;
+        }
+        if (!dryRun) {
+            const moved = moveEngramFileToTrash(repo, engram.id, entry.path, formatTrashPartition(now));
+            if (!moved.ok) {
+                skipped.push({ id: engram.id, reason: moved.reason });
+                continue;
+            }
+        }
+        trashed.push(engram.id);
+        options.auditLog?.append({
+            actor: "system",
+            action: "sweep_to_trash",
+            engramId: engram.id,
+            metadata: { partition: formatTrashPartition(now) },
+        });
+    }
+    // === 阶段 2: purge expired trash ===
+    const purged = dryRun
+        ? []
+        : purgeExpiredTrash(repo, now, purgeMs, options.auditLog);
+    return { scanned, trashed, purged, skipped };
+}
+/** 内部：物理移动单个 engram 文件到 trash 分区 */
+function moveEngramFileToTrash(repo, engramId, relativePath, partition) {
+    const srcRel = relativePath;
+    const dstRel = deriveTrashFilePath(srcRel, partition);
+    const srcAbs = join(repo.rootPath, srcRel);
+    const dstAbs = join(repo.rootPath, dstRel);
+    if (!existsSync(srcAbs)) {
+        return { ok: false, reason: `source missing: ${srcRel}` };
+    }
+    if (existsSync(dstAbs)) {
+        return { ok: false, reason: `destination exists: ${dstRel}` };
+    }
+    mkdirSync(dirname(dstAbs), { recursive: true });
+    const useGit = isGitRepo(repo.rootPath);
+    try {
+        if (useGit) {
+            try {
+                execSync(`git mv "${srcRel}" "${dstRel}"`, {
+                    cwd: repo.rootPath,
+                    stdio: "ignore",
+                });
+            }
+            catch {
+                renameSync(srcAbs, dstAbs);
+            }
+        }
+        else {
+            renameSync(srcAbs, dstAbs);
+        }
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // 移除 engram-index 中的条目（保证主索引不再列出已回收的 id）
+    repo.deleteEngram(engramId);
+    // deleteEngram 也会尝试删文件——但文件已被移走,所以是 no-op;主要靠它清理 index + dangling synapses
+    return { ok: true };
+}
+/**
+ * 扫描 .trash/,删除超过 purgeMs 的分区
+ *
+ * 粗粒度策略：以"分区（月份）"为单位删除,而非单文件。
+ * 好处：单次操作 O(月份数),避免遍历每个文件 mtime。
+ * 缺点：可能删除略早于阈值的文件（最多 31 天误差）。
+ */
+function purgeExpiredTrash(repo, now, purgeMs, auditLog) {
+    const trashRoot = join(repo.rootPath, TRASH_DIR_NAME);
+    if (!existsSync(trashRoot))
+        return [];
+    const purged = [];
+    const partitions = readdirSync(trashRoot, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && /^\d{4}-\d{2}$/.test(d.name))
+        .map((d) => d.name)
+        .sort();
+    for (const partition of partitions) {
+        const partPath = join(trashRoot, partition);
+        const partMtime = statSync(partPath).mtimeMs;
+        const ageMs = now.getTime() - partMtime;
+        if (ageMs < purgeMs)
+            continue;
+        const engramIds = collectEngramIdsInPartition(partPath);
+        purged.push(...engramIds);
+        rmSync(partPath, { recursive: true, force: true });
+        for (const id of engramIds) {
+            auditLog?.append({
+                actor: "system",
+                action: "purge",
+                engramId: id,
+                metadata: { partition },
+            });
+        }
+    }
+    return purged;
+}
+/** 扫描分区目录,提取所有 engram id（从 frontmatter 读取,去重） */
+function collectEngramIdsInPartition(partitionAbsPath) {
+    const ids = new Set();
+    const walk = (dir) => {
+        let items;
+        try {
+            items = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const item of items) {
+            const full = join(dir, item.name);
+            if (item.isDirectory()) {
+                walk(full);
+            }
+            else if (item.isFile() && item.name.endsWith(".md")) {
+                try {
+                    const parsed = readEngramFile(full);
+                    if (parsed?.frontmatter?.id)
+                        ids.add(parsed.frontmatter.id);
+                }
+                catch {
+                    // 非 engram 文件,跳过
+                }
+            }
+        }
+    };
+    walk(partitionAbsPath);
+    return [...ids].sort();
+}
+export function listTrashed(repo) {
+    const trashRoot = join(repo.rootPath, TRASH_DIR_NAME);
+    if (!existsSync(trashRoot))
+        return [];
+    const out = [];
+    const partitions = readdirSync(trashRoot, { withFileTypes: true }).filter((d) => d.isDirectory() && /^\d{4}-\d{2}$/.test(d.name));
+    for (const part of partitions) {
+        const partPath = join(trashRoot, part.name);
+        const partMtime = statSync(partPath).mtime.toISOString();
+        const walk = (dir) => {
+            const items = readdirSync(dir, { withFileTypes: true });
+            for (const item of items) {
+                const full = join(dir, item.name);
+                if (item.isDirectory()) {
+                    walk(full);
+                }
+                else if (item.isFile() && item.name.endsWith(".md")) {
+                    try {
+                        const parsed = readEngramFile(full);
+                        const id = parsed?.frontmatter?.id;
+                        if (id) {
+                            out.push({
+                                id,
+                                partition: part.name,
+                                contentPath: full,
+                                trashedAt: partMtime,
+                            });
+                        }
+                    }
+                    catch {
+                        // skip
+                    }
+                }
+            }
+        };
+        walk(partPath);
+    }
+    return out.sort((a, b) => (a.id < b.id ? -1 : 1));
+}
+/**
+ * 在 trash 中查找指定 id 的 engram
+ */
+export function findTrashed(repo, engramId) {
+    const all = listTrashed(repo);
+    return all.find((t) => t.id === engramId) ?? null;
+}
+/**
+ * 一键清空回收站(永久删除)
+ *
+ * 与 sweepToTrash 内部的 purgeExpiredTrash 不同,本函数:
+ *   - 不按时间过滤,而是清掉所有(或指定 partition)的 trashed engram
+ *   - 由用户在 UI 显式触发,审计日志记 actor='user'(非 system)
+ *   - 同步审计:每条删除写一条 action='purge' 审计
+ *
+ * 安全策略:
+ *   - dryRun=true 时只计算 purged id,不真正删除
+ *   - partition 未传 → 清所有分区
+ *   - partition 传入但不存在 → 返回空(不抛)
+ *
+ * @returns purged id 列表(按字典序)
+ */
+export function purgeAllTrash(repo, options = {}) {
+    const trashRoot = join(repo.rootPath, TRASH_DIR_NAME);
+    if (!existsSync(trashRoot)) {
+        return { purged: [], partitionsRemoved: [] };
+    }
+    const targetPartitions = options.partition
+        ? [options.partition]
+        : readdirSync(trashRoot, { withFileTypes: true })
+            .filter((d) => d.isDirectory() && /^\d{4}-\d{2}$/.test(d.name))
+            .map((d) => d.name)
+            .sort();
+    const actor = options.actor ?? "user";
+    const purged = [];
+    const partitionsRemoved = [];
+    for (const partition of targetPartitions) {
+        const partPath = join(trashRoot, partition);
+        if (!existsSync(partPath))
+            continue;
+        const ids = collectEngramIdsInPartition(partPath);
+        purged.push(...ids);
+        if (!options.dryRun) {
+            rmSync(partPath, { recursive: true, force: true });
+            partitionsRemoved.push(partition);
+            for (const id of ids) {
+                options.auditLog?.append({
+                    actor,
+                    action: "purge",
+                    engramId: id,
+                    metadata: { partition, source: "purge_all" },
+                });
+            }
+        }
+    }
+    return {
+        purged: [...new Set(purged)].sort(),
+        partitionsRemoved: partitionsRemoved.sort(),
+    };
+}
+/**
+ * 读取 trash 中某个 engram 的完整内容(供 UI 预览)
+ *
+ * 返回 frontmatter + body,以及 partition / trashedAt 元信息。
+ * 不存在时返回 null(由调用方决定 404)。
+ */
+export function readTrashed(repo, engramId) {
+    const found = findTrashed(repo, engramId);
+    if (!found)
+        return null;
+    let parsed = null;
+    try {
+        parsed = readEngramFile(found.contentPath);
+    }
+    catch {
+        return null;
+    }
+    return {
+        id: found.id,
+        partition: found.partition,
+        trashedAt: found.trashedAt,
+        frontmatter: parsed.frontmatter,
+        content: parsed.content,
+        contentPath: found.contentPath,
+    };
+}
+/**
+ * 从 trash 恢复 engram：物理移回原位 + status 切回 active
+ *
+ * 流程：
+ *   1. 在 .trash/ 中查找 id（可能跨多个分区）
+ *   2. 把单文件移回 <root>/<originalRelativePath>
+ *   3. repo.updateLifecycle(id, 'active', 'fresh') 重置检索状态
+ *
+ * 不抛：找不到返回 { ok: false, reason }。
+ */
+export function restoreFromTrash(repo, engramId, options = {}) {
+    const found = findTrashed(repo, engramId);
+    if (!found) {
+        return { ok: false, reason: `not found in trash: ${engramId}` };
+    }
+    // 从 trash 中的 frontmatter 读取原始 domainTags 来推断路径
+    let parsed;
+    try {
+        parsed = readEngramFile(found.contentPath);
+    }
+    catch {
+        return { ok: false, reason: "cannot parse trashed file" };
+    }
+    // 目标路径：恢复到 deriveDefaultPath（domainTags + slug）
+    const slug = parsed.frontmatter.slug ?? slugify(parsed.frontmatter.title);
+    const domains = parsed.frontmatter.domainTags ?? [];
+    const dstRel = domains.length === 0 ? `${slug}.md` : `${domains.join("/")}/${slug}.md`;
+    const srcAbs = found.contentPath;
+    const dstAbs = join(repo.rootPath, dstRel);
+    if (existsSync(dstAbs)) {
+        return { ok: false, reason: `target exists in active area: ${dstRel}` };
+    }
+    mkdirSync(dirname(dstAbs), { recursive: true });
+    const useGit = isGitRepo(repo.rootPath);
+    const srcRel = relative(repo.rootPath, srcAbs);
+    try {
+        if (useGit) {
+            try {
+                execSync(`git mv "${srcRel}" "${dstRel}"`, {
+                    cwd: repo.rootPath,
+                    stdio: "ignore",
+                });
+            }
+            catch {
+                renameSync(srcAbs, dstAbs);
+            }
+        }
+        else {
+            renameSync(srcAbs, dstAbs);
+        }
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // 触发 index 重建,使主索引重新列出该 engram
+    repo.rebuildIndex();
+    // 状态重置：forgotten → active;freshness 重新计算由调用方/检索期决定,这里先置 fresh
+    repo.updateLifecycle(engramId, "active", "fresh");
+    // 清理空分区目录（best-effort,不抛）
+    cleanupEmptyPartition(repo, found.partition);
+    options.auditLog?.append({
+        actor: "system",
+        action: "restore_from_trash",
+        engramId,
+        metadata: { partition: found.partition },
+    });
+    return { ok: true };
+}
+/** 清理空分区目录（best-effort） */
+function cleanupEmptyPartition(repo, partition) {
+    const partPath = join(repo.rootPath, TRASH_DIR_NAME, partition);
+    if (!existsSync(partPath))
+        return;
+    try {
+        const isEmpty = (dir) => {
+            const items = readdirSync(dir, { withFileTypes: true });
+            for (const item of items) {
+                const full = join(dir, item.name);
+                if (item.isDirectory()) {
+                    if (!isEmpty(full))
+                        return false;
+                }
+                else {
+                    return false;
+                }
+            }
+            return true;
+        };
+        if (isEmpty(partPath)) {
+            rmSync(partPath, { recursive: true, force: true });
+        }
+    }
+    catch {
+        // ignore — 留下空目录无害
+    }
+}
+//# sourceMappingURL=trash.js.map

package/dist/dreaming/trash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.js","sourceRoot":"","sources":["../../src/dreaming/trash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,MAAM,EACN,QAAQ,GAET,MAAM,SAAS,CAAC;AACjB,OAAO,EAAY,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA6B9C,wBAAwB;AACxB,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,iCAAiC;AACjC,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,4BAA4B;AAC5B,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAU;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACrB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,SAAiB;IAEjB,OAAO,GAAG,cAAc,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;AAC1D,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,SAAiB;IAEjB,MAAM,IAAI,GAAG,GAAG,cAAc,IAAI,SAAS,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO;QACL,OAAO,EAAE,GAAG,IAAI,oBAAoB,QAAQ,KAAK;QACjD,IAAI,EAAE,GAAG,IAAI,iBAAiB,QAAQ,OAAO;QAC7C,QAAQ,EAAE,GAAG,IAAI,qBAAqB,QAAQ,OAAO;KACtD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAsB,EACtB,UAAwB,EAAE;IAE1B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,wBAAwB,CAAC;IAChE,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc,IAAI,8BAA8B,CAAC;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IAEvC,MAAM,WAAW,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACpD,MAAM,OAAO,GACX,cAAc,GAAG,CAAC;QAChB,CAAC,CAAC,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QACtC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAE/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAA0C,EAAE,CAAC;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,kCAAkC;IAClC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxD,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACrB,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QAC5C,OAAO,IAAI,CAAC,CAAC;QAEb,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC;QACpC,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,gBAAgB,SAAS,GAAG;aACtF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,qBAAqB,CACjC,IAAI,EACJ,MAAM,CAAC,EAAE,EACT,KAAK,CAAC,IAAI,EACV,oBAAoB,CAAC,GAAG,CAAC,CAC1B,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtD,SAAS;YACX,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;YACvB,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,gBAAgB;YACxB,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,QAAQ,EAAE,EAAE,SAAS,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAAE;SACnD,CAAC,CAAC;IACL,CAAC;IAED,oCAAoC;IACpC,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,oCAAoC;AACpC,SAAS,qBAAqB,CAC5B,IAAsB,EACtB,QAAgB,EAChB,YAAoB,EACpB,SAAiB;IAEjB,MAAM,MAAM,GAAG,YAAY,CAAC;IAC5B,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE3C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,MAAM,EAAE,EAAE,CAAC;IAChE,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,GAAG,EAAE;oBACzC,GAAG,EAAE,IAAI,CAAC,QAAQ;oBAClB,KAAK,EAAE,QAAQ;iBAChB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC5B,2EAA2E;IAC3E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CACxB,IAAsB,EACtB,GAAS,EACT,OAAe,EACf,QAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC/D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,KAAK,GAAG,OAAO;YAAE,SAAS;QAE9B,MAAM,SAAS,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAE1B,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,QAAQ,EAAE,MAAM,CAAC;gBACf,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,EAAE;gBACZ,QAAQ,EAAE,EAAE,SAAS,EAAE;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iDAAiD;AACjD,SAAS,2BAA2B,CAAC,gBAAwB;IAC3D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;oBACpC,IAAI,MAAM,EAAE,WAAW,EAAE,EAAE;wBAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBAAC,MAAM,CAAC;oBACP,iBAAiB;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAkBD,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CACvE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CACvD,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAEzD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;YACjC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACb,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACtD,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;wBACpC,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;wBACnC,IAAI,EAAE,EAAE,CAAC;4BACP,GAAG,CAAC,IAAI,CAAC;gCACP,EAAE;gCACF,SAAS,EAAE,IAAI,CAAC,IAAI;gCACpB,WAAW,EAAE,IAAI;gCACjB,SAAS,EAAE,SAAS;6BACrB,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsB,EACtB,QAAgB;IAEhB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAsB,EACtB,UASI,EAAE;IAEN,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS;QACxC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,EAAE,CAAC;IAEd,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,iBAAiB,GAAa,EAAE,CAAC;IAEvC,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QAEpC,MAAM,GAAG,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QAEpB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAElC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;oBACvB,KAAK;oBACL,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,EAAE;oBACZ,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE;QACnC,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsB,EACtB,QAAgB;IAShB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,MAAM,GACR,IAAI,CAAC;IACP,IAAI,CAAC;QACH,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,WAAW,CAGxC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAsB,EACtB,QAAgB,EAChB,UAA4C,EAAE;IAE9C,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,QAAQ,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,+CAA+C;IAC/C,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAC5D,CAAC;IAED,gDAAgD;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC;IACpD,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC;IAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE3C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,MAAM,EAAE,EAAE,CAAC;IAC1E,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,GAAG,EAAE;oBACzC,GAAG,EAAE,IAAI,CAAC,QAAQ;oBAClB,KAAK,EAAE,QAAQ;iBAChB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,YAAY,EAAE,CAAC;IAEpB,8DAA8D;IAC9D,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAElD,0BAA0B;IAC1B,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAE7C,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,oBAAoB;QAC5B,QAAQ;QACR,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;KACzC,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,2BAA2B;AAC3B,SAAS,qBAAqB,CAC5B,IAAsB,EACtB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAClC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,GAAW,EAAW,EAAE;YACvC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;wBAAE,OAAO,KAAK,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QACF,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;AACH,CAAC"}

package/dist/evolution/category.d.ts

@@ -0,0 +1,127 @@
+/**
+ * 类别进化（spec §5.1 进化链 + §3.2 CategoryEvolutionTrail）
+ *
+ * 进化路径：
+ *   observation → fact → pattern → procedure → (skill suggest → skill auto)
+ *
+ * 触发条件：
+ *   - observation → fact: evidenceCount ≥ 阈值（多次独立验证）
+ *   - fact → pattern: 跨情境抽象（REM 做梦触发，kind 已是 pattern 不重复升级）
+ *   - pattern → procedure: 高 effectiveRetrievals + 显式流程化标记
+ *   - procedure → skill: 由 Skill 系统处理（不在本模块）
+ *
+ * Trail 记录：
+ *   - originalKind（创建时的 kind）
+ *   - currentKind（当前 kind）
+ *   - transitions: [{ from, to, at, evidence, reason }]
+ *
+ * 多标签 kinds：
+ *   - 同一 engram 可以同时属于多个 kind（如 ['fact', 'pattern']）
+ *   - primary kind 决定 UI 颜色，secondary kinds 作为补充
+ *
+ * @module @co-engram/core/evolution
+ */
+import type { EngramKind } from "../types/engram.js";
+import type { EngramRepository } from "../storage/repository.js";
+/** 完整进化链顺序（spec §5.1） */
+export declare const EVOLUTION_CHAIN: readonly EngramKind[];
+/** 升级合法性表（A → B 是否允许） */
+export interface AllowedUpgrade {
+    readonly from: EngramKind;
+    readonly to: EngramKind;
+}
+export declare const ALLOWED_UPGRADES: readonly AllowedUpgrade[];
+export interface CategoryTransition {
+    readonly from: EngramKind;
+    readonly to: EngramKind;
+    readonly at: string;
+    readonly reason: string;
+    /** 触发证据（如 "evidenceCount=5", "REM dream cluster"） */
+    readonly evidence: string;
+    readonly upgradedBy: string;
+}
+export interface CategoryEvolutionTrail {
+    readonly originalKind: EngramKind;
+    readonly currentKind: EngramKind;
+    readonly transitions: readonly CategoryTransition[];
+}
+export interface UpgradeConditions {
+    /** observation → fact 需要的最小 evidenceCount（默认 3） */
+    readonly observationToFactEvidence?: number;
+    /** fact → pattern 需要的最小 effectiveRetrievals（默认 5） */
+    readonly factToPatternEffective?: number;
+    /** pattern → procedure 需要的最小 effectiveRetrievals（默认 10） */
+    readonly patternToProcedureEffective?: number;
+}
+export declare const DEFAULT_UPGRADE_CONDITIONS: UpgradeConditions;
+export interface UpgradeAssessment {
+    readonly canUpgrade: boolean;
+    readonly fromKind: EngramKind;
+    readonly targetKind?: EngramKind;
+    readonly reason: string;
+    /** 满足度（0~1，1=完全满足） */
+    readonly readiness: number;
+}
+/**
+ * 评估当前 engram 是否可以升级
+ */
+export declare function assessUpgrade(engram: {
+    readonly kind: EngramKind;
+    readonly kinds: readonly EngramKind[];
+    readonly effectiveRetrievals: number;
+    readonly retrievalCount: number;
+    readonly incomingSynapseCount: number;
+}, conditions?: UpgradeConditions): UpgradeAssessment;
+export interface UpgradeKindInput {
+    readonly id: string;
+    readonly newKind: EngramKind;
+    readonly reason: string;
+    readonly evidence?: string;
+    readonly upgradedBy: string;
+    /** 是否同时加入 kinds 多标签（默认 true） */
+    readonly keepOldKinds?: boolean;
+    readonly nowIso?: string;
+}
+export interface UpgradeKindResult {
+    readonly id: string;
+    readonly previousKind: EngramKind;
+    readonly newKind: EngramKind;
+    readonly trail: CategoryEvolutionTrail;
+    readonly transition: CategoryTransition;
+}
+/**
+ * 校验升级是否合法（按 ALLOWED_UPGRADES 表）
+ */
+export declare function isUpgradeAllowed(from: EngramKind, to: EngramKind): boolean;
+/**
+ * 手动升级 kind（带 trail 记录）
+ *
+ * 注意：本函数只更新 kind/kinds 字段；trail 持久化需要调用方处理（P2 暂存在内存返回值）。
+ */
+export declare function upgradeEngramKind(repo: EngramRepository, input: UpgradeKindInput): UpgradeKindResult;
+export interface CategoryEvolutionResult {
+    readonly scanned: number;
+    readonly upgraded: ReadonlyArray<{
+        id: string;
+        from: EngramKind;
+        to: EngramKind;
+        reason: string;
+    }>;
+    readonly skipped: ReadonlyArray<{
+        id: string;
+        reason: string;
+    }>;
+}
+/**
+ * 扫描所有 active engram，评估是否满足升级条件
+ *
+ * 注意：高 readiness 但未触发自动升级的会进入 skipped；
+ * 完全满足条件时（canUpgrade=true 且 readiness=1）自动升级。
+ */
+export declare function runCategoryEvolution(repo: EngramRepository, options?: {
+    readonly conditions?: UpgradeConditions;
+    readonly upgradedBy?: string;
+    readonly nowIso?: string;
+    readonly dryRun?: boolean;
+}): CategoryEvolutionResult;
+//# sourceMappingURL=category.d.ts.map

package/dist/evolution/category.d.ts.map

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