@a9i5k4/dsh-auto-memory 3.0.0 → 3.0.1

package/lib/activation-host.js

@@ -19,6 +19,7 @@ import {
 import { createActivationInboxPre, ActivationInboxRegistry, REFERENCE_TAIL_COOLDOWN_STEPS_V1 } from './activation-inbox-state.js'
 import { createAccessEvidencePre } from './context-bridge.js'
 import path from 'node:path'
+import { resolveDshHomeForEnginePre } from './dsh-home.js'
 import { buildSourceCatalog, loadCorpusSnapshot, CorpusRegistry, canonicalize } from './m4-corpus.js'
 
 /** §11 capability 快照版本。 */
@@ -49,7 +50,12 @@ export function createActivationHost(opts = {}) {
   // 现改为按身份分片:投影按 sessionId、miv 按 wsRef。**只增 key 维度,不改任何判定口径**。
   const mivCacheByWs = new Map()   // wsRef -> miv(每个工作区各记一份,不再互相踢)
   const pathsByKey = new Map()
+  // ★#84（2026-09-20）：`≤16 最小投影` —— 原实现在超出上限时**静默 shift**，
+  //   于是「诊断面看不到最近事件」没有任何痕迹；排查时会误判成「压根没产生事件」。
+  //   现补 `volatileDropped` 计数并具名化上限。
   const volatileEvents = [] // ≤16 最小投影
+  let volatileDropped = 0
+  const VOLATILE_MAX_V1 = 16
   const stats = { injected: 0, injectedAccepted: 0, injectedRejected: 0, claims: 0, claimFails: 0, rendered: 0, delivered: 0, seenCreated: 0, seenSkippedNoProv: 0, errors: 0 }
 
   function effectiveEnabled() {
@@ -69,14 +75,17 @@ export function createActivationHost(opts = {}) {
     return 'invalid'
   }
   function dshHome() {
-    const env = process.env.DSH_HOME
-    if (env && env.trim()) return env.trim()
-    const base = engine.__homedirFn ? engine.__homedirFn() : (process.env.USERPROFILE || process.env.HOME || '')
-    return base ? path.join(base, '.dsh') : '.'
+    // ★#86-3：统一口径。原实现全失败时返回 '.'（**与其余站点不同**）；
+    //   __homedirFn 注入点由 resolveDshHomeForEnginePre 保留，测试兼容。
+    return resolveDshHomeForEnginePre(engine)
   }
   function pushEvent(entry) {
     volatileEvents.push({ at: Date.now(), ...entry })
-    if (volatileEvents.length > 16) volatileEvents.shift()
+    if (volatileEvents.length > VOLATILE_MAX_V1) {
+      volatileEvents.shift()
+      // ★#84：丢弃必须留痕（否则「看不到事件」无法区分「没产生」与「被挤掉」）
+      volatileDropped++
+    }
   }
   function capturePaths(runtimeKey, p) {
     pathsByKey.set(String(runtimeKey || ''), {
@@ -202,6 +211,9 @@ export function createActivationHost(opts = {}) {
       if (!engine._tierGateHitsBySession || typeof engine._tierGateHitsBySession.set !== 'function') {
         engine._tierGateHitsBySession = new Map()
       }
+      // ★2026-09-20 移植（issue #94⑤ / PR #100）：Map.set 对既有键**不刷新插入序** ⇒
+      //   keys().next() 淘汰的是「最老创建」而非「最久未用」，最活跃会话反被逐出。
+      engine._tierGateHitsBySession.delete(sid)
       engine._tierGateHitsBySession.set(sid, projection)
       // 兼容投影：保留旧字段指向"最近一次投递"，供旧诊断面板/测试继续可读（只增不改语义）。
       engine._tierGateHits = projection
@@ -234,7 +246,10 @@ export function createActivationHost(opts = {}) {
    */
   function pumpClaimed(box, req) {
     const c2 = box.claim({
-      nowStep: stepFor(req.sessionId, req.workspaceKey),
+      // ★ issue #75 CC-11 修复：用**只读**步号，不再自增。
+      //   pump 总是紧跟在同键 `stepFor`（offer 时）之后同步调用 ⇒ 读到的就是刚烘焙 TTL 的那个步。
+      //   旧实现此处再 `stepFor` 一次 ⇒ 同一步内凭空消耗 2 步 TTL（见 currentStepOf 注释）。
+      nowStep: currentStepOf(req.sessionId, req.workspaceKey),
       currentContextVersion: req.contextVersion,
       currentMemoryIndexVersion: req.memoryIndexVersion,
     })
@@ -348,12 +363,39 @@ export function createActivationHost(opts = {}) {
     return { ok: true, request }
   }
   const stepsByRuntime = new Map()
+  /**
+   * 步进计数器的**唯一键格式**（issue#58 修复，2026-09-19）。
+   * 旧实现：写入侧用 `sessionId + '|ws:' + workspaceKey`，而删除侧 `disposeRuntime` 用
+   * `String(runtimeKey)`（= `session:<sid>`）⇒ **两个键空间永不相交** ⇒ 删除是空操作，
+   * `stepsByRuntime` 只增不减（「会话×工作区」一条，进程内永不回收）。
+   * 现在格式收敛到这一处，写入与删除共用，杜绝再次漂移。
+   */
+  function stepKeyOf(sessionId, workspaceKey) {
+    return String(sessionId || '') + '|ws:' + String(workspaceKey || '')
+  }
   function stepFor(sessionId, workspaceKey) {
-    const key = sessionId + '|ws:' + workspaceKey
+    const key = stepKeyOf(sessionId, workspaceKey)
     const n = (stepsByRuntime.get(key) || 0) + 1
     stepsByRuntime.set(key, n)
     return n
   }
+  /**
+   * ★ issue #75 CC-11 修复（2026-09-19）：**只读**当前步（不自增）。
+   *
+   * 动机：`stepFor` 是自增器（+1 写回）。而「注入即泵」路径是
+   * `finishInject` 先 `offerActivation({nowStep: stepFor(...)})` 烘焙 TTL 起点，
+   * 紧接着**同一同步块内** `pumpClaimed` 又调一次 `stepFor` 去 claim
+   * ⇒ **offer 与 pump 各消耗 1 步而零时间流逝** ⇒ `expiresAtStep` 按第一次烘焙、
+   * 判定却用第二次 ⇒ TTL 窗口凭空少 1 步（实测 ttl=3 的自然投递窗由 2 次机会缩为 1；
+   * ttl=2 的 rollback 场景整包必死）。
+   *
+   * 语义上「同步 offer + pump」是**同一步内**的投递动作，不该消耗 2 步 TTL。
+   * 因此给 pump 侧提供只读版本：它总是紧跟在同键的 `stepFor` 之后调用，
+   * 读到的必然是刚自增过的那个值（≥1），不会读到 0。
+   */
+  function currentStepOf(sessionId, workspaceKey) {
+    return stepsByRuntime.get(stepKeyOf(sessionId, workspaceKey)) || 0
+  }
 
   /**
    * agent/pre-step(§8):先校验当前 cursor/index/TTL 再 claim;claimed packet 存 runtime 态,
@@ -371,6 +413,8 @@ export function createActivationHost(opts = {}) {
       const miv = currentMiv(identity.workspaceKey)
       box.setCursor({ contextVersion: runtime.contextVersion, memoryIndexVersion: miv || undefined })
       const nowStep = stepFor(identity.sessionId, identity.workspaceKey)
+      // issue#58:把步进键登记进 runtime 态,供 disposeRuntime 精确回收(否则计数器只增不减)。
+      const stepKeyHere = stepKeyOf(identity.sessionId, identity.workspaceKey)
       const c = box.claim({
         nowStep,
         currentContextVersion: runtime.contextVersion,
@@ -379,6 +423,7 @@ export function createActivationHost(opts = {}) {
       let st = runtimeState.get(runtime.key)
       if (!st) { st = { step: 0, claimed: null }; runtimeState.set(runtime.key, st) }
       st.step = nowStep
+      st.stepKey = stepKeyHere
       if (c.ok) { st.claimed = { packet: c.packet, inbox: box }; stats.claims++ }
       else {
         // 2026-08-28 浏览器实测修复:claim 失败(none-pending 等)不得清掉已存在的 claimed——
@@ -505,9 +550,18 @@ export function createActivationHost(opts = {}) {
     } catch (e) { stats.errors++; return { ok: false, reason: 'internal-error' } }
   }
 
+  /**
+   * 单 runtime 清理。issue#58 修复（2026-09-19）：**必须清掉步进计数器**。
+   * 旧实现 `stepsByRuntime.delete(String(runtimeKey))` 是坏键（见 `stepKeyOf` 注释）⇒ 空操作。
+   * 现在优先用创建时登记的 `stepKey`；同时保留 runtimeKey 形态的删除，
+   * 兼容「调用方直接传 step-key」的情况（两条都删，代价为零）。
+   */
   function disposeRuntime(runtimeKey) {
-    runtimeState.delete(runtimeKey)
-    stepsByRuntime.delete(String(runtimeKey))
+    const k = String(runtimeKey)
+    const st = runtimeState.get(k)
+    runtimeState.delete(k)
+    if (st && st.stepKey) stepsByRuntime.delete(st.stepKey)
+    stepsByRuntime.delete(k)
   }
   function disposeAll(reason) {
     runtimeState.clear()

package/lib/board-mode.js

@@ -8,7 +8,7 @@
  *  - boardMode = 'legacy'(默认) | 'graph'(新版看板 dsh-graph + sidecar + 遍历工具)。
  *  - **开关解耦**(用户硬性规则): boardMode 只决定"白板线新能力是否激活",
  *    不顺带改变任何其他功能行为; legacy 模式下一切行为与 P5 收官时**字节级一致**。
- *  - graph_* 工具(dsh-graph vendor)与 memory_expand_pre/memory_trace_pre(P3)
+ *  - graph_* 工具(dsh-graph vendor)与 memory_expand/memory_trace(P3)
  *    仅在 boardMode='graph' 时注册; P2 sidecar 仅在 'graph' 时写盘。
  *  - fail closed: 非法值一律按 legacy(旧行为), 绝不猜。
  */