@a9i5k4/dsh-auto-memory 2.2.6 → 2.3.0

package/docs/prompts/EXEC-ORDER.md

@@ -0,0 +1,77 @@
+## 附：执行顺序建议（v2，反映 M8-R 已执行完毕的现状）
+
+```
+批次 1（并行，互不干扰，可分给不同 Agent）
+  ├─ P1   L0 索引            （新增 lib/l0-index-pre.js，不接线，删文件即回滚）
+  ├─ P5   接续锚点表          （改 index.js 的 buildContinueCarry 单一函数）
+  ├─ P7   写入侧修复          （改 index.js 写入函数：标题重复 / 白板老化）
+  └─ M8-1 Fact 元数据补强     （改 lib/fact-store-pre.js 增量，不动 M8 其他文件）
+
+批次 2（依赖 P1）
+  └─ P2 语义臂接入 recall     （改 index.js 的 recall()）
+
+批次 3（依赖 P2）
+  └─ P3 融合层改造            （改 lib/semantic-js-pre.js：rank-space + 绝对分数）
+
+批次 4（依赖 P3）
+  └─ P4 返回 L0 + 按需展开    （改 index.js 的 recall() 返回结构）
+
+批次 5（依赖 P5）
+  └─ P6 账本权重化截断        （新增 lib/handoff-anchor-pre.js + index.js 接线）
+
+批次 6（建议 P3 之后，避免权重叠加冲突）
+  └─ M8-2 evidence → importance 接线
+       （新增 lib/memory-importance-pre.js；若 P3 未完成则只交付纯函数不接线）
+
+批次 7（需用户书面确认后才投喂）
+  └─ M8-3 M8 启用 + live 验证（改 index.js 的 memoryHubEnabled 默认值一行）
+
+── 以下为 2026-09-09 收官后补做段（M8-2 目标未达成，见 M8-2-ADJUDICATION.md）──
+
+批次 8（依赖 P3 已交付 + P1/P2/P4；修复 P2 语义臂实效性）
+  └─ P8  RRF 接线进 recall（替换字典序排序，默认开启 + legacy 回退）
+
+批次 9（依赖 P8）
+  └─ M8-2b evidence 聚合层 + importance 加权接入
+
+批次 10（M8-2b 验收后数据源瓶颈，P9 已排查完）
+  └─ P9a correction 修复（唯一投喂项，重设计：单条归因到最近被 cite 记忆）
+  └─ P9d success 时间戳缺陷修复（**结构性断裂，立即做，优先于观察**）
+  ├─ P9b success 观察（**P9d 之后**才观察：5/30 分钟窗口命中量级）
+  └─ P9c reuse 延后（与 success 合并为"有用性信号补全"段，之后定）
+
+批次 11（低风险、可与 P9 并行，建议尽早做）
+  └─ P11 fail-soft 空 catch 统一可观测
+
+批次 12（顺序后移：待 success/reuse/correction 有真实数据后再标定）
+  └─ P10 importance 效应定标（w 可配置 + 翻转率实测）
+```
+
+## 冲突提示（务必遵守）
+
+1. **P2/P3/P4 与 P5/P6 都会改 `lib/index.js`**。若并行执行，必须**串行投喂、逐段 `git diff` 验收**，避免同文件改动互相覆盖。
+2. **M8-1 与 P 系列零文件交集**（M8-1 只碰 `lib/fact-store-pre.js`），可与批次 1 完全并行。
+3. **M8-2 与 P3 有概念耦合**（importance 参与融合排序）：P3 先做，M8-2 后做；顺序颠倒会导致两次改同一融合公式。
+4. **M8-3 永远最后**：它是行为开关，必须等 M8-1/M8-2 落地且五套基线全绿之后再确认执行。
+
+## M8-R 调研状态
+
+**已执行完毕**（2026-09-09），报告见 `M8-R-REPORT.md`。选型 = **A+（保留三层 + 叠加 epistemicStatus 字段 + 补时间三价 + importance 接线）**。`M8-R-research.md` 任务书保留存档，无需再投喂。
+
+## P8 / M8-2b 补做说明（2026-09-09 裁决）
+
+M8-2 的排序目标**未达成**：纯函数已交付（`311e2e8`），但接线点在当时不存在。经实读代码核实后裁决为**不降级，拆两段补做**：
+
+- **P8**：`recall()` 当前是**字典序排序**（`b.lex - a.lex || (b.sem||0) - (a.sem||0)`），语义臂仅在词法分相等时打破平局 → P2 的语义臂"接了但没用"。P3 交付的 `rankFusionRRFPre` 经 grep 确认**零引用**。本段把它接进去，**属缺陷修复，默认开启**。
+- **M8-2b**：evidence 事件**确实落盘**（`~/.dsh/memory/evidence-pre/events/*.jsonl`，按日），只是无人读取（`evidenceFor` 零调用方）。本段补「聚合层 → importance → 接入 P8 融合」全链。
+
+完整裁决依据（四条代码证据 + 三条规划缺口认领）见 **`M8-2-ADJUDICATION.md`**。
+
+## 全程验收底线（每段完成后核对）
+
+```bash
+git status --short   # 改动文件不得超过该段"允许修改"清单
+git diff --stat      # 最小 diff，无整文件重写
+```
+
+五套 smoke 基线不得下降：**l0-extract 18 / handoff 51 / continue-chain 58 / water-step 12 / autocont-host 29**（M8-1 追加 fact store ≥41 断言）。

