dsh-prime-memory 0.22.2 → 0.24.1

package/dist/index.js

@@ -37,12 +37,17 @@ import { SlotStore } from './store/slots.js';
 import { registerMemoryTools } from './tools/index.js';
 import { registerSlotTools } from './tools/slots.js';
 import { registerSlotRecall } from './hooks/slot-recall.js';
+import { registerObsoleteNotice } from './hooks/obsolete-notice.js';
 import { RoomRegistryStore } from './store/rooms-registry.js';
 import { MemorySourceStore } from './store/memory-sources.js';
 import { SkillStore } from './store/skill-store.js';
 import { registerSkillRecall } from './hooks/skill-recall.js';
 import { registerSkillTools } from './tools/skills.js';
 import { RecallUsageStore } from './store/recall-usage.js';
+import { RecallFeedbackStore } from './store/recall-feedback.js';
+import { MdLedgerStore } from './store/memory-md-ledger.js';
+import { makeFileSyncHook } from './store/memory-md-sync.js';
+import { ObsoleteNoticeStore } from './store/obsolete-notices.js';
 import { registerSlotsProjection } from './projection/slots.js';
 import { registerRecallProjection } from './projection/recall.js';
 import { errDetail, withFileLog } from './util/filelog.js';
@@ -170,7 +175,10 @@ export async function apply(ctx, config) {
         l0: new L0Store(dataDir, db, embed, logger),
         l1: new L1Store(dataDir, db, embed, config.recall.strategy, logger, config.recall.decayHalfLifeDays, 
         // §D 第 3 路:图谱回链。图谱不可用时 searchNodes 自带 no-op,不影响双路。
-        (query, limit, family) => db.graphStore.searchNodes(query, limit, family ? [family] : undefined)),
+        (query, limit, family) => db.graphStore.searchNodes(query, limit, family ? [family] : undefined), 
+        // 投射开着才给没名字的新记录起名（“关时零动作”这条承诺不改）。
+        // 传函数而不是布尔：读的是当前配置对象，不把启动那一刻的值钉进 store。
+        () => config.memExport?.enabled === true),
         // L2/L3 分族隔离:各自目录与文件(scenes/chat|work、persona-chat|work.md)
         scenes: {
             chat: new SceneStore(dataDir, 'chat', logger),
@@ -183,6 +191,11 @@ export async function apply(ctx, config) {
         state: new StateStore(StateStore.pathFor(dataDir), logger),
         // 会话“活召回集”（G-live）：sessionKey → 本会话已注入未压缩的记录 id；持久化，旧会话重开载回。
         recalled: new SessionRecalledStore(dataDir, logger),
+        // 召回相关度反馈与过时播报队列（装配于下方，需 await init）。
+        feedback: undefined,
+        notices: undefined,
+        // md 投射指纹账本（N9；装配于下方，需 await init）。
+        mdLedger: undefined,
         // 激活槽位(active slot):独立 slots.json,高频小改不拖累 checkpoint 原子写
         slots: new SlotStore(SlotStore.pathFor(dataDir), logger, {
             maxSlots: config.slots.maxSlots,
@@ -381,6 +394,40 @@ export async function apply(ctx, config) {
     const recallUsage = new RecallUsageStore(dataDir, logger);
     await recallUsage.init();
     stores.usage = recallUsage;
+    // 召回相关度反馈（人在召回卡上打 -1..5）与「已声明过时」待播报队列。
+    // 两个都是低频用户动作 → 立即落盘；sidecar 缺席/损坏只降级为只读，不阻断任何读路径。
+    const recallFeedback = new RecallFeedbackStore(dataDir, logger);
+    await recallFeedback.init();
+    stores.feedback = recallFeedback;
+    const obsoleteNotices = new ObsoleteNoticeStore(dataDir, logger);
+    await obsoleteNotices.init();
+    stores.notices = obsoleteNotices;
+    // md 投射指纹账本（N9）：派生态，缺席/损坏只降级为只读，不弄挂任何读路径。
+    // 它与 feedback/notices 同属“库外 sidecar”，不进快照哈希投影。
+    const mdLedger = new MdLedgerStore(dataDir, logger);
+    await mdLedger.init();
+    stores.mdLedger = mdLedger;
+    // 库→文件投射的跟随钩子：**收口在 `L1Store` 的四个汇流口**（appendNew / retire / restore / rename），
+    // 不在这里往调用方分发。不变式本体在 `store/memory-md-sync.ts`。
+    // 为什么只能装配层建：工具面/冲突裁决各自看不到 cfg + ledger + dataDir 的完整视野。
+    const fileSync = makeFileSyncHook({
+        getByIds: (list) => stores.l1.getByIds([...list]),
+        // 现读生效配置（volatile 热更后不必重启）：与 RPC 分发用同一个 `effectiveCfg` 口径。
+        exportCfg: () => {
+            const exp = effectiveCfg(config, live).memExport;
+            return {
+                enabled: exp?.enabled === true,
+                root: exp?.root,
+                maxRecords: exp?.maxRecords ?? 2000,
+                timeBudgetMs: exp?.timeBudgetMs ?? 120_000,
+            };
+        },
+        dataDir,
+        ledger: () => stores.mdLedger,
+        logger,
+    });
+    // 晚绑定：`stores.l1` 在 md 账本之前就建好了，这里只把钩子接上去。
+    stores.l1.setFileSyncHook(fileSync);
     const recall = registerRecall(ctx, config, stores, logger, live, modes, dataDir, recallUsage);
     runner.setAfterRun(recall.invalidateProfile);
     registerMemoryTools(ctx, config, stores, logger, modes, live, ruminate, storageOk ? roomRegistry : undefined);
@@ -398,7 +445,10 @@ export async function apply(ctx, config) {
     registerSlotsProjection(ctx, stores.slots, stores.l1);
     // memoryRecall 投影：本会话“已注入且未被压缩覆盖”的召回集（会话感知，init 取 header.id），
     // 与常驻槽位是两条轴：那个是手动 pin 的硬注入约定，这个是非常驻的相关性浮现结果。
-    registerRecallProjection(ctx, stores.recalled, stores.l1);
+    // 带上反馈面：条目要显示人已经打过的那一笔（rating）。
+    registerRecallProjection(ctx, stores.recalled, stores.l1, recallFeedback);
+    // 人打 -1 声明过时后，下一轮向模型一次性播报“这条已退场、别再依据它作答”。
+    registerObsoleteNotice(ctx, config, obsoleteNotices, logger);
     void slotRecall;
     registerMemoryRpc(ctx, config, stores, logger, {
         degraded: () => !storageOk || db.isDegraded(),

package/dist/memory-types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 记忆类型词表的**唯一事实源**（pm-name-distill A 节）。
+ *
+ * 在此之前，"类型全集"手抄在四处：`MEMORY_TYPE_DIRS`（投射目录）、`ADD_TYPES`（写入白名单）、
+ * `TYPE_LABELS`（面板标签）、抽取/去重 prompt 的枚举串。四处各自演化过——宿主记忆分类
+ * （29 类）与插件 7 类字面交集为空，`memory_add` 把外部分类**静默改写**成 `episodic`，
+ * 而 memport 的警告文案却承诺"按原样透传"。同一件事两套口径，漂移只是时间问题。
+ *
+ * 词表内容 = **宿主 29 类原名**（与 memport 导入的分类字面一致，不再造 `dev_*`/`exp_*`
+ * 那层映射——映射层每多一处就多一处漂移）+ 插件旧 7 类（库里 1166 条正带着它们，
+ * 不许一夜之间全变 `unclassified`）+ `unclassified` 兜底目录。
+ *
+ * 本文件必须**零依赖运行**（不引 node: 模块）：client 侧与 server 侧同源消费，
+ * prompt 渲染也从这里派生。
+ */
+/** 类型族（与 `types.ts` 的 `MemoryFamily` 同域；这里重述字面量以免运行时循环引用）。 */
+export type TypeFamily = 'chat' | 'work';
+/** 宿主记忆分类的 29 类原名（实测自宿主记忆目录树，条数分布见计划 findings 第一节）。 */
+export declare const HOST_MEMORY_TYPES: readonly string[];
+/** 插件早期 7 类（蒸馏管线现役词表；库里存量正带着，永久保留）。 */
+export declare const LEGACY_MEMORY_TYPES: readonly string[];
+/**
+ * 兜底目录名（不是可赋值类型）：不在词表的 `type` 原值照旧写进 frontmatter，
+ * 只在**目录层**归这里。归进某个 `work_*` 会静默把这批记录的 family 挑到 work 侧
+ * （family 决定共享面），所以它自成一桶、族取 chat。
+ */
+export declare const UNCLASSIFIED_DIR = "unclassified";
+/**
+ * 非词表 type 进入写路径时的降级目标。旧代码在 `tools/index.ts` 里把 `'episodic'`
+ * 当字面量散写；集中到这里，降级行为至少有一个可 grep 的名字。
+ */
+export declare const DOWNGRADE_TARGET = "episodic";
+/** 可赋值类型全集（宿主 29 + 旧 7 = 36；`unclassified` 不在其中——它是目录，不是类型）。 */
+export declare const MEMORY_TYPE_VOCABULARY: ReadonlySet<string>;
+/**
+ * 族映射（新旧同放）。旧 `familyForType` 靠 `type.startsWith('work')` 前缀猜族，
+ * 新词表里 `project_*`/`development_*`/`*_experience` 都是 work 族却不带 work 前缀——
+ * 前缀判定会把它们静默归进 chat，而 family 决定召回/浏览/去重的共享面。
+ */
+export declare const TYPE_FAMILY_MAP: Readonly<Record<string, TypeFamily>>;
+/** 类型 → 面板中文标签（真源；client 侧经 `list-records` 的 `typeCatalog` 下发消费）。 */
+export declare const MEMORY_TYPE_LABELS: Readonly<Record<string, string>>;
+/** 投射目录全集 = 可赋值类型 + 兜底桶（37 个）。`memory-md.ts` 的白名单从这里派生。 */
+export declare function memoryTypeDirs(): ReadonlySet<string>;
+/** 是否为词表内类型（写路径白名单判据；`unclassified` 不算——没人该主动赋它）。 */
+export declare function isKnownType(type: string): boolean;
+/** 族查询：查表；未知值回落旧前缀规则并交给 `onUnknownFamily` 提醒一次。 */
+export declare function familyOf(type: string): TypeFamily;
+/**
+ * CSS 类名用的 slug（`work_fact` → `work-fact`）。
+ *
+ * 面板标签类名以前直接拼 `type` 原值（下划线），而主题 CSS 定义的是连字符类——
+ * `dsh-mem-tag-work_fact` 匹配不上 `.dsh-mem-tag-work-fact`，标签无色（F11 既有断裂）。
+ * 拼接点统一走这里，判据只有一份。
+ */
+export declare function slugOf(type: string): string;
+/** 面板词表目录（下发给 client 的 `typeCatalog`；含兜底桶，顺序 = 旧 7 → 宿主 29 → 兜底）。 */
+export declare function typeCatalogEntries(): Array<{
+    id: string;
+    label: string;
+}>;
+/** chat / work 族的可赋值类型（prompt 枚举串从这里渲染，不再手抄）。 */
+export declare function typesOfFamily(family: TypeFamily): string[];
+/** prompt/工具描述用的枚举串（`|` 或 `/` 连接，顺序稳定：旧 7 在前）。 */
+export declare function typeEnumSep(sep: string, family?: TypeFamily): string;
+/** 测试/宿主接线用：替换未知族的提醒出口（传 undefined 恢复 console）。 */
+export declare function setFamilyWarnSink(sink?: (msg: string) => void): void;
+/** 清空"已提醒"集（用例要能反复断言只 warn 一次）。 */
+export declare function resetFamilyWarned(): void;

package/dist/memory-types.js

@@ -0,0 +1,165 @@
+/**
+ * 记忆类型词表的**唯一事实源**（pm-name-distill A 节）。
+ *
+ * 在此之前，"类型全集"手抄在四处：`MEMORY_TYPE_DIRS`（投射目录）、`ADD_TYPES`（写入白名单）、
+ * `TYPE_LABELS`（面板标签）、抽取/去重 prompt 的枚举串。四处各自演化过——宿主记忆分类
+ * （29 类）与插件 7 类字面交集为空，`memory_add` 把外部分类**静默改写**成 `episodic`，
+ * 而 memport 的警告文案却承诺"按原样透传"。同一件事两套口径，漂移只是时间问题。
+ *
+ * 词表内容 = **宿主 29 类原名**（与 memport 导入的分类字面一致，不再造 `dev_*`/`exp_*`
+ * 那层映射——映射层每多一处就多一处漂移）+ 插件旧 7 类（库里 1166 条正带着它们，
+ * 不许一夜之间全变 `unclassified`）+ `unclassified` 兜底目录。
+ *
+ * 本文件必须**零依赖运行**（不引 node: 模块）：client 侧与 server 侧同源消费，
+ * prompt 渲染也从这里派生。
+ */
+/** 宿主记忆分类的 29 类原名（实测自宿主记忆目录树，条数分布见计划 findings 第一节）。 */
+export const HOST_MEMORY_TYPES = [
+    // —— 个人可见（chat 族）：用户画像的四类 ——
+    'user_info', 'user_hobby', 'user_communication', 'user_behavior',
+    // —— 项目轴（work 族）——
+    'project_introduction', 'project_tech_stack', 'project_architecture',
+    'project_build_configuration', 'project_dependency_configuration', 'project_ide_configuration',
+    'project_scm_configuration', 'project_environment_configuration', 'project_rule',
+    // —— 开发规范轴（work 族）——
+    'development_code_specification', 'development_practice_specification',
+    'development_test_specification', 'development_comment_specification',
+    // —— 经验轴（work 族）——
+    'task_summary_experience', 'task_breakdown_experience', 'task_flow_experience', 'task_experience',
+    'tool_experience', 'mcp_experience', 'skill_experience', 'learned_skill_experience',
+    'expert_experience', 'important_decision_experience', 'common_pitfalls_experience',
+    'history_task_reference_files',
+];
+/** 插件早期 7 类（蒸馏管线现役词表；库里存量正带着，永久保留）。 */
+export const LEGACY_MEMORY_TYPES = [
+    'persona', 'episodic', 'instruction', 'work_fact', 'work_task', 'work_method', 'work_artifact',
+];
+/**
+ * 兜底目录名（不是可赋值类型）：不在词表的 `type` 原值照旧写进 frontmatter，
+ * 只在**目录层**归这里。归进某个 `work_*` 会静默把这批记录的 family 挑到 work 侧
+ * （family 决定共享面），所以它自成一桶、族取 chat。
+ */
+export const UNCLASSIFIED_DIR = 'unclassified';
+/**
+ * 非词表 type 进入写路径时的降级目标。旧代码在 `tools/index.ts` 里把 `'episodic'`
+ * 当字面量散写；集中到这里，降级行为至少有一个可 grep 的名字。
+ */
+export const DOWNGRADE_TARGET = 'episodic';
+/** 可赋值类型全集（宿主 29 + 旧 7 = 36；`unclassified` 不在其中——它是目录，不是类型）。 */
+export const MEMORY_TYPE_VOCABULARY = new Set([
+    ...LEGACY_MEMORY_TYPES, ...HOST_MEMORY_TYPES,
+]);
+/**
+ * 族映射（新旧同放）。旧 `familyForType` 靠 `type.startsWith('work')` 前缀猜族，
+ * 新词表里 `project_*`/`development_*`/`*_experience` 都是 work 族却不带 work 前缀——
+ * 前缀判定会把它们静默归进 chat，而 family 决定召回/浏览/去重的共享面。
+ */
+export const TYPE_FAMILY_MAP = Object.freeze((() => {
+    const map = {};
+    for (const t of LEGACY_MEMORY_TYPES)
+        map[t] = t.startsWith('work') ? 'work' : 'chat';
+    for (const t of HOST_MEMORY_TYPES)
+        map[t] = t.startsWith('user_') ? 'chat' : 'work';
+    map[UNCLASSIFIED_DIR] = 'chat';
+    return map;
+})());
+/** 类型 → 面板中文标签（真源；client 侧经 `list-records` 的 `typeCatalog` 下发消费）。 */
+export const MEMORY_TYPE_LABELS = Object.freeze({
+    persona: '画像偏好',
+    episodic: '客观事件',
+    instruction: '全局指令',
+    work_fact: '工作事实',
+    work_task: '工作任务',
+    work_method: '工作方法',
+    work_artifact: '工作资产',
+    user_info: '用户信息',
+    user_hobby: '用户爱好',
+    user_communication: '沟通风格',
+    user_behavior: '行为规范',
+    project_introduction: '项目介绍',
+    project_tech_stack: '技术栈',
+    project_architecture: '架构设计',
+    project_build_configuration: '构建配置',
+    project_dependency_configuration: '依赖配置',
+    project_ide_configuration: 'IDE 配置',
+    project_scm_configuration: '版本控制配置',
+    project_environment_configuration: '环境配置',
+    project_rule: '项目规则',
+    development_code_specification: '代码规范',
+    development_practice_specification: '实践规范',
+    development_test_specification: '测试规范',
+    development_comment_specification: '注释规范',
+    task_summary_experience: '任务总结',
+    task_breakdown_experience: '任务拆解',
+    task_flow_experience: '任务流程',
+    task_experience: '任务经验',
+    tool_experience: '工具经验',
+    mcp_experience: 'MCP 经验',
+    skill_experience: '技能经验',
+    learned_skill_experience: '习得技能',
+    expert_experience: '专家经验',
+    important_decision_experience: '重要决策',
+    common_pitfalls_experience: '常见陷阱',
+    history_task_reference_files: '历史参考文件',
+    [UNCLASSIFIED_DIR]: '未分类',
+});
+/** 投射目录全集 = 可赋值类型 + 兜底桶（37 个）。`memory-md.ts` 的白名单从这里派生。 */
+export function memoryTypeDirs() {
+    return new Set([...MEMORY_TYPE_VOCABULARY, UNCLASSIFIED_DIR]);
+}
+/** 是否为词表内类型（写路径白名单判据；`unclassified` 不算——没人该主动赋它）。 */
+export function isKnownType(type) {
+    return MEMORY_TYPE_VOCABULARY.has(type);
+}
+/** 族查询：查表；未知值回落旧前缀规则并交给 `onUnknownFamily` 提醒一次。 */
+export function familyOf(type) {
+    const f = TYPE_FAMILY_MAP[type];
+    if (f !== undefined)
+        return f;
+    noteUnknown(type);
+    return type.startsWith('work') ? 'work' : 'chat';
+}
+/**
+ * CSS 类名用的 slug（`work_fact` → `work-fact`）。
+ *
+ * 面板标签类名以前直接拼 `type` 原值（下划线），而主题 CSS 定义的是连字符类——
+ * `dsh-mem-tag-work_fact` 匹配不上 `.dsh-mem-tag-work-fact`，标签无色（F11 既有断裂）。
+ * 拼接点统一走这里，判据只有一份。
+ */
+export function slugOf(type) {
+    return type.replace(/_/g, '-');
+}
+/** 面板词表目录（下发给 client 的 `typeCatalog`；含兜底桶，顺序 = 旧 7 → 宿主 29 → 兜底）。 */
+export function typeCatalogEntries() {
+    return [...LEGACY_MEMORY_TYPES, ...HOST_MEMORY_TYPES, UNCLASSIFIED_DIR].map((id) => ({
+        id,
+        label: MEMORY_TYPE_LABELS[id] ?? id,
+    }));
+}
+/** chat / work 族的可赋值类型（prompt 枚举串从这里渲染，不再手抄）。 */
+export function typesOfFamily(family) {
+    return [...MEMORY_TYPE_VOCABULARY].filter((t) => TYPE_FAMILY_MAP[t] === family);
+}
+/** prompt/工具描述用的枚举串（`|` 或 `/` 连接，顺序稳定：旧 7 在前）。 */
+export function typeEnumSep(sep, family) {
+    const list = family === undefined ? [...LEGACY_MEMORY_TYPES, ...HOST_MEMORY_TYPES] : typesOfFamily(family);
+    return list.join(sep);
+}
+// —— 未知类型的"只提醒一次"：诊断集封到 64 个就不再记录（宁可漏提醒，不让集合无限吃内存）。
+const warnedUnknownFamilies = new Set();
+let warnSink = (msg) => console.warn(msg);
+/** 测试/宿主接线用：替换未知族的提醒出口（传 undefined 恢复 console）。 */
+export function setFamilyWarnSink(sink) {
+    warnSink = sink ?? ((msg) => console.warn(msg));
+}
+/** 清空"已提醒"集（用例要能反复断言只 warn 一次）。 */
+export function resetFamilyWarned() {
+    warnedUnknownFamilies.clear();
+}
+function noteUnknown(type) {
+    if (warnedUnknownFamilies.has(type))
+        return;
+    if (warnedUnknownFamilies.size < 64)
+        warnedUnknownFamilies.add(type);
+    warnSink(`[memory] type '${type}' 不在词表，family 按旧前缀规则回落（请核对来源）`);
+}

package/dist/memport/format.d.ts

@@ -1,6 +1,11 @@
 /** MMF v1.1 默认列序（缺 `#cols=` 时按此解析；v1 包缺 vf/vt/st 列按 -/-/? 补齐）。 */
 export declare const DEFAULT_COLS: readonly ["type", "created", "updated", "vf", "vt", "st", "cf", "rw", "tags", "content"];
-/** 类型码 → 运行时 type（与 memport.py TYPE_CODES 一字不差）。 */
+/**
+ * 类型码 → 运行时 type（与 memport.py TYPE_CODES 一字不差）。
+ *
+ * 旧码（插件 7 类）不变；pm-name-distill task_1.7 补进宿主 29 类的新码，使外部包
+ * 带来的宿主分类不再被写侧抹平——两实现同表是 `memport-ts-consistency` 的前提。
+ */
 export declare const TYPE_CODES: Record<string, string>;
 /** 持续性取值域：p 时点 / s 已结束区间 / o 仍在持续 / t 无时间性 / ? 未判定。 */
 export declare const PERSISTENCE: readonly ["p", "s", "o", "t", "?"];

package/dist/memport/format.js

@@ -13,7 +13,12 @@
 import { createHash } from 'node:crypto';
 /** MMF v1.1 默认列序（缺 `#cols=` 时按此解析；v1 包缺 vf/vt/st 列按 -/-/? 补齐）。 */
 export const DEFAULT_COLS = ['type', 'created', 'updated', 'vf', 'vt', 'st', 'cf', 'rw', 'tags', 'content'];
-/** 类型码 → 运行时 type（与 memport.py TYPE_CODES 一字不差）。 */
+/**
+ * 类型码 → 运行时 type（与 memport.py TYPE_CODES 一字不差）。
+ *
+ * 旧码（插件 7 类）不变；pm-name-distill task_1.7 补进宿主 29 类的新码，使外部包
+ * 带来的宿主分类不再被写侧抹平——两实现同表是 `memport-ts-consistency` 的前提。
+ */
 export const TYPE_CODES = {
     pe: 'persona',
     ep: 'episodic',
@@ -22,6 +27,39 @@ export const TYPE_CODES = {
     wt: 'work_task',
     wm: 'work_method',
     wa: 'work_artifact',
+    // —— 宿主分类·个人轴 ——
+    ui: 'user_info',
+    uh: 'user_hobby',
+    uc: 'user_communication',
+    ub: 'user_behavior',
+    // —— 宿主分类·项目轴 ——
+    pi: 'project_introduction',
+    pt: 'project_tech_stack',
+    pg: 'project_architecture',
+    pb: 'project_build_configuration',
+    pq: 'project_dependency_configuration',
+    po: 'project_ide_configuration',
+    ps: 'project_scm_configuration',
+    pw: 'project_environment_configuration',
+    pl: 'project_rule',
+    // —— 宿主分类·规范轴 ——
+    ds: 'development_code_specification',
+    dp: 'development_practice_specification',
+    dv: 'development_test_specification',
+    dn: 'development_comment_specification',
+    // —— 宿主分类·经验轴 ——
+    tm: 'task_summary_experience',
+    dk: 'task_breakdown_experience',
+    df: 'task_flow_experience',
+    td: 'task_experience',
+    tl: 'tool_experience',
+    mp: 'mcp_experience',
+    sl: 'skill_experience',
+    lk: 'learned_skill_experience',
+    ek: 'expert_experience',
+    im: 'important_decision_experience',
+    cp: 'common_pitfalls_experience',
+    hf: 'history_task_reference_files',
 };
 const TYPE_FULL = Object.fromEntries(Object.entries(TYPE_CODES).map(([k, v]) => [v, k]));
 /** 持续性取值域：p 时点 / s 已结束区间 / o 仍在持续 / t 无时间性 / ? 未判定。 */
@@ -269,8 +307,10 @@ export function parseBundle(text) {
         if (!(rec.type in TYPE_CODES) && !(rec.type in TYPE_FULL)) {
             if (rec.type === '' || rec.type === '?')
                 b.warnings.push(`${p}: 类型缺失，导入时将回落 episodic`);
+            // 口径与写侧 `memory_add` 一致（旧文案承诺“按原样透传”，写侧却静默抹平——
+            // 同一件事两套说法）。非词表值现在会被降级并留痕，不能再说是“透传”。
             else
-                b.warnings.push(`${p}: 非标准类型码 ${rec.type}，将按原样透传`);
+                b.warnings.push(`${p}: 非词表类型 ${rec.type}，导入时将降级为 episodic（服务端记 warn）`);
         }
         for (const [fld, val] of [
             ['cf', rec.cf],

package/dist/pipeline/l1.d.ts

@@ -2,7 +2,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { MemoryConfig } from '../config.js';
 import type { L1Store } from '../store/l1.js';
 import type { MemoryState } from '../store/state.js';
-import type { ConversationAnchor, ConversationMessage, ExtractMode, MemoryFamily, MemoryLogger, MemoryRecord } from '../types.js';
+import type { ConversationAnchor, ConversationMessage, ExtractedMemory, ExtractMode, MemoryFamily, MemoryLogger, MemoryRecord, MemoryScope } from '../types.js';
 export interface ExtractionResult {
     stored: number;
     skipped: boolean;
@@ -15,6 +15,42 @@ export interface ExtractionResult {
 }
 /** 分族 checkpoint 桶(活引用,改动由调用方 save 落盘)。 */
 export type FamilyStates = Record<MemoryFamily, MemoryState>;
+/** 抽取产出 + 管线补上的五个字段(与 Step 1 的 `extracted` 元素同形)。 */
+export type PendingMemory = ExtractedMemory & {
+    record_id: string;
+    scene_name: string;
+    family: MemoryFamily;
+    /** §E 归属:write 侧已按 `resolveRecordScope` 算好,`toStoreRecord` 原样带出 */
+    scope: MemoryScope;
+    workspaceId: string;
+    /** 治理归属(ADR-0015 T1.9/T1.10):进管线时一次算定(I-21),写时随 store 行落盘。 */
+    repoKeyName: string;
+    repoKeyOwner: string;
+    applicability: string;
+};
+/**
+ * 合并时的检索轴并集（P0-c）。
+ *
+ * 此前合并产物只带新记忆的 metadata，targets 的 tags/hall/cogHall/使用场景全丢——
+ * 一次合并就把这条记忆从它原来的 Room/Wing 里摘出去，而面板上看不出任何异常（F2）。
+ * 这里只并**检索轴**：派生评价（maturity/usage/rating）与内容层字段不在其列。
+ *
+ * 单值轴（hall/cogHall）两侧互斥时**保留新记忆侧并留痕**，不拼成 `"a,b"`——那会
+ * 造出一个不存在的域（与 `isWingId` 的值域约束相冲）。
+ *
+ * @param self - 新记忆自己的 metadata（可为 undefined）。
+ * @param targets - 被合并掉的旧记录们的 metadata。
+ * @returns 并集后的 metadata 与若干条“丢了什么”的留痕文案。
+ */
+export declare function mergeAxes(self: Record<string, unknown> | undefined, targets: ReadonlyArray<Record<string, unknown> | undefined>): {
+    metadata: Record<string, unknown>;
+    notes: string[];
+};
+/**
+ * 导出仅供用例：`title → name` 这一跳是本计划的风隙（模型给的名字能不能落成合法身份名），
+ * 而驱动整条 LLM 管线会把断言埋进抽取/去重两段的噪声里。与 `mergeAxes` 同一先例。
+ */
+export declare function toStoreRecord(m: PendingMemory, now: number, ts: number, anchorMap?: ReadonlyMap<string, ConversationAnchor>): MemoryRecord;
 /**
  * 按字符预算把消息切成多块(保持顺序,单条超预算独占一块,由 callLLM 兜底截断)。
  * 每条消息按 content 长度 + 64 字符脚手架开销(id/时间戳行)计。
@@ -32,4 +68,10 @@ workspaceId?: string,
  * **缺省时行为与改动前逐字一致**——传入的 `pending` 消息若不带锚点(老数据、
  * 未启用捕获侧打戳),`resolveSourceAnchors` 一律返回 undefined,不写 metadata 键。
  */
-anchorMap?: ReadonlyMap<string, ConversationAnchor>): Promise<ExtractionResult>;
+anchorMap?: ReadonlyMap<string, ConversationAnchor>, 
+/**
+ * 合并后的**派生数据搬运钩子**（P0-d）：旧 id → 新 id。使用史与人工标注存在
+ * 另两个 sidecar 里，而 merge 每次新铸 id——不搬就等于每次合并把这条记忆的
+ * `used`/人工打分清零，它会被当成“没用过”而沉底。缺省不搬（行为与改动前一致）。
+ */
+mergeRekey?: (oldId: string, newId: string) => void): Promise<ExtractionResult>;