berry-agent 0.1.0-alpha.1

package/dist/memory/diff.js

@@ -0,0 +1,238 @@
+/**
+ * memory 简报差分件（06 §6 差分纪律——批 18c-7）。
+ *
+ * 三件：①基线冻结不动（差分永不触发 systemPrompt 重建——重建时点唯
+ * 装配面 materialize）；②权威变化落 durable 事件 `memory/diff`（surface
+ * 类别——与 todo/write 同族；全量差分 last-wins + 落账时权威面指纹）；
+ * ③请求尾差分注入 = 派生视图（镜像纯函数于日志——无日志即无视图）。
+ *
+ * 不变式：`mirror == derive(日志, 基线指纹)`（last-wins 取最后一条指纹
+ * 匹配事件）。纪元首请求懒派生（mirror 置 null 未初始化）；派生非空而
+ * 当面零漂移的不一致即落清账事件 entries=[]——重启撞指纹自愈（上进程
+ * 面漂移后回摆、净变化恰归零且未及下一请求即退出，新进程基线指纹与
+ * 残留事件相同）。收敛清账：净变化为零 = 空差分，mirror 非空时落
+ * entries=[] 清账事件（视图归零）。
+ *
+ * **词面独立律**：appendEvent / fetchEvents 为装配面注入 seam（结构兼容
+ * 宿主会话面子集——memory 席 DAG 无 host 边）；appendEvent 缺席 = 降级
+ * 只渲染不落账（mirror 不锁步）。`memory/diff` 词汇 meta 随件导出，经
+ * `ctx.events.registerSessionEventType` 装配面作用域化注册（件内不静态
+ * 注册——注册器挂 effect 栈的回卷语义归装配面）。
+ */
+import { createHash } from 'node:crypto';
+import { getMessageRoleDefinition, registerMessageRole, } from '../contracts/index.js';
+import { shortIdOf } from './inject.js';
+import { MEMORY_DIFF_EPOCHS_LRU } from './types.js';
+/* ---------------- 词汇注册面（装配面消费） ---------------- */
+/** 差分事件类型词（06 §6 唯一 durable 出口——surface 类别） */
+export const MEMORY_DIFF_EVENT_TYPE = 'memory/diff';
+/** 差分事件词汇 meta（经 ctx.events.registerSessionEventType 装配面注册） */
+export const MEMORY_DIFF_EVENT_META = {
+    type: MEMORY_DIFF_EVENT_TYPE,
+    category: 'surface',
+    owner: 'memory',
+    tier: 'stable',
+    description: '记忆简报权威面自基线的变化（全量差分 last-wins + 基线指纹）',
+    ignorable: true,
+};
+/* ---------------- 面与指纹（纯函数） ---------------- */
+/**
+ * 简报基线拍平为权威面三元组（frozen + competitive + 晋升候选三流——
+ * §9.1「候选行进简报权威面」的物理承载；quoted 呈现层注记不进面；
+ * updatedAt/expiresAt 时效数据字段同 quoted 律不进面——06 §6 p-1 指纹
+ * 排除律：时间流逝不换纪元、差分不 churn）。
+ */
+export function faceOf(baseline) {
+    return [...baseline.frozen, ...baseline.competitive, ...baseline.candidates].map((e) => ({
+        id: e.id,
+        kind: e.kind,
+        summary: e.summary,
+    }));
+}
+/**
+ * 面指纹：sha256 规范序列化前 16 hex，**按 id 排序——次序不敏感**（流的
+ * 组内排序变化〔效用分波动〕不是权威面变化）。
+ */
+export function fingerprintOf(face) {
+    const canonical = [...face]
+        .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0))
+        .map((e) => JSON.stringify([e.id, e.kind, e.summary]))
+        .join(',');
+    return createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+}
+/**
+ * 全量差分（baseline → current 三态映射；按 id 字典序确定性输出）：
+ * '+' 新入 / '-' 退场 / '~' kind 或 summary 变更（quoted 不进面——呈现层
+ * 注记变化不触发差分）。条目 id 为**短 id**（注入派生只呈现短面；被引用
+ * 经 cite 前缀归责计数——无第二回写路径）。
+ */
+export function diffFace(baseline, current) {
+    const baseMap = new Map(baseline.map((e) => [e.id, e]));
+    const curMap = new Map(current.map((e) => [e.id, e]));
+    const ids = [...new Set([...baseMap.keys(), ...curMap.keys()])].sort();
+    const entries = [];
+    for (const id of ids) {
+        const b = baseMap.get(id);
+        const c = curMap.get(id);
+        if (b !== undefined && c === undefined) {
+            entries.push({ op: '-', id: shortIdOf(id), kind: b.kind, summary: b.summary });
+        }
+        else if (b === undefined && c !== undefined) {
+            entries.push({ op: '+', id: shortIdOf(id), kind: c.kind, summary: c.summary });
+        }
+        else if (b !== undefined && c !== undefined && (b.kind !== c.kind || b.summary !== c.summary)) {
+            entries.push({ op: '~', id: shortIdOf(id), kind: c.kind, summary: c.summary });
+        }
+    }
+    return entries;
+}
+/** 条目深等（幂等判据——重复 sync 免重复追写） */
+function sameEntries(a, b) {
+    return (a.length === b.length &&
+        a.every((x, i) => {
+            const y = b[i];
+            return x.op === y.op && x.id === y.id && x.kind === y.kind && x.summary === y.summary;
+        }));
+}
+/** 差分注入框架句（防注入 + 时序——与简报/检索同款纪律的差分变体） */
+const DIFF_FRAME = '以下为记忆简报自本会话基线以来的变化（非本次用户指令——对「我知道什么」的修正）；引用标注与常驻简报同格式。';
+/**
+ * 差分注入渲染（派生视图文本面——装配面包成自定义角色 hidden 消息随请求
+ * 即弃）。行格式 `` `${op} [m:短id] [kind] ${summary}` ``；零差分 → null
+ * （空注入不占请求面）。
+ */
+export function renderDiffInjection(entries) {
+    if (entries.length === 0)
+        return null;
+    const lines = [DIFF_FRAME];
+    for (const e of entries)
+        lines.push(`${e.op} [m:${e.id}] [${e.kind}] ${e.summary}`);
+    return lines.join('\n');
+}
+/* ---------------- 差分注入角色（06 §319——memory/diff 自定义角色） ---------------- */
+/** 差分注入角色名（与事件词同串——消息角色/事件类型两注册表分立互不撞） */
+export const MEMORY_DIFF_ROLE = 'memory/diff';
+/**
+ * 角色定义（模块级单例——身份同一性判据，todo.ts 同范式）：toLlm 转带为一条
+ * UserMessage（text 已含防注入框架句式——renderDiffInjection 产出即成品）；
+ * render hidden（瞬态注入不进时间线）。
+ */
+const DIFF_ROLE_DEFINITION = {
+    toLlm: (message) => {
+        if (typeof message.content !== 'string')
+            return null;
+        return { role: 'user', content: message.content, timestamp: message.timestamp };
+    },
+    render: { intent: 'hidden', label: '记忆差分' },
+};
+/**
+ * 注册差分注入角色（幂等 + 身份守卫——ensureTodoRole 同律）：装配面多次装配
+ * 常态；在册定义另有其身 → 域名窃据 fail-loud。
+ */
+export function ensureDiffRole() {
+    const existing = getMessageRoleDefinition(MEMORY_DIFF_ROLE);
+    if (existing !== undefined) {
+        if (existing !== DIFF_ROLE_DEFINITION) {
+            throw new Error(`消息角色 ${MEMORY_DIFF_ROLE} 已被其他定义占用（memory 域名窃据——差分注入拒绝分叉转写）`);
+        }
+        return;
+    }
+    registerMessageRole(MEMORY_DIFF_ROLE, DIFF_ROLE_DEFINITION);
+}
+/**
+ * 构建差分注入消息（LLM 形——context_transform 载荷消息批已是 LLM 形）：
+ * 经角色 toLlm 转写（ensureDiffRole 自足）。timestamp 取请求时点。
+ */
+export function diffInjectionMessage(text, timestamp) {
+    ensureDiffRole();
+    const converted = DIFF_ROLE_DEFINITION.toLlm?.({ role: MEMORY_DIFF_ROLE, content: text, timestamp });
+    // 定义体在本模块单源——string content 必产单条 user；运行时窄化防御仅挡未来改动
+    if (converted === undefined || converted === null || Array.isArray(converted) || converted.role !== 'user') {
+        return null;
+    }
+    return converted;
+}
+/** 建差分 tracker（epochs per-session Map——LRU 帽 256） */
+export function createDiffTracker(deps) {
+    const warn = deps.warn ?? (() => { });
+    const epochs = new Map();
+    /** LRU 触达（delete + set 复位插入序；超帽逐最旧） */
+    function touch(sessionId, epoch) {
+        epochs.delete(sessionId);
+        epochs.set(sessionId, epoch);
+        if (epochs.size > MEMORY_DIFF_EPOCHS_LRU) {
+            const oldest = epochs.keys().next().value;
+            if (oldest !== undefined)
+                epochs.delete(oldest);
+        }
+    }
+    /** 懒派生：last-wins 取日志最后一条指纹匹配事件（不变式右半的实现体） */
+    function deriveFromLog(sessionId, fingerprint) {
+        if (!deps.fetchEvents)
+            return [];
+        try {
+            const events = deps.fetchEvents(sessionId);
+            for (let i = events.length - 1; i >= 0; i--) {
+                const e = events[i];
+                if (e.type !== MEMORY_DIFF_EVENT_TYPE)
+                    continue;
+                const d = e.data;
+                if (typeof d === 'object' && d !== null && d.fingerprint === fingerprint && Array.isArray(d.entries)) {
+                    return d.entries;
+                }
+            }
+        }
+        catch (err) {
+            warn(`[memory] 差分懒派生尽力而为止步：${err instanceof Error ? err.message : String(err)}`);
+        }
+        return [];
+    }
+    /** 落账 + 锁步（appendEvent 缺席/失败 = 降级：不落账不锁步——派生视图纯函数于日志） */
+    function commit(data) {
+        if (!deps.appendEvent)
+            return false;
+        try {
+            deps.appendEvent(MEMORY_DIFF_EVENT_TYPE, data);
+            return true;
+        }
+        catch (err) {
+            warn(`[memory] 差分落账尽力而为止步：${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        }
+    }
+    return {
+        materialize(sessionId) {
+            if (sessionId === null)
+                return; // 诊断物化——只渲染不立纪元
+            const base = deps.face();
+            touch(sessionId, { base, fingerprint: fingerprintOf(base), mirror: null });
+        },
+        sync(sessionId) {
+            let epoch = epochs.get(sessionId);
+            if (epoch === undefined) {
+                // 未立纪元（诊断物化后首请求 / 纪元被逐）：以当面懒立——重立基线重派生，语义零变
+                const base = deps.face();
+                epoch = { base, fingerprint: fingerprintOf(base), mirror: null };
+                touch(sessionId, epoch);
+            }
+            else {
+                touch(sessionId, epoch); // LRU 触达
+            }
+            // 懒派生（纪元首请求——重启撞指纹自愈的发现位）
+            if (epoch.mirror === null)
+                epoch.mirror = deriveFromLog(sessionId, epoch.fingerprint);
+            const current = deps.face();
+            const diff = diffFace(epoch.base, current);
+            if (sameEntries(diff, epoch.mirror))
+                return epoch.mirror; // 幂等（重复 sync / 已追写态）
+            // 载荷指纹 = 落账时权威面（当前面）——重放 last-wins 与新基线指纹比对的重启自愈判据
+            const data = { entries: diff, fingerprint: fingerprintOf(current) };
+            if (commit(data))
+                epoch.mirror = diff; // 锁步只在落账成功后
+            return epoch.mirror;
+        },
+        renderInjection(entries) {
+            return renderDiffInjection(entries);
+        },
+    };
+}

package/dist/memory/extract.js

@@ -0,0 +1,181 @@
+/**
+ * memory 提取即时路（06 §4——确定性代码零 LLM，fire-and-forget）。
+ *
+ * **纠正检测**：真用户消息命中纠正触发词表（中英双语保守清单常量，起草值
+ * 随实测调）→ 立即提取 correction 候选（置信度 0.7 = 强证据——Mercury/Hermes
+ * 纠正即时存先例）。候选经 ingest 单点入库（§5 合并管线 + §8 写前扫描
+ * 内置——没有绕过合并的写路径）。
+ *
+ * **机器源滤除**（06 §4 即时路细则）：只对真用户消息入检——source 归因
+ * 仅三形参与：缺省（读侧视为 'user'）/ 'user' / 'channel:*'；压缩摘要载体
+ * （compaction）、插件注入（plugin:*）、调度（schedule）、子代理结算
+ * （subagent-*）等机器载体一律跳过——机器文本命中纠正触发词会被提取成
+ * 「用户亲口纠正」污染记忆库语义。
+ *
+ * **owner 恒 global**（06 §4 细则：纠正的是模型行为，跨项目成立——不走
+ * project 域）。**溯源精确事件位**：sourceRefs = {sessionId, seq}（信封
+ * seq——18c-2 工具面 seq:0 会话级位的精确位兑现）。
+ *
+ * **polluted 资格检查**（§4.1「两路入口同一资格检查」——批 18c-5 兑现）：
+ * 本件首步（源滤除之前）经 isSessionPolluted seam 检查——polluted 会话跳过
+ * 提取（外部源内容不做记忆源）；seam 缺席恒 eligible（无污染追踪装配的
+ * 装配面——装配根把周期路编排件的 pollution 追踪器接到此位）。
+ *
+ * **装配位**：本件为纯消费件——host 装配批（批 12 装载面后装配批）把
+ * onUserMessage 挂到 durable 事件流消费点；件自身不订阅。
+ *
+ * **词面独立律**：入检消息结构兼容 session UserMessageData（content
+ * string|块数组 + source 可选）——本件不 import session（memory→session
+ * 边的 18c-6 跨会话检索消费位仍占位）。
+ */
+import { parseEventSource } from '../contracts/index.js';
+import { recordCorrectedCites } from './cite.js';
+import { MEMORY_CONTENT_MAX_CHARS, MEMORY_SUMMARY_MAX_CHARS } from './types.js';
+/**
+ * 纠正触发词表（06 §4 中英双语保守清单——起草值随实测调）。
+ * 中文：直接子串匹配；英文：小写归一后子串匹配（含撇形两拼）。
+ */
+const CORRECTION_TRIGGERS_ZH = [
+    '不对',
+    '不是的',
+    '说错了',
+    '我说错了',
+    '我说的是',
+    '搞错了',
+    '弄错了',
+    '别再',
+    '不要再',
+    '纠正一下',
+    '应该是',
+];
+const CORRECTION_TRIGGERS_EN = [
+    "that's wrong",
+    'thats wrong',
+    "that's not right",
+    "that's incorrect",
+    "you're wrong",
+    'youre wrong',
+    'no, i said',
+    'i meant',
+    'i said,',
+    'stop doing',
+    "don't do that",
+    'dont do that',
+    'scratch that',
+];
+/** 纠正候选置信度（06 §4——强证据定值） */
+const CORRECTION_CONFIDENCE = 0.7;
+/** 摘要前缀（落码定形：统一前缀 + 全文截断——同文本恒同摘要，重放经 exact 合并幂等吸收） */
+const CORRECTION_SUMMARY_PREFIX = '用户纠正：';
+/** 摘要正文截长（起草值——总长仍在 MEMORY_SUMMARY_MAX_CHARS 帽内） */
+const CORRECTION_SUMMARY_TEXT_MAX = 100;
+/**
+ * 机器源滤除（06 §4 三形白名单）：缺省 / 'user' / 'channel:*' 入检；
+ * schedule / subagent-* / compaction / plugin:* 跳过。未知字面量按
+ * contracts.parseEventSource 归 user 同视（05 §3.1 读侧向前兼容）——
+ * 与「缺省（读侧视为 'user'）」同形。
+ */
+export function isEligibleUserSource(source) {
+    if (source === undefined)
+        return true;
+    const kind = parseEventSource(source).kind;
+    return kind === 'user' || kind === 'channel';
+}
+/**
+ * 消息纯文本面提取：string 直取；块数组拼 text 块（其余块形无关）；
+ * 无文本（纯图像等）→ null 不入检。
+ */
+export function userTextOf(content) {
+    if (typeof content === 'string')
+        return content === '' ? null : content;
+    const parts = [];
+    for (const block of content) {
+        if (block.type === 'text' && typeof block.text === 'string')
+            parts.push(block.text);
+    }
+    if (parts.length === 0)
+        return null;
+    const joined = parts.join('\n');
+    return joined === '' ? null : joined;
+}
+/**
+ * 纠正触发词检测：中文表子串直配；英文表小写归一子串配。
+ * 多命中取首（表序即优先序）；未命中 → null。
+ */
+export function detectCorrectionHit(text) {
+    for (const trigger of CORRECTION_TRIGGERS_ZH) {
+        if (text.includes(trigger))
+            return { trigger, text };
+    }
+    const lower = text.toLowerCase();
+    for (const trigger of CORRECTION_TRIGGERS_EN) {
+        if (lower.includes(trigger))
+            return { trigger, text };
+    }
+    return null;
+}
+/** 摘要形（落码定形：前缀 + 全文截 100 + 省略尾——同文本恒同串，exact 合并幂等键） */
+function correctionSummary(text) {
+    const body = text.length > CORRECTION_SUMMARY_TEXT_MAX ? `${text.slice(0, CORRECTION_SUMMARY_TEXT_MAX)}…` : text;
+    const summary = `${CORRECTION_SUMMARY_PREFIX}${body}`;
+    // 双保险截帽（前缀 + 截长恒在帽内；显式截防起草值未来调大越帽）
+    return summary.length > MEMORY_SUMMARY_MAX_CHARS ? summary.slice(0, MEMORY_SUMMARY_MAX_CHARS) : summary;
+}
+/**
+ * 纠正候选组装（06 §4 细则全档：kind correction / 置信度 0.7 / owner 恒
+ * global / 溯源精确事件位）。content 截至帽内（提取尽力而为——超长纠正
+ * 截尾保知识不整条拒写；截断点前文本仍完整过写前扫描）。
+ */
+export function buildCorrectionCandidate(hit, sessionId, seq) {
+    return {
+        ownerKey: 'global',
+        kind: 'correction',
+        summary: correctionSummary(hit.text),
+        content: hit.text.length > MEMORY_CONTENT_MAX_CHARS ? hit.text.slice(0, MEMORY_CONTENT_MAX_CHARS) : hit.text,
+        confidence: CORRECTION_CONFIDENCE,
+        sourceRefs: [{ sessionId, seq }],
+    };
+}
+/**
+ * 即时路编排件工厂：资格首步 → 源滤除 → 文本提取 → 触发词检测 →（命中即记
+ * 负效用回看 +）候选组装 → ingest 单点。第二动作（负效用回写）与候选 ingest
+ * **失败路径分立**：回写件自持 try/catch（cite.ts recordCorrectedCites 尽力而
+ * 为），候选走 §5 合并被拒（secret 扫描等）不连带负效用落账。
+ */
+export function createImmediateExtractor(deps) {
+    const warn = deps.warn ?? (() => { });
+    return {
+        onUserMessage(sessionId, seq, data) {
+            try {
+                // 资格检查首步（§4.1——源滤除之前；polluted 会话两动作同跳：提取与
+                // 负效用回写均为派生面，污染可注入——派生面从严）
+                if (deps.isSessionPolluted !== undefined && deps.isSessionPolluted(sessionId)) {
+                    return { extracted: false };
+                }
+                if (!isEligibleUserSource(data.source))
+                    return { extracted: false };
+                const text = userTextOf(data.content);
+                if (text === null)
+                    return { extracted: false };
+                const hit = detectCorrectionHit(text);
+                if (hit === null)
+                    return { extracted: false };
+                // —— 第二动作：纠正负效用回看（§4——触发位 = 纠正**命中**即记；回看
+                // 紧邻前一条 assistant 文本全复用 §6 解析面；件内自持 try/catch，
+                // 候选 ingest 被拒不连带）——
+                const previousAssistantText = deps.lastAssistantText?.(sessionId) ?? null;
+                if (previousAssistantText !== null && previousAssistantText !== '') {
+                    recordCorrectedCites(deps.dao, sessionId, previousAssistantText, warn);
+                }
+                deps.dao.ingest(buildCorrectionCandidate(hit, sessionId, seq));
+                return { extracted: true };
+            }
+            catch (error) {
+                // 尽力而为（06 §4——提取失败不重试不反噬；写前扫描拒写〔secret 命中〕
+                // 等被拒候选在此吞——进程日志是唯一观测面；负效用已在前位独立落账）
+                warn(`memory 即时路提取失败（尽力而为跳过）：${error instanceof Error ? error.message : String(error)}`);
+                return { extracted: false };
+            }
+        },
+    };
+}

package/dist/memory/fts.js

@@ -0,0 +1,58 @@
+/**
+ * session_fts 消费件（批 18c-6——06 §10 + 05 §9 追记）：激活期对账策略位
+ * （ensureFtsIndex）+ snippet 切窗纯函数（snippetOf）。
+ *
+ * **维护归属映射**（05 §9 追记②——结构对账住 persist / 策略位与消费位住
+ * core:memory）：写入档同批同事务与删除档已是 persist 写路径的结构性组成
+ * （「单事件原子」免费成立），本件只持**策略位**——激活期触发抽样审计、
+ * 发现缺口即全量重建（派生物不修不补，重建即修复）；装配面（host 装配根）
+ * 在 memory 装载序激活时调用一次。
+ *
+ * **词面独立律**：FtsMaintenanceFace / SessionFtsSearchFace 均为结构兼容
+ * persist Store 公开面的窄 seam——host 装配批直传 Store 真身，compat 互证
+ * 见 fts.test（真 Store 全环）。
+ */
+import { MEMORY_SNIPPET_AFTER, MEMORY_SNIPPET_BEFORE, } from './types.js';
+/* ---------------- snippet 切窗（纯函数） ---------------- */
+/**
+ * 命中 body 切 snippet（06 §10 定形注②）：命中位前 {@link MEMORY_SNIPPET_BEFORE}
+ * 后 {@link MEMORY_SNIPPET_AFTER} 字符、截断端补省略号；命中词大小写不敏感
+ * 定位（trigram 分词器大小写不折叠对齐——lowercase 双侧比对）；命中词缺席
+ * （理论不至——trigram 子串语义下查询必为 body 子串；防御位）退化为 body
+ * 头窗。查询词先消毒（剥引号——与检索侧字符串字面量包裹同族的用户输入面）。
+ */
+export function snippetOf(body, query) {
+    const sanitized = query.replaceAll('"', ' ').trim();
+    const lowerBody = body.toLowerCase();
+    const idx = sanitized === '' ? -1 : lowerBody.indexOf(sanitized.toLowerCase());
+    if (idx < 0) {
+        // 防御位：无命中词可定位——头窗呈现（前 BEFORE+AFTER 字符）
+        const head = body.slice(0, MEMORY_SNIPPET_BEFORE + MEMORY_SNIPPET_AFTER);
+        return head.length < body.length ? `${head}…` : head;
+    }
+    const start = Math.max(0, idx - MEMORY_SNIPPET_BEFORE);
+    const end = Math.min(body.length, idx + sanitized.length + MEMORY_SNIPPET_AFTER);
+    const prefix = start > 0 ? '…' : '';
+    const suffix = end < body.length ? '…' : '';
+    return `${prefix}${body.slice(start, end)}${suffix}`;
+}
+/**
+ * 激活期对账（memory 装载序调用一次）：抽样审计 → 有缺口即全量重建
+ * （05 §9 对账三档第三档消费位——派生物不修不补，重建即修复）。
+ * 永不抛——对账失败不阻断装载（warn 吞，索引退化可检索面降级不致命）。
+ */
+export function ensureFtsIndex(deps) {
+    const warn = deps.warn ?? (() => { });
+    try {
+        const audit = deps.face.auditFts(deps.sampleCount);
+        if (audit.mismatches.length === 0)
+            return { audit };
+        warn(`session_fts 抽样对账发现缺口（${audit.mismatches.length}/${audit.checked} 会话）——全量重建：` +
+            audit.mismatches.map((m) => `${m.sessionId} 期望 ${m.expected} 实有 ${m.actual}`).join('；'));
+        return { audit, rebuilt: deps.face.rebuildFts() };
+    }
+    catch (error) {
+        warn(`session_fts 激活期对账失败（尽力而为跳过）：${error instanceof Error ? error.message : String(error)}`);
+        return { audit: { checked: 0, mismatches: [] } };
+    }
+}

package/dist/memory/index.js

@@ -0,0 +1,42 @@
+/**
+ * memory 模块公开面（core:memory——06 篇 §1-§10 使用进化机制落码件；批 18c）。
+ *
+ * 单向 DAG（02 §4.1 memory 席 deps = contracts + context + session + persist）。
+ * 批 18c-1 域 = 表族三迁移槽 + 入库单点 DAO（secret 扫描 + 版本链拍照）+
+ * 合并三分支纯函数 + 效用综合分；18c-2 域 = 持有面动词 + 检索/访问面 +
+ * 工具面九件（createMemoryTools）；18c-3 域 = 提取即时路（纠正检测纯函数 +
+ * fire-and-forget 编排件——机器源滤除 + owner 恒 global + 精确事件位溯源）；
+ * 18c-4 域 = 注入两路（常驻简报 memory/core builder + 按需检索 recall 瞬态
+ * 注入——读出消毒统一罩工具读面与注入面、流水 op='recall' 分账）；
+ * 18c-5 域 = 周期路（review 编排 + 审阅窗转录 + JSON 三试）+ consolidation
+ * 整理拍（absorb/decay/sweepExpired 物理承载 + 护栏四件）+ polluted 会话
+ * 资格（判据通配 + 状态机 + 两路入口挂检）；18c-6 域 = 跨会话检索
+ * （session_fts 消费件——激活期对账策略位 ensureFtsIndex + snippet 切窗
+ * + memory_search 联合检索扩面 [历史会话] 行）；18c-7 域 = 晋升桥候选
+ * 点名（简报尾行两形 + BriefBaseline.candidates 权威流）+ 效用进化
+ * （cite 引用回写件 cite.ts + dao markUsed/resolveShortId）+ 简报差分
+ * （memory/diff durable 词汇 + 纪元 tracker epochs LRU + 懒派生自愈）；
+ * 18c-8 域 = 持有面收口（sweep 双清同拍——TTL 物化 + 访问日志 90 天窗口清扫）
+ * + 导入导出件（port.ts JSONL 序列化/解析 + command.ts 两命令处理器；
+ * provenance 写入面与 skill_manage 三动作经对账钉死已随 14b 落）。
+ * 迁移 export-only（host 装配根机械聚合入
+ * 宿主单链——05 §6.4）；错误码注册（codes.ts）随本面引入生效。
+ */
+import './codes.js';
+export { MEMORY_KINDS, MEMORY_STATUSES, MEMORY_FUZZY_JACCARD_THRESHOLD, MEMORY_POLARITY_JACCARD_THRESHOLD, MEMORY_SOURCE_REFS_CAP, MEMORY_SUMMARY_MAX_CHARS, MEMORY_CONTENT_MAX_CHARS, MEMORY_SEARCH_DEFAULT_LIMIT, MEMORY_SEARCH_MAX_LIMIT, MEMORY_ACCESS_LOG_DEFAULT_LIMIT, MEMORY_ACCESS_LOG_MAX_LIMIT, MEMORY_ACCESS_AGGREGATE_TOP_N, MEMORY_SKILL_NAME_RE, MEMORY_SKILL_NAME_MAX, MEMORY_RECENT_LIMIT, MEMORY_DAY_MS, MEMORY_BRIEF_MARKER, MEMORY_BRIEF_CHAR_LIMIT, MEMORY_BRIEF_TOP_N, MEMORY_BRIEF_STALE_DAYS, MEMORY_RECALL_QUERY_MAX_CHARS, MEMORY_RECALL_TOP_K, MEMORY_RECALL_POOL_FACTOR, MEMORY_RECALL_ROLE, MEMORY_REVIEW_TURN_THRESHOLD, MEMORY_REVIEW_TOOL_CALL_THRESHOLD, MEMORY_REVIEW_WINDOW_TURNS, MEMORY_REVIEW_CONFIDENCE, MEMORY_CONSOLIDATION_STALE_DAYS, MEMORY_OWNER_CAPACITY, MEMORY_CONSOLIDATION_ANCHOR_MS, MEMORY_DECAY_FACTOR, MEMORY_POLLUTION_DEFAULT_PATTERNS, MEMORY_SNIPPET_BEFORE, MEMORY_SNIPPET_AFTER, MEMORY_PROMOTION_KINDS, MEMORY_PROMOTION_TOP_N, MEMORY_PROMOTION_EVIDENCE_MIN, MEMORY_PROMOTION_USAGE_MIN, MEMORY_PROMOTION_DISTINCT_SESSIONS_MIN, MEMORY_DIFF_EPOCHS_LRU, MEMORY_LAST_ASSISTANT_TEXT_LRU, MEMORY_ACCESS_WINDOW_DAYS, MEMORY_EXPORT_MAGIC, MEMORY_EXPORT_FORMAT_VERSION, REVIEW_KINDS, llmTextOf, } from './types.js';
+export { MEMORY_MIGRATIONS } from './migration.js';
+export { scanForSecrets, sanitizeEntryForReadout } from './scan.js';
+export { tokenizeForMerge, normalizeForMerge, jaccard, detectPolarityConflict, decideMerge, utilityScore, unionSourceRefs, } from './merge.js';
+export { createMemoryDao, uuidv7 } from './dao.js';
+export { createMemoryTools } from './tools.js';
+export { isEligibleUserSource, userTextOf, detectCorrectionHit, buildCorrectionCandidate, createImmediateExtractor, } from './extract.js';
+export { MEMORY_CITE_RE, shortIdOf, freshnessLabel, briefBaseline, renderCoreBrief, buildCoreBrief, recallForQuery, ensureRecallRole, recallInjectionMessage, } from './inject.js';
+export { matchesToolPattern, isPollutingToolName, createPollutionTracker } from './pollution.js';
+export { parseJsonPayload, transcribeForReview, runMemoryReview } from './review.js';
+export { createConsolidator } from './consolidate.js';
+export { sliceReviewWindow, createMemoryCycle } from './cycle.js';
+export { snippetOf, ensureFtsIndex } from './fts.js';
+export { parseCitations, createCiteRecorder, recordCorrectedCites, createLastAssistantTextCache, assistantTextOf, } from './cite.js';
+export { MEMORY_DIFF_EVENT_TYPE, MEMORY_DIFF_EVENT_META, MEMORY_DIFF_ROLE, faceOf, fingerprintOf, diffFace, renderDiffInjection, ensureDiffRole, diffInjectionMessage, createDiffTracker, } from './diff.js';
+export { isWithinRoots, exportRowOf, serializeMemoryExport, parseMemoryImportHeader, parseMemoryImportRow, runMemoryImport, buildMemoryExport, } from './port.js';
+export { MEMORY_EXPORT_USAGE, MEMORY_IMPORT_USAGE, runMemoryExportCommand, runMemoryImportCommand } from './command.js';