iterate-plugin 3.14.0 → 3.15.0

package/README.md

@@ -115,6 +115,7 @@ Both modes share:
 - **SettingsPanel** (`settings.section`) — theme toggle, triage-persistence notes, config-management guide (covers `validation.commands` / `language` / `personalization.known_intentional` with an explicit "empty validation.commands = unprotected" warning; a field picker generates the matching `iterate_config write` instruction), **v3.7: a 回读当前配置 (read back current config) button that closes the write → read-back loop** — it copies an `iterate_config read` instruction and, once the model echoes the result into the session, shows the current value of the selected field, runtime status overview (artifact layout + view/cleanup tool guide + disk-snapshot pull), one-click triage data reset.
 - **Bilingual UI (v3.7)** — every piece of UI chrome (panels, empty states, tabs, badges, settings, stop-reason and completion labels) ships in 简体中文 and English. Pick the language under **Settings → 界面语言 / Interface language**; the choice persists in `localStorage` (`iterate-ui-lang`) and otherwise auto-detects from `navigator.language` (a stored choice always wins, and auto-detection never writes a preference). **Model-facing copy deliberately stays Chinese** — the `build*Instruction` payloads and the copy-paste guides are contract text mirroring `SKILL.md`, so the two expanded guides carry a 「中文（粘贴给模型的契约文案）」 chip instead of looking like a missed translation.
 - **Right-click menu (v3.14, dsh ≥ 0.2.2-alpha.3)** — the iterate entry points now also hang off the **native unified context menus**: right-click a **Session** in the sidebar to `打开 iterate 质量指挥中心` (expands the docked observatory and jumps to the live stream), copy the preflight / dry-run / checkpoint-resume / disk-snapshot instructions, or right-click a **file** (with line) / **directory** to copy a *scoped* dry-run review instruction. Bilingual labels, copy-failure recovery guidance, and a shared success toast; a host without `contextMenus` degrades to no menu items (the docked panel remains the entry point).
