sage-mem 2.0.0 → 2.1.0

package/lib/recall/injector.js

@@ -26,6 +26,43 @@ import { buildCandidates, composeDelivery, composeStatus } from './compose.js'
 import { composeRecallText } from './text.js'
 import { debugEnabled, debugRecall, recordInjection } from './debug.js'
 
+/**
+ * 2.0.1：调试账里「被有效性挡掉」的两类理由（2.0.0 新引入的抑制）。
+ *
+ * ⚠️ **只收这两个**：`below_floor` / `budget_omitted` 等老理由在 2.0.0 之前就有，
+ * 它们的解释已经在面板的「预算挡掉 N 条」与得分列表里；而失效与未裁决矛盾是
+ * 2.0.0 让记忆**从正文里消失**的唯一原因 —— 不单列出来，用户与维护侧都只能靠
+ * 猜「这条到底是没检索到，还是被新规则挡住了」。
+ */
+const VALIDITY_SUPPRESS_REASONS = new Set(['expired_source', 'conflict_pending'])
+
+/** reason → 面板上的一句人话（英文由 client 侧字典决定，这里只给稳定键）。 */
+const VALIDITY_REASON_LABEL = Object.freeze({
+  expired_source: '已失效',
+  conflict_pending: '待裁决矛盾',
+})
+
+/**
+ * 从 `decideDelivery` 的逐条处置里挑出被有效性挡掉的，附上文件名、理由与（可选）冲突 id。
+ *
+ * 纯函数，给调试账用；**不影响注入结果** —— items 是决策的产物，这里只是把其中
+ * 两类 reason 摘出来。`conflictIds` 是「文件名 → 冲突记录 id」的映射：同一份文件被
+ * 多条记录牵扯时取第一条（按 `listConflictIndex` 的时间倒序），够定位就行。
+ */
+function validitySuppressedItems(items, conflictIds) {
+  const out = []
+  for (const it of Array.isArray(items) ? items : []) {
+    if (!it || !VALIDITY_SUPPRESS_REASONS.has(it.reason)) continue
+    const row = { file: String(it.file ?? ''), reason: it.reason, label: VALIDITY_REASON_LABEL[it.reason] }
+    if (it.reason === 'conflict_pending' && conflictIds instanceof Map) {
+      const id = conflictIds.get(row.file)
+      if (id) row.conflictId = id
+    }
+    out.push(row)
+  }
+  return out
+}
+
 /**
  * @param {object} deps
  * @param {object} deps.ctx — 宿主 ctx（`scanMemoryFiles` / `warnLog` 用）
@@ -95,6 +132,9 @@ export function createRecallInjector({ ctx, state, tools, taskIdOf }) {
       // ⚠️ 只对 `contradiction` 进集合：写失败型记录里盘上那份仍是现行内容（§6.3）。
       let conflictsForDelivery = new Set()
       let pendingConflicts = 0
+      // 2.0.1：调试账用的「文件名 → 冲突记录 id」。只在开关打开时才读得到，但先按需
+      // 建一份空 Map（代价可忽略，比在 makeDebug 里为了 id 再扫一次队列便宜）。
+      const conflictIdByFile = new Map()
       const validity = validityEnabled()
       const expired = validity ? buildExpirySet(files, nowMs) : new Set()
       if (validity) {
@@ -104,6 +144,13 @@ export function createRecallInjector({ ctx, state, tools, taskIdOf }) {
           const listed = await listConflictIndex({ stateRoot: STATE_ROOT })
           if (listed.ok) {
             conflictsForDelivery = buildContradictionFileSet(listed.items)
+            for (const c of listed.items) {
+              if (!c || c.status !== 'open' || c.kind !== 'contradiction') continue
+              for (const key of ['file', 'otherFile']) {
+                const name = typeof c[key] === 'string' ? c[key].trim() : ''
+                if (name !== '' && !conflictIdByFile.has(name)) conflictIdByFile.set(name, c.id)
+              }
+            }
             pendingConflicts = listed.items.filter((c) => c.status === 'open' && c.kind === 'contradiction').length
           } else {
             warnLog(ctx, `读冲突队列失败，本轮不做矛盾抑制：${listed.error ?? listed.code}`, sessionId)
@@ -162,7 +209,10 @@ export function createRecallInjector({ ctx, state, tools, taskIdOf }) {
       //   - `sessionChars` = 本代累计正文字节（预算账）；
       //   - `cardChars` = 这一步发出去的状态卡字节（没发就是 0）；
       //   - `deduped` = 同题同命中集刚注过，这一步没重复追加 —— 面板上要解释成
-      //     「不是坏了，是去重生效」，否则每轮多步里大部分账看着都是空的。
+      //     「不是坏了，是去重生效」，否则每轮多步里大部分账看着都是空的；
+      //   - `validitySuppressed`（2.0.1）= 被 2.0.0 的有效性规则挡在正文外的条目，
+      //     带 `reason`（expired_source / conflict_pending）与 `label`；矛盾还带
+      //     `conflictId`，便于去「冲突」页签定位。**这不是检索失败**，是规则生效。
       const debugOn = debugEnabled()
       const makeDebug = debugOn
         ? (outcome) => ({
@@ -182,6 +232,7 @@ export function createRecallInjector({ ctx, state, tools, taskIdOf }) {
             sessionChars: contentBytes,
             cardChars: cardPart ? Buffer.byteLength(cardPart, 'utf8') : 0,
             skippedByBudget: skippedForBudget,
+            validitySuppressed: validitySuppressedItems(delivered.delivery.items, conflictIdByFile),
             card: cardPart ? 'sent' : (status.cardText ? 'deduped-or-over-budget' : 'none'),
           })
         : () => null

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sage-mem",
   "description": "Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "type": "module",
   "main": "lib/index.js",
   "icon": "./icon.png",