dsh-prime-memory 0.26.12 → 0.26.13

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 更新日志（Changelog）
 
+## [0.26.13] — 2026-10-28
+
+> 修复 issue #19：单条 L1 priority 越界（如 LLM 回 `-1`）经无夹取写点落库后，`memoryRecall` 投影的 `viewSchema` 严格校验（判非负整数）抛错 → 宿主把整会话包成 `SESSION_QUERY_CORRUPT_SESSION` → **一条脏数据打死整个会话历史**。
+
+### 修复
+
+- **双防线**：
+  - **写侧夹取（防新增）**：新建 `src/util/priority.ts` 单源 `clampPriority`（非有限→回落缺省、小数 `Math.round`、夹到整数 `[0,100]`），L1 抽取/合并构造（`pipeline/l1.ts` 两处）、upsert 绑定层（`store/sqlite.ts`，保留历史缺省 50）、MD 导入解析（`store/memory-md-parse.ts`）统一走同一夹取。
+  - **读侧兜底（自愈存量）**：投影 `makeView` 遇脏 priority 就地夹取并 `warn`（带 record id + 原值），绝不让单条脏字段打死整会话。因升级必重启宿主、`viewMemo`（进程内 WeakMap）随之清空，脏行读时被夹取 → **存量脏数据无需手动改库、无需迁移**。
+- 保留 `viewSchema` 严格校验（纵深防御仍在，只是喂进去的已是干净值）；合法 0–100 整数读写逐字不变；`slots.ts` 的同名私有 `clampPriority`（floor/50，memorySlots 另一条链）不受影响。
+- 本版叠加在 0.26.12（DSH 0.2.1-rc.4 适配）之上，`latest` 与 `dsh-0.2.1-rc.4` dist-tag 同指本版。
+
 ## [0.26.12] — 2026-10-28
 
 > 0.26.12: host enumeration addendum for DSH 0.2.1-rc.4 (declaration-only bump; contract plane zero diff). `engines.dsh`/`dsh.plugin.json`/README 同串补 `0.2.1-rc.4` 枚举行（19 档）。

package/dist/index.js

