dsh-mnemon 0.5.0-rc.1 → 0.5.1

package/README.md

@@ -24,7 +24,7 @@
 <p align="center">
   <a href="./docs/en/capabilities.md"><strong>Explore the capability map</strong></a> ·
   <a href="./docs/en/getting-started.md">Start in five minutes</a> ·
-  <a href="./docs/en/releases/v0.4.7.md">Read the v0.4.7 notes</a> ·
+  <a href="./docs/en/releases/v0.5.1.md">Read the v0.5.1 notes</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">Watch the widescreen demo</a>
 </p>
 
@@ -34,11 +34,13 @@
 
 Runtime, Documents and Memory Spaces are independent Source plugins. A Strategy selects their instance-specific projections, retrieval routes and actions into an immutable per-turn View. Core provides only `ctx.mnemonMemory`; Sources own their data and optional pages, while Memory Spaces owns its private Provider children. The `dsh-mnemon` Starter preserves the default three-tier experience. See [Architecture](./docs/en/architecture.md) and [Plugin development](./docs/en/extensions.md).
 
-**v0.5.0-rc.1 introduces View-based Memory and independently published Source/Strategy/Provider plugins.** The SDK remains a prerelease API rather than a frozen extension ABI; default user configuration and workflows stay compatible. Compared with v0.4, the ordinary UI adds only three disabled-by-default enhancement switches under **Settings → Memory System**—no View page or plugin-management entry. See the [release-candidate scope and upgrade notes](./docs/en/releases/v0.5.0-rc.1.md); v0.4 remains the stable Sidebar-convergence line.
+**The v0.5 line introduces View-based Memory and independently published Source/Strategy/Provider plugins.** The documented extension exports form the supported v0.5 surface; internal paths and Host RPC remain private. Default user configuration and workflows stay compatible. Compared with v0.4, the ordinary UI adds only three disabled-by-default enhancement switches under **Settings → Memory System**—no View page or plugin-management entry. See the [v0.5.0 architecture scope](./docs/en/releases/v0.5.0.md).
 
