@co-engram/core 0.1.0

package/dist/evolution/category.js

@@ -0,0 +1,271 @@
+/**
+ * 类别进化（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
+ */
+// ============================================================
+// 进化链定义
+// ============================================================
+/** 完整进化链顺序（spec §5.1） */
+export const EVOLUTION_CHAIN = [
+    "observation",
+    "fact",
+    "pattern",
+    "procedure",
+    // hypothesis 是旁路（不直接进化为 procedure）
+];
+export const ALLOWED_UPGRADES = [
+    { from: "observation", to: "fact" },
+    { from: "fact", to: "pattern" },
+    { from: "pattern", to: "procedure" },
+    { from: "observation", to: "pattern" }, // 跳级（高置信度时）
+    { from: "observation", to: "procedure" }, // 跳级
+    { from: "fact", to: "procedure" }, // 跳级
+    { from: "hypothesis", to: "fact" }, // 假设验证为事实
+    { from: "hypothesis", to: "pattern" },
+];
+export const DEFAULT_UPGRADE_CONDITIONS = {
+    observationToFactEvidence: 3,
+    factToPatternEffective: 5,
+    patternToProcedureEffective: 10,
+};
+/**
+ * 评估当前 engram 是否可以升级
+ */
+export function assessUpgrade(engram, conditions = DEFAULT_UPGRADE_CONDITIONS) {
+    const currentKind = engram.kind;
+    // hypothesis → fact（如果 evidence 充分）
+    if (currentKind === "hypothesis") {
+        return {
+            canUpgrade: true,
+            fromKind: currentKind,
+            targetKind: "fact",
+            reason: "hypothesis verified",
+            readiness: 1,
+        };
+    }
+    if (currentKind === "observation") {
+        const needed = conditions.observationToFactEvidence ?? 3;
+        // evidenceCount 用 incomingSynapseCount（exemplifies/derives_from 作为证据）
+        const evidenceCount = engram.incomingSynapseCount;
+        if (evidenceCount >= needed) {
+            return {
+                canUpgrade: true,
+                fromKind: currentKind,
+                targetKind: "fact",
+                reason: `evidenceCount=${evidenceCount} ≥ ${needed}`,
+                readiness: Math.min(1, evidenceCount / needed),
+            };
+        }
+        return {
+            canUpgrade: false,
+            fromKind: currentKind,
+            reason: `evidenceCount=${evidenceCount} < ${needed}`,
+            readiness: evidenceCount / needed,
+        };
+    }
+    if (currentKind === "fact") {
+        const needed = conditions.factToPatternEffective ?? 5;
+        if (engram.effectiveRetrievals >= needed) {
+            return {
+                canUpgrade: true,
+                fromKind: currentKind,
+                targetKind: "pattern",
+                reason: `effectiveRetrievals=${engram.effectiveRetrievals} ≥ ${needed}`,
+                readiness: Math.min(1, engram.effectiveRetrievals / needed),
+            };
+        }
+        return {
+            canUpgrade: false,
+            fromKind: currentKind,
+            reason: `effectiveRetrievals=${engram.effectiveRetrievals} < ${needed}`,
+            readiness: engram.effectiveRetrievals / needed,
+        };
+    }
+    if (currentKind === "pattern") {
+        const needed = conditions.patternToProcedureEffective ?? 10;
+        if (engram.effectiveRetrievals >= needed) {
+            return {
+                canUpgrade: true,
+                fromKind: currentKind,
+                targetKind: "procedure",
+                reason: `effectiveRetrievals=${engram.effectiveRetrievals} ≥ ${needed}`,
+                readiness: Math.min(1, engram.effectiveRetrievals / needed),
+            };
+        }
+        return {
+            canUpgrade: false,
+            fromKind: currentKind,
+            reason: `effectiveRetrievals=${engram.effectiveRetrievals} < ${needed}`,
+            readiness: engram.effectiveRetrievals / needed,
+        };
+    }
+    // procedure → skill 不在本模块
+    return {
+        canUpgrade: false,
+        fromKind: currentKind,
+        reason: "已达到本模块进化的最高级（procedure → skill 由 Skill 系统处理）",
+        readiness: 0,
+    };
+}
+/**
+ * 校验升级是否合法（按 ALLOWED_UPGRADES 表）
+ */
+export function isUpgradeAllowed(from, to) {
+    if (from === to)
+        return false;
+    return ALLOWED_UPGRADES.some((u) => u.from === from && u.to === to);
+}
+/**
+ * 手动升级 kind（带 trail 记录）
+ *
+ * 注意：本函数只更新 kind/kinds 字段；trail 持久化需要调用方处理（P2 暂存在内存返回值）。
+ */
+export function upgradeEngramKind(repo, input) {
+    if (!repo.exists(input.id)) {
+        throw new Error(`Engram not found: ${input.id}`);
+    }
+    const old = repo.readEngram(input.id);
+    if (!isUpgradeAllowed(old.kind, input.newKind)) {
+        throw new Error(`Upgrade not allowed: ${old.kind} → ${input.newKind}. Allowed upgrades: see ALLOWED_UPGRADES.`);
+    }
+    const nowIso = input.nowIso ?? new Date().toISOString();
+    const keepOld = input.keepOldKinds ?? true;
+    // 构造新 kinds：newKind 放第一位（repository 用 kinds[0] 作为 kind 字段）
+    const oldKinds = [...old.kinds];
+    const filteredOld = oldKinds.filter((k) => k !== input.newKind);
+    const newKinds = keepOld ? [input.newKind, ...filteredOld] : [input.newKind];
+    repo.updateEngram(input.id, {
+        kinds: newKinds,
+        updatedBy: input.upgradedBy,
+    });
+    const transition = {
+        from: old.kind,
+        to: input.newKind,
+        at: nowIso,
+        reason: input.reason,
+        evidence: input.evidence ?? "manual upgrade",
+        upgradedBy: input.upgradedBy,
+    };
+    // trail 构造（P2 暂不持久化，返回给调用方）
+    const existingTransitions = extractTransitionsFromKinds(oldKinds, old.kind);
+    const trail = {
+        originalKind: existingTransitions[0]?.from ?? old.kind,
+        currentKind: input.newKind,
+        transitions: [...existingTransitions, transition],
+    };
+    return {
+        id: input.id,
+        previousKind: old.kind,
+        newKind: input.newKind,
+        trail,
+        transition,
+    };
+}
+/**
+ * 从 engram.kinds 推断历史 transitions（无持久化时的启发式）
+ *
+ * kinds 数组按"最新在前"保留：[newest, ..., oldest]
+ * 例如 ['pattern', 'fact', 'observation'] → [{observation→fact}, {fact→pattern}]
+ */
+function extractTransitionsFromKinds(kinds, currentKind) {
+    if (kinds.length === 0) {
+        return [];
+    }
+    const result = [];
+    // 从最旧（数组末尾）向最新（数组开头）构造 transition 链
+    for (let i = kinds.length - 1; i > 0; i--) {
+        result.push({
+            from: kinds[i],
+            to: kinds[i - 1],
+            at: "unknown",
+            reason: "inferred from kinds array",
+            evidence: "kinds order",
+            upgradedBy: "unknown",
+        });
+    }
+    // currentKind 与 kinds[0] 不一致时（理论上不应发生，但防御性处理）
+    if (result.length === 0 && currentKind !== kinds[0]) {
+        result.push({
+            from: kinds[0],
+            to: currentKind,
+            at: "unknown",
+            reason: "kind mismatch inferred",
+            evidence: "kind field",
+            upgradedBy: "unknown",
+        });
+    }
+    return result;
+}
+/**
+ * 扫描所有 active engram，评估是否满足升级条件
+ *
+ * 注意：高 readiness 但未触发自动升级的会进入 skipped；
+ * 完全满足条件时（canUpgrade=true 且 readiness=1）自动升级。
+ */
+export function runCategoryEvolution(repo, options = {}) {
+    const conditions = options.conditions ?? DEFAULT_UPGRADE_CONDITIONS;
+    const upgradedBy = options.upgradedBy ?? "category-evolution";
+    const nowIso = options.nowIso ?? new Date().toISOString();
+    const dryRun = options.dryRun ?? false;
+    const upgraded = [];
+    const skipped = [];
+    const entries = [...repo.listEngrams()].sort((a, b) => a.id < b.id ? -1 : 1);
+    let scanned = 0;
+    for (const entry of entries) {
+        const engram = repo.readEngram(entry.id);
+        if (engram.status !== "active")
+            continue;
+        scanned += 1;
+        const assessment = assessUpgrade(engram, conditions);
+        if (!assessment.canUpgrade || !assessment.targetKind) {
+            skipped.push({ id: engram.id, reason: assessment.reason });
+            continue;
+        }
+        if (!dryRun) {
+            try {
+                upgradeEngramKind(repo, {
+                    id: engram.id,
+                    newKind: assessment.targetKind,
+                    reason: assessment.reason,
+                    evidence: `auto: ${assessment.reason}`,
+                    upgradedBy,
+                    nowIso,
+                });
+            }
+            catch (e) {
+                skipped.push({
+                    id: engram.id,
+                    reason: `upgrade failed: ${e.message}`,
+                });
+                continue;
+            }
+        }
+        upgraded.push({
+            id: engram.id,
+            from: assessment.fromKind,
+            to: assessment.targetKind,
+            reason: assessment.reason,
+        });
+    }
+    return { scanned, upgraded, skipped };
+}
+//# sourceMappingURL=category.js.map

