dsh-layered-memory 0.8.4 → 0.8.6

package/dist/types.d.ts

@@ -43,7 +43,15 @@ export interface ExtractedMemory {
     metadata: Record<string, unknown>;
     /** 所属情境名（L1 抽取的情境切分结果）。 */
     scene_name: string;
+    /** auto 档抽取输出的显式族判定（chat|work；纯档 Prompt 无此字段）。
+     *  语境归族、形状不归族——修复"个人计划性事实被 work_* 形状吸走"的族错标
+     *  （2026-08-23 lifecycle 赛道实测发现）。 */
+    family?: string;
 }
+/** 抽取输出的 family 字段归一：只认 chat|work，其余（缺省/非法值）交由调用方回落。 */
+export declare function normExtractedFamily(raw: unknown): MemoryFamily | undefined;
+/** 记录族三级兜底链：会话档位强制（纯档）→ 抽取显式判定（auto）→ type 前缀推导（旧输出兜底）。 */
+export declare function resolveRecordFamily(forced: MemoryFamily | undefined, extracted: unknown, type: string): MemoryFamily;
 /** L1 持久化记录（字段对齐 MemoryCore；version/source_message_ids/metadata 由写入侧补默认）。 */
 export interface MemoryRecord {
     id: string;

package/dist/types.js

@@ -5,3 +5,11 @@
 export function familyForType(type) {
     return type.startsWith('work') ? 'work' : 'chat';
 }
+/** 抽取输出的 family 字段归一：只认 chat|work，其余（缺省/非法值）交由调用方回落。 */
+export function normExtractedFamily(raw) {
+    return raw === 'chat' || raw === 'work' ? raw : undefined;
+}
+/** 记录族三级兜底链：会话档位强制（纯档）→ 抽取显式判定（auto）→ type 前缀推导（旧输出兜底）。 */
+export function resolveRecordFamily(forced, extracted, type) {
+    return forced ?? normExtractedFamily(extracted) ?? familyForType(type);
+}

package/dist/util/recall-budget.d.ts

@@ -27,6 +27,6 @@ export declare function applyRecallBudget(lines: string[], limits: RecallBudgetL
  * resolve 为空结果（空数组）与超时（undefined）语义不同，调用方据此区分日志。
  */
 export declare function raceRecallTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T | undefined>;
-/** 召回路径远程嵌入 fetch 的内层钳制（固定值）：给 FTS 降级留出总预算内的时间。
- *  仅作用于远程 HTTP 调用；本地推理不受钳制（进程内 CPU 推理无挂起风险）。 */
+/** 召回路径嵌入调用的内层钳制（固定值）：给 FTS 降级留出总预算内的时间。
+ *  远程作用于 HTTP fetch；本地作用于 worker 代理的等待（race 放弃、迟到回复丢弃）。 */
 export declare const RECALL_EMBED_CAP_MS = 3000;

package/dist/util/recall-budget.js

@@ -80,6 +80,6 @@ export async function raceRecallTimeout(promise, timeoutMs) {
             clearTimeout(timer);
     }
 }
-/** 召回路径远程嵌入 fetch 的内层钳制（固定值）：给 FTS 降级留出总预算内的时间。
- *  仅作用于远程 HTTP 调用；本地推理不受钳制（进程内 CPU 推理无挂起风险）。 */
+/** 召回路径嵌入调用的内层钳制（固定值）：给 FTS 降级留出总预算内的时间。
+ *  远程作用于 HTTP fetch；本地作用于 worker 代理的等待（race 放弃、迟到回复丢弃）。 */
 export const RECALL_EMBED_CAP_MS = 3_000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-layered-memory",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "L0~L3 分层蒸馏记忆插件 for DeepSeek Harness：自动捕获对话（L0）、抽取原子记忆（L1）、整合场景块（L2）、蒸馏核心画像/团队方法论（L3），并在模型步骤前自动召回注入。移植自 MemoryCore (TencentDB Agent Memory) 的管线设计。",
   "type": "module",
   "main": "dist/index.js",