iterate-plugin 2.10.0 → 2.12.0

package/src/client/index.ts

@@ -17,13 +17,14 @@
  *   - `inject`: services the shell must have up before `apply` runs.
  *   - `apply(ctx)`: called by the client runtime with the ClientContext.
  *
- * Implements the §14.4 / §16 six-part UI layer:
+ * Implements the §14.4 / §16 UI layer:
  *   1. Convergence dashboard  -> conversation.input.dock
- *   2. Findings triage panel  -> conversation.chat.turnTail
- *   3. Iteration stats card   -> conversation.chat.turnTail (same chain, empty-findings case)
- *   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
+ *   2. Findings triage panel   -> conversation.chat.turnTail
+ *   3. Iteration stats card    -> conversation.chat.turnTail (same chain, empty-findings case)
+ *   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)
  *
  * Design notes:
  *   - All styles are injected via one <style> tag; colors use dsh token
@@ -70,6 +71,8 @@ import {
   buildRuntimeStatusGuide,
   scanSessionForResume,
   countSessionImages,
+  scanSessionForTranscript,
+  normalizeTranscript,
   SEVERITY_LABEL,
   SEVERITY_COLOR,
 } from '../../lib/parse.js'
@@ -142,6 +145,100 @@ interface ThemeService {
   overrideTokens(source: string, tokens: IterateTokenMap): () => void
 }
 
+// ─── Runtime observatory (transcript) types ─────────────────────────────────
+// Mirrors src/types.ts Transcript* series, but every field is defensive/optional
+// so the panel never crashes on a malformed or partial manifest.
+
+interface ObsCheckpoint {
+  mode?: string
+  round?: number
+  maxRounds?: number
+  fixedCount?: number
+  resumeCount?: number
+  updatedAt?: string
+}
+
+interface ObsNudge {
+  timestamp?: string
+  text?: string
+}
+
+interface ObsApproval {
+  active?: boolean
+  policy?: string
+}
+
+interface ObsThread {
+  dimension?: string
+  attempt?: number
+  messages?: string[]
+  readFiles?: string[]
+  findings?: ObsFinding[]
+}
+
+interface ObsRound {
+  round?: number
+  threads?: ObsThread[]
+}
+
+interface ObsFinding {
+  dimension?: string
+  file?: string
+  line?: number
+  severity?: string
+  summary?: string
+  failure_scenario?: string
+  suggested_fix?: string
+  is_atomic?: boolean
+  acknowledged?: boolean
+}
+
+interface ObsFix {
+  id?: string
+  timestamp?: string
+  round?: number
+  file?: string
+  summary?: string
+  linesAdded?: number
+  linesRemoved?: number
+  success?: boolean
+}
+
+interface ObsEntry {
+  timestamp?: string
+  round?: number
+  type?: string
+  data?: Record<string, unknown>
+}
+
+interface ObsLive {
+  ts?: string
+  type?: string
+  tool?: string
+  target?: string
+}
+
+interface ObsManifest {
+  version?: number
+  project?: string
+  updatedAt?: string
+  active?: boolean
+  mode?: string
+  goal?: string
+  phases?: string[]
+  round?: number
+  maxRounds?: number
+  rounds?: ObsRound[]
+  convergence?: number[]
+  findings?: ObsFinding[]
+  fixes?: ObsFix[]
+  live?: ObsLive[]
+  checkpoint?: ObsCheckpoint | null
+  timeline?: ObsEntry[]
+  nudge?: ObsNudge | null
+  approval?: ObsApproval
+}
+
 /** Opaque slot props: heterogeneous per-slot payloads. */
 type SlotProps = Record<string, unknown>
 
@@ -333,6 +430,27 @@ const ITERATE_CSS = `
 .iterate-switch[data-on] { background: var(--dsw-alias-brand-primary); border-color: var(--dsw-alias-brand-primary); }
 .iterate-switch[data-on] .iterate-switch-knob { transform: translateX(18px); background: #FFFFFF; }
 
+/* Shared keyboard focus ring for every iterate interactive control */
+.iterate-btn:focus-visible, .iterate-vbtn:focus-visible, .iterate-batch-btn:focus-visible,
+.iterate-filter-select:focus-visible, .iterate-filter-search:focus-visible,
+.iterate-finding:focus-visible, .iterate-switch:focus-visible {
+  outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 2px;
+}
+
+/* Dashboard empty/onboarding state */
+.iterate-dashboard-empty { opacity: 0.75; }
+.iterate-empty-hint { font-size: 12px; color: var(--dsw-alias-label-secondary); }
+
+/* Convergence-completed progress fill */
+.iterate-progress-fill-done { background: var(--dsw-alias-state-success-primary); }
+
+/* Batch scope segmented control */
+.iterate-batch-scope { opacity: 0.6; }
+.iterate-batch-scope-on { opacity: 1; border-color: var(--dsw-alias-brand-primary); color: var(--dsw-alias-label-primary); }
+
+/* Overflow dimension chip */
+.iterate-dim-more { opacity: 0.7; font-style: italic; }
+
 /* Button variants */
 .iterate-btn[data-ghost] { background: transparent; }
 .iterate-btn[data-danger] { border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent); color: var(--dsw-alias-state-error-primary); background: transparent; }
@@ -343,6 +461,38 @@ const ITERATE_CSS = `
 .iterate-guide { margin-top: 4px; border: 1px solid var(--dsw-alias-border-l1); border-radius: 10px; overflow: hidden; background: var(--dsw-alias-bg-layer-2); }
 .iterate-guide-bar { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 8px 12px; background: var(--dsw-alias-bg-layer-2); border-bottom: 1px solid var(--dsw-alias-border-l1); font-size: 12px; color: var(--dsw-alias-label-secondary); }
 .iterate-guide-body { padding: 12px 14px; font-family: var(--dsw-font-mono, ui-monospace, monospace); font-size: 11.5px; line-height: 1.75; white-space: pre-wrap; color: var(--dsw-alias-label-primary); max-height: 260px; overflow: auto; }