package/docs/prompts/FEEDING-SCRIPT.md

@@ -0,0 +1,174 @@
+# 轮次投喂脚本（FEEDING-SCRIPT）
+
+> 用法：每个轮次 = **新开一个干净会话**，把下方开场模板 + 两个材料文件**全文粘贴**给 Agent。
+> 轮次 1–4 可分给 4 个不同 Agent 同时跑；只有一个 Agent 就按顺序 1→2→3→4。
+> 每轮验收通过后 **git commit 一次**（便于回滚归因），再进下一轮。
+
+---
+
+## 〇、每次投喂的固定开场模板（每次都要带）
+
+```
+你是本次任务的执行 Agent，工作目录 D:\dsh-auto-memory。
+下面给你两份材料：【材料一】通用前置约束，必须全部遵守；【材料二】你的唯一任务。
+执行顺序：先按材料二的「需先检索的仓库路径与符号关键词」用 Grep 定位真实符号与行号，
+回报定位结果后再实施；完成后按材料二的「完成自检」逐项回报。
+仓库实际代码与材料描述不符时，以实际代码为准并明确指出差异；
+无法定位或信息不足立即停止回报，禁止猜测，禁止整文件重写。
+
+======== 材料一 ========
+（粘贴 _COMMON.md 全文）
+
+======== 材料二 ========
+（粘贴当轮任务文件全文）
+```
+
+---
+
+## 一、每轮之后的固定验收（你来跑，约 1 分钟）
+
+```bash
+cd D:/dsh-auto-memory
+git status --short          # 改动文件不得超过该轮"允许"清单
+git diff --stat             # 最小 diff，无整文件重写
+# —— 十三套基线（收官后实测值，数字不得下降）——
+node tests/smoke/smoke-test-m73-pre.mjs 2>&1 | tail -1                 # 59
+node tests/smoke/smoke-test-handoff-anchor-pre.mjs 2>&1 | tail -1      # 42
+node tests/smoke/smoke-test-m81-hub-pre.mjs 2>&1 | tail -1             # 39
+node tests/smoke/smoke-test-p4-recall-l0-pre.mjs 2>&1 | tail -1        # 34
+node tests/smoke/smoke-test-memory-importance-pre.mjs 2>&1 | tail -1   # 17
+node tests/smoke/smoke-test-l0-extract-pre.mjs 2>&1 | tail -1          # 18
+node tests/smoke/smoke-test-handoff-pre.mjs 2>&1 | tail -1             # 51
+node tests/smoke/smoke-test-continue-chain-pre.mjs 2>&1 | tail -1      # 58
+node tests/smoke/smoke-test-water-step-pre.mjs 2>&1 | tail -1          # 12
+node tests/smoke/smoke-test-autocont-host-pre.mjs 2>&1 | tail -1       # 29
+# 另有 l0-index / recall-fusion / fact-store 等新增套件，按各轮"应产出"核对
+```
+
+> 若某个 smoke 文件名与实际不符，先 `ls tests/smoke/` 确认真实文件名再跑——**文件名以仓库实际为准**。
+
+---
+
+## 二、轮次表
+
+### 批次 A（轮次 1–4，互相零冲突，可并行）
+
+**轮次 1 · P1 L0 向量索引**（纯新增，删文件即回滚）
+- 投喂：`_COMMON.md` + `P1-l0-index.md`
+- Agent 要读的仓库文件：`lib/l0-extract-pre.js`、`lib/memory-index-pre.js`、`lib/semantic-js-pre.js`、`lib/m4-corpus-pre.js`
+- 应产出：`lib/l0-index-pre.js`、`tests/smoke/smoke-test-l0-index-pre.mjs`
+- 额外验收：新 smoke 全绿；`git status` 只新增这 2 个文件
+
+**轮次 2 · P5 接续锚点表**
+- 投喂：`_COMMON.md` + `P5-handoff-anchor.md`
+- Agent 要读的仓库文件：`lib/index.js`（定位 `buildContinueCarry` / 三处 `slice`）
+- 应产出：`lib/index.js` 最小 diff
+- 额外验收：handoff 51 / continue-chain 58 不降；回报里必须有"相同输入两次注入 hash 一致"的断言证据
+
+**轮次 3 · P7 写入侧修复**
+- 投喂：`_COMMON.md` + `P7-write-fix.md`
+- Agent 要读的仓库文件：`lib/index.js`（账本/白板写入函数）、`lib/memory-writer-pre.js`
+- 应产出：`lib/index.js` 最小 diff
+- ⚠️ 开工前先备份：`cp -r ~/.dsh/memory ~/.dsh/memory-backup-$(date +%m%d)`
+- 额外验收：既有账本/白板文件内容零丢失
+
+**轮次 4 · M8-1 Fact 元数据补强**
+- 投喂：`_COMMON.md` + `M8-1-fact-metadata.md`
+- Agent 要读的仓库文件：`lib/fact-store-pre.js`、`lib/index.js`（定位 `hubIo`）
+- 应产出：`lib/fact-store-pre.js` 增量 diff + 新断言
+- ⚠️ 内置硬停止：`hubIo()` 查不到 → Agent 必须停下回报，不许猜
+
+### 批次 B（主链串行，P1 完成后开工）
+
+**轮次 5 · P2 语义臂接入 recall**（前置：轮次 1 完成）
+- 投喂：`_COMMON.md` + `P2-semantic-recall.md`
+- Agent 要读的仓库文件：`lib/index.js`、`lib/semantic-js-pre.js`、`lib/shadow-retrieval-pre.js`、`lib/context-host-pre.js`
+- 额外验收：`recall(query, limit, agent, scope)` 签名未变；语义引擎不可用时退回纯词法
+
+**轮次 6 · P3 融合层改造**（前置：轮次 5）
+- 投喂：`_COMMON.md` + `P3-fusion.md`
+- Agent 要读的仓库文件：`lib/semantic-js-pre.js`、`lib/shadow-retrieval-pre.js`、`lib/context-bridge-pre.js`
+- 额外验收：`fuseD6Pre` 既有行为未被删改（并存）；无 score-space 加权 RRF
+
+**轮次 7 · P4 返回 L0 + 按需展开**（前置：轮次 6）
+- 投喂：`_COMMON.md` + `P4-l0-response.md`
+- Agent 要读的仓库文件：`lib/index.js`、`lib/memory-index-pre.js`
+- 额外验收：旧调用方式（不传新参数）行为不变
+
+### 批次 C（接续链 + M8 后续）
+
+**轮次 8 · P6 账本权重化截断**（前置：轮次 2 完成）
+- 投喂：`_COMMON.md` + `P6-ledger-weight.md`
+- Agent 要读的仓库文件：`lib/index.js`、`docs/M-CM7-HANDOFF-LAYERED-RETRIEVAL.md`
+- 应产出：`lib/handoff-anchor-pre.js` + smoke + `buildContinueCarry` 接线
+
+**轮次 9 · M8-2 importance 接线**（前置：轮次 6 完成；否则只交付纯函数不接线）
+- 投喂：`_COMMON.md` + `M8-2-importance-wiring.md`
+- Agent 要读的仓库文件：`lib/context-bridge-pre.js`、`lib/fact-store-pre.js`、`lib/procedure-store-pre.js`、`lib/shadow-retrieval-pre.js`、`lib/semantic-js-pre.js`
+- ⚠️ 内置硬停止：`evidenceFor()` 返回结构与 `correctionRate` 口径无法确认 → 停下回报
+
+**轮次 10 · M8-3 M8 启用与 live 验证**（⚠️ 最后；投喂前你必须先书面确认三问）
+- 你先回答（在投喂材料开头附上）：① 是否同意 `memoryHubEnabled` 默认改 true？② 是否保留回滚开关？③ live 验证由谁做？
+- 投喂：`_COMMON.md` + `M8-3-enable-verify.md`
+- Agent 要读的仓库文件：`lib/index.js`、`docs/M8-MEMORY-HUB.md`
+- 额外验收：Agent 产出 live 验证清单（重启 dsh web / 三栏有内容 / facts.json 落盘 / restore 不丢），由你执行
+
+---
+
+### 批次 D（2026-09-09 收官后补做，修 M8-2 未达成的排序目标）
+
+**轮次 11 · P8 RRF 接线进 recall**（前置：P3 已交付）
+- ⭐ **复制即投喂**：直接复制 `docs/prompts/FIX-AGENT-P8.md` 全文（**自包含，硬约束已内联，无需再拼 `_COMMON.md`**）
+- 或按公式投喂：`_COMMON.md` + `P8-rrf-wiring.md`
+- Agent 要读的仓库文件：`lib/index.js`（`recall()` 的 L0 分支）、`lib/recall-fusion-pre.js`、`lib/semantic-js-pre.js`、`lib/shadow-retrieval-pre.js`
+- 应产出：`lib/index.js` 最小 diff + 新断言
+- 额外验收：必须有「lex 相同、sem 不同 → 排序随 sem 变化」的断言；回报须含 **legacy vs rrf 的 top-5 id 序列 diff**（≥3 条查询）
+- 备注：本段是**缺陷修复**（P2 语义臂当前实效为零），默认开启 + `legacy` 回退
+
+**轮次 12 · M8-2b evidence 管道 + importance 加权**（前置：轮次 11 完成）
+- ⭐ **复制即投喂**：直接复制 `docs/prompts/FIX-AGENT-M8-2b.md` 全文（**自包含**，无需 `_COMMON.md`）
+- 或按公式投喂：`_COMMON.md` + `M8-2b-evidence-pipeline.md`
+- Agent 要读的仓库文件：`lib/index.js`（`6861-6876` 读取范式）、`lib/context-bridge-pre.js`、`lib/memory-importance-pre.js`、`lib/fact-store-pre.js`、`lib/procedure-store-pre.js`、`lib/recall-fusion-pre.js`
+- ⚠️ Agent 必须**实读一个真实 events 文件**确认行结构（`~/.dsh/memory/evidence-pre/events/*.jsonl`）
+- 应产出：`lib/evidence-agg-pre.js` + smoke + `recall()` 加权接线
+- 额外验收：只读性断言（不写回 events）、空数据返回中性值、有界读取（默认 7 天/末 400 行）
+
+
+**轮次 13 · P9 evidence 写入侧覆盖率排查**（前置：轮次 12 完成；**默认只排查，不改码**）
+- ⭐ **复制即投喂**：`docs/prompts/FIX-AGENT-P9.md` 全文（自包含，硬约束已内联）
+- Agent 要读：`lib/index.js`、`lib/context-bridge-pre.js`、`lib/procedure-store-pre.js` + 真实 events 目录
+- 应产出：实测 kind 分布 + reuse/success/correction 各自根因（(a) 未接线 / (b) 条件未满足 / (c) 分流）+ 修复方案（待你批准）
+- 额外验收：`git status` 中 **lib/ 不得有任何改动**（排查段）
+
+
+**轮次 14 · P11 静默 catch 可观测**（无依赖，**建议与轮次 13 并行**）
+- ⭐ **复制即投喂**：`docs/prompts/FIX-AGENT-P11.md` 全文（自包含，可与轮次 13 并行）
+- Agent 要读：`lib/index.js`（recall/接续链路的 catch）、`diag()` 定义处
+- 额外验收：`git diff` **仅含 catch 行**（无控制流改动）；给出全仓空 catch 清单与取舍理由
+
+**轮次 15 · P10 importance 效应定标**（前置：轮次 13 的 P9 结论）
+- 投喂：`_COMMON.md` + `P10-importance-calibration.md`
+- Agent 要读：`lib/index.js`（dense 臂）、`lib/memory-importance-pre.js`、既有配置读取机制
+- 应产出：`w` 可配置（默认 0.5，行为等价）+ **三档翻转率实测**（w=0/0.5/1，≥10 条真实查询）+ 至少 1 个翻转样例
+- ⚠️ 若没有统一配置机制 → Agent 必须停止回报，不得自造配置文件
+
+---
+
+## 三、依赖关系一图
+
+```
+轮次1(P1) ──→ 轮次5(P2) ──→ 轮次6(P3) ──→ 轮次7(P4)
+轮次2(P5) ──→ 轮次8(P6)                    轮次6 ──→ 轮次9(M8-2) ──→ 轮次10(M8-3，需你确认)
+轮次3(P7)
+轮次4(M8-1)
+轮次6(P3) ──→ 轮次11(P8 RRF 接线) ──→ 轮次12(M8-2b evidence 管道)
+轮次12 ──→ 轮次13(P9 排查) ──→ 轮次15(P10 定标)；轮次14(P11) 无依赖可并行
+（1–4 互不依赖，可并行；10 永远最后；11/12 为收官后补做）
+```
+
+## 四、常见翻车点
+
+1. **只粘任务文件、忘粘 `_COMMON.md`** → Agent 会整文件重写。
+2. **同一会话连喂多轮** → 上下文互相污染；每轮新开会话。
+3. **并行 Agent 同改 `lib/index.js`** → 轮次 2/3 都改它，须串行验收（A 批次里这两轮错开跑）；P2/P3/P4 与 P5/P6 同理。
+4. **跳过验收直接下一轮** → 错误跨轮传播，最后归因不了。

package/docs/prompts/FEEDING-SEQUENCE.md

@@ -0,0 +1,61 @@
+# 投喂顺序（3 段喂 AI + 1 步你做）
+
+> 每段**新开一个会话**，复制该段整段文字喂给 AI。AI 完成后停下回报，你验收后再喂下一段。
+> 第 4 段不是喂 AI 的，是你自己执行。
+
+---
+
+## 第 1 段 · 修 P12（主动联想词项截断）
+
+请先阅读以下两个文件，然后严格按里面的 prompt 完成工作：
+
+1. `D:\dsh-auto-memory\docs\prompts\_COMMON.md`
+2. `D:\dsh-auto-memory\docs\prompts\FIX-AGENT-P12-FULL-REGRESSION.md`
+
+本段目标：修复主动联想路径上「按字典序截断、丢高权重词」的缺陷，跑完九套静态回归，产出「重启后 live 验证清单」。完成后停下回报静态结论，等下一段。
+
+---
+
+## 第 2 段 · 加时间检索臂
+
+请先阅读以下两个文件，然后严格按里面的 prompt 完成工作：
+
+1. `D:\dsh-auto-memory\docs\prompts\_COMMON.md`
+2. `D:\dsh-auto-memory\docs\prompts\FIX-AGENT-TEMPORAL-ARM.md`
+
+本段目标：新增中文时间表达解析（纯函数），作为软性第三臂接入记忆检索，查询无时间表达时零行为变更。跑完静态回归后停下回报，等下一段。
+
+---
+
+## 第 3 段 · 收尾（提交 + 全量回归 + 发版准备）
+
+请先阅读以下三个文件，然后严格按里面的清单完成工作：
+
+1. `D:\dsh-auto-memory\docs\prompts\_COMMON.md`
+2. `D:\dsh-auto-memory\docs\RELEASE-GO-NOGO.md`
+3. `D:\dsh-auto-memory\docs\STATUS-BOARD.md`
+
+本段目标：
+
+1. 报告当前工作区状态（含两个未提交文件 `lib/index.js`、`lib/python-setup-pre.js` 的 diff 摘要）
+2. 跑一遍**全量静态回归**（P12 + 时间臂 落地后应新增两套，加上既有九套，共十一套）
+3. 确认所有静态基线全绿后，**停下等你确认**是否把那两个未提交文件一起提交
+4. 你确认后：提交本版本全部改动，并产出最终的「重启后 live 验证清单」
+
+---
+
+## 第 4 步 · 交给 Zcode 独立验收（推荐，非投喂给开发的 Agent）
+
+> **为什么交给 Zcode**：它能**重启 dsh web**（DSH 自己的 Agent 做不到，重启会截断对话）、能**操作 UI**、能**读后台日志**，而且是**独立第三方**——不受"自己写的自己测"的盲区影响。
+
+把 `D:\dsh-auto-memory\docs\prompts\LIVE-VERIFY-ZCODE.md` 整段喂给 Zcode（从"你是独立第三方验收 Agent"开始复制到末尾）。
+
+它会：重启 → 逐项实测九项（L1 主动联想 / L2 语义检索 / L3 L0 返回 / **T1 时间臂** / L4 M8 / L5 证据落盘 / L6 接续 / L7 写入 restore / P 性能）→ 每项贴证据 → 给 Go/No-Go 结论。
+
+**若你更想自己验**（Zcode 不可用时），按下面清单手测：
+
+1. 重启 dsh web
+2. 逐项验证（重点 L1 主动联想、L2 语义检索；另补时间臂：用一条含"上周"的查询实测召回按时间提升）
+3. 全部通过后：`node tools/release.mjs <版本号>` 发版
+
+> 判据：L2 语义检索失败且 `legacy` 下正常 = P8 回归；T1 中"无时间词查询排序也变了" = 违反零行为变更；任一成立即暂缓发版。

