@dsh-electron/dsh-plugin-multi-root-workspace 0.1.10 → 0.1.11

package/CHANGELOG.en.md

@@ -8,6 +8,17 @@ This file records the user-visible changes of every **released** version.
 - For installation sources, the supported upstream runtimes, and known limitations, see the [README](./README.en.md).
 - The evidence, numbering, and release state of each version live in the [roadmap progress ledger](./docs/plans/active/2026-09-12-multi-root-workspace.md#进度总账). The body of each GitHub Release is generated from the commit history by `scripts/release-notes.mjs` and is the complete raw list behind this file.
 
+## [0.1.11] - 2026-10-29
+
+### Added
+
+- **Exact support for DSH `0.2.1-rc.4` and `0.2.2-alpha.2`**: the `rc.4` probe was fully green with no adapter changes; `0.2.2-alpha.2` splits tool execution out of `dsh-tools` into executors and gives `AgentRegistry` a new `sessionProjections` injection — neither touches plugin source. Upstream's new `SandboxExecutionPolicy.additionalWritableRoots` (a native third writable-root path unrelated to this fork) composes correctly with the widened provider, pinned by a new regression spec asserting both grants take effect. The dev pin moves to `0.2.2-alpha.2` (cordis `4.0.6-alpha.1`, Node ≥24.9). The client forks (files-tree, open-in-app) are re-synced to the `0.2.2-alpha.2` baseline — hover rules moved under `@media (hover: hover)` and open-in-app failure feedback became an app-wide `shell.overlay` outcome toast.
+- **Upgrade lane and CI**: the CI verify matrix now routes by a known list — `0.1.*` / `0.2.0` / `0.2.1` run on Node `22.19.0`, everything else (including 0.2.2 and later) on `24.9.0`; the upgrade script additionally pins the target release's own cordis ecosystem (plugin-loader/group/include, schemastery, cosmokit) when repointing, so an older tree cannot mix with the alpha-line packages the committed lockfile prefers.
+
+### Fixed
+
+- **Skills refresh feedback loop caused by repeated Registry-authority notifications ([Issue #24](https://github.com/cherrchen/dsh-plugin-multi-root-workspace/issues/24))**: while a second DSH process contends for the registry lease (or the store fails to open), every additional-root Skills query retried the lease through `refresh()`; on failure `setRegistryAuthority(false)` notified listeners even though the state had not changed, invalidating the Skills cache and broadcasting `skills/change` — clients re-query on every event, closing an unbounded feedback loop: the contending Host burned about one CPU core while idle, grew memory, and eventually died of V8 OOM, and zero additional roots did not prevent it. Listeners are now notified only on a real `available`/`unavailable` transition; the lease retry, takeover after the holder exits, and the fail-closed "primary root only while authority is unavailable" semantics are unchanged ([troubleshooting](./docs/troubleshooting/registry-owned-by-another-process.md#skills-查询导致持续刷新issue-24), [ADR-0023 revision](./docs/decisions/ADR-0023-multi-root-skill-discovery-and-invocation.md#4-生命周期缓存与撤销)).
+
 ## [0.1.10] - 2026-10-25
 
 ### Added
@@ -181,7 +192,8 @@ The first release: the three MVP milestones (M1–M3).
 
 - All eight findings of the pre-release external review (three of them release-blocking) are fixed, each with a regression test: a registered directory replaced by a symlink transplanting its authority (which introduced `recordedPath` — **re-resolving a path is not re-authorizing it**), concurrent registry mutations losing a write or reviving a revoked grant (per-primary-root mutations are serialized), a refresh not re-checking directories, a typed path being overwritten by the directory picker, the `reveal` response contract and failure code, duplicate ids not validated, the primary root missing from nesting validation, and CI testing before building.
 
-[Unreleased]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.10...HEAD
+[Unreleased]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.11...HEAD
+[0.1.11]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.10...v0.1.11
 [0.1.10]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.9...v0.1.10
 [0.1.9]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.7...v0.1.8

package/CHANGELOG.md

@@ -8,6 +8,17 @@ English: [CHANGELOG.en.md](./CHANGELOG.en.md)
 - 安装方式、受支持的上游运行时与已知限制见 [README](./README.md)。
 - 每个版本的实施证据、编号口径与发布状态见[路线图 §进度总账](./docs/plans/active/2026-09-12-multi-root-workspace.md#进度总账)；GitHub Release 的正文由 `scripts/release-notes.mjs` 从 commit 历史生成，是本文件之外的完整原始清单。
 
+## [0.1.11] - 2026-10-29
+
+### Added
+
+- **精确支持 DSH `0.2.1-rc.4` 与 `0.2.2-alpha.2`**：`rc.4` 探针全绿、无需任何适配改动；`0.2.2-alpha.2` 把工具执行从 `dsh-tools` 拆出为独立执行器，`AgentRegistry` 新增注入 `sessionProjections`，本插件源码均不受影响。上游新增 `SandboxExecutionPolicy.additionalWritableRoots`（原生与 fork 无关的第三路可写根），宽授权 provider 与其正确复合——新回归用例钉住双方 grant 同时生效。开发 pin 提升到 `0.2.2-alpha.2`（cordis `4.0.6-alpha.1`，Node ≥24.9）。客户端 fork（files-tree、open-in-app）已对齐 `0.2.2-alpha.2` 基线——hover 规则移入 `@media (hover: hover)`，open-in-app 失败反馈改为应用级 `shell.overlay` outcome toast。
+- **升级通道与 CI**：CI verify 矩阵改为按已知名单分流——`0.1.*` / `0.2.0` / `0.2.1` 走 Node `22.19.0`，其余（含 0.2.2 及以后）走 Node `24.9.0`；升级脚本在重指旧版本时会顺带钉住该版本自带的 cordis 生态（plugin-loader/group/include、schemastery、cosmokit），避免与提交锁文件的 alpha 行混树。
+
+### Fixed
+
+- **Registry Authority 重复通知引发的 Skills 刷新反馈循环（[Issue #24](https://github.com/cherrchen/dsh-plugin-multi-root-workspace/issues/24)）**：第二个 DSH 进程争用登记表 lease（或存储打开失败）时，附加根 Skills 的每次查询都经 `refresh()` 重试 lease；失败后 `setRegistryAuthority(false)` 即使状态没有变化也通知监听者，使 Skills 缓存失效并广播 `skills/change`，收到事件的客户端立即重查，形成无界反馈循环——等待方 Host 空闲时持续占用约一个 CPU 核心、内存增长直至 V8 OOM，零附加根同样可触发。现在仅在实际状态变化时通知；lease 重试、持锁方退出后的接管、以及「权限不可用时仅主根可写」的 fail-closed 语义不变（[故障排查](./docs/troubleshooting/registry-owned-by-another-process.md#skills-查询导致持续刷新issue-24)、[ADR-0023 修订](./docs/decisions/ADR-0023-multi-root-skill-discovery-and-invocation.md#4-生命周期缓存与撤销)）。
+
 ## [0.1.10] - 2026-10-25
 
 ### Added
@@ -181,7 +192,8 @@ English: [CHANGELOG.en.md](./CHANGELOG.en.md)
 
 - 发布前外部评审提出的 8 项发现（其中 3 项发布阻断）全部修复，每项各带一个回归测试：登记目录被替换为符号链接后授权转移（引入 `recordedPath`，**重新解析路径不等于重新授权**）、并发修改注册表丢写或复活已撤销的授权（每个主根的变更串行）、刷新不重新检查目录、手输路径被目录选择器覆盖、`reveal` 的应答契约与失败码、重复 id 未校验、主根未纳入嵌套校验、CI 先测后构建。
 
-[Unreleased]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.10...HEAD
+[Unreleased]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.11...HEAD
+[0.1.11]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.10...v0.1.11
 [0.1.10]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.9...v0.1.10
 [0.1.9]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/cherrchen/dsh-plugin-multi-root-workspace/compare/v0.1.7...v0.1.8

package/README.en.md

@@ -20,7 +20,7 @@ Not every project is a monorepo. A real development project is usually several i
 - **Additional-root Skills**: discovers `.dsh/skills` and `.agents/skills` inside additional folders, invoked through the namespaced `/alias-id:skill-name` reference and the native `skill` tool; each root has an independent toggle and editable `aliasId`, with a global setting that defaults to on.
 - **Absent when absent**: with no additional root configured, its behavior is item-for-item identical to an uninstalled harness; every misconfiguration fails loudly instead of silently degrading.
 
-Current released version: `v0.1.10`. The user-visible changes of each version live in the [CHANGELOG](./CHANGELOG.en.md); progress and release state live in the [roadmap progress ledger](./docs/plans/active/2026-09-12-multi-root-workspace.md#进度总账).
+Current released version: `v0.1.11`. The user-visible changes of each version live in the [CHANGELOG](./CHANGELOG.en.md); progress and release state live in the [roadmap progress ledger](./docs/plans/active/2026-09-12-multi-root-workspace.md#进度总账).
 
 ## Quick Start
 
@@ -49,11 +49,12 @@ The agent can now read, write, and run bash in that directory — the default is
 | `0.1.6` | `0.1.6-alpha.1`, `0.1.6-alpha.2` |
 | `0.1.7` | `0.1.7-alpha.1`, `0.1.7-alpha.2`, `0.1.7-rc.1`, `0.1.7-rc.2` |
 | `0.2.0` | `0.2.0-rc.1`, `0.2.0-rc.2` |
-| `0.2.1` | `0.2.1-alpha.1`, `0.2.1-alpha.2`, `0.2.1-alpha.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3` |
+| `0.2.1` | `0.2.1-alpha.1`, `0.2.1-alpha.2`, `0.2.1-alpha.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4` |
+| `0.2.2` | `0.2.2-alpha.2` |
 
 The plugin does not start — as if it were not installed — when the DSH release is not in the table or the `@deepseek-ai/dsh-*` packages disagree on a version.
 
-**Building from source / contributing**: Node.js `^22.19.0 || >=24`, pnpm `11.25.0` (enable via corepack); the dev-pinned DSH is `0.2.1-rc.3`.
+**Building from source / contributing**: Node.js `^22.19.0 || >=24`, pnpm `11.25.0` (enable via corepack); the dev-pinned DSH is `0.2.2-alpha.2` (Node ≥24.9).
 
 **Platforms**: macOS (Seatbelt), Linux (bwrap / Landlock), Windows (root-set ACL runner).
 
@@ -92,8 +93,8 @@ This installs pre-built artifacts; the first install needs the `allowBuilds` add
 ```sh
 pnpm pack @dsh-electron/dsh-plugin-multi-root-workspace
 # or download the tgz from the GitHub Release assets, e.g.:
-# https://github.com/cherrchen/dsh-plugin-multi-root-workspace/releases/download/v0.1.10/dsh-electron-dsh-plugin-multi-root-workspace-0.1.10.tgz
-dsh plugin --profile web add ./dsh-electron-dsh-plugin-multi-root-workspace-0.1.10.tgz
+# https://github.com/cherrchen/dsh-plugin-multi-root-workspace/releases/download/v0.1.11/dsh-electron-dsh-plugin-multi-root-workspace-0.1.11.tgz
+dsh plugin --profile web add ./dsh-electron-dsh-plugin-multi-root-workspace-0.1.11.tgz
 ```
 
 Also pre-built, handy for air-gapped or offline delivery; the first install needs the same `allowBuilds` addition.
@@ -112,10 +113,10 @@ allowBuilds:
   koffi: true
 ```
 
-Pinning a version (e.g. `#v0.1.10`) is recommended so a later push cannot silently change what actually runs:
+Pinning a version (e.g. `#v0.1.11`) is recommended so a later push cannot silently change what actually runs:
 
 ```sh
-dsh plugin --profile web add github:cherrchen/dsh-plugin-multi-root-workspace#v0.1.10
+dsh plugin --profile web add github:cherrchen/dsh-plugin-multi-root-workspace#v0.1.11
 ```
 
 ### Install from a local clone

package/README.md

@@ -20,7 +20,7 @@
 - **附属根 Skills**：发现附属目录的 `.dsh/skills` 与 `.agents/skills`，附属根经 `/alias-id:skill-name` 命名空间调用原生 `skill` 工具；每根独立开关、可编辑 `aliasId`，全局设置默认开启。
 - **不配等于没装**：未登记附加根时行为与未装插件逐项一致；配置错误一律明确报错，从不静默降级。
 
-当前发布版本 `v0.1.10`。各版本的用户可见变更见 [CHANGELOG](./CHANGELOG.md)；进度与发布状态见[路线图 §进度总账](./docs/plans/active/2026-09-12-multi-root-workspace.md#进度总账)。
+当前发布版本 `v0.1.11`。各版本的用户可见变更见 [CHANGELOG](./CHANGELOG.md)；进度与发布状态见[路线图 §进度总账](./docs/plans/active/2026-09-12-multi-root-workspace.md#进度总账)。
 
 ## 快速开始
 
@@ -51,11 +51,12 @@ tarball、GitHub、本地源码等其他安装方式见[安装](#安装)。
 | `0.1.6` | `0.1.6-alpha.1`、`0.1.6-alpha.2` |
 | `0.1.7` | `0.1.7-alpha.1`、`0.1.7-alpha.2`、`0.1.7-rc.1`、`0.1.7-rc.2` |
 | `0.2.0` | `0.2.0-rc.1`、`0.2.0-rc.2` |
-| `0.2.1` | `0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3` |
+| `0.2.1` | `0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` |
+| `0.2.2` | `0.2.2-alpha.2` |
 
 DSH 版本不在表内、或 `@deepseek-ai/dsh-*` 各包版本不一致时，插件不会启动，行为等同没装。
 
-**从源码构建 / 贡献**：Node.js `^22.19.0 || >=24`，pnpm `11.25.0`（建议经 corepack 启用）；开发 pin 的 DSH 为 `0.2.1-rc.3`。
+**从源码构建 / 贡献**：Node.js `^22.19.0 || >=24`，pnpm `11.25.0`（建议经 corepack 启用）；开发 pin 的 DSH 为 `0.2.2-alpha.2`（Node ≥24.9）。
 
 **运行平台**：macOS（Seatbelt）、Linux（bwrap / Landlock）、Windows（root-set ACL runner）。
 
@@ -94,8 +95,8 @@ dsh plugin --profile web add @dsh-electron/dsh-plugin-multi-root-workspace
 ```sh
 pnpm pack @dsh-electron/dsh-plugin-multi-root-workspace
 # 或从 GitHub Release 资产下载，例如：
-# https://github.com/cherrchen/dsh-plugin-multi-root-workspace/releases/download/v0.1.10/dsh-electron-dsh-plugin-multi-root-workspace-0.1.10.tgz
-dsh plugin --profile web add ./dsh-electron-dsh-plugin-multi-root-workspace-0.1.10.tgz
+# https://github.com/cherrchen/dsh-plugin-multi-root-workspace/releases/download/v0.1.11/dsh-electron-dsh-plugin-multi-root-workspace-0.1.11.tgz
+dsh plugin --profile web add ./dsh-electron-dsh-plugin-multi-root-workspace-0.1.11.tgz
 ```
 
 同样是预构建产物，适合内网或离线环境交付；首次安装同样需要添加 `allowBuilds`。
@@ -114,10 +115,10 @@ allowBuilds:
   koffi: true
 ```
 
-建议锁定版本（如 `#v0.1.10`），让后续推送无法悄悄改变实际运行的内容：
+建议锁定版本（如 `#v0.1.11`），让后续推送无法悄悄改变实际运行的内容：
 
 ```sh
-dsh plugin --profile web add github:cherrchen/dsh-plugin-multi-root-workspace#v0.1.10
+dsh plugin --profile web add github:cherrchen/dsh-plugin-multi-root-workspace#v0.1.11
 ```
 
 ### 从本地源码安装

package/lib/client.js

@@ -5986,7 +5986,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 
 /* ── files-tree fork (verbatim rules, renamed classes) ─────────────────────
    Copied from upstream's FilesBody.module.css (ui-sidebar-files @
-   0.2.1-alpha.2) with local names mapped to mrfw-ft* so the rules cannot
+   0.2.2-alpha.2) with local names mapped to mrfw-ft* so the rules cannot
    collide with host DOM — and so the fork's own body (which must NOT carry
    data-files-body) stays visible while the rules above hide the native one.
    The header-only rules (root/header/path/tool/status/statusLine/titleIcon)
@@ -6043,8 +6043,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   cursor: pointer;
 }
 
-.mrfw-ftRow:hover {
-  background: var(--dsw-alias-interactive-bg-hover);
+@media (hover: hover) {
+  .mrfw-ftRow:hover {
+    background: var(--dsw-alias-interactive-bg-hover);
+  }
 }
 
 /* The folder glyph rides the tertiary ink, as the workspace tree's does. */
@@ -6072,8 +6074,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   cursor: default;
 }
 
-.mrfw-ftOther:hover {
-  background: transparent;
+@media (hover: hover) {
+  .mrfw-ftOther:hover {
+    background: transparent;
+  }
 }
 
 .mrfw-ftNote {
@@ -6898,7 +6902,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* Named imports cannot spell both releases: each name is absent from the
 		* other release's declaration, so the compiler is told once, here.
 		*/
-		const installed$1 = _deepseek_ai_dsh_client_ui_primitives;
+		const installed$2 = _deepseek_ai_dsh_client_ui_primitives;
 		/**
 		* Pick the first export name this release actually provides.
 		* @param module - the icon module to read.
@@ -6921,7 +6925,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		*/
 		function maybeIcon(names) {
 			for (const name of names) {
-				const found = installed$1[name];
+				const found = installed$2[name];
 				if (found !== void 0) return found;
 			}
 		}
@@ -6936,7 +6940,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		}
 		/** Resolved once, against the installed module. */
 		function icon(pixelName, regularName) {
-			return selectIcon(installed$1, [pixelName, regularName]);
+			return selectIcon(installed$2, [pixelName, regularName]);
 		}
 		const IconChevronDown = icon("IconChevronDownOutline14", "IconChevronDownOutlineRegular");
 		const IconChevronUp = icon("IconChevronUpOutline14", "IconChevronUpOutlineRegular");
@@ -6953,7 +6957,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const IconAccessReadOnly = maybeIcon(["PermissionIconReadOnlyRegular", "IconReadOnlyRegular"]);
 		const IconAccessInherit = maybeIcon(["IconWorkspaceTreeOutline16", "IconWorkspaceTreeOutlineRegular"]);
 		//#endregion
-		//#region node_modules/.pnpm/@deepseek-ai+dsh-typert-protocol@0.2.1-rc.3_@deepseek-ai+cordis@4.0.5/node_modules/@deepseek-ai/dsh-typert-protocol/lib/index.js
+		//#region node_modules/.pnpm/@deepseek-ai+dsh-typert-protocol@0.2.2-alpha.2_@deepseek-ai+cordis@4.0.6-alpha.1/node_modules/@deepseek-ai/dsh-typert-protocol/lib/index.js
 		/** The one Remote failure class shared by owners, the Gateway, and consumers. */
 		/**
 		* One Remote call failure: a real Error carrying its stable code and typed
@@ -7463,7 +7467,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return n;
 		}
 		//#endregion
-		//#region node_modules/.pnpm/@deepseek-ai+dsh-util-workspace-path@0.2.1-rc.3_@deepseek-ai+cordis@4.0.5/node_modules/@deepseek-ai/dsh-util-workspace-path/lib/index.js
+		//#region node_modules/.pnpm/@deepseek-ai+dsh-util-workspace-path@0.2.2-alpha.2_@deepseek-ai+cordis@4.0.6-alpha.1/node_modules/@deepseek-ai/dsh-util-workspace-path/lib/index.js
 		/**
 		* The `dsh-resource://file/…` address grammar: how a file is named across the
 		* Sidebar and the resource model, built and parsed without touching a
@@ -7885,7 +7889,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			};
 		}
 		//#endregion
-		//#region node_modules/.pnpm/@deepseek-ai+dsh-host-open-in-app@0.2.1-rc.3_@deepseek-ai+cordis@4.0.5_@deepseek-ai+dsh_5b371ee77d0b761177ea40ae8a5dc767/node_modules/@deepseek-ai/dsh-host-open-in-app/lib/types/shared.js
+		//#region node_modules/.pnpm/@deepseek-ai+dsh-host-open-in-app@0.2.2-alpha.2_@deepseek-ai+cordis@4.0.6-alpha.1_@deep_d76f08f4e35ff3a756a48d7d013379f6/node_modules/@deepseek-ai/dsh-host-open-in-app/lib/types/shared.js
 		var shared_exports = /* @__PURE__ */ __exportAll({
 			OPEN_IN_APP_APPS_PATH: () => OPEN_IN_APP_APPS_PATH,
 			OPEN_IN_APP_APPS_ROUTE: () => OPEN_IN_APP_APPS_ROUTE,
@@ -7941,7 +7945,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* Named imports cannot spell both eras: each name is absent from the other
 		* era's declaration, so the compiler is told once, here.
 		*/
-		const installed = shared_exports;
+		const installed$1 = shared_exports;
 		/**
 		* Pick the first export name this release actually provides.
 		* @param module - the shared module to read.
@@ -7963,7 +7967,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* `iconUrl` on runtimes whose glyph gate already passed, and on the pixel era
 		* the absolute form is exactly what upstream's own client fetched.
 		*/
-		const OPEN_IN_APP_ICON_URL_PREFIX = selectSharedRoute(installed, ["OPEN_IN_APP_ICON_PREFIX_ROUTE", "OPEN_IN_APP_ICON_PREFIX"]);
+		const OPEN_IN_APP_ICON_URL_PREFIX = selectSharedRoute(installed$1, ["OPEN_IN_APP_ICON_PREFIX_ROUTE", "OPEN_IN_APP_ICON_PREFIX"]);
 		//#endregion
 		//#region src/client/open-in-app/applications.ts
 		/** Label keys for applications supported by this client. */
@@ -8059,10 +8063,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			* @param appId - catalog id from the availability list.
 			* @param path - the session's absolute workspace directory.
 			* Concurrent gestures are ignored until the current Host request settles.
-			* @returns after the host acknowledged the launch; rejects on any failure.
+			* @returns the acknowledged handoff, or `{ kind: 'skipped' }` while another
+			* launch holds the operation, or a named failure when the Host refuses or
+			* cannot be reached. Host and transport failures resolve without rejecting.
 			*/
 			async launch(appId, path) {
-				if (this.operation.getSnapshot().phase === "busy") return;
+				if (this.operation.getSnapshot().phase === "busy") return { kind: "skipped" };
 				this.operation.set({
 					phase: "busy",
 					path
@@ -8082,12 +8088,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						phase: "idle",
 						path
 					});
-				} catch (error) {
+					return { kind: "opened" };
+				} catch (_error) {
 					this.operation.set({
 						phase: "error",
 						path
 					});
-					throw error;
+					return {
+						kind: "failed",
+						failure: "openError"
+					};
 				}
 			}
 			async run() {
@@ -8107,36 +8117,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		/** Dictionary namespace owned by upstream's plugin (verbatim). */
 		const NS = "open-in-app";
 		//#endregion
-		//#region src/client/open-in-app/open-failure-toast.tsx
-		/** Per-control failure banner for path gestures. */
-		/**
-		* Transient failure banner owned by the control that initiated the gesture,
-		* so one failed request announces once, from the control the user pressed.
-		* @returns `toast` owned by the control and `show` to announce one
-		* failure with resolved copy; announcing again replays the banner.
-		*/
-		function useOpenFailureToast() {
-			const seq = (0, react.useRef)(0);
-			const [banner, setBanner] = (0, react.useState)(null);
-			const dismiss = (0, react.useCallback)(() => {
-				setBanner(null);
-			}, []);
-			return {
-				toast: banner === null ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Toast, {
-					text: banner.text,
-					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutlineRegular, {}),
-					onDone: dismiss
-				}, banner.seq),
-				show: (text) => {
-					seq.current += 1;
-					setBanner({
-						seq: seq.current,
-						text
-					});
-				}
-			};
-		}
-		//#endregion
 		//#region src/client/open-in-app/OpenTargetButton.module.css.ts
 		/**
 		* Fork-facing shim for upstream `OpenTargetButton.module.css`.
@@ -8168,27 +8148,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		};
 		//#endregion
 		//#region src/client/open-in-app/OpenTargetButton.tsx
-		/** Shared file and directory opener: one default action, application menu, and per-gesture feedback. */
+		/** Shared file and directory opener: one default action, application menu, and one reported outcome per gesture. */
 		/**
-		* Serialize gestures and announce their failures through the initiating control's toast.
-		* @param execute - target adapter that returns the failure to announce, or null.
-		* @param t - localized control copy.
-		* @returns the pending state, feedback, and guarded action callback.
+		* Serialize gestures and report the outcome each one settles on to the app-wide
+		* announcer, which outlives this control and the panel holding it.
+		* @param execute - target adapter that settles on the gesture's outcome.
+		* @param report - announcement seat the settled outcome is sent to.
+		* @returns the pending state and the guarded action callback.
 		*/
-		function useOpenTargetGesture(execute, t) {
+		function useOpenTargetGesture(execute, report) {
 			const [pending, setPending] = (0, react.useState)(false);
 			const inFlight = (0, react.useRef)(false);
-			const { toast, show } = useOpenFailureToast();
 			return {
 				pending,
-				toast,
 				act: (operation) => {
 					if (inFlight.current) return;
 					inFlight.current = true;
 					setPending(true);
-					execute(operation).then((failure) => {
-						if (failure !== null) show(t(`path.${failure}`));
-					}).finally(() => {
+					execute(operation).then(report).finally(() => {
 						inFlight.current = false;
 						setPending(false);
 					});
@@ -8214,12 +8191,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* Render identical split buttons for files and directories. File reveal always
 		* stays last; it is the default only when no application is registered.
 		* @param props - target applications, default selection, and operations.
-		* @returns the control and its transient failure feedback.
+		* @returns the control alone: its settled outcomes are announced by the seat it reports to.
 		*/
 		function OpenTargetButton(props) {
 			const { applications, defaultId, kind, t } = props;
 			const [menuOpen, setMenuOpen] = (0, react.useState)(false);
-			const { pending, toast, act } = useOpenTargetGesture(props.execute, t);
+			const { pending, act } = useOpenTargetGesture(props.execute, props.report);
 			const preferred = kind === "file" ? applications.find((app) => app.id === defaultId) ?? applications[0] : applications.find((app) => app.id === defaultId);
 			const disabled = pending || props.busy === true || props.loading === true;
 			const hasMenu = props.loading === true || props.failed || applications.length + (kind === "file" ? 1 : 0) > 1;
@@ -8255,7 +8232,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				source: preferred?.icon ?? null,
 				size: props.prominent ? 18 : 13
 			}, preferred?.icon);
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
 				className: css.menuAnchor,
 				open: menuOpen && !disabled && hasMenu,
 				autoFocus: true,
@@ -8323,13 +8300,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular, { size: props.prominent ? 14 : 10 })
 					})]
 				})
-			}), toast] });
+			});
 		}
 		//#endregion
 		//#region src/client/open-in-app/OpenInAppAction.tsx
 		/**
 		* Adapt the installed directory catalog to the shared opening control.
-		* @param props - displayed directory, installed catalog, and launch operations.
+		* @param props - displayed directory, installed catalog, launch operations, and the announcement seat.
 		* @returns the shared control, or null without an eligible application.
 		*/
 		function OpenInAppAction(props) {
@@ -8356,19 +8333,101 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				t,
 				busy: operation.phase === "busy",
 				shortcut,
+				report: props.report,
 				execute: async (operation) => {
 					const id = operation.kind === "application" ? operation.id : preferred.id;
-					try {
-						await props.launch(id, absolutePath);
-					} catch (_error) {
-						return "openError";
-					}
-					if (operation.kind === "application") props.choose(id);
-					return null;
+					const outcome = await props.launch(id, absolutePath);
+					if (outcome.kind === "opened" && operation.kind === "application") props.choose(id);
+					return outcome;
 				}
 			}, absolutePath);
 		}
 		//#endregion
