@co-engram/core 0.1.0

package/dist/contradiction/resolver.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Contradiction Resolver（spec §3.9 完整三阶段）
+ *
+ * resolveContradiction:
+ *   阶段 1 - LLM 自动裁决（confidence ≥ threshold）
+ *     → 执行 verdict (keep_new / keep_old / merge)
+ *   阶段 2 - 升级归属人（confidence < threshold 或 verdict=archive）
+ *     → 标记 escalated + 设置 expiresAt
+ *   阶段 3 - 超时降级（由 processExpiredContradictions 单独处理）
+ *
+ * Verdict 执行的副作用：
+ *   - keep_new: old verificationStatus = 'refuted'
+ *   - keep_old: new verificationStatus = 'refuted'
+ *   - merge: 合并 new → old（content + summary），删除 contradicts synapse
+ *   - archive: 不自动执行（仅阶段 2 升级，由人工决定）
+ *
+ * revisionHistory 通过 synapse.evidence 数组追加记录每次裁决动作。
+ *
+ * @module @co-engram/core/contradiction
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { EngramId } from "../types/engram.js";
+import { type ContradictionArbiter } from "./arbiter.js";
+import type { ResolutionResult } from "./types.js";
+export interface ResolveContradictionOptions {
+    /** 自定义 arbiter（默认 LocalHeuristicContradictionArbiter） */
+    readonly arbiter?: ContradictionArbiter;
+    /** 自动裁决阈值（默认 0.8） */
+    readonly autoThreshold?: number;
+    /** 阶段 2 超时天数（默认 7） */
+    readonly escalationTimeoutDays?: number;
+    /** 当前时间（测试用） */
+    readonly now?: Date;
+    /** 是否实际落盘（默认 true） */
+    readonly persist?: boolean;
+}
+export interface ResolveContradictionInput {
+    readonly fromId: EngramId;
+    readonly synapseId: string;
+}
+/**
+ * 解决一个 contradicts synapse（三阶段流程入口）
+ */
+export declare function resolveContradiction(repo: EngramRepository, input: ResolveContradictionInput, options?: ResolveContradictionOptions): Promise<ResolutionResult>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/contradiction/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/contradiction/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAKjE,OAAO,KAAK,EAAU,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAQpB,MAAM,WAAW,2BAA2B;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,qBAAqB;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB;IACtB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,gBAAgB;IAChB,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACpB,sBAAsB;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,yBAAyB,EAChC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAoI3B"}

package/dist/contradiction/resolver.js