+
+/* ── Runtime observatory panel ──────────────────────────────────────────── */
+.iterate-obs { margin: 6px 0; border: 1px solid var(--dsw-alias-border-l1); border-radius: 12px; background: var(--dsw-alias-bg-layer-1); overflow: hidden; font-size: 12px; color: var(--dsw-alias-label-primary); }
+.iterate-obs-head { display: flex; align-items: center; gap: 10px; padding: 8px 14px; cursor: pointer; border-bottom: 1px solid var(--dsw-alias-border-l1); flex-wrap: wrap; }
+.iterate-obs-head[data-closed] { border-bottom: none; }
+.iterate-obs-title { font-weight: 650; }
+.iterate-obs-badge { display: inline-flex; align-items: center; gap: 6px; padding: 2px 10px; border-radius: 999px; background: color-mix(in srgb, var(--dsw-alias-brand-primary) 12%, transparent); color: var(--dsw-alias-brand-primary); font-size: 11px; font-weight: 600; white-space: nowrap; }
+.iterate-obs-badge[data-live] { color: var(--dsw-alias-state-success-primary); background: color-mix(in srgb, var(--dsw-alias-state-success-primary) 12%, transparent); }
+.iterate-obs-head-meta { margin-left: auto; font-size: 11px; color: var(--dsw-alias-label-secondary); white-space: nowrap; }
+.iterate-obs-tabs { display: flex; gap: 4px; padding: 8px 14px 0; flex-wrap: wrap; border-bottom: 1px solid var(--dsw-alias-border-l1); }
+.iterate-obs-tab { padding: 4px 10px; border-radius: 7px; border: 1px solid var(--dsw-alias-border-l1); background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-secondary); font-size: 11px; cursor: pointer; }
+.iterate-obs-tab[data-active] { border-color: var(--dsw-alias-brand-primary); color: var(--dsw-alias-brand-primary); }
+.iterate-obs-body { padding: 12px 14px; max-height: 460px; overflow: auto; }
+.iterate-obs-block { border: 1px solid var(--dsw-alias-border-l1); border-radius: 8px; overflow: hidden; margin-bottom: 8px; }
+.iterate-obs-block:last-child { margin-bottom: 0; }
+.iterate-obs-block-head { display: flex; align-items: center; gap: 8px; padding: 7px 10px; background: var(--dsw-alias-bg-layer-2); border-bottom: 1px solid var(--dsw-alias-border-l1); font-size: 11px; color: var(--dsw-alias-label-primary); flex-wrap: wrap; }
+.iterate-obs-block-head[data-click] { cursor: pointer; }
+.iterate-obs-block-body { padding: 8px 10px; }
+.iterate-obs-chip { display: inline-flex; align-items: center; gap: 6px; padding: 2px 8px; border-radius: 6px; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l1); font-size: 11px; color: var(--dsw-alias-label-secondary); white-space: nowrap; }
+.iterate-obs-msg { padding: 2px 0; color: var(--dsw-alias-label-secondary); line-height: 1.5; font-size: 11px; word-break: break-word; }
+.iterate-obs-file { font-family: var(--dsw-font-mono, ui-monospace, monospace); font-size: 10.5px; color: var(--dsw-alias-label-secondary); word-break: break-all; }
+.iterate-obs-bar { display: flex; align-items: center; gap: 6px; font-size: 11px; color: var(--dsw-alias-label-secondary); flex-wrap: wrap; }
+.iterate-obs-bar b { color: var(--dsw-alias-label-primary); font-weight: 600; }
+.iterate-obs-mono { font-family: var(--dsw-font-mono, ui-monospace, monospace); }
+.iterate-obs-code { padding: 6px 8px; margin-top: 4px; border-radius: 6px; background: var(--dsw-alias-bg-layer-2); border: 1px solid var(--dsw-alias-border-l1); font-family: var(--dsw-font-mono, ui-monospace, monospace); font-size: 10.5px; color: var(--dsw-alias-label-secondary); white-space: pre-wrap; word-break: break-all; }
+.iterate-obs-input { width: 100%; padding: 8px; border: 1px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary); font-size: 11px; resize: vertical; }
+.iterate-obs-input:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 2px; }
+.iterate-obs-input::placeholder { color: var(--dsw-alias-label-secondary); }
+.iterate-obs-empty { font-size: 11px; color: var(--dsw-alias-label-secondary); padding: 8px 0; }
+.iterate-obs-row { display: flex; align-items: center; gap: 8px; padding: 5px 0; border-bottom: 1px solid var(--dsw-alias-border-l1); font-size: 11px; color: var(--dsw-alias-label-secondary); flex-wrap: wrap; }
+.iterate-obs-row:last-child { border-bottom: none; }
+.iterate-obs-livebadge { display: inline-flex; align-items: center; gap: 4px; padding: 1px 7px; border-radius: 6px; border: 1px solid currentColor; background: color-mix(in srgb, currentColor 10%, transparent); font-size: 10.5px; font-weight: 600; white-space: nowrap; }
 `
 
 // ─── Small helpers ───────────────────────────────────────────────────────────
@@ -402,16 +552,15 @@ function removeStorageByPrefix(prefix: string): number {
   return removed
 }
 
-/** Copy text to the clipboard, returning whether it succeeded. */
-function copyText(text: string): boolean {
+/** Copy text to the clipboard, resolving to whether it actually succeeded. */
+function copyText(text: string): Promise<boolean> {
   if (typeof navigator !== 'undefined' && navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
-    navigator.clipboard.writeText(text).then(
+    return navigator.clipboard.writeText(text).then(
       () => true,
       () => false,
     )
-    return true
   }
-  return false
+  return Promise.resolve(false)
 }
 
 /** Literal severity keys recognized by SEVERITY_LABEL / SEVERITY_COLOR. */
@@ -523,7 +672,14 @@ function TrendChart({ points }: { points: Array<{ round: number; count: number }
       style: { height: `${Math.max(4, Math.round((p.count / max) * 24))}px` },
     }),
   )
-  return React.createElement('div', { className: 'iterate-trend', title: '各轮发现数量趋势' }, ...bars)
+  // Accessible summary: the per-round counts are otherwise invisible to
+  // assistive tech (mouse-only title divs).
+  const summary = points.map((p) => `Round ${p.round}: ${p.count}`).join(', ')
+  return React.createElement('div', {
+    className: 'iterate-trend',
+    role: 'img',
+    'aria-label': `各轮发现数量趋势：${summary}`,
+  }, ...bars)
 }
 
 /** Dashboard: live convergence strip above the composer.
@@ -549,7 +705,16 @@ function ConvergenceDashboard(props: SlotProps) {
     setPulseKey((k) => k + 1)
   }, [report && hashReport(report) + ':' + getCurrentRound(report)])
 
-  if (!report) return null
+  if (!report) {
+    // Empty/onboarding state: first-time users otherwise see nothing and have
+    // no idea the plugin exists or how to start.
+    return React.createElement(
+      'div',
+      { 'data-iterate-root': '', 'data-iterate': 'dashboard', className: 'iterate-dashboard iterate-dashboard-empty' },
+      React.createElement('span', { className: 'iterate-round-badge' }, 'iterate'),
+      React.createElement('span', { className: 'iterate-empty-hint' }, '运行一次评审后，这里会显示收敛进度与发现统计。试试「review this project」或「/iterate review-only」'),
+    )
+  }
 
   const round = getCurrentRound(report)
   const total = getTotalRounds(report)
@@ -577,13 +742,25 @@ function ConvergenceDashboard(props: SlotProps) {
       }, `附件图片 ${String(imageCount)}`)
     : null
 
-  const dimBadges = Object.keys(dims).slice(0, 6).map((dim) =>
+  const dimNames = Object.keys(dims)
+  const dimBadges = dimNames.slice(0, 6).map((dim) =>
     React.createElement(
       'span',
       { key: dim, className: 'iterate-dim-badge' },
       `${dim} · ${(dims[dim]?.length ?? 0)}`,
     ),
   )
+  // Don't silently drop dimensions: surface the overflow as a +N chip.
+  const overflow = dimNames.length - 6
+  if (overflow > 0) {
+    dimBadges.push(
+      React.createElement(
+        'span',
+        { key: '+more', className: 'iterate-dim-badge iterate-dim-more', title: dimNames.slice(6).join(', ') },
+        `+${overflow} 更多`,
+      ),
+    )
+  }
 
   // Fix-count badge: show a running "fixes applied" metric when the report
   // carries a number (normal mode only — threaded through `fixedCount`).
@@ -599,6 +776,23 @@ function ConvergenceDashboard(props: SlotProps) {
       }, `${String(fixCount)} fixes`)
     : null
 
+  // Convergence is the payoff of the review — make it visible on the
+  // persistent dashboard, not only in the transient 3.6s capsule.
+  const converged = report.convergence && report.convergence.converged === true
+  const convChip = converged
+    ? React.createElement('span', {
+        className: 'iterate-chip-resume',
+        key: 'converged',
+        title: '审查已收敛：最后一轮未发现新问题',
+      }, '✓ 已收敛')
+    : null
+
+  const sevMetric = (key: 'critical' | 'high' | 'medium' | 'low', label: string) =>
+    React.createElement('span', { className: 'iterate-metric', key, title: label },
+      React.createElement('span', { className: 'iterate-sev-dot', style: { background: SEVERITY_COLOR[key] } }),
+      `${label} ${String(stats[key])}`,
+    )
+
   return React.createElement(
     'div',
     { 'data-iterate-root': '', 'data-iterate': 'dashboard', className: 'iterate-dashboard' },
@@ -608,20 +802,16 @@ function ConvergenceDashboard(props: SlotProps) {
       `Round ${round} / ${total}`,
     ),
     React.createElement('div', { className: 'iterate-progress' },
-      React.createElement('div', { className: 'iterate-progress-fill', style: { width: `${progress}%` } }),
-    ),
-    React.createElement('span', { className: 'iterate-metric' },
-      React.createElement('span', { className: 'iterate-sev-dot', style: { background: SEVERITY_COLOR.critical } }),
-      stats.critical,
-    ),
-    React.createElement('span', { className: 'iterate-metric' },
-      React.createElement('span', { className: 'iterate-sev-dot', style: { background: SEVERITY_COLOR.high } }),
-      stats.high,
-    ),
-    React.createElement('span', { className: 'iterate-metric' },
-      React.createElement('span', { className: 'iterate-sev-dot', style: { background: SEVERITY_COLOR.medium } }),
-      stats.medium,
+      React.createElement('div', {
+        className: converged ? 'iterate-progress-fill iterate-progress-fill-done' : 'iterate-progress-fill',
+        style: { width: `${progress}%` },
+      }),
     ),
+    convChip,
+    sevMetric('critical', 'CRIT'),
+    sevMetric('high', 'HIGH'),
+    sevMetric('medium', 'MED'),
+    sevMetric('low', 'LOW'),
     fixBadge,
     resumeChip,
     imageChip,
@@ -731,14 +921,15 @@ function TriagePanel(props: SlotProps) {
   const [selected, setSelected] = React.useState<number | null>(null)
   const [selectAll, setSelectAll] = React.useState(false)
 
-  /** Persist + return the next verdicts state. */
-  const persistVerdicts = (next: Record<string, 'keep' | 'skip' | 'ignore'>) => {
-    if (storage) storage.set(storageKey, JSON.stringify(next))
-    return next
-  }
+  /** Persist the verdicts to localStorage whenever they change. Kept OUT of
+   *  the state updater (updaters must stay pure — React may double-invoke them
+   *  under StrictMode, and a storage throw must not surface during render). */
+  React.useEffect(() => {
+    if (storage) storage.set(storageKey, JSON.stringify(verdicts))
+  }, [storageKey, verdicts])
 
   const setVerdict = (index: number, verdict: 'keep' | 'skip' | 'ignore') => {
-    setVerdicts((prev) => persistVerdicts({ ...prev, [String(index)]: verdict }))
+    setVerdicts((prev) => ({ ...prev, [String(index)]: verdict }))
   }
 
   // ── Filtering (visible findings + their original indices) ───────────────
@@ -757,13 +948,10 @@ function TriagePanel(props: SlotProps) {
   const allIndices = allVerdictKeys(verdicts)
   const batchTarget = selectAll ? allIndices : indices
   const applyBatch = (verdict: 'keep' | 'skip' | 'ignore') => {
-    setVerdicts((prev) => persistVerdicts(batchSetVerdict(prev, batchTarget, verdict)))
-  }
-  const applyBatchAll = (verdict: 'keep' | 'skip' | 'ignore') => {
-    setVerdicts((prev) => persistVerdicts(setAllVerdicts(prev, verdict)))
+    setVerdicts((prev) => batchSetVerdict(prev, batchTarget, verdict))
   }
   const doResetVerdicts = () => {
-    setVerdicts((prev) => persistVerdicts(setAllVerdicts(prev, 'keep')))
+    setVerdicts((prev) => setAllVerdicts(prev, 'keep'))
     setSelectAll(false)
   }
 
@@ -772,8 +960,13 @@ function TriagePanel(props: SlotProps) {
     const doc = typeof document !== 'undefined' ? document : null
     if (!doc) return
     const onKeyDown = (ev: KeyboardEvent) => {
+      // Never hijack modified shortcuts (Cmd/Ctrl/Alt combos like Cmd+A
+      // select-all) or keystrokes typed into an editable surface (the composer
+      // may be a contenteditable div, not a textarea).
+      if (ev.metaKey || ev.ctrlKey || ev.altKey) return
       const t = ev.target as HTMLElement | null
       if (t && (t.tagName === 'INPUT' || t.tagName === 'TEXTAREA' || t.tagName === 'SELECT')) return
+      if (t && typeof t.isContentEditable === 'boolean' && t.isContentEditable) return
       const verdict = keyToVerdict(ev.key)
       if (verdict && selected !== null && indices.includes(selected)) {
         ev.preventDefault()
@@ -807,10 +1000,16 @@ function TriagePanel(props: SlotProps) {
   const doCopyYaml = () => {
     const yaml = toKnownIntentionalYaml(ignored)
     if (!yaml) return
-    const ok = copyText(yaml)
-    setCopied(true)
-    setTimeout(() => setCopied(false), 1600)
-    if (!ok) setPayload(yaml)
+    copyText(yaml).then((ok) => {
+      if (ok) {
+        setCopied(true)
+        setTimeout(() => setCopied(false), 1600)
+      } else {
+        // Copy failed (permissions/unsupported) — reveal the payload as a
+        // manual-copy fallback instead of claiming success.
+        setPayload(yaml)
+      }
+    })
   }
 
   const doBuildInstruction = () => {
@@ -841,7 +1040,14 @@ function TriagePanel(props: SlotProps) {
       key: String(index),
       className: 'iterate-finding',
       'data-selected': isSelected ? '' : undefined,
+      role: 'option',
+      'aria-selected': isSelected,
+      tabIndex: 0,
       onClick: () => setSelected(index),
+      onFocus: () => setSelected(index),
+      onKeyDown: (e: React.KeyboardEvent) => {
+        if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); setSelected(index) }
+      },
     },
       React.createElement('div', { className: 'iterate-finding-meta' },
         React.createElement('span', { className: 'iterate-sev-dot', style: { background: severityColor(severity) } }),
@@ -861,17 +1067,17 @@ function TriagePanel(props: SlotProps) {
 
   return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'triage', className: 'iterate-triage' },
     React.createElement('div', { className: 'iterate-triage-head' },
-      React.createElement('span', {}, `Iterate · Findings 分诊 (${filtered.length}/${findings.length})`),
+      React.createElement('span', { role: 'heading', 'aria-level': 3 }, `Iterate · Findings 分诊 (${filtered.length}/${findings.length})`),
       React.createElement('span', { className: 'iterate-triage-hint' }, 'y=修复 · n=跳过 · a=已知有意 · ↑/↓ 选择'),
     ),
     React.createElement('div', { className: 'iterate-filter' },
-      React.createElement('select', { className: 'iterate-filter-select', value: filter.severities[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setSeverityFilter(e.target.value), title: '按严重度筛选' },
+      React.createElement('select', { className: 'iterate-filter-select', value: filter.severities[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setSeverityFilter(e.target.value), 'aria-label': '按严重度筛选' },
         React.createElement('option', { value: '' }, '全部严重度'),
         ...options.severities.map((s) =>
           React.createElement('option', { key: s.value, value: s.value }, `${severityLabel(s.value)} (${s.count})`),
         ),
       ),
-      React.createElement('select', { className: 'iterate-filter-select', value: filter.dimensions[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setDimensionFilter(e.target.value), title: '按维度筛选' },
+      React.createElement('select', { className: 'iterate-filter-select', value: filter.dimensions[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setDimensionFilter(e.target.value), 'aria-label': '按维度筛选' },
         React.createElement('option', { value: '' }, '全部维度'),
         ...options.dimensions.map((d) =>
           React.createElement('option', { key: d.value, value: d.value }, `${d.value} (${d.count})`),
@@ -881,6 +1087,7 @@ function TriagePanel(props: SlotProps) {
         className: 'iterate-filter-search',
         type: 'search',
         placeholder: '搜索文件 / 摘要…',
+        'aria-label': '搜索文件或摘要',
         value: filter.search,
         onChange: (e: React.ChangeEvent<HTMLInputElement>) => setSearchFilter(e.target.value),
       }),
@@ -891,26 +1098,35 @@ function TriagePanel(props: SlotProps) {
       ),
     ),
     React.createElement('div', { className: 'iterate-batch' },
-      React.createElement('span', { className: 'iterate-batch-label' }, '批量：'),
-      React.createElement('label', { className: 'iterate-batch-check', title: '勾选后批量按钮作用于全部 findings，否则仅当前可见' },
-        React.createElement('input', { type: 'checkbox', checked: selectAll, onChange: (e) => setSelectAll(e.target.checked) }),
-        selectAll ? `全部 ${allIndices.length}` : '全选',
-      ),
-      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('keep') }, '全部 y'),
-      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('skip') }, '全部 n'),
-      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('ignore') }, '全部 a'),
-      React.createElement('span', { className: 'iterate-batch-label', style: { marginLeft: 8 } }, '全部：'),
-      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatchAll('keep') }, 'y'),
-      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatchAll('skip') }, 'n'),
-      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatchAll('ignore') }, 'a'),
+      React.createElement('span', { className: 'iterate-batch-label' }, '批量作用于：'),
+      React.createElement('button', {
+        className: selectAll ? 'iterate-batch-btn iterate-batch-scope' : 'iterate-batch-btn iterate-batch-scope iterate-batch-scope-on',
+        onClick: () => setSelectAll(false),
+        title: '批量按钮仅作用于当前筛选可见的 findings',
+      }, `可见 ${indices.length}`),
+      React.createElement('button', {
+        className: selectAll ? 'iterate-batch-btn iterate-batch-scope iterate-batch-scope-on' : 'iterate-batch-btn iterate-batch-scope',
+        onClick: () => setSelectAll(true),
+        title: '批量按钮作用于全部 findings',
+      }, `全部 ${allIndices.length}`),
+      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('keep') }, 'y'),
+      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('skip') }, 'n'),
+      React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('ignore') }, 'a'),
       React.createElement('button', { className: 'iterate-batch-btn', onClick: doResetVerdicts, title: '把所有判定恢复为默认 y（修复）' }, '重置'),
     ),
     ...rows,
     React.createElement('div', { className: 'iterate-triage-foot' },
       React.createElement('span', {}, `y ${counts.keep} · n ${counts.skip} · a ${counts.ignore} · 待写回 known_intentional：${ignoredCount} 条`),
       React.createElement('span', { style: { display: 'flex', gap: 6 } },
-        React.createElement('button', { className: 'iterate-btn', 'data-primary': '', 'data-copied': copied ? '' : undefined, onClick: doCopyYaml }, copied ? '已复制' : '复制 known_intentional'),
-        React.createElement('button', { className: 'iterate-btn', onClick: doBuildInstruction }, '生成应用指令'),
+        React.createElement('button', {
+          className: 'iterate-btn', 'data-primary': '', 'data-copied': copied ? '' : undefined,
+          onClick: doCopyYaml, disabled: ignoredCount === 0,
+          title: ignoredCount === 0 ? '当前没有标记为「已知有意」的 finding' : '复制 known_intentional YAML',
+        }, copied ? '已复制' : `复制 known_intentional${ignoredCount > 0 ? `（${ignoredCount}）` : ''}`),
+        React.createElement('button', {
+          className: 'iterate-btn', onClick: doBuildInstruction, disabled: ignoredCount === 0,
+          title: ignoredCount === 0 ? '当前没有标记为「已知有意」的 finding' : '生成 iterate_triage 应用指令',
+        }, '生成应用指令'),
       ),
     ),
     payload
@@ -1031,10 +1247,11 @@ function SettingsPanel(_props: SlotProps) {
     setTimeout(() => setter(false), 1600)
   }
 
-  /** Copy a guide/status block; keep the copy button state in sync. */
+  /** Copy a guide/status block; flash success only when it actually copied. */
   const doCopy = (text: string, slot: 'guide' | 'status') => {
-    copyText(text)
-    flashCopied(slot)
+    copyText(text).then((ok) => {
+      if (ok) flashCopied(slot)
+    })
   }
 
   /** Two-step destroy guard: first click arms, second click clears. */
@@ -1160,6 +1377,525 @@ function SettingsPanel(_props: SlotProps) {
   )
 }
 
+// ─── Runtime observatory panel (F1–F7) ──────────────────────────────────────
+
+/** Tab id → label for the observatory's eight panels. Live (real-time activity
+ * stream) is first so it is the default view; F-panels follow. */
+const OBS_TABS = [
+  { key: 'live', label: '实时活动流' },
+  { key: 'f1', label: '审查线程' },
+  { key: 'f2', label: '收敛趋势' },
+  { key: 'f3', label: '发现定位' },
+  { key: 'f4', label: '修复与回滚' },
+  { key: 'f5', label: '断点恢复' },
+  { key: 'f6', label: '运行控制台' },
+  { key: 'f7', label: '决策时间线' },
+] as const
+
+/** Live subagent activity badges: type → Chinese label + dsw token color accent. */
+const OBS_LIVE_META: Record<string, { label: string; color: string }> = {
+  read: { label: '阅读', color: 'var(--dsw-alias-brand-primary)' },
+  fix: { label: '修复', color: 'var(--dsw-alias-state-success-primary)' },
+  rollback: { label: '回滚', color: 'var(--dsw-alias-state-error-primary)' },
+  diff: { label: '差异', color: 'var(--dsw-alias-state-warn-primary)' },
+  review: { label: '审查', color: 'var(--dsw-alias-brand-primary)' },
+  triage: { label: '分流', color: 'var(--dsw-alias-state-warn-primary)' },
+  checkpoint: { label: '断点', color: 'var(--dsw-alias-brand-primary)' },
+  validate: { label: '校验', color: 'var(--dsw-alias-state-success-primary)' },
+  log: { label: '记录', color: 'var(--dsw-alias-label-secondary)' },
+  prune: { label: '清理', color: 'var(--dsw-alias-state-warn-primary)' },
+  info: { label: '信息', color: 'var(--dsw-alias-label-secondary)' },
+}
+const OBS_LIVE_FALLBACK_COLOR = 'var(--dsw-alias-label-secondary)'
+
+/**
+ * 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 ''.
+ */
+function formatObsLiveTime(ts?: string): string {
+  if (!ts) return ''
+  let date: Date | null = null
+  const num = Number(ts)
+  if (typeof ts === 'string' && ts !== '' && !Number.isNaN(num) && /^\d+$/.test(ts)) {
+    date = new Date(num)
+  } else {
+    const d = new Date(ts)
+    date = Number.isNaN(d.getTime()) ? null : d
+  }
+  if (!date) return String(ts)
+  const p = (n: number) => String(n).padStart(2, '0')
+  const h = p(date.getHours())
+  const mi = p(date.getMinutes())
+  const s = p(date.getSeconds())
+  return `${p(date.getDate())}/${p(date.getMonth() + 1)} ${h}:${mi}:${s}`
+}
+
+/** Find the latest runtime-observatory manifest inside a session snapshot. */
+function latestTranscript(session: unknown): ObsManifest | null {
+  if (!session) return null
+  const raw = scanSessionForTranscript(session)
+  return raw ? normalizeTranscript(raw) as ObsManifest : null
+}
+
+/** Build a human-pasteable `iterate_fix` instruction for one finding. */
+function buildObsFixInstruction(f: ObsFinding): string {
+  const payload = JSON.stringify({
+    file: String(f.file || ''),
+    ...(typeof f.line === 'number' && f.line > 0 ? { line: f.line } : {}),
+    dimension: String(f.dimension || ''),
+    summary: String(f.summary || ''),
+    ...(f.suggested_fix ? { suggested_fix: String(f.suggested_fix) } : {}),
+  }, null, 2)
+  return `请调用 \`iterate_fix\` 修复以下 finding：\n\n\`\`\`json\n${payload}\n\`\`\``
+}
+
+/**
+ * ObservatoryPanel: an 8-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
+ * defensively guarded (optional chaining + fallbacks) so a partial/malformed
+ * manifest never crashes the slot. The client cannot call harness tools
+ * directly, so every action copies a paste-able instruction text instead.
+ */
+function ObservatoryPanel(props: SlotProps) {
+  const session = props && props.session ? props.session : null
+  const manifest = latestTranscript(session)
+
+  const [open, setOpen] = React.useState(false)
+  const [tab, setTab] = React.useState('live')
+  const [expandedThreads, setExpandedThreads] = React.useState<Set<string>>(new Set())
+  const [copiedKey, setCopiedKey] = React.useState<string | null>(null)
+  const [nudgeText, setNudgeText] = React.useState('')
+  const [timelineType, setTimelineType] = React.useState('')
+  const [timelineSearch, setTimelineSearch] = React.useState('')
+
+  // 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) }, [])
+
+  /** Copy an instruction, flashing "已复制" on the originating button only when the copy actually succeeded. */
+  const copyInstruction = (key: string, text: string) => {
+    if (!text) return
+    copyText(text).then((ok) => {
+      if (!ok) return
+      setCopiedKey(key)
+      if (copyTimer.current) clearTimeout(copyTimer.current)
+      copyTimer.current = setTimeout(() => setCopiedKey((cur) => (cur === key ? null : cur)), 1600)
+    })
+  }
+
+  const toggleThread = (key: string) => {
+    setExpandedThreads((prev) => {
+      const next = new Set(prev)
+      if (next.has(key)) next.delete(key); else next.add(key)
+      return next
+    })
+  }
+
+  // No observable transcript yet: show a compact, collapsed header row.
+  if (!manifest) {
+    return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'obs', className: 'iterate-obs' },
+      React.createElement('div', { className: 'iterate-obs-head', 'data-closed': '' },
+        React.createElement('span', { className: 'iterate-obs-title' }, 'iterate 观测台'),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, '暂无运行时观测数据'),
+      ),
+    )
+  }
+
+  const live = manifest.active === true
+  const roundMeta = typeof manifest.round === 'number'
+    ? (typeof manifest.maxRounds === 'number' ? `Round ${manifest.round}/${manifest.maxRounds}` : `Round ${manifest.round}`)
+    : ''
+  const headMeta = [manifest.mode || '', roundMeta, manifest.updatedAt || ''].filter(Boolean).join(' · ')
+
+  // ── F1: review threads ─────────────────────────────────────────────────
+  const threadFindingPill = (f: ObsFinding, keyBase: string) => {
+    const loc = `${String(f.file || '?')}${typeof f.line === 'number' && f.line > 0 ? `:${f.line}` : ''}`
+    return React.createElement('div', { key: keyBase, className: 'iterate-obs-row' },
+      React.createElement('span', { className: 'iterate-sev-dot', style: { background: severityColor(f.severity) } }),
+      React.createElement('span', {}, severityLabel(f.severity)),
+      React.createElement('span', { className: 'iterate-obs-file' }, loc),
+      React.createElement('span', {}, String(f.dimension || '')),
+      React.createElement('span', { className: 'iterate-obs-msg' }, String(f.summary || '')),
+    )
+  }
+
+  const renderThreads = () => {
+    const rounds = manifest.rounds || []
+    if (rounds.length === 0) {
+      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无审查线程')
+    }
+    return React.createElement('div', {}, ...rounds.map((r, ri) => {
+      const threads = r.threads || []
+      const fCount = threads.reduce((sum, t) => sum + (t.findings ? t.findings.length : 0), 0)
+      const threadBlocks = threads.length === 0
+        ? [React.createElement('div', { key: 'none', className: 'iterate-obs-empty' }, '本轮无线程')]
+        : threads.map((t, ti) => {
+            const key = `${ri}-${ti}`
+            const expanded = expandedThreads.has(key)
+            const dim = t.dimension || '未命名维度'
+            const tFindings = t.findings || []
+            const files = t.readFiles || []
+            const msgs = t.messages || []
+            return React.createElement('div', { key, className: 'iterate-obs-block' },
+              React.createElement('div', { className: 'iterate-obs-block-head', 'data-click': '', onClick: () => toggleThread(key), title: expanded ? '收起线程' : '展开线程' },
+                React.createElement('span', {}, expanded ? '−' : '+'),
+                React.createElement('b', {}, dim),
+                React.createElement('span', { className: 'iterate-obs-chip' }, `attempt ${typeof t.attempt === 'number' ? t.attempt : '?'}`),
+                React.createElement('span', { className: 'iterate-obs-chip' }, `${tFindings.length} findings`),
+              ),
+              expanded
+                ? React.createElement('div', { className: 'iterate-obs-block-body' },
+                    React.createElement('div', { className: 'iterate-obs-bar' },
+                      React.createElement('b', {}, '叙述'),
+                      React.createElement('span', { className: 'iterate-obs-head-meta' }, `${msgs.length} 条`),
+                    ),
+                    ...(msgs.length === 0
+                      ? [React.createElement('div', { key: 'msg-none', className: 'iterate-obs-empty' }, '无线索叙述')]
+                      : msgs.map((m, mi) => React.createElement('div', { key: mi, className: 'iterate-obs-msg' }, String(m)))),
+                    ...(files.length > 0
+                      ? [
+                          React.createElement('div', { key: 'files-h', className: 'iterate-obs-bar', style: { marginTop: 6 } },
+                            React.createElement('b', {}, '读取文件'),
+                          ),
+                          ...files.map((f, fi) =>
+                            React.createElement('div', { key: `f${fi}`, className: 'iterate-obs-file' }, String(f)),
+                          ),
+                        ]
+                      : []),
+                    React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
+                      React.createElement('b', {}, '发现'),
+                    ),
+                    ...(tFindings.length === 0
+                      ? [React.createElement('div', { key: 'finding-none', className: 'iterate-obs-empty' }, '本线程无发现')]
+                      : tFindings.map((f, fi) => threadFindingPill(f, `tf${fi}`))),
+                  )
+                : null,
+            )
+          })
+      return React.createElement('div', { key: ri, className: 'iterate-obs-block' },
+        React.createElement('div', { className: 'iterate-obs-block-head' },
+          React.createElement('b', {}, `Round ${typeof r.round === 'number' ? r.round : ri + 1}`),
+          React.createElement('span', { className: 'iterate-obs-chip' }, `${threads.length} 线程`),
+          React.createElement('span', { className: 'iterate-obs-head-meta' }, `${fCount} findings`),
+        ),
+        React.createElement('div', { className: 'iterate-obs-block-body' }, ...threadBlocks),
+      )
+    }))
+  }
+
+  // ── 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' }, '暂无收敛数据')
+    }
+    const points = conv.map((n, i) => ({ round: i + 1, count: n }))
+    return React.createElement('div', {},
+      React.createElement(TrendChart, { points }),
+      React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
+        `各轮发现数量：${conv.join(' → ')}${typeof manifest.round === 'number' ? ` · 当前 Round ${manifest.round}` : ''}`,
+      ),
+    )
+  }
+
+  // ── F3: finding location + action copy buttons ─────────────────────────
+  const renderFindings = () => {
+    const findings = manifest.findings || []
+    if (findings.length === 0) {
+      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无发现')
+    }
+    return React.createElement('div', {}, ...findings.map((f, i) => {
+      const k = `f3-${i}`
+      const loc = `${String(f.file || '?')}${typeof f.line === 'number' && f.line > 0 ? `:${f.line}` : ''}`
+      const entry = {
+        file: String(f.file || ''),
+        ...(typeof f.line === 'number' && f.line > 0 ? { line: f.line } : {}),
+        dimension: String(f.dimension || ''),
+        reason: String(f.summary || ''),
+      }
+      const knownInstruction = buildApplyInstruction([entry])
+      const fixInstruction = buildObsFixInstruction(f)
+      return React.createElement('div', { key: k, className: 'iterate-obs-block' },
+        React.createElement('div', { className: 'iterate-obs-block-head' },
+          React.createElement('span', { className: 'iterate-sev-dot', style: { background: severityColor(f.severity) } }),
+          React.createElement('span', {}, severityLabel(f.severity)),
+          React.createElement('span', { className: 'iterate-obs-file' }, loc),
+          React.createElement('span', {}, String(f.dimension || '')),
+          f.acknowledged === true
+            ? React.createElement('span', { className: 'iterate-obs-chip' }, '已确认')
+            : null,
+        ),
+        React.createElement('div', { className: 'iterate-obs-block-body' },
+          React.createElement('div', { className: 'iterate-obs-msg' }, String(f.summary || '')),
+          React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 8 } },
+            React.createElement('button', {
+              className: 'iterate-btn', 'data-copied': copiedKey === `${k}-fix` ? '' : undefined,
+              onClick: () => copyInstruction(`${k}-fix`, String(f.suggested_fix || '')),
+              title: '复制该 finding 的建议修复文本',
+            }, copiedKey === `${k}-fix` ? '已复制' : '复制 suggested_fix'),
+            React.createElement('button', {
+              className: 'iterate-btn', 'data-copied': copiedKey === `${k}-known` ? '' : undefined,
+              onClick: () => copyInstruction(`${k}-known`, knownInstruction),
+              title: '复制 iterate_triage 指令文本（标记为 known_intentional）',
+            }, copiedKey === `${k}-known` ? '已复制' : 'known_intentional'),
+            React.createElement('button', {
+              className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === `${k}-repair` ? '' : undefined,
+              onClick: () => copyInstruction(`${k}-repair`, fixInstruction),
+              title: '复制 iterate_fix 指令文本',
+            }, copiedKey === `${k}-repair` ? '已复制' : '复制修复指令'),
+          ),
+        ),
+      )
+    }))
+  }
+
+  // ── F4: fixes + rollback ───────────────────────────────────────────────
+  const renderFixes = () => {
+    const fixes = manifest.fixes || []
+    if (fixes.length === 0) {
+      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无修复记录')
+    }
+    return React.createElement('div', {}, ...fixes.map((f, i) => {
+      const k = `f4-${i}`
+      const id = String(f.id || `fix#${i + 1}`)
+      const rollbackText = `请调用 \`iterate_rollback\` 回滚以下修复：\n\n\`\`\`json\n${JSON.stringify({ id }, null, 2)}\n\`\`\``
+      const added = typeof f.linesAdded === 'number' ? f.linesAdded : 0
+      const removed = typeof f.linesRemoved === 'number' ? f.linesRemoved : 0
+      return React.createElement('div', { key: k, className: 'iterate-obs-block' },
+        React.createElement('div', { className: 'iterate-obs-block-head' },
+          React.createElement('b', {}, id),
+          React.createElement('span', { className: 'iterate-obs-file' }, String(f.file || '?')),
+          React.createElement('span', { className: 'iterate-obs-chip' }, f.success === true ? '成功' : '失败'),
+          typeof f.round === 'number'
+            ? React.createElement('span', { className: 'iterate-obs-head-meta' }, `Round ${f.round}`)
+            : null,
+        ),
+        React.createElement('div', { className: 'iterate-obs-block-body' },
+          React.createElement('div', { className: 'iterate-obs-msg' }, String(f.summary || '')),
+          React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 8 } },
+            React.createElement('span', { className: 'iterate-obs-chip' }, `+${added}`),
+            React.createElement('span', { className: 'iterate-obs-chip' }, `−${removed}`),
+            React.createElement('button', {
+              className: 'iterate-btn', 'data-danger': '', 'data-copied': copiedKey === `${k}-rb` ? '' : undefined,
+              onClick: () => copyInstruction(`${k}-rb`, rollbackText),
+              title: '复制 iterate_rollback 指令文本',
+            }, copiedKey === `${k}-rb` ? '已复制' : '回滚'),
+          ),
+        ),
+      )
+    }))
+  }
+
+  // ── F5: checkpoint resume ──────────────────────────────────────────────
+  const renderCheckpoint = () => {
+    const cp = manifest.checkpoint
+    if (!cp) {
+      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无断点')
+    }
+    const resumeText = `请调用 \`iterate_checkpoint\` 从断点恢复迭代：\n\n\`\`\`json\n${JSON.stringify({
+      operation: 'resume',
+      mode: String(cp.mode || 'normal'),
+      maxRounds: typeof cp.maxRounds === 'number' ? cp.maxRounds : null,
+    }, null, 2)}\n\`\`\``
+    const item = (label: string, value: unknown) =>
+      React.createElement('span', { className: 'iterate-obs-chip' }, `${label} ${String(value ?? '?')}`)
+    return React.createElement('div', { className: 'iterate-obs-block' },
+      React.createElement('div', { className: 'iterate-obs-block-head' },
+        React.createElement('b', {}, '断点'),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, String(cp.updatedAt || '')),
+      ),
+      React.createElement('div', { className: 'iterate-obs-block-body' },
+        React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
+          item('mode', cp.mode || 'normal'),
+          item('round', cp.round),
+          item('maxRounds', cp.maxRounds),
+          item('fixed', cp.fixedCount),
+          item('resume', cp.resumeCount),
+        ),
+        React.createElement('button', {
+          className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'cp-resume' ? '' : undefined,
+          onClick: () => copyInstruction('cp-resume', resumeText),
+          title: '复制 iterate_checkpoint 综/恢复指令文本',
+        }, copiedKey === 'cp-resume' ? '已复制' : '复制恢复指令'),
+      ),
+    )
+  }
+
+  // ── F6: run console (status / approval / nudge draft) ──────────────────
+  const renderConsole = () => {
+    const approval = manifest.approval || { policy: 'ask' }
+    const policyLabelMap: Record<string, string> = { ask: '询问用户', deny: '拒绝', allow: '直接执行' }
+    const policyLabel = policyLabelMap[String(approval.policy || 'ask')] || String(approval.policy || 'ask')
+    const nudge = manifest.nudge || null
+    const present = Boolean(nudge && nudge.text)
+    const activeNudgeText = nudge && nudge.text ? nudge.text : ''
+    const nudgeInstruction = `请调用 \`iterate_transcript\` 写入 nudge 指令：\n\n\`\`\`json\n${JSON.stringify({ operation: 'nudge', text: nudgeText }, null, 2)}\n\`\`\``
+    return React.createElement('div', { className: 'iterate-obs-block' },
+      React.createElement('div', { className: 'iterate-obs-block-head' },
+        React.createElement('span', {}, '运行控制台'),
+        React.createElement('span', { className: 'iterate-obs-badge', 'data-live': live ? '' : undefined }, live ? '运行中' : '已结束'),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, `批准策略：${policyLabel}`),
+      ),
+      React.createElement('div', { className: 'iterate-obs-block-body' },
+        present
+          ? React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 6 } },
+              React.createElement('b', {}, '当前 nudge'),
+              React.createElement('span', { className: 'iterate-obs-msg' }, activeNudgeText),
+              React.createElement('button', { className: 'iterate-btn', onClick: () => setNudgeText('') }, '清除'),
+            )
+          : null,
+        React.createElement('textarea', {
+          className: 'iterate-obs-input iterate-obs-mono',
+          rows: 3,
+          placeholder: '起草一条 nudge 方向指令…',
+          value: nudgeText,
+          'aria-label': 'nudge 草稿',
+          onChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => setNudgeText(e.target.value),
+        }),
+        React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
+          React.createElement('button', {
+            className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'nudge' ? '' : undefined,
+            disabled: !nudgeText,
+            onClick: () => copyInstruction('nudge', nudgeInstruction),
+            title: '复制 iterate_transcript nudge 指令文本',
+          }, copiedKey === 'nudge' ? '已复制' : '复制 nudge 指令'),
+        ),
+      ),
+    )
+  }
+
+  // ── F7: decision timeline (type filter + search, newest first) ──────────
+  const renderTimeline = () => {
+    const entries = manifest.timeline || []
+    if (entries.length === 0) {
+      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无时间线条目')
+    }
+    const types = Array.from(new Set(entries.map((t) => String(t.type || 'unknown')).filter(Boolean))).sort()
+    const q = timelineSearch.trim().toLowerCase()
+    const filtered = entries.filter((t) => {
+      if (timelineType && String(t.type || '') !== timelineType) return false
+      if (!q) return true
+      const hay = [String(t.type || ''), String(t.round ?? ''), JSON.stringify(t.data || {})].join(' ').toLowerCase()
+      return hay.indexOf(q) >= 0
+    })
+    // Newest first: entries are not guaranteed to be reverse ordered in the
+    // manifest, so sort by timestamp string descending for a stable timeline.
+    const sorted = filtered.slice().sort((a, b) => String(b.timestamp || '').localeCompare(String(a.timestamp || '')))
+    const rows = sorted.map((t, i) => {
+      const k = `f7-${i}`
+      const dataText = t.data && typeof t.data === 'object' ? JSON.stringify(t.data) : ''
+      return React.createElement('div', { key: k, className: 'iterate-obs-row', style: { flexDirection: 'column', alignItems: 'flex-start' } },
+        React.createElement('div', { className: 'iterate-obs-bar', style: { width: '100%' } },
+          React.createElement('span', { className: 'iterate-obs-chip' }, String(t.type || '?')),
+          React.createElement('span', { className: 'iterate-obs-head-meta' },
+            `${typeof t.round === 'number' ? `Round ${t.round} · ` : ''}${String(t.timestamp || '')}`,
+          ),
+        ),
+        dataText ? React.createElement('div', { className: 'iterate-obs-code' }, dataText) : null,
+      )
+    })
+    if (rows.length === 0) {
+      return React.createElement('div', { className: 'iterate-obs-empty' }, '无匹配的时间线条目')
+    }
+    return React.createElement('div', {},
+      React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
+        React.createElement('select', {
+          className: 'iterate-filter-select',
+          value: timelineType,
+          'aria-label': '按时间线类型筛选',
+          onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setTimelineType(e.target.value),
+        },
+          React.createElement('option', { value: '' }, '全部类型'),
+          ...types.map((t) => React.createElement('option', { key: t, value: t }, t)),
+        ),
+        React.createElement('input', {
+          className: 'iterate-filter-search',
+          type: 'search',
+          placeholder: '搜索时间线…',
+          'aria-label': '搜索时间线',
+          value: timelineSearch,
+          onChange: (e: React.ChangeEvent<HTMLInputElement>) => setTimelineSearch(e.target.value),
+        }),
+        React.createElement('span', { className: 'iterate-filter-count' }, `${filtered.length}/${entries.length}`),
+      ),
+      ...rows,
+    )
+  }
+
+  // ── Live: real-time secondary-subagent activity stream (newest first) ─────
+  const renderLive = () => {
+    const liveEntries = manifest.live || []
+    if (liveEntries.length === 0) {
+      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无实时活动')
+    }
+    const rows = liveEntries.map((e, i) => {
+      const type = String(e.type || 'unknown')
+      const meta = OBS_LIVE_META[type] || { label: String(e.type || '?'), color: OBS_LIVE_FALLBACK_COLOR }
+      const tool = String(e.tool || '')
+      const target = String(e.target || '')
+      const time = formatObsLiveTime(e.ts)
+      return React.createElement('div', { key: `live-${i}`, className: 'iterate-obs-row' },
+        React.createElement('span', { className: 'iterate-obs-livebadge', style: { color: meta.color } }, meta.label),
+        tool
+          ? React.createElement('span', { className: 'iterate-obs-chip' }, tool)
+          : null,
+        React.createElement('span', { className: 'iterate-obs-msg' }, target || '—'),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, time),
+      )
+    })
+    return React.createElement('div', {},
+      React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
+        React.createElement('b', {}, '实时活动'),
+        React.createElement('span', { className: 'iterate-obs-chip' }, `${liveEntries.length} 项`),
+      ),
+      ...rows,
+    )
+  }
+
+  const renderBody = () => {
+    switch (tab) {
+      case 'live': return renderLive()
+      case 'f1': return renderThreads()
+      case 'f2': return renderTrend()
+      case 'f3': return renderFindings()
+      case 'f4': return renderFixes()
+      case 'f5': return renderCheckpoint()
+      case 'f6': return renderConsole()
+      case 'f7': return renderTimeline()
+      default: return null
+    }
+  }
+
+  return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'obs', className: 'iterate-obs' },
+    React.createElement('div', { className: 'iterate-obs-head', 'data-closed': open ? undefined : '', onClick: () => setOpen((v) => !v) },
+      React.createElement('span', { className: 'iterate-obs-title' }, 'iterate 观测台'),
+      React.createElement('span', { className: 'iterate-obs-badge', 'data-live': live ? '' : undefined }, live ? '运行中' : '已结束'),
+      React.createElement('span', { className: 'iterate-obs-head-meta' }, headMeta || 'runtime'),
+      React.createElement('button', {
+        className: 'iterate-btn', 'data-ghost': '',
+        onClick: (e: React.MouseEvent<HTMLButtonElement>) => { e.stopPropagation(); setOpen((v) => !v) },
+      }, open ? '收起' : '展开'),
+    ),
+    open
+      ? React.createElement('div', {},
+          React.createElement('div', { className: 'iterate-obs-tabs' },
+            ...OBS_TABS.map((t) =>
+              React.createElement('button', {
+                key: t.key,
+                className: 'iterate-obs-tab',
+                'data-active': tab === t.key ? '' : undefined,
+                onClick: () => setTab(t.key),
+              }, t.label),
+            ),
+          ),
+          React.createElement('div', { className: 'iterate-obs-body' }, renderBody()),
+        )
+      : null,
+  )
+}
+
 // ─── Registration ────────────────────────────────────────────────────────────
 
 /**
@@ -1215,6 +1951,15 @@ export function apply(ctx: ClientContext): void {
       ),
     )
 
+    // F1–F7: 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(
+        { name: 'conversation.input.dock', id: 'iterate-observatory', order: 91 },
+        (props) => React.createElement(ObservatoryPanel, props),
+      ),
+    )
+
     // 2 + 3: triage panel / stats card (turn-tail chain, session scope).
     slotsSvc.inject('conversation.chat.turnTail', () =>
       slotsSvc?.register(