@@ -497,7 +497,7 @@ export async function apply(ctx, config) {
     // memoryRecall 投影：本会话“已注入且未被压缩覆盖”的召回集（会话感知，init 取 header.id），
     // 与常驻槽位是两条轴：那个是手动 pin 的硬注入约定，这个是非常驻的相关性浮现结果。
     // 带上反馈面：条目要显示人已经打过的那一笔（rating）。
-    registerRecallProjection(ctx, stores.recalled, stores.l1, recallFeedback);
+    registerRecallProjection(ctx, stores.recalled, stores.l1, recallFeedback, logger);
     // 人打 -1 声明过时后，下一轮向模型一次性播报“这条已退场、别再依据它作答”。
     registerObsoleteNotice(ctx, config, obsoleteNotices, logger);
     void slotRecall;

package/dist/pipeline/l1.js

@@ -14,6 +14,7 @@ import { buildConflictPair, conflictRejectId, DEFER_MAX, normalizeClaimKey, norm
 import { formatExtractionPrompt, getExtractMemoriesSystemPrompt } from '../prompts/l1-extraction.js';
 import { normTags, normUsageScenario, readCognitiveHall, readWing } from '../metadata-validators.js';
 import { acceptTitle } from '../util/md-name.js';
+import { clampPriority } from '../util/priority.js';
 import { formatBatchConflictPrompt, getConflictDetectionSystemPrompt } from '../prompts/l1-dedup.js';
 import { resolveSourceAnchors, withSourceAnchors } from './anchors.js';
 import { stampValidity, validToSourceOf } from '../store/validity.js';
@@ -196,7 +197,7 @@ export function toStoreRecord(m, now, ts, anchorMap) {
         id: m.record_id,
         content: m.content,
         type: m.type,
-        priority: Number(m.priority) || 60,
+        priority: clampPriority(m.priority),
         scene_name: m.scene_name,
         timestamps: [Number.isNaN(ts) ? now : ts],
         createdAt: now,
@@ -714,7 +715,7 @@ routeHealth) {
             id: m.record_id,
             content: mergedContent,
             type: decision.merged_type || m.type,
-            priority: Number(decision.merged_priority) || Number(m.priority) || 60,
+            priority: clampPriority(decision.merged_priority ?? m.priority),
             scene_name: m.scene_name,
             timestamps: Array.from(new Set(mergedTs)).sort((a, b) => a - b),
             createdAt: now,

package/dist/projection/recall.d.ts

@@ -116,5 +116,7 @@ export interface RecallFeedbackFace {
  * apply 是 O(1) 判脏（store.revision() 与反馈序号比对），任意已提交事件都会带进来看一眼。
  * @param feedback - 相关度反馈只读面；缺席时 view 不带 rating（旧行为）。
  */
-export declare function registerRecallProjection(ctx: Context, store: SessionRecalledStore, l1?: RecallL1Face, feedback?: RecallFeedbackFace): void;
+export declare function registerRecallProjection(ctx: Context, store: SessionRecalledStore, l1?: RecallL1Face, feedback?: RecallFeedbackFace, log?: {
+    warn(message: string): void;
+}): void;
 export {};

package/dist/projection/recall.js

@@ -1,5 +1,6 @@
 import { isRetired } from '../store/supersede.js';
 import { stateOfRecord } from '../store/validity.js';
+import { clampPriority, isDirtyPriority } from '../util/priority.js';
 export const MEMORY_RECALL_KEY = 'memoryRecall';
 /** view 最多透出条数（最近在上；超出部分只计入 count，防 wire 体量失控）。 */
 export const RECALL_VIEW_CAP = 20;
@@ -141,7 +142,7 @@ function sameIds(a, b) {
 }
 /** view 引用稳定：同一 state 恒返回同一对象（registry 按 Object.is 判发布）。 */
 const viewMemo = new WeakMap();
-function makeView(state, l1, feedback) {
+function makeView(state, l1, feedback, log) {
     const memoized = viewMemo.get(state);
     if (memoized !== undefined)
         return memoized;
@@ -163,11 +164,16 @@ function makeView(state, l1, feedback) {
         // 未退场行才会真判过时两档（退场行由 retired 键表达，validity 不再叠加）。
         const vState = isRetired(r) ? undefined : stateOfRecord(r, Date.now());
         const showValidity = vState === 'expired' || vState === 'expired_suspect';
+        // #19 读侧兜底：脏 priority（负/超界/非整数/非有限）就地夹取，绝不让 viewSchema
+        // 因单条脏字段抛错打死整会话；命中时 warn 留痕（静默夹取会掩盖上游 LLM 异常）。
+        const rawPriority = r.priority;
+        if (isDirtyPriority(rawPriority))
+            log?.warn(`[memory][recall] 脏 priority 回落 record=${r.id} raw=${String(rawPriority)}`);
         items.push({
             id: r.id,
             type: r.type,
             title: r.name || firstLine(r.content),
-            priority: r.priority,
+            priority: clampPriority(rawPriority),
             body: clampBody(r.content),
             ...(scenario !== undefined && scenario.length > 0 ? { scenario } : {}),
             ...(typeof rating === 'number' ? { rating } : {}),
@@ -196,7 +202,7 @@ function sessionIdOf(header) {
  * apply 是 O(1) 判脏（store.revision() 与反馈序号比对），任意已提交事件都会带进来看一眼。
  * @param feedback - 相关度反馈只读面；缺席时 view 不带 rating（旧行为）。
  */
-export function registerRecallProjection(ctx, store, l1, feedback) {
+export function registerRecallProjection(ctx, store, l1, feedback, log) {
     ctx.inject(['sessionProjections'], (injected) => {
         const registry = injected.sessionProjections;
         if (registry === undefined || typeof registry.register !== 'function')
@@ -208,9 +214,9 @@ export function registerRecallProjection(ctx, store, l1, feedback) {
             stateSchema,
             init: (header) => buildState(sessionIdOf(header), store, fbRev()),
             apply: (state) => buildState(state.sessionId, store, fbRev(), state),
-            wire: { viewSchema, view: (state) => makeView(state, l1, feedback) },
+            wire: { viewSchema, view: (state) => makeView(state, l1, feedback, log) },
             schema: viewSchema,
-            view: (state) => makeView(state, l1, feedback),
+            view: (state) => makeView(state, l1, feedback, log),
             stateVersion: 0,
         };
         registry.register(definition);

package/dist/store/memory-md-parse.js

@@ -13,6 +13,7 @@
  * 与正文本体是否一致（`hashValid`），不替调用方决定怎么处置——那属于同步侧的裁决。
  */
 import { contentHash } from './memory-md.js';
+import { clampPriority } from '../util/priority.js';
 /** 取 frontmatter 块：首行必须是 `---`，到下一个 `---` 为止。 */
 function splitFrontmatter(text) {
     // BOM 与 CRLF 都要先吃掉：人在记事本里改一行就会引入 \r，而 `\r` 会让 key 匹配不上。
@@ -71,7 +72,7 @@ export function parseMdFile(text) {
     return {
         name: str(fields.get('name')),
         type: str(fields.get('type')),
-        priority: Number.isFinite(prio) ? prio : 60,
+        priority: clampPriority(prio),
         createdAt: str(fields.get('createdAt')),
         updatedAt: str(fields.get('updatedAt')),
         usageScenario: scenario,

package/dist/store/sqlite.js

@@ -26,6 +26,7 @@ import { normApplicability } from '../repo-scope.js';
 import { normalizeWorkspacePath } from '../workspace.js';
 import { bm25RankToScore, buildFtsQuery, tokenizeForFts } from './search-utils.js';
 import { describeTokenizer, ensureTokenizer, tokenizerStamp } from '../util/tokenizer.js';
+import { clampPriority } from '../util/priority.js';
 const require = createRequire(import.meta.url);
 const TAG = '[memory][sqlite]';
 /**
@@ -992,7 +993,7 @@ export class MemoryDb {
         // 无法绑定(node:sqlite 拒绝绑定),曾致旧版导入逐条全挂、每次启动无限重试。
         // 主表与 FTS 两条语句共用同源归一化值;type 归一化后 familyForType 也不再收到 undefined。
         const type = record.type ?? '';
-        const priority = record.priority ?? 50;
+        const priority = clampPriority(record.priority, 50);
         const sceneName = record.scene_name ?? '';
         const family = record.family ?? familyForType(type);
         // §E 写入侧兜底归一,并维持一条**不变量**:`scope='global'` 的记录 `workspace_id` 恒为空串。

package/dist/util/priority.d.ts

@@ -0,0 +1,22 @@
+/**
+ * L1 记忆 priority 的归一单源（issue #19）。
+ *
+ * 存在理由：priority 是磁盘契约列，且被 memoryRecall 投影的 `viewSchema` 严格校验
+ * （`requireCounter` 判非负整数）。任一写入口把 LLM 回传的负数/超界/小数原样落库，
+ * 投影出网即抛 → 宿主把整会话包成 `SESSION_QUERY_CORRUPT_SESSION` → **一条脏数据
+ * 打死整个会话历史**。故所有喂进 `l1_records.priority` 的路径必须过同一夹取。
+ *
+ * 语义（用户选定）：非有限值→`fallback`；小数 `Math.round`；结果夹到整数 `[0,100]`。
+ * `fallback` 形参是为保留各写点既有的缺省差异（upsert 绑定层历史上用 50，抽取用 60），
+ * 避免为修范围而把某处的默认值静默漂移。
+ *
+ * 注意：**不动** `store/slots.ts` 里的同名私有 `clampPriority`（floor/50，服务 memorySlots
+ * 另一条链）；本文件只服务 L1 记忆 priority。
+ */
+export declare const PRIORITY_DEFAULT = 60;
+export declare const PRIORITY_MIN = 0;
+export declare const PRIORITY_MAX = 100;
+/** 夹取到 `[PRIORITY_MIN, PRIORITY_MAX]` 的整数；非有限值回落 `fallback`。 */
+export declare function clampPriority(value: unknown, fallback?: number): number;
+/** 是否会被夹取改变（负 / 超界 / 非整数 / 非有限 / 缺失）——供读侧判定要不要 warn。 */
+export declare function isDirtyPriority(value: unknown): boolean;

package/dist/util/priority.js

@@ -0,0 +1,36 @@
+/**
+ * L1 记忆 priority 的归一单源（issue #19）。
+ *
+ * 存在理由：priority 是磁盘契约列，且被 memoryRecall 投影的 `viewSchema` 严格校验
+ * （`requireCounter` 判非负整数）。任一写入口把 LLM 回传的负数/超界/小数原样落库，
+ * 投影出网即抛 → 宿主把整会话包成 `SESSION_QUERY_CORRUPT_SESSION` → **一条脏数据
+ * 打死整个会话历史**。故所有喂进 `l1_records.priority` 的路径必须过同一夹取。
+ *
+ * 语义（用户选定）：非有限值→`fallback`；小数 `Math.round`；结果夹到整数 `[0,100]`。
+ * `fallback` 形参是为保留各写点既有的缺省差异（upsert 绑定层历史上用 50，抽取用 60），
+ * 避免为修范围而把某处的默认值静默漂移。
+ *
+ * 注意：**不动** `store/slots.ts` 里的同名私有 `clampPriority`（floor/50，服务 memorySlots
+ * 另一条链）；本文件只服务 L1 记忆 priority。
+ */
+export const PRIORITY_DEFAULT = 60;
+export const PRIORITY_MIN = 0;
+export const PRIORITY_MAX = 100;
+/** 夹取到 `[PRIORITY_MIN, PRIORITY_MAX]` 的整数；非有限值回落 `fallback`。 */
+export function clampPriority(value, fallback = PRIORITY_DEFAULT) {
+    const sanitize = (x) => Math.max(PRIORITY_MIN, Math.min(PRIORITY_MAX, Math.round(x)));
+    // null/undefined 显式回落（Number(null) 得 0，若不当缺省处理会把旧 `?? 50` 漂移成 0）。
+    if (value === null || value === undefined)
+        return sanitize(fallback);
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n))
+        return sanitize(fallback);
+    return sanitize(n);
+}
+/** 是否会被夹取改变（负 / 超界 / 非整数 / 非有限 / 缺失）——供读侧判定要不要 warn。 */
+export function isDirtyPriority(value) {
+    if (value === null || value === undefined)
+        return true;
+    const n = typeof value === 'number' ? value : Number(value);
+    return !Number.isInteger(n) || n < PRIORITY_MIN || n > PRIORITY_MAX;
+}

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.26.12",
+  "version": "0.26.13",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.26.12",
+  "version": "0.26.13",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",