package/docs/prompts/FIX-AGENT-M8-2b.md

@@ -0,0 +1,119 @@
+> **给使用者的说明**：**P8 验收通过后再投喂本段**。同样自包含（硬约束内联 + 绝对路径），复制时从 `你是一名严谨的修复 Agent` 开始复制到文件末尾。
+
+---
+
+你是一名严谨的修复 Agent。工作目录：`D:\dsh-auto-memory`（Node.js 项目，BSD-3-Clause，v2.2.6，零运行时依赖）。
+
+# 任务：补上「evidence 事件 → 聚合 → importance → 参与检索排序」这条管道
+
+## 0. 必读文件（绝对路径，先全部读完再动手）
+
+- `D:\dsh-auto-memory\lib\memory-importance-pre.js` —— M8-2 已交付的纯函数（**未接线**，本任务消费它）
+- `D:\dsh-auto-memory\lib\context-bridge-pre.js` —— 六类 evidence 写入侧（第 45 行 `ACCESS_KINDS_PRE_V1`）
+- `D:\dsh-auto-memory\lib\procedure-store-pre.js` —— `correctionRate` 口径来源（**必须复用，不得另立一套**）
+- `D:\dsh-auto-memory\lib\fact-store-pre.js` —— `evidenceFor()`（注释称消费侧聚合，**实际零调用方**）
+- `D:\dsh-auto-memory\lib\index.js` —— 第 6861–6876 行附近已有 evidence 事件的**读取范式**（**直接复用，不要另造**）；以及 P8 刚改好的 `recall()` 融合入口
+- `D:\dsh-auto-memory\lib\recall-fusion-pre.js` —— P8 接线后的 RRF（**禁止修改**）
+- 真实数据样本：`C:\Users\JH Z\.dsh\memory\evidence-pre\events\*.jsonl`（**必须实读至少 1 个文件确认行结构**）
+
+## 1. 问题（已有代码证据，你必须先自行复现验证）
+
+- **数据在盘上，只是没人读**：evidence 事件按日落盘为 JSONL，行结构含 `{ kind, memoryId, ts 或 event.ts, ... }`。
+- `evidenceFor` 在 `lib/` 下 grep **仅命中注释**，`lib/index.js` 无 evidence store 实例 → **检索侧拿不到 evidence**。
+- `lib\memory-importance-pre.js` 已交付 importance 纯函数，但**零引用**。
+- 因此 M8-2 的原始目标「importance 参与候选排序」未达成。
+
+**请用 grep + 实读一个 events 文件复现以上事实，并在回报中给出真实行号与一条真实事件样本（脱敏后）。**
+
+## 2. 目标
+
+新增只读聚合层 `lib\evidence-agg-pre.js`：按 `memoryId` 聚合六类计数与去重会话数 → 经 `memory-importance-pre.js` 转 importance → 作为**加权因子之一**接入 P8 已建好的 `recall()` 融合排序。
+
+## 3. 硬约束（违反即打回）
+
+1. **搜索优先**：每个符号先 grep 到定义处；**events 行结构必须实读真实文件确认，禁止假设字段名**。
+2. **最小 diff**，禁止整文件重写。
+3. **零新依赖**；新模块遵循 `lib\xxx-pre.js` 惯例：**纯函数 + IO 注入，零内置 IO**。
+4. **只读**：聚合层**不得写入**任何文件，尤其不得修改 events 目录。
+5. **fail-soft**：events 缺失/损坏/读取失败 → importance 取中性值，**绝不阻塞检索**。
+6. **不得另立一套纠正口径**：`correction` 的负向处理必须复用 `procedure-store-pre.js` 的 `correctionRate` 口径。
+7. **importance 只能是加权因子之一**，不得成为唯一排序依据。
+
+## 4. 改动边界
+
+**允许新增**
+- `D:\dsh-auto-memory\lib\evidence-agg-pre.js`
+- `D:\dsh-auto-memory\tests\smoke\smoke-test-evidence-agg-pre.mjs`
+
+**允许修改**
+- `D:\dsh-auto-memory\lib\index.js` —— 仅在 P8 建好的融合入口处**加一项加权**（最小 diff）
+
+**禁止修改**（绝对路径）
+- `D:\dsh-auto-memory\lib\memory-importance-pre.js`（M8-2 已锁定）
+- `D:\dsh-auto-memory\lib\recall-fusion-pre.js`（P8 已锁定）
+- `D:\dsh-auto-memory\lib\context-bridge-pre.js`（写入侧）
+- `D:\dsh-auto-memory\lib\procedure-store-pre.js`
+- `D:\dsh-auto-memory\lib\fact-store-pre.js`
+- evidence 事件目录（只读，不得增删改）
+
+## 5. 验收标准（逐条可验证）
+
+1. `evidence-agg-pre.js` 为**纯函数 + IO 注入**，可用 fixture 锁定，结果**确定性**。
+2. 按 `memoryId` 聚合六类计数 + `distinctSessions`，输出形状与 `memory-importance-pre.js` 的**输入契约一致**（以其源码为准）。
+3. **有界读取**：默认最近 7 天 / 每文件末 400 行（沿用 `index.js:6861-6876` 范式），可配置；**不得全量扫描历史**。
+4. **空数据返回中性值**：无 evidence 记录的记忆既不置顶也不沉底。
+5. **只读性断言**：运行前后 events 目录文件哈希不变。
+6. `correction` 为负向；importance **只作为加权因子之一**接入。
+7. 既有基线不降：`memory-importance 17`、`p4 34` 及十三套基线。
+8. 覆盖「读取失败 → 中性值」的 fail-soft 断言。
+
+## 6. 停止条件（触发即停下回报，禁止猜测）
+
+- 真实 events 文件结构不含 `kind` 或 `memoryId`；
+- `memory-importance-pre.js` 的输入契约无法确认；
+- P8 的融合入口不支持加入加权项（此时应回报"需先扩展 P8 接口"，**不得自行改写 `recall-fusion-pre.js`**）。
+
+回报格式：
+```
+停止原因：未能定位/确认 <符号/结构>
+已尝试：<搜索词 1>、<搜索词 2>、<路径>
+需要：<澄清问题>
+```
+
+## 7. 完成后自检（逐项执行并把原始输出贴进回报）
+
+```bash
+cd /d/D/dsh-auto-memory || cd D:/dsh-auto-memory
+
+node --check lib/evidence-agg-pre.js
+node --check lib/index.js
+
+node tests/smoke/smoke-test-evidence-agg-pre.mjs       # 新增
+node tests/smoke/smoke-test-memory-importance-pre.mjs   # 17
+node tests/smoke/smoke-test-p4-recall-l0-pre.mjs        # 34
+node tests/smoke/smoke-test-l0-extract-pre.mjs          # 18
+node tests/smoke/smoke-test-handoff-pre.mjs             # 51
+node tests/smoke/smoke-test-continue-chain-pre.mjs      # 58
+node tests/smoke/smoke-test-water-step-pre.mjs          # 12
+node tests/smoke/smoke-test-autocont-host-pre.mjs       # 29
+
+# 接口一致性：importance 现在应有调用方
+grep -rn "memory-importance\|evidence-agg" lib/ | head -20
+
+git status --short
+git diff --stat
+```
+
+## 8. 回报必须包含（缺一不可）
+
+1. **一条真实 events 行样本**（脱敏）与你据此确认的字段结构
+2. 每处改动写成 `文件路径:行号 — 原内容 → 新内容`
+3. importance 加在融合公式的哪一项、为何不破坏 P8 的 rank-space 结构
+4. 有界读取的具体参数与默认值
+5. 只读性证据（events 目录前后哈希）
+6. 回滚方式：删除新增文件 + `git checkout lib/index.js`
+7. 上述自检的原始输出
+
+---
+
+> **投喂提示**：本段自包含，无需再附 `_COMMON.md`。原文依据见 `D:\dsh-auto-memory\docs\prompts\M8-2b-evidence-pipeline.md` 与 `M8-2-ADJUDICATION.md`。

