@a9i5k4/dsh-auto-memory 3.1.0 → 3.1.1

package/lib/config-io.js

@@ -27,12 +27,34 @@
  *   - CRLF、无 BOM。
  */
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs'
-import { writeFile } from 'node:fs/promises'
+import { rename, writeFile } from 'node:fs/promises'
+import { setTimeout as sleepDelayPre } from 'node:timers/promises'
 import path from 'node:path'
 
 /** 临时文件后缀。与既有 hub 落盘的 `.tmp` 同族，便于排查时一眼认出。 */
 export const ATOMIC_TMP_SUFFIX_V1 = '.tmp'
 
+/**
+ * ★2026-09-22（并发写修复）：tmp 路径的**唯一段** = pid + 进程内自增序号。
+ *
+ * 病症：tmp 名原先**只由目标路径决定**（`file + '.tmp'`）⇒ 对同一目标并发保存时，
+ * 先完成者把 tmp 改名走，后到者的 rename 找不到源文件而抛 **ENOENT**（非瞬时错误、
+ * 按纪律不得重试）⇒ 后一次保存静默失败（只回 `{ok:false}`，界面看起来"改了没生效"）。
+ * 实测复现：对同一目标并发 5 次 `writeTextAtomicPre`，部分调用返回
+ * `{ok:false, error:'ENOENT … rename … .tmp -> …'}`（见 `tests/smoke/smoke-test-p3-batchb-guards-pre.mjs` P3B-2d）。
+ *
+ * 处方：每次调用生成一个独立的 tmp 名 —— 同进程并发各写各的，跨进程并发靠 pid 区分；
+ * 最后一次 rename 胜出，**原子性不变量不变**（目标任意时刻仍是旧完整版或新完整版）。
+ *
+ * 边界：仍落在**同目录**且保持 `.tmp` 前缀（`rename` 必须同文件系统）；失败路径照旧
+ * `rmSync` 清理。唯一代价是**进程崩溃**时会在目标目录留下一个 `.tmp-<pid>-<n>`
+ * （可识别、可手工清理；不自动扫描删除，避免误删他人正在写的 tmp）。
+ */
+let _tmpSeqPre = 0
+function tmpUniqueSuffixPre() {
+  return '-' + process.pid + '-' + (++_tmpSeqPre)
+}
+
 /** 损坏留存的默认后缀前缀。 */
 export const CORRUPT_QUARANTINE_PREFIX_V1 = '.corrupt-'
 