-The v0.5 branch includes main's v0.4.3 behavior: Sidebar is the default; optional `displayMode: builtin` places the same Source pages in the owning conversation. Legacy `buildin` is accepted and automatically saved as `builtin`, without changing memory data. The collapsed icon aligns with neighboring Sidebar controls. The settings-store and ZIP fixes from v0.4.1 are retained. See the [latest stable release notes](./docs/en/releases/v0.4.3.md) and [entry placement and scope mapping](./docs/en/configuration.md#entry-placement-displaymode-and-tabenabled).
+v0.5.0 retains the v0.4 Sidebar behavior: Sidebar is the default; optional `displayMode: builtin` places the same Source pages in the owning conversation. Legacy `buildin` is accepted and automatically saved as `builtin`, without changing memory data. The collapsed icon aligns with neighboring Sidebar controls, and the settings-store and ZIP fixes remain included. See the [stable release notes](./docs/en/releases/v0.5.0.md) and [entry placement and scope mapping](./docs/en/configuration.md#entry-placement-displaymode-and-tabenabled).
 
-v0.4.7 promotes the published DSH 0.1.2-rc.1 release to the stable registry baseline, keeps source verification against its alpha.5 predecessor, and retains a real WebUI regression on the previous 0.1.1-rc.2 line. See the [patch release notes](./docs/en/releases/v0.4.7.md).
+v0.5.1 fixes writable settings under the released nested Desktop Sidebar and removes an Idle Review race that could reject the next conversation turn with an `already pinned` error. See the [v0.5.1 patch notes](./docs/en/releases/v0.5.1.md).
+
+The tested DSH baseline remains 0.1.2-rc.1, with Node 20 public-entry compatibility and retained regression evidence for the previous 0.1.1-rc.2 line.
 
 ## Understand the scope in 30 seconds
 
@@ -114,7 +116,7 @@ Windows users can install the official v0.2.3-or-newer release ZIP. The expected
 
 ### 2. Install DSH and the plugin
 
-The registry installation is verified against stable DSH 0.1.2-rc.1, whose complete profiles require Node.js `^22.19.0 || >=24.0.0`. The immediately preceding DSH 0.1.2-alpha.5 remains covered from source, and the previous 0.1.1-rc.2 registry line remains a backward-regression target. The dsh-mnemon package itself retains Node.js 20 compatibility for older compatible DSH hosts. Use the exact published version below for a reproducible installation; plugin authors can follow the [alpha source workflow](./docs/en/development.md#dsh-012-alpha5-source-compatibility).
+The registry installation is verified against stable DSH 0.1.2-rc.1, whose complete profiles require Node.js `^22.19.0 || >=24.0.0`. The dsh-mnemon package itself retains Node.js 20 public-entry compatibility for older compatible DSH hosts. Use the exact published version below for a reproducible installation; maintainers can run the optional [alpha source compatibility workflow](./docs/en/development.md#manual-dsh-012-alpha5-source-compatibility).
 
 ```sh
 npm install -g @deepseek-ai/dsh@0.1.2-rc.1
@@ -122,7 +124,7 @@ dsh --version
 ```
 
 ```sh
-dsh plugin --profile web add dsh-mnemon
+dsh plugin --profile web add dsh-mnemon@0.5.1
 dsh --profile web
 ```
 
@@ -216,7 +218,7 @@ See [Operations, security, and troubleshooting](./docs/en/operations.md) for bac
 | Back up, update, or troubleshoot | [Operations](./docs/en/operations.md) |
 | Integrate tools, commands, or RPC | [Interface reference](./docs/en/interfaces.md) |
 | Build a Source, Strategy or Memory Spaces Provider plugin | [Extension guide](./docs/en/extensions.md) |
-| Review the stable release | [v0.4.3 release notes](./docs/en/releases/v0.4.3.md) |
+| Review the stable release | [v0.5.1 release notes](./docs/en/releases/v0.5.1.md) |
 
 See the [documentation hub](./docs/en/README.md) for the full map.
 

package/README.zh-CN.md

@@ -24,7 +24,7 @@
 <p align="center">
   <a href="./docs/zh-CN/capabilities.md"><strong>先看能力地图</strong></a> ·
   <a href="./docs/zh-CN/getting-started.md">5 分钟开始</a> ·
-  <a href="./docs/zh-CN/releases/v0.4.7.md">v0.4.7 升级说明</a> ·
+  <a href="./docs/zh-CN/releases/v0.5.1.md">v0.5.1 升级说明</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">观看宽屏实机演示</a>
 </p>
 
@@ -34,11 +34,13 @@
 
 Runtime、Documents、Memory Spaces 是独立 Source 插件；Strategy 将各实例的投影、检索 route 与 action 组合成逐回合不可变 View。Core 只提供 `ctx.mnemonMemory`，Source 拥有数据与可选页面，Memory Spaces 自己拥有内部 Provider 子节点。`dsh-mnemon` Starter 保持默认三层使用体验。详见[架构](./docs/zh-CN/architecture.md)与[插件开发](./docs/zh-CN/extensions.md)。
 
-**v0.5.0-rc.1 引入 View-based Memory，以及独立发布的 Source/Strategy/Provider 插件。** SDK 仍是预发布 API，尚未冻结扩展 ABI；默认用户配置与使用流程保持兼容。相对 v0.4，普通界面只在“设置 → 记忆系统”增加三个默认关闭的增强开关，不增加 View 页或插件管理入口。参阅 [RC 范围与升级说明](./docs/zh-CN/releases/v0.5.0-rc.1.md)；v0.4 仍是稳定的 Sidebar 收敛发行线。
+**v0.5 版本线引入 View-based Memory，以及独立发布的 Source/Strategy/Provider 插件。** 文档化的扩展导出构成 v0.5 支持表面，内部路径与 Host RPC 仍是私有实现。默认用户配置与使用流程保持兼容。相对 v0.4，普通界面只在“设置 → 记忆系统”增加三个默认关闭的增强开关，不增加 View 页或插件管理入口。参阅 [v0.5.0 架构范围](./docs/zh-CN/releases/v0.5.0.md)。
 
-v0.5 分支已纳入 main 的 v0.4.3 行为：默认使用 Sidebar，可选 `displayMode: builtin` 将同一组 Source 页面放入所属会话。旧 `buildin` 可识别并自动保存为 `builtin`，不改变记忆数据；折叠图标与侧栏相邻控件对齐，v0.4.1 的 settings store 与 ZIP 修复也继续保留。详见[最新稳定版说明](./docs/zh-CN/releases/v0.4.3.md)与[入口位置及范围映射](./docs/zh-CN/configuration.md#入口位置displaymode-与-tabenabled)。
+v0.5.0 保留 v0.4 的 Sidebar 行为：默认使用 Sidebar，可选 `displayMode: builtin` 将同一组 Source 页面放入所属会话。旧 `buildin` 可识别并自动保存为 `builtin`，不改变记忆数据；折叠图标与侧栏相邻控件对齐，settings store 与 ZIP 修复也继续保留。详见[稳定版说明](./docs/zh-CN/releases/v0.5.0.md)与[入口位置及范围映射](./docs/zh-CN/configuration.md#入口位置displaymode-与-tabenabled)。
 
-v0.4.7 将已发布的 DSH 0.1.2-rc.1 提升为稳定的 registry 基线，继续对其 alpha.5 前序版本执行源码验证，并保留上一条 0.1.1-rc.2 版本线的真实 WebUI 回归。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.7.md)。
+v0.5.1 修复正式 Desktop 嵌套 Sidebar 下设置不可写，以及 Idle Review 竞态导致下一轮对话出现 `already pinned` 错误的问题。详见 [v0.5.1 补丁说明](./docs/zh-CN/releases/v0.5.1.md)。
+
+已验证的 DSH 基线仍是 0.1.2-rc.1，同时保留 Node 20 公开入口兼容与上一条 0.1.1-rc.2 版本线的回归证据。
 
 ## 30 秒理解能力边界
 
@@ -114,7 +116,7 @@ Windows 推荐安装 v0.2.3 或更高版本的官方 ZIP；标准安装目录与
 
 ### 2. 安装 DSH 与插件
 
-Registry 安装以稳定的 DSH 0.1.2-rc.1 验证；其完整 profile 需要 Node.js `^22.19.0 || >=24.0.0`。它的直接前序版本 DSH 0.1.2-alpha.5 继续通过源码覆盖，上一条 0.1.1-rc.2 registry 版本线则保留为向后回归目标。dsh-mnemon 包本身仍为较旧且兼容的 DSH Host 保留 Node.js 20 支持。下面显式指定已发布版本以保证可复现安装；插件作者可参照 [alpha 源码兼容流程](./docs/zh-CN/development.md#dsh-012-alpha5-源码兼容)。
+Registry 安装以稳定的 DSH 0.1.2-rc.1 验证；其完整 profile 需要 Node.js `^22.19.0 || >=24.0.0`。dsh-mnemon 包本身仍为较旧且兼容的 DSH Host 保留 Node.js 20 公开入口兼容。下面显式指定已发布版本以保证可复现安装；维护者可按需运行 [alpha 源码兼容流程](./docs/zh-CN/development.md#手动-dsh-012-alpha5-源码兼容)。
 
 ```sh
 npm install -g @deepseek-ai/dsh@0.1.2-rc.1
@@ -122,7 +124,7 @@ dsh --version
 ```
 
 ```sh
-dsh plugin --profile web add dsh-mnemon
+dsh plugin --profile web add dsh-mnemon@0.5.1
 dsh --profile web
 ```
 
@@ -216,7 +218,7 @@ dsh plugin --profile headless add "link:/absolute/path/to/dsh-mnemon"
 | 备份、更新或排障 | [运维指南](./docs/zh-CN/operations.md) |
 | 接入工具、命令或 RPC | [接口参考](./docs/zh-CN/interfaces.md) |
 | 开发 Source、Strategy 或 Memory Spaces Provider 插件 | [扩展开发指南](./docs/zh-CN/extensions.md) |
-| 查看稳定版升级 | [v0.4.3 发布说明](./docs/zh-CN/releases/v0.4.3.md) |
+| 查看稳定版升级 | [v0.5.1 发布说明](./docs/zh-CN/releases/v0.5.1.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 

package/lib/client.js

@@ -4945,7 +4945,11 @@ window.__ModuleLoader__.load({
 			}
 			publish(snapshot) {
 				this.snapshot = snapshot;
-				for (const listener of this.listeners) listener();
+				for (const listener of this.listeners) try {
+					listener();
+				} catch (error) {
+					console.warn("dsh-mnemon: settings listener failed; keeping the published Host snapshot", error);
+				}
 			}
 		};
 		//#endregion
@@ -7091,11 +7095,12 @@ window.__ModuleLoader__.load({
 		function placeEntry(root, entry) {
 			const button = newSessionButton(root);
 			if (button === void 0) return false;
-			if (entry.parentElement === root) return true;
 			const row = button.closest("[class*=\"logoRow\"]");
 			const base = row !== null && row.parentElement === root ? row : button;
-			const anchor = Array.from(root.children).filter((element) => element instanceof HTMLElement && element.matches(FAMILY_SELECTOR)).at(-1)?.nextElementSibling ?? base.nextElementSibling;
-			root.insertBefore(entry, anchor);
+			const parent = base.parentElement ?? root;
+			if (entry.parentElement === parent) return true;
+			const anchor = Array.from(parent.children).filter((element) => element instanceof HTMLElement && element.matches(FAMILY_SELECTOR)).at(-1)?.nextElementSibling ?? base.nextElementSibling;
+			parent.insertBefore(entry, anchor !== null && anchor.parentElement === parent ? anchor : null);
 			return true;
 		}
 		/** Mount a self-healing official-style entry under the New Session row. */
@@ -7149,15 +7154,21 @@ window.__ModuleLoader__.load({
 			};
 			const unsubscribe = controller.subscribe(syncActive);
 			const unsubscribeLocale = subscribeLocale?.(syncLabel) ?? (() => {});
-			syncActive();
-			tryPlace();
-			return () => {
+			const dispose = () => {
 				waitObserver.disconnect();
 				rootObserver.disconnect();
 				unsubscribe();
 				unsubscribeLocale();
 				entry.remove();
 			};
+			try {
+				syncActive();
+				tryPlace();
+				return dispose;
+			} catch (error) {
+				dispose();
+				throw error;
+			}
 		}
 		//#endregion
 		//#region src/client/workspace-controller.ts
@@ -7769,22 +7780,39 @@ window.__ModuleLoader__.load({
 					t: translate
 				})
 			}, MnemonSidebarWorkspaceHost));
-			const disposeBetterSidebar = mountBetterSidebarTab(ctx, translate, betterSidebarSeat);
-			if (typeof window === "undefined" || typeof document === "undefined") return () => {
-				disposeBetterSidebar();
-				disposeView();
-			};
+			let disposeBetterSidebar;
+			let disposeLauncher;
+			let listening = false;
+			let disposed = false;
 			const openMemoryView = () => {
 				navigation.open();
 			};
-			window.addEventListener(MNEMON_ANCHOR_EVENT, openMemoryView);
-			const disposeLauncher = mountMnemonSidebarLauncher(ctx, translate, controller);
-			return () => {
-				disposeLauncher();
-				window.removeEventListener(MNEMON_ANCHOR_EVENT, openMemoryView);
-				disposeBetterSidebar();
-				disposeView();
+			const dispose = () => {
+				if (disposed) return;
+				disposed = true;
+				try {
+					disposeLauncher?.();
+				} finally {
+					if (listening) window.removeEventListener(MNEMON_ANCHOR_EVENT, openMemoryView);
+					try {
+						disposeBetterSidebar?.();
+					} finally {
+						disposeView();
+					}
+				}
 			};
+			try {
+				disposeBetterSidebar = mountBetterSidebarTab(ctx, translate, betterSidebarSeat);
+				if (typeof window !== "undefined" && typeof document !== "undefined") {
+					window.addEventListener(MNEMON_ANCHOR_EVENT, openMemoryView);
+					listening = true;
+					disposeLauncher = mountMnemonSidebarLauncher(ctx, translate, controller);
+				}
+				return dispose;
+			} catch (error) {
+				dispose();
+				throw error;
+			}
 		}
 		/** DSH supplies the owning session; Source pages retain the same render contract. */
 		function mountBuiltinMemoryView(ctx, settings, namespace, translate) {

package/lib/index.js

@@ -4619,6 +4619,7 @@ var MnemonAgentLifecycle = class {
 	injectedMemoryText;
 	idleReviewTimer;
 	reviewController;
+	idleReviewRun;
 	reviewRunning = false;
 	lastReviewAt;
 	lastReviewAction;
@@ -4777,7 +4778,9 @@ var MnemonAgentLifecycle = class {
 	async assemblePrompt(assembly, context, next) {
 		if (context.agent !== void 0 && context.agent.id !== this.agent.id) return next();
 		const turn = openAgentTurn(this.agent);
-		if (turn === void 0 || context.signal?.aborted === true) return next();
+		if (turn === void 0) return next();
+		await this.settleIdleReview();
+		if (context.signal?.aborted === true || openAgentTurn(this.agent) !== turn) return next();
 		await this.memoryTurn?.begin(turn, context.signal);
 		return applyMemoryViewGuidance(await next(), this.memoryTurn?.current?.context.view, this.config.routingGuidance);
 	}
@@ -4808,9 +4811,17 @@ var MnemonAgentLifecycle = class {
 			if (this.config.memoryTopology.strategyId !== "default-three-tier") return;
 			if (this.agent.status !== "idle") return;
 			if (!hostSessionEvents(this.agent.session).some((event) => event.type === "turn/end" && eventTurn(event) === turn) || !this.reviewActivity().eligible || !this.reviewAdmitted(turn)) return;
-			this.runIdleReview();
+			this.startIdleReview();
 		}, this.config.idleReviewMs);
 	}
+	startIdleReview() {
+		const run = this.runIdleReview();
+		this.idleReviewRun = run;
+		const clear = () => {
+			if (this.idleReviewRun === run) this.idleReviewRun = void 0;
+		};
+		run.then(clear, clear);
+	}
 	async runIdleReview() {
 		const controller = new AbortController();
 		const triggeredScore = this.reviewActivity().score;
@@ -4840,6 +4851,10 @@ var MnemonAgentLifecycle = class {
 		this.idleReviewTimer = void 0;
 		if (abortRunning) this.reviewController?.abort();
 	}
+	async settleIdleReview() {
+		this.cancelIdleReview(true);
+		await this.idleReviewRun;
+	}
 	ensureTurnActivity(turn) {
 		let activity = this.turnActivity.get(turn);
 		if (activity === void 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.5.0-rc.1",
+  "version": "0.5.1",
   "description": "Composable three-tier memory control plane for DeepSeek Harness: persistent runtime context, searchable project documents, pluggable long-term memory, guarded strategies, WebUI, and headless tools.",
   "keywords": [
     "deepseek-harness",
@@ -45,7 +45,7 @@
   "license": "MIT",
   "publishConfig": {
     "access": "public",
-    "tag": "rc"
+    "tag": "latest"
   },
   "engines": {
     "node": ">=20"
@@ -121,33 +121,34 @@
     "lint:package": "publint --strict && attw --pack . --profile esm-only --quiet",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
+    "test:root": "vitest run --dir tests",
     "verify:build": "node scripts/verify-deterministic-build.mjs",
     "verify:headless": "node scripts/verify-headless-profile.mjs",
     "verify:package": "node scripts/verify-package-contents.mjs && node scripts/verify-public-entries.mjs && pnpm run lint:package",
     "verify:plugins": "node scripts/verify-plugin-artifacts.mjs",
     "e2e:serve": "node scripts/serve-e2e.mjs",
-    "verify": "pnpm run typecheck && pnpm run verify:build && pnpm --workspace-concurrency=1 -r build && pnpm -r typecheck && pnpm -r test && pnpm run test && pnpm run verify:headless && pnpm run verify:package",
+    "verify": "pnpm run typecheck && pnpm run verify:build && pnpm --workspace-concurrency=4 -r build && pnpm -r typecheck && pnpm -r test && pnpm run test:root && pnpm run verify:headless && pnpm run verify:package",
     "dsh:link-source": "node scripts/link-dsh-source.mjs",
     "dsh:restore-registry": "node scripts/link-dsh-source.mjs --restore",
     "release:check": "node scripts/release.mjs --check"
   },
   "dependencies": {
-    "dsh-mnemon-provider-byterover": "0.5.0-rc.1",
-    "dsh-mnemon-provider-hindsight": "0.5.0-rc.1",
-    "dsh-mnemon-provider-holographic": "0.5.0-rc.1",
-    "dsh-mnemon-provider-honcho": "0.5.0-rc.1",
-    "dsh-mnemon-provider-mem0": "0.5.0-rc.1",
-    "dsh-mnemon-provider-mnemon-native": "0.5.0-rc.1",
-    "dsh-mnemon-provider-openviking": "0.5.0-rc.1",
-    "dsh-mnemon-provider-retaindb": "0.5.0-rc.1",
-    "dsh-mnemon-provider-supermemory": "0.5.0-rc.1",
-    "dsh-mnemon-source-documents": "0.5.0-rc.1",
-    "dsh-mnemon-source-memory-spaces": "0.5.0-rc.1",
-    "dsh-mnemon-source-runtime": "0.5.0-rc.1",
-    "dsh-mnemon-strategy-auto-capture": "0.5.0-rc.1",
-    "dsh-mnemon-strategy-default-three-tier": "0.5.0-rc.1",
-    "dsh-mnemon-strategy-light-context": "0.5.0-rc.1",
-    "dsh-mnemon-strategy-scoped": "0.5.0-rc.1",
+    "dsh-mnemon-provider-byterover": "0.5.1",
+    "dsh-mnemon-provider-hindsight": "0.5.1",
+    "dsh-mnemon-provider-holographic": "0.5.1",
+    "dsh-mnemon-provider-honcho": "0.5.1",
+    "dsh-mnemon-provider-mem0": "0.5.1",
+    "dsh-mnemon-provider-mnemon-native": "0.5.1",
+    "dsh-mnemon-provider-openviking": "0.5.1",
+    "dsh-mnemon-provider-retaindb": "0.5.1",
+    "dsh-mnemon-provider-supermemory": "0.5.1",
+    "dsh-mnemon-source-documents": "0.5.1",
+    "dsh-mnemon-source-memory-spaces": "0.5.1",
+    "dsh-mnemon-source-runtime": "0.5.1",
+    "dsh-mnemon-strategy-auto-capture": "0.5.1",
+    "dsh-mnemon-strategy-default-three-tier": "0.5.1",
+    "dsh-mnemon-strategy-light-context": "0.5.1",
+    "dsh-mnemon-strategy-scoped": "0.5.1",
     "fflate": "^0.8.3",
     "schemastery": "^3.18.0",
     "zod": "^4.4.3"