@a9i5k4/dsh-auto-memory 3.1.0 → 3.1.3

package/lib/shadow-host.js

@@ -40,7 +40,30 @@ export function truncateAuditEvent(ev) {
   return e
 }
 
-export function createShadowHost({ engine }) {
+/**
+ * ★P3-9（组2，2026-09-22）：诊断**节流**表。
+ * 原先 `no-paths` 每个 Segment 都直接 console.error ⇒ 单次历史回放能刷出上百行。
+ * 表放**模块级**而非闭包级：同进程多实例共享 ⇒ 不会各自持一份而双写。
+ * 语义同 index.js 的 diagThrottled：首条立即透出，窗口内重复压掉。
+ */
+const DIAG_THROTTLE_MS_V1 = 300000
+const _diagAt = new Map()
+function shouldReportDiag(key) {
+  try {
+    const now = Date.now()
+    if (now - (Number(_diagAt.get(key)) || 0) < DIAG_THROTTLE_MS_V1) return false
+    _diagAt.set(key, now)
+  } catch (_) { /* 计时失败不阻断上报 */ }
+  return true
+}
+
+/**
+ * @param {{engine: object, onDiag?: Function|null, recallStats?: object|null}} opts
+ *   `recallStats` = 召回统计实例（可选）。**依赖注入而非模块级单例**：本模块保持零耦合，
+ *   测试可传假对象（不碰真磁盘）；不传时埋点整段跳过，行为与从前逐字节相同。
+ *   ★命名：不得叫 `stats` —— 本函数内部已有同名 const（shadow 自身计数器），会作用域冲突。
+ */
+export function createShadowHost({ engine, onDiag = null, recallStats = null }) {
   const states = new WeakMap() // runtime → shadow state(lazy)
   const volatileRing = [] // ≤64 events(最小投影)
   const stats = { evaluated: 0, retrieved: 0, prefetched: 0, suppressed: 0, stale: 0, errors: 0 }
@@ -58,6 +81,13 @@ export function createShadowHost({ engine }) {
     engine.config.shadowRetrievalEnabled === true &&
     engine.config.memoryAnchorEnabled === true
 
+  /** ★P3-9（组2）：节流上报。未注入 onDiag 时回落 console.error（保持既有行为，只去掉刷屏）。 */
+  function reportDiag(key, msg) {
+    if (!shouldReportDiag(key)) return
+    if (typeof onDiag === 'function') { try { onDiag(key, msg); return } catch (_) { /* 回落 */ } }
+    try { console.error(msg) } catch (_) {}
+  }
+
   function stateFor(runtime) {
     let st = states.get(runtime)
     if (!st) {
@@ -225,7 +255,7 @@ export function createShadowHost({ engine }) {
           return
         }
         const paths = pathsByKey.get(String(runtime.key || '')) || null
-        if (!paths) { console.error('[shadow-diag] no-paths'); stats.suppressed++; pushVolatile({ reason: 'no-paths-captured', contextVersion: seg.contextVersion }); return }
+        if (!paths) { reportDiag('shadow:no-paths', '[shadow-diag] no-paths'); stats.suppressed++; pushVolatile({ reason: 'no-paths-captured', contextVersion: seg.contextVersion }); return }
         // window:segments ring 最近 8 条(含当前)
         const ringItems = runtime.segments ? runtime.segments.snapshot() : []
         const win = ringItems.slice(-8).map((w) => ({
@@ -320,6 +350,15 @@ export function createShadowHost({ engine }) {
     if (dec.action === 'retrieve') stats.retrieved++
     else stats.prefetched++
     st.recentHits.push({ queryDigest: qp.queryDigest, fresh: ls.kept.length > 0, memoryIds: ls.kept.map((k) => k.memoryId) })
+    // ★③ 召回统计 · shadow 通道（2026-09-22 用户拍板「分开计算」）：
+    //   这条通路 = 系统**主动判断该唤起**，与「模型主动检索」是两回事，必须分账。
+    //   语义：命中率（kept 空 ⇒ 唤起了但没东西）+ 哪些内容被系统认为该唤起。
+    //   ★只读：不改 ls / st / 决策，不影响任何 shadow 行为（守卫断言）。
+    if (recallStats && typeof recallStats.observe === 'function') {
+      try {
+        recallStats.observe(ls.kept.map((k) => ({ id: k.memoryId, layer: k.sourceClass || k.scope || 'shadow' })), { channel: 'shadow' })
+      } catch (_) {}
+    }
     if (st.recentHits.length > 64) st.recentHits.shift()
     st.completedKeys.add(qp.queryDigest + ':' + snapshotOut.memoryIndexVersion)
     if (st.completedKeys.size > 256) { const first = st.completedKeys.values().next().value; st.completedKeys.delete(first) }

package/lib/subagent-gc.js

@@ -201,7 +201,11 @@ export async function scanPluginSubagentSessions(opts = {}) {
       // 按 mtime 取最新存在的文件,兼容两代命名。
       let file = ''
       let st = null
-      for (const name of ['session.v3.jsonl.zstd', 'session.jsonl.zstd']) {
+      // ★v3.1.3：不再固定候选名 —— 扫目录取任意 session.*\.jsonl[.zstd]（兼容未来 vN 命名）。
+  let names = []
+  try { names = readdirSync(dir) } catch (_) { names = [] }
+  const hits = names.filter((n) => /^session[.-].*\.jsonl(\.zstd)?$/i.test(n) && !/backup|corrupt/i.test(n))
+  for (const name of (hits.length ? hits : ['session.v3.jsonl.zstd', 'session.jsonl.zstd'])) {
         const cand = path.join(dir, name)
         try {
           const s = await stat(cand)

package/lib/wb-sidecar.js

@@ -668,7 +668,10 @@ export function buildKanbanPre(index, opts = {}) {
         source: String(c.source || ''),
         section: String(c.section || ''),
         preview: body.replace(/\s+/g, ' ').trim().slice(0, 400),
-        full: body.slice(0, 6000),           // P12: 卡上可展开看全文
+        // ★v3.1.2 性能：full 不再内联进看板载荷（实测每卡≤6000 字符、1178 卡合计 0.85 MB，
+        //   且 lanes+matrix 双份 ⇒ 1.7 MB 纯冗余；前端默认只渲染 preview，full 仅「展开全文」需要）。
+        //   改为只带长度标示，正文由 kanban-card 路由按 id 单取。
+        fullLen: body.length,
         tags: t.tags,
         sectionTags: t.sectionTags,
         cues: (Array.isArray(c.cues) ? c.cues : []).slice(0, 3),
@@ -698,7 +701,8 @@ export function buildKanbanPre(index, opts = {}) {
         source: String(e.source || ''),
         section: String(e.section || ''),
         preview: String(e.preview || '').slice(0, 400),
-        full: String(e.preview || '').slice(0, 6000),
+        // ★v3.1.2 性能：同 sectionCards 分支 —— 不内联 full，仅带长度（见上）。
+        fullLen: String(e.preview || '').length,
         tags: t.tags,
         sectionTags: t.sectionTags,
         cues: (Array.isArray(e.cues) ? e.cues : []).slice(0, 3),
@@ -842,7 +846,8 @@ export function buildKanbanMatrixPre(cards, opts = {}) {
         docTitle: String(c.docTitle || ''),
         source: String(c.source || ''),
         preview: body.replace(/\s+/g, ' ').trim().slice(0, 220),
-        full: body.slice(0, 6000),
+        // ★v3.1.2 性能：矩阵卡同样不内联 full（同 lanes 口径）——带长度标示，点开时按 id 单取。
+        fullLen: body.length,
         bullets: Number(c.bullets) || 0,
         criteria: String(c.criteria || 'unknown'),
         badge: criteriaBadgePre(c.criteria),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a9i5k4/dsh-auto-memory",
   "description": "Proactive associative memory for DSH: zero-prompt recall injected before the model speaks, three-layer auto-consolidation, skill crystallization, and Astra-style context management - handoff ledgers, PLAN whiteboard, water-level sensing. Local-first, model-agnostic, zero deps. 主动联想记忆+Astra 式上下文管理:自动唤回/自动沉淀/技能固化/交接账本与白板跨窗口续命/水位感知。",
-  "version": "3.1.0",
+  "version": "3.1.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {