@a9i5k4/dsh-auto-memory 3.1.5 → 3.1.7

package/lib/engine-identity.js

@@ -1,5 +1,5 @@
 /**
- * 引擎身份（engine_identity_v1）—— P2「引擎隔离」的地基（V2-P2 卡 / 评审 §3.5）。
+ * 引擎身份（engine_identity_pre_v1）—— P2「引擎隔离」的地基（V2-P2 卡 / 评审 §3.5）。
  *
  * 为什么需要它（权威依据）：
  *   V2-P2 卡明确指出：单个 `PROVIDER_ID_INT8`（`python-setup.js:55`）**不足以**标识
@@ -9,7 +9,7 @@
  *     模型与权重摘要 · tokenizer 版本 · 精度格式 · 维度 · 池化 · 归一化 · 输入处理版本。
  *
  * 本模块只做三件事（纯函数、零 IO、零依赖，便于宿主与测试共用）：
- *   1) `computeEngineIdentityPre(desc)` —— 宽身份描述 → 稳定身份串 `engid_<32hex>`
+ *   1) `computeEngineIdentityPre(desc)` —— 宽身份描述 → 稳定身份串 `engid_pre_<32hex>`
  *      （canonical 排序 JSON + sha256，同输入逐字节同输出；任一字段变化 → 身份必变）。
  *   2) `aliasKeyPre(engineIdentity, chunkId)` —— 两级引用的**第一级**：
  *      `engineIdentity + chunkId → alias`。记录变化导致未改块重新编号（chunkId 变）时，
@@ -25,14 +25,14 @@
  */
 import { createHash } from 'node:crypto'
 
-export const ENGINE_IDENTITY_VERSION = 'engine_identity_v1'
+export const ENGINE_IDENTITY_VERSION = 'engine_identity_pre_v1'
 