+- **Keyboard shortcut (v3.15, dsh ≥ 0.2.2-rc.1)** — the iterate command center is now one keystroke away: **Cmd/Ctrl+Shift+O** opens the docked observatory from anywhere in a session (dsh's new unified keyboard-command capability). The shortcut is registered on dsh's `shortcuts` service with the same command id the right-click "open command center" action carries, so the context menu shows the live keycap and dsh's own shortcut settings page lists it as an editable binding. A host that predates the `shortcuts` service degrades to no keyboard command (the docked panel and the context menu remain the entry points); a conflicting default binding is logged and skipped rather than breaking the plugin.
 
 The UI layer is **defensive by design**: it degrades gracefully if any of `slots` / `theme` / `React` is unavailable — it never crashes the client.
 
@@ -348,12 +349,12 @@ All runtime state lives under `.iterate/` at the project root (can be excluded v
   `0.2.0-rc.2`, `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.1-rc.5`, `0.2.2-alpha.2`,
-  `0.2.2-alpha.3` (29 releases, `0.1.1-rc.1` … `0.2.2-alpha.3`).
+  `0.2.2-alpha.3`, `0.2.2-rc.1` (30 releases, `0.1.1-rc.1` … `0.2.2-rc.1`).
   The plugin is built against `@deepseek-ai/dsh-tools` /
-  `@deepseek-ai/dsh-util-values` `0.2.2-alpha.3` and uses only public contracts
+  `@deepseek-ai/dsh-util-values` `0.2.2-rc.1` and uses only public contracts
   (tool registration, client slots + theme, bundle patch, and — since v3.9 —
   the session state-record API for session-linked run records).
-  It also declares `engines.dsh` (`>=0.1.1-rc.1`) so the dsh ≥ 0.2.2-alpha.3
+  It also declares `engines.dsh` (`>=0.1.1-rc.1`) so the dsh ≥ 0.2.2-rc.1
   runtime evaluates compatibility from that single range (earlier runtimes fall
   back to the `@deepseek-ai/dsh-*` peer versions listed in `package.json`).
 - **Disposable-Profile evidence (real, `dsh` CLI `0.1.1-rc.1`)**: on a temp

package/README.zh-CN.md

@@ -114,6 +114,7 @@ dsh plugin --profile web add iterate-plugin
 - **iterate 设置区 `SettingsPanel`**（`settings.section`）— 主题开关、分诊持久化说明、配置管理指引（覆盖 `validation.commands` / `language` / `personalization.known_intentional`，并显式警告"validation.commands 为空 = 本轮不受任何测试保护"；字段选择器可生成对应的 `iterate_config write` 指令），**v3.7：新增「回读当前配置」补齐写入 → 回读闭环**——复制 `iterate_config read` 指令，模型把结果回显进会话后，卡片就地展示所选字段的当前值；运行时状态概览（产物布局 + 查看/清理工具指引 + 磁盘快照拉取）、一键清空分诊数据。
 - **双语 UI（v3.7）**——所有界面文案（面板、空态、页签、徽标、设置、停止原因与完成汇总）均提供简体中文与 English。在**设置 → 界面语言 / Interface language**切换；选择持久化在 `localStorage`（`iterate-ui-lang`），否则按 `navigator.language` 自动探测（已保存的选择始终优先，且自动探测不会写入偏好）。**面向模型的文案有意保持中文**——`build*Instruction` 指令与可粘贴指引是与 `SKILL.md` 对齐的契约文本，因此两处展开的指引带「中文（粘贴给模型的契约文案）」标签，避免被误当成漏翻。
 - **右键菜单（v3.14，dsh ≥ 0.2.2-alpha.3）**——iterate 入口现在也挂在**原生统一右键菜单**上：右键侧边栏的**会话**可 `打开 iterate 质量指挥中心`（展开停靠观测台并跳到实时流）、复制预检 / dry-run / 断点恢复 / 磁盘快照指令；右键**文件**（带行号）/ **目录**可复制**定向** dry-run 审查指令（仅审查该文件/目录）。双语标签、复制失败的自救指引、共享成功 toast；宿主无 `contextMenus` 时降级为无菜单项（停靠面板仍是入口）。
+- **键盘快捷键（v3.15，dsh ≥ 0.2.2-rc.1）**——iterate 指挥中心现在一键可达：任意会话内按 **Cmd/Ctrl+Shift+O** 即可打开停靠观测台（dsh 新增的统一键盘命令能力）。快捷键注册在 dsh 的 `shortcuts` 服务上，与右键「打开指挥中心」动作共用同一命令 id，因此右键菜单会显示实时键帽、dsh 自身的快捷键设置页也会将其列为可编辑绑定。宿主早于 `shortcuts` 服务时降级为无键盘命令（停靠面板与右键菜单仍是入口）；默认绑定冲突时仅记录并跳过，绝不拖垮插件。
 
 UI 层为**防御式设计**：`slots` / `theme` / `React` 任一不可用时自动降级，不会崩溃客户端。
 
@@ -337,7 +338,7 @@ validation:
 ### Node.js / DSH 兼容范围
 
 - **Node.js**：`>=20`（`package.json` 的 `engines.node`）。
-- **DSH**：`package.json` 的 `dsh.compatibility.dshReleases` 字段是发布兼容性的**唯一真源**（本 README 逐字镜像该字段；两者需同步更新）。以下官方版本声明为 `compatible`：`0.1.1-rc.1`、`0.1.2-alpha.4`、`0.1.2-alpha.5`、`0.1.2-rc.1`、`0.1.3-alpha.1`、`0.1.5-alpha.1`、`0.1.5-alpha.2`、`0.1.5-rc.1`、`0.1.5-rc.2`、`0.1.6-alpha.1`、`0.1.6-alpha.2`、`0.1.7-alpha.1`、`0.1.7-alpha.2`、`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`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.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`（共 29 个版本，`0.1.1-rc.1` … `0.2.2-alpha.3`）。插件基于 `@deepseek-ai/dsh-tools` / `@deepseek-ai/dsh-util-values` `0.2.2-alpha.3` 构建，只使用公开契约（工具注册、客户端 slots + theme、bundle patch，以及 v3.9 起的会话状态记录接口）。插件同时声明 `engines.dsh`（`>=0.1.1-rc.1`），使 dsh ≥ 0.2.2-alpha.3 运行时只依据该范围判断兼容性（更早的运行时仍回退校验 `package.json` 中列出的 `@deepseek-ai/dsh-*` peer 版本）。
+- **DSH**：`package.json` 的 `dsh.compatibility.dshReleases` 字段是发布兼容性的**唯一真源**（本 README 逐字镜像该字段；两者需同步更新）。以下官方版本声明为 `compatible`：`0.1.1-rc.1`、`0.1.2-alpha.4`、`0.1.2-alpha.5`、`0.1.2-rc.1`、`0.1.3-alpha.1`、`0.1.5-alpha.1`、`0.1.5-alpha.2`、`0.1.5-rc.1`、`0.1.5-rc.2`、`0.1.6-alpha.1`、`0.1.6-alpha.2`、`0.1.7-alpha.1`、`0.1.7-alpha.2`、`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`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.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1`（共 30 个版本，`0.1.1-rc.1` … `0.2.2-rc.1`）。插件基于 `@deepseek-ai/dsh-tools` / `@deepseek-ai/dsh-util-values` `0.2.2-rc.1` 构建，只使用公开契约（工具注册、客户端 slots + theme、bundle patch，以及 v3.9 起的会话状态记录接口）。插件同时声明 `engines.dsh`（`>=0.1.1-rc.1`），使 dsh ≥ 0.2.2-rc.1 运行时只依据该范围判断兼容性（更早的运行时仍回退校验 `package.json` 中列出的 `@deepseek-ai/dsh-*` peer 版本）。
 - **一次性 Profile 证据（真实，`dsh` CLI `0.1.1-rc.1`）**：在临时 `$DSH_HOME` 下
   `dsh plugin --profile <p> add <本仓库>` 约 449ms 完成安装；`dsh --profile <p>
   --dump-config` 正确合成 `iterate-plugin` bundle patch；`dsh plugin --profile <p>

package/lib/client.js

@@ -1,4 +1,4 @@
-/* iterate-plugin client source-digest: 5b22267e6de6fb0564d60874b3de1211755cdeb398f6c7ffa87dfa1007e6796f */
+/* iterate-plugin client source-digest: 4f3bcac77cef83b80ea8fa2387f254121b9f94f7a2a2ca9422dd6342581c3463 */
 window.__ModuleLoader__.load({ id: "iterate-plugin", factory: (require) => {
 var module = { exports: {} };
 var exports = module.exports;
@@ -2865,6 +2865,53 @@ function subscribeSession(listener) {
   };
 }
 
+// src/client/shortcuts.ts
+var OBSERVATORY_SHORTCUT_ID = "iterate.open-observatory";
+var DEFAULT_BINDING = { code: "KeyO", modifiers: ["primary", "shift"] };
+var DEFAULT_PROFILES = [
+  "desktop:macos",
+  "desktop:windows",
+  "desktop:linux",
+  "web:macos",
+  "web:windows",
+  "web:linux"
+];
+var OBSERVATORY_DEFAULT_BINDINGS = Object.fromEntries(
+  DEFAULT_PROFILES.map((profile) => [profile, DEFAULT_BINDING])
+);
+function buildObservatoryShortcutCommand(deps) {
+  const label = () => deps.lang() === "zh" ? "\u6253\u5F00 iterate \u89C2\u6D4B\u53F0" : "Open iterate observatory";
+  return {
+    id: OBSERVATORY_SHORTCUT_ID,
+    label,
+    aliases: [],
+    defaults: OBSERVATORY_DEFAULT_BINDINGS,
+    regions: ["page", "editable", "terminal"],
+    modals: [],
+    resolve: () => ({ status: "handled", run: () => deps.openObservatory({}) })
+  };
+}
+function registerIterateShortcuts(service, deps) {
+  try {
+    const dispose = service.register(buildObservatoryShortcutCommand(deps));
+    let done = false;
+    return () => {
+      if (done) return;
+      done = true;
+      try {
+        dispose();
+      } catch {
+      }
+    };
+  } catch (err) {
+    if (typeof console !== "undefined" && typeof console.error === "function") {
+      console.error("[iterate-ui] keyboard-command registration failed; continuing without it.", err);
+    }
+    return () => {
+    };
+  }
+}
+
 // src/client/context-menu.ts
 var OBS_OPEN_EVENT = "iterate-plugin:open-observatory";
 function openObservatory(detail) {
@@ -2906,14 +2953,14 @@ function buildSessionMenuEntries(lang, opts) {
 function buildFileMenuEntries(lang) {
   return [
     { id: "iterate.review-file", label: pick("iterate.review-file", lang) },
-    { id: "iterate.open-panel", label: pick("iterate.open-panel", lang) }
+    { id: "iterate.open-panel", label: pick("iterate.open-panel", lang), openTab: "live" }
   ];
 }
 function buildDirectoryMenuEntries(lang) {
   return [
     { id: "iterate.review-dir", label: pick("iterate.review-dir", lang) },
     { id: "iterate.preflight", label: pick("iterate.preflight", lang), separatorBefore: true },
-    { id: "iterate.open-panel", label: pick("iterate.open-panel", lang) }
+    { id: "iterate.open-panel", label: pick("iterate.open-panel", lang), openTab: "live" }
   ];
 }
 function toAction(entry, deps, lang) {
@@ -2925,6 +2972,7 @@ function toAction(entry, deps, lang) {
   };
   if (entry.disabled) action.disabled = true;
   if (entry.openTab) {
+    action.commandId = OBSERVATORY_SHORTCUT_ID;
     action.run = () => {
       deps.openPanel({ tab: entry.openTab });
       deps.notify(lang === "zh" ? "\u5DF2\u6253\u5F00 iterate \u89C2\u6D4B\u53F0\u3002" : "Iterate observatory opened.", true);
@@ -3439,6 +3487,14 @@ function readContextMenus(ctx) {
   if (typeof svc.notify !== "function") return void 0;
   return svc;
 }
+function readShortcuts(ctx) {
+  if (!ctx || typeof ctx.get !== "function") return void 0;
+  const raw = ctx.get("shortcuts", false);
+  if (!raw || typeof raw !== "object") return void 0;
+  const svc = raw;
+  if (typeof svc.register !== "function") return void 0;
+  return svc;
+}
 function sessionIdOfSession(session) {
   if (!session || typeof session !== "object") return null;
   const s = session;
@@ -3466,6 +3522,7 @@ var themeDisposer = null;
 var themeListener = null;
 var themeEnabled = true;
 var menuDisposer = null;
+var shortcutDisposer = null;
 var roundPulseListeners = [];
 function emitRoundPulse(round, converged) {
   const payload = { round, converged: converged === true };
@@ -6446,6 +6503,32 @@ function apply(ctx) {
       }
     }
   }
+  {
+    const shortcutSvc = readShortcuts(ctx);
+    if (shortcutSvc) {
+      if (shortcutDisposer) {
+        try {
+          shortcutDisposer();
+        } catch {
+        }
+        shortcutDisposer = null;
+      }
+      shortcutDisposer = registerIterateShortcuts(shortcutSvc, {
+        openObservatory: (detail) => {
+          openObservatory(detail);
+        },
+        lang: () => getLang()
+      });
+      if (typeof ctx.effect === "function") {
+        ctx.effect(() => {
+          if (shortcutDisposer) {
+            shortcutDisposer();
+            shortcutDisposer = null;
+          }
+        });
+      }
+    }
+  }
   registerThemeListener(ctx);
 }
 return module.exports; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iterate-plugin",
-  "version": "3.14.0",
+  "version": "3.15.0",
   "description": "dsh plugin that turns the iterate skill into an autonomous closed-loop harness with quality command center and experience bank (v3.3). Features: plan -> parallel review xN -> atomic fixes -> validate -> loop -> auto-stop, plus dry-run pure-review mode, quality gate compute/persist, writable experience bank, defense events stream (record + bilingual labels), and native command buttons — with a live quality command center (F8/F9/F10 render real session data), §8 assign-fix instruction, and task_mode indicator wired end to end.",
   "type": "module",
   "license": "MIT",
@@ -56,7 +56,8 @@
         "0.2.1-rc.4": "compatible",
         "0.2.1-rc.5": "compatible",
         "0.2.2-alpha.2": "compatible",
-        "0.2.2-alpha.3": "compatible"
+        "0.2.2-alpha.3": "compatible",
+        "0.2.2-rc.1": "compatible"
       }
     },
     "client": {
@@ -93,14 +94,14 @@
     "test:validate": "tsx --test test/validate.test.ts"
   },
   "dependencies": {
-    "iterate-kernel": "0.1.9",
+    "iterate-kernel": "0.1.10",
     "js-yaml": "4.3.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.2 || ~4.0.6-alpha.1 || ~4.0.6-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.1-rc.1 || 0.1.2-alpha.4 || 0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.5-alpha.1 || 0.1.5-alpha.2 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 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.1-rc.5 || 0.2.2-alpha.2 || 0.2.2-alpha.3",
-    "@deepseek-ai/dsh-tools": "0.1.1-rc.1 || 0.1.2-alpha.4 || 0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.5-alpha.1 || 0.1.5-alpha.2 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 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.1-rc.5 || 0.2.2-alpha.2 || 0.2.2-alpha.3",
-    "@deepseek-ai/dsh-util-values": "0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.5-alpha.1 || 0.1.5-alpha.2 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 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.1-rc.5 || 0.2.2-alpha.2 || 0.2.2-alpha.3"
+    "@deepseek-ai/dsh-session": "0.1.1-rc.1 || 0.1.2-alpha.4 || 0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.5-alpha.1 || 0.1.5-alpha.2 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 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.1-rc.5 || 0.2.2-alpha.2 || 0.2.2-alpha.3 || 0.2.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.1 || 0.1.2-alpha.4 || 0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.5-alpha.1 || 0.1.5-alpha.2 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 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.1-rc.5 || 0.2.2-alpha.2 || 0.2.2-alpha.3 || 0.2.2-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.5-alpha.1 || 0.1.5-alpha.2 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 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.1-rc.5 || 0.2.2-alpha.2 || 0.2.2-alpha.3 || 0.2.2-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -117,20 +118,20 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.6-alpha.2",
-    "@deepseek-ai/dsh-agent": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-jobs": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-llm": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-ptc-runtime": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-sandbox": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-sandbox-policy": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-scope": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-session": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-tools": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-user-approval": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.3",
-    "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.3",
+    "@deepseek-ai/cordis": "4.1.0",
+    "@deepseek-ai/dsh-agent": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-jobs": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-sandbox": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-scope": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-user-approval": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.2-rc.1",
     "@types/js-yaml": "4.0.9",
     "@types/node": "22.15.0",
     "@types/react": "19.2.2",
@@ -144,5 +145,8 @@
   "engines": {
     "node": ">=20",
     "dsh": ">=0.1.1-rc.1"
+  },
+  "overrides": {
+    "zod": "4.6.7"
   }
 }

package/src/client/context-menu.ts

@@ -40,6 +40,7 @@
  */
 
 import { getLang, type Lang } from './i18n.ts'
+import { OBSERVATORY_SHORTCUT_ID } from './shortcuts.ts'
 
 // ─── Structural service types (defensive; mirrors SlotsService) ──────────────
 //
@@ -63,6 +64,8 @@ export interface IterateMenuAction {
   separatorBefore?: boolean
   /** Localized operation + recovery guidance when `run` rejects. */
   failureLabel?: string
+  /** Live-shortcut display for an action backed by a registered command. */
+  commandId?: string
   run?: () => void | Promise<void>
 }
 
@@ -168,7 +171,7 @@ export function buildSessionMenuEntries(lang: Lang, opts?: { hasCheckpoint?: boo
 export function buildFileMenuEntries(lang: Lang): MenuEntry[] {
   return [
     { id: 'iterate.review-file', label: pick('iterate.review-file', lang) },
-    { id: 'iterate.open-panel', label: pick('iterate.open-panel', lang) },
+    { id: 'iterate.open-panel', label: pick('iterate.open-panel', lang), openTab: 'live' },
   ]
 }
 
@@ -177,7 +180,7 @@ export function buildDirectoryMenuEntries(lang: Lang): MenuEntry[] {
   return [
     { id: 'iterate.review-dir', label: pick('iterate.review-dir', lang) },
     { id: 'iterate.preflight', label: pick('iterate.preflight', lang), separatorBefore: true },
-    { id: 'iterate.open-panel', label: pick('iterate.open-panel', lang) },
+    { id: 'iterate.open-panel', label: pick('iterate.open-panel', lang), openTab: 'live' },
   ]
 }
 
@@ -203,6 +206,12 @@ function toAction(entry: MenuEntry, deps: IterateMenuDeps, lang: Lang): IterateM
   }
   if (entry.disabled) action.disabled = true
   if (entry.openTab) {
+    // The "open command center" action is backed by the registered
+    // `iterate.open-observatory` keyboard command, so the context menu shows
+    // its live keycap (Cmd/Ctrl+Shift+O) — the shortcut is discoverable in the
+    // same place the user would look for it. Display only: selection still
+    // runs this action's `run`.
+    action.commandId = OBSERVATORY_SHORTCUT_ID
     action.run = () => {
       deps.openPanel({ tab: entry.openTab })
       deps.notify(lang === 'zh' ? '已打开 iterate 观测台。' : 'Iterate observatory opened.', true)

package/src/client/index.ts

@@ -24,7 +24,7 @@
  *   4. iterate theme skin      -> theme.overrideTokens
  *   5. Progress event linkage  -> ctx.on('slots/changed') + round-pulse + shell.overlay capsule
  *   6. Settings page section   -> settings.section
- *   7. Runtime observatory     -> conversation.input.dock (order 91, F1–F7 board)
+ *   7. Runtime observatory     -> conversation.input.dock (order 91, F1–F11 board)
  *
  * Design notes:
  *   - All styles are injected via one <style> tag; colors use dsh token
@@ -141,6 +141,11 @@ import {
   type ContextMenusService,
   type ObsOpenDetail,
 } from './context-menu.ts'
+// v3.15: keyboard-command contribution (dsh 0.2.2-rc.1 unified shortcuts).
+import {
+  registerIterateShortcuts,
+  type ShortcutsService,
+} from './shortcuts.ts'
 
 // ─── Module contract ─────────────────────────────────────────────────────────
 
@@ -932,6 +937,21 @@ function readContextMenus(ctx: ClientContext): ContextMenusService | undefined {
   return svc as unknown as ContextMenusService
 }
 
+/**
+ * Resolve the dsh 0.2.2-rc.1 `shortcuts` service. Like contextMenus it is NOT
+ * in the typed `ClientContext`, so it is probed through `ctx.get` and
+ * structurally validated. A host that predates the capability returns
+ * `undefined` and the plugin simply has no keyboard command.
+ */
+function readShortcuts(ctx: ClientContext): ShortcutsService | undefined {
+  if (!ctx || typeof ctx.get !== 'function') return undefined
+  const raw = ctx.get('shortcuts', false)
+  if (!raw || typeof raw !== 'object') return undefined
+  const svc = raw as { register?: unknown }
+  if (typeof svc.register !== 'function') return undefined
+  return svc as unknown as ShortcutsService
+}
+
 /**
  * Extract a session identifier from an opaque host-shaped session object.
  * The slot `props.session` shape is host-defined; this probes the common
@@ -967,6 +987,8 @@ let themeListener: (() => void) | null = null
 let themeEnabled = true
 /** v3.14: right-click menu contribution disposer (re-apply() never stacks). */
 let menuDisposer: (() => void) | null = null
+/** v3.15: keyboard-command contribution disposer (re-apply() never stacks). */
+let shortcutDisposer: (() => void) | null = null
 const roundPulseListeners: Array<(payload: { round: number; converged: boolean }) => void> = []
 
 /**
@@ -2232,7 +2254,7 @@ function SettingsPanel(props: SlotProps) {
   )
 }
 
-// ─── Runtime observatory panel (F1–F7) ──────────────────────────────────────
+// ─── Runtime observatory panel (F1–F11) ─────────────────────────────────────
 
 /** Tab id → label for the observatory's eleven panels. Live (real-time
  *  activity stream) is first so it is the default view; F-panels follow.
@@ -2359,7 +2381,7 @@ function buildObsFixInstruction(f: ObsFinding): string {
 }
 
 /**
- * ObservatoryPanel: an 8-tab runtime observatory that renders the latest
+ * ObservatoryPanel: a 12-tab runtime observatory that renders the latest
  * iterate_transcript manifest found in the dsh session stream. The panel is
  * collapsed by default to a single entry row so it never re-occludes the main
  * convergence dashboard; clicking expands it into tabs. Every field read is
@@ -3907,7 +3929,7 @@ export function apply(ctx: ClientContext): void {
       ),
     )
 
-    // F1–F7: runtime observatory board (order 91, below the dashboard's 90 so
+    // F1–F11: runtime observatory board (order 91, below the dashboard's 90 so
     // its collapsed header never occludes the main convergence dashboard).
     slotsSvc.inject('conversation.input.dock', () =>
       slotsSvc?.register(
@@ -3984,6 +4006,26 @@ export function apply(ctx: ClientContext): void {
     }
   }
 
+  // 5c. v3.15: keyboard-command contribution (dsh 0.2.2-rc.1 unified
+  // shortcuts). Optional service: a host that predates the capability has no
+  // keyboard command, and the docked observatory stays the entry point.
+  {
+    const shortcutSvc = readShortcuts(ctx)
+    if (shortcutSvc) {
+      if (shortcutDisposer) {
+        try { shortcutDisposer() } catch { /* noop */ }
+        shortcutDisposer = null
+      }
+      shortcutDisposer = registerIterateShortcuts(shortcutSvc, {
+        openObservatory: (detail) => { openObservatory(detail) },
+        lang: () => getLang(),
+      })
+      if (typeof ctx.effect === 'function') {
+        ctx.effect(() => { if (shortcutDisposer) { shortcutDisposer(); shortcutDisposer = null } })
+      }
+    }
+  }
+
   // 6: keep theme toggle state consistent across theme/change events.
   // Registered through registerThemeListener so repeated apply() and client
   // unmounts never leak a second listener.

package/src/client/shortcuts.ts

@@ -0,0 +1,152 @@
+/**
+ * src/client/shortcuts.ts — iterate-plugin keyboard-command contributions.
+ *
+ * dsh 0.2.2-rc.1 added the *unified keyboard-command* capability
+ * (`@deepseek-ai/dsh-client-shortcuts`): any client plugin may register a
+ * command with a default key binding and a target resolver, and dsh's own
+ * keyboard adapter dispatches the gesture to it. The same capability also lets
+ * a context-menu action carry a `commandId` so the menu shows the live
+ * keycap next to the action (selection still invokes the action's `run`).
+ *
+ * This module turns that new upstream capability into a *user-perceivable*
+ * iterate surface: instead of hunting for the docked observatory (or
+ * right-clicking a session), the user can now press **Cmd/Ctrl+Shift+O** to
+ * open the iterate quality command center from anywhere in the session. The
+ * matching context-menu action carries the same `commandId`, so the shortcut
+ * is discoverable in the right-click menu ("open command center" shows the
+ * keycap), and dsh's own shortcut settings page lists it as an editable
+ * binding.
+ *
+ * Design (mirrors `context-menu.ts` and the rest of the client half):
+ *   - **Defensive**: the `shortcuts` service is optional and probed at
+ *     apply-time (see `readShortcuts` in `index.ts`); a host that predates
+ *     0.2.2-rc.1 simply has no keyboard command (the docked panel stays the
+ *     entry point). Nothing throws.
+ *   - **Pure builder**: `buildObservatoryShortcutCommand` returns the command
+ *     shape with no `ctx`/DOM side effects, so it is unit-testable on its own
+ *     (label resolution, binding defaults, resolve→run). The imperative
+ *     wiring (`openObservatory` / `lang`) is injected by
+ *     `registerIterateShortcuts`.
+ *   - **Bilingual**: the label resolves against the language passed in at
+ *     registration (a language switch is picked up by dsh's own command
+ *     catalog on the next render).
+ *   - **No external import**: like the rest of the client half, the dsh
+ *     `@deepseek-ai/dsh-client-shortcuts` types are NOT imported (no
+ *     compile-time coupling to a package a pre-0.2.2-rc.1 host may not have);
+ *     the surface below is the structural subset this plugin consumes.
+ */
+
+import type { Lang } from './i18n.ts'
+
+// ─── Structural service types (defensive; mirrors ContextMenusService) ───────
+
+/** Stable command identity owned by this plugin (a branded string upstream). */
+export const OBSERVATORY_SHORTCUT_ID = 'iterate.open-observatory'
+
+/** One physical key + modifiers; `primary` expands to Meta on macOS. */
+export interface ShortcutBinding {
+  code: string
+  secondCode?: string
+  modifiers: readonly string[]
+}
+
+/** The dsh command catalog shape this plugin registers. */
+export interface ShortcutCommand {
+  id: string
+  label: () => string
+  aliases: readonly string[]
+  defaults: Readonly<Record<string, ShortcutBinding>>
+  regions: readonly string[]
+  modals: readonly string[]
+  resolve(context: { region?: string; modal?: string | null; target?: Element | null }): ShortcutResolution
+}
+
+/** A resolved command either runs, is blocked with a reason, or passes. */
+export type ShortcutResolution =
+  | { status: 'handled'; run: () => void }
+  | { status: 'blocked'; reason: string }
+  | { status: 'pass' }
+
+/** Structural view of the dsh `shortcuts` service this plugin consumes. */
+export interface ShortcutsService {
+  register(command: ShortcutCommand): () => void
+}
+
+/** Injection points the shortcut wiring needs (kept dependency-light for tests). */
+export interface ShortcutDeps {
+  /** Open the observatory panel (optionally for a session, on a tab). */
+  openObservatory: (detail?: { sessionId?: string; tab?: string }) => void
+  /** Resolve the current UI language at label-build time. */
+  lang: () => Lang
+}
+
+/**
+ * Default key binding for the observatory command: Cmd/Ctrl+Shift+O
+ * ("O" = Open), applied uniformly across every runtime/platform profile so the
+ * feature is on by default on desktop and web. If an existing dsh command
+ * already owns this combination, `register` throws and the plugin degrades
+ * gracefully (no keyboard command; the observatory stays mouse-reachable).
+ */
+const DEFAULT_BINDING: ShortcutBinding = { code: 'KeyO', modifiers: ['primary', 'shift'] }
+
+const DEFAULT_PROFILES = [
+  'desktop:macos',
+  'desktop:windows',
+  'desktop:linux',
+  'web:macos',
+  'web:windows',
+  'web:linux',
+] as const
+
+/** Every runtime/platform profile maps to the same default binding. */
+export const OBSERVATORY_DEFAULT_BINDINGS: Readonly<Record<string, ShortcutBinding>> = Object.fromEntries(
+  DEFAULT_PROFILES.map((profile) => [profile, DEFAULT_BINDING]),
+) as Readonly<Record<string, ShortcutBinding>>
+
+/**
+ * Build the pure command descriptor for "open iterate observatory". The
+ * resolver always handles the gesture and runs the injected opener; it never
+ * blocks (opening the observatory is safe from any region and no modal).
+ */
+export function buildObservatoryShortcutCommand(deps: ShortcutDeps): ShortcutCommand {
+  const label = (): string =>
+    deps.lang() === 'zh' ? '打开 iterate 观测台' : 'Open iterate observatory'
+  return {
+    id: OBSERVATORY_SHORTCUT_ID,
+    label,
+    aliases: [],
+    defaults: OBSERVATORY_DEFAULT_BINDINGS,
+    regions: ['page', 'editable', 'terminal'],
+    modals: [],
+    resolve: () => ({ status: 'handled', run: () => deps.openObservatory({}) }),
+  }
+}
+
+/**
+ * Register the observatory keyboard command on the (already-validated)
+ * `shortcuts` service. Returns an unregister function; a host without the
+ * service is a no-op that returns `() => {}` (callers guard).
+ */
+export function registerIterateShortcuts(service: ShortcutsService, deps: ShortcutDeps): () => void {
+  try {
+    const dispose = service.register(buildObservatoryShortcutCommand(deps))
+    let done = false
+    return () => {
+      if (done) return
+      done = true
+      try {
+        dispose()
+      } catch {
+        /* noop */
+      }
+    }
+  } catch (err) {
+    // A duplicate id or an overlapping default binding must not take the
+    // plugin down — log and continue with no keyboard command (the docked
+    // panel and the context-menu "open" action remain the entry points).
+    if (typeof console !== 'undefined' && typeof console.error === 'function') {
+      console.error('[iterate-ui] keyboard-command registration failed; continuing without it.', err)
+    }
+    return () => {}
+  }
+}