dsh-brief-sidebar 0.5.0 → 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 drscrewdriver
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -15,14 +15,12 @@ DSH web 插件（`dsh-better-sidebar` 消费方），仓库/包名 **`dsh-brief-
 
 **兼容性范围**：本线（分支 `main`，自 `compat/0.2.0` 升格）面向 **DSH 0.2.0 线**——`engines.dsh` 为 `>=0.2.0-rc.1 <0.2.1-0`，实测基线是 DSH 0.2.0-rc.1，发布走 npm dist-tag **`dsh-0.2.0`**。0.2.0 对本插件所用的全部宿主 API 是纯增量（消费面全部是 `ctx.get(...)` 纯 caller，零导出删除），所以支持线整体前移即可，没有运行时兼容分支。**按 DSH 版本选插件版本**（不要在旧宿主上裸用 `latest`——不满足旧宿主 `engines` 会被启动预检静默禁用；caret 范围跨宿主 minor 也不成立）：
 
-| DSH 宿主 | 本插件最新版本 | 安装 dist-tag |
-|---|---|---|
-| 0.2.0 | **0.4.0**（latest） | `dsh-0.2.0` |
-| 0.1.7 | 0.3.1 | `dsh-0.1.7` |
-| 0.1.5 | 0.3.1 | `dsh-0.1.5` |
-| 0.1.2 及更早 | 不支持（0.1.x 线下限为 0.1.5-rc.1，npm 上无对应 dist-tag） | — |
-
-（截至 2026-09-30；0.1.x 线由冻结保留分支 `compat/0.1.7` / `compat/0.1.5`（≤0.3.1）继续服务。）
+| DSH 宿主 | 本插件最新版本 | 安装 dist-tag |
+|---|---|---|
+| 0.1.0-rc.2 ～ 0.2.0 全线（15rc） | **0.6.0**（单版本统一） | `latest`（或任一线 tag，全指 0.6.0） |
+
+（2026-10-09 起单版本跨线：`compat/0.1.7` / `compat/0.1.5` 冻结退役。0.1.x 老格上 better-sidebar 未激活服务时本插件按设计 inert——console 干净、不拖死其它插件；「概要」tab 在 better-sidebar 正常激活的宿主（0.2.0 等）呈现。）
+
 
 ![brief-sidebar](assets/brief.png)
 
@@ -32,6 +30,10 @@ dock cell、`dsh-tool-todo` 属于 DSH 上游领域，沿用 `todo` 原词，不
 
 **记忆系统**：简报的第三个分区（记忆召回）目前**仅预留布局插槽**，处于**规划中**，本期不渲染——见 R11 / K4。
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **Supported DSH hosts:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (15 rc releases across lines 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+<!-- host-compat:end -->
+
 ## 需求映射
 
 | 编号 | 需求 | 实现位置 |

package/dsh.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "dsh-external/dsh-brief-sidebar",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "main": "./lib/index.mjs",
   "description": "会话简报侧栏页（brief）：把会话的 todo 列表（`todos` 投影的进展看板）、产物列表（`dshSummaryDeliverables` 投影的实时产出文件）与记忆槽位（`memorySlots` 投影，来自 dsh-prime-memory，开关可关）一起渲染成右侧栏的一个「概要」tab，并遮蔽 DSH 官方那条 composer 上方的 todo 面板。只读展示，不做写回。",
   "engines": {
-    "dsh": ">=0.2.0-rc.1 <0.2.1-0"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2"
   },
   "contributes": {
     "tools": [],

package/lib/client.js

@@ -1389,6 +1389,58 @@ window.__ModuleLoader__.load({
 			})));
 		}
 		//#endregion
+		//#region src/client/native-sidebar.tsx
+		/** The keyed seat a tab type registers its body under. */
+		const PANE_TAB_SEAT = "sidebar.right.pane.tab";
+		/**
+		* Register the board as a native right-sidebar tab type.
+		*
+		* The registry arrives as a parameter, read from the deferred `ctx.inject`
+		* scope in `apply` — the 0.1.7+ strict-proxy ctx refuses a root `ctx.get`
+		* of an undeclared service, so reaching for `sidebarRightTabs` from the root
+		* context is what made the native seat silently no-op on 0.1.7 (the "cannot
+		* register directly" observation). better-sidebar's own native bridge reads
+		* it the same way: from the inject callback's scope.
+		*
+		* @param ctx - the client root context (for the declared `slots` service).
+		* @param registry - the host tab-type registry from the injected scope.
+		* @param deps - the stable ids and the translator from `apply`.
+		* @returns a disposer that unregisters the seat first, then the type (the
+		*   registry refuses opens for a type whose body is already gone).
+		*/
+		function registerNativeBoardTab(ctx, registry, deps) {
+			const slots = ctx.get("slots");
+			if (registry === void 0 || typeof registry.register !== "function" || slots === void 0) return () => {};
+			const disposeType = registry.register({
+				id: deps.id,
+				kind: deps.kind,
+				title: () => deps.t("tab.title"),
+				guide: [{
+					id: deps.id,
+					order: deps.order,
+					title: () => deps.t("tab.title"),
+					description: () => deps.t("tab.desc")
+				}]
+			});
+			const disposeSeat = slots.inject(PANE_TAB_SEAT, () => slots.register({
+				name: PANE_TAB_SEAT,
+				key: deps.id,
+				inject: (sessionId) => ({
+					t: deps.t,
+					ctx,
+					scope: { sessionId },
+					visible: true
+				})
+			}, SummaryTab));
+			return () => {
+				try {
+					disposeSeat();
+				} finally {
+					disposeType();
+				}
+			};
+		}
+		//#endregion
 		//#region src/client/BriefIcon.tsx
 		/**
 		* A checklist mark: three rows with ticks and text rails — the same status
@@ -1636,10 +1688,14 @@ window.__ModuleLoader__.load({
 		* 1. **Dictionaries first.** Every later registration can render translated
 		*    copy, and a dictionary that lands after the first paint would show raw
 		*    keys for a frame.
-		* 2. **Soft-dependency check.** `inject` already waits for `betterSidebar`, so
-		*    the guard only fires in a composition that relaxes the inject list. It is
-		*    kept because it is what stops the plugin from hiding the official panel
-		*    when it has no board to replace it with.
+		* 2. **Sidebar surface, deferred.** The board needs a sidebar to live in:
+		*    better-sidebar when it is installed (richer: badge + rail icon), else the
+		*    host's own right-sidebar tab system (0.1.5+ `sidebarRightTabs` +
+		*    `sidebar.right.pane.tab`). Both are acquired through the deferred
+		*    `ctx.inject` because neither service is ordered against this apply —
+		*    an immediate `ctx.get` was the 0.1.2 inert bug. With neither — ≤0.1.2
+		*    hosts without better-sidebar — the plugin stays sidebar-inert: the
+		*    official panel keeps rendering and the shadow never installs.
 		* 3. **Shadow the official dock.** Deliberately BEFORE the tab registration:
 		*    the panel is the only other carrier of the list, so the replacement has to
 		*    exist in the same activation.
@@ -1674,6 +1730,12 @@ window.__ModuleLoader__.load({
 		*/
 		const TAB_ID = "dsh-brief-sidebar:board";
 		/**
+		* Tab kind on the native host-sidebar path (`openTab`/guide dispatch key).
+		* Only the native registration uses it; better-sidebar keeps addressing the
+		* tab by {@link TAB_ID}.
+		*/
+		const TAB_KIND = "brief-board";
+		/**
 		* Position in the host's new-tab guide.
 		*
 		* Built-ins on this host generation sit at editor 10 / git 20 / subagent 30 /
@@ -1682,17 +1744,29 @@ window.__ModuleLoader__.load({
 		*/
 		const TAB_ORDER = 15;
 		/** Services required before `apply` runs. */
-		const inject = [
-			"betterSidebar",
-			"locale",
-			"slots"
-		];
+		const inject = ["slots", "locale"];
 		/**
 		* An effect body must return a disposer (cordis rejects `undefined` with a
 		* `TypeError`), so a path that could not register anything returns this no-op
 		* instead of nothing.
 		*/
 		const NOOP = () => {};
+		/** Console prefix for the environment probe and registration attribution. */
+		const LOG = "[dsh-brief-sidebar]";
+		/**
+		* Run a registration thunk, attributing a thrown failure to the console
+		* instead of the cordis effect void (a bare throw inside `ctx.effect` leaves
+		* the field reader with an empty sidebar and no clue which arm died).
+		*/
+		function guarded(label, run) {
+			try {
+				const dispose = run();
+				return typeof dispose === "function" ? dispose : NOOP;
+			} catch (error) {
+				console.error(`${LOG} ${label} failed`, error);
+				return NOOP;
+			}
+		}
 		/**
 		* Browser-face apply.
 		*
@@ -1715,34 +1789,83 @@ window.__ModuleLoader__.load({
 					return key;
 				}
 			};
-			const bar = ctx.get("betterSidebar");
-			if (bar === void 0) return;
-			ctx.effect(() => registerTodoDockShadow(ctx) ?? NOOP, "dsh-brief-sidebar: dock shadow");
-			ctx.effect(() => bar.registerTab({
-				id: TAB_ID,
-				title: () => t("tab.title"),
-				description: () => t("tab.desc"),
-				icon: (size) => BriefIcon(size),
-				order: 15,
-				single: true,
-				/**
-				* Unfinished count on the tab strip. Called on every tab-bar render, so
-				* it reads one snapshot and allocates no subscription; a completed list
-				* shows no badge at all.
-				*/
-				badge: (badgeCtx, badgeScope) => {
-					const todos = readTodos(projectionSnapshot(badgeCtx, badgeScope.sessionId, TODOS_KEY));
-					if (todos === void 0) return null;
-					const pending = unfinishedCount(todos);
-					return pending > 0 ? pending : null;
-				},
-				component: (props) => (0, react.createElement)(SummaryTab, {
-					t,
-					ctx: props.ctx,
-					scope: props.scope,
-					visible: props.visible
-				})
-			}), "dsh-brief-sidebar: tab");
+			let surface = "none";
+			let shadowDone = false;
+			let nativeDisposer;
+			/** Hide the official composer-band panel (reversible on unload), once. */
+			const shadowDock = () => {
+				if (shadowDone) return;
+				shadowDone = true;
+				ctx.effect(() => registerTodoDockShadow(ctx) ?? NOOP, "dsh-brief-sidebar: dock shadow");
+			};
+			const registerOnBar = (bar) => {
+				if (surface === "bar") return;
+				if (surface === "native") {
+					const release = nativeDisposer;
+					nativeDisposer = void 0;
+					try {
+						release?.();
+					} catch {}
+					console.info(`${LOG} surface=bar (handed over from native)`);
+				} else console.info(`${LOG} surface=bar`);
+				surface = "bar";
+				shadowDock();
+				ctx.effect(() => guarded("registerTab", () => bar.registerTab({
+					id: TAB_ID,
+					title: () => t("tab.title"),
+					description: () => t("tab.desc"),
+					icon: (size) => BriefIcon(size),
+					order: 15,
+					single: true,
+					/**
+					* Unfinished count on the tab strip. Called on every tab-bar render, so
+					* it reads one snapshot and allocates no subscription; a completed list
+					* shows no badge at all.
+					*/
+					badge: (badgeCtx, badgeScope) => {
+						const todos = readTodos(projectionSnapshot(badgeCtx, badgeScope.sessionId, TODOS_KEY));
+						if (todos === void 0) return null;
+						const pending = unfinishedCount(todos);
+						return pending > 0 ? pending : null;
+					},
+					component: (props) => (0, react.createElement)(SummaryTab, {
+						t,
+						ctx: props.ctx,
+						scope: props.scope,
+						visible: props.visible
+					})
+				})), "dsh-brief-sidebar: tab");
+			};
+			const registerOnNative = (registry) => {
+				if (surface !== "none") return;
+				surface = "native";
+				console.info(`${LOG} surface=native`);
+				shadowDock();
+				ctx.effect(() => {
+					nativeDisposer = guarded("native tab", () => registerNativeBoardTab(ctx, registry, {
+						id: TAB_ID,
+						kind: TAB_KIND,
+						order: 15,
+						t
+					}));
+					return () => {
+						nativeDisposer = void 0;
+					};
+				}, "dsh-brief-sidebar: native tab");
+			};
+			let bar;
+			try {
+				bar = ctx.get("betterSidebar");
+			} catch {
+				bar = void 0;
+			}
+			if (bar !== void 0) registerOnBar(bar);
+			else ctx.inject(["betterSidebar"], (scope) => {
+				if (scope.betterSidebar !== void 0) registerOnBar(scope.betterSidebar);
+			});
+			ctx.inject(["sidebarRightTabs"], (scope) => {
+				registerOnNative(scope.sidebarRightTabs);
+			});
 			const slots = ctx.get("slots");
 			ctx.inject(["configForms"], (scope) => {
 				const configForms = scope.configForms;
@@ -1767,9 +1890,23 @@ window.__ModuleLoader__.load({
 					inject: injectFactory
 				}, component));
 			});
+			try {
+				let nativeTabsAtApply = false;
+				try {
+					nativeTabsAtApply = ctx.get("sidebarRightTabs") !== void 0;
+				} catch {
+					nativeTabsAtApply = false;
+				}
+				console.info(`${LOG} env ${JSON.stringify({
+					locale: locale !== void 0,
+					barAtApply: bar !== void 0,
+					nativeTabsAtApply
+				})}`);
+			} catch {}
 		}
 		//#endregion
 		exports.TAB_ID = TAB_ID;
+		exports.TAB_KIND = TAB_KIND;
 		exports.TAB_ORDER = TAB_ORDER;
 		exports.apply = apply;
 		exports.inject = inject;