-/** 身份串前缀：有意与 corpus 的 `idx_` / L0 的 `l0idx_` 区分，避免三套版本语义混淆。 */
-export const ENGINE_IDENTITY_PREFIX = 'engid_'
+/** 身份串前缀：有意与 corpus 的 `idx_pre_` / L0 的 `l0idx_pre_` 区分，避免三套版本语义混淆。 */
+export const ENGINE_IDENTITY_PREFIX = 'engid_pre_'
 
 /** 身份必须覆盖的字段（缺一即身份不完整；缺失字段按空串参与哈希，不给"省略=通过"的口子）。 */
 export const ENGINE_IDENTITY_FIELDS = Object.freeze([
-  'provider',        // 通道/提供方标识（如 bge-m3-onnx-int8-v1 / js-e5-small-q8-v1）
+  'provider',        // 通道/提供方标识（如 bge-m3-onnx-int8-pre-v1 / js-e5-small-q8-pre-v1）
   'model',           // 模型名（如 bge-m3 / multilingual-e5-small）
   'weightsDigest',   // 权重摘要（sha256 或廉价指纹；见 weightsDigestOfFilePre 的口径说明）
   'tokenizer',       // tokenizer 版本/来源（如 xenova-bge-m3-fast / e5-small-tokenizer-v1）
@@ -63,7 +63,7 @@ export function canonicalEngineDescPre(desc) {
 }
 
 /**
- * 宽身份计算：canonical 描述 → `engid_<first32hex(sha256)>`。
+ * 宽身份计算：canonical 描述 → `engid_pre_<first32hex(sha256)>`。
  * 任一字段（含维度、精度、tokenizer、输入版本）变化 → 身份必变；同输入确定性。
  */
 export function computeEngineIdentityPre(desc) {
@@ -73,7 +73,7 @@ export function computeEngineIdentityPre(desc) {
 
 /** 身份合法性：必须是本模块产出的前缀形态（防把任意字符串当身份塞进缓存）。 */
 export function isEngineIdentityPre(x) {
-  return typeof x === 'string' && /^engid_[0-9a-f]{32}$/.test(x)
+  return typeof x === 'string' && /^engid_pre_[0-9a-f]{32}$/.test(x)
 }
 
 /** 两个身份是否同一引擎。非法的身份一律视为不匹配（fail closed：宁可重建，不冒串用风险）。 */
@@ -115,10 +115,10 @@ export function weightsDigestOfFilePre(stat, name) {
 }
 
 /** 端侧 JS 引擎（e5-small q8，384 维已归一化）的规范身份描述。 */
-export const JS_E5_IDENTITY_DESC_V1 = Object.freeze({
-  provider: 'js-e5-small-q8-v1',
+export const JS_E5_IDENTITY_DESC_PRE_V1 = Object.freeze({
+  provider: 'js-e5-small-q8-pre-v1',
   model: 'multilingual-e5-small',
-  weightsDigest: 'manifest-e5-small-q8-v1', // 端侧资产清单版本；模型文件摘要由下载清单锁定
+  weightsDigest: 'manifest-e5-small-q8-pre-v1', // 端侧资产清单版本；模型文件摘要由下载清单锁定
   tokenizer: 'e5-small-tokenizer-v1',
   precision: 'q8',
   dim: 384,
@@ -130,7 +130,7 @@ export const JS_E5_IDENTITY_DESC_V1 = Object.freeze({
 /** Python 引擎（bge-m3 onnx int8，1024 维）的身份描述构造器（weightsDigest 由调用方给指纹）。 */
 export function pyBgeM3IdentityDescPre(weightsDigest) {
   return {
-    provider: 'bge-m3-onnx-int8-v1',
+    provider: 'bge-m3-onnx-int8-pre-v1',
     model: 'bge-m3',
     weightsDigest: weightsDigest || '',
     tokenizer: 'xenova-bge-m3-fast',

package/lib/engine-switch.js

@@ -1,5 +1,5 @@
 /**
- * 引擎切换状态机（engine_switch_v1）—— P2 / T2-9 切档隔离与进度条（V2-P2 卡 points 4/5）。
+ * 引擎切换状态机（engine_switch_pre_v1）—— P2 / T2-9 切档隔离与进度条（V2-P2 卡 points 4/5）。
  *
  * 权威依据（评审 §3.5 采纳条目 + V2-P2 卡）：
  *   · **切档 = 强制全量重建 + 进度条**（用户裁定）：每次**实际切换**创建**新 rebuild generation**，
@@ -22,7 +22,7 @@
  * 零第三方依赖；IO 全注入（不传则纯内存）；UTF-8 无 BOM。
  */
 
-export const ENGINE_SWITCH_VERSION = 'engine_switch_v1'
+export const ENGINE_SWITCH_VERSION = 'engine_switch_pre_v1'
 
 /** 终态：到达后不再变化（除 begin 开新代）。 */
 const TERMINAL = new Set(['ready', 'failed', 'cancelled'])
@@ -117,7 +117,7 @@ export function createEngineSwitchPre(opts = {}) {
     const fromIdentity = String(input.fromIdentity || state.toIdentity || '').trim()
     const total = Number(input.total) > 0 ? Math.floor(Number(input.total)) : 0
     if (!switchId) return { ok: false, switchId: '', generation, reason: 'no-switch-id' }
-    if (!/^engid_[0-9a-f]{32}$/.test(toIdentity)) return { ok: false, switchId, generation, reason: 'bad-identity' }
+    if (!/^engid_pre_[0-9a-f]{32}$/.test(toIdentity)) return { ok: false, switchId, generation, reason: 'bad-identity' }
     // 幂等：同 id 已完成 → 不重跑
     if (state.switchId === switchId && state.phase === 'ready' && state.toIdentity === toIdentity) {
       return { ok: true, switchId, generation: state.generation, reason: 'already-ready' }

package/lib/episodic-store.js

@@ -26,21 +26,21 @@ import { createHash } from 'node:crypto'
 
 // ========== 冻结常量 ==========
 
-export const EPISODIC_POLICY_VERSION = 'episodic_store_v1'
-export const EPISODE_ID_PREFIX = 'epi_'
-export const EPISODE_ID_RE = /^epi_[0-9a-f]{32}$/
+export const EPISODIC_POLICY_VERSION = 'episodic_store_pre_v1'
+export const EPISODE_ID_PREFIX = 'epi_pre_'
+export const EPISODE_ID_RE = /^epi_pre_[0-9a-f]{32}$/
 
 /** episode 累积上限(防无限增长;超过后最旧段被丢弃)。 */
-export const EPISODE_SEGMENT_CAP_V1 = 64
+export const EPISODE_SEGMENT_CAP_PRE_V1 = 64
 
 /** 巩固后保留的最多 episode 数(超出按时间淘汰,保留最近)。 */
-export const EPISODE_RETENTION_V1 = 256
+export const EPISODE_RETENTION_PRE_V1 = 256
 
 /** 巩固阈值:至少多少段才算一个可巩固 episode(少于=丢弃,噪声太多)。 */
-export const EPISODE_MIN_SEGMENTS_V1 = 2
+export const EPISODE_MIN_SEGMENTS_PRE_V1 = 2
 
 /** outcome 枚举。 */
-export const EPISODE_OUTCOMES_V1 = Object.freeze(['unknown', 'success', 'failure', 'partial'])
+export const EPISODE_OUTCOMES_PRE_V1 = Object.freeze(['unknown', 'success', 'failure', 'partial'])
 
 /**
  * EpisodeSegment 校验(append 输入)。
@@ -69,7 +69,7 @@ export function validateEpisodePre(ep) {
   if (!Array.isArray(ep.actions)) p.push('actions')
   if (!Array.isArray(ep.entities)) p.push('entities')
   if (!Array.isArray(ep.unresolved)) p.push('unresolved')
-  if (!EPISODE_OUTCOMES_V1.includes(ep.outcome)) p.push('outcome')
+  if (!EPISODE_OUTCOMES_PRE_V1.includes(ep.outcome)) p.push('outcome')
   if (!Array.isArray(ep.provenance)) p.push('provenance')
   if (typeof ep.startedAt !== 'number' || !Number.isFinite(ep.startedAt)) p.push('startedAt')
   if (ep.consolidatedAt !== undefined && (typeof ep.consolidatedAt !== 'number' || !Number.isFinite(ep.consolidatedAt))) p.push('consolidatedAt')
@@ -89,9 +89,9 @@ export function createEpisodicStorePre(opts = {}) {
   const io = opts.io || { save() {}, load() { return null }, clear() {} }
   const nowFn = typeof opts.now === 'function' ? opts.now : () => Date.now()
   const cfg = Object.assign({
-    segmentCap: EPISODE_SEGMENT_CAP_V1,
-    retention: EPISODE_RETENTION_V1,
-    minSegments: EPISODE_MIN_SEGMENTS_V1,
+    segmentCap: EPISODE_SEGMENT_CAP_PRE_V1,
+    retention: EPISODE_RETENTION_PRE_V1,
+    minSegments: EPISODE_MIN_SEGMENTS_PRE_V1,
   }, opts.config || {})
 
   let episodes = []        // 已巩固 episode(含 candidate 状态)
@@ -100,7 +100,7 @@ export function createEpisodicStorePre(opts = {}) {
   const stats = { segmentsAppended: 0, consolidated: 0, droppedTooShort: 0, retained: 0 }
 
   function defaultEpisodeId(sessionRef, startedAt) {
-    const h = createHash('sha256').update(['episode-v1', String(sessionRef), String(startedAt)].join('\u0000')).digest('hex')
+    const h = createHash('sha256').update(['episode-pre-v1', String(sessionRef), String(startedAt)].join('\u0000')).digest('hex')
     return EPISODE_ID_PREFIX + h.slice(0, 32)
   }
 
@@ -335,7 +335,7 @@ export function createEpisodicStorePre(opts = {}) {
   // ---- 持久化 ----
   function snapshot() {
     return {
-      schemaVersion: 1, namespace: 'dsh-auto-memory', policyVersion: EPISODIC_POLICY_VERSION,
+      schemaVersion: 1, namespace: 'dsh-auto-memory-pre', policyVersion: EPISODIC_POLICY_VERSION,
       savedAt: nowFn(),
       // ★ P2-2 修复：快照数组字段同样做副本(调用方改快照不得改脏库内 episode)
       episodes: episodes.map(cloneEpisode),

package/lib/evidence-agg.js

@@ -1,7 +1,7 @@
 /**
  * evidence-agg-pre —— evidence 事件 → 聚合 → importance 输入契约(M8-2b, 2026-09-09)。
  *
- * 管道:evidence/events/*.jsonl(写入侧 context-bridge-pre,只读)→ 有界扫描 →
+ * 管道:evidence-pre/events/*.jsonl(写入侧 context-bridge-pre,只读)→ 有界扫描 →
  * 按 memoryId 聚合六类计数 + distinctSessions → 交给 memory-importance-pre.computeImportancePre
  * → 作为 recall() L0 融合的加权因子之一(P8 融合入口)。
  *
@@ -14,10 +14,10 @@
  *   - fail-soft:行损坏跳过;io 抛错由调用方处理(模块内不吞 IO 异常——io 是注入的,调用方决定降级)。
  */
 
-export const EVIDENCE_AGG_VERSION = 'evidence_agg_v1'
+export const EVIDENCE_AGG_VERSION = 'evidence_agg_pre_v1'
 
 /** 有界读取默认值。 */
-export const EVIDENCE_AGG_DEFAULTS_V1 = Object.freeze({
+export const EVIDENCE_AGG_DEFAULTS_PRE_V1 = Object.freeze({
   maxAgeDays: 7, // 文件名日期距 now 的最大天数
   maxLinesPerFile: 400, // 每文件末 N 行(沿用 index.js 证据读取范式 slice(-400))
 })
@@ -31,7 +31,7 @@ const KINDS = ['seen', 'read', 'cite', 'reuse', 'success', 'correction']
  * @returns {Array<object>} 解析后的事件对象(损坏行跳过;任何字段缺失由聚合层兜底)
  */
 export function scanEvidenceEventsPre(io, opts = {}) {
-  const d = Object.assign({}, EVIDENCE_AGG_DEFAULTS_V1, opts)
+  const d = Object.assign({}, EVIDENCE_AGG_DEFAULTS_PRE_V1, opts)
   const now = d.now || Date.now
   const files = (io.listFiles() || []).slice().sort()
   const cutoff = now() - d.maxAgeDays * 86400000

package/lib/evidence-store.js

@@ -16,9 +16,9 @@ const sha256Str = (s) => createHash('sha256').update(Buffer.from(String(s), 'utf
 const first32 = (h) => h.slice(0, 32)
 
 /** §10 持久化策略(冻结)。 */
-export const EVIDENCE_STORE_POLICY_V1 = Object.freeze({
+export const EVIDENCE_STORE_POLICY_PRE_V1 = Object.freeze({
   schemaVersion: 1,
-  storePolicyVersion: 'evidence_store_v1',
+  storePolicyVersion: 'evidence_store_pre_v1',
   keepDays: 30,
   maxTotalBytes: 32 * 1024 * 1024,
   eventMaxBytes: 16 * 1024,
@@ -32,12 +32,12 @@ export function canonicalWorkspaceKey(key) {
 
 /** §10 隐私投影:sessionId → plugin-local sessionRef(不可逆哈希;跨文件稳定)。 */
 export function sessionRefOf(sessionId) {
-  return 'sesr_' + first32(sha256Str('evidence-sesref-v1\u0000' + String(sessionId || '')))
+  return 'sesr_' + first32(sha256Str('evidence-sesref-pre-v1\u0000' + String(sessionId || '')))
 }
 
 /** §10 隐私投影:workspace 绝对键 → 稳定 workspaceRef(不落盘任何绝对路径)。 */
 export function workspaceRefOf(workspaceKey) {
-  return 'wsr_' + first32(sha256Str('evidence-wsref-v1\u0000' + canonicalWorkspaceKey(workspaceKey)))
+  return 'wsr_' + first32(sha256Str('evidence-wsref-pre-v1\u0000' + canonicalWorkspaceKey(workspaceKey)))
 }
 
 /**
@@ -48,11 +48,11 @@ export function workspaceRefOf(workspaceKey) {
 export function projectEvidenceForDurable(ev, opts = {}) {
   const v = validateAccessEvidencePre(ev)
   if (!v.ok) return { ok: false, reason: 'invalid-evidence:' + v.reason }
-  const maxBytes = Number(opts.eventMaxBytes) || EVIDENCE_STORE_POLICY_V1.eventMaxBytes
+  const maxBytes = Number(opts.eventMaxBytes) || EVIDENCE_STORE_POLICY_PRE_V1.eventMaxBytes
   const projected = {
     schemaVersion: 1,
     namespace: NAMESPACE,
-    storePolicyVersion: EVIDENCE_STORE_POLICY_V1.storePolicyVersion,
+    storePolicyVersion: EVIDENCE_STORE_POLICY_PRE_V1.storePolicyVersion,
     evidenceId: ev.evidenceId,
     kind: ev.kind,
     memoryId: ev.memoryId,
@@ -101,12 +101,12 @@ export function parseDurableEventLine(line) {
  * 表放**模块级**而非实例级：同进程多实例共享 ⇒ 不会各自持一份而双写。
  * 语义同 index.js 的 diagThrottled：首条立即透出，窗口内重复压掉。
  */
-const DIAG_THROTTLE_MS_V1 = 300000
+const DIAG_THROTTLE_MS_PRE_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
+    if (now - (Number(_diagAt.get(key)) || 0) < DIAG_THROTTLE_MS_PRE_V1) return false
     _diagAt.set(key, now)
   } catch (_) { /* 计时失败不阻断上报 */ }
   return true
@@ -117,7 +117,7 @@ export class EvidenceEventStore {
     this.root = opts.root || null
     this.eventsDir = opts.eventsDir || (this.root ? path.join(this.root, 'events') : null)
     this._chain = Promise.resolve()
-    this._appended = new BoundedIdSet(EVIDENCE_STORE_POLICY_V1.appendedIdCache)
+    this._appended = new BoundedIdSet(EVIDENCE_STORE_POLICY_PRE_V1.appendedIdCache)
     this._swept = false
     this.stats = { appended: 0, duplicates: 0, oversize: 0, invalid: 0, writeFailed: 0, sweptFiles: 0, lastWriteError: null }
     // ★P3-9（组2）：可注入诊断通道（宿主不注入时 reportDiag 回落 console.error，行为向后兼容）。
@@ -189,7 +189,7 @@ export class EvidenceEventStore {
       files.sort((a, b) => a.mtimeMs - b.mtimeMs)
       for (const f of files) {
         const ageDays = (now - f.mtimeMs) / 86400000
-        if (ageDays > EVIDENCE_STORE_POLICY_V1.keepDays || total > EVIDENCE_STORE_POLICY_V1.maxTotalBytes) {
+        if (ageDays > EVIDENCE_STORE_POLICY_PRE_V1.keepDays || total > EVIDENCE_STORE_POLICY_PRE_V1.maxTotalBytes) {
           try { rmSync(f.fp, { force: true }); this.stats.sweptFiles++; total -= f.size } catch (_) {}
         } else break
       }
@@ -295,11 +295,11 @@ export function rebuildAggregates(durableEvents, corpusRecords) {
   return { aggregates, byWorkspaceRef, duplicates, sessionScoped }
 }
 
-/** aggregate 快照持久化(evidence/aggregates/index.json;可重建派生物,仅调试/导出用)。 */
+/** aggregate 快照持久化(evidence-pre/aggregates/index.json;可重建派生物,仅调试/导出用)。 */
 export function persistAggregatesSnapshot(root, aggregates) {
   const dir = path.join(root, 'aggregates')
   mkdirSync(dir, { recursive: true })
-  const payload = { schemaVersion: 1, namespace: NAMESPACE, storePolicyVersion: EVIDENCE_STORE_POLICY_V1.storePolicyVersion, rebuiltAt: Date.now(), aggregates }
+  const payload = { schemaVersion: 1, namespace: NAMESPACE, storePolicyVersion: EVIDENCE_STORE_POLICY_PRE_V1.storePolicyVersion, rebuiltAt: Date.now(), aggregates }
   writeFileSync(path.join(dir, 'index.json'), JSON.stringify(payload, null, 2) + '\n', 'utf8')
   return path.join(dir, 'index.json')
 }

package/lib/fact-store.js

@@ -39,38 +39,38 @@ import { createHash } from 'node:crypto'
 // ========== 冻结常量(变更必须升级 FACT_POLICY_VERSION) ==========
 
 /** Fact 策略版本。 */
-export const FACT_POLICY_VERSION = 'fact_store_v1'
+export const FACT_POLICY_VERSION = 'fact_store_pre_v1'
 
 /** factId 前缀(确定性身份)。 */
-export const FACT_ID_PREFIX = 'fact_'
+export const FACT_ID_PREFIX = 'fact_pre_'
 
 /** factId 长度前缀断言(与 memoryId/anchorId 同风格)。 */
-export const FACT_ID_RE = /^fact_[0-9a-f]{32}$/
+export const FACT_ID_RE = /^fact_pre_[0-9a-f]{32}$/
 
 /** scope 枚举: 与 M5/M6 的 scope 对齐(User=跨工作区, Workspace=当前工作区)。 */
-export const FACT_SCOPES_V1 = Object.freeze(['User', 'Workspace'])
+export const FACT_SCOPES_PRE_V1 = Object.freeze(['User', 'Workspace'])
 
 /** M8-1 认识论状态枚举: fact=证据/不可推导, observation=推断/可重算, directive=行为指令。 */
-export const FACT_EPISTEMIC_STATUSES_V1 = Object.freeze(['fact', 'observation', 'directive'])
+export const FACT_EPISTEMIC_STATUSES_PRE_V1 = Object.freeze(['fact', 'observation', 'directive'])
 
 /** M8-1 趋势枚举: 相对上次确认的生命周期走向。 */
-export const FACT_TRENDS_V1 = Object.freeze(['new', 'strengthening', 'stable', 'weakening', 'stale'])
+export const FACT_TRENDS_PRE_V1 = Object.freeze(['new', 'strengthening', 'stable', 'weakening', 'stale'])
 
 /** sourceClass 枚举: 与 m4-corpus-pre 的 sourceClass 对齐。 */
-export const FACT_SOURCE_CLASSES_V1 = Object.freeze([
+export const FACT_SOURCE_CLASSES_PRE_V1 = Object.freeze([
   'user-memory', 'workspace-notes', 'workspace-log', 'semantic-candidate', 'profile-candidate',
 ])
 
 /** 来源类型: 用户明确声明(硬规则) vs 模型推断(candidate)。 */
-export const FACT_SOURCE_KINDS_V1 = Object.freeze(['explicit', 'inference'])
+export const FACT_SOURCE_KINDS_PRE_V1 = Object.freeze(['explicit', 'inference'])
 
 /** 冲突处理结果枚举。 */
-export const UPSERT_OUTCOMES_V1 = Object.freeze([
+export const UPSERT_OUTCOMES_PRE_V1 = Object.freeze([
   'created', 'merged', 'superseded', 'conflict-added', 'inference-blocked', 'expired-ignored',
 ])
 
 /** TTL 语义: 过期事实视为不存在(读取时过滤),但保留记录供审计。 */
-export const FACT_TTL_DEFAULT_V1 = 0 // 0 = 永不过期
+export const FACT_TTL_DEFAULT_PRE_V1 = 0 // 0 = 永不过期
 
 /**
  * FactCandidate 校验(fail closed)。
@@ -79,12 +79,12 @@ export const FACT_TTL_DEFAULT_V1 = 0 // 0 = 永不过期
 export function validateFactCandidatePre(cand) {
   const p = []
   if (!cand || typeof cand !== 'object' || Array.isArray(cand)) return { ok: false, reason: 'not-object' }
-  if (!FACT_SCOPES_V1.includes(cand.scope)) p.push('scope')
+  if (!FACT_SCOPES_PRE_V1.includes(cand.scope)) p.push('scope')
   if (typeof cand.subject !== 'string' || !cand.subject.trim()) p.push('subject')
   if (typeof cand.predicate !== 'string' || !cand.predicate.trim()) p.push('predicate')
   if (cand.object !== undefined && cand.object !== null && typeof cand.object !== 'string') p.push('object')
-  if (!FACT_SOURCE_KINDS_V1.includes(cand.sourceKind)) p.push('sourceKind')
-  if (cand.sourceClass !== undefined && !FACT_SOURCE_CLASSES_V1.includes(cand.sourceClass)) p.push('sourceClass')
+  if (!FACT_SOURCE_KINDS_PRE_V1.includes(cand.sourceKind)) p.push('sourceKind')
+  if (cand.sourceClass !== undefined && !FACT_SOURCE_CLASSES_PRE_V1.includes(cand.sourceClass)) p.push('sourceClass')
   if (cand.provenance !== undefined && (!Array.isArray(cand.provenance) || cand.provenance.some((s) => typeof s !== 'string'))) p.push('provenance')
   if (cand.confidence !== undefined && (typeof cand.confidence !== 'number' || !Number.isFinite(cand.confidence) || cand.confidence < 0 || cand.confidence > 1)) p.push('confidence')
   if (cand.ttl !== undefined && (typeof cand.ttl !== 'number' || !Number.isFinite(cand.ttl) || cand.ttl < 0)) p.push('ttl')
@@ -92,8 +92,8 @@ export function validateFactCandidatePre(cand) {
   for (const k of ['occurredAt', 'mentionedAt', 'ingestedAt']) {
     if (cand[k] !== undefined && (typeof cand[k] !== 'number' || !Number.isFinite(cand[k]) || cand[k] < 0)) p.push(k)
   }
-  if (cand.epistemicStatus !== undefined && !FACT_EPISTEMIC_STATUSES_V1.includes(cand.epistemicStatus)) p.push('epistemicStatus')
-  if (cand.trend !== undefined && !FACT_TRENDS_V1.includes(cand.trend)) p.push('trend')
+  if (cand.epistemicStatus !== undefined && !FACT_EPISTEMIC_STATUSES_PRE_V1.includes(cand.epistemicStatus)) p.push('epistemicStatus')
+  if (cand.trend !== undefined && !FACT_TRENDS_PRE_V1.includes(cand.trend)) p.push('trend')
   if (p.length) return { ok: false, reason: 'invalid:' + p.join(',') }
   return { ok: true, candidate: cand }
 }
@@ -106,7 +106,7 @@ export function validateFactPre(fact) {
   const p = []
   if (!fact || typeof fact !== 'object' || Array.isArray(fact)) return { ok: false, reason: 'not-object' }
   if (typeof fact.factId !== 'string' || !FACT_ID_RE.test(fact.factId)) p.push('factId')
-  if (!FACT_SCOPES_V1.includes(fact.scope)) p.push('scope')
+  if (!FACT_SCOPES_PRE_V1.includes(fact.scope)) p.push('scope')
   if (typeof fact.subject !== 'string' || !fact.subject.trim()) p.push('subject')
   if (typeof fact.predicate !== 'string' || !fact.predicate.trim()) p.push('predicate')
   if (fact.object !== undefined && fact.object !== null && typeof fact.object !== 'string') p.push('object')
@@ -118,8 +118,8 @@ export function validateFactPre(fact) {
   for (const k of ['occurredAt', 'mentionedAt', 'ingestedAt']) {
     if (fact[k] !== undefined && (typeof fact[k] !== 'number' || !Number.isFinite(fact[k]))) p.push(k)
   }
-  if (fact.epistemicStatus !== undefined && !FACT_EPISTEMIC_STATUSES_V1.includes(fact.epistemicStatus)) p.push('epistemicStatus')
-  if (fact.trend !== undefined && !FACT_TRENDS_V1.includes(fact.trend)) p.push('trend')
+  if (fact.epistemicStatus !== undefined && !FACT_EPISTEMIC_STATUSES_PRE_V1.includes(fact.epistemicStatus)) p.push('epistemicStatus')
+  if (fact.trend !== undefined && !FACT_TRENDS_PRE_V1.includes(fact.trend)) p.push('trend')
   if (p.length) return { ok: false, reason: 'invalid:' + p.join(',') }
   return { ok: true, fact }
 }
@@ -139,15 +139,15 @@ export function isFactConflict(a, b) {
 // ========== B-3 事实性入口判据(保守版:只拒「明显不是事实陈述」的形态) ==========
 
 /** 陈述文本最小长度(去空白后);低于此值且呈散文形态才判为碎片。 */
-export const FACT_MIN_STATEMENT_CHARS_V1 = 6
+export const FACT_MIN_STATEMENT_CHARS_PRE_V1 = 6
 
 /** 判据子类码(冻结;前端/工具按它给中文说明,不要按 code 反推语义)。 */
-export const FACTNESS_CODES_V1 = Object.freeze([
+export const FACTNESS_CODES_PRE_V1 = Object.freeze([
   'factness-empty', 'factness-symbol-only', 'factness-question', 'factness-imperative', 'factness-too-short',
 ])
 
 /** 子类码 → 中文人话说明:既让模型知道「怎么改写成合法陈述」,也让人不看代码就看得懂。 */
-export const FACTNESS_MESSAGES_V1 = Object.freeze({
+export const FACTNESS_MESSAGES_PRE_V1 = Object.freeze({
   'factness-empty': '内容为空白(没有任何字符),不是一条事实陈述。请写成「主体 + 谓词 (+ 宾语)」再入库,例如 主体=「项目」、谓词=「构建工具」、宾语=「esbuild」。',
   'factness-symbol-only': '内容只有标点、符号或表情,没有可读的文字或数字,不是一条事实陈述。请补上文字描述再入库,例如 主体=「项目」、谓词=「状态」、宾语=「进行中」。',
   'factness-question': '内容是一个疑问句(以「?」或「？」结尾,且整句没有陈述成分),不是一条事实陈述。请先把答案写成陈述句再入库,例如写「端口 默认值 3080」,而不是「端口是多少？」。',
@@ -156,7 +156,7 @@ export const FACTNESS_MESSAGES_V1 = Object.freeze({
 })
 
 /** 判据子类码 → stats 计数键(诊断面可分别读数)。 */
-const FACTNESS_STAT_KEYS_V1 = Object.freeze({
+const FACTNESS_STAT_KEYS_PRE_V1 = Object.freeze({
   'factness-empty': 'factnessEmpty',
   'factness-symbol-only': 'factnessSymbolOnly',
   'factness-question': 'factnessQuestion',
@@ -165,35 +165,35 @@ const FACTNESS_STAT_KEYS_V1 = Object.freeze({
 })
 
 /** 认识论状态强弱序:推断(observation) < 明确陈述(fact/directive)。 */
-const FACT_EPISTEMIC_RANK_V1 = Object.freeze({ observation: 1, fact: 2, directive: 2 })
+const FACT_EPISTEMIC_RANK_PRE_V1 = Object.freeze({ observation: 1, fact: 2, directive: 2 })
 
 /** 有词形字符(拉丁/数字/CJK/假名/谚文/西里尔/希腊/全角字母数字)才算「有内容」。 */
-const FACT_WORD_CHAR_RE_V1 = /[0-9A-Za-z\u00C0-\u024F\u0370-\u03FF\u0400-\u04FF\u3040-\u30FF\u3400-\u4DBF\u4E00-\u9FFF\uAC00-\uD7AF\uF900-\uFAFF\uFF10-\uFF19\uFF21-\uFF3A\uFF41-\uFF5A]/
+const FACT_WORD_CHAR_RE_PRE_V1 = /[0-9A-Za-z\u00C0-\u024F\u0370-\u03FF\u0400-\u04FF\u3040-\u30FF\u3400-\u4DBF\u4E00-\u9FFF\uAC00-\uD7AF\uF900-\uFAFF\uFF10-\uFF19\uFF21-\uFF3A\uFF41-\uFF5A]/
 
 /** 句读/符号:字段里出现即视为「散文残片」,而不是结构化词条(空白 + ASCII 标点 + 中西标点/表情区)。 */
-const FACT_PROSE_PUNCT_RE_V1 = /[\s!"#$%&'()*+,\-.\/:;<=>?@\[\\\]^_`{|}~\u2000-\u206F\u2190-\u2BFF\u3000-\u303F\uD800-\uDFFF\uFE10-\uFE1F\uFE30-\uFE6F\uFF01-\uFF0F\uFF1A-\uFF20\uFF3B-\uFF40\uFF5B-\uFF65]/
+const FACT_PROSE_PUNCT_RE_PRE_V1 = /[\s!"#$%&'()*+,\-.\/:;<=>?@\[\\\]^_`{|}~\u2000-\u206F\u2190-\u2BFF\u3000-\u303F\uD800-\uDFFF\uFE10-\uFE1F\uFE30-\uFE6F\uFF01-\uFF0F\uFF1A-\uFF20\uFF3B-\uFF40\uFF5B-\uFF65]/
 
 /** 只含中日韩文字(用于「英文祈使开头只在纯英文文本上生效」这条护栏)。 */
-const FACT_CJK_CHAR_RE_V1 = /[\u3040-\u30FF\u3400-\u4DBF\u4E00-\u9FFF\uAC00-\uD7AF\uF900-\uFAFF\u3000-\u303F\uFF00-\uFFEF]/
+const FACT_CJK_CHAR_RE_PRE_V1 = /[\u3040-\u30FF\u3400-\u4DBF\u4E00-\u9FFF\uAC00-\uD7AF\uF900-\uFAFF\u3000-\u303F\uFF00-\uFFEF]/
 
 /** 疑问尾:「?」或「？」结尾(且整句无陈述成分时判为疑问)。 */
-const FACT_QUESTION_TAIL_RE_V1 = /[?？]\s*$/
+const FACT_QUESTION_TAIL_RE_PRE_V1 = /[?？]\s*$/
 
 /** 陈述成分标记:出现任一即认为「有主谓/已成立」⇒ 一律放行(宁可放过不可误杀)。 */
-const FACT_CLAUSE_MARKER_RE_V1 = /(是|为|在|有|了|被|过|会|能|需|由|得|着|将|已|后|前|时|与|和|及|即|属|含|指|表示|代表|完成|支持|启用|关闭|默认|等于|位于|\b(is|are|was|were|be|been|has|have|had|will|would|can|could|must|should|equals?|means|contains|supports|defaults?|uses?)\b)/i
+const FACT_CLAUSE_MARKER_RE_PRE_V1 = /(是|为|在|有|了|被|过|会|能|需|由|得|着|将|已|后|前|时|与|和|及|即|属|含|指|表示|代表|完成|支持|启用|关闭|默认|等于|位于|\b(is|are|was|were|be|been|has|have|had|will|would|can|could|must|should|equals?|means|contains|supports|defaults?|uses?)\b)/i
 
 /** 疑问/系词复合:先摘掉,免得「为什么」里的「为」被误当成陈述标记。 */
-const FACT_CLAUSE_STRIP_RE_V1 = /(为什么|为何|什么样|什么时候|因为|认为|以为|视为|作为|属于|分为)/g
+const FACT_CLAUSE_STRIP_RE_PRE_V1 = /(为什么|为何|什么样|什么时候|因为|认为|以为|视为|作为|属于|分为)/g
 
 /** 祈使开头:这些形态**且整句无陈述成分**时才判为指令(请求式英文词始终生效)。 */
-const FACT_IMPERATIVE_OPENERS_V1 = Object.freeze([
+const FACT_IMPERATIVE_OPENERS_PRE_V1 = Object.freeze([
   /^(帮我|帮忙|帮个忙|麻烦|拜托|烦请|给我|替我|请帮|请把|请将|请给|请写|请记|请查|请修|请改|请加|请添|请看|请做)/,
   /^把[^，,。.；;？?！!]{0,12}(改成|改为|换成|换为|调成|调为|设置为|设为|调整|删除|删掉|去掉|加上|添加|补上|写上|写成)/,
   /^(please|pls|plz|help me|can you|could you|would you|i need you to|i want you to|go ahead and|make sure|remember to|do not|don't)\b/i,
 ])
 
 /** 裸动词祈使开头:**仅纯英文文本**才生效(中式事实句「Run 命令：…」不得被误杀)。 */
-const FACT_IMP_VERB_OPENERS_EN_V1 = /^(add|change|update|fix|remove|delete|rename|move|run|write|create|implement|refactor|ensure|revert|bump|install)\b/i
+const FACT_IMP_VERB_OPENERS_EN_PRE_V1 = /^(add|change|update|fix|remove|delete|rename|move|run|write|create|implement|refactor|ensure|revert|bump|install)\b/i
 
 /** 去掉全部空白(长度与词形判定用)。 */
 function factFlatPre(text) {
@@ -202,14 +202,14 @@ function factFlatPre(text) {
 
 /** 整句是否带陈述成分(带 ⇒ 放行信号)。 */
 function factHasClausePre(text) {
-  const s = String(text == null ? '' : text).replace(FACT_CLAUSE_STRIP_RE_V1, ' ')
-  return FACT_CLAUSE_MARKER_RE_V1.test(s)
+  const s = String(text == null ? '' : text).replace(FACT_CLAUSE_STRIP_RE_PRE_V1, ' ')
+  return FACT_CLAUSE_MARKER_RE_PRE_V1.test(s)
 }
 
 /** 整句是否「只有疑问」:以 ?/？ 结尾且没有陈述成分。 */
 function factQuestionOnlyPre(text) {
   const s = String(text == null ? '' : text).trim()
-  if (!FACT_QUESTION_TAIL_RE_V1.test(s)) return false
+  if (!FACT_QUESTION_TAIL_RE_PRE_V1.test(s)) return false
   return !factHasClausePre(s)
 }
 
@@ -217,8 +217,8 @@ function factQuestionOnlyPre(text) {
 function factImperativeOnlyPre(text) {
   const s = String(text == null ? '' : text).trim()
   if (!s) return false
-  if (FACT_IMPERATIVE_OPENERS_V1.some((re) => re.test(s))) return !factHasClausePre(s)
-  if (!FACT_CJK_CHAR_RE_V1.test(s) && FACT_IMP_VERB_OPENERS_EN_V1.test(s)) return !factHasClausePre(s)
+  if (FACT_IMPERATIVE_OPENERS_PRE_V1.some((re) => re.test(s))) return !factHasClausePre(s)
+  if (!FACT_CJK_CHAR_RE_PRE_V1.test(s) && FACT_IMP_VERB_OPENERS_EN_PRE_V1.test(s)) return !factHasClausePre(s)
   return false
 }
 
@@ -227,7 +227,7 @@ function factTermLikeFieldPre(v) {
   if (typeof v !== 'string') return true
   const s = v.trim()
   if (!s) return true
-  return !FACT_PROSE_PUNCT_RE_V1.test(s)
+  return !FACT_PROSE_PUNCT_RE_PRE_V1.test(s)
 }
 
 /** 三元组是否「结构化短词条」(每个字段都是词条形态)。 */
@@ -238,7 +238,7 @@ function factStructuredTuplePre(cand) {
 
 /** 组装一个拒绝判定(code + 中文人话 message)。 */
 function factnessVerdictPre(code) {
-  return { ok: false, code, message: FACTNESS_MESSAGES_V1[code] || code }
+  return { ok: false, code, message: FACTNESS_MESSAGES_PRE_V1[code] || code }
 }
 
 /**
@@ -252,10 +252,10 @@ export function looksFactStatementPre(text) {
   const raw = String(text == null ? '' : text).trim()
   const flat = raw.replace(/\s+/g, '')
   if (!flat) return factnessVerdictPre('factness-empty')
-  if (!FACT_WORD_CHAR_RE_V1.test(flat)) return factnessVerdictPre('factness-symbol-only')
+  if (!FACT_WORD_CHAR_RE_PRE_V1.test(flat)) return factnessVerdictPre('factness-symbol-only')
   if (factQuestionOnlyPre(raw)) return factnessVerdictPre('factness-question')
   if (factImperativeOnlyPre(raw)) return factnessVerdictPre('factness-imperative')
-  if (flat.length < FACT_MIN_STATEMENT_CHARS_V1) return factnessVerdictPre('factness-too-short')
+  if (flat.length < FACT_MIN_STATEMENT_CHARS_PRE_V1) return factnessVerdictPre('factness-too-short')
   return { ok: true }
 }
 
@@ -302,7 +302,7 @@ export function looksFactCandidatePre(cand) {
  *   调用方显式给了合法值就尊重(本函数只在缺省时用);
  *   来源 = 用户明确陈述(sourceKind='explicit' / sourceClass='user-memory' / origin='user')→ 'fact'(明说);
  *   其余(模型推断、自动沉淀、judgement 候选)→ 'observation'(推断)。
- *   ⚠️ 取值必须落在冻结枚举 FACT_EPISTEMIC_STATUSES_V1 内 —— 写 'inference'/'explicit'
+ *   ⚠️ 取值必须落在冻结枚举 FACT_EPISTEMIC_STATUSES_PRE_V1 内 —— 写 'inference'/'explicit'
  *   这类枚举外的字面量会被 validateFactPre 判非法并**整条拒收**,不能用。
  */
 export function defaultEpistemicStatusPre(cand) {
@@ -341,7 +341,7 @@ export function createFactStorePre(opts = {}) {
   // ---- 确定性 factId(与 memoryId/anchorId 同风格) ----
   function defaultFactId(subject, predicate, object, scope) {
     const h = createHash('sha256').update(
-      ['fact-v1', String(scope), String(subject), String(predicate), String(object == null ? '' : object)].join('\u0000')
+      ['fact-pre-v1', String(scope), String(subject), String(predicate), String(object == null ? '' : object)].join('\u0000')
     ).digest('hex')
     return FACT_ID_PREFIX + h.slice(0, 32)
   }
@@ -406,8 +406,8 @@ export function createFactStorePre(opts = {}) {
     if (c.epistemicStatus !== undefined) {
       // ★ B-4(2026-09-22)：认识论状态跟随候选(入口 :~250 已补默认值),但**降级**要挡住 ——
       //   用户明确陈述(fact/directive)不得被后续模型推断(observation)覆盖(与上面 sourceKind 的提升同向)。
-      const prevRank = FACT_EPISTEMIC_RANK_V1[prev.epistemicStatus] || 0
-      const candRank = FACT_EPISTEMIC_RANK_V1[c.epistemicStatus] || 0
+      const prevRank = FACT_EPISTEMIC_RANK_PRE_V1[prev.epistemicStatus] || 0
+      const candRank = FACT_EPISTEMIC_RANK_PRE_V1[c.epistemicStatus] || 0
       if (prev.epistemicStatus === undefined || c.sourceKind === 'explicit' || candRank > prevRank) {
         prev.epistemicStatus = c.epistemicStatus
       }
@@ -442,7 +442,7 @@ export function createFactStorePre(opts = {}) {
     const factness = looksFactCandidatePre(c)
     if (!factness.ok) {
       stats.factnessRejected++
-      const statKey = FACTNESS_STAT_KEYS_V1[factness.code]
+      const statKey = FACTNESS_STAT_KEYS_PRE_V1[factness.code]
       if (statKey) stats[statKey]++
       lastFactnessReject = { code: factness.code, message: factness.message, text: factStatementTextPre(c), at: now }
       return {
@@ -510,7 +510,7 @@ export function createFactStorePre(opts = {}) {
         sourceClass: c.sourceClass || (c.sourceKind === 'explicit' ? 'user-memory' : 'semantic-candidate'),
         provenance: c.provenance || [],
         confidence: c.confidence !== undefined ? c.confidence : null,
-        confirmedAt: now, ttl: c.ttl !== undefined ? c.ttl : FACT_TTL_DEFAULT_V1,
+        confirmedAt: now, ttl: c.ttl !== undefined ? c.ttl : FACT_TTL_DEFAULT_PRE_V1,
         revoked: false,
         // M8-1 时间三价:入库时间必填(=本次确认);发生/陈述时间候选提供则透传,缺省 undefined(落盘时省略)
         ingestedAt: now,
@@ -737,7 +737,7 @@ export function createFactStorePre(opts = {}) {
   function snapshot(opts = {}) {
     const now = nowFn()
     return {
-      schemaVersion: 1, namespace: 'dsh-auto-memory', policyVersion: FACT_POLICY_VERSION,
+      schemaVersion: 1, namespace: 'dsh-auto-memory-pre', policyVersion: FACT_POLICY_VERSION,
       savedAt: now,
       // ★ P2-2 修复：快照同样不得与库内对象共享 provenance 数组引用
       //   (宿主读快照后 push 会改脏已入账记录)。

package/lib/handoff-anchor.js

@@ -1,5 +1,5 @@
 /**
- * P6(2026-09-09) 账本权重化截断纯核心(handoff_ledger_weight_v1)。
+ * P6(2026-09-09) 账本权重化截断纯核心(handoff_ledger_weight_pre_v1)。
  *
  * 背景:buildContinueCarry 的 `ledger.slice(0, 8000)` 是位置截断,而账本段内异质——
  * 位置截可能把高价值段整体截掉(M-CM7 §C/§G4)。本模块按账本自身四段标题赋权:
@@ -12,17 +12,17 @@
  *   - 只影响注入,不动文件原文。
  */
 
-export const HANDOFF_LEDGER_WEIGHT_VERSION = 'handoff_ledger_weight_v1'
+export const HANDOFF_LEDGER_WEIGHT_VERSION = 'handoff_ledger_weight_pre_v1'
 
 /** 四段标题 → 权重(降序)。标题为账本中的原样标题行(半角 '## '+单空格,不含行尾 \r)。 */
-export const HANDOFF_LEDGER_SECTION_WEIGHTS_V1 = Object.freeze([
+export const HANDOFF_LEDGER_SECTION_WEIGHTS_PRE_V1 = Object.freeze([
   Object.freeze({ title: '已试方案与失败原因', weight: 0.35 }),
   Object.freeze({ title: '进度与下一步', weight: 0.30 }),
   Object.freeze({ title: '目标', weight: 0.20 }),
   Object.freeze({ title: '任务状态', weight: 0.15 }),
 ])
 
-const TITLE_WEIGHT = new Map(HANDOFF_LEDGER_SECTION_WEIGHTS_V1.map((x) => [x.title, x.weight]))
+const TITLE_WEIGHT = new Map(HANDOFF_LEDGER_SECTION_WEIGHTS_PRE_V1.map((x) => [x.title, x.weight]))
 /** 未知 '## ' 段:权重最低(最先被截),但仍保留标题与内容直到轮到它。 */
 const UNKNOWN_WEIGHT = 0.05
 const TRIM_MARK = '…(已按预算截断,全文见 handoff/ 最新账本)'