@co-engram/core 0.1.0

package/dist/evolution/triggered.js

@@ -0,0 +1,278 @@
+/**
+ * 触发式进化（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 { randomUUID } from "node:crypto";
+export const DEFAULT_TRIGGERED_CONFIG = {
+    minDomainTagOverlap: 1,
+    minContextTagOverlap: 1,
+    newSynapseWeight: 0.3,
+    synapseBoost: 0.05,
+    maxSynapseWeight: 1.0,
+    minContradictionKeywordOverlap: 2,
+    excludeSelf: true,
+};
+/**
+ * 触发式进化：新 engram 写入钩子
+ *
+ * 主流程：
+ *   1. 读 newEngram + 列出所有 active engram
+ *   2. 对每个 candidate：
+ *      - 计算 domainTags + contextTags 重叠
+ *      - 满足阈值 → 重塑 synapse（创建 or 强化）
+ *      - kind 不同 + 内容关键词重叠 → 记为潜在 contradiction
+ *   3. 模式重复检测：按 (kind, domainTags 组合 key) 分组计数
+ *
+ * 稳定扫描：candidates 按 id 字典序（prompt cache 友好）
+ */
+export function onEngramCreated(repo, newEngramId, options = {}) {
+    const startMs = Date.now();
+    if (!repo.exists(newEngramId)) {
+        throw new Error(`Engram not found: ${newEngramId}`);
+    }
+    const cfg = {
+        ...DEFAULT_TRIGGERED_CONFIG,
+        ...options.config,
+    };
+    const nowIso = options.nowIso ?? new Date().toISOString();
+    const persist = options.persist ?? true;
+    const newEngram = repo.readEngram(newEngramId);
+    const newDomainSet = new Set(newEngram.domainTags);
+    const newContextSet = new Set(newEngram.contextTags);
+    const newKeywords = extractKeywords(newEngram.content);
+    const reshapings = [];
+    const potentialContradictions = [];
+    // 列出所有候选（排除自身）
+    const entries = [...repo.listEngrams()].sort((a, b) => a.id < b.id ? -1 : 1);
+    let overlapCount = 0;
+    // 收集 newEngram 的 outgoing synapses（用于判断是否已有连接）
+    const newSynapses = repo.readSynapses(newEngramId).outgoing;
+    const existingOutgoing = new Set(newSynapses.map((s) => `${s.to}::${s.kind}`));
+    // 模式重复 key 收集（newEngram 自己也算一次）
+    const patternBuckets = new Map();
+    const newPatternKey = patternKey(newEngram.kind, newEngram.domainTags);
+    patternBuckets.set(newPatternKey, {
+        kind: newEngram.kind,
+        ids: [newEngramId],
+    });
+    for (const entry of entries) {
+        if (cfg.excludeSelf && entry.id === newEngramId)
+            continue;
+        const other = repo.readEngram(entry.id);
+        if (other.status !== "active")
+            continue;
+        // 模式重复检测
+        const otherPatternKey = patternKey(other.kind, other.domainTags);
+        const bucket = patternBuckets.get(otherPatternKey);
+        if (bucket) {
+            bucket.ids.push(other.id);
+        }
+        else {
+            patternBuckets.set(otherPatternKey, {
+                kind: other.kind,
+                ids: [other.id],
+            });
+        }
+        // 计算 tag 重叠
+        const domainOverlap = countOverlap(newDomainSet, other.domainTags);
+        const contextOverlap = countOverlap(newContextSet, other.contextTags);
+        const domainOk = domainOverlap >= cfg.minDomainTagOverlap;
+        const contextOk = contextOverlap >= cfg.minContextTagOverlap;
+        if (!domainOk && !contextOk)
+            continue;
+        overlapCount += 1;
+        // 检查是否已有 similar_to 连接（任一方向）
+        const key = `${other.id}::similar_to`;
+        const reverseKey = `${newEngramId}::similar_to`; // outgoing from other
+        const hasOutgoing = existingOutgoing.has(key);
+        const hasIncoming = repo
+            .readSynapses(other.id)
+            .outgoing.some((s) => s.to === newEngramId && s.kind === "similar_to");
+        if (hasOutgoing) {
+            // 已有 outgoing → boost 权重
+            const existing = newSynapses.find((s) => s.to === other.id && s.kind === "similar_to");
+            const newWeight = Math.min(cfg.maxSynapseWeight, existing.weight + cfg.synapseBoost);
+            if (newWeight === existing.weight) {
+                reshapings.push({
+                    otherEngramId: other.id,
+                    action: "skipped_existing_max",
+                    kind: "similar_to",
+                    weight: existing.weight,
+                    previousWeight: existing.weight,
+                    reason: "already at max weight",
+                });
+            }
+            else {
+                if (persist) {
+                    boostSynapseWeight(repo, newEngramId, existing.id, newWeight, nowIso);
+                }
+                reshapings.push({
+                    otherEngramId: other.id,
+                    action: "boosted",
+                    kind: "similar_to",
+                    weight: newWeight,
+                    previousWeight: existing.weight,
+                    reason: `domainOverlap=${domainOverlap}, contextOverlap=${contextOverlap}`,
+                });
+            }
+        }
+        else if (!hasIncoming) {
+            // 无连接 → 创建 similar_to
+            if (persist) {
+                repo.addOutgoingSynapse(newEngramId, {
+                    id: `trig-${randomUUID().slice(0, 12)}`,
+                    from: newEngramId,
+                    to: other.id,
+                    kind: "similar_to",
+                    weight: cfg.newSynapseWeight,
+                    direction: "bidirectional",
+                    evidence: [
+                        {
+                            description: `triggered evolution: domainOverlap=${domainOverlap}, contextOverlap=${contextOverlap}`,
+                            addedAt: nowIso,
+                            addedBy: "triggered-evolution",
+                        },
+                    ],
+                    createdBy: "triggered-evolution",
+                    createdAt: nowIso,
+                    updatedAt: nowIso,
+                    retrievalWeight: cfg.newSynapseWeight,
+                });
+            }
+            reshapings.push({
+                otherEngramId: other.id,
+                action: "created",
+                kind: "similar_to",
+                weight: cfg.newSynapseWeight,
+                reason: `domainOverlap=${domainOverlap}, contextOverlap=${contextOverlap}`,
+            });
+        }
+        // 潜在 contradiction 检测：kind 不同 + 关键词重叠
+        if (other.kind !== newEngram.kind) {
+            const otherKeywords = extractKeywords(other.content);
+            const sharedKeywords = intersect(newKeywords, otherKeywords);
+            if (sharedKeywords.length >= cfg.minContradictionKeywordOverlap) {
+                potentialContradictions.push({
+                    otherEngramId: other.id,
+                    newKind: newEngram.kind,
+                    otherKind: other.kind,
+                    sharedKeywords,
+                    reason: `kind mismatch (${newEngram.kind} vs ${other.kind}) + ${sharedKeywords.length} shared keywords`,
+                });
+            }
+        }
+    }
+    // 模式重复记录（只保留 occurrences >= 2 的）
+    const patternRepeats = [];
+    for (const [key, bucket] of patternBuckets) {
+        if (bucket.ids.length >= 2) {
+            patternRepeats.push({
+                kind: bucket.kind,
+                domainTagsKey: key,
+                occurrences: bucket.ids.length,
+                siblingIds: [...bucket.ids].sort(),
+            });
+        }
+    }
+    patternRepeats.sort((a, b) => {
+        if (b.occurrences !== a.occurrences)
+            return b.occurrences - a.occurrences;
+        return a.domainTagsKey < b.domainTagsKey ? -1 : 1;
+    });
+    return {
+        newEngramId,
+        overlapCount,
+        reshapings,
+        patternRepeats,
+        potentialContradictions,
+        durationMs: Date.now() - startMs,
+        persisted: persist,
+    };
+}
+/**
+ * 触发式进化处理器工厂
+ *
+ * 返回一个 handler 函数，供 host 在 engram_create 后调用。
+ *
+ * 用法：
+ *   const handler = createTriggeredEvolutionHandler(repo)
+ *   // ...在 engram_create 工具 execute 后:
+ *   handler(newEngramId)
+ */
+export function createTriggeredEvolutionHandler(repo, config) {
+    return (engramId) => onEngramCreated(repo, engramId, { config });
+}
+// ============================================================
+// 辅助函数
+// ============================================================
+function countOverlap(set, list) {
+    let n = 0;
+    for (const item of list) {
+        if (set.has(item))
+            n += 1;
+    }
+    return n;
+}
+function intersect(a, b) {
+    const bset = new Set(b);
+    const result = [];
+    for (const x of a) {
+        if (bset.has(x))
+            result.push(x);
+    }
+    return result;
+}
+/**
+ * 简易关键词提取（中文按 2-gram，英文按 word）
+ *
+ * 与 dedup 的 TokenJaccardSimilarityEngine 一致。
+ */
+function extractKeywords(content) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return [];
+    const tokens = [];
+    // 英文 word
+    const enWords = trimmed.match(/[A-Za-z][A-Za-z0-9_-]{1,}/g) ?? [];
+    tokens.push(...enWords.map((w) => w.toLowerCase()));
+    // 中文 bigram
+    const cn = trimmed.match(/[一-鿿]+/g) ?? [];
+    for (const seg of cn) {
+        for (let i = 0; i < seg.length - 1; i++) {
+            tokens.push(seg.slice(i, i + 2));
+        }
+    }
+    return [...new Set(tokens)];
+}
+function patternKey(kind, domainTags) {
+    return `${kind}|${[...domainTags].sort().join(",")}`;
+}
+function boostSynapseWeight(repo, fromId, synapseId, newWeight, nowIso) {
+    const file = repo.readSynapses(fromId);
+    const target = file.outgoing.find((s) => s.id === synapseId);
+    if (!target)
+        return;
+    // 通过 replaceSynapseEvidence 同样的私有路径... 实际上需要专门方法
+    // 简化：使用 repo 的 addOutgoingSynapse 不行（追加），需要替换。
+    // 我们用 replaceSynapseEvidence 间接 → 不行，那是 evidence-only。
+    // 折中：直接调 repo.updateSynapseWeight（如果存在）；否则删除+重建。
+    repo.replaceSynapse(fromId, synapseId, {
+        ...target,
+        weight: newWeight,
+        updatedAt: nowIso,
+    });
+}
+//# sourceMappingURL=triggered.js.map