+		//#region src/compat/open-in-app-device.ts
+		/**
+		* Compatibility adapter for `isMobileDevice` from
+		* `@deepseek-ai/dsh-client-ui-primitives`.
+		*
+		* ```text
+		* 0.1.5-rc.2 through 0.2.1-rc.4   no `isMobileDevice` export
+		* 0.2.2-alpha.2 +                 `isMobileDevice` exported
+		* ```
+		*
+		* The open-in-app fork's verbatim `open-toast.tsx` spells the detector as a
+		* primitives import — a name absent before `0.2.2-alpha.2` — so the lookup
+		* is by export name, not by release string (the `client-icons.ts` pattern).
+		* An older runtime falls back to upstream's identical detection: mobile
+		* userAgent, or a touch-capable MacIntel platform, memoized like upstream's.
+		*
+		* @module @dsh-electron/dsh-plugin-multi-root-workspace/compat/open-in-app-device
+		*/
+		/** The primitives module, addressed by export name. */
+		const installed = _deepseek_ai_dsh_client_ui_primitives;
+		/** Upstream's own detector when the installed release carries it (verbatim logic below otherwise). */
+		const upstream = typeof installed.isMobileDevice === "function" ? installed.isMobileDevice : void 0;
+		let fallbackResult;
+		/**
+		* Whether this browser is a mobile device — upstream's detection verbatim.
+		* @returns true for a mobile userAgent or a touch-capable macOS surface.
+		*/
+		function isMobileDeviceFallback() {
+			fallbackResult ??= /Android|iPhone|iPad|iPod/i.test(navigator.userAgent) || navigator.platform === "MacIntel" && navigator.maxTouchPoints > 1;
+			return fallbackResult;
+		}
+		/**
+		* Resolve the installed release's `isMobileDevice`, or the identical local
+		* fallback on releases that predate the export.
+		* @returns the mobile-device verdict.
+		*/
+		function isMobileDevice() {
+			return upstream === void 0 ? isMobileDeviceFallback() : upstream();
+		}
+		//#endregion
+		//#region src/client/open-in-app/open-toast.tsx
+		/**
+		* Create the one outcome store the overlay entry shows.
+		* @returns the observable notice with its report and dismiss actions.
+		*/
+		function createOpenInAppToastSource() {
+			const store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)(null);
+			let seq = 0;
+			return {
+				hooks: { toast: store },
+				report: (outcome) => {
+					if (outcome.kind === "skipped") return;
+					if (outcome.kind !== "failed" && !isMobileDevice()) return;
+					seq += 1;
+					store.set({
+						...outcome,
+						seq
+					});
+				},
+				dismiss: () => {
+					store.set(null);
+				}
+			};
+		}
+		/**
+		* Render a mobile handoff confirmation or a native-open failure.
+		* @param props - the notice hook, its dismissal, and the locale seat.
+		* @returns the banner on display, or null.
+		*/
+		function OpenInAppToast({ useToast, dismiss, t }) {
+			const toast = useToast((current) => current);
+			if (toast === null) return null;
+			const key = `open-in-app-${String(toast.seq)}`;
+			if (toast.kind === "failed") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Toast, {
+				text: t(toast.failure === "revealError" ? "path.revealError" : "path.openError"),
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutlineRegular, {}),
+				onDone: dismiss
+			}, key);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Toast, {
+				text: t(toast.kind === "opened" ? "path.opened" : "path.revealed"),
+				tone: "success",
+				onDone: dismiss
+			}, key);
+		}
+		//#endregion
 		//#region src/client/open-in-app/adapter.tsx
 		/**
 		* The plugin-owned wiring around the verbatim open-in-app fork.
@@ -8433,17 +8492,22 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			if (!REQUIRED_GLYPHS.every((name) => maybeIcon([name]) !== void 0)) return void 0;
 			const controller = new OpenInAppController();
 			controller.load();
+			const toast = createOpenInAppToastSource();
 			return {
-				useOpenInAppApps: bindSnapshot(controller.apps),
-				useOpenInAppChoice: bindSnapshot(controller.choice),
-				useOpenInAppLaunch: bindSnapshot(controller.operation),
-				useShortcuts: bindSnapshot(deps.shortcuts ?? NO_SHORTCUTS),
-				launch: (appId, path) => controller.launch(appId, path),
-				choose: (appId) => {
-					controller.choose(appId);
-				},
-				iconUrl: (appId) => `${OPEN_IN_APP_ICON_URL_PREFIX}/${appId}`,
-				t: deps.t
+				toast,
+				adapter: {
+					useOpenInAppApps: bindSnapshot(controller.apps),
+					useOpenInAppChoice: bindSnapshot(controller.choice),
+					useOpenInAppLaunch: bindSnapshot(controller.operation),
+					useShortcuts: bindSnapshot(deps.shortcuts ?? NO_SHORTCUTS),
+					launch: (appId, path) => controller.launch(appId, path),
+					report: toast.report,
+					choose: (appId) => {
+						controller.choose(appId);
+					},
+					iconUrl: (appId) => `${OPEN_IN_APP_ICON_URL_PREFIX}/${appId}`,
+					t: deps.t
+				}
 			};
 		}
 		//#endregion
@@ -9747,6 +9811,18 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				t: ctx.locale.bind(NS),
 				shortcuts: readService(ctx, "shortcuts")?.catalog
 			});
+			if (openInApp !== void 0) {
+				const { toast } = openInApp;
+				ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+					name: "shell.overlay",
+					id: "multi-root-open-in-app.toast",
+					locale: NS,
+					inject: () => ({
+						hooks: toast.hooks,
+						dismiss: toast.dismiss
+					})
+				}, OpenInAppToast));
+			}
 			const filesTreeSeats = createFilesTreeSeats(ctx);
 			const filesTreeT = ctx.locale.bind(NS$1);
 			ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
@@ -9790,7 +9866,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					sessionId: paneSessionId,
 					subscribeSession,
 					t,
-					openInApp,
+					openInApp: openInApp?.adapter,
 					filesTree
 				});
 			}));