dsh-vscode-mode 0.14.3 → 0.14.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.14.3",
+  "version": "0.14.5",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车，界面状态（页签/光标/侧栏/编辑 Tab/导航历史）镜像到 DSH home 跨重启恢复",
   "icon": "assets/icon.svg",
   "keywords": [
@@ -48,12 +48,12 @@
     "@vscode/ripgrep": "^1.18.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1",
-    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1",
-    "@deepseek-ai/dsh-llm": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1",
-    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1 || =0.2.0-rc.2",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1 || =0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1 || =0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1 || =0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1 || =0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0 || >=0.1.7-0 <0.2.0-0 || =0.2.0-rc.1 || =0.2.0-rc.2",
     "cordis": ">=4.0.0-rc <5",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",

package/skills/dsh-vscodemode-mcp/SKILL.md

@@ -29,6 +29,10 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 
 禁用、删除、配置变更、刷新重连及 agent/插件卸载都会释放相应 fiber 和连接。仅刷新未变化的项目列表不会重复连接。主机代码更新需要重启 DSH 才能加载新实现。
 
+管理页首次加载配置，之后仅在 MCP 页签可见且文档可见时每 2.5 秒读取 `mcp.snapshot`；单次读取 10 秒截止，不重叠、不在卸载后回写。快照只读运行台账，不读项目文件、不 reconcile、不额外建连。外部文件变更通过显式刷新/重新打开设置或新 agent 加载；快照不是文件监听器。配置写操作串行保护读取—修改—写入与跨作用域命名保留。
+
+表单 stdio 参数采用 JSON `string[]` 或每行一个完整参数，不按空格/引号做 shell 拆分；含空参数或内嵌换行使用 JSON。HTTP 请求头每行 `key=value`，保留值内的等号，拒绝非法/重复（忽略大小写）键。失败保存保持表单，忙时禁止重复动作。
+
 ## 3. 项目配置
 
 `.mcp.json` 示例：
@@ -57,7 +61,7 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 - `disabled: true` 保持配置但不创建连接；保存表单会恢复启用。重启和 reconcile 都尊重 `disabled`。
 - 保存保留文档顶层、其他服务器及当前服务器的未知字段和未编辑高级参数；切换传输方式会移除旧传输专属字段。
 - `env` / `headers` 在返回值中使用 `••••••` 脱敏。原键的未修改掩码保存时恢复真实值；新键只有掩码而没有原值时会拒绝保存，需填写凭据。
-- 只有 `ENOENT` 表示配置不存在。权限、IO、JSON 或结构错误会报告 `fileError`，保留最后有效配置与活动连接，不覆盖损坏文件。
+- 配置不存在只认结构化错误码：官方 fs 的 `FS_NOT_FOUND` 与兼容旧后端的 `ENOENT`；缺失的可选配置按空服务处理，不写空文件，不阻断其他项目的重名检查。权限、IO、JSON 或结构错误会报告 `fileError`，保留最后有效配置与活动连接，不覆盖损坏文件。
 
 全局配置继续使用官方 loader entry：
 
@@ -80,6 +84,7 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 | 方法 | 入参 | 成功返回字段 |
 |---|---|---|
 | `mcp.list` | `{}` | `servers` |
+| `mcp.snapshot` | `{}` | `servers`, `projects`（只读运行快照） |
 | `mcp.save` | `{ config }` | `server` |
 | `mcp.remove` | `{ id }` | 无 |
 | `mcp.toggle` | `{ id, enabled }` | `server` |
@@ -97,6 +102,7 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 - `serverName` 使用 `/^[A-Za-z0-9_-]{1,32}$/`；允许下划线，与技能名规则不同。
 - VSCodeMode 管理的全局和所有项目配置之间名称唯一，包括未启用和没有活动 agent 的配置。官方 MCP 还会拒绝同一个 agent scope 中的重复名称。
 - 工具名是 `mcp__<serverName>__<原始工具名>`。共享资源工具通过 `arguments.server` 选择服务器。
+- 不同服务名称不得以 `__` 形成前缀交叠，例如 `alpha` 与 `alpha__nested`：原始工具名也允许 `__`，官方编码不能唯一反解，不能靠最长前缀猜归属。保存与 reconcile 双向检查全局/所有项目（含禁用项）；历史歧义工具执行时 fail-closed 且不计入任何服务。独立含 `__` 的名称仍合法。
 - 项目稳定 id 仍是 `vsm-mcp.<workspaceHash>.<serverName>`，用于 UI/RPC 身份；0.13 起不再代表全局 loader entry。
 - 启动迁移会先删除旧的 `vsm-mcp.*` 和 `vsm-mcp:*` 全局项目条目及其连接，再在 agent scope 挂载。不要手动将项目条目改成其他 id。
 - 项目写操作只接受已注册 workspace，目标固定为该根目录的 `.mcp.json`。
@@ -120,10 +126,10 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 
 | 状态/现象 | 含义与处理 |
 |---|---|
-| `configured` | 配置已保存，没有已挂载实例；打开匹配工作区会话后挂载 |
+| `configured` | 中性色；配置已保存，没有已挂载实例，打开匹配工作区会话后挂载 |
 | `disabled` | 配置已停用，不建立项目连接 |
 | `connecting` | 官方插件还在等待启动完成；检查命令、cwd、URL 和握手 |
-| `unverified` | fiber 已激活，但官方没有公开连接状态证据；不能宣称已连接 |
+| `unverified` | 中性色；fiber 已激活，但官方没有公开连接状态证据，不能宣称已连接；右侧绿色开关只表示启用 |
 | `error` | 插件启动或挂载失败；读 `error` 与 Host 日志 |
 | `instanceCount: N` | N 个挂载的官方插件 fiber，**不等于 N 个确认存活的网络连接** |
 | `toolCount: 0` | 可能是合法的纯资源服务器，也可能启动失败或工具同步失败；结合资源调用和日志判断 |

package/src/client/diffDockStore.ts

@@ -18,15 +18,20 @@ export interface DiffDockSnapshot {
 }
 
 /**
- * 判断编辑器差异栏应显示在指定布局，空态仅在尚有差异文件时显示。
- * @author ddj 2026年09月29号
+ * 指定布局仅在仍有待处理差异时显示差异栏，冲突差异和其他文件差异也保留入口。
+ * @public
+ * @author ddj 2026年10月08号
  * @param snapshot 编辑器发布的差异快照
  * @param layout 目标布局
  * @returns 是否显示差异栏
  */
 export function dockInLayout(snapshot: DiffDockSnapshot | null, layout: 'side' | 'tab'): boolean {
   if (!snapshot || (snapshot.layout ?? 'tab') !== layout) return false
-  return snapshot.mode !== 'editor-empty' || Boolean(snapshot.fileTotal)
+  return Number(snapshot.fileTotal) > 0
+    || Number(snapshot.allPendingCount) > 0
+    || Number(snapshot.diffTotal) > 0
+    || (Array.isArray(snapshot.pendingRegions) && snapshot.pendingRegions.length > 0)
+    || (Array.isArray(snapshot.staleRegions) && snapshot.staleRegions.length > 0)
 }
 
 type DiffDockListener = () => void

package/src/client/index.ts

@@ -64,6 +64,7 @@ import { disposeSnippets } from './snippets/provider.js'
 import { disposeLaunchJson } from './dap/launchSnippetProvider.js'
 import { disposeAiInline } from './ai/inlineProvider.js'
 import { readSessionScope, subscribeScope } from './sessionScope.js'
+import { installPlanBridge } from './planBridge.js'
 import { flushUiState, hydrateUiState, installUiStatePersist, onUiStateReady, reportUiStateEvent, uiStateSettled } from './state/uiStatePersist.js'
 import { workspaceScopeOf } from './state/scopeStore.js'
 import { dapStore } from './dap/store.js'
@@ -188,6 +189,7 @@ export async function apply(ctx: any): Promise<void> {
   const registry: FileOpenerRegistry = createFileOpenerRegistry()
   const workspaces = ctx.get('workspaces')
   const sessions = ctx.get('sessions')
+  ctx.effect(() => installPlanBridge(ctx, schedule), 'vscode-mode: plan integration')
 
   // 外部深链落地：Windows 右键菜单 / Unity 外部编辑器 → 浏览器 URL 参数 → 打开规则路由
   ctx.effect(() => setupExtOpen(ctx), 'vscode-mode: external open')

package/src/client/mcpForm.ts

@@ -0,0 +1,79 @@
+import type { MpcConfig } from '../shared/mcp.js'
+
+export interface McpDraft {
+  serverName: string
+  transport: 'stdio' | 'streamable-http'
+  command: string
+  args: string
+  cwd: string
+  url: string
+  headers: string
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月08号
+ * @description Parse lossless JSON string[] or one literal argument per nonempty line; no shell splitting.
+ * @param text Argument field.
+ * @returns Literal argument vector.
+ * @throws Invalid JSON or a non-string array element.
+ */
+export function parseArgs(text: string): string[] {
+  if (text.trimStart().startsWith('[')) {
+    let value: unknown
+    try { value = JSON.parse(text) } catch { throw new Error('参数 JSON 无效，请输入 string[] 或每行一个参数') }
+    if (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) {
+      throw new Error('参数 JSON 必须是 string[]')
+    }
+    return value
+  }
+  return text.split(/\r?\n/).filter((line) => line.length > 0)
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月08号
+ * @description Validate HTTP headers; duplicates are case-insensitive and values retain embedded equals.
+ * @param text One key=value header per line.
+ * @returns Validated header dictionary.
+ * @throws Missing separator, invalid/empty key, duplicate key, or illegal control characters.
+ */
+export function parsePairs(text: string): Record<string, string> {
+  const pairs: Array<[string, string]> = []
+  const keys = new Set<string>()
+  for (const [index, raw] of text.split(/\r?\n/).entries()) {
+    if (!raw.trim()) continue
+    const separator = raw.indexOf('=')
+    const key = raw.slice(0, separator).trim()
+    const value = raw.slice(separator + 1).trim()
+    if (separator < 1 || !/^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/.test(key) || /[\x00-\x08\x0a-\x1f\x7f]/.test(value)) {
+      throw new Error('请求头第 ' + (index + 1) + ' 行格式错误，应为有效 key=value')
+    }
+    const normalized = key.toLowerCase()
+    if (keys.has(normalized)) throw new Error('请求头重复：' + key)
+    keys.add(normalized)
+    pairs.push([key, value])
+  }
+  return Object.fromEntries(pairs)
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月08号
+ * @description Convert a form draft without losing argument boundaries or silently accepting malformed headers.
+ * @param draft Current editable fields.
+ * @returns Host MCP configuration.
+ * @throws Argument/header validation errors; callers must keep the form open.
+ */
+export function configOf(draft: McpDraft): MpcConfig {
+  const config: MpcConfig = { serverName: draft.serverName.trim(), transport: draft.transport }
+  if (draft.transport === 'stdio') {
+    config.command = draft.command.trim()
+    config.args = parseArgs(draft.args)
+    if (draft.cwd.trim()) config.cwd = draft.cwd.trim()
+  } else {
+    config.url = draft.url.trim()
+    config.headers = parsePairs(draft.headers)
+  }
+  return config
+}

package/src/client/mcpState.ts

@@ -0,0 +1,179 @@
+import type { MpcProject, MpcServer } from '../shared/mcp.js'
+import type { rpc } from './rpc.js'
+
+export interface McpView {
+  servers: MpcServer[]
+  projects: MpcProject[]
+  loading: boolean
+  busy: string
+  error: string
+}
+interface McpTiming { interval?: number; timeout?: number }
+interface ReadToken { controller: AbortController; version: number; timer: ReturnType<typeof setTimeout> }
+type Result = { ok: boolean; error?: string }
+
+/** Owns MCP read lifetimes and one synchronous mutation lock for the entire management page. */
+export class McpState {
+  readonly view: McpView = { servers: [], projects: [], loading: true, busy: '', error: '' }
+  private active = false
+  private visible = true
+  private disposed = false
+  private version = 0
+  private reading: ReadToken | null = null
+  private timer: ReturnType<typeof setTimeout> | null = null
+  private readonly interval: number
+  private readonly timeout: number
+
+  /** @public @author ddj 2026年10月08号 @param request Typed RPC transport. @param changed View notification. @param timing Bounded read and polling timings. */
+  constructor(private readonly request: typeof rpc, private readonly changed: (view: McpView) => void, timing: McpTiming = {}) {
+    this.interval = Math.max(100, timing.interval ?? 2500)
+    this.timeout = Math.max(50, timing.timeout ?? 10000)
+  }
+
+  //region Read lifecycle
+  /** @private @author ddj 2026年10月08号 @description Publish a copied view only while mounted. */
+  private emit(): void {
+    if (!this.disposed) this.changed({ ...this.view })
+  }
+
+  /** @private @author ddj 2026年10月08号 @description Cancel scheduled reads and invalidate every older response. */
+  private invalidate(): void {
+    this.version++
+    if (this.timer !== null) clearTimeout(this.timer)
+    this.timer = null
+    this.reading?.controller.abort()
+  }
+
+  /** @private @author ddj 2026年10月08号 @description Schedule a single read only after the preceding transport settled. */
+  private schedule(): void {
+    if (this.disposed || !this.active || !this.visible || this.reading || this.view.loading || this.view.busy || this.timer !== null) return
+    this.timer = setTimeout(this.poll, this.interval)
+  }
+
+  /** @private @author ddj 2026年10月08号 @description Timer entry, with failures handled in read. */
+  private poll = (): void => {
+    this.timer = null
+    void this.read(false)
+  }
+
+  /** @private @author ddj 2026年10月08号 @returns Versioned read token with an abort deadline. */
+  private beginRead(): ReadToken {
+    const controller = new AbortController()
+    const version = this.version
+    /** @author ddj 2026年10月08号 @description Abort timed-out transport and invalidate its eventual response. */
+    const expire = (): void => {
+      controller.abort()
+      if (this.disposed || version !== this.version) return
+      this.version++
+      this.view.loading = false
+      this.view.error = '读取 MCP 状态超时'
+      this.emit()
+    }
+    const token = { controller, version, timer: setTimeout(expire, this.timeout) }
+    this.reading = token
+    return token
+  }
+
+  /** @private @author ddj 2026年10月08号 @param initial Initialization versus read-only polling. @param signal Abort deadline. @returns Complete settled data, never an early half-settled initial read. @throws Transport or host failures. */
+  private async fetchData(initial: boolean, signal: AbortSignal): Promise<Pick<McpView, 'servers' | 'projects'>> {
+    if (!initial) {
+      const snapshot = await this.request('mcp.snapshot', {}, signal)
+      if (!snapshot.ok) throw new Error(snapshot.error)
+      return snapshot
+    }
+    const [list, groups] = await Promise.allSettled([this.request('mcp.list', {}, signal), this.request('mcp.projects', {}, signal)])
+    if (list.status === 'rejected') throw list.reason
+    if (groups.status === 'rejected') throw groups.reason
+    if (!list.value.ok) throw new Error(list.value.error)
+    if (!groups.value.ok) throw new Error(groups.value.error)
+    return { servers: list.value.servers, projects: groups.value.projects }
+  }
+
+  /** @private @author ddj 2026年10月08号 @param initial Use legacy initialization RPCs once; later polls are read-only snapshots. @returns Completion after transport settles; aborted results never publish. */
+  private async read(initial: boolean): Promise<void> {
+    if (this.disposed || this.reading || this.view.busy) return
+    if (!initial && (!this.active || !this.visible)) return
+    const token = this.beginRead()
+    try {
+      const signal = token.controller.signal
+      const { servers, projects } = await this.fetchData(initial, signal)
+      if (!this.disposed && token.version === this.version && !signal.aborted) {
+        this.view.servers = servers
+        this.view.projects = projects
+        this.view.error = ''
+      }
+    } catch (error) {
+      if (!this.disposed && token.version === this.version && !token.controller.signal.aborted) this.view.error = String(error)
+    } finally {
+      clearTimeout(token.timer)
+      this.reading = null
+      if (!this.disposed) {
+        this.view.loading = false
+        this.emit()
+        this.schedule()
+      }
+    }
+  }
+
+  /** @public @author ddj 2026年10月08号 @description Initialize list/projects once per mounted page. @returns Load completion. */
+  load(): Promise<void> { return this.read(true) }
+
+  /** @public @author ddj 2026年10月08号 @param active Whether the top-level MCP tab is selected. */
+  setActive(active: boolean): void {
+    if (this.active === active) return
+    this.active = active
+    if (!active) this.invalidate()
+    this.schedule()
+  }
+
+  /** @public @author ddj 2026年10月08号 @param visible Whether document visibility permits background requests. */
+  setVisible(visible: boolean): void {
+    if (this.visible === visible) return
+    this.visible = visible
+    if (!visible) this.invalidate()
+    this.schedule()
+  }
+
+  /** @public @author ddj 2026年10月08号 @description Stop timers and invalidate all responses on unmount. */
+  dispose(): void {
+    this.disposed = true
+    this.invalidate()
+    if (this.reading) clearTimeout(this.reading.timer)
+  }
+  //endregion
+
+  //region Serialized mutations
+  /**
+   * @public
+   * @author ddj 2026年10月08号
+   * @description Acquire a synchronous page-wide lock before validation/RPC. Duplicate actions are rejected; failed saves never call commit.
+   * @param label Busy indicator key.
+   * @param task Validation and RPC work, including synchronous configuration errors.
+   * @param commit Apply successful result; may reset and close a save form.
+   * @returns Whether this mutation committed successfully while mounted.
+   */
+  async mutate<T extends Result>(label: string, task: () => Promise<T>, commit: (result: T) => void): Promise<boolean> {
+    if (this.disposed || this.view.busy) return false
+    this.invalidate()
+    this.view.busy = label
+    this.view.error = ''
+    this.emit()
+    try {
+      const result = await task()
+      if (!result.ok) throw new Error(result.error)
+      if (this.disposed) return false
+      commit(result)
+      return true
+    } catch (error) {
+      if (!this.disposed) this.view.error = String(error)
+      return false
+    } finally {
+      if (!this.disposed) {
+        this.view.busy = ''
+        this.emit()
+        this.schedule()
+      }
+    }
+  }
+  //endregion
+}