package/dist/evolution/triggered.js.map

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

package/dist/generative/cross-pollinate.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 跨域授粉（spec §5.3 机制 4，P3 4.3）
+ *
+ * 发现跨领域类比（创造性思维）。
+ *
+ * 算法：
+ *   1. 计算每个 domain 的结构指纹：
+ *      - SynapseKind 分布（structural/causal/evidential/...）
+ *      - EngramKind 分布（observation/fact/...）
+ *      - 平均 importance / confidence
+ *   2. 计算两个 domain 的结构相似度（Cosine similarity on synapse kind 向量）
+ *   3. 相似度 ≥ threshold → 调 Provider 生成类比描述
+ *   4. 可选创建 hypothesis engram 记录类比（kind=hypothesis, domainTags=[A,B]）
+ *
+ * 默认启发式：基于结构向量相似度 + 模板化类比描述。
+ * 生产实现：宿主注入 LLM provider 做真正的语义类比。
+ *
+ * @module @co-engram/core/generative
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { EngramKind } from "../types/engram.js";
+import type { SynapseKind } from "../types/synapse.js";
+/** Domain 结构指纹 */
+export interface DomainProfile {
+    readonly domain: string;
+    readonly engramCount: number;
+    readonly kindDistribution: Record<EngramKind, number>;
+    readonly synapseDistribution: Record<SynapseKind, number>;
+    readonly avgImportance: number;
+    readonly avgConfidence: number;
+}
+/** Provider 输入 */
+export interface CrossPollinationProviderInput {
+    readonly domainA: string;
+    readonly profileA: DomainProfile;
+    readonly domainB: string;
+    readonly profileB: DomainProfile;
+    readonly structuralSimilarity: number;
+    readonly sampleEngramsA: ReadonlyArray<{
+        title: string;
+        content: string;
+    }>;
+    readonly sampleEngramsB: ReadonlyArray<{
+        title: string;
+        content: string;
+    }>;
+}
+/** Provider 输出 */
+export interface CrossPollinationProviderOutput {
+    readonly analogy: string;
+    readonly sharedPrinciple: string;
+    readonly confidence: number;
+    readonly reason: string;
+}
+/** 跨域授粉 Provider 接口 */
+export interface CrossPollinationProvider {
+    generate(input: CrossPollinationProviderInput): Promise<CrossPollinationProviderOutput> | CrossPollinationProviderOutput;
+}
+/** crossPollinate 单条输入 */
+export interface CrossPollinatePairInput {
+    readonly domainA: string;
+    readonly domainB: string;
+    readonly createdBy: string;
+    /** 自动采纳阈值（默认 0.5） */
+    readonly autoAdoptionThreshold?: number;
+    /** 是否创建 hypothesis engram 记录类比（默认 false） */
+    readonly createHypothesis?: boolean;
+    readonly nowIso?: string;
+}
+/** crossPollinate 单条结果 */
+export interface CrossPollinationResult {
+    readonly domainA: string;
+    readonly domainB: string;
+    readonly structuralSimilarity: number;
+    readonly profileA: DomainProfile;
+    readonly profileB: DomainProfile;
+    readonly analogy: CrossPollinationProviderOutput | null;
+    readonly adopted: boolean;
+    readonly engramId: string | null;
+    readonly reason: string;
+}
+/** findCrossDomainCandidates 结果 */
+export interface CrossDomainCandidate {
+    readonly domainA: string;
+    readonly domainB: string;
+    readonly similarity: number;
+}
+/**
+ * 默认启发式跨域类比 Provider（无 LLM）
+ *
+ * 模板化输出：
+ *   - analogy: "{domainA} 的 {topKindA} 模式与 {domainB} 的 {topKindB} 模式结构同构"
+ *   - sharedPrinciple: 基于 top synapse kind 推断
+ *   - confidence = structuralSimilarity
+ */
+export declare class LocalHeuristicCrossPollinationProvider implements CrossPollinationProvider {
+    generate(input: CrossPollinationProviderInput): CrossPollinationProviderOutput;
+}
+/**
+ * 计算单个 domain 的结构指纹
+ */
+export declare function computeDomainProfile(repo: EngramRepository, domain: string): DomainProfile | null;
+/**
+ * 计算两个 domain 的结构相似度（Cosine similarity on synapse kind 向量）
+ *
+ * 返回 [0,1]，1 = 完全同构
+ */
+export declare function computeStructuralSimilarity(a: DomainProfile, b: DomainProfile): number;
+/**
+ * 扫描所有 domain pair，返回结构相似的候选对
+ *
+ * @param options.threshold 相似度下限（默认 0.5）
+ * @param options.maxPairs 最多返回数量（默认 10）
+ */
+export declare function findCrossDomainCandidates(repo: EngramRepository, options?: {
+    readonly threshold?: number;
+    readonly maxPairs?: number;
+    readonly minEngramsPerDomain?: number;
+}): CrossDomainCandidate[];
+/**
+ * 对单对 domain 执行跨域授粉
+ *
+ * 行为：
+ *   1. 计算 profileA / profileB
+ *   2. 计算 structuralSimilarity
+ *   3. 调 Provider.generate（即使相似度低也调用，由 Provider 决定是否输出）
+ *   4. createHypothesis=true 且 confidence ≥ autoAdoptionThreshold
+ *      → 创建 hypothesis engram（domainTags=[A,B]）记录类比
+ */
+export declare function crossPollinate(repo: EngramRepository, provider: CrossPollinationProvider, input: CrossPollinatePairInput): Promise<CrossPollinationResult>;
+/**
+ * 批量执行：对前 N 个候选 pair 跑 crossPollinate
+ */
+export declare function crossPollinateBatch(repo: EngramRepository, provider: CrossPollinationProvider, input: {
+    readonly createdBy: string;
+    readonly threshold?: number;
+    readonly maxPairs?: number;
+    readonly createHypothesis?: boolean;
+    readonly autoAdoptionThreshold?: number;
+}): Promise<{
+    readonly candidates: readonly CrossDomainCandidate[];
+    readonly results: readonly CrossPollinationResult[];
+}>;
+//# sourceMappingURL=cross-pollinate.d.ts.map

package/dist/generative/cross-pollinate.d.ts.map

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