@@ -70,7 +92,7 @@ export function quarantineFilePreSync(file, opts = {}) {
  * @returns {{ok: boolean, path?: string, error?: string}} 结构化结果（fail-soft，不抛）。
  */
 export function writeTextAtomicPreSync(file, text) {
-  const tmp = file + ATOMIC_TMP_SUFFIX_V1
+  const tmp = file + ATOMIC_TMP_SUFFIX_V1 + tmpUniqueSuffixPre()
   try {
     mkdirSync(path.dirname(file), { recursive: true })
     writeFileSync(tmp, String(text), 'utf8')
@@ -83,18 +105,49 @@ export function writeTextAtomicPreSync(file, text) {
   }
 }
 
+/**
+ * **有界退避 rename**（★P3-12，2026-09-22）。
+ *
+ * 病症：异步原子写原先走裸 `renameSync` —— Windows 上目标文件被别的进程持有句柄时会抛
+ * EPERM/EACCES/EBUSY，于是**整次设置保存失败**（用户侧表现为"改了设置没生效"）。
+ * 处方：仅对这三个**瞬时**错误码退避重试；首项延迟为 0 ⇒ **正常路径零延迟变化**。
+ *
+ * ⚠️ **为什么不 import `fs-retry.js`**：本模块的**零运行时依赖纪律**（见文件头）
+ * 被 `tests/smoke/smoke-test-t8-configio-pre.mjs` 的 T8c-6 钉死 —— 配置 I/O 层不得因为
+ * 任何兄弟模块的加载期故障而失效。故此处**内联**同一套退避刻度（只用 node: 内置），
+ * 语义与 `fs-retry.js` 的 `retryRename` 保持一致。
+ */
+const RENAME_RETRY_DELAYS_V1 = Object.freeze([0, 50, 150, 400, 1000])
+const TRANSIENT_RENAME_CODES_V1 = new Set(['EPERM', 'EACCES', 'EBUSY'])
+async function renameBoundedRetryPre(from, to) {
+  const last = RENAME_RETRY_DELAYS_V1.length - 1
+  for (let attempt = 0; attempt <= last; attempt++) {
+    const wait = RENAME_RETRY_DELAYS_V1[attempt]
+    if (wait) await sleepDelayPre(wait)
+    try {
+      await rename(from, to)
+      return
+    } catch (e) {
+      const transient = TRANSIENT_RENAME_CODES_V1.has(e && e.code)
+      if (!transient || attempt === last) throw e
+    }
+  }
+}
+
 /**
  * **异步原子写**：tmp → rename。语义与同步版一致。
  *
- * 只把**可能较大**的正文写入交给异步 IO；rename 本身极快，保持同步调用。
- * 这样与既有 `persistConfigPre` 的异步口径对齐，不引入额外的 await 链。
+ * 只把**可能较大**的正文写入交给异步 IO。
+ *
+ * ★P3-12（2026-09-22）：rename 走 `renameBoundedRetryPre`（有界退避；首项 0 ⇒ 正常路径零延迟变化）。
+ * 同步版 `writeTextAtomicPreSync` 的契约是同步，保持 `renameSync` 不动。
  */
 export async function writeTextAtomicPre(file, text) {
-  const tmp = file + ATOMIC_TMP_SUFFIX_V1
+  const tmp = file + ATOMIC_TMP_SUFFIX_V1 + tmpUniqueSuffixPre()
   try {
     mkdirSync(path.dirname(file), { recursive: true })
     await writeFile(tmp, String(text), 'utf8')
-    renameSync(tmp, file)
+    await renameBoundedRetryPre(tmp, file)
     return { ok: true, path: file }
   } catch (e) {
     try { rmSync(tmp, { force: true }) } catch (_) {}

package/lib/context-host.js

@@ -164,7 +164,11 @@ export function createContextHost(opts = {}) {
     return bridge
   }
   function storeFor() {
-    if (!store) store = new EvidenceEventStore({ root: path.join(dshHome(), 'memory', 'evidence') })
+    if (!store) store = new EvidenceEventStore({
+      root: path.join(dshHome(), 'memory', 'evidence'),
+      // ★P3-9（组2，2026-09-22）：注入统一节流诊断通道；不注入时 store 内回落 console.error。
+      onDiag: (key, msg) => { try { diagCtx(msg) } catch (_) {} },
+    })
     return store
   }
   function evidenceRootExists() {
@@ -819,6 +823,11 @@ export function createContextHost(opts = {}) {
     const st = states.get(runtime)
     if (st) st.disposed = true
     states.delete(runtime)
+    // ★P3-3(a)（2026-09-22）：pathsByKey 原先是「模块生命周期内永不释放」的集合——
+    // 写入点只有 capturePaths（每会话一条），全文件零 delete/clear；且 disposeAll 走本函数，
+    // 连全量退出路径也清不掉 ⇒ findProvenance 会在已释放的 runtime 上命中陈旧快照。
+    // 键口径与 :316/:482/:683 三处读点一致（String(runtime.key || '')）。
+    pathsByKey.delete(String(runtime.key || ''))
   }
   function disposeAll(reason) {
     for (const pair of collectStates()) disposeRuntime(pair.runtime)

package/lib/evidence-store.js

@@ -95,6 +95,23 @@ export function parseDurableEventLine(line) {
 
 // ========== Store(appen-only JSONL,engine 级串行链) ==========
 
+/**
+ * ★P3-9（组2，2026-09-22）：诊断**节流**表。
+ * 原先 `_writeLine` 每次写失败都直接 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
+}
+
 export class EvidenceEventStore {
   constructor(opts = {}) {
     this.root = opts.root || null
@@ -103,6 +120,15 @@ export class EvidenceEventStore {
     this._appended = new BoundedIdSet(EVIDENCE_STORE_POLICY_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，行为向后兼容）。
+    this._onDiag = typeof opts.onDiag === 'function' ? opts.onDiag : null
+  }
+
+  /** ★P3-9（组2）：节流上报。首条立即透出，窗口内重复压掉。 */
+  reportDiag(key, msg) {
+    if (!shouldReportDiag(key)) return
+    if (this._onDiag) { try { this._onDiag(key, msg); return } catch (_) { /* 回落 */ } }
+    try { console.error(msg) } catch (_) {}
   }
 
   /** §9 幂等:同 evidenceId 进程内只落盘一次(seed replay 与 live 双喂安全网;磁盘侧靠 rebuild 去重兜底)。 */
@@ -140,7 +166,7 @@ export class EvidenceEventStore {
     } catch (e) {
       this.stats.writeFailed++
       this.stats.lastWriteError = String(e && e.message ? e.message : e)
-      try { console.error('[evidence-store] write-failed: ' + this.stats.lastWriteError) } catch (_) {}
+      try { this.reportDiag('evidence:write-failed', '[evidence-store] write-failed: ' + this.stats.lastWriteError) } catch (_) {}
       return false
     }
   }