package/docs/prompts/FIX-AGENT-P11.md

@@ -0,0 +1,97 @@
+> **给使用者的说明**：**可与 P9 并行**投喂给另一个 Agent（无依赖、风险低、建议尽早做）。复制时从 `你是一名严谨的修复 Agent` 开始到文件末尾（自包含，无需 `_COMMON.md`）。
+> ⚠️ 本段会改 `lib\index.js` —— **与 P9 排查段不冲突**（P9 不改码），但**不要和其他改 index.js 的任务同时进行**。
+
+---
+
+你是一名严谨的修复 Agent。工作目录：`D:\dsh-auto-memory`（Node.js 项目，BSD-3-Clause，v2.2.6，零运行时依赖）。
+
+# 任务：fail-soft 空 catch 统一可观测（只加日志，绝不改行为）
+
+## 0. 背景（实读代码，2026-09-09 核实）
+
+- M8-2b 曾出现 P0 缺陷：新增代码裸用未导入的 `readdirSync`，抛错后被 `catch (eImp) {}` **静默吞掉**，导致整条 importance 管道在生产中全程失效，而**四套冒烟全绿**——因为冒烟测的是纯函数，从不执行接线代码。
+- 该缺陷已修（提交 `4d54664`），同提交给该 catch 补了 diag，写法如下（**沿用这个写法**）：
+
+```js
+} catch (eImp) { try { diag('evidence-agg 降级为中性(impMap 空): ' + String((eImp && eImp.message) || eImp).slice(0, 140)) } catch (_) {} }
+```
+
+- 同一条 recall 融合链上**仍有同款静默空 catch**：`eRrf`、`eL0Sem`、`eAnchor`（名称以实际 grep 为准）。
+
+**目标**：把**记忆 / 检索 / 接续链路**上的 fail-soft 空 catch 统一加上可辨识的 diag 日志。**只加日志，控制流一律不变。**
+
+## 1. 必读文件（绝对路径）
+
+- `D:\dsh-auto-memory\lib\index.js` —— 主要改动面（recall 融合、L0 语义、接续锚点链路）
+- `D:\dsh-auto-memory\lib\client.js` —— 查是否有同款空 catch
+- `diag()` 的定义处（在 `lib\index.js` 内，请自行 grep 定位，确认其输出目标文件）
+- 参考写法：`git show 4d54664 -- lib/index.js`
+
+## 2. 硬约束（违反即打回）
+
+1. **搜索优先**：先 grep 定位 `diag()` 定义、空 catch 全清单，记下真实行号（prompt 中的行号可能漂移）。
+2. **行为零变更**：异常仍被吞掉（保持 fail-soft，不向上抛），不得改控制流，不得加重试，不得改 `try` 内任何业务逻辑。
+3. **最小 diff**：`git diff` 只能出现 catch 行。
+4. **零新依赖**；不得引入日志库。
+5. **日志不得进入提示词 / 注入内容 / 对外响应**——diag 只写日志文件。
+6. 不得删除既有断言。
+
+## 3. 改动边界
+
+- ✅ 允许修改：`D:\dsh-auto-memory\lib\index.js` 中**记忆/检索/接续链路**的 catch 行
+- ❌ **禁止修改**：任何 `try` 块内的业务逻辑；任何控制流
+- ❌ 禁止：全仓无差别改造（只改记忆/检索/接续链路）；给无关 catch 加日志
+- ❌ 禁止修改：`lib\recall-fusion-pre.js`、`lib\evidence-agg-pre.js`、`lib\memory-importance-pre.js`、`lib\l0-extract-pre.js`
+
+## 4. 验收标准
+
+1. **先出清单**：grep 全仓 `catch` 后直接 `{}` 或仅注释的空捕获，按模块分组列 `文件:行号`；**明确标注本次改哪些、不改哪些及理由**
+2. 每处补日志的 catch：
+   - 可辨识前缀（如 `recall-fusion 降级:` / `l0-sem 降级:` / `handoff-anchor 降级:`）
+   - 含异常摘要（`String((e && e.message) || e).slice(0, 140)`）
+   - **外层再包一层 try/catch**，确保 diag 自身抛错也不影响主流程
+3. **行为不变**：可通过 `git diff` 证明只有 catch 行被改
+4. 确认 `diag()` 输出目标**在 `~/.dsh/memory` 之外或不污染用户记忆文件**（隐私口径）
+5. 基线不降：p8 14 / p4 34 / evidence-agg 14 / memory-importance 18 / handoff 51 / continue-chain 58
+
+## 5. 停止条件
+
+若 `diag()` 不存在，或其输出目标落在用户记忆目录内（可能污染记忆或外泄），**立即停止回报**，不得自行新建日志通道。
+
+```
+停止原因：未能定位 <符号> / 输出目标不合规
+已尝试：<搜索词 1>、<搜索词 2>、<路径>
+需要：<澄清问题>
+```
+
+## 6. 完成后自检（逐项执行并贴原始输出）
+
+```bash
+cd /d/D/dsh-auto-memory || cd D:/dsh-auto-memory
+
+node --check lib/index.js
+
+node tests/smoke/smoke-test-p8-rrf-wiring-pre.mjs       # 14
+node tests/smoke/smoke-test-p4-l0-response-pre.mjs      # 34
+node tests/smoke/smoke-test-evidence-agg-pre.mjs        # 14
+node tests/smoke/smoke-test-memory-importance-pre.mjs   # 18
+node tests/smoke/smoke-test-handoff-pre.mjs             # 51
+node tests/smoke/smoke-test-continue-chain-pre.mjs      # 58
+
+# 证明只有 catch 行被改
+git diff --stat
+git diff lib/index.js | grep -E "^[+-]" | grep -vE "^[+-]{3}"
+```
+
+## 7. 回报必须包含
+
+1. 全仓空 catch 清单（按模块分组）+ 本次取舍理由
+2. 每处改动：`文件:行号 — 原内容 → 新内容`
+3. `diag()` 定义位置与输出目标文件
+4. 控制流未变的证明（diff 仅含 catch 行）
+5. 自检原始输出
+6. 回滚方式：`git checkout lib/index.js`
+
+---
+
+> 背景依据：`D:\dsh-auto-memory\docs\prompts\M8-2-ADJUDICATION.md` §6.2、§6.4。