package/dist/evolution/category.js.map

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

package/dist/evolution/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Evolution 模块 barrel
+ *
+ * @module @co-engram/core/evolution
+ */
+export * from "./category.js";
+export * from "./triggered.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evolution/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/evolution/index.js

@@ -0,0 +1,8 @@
+/**
+ * Evolution 模块 barrel
+ *
+ * @module @co-engram/core/evolution
+ */
+export * from "./category.js";
+export * from "./triggered.js";
+//# sourceMappingURL=index.js.map

package/dist/evolution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evolution/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/evolution/triggered.d.ts

@@ -0,0 +1,107 @@
+/**
+ * 触发式进化（A-MEM，spec §5.2 路径 1）
+ *
+ * 新 engram 写入时，立即触发局部联想更新：
+ *   1. 重叠检测：domainTags / contextTags 与已有 engram 重叠
+ *   2. Synapse 权重重塑：
+ *      - 无连接 + 重叠 → 创建 similar_to（弱权重）
+ *      - 已有连接 + 重叠 → 权重提升（Hebbian 强化）
+ *   3. 模式重复检测：同 kind + 同 domainTags 多次出现 → 累计计数
+ *      (供 REM 做梦消费，达到阈值时升级为 pattern)
+ *   4. 潜在 contradiction 检测：kind 不同但内容关键词重叠 → 返回候选对
+ *      (contradicts synapse 由调用方/人工确认，不自动创建)
+ *
+ * 范围：局部（只处理与 newEngram 重叠的 engram），毫秒级。
+ *
+ * @module @co-engram/core/evolution
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { EngramKind, EngramId } from "../types/engram.js";
+/** 触发式进化的默认配置 */
+export interface TriggeredEvolutionConfig {
+    /** domainTags 重叠的最小数量（默认 1） */
+    readonly minDomainTagOverlap: number;
+    /** contextTags 重叠的最小数量（默认 1） */
+    readonly minContextTagOverlap: number;
+    /** 新建 similar_to synapse 的初始权重（默认 0.3） */
+    readonly newSynapseWeight: number;
+    /** 已有 synapse 的权重提升（默认 0.05） */
+    readonly synapseBoost: number;
+    /** 权重上限（默认 1.0） */
+    readonly maxSynapseWeight: number;
+    /** 潜在 contradiction 关键词最小重叠（默认 2） */
+    readonly minContradictionKeywordOverlap: number;
+    /** 是否排除自身（默认 true） */
+    readonly excludeSelf: boolean;
+}
+export declare const DEFAULT_TRIGGERED_CONFIG: TriggeredEvolutionConfig;
+/** 重塑的单条 synapse 操作记录 */
+export interface SynapseReshapeRecord {
+    readonly otherEngramId: EngramId;
+    readonly action: "created" | "boosted" | "skipped_existing_max";
+    readonly kind: "similar_to";
+    readonly weight: number;
+    readonly previousWeight?: number;
+    readonly reason: string;
+}
+/** 模式重复检测记录 */
+export interface PatternRepeatRecord {
+    readonly kind: EngramKind;
+    readonly domainTagsKey: string;
+    readonly occurrences: number;
+    readonly siblingIds: readonly EngramId[];
+}
+/** 潜在矛盾候选对（不自动创建 contradicts synapse） */
+export interface PotentialContradictionRecord {
+    readonly otherEngramId: EngramId;
+    readonly newKind: EngramKind;
+    readonly otherKind: EngramKind;
+    readonly sharedKeywords: readonly string[];
+    readonly reason: string;
+}
+/** 触发式进化结果 */
+export interface TriggeredEvolutionResult {
+    readonly newEngramId: EngramId;
+    /** 找到的重叠 engram 总数 */
+    readonly overlapCount: number;
+    /** synapse 重塑记录 */
+    readonly reshapings: readonly SynapseReshapeRecord[];
+    /** 模式重复记录 */
+    readonly patternRepeats: readonly PatternRepeatRecord[];
+    /** 潜在矛盾候选对（供人工/上层确认） */
+    readonly potentialContradictions: readonly PotentialContradictionRecord[];
+    /** 执行耗时（毫秒） */
+    readonly durationMs: number;
+    /** 是否实际落盘 */
+    readonly persisted: boolean;
+}
+/**
+ * 触发式进化：新 engram 写入钩子
+ *
+ * 主流程：
+ *   1. 读 newEngram + 列出所有 active engram
+ *   2. 对每个 candidate：
+ *      - 计算 domainTags + contextTags 重叠
+ *      - 满足阈值 → 重塑 synapse（创建 or 强化）
+ *      - kind 不同 + 内容关键词重叠 → 记为潜在 contradiction
+ *   3. 模式重复检测：按 (kind, domainTags 组合 key) 分组计数
+ *
+ * 稳定扫描：candidates 按 id 字典序（prompt cache 友好）
+ */
+export declare function onEngramCreated(repo: EngramRepository, newEngramId: EngramId, options?: {
+    readonly config?: Partial<TriggeredEvolutionConfig>;
+    readonly nowIso?: string;
+    readonly persist?: boolean;
+}): TriggeredEvolutionResult;
+/**
+ * 触发式进化处理器工厂
+ *
+ * 返回一个 handler 函数，供 host 在 engram_create 后调用。
+ *
+ * 用法：
+ *   const handler = createTriggeredEvolutionHandler(repo)
+ *   // ...在 engram_create 工具 execute 后:
+ *   handler(newEngramId)
+ */
+export declare function createTriggeredEvolutionHandler(repo: EngramRepository, config?: Partial<TriggeredEvolutionConfig>): (engramId: EngramId) => TriggeredEvolutionResult;
+//# sourceMappingURL=triggered.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggered.d.ts","sourceRoot":"","sources":["../../src/evolution/triggered.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG/D,iBAAiB;AACjB,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,gCAAgC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,gCAAgC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAC;IAChD,sBAAsB;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,wBAAwB,EAAE,wBAQtC,CAAC;AAEF,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,sBAAsB,CAAC;IAChE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAe;AACf,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC1C;AAED,yCAAyC;AACzC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,cAAc;AACd,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/B,sBAAsB;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACrD,aAAa;IACb,QAAQ,CAAC,cAAc,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxD,wBAAwB;IACxB,QAAQ,CAAC,uBAAuB,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC1E,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,aAAa;IACb,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,QAAQ,EACrB,OAAO,GAAE;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CACvB,GACL,wBAAwB,CAuL1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,gBAAgB,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACzC,CAAC,QAAQ,EAAE,QAAQ,KAAK,wBAAwB,CAElD"}