iterate-plugin 3.14.0 → 3.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iterate-plugin",
-  "version": "3.14.0",
+  "version": "3.16.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/i18n.ts

@@ -296,8 +296,27 @@ export const EN: Record<string, string> = {
   '各轮发现数量：{a0}{a1}': 'Findings per round: {a0}{a1}',
   ' · 当前 Round {a0}': ' · current round {a0}',
   '跨轮对比（本会话）': 'Cross-round comparison (this session)',
-  '跨会话对比：本表只覆盖当前会话；点「拉取磁盘快照」让模型回显 iterate_history，再用「导出 JSON」并排比较两次运行':
-    'Cross-session comparison: this table only covers the current session — click "Pull disk snapshot" to have the model echo iterate_history, then use "Export JSON" to compare two runs side by side',
+  '跨会话对比：本表只覆盖当前会话；要跨两次迭代对比，用下方「存为对比基准」保存本次运行，再与下一次迭代对比。':
+    'Cross-session comparison: this table only covers the current session — to compare two iterations, save this run with \"Save as comparison baseline\" below, then compare the next iteration against it.',
+  跨会话对比: 'Cross-session comparison',
+  '基准已保存：{a0}': 'Baseline saved: {a0}',
+  '先保存当前运行为基准，再跑下一次迭代后一键对比':
+    'Save the current run as the baseline, then one-click compare the next iteration against it',
+  '把当前运行摘要保存为对比基准（含轮次/发现/修复/验证/门禁）':
+    'Save the current run summary as the comparison baseline (rounds / findings / fixes / validation / gate)',
+  '当前没有可保存的运行数据': 'No run data to save yet',
+  已存为基准: 'Saved as baseline',
+  存为对比基准: 'Save as comparison baseline',
+  '显示或隐藏与已保存基准的对比表': 'Show or hide the comparison against the saved baseline',
+  收起对比: 'Hide comparison',
+  与基准对比: 'Compare with baseline',
+  '清除已保存的对比基准': 'Clear the saved comparison baseline',
+  清除基准: 'Clear baseline',
+  '当前会话没有运行数据可对比': 'This session has no run data to compare yet',
+  指标: 'Metric',
+  基准: 'Baseline',
+  当前: 'Current',
+  变化: 'Delta',
 
   // ── F3 finding locations ─────────────────────────────────────────────────
   暂无发现: 'No findings',

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,22 @@ 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'
+// v3.16: cross-session run comparison — the F2 tab compares two iterations of
+// the same project (save the current run as a baseline, then compare any later
+// run against it), instead of the old export-two-JSONs-and-diff-by-hand chore.
+import {
+  buildRunBaseline,
+  parseRunBaseline,
+  compareRuns,
+  RUN_BASELINE_STORAGE_KEY,
+  type RunBaseline,
+  type RunCompareMetric,
+} from './run-compare.ts'
 
 // ─── Module contract ─────────────────────────────────────────────────────────
 
@@ -932,6 +948,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 +998,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 +2265,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.
@@ -2296,6 +2329,17 @@ const OBS_LIVE_META: Record<string, { label: { zh: string; en: string }; color:
 }
 const OBS_LIVE_FALLBACK_COLOR = 'var(--dsw-alias-label-secondary)'
 
+/** v3.16: cross-session comparison metric labels (inline {zh,en} pair, like OBS_TABS). */
+const RUN_COMPARE_METRIC_LABELS: Record<string, { zh: string; en: string }> = {
+  rounds: { zh: '轮次', en: 'Rounds' },
+  findings: { zh: '发现', en: 'Findings' },
+  criticalHigh: { zh: '严重（critical+high）', en: 'Critical + high' },
+  fixed: { zh: '修复成功', en: 'Fixes applied' },
+  failedFixes: { zh: '修复失败', en: 'Failed fixes' },
+  validationPassRate: { zh: '验证通过率', en: 'Validation pass rate' },
+  qualityGateScore: { zh: '门禁得分', en: 'Quality gate score' },
+}
+
 /**
  * Format a live-event timestamp as DD/MM HH:mm:ss (0-padded). Accepts an epoch
  * ms number or an ISO-ish string; any unparseable value degrades to ''.
@@ -2359,7 +2403,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
@@ -2406,6 +2450,20 @@ function ObservatoryPanel(props: SlotProps) {
   // v3.0: Defense events filter
   const [defenseFilter, setDefenseFilter] = React.useState('')
 
+  // v3.16: cross-session comparison — the baseline is read from localStorage
+  // once on mount (a corrupt/stale payload reads as "no baseline", never as a
+  // phantom run); `showCompare` toggles the side-by-side table, `baselineFlash`
+  // confirms the save action.
+  const [baseline, setBaseline] = React.useState<RunBaseline | null>(() => {
+    try {
+      return parseRunBaseline(storage ? storage.get(RUN_BASELINE_STORAGE_KEY) : null)
+    } catch {
+      return null
+    }
+  })
+  const [showCompare, setShowCompare] = React.useState(false)
+  const [baselineFlash, setBaselineFlash] = React.useState(false)
+
   // Single shared "copied" flash timer (reused across all copy buttons).
   const copyTimer = React.useRef<ReturnType<typeof setTimeout> | null>(null)
   React.useEffect(() => () => { if (copyTimer.current) clearTimeout(copyTimer.current) }, [])
@@ -2669,18 +2727,62 @@ function ObservatoryPanel(props: SlotProps) {
     }))
   }
 
+  // ── v3.16: cross-session run comparison handlers ────────────────────────
+  // The summary is built from the SAME manifest the F2 tab renders, so a saved
+  // baseline can never disagree with what the user is looking at.
+  const currentRunSummary = (): RunBaseline | null => {
+    const hasRun =
+      (manifest.convergence || []).length > 0 ||
+      (manifest.findings || []).length > 0 ||
+      (manifest.fixes || []).length > 0 ||
+      (typeof manifest.round === 'number' && manifest.round > 0)
+    if (!hasRun) return null
+    return buildRunBaseline(
+      {
+        project: manifest.project || undefined,
+        mode: manifest.mode || undefined,
+        convergence: manifest.convergence || [],
+        findings: (manifest.findings || []) as Array<{ severity?: string }>,
+        fixes: (manifest.fixes || []) as Array<{ success?: boolean }>,
+        validations: (manifest.validations || []) as Array<{ allowed?: boolean }>,
+        qualityGateStatus: (qualityGate && qualityGate.overallStatus) || null,
+        qualityGateScore: qualityGate && typeof qualityGate.overallScore === 'number' ? qualityGate.overallScore : null,
+        stoppedReason: manifest.stoppedReason || null,
+      },
+      new Date().toISOString(),
+    )
+  }
+  const saveBaseline = () => {
+    const summary = currentRunSummary()
+    if (!summary || !storage) return
+    try {
+      storage.set(RUN_BASELINE_STORAGE_KEY, JSON.stringify(summary))
+      setBaseline(summary)
+      setShowCompare(true)
+      setBaselineFlash(true)
+      if (copyTimer.current) clearTimeout(copyTimer.current)
+      copyTimer.current = setTimeout(() => setBaselineFlash(false), 1600)
+    } catch (err) {
+      log('failed to persist run baseline', err)
+    }
+  }
+  const clearBaseline = () => {
+    if (storage) {
+      try { storage.remove(RUN_BASELINE_STORAGE_KEY) } catch (err) { log('failed to clear run baseline', err) }
+    }
+    setBaseline(null)
+    setShowCompare(false)
+  }
+
   // ── F2: convergence trend (inline bars, reusing TrendChart) ─────────────
   const renderTrend = () => {
     const conv = manifest.convergence || []
-    if (conv.length === 0) {
-      return React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无收敛数据'))
-    }
     const points = conv.map((n, i) => ({ round: i + 1, count: n }))
     // Gap #13 (step ①): single-session cross-round comparison. One row per
     // round — findings raised / fixed / severity mix / validation outcome.
-    // Cross-SESSION comparison rides on the #4 pull instruction instead (the
-    // client has no filesystem access, so `iterate_history` aggregates have to
-    // be echoed back into the session first).
+    // v3.16: the cross-SESSION half is now the `renderCrossSessionCompare`
+    // block below (save the current run as a baseline, then compare any later
+    // run against it) instead of the old export-two-JSONs-and-diff-by-hand chore.
     const report = latestReport(session)
     const comparison = buildRoundComparison(report, manifest.validations || [], manifest.fixes || [])
     const comparisonTable = comparison.length === 0
@@ -2720,22 +2822,117 @@ function ObservatoryPanel(props: SlotProps) {
             }),
           ),
         )
-    return React.createElement('div', {},
-      React.createElement(TrendChart, { points }),
-      React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
-        tf(`各轮发现数量：{a0}{a1}`, { a0: conv.join(' → '), a1: typeof manifest.round === 'number' ? tf(` · 当前 Round {a0}`, { a0: manifest.round }) : '' }),
-      ),
-      comparisonTable
-        ? React.createElement('div', { className: 'iterate-obs-block', style: { marginTop: 8 } },
-            React.createElement('div', { className: 'iterate-obs-block-head' },
-              React.createElement('span', {}, t('跨轮对比（本会话）')),
-              React.createElement('span', { className: 'iterate-obs-head-meta' },
-                t('跨会话对比：本表只覆盖当前会话；点「拉取磁盘快照」让模型回显 iterate_history，再用「导出 JSON」并排比较两次运行'),
-              ),
+    const trendBody = conv.length === 0
+      ? React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无收敛数据'))
+      : React.createElement('div', {},
+          React.createElement(TrendChart, { points }),
+          React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
+            tf(`各轮发现数量：{a0}{a1}`, { a0: conv.join(' → '), a1: typeof manifest.round === 'number' ? tf(` · 当前 Round {a0}`, { a0: manifest.round }) : '' }),
+          ),
+          comparisonTable
+            ? React.createElement('div', { className: 'iterate-obs-block', style: { marginTop: 8 } },
+                React.createElement('div', { className: 'iterate-obs-block-head' },
+                  React.createElement('span', {}, t('跨轮对比（本会话）')),
+                  React.createElement('span', { className: 'iterate-obs-head-meta' },
+                    t('跨会话对比：本表只覆盖当前会话；要跨两次迭代对比，用下方「存为对比基准」保存本次运行，再与下一次迭代对比。'),
+                  ),
+                ),
+                React.createElement('div', { className: 'iterate-obs-block-body' }, comparisonTable),
+              )
+            : null,
+        )
+    return React.createElement('div', {}, trendBody, renderCrossSessionCompare())
+  }
+
+  // ── v3.16: cross-session run comparison (F2) ─────────────────────────────
+  // Side-by-side comparison of the CURRENT run against a previously saved
+  // baseline, persisted in localStorage. This replaces the manual
+  // export-JSON-and-diff chore the old cross-session hint pointed at: save the
+  // current run once, then compare any later run against it in one click.
+  const renderCrossSessionCompare = () => {
+    const current = currentRunSummary()
+    const hasRun = current !== null
+    const metricLabel = (key: string): string => {
+      const m = RUN_COMPARE_METRIC_LABELS[key]
+      return m ? m[getLang()] : key
+    }
+    const fmtCell = (v: number | null, key: string): string => {
+      if (v === null) return '—'
+      return key === 'validationPassRate' ? `${v}%` : String(v)
+    }
+    const deltaText = (row: RunCompareMetric): string => {
+      if (row.baseline === null || row.current === null) return '—'
+      const d = row.current - row.baseline
+      return d === 0 ? '0' : `${d > 0 ? '+' : ''}${d}`
+    }
+    const deltaTint = (row: RunCompareMetric): { color: string; fontWeight: number } | undefined => {
+      if (row.baseline === null || row.current === null || row.higherIsBetter === null) return undefined
+      const d = row.current - row.baseline
+      if (d === 0) return undefined
+      const improved = row.higherIsBetter ? d > 0 : d < 0
+      return improved
+        ? { color: 'var(--dsw-alias-state-success-primary)', fontWeight: 600 }
+        : { color: 'var(--dsw-alias-state-error-primary)', fontWeight: 600 }
+    }
+    let compareBody: React.ReactNode = null
+    if (baseline && current && showCompare) {
+      const rows = compareRuns(baseline, current)
+      compareBody = React.createElement('table', { className: 'iterate-obs-table' },
+        React.createElement('thead', {},
+          React.createElement('tr', {},
+            React.createElement('th', {}, t('指标')),
+            React.createElement('th', {}, t('基准')),
+            React.createElement('th', {}, t('当前')),
+            React.createElement('th', {}, t('变化')),
+          ),
+        ),
+        React.createElement('tbody', {},
+          ...rows.map((row) =>
+            React.createElement('tr', { key: `rc-${row.key}` },
+              React.createElement('td', {}, metricLabel(row.key)),
+              React.createElement('td', {}, fmtCell(row.baseline, row.key)),
+              React.createElement('td', {}, fmtCell(row.current, row.key)),
+              React.createElement('td', { style: deltaTint(row) }, deltaText(row)),
             ),
-            React.createElement('div', { className: 'iterate-obs-block-body' }, comparisonTable),
-          )
-        : null,
+          ),
+        ),
+      )
+    }
+    return React.createElement('div', { className: 'iterate-obs-block', style: { marginTop: 8 } },
+      React.createElement('div', { className: 'iterate-obs-block-head' },
+        React.createElement('span', {}, t('跨会话对比')),
+        baseline
+          ? React.createElement('span', { className: 'iterate-obs-head-meta' }, tf(`基准已保存：{a0}`, { a0: baseline.savedAt }))
+          : React.createElement('span', { className: 'iterate-obs-head-meta' }, t('先保存当前运行为基准，再跑下一次迭代后一键对比')),
+      ),
+      React.createElement('div', { className: 'iterate-obs-block-body' },
+        React.createElement('div', { className: 'iterate-obs-bar', style: { flexWrap: 'wrap' } },
+          React.createElement('button', {
+            className: 'iterate-btn', 'data-primary': '', disabled: !hasRun,
+            title: hasRun ? t('把当前运行摘要保存为对比基准（含轮次/发现/修复/验证/门禁）') : t('当前没有可保存的运行数据'),
+            onClick: saveBaseline,
+          }, baselineFlash ? t('已存为基准') : t('存为对比基准')),
+          baseline
+            ? React.createElement('button', {
+                className: 'iterate-btn', 'data-copied': showCompare ? '' : undefined,
+                disabled: !hasRun,
+                title: t('显示或隐藏与已保存基准的对比表'),
+                onClick: () => setShowCompare((v) => !v),
+              }, showCompare ? t('收起对比') : t('与基准对比'))
+            : null,
+          baseline
+            ? React.createElement('button', {
+                className: 'iterate-btn', 'data-ghost': '',
+                title: t('清除已保存的对比基准'),
+                onClick: clearBaseline,
+              }, t('清除基准'))
+            : null,
+        ),
+        showCompare && baseline && !hasRun
+          ? React.createElement('div', { className: 'iterate-obs-empty', style: { marginTop: 8 } }, t('当前会话没有运行数据可对比'))
+          : null,
+        compareBody,
+      ),
     )
   }
 
@@ -3907,7 +4104,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 +4181,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.