sage-mem 1.0.2 → 1.1.0

package/README.md

@@ -151,7 +151,7 @@ Every image below is **rendered from the UI code in this repository** (the same
 
 ![File list: one Markdown file per memory, greyed rows are archived](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/files-list.png)
 
-*File list — the header always shows 「体检 N 个问题」(audit: N issues) and 「待重启生效」(restart to apply), so you know whether you should deal with it without opening anything; greyed rows are archived and can be restored at any time.*
+*File list — the header always shows 「体检 N 个问题」(audit: N issues) and 「待重启生效」(restart to apply), so you know whether you should deal with it without opening anything; greyed rows are archived and can be restored at any time, or deleted for good with 「彻底删除」(irreversible, asks once more).*
 
 ![Tools drawer: archive candidates / reserved-name editing, zero footprint when closed](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/tools-drawer.png)
 
@@ -171,7 +171,7 @@ Every image below is **rendered from the UI code in this repository** (the same
 
 ![Archive candidates: each states "why archiving is suggested", executed only after confirmation](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/archive-candidates.png)
 
-*Archive candidates — each states "why archiving is suggested" (idle days vs the threshold for that type); files are touched only after you confirm one by one or select all. Archiving moves a file into `archive/`, it **does not delete**.*
+*Archive candidates — each states "why archiving is suggested" (idle days vs the threshold for that type); files are touched only after you confirm one by one or select all. Archiving moves a file into `archive/`, it **does not delete**; to actually delete an archived entry, click 「彻底删除」(delete permanently) in the archive view and confirm once more.*
 
 ![Memory star map: dark stars are archived memories](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/starmap-archive.png)
 

package/README.zh.md

@@ -153,7 +153,7 @@ SAGE_MEM_DIR=/path/to/your/memory
 
 ![文件列表：每条记忆一个 Markdown 文件，灰底的是已归档](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/files-list.png)
 
-*文件列表 —— 头部常显「体检 N 个问题」与「待重启生效」，不用点开就知道该不该处理；灰底条目是已归档，随时可以恢复。*
+*文件列表 —— 头部常显「体检 N 个问题」与「待重启生效」，不用点开就知道该不该处理；灰底条目是已归档，随时可以恢复，也可以点「彻底删除」真的删掉（不可恢复，要再确认一次）。*
 
 ![工具抽屉：归档候选 / 保留名编辑，关着时零占位](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/tools-drawer.png)
 
@@ -173,7 +173,7 @@ SAGE_MEM_DIR=/path/to/your/memory
 
 ![归档候选：每条写清「为什么建议归档」，确认后才执行](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/archive-candidates.png)
 
-*归档候选 —— 每条写清「为什么建议归档」（闲置天数 vs 该类型阈值），逐条或全选后确认才动文件。归档是把文件移进 `archive/`，**不删除**。*
+*归档候选 —— 每条写清「为什么建议归档」（闲置天数 vs 该类型阈值），逐条或全选后确认才动文件。归档是把文件移进 `archive/`，**不删除**；真要删掉一条归档件，得在档案馆里单独点「彻底删除」并再确认一次。*
 
 ![记忆星图：暗星是已归档的记忆](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/starmap-archive.png)
 

package/lib/client.js

@@ -1605,6 +1605,9 @@ const StarmapRuntime = (function (require, _react) {
 		// 归档文件的读 / 写（B1b）：形状与活跃记忆那套的 readSchema / writeSchema 对称。
 		const archivedReadSchema = parseSchema({ "name": isStr, "content": isStr });
 		const archivedWriteSchema = parseSchema({ "ok": isBool, "file": isStr });
+		// 「彻底删除」的入参：归档代次（`archivedAt`）。它不是装饰 —— 宿主拿它核对
+		// 「要删的是不是用户确认过的那一版」。老归档件没有留痕时传空串，所以只校类型。
+		const archiveStampSchema = strSchema;
 
 		// ── autodream 的 codec ──
 		// 刻意写得宽：这几个方法返回的是配置 / 状态对象，字段会随版本增删。
@@ -1734,6 +1737,21 @@ const StarmapRuntime = (function (require, _react) {
 					result: { mode: "strict", typeSymbol: "sage-mem/types#ArchivedWriteResult", schema: archivedWriteSchema, create: () => archivedWriteSchema },
 					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
+				{
+					// 彻底删除一条归档件（不可恢复）。第二个参数是归档代次：宿主拿它核对
+					// 「要删的是不是用户确认过的那一版」，传错（比如列表过期）会被拒绝。
+					id: "sage-mem#memory/deleteArchived",
+					service: "memory",
+					namespace: "memory",
+					method: "deleteArchived",
+					invocation: { kind: "direct" },
+					parameters: [
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#ArchivedFileName", schema: strSchema, create: () => strSchema } },
+						{ name: "archivedAt", wire: "archivedAt", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#ArchiveStamp", schema: archiveStampSchema, create: () => archiveStampSchema } },
+					],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#ArchiveResult", schema: archiveSchema, create: () => archiveSchema },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+				},
 				// ── 面板 API（D1）：体检 / 归档候选 / 设置 / 保留名原样读写 ──
 				// 结果形状都在演进（审计清单、候选表、设置项），顶层用 objCodec 接住、
 				// 内部宽松 —— 与 autodream 那几个 codec 同一套理由：host 加字段不该让旧界面整体报错。
@@ -2555,7 +2573,7 @@ const StarmapRuntime = (function (require, _react) {
 
 		/**
 		 * 归档区的一条。与活动卡片共用骨架（类型章 / 标题 / 标签 / 描述），刻意的差异：
-		 * 虚线边框 + 整体压灰（退役感）、多一行归档留痕、动作是「编辑 / 恢复」。
+		 * 虚线边框 + 整体压灰（退役感）、多一行归档留痕、动作是「编辑 / 恢复 / 彻底删除」。
 		 *
 		 * ⚠️ 灰的只有**内容**（`.smem-card--archived` 那几条只点标题/类型章/标签/正文的字色）。
 		 * 按钮一律保持原样 —— 按钮一灰，用户就以为不能按。
@@ -2563,7 +2581,10 @@ const StarmapRuntime = (function (require, _react) {
 		 * ⚠️ 编辑走**原样文本**：readArchived 拿到的全文直接进 textarea，保存时原样交回
 		 * writeArchived。绝不走活跃记忆那套 buildFrontmatter 重建 —— 重建会吞字段，
 		 * 归档文件里还有 archived_at / archived_reason 这种留痕，更动不得。
-		 * 也不提供删除：归档 = 不删，host 侧也没有那条 remote。
+		 *
+		 * 「彻底删除」是 v1.1.0 加的**唯一**一个不可逆入口，所以它走两段式：
+		 * 点一下只展开一句「真的删、不能恢复」的确认条，再点「确认彻底删除」才动手。
+		 * 归档的承诺（只移不删）没有被它破坏 —— 归档动作仍然一个字节都不删。
 		 */
 		function ArchivedCard(props) {
 			const item = props.item;
@@ -2603,19 +2624,39 @@ const StarmapRuntime = (function (require, _react) {
 								h("button", { type: "button", className: "smem-btn", key: "cancel", disabled: props.busy, onClick: props.onCancel }, "取消"),
 							]),
 						])
-					: h("div", { className: "smem-card-foot", key: "foot" },
-							h("div", { className: "smem-actions", key: "acts" }, [
-								h("button", {
-									type: "button", className: "smem-btn", key: "edit",
-									disabled: props.busy,
-									onClick: function () { props.onEdit(item.file); },
-								}, "编辑"),
-								h("button", {
-									type: "button", className: "smem-btn smem-btn-primary", key: "restore",
-									disabled: props.busy,
-									onClick: function () { props.onRestore(item.file); },
-								}, props.restoring ? "恢复中…" : "恢复"),
-							])),
+					: props.deleting
+						? h("div", { className: "smem-ar-confirm", key: "del" }, [
+								h("div", { key: "what" },
+									"彻底删除「" + item.file + "」：它会从 archive/ 里被真的删掉，不能恢复。" +
+									"要保留它就先点「恢复」，把它放回活动记忆。"),
+								h("div", { className: "smem-ar-hint", key: "hint" },
+									"这一步之后没有任何界面能把内容找回来 —— 只剩你自己在磁盘上留过备份。"),
+								h("div", { className: "smem-row", key: "btns" }, [
+									h("button", { type: "button", className: "smem-btn smem-btn-danger", key: "yes", disabled: props.busy, onClick: function () { props.onConfirmDelete(item.file); } }, "确认彻底删除"),
+									h("button", { type: "button", className: "smem-btn", key: "no", disabled: props.busy, onClick: props.onCancelDelete }, "取消"),
+								]),
+							])
+						: h("div", { className: "smem-card-foot", key: "foot" },
+								h("div", { className: "smem-actions", key: "acts" }, [
+									h("button", {
+										type: "button", className: "smem-btn", key: "edit",
+										disabled: props.busy,
+										onClick: function () { props.onEdit(item.file); },
+									}, "编辑"),
+									h("button", {
+										type: "button", className: "smem-btn smem-btn-primary", key: "restore",
+										disabled: props.busy,
+										onClick: function () { props.onRestore(item.file); },
+									}, props.restoring ? "恢复中…" : "恢复"),
+									// 放在最后、且用 danger-ghost：它是这张卡上唯一不可逆的动作，
+									// 不该跟「恢复」长得一样。
+									h("button", {
+										type: "button", className: "smem-btn smem-btn-danger-ghost", key: "purge",
+										disabled: props.busy,
+										title: "从 archive/ 里彻底删掉，不可恢复（要留就先恢复）",
+										onClick: function () { props.onAskDelete(item.file); },
+									}, "彻底删除"),
+								])),
 			]);
 		}
 
@@ -3804,6 +3845,10 @@ const StarmapRuntime = (function (require, _react) {
 			const archiveReason = sArchiveReason[0], setArchiveReason = sArchiveReason[1];
 			const sRestoring = react.useState(null);
 			const restoring = sRestoring[0], setRestoring = sRestoring[1];
+			// 「彻底删除」的二次确认：正在问哪一条（null = 没在问）。
+			// 与 editing 互斥 —— 同一张卡上不能既在改又在删。
+			const sArchDelete = react.useState(null);
+			const archDelete = sArchDelete[0], setArchDelete = sArchDelete[1];
 			// 归档文件的「原样文本」编辑器：正在编辑谁、编辑框里是什么、读/存进行中
 			const sArchEdit = react.useState(null);
 			const archEdit = sArchEdit[0], setArchEdit = sArchEdit[1];
@@ -4073,6 +4118,7 @@ const StarmapRuntime = (function (require, _react) {
 				}
 				setBusy(true); setError(null); setNotice("");
 				setRestoring(file);
+				setArchDelete(null);
 				remote.restore(file)
 					.then(function (r) {
 						if (r && r.ok === false) { setError(r.error || "恢复被拒绝"); return; }
@@ -4084,6 +4130,31 @@ const StarmapRuntime = (function (require, _react) {
 					.then(function () { setBusy(false); setRestoring(null); });
 			}
 
+			/**
+			 * **彻底删除**一条归档件（不可恢复）。
+			 *
+			 * 第二个参数是归档代次（列表上看到的 `archivedAt`）：宿主拿它核对「要删的是不是
+			 * 我确认过的那一版」。不传它会变成「按名字删」—— 名字底下的内容刚才可能已经换人了。
+			 */
+			function deleteArchivedFile(file) {
+				if (typeof remote.deleteArchived !== "function") {
+					setError("宿主侧还没有 deleteArchived 接口（插件版本较旧）");
+					return;
+				}
+				const item = archiveItems.filter(function (x) { return x.file === file; })[0];
+				const stamp = (item && item.archivedAt) || "";
+				setBusy(true); setError(null); setNotice("");
+				remote.deleteArchived(file, stamp)
+					.then(function (r) {
+						if (r && r.ok === false) { setError(r.error || "删除被拒绝"); return; }
+						setArchDelete(null);
+						setNotice("已彻底删除 " + file + " —— 归档区里也没有它了，找不回来");
+						load();
+					})
+					.catch(function (e) { setError(String((e && e.message) || e)); })
+					.then(function () { setBusy(false); });
+			}
+
 			/**
 			 * 打开归档文件的**原样文本**编辑器。
 			 *
@@ -4098,6 +4169,7 @@ const StarmapRuntime = (function (require, _react) {
 					return;
 				}
 				setError(null); setNotice("");
+				setArchDelete(null);
 				setArchEdit(file);
 				setArchText("");
 				setArchLoad(true);
@@ -4368,6 +4440,7 @@ const StarmapRuntime = (function (require, _react) {
 							item: it,
 							busy: busy,
 							restoring: restoring === it.file,
+							deleting: archDelete === it.file,
 							editing: archEdit === it.file,
 							loading: archLoad && archEdit === it.file,
 							saving: archSaving && archEdit === it.file,
@@ -4377,6 +4450,10 @@ const StarmapRuntime = (function (require, _react) {
 							onSave: saveArchEdit,
 							onCancel: cancelArchEdit,
 							onRestore: restoreFile,
+							// 两个「危险动作的确认」互斥：问到一半又去改文本，界面就会同时摆两个确认条。
+							onAskDelete: function (file) { setArchDelete(file); setArchEdit(null); },
+							onCancelDelete: function () { setArchDelete(null); },
+							onConfirmDelete: deleteArchivedFile,
 						});
 					}
 					return h(Card, {
@@ -4407,7 +4484,7 @@ const StarmapRuntime = (function (require, _react) {
 					? [
 							h("div", { className: "smem-ar-banner", key: "banner" },
 								"档案馆里的记忆不参与检索与星图，原文仍在记忆目录的 archive/ 下 —— 恢复后它就回到活动列表；" +
-								"「编辑」是原样文本编辑，改完存回同一份文件。"),
+								"「编辑」是原样文本编辑，改完存回同一份文件；「彻底删除」会真的从 archive/ 里删掉它（不可恢复，删除前还要再确认一次）。"),
 							list,
 						]
 					: list;

package/lib/index.js

@@ -32,7 +32,7 @@ import { readCheckpoint } from './memory/checkpoint.js'
 import { memoryPathOf } from './memory/paths.js'
 import { decideWriteIntent, decideEditGuard } from './memory/write-gate.js'
 import { createMemoryTools } from './tools/memory-tools.js'
-import { archiveMemory, restoreMemory } from './memory/archive.js'
+import { archiveMemory, deleteArchivedMemory, restoreMemory } from './memory/archive.js'
 import { flushAccess, pickArchiveCandidates, readAccessLedger, recordAccess, recordRead } from './memory/access.js'
 import { warnLog, writeFileAtomic } from './memory/util.js'
 import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
@@ -1027,6 +1027,21 @@ export class MemoryGateway extends TypertRemoteService {
     return { ok: true, file: safe }
   }
 
+  /**
+   * **彻底删除**一条已归档记忆（不可恢复）。
+   *
+   * 与 `deleteFile` 的区别要在代码里就分开：那个删的是活动记忆，这个删的是档案馆里的退役件；
+   * 归档「只移不删」的承诺不变 —— 走进档案馆之后，删不删由人单独决定。
+   *
+   * `archivedAt` 是**身份判据**（见 `memory/archive.js` 的头注）：调用方交回它当时看见的
+   * 归档时间，盘上那份对不上就拒绝。不传 / 传空串只对「本来就没有留痕的老归档件」成立。
+   */
+  async deleteArchived(name, archivedAt) {
+    const res = await deleteArchivedMemory(MEMORY_DIR, name, archivedAt)
+    if (!res.ok) return { ok: false, error: res.error }
+    return { ok: true, file: res.file }
+  }
+
   /**
    * 记忆目录体检：结构化审计结果。
    *
@@ -1233,6 +1248,7 @@ markRemote(MemoryGateway, 'restore', 'restore')
 markRemote(MemoryGateway, 'listArchived', 'listArchived')
 markRemote(MemoryGateway, 'readArchived', 'readArchived')
 markRemote(MemoryGateway, 'writeArchived', 'writeArchived')
+markRemote(MemoryGateway, 'deleteArchived', 'deleteArchived')
 markRemote(MemoryGateway, 'audit', 'audit')
 markRemote(MemoryGateway, 'checkUpdate', 'checkUpdate')
 markRemote(MemoryGateway, 'setLocked', 'setLocked')

package/lib/memory/archive.js

@@ -15,7 +15,7 @@
  * 就是临时目录），拿模块级常量会写错地方 —— 那是会碰到真实记忆的危险错误。
  */
 
-import { ARCHIVE_DIR_NAME, addArchiveMeta, inspectDir, inspectMemoryEntry, localStamp, stripArchiveMeta } from './scan.js'
+import { ARCHIVE_DIR_NAME, addArchiveMeta, inspectDir, inspectMemoryEntry, localStamp, readArchivedMeta, stripArchiveMeta } from './scan.js'
 import { isReserved, nameKey, safeName } from './naming.js'
 import { writeFileAtomic, writeFileExclusive } from './util.js'
 import { isLocked } from './lock.js'
@@ -290,3 +290,104 @@ export async function restoreMemory(memoryDir, name) {
     ...(indexError ? { indexError } : {}),
   }
 }
+
+/**
+ * 从归档区**彻底删除**一条记忆（不可恢复）。
+ *
+ * 为什么不复用 `deleteFile`：归档的承诺是「只移不删」，活记忆的 `deleteFile` 承诺的
+ * 是「删掉活的这份」。两者混在一个名字下，用户就永远分不清自己按的是哪一个；
+ * 而这个操作**没有回收站**。
+ *
+ * 三道判据，缺一不可：
+ *   1. **归档区的目录闸门**：它若被换成指向外部的联接，删掉的是别人的文件；
+ *   2. **条目闸门**：链接 / 硬链接指向的可能是记忆目录之外的内容，删它等于替别人删文件；
+ *   3. **代次（`archivedAt`）**：名字不是身份。用户从列表看到确认框、到请求到达之间，
+ *      这条完全可能被恢复回顶层、又被另一版同名记忆归档进来 —— 按名删掉的就不再是他
+ *      确认过的那一份。所以调用方必须交回它当时看见的 `archived_at`，对不上就拒绝。
+ *      老数据没有留痕时两边都是空串，仍然一致（那是「同一份、只是没有时间戳」）。
+ *
+ * ⚠️ 删除本身用 **`rename` 到私有名 + `rm` 私有名**：`inspect` 与 `unlink` 之间隔着
+ * 读文件，直接 `unlink(full)` 认的是**名字**而不是我们核对过的那份实物。`rename` 是原子的，
+ * 之后删的一定是刚移走的那一个 inode。删失败时把名字 `link()` 还回去 —— 绝不让它
+ * 以 `.deleting-` 的私有名留在盘上（扫描不认那个名字，等于文件凭空消失）。
+ *
+ * @param {string} memoryDir — 记忆根目录（调用方给，不许拿模块常量）
+ * @param {string} name — 归档区里的文件名
+ * @param {string} expectedArchivedAt — 调用方看见的 `archived_at`（没有留痕时传空串）
+ * @returns {Promise<{ok:true,file:string}|{ok:false,code:string,error:string}>}
+ */
+export async function deleteArchivedMemory(memoryDir, name, expectedArchivedAt = '') {
+  const gate = checkName(name, 'delete')
+  if (!gate.ok) return gate
+  const safe = gate.safe
+  const dirGate = await inspectDir(archiveDirOf(memoryDir))
+  if (!dirGate.ok) {
+    return {
+      ok: false,
+      code: dirGate.code === 'missing' ? 'not-archived' : dirGate.code,
+      error: `sage-mem: not archived: ${safe}（${dirGate.error}）`,
+    }
+  }
+  const full = join(archiveDirOf(memoryDir), safe)
+  const srcGate = await inspectMemoryEntry(full, { limitBytes: null })
+  if (!srcGate.ok) {
+    return {
+      ok: false,
+      code: srcGate.code === 'missing' ? 'not-archived' : srcGate.code,
+      error: `sage-mem: not archived: ${safe}（${srcGate.error}）`,
+    }
+  }
+  // 读全文只为取留痕：代次判据必须来自**盘上的那份**，不能信调用方一路传下来的展示值。
+  const onDisk = readArchivedMeta(await readFile(full, 'utf8'))
+  const expected = String(expectedArchivedAt ?? '')
+  if (expected !== onDisk.archivedAt) {
+    return {
+      ok: false,
+      code: 'changed',
+      error:
+        `sage-mem: ${safe} 在确认之后被换成了另一版（界面上是「${expected || '时间未知'}」，` +
+        `盘上是「${onDisk.archivedAt || '时间未知'}」），本次一个字节都没删 —— 请刷新列表再看一眼。`,
+    }
+  }
+  const taken = join(archiveDirOf(memoryDir), `.${safe}.deleting-${randomUUID().replace(/-/g, '')}`)
+  const moveErr = await rename(full, taken).then(
+    () => null,
+    (err) => err,
+  )
+  if (moveErr) {
+    if (moveErr?.code === 'ENOENT') {
+      return { ok: false, code: 'not-archived', error: `sage-mem: not archived: ${safe}（删除途中它从归档区消失了）` }
+    }
+    return {
+      ok: false,
+      code: 'move-failed',
+      error: `sage-mem: 删除 ${safe} 时移不动它（${moveErr?.code ?? moveErr}：${moveErr?.message ?? moveErr}）。文件仍在 archive/ 里、一个字节没动 —— 可稍后重试（若是被其它程序占用，关掉它再来）。`,
+    }
+  }
+  const delErr = await rm(taken, { force: true }).then(
+    () => null,
+    (err) => err,
+  )
+  if (delErr) {
+    const restored = await link(taken, full).then(
+      () => true,
+      () => false,
+    )
+    if (!restored) {
+      return {
+        ok: false,
+        code: 'delete-failed',
+        error:
+          `sage-mem: 删除 ${safe} 失败（${delErr?.code ?? delErr}），且归还原名时被占用 —— ` +
+          `**内容仍保留在 archive/${basename(taken)}**，请手工改回 ${safe} 再试。`,
+      }
+    }
+    await rm(taken, { force: true }).catch(() => {})
+    return {
+      ok: false,
+      code: 'delete-failed',
+      error: `sage-mem: 删除 ${safe} 失败（${delErr?.code ?? delErr}：${delErr?.message ?? delErr}），文件已还回 archive/${safe}，没有丢。`,
+    }
+  }
+  return { ok: true, file: safe }
+}

package/lib/typert.host.js

@@ -96,6 +96,9 @@ const archivedListSchema = z.object({
 // 归档缘由：用户输入的一句话。真正的 YAML 转义在 host 侧 yamlScalar（值里的「: 」「 #」），
 // 这里只兜长度 —— 缘由不该长到把 frontmatter 变成正文。
 const archiveReasonSchema = z.string().max(1000).optional()
+// 归档代次（`archived_at`，`YYYY-MM-DD HH:mm`）：面板把它交回「彻底删除」当**身份判据**
+// —— 用户确认过的是「这一版归档件」，名字不是身份。老归档件没有留痕时传空串，所以不设 min。
+const archiveStampSchema = z.string().max(64)
 // starmap.listStars 的可选开关：不看归档星时行为与从前完全一致。
 const includeArchivedSchema = z.boolean().optional()
 
@@ -585,6 +588,22 @@ export const TYPERT = {
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#ArchivedWriteResult', schema: archivedWriteResultSchema, create: () => archivedWriteResultSchema },
 			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
+		{
+			// **彻底删除**一条归档件（不可恢复）。第二个参数是身份判据，不是装饰：
+			// 名字在「用户确认」与「请求到达」之间可能已经被恢复＋重新归档成另一版。
+			id: 'sage-mem#memory/deleteArchived',
+			service: 'memory',
+			namespace: 'memory',
+			method: 'deleteArchived',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#ArchivedFileName', schema: fileNameSchema, create: () => fileNameSchema } },
+				{ name: 'archivedAt', wire: 'archivedAt', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#ArchiveStamp', schema: archiveStampSchema, create: () => archiveStampSchema } },
+			],
+			// 成功 `{ ok: true, file }`、失败 `{ ok: false, error }` —— 与归档 / 恢复同形，复用 ArchiveResult。
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#ArchiveResult', schema: archiveResultSchema, create: () => archiveResultSchema },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+		},
 		{
 			id: 'sage-mem#memory/audit',
 			service: 'memory',

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": "1.0.2",
+  "version": "1.1.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {