memory-eternal 0.10.31 → 0.10.32

package/lib/resident-state.js

@@ -0,0 +1,61 @@
+// 「常驻实例不可替换」这个**长期状态**的记忆（issue #30 第五轮复测：A: 盘那台的稳态）。
+//
+// 现场（报告者实测 5 天 44 次）：
+//   升级 → 端口上那个常驻实例仍是上一代 → 宿主探测到"漂移" → 拉起 --replace 助手
+//   → 助手前置探到 lock.writable = false → **正确地拒绝**（宁可拒绝也不留孤儿）
+//   → 旧实例继续存活 → 下次开机再报一次…… 于是「每一步都按设计工作，合起来永远换不掉」。
+//
+// 所以：**环境限制要当成状态记下来**，而不是每次都当"漂移"重试一遍。记下之后：
+//   · 面板 / align / version-check 能显示「常驻实例不可替换（环境限制）」并给出路；
+//   · 宿主不再每次开机都重试注定失败的替换（首次 warn，之后降级为 boot 级别的一条已知状态）。
+import fs from 'node:fs'
+import path from 'node:path'
+import { watchdogLockPath } from './watchdog.js'
+
+/** 状态文件与看门狗锁同目录（同一个 DSH_HOME）。 */
+export function residentStatePath(env = process.env) {
+  return path.join(path.dirname(watchdogLockPath(env)), 'memory-eternal-state.json')
+}
+
+/** 读状态：不存在/损坏都返回 {}（绝不影响主流程）。 */
+export function readResidentState(env = process.env) {
+  try {
+    const data = JSON.parse(fs.readFileSync(residentStatePath(env), 'utf8'))
+    return data && typeof data === 'object' ? data : {}
+  } catch { return {} }
+}
+
+function writeResidentState(env, data) {
+  const file = residentStatePath(env)
+  const tmp = file + '.tmp'
+  fs.mkdirSync(path.dirname(file), { recursive: true })
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf8')
+  fs.renameSync(tmp, file)
+}
+
+/**
+ * 记下「常驻实例不可替换（环境限制）」。
+ * @returns {{ok:boolean, recordedAt:number, firstTime:boolean}}
+ */
+export function recordReplaceBlocked(env = process.env, { error = '', lockPath = '', port = 0, version = '', served = '' } = {}) {
+  const prev = readResidentState(env).replaceBlocked
+  const firstTime = !prev
+  const at = Date.now()
+  const data = { ...readResidentState(env), replaceBlocked: { at, error: String(error || '').slice(0, 300), lockPath: String(lockPath || ''), port: Number(port) || 0, version: String(version || ''), served: String(served || ''), count: (prev && Number(prev.count) || 0) + 1 } }
+  try { writeResidentState(env, data); return { ok: true, recordedAt: at, firstTime } } catch { return { ok: false, recordedAt: at, firstTime } }
+}
+
+/** 环境修好（锁可写了）→ 清掉这条状态。 */
+export function clearReplaceBlocked(env = process.env) {
+  const cur = readResidentState(env)
+  if (!cur.replaceBlocked) return false
+  delete cur.replaceBlocked
+  try { writeResidentState(env, cur); return true } catch { return false }
+}
+
+/** 供界面/报告用：这条状态是否仍然成立（默认 7 天内算"当前有效"）。 */
+export function replaceBlockedInfo(env = process.env, { freshMs = 7 * 24 * 3600 * 1000 } = {}) {
+  const b = readResidentState(env).replaceBlocked
+  if (!b) return null
+  return { ...b, fresh: Date.now() - Number(b.at || 0) < freshMs }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.10.31",
+  "version": "0.10.32",
   "description": "记忆核心（Memory Eternal）：自研的 DeepSeek Harness 记忆插件，不移植任何既有记忆框架——对话结束后自动沉淀知识卡到本地 Markdown Vault（自研去重、自研 CJK 检索、可 git 管理），设置页提供图形化知识库（统计 / 搜索 / 知识图谱 + 侧边栏一键弹窗），Agent 通过 memory_recall 工具按需召回历史上下文。零人工干预。",
   "license": "MIT",
   "repository": {
@@ -64,7 +64,7 @@
     "prepublishOnly": "node build.mjs",
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
-    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/ssr.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs"
+    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/ssr.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs && node tests/resident-state.test.mjs"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"