@a9i5k4/dsh-auto-memory 3.1.5 → 3.1.7

package/lib/tier-layer-inject.js

@@ -1,5 +1,5 @@
 /**
- * 三层注入装配（tier_layer_inject_v1）—— 契约 C5
+ * 三层注入装配（tier_layer_inject_pre_v1）—— 契约 C5
  * （`docs/internal/THREE-LAYER-CONTRACT.md` §2.1/§5、`SEMANTIC-ARCHITECTURE-SPEC.md` S5/S9）。
  *
  * 2026-09-14 建立。职责 = **把三层按闸门装成一段可注入文本**：
@@ -33,10 +33,10 @@ import {
 // 而本模块的 S9 检查只禁网络/LLM/子进程/await，不禁内部纯模块引用（该模块本身零 import）。
 import { isCurrentPre } from './l0-extract.js'
 
-export const TIER_INJECT_VERSION = 'tier_layer_inject_v1'
+export const TIER_INJECT_VERSION = 'tier_layer_inject_pre_v1'
 
 /** 契约预算（冻结；变更须同步 `THREE-LAYER-CONTRACT.md` §4.3）。 */
-export const TIER_BUDGET_V1 = Object.freeze({
+export const TIER_BUDGET_PRE_V1 = Object.freeze({
   B0: 800,
   L1: 140,
   K: 8,
@@ -47,7 +47,7 @@ export const TIER_BUDGET_V1 = Object.freeze({
 })
 
 /** 段落标记（可读、可 grep；不改既有 Reference Tail 的固定边界行）。 */
-export const TIER_MARK_V1 = Object.freeze({
+export const TIER_MARK_PRE_V1 = Object.freeze({
   degrade: '[降级]',
   gate: '[闸门]',
   account: '[层账]',
@@ -55,7 +55,7 @@ export const TIER_MARK_V1 = Object.freeze({
 })
 
 /** 五层展示顺序（与契约 §2 优先级一致：project > whiteboard > user > reflection > log）。 */
-export const TIER_LAYER_ORDER_V1 = Object.freeze(['project', 'whiteboard', 'user', 'reflection', 'log'])
+export const TIER_LAYER_ORDER_PRE_V1 = Object.freeze(['project', 'whiteboard', 'user', 'reflection', 'log'])
 
 /** 深挖语义（决定"要不要下探 Tier-1"）：含这些词说明用户在问"怎么/为什么/具体"。 */
 const DEEP_INTENT_RE = /为什么|怎么|如何|具体|复现|细节|原理|根因|哪个文件|在哪/
@@ -143,7 +143,7 @@ export function filterExcludedSourcesPre(hits, patterns) {
   }
   const normPath = (s) => String(s == null ? '' : s).replace(/[\\/]+/g, '/').toLowerCase()
   const isDirPat = (p) => /[\\/]$/.test(p)
-  const layers = new Set(TIER_LAYER_ORDER_V1)
+  const layers = new Set(TIER_LAYER_ORDER_PRE_V1)
   const matched = new Set()
   const kept = []
   const dropped = []
@@ -189,7 +189,7 @@ export function filterExcludedSourcesPre(hits, patterns) {
  * 于是「A 快照产生的候选，到 B 快照才准备输出」时会照样被复用（A 的正文进了 B 的注入），
  * 这正是 T0-2 要挡的场景（契约 I6：三层必须来自同一份快照，混版视为错误）。
  */
-export const TIER_HITS_REUSE_REASONS_V1 = Object.freeze({
+export const TIER_HITS_REUSE_REASONS_PRE_V1 = Object.freeze({
   ok: '投影仍属当前快照',
   'no-projection': '本轮无命中投影（尚未发生激活投递）',
   'stale-time': '投影超出新鲜度窗口（仅时间新鲜不足以保证版本一致）',
@@ -205,7 +205,7 @@ export const TIER_HITS_REUSE_REASONS_V1 = Object.freeze({
 /** 原因码 → 可读中文（未知码原样返回，便于排障时不吞信息）。 */
 export function describeReuseReasonPre(code) {
   const k = clean(code)
-  return TIER_HITS_REUSE_REASONS_V1[k] || k || '未知原因'
+  return TIER_HITS_REUSE_REASONS_PRE_V1[k] || k || '未知原因'
 }
 
 /**
@@ -285,7 +285,7 @@ export function selectReusableTierHitsPre(input = {}) {
 }
 
 /** 跳过原因 → 可读中文（I7：降级行必须人能读懂，不能只写机器枚举）。 */
-export const SKIP_REASON_TEXT_V1 = Object.freeze({
+export const SKIP_REASON_TEXT_PRE_V1 = Object.freeze({
   'missing-path': '路径未提供',
   'not-found': '文件不存在',
   'not-a-file': '路径不是文件',
@@ -301,7 +301,7 @@ export const SKIP_REASON_TEXT_V1 = Object.freeze({
 export function describeReasonPre(reason) {
   const key = clean(reason)
   if (!key) return '未知原因'
-  return SKIP_REASON_TEXT_V1[key] || key
+  return SKIP_REASON_TEXT_PRE_V1[key] || key
 }
 
 /**
@@ -310,7 +310,7 @@ export function describeReasonPre(reason) {
  * @param {string[]} [order]
  */
 export function tierLayerAccountLinePre(perLayer, order) {
-  const layers = Array.isArray(order) && order.length ? order : TIER_LAYER_ORDER_V1
+  const layers = Array.isArray(order) && order.length ? order : TIER_LAYER_ORDER_PRE_V1
   const segs = layers.map((layer) => {
     const m = (perLayer && perLayer[layer]) || null
     if (!m) return layer + ' ?'
@@ -318,7 +318,7 @@ export function tierLayerAccountLinePre(perLayer, order) {
     return layer + ' ' + m.picked + '/' + m.candidates + (m.dropped ? '(裁' + m.dropped + ')' : '')
   })
   const dropped = layers.reduce((a, l) => a + (((perLayer && perLayer[l]) || {}).dropped || 0), 0)
-  return TIER_MARK_V1.account + ' ' + segs.join(' · ') + (dropped ? ' · 合计裁剪 ' + dropped + ' 条' : '')
+  return TIER_MARK_PRE_V1.account + ' ' + segs.join(' · ') + (dropped ? ' · 合计裁剪 ' + dropped + ' 条' : '')
 }
 
 /**
@@ -331,7 +331,7 @@ export function collectDegradationsPre(input = {}) {
   const o = input && typeof input === 'object' ? input : {}
   const catalog = o.catalog || null
   const out = []
-  const mark = TIER_MARK_V1.degrade + ' '
+  const mark = TIER_MARK_PRE_V1.degrade + ' '
 
   if (!catalog) {
     out.push({ code: 'catalog-missing', text: mark + 'Tier-0 目录生成器未返回结果（本轮无目录层）' })
@@ -424,8 +424,8 @@ function hitSummarySourcePre(h) {
  * 超出 K 的部分**显式计数**（不静默截断）。
  */
 export function buildTier1SectionPre(hits, opts = {}) {
-  const K = Math.max(1, Number((opts && opts.maxItems) || TIER_BUDGET_V1.K))
-  const L1 = Math.max(8, Number((opts && opts.itemChars) || TIER_BUDGET_V1.L1))
+  const K = Math.max(1, Number((opts && opts.maxItems) || TIER_BUDGET_PRE_V1.K))
+  const L1 = Math.max(8, Number((opts && opts.itemChars) || TIER_BUDGET_PRE_V1.L1))
   const list = (Array.isArray(hits) ? hits.filter(Boolean) : [])
     .map((h, i) => ({ h, i, s: Number(h.score) }))
     .sort((a, b) => (Number.isFinite(b.s) ? b.s : -1) - (Number.isFinite(a.s) ? a.s : -1) || a.i - b.i)
@@ -440,7 +440,7 @@ export function buildTier1SectionPre(hits, opts = {}) {
   })
   const overflow = list.length - kept.length
   const head = '[Tier-1 命中摘要 · ' + kept.length + '/' + list.length + ' 条 · 每条 ≤' + L1 + ' 字 · K=' + K + ']'
-  const tail = overflow > 0 ? [TIER_MARK_V1.degrade + ' Tier-1 另 ' + overflow + ' 条命中未展开（K=' + K + ' 上限）；需要时用 memory_recall 取'] : []
+  const tail = overflow > 0 ? [TIER_MARK_PRE_V1.degrade + ' Tier-1 另 ' + overflow + ' 条命中未展开（K=' + K + ' 上限）；需要时用 memory_recall 取'] : []
   return {
     text: [head].concat(lines, tail).join('\n'),
     lines,
@@ -454,8 +454,8 @@ export function buildTier1SectionPre(hits, opts = {}) {
  * Tier-2 渲染：命中块原文，单块 ≤ `B2`（默认 2400）字符；超长块显式标注"已截断，全文 N 字符"。
  */
 export function buildTier2SectionPre(hits, opts = {}) {
-  const B2 = Math.max(80, Number((opts && opts.maxChars) || TIER_BUDGET_V1.B2))
-  const maxBlocks = Math.max(1, Number((opts && opts.maxBlocks) || TIER_BUDGET_V1.maxTier2Blocks))
+  const B2 = Math.max(80, Number((opts && opts.maxChars) || TIER_BUDGET_PRE_V1.B2))
+  const maxBlocks = Math.max(1, Number((opts && opts.maxBlocks) || TIER_BUDGET_PRE_V1.maxTier2Blocks))
   const list = (Array.isArray(hits) ? hits.filter(Boolean) : [])
     .map((h, i) => ({ h, i, s: Number(h.score) }))
     .sort((a, b) => (Number.isFinite(b.s) ? b.s : -1) - (Number.isFinite(a.s) ? a.s : -1) || a.i - b.i)
@@ -496,7 +496,7 @@ export function buildTier2SectionPre(hits, opts = {}) {
  */
 export function composeTieredInjectionPre(input = {}) {
   const o = input && typeof input === 'object' ? input : {}
-  const maxTokens = Math.max(60, Number(o.maxTokens) > 0 ? Math.min(Number(o.maxTokens), TIER_BUDGET_V1.B0) : TIER_BUDGET_V1.B0)
+  const maxTokens = Math.max(60, Number(o.maxTokens) > 0 ? Math.min(Number(o.maxTokens), TIER_BUDGET_PRE_V1.B0) : TIER_BUDGET_PRE_V1.B0)
   // I5 状态过滤（2026-09-14 P0 / C8）：**闸门之前**先挡下非 current —— 顺序很关键。
   // 若放在 Tier-1 渲染里过滤，闸门仍会看到"有命中"而下探、渲染出空段，浪费一轮预算且语义错乱；
   // 放在闸门前，则"全是 superseded"会自然退化成 tier0（本轮无可下探内容），这才是真实处境。
@@ -516,7 +516,7 @@ export function composeTieredInjectionPre(input = {}) {
   const catalog = o.catalog || buildTier0CatalogFromTextPre(Array.isArray(o.sources) ? o.sources : [], {
     maxTokens,
     estimateMode: 'conservative',
-    quota: { projectRatio: TIER_BUDGET_V1.projectRatio, floorRatio: TIER_BUDGET_V1.floorRatio },
+    quota: { projectRatio: TIER_BUDGET_PRE_V1.projectRatio, floorRatio: TIER_BUDGET_PRE_V1.floorRatio },
   })
   const degradations = collectDegradationsPre({
     catalog,
@@ -528,7 +528,7 @@ export function composeTieredInjectionPre(input = {}) {
   if (exHits.droppedCount > 0) {
     degradations.push({
       code: 'excluded-source',
-      text: TIER_MARK_V1.degrade + ' 已按用户排除项挡下 ' + exHits.droppedCount + ' 条命中（'
+      text: TIER_MARK_PRE_V1.degrade + ' 已按用户排除项挡下 ' + exHits.droppedCount + ' 条命中（'
         + exHits.matchedPatterns.slice(0, 3).map((p) => clean(p)).join(' / ') + '）· 不进注入',
     })
   }
@@ -538,7 +538,7 @@ export function composeTieredInjectionPre(input = {}) {
     const states = Array.from(new Set(gateHits.dropped.map((h) => clean(h && h.status) || '(空)')))
     degradations.push({
       code: 'status-filtered',
-      text: TIER_MARK_V1.degrade + ' 已按 I5 挡下 ' + gateHits.droppedCount + ' 条非 current 命中（'
+      text: TIER_MARK_PRE_V1.degrade + ' 已按 I5 挡下 ' + gateHits.droppedCount + ' 条非 current 命中（'
         + states.join('/') + '）· 审计视图仍可见，但不进注入',
     })
   }
@@ -550,7 +550,7 @@ export function composeTieredInjectionPre(input = {}) {
     ? buildTier2SectionPre(gateHits.kept, { maxChars: o.B2, maxBlocks: o.maxBlocks })
     : null
 
-  const head = '[Tier-0 常驻目录 · 指引层 · ≤B0=' + TIER_BUDGET_V1.B0 + ' token(实计 ' + catalog.tokens + ') · '
+  const head = '[Tier-0 常驻目录 · 指引层 · ≤B0=' + TIER_BUDGET_PRE_V1.B0 + ' token(实计 ' + catalog.tokens + ') · '
     + (Array.isArray(catalog.items) ? catalog.items.length : 0) + ' 条]'
   const headParts = [head]
   if (Array.isArray(catalog.items) && catalog.items.length) headParts.push(catalog.text)
@@ -558,12 +558,12 @@ export function composeTieredInjectionPre(input = {}) {
   for (const d of degradations) headParts.push(d.text)
   const drillParts = []
   if (gate.level === 'tier0') {
-    headParts.push(TIER_MARK_V1.gate + ' 本轮无语义命中（' + gate.reasons.join(',') + '）→ 仅目录层，未下探 Tier-1/Tier-2')
+    headParts.push(TIER_MARK_PRE_V1.gate + ' 本轮无语义命中（' + gate.reasons.join(',') + '）→ 仅目录层，未下探 Tier-1/Tier-2')
   } else {
-    headParts.push(TIER_MARK_V1.gate + ' 本轮命中 ' + gate.hitCount + ' 条（' + gate.reasons.join(',') + '）→ 下探 Tier-1')
+    headParts.push(TIER_MARK_PRE_V1.gate + ' 本轮命中 ' + gate.hitCount + ' 条（' + gate.reasons.join(',') + '）→ 下探 Tier-1')
     if (tier1) drillParts.push(tier1.text)
     if (tier2) {
-      drillParts.push(TIER_MARK_V1.gate + ' 需要证据语义 → 继续下探 Tier-2（单块 ≤' + TIER_BUDGET_V1.B2 + ' 字符）')
+      drillParts.push(TIER_MARK_PRE_V1.gate + ' 需要证据语义 → 继续下探 Tier-2（单块 ≤' + TIER_BUDGET_PRE_V1.B2 + ' 字符）')
       drillParts.push(tier2.text)
     }
   }
@@ -582,7 +582,7 @@ export function composeTieredInjectionPre(input = {}) {
   let claimedTotalChars = 0
   const maxTotal = Number(o.maxTotalChars) > 0 ? Number(o.maxTotalChars) : 0
   if (maxTotal) {
-    const noteFor = (n) => TIER_MARK_V1.degrade + ' 下探段超注入预算，已裁剪 ' + n + ' 行（目录层与降级标注不受影响）'
+    const noteFor = (n) => TIER_MARK_PRE_V1.degrade + ' 下探段超注入预算，已裁剪 ' + n + ' 行（目录层与降级标注不受影响）'
     const lines = drillParts.join('\n').split('\n').filter(Boolean)
     // 用"预留降级行长度"的保守估计先裁（降级行的字数随 trimmed 变化，先按最坏情况占位）。
     const reserve = noteFor(999).length
@@ -604,7 +604,7 @@ export function composeTieredInjectionPre(input = {}) {
     if (claimedTotalChars > maxTotal) {
       // 走投无路：目录层与降级行按 I7 不可裁 ⇒ **如实标注**，绝不假装达标。
       headOverBudget = claimedTotalChars - maxTotal
-      const overNote = TIER_MARK_V1.degrade + ' 目录层与降级标注不可裁，本轮合计仍超注入预算 '
+      const overNote = TIER_MARK_PRE_V1.degrade + ' 目录层与降级标注不可裁，本轮合计仍超注入预算 '
         + headOverBudget + ' 字符（尽力门 + 显式超额，不静默）'
       headParts.push(overNote)
       claimedTotalChars = headParts.join('\n').length + (drillLen ? 1 + drillLen : 0)

package/lib/tier0-catalog.js

@@ -1,5 +1,5 @@
 /**
- * Tier-0 目录生成器（tier0_catalog_v1）—— 三层检索契约（`docs/internal/THREE-LAYER-CONTRACT.md`）C4。
+ * Tier-0 目录生成器（tier0_catalog_pre_v1）—— 三层检索契约（`docs/internal/THREE-LAYER-CONTRACT.md`）C4。
  *
  * 2026-09-14 建立。作用＝**指引层**：把四类来源（用户级记忆 / 项目笔记 / 当日日志 / 白板 PLAN）
  * 压成"每条 1 行"的短目录，用来回答「要不要用某条记忆」，从而决定是否下探 Tier-1 / Tier-2。
@@ -26,7 +26,7 @@
  * 约 2-4 倍**（中文接近 1 token/字符），拿它当预算门会静默突破 B0。故本模块两种口径都实现：
  *   - `estimateMode:'repo'`         —— 原样复刻仓库既有口径（供对齐 / 复算）；
  *   - `estimateMode:'conservative'` —— `ceil(字符/2)`，**默认**用它当预算门（CJK 密集体裁的保守上界）。
- * 验收口径：**两种口径下 text 都 ≤ maxTokens**（见 `tests/smoke/smoke-test-tier0-catalog-pre.mjs`）。
+ * 验收口径：**两种口径下 text 都 ≤ maxTokens**（见 `tests/smoke/smoke-test-tier0-catalog.mjs`）。
  *
  * 单元（"一条"）切分：① 有 `<!-- memory:mem_<32hex> -->` 锚点 → 一块一条（与 l0-extract-pre 同约定：
  * 锚点标记其**后**内容）；② 无锚点 → 按最浅的 ≥2 级标题切（`#` 文档标题成为独立一条）；③ 无标题 →
@@ -44,12 +44,12 @@
  */
 import { readFileSync, statSync } from 'node:fs'
 
-export const TIER0_CATALOG_VERSION = 'tier0_catalog_v1'
+export const TIER0_CATALOG_VERSION = 'tier0_catalog_pre_v1'
 
 /**
  * ★M1（2026-09-18）：白板锚点 id 的**形态判据**（契约 §2）。
  *
- * 与 `wb-sidecar.js:466 WB_ANCHOR_LINE_RE_V1`、契约 §2 的
+ * 与 `wb-sidecar.js:466 WB_ANCHOR_LINE_RE_PRE_V1`、契约 §2 的
  * `^mem_[0-9a-f]{32}$` **同源同形**。此处**本地定义而非 import**：
  *   - tier0-catalog 是本仓最底层的目录渲染模块，不应反向依赖 wb-sidecar（避免耦合/循环）；
  *   - 两处形态由**同一份契约文档**约束，套件断言两者**逐字相同**（防双源漂移）。

package/lib/wb-contract.js

@@ -1,5 +1,5 @@
 /**
- * 白板格式适配器（wb_contract_v1）—— 白板线拥有「白板格式及其适配器」。
+ * 白板格式适配器（wb_contract_pre_v1）—— 白板线拥有「白板格式及其适配器」。
  *
  * 2026-09-14 建立（P0 最小适配边界）。**边界（总纲 §0.5 / ROUND3 §3.1 定案）**：
  *   - **3.0 主体**拥有「共同提交与保护入口」= `lib/memory-mutation.js:validateMutationBoundaryPre`
@@ -27,15 +27,15 @@
  */
 import { createHash } from 'node:crypto'
 // 账本四段判据复用既有解析器（`handoff-anchor.js` 是账本段结构的既有权威，不另写一份）
-import { parseHandoffLedgerPre, HANDOFF_LEDGER_SECTION_WEIGHTS_V1 } from './handoff-anchor.js'
+import { parseHandoffLedgerPre, HANDOFF_LEDGER_SECTION_WEIGHTS_PRE_V1 } from './handoff-anchor.js'
 
-export const WB_CONTRACT_VERSION = 'wb_contract_v1'
+export const WB_CONTRACT_VERSION = 'wb_contract_pre_v1'
 
 /** 锚点正则（与 `l0-extract.js` 的 `MEM_ANCHOR_RE` 完全一致；契约 §2 要求"完全一致"）。 */
-export const WB_ANCHOR_RE_V1 = /^<!--\s*memory:(mem_[0-9a-f]{32})\s*-->$/
+export const WB_ANCHOR_RE_PRE_V1 = /^<!--\s*memory:(mem_[0-9a-f]{32})\s*-->$/
 
 /** 分区标记（契约 §5 逐字）。 */
-export const WB_MARKERS_V1 = Object.freeze({
+export const WB_MARKERS_PRE_V1 = Object.freeze({
   modelOpen: '<!-- model -->',
   modelClose: '<!-- /model -->',
   userOpen: '<!-- user -->',
@@ -48,10 +48,10 @@ export const WB_MARKERS_V1 = Object.freeze({
  *  (`current`/`superseded`/`retracted`), 属已发布插件 (@a9i5k4/dsh-auto-memory 3.0.0, 有真实用户)
  *  的公开导出面; 第三方按契约读取状态时需要它作为**单一真源**, 删掉等于把值域契约降级成散落字面量。
  *  ⇒ 保留 + 显式标注, 不做"沉默留着"。 */
-export const WB_STATUSES_V1 = Object.freeze(['current', 'superseded', 'retracted'])
+export const WB_STATUSES_PRE_V1 = Object.freeze(['current', 'superseded', 'retracted'])
 
 /** 解析/校验的原因码 → 可读中文。 */
-export const WB_REASONS_V1 = Object.freeze({
+export const WB_REASONS_PRE_V1 = Object.freeze({
   'not-string': '内容不是字符串',
   'empty': '内容为空',
   'no-card': '页面里没有任何卡片标题（`### ` 行）',
@@ -66,17 +66,17 @@ export const WB_REASONS_V1 = Object.freeze({
 
 /** 原因码 → 可读中文（未知码原样返回，排障不吞信息）。
  *  ⚠️ 2026-09-17 L7 存活标注: 本函数**当前无仓内调用者**(全仓引用计数 = 1, 仅此定义)。
- *  判定 = **对外契约保留**, 不删 —— 它是 `WB_REASONS_V1`(上文, **有消费者**) 的唯一
+ *  判定 = **对外契约保留**, 不删 —— 它是 `WB_REASONS_PRE_V1`(上文, **有消费者**) 的唯一
  *  取值入口; 删掉函数会让那份码表的"怎么读"离开公开面, 而码表本身是契约的一部分
  *  (发布版已有真实用户)。⇒ 保留 + 显式标注。 */
 export function describeWbReasonPre(code) {
   const k = String(code == null ? '' : code)
-  return WB_REASONS_V1[k] || k || '未知原因'
+  return WB_REASONS_PRE_V1[k] || k || '未知原因'
 }
 
-const isAnchor = (line) => WB_ANCHOR_RE_V1.test(String(line || '').replace(/\r$/, ''))
+const isAnchor = (line) => WB_ANCHOR_RE_PRE_V1.test(String(line || '').replace(/\r$/, ''))
 const anchorIdOf = (line) => {
-  const m = WB_ANCHOR_RE_V1.exec(String(line || '').replace(/\r$/, ''))
+  const m = WB_ANCHOR_RE_PRE_V1.exec(String(line || '').replace(/\r$/, ''))
   return m ? m[1] : ''
 }
 const isCardTitle = (line) => /^#{3,}\s+\S/.test(String(line || '').replace(/\r$/, ''))
@@ -153,7 +153,7 @@ export function parseWhiteboardPre(text, opts = {}) {
     const trimmed = line.replace(/\r$/, '')
 
     // ── 分区标记（先于一切判定：标记行本身既不是标题也不是内容） ──
-    if (trimmed === WB_MARKERS_V1.userOpen) {
+    if (trimmed === WB_MARKERS_PRE_V1.userOpen) {
       if (region === 'user') issues.push({ code: 'user-region-interleaved', detail: '重复的 user 开始标记', line: i + 1 })
       if (region === 'model') closeRegion()
       if (!cur) issues.push({ code: 'user-region-unclosed', detail: 'user 段不在任何卡片内（契约 §5 要求每卡分区）', line: i + 1 })
@@ -162,19 +162,19 @@ export function parseWhiteboardPre(text, opts = {}) {
       regionLines = []
       continue
     }
-    if (trimmed === WB_MARKERS_V1.userClose) {
+    if (trimmed === WB_MARKERS_PRE_V1.userClose) {
       if (region !== 'user') issues.push({ code: 'user-region-unclosed', detail: 'user 结束标记没有对应的开始标记', line: i + 1 })
       else closeRegion()
       continue
     }
-    if (trimmed === WB_MARKERS_V1.modelOpen) {
+    if (trimmed === WB_MARKERS_PRE_V1.modelOpen) {
       if (region === 'user') issues.push({ code: 'user-region-interleaved', detail: 'user 段里又开了 model 段（契约 §5 禁止）', line: i + 1 })
       region = 'model'
       regionStart = i + 1
       regionLines = []
       continue
     }
-    if (trimmed === WB_MARKERS_V1.modelClose) {
+    if (trimmed === WB_MARKERS_PRE_V1.modelClose) {
       if (region !== 'model') issues.push({ code: 'model-region-unclosed', detail: 'model 结束标记没有对应的开始标记', line: i + 1 })
       else closeRegion()
       continue
@@ -281,10 +281,10 @@ function emptyResult(kind, issues) {
 //   ⑤ 矛盾检测 → 需 LLM，**不在本模块**（契约 §6：必须手动触发，不进自动路径）
 // ─────────────────────────────────────────────────────────────────────────────
 
-export const WB_LINT_VERSION = 'wb_lint_v1'
+export const WB_LINT_VERSION = 'wb_lint_pre_v1'
 
 /** lint 问题码（§6 四类；⑤ 矛盾检测需 LLM，不在此列）。 */
-export const WB_LINT_CODES_V1 = Object.freeze({
+export const WB_LINT_CODES_PRE_V1 = Object.freeze({
   ORPHAN: 'orphan',                   // ① 孤立条目
   INACTIVE: 'inactive',               // ② 陈旧（已标 superseded/retracted）
   EXPIRED: 'expired',                 // ② 陈旧（仍标 current 但超阈值）
@@ -293,7 +293,7 @@ export const WB_LINT_CODES_V1 = Object.freeze({
 })
 
 /** 默认口径。 */
-export const WB_LINT_DEFAULTS_V1 = Object.freeze({
+export const WB_LINT_DEFAULTS_PRE_V1 = Object.freeze({
   staleDays: 90,      // ② 仍标 current 但日期早于 now-90d ⇒ 报 expired
   minSharedTags: 2,   // ④ 共享 tag 数 ≥ 2 才算"应互链"
 })
@@ -322,8 +322,8 @@ export function lintWhiteboardPre(entries, opts = {}) {
   const o = opts && typeof opts === 'object' ? opts : {}
   const list = Array.isArray(entries) ? entries
     : (entries && Array.isArray(entries.entries) ? entries.entries : [])
-  const staleDays = Number.isFinite(Number(o.staleDays)) ? Number(o.staleDays) : WB_LINT_DEFAULTS_V1.staleDays
-  const minSharedTags = Number.isFinite(Number(o.minSharedTags)) ? Number(o.minSharedTags) : WB_LINT_DEFAULTS_V1.minSharedTags
+  const staleDays = Number.isFinite(Number(o.staleDays)) ? Number(o.staleDays) : WB_LINT_DEFAULTS_PRE_V1.staleDays
+  const minSharedTags = Number.isFinite(Number(o.minSharedTags)) ? Number(o.minSharedTags) : WB_LINT_DEFAULTS_PRE_V1.minSharedTags
 
   const nowMs0 = o.now instanceof Date ? o.now.getTime()
     : (typeof o.now === 'number' ? o.now : asDateMs(o.now))
@@ -382,19 +382,19 @@ export function lintWhiteboardPre(entries, opts = {}) {
         if (total - selfN > 0) referenced = true
       }
     }
-    if (!referenced) push(WB_LINT_CODES_V1.ORPHAN, c, '无任何其他卡片或语料引用它的 id/标题')
+    if (!referenced) push(WB_LINT_CODES_PRE_V1.ORPHAN, c, '无任何其他卡片或语料引用它的 id/标题')
   }
 
   // ── ② 陈旧 ──
   const cutoff = nowMs - staleDays * 86400000
   for (const c of cards) {
     if (c.status !== 'current') {
-      push(WB_LINT_CODES_V1.INACTIVE, c, 'status=' + c.status + '（已作废，仍在白板内）')
+      push(WB_LINT_CODES_PRE_V1.INACTIVE, c, 'status=' + c.status + '（已作废，仍在白板内）')
       continue
     }
     if (Number.isFinite(c.dateMs) && c.dateMs < cutoff) {
       const ageDays = Math.floor((nowMs - c.dateMs) / 86400000)
-      push(WB_LINT_CODES_V1.EXPIRED, c, '仍标 current 但日期为 ' + c.dateRaw + '（' + ageDays + ' 天前，超阈值 ' + staleDays + ' 天）')
+      push(WB_LINT_CODES_PRE_V1.EXPIRED, c, '仍标 current 但日期为 ' + c.dateRaw + '（' + ageDays + ' 天前，超阈值 ' + staleDays + ' 天）')
     }
   }
 
@@ -406,7 +406,7 @@ export function lintWhiteboardPre(entries, opts = {}) {
   for (const id of allIds) {
     if (!knownIds.has(id)) {
       findings.push({
-        code: WB_LINT_CODES_V1.DANGLING_REF, id, title: '',
+        code: WB_LINT_CODES_PRE_V1.DANGLING_REF, id, title: '',
         detail: '正文引用了 ' + id + '，但白板内没有该 id 的卡片（悬空引用）',
       })
     }
@@ -425,7 +425,7 @@ export function lintWhiteboardPre(entries, opts = {}) {
         (a.title && String((list.find((x) => x && x.id === b.id) || {}).body || '').includes(a.title))
       if (!aRefB && !bRefA) {
         findings.push({
-          code: WB_LINT_CODES_V1.NO_CROSS_REF, id: a.id, title: a.title,
+          code: WB_LINT_CODES_PRE_V1.NO_CROSS_REF, id: a.id, title: a.title,
           detail: '与「' + (b.title || b.id) + '」共享 ' + shared.length + ' 个 tag（' + shared.join(', ') + '）但互不引用',
         })
       }
@@ -503,25 +503,25 @@ export function toMutationProjectionPre(projection) {
 // `memory-mutation.js` 里，无条件生效**，任何开关都绕不过。
 // ═══════════════════════════════════════════════════════════════════════════
 
-export const CRITERIA_GATE_VERSION = 'wb_criteria_v1'
+export const CRITERIA_GATE_VERSION = 'wb_criteria_pre_v1'
 
 /** 账本四段标题（逐字匹配；与 `handoff-anchor.js` 的权重表同源，不另写一份）。 */
-export const HANDOFF_REQUIRED_SECTIONS_V1 = Object.freeze(
-  HANDOFF_LEDGER_SECTION_WEIGHTS_V1.map((x) => x.title),
+export const HANDOFF_REQUIRED_SECTIONS_PRE_V1 = Object.freeze(
+  HANDOFF_LEDGER_SECTION_WEIGHTS_PRE_V1.map((x) => x.title),
 )
 
 /** 占位符黑名单（H3）：段 body 只含这些即视为未填写。 */
-export const CRITERIA_PLACEHOLDERS_V1 = Object.freeze(['(待补充)', '（待补充）', 'todo', '同上', '略', 'n/a', '待补充'])
+export const CRITERIA_PLACEHOLDERS_PRE_V1 = Object.freeze(['(待补充)', '（待补充）', 'todo', '同上', '略', 'n/a', '待补充'])
 
 /** 账本/白板判据的阈值（与 `sanitizeForWrite` 上限同源，先于它执行以免双重截断语义混乱）。 */
-export const CRITERIA_LIMITS_V1 = Object.freeze({
+export const CRITERIA_LIMITS_PRE_V1 = Object.freeze({
   handoffMaxChars: 8000,
   planMaxChars: 200000,
   sectionMinChars: 20,
   sectionMaxLines: 5,
 })
 
-const PLACEHOLDER_SET = new Set(CRITERIA_PLACEHOLDERS_V1.map((x) => x.toLowerCase()))
+const PLACEHOLDER_SET = new Set(CRITERIA_PLACEHOLDERS_PRE_V1.map((x) => x.toLowerCase()))
 
 /** 段 body 的"实质内容"行（去空行、去纯占位行）。 */
 function bodyRealLines(body) {
@@ -545,7 +545,7 @@ export function checkHandoffCriteriaPre(text) {
 
   // H1 四段标题齐全且逐字匹配
   const gotTitles = parsed ? parsed.sections.map((s) => String(s.title).replace(/\r$/, '').replace(/^##\s+/, '').trim()) : []
-  const missing = HANDOFF_REQUIRED_SECTIONS_V1.filter((t) => !gotTitles.includes(t))
+  const missing = HANDOFF_REQUIRED_SECTIONS_PRE_V1.filter((t) => !gotTitles.includes(t))
   hard.push({
     id: 'H1', pass: missing.length === 0, missing: missing.slice(),
     detail: missing.length
@@ -558,10 +558,10 @@ export function checkHandoffCriteriaPre(text) {
   if (parsed) {
     for (const s of parsed.sections) {
       const name = String(s.title).replace(/\r$/, '').replace(/^##\s+/, '').trim()
-      if (!HANDOFF_REQUIRED_SECTIONS_V1.includes(name)) continue
+      if (!HANDOFF_REQUIRED_SECTIONS_PRE_V1.includes(name)) continue
       const real = bodyRealLines(s.body)
       const chars = real.join('').length
-      if (!real.length || chars < CRITERIA_LIMITS_V1.sectionMinChars) thinSections.push(name + '(' + chars + ' 字符)')
+      if (!real.length || chars < CRITERIA_LIMITS_PRE_V1.sectionMinChars) thinSections.push(name + '(' + chars + ' 字符)')
     }
   } else {
     thinSections.push('(无法解析出任何段)')
@@ -569,7 +569,7 @@ export function checkHandoffCriteriaPre(text) {
   hard.push({
     id: 'H2', pass: thinSections.length === 0, missing: thinSections.slice(),
     detail: thinSections.length
-      ? '这些段为空或少于 ' + CRITERIA_LIMITS_V1.sectionMinChars + ' 字符：' + thinSections.join('、')
+      ? '这些段为空或少于 ' + CRITERIA_LIMITS_PRE_V1.sectionMinChars + ' 字符：' + thinSections.join('、')
       : '四段 body 均非空且达到最小长度',
   })
 
@@ -586,14 +586,14 @@ export function checkHandoffCriteriaPre(text) {
   hard.push({
     id: 'H3', pass: placeholderHits.length === 0, missing: placeholderHits.slice(),
     detail: placeholderHits.length
-      ? '这些段的正文只有占位符（' + CRITERIA_PLACEHOLDERS_V1.slice(0, 4).join('/') + ' 等）：' + placeholderHits.join('、')
+      ? '这些段的正文只有占位符（' + CRITERIA_PLACEHOLDERS_PRE_V1.slice(0, 4).join('/') + ' 等）：' + placeholderHits.join('、')
       : '无纯占位符段',
   })
 
   // H4 总长 ≤ 8000
   hard.push({
-    id: 'H4', pass: src.length <= CRITERIA_LIMITS_V1.handoffMaxChars, missing: [],
-    detail: '总长 ' + src.length + ' 字符（上限 ' + CRITERIA_LIMITS_V1.handoffMaxChars + '）',
+    id: 'H4', pass: src.length <= CRITERIA_LIMITS_PRE_V1.handoffMaxChars, missing: [],
+    detail: '总长 ' + src.length + ' 字符（上限 ' + CRITERIA_LIMITS_PRE_V1.handoffMaxChars + '）',
   })
 
   // S1 每段 ≤5 行（软·警告；prompt 纪律既有约定）
@@ -601,9 +601,9 @@ export function checkHandoffCriteriaPre(text) {
   if (parsed) {
     for (const s of parsed.sections) {
       const name = String(s.title).replace(/\r$/, '').replace(/^##\s+/, '').trim()
-      if (!HANDOFF_REQUIRED_SECTIONS_V1.includes(name)) continue
+      if (!HANDOFF_REQUIRED_SECTIONS_PRE_V1.includes(name)) continue
       const n = bodyRealLines(s.body).length
-      if (n > CRITERIA_LIMITS_V1.sectionMaxLines) longSections.push(name + '(' + n + ' 行)')
+      if (n > CRITERIA_LIMITS_PRE_V1.sectionMaxLines) longSections.push(name + '(' + n + ' 行)')
     }
   }
   soft.push({ id: 'S1', pass: longSections.length === 0, detail: longSections.length ? '超过 5 行的段：' + longSections.join('、') : '各段均 ≤5 行' })
@@ -631,7 +631,7 @@ export function checkHandoffCriteriaPre(text) {
   return {
     ok: hard.every((h) => h.pass), version: CRITERIA_GATE_VERSION, target: 'handoff',
     hardPass: hard.every((h) => h.pass), hard, soft,
-    report: { chars: src.length, sections: gotTitles.length, requiredSections: HANDOFF_REQUIRED_SECTIONS_V1.length },
+    report: { chars: src.length, sections: gotTitles.length, requiredSections: HANDOFF_REQUIRED_SECTIONS_PRE_V1.length },
   }
 }
 
@@ -652,17 +652,17 @@ export function checkPlanCriteriaPre(text, projection) {
   const sections = src.split(/(?=^## )/m).filter((s) => /^## /.test(s))
   const nonEmpty = sections.filter((s) => {
     const body = s.split('\n').slice(1).join('\n').trim()
-    return body.length >= CRITERIA_LIMITS_V1.sectionMinChars
+    return body.length >= CRITERIA_LIMITS_PRE_V1.sectionMinChars
   })
   hard.push({
     id: 'P-H1', pass: nonEmpty.length >= 1, missing: nonEmpty.length ? [] : ['(无非空 ## 顶层节)'],
     detail: nonEmpty.length
       ? '有 ' + nonEmpty.length + ' 个非空顶层节（共 ' + sections.length + ' 个）'
-      : '没有任何非空 `## ` 顶层节（' + CRITERIA_LIMITS_V1.sectionMinChars + ' 字符以上）—— 这是"白板被整篇覆盖成骨架/空白板"的形态',
+      : '没有任何非空 `## ` 顶层节（' + CRITERIA_LIMITS_PRE_V1.sectionMinChars + ' 字符以上）—— 这是"白板被整篇覆盖成骨架/空白板"的形态',
   })
   hard.push({
-    id: 'P-H2', pass: src.length <= CRITERIA_LIMITS_V1.planMaxChars, missing: [],
-    detail: '总长 ' + src.length + ' 字符（上限 ' + CRITERIA_LIMITS_V1.planMaxChars + '）',
+    id: 'P-H2', pass: src.length <= CRITERIA_LIMITS_PRE_V1.planMaxChars, missing: [],
+    detail: '总长 ' + src.length + ' 字符（上限 ' + CRITERIA_LIMITS_PRE_V1.planMaxChars + '）',
   })
   const forward = /下一步|待办|计划|todo/i.test(src)
   soft.push({ id: 'P-S1', pass: forward, detail: forward ? '含前瞻内容' : '未见前瞻内容（下一步/待办/计划）—— 软提示，不拦截' })

package/lib/wb-sidecar.js

@@ -1,5 +1,5 @@
 /**
- * wb-sidecar-pre —— WB-GRAPH P2 结构化 sidecar(2026-09-16, wb_sidecar_v1)。
+ * wb-sidecar-pre —— WB-GRAPH P2 结构化 sidecar(2026-09-16, wb_sidecar_pre_v1)。
  *
  * 权威依据: WB-GRAPH-INTEGRATION-PLAN.md §5 P2-1/P2-2 + WB-FORMAT-CONVENTION §3(索引派生)/§4(写入门)
  *   + 拍板 A2: sidecar 放 memoryRoot/<ws>/handoff/ 旁挂。
@@ -18,7 +18,7 @@
 
 import { createHash } from 'node:crypto'
 
-export const WB_SIDECAR_VERSION = 'wb_sidecar_v1'
+export const WB_SIDECAR_VERSION = 'wb_sidecar_pre_v1'
 
 /** 章节标题 → tag(截断 24 字, 去掉 markdown 井号前缀)。 */
 function sectionTagPre(sectionTitle) {
@@ -196,7 +196,7 @@ export function splitSectionsPre(text) {
     // 引言区里的 `# 文档标题` 行不是内容 —— 若不剔除, 它会变成一张只有标题的垃圾卡
     if (cur.preamble && /^#\s+/.test(line)) continue
     // 标题行紧随的锚点行进 anchorId(§2 契约形态)
-    const am = line.trim().match(WB_ANCHOR_LINE_RE_V1)
+    const am = line.trim().match(WB_ANCHOR_LINE_RE_PRE_V1)
     if (am && !cur.bodyLines.some((x) => x.trim())) { cur.anchorId = am[1]; continue }
     cur.bodyLines.push(line)
   }
@@ -514,7 +514,7 @@ export function criteriaWeightPre(criteria) {
 }
 
 /** 锚点行正则(与 L0 抽取的 MEM_ANCHOR_RE 同形)。 */
-export const WB_ANCHOR_LINE_RE_V1 = /^<!--\s*memory:(mem_[0-9a-f]{32})\s*-->$/
+export const WB_ANCHOR_LINE_RE_PRE_V1 = /^<!--\s*memory:(mem_[0-9a-f]{32})\s*-->$/
 
 /**
  * WB-FORMAT-CONVENTION §2 锚点写入(纯函数, 零 IO)。
@@ -552,7 +552,7 @@ export function applyAnchorsPre(workspaceKey, relPath, text) {
     const want = wbEntryIdPre(workspaceKey, rel, cardTitle)
     const anchor = '<!-- memory:' + want + ' -->'
     const next = lines[i + 1] == null ? '' : lines[i + 1]
-    const have = next.trim().match(WB_ANCHOR_LINE_RE_V1)
+    const have = next.trim().match(WB_ANCHOR_LINE_RE_PRE_V1)
     if (have) {
       // 标题未变 ⇒ **原样保留既有锚点行**(不重发、不删除; 否则二次应用会丢失锚点, 破坏幂等)
       if (have[1] === want) { unchanged++; out.push(next) } else { updated++; out.push(anchor) }
@@ -569,7 +569,7 @@ export function applyAnchorsPre(workspaceKey, relPath, text) {
 export function collectAnchorIdsPre(text) {
   const ids = []
   for (const line of String(text || '').split('\n')) {
-    const m = line.trim().match(WB_ANCHOR_LINE_RE_V1)
+    const m = line.trim().match(WB_ANCHOR_LINE_RE_PRE_V1)
     if (m) ids.push(m[1])
   }
   return ids
@@ -590,7 +590,7 @@ export function collectAnchorIdsPre(text) {
 /** 泳道定义(顺序即渲染顺序)。match 按 kind → tag → 小节名 → 小节标题正则, 先命中先归。
  *  v2(2026-09-16): 新增 matchTitle 正则 —— 小节级卡片没有 tag(白板正文里几乎没有语义 tag),
  *  只能靠**小节标题**分列; 实测真实数据的标题形如「任务状态」「已试方案与失败原因」「关键坑(血泪)」。 */
-export const WB_KANBAN_LANES_V1 = [
+export const WB_KANBAN_LANES_PRE_V1 = [
   { key: 'goal', label: '目标', matchTags: ['type:goal'], matchSections: ['目标'], matchTitle: /^(?:总体)?目标|这是什么|定位|背景/ },
   { key: 'state', label: '进行中', matchTags: ['type:state'], matchSections: ['任务状态'], matchTitle: /任务状态|现状|进行中|在做/ },
   { key: 'deadend', label: '失败与弯路', matchTags: ['type:dead-end'], matchSections: ['已试方案与失败原因', '失败'], matchTitle: /失败|弯路|坑|教训|血泪|报错|阻塞/ },
@@ -612,7 +612,7 @@ export function laneOfEntryPre(entry) {
   const tags = Array.isArray(e.tags) ? e.tags : []
   const sec = String(e.section || e.title || '')
   const kind = String(e.kind || '')
-  for (const lane of WB_KANBAN_LANES_V1) {
+  for (const lane of WB_KANBAN_LANES_PRE_V1) {
     if (Array.isArray(lane.matchKinds) && lane.matchKinds.includes(kind)) return lane.key
     if (Array.isArray(lane.matchTags) && lane.matchTags.some((t) => tags.includes(t))) return lane.key
     if (Array.isArray(lane.matchSections) && sec) {
@@ -651,7 +651,7 @@ export function buildKanbanPre(index, opts = {}) {
   const sectionCards = Array.isArray(opts.cards) && opts.cards.length ? opts.cards : null
   const perLaneCap = Number(opts.perLaneCap) > 0 ? Number(opts.perLaneCap) : 0
 
-  const lanes = WB_KANBAN_LANES_V1.map((l) => ({ key: l.key, label: l.label, cards: [] }))
+  const lanes = WB_KANBAN_LANES_PRE_V1.map((l) => ({ key: l.key, label: l.label, cards: [] }))
   const misc = { key: 'misc', label: '其它', cards: [] }
 
   if (sectionCards) {
@@ -809,9 +809,9 @@ export function buildKanbanMatrixPre(cards, opts = {}) {
   const list = Array.isArray(cards) ? cards : []
   const colKeys = Array.isArray(opts.colKeys) && opts.colKeys.length
     ? opts.colKeys
-    : WB_KANBAN_LANES_V1.map((l) => l.key).concat(['misc'])
+    : WB_KANBAN_LANES_PRE_V1.map((l) => l.key).concat(['misc'])
   const columns = colKeys.map((k) => {
-    const lane = WB_KANBAN_LANES_V1.find((l) => l.key === k)
+    const lane = WB_KANBAN_LANES_PRE_V1.find((l) => l.key === k)
     return { key: k, label: lane ? lane.label : (k === 'misc' ? '其它' : k), count: 0 }
   })
   const colOf = {}

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.5",
+  "version": "3.1.7",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -17,9 +17,8 @@
     "!python/bench",
     "!python/__pycache__",
     "!docs/internal",
-    "!docs/**/*.bak",
-    "!docs/**/*.bak-*",
-    "!**/*.mjs.bak-*"
+    "!**/*.bak*",
+    "!lib/*.m8b*bak*"
   ],
   "dsh": {
     "bundle": {