@@ -0,0 +1,196 @@
+/**
+ * Contradiction Resolver（spec §3.9 完整三阶段）
+ *
+ * resolveContradiction:
+ *   阶段 1 - LLM 自动裁决（confidence ≥ threshold）
+ *     → 执行 verdict (keep_new / keep_old / merge)
+ *   阶段 2 - 升级归属人（confidence < threshold 或 verdict=archive）
+ *     → 标记 escalated + 设置 expiresAt
+ *   阶段 3 - 超时降级（由 processExpiredContradictions 单独处理）
+ *
+ * Verdict 执行的副作用：
+ *   - keep_new: old verificationStatus = 'refuted'
+ *   - keep_old: new verificationStatus = 'refuted'
+ *   - merge: 合并 new → old（content + summary），删除 contradicts synapse
+ *   - archive: 不自动执行（仅阶段 2 升级，由人工决定）
+ *
+ * revisionHistory 通过 synapse.evidence 数组追加记录每次裁决动作。
+ *
+ * @module @co-engram/core/contradiction
+ */
+import { LocalHeuristicContradictionArbiter, validateArbiterOutput, shouldAutoExecute, } from "./arbiter.js";
+/** 默认自动裁决阈值（spec §3.9 阶段 1：confidence ≥ 0.8） */
+const DEFAULT_AUTO_THRESHOLD = 0.8;
+/** 阶段 2 默认超时时间（天） */
+const DEFAULT_ESCALATION_TIMEOUT_DAYS = 7;
+/**
+ * 解决一个 contradicts synapse（三阶段流程入口）
+ */
+export async function resolveContradiction(repo, input, options = {}) {
+    const arbiter = options.arbiter ?? new LocalHeuristicContradictionArbiter();
+    const threshold = options.autoThreshold ?? DEFAULT_AUTO_THRESHOLD;
+    const timeoutDays = options.escalationTimeoutDays ?? DEFAULT_ESCALATION_TIMEOUT_DAYS;
+    const now = options.now ?? new Date();
+    const persist = options.persist ?? true;
+    // 1. 找到 contradicts synapse
+    const file = repo.readSynapses(input.fromId);
+    const synapse = file.outgoing.find((s) => s.id === input.synapseId);
+    if (!synapse) {
+        throw new Error(`Synapse not found: ${input.synapseId} (from ${input.fromId})`);
+    }
+    if (synapse.kind !== "contradicts") {
+        throw new Error(`Synapse ${input.synapseId} is not a contradicts (kind=${synapse.kind})`);
+    }
+    const fromEngram = repo.readEngram(input.fromId);
+    const toEngram = repo.readEngram(synapse.to);
+    // 2. 构造 arbiter 输入
+    const arbInput = {
+        newEngram: engramToArbiterView(fromEngram),
+        oldEngram: engramToArbiterView(toEngram),
+        contradictionEvidence: synapse.evidence.map((e) => e.description),
+    };
+    // 3. 阶段 1：调 arbiter
+    const arbOutput = await arbiter.arbitrate(arbInput);
+    validateArbiterOutput(arbOutput);
+    const history = [];
+    const nowIso = now.toISOString();
+    const expiresAtIso = new Date(now.getTime() + timeoutDays * 24 * 60 * 60 * 1000).toISOString();
+    // 4. 决定走自动还是升级
+    if (shouldAutoExecute(arbOutput, threshold)) {
+        // === 阶段 1：自动执行 ===
+        history.push({
+            at: nowIso,
+            phase: 1,
+            action: "execute_verdict",
+            verdict: arbOutput.verdict,
+            rationale: arbOutput.rationale,
+            confidence: arbOutput.confidence,
+            actor: "llm-arbiter",
+        });
+        if (persist) {
+            executeVerdict(repo, input.fromId, synapse.to, input.synapseId, arbOutput.verdict, nowIso);
+        }
+        // merge 已删除 synapse；其他 verdict 更新 resolutionState
+        if (persist && arbOutput.verdict !== "merge") {
+            const finalState = {
+                status: "auto_resolved",
+                phase: 1,
+                verdict: arbOutput.verdict,
+                rationale: arbOutput.rationale,
+                confidence: arbOutput.confidence,
+                resolvedAt: nowIso,
+                resolvedBy: "llm-arbiter",
+            };
+            repo.updateSynapseResolution(input.fromId, input.synapseId, finalState);
+        }
+        return {
+            synapseId: input.synapseId,
+            fromId: input.fromId,
+            toId: synapse.to,
+            finalPhase: 1,
+            finalStatus: "auto_resolved",
+            verdict: arbOutput.verdict,
+            rationale: arbOutput.rationale,
+            confidence: arbOutput.confidence,
+            persisted: persist,
+            history,
+        };
+    }
+    // === 阶段 2：升级归属人 ===
+    history.push({
+        at: nowIso,
+        phase: 2,
+        action: "escalated",
+        verdict: arbOutput.verdict,
+        rationale: arbOutput.rationale,
+        confidence: arbOutput.confidence,
+        actor: "system",
+    });
+    const escalatedState = {
+        status: "escalated",
+        phase: 2,
+        verdict: arbOutput.verdict,
+        rationale: arbOutput.rationale,
+        confidence: arbOutput.confidence,
+        escalatedTo: toEngram.createdBy,
+        escalatedAt: nowIso,
+        expiresAt: expiresAtIso,
+    };
+    if (persist) {
+        repo.updateSynapseResolution(input.fromId, input.synapseId, escalatedState);
+    }
+    return {
+        synapseId: input.synapseId,
+        fromId: input.fromId,
+        toId: synapse.to,
+        finalPhase: 2,
+        finalStatus: "escalated",
+        verdict: arbOutput.verdict,
+        rationale: arbOutput.rationale,
+        confidence: arbOutput.confidence,
+        persisted: persist,
+        history,
+    };
+}
+/**
+ * 执行 verdict 的副作用
+ */
+function executeVerdict(repo, fromId, toId, synapseId, verdict, nowIso) {
+    switch (verdict) {
+        case "keep_new": {
+            repo.updateVerificationStatus(toId, "refuted");
+            appendEvidence(repo, fromId, synapseId, `auto: keep_new (old ${toId} refuted)`, nowIso);
+            break;
+        }
+        case "keep_old": {
+            repo.updateVerificationStatus(fromId, "refuted");
+            appendEvidence(repo, fromId, synapseId, `auto: keep_old (new ${fromId} refuted)`, nowIso);
+            break;
+        }
+        case "merge": {
+            const fromEngram = repo.readEngram(fromId);
+            const toEngram = repo.readEngram(toId);
+            repo.updateEngram(toId, {
+                content: mergeContent(toEngram.content, fromEngram.content),
+                summary: mergeSummary(toEngram.summary, fromEngram.summary),
+                updatedBy: "contradiction-merge",
+            });
+            repo.removeOutgoingSynapse(fromId, synapseId);
+            break;
+        }
+        case "archive":
+            // 阶段 2 升级，不自动 archive
+            break;
+    }
+}
+function appendEvidence(repo, fromId, synapseId, description, atIso) {
+    const file = repo.readSynapses(fromId);
+    const target = file.outgoing.find((s) => s.id === synapseId);
+    if (!target)
+        return;
+    const newEvidence = [
+        ...target.evidence,
+        { description, addedAt: atIso, addedBy: "contradiction-resolver" },
+    ];
+    repo.replaceSynapseEvidence(fromId, synapseId, newEvidence);
+}
+function mergeContent(a, b) {
+    return `${a}\n\n---\n\n[merged from contradiction]\n${b}`;
+}
+function mergeSummary(a, b) {
+    if (a === b)
+        return a;
+    return `${a} / ${b}`;
+}
+function engramToArbiterView(e) {
+    return {
+        id: e.id,
+        title: e.title,
+        summary: e.summary,
+        content: e.content,
+        confidence: e.confidence,
+        sourceType: e.sourceType,
+        evidenceCount: e.evidenceCount,
+    };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/contradiction/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/contradiction/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,cAAc,CAAC;AAOtB,gDAAgD;AAChD,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,qBAAqB;AACrB,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAoB1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAsB,EACtB,KAAgC,EAChC,UAAuC,EAAE;IAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,kCAAkC,EAAE,CAAC;IAC5E,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;IAClE,MAAM,WAAW,GACf,OAAO,CAAC,qBAAqB,IAAI,+BAA+B,CAAC;IACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAExC,4BAA4B;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,CAAC,SAAS,UAAU,KAAK,CAAC,MAAM,GAAG,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,CAAC,SAAS,+BAA+B,OAAO,CAAC,IAAI,GAAG,CACzE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE7C,mBAAmB;IACnB,MAAM,QAAQ,GAAmB;QAC/B,SAAS,EAAE,mBAAmB,CAAC,UAAU,CAAC;QAC1C,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CAAC;QACxC,qBAAqB,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;KAClE,CAAC;IAEF,oBAAoB;IACpB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpD,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAEjC,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,IAAI,CAC3B,GAAG,CAAC,OAAO,EAAE,GAAG,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAClD,CAAC,WAAW,EAAE,CAAC;IAEhB,eAAe;IACf,IAAI,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;QAC5C,oBAAoB;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,KAAK,EAAE,aAAa;SACrB,CAAC,CAAC;QAEH,IAAI,OAAO,EAAE,CAAC;YACZ,cAAc,CACZ,IAAI,EACJ,KAAK,CAAC,MAAM,EACZ,OAAO,CAAC,EAAE,EACV,KAAK,CAAC,SAAS,EACf,SAAS,CAAC,OAAO,EACjB,MAAM,CACP,CAAC;QACJ,CAAC;QAED,kDAAkD;QAClD,IAAI,OAAO,IAAI,SAAS,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7C,MAAM,UAAU,GAA2B;gBACzC,MAAM,EAAE,eAAe;gBACvB,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,SAAS,CAAC,OAAO;gBAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC9B,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,aAAa;aAC1B,CAAC;YACF,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,OAAO,CAAC,EAAE;YAChB,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,SAAS,EAAE,OAAO;YAClB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,OAAO,CAAC,IAAI,CAAC;QACX,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IAEH,MAAM,cAAc,GAA2B;QAC7C,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,WAAW,EAAE,QAAQ,CAAC,SAAS;QAC/B,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,YAAY;KACxB,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,OAAO,CAAC,EAAE;QAChB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,SAAS,EAAE,OAAO;QAClB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,IAAsB,EACtB,MAAgB,EAChB,IAAc,EACd,SAAiB,EACjB,OAA6B,EAC7B,MAAc;IAEd,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,wBAAwB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/C,cAAc,CACZ,IAAI,EACJ,MAAM,EACN,SAAS,EACT,uBAAuB,IAAI,WAAW,EACtC,MAAM,CACP,CAAC;YACF,MAAM;QACR,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACjD,cAAc,CACZ,IAAI,EACJ,MAAM,EACN,SAAS,EACT,uBAAuB,MAAM,WAAW,EACxC,MAAM,CACP,CAAC;YACF,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;gBACtB,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC;gBAC3D,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC;gBAC3D,SAAS,EAAE,qBAAqB;aACjC,CAAC,CAAC;YACH,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC9C,MAAM;QACR,CAAC;QACD,KAAK,SAAS;YACZ,sBAAsB;YACtB,MAAM;IACV,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,IAAsB,EACtB,MAAgB,EAChB,SAAiB,EACjB,WAAmB,EACnB,KAAa;IAEb,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,WAAW,GAAG;QAClB,GAAG,MAAM,CAAC,QAAQ;QAClB,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,wBAAwB,EAAE;KACnE,CAAC;IACF,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACxC,OAAO,GAAG,CAAC,2CAA2C,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACxC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,mBAAmB,CAAC,CAAS;IACpC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,UAAU,EAAE,CAAC,CAAC,UAAoB;QAClC,aAAa,EAAE,CAAC,CAAC,aAAa;KAC/B,CAAC;AACJ,CAAC"}

package/dist/contradiction/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Contradiction Resolution 共享类型（spec §3.9）
+ *
+ * @module @co-engram/core/contradiction
+ */
+import type { EngramId, SynapseId } from "../types/engram.js";
+import type { ContradictionVerdict, SynapseResolutionStatus } from "../types/synapse.js";
+/** 矛盾对（A vs B，A 是 synapse.from，B 是 synapse.to） */
+export interface ContradictionPair {
+    readonly synapseId: SynapseId;
+    readonly fromId: EngramId;
+    readonly toId: EngramId;
+    /** 矛盾强度（synapse.weight） */
+    readonly weight: number;
+    /** 当前裁决状态（undefined=未进入流程） */
+    readonly status: SynapseResolutionStatus | "none";
+}
+/** Arbiter 输入：两个 engram 的简要信息 */
+export interface ArbitrateInput {
+    readonly newEngram: {
+        readonly id: EngramId;
+        readonly title: string;
+        readonly summary: string;
+        readonly content: string;
+        readonly confidence: number;
+        readonly sourceType: string;
+        readonly evidenceCount: number;
+    };
+    readonly oldEngram: {
+        readonly id: EngramId;
+        readonly title: string;
+        readonly summary: string;
+        readonly content: string;
+        readonly confidence: number;
+        readonly sourceType: string;
+        readonly evidenceCount: number;
+    };
+    /** 触发矛盾的 synapse 上的证据描述 */
+    readonly contradictionEvidence: readonly string[];
+}
+/** Arbiter 输出：裁决结果 */
+export interface ArbitrateOutput {
+    readonly verdict: ContradictionVerdict;
+    readonly rationale: string;
+    readonly confidence: number;
+}
+/** 一条裁决历史记录（revisionHistory） */
+export interface RevisionEntry {
+    readonly at: string;
+    readonly phase: 1 | 2 | 3;
+    readonly action: SynapseResolutionStatus | "execute_verdict";
+    readonly verdict?: ContradictionVerdict;
+    readonly rationale?: string;
+    readonly confidence?: number;
+    readonly actor: string;
+}
+/** 裁决流程结果 */
+export interface ResolutionResult {
+    readonly synapseId: SynapseId;
+    readonly fromId: EngramId;
+    readonly toId: EngramId;
+    /** 最终进入的阶段（1=自动 / 2=升级 / 3=降级） */
+    readonly finalPhase: 1 | 2 | 3;
+    readonly finalStatus: SynapseResolutionStatus;
+    readonly verdict?: ContradictionVerdict;
+    readonly rationale?: string;
+    readonly confidence?: number;
+    /** 是否实际落盘 */
+    readonly persisted: boolean;
+    /** revisionHistory */
+    readonly history: readonly RevisionEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/contradiction/types.d.ts.map

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

package/dist/contradiction/types.js

@@ -0,0 +1,7 @@
+/**
+ * Contradiction Resolution 共享类型（spec §3.9）
+ *
+ * @module @co-engram/core/contradiction
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/contradiction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contradiction/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/dedup/dedupe.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 智能去重编排器
+ *
+ * 整合 hash 匹配 + 相似度召回 + triage + 合并/强化，
+ * 提供给 engram_create 工具调用。
+ *
+ * 用法：
+ *   const result = await dedupe(repo, input, { similarityEngine, triageProvider })
+ *   switch (result.verdict) {
+ *     case 'DUPLICATE': // 强化原 engram
+ *     case 'UPDATE':    // 已合并
+ *     case 'NEW':       // 正常创建
+ *   }
+ *
+ * 同步版本（checkDuplicateSync）用于 engram_create 自动触发，
+ * 仅支持同步启发式引擎 + 启发式 triage；
+ * 如需注入真正的 LLM triage，使用 async checkDuplicate 手动调用。
+ *
+ * @module @co-engram/core/dedup
+ */
+import type { EngramCreateInput } from "../types/engram.js";
+import type { EngramRepository } from "../storage/repository.js";
+import type { DedupResult, LlmTriageProvider, SimilarityEngine } from "./types.js";
+export interface DedupeOptions {
+    readonly similarityEngine?: SimilarityEngine;
+    readonly triageProvider?: LlmTriageProvider;
+    readonly topK?: number;
+    readonly minSimilarity?: number;
+}
+export interface DedupeContext {
+    readonly repository: EngramRepository;
+    readonly options?: DedupeOptions;
+}
+/**
+ * 执行去重检查（不创建/合并，只裁决）
+ *
+ * 返回 verdict + targetId（如有）。
+ * 后续由调用方决定如何处理（DUPLICATE → 强化；UPDATE → mergeEngram；NEW → createEngram）。
+ */
+export declare function checkDuplicate(ctx: DedupeContext, input: EngramCreateInput): Promise<DedupResult>;
+/**
+ * 同步版本：仅使用默认启发式（TokenJaccardSimilarityEngine + LocalHeuristicTriage）
+ *
+ * 用于 engram_create 自动触发，避免 async 传染；
+ * 如需注入真正的 LLM triage，调用方应使用 async checkDuplicate 手动裁决，
+ * 然后根据 verdict 决定 createEngram / mergeEngram / 强化。
+ */
+export declare function checkDuplicateSync(ctx: DedupeContext, input: EngramCreateInput): DedupResult;
+//# sourceMappingURL=dedupe.d.ts.map

package/dist/dedup/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../../src/dedup/dedupe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,WAAW,CAAC,CA0CtB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,iBAAiB,GACvB,WAAW,CAgDb"}

package/dist/dedup/dedupe.js

@@ -0,0 +1,111 @@
+/**
+ * 智能去重编排器
+ *
+ * 整合 hash 匹配 + 相似度召回 + triage + 合并/强化，
+ * 提供给 engram_create 工具调用。
+ *
+ * 用法：
+ *   const result = await dedupe(repo, input, { similarityEngine, triageProvider })
+ *   switch (result.verdict) {
+ *     case 'DUPLICATE': // 强化原 engram
+ *     case 'UPDATE':    // 已合并
+ *     case 'NEW':       // 正常创建
+ *   }
+ *
+ * 同步版本（checkDuplicateSync）用于 engram_create 自动触发，
+ * 仅支持同步启发式引擎 + 启发式 triage；
+ * 如需注入真正的 LLM triage，使用 async checkDuplicate 手动调用。
+ *
+ * @module @co-engram/core/dedup
+ */
+import { computeContentHash } from "../storage/hash.js";
+import { findExactHashMatch } from "./hash.js";
+import { LocalHeuristicTriage } from "./llm-triage.js";
+import { TokenJaccardSimilarityEngine } from "./similar.js";
+/**
+ * 执行去重检查（不创建/合并，只裁决）
+ *
+ * 返回 verdict + targetId（如有）。
+ * 后续由调用方决定如何处理（DUPLICATE → 强化；UPDATE → mergeEngram；NEW → createEngram）。
+ */
+export async function checkDuplicate(ctx, input) {
+    const repo = ctx.repository;
+    const options = ctx.options ?? {};
+    // 1. 精确 hash 匹配（O(N) 扫描）
+    const newHash = computeContentHash(input.content);
+    const exactMatch = findExactHashMatch(repo, newHash);
+    if (exactMatch) {
+        return {
+            verdict: "DUPLICATE",
+            targetId: exactMatch,
+            reason: `exact contentHash match: ${newHash}`,
+            confidence: 1,
+            candidatesConsidered: 1,
+        };
+    }
+    // 2. 相似度召回
+    const engine = options.similarityEngine ?? new TokenJaccardSimilarityEngine(repo);
+    const topK = options.topK ?? 5;
+    const minSimilarity = options.minSimilarity ?? 0.3;
+    const candidates = await engine.findCandidates(`${input.title} ${input.content}`, { topK, minSimilarity });
+    // 3. triage
+    const triageProvider = options.triageProvider ?? new LocalHeuristicTriage();
+    const triage = await triageProvider.triage({
+        newTitle: input.title,
+        newContent: input.content,
+        candidates,
+    });
+    return {
+        verdict: triage.verdict,
+        targetId: triage.duplicateOf ?? triage.updateTarget,
+        reason: triage.reason,
+        confidence: triage.confidence,
+        candidatesConsidered: candidates.length,
+    };
+}
+/**
+ * 同步版本：仅使用默认启发式（TokenJaccardSimilarityEngine + LocalHeuristicTriage）
+ *
+ * 用于 engram_create 自动触发，避免 async 传染；
+ * 如需注入真正的 LLM triage，调用方应使用 async checkDuplicate 手动裁决，
+ * 然后根据 verdict 决定 createEngram / mergeEngram / 强化。
+ */
+export function checkDuplicateSync(ctx, input) {
+    const repo = ctx.repository;
+    const options = ctx.options ?? {};
+    // 1. 精确 hash 匹配
+    const newHash = computeContentHash(input.content);
+    const exactMatch = findExactHashMatch(repo, newHash);
+    if (exactMatch) {
+        return {
+            verdict: "DUPLICATE",
+            targetId: exactMatch,
+            reason: `exact contentHash match: ${newHash}`,
+            confidence: 1,
+            candidatesConsidered: 1,
+        };
+    }
+    // 2. 同步相似度召回（走 TokenJaccardSimilarityEngine.findCandidatesSync）
+    const injectedEngine = options.similarityEngine;
+    const topK = options.topK ?? 5;
+    const minSimilarity = options.minSimilarity ?? 0.3;
+    const candidates = injectedEngine &&
+        typeof injectedEngine
+            .findCandidatesSync === "function"
+        ? injectedEngine.findCandidatesSync(`${input.title} ${input.content}`, { topK, minSimilarity })
+        : new TokenJaccardSimilarityEngine(repo).findCandidatesSync(`${input.title} ${input.content}`, { topK, minSimilarity });
+    // 3. 同步 triage（仅 LocalHeuristicTriage 支持）
+    const triage = new LocalHeuristicTriage().triageSync({
+        newTitle: input.title,
+        newContent: input.content,
+        candidates,
+    });
+    return {
+        verdict: triage.verdict,
+        targetId: triage.duplicateOf ?? triage.updateTarget,
+        reason: triage.reason,
+        confidence: triage.confidence,
+        candidatesConsidered: candidates.length,
+    };
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/dedup/dedupe.js.map

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

package/dist/dedup/hash.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 精确匹配去重（contentHash）
+ *
+ * 最快、最可靠的去重方式：相同内容 → 相同 hash。
+ * 在调用相似度引擎之前先查 hash 表，命中直接 DUPLICATE。
+ *
+ * @module @co-engram/core/dedup
+ */
+import type { EngramId } from "../types/engram.js";
+import type { EngramRepository } from "../storage/repository.js";
+/**
+ * 在仓库中查找 contentHash 已存在的 engram
+ *
+ * 扫描所有 engram 的 meta.yaml 的 contentHash 字段。
+ * P1 简化：线性扫描（<1000 engram 时 OK）；P2 会引入 hash → id 索引。
+ *
+ * @returns 匹配的 engram id，或 null
+ */
+export declare function findExactHashMatch(repo: EngramRepository, hash: string): EngramId | null;
+/**
+ * 批量构建 hash → id 映射（用于高频查询场景）
+ *
+ * 首次调用 O(N)，之后 O(1)。
+ * 注意：仓库变更（create/update/delete）后需重建。
+ */
+export declare function buildHashIndex(repo: EngramRepository): Map<string, EngramId>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/dedup/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/dedup/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,GACX,QAAQ,GAAG,IAAI,CAUjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAO5E"}

package/dist/dedup/hash.js

@@ -0,0 +1,43 @@
+/**
+ * 精确匹配去重（contentHash）
+ *
+ * 最快、最可靠的去重方式：相同内容 → 相同 hash。
+ * 在调用相似度引擎之前先查 hash 表，命中直接 DUPLICATE。
+ *
+ * @module @co-engram/core/dedup
+ */
+/**
+ * 在仓库中查找 contentHash 已存在的 engram
+ *
+ * 扫描所有 engram 的 meta.yaml 的 contentHash 字段。
+ * P1 简化：线性扫描（<1000 engram 时 OK）；P2 会引入 hash → id 索引。
+ *
+ * @returns 匹配的 engram id，或 null
+ */
+export function findExactHashMatch(repo, hash) {
+    if (!hash)
+        return null;
+    const entries = repo.listEngrams();
+    for (const entry of entries) {
+        const engram = repo.readEngram(entry.id);
+        if (engram.contentHash === hash) {
+            return entry.id;
+        }
+    }
+    return null;
+}
+/**
+ * 批量构建 hash → id 映射（用于高频查询场景）
+ *
+ * 首次调用 O(N)，之后 O(1)。
+ * 注意：仓库变更（create/update/delete）后需重建。
+ */
+export function buildHashIndex(repo) {
+    const index = new Map();
+    for (const entry of repo.listEngrams()) {
+        const engram = repo.readEngram(entry.id);
+        index.set(engram.contentHash, entry.id);
+    }
+    return index;
+}
+//# sourceMappingURL=hash.js.map

package/dist/dedup/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/dedup/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAsB,EACtB,IAAY;IAEZ,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAsB;IACnD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/dedup/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dedup 模块 barrel
+ *
+ * @module @co-engram/core/dedup
+ */
+export * from "./types.js";
+export * from "./hash.js";
+export * from "./similar.js";
+export * from "./llm-triage.js";
+export * from "./merge.js";
+export * from "./dedupe.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dedup/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/dedup/index.js

@@ -0,0 +1,12 @@
+/**
+ * Dedup 模块 barrel
+ *
+ * @module @co-engram/core/dedup
+ */
+export * from "./types.js";
+export * from "./hash.js";
+export * from "./similar.js";
+export * from "./llm-triage.js";
+export * from "./merge.js";
+export * from "./dedupe.js";
+//# sourceMappingURL=index.js.map

package/dist/dedup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dedup/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}