sage-mem 2.1.9 → 2.1.10

package/README.md

@@ -12,7 +12,7 @@
 
 **Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.**
 
-**Current release: `2.1.9`** — the npm badge above is the dynamic source of truth. **Contract baseline: `1.0.0`** — the first stable release, whose public commitments, the capability boundaries and the list of things it explicitly cannot do are frozen in the
+**Current release: `2.1.10`** — the npm badge above is the dynamic source of truth. **Contract baseline: `1.0.0`** — the first stable release, whose public commitments, the capability boundaries and the list of things it explicitly cannot do are frozen in the
 [frozen contract](https://github.com/gezi-wen/sage-mem/blob/main/docs/1.0.0-contract.md).
 
 If it is useful to you, a Star is the most direct feedback.

package/README.zh.md

@@ -14,7 +14,7 @@
 
 > File-based cross-session memory for DeepSeek Harness — every memory is a plain markdown file you can open, edit and delete. No database, no worker, no port.
 
-**当前发布版本：`2.1.9`** —— 顶部 npm 徽章是动态权威。**契约基线：`1.0.0`** —— 第一个稳定版，公开承诺、能力边界与「明确做不到」的清单冻结在
+**当前发布版本：`2.1.10`** —— 顶部 npm 徽章是动态权威。**契约基线：`1.0.0`** —— 第一个稳定版，公开承诺、能力边界与「明确做不到」的清单冻结在
 [契约冻结](https://github.com/gezi-wen/sage-mem/blob/main/docs/1.0.0-contract.md)。
 
 如果它对你有用，给个 Star 是最直接的反馈。

package/lib/client.js

@@ -6051,23 +6051,22 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			function createIndexSkeleton() {
 				setError(null);
 				setNotice("");
-				if (!remote || typeof remote.readRaw !== "function" || typeof remote.writeRaw !== "function") {
+				if (!remote || typeof remote.writeRaw !== "function") {
 					setError(t("error.noRaw"));
 					return;
 				}
 				setBusy(true);
-				// 先读再写：**已有索引绝不覆盖**。readRaw 对不存在的文件会 reject，正好当探针。
-				remote.readRaw("MEMORY.md").then(function () {
+				// 2.1.10（Q10）：只调**一个意图接口**（writeRaw 的 createIfAbsent）：
+				// 服务端负责「全新安装、memory 目录还不存在」时先建父目录；
+				// 已有索引 → 明确回 already_exists（逐字节不动）。绝不再「先读一次、读失败就当
+				// 可以覆盖」—— 读失败也可能是权限错误，而那正是会顶掉一份真索引的路。
+				remote.writeRaw("MEMORY.md", INDEX_SKELETON, { create: true }).then(function (res) {
+					const out = unwrap(res);
 					setBusy(false);
-					setNotice(t("notice.indexExists"));
-				}, function () {
-					return remote.writeRaw("MEMORY.md", INDEX_SKELETON).then(function (res) {
-						const out = unwrap(res);
-						setBusy(false);
-						if (out && out.ok === false) { setError(out.error || t("error.skeletonFailed")); return; }
-						setNotice(t("notice.indexCreated"));
-						load();
-					});
+					if (out && out.code === "already_exists") { setNotice(t("notice.indexExists")); return; }
+					if (out && out.ok === false) { setError(out.error || t("error.skeletonFailed")); return; }
+					setNotice(t("notice.indexCreated"));
+					load();
 				}).catch(function (e) {
 					setBusy(false);
 					setError(String((e && e.message) || e));

package/lib/memory/write-protocol.js

@@ -22,6 +22,8 @@
  */
 
 import { createHash } from 'node:crypto'
+import { mkdir } from 'node:fs/promises'
+import { dirname } from 'node:path'
 import { readVerified } from './scan.js'
 import { warnLog, writeFileAtomic, writeFileExclusive } from './util.js'
 
@@ -70,6 +72,10 @@ export async function writeSnapshot(target, content, gate, opts, meta) {
   if (o.create === true) {
     if (gate?.ok) return rejected(ERR_ALREADY_EXISTS, `sage-mem: ${name} 已经存在，新建不会覆盖它（要改正文请打开它）`)
     try {
+      // 2.1.10（Q10）：createIfAbsent 也负责「全新安装、父目录还不存在」这一种：
+      // writeFileExclusive 的临时文件落在同一目录，目录不在就会 ENOENT（审查实测）。
+      // 只建父目录、绝不动目标文件 —— 「建立索引骨架」这个意图由调用方一次说清。
+      await mkdir(dirname(target), { recursive: true })
       await writeFileExclusive(target, content)
     } catch (err) {
       if (err?.code === 'EEXIST') return rejected(ERR_ALREADY_EXISTS, `sage-mem: ${name} 刚刚被别的写入建出来了，新建没有覆盖它`)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sage-mem",
   "description": "Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.",
-  "version": "2.1.9",
+  "version": "2.1.10",
   "type": "module",
   "main": "lib/index.js",
   "icon": "./icon.png",