@joekytc/dsh-swarm 0.3.1 → 0.3.6

package/README.md

@@ -136,7 +136,7 @@ All keys are optional; schema lives in `src/config.ts`. **Most users only need t
 | `dispatcher.maxRetries` | `3` | Failure retries before circuit → `blocked(gave_up)` |
 | `dispatcher.heartbeatIntervalSeconds` | `300` | Watchdog heartbeat period |
 | `dispatcher.maxProtocolViolations` | `2` | Protocol-violation guardrail: after this many consecutive violations the next one is final (`gave_up`) |
-| `dispatcher.maxReworksPerRole` | `{ pt: 2, dt: 3 }` | Max review rework rounds before `review/gave-up` + `[review-final]` |
+| `dispatcher.maxReworksPerRole` | `{ pt: 3, dt: 3 }` | Max review rework rounds before `review/gave-up` + `[review-final]` |
 | `prefixRoutes.plan` | `/plan:` | Command-mode planning prefix |
 | `prefixRoutes.openspec` | `/openspec:` | Command-mode approve-and-execute prefix |
 | `ui.enabled` | `true` | Enable the kanban web tab |
@@ -298,12 +298,19 @@ blocks the save, and chain creation mounts the checklist as the `file-prefetch`
 #### Rework (review failure)
 
 A failed review never mutates a `done` card. Instead the system records
-`review/failed`, creates a **rework task** (`[返工] ...`) that inherits the source's
-session (`resumeSessionId`), `reviewAttempt + 1`, and starts as `todo`
-(`reviewStatus: 'pending'`), then re-dispatches a fresh review card for the rework.
-When `reviewAttempt` reaches `maxReworksPerRole` (PT 2 / DT 3), the system records
-`review/gave-up` and posts a `[review-final]` evidence-chain comment; the pipeline
-stalls at the review stage for human intervention.
+`review/failed`, creates a **rework task** (`[返工] ...`) with its own session
+(`kbn-<reworkId>`, `resumeSessionId = null`), `reviewAttempt + 1`, and starts as
+`todo` (`reviewStatus: 'pending'`). The rework card body additionally carries the
+previous round's issues verbatim in a `## 本轮修复清单` (fix-this-round) section.
+A fresh review card is then dispatched for the rework.
+When `reviewAttempt` reaches `maxReworksPerRole` (PT 3 / DT 3), the system records
+`review/gave-up` and posts a `[review-final]` evidence-chain comment, and (with IM
+delivery enabled) sends a `[评审超限待裁决]` notification with two exit paths:
+waive the review (`kanban_waive_review` / GUI “豁免评审”) or reopen the chain
+(`kanban_reopen_chain` / GUI “人工恢复”). **Convergence gate (2026-09-15)**: on PT
+rework rounds, once all legacy issues are resolved and no unresolved `critical`
+remains, a `fail` verdict is downgraded to `pass` (new findings flow downstream as
+non-blocking suggestions), so the loop always converges.
 
 #### Failure recovery
 

package/README.zh-CN.md

@@ -138,7 +138,7 @@ p ──> (pt?) ──> w2 ──> d ──> dt ──> w3 ──> summary
 | `dispatcher.maxRetries` | `3` | 失败重试上限，超出进入熔断 → `blocked(gave_up)` |
 | `dispatcher.heartbeatIntervalSeconds` | `300` | 看门狗心跳周期 |
 | `dispatcher.maxProtocolViolations` | `2` | 协议违规护栏：连续违规超过该次数后，下一次即终局（`gave_up`） |
-| `dispatcher.maxReworksPerRole` | `{ pt: 2, dt: 3 }` | 评审返工轮数上限，超出进入 `review/gave-up` + `[review-final]` |
+| `dispatcher.maxReworksPerRole` | `{ pt: 3, dt: 3 }` | 评审返工轮数上限，超出进入 `review/gave-up` + `[review-final]` |
 | `prefixRoutes.plan` | `/plan:` | 命令模式阶段 0 规划前缀 |
 | `prefixRoutes.openspec` | `/openspec:` | 命令模式批准并执行前缀 |
 | `ui.enabled` | `true` | 启用看板 Web 标签页 |
@@ -290,10 +290,15 @@ D 只有带 `tdd` 才能完成——`test_files`（含 `test_first`）或 `skipp
 #### 返工（评审失败）
 
 评审失败**从不改写** `done` 卡。系统改为记录 `review/failed`，创建**返工任务**
-（`[返工] ...`），继承源会话（`resumeSessionId`）、`reviewAttempt + 1`，初始为
-`todo`（`reviewStatus: 'pending'`），然后为返工重新派发全新评审卡。当 `reviewAttempt`
-达到 `maxReworksPerRole`（PT 2 / DT 3）时，系统记录 `review/gave-up` 并发布
-`[review-final]` 证据链评论；管线停在评审阶段等待人类介入。
+（`[返工] ...`）——独立会话（`kbn-<reworkId>`，`resumeSessionId = null`）、
+`reviewAttempt + 1`，初始为 `todo`（`reviewStatus: 'pending'`）；返工卡 body 追加
+「本轮修复清单」节（携带上一轮 issues 全文），然后为返工重新派发全新评审卡。
+当 `reviewAttempt` 达到 `maxReworksPerRole`（PT 3 / DT 3）时，系统记录
+`review/gave-up` 并发布 `[review-final]` 证据链评论，同时（启用 IM 投递时）发出
+`[评审超限待裁决]` 通知，附两条出口：豁免评审（`kanban_waive_review` / GUI「豁免评审」）
+或人工恢复链（`kanban_reopen_chain` / GUI「人工恢复」）。**收敛闸（2026-09-15）**：
+PT 复审轮中旧账清零且无未解决 `critical` 时，fail 自动降级为 pass（新发现转下游
+非阻塞建议），循环必然收敛。
 
 #### 故障恢复
 

package/client/KanbanBoard.tsx

@@ -126,7 +126,7 @@ export function KanbanBoard(props: {
         readOnly={task.status === 'archived'}
         onRetry={failedAction && failedAction.taskId === task.id ? () => void runAction(failedAction.action) : undefined}
         onComment={(body) => void runAction({ type: 'comment', taskId: task.id, body })}
-        onAction={(action) => void runAction(action)}
+        onAction={(action) => runAction(action)}
         onClose={() => history.back()}
       />
     );
@@ -160,6 +160,8 @@ export function KanbanBoard(props: {
         onOpenView={props.onOpenView}
         onConfirmAudit={(chainId) => void runAction({ type: 'confirm-audit', chainId })}
         onRenameChain={(chainId, title) => void runAction({ type: 'rename', chainId, title })}
+        // 2026-09-15 恢复能力：直连 postAction（失败 throw 由弹窗展示；无乐观更新，走服务端事件收敛）
+        onReopenChain={(chainId, reason) => props.postAction({ type: 'reopen-chain', chainId, reason }).then(() => undefined)}
         onDeleteChain={async (chainId) => {
           // 直连 postAction：失败 throw 上抛删除弹窗展示（runAction 吞错仅服务 TaskDrawer 重试条）
           await props.postAction({ type: 'delete', chainId });

package/client/TaskDrawer.tsx

@@ -37,14 +37,23 @@ export function TaskDrawer(props: {
   readOnly?: boolean;
   onRetry?: () => void;
   onComment(body: string): void;
-  onAction(action: { type: string; taskId: string; reason?: string; summary?: string; metadata?: Record<string, unknown>; body?: string }): void;
+  onAction(action: { type: string; taskId: string; reason?: string; summary?: string; metadata?: Record<string, unknown>; body?: string }): void | Promise<unknown>;
   onClose(): void;
 }) {
   const { task, events, handoff, specCard, chain } = props;
   const [tab, setTab] = useState<string>('overview');
-  const [pending, setPending] = useState<{ kind: 'archive'; value: string } | null>(null);
+  const [pending, setPending] = useState<{ kind: 'archive' | 'waive'; value: string } | null>(null);
+  // 2026-09-15：豁免弹窗反馈三态（校验提示 / 在途 / 成功）——此前点击无任何反馈
+  const [waiveError, setWaiveError] = useState<string | null>(null);
+  const [waiveBusy, setWaiveBusy] = useState(false);
+  const [waiveOk, setWaiveOk] = useState(false);
   const timeline = events.filter((e) => e.taskId === task.id).toSorted((a, b) => a.seq - b.seq);
   const comments = timeline.filter((e) => e.kind === 'task/commented');
+  // 2026-09-15 恢复能力：评审卡存在 failed/gave-up 结论 → 可人工豁免（理由必填，审计留痕）。
+  const reviewOutcome = task.mode === 'review-plan' || task.mode === 'review-impl'
+    ? events.filter((e) => e.taskId === task.id && e.kind.startsWith('review/')).at(-1)?.kind ?? null
+    : null;
+  const canWaive = (reviewOutcome === 'review/failed' || reviewOutcome === 'review/gave-up');
   const submitComment = (el: HTMLInputElement) => {
     const value = el.value.trim();
     if (!value) return;
@@ -62,6 +71,26 @@ export function TaskDrawer(props: {
     setPending(null);
     props.onAction({ type: 'archive', taskId: task.id });
   };
+  /** 豁免提交（2026-09-15）：校验必给反馈 + 在途禁用 + 成功显式提示；失败保留输入可重试。 */
+  const submitWaive = async () => {
+    if (pending?.kind !== 'waive') return;
+    const reason = pending.value.trim();
+    if (!reason) {
+      setWaiveError('请填写豁免理由（必填，用于审计留痕）');
+      return;
+    }
+    setWaiveError(null);
+    setWaiveBusy(true);
+    try {
+      await props.onAction({ type: 'waive-review', taskId: task.id, reason });
+      setWaiveOk(true);
+      window.setTimeout(() => { setPending(null); setWaiveOk(false); }, 800);
+    } catch (err) {
+      setWaiveError('豁免失败：' + String(err));
+    } finally {
+      setWaiveBusy(false);
+    }
+  };
   return (
     <div className="dsh-kb-detail">
       <header className="dsh-kb-detail__header">
@@ -83,6 +112,14 @@ export function TaskDrawer(props: {
               {pending?.kind === 'archive' ? '确认归档' : '归档'}
             </button>
           )}
+          {canWaive && (
+            <button
+              type="button"
+              onClick={() => { setPending({ kind: 'waive', value: '' }); setWaiveError(null); setWaiveOk(false); }}
+            >
+              豁免评审
+            </button>
+          )}
           </div>
         )}
       </header>
@@ -209,6 +246,41 @@ export function TaskDrawer(props: {
           )}
         </section>
       )}
+      {/* 豁免评审弹窗（2026-09-15）：由行内编辑改为弹窗确认——行内输入框会挤压 header 按钮（文字被迫竖排） */}
+      {!props.readOnly && pending?.kind === 'waive' && (
+        <div className="dsh-kb-rename-overlay" onClick={(e) => { e.stopPropagation(); if (!waiveBusy) { setPending(null); setWaiveError(null); } }}>
+          <div
+            className="dsh-kb-rename-modal"
+            role="dialog"
+            aria-modal="true"
+            aria-label="豁免评审"
+            onClick={(e) => e.stopPropagation()}
+          >
+            <div className="dsh-kb-rename-modal__label">豁免评审</div>
+            <div className="dsh-kb-delete-modal__text">
+              豁免「{task.title}」（{task.id}）的评审结论：被评审卡置为 waived，链路按评审通过继续推进（该评审的遗留问题仍作为非阻塞建议传下游）。请填写豁免理由。
+            </div>
+            <input
+              className="dsh-kb-comment-input"
+              aria-label="豁免理由"
+              placeholder="豁免理由（必填）"
+              autoFocus
+              value={pending.value}
+              onChange={(e) => { setPending({ kind: 'waive', value: e.target.value }); if (waiveError) setWaiveError(null); }}
+              onKeyDown={(e) => { if (e.key === 'Enter') void submitWaive(); }}
+            />
+            <div className="dsh-kb-rename-modal__hint">豁免理由必填（审计留痕）；填写后点「确认豁免」。</div>
+            {waiveError && <div className="dsh-kb-delete-modal__error" role="alert">{waiveError}</div>}
+            {waiveOk && <div className="dsh-kb-rename-modal__success" role="status">✓ 已豁免，链路将继续推进</div>}
+            <div className="dsh-kb-rename-modal__actions">
+              <button type="button" className="dsh-kb-rename-cancel" disabled={waiveBusy} onClick={() => { setPending(null); setWaiveError(null); }}>取消</button>
+              <button type="button" className="dsh-kb-rename-save" disabled={waiveBusy || waiveOk} onClick={() => void submitWaive()}>
+                {waiveOk ? '已豁免' : waiveBusy ? '豁免中…' : '确认豁免'}
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
     </div>
   );
 }

package/client/WorkflowRail.tsx

@@ -30,6 +30,8 @@ export function WorkflowRail(props: {
   onRenameChain?(chainId: string, title: string): void;
   /** 整链硬删除（POST /kanban/action {type:'delete', chainId}）；失败 throw 由弹窗展示。 */
   onDeleteChain?(chainId: string): Promise<void>;
+  /** 人工恢复被 blocked 的链（POST /kanban/action {type:'reopen-chain', chainId, reason}）；失败 throw 由弹窗展示。 */
+  onReopenChain?(chainId: string, reason: string): Promise<void>;
 }) {
   const searching = props.query.trim().length > 0;
   const visible = props.chains.filter((view) => matches(view, props.query));
@@ -37,6 +39,38 @@ export function WorkflowRail(props: {
   const renamingChain = renamingChainId ? props.chains.find((v) => v.chain.id === renamingChainId)?.chain : undefined;
   const [deletingChainId, setDeletingChainId] = useState<string | null>(null);
   const [deleteError, setDeleteError] = useState<string | null>(null);
+  // 2026-09-15 恢复能力：blocked 链 → 人工恢复（理由必填，审计留痕）。
+  const [reopeningChainId, setReopeningChainId] = useState<string | null>(null);
+  const [reopenReason, setReopenReason] = useState('');
+  const [reopenError, setReopenError] = useState<string | null>(null);
+  const [reopenBusy, setReopenBusy] = useState(false);
+  const [reopenOk, setReopenOk] = useState(false);
+  const reopeningView = reopeningChainId ? props.chains.find((v) => v.chain.id === reopeningChainId) : undefined;
+  const closeReopen = () => {
+    setReopeningChainId(null);
+    setReopenReason('');
+    setReopenError(null);
+    setReopenOk(false);
+  };
+  /** 校验必给反馈（此前按钮 disabled 且无禁用样式 → 用户点击毫无反应）；请求在途禁用防重复；成功后显式提示。 */
+  const confirmReopen = async () => {
+    if (!reopeningChainId) return;
+    if (!reopenReason.trim()) {
+      setReopenError('请填写恢复理由（必填，用于审计留痕）');
+      return;
+    }
+    setReopenError(null);
+    setReopenBusy(true);
+    try {
+      await props.onReopenChain?.(reopeningChainId, reopenReason.trim());
+      setReopenOk(true); // 明确成功反馈，800ms 后自动关闭
+      window.setTimeout(() => closeReopen(), 800);
+    } catch (err) {
+      setReopenError('恢复失败：' + String(err)); // 失败保留弹窗，理由可改后重试
+    } finally {
+      setReopenBusy(false);
+    }
+  };
   const deletingView = deletingChainId ? props.chains.find((v) => v.chain.id === deletingChainId) : undefined;
   const confirmDelete = async () => {
     if (!deletingChainId) return;
@@ -97,6 +131,7 @@ export function WorkflowRail(props: {
                     type="button"
                     className="dsh-kb-chain__delete"
                     aria-label="删除需求"
+                    title="删除需求（整链硬删除，不可恢复）"
                     onClick={(e) => { e.stopPropagation(); setDeleteError(null); setDeletingChainId(view.chain.id); }}
                     onKeyDown={(e) => { e.stopPropagation(); }}
                   >
@@ -111,15 +146,29 @@ export function WorkflowRail(props: {
                     type="button"
                     className="dsh-kb-chain__rename"
                     aria-label="改链标题"
+                    title="修改链路标题"
                     onClick={(e) => { e.stopPropagation(); setRenamingChainId(view.chain.id); }}
                     onKeyDown={(e) => { e.stopPropagation(); }}
                   >
                     ✎
                   </button>
                 )}
+                {/* 人工恢复（2026-09-15）：仅 blocked 链显示；文字按钮（低频高价值，明确性优先，⟳ 易被误读为刷新） */}
+                {props.onReopenChain && view.chain.status === 'blocked' && (
+                  <button
+                    type="button"
+                    className="dsh-kb-chain__reopen"
+                    aria-label="人工恢复链路"
+                    title="将 blocked 链恢复为 executing，编排器继续推进后续阶段"
+                    onClick={(e) => { e.stopPropagation(); setReopenError(null); setReopenReason(''); setReopeningChainId(view.chain.id); }}
+                    onKeyDown={(e) => { e.stopPropagation(); }}
+                  >
+                    恢复
+                  </button>
+                )}
               </div>
               {(blocked || view.blockedSummary) && (
-                <div className="dsh-kb-chain__warning">{summary}</div>
+                <div className="dsh-kb-chain__warning" title={summary}>{summary}</div>
               )}
               {/* D23：completed 链存在未确认 audit-warning → 顶部警告行 + 确认按钮（阻塞最终汇报直至确认） */}
               {view.audit && !view.audit.confirmed && (
@@ -151,6 +200,40 @@ export function WorkflowRail(props: {
           onCancel={() => setRenamingChainId(null)}
         />
       )}
+      {reopeningView && props.onReopenChain && (
+        <div className="dsh-kb-rename-overlay" onClick={(e) => { e.stopPropagation(); closeReopen(); }}>
+          <div
+            className="dsh-kb-rename-modal"
+            role="dialog"
+            aria-modal="true"
+            aria-label="人工恢复链路"
+            onClick={(e) => e.stopPropagation()}
+          >
+            <div className="dsh-kb-rename-modal__label">人工恢复链路</div>
+            <div className="dsh-kb-delete-modal__text">
+              将「{reopeningView.chain.title || '未命名需求'}」从 blocked 恢复为 executing，编排器继续推进后续阶段。
+            </div>
+            <input
+              className="dsh-kb-comment-input"
+              aria-label="恢复理由"
+              placeholder="恢复理由（必填）"
+              autoFocus
+              value={reopenReason}
+              onChange={(e) => { setReopenReason(e.target.value); if (reopenError) setReopenError(null); }}
+              onKeyDown={(e) => { if (e.key === 'Enter') void confirmReopen(); }}
+            />
+            <div className="dsh-kb-rename-modal__hint">恢复理由必填（审计留痕）；填写后点「确认恢复」。</div>
+            {reopenError && <div className="dsh-kb-delete-modal__error" role="alert">{reopenError}</div>}
+            {reopenOk && <div className="dsh-kb-rename-modal__success" role="status">✓ 已恢复，编排器将继续推进后续阶段</div>}
+            <div className="dsh-kb-rename-modal__actions">
+              <button type="button" className="dsh-kb-rename-cancel" disabled={reopenBusy} onClick={closeReopen}>取消</button>
+              <button type="button" className="dsh-kb-rename-save" disabled={reopenBusy || reopenOk} onClick={() => void confirmReopen()}>
+                {reopenOk ? '已恢复' : reopenBusy ? '恢复中…' : '确认恢复'}
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
       {deletingView && props.onDeleteChain && (
         <div className="dsh-kb-rename-overlay" onClick={(e) => { e.stopPropagation(); setDeletingChainId(null); }}>
           <div

package/client/config-store.ts

@@ -7,6 +7,8 @@ export interface EditableSnapshot {
   wikiVault: { baseUrl: string; pagePrefix: string };
   roles: { models: Partial<Record<string, EditableModelSnapshot>> };
   reviewEngine: { mode: 'delegate' | 'managed'; managed: { provider: string; model: string } };
+  /** 默认投递机器人（预设未命中的落点）。本面板不编辑：用户经 /sms 交互写入，原样回传避免清空。 */
+  imDelivery: { fallbackBotId: string };
 }
 /** GET /kanban/ocr/status 响应镜像；null = 尚未拉到/拉取失败（状态未知）。 */
 export interface OcrStatus { installed: boolean; version: string; mode: string; kbMode: 'remote' | 'local'; managedReady: boolean; }
@@ -23,7 +25,7 @@ export interface ConfigState {
 
 /** 配置外部 store（GET /kanban/config + /kanban/llm-catalog + ocr 运维面；PUT 保存；POST reset），fetch 注入便于测试。 */
 export function createConfigStore(fetchImpl: typeof fetch) {
-  let state: ConfigState = { effective: { wikiVault: { baseUrl: '', pagePrefix: '' }, roles: { models: {} }, reviewEngine: { mode: 'delegate', managed: { provider: '', model: '' } } }, sources: {}, catalog: { providers: [], models: {} }, ocrStatus: null, install: { phase: 'idle', log: '' }, saving: false, error: null };
+  let state: ConfigState = { effective: { wikiVault: { baseUrl: '', pagePrefix: '' }, roles: { models: {} }, reviewEngine: { mode: 'delegate', managed: { provider: '', model: '' } }, imDelivery: { fallbackBotId: '' } }, sources: {}, catalog: { providers: [], models: {} }, ocrStatus: null, install: { phase: 'idle', log: '' }, saving: false, error: null };
   const listeners = new Set<() => void>();
   const setState = (patch: Partial<ConfigState>) => { state = { ...state, ...patch }; for (const l of [...listeners]) l(); };
   const get = () => state;

package/client/kanban.css

@@ -399,6 +399,7 @@
   padding: 4px 10px;
   cursor: pointer;
   font: inherit;
+  white-space: nowrap; /* 2026-09-15：横向空间不足时按钮文字曾被逐字竖排 */
   transition: border-color 150ms ease, color 150ms ease, background-color 150ms ease;
 }
 .dsh-kb-detail__actions button:hover {
@@ -722,6 +723,21 @@
   cursor: pointer;
 }
 .dsh-kb-chain__rename:hover { opacity: 1; }
+/* 人工恢复按钮（2026-09-15）：仅 blocked 链显示，常显（低频高价值场景，明确性优先于紧凑性） */
+.dsh-kb-chain__reopen {
+  flex: 0 0 auto;
+  border: 0;
+  background: transparent;
+  color: currentColor;
+  font: inherit;
+  font-size: 12px;
+  line-height: 1;
+  padding: 2px 6px;
+  border-radius: 4px;
+  cursor: pointer;
+  transition: background 150ms ease;
+}
+.dsh-kb-chain__reopen:hover { background: rgba(255, 255, 255, 0.12); }
 .dsh-kb-task__status-row {
   display: flex;
   align-items: center;
@@ -803,6 +819,18 @@
   background: var(--dsw-alias-button-primary-fill);
   color: var(--dsw-alias-label-primary-foreground);
 }
+/* 2026-09-15：弹窗操作按钮的禁用/在途视觉（此前完全缺失——disabled 无视觉差异，点击像"没反应"） */
+.dsh-kb-rename-modal__actions button:disabled { opacity: 0.5; cursor: not-allowed; }
+.dsh-kb-rename-modal__hint {
+  color: var(--dsh-kb-text-secondary);
+  font-size: 12px;
+  line-height: 1.4;
+}
+.dsh-kb-rename-modal__success {
+  color: #2ea043;
+  font-size: 12px;
+  line-height: 1.4;
+}
 
 /* Swarm 配置面板「评审引擎（ocr）」卡：安装中 spinner 行与状态行（成功绿 / 警示黄） */
 .dsh-kb-config__installing {

package/client/timeline-model.ts

@@ -41,6 +41,8 @@ const STATUS_OF: Record<EventKind, TimelineStatus> = {
   'chain/audit-confirmed': 'neutral',
   'chain/title-updated': 'neutral',
   'chain/im-delivery-failed': 'exception', // IM 投递失败留痕（非状态转换注记）
+  'chain/reopened': 'running', // 人工恢复（blocked → executing）
+  'review/waived': 'success', // 人工评审豁免（放行）
   'spec-card/created': 'neutral',
   'spec-card/edited': 'neutral',
   'spec-card/approved': 'success',
@@ -77,6 +79,7 @@ const KIND_LABEL: Record<EventKind, string> = {
   'chain/audit-confirmed': '越权已确认',
   'chain/title-updated': '链路改名',
   'chain/im-delivery-failed': 'IM 投递失败',
+  'chain/reopened': '人工恢复链路',
   'spec-card/created': '规格卡创建',
   'spec-card/edited': '规格卡编辑',
   'spec-card/approved': '规格卡批准',
@@ -95,6 +98,7 @@ const KIND_LABEL: Record<EventKind, string> = {
   'review/passed': '评审通过',
   'review/failed': '评审驳回',
   'review/gave-up': '评审超限放弃',
+  'review/waived': '评审豁免',
 };
 
 /** author id → 友好名（复用 ROLE_NAME 语义，system/human 另映射）。 */

package/client/workflow-model.ts

@@ -117,19 +117,28 @@ function activityLabel(task: Task, state: BoardState, now: number): string {
   return `${Math.floor(diff / 86_400_000)}d`;
 }
 
+/** 链头警告摘要（2026-09-15 修正）：只反映"当前"状态，不粘历史。
+ *  旧实现是纯历史扫描（取链上 seq 最大的 task/blocked|task/failed 的 reason），不看该卡当前状态——
+ *  历史阻塞解除/链恢复后警告行永久常驻，且真正停因（chain/blocked，如 stall-watchdog）从不显示。
+ *  新优先级：① 链级 blocked → chain/blocked 的 reason（"链为什么停"的第一手原因）；
+ *           ② 否则 → 当前处于 blocked/failed 的卡自身最后一次 block/fail 原因；
+ *           ③ 均无 → null（警告行不显示；历史原因仍可在卡轨迹查看）。 */
 function blockedSummary(chainId: string, state: BoardState): string | null {
-  let latest: string | null = null;
-  let latestSeq = -1;
-  for (const ev of state.events) {
-    if (ev.chainId !== chainId) continue;
-    if (ev.kind === 'task/blocked' || ev.kind === 'task/failed') {
-      if (ev.seq > latestSeq) {
-        latestSeq = ev.seq;
-        latest = String(ev.payload['reason'] ?? '');
-      }
-    }
+  if (state.chains.get(chainId)?.status === 'blocked') {
+    const ev = [...state.events].reverse().find((e) => e.chainId === chainId && e.kind === 'chain/blocked');
+    return String(ev?.payload['reason'] ?? '') || '链级阻塞（原因未记录）';
   }
-  return latest;
+  const blockedIds = new Set(
+    [...state.tasks.values()]
+      .filter((t) => t.chainId === chainId && (t.status === 'blocked' || t.status === 'failed'))
+      .map((t) => t.id),
+  );
+  if (blockedIds.size === 0) return null;
+  const ev = [...state.events]
+    .reverse()
+    .find((e) => e.chainId === chainId && e.taskId !== null && blockedIds.has(e.taskId)
+      && (e.kind === 'task/blocked' || e.kind === 'task/failed'));
+  return ev ? String(ev.payload['reason'] ?? '') : null;
 }
 
 function relatedIds(state: BoardState, chainId: string, selectedTaskId: string): Set<string> {