@mstar-harness/dsh 3.7.3 → 3.8.1

package/README.zh.md

@@ -2,9 +2,9 @@
 
 [English](README.md) | 中文
 
-![dsh](https://img.shields.io/badge/dsh-0.1.5--rc.1-4B32C3.svg)
+![dsh](https://img.shields.io/badge/dsh-0.1.5--rc.2-4B32C3.svg)
 
-让 [Morning Star](https://github.com/btspoony/mstar-harness) 成为一等公民的 dsh（DeepSeek Harness）宿主——一个 cordis 函数插件，将 mstar engine 进程内挂载，实现 engine `HostAdapter`（`host: 'dsh'`），守护 `{HARNESS_DIR}/status.json` 写入（校验 + 咨询；hard 下按修复逃生放行），在 `Enforcement: hard` 开启时阻止被禁止的 subagent 派发，对挂载技能根下的 `SKILL.md` 写入执行技能撰写 lint，通过 dsh skill-filesystem 提供者挂载 mstar `skills/` 镜像（单一规范挂载），并向每个组合后的 agent 步骤追加一条持久化的 `mstar-engine-status` catalog 行。随 dsh Loader 应用启动；一切均通过 seam 的拒绝/咨询通道行使职责，从不改动工具本身。
+让 [Morning Star](https://github.com/btspoony/mstar-harness) 成为一等公民的 dsh（DeepSeek Harness）宿主——一个 cordis 函数插件，将 mstar engine 进程内挂载，实现 engine `HostAdapter`（`host: 'dsh'`），守护 `{HARNESS_DIR}/status.json` 写入（校验 + 咨询；hard 下按修复逃生放行），在 `Enforcement: hard` 开启时阻止被禁止的 subagent 派发，对挂载技能根下的 `SKILL.md` 写入执行技能撰写 lint，通过 dsh skill-filesystem 提供者挂载 mstar `skills/` 镜像（单一规范挂载），并向每个组合后的 agent 步骤追加一条持久化的 `mstar-engine` catalog 行（持久化日志的读取方也接受旧标识 `mstar-engine-status`）。随 dsh Loader 应用启动；一切均通过 seam 的拒绝/咨询通道行使职责，从不改动工具本身。
 
 ## Usage
 
@@ -71,7 +71,7 @@ dsh plugin --profile headless add @mstar-harness/dsh
 | `rolePersonas` | `Record<string, string>` | 未设置（打包镜像默认） | mstar 角色 id（`Execute as`）→ persona 文本；原生 subagent persona 通道的**覆盖**来源——角色匹配的 start（一次性 `start` 或可选的 continuable `startContinuable`）会把 persona 合入原生请求的 `persona` 槽（子会话体现角色 persona 而**非**部署 persona；持久化并在 resume 时重放）。合并次序：请求自身已携带 `persona` 时**原样生效**（调用方意图绝不被覆盖——不做角色合并）；否则非空条目优先于打包的 `harness-agents/` 镜像默认值，**空字符串**条目视为未设置并回落到镜像默认值，无条目时使用镜像默认值（见 LLM fallbacks integration）。 |
 | `skillRoots` | `string[]` | 未设置（不注册自定义根） | 向 dsh skill-filesystem 提供者注册的额外技能根（`customSkillDirs` 语义——先于用户根扫描）。开发期：镜像 `<repo-root>/skills` 的绝对路径。 |
 | `bundledSkillDir` | `string` | 打包的 `harness-skills/` 镜像（包相对路径） | 向 dsh skill-filesystem 提供者注册的打包技能根（`bundledSkillDir` 语义——最后扫描、受信任）。默认取包内自带的 `harness-skills/` 镜像（`bundle-assets` 同步；gitignore）——包相对路径，**非** cwd 锚定。显式值优先。 |
-| `catalogTtlMs` | `number` | `60000` | pre-step catalog 缓存刷新间隔（毫秒）：按工作区缓存的统一 `mstar-engine-status` 行（水印 + 迭代闸门 + 工作区摘要）多久重读一次 `status.json` / compass / 知识索引。刷新间隔之间热路径只是时间戳比较 + Map 命中；会话中 plan/compass/residual 的变化会在一个间隔内落地。 |
+| `catalogTtlMs` | `number` | `60000` | pre-step catalog 缓存刷新间隔（毫秒）：按工作区缓存的统一 `mstar-engine` 行（水印 + 迭代闸门 + 工作区摘要）多久重读一次 `status.json` / compass / 知识索引。刷新间隔之间热路径只是时间戳比较 + Map 命中；会话中 plan/compass/residual 的变化会在一个间隔内落地。 |
 | `workflowGate` | `'off' \| 'warn' \| 'ask' \| 'hard'` | `'warn'` | workflow/ralph 闸门模式（见 Gates → Workflow / ralph gate）。`off` = 直通且不产生 verdict 行；`warn` = 仅咨询；`ask` = 首见名字走审批瀑布（P-c）；`hard` = 策略违规在任何子进程启动前否决。默认 `warn` 不改任何 hard 行为——除非部署显式选入 `ask`/`hard`，闸门仅咨询。 |
 | `workflowNames` | `string[]` | 未设置 | workflow 名字白名单（P-a）：被闸门视为 KNOWN 的 `meta.name` 值。为空或缺省 ⇒ **每个**名字都 unknown（有文档——闸门**绝不**因缺省而"全放行"）。ralph 调用不携带 `meta.name`——P-a 对其永不适用。 |
 
@@ -98,7 +98,7 @@ profile bundle 组合出以下行——注册表行来自 `@deepseek-ai/dsh-base
 - **seam lint**——harness 下 `DESIGN.md` / audit plan / 知识文档 / roles 目录的写入运行各自的 artifact 级 engine lint。
 - **模型可见工具**——`mstar_sdd_workspace`、`mstar_sdd_task_brief`、`mstar_iteration_gate`、`mstar_design_md_validate`、`mstar_audit_validate`、`mstar_compound_validate`、`mstar_roles_validate` 注册到 `ctx.tools`。`mstar_iteration_gate` 镜像改用 v3 输入 `snapshot_path`（`{HARNESS_DIR}/workflows/<id>/snapshot.json`——镜像 `mstar iteration gate --workflow <id>`；旧的根 `status_path` 输入随 v1 读取路径移除）。
 - **bundled 命令**——向 `ctx.commands` 注册 `/iteration-start`、`/iteration-drive`、`/iteration-loop`、`/codebase-audit`（来自打包的 `harness-commands/` 镜像；每条声明 frontmatter `input` hint，使 web 客户端 claim `/name ` 并等待用户后续输入而非立即执行；handler 把命令正文 + 用户输入 steer 进接收 agent）。
-- **pre-step catalog 行**——每个组合后的 agent 步骤都会追加**一条**统一的 `mstar-engine-status` catalog 消息：水印（统一 mstar 版本、harness 目录、enforcement）、迭代相位闸门段（解析到 steering compass 时）与工作区状态摘要段（工作区有 `status.json` 时：plan 注册表、open residual、分支/政策锚点、活跃 lease、知识摘要、compass 方向）。该行是 digest 门控的（每 turn 注入一次、变化时才重发），并共享一次按工作区 TTL 缓存的构建（`catalogTtlMs`，默认 60 秒）。
+- **pre-step catalog 行**——每个组合后的 agent 步骤都会追加**一条**统一的 `mstar-engine` catalog 消息：水印（统一 mstar 版本、harness 目录、enforcement）、迭代相位闸门段（解析到 steering compass 时）与工作区状态摘要段（工作区有 `status.json` 时：plan 注册表、open residual、分支/政策锚点、活跃 lease、知识摘要、compass 方向）。该行是 digest 门控的（每 turn 注入一次、变化时才重发），并共享一次按工作区 TTL 缓存的构建（`catalogTtlMs`，默认 60 秒）。
 
 ### Enforcement semantics
 
@@ -232,7 +232,7 @@ mstar 技能通过 dsh skill-filesystem 提供者以**单一规范挂载**接入
 | host（resolveSkillRoot、HostAdapter） | engine host.ts 检测行 + 插件适配器（`host: 'dsh'`） | 已交付（P2） |
 | skill-authoring（lintFrontmatter、lintFiveQuestion） | skill-filesystem 根 + 对 SKILL.md 的 `fs/write-intent` | 已交付（P2） |
 | lint（lintSkillFrontmatter、planQualityBar、assertSddTddTriple） | 未接线——plan/tdd 的 fs 闸门为延后项；`lintSkillFrontmatter` 仅运行于 skills-mount 测试套件 | 延后 |
-| agent catalog | MessageSourceMap `mstar-engine-status`（模型可见 ⟺ 已记录） | 已交付（P2） |
+| agent catalog | 一方 `plugin` catalog source（锚点）+ `/api/mstar/engineStatus` 快照读取（模型可见 ⟺ 已记录） | 已交付（P2） |
 | sdd（sddWorkspace、taskBrief） | 注册在 `ctx.tools` 上的 `defineTool` 包装 | 已交付（P3） |
 | iteration（evaluatePhaseGate、parseCompassFrontmatter） | `agent/pre-step` + iteration 闸门 | 已交付（P3） |
 | worktree（l1PreDispatchCheck、l2PreDispatchCheck） | `tools/pre-execute` L1/L2（派发闸门内） | 已交付（P3） |
@@ -240,7 +240,7 @@ mstar 技能通过 dsh skill-filesystem 提供者以**单一规范挂载**接入
 
 ## Engine-status catalog
 
-一个咨询式 `agent/pre-step` 瀑布监听器向每个组合后的步骤追加**一条** **`mstar-engine-status`** catalog MessageSource（`kind`/`form: 'catalog'` 契约，镜像 dsh tool-skill 先例）：模型可见的 `<mstar_engine_status>` 块渲染水印字段——**mstar 版本**（插件自身清单；单一版本不变量把打包的 engine 钉在同一版本）、**harness 目录**（解析后的 `{HARNESS_DIR}`，缺失为 `none`）、**enforcement**（compass 模式，`soft` / `hard (compass)`）——以及 **迭代相位闸门段**（当 steering compass + `status.json` 可解析时：迭代 id、transition、all-plans-done、闸门判定 + 违规码——即 `mstar iteration gate` 工具结果形态）与 **工作区状态摘要段**（当工作区有 `status.json` 时）：**plans**（`id(status)` 注册表）、**residuals**（按 severity 的 open 计数）、**branch**（base → target、spec 集成）、**policy**（push 政策、worktree 模式、control 根）、**leases**（活跃 plan 执行租约：持有者 + worktree）、**knowledge**（知识索引文档数与分类）与 **direction**（steering compass 的 problem statement 一句话）。监听器先调用 `next()` 并基于委托后的决策追加——从不否决步骤、从不替换已组合的消息。模型可见 ⟺ 已记录：持久化的 `catalog` 形态 source 在模型面向的散文旁记录了其发布的事实，会话日志无需重新解析该块即可重建该行（dsh packages/AGENTS.md）。fiber 销毁即移除监听器（HMR 安全）。
+一个咨询式 `agent/pre-step` 瀑布监听器向每个组合后的步骤追加**一条** **`mstar-engine`** catalog MessageSource——一方 `plugin` 臂，即恰好 `{ kind: 'plugin', plugin: 'mstar-engine', form: 'catalog' }`、**不含任何其它成员**（镜像 dsh tool-skill 先例）：模型可见的 `<mstar_engine_status>` 块渲染水印字段——**mstar 版本**（插件自身清单；单一版本不变量把打包的 engine 钉在同一版本）、**harness 目录**（解析后的 `{HARNESS_DIR}`，缺失为 `none`）、**enforcement**（compass 模式，`soft` / `hard (compass)`）——以及 **迭代相位闸门段**（当 steering compass + `status.json` 可解析时：迭代 id、transition、all-plans-done、闸门判定 + 违规码——即 `mstar iteration gate` 工具结果形态）与 **工作区状态摘要段**（当工作区有 `status.json` 时）：**plans**（`id(status)` 注册表）、**residuals**（按 severity 的 open 计数）、**branch**（base → target、spec 集成）、**policy**（push 政策、worktree 模式、control 根）、**leases**（活跃 plan 执行租约：持有者 + worktree）、**knowledge**（知识索引文档数与分类）与 **direction**（steering compass 的 problem statement 一句话）。监听器先调用 `next()` 并基于委托后的决策追加——从不否决步骤、从不替换已组合的消息。模型可见 ⟺ 已记录：持久化的 source 不携带任何事实——该行是持久化的**锚点**，其**实际发出**的 payload 在同一次 digest 门控发射时按会话快照到 `{HARNESS_DIR}/snapshots/engine-status.json`，因此「会话日志 + 该存储」无需重新解析该块即可重建该行（dsh packages/AGENTS.md）。任何已发布的会话格式边界都不接受 message source 上的多余成员，故 `source` 上永远只写 `plugin` 臂。**锚点标识（更名，带读兼容）**：发出的 `plugin` 值为 `mstar-engine`（原 `mstar-engine-status`）；更名前已发布构建发出的行在已写入的会话日志中持久化旧标识，面板的锚点读取方把 `mstar-engine` 与 `mstar-engine-status` **都**视作本插件的一方臂——任何其它 `plugin` 值都不是锚点，会话降级为显式 `waiting` 态（绝不猜测数据）。工作流面板通过宿主共享的 `/api` typert 网关按需读取该快照：**路由由宿主网关持有**（插件无法注册路由；`connection.rpc.handle` 的普通信道会经由调用 fiber 上的 `webServer` 挂载、并使本行的 boot 挂起——本包刻意不走该机制），本包只经可选 `ctx.typert.register(...)` 子单元贡献 `mstar/engineStatus` 端点描述符。浏览器半体调用 `connection.rpc.call('/api', 'mstar/engineStatus', { args: { sessionId, cwd } })`，得到该会话自己的已存快照，或带原因的显式 `unavailable`（绝不返回其它会话的数据、绝不静默空字段）。**信任边界，如实说明：**该端点自身不做任何鉴权——传输层围栏（host/origin + 浏览器鉴权）只证明调用方是本宿主自己服务的页面，因此*持有 `(sessionId, cwd)` 组合 + 能访问本机 `/api` 网关即为能力*。应答按**请求**限定：查询以被断言的 id 为键，存储记录的 `cwd` 必须同时等于断言值与服务端解析出的会话 `cwd`，客户端在渲染前还会复核回显的 id 与工作区——因此一个会话的请求绝不会被返回另一个会话的记录。payload 是工作区摘要（版本、harness 目录、enforcement、plan/residual/lease 计数），面板自身的会话记录本就暴露这些信息；它不被当作机密，而不同的 `unavailable` 原因会让该端点对已持有 id 的调用方成为一个弱的「会话是否存在」探针。fiber 销毁即移除监听器（HMR 安全）。
 
 该行是 **digest 门控**的：按 agent+workspace，每个 turn 只注入一次，仅当渲染文本变化时重新注入——20 步的 turn 只显示一次 catalog，而不是 20 次。source 共享**同一**按工作区缓存条目：显式 `harnessDir` 时在 boot 构建（否则在工作区首次 pre-step 构建），并按 TTL 刷新（`catalogTtlMs`，默认 60 秒）——刷新间隔之间热路径只是时间戳比较 + Map 命中，会话中 plan/compass/residual 的变化在一个间隔内落地。
 
@@ -274,11 +274,13 @@ agent-flow 账本——`{HARNESS_DIR}/agent-flow.jsonl`，即 catalog 的 `state
 
 本包为 dsh **web** profile 提供浏览器客户端半体，在**已安装的 `mstar` bundle 行**上被自动发现（package.json 的 `dsh.client` 声明 + `exports["./client"]` → `dist/client.js`——上游 web `dsh.client` 发现逻辑扫描 loader entries，并把每个客户端的 `exports["./client"]` 解析进 boot 图）——**无需独立 profile 层或安装步骤**（spec §6.1）。web 应用在 `/plugins/@mstar-harness/dsh/client.js` 提供该 bundle，并经 closure-factory loader 握手加载（`window.__ModuleLoader__.load({ id, factory })`）。
 
-客户端入口在 **`conversation.view`** view ring 注册一个 tab（`id: 'mstar-workflow'`、`order: 20`——trajectory 先例形态），经 `mstar-panel` locale 命名空间命名为 **"MStar 工作流"**（zh）/ **"MStar Workflow"**（en）。面板即 **MStar 工作流布局**：右侧固定 300px sidebar——计划（≤5 时间倒序 + `+N more`）、未决残留 findings（≤10、severity chip、溢出提示）、策略（**enforcement 首位** + push / worktree / control worktree）、租约、知识、方向——其下为**底部 fixed 小面板**（版本 + harness 目录；小字号 muted、不随 sidebar digest 滚动；原 header 行已移除），主体为 **HTML/CSS zone dashboard**，外加新鲜度 footer（`last-updated HH:MM:SS` + catalog 重发刷新说明）。branches 区块已移出 sidebar 迁入迭代区（plan `20260810-panel-canvas-zones`）。860px 以下 sidebar 堆叠到主区下方。
+客户端入口经公开的两段式席位契约把面板注册为**右 Sidebar 页签类型**：`ctx.sidebarRightTabs.register(definition)`——`id: '@mstar-harness/dsh'`、`kind: 'mstar-workflow'`（页类型——无 `patterns`/`canOpen`/`priority`，按 kind 打开）、跟随 locale 的 `title()` thunk，以及**恰好一个引导页 capsule**（`order: 20`，描述 + MStar glyph 图标）——点选 capsule 会在该 pane 的槽位打开面板（替换引导页签、展开侧栏），再次点选聚焦既有页签（宿主页去重规则）——不自动打开、不重复表面。旧 **`conversation.view`** view-ring 页签**已移除**（迁移，而非第二表面）：sidebar 页签取代会话区页签。面板体与其 chip 标题在同一 id 下注册为 keyed 席位（`sidebar.right.pane.tab` + `sidebar.right.pane.tab.title`；chip 为 glyph + 打开时捕获的标题——不跟随会话中途的语言切换）。`tab.visible === false`（列折叠或同 pane 其它页签激活）时面板体**不渲染任何内容**（无投影、无 DOM），选中分区存放在按页签记录键控的 entry slot store 中，因此能在 docked 面板体卸载后存活。文案来自 `mstar-panel` locale 命名空间：**"启明星工作流"**（zh）/ **"Morning Star Workflow"**（en）。
 
-canvas 区是会话日志中最新一条 `mstar-engine-status` catalog 行的纯渲染（数据来自 `useSession` 快照——刷新跟随快照，不轮询）：页面**撑满 Tab**（无整页滚动——zone 容器是唯一滚动主体），**zone dashboard**（替代 react-flow 循环图，plan `20260810-panel-canvas-zones`）排布三区——**迭代区**（Step 1–5 竖排 stepper + `Step N/5` 徽标、激活高亮 / 未激活暗淡态；steps 为**四态状态机**——`current` / `next` / `done` / `idle`（plan `20260812-panel-f5-iteration-zone-fix` Task 1）：current 之前的步骤投影为 `done`「已完成」（已完成的 Step 1 不得在 Step 2 current 时显示为待命 idle），`next` 为唯一前向目标，`idle` 仅为 schema 余项——分支面板：迭代 base / 目标分支 / spec 集成分支，仅激活时渲染；展开态头部为**左右分栏**——分支（左小半，**宽度受约束**——`flex: 0 1 260px` + `max-width: 280px`，不再随容器撑宽；<860px 竖排时重置为内容高度）+ Steps（右大半，`flex: 1 1 0` 吸收剩余宽度），经 `data-iteration-head-split`，窄宽回退堆叠，无激活迭代时无分支面板；当前步跟随 steering compass：`compassStatus: 'active'`（Phase 1 进行中）→ Step 1（iteration-start）为**当前步**且 verdict 为 `unknown`——无 PASS/FAIL 徽标——plan `20260811-panel-f4-iteration-zone`）；**迭代信息 Section 由任务迭代与代理执行两 tab 共用**（plan `20260812-panel-f5-design-system` Task 8，用户第 4 轮决策 #4——单一 `IterationInfoSection` 组件，两 tab 渲染同一 `view.iteration` 块：摘要 + steps + 分支）；**任务区**（**5 列 kanban**：Todo / InProgress / InReview / Done / `blocked-unknown`——Blocked 与原有 unknown 兜底**合并为单列**，标题「受阻/未知」/「Blocked / Unknown」，plan `20260813-panel-quick-fixes` Task 1——带计数徽标；每列渲染行数统一以 `PLAN_CAP` 封顶，超限显示可点击的「更多」/「收起」展开按钮（`data-kanban-more` 锚点）展开全量——投影保留全部 plan 行，封顶只是渲染关注点、绝不丢弃）与**代理执行区**（四个 EXPECTED_ROLE_FLOW stage/phase 列——review-edit-chain → sdd-implement → qc-tri → qa-gate（终点阶段；原 `sdd-task-review` 阶段已删除，其 SDD L2 审查者现为管线内角色 `code-reviewer`，v2.1.1）——**严格四列布局、无独立 unknown 列**（plan `20260812-panel-f5-design-system` Task 5，用户 2026-08-12 第二轮决策——原 plan `20260812-panel-f5-agent-layout` 的最右 unknown 列被取代）：`general` 桶**下沉至 `qa-gate` 列底部 unknown 子分区**（`data-sub-bucket="unknown"` 标题行「unknown / 未匹配角色」，位于末张 qa-gate 卡之后，其下排布 general 卡；独立 on-demand 列已于 agent-layout plan 移除）；`explore` 已移除——无卡无列。`sdd-implement` 列按投影 `entity.bucket` 拆为**子桶**（绝非渲染猜测）：上方 **implementor 分区**——按 stage 原始顺序的 flow 角色（fullstack-dev / fullstack-dev-2 / frontend-dev），随后是 on-demand 角色（ops-engineer / prompt-engineer，带 **按需徽标**——无独立 on-demand 列）——与下方 **sdd-reviewer 分区**（code-reviewer，SDD L2 task reviewer），带 implementor / sdd-reviewer 标题标签；`zone: 'on-demand'` 实体位于 implementor 分区内，`zone: 'general'` 实体渲染于 qa-gate 列底部 unknown 子分区。画布按**两个左右并排的 Phase 分组**排布（plan `20260812-panel-f5-design-system` Task 8，用户第 4 轮决策 #2；左右排列 per plan `20260813-panel-agent-canvas-legend-layout` Task 2）：**左：Phase 1 组**（review-edit-chain——顺序完成的 Review & Edit 链：product-manager → architect → writing-specialist）+ **右：Phase 2 组**（sdd-implement → qc-tri → qa-gate——循环迭代 plans），顶部对齐（各组标签行共享同一 `y = PAD_Y`），各带组标签行；**Phase 2 组标签标注当前 plan**（`data-canvas-group-plan` = 投影 `activePlanId` = `state.plans[]` 中首个 InProgress plan_id；多个进行中 → `+N more` 诚实计数；无 → 灰字「无进行中 plan」）。subagent **实体卡**按 **role 聚合**：同一角色跨 session 合并为一张卡 ×N，所有 off-roster 派发（原 `generalPurpose` SDD 审查者、`scout`、匿名 `role === ''`）归入唯一 `general` 桶实体——卡以 **role 为标题**（role id）；agent session id / 任务标签（`planId#taskId`）走在记录行上、不作卡标题——卡片显示 role chip / 状态点 / ×N 计数；执行中实体带 business glow-pulse 高亮（施加于**圆角 `.card-body`**——卡片为唯一圆角元素，无方形外轮廓叠加，plan `20260812-panel-f5-design-system` Task 5），无证据 stage 渲染虚线「待执行」占位（含预期 role chips），无证据 KNOWN_AGENTS 成员渲染虚线 idle 卡（14 角色 roster 永不隐藏），头部显示 `N 执行中 · M 待执行` 摘要；卡片携带投影 **透明度分级**（plan `20260812-panel-f5-design-system` Task 4，design doc §3）：`emphasis: 'current' | 'next' | 'off' | null`——迭代当前阶段角色 **100%** chrome 全强度、后续阶段预期角色 **75%**、已过阶段 / 无阶段角色（on-demand、general）**45%**，`null`（无迭代 / transition 不可解析）**不覆盖**——恒为 chrome **alpha 混合**（`--mstar-canvas-emphasis-*` token；绝不整卡 `opacity`，状态点与 running 辉光保持不透明）。已结算实体带**独立绿色完成框 + 绿 ✓**（plan `20260812-panel-f5-design-system` Task 8，用户第 4 轮决策 #1/#3：`data-agent-done="true"`——圆角卡片体 success 边框 + 1px ring + 状态点绿 ✓，全强度 evidence 态）——**仅当 `emphasis ≠ 'off'`**；off 档角色（已过阶段 / 无阶段 on-demand + general）显示灰字圆点、**绝不显示完成标记**（第 4 轮 #3：已完成状态不出现在无阶段角色上）。画布只投影**当前迭代**的派发证据（plan `20260813-panel-quick-fixes` Task 2）：steering compass `iterationId` 活跃时取之，否则经 catalog `plans[].iterationRefs` 推导最近迭代（8 位日期前缀 + doneAt 最大的 plan 的 refs）；可证明跨迭代的事件不产生实体/连线（roster 常驻 idle 卡），无 plan / 未知 plan / 独立 plan 的派发绝不隐藏。状态诚实（Task 2）：`advisory` **不再终态**——软执法派发落到配对 settle（有 settle 绿 ✓ 已完成、无 settle 显示执行中），`denied` 仍为终态；advisory verdict 仍在事件记录页呈现。画布图例位于**视口下方**（Task 3，自上方移下，用户 2026-08-13 反馈）。连线（plan `20260812-panel-f5-design-system` Task 5，design doc §2）：`expected` 阶段骨架箭头与**带动画的 next 边**（原 `@keyframes agent-dash-flow` dash-flow 箭头，plan `20260810-panel-agent-flow-zone`）**已移除**——流转顺序由固定列序 + 列标签暗示、当前位置由 running 辉光 + 状态点承担——仅余两类语义线：证据驱动的 **`actual` 交接线**（同 plan ts 相邻派发实体键对、过滤 general 端点、同对实体键至多 1 条）以 **bezier `C` 曲线**绘制，锚定卡片 **4 端口**（上/下/左/右四边中点；静止不可见、hover 显示为小圆点），箭头尖端退让至端口外 **10px standoff**——箭头沿线在锚点处的局部切线（**H1**），任何线的描边/箭头不穿过文字（**H2**：standoff + 侧隙路由，design doc §2.0/§2.5/§2.6；plan `20260813-panel-quick-fixes` Task 3 收紧——同列纵向流的中线会穿过中间卡片体时改走列**左侧隙带**（正向与反向；如 fullstack-dev → frontend-dev 跳过 idle 的 fullstack-dev-2），反向水平 bezier 保持**方向感知**控制点位于端点**之间**、不再向相邻列鼓包）——外加**双向监督线**（plan `20260812-panel-f5-agent-layout` Task 1/2）——`sdd-implement` 列内一条静态设计知识子桶边（implementor ↔ sdd-reviewer——mstar-sdd 相互监督契约），现锚定于**列外侧隙垂直锚点**（`x = 卡片右缘 + 18px`，垂直 bezier 流，箭头沿垂直切线——design doc §2.5/§2.7）；默认 dim 虚线，投影 `evidenced` 为真时亮起 business **实线**（证据驱动点亮，绝不伪造激活））——agent 流转事件条迁入**「事件记录」tab 日志页**（spec F1.5，plan `20260811-panel-event-log`）：非 canvas 日志页——**Agent 流转事件** / **违规记录** 两个分区，每条可展开原生 `<details>` 呈现完整 catalog 字段（缺失字段显示「—」，绝不捏造），空态 muted；两个分区在**锁定高度的左右两列** grid（`repeat(2, minmax(0, 1fr))`）中并排——页面整体不再滚动，各分区固定标题、列表内部滚动（plan `20260813-panel-quick-fixes` Task 4 修复根因——面板根节点接入宿主 `data-conversation-composer-overlay` 全高 opt-in，使 `height:100%` 真正解析、`.rowList` 的 `overflow-y: auto` 在分区内部滚动、宿主页面不再整页滚动，底部按宿主发布 `--dsh-composer-height` 预留悬浮 composer 间隙）——1200px 以下回退为两个 50/50 锁定行（`data-event-log-*` 锚点族不变，plan `20260811-panel-f3-agent-general`）；**canvas 左下角 fixed `AgentEventDock`** 与底部 fixed footer 条随页面落地而**移除**（无双份日志，spec §5）。空分支（spec §2，plan `20260812-panel-f5-agent-layout` Task 3）：waiting 保留 muted hint；无 harness 时渲染**居中未激活态卡片**——文件夹图标 + 「未检测到 Morning Star harness」标题 + hint 文案（详细面板保持未激活——无 tab、无 sidebar——检测到 harness 后自动呈现；`data-mstar-empty="no-harness"` 锚点保留在标题上，`data-mstar-graph` 在主容器上）。1200px 以下三区纵向堆叠。投影为纯函数 `projectGraph(source)`（schema 常量与 catalog 证据严格分离；永不 throw；缺失字段显式降级为空态/最后已知态——muted 空态，绝无橙色 warn 框），产出纯数据 `ZoneView`；`WorkflowCanvas` 以纯 HTML/CSS 渲染。
+面板是最新 catalog 快照（取自宿主 `/api/mstar/engineStatus` 端点——刷新跟随拉取，不轮询）的纯渲染：**窄列布局**为绑定 sidebar pane 确定高度的单列 flex，恰好三个分区——**分区导航**（任务迭代 / 代理执行 / 事件记录，flex: none）、面板自有的**唯一滚动主体**（`[data-mstar-scroll]`——面板内**唯一** `overflow-y` 元素；任何元素都不横向滚动；`data-mstar-graph` 随其上）、钉住的 **meta 小面板**（版本 + harness 目录；永不滚动）。工作区状态摘要（计划 ≤5 时间倒序 + `+N more`、未决残留 findings ≤10 带 severity chip、策略 **enforcement 首位** + push / worktree / control worktree、租约、知识、方向）以流内内容位于滚动主体末尾——固定 300px 兄弟列及其嵌套滚动器已删除——新鲜度 footer（`last-updated HH:MM:SS` + turn）收尾滚动主体。宿主 composer-overlay opt-in 不再需要（sidebar pane 体本就是确定高度盒），过时的视口媒体查询已删除：壳层携带 `container-type: inline-size`，宽度规则为**容器查询**——容器宽 480px 以下内距与分组间距收紧（300px 下限的紧凑节奏）；≥720px 共享分组网格铺开为两列（`repeat(auto-fit, minmax(280px, 1fr))`）——这是任何宽度带来的**唯一**结构变化（一份 DOM、一棵树；无 JS 布局测量）。缺失字段显式降级为空态/最后已知态（muted，绝无橙色 warn 框）；`waiting` 保留 muted hint；无 harness 时渲染居中未激活态卡片，检测到后自动呈现。
 
-**依赖**：zone dashboard **不携带任何图库**——`@xyflow/react` devDependency（此前构建期内联进 `dist/client.js`）随 react-flow 渲染层一并移除（plan `20260810-panel-canvas-zones`），唯一消费者是 `@xyflow/react/dist/style.css` 的 plain-`.css` text loader 也已删除（`CLIENT_EXTERNALS` 不变——react / react-dom 与 `@deepseek-ai/dsh-client-*` 平台模块保持外部）。构建脚本端到端断言移除成立：产物**不得含 `xyflow`/`reactflow` 标记**、`@deepseek-ai/*` 值导入为 0、**无 `import.meta` / ESM 语句**——web loader 以**经典 `<script>`** 执行插件 bundle，字面 `import.meta` 是 parse-time SyntaxError（zustand v4 的 `import.meta.env` 读取已在构建期 define 消除；见本迭代 install-verification guide §6）。本 plan 收口时的体积：**145,159 B raw / 29,460 B gzip**（以各迭代 install-verification guide 为重新测量 SSOT——react-flow 移除后缩至约 85 KB，代理执行区实体渲染落地后回升，F5 透明度分级 + 连线重构后再度增长）。
+三个分区在唯一滚动主体内堆叠。**任务迭代**渲染迭代头部（未激活时为折叠摘要）+ **竖直** 5 步 stepper（每步一行——徽标 · 相位 · chip · 预留 verdict 席位；保留四态 `current` / `next` / `done` / `idle` 状态机：current 之前的步骤投影为 `done`「已完成」，`next` 为唯一前向目标，`idle` 仅为 schema 余项；steering compass 为 `status: active` 时 Step 1 即当前步——无 PASS/FAIL 徽标——Step 5 永远不会是当前步）+ 分支面板（迭代 base / 目标 / spec 集成分支，仅激活时渲染）+ 计划板为**五个竖排状态组**（恒定顺序——Todo / InProgress / InReview / Done / 合并的「受阻/未知」/「Blocked / Unknown」列），每 `data-kanban-column` / `data-kanban-arrow` / `data-kanban-count` 锚点全保留；每组渲染行数以 `PLAN_CAP` 封顶，超限显示可点击「更多」/「收起」展开按钮（`data-kanban-more`）展开全量（投影保留全部 plan 行——封顶只是渲染关注点，绝不丢弃）——随后是项目 rollup。**事件记录**把两个分区（Agent 流转事件 / 违规记录）渲染为流内容——每条可展开原生 `<details>` 呈现完整 catalog 字段（缺失显示「—」，绝不捏造；workflow 行保留 name / 成员数 / stop-reason 字段），无分区自有滚动器。**代理执行**把 agents 渲染为**竖直分组列表**——绝对定位画布连同 SVG 连线层、卡片端口与指针 pan **已删除**：两个 Phase 组恒定顺序，Phase 1（`iteration-start`——顺序完成的 Review & Edit 链：product-manager → architect → writing-specialist）在上，Phase 2（`autonomous-execute`——循环迭代 plans；其组标签标注**当前 plan**：投影 `activePlanId`（`data-agent-group-plan`），多个进行中 → `+N more`（`data-agent-group-plan-more`），无 → 灰字「无进行中 plan」（`data-agent-group-no-plan`））在下；每个 Phase 组竖排其 stage 组——`sdd-implement` 拆为上方 **implementor** 分区（flow 角色 fullstack-dev / fullstack-dev-2 / frontend-dev 按 flow 序，随后 on-demand 角色 ops-engineer / prompt-engineer，带虚线**按需徽标**）与下方 **reviewer** 分区（code-reviewer），`general` 桶下沉到最后一个 stage 组底部的 `unknown` 子桶、仅有成员时渲染；每个 stage 组把完整 14 角色 roster 渲染为**全宽流行（flow row）**（idle 行虚线 muted——roster 永不隐藏），带 role chip / 状态点 / `×N` 计数 / 记录行（session id · 任务标签——辅助字段，绝不作标题），头部为 `N 执行中 · M 待执行` 摘要（`data-agent-summary-*`），三态图例以流内形式位于列表下方。行携带投影**透明度分级**：`emphasis: 'current' | 'next' | 'off' | null`——当前阶段角色 **100%** chrome 强度、后续阶段预期角色 **75%**、已过阶段 / 无阶段角色（on-demand、general）**45%**，`null`（无迭代 / transition 不可解析）**不覆盖**——恒为 chrome **alpha 混合**（`--mstar-canvas-emphasis-*` token；绝不整行 `opacity`，状态点与 running 辉光保持不透明）。已结算实体带**独立绿色完成框 + 绿 ✓**（`data-agent-done="true"`——圆角行体 success 边框 + 1px ring + 状态点绿 ✓，全强度 evidence 态）——**仅当 `emphasis ≠ 'off'`**；off 档角色显示灰字圆点、**绝不显示完成标记**。代理执行页含**零** `<svg>` 元素、零 `data-agent-port` / `data-canvas-*` 锚点、无 pan 变换。派发证据仍只投影**当前迭代的 plans**（steering compass `iterationId` 活跃时取之，否则经 catalog `plans[].iterationRefs` 推导最近迭代）；可证明跨迭代的事件不产生实体——roster 常驻 idle 卡，无 plan / 未知 plan / 独立 plan 的派发绝不隐藏。状态诚实：`advisory` **不再终态**——软执法派发落到配对 settle（有 settle 绿 ✓ 已完成、无 settle 显示执行中），`denied` 仍为终态，advisory verdict 仍在事件记录页呈现。**迭代信息 Section 由任务迭代与代理执行两页共用**——单一 `IterationInfoSection` 组件，两页渲染同一 `view.iteration` 块（摘要 + steps + 分支）。投影为纯函数 `projectGraph(source)`（schema 常量与 catalog 证据严格分离；永不 throw）。
+
+**依赖**：面板客户端 bundle **不携带任何图库**——`@xyflow/react` devDependency（此前构建期内联进 `dist/client.js`）随 react-flow 渲染层一并移除，唯一消费者是 `@xyflow/react/dist/style.css` 的 plain-`.css` text loader 也已删除（`CLIENT_EXTERNALS` 不变——react / react-dom 与 `@deepseek-ai/dsh-client-*` 平台模块保持外部）。构建脚本端到端断言移除成立：产物**不得含 `xyflow`/`reactflow` 标记**、`@deepseek-ai/*` 值导入为 0、**无 `import.meta` / ESM 语句**——web loader 以**经典 `<script>`** 执行插件 bundle，字面 `import.meta` 是 parse-time SyntaxError（zustand v4 的 `import.meta.env` 读取已在构建期 define 消除；见本迭代 install-verification guide §6）。当前 bundle 体积：**145,159 B raw / 29,460 B gzip**（以各迭代 install-verification guide 为重新测量 SSOT——react-flow 移除后缩至约 85 KB，代理执行页实体渲染落地后回升，透明度分级样式后再度增长）。
 
 安装 / 验证（客户端半体与服务器半体走同一条 bundle 行安装）：
 
@@ -292,7 +294,7 @@ dsh web                     # 启动 → 服务 /plugins/@mstar-harness/dsh/clie
 
 本地已验证（install-verification guide）：boot 图包含客户端 entry（`@mstar-harness/dsh` 携声明的 inject 面）、`/plugins/<id>/client.js` 路由服务的正是构建产物（rev = 内容 sha1）、浏览器握手 materialize 出插件入口（`inject` + `apply` + CSS 注入，经典脚本语义）——见 panel-beautify 迭代的 `install-verification.md` guide（本地 harness root）。
 
-**Known Limitations**（本迭代）：迭代 stepper 的 Step 1（iteration-start）在 steering compass `status: active`（Phase 1 进行中——catalog `compassStatus` 字段）时为**当前步**，且不携带 PASS/FAIL 徽标（Phase 1 无 gate 判定）；Step 5（merge-ready）**永远不会是当前步**——engine 相位门只评估 Phase 2→3→4（merge-ready 从不是 gate transition）；仅当 Step 4（pr-delivery）为当前步时渲染 `next`，其余为 idle；当前步跟随 TTL 刷新的 `compassStatus`——会话中途 `active`→`locked` 翻转后最多落后一个 catalog 间隔（60 秒）（有界、已记录的陈旧；绝不给出错误判定）；代理实体状态按**精确配对**派生（paired settle 携带的 `(agent, role, planId, taskId)` 标识精确配对到对应派发——QC tri N=3 并发下各卡各自结算；未配对派发保持 running，绝不捏造）；无 steering compass 时的「当前迭代」过滤按 plan id（8 位日期前缀）+ doneAt 推导迭代——确定性、已记录的启发式，且只丢弃可证明跨迭代的事件）；不回溯 resumed 长日志的历史行（服务端每 turn 首步必重发，digest 门控）；无自定义顶层槽位（不改 dsh-private 布局的前提下，`conversation.view` tab 是唯一的会话级面板位——spec §1）。面板验收为双轨：in-loop 浏览器 harness 验证（对重建 bundle）+ 用户重启后 GUI 终验——重跑步骤见 install-verification guide §8。
+**Known Limitations**（本迭代）：迭代 stepper 的 Step 1（iteration-start）在 steering compass `status: active`（Phase 1 进行中——catalog `compassStatus` 字段）时为**当前步**，且不携带 PASS/FAIL 徽标（Phase 1 无 gate 判定）；Step 5（merge-ready）**永远不会是当前步**——engine 相位门只评估 Phase 2→3→4（merge-ready 从不是 gate transition）；仅当 Step 4（pr-delivery）为当前步时渲染 `next`，其余为 idle；当前步跟随 TTL 刷新的 `compassStatus`——会话中途 `active`→`locked` 翻转后最多落后一个 catalog 间隔（60 秒）（有界、已记录的陈旧；绝不给出错误判定）；代理实体状态按**精确配对**派生（paired settle 携带的 `(agent, role, planId, taskId)` 标识精确配对到对应派发——QC tri N=3 并发下各卡各自结算；未配对派发保持 running，绝不捏造）；无 steering compass 时的「当前迭代」过滤按 plan id（8 位日期前缀）+ doneAt 推导迭代——确定性、已记录的启发式，且只丢弃可证明跨迭代的事件）；不回溯 resumed 长日志的历史行（服务端每 turn 首步必重发，digest 门控）；sidebar chip 标题在打开时捕获（会话中途切换语言不会翻转它——为与一方 chip 的 glyph 形态对齐而接受）；列折叠或同 pane 其它页签激活时（`tab.visible === false`）面板体不渲染任何内容（无投影、无 DOM、隐藏期零快照开销）。面板验收为双轨：in-loop 浏览器 harness 验证（对重建 bundle）+ 用户重启后 GUI 终验——重跑步骤见 install-verification guide §8。
 
 ## Development
 
@@ -314,7 +316,7 @@ bun run build
 
 #### What the model sees
 
-每个组合后的步骤携带一条 `mstar-engine-status` catalog 用户消息（`<mstar_engine_status>` 水印块——见 Engine-status catalog 一节）。闸门决策额外添加：派发否决以注册表物化的 `PreToolDecision { kind: 'deny', reason }` 错误呈现；状态闸门以 `mstar/status-gate` 咨询呈现（告警放行、hard 修复逃生或降级放行）；派发闸门以 `mstar/dispatch-gate` 咨询呈现（告警放行或降级）；技能 lint 闸门以 `mstar/skill-lint` 咨询呈现（告警放行、hard 修复逃生或降级放行）。每条模型可见的行都能从会话日志重建（catalog 形态 source + 咨询事件）。
+每个组合后的步骤携带一条 `mstar-engine` catalog 用户消息（`<mstar_engine_status>` 水印块——见 Engine-status catalog 一节）。闸门决策额外添加：派发否决以注册表物化的 `PreToolDecision { kind: 'deny', reason }` 错误呈现；状态闸门以 `mstar/status-gate` 咨询呈现（告警放行、hard 修复逃生或降级放行）；派发闸门以 `mstar/dispatch-gate` 咨询呈现（告警放行或降级）；技能 lint 闸门以 `mstar/skill-lint` 咨询呈现（告警放行、hard 修复逃生或降级放行）。每条模型可见的行都能从会话日志重建（catalog 形态 source + 咨询事件）。
 
 **Leaf 交付纪律（PM 2026-08-12）**：leaf 子代理在**最终（closing）消息**中交回完成报告，**不**通过 `report` 工具交付——dsh tool-subagent-report 默认 `reportDelivery: quiet` 会把报告投递到父代理的 next-step 队列，父代理 turn 结束（无 step 边界）后报告会滞留队列。closing 消息是可靠交付通道；`report` 保留给「中途发现、需要父代理改变下一步」的发现（SSOT：`skills/mstar-host/references/dsh.md` → PM dispatch）。
 
@@ -349,7 +351,7 @@ catalog 行在委托之后追加到组合步骤消息的**末尾**——请求
 - **CLI `HOST_SIGNALS` 缺少 `subagent` token**——engine `ToolSignal` 联合已包含它且 `detectHost` 能处理，但 `packages/cli` 的 `HOST_SIGNALS` 尚未更新，`mstar host detect --signals subagent` 会拒绝，直到上游化时更新 CLI 列表。
 - **入口是 `src/gates/*` 之上的模块索引**——拆分已交付：`src/index.ts` 从各 gate 模块（`_shared` / `status` / `skill-lint` / `seams` / `dispatch` / `catalog` / `tools` / `adapter`）原样 re-export 冻结的 56 名导出面（31 值导出 + 25 type-only 名；`Config` 计一次），并保留插件 manifest、单一 cordis augmentation 点、命令注册与 `apply()` 启动接线。导出面由 `tests/export-surface.spec.ts` 冻结——运行时值导出集 + `typecheck:tests`（`bunx tsc --noEmit -p tests/tsconfig.json`）下的值命名空间恒等与逐名类型探测。
 - **engine dsh 行待上游化**——engine `host.ts` 的 dsh 改动（`DetectResult`、`ToolSignal`、`resolveSkillRoot`）位于 mstar-workflow engine 镜像，计划经用户授权的上游 PR 合入 mstar-harness；`mstar-host` 技能镜像（§ Detect / § Resolve loaded skill root / `references/dsh.md`）随之一并更新。
-- **迭代 stepper：Step 1 为 compass 驱动，Step 5 为 schema 驱动**——zone dashboard 的 Step 1（iteration-start）在 steering compass `status: active`（Phase 1 进行中）时为当前步（无 gate 判定 → 无 PASS/FAIL 徽标）；Step 5（merge-ready）是 engine 闸门永不点亮为当前的 schema 常量（transition 只覆盖 Phase 2→3→4，merge-ready 从不是 gate transition）；仅当 Step 4 为当前步时作为 `next` 渲染，其余为 idle——已记录于迭代 guide，非缺陷。完整面板限制清单见 Web 客户端插件一节。
+- **迭代 stepper：Step 1 为 compass 驱动，Step 5 为 schema 驱动**——工作流面板的 Step 1（iteration-start）在 steering compass `status: active`（Phase 1 进行中）时为当前步（无 gate 判定 → 无 PASS/FAIL 徽标）；Step 5（merge-ready）是 engine 闸门永不点亮为当前的 schema 常量（transition 只覆盖 Phase 2→3→4，merge-ready 从不是 gate transition）；仅当 Step 4 为当前步时作为 `next` 渲染，其余为 idle——已记录于迭代 guide，非缺陷。完整面板限制清单见 Web 客户端插件一节。
 - **`dsh-llm-fallbacks` 为可选的开发期依赖**——dsh 原生覆盖 subagent 定制，fallbacks 因此严格可选：`src/` 对其零导入（运行时与类型——被消费面是本地结构镜像 `fallbacks-structural.ts`，由探测的 exact-keys 漂移闸门 + `typecheck:tests` 的 real → view 可赋值检查保持同步），`package.json` 仅在 `devDependencies` 携带它（类型镜像 + 真实包测试 harness），`dist/` 无导入也无类型引用（仅 1 处命名该包的字符串字面量——探测的 loader 条目匹配；建议日志写作 `fallbacks`）。激活是**单独显式安装**（双命令契约），绝不传递；不再有 `--external` 护栏——未来的值导入必须按设计重新加入运行时依赖。
 - **本批次未交付角色→模型覆盖**——把角色路由到 fallbacks `model`（或经 fallbacks 规则路由 persona）需要改写启动请求上的子会话 `agentOptions`，但启动请求选项由调用方控制（tool-subagent 自己的 Config；调用参数仅为 `description`/`prompt`/`run_in_background`，且深度冻结）。等待上游 `fallbacks-explicit-role-tool` 或 N-B1 systemPrompt 采纳（roadmap §10.4）。
 - **persona 交付为 dsh 原生——不再有附加段**——角色 persona 合入 `SubagentStartRequest.persona`（一次性 `start` 与可选的 continuable `startContinuable` 两个启动面），对角色匹配的子会话**遮蔽**部署 persona（子会话体现角色；持久化并在 resume 时重放）。`mstar:role-persona` system-prompt 段已不复存在。

package/bundle/README.md

@@ -82,7 +82,7 @@ The `mstar` row accepts the plugin `Config` (see `src/index.ts`):
 | `dispatchBinding` | unset → fail-closed `empty-binding` under hard | the dispatching agent's own role (the anti-recursion CALLER) for the precheck |
 | `skillRoots` | unset | additional skill roots (custom mirrors) |
 | `bundledSkillDir` | unset → plugin resolves its OWN packaged `harness-skills/` mirror package-relative | bundled skill mount — the repo-root `skills/` mirror synced by `bundle-assets` at build time (gitignored), resolved package-relative (NOT cwd-anchored). An explicit value wins; a RELATIVE override stays cwd-anchored, so pass an absolute path in the profile layer |
-| `catalogTtlMs` | unset → `60000` | pre-step catalog cache refresh interval (ms) — how often the per-workspace unified `mstar-engine-status` catalog row (watermark + iteration gate + workspace-state digest) re-reads `status.json` / the compass / the knowledge index; the hot path is a timestamp compare + cache hit between refreshes |
+| `catalogTtlMs` | unset → `60000` | pre-step catalog cache refresh interval (ms) — how often the per-workspace unified `mstar-engine` catalog row (watermark + iteration gate + workspace-state digest) re-reads `status.json` / the compass / the knowledge index; the hot path is a timestamp compare + cache hit between refreshes |
 
 ## Client half (workflow panel)
 
@@ -97,166 +97,84 @@ boot the web app serves the closure-factory CJS bundle at
 `/plugins/@mstar-harness/dsh/client.js` (rev = content sha1) and loads it via
 `window.__ModuleLoader__.load({ id, factory })`.
 
-The client entry registers a `conversation.view` view-ring tab
-(`id: 'mstar-workflow'`, `order: 20`), labeled **"MStar 工作流" / "MStar
-Workflow"**, rendering the latest `mstar-engine-status` catalog row as the
-**MStar Workflow layout**: a right sidebar (plans ≤5 time-desc + `+N more`,
-open residual findings ≤10 with severity chips + overflow hint, policy with
-enforcement first, leases, knowledge, direction) over a bottom **fixed meta
-dock** (version + harness dir; the former header row was removed), and an
-**HTML/CSS zone dashboard** as the main body — the react-flow cyclic graph
-was removed in plan `20260810-panel-canvas-zones`. The canvas fills the Tab
-(the page never scrolls; the zone container is the only scroll body) and
-lays out three zones projected from the catalog by the pure `projectGraph`
+The client entry registers a right-Sidebar page tab type (`id:
+'@mstar-harness/dsh'`, `kind: 'mstar-workflow'`, one guide-page capsule at
+`order: 20`), labeled **"MStar 工作流" / "MStar
+Workflow"**; clicking the capsule opens the panel in that pane's slot
+(replacing the guide tab, expanding the sidebar) and a second click focuses
+the existing tab (the host's page-dedup rule). The former
+`conversation.view` view-ring tab is REMOVED (migration, not a second
+surface). The body + its chip title register as keyed seats under the same
+id (`sidebar.right.pane.tab` + `sidebar.right.pane.tab.title`; the chip is
+the glyph + the title captured at open — it does not follow a mid-session
+locale switch), and a docked body renders NOTHING while `tab.visible ===
+false` (collapsed column or another pane tab active). The tab renders the
+latest `mstar-engine` catalog **anchor** row — the persisted source is the
+bare first-party `plugin` arm
+(`{ kind: 'plugin', plugin: 'mstar-engine', form: 'catalog' }`; the anchor
+reader also accepts the legacy `mstar-engine-status` identity from
+persisted logs) — and the payload is fetched from the host's
+`/api/mstar/engineStatus` endpoint (the gateway owns the route; the
+panel's browser half calls
+`connection.rpc.call('/api', 'mstar/engineStatus', { args: { sessionId, cwd } })`
+and renders the session's stored snapshot, or an explicit unavailable
+reason).
+
+**MStar Workflow layout**: a narrow-column shell bound to the sidebar
+pane's definite height — exactly three zones: the **section nav** (任务迭代
+/ 代理执行 / 事件记录; `data-mstar-tab-nav`), the panel-owned **single
+scroll body** (`[data-mstar-scroll]` — the ONLY `overflow-y` element in
+the panel; nothing scrolls horizontally; `data-mstar-graph` rides it), and
+the pinned **meta dock** (version + harness dir; never scrolls). The
+workspace-state digest (plans ≤5 time-desc + `+N more`, open residual
+findings ≤10 with severity chips + overflow hint, policy with enforcement
+first then push / worktree / control worktree, leases, knowledge,
+direction) renders IN FLOW at the end of the scroll body, closed by the
+freshness footer (`snapshot {time} · turn {turn}` — the served snapshot's
+own timestamp + turn, never "live"). The shell carries `container-type:
+inline-size`: below 480px container width padding and group gap tighten;
+at ≥720px the shared group grid spreads to two columns
+(`repeat(auto-fit, minmax(280px, 1fr))`) — the only structural change any
+width makes (one DOM, one tree; no JS layout measurement). The three
+sections stack in the scroll body: the tasks page (iteration head +
+**vertical** 5-step stepper with the FOUR-STATE `current` / `next` /
+`done` / `idle` machine + the branch panel + five stacked status groups —
+the merged「受阻/未知」/「Blocked / Unknown」column kept, `PLAN_CAP` render
+caps + the clickable 「更多」/「收起」 expand button (`data-kanban-more`) —
+then the project rollup), the events page (two partitions — Agent 流转事件
+/ 违规记录 — as flow rows, every row an expandable native `<details>`
+carrying the full catalog fields, missing fields render 「—」 never a
+guessed value), and the agents page — a **vertical grouped list** (the
+react-flow canvas, its SVG edge layer, card ports and pointer pan are
+REMOVED): two Phase groups in constant order (Phase 1 review-edit-chain
+above; Phase 2 sdd-implement → qc-tri → qa-gate below, its label
+annotating the CURRENT plan — `data-agent-group-plan` + `+N more`),
+`sdd-implement` split into implementor / reviewer sub-partitions, the
+`general` bucket sunk into an `unknown` sub-bucket, the full 14-role
+roster as full-width flow rows (idle rows dashed muted — the roster is
+never hidden) with role chip / status point / `×N` count / record line,
+the `N executing · M pending` summary, and the three-entry legend in flow
+below the list; rows carry the projected **emphasis tier**
+(`--mstar-canvas-emphasis-*` chrome alpha mix — never a whole-row
+`opacity`, so the status point + running glow stay opaque), settled
+entities get the standalone GREEN done frame + ✓ (`data-agent-done="true"`)
+ONLY when `emphasis ≠ 'off'`; the agents page contains zero `<svg>`, zero
+`data-agent-port` / `data-canvas-*` anchors and no pan transform. The
+**iteration info section is shared by the tasks AND agents pages** (one
+`IterationInfoSection`, both render the same `view.iteration` block).
+Empty branches are explicit states — `waiting` / `loading` /
+`unavailable` (with its reason) / no-harness each carry their OWN anchor
+and copy and render no tabs, no digest and no meta dock; no harness
+renders a CENTERED inactive-state card that activates automatically once a
+harness is detected. Projection is the pure `projectGraph(source)`
 function (schema constants vs catalog evidence strictly separated; never
 throws; explicit degraded states — muted empty states, never orange warn
-boxes): an **iteration zone** (Step 1–5 stepper + `Step N/5` badge,
-active-highlight / inactive dimmed states; the steps carry a FOUR-STATE machine —
-`current` / `next` / `done` / `idle` (plan `20260812-panel-f5-iteration-zone-fix`
-Task 1): every step BEFORE the current one projects `done`「已完成」(completed —
-a finished Step 1 must not read as idle while Step 2 is current), `next` is the
-single forward target, `idle` is schema-only — and the branch panel — iteration
-base / target / spec integration, rendered only while active; the expanded
-head is a LEFT-RIGHT SPLIT — branches (small left half, WIDTH-CAPPED —
-`flex: 0 1 260px` + `max-width: 280px`, never stretches with the container; the
-<860px column stack resets to content height) + steps (large right half,
-`flex: 1 1 0` absorbing the remaining width) via `data-iteration-head-split`,
-stacking on narrow widths, and NO
-branch panel when there is no active iteration; the current step follows the
-steering compass: `compassStatus: 'active'` (Phase 1 in flight) → Step 1
-(iteration-start) is CURRENT with verdict `unknown` — no PASS/FAIL badge —
-plan `20260811-panel-f4-iteration-zone`; the branches
-block left the sidebar for this in plan `20260810-panel-sidebar-info`), a
-**tasks zone** (5-column kanban: Todo / InProgress / InReview / Done /
-`blocked-unknown` — the Blocked state and the former unknown catch-all fold
-into ONE merged column titled「受阻/未知」/「Blocked / Unknown」, plan
-`20260813-panel-quick-fixes` Task 1 — with count badges; every column caps
-its rendered rows at `PLAN_CAP` with a clickable 「更多」/「收起」 expand
-button (`data-kanban-more` anchor) unfolding the full column — the
-projection keeps ALL plan rows, the cap is a render concern never a
-discard), an
-**agent-execution zone** (the four EXPECTED_ROLE_FLOW stage/phase columns
-— review-edit-chain → sdd-implement → qc-tri → qa-gate (the terminal
-stage; the former `sdd-task-review` stage is removed, its SDD L2 reviewer
-is now the pipeline role `code-reviewer`, v2.1.1) — a strict FOUR-column
-layout with NO standalone unknown column (plan
-`20260812-panel-f5-design-system` Task 5, user 2026-08-12 round-2 decision —
-the former rightmost unknown column of plan `20260812-panel-f5-agent-layout`
-is superseded): the `general` bucket sinks into an **unknown sub-partition
-at the bottom of the `qa-gate` column** (a `data-sub-bucket="unknown"`
-caption row 「unknown / 未匹配角色」 after the last qa-gate card, then the
-general cards; the standalone on-demand column was already removed in the
-agent-layout plan); `explore` is removed — no card, no column. The `sdd-implement`
-column splits into **sub-buckets** by the projected `entity.bucket` (never
-a render guess): the **implementor** partition above — flow roles in the
-stage's original order (fullstack-dev / fullstack-dev-2 / frontend-dev),
-then the on-demand roles (ops-engineer / prompt-engineer, carrying the
-**on-demand badge** — no standalone on-demand column) — and the
-**sdd-reviewer** partition below (code-reviewer, the SDD L2 task reviewer),
-with implementor / sdd-reviewer caption labels; `zone: 'on-demand'` entities
-live in the implementor partition, `zone: 'general'` entities render in the
-qa-gate column's bottom unknown sub-partition. The canvas is laid out in
-**TWO side-by-side Phase groups** (plan `20260812-panel-f5-design-system`
-Task 8, user 2026-08-12 round-4 decision #2; side-by-side layout per plan
-`20260813-panel-agent-canvas-legend-layout` Task 2): the **Phase 1 group on
-the LEFT** (review-edit-chain — the sequential Review & Edit chain) and the
-**Phase 2 group on the RIGHT** (sdd-implement → qc-tri → qa-gate — the
-iterative plan loop), top-aligned (all group label rows share the same
-`y = PAD_Y`), each with its group label row; the **Phase-2 label annotates
-the CURRENT PLAN** (projected `agents.activePlanId` — the first InProgress
-`state.plans[]` row, `data-canvas-group-plan`; `+N more` when several plans
-run in parallel, muted「无进行中 plan」when none). The subagent ENTITY cards aggregate **by role** from actual
-dispatch evidence — the same role across sessions folds into one card ×N,
-and every off-roster dispatch (the former `generalPurpose` SDD reviewer,
-`scout`, anonymous `role === ''`) folds into the single `general` bucket
-entity (the card is role-titled — the role id; the agent session id / task
-tag ride the record line, never the title) — role chip / status point / ×N
-count; running entities carry the business glow-pulse
-highlight (on the ROUNDED `.card-body` — the card is a single rounded
-element, no square outline overlay, plan `20260812-panel-f5-design-system`
-Task 5), un-evidenced stages render the dashed "待执行" pending
-placeholder with their expected role chips, un-evidenced KNOWN_AGENTS
-members render dashed idle cards (the full 14-role roster is never
-hidden), and the header shows the
-`N executing · M pending` summary; cards carry the projected **emphasis
-tier** (plan `20260812-panel-f5-design-system` Task 4, design doc §3):
-`emphasis: 'current' | 'next' | 'off' | null` — the iteration's
-current-phase roles render at **100%** chrome intensity, later-phase
-expected roles at **75%**, already-passed / stage-less (on-demand, general)
-roles at **45%**, and `null` (no iteration / unresolved transition) applies
-NO override — always a chrome **alpha mix** (`--mstar-canvas-emphasis-*`
-tokens; never a whole-card `opacity`, so the status point + running glow
-stay opaque). Settled entities get a **standalone GREEN done frame + green
-✓** (plan `20260812-panel-f5-design-system` Task 8, user round-4 decisions
-#1/#3: `data-agent-done="true"` — a full-strength success border + 1px ring
-on the rounded card body + the ✓ in the status point) **ONLY when
-`emphasis ≠ 'off'`** — an off-tier role (already-passed / stage-less
-on-demand + general) renders the muted dot instead and NEVER shows the
-completion marker. The agent canvas filters dispatch evidence to the
-**current iteration's plans only** (plan `20260813-panel-quick-fixes` Task
-2): the steering compass `iterationId` when active, else the nearest
-iteration from the catalog `plans[].iterationRefs` (most-recent plan by
-8-digit id date prefix + doneAt); provably cross-iteration events produce
-no entity/edge — the roster keeps its idle cards, and plan-less /
-unknown-plan / standalone dispatches are never hidden. Status honesty (Task
-2): `advisory` is no longer terminal — a soft-enforcement dispatch falls
-through to its paired settle (green ✓ when a settle exists, `running` when
-none), `denied` stays terminal, and the advisory verdict still renders in
-the event log. The canvas legend sits BELOW the viewport (Task 3, moved
-from above). The **iteration info section is SHARED by the tasks AND
-agents tabs** (Task 8, decision #4 — one `IterationInfoSection` component,
-both tabs render the same `view.iteration` block). Edges — plan `20260812-panel-f5-design-system` Task 5 (design
-doc §2): the `expected` stage skeleton arrows AND the ANIMATED **next** edge
-(the former `@keyframes agent-dash-flow` dash-flow arrow of plan
-`20260810-panel-agent-flow-zone`) are **REMOVED** — flow order is implied
-by the fixed column order + column labels, the current position by the
-running card glow + status point — leaving TWO semantic kinds: the
-evidence-driven **`actual` handoff** edges (same-plan ts-adjacent dispatch
-entity-key pairs, `general` endpoints filtered, ≤1 per entity pair) drawn as
-**bezier `C` curves** anchored to card **ports** — 4 fixed edge-midpoint
-ports (north / south / east / west; static-invisible, hover-revealed as
-small dots) with the arrow tip pulled back to a **10px standoff** off the
-port — the arrow follows the line's local tangent at the anchor (**H1**),
-and no line's stroke or arrow crosses any text (**H2**: standoff + side-gap
-routing, design doc §2.0/§2.5/§2.6; tightened in plan
-`20260813-panel-quick-fixes` Task 3 — same-column vertical flows whose
-center-x line would cross an in-between card body reroute into the column's
-LEFT side gap (forward AND reverse), and reverse horizontal beziers keep
-direction-aware control points BETWEEN the endpoints, never bulging into
-the adjacent column) — plus the **bidirectional supervise
-line** (plan `20260812-panel-f5-agent-layout` Task 1/2) — one static
-design-knowledge sub-bucket edge inside the `sdd-implement` column
-(implementor ↔ sdd-reviewer — the mstar-sdd mutual-supervision contract),
-now anchored at the **side-gap vertical anchor** (`x = card right edge +
-18px`, vertical bezier flow, arrows along the vertical tangent — design doc
-§2.5/§2.7); dim dashed by default, lit business SOLID when the projected
-`evidenced` flag is true — evidence-driven lighting, never a fabricated
-activation), with the
-agent-flow event strip migrated into the **事件记录 (Event Log) tab** — a
-non-canvas log page (spec F1.5, plan `20260811-panel-event-log`): two
-partitions (Agent 流转事件 / 违规记录), every row an expandable native
-`<details>` carrying the full catalog fields (missing → 「—」), muted empty
-states — the two partitions render SIDE BY SIDE in a locked-height
-two-column grid (`repeat(2, minmax(0, 1fr))` — the page never scrolls as a
-whole; each partition pins its title and owns an internal `overflow-y`
-scroll on its row list; plan `20260813-panel-quick-fixes` Task 4
-root-caused the whole-page scroll — the panel root opts into the host
-`data-conversation-composer-overlay` (the host's full-height opt-in), so
-`height:100%` resolves and `.rowList`'s `overflow-y: auto` scrolls INSIDE
-the partition (the host page no longer scrolls), with bottom clearance
-reserving the floating composer via the host-published
-`--dsh-composer-height`), falling back to two stacked 50/50 locked rows
-below 1200px (`data-event-log-*` anchors unchanged, plan
-`20260811-panel-f3-agent-general`) — the canvas-corner **AgentEventDock** is REMOVED with the page
-(无双份日志, spec §5; the fixed footer bar — zone legend + gate summary +
-violations — died with the WorkflowCanvas in the tabs-shell plan; the
-footer that remains is the freshness marker). Empty branches (spec §2, plan
-`20260812-panel-f5-agent-layout` Task 3): waiting keeps the muted hint, and
-NO harness renders a **centered inactive-state card** — folder icon + 「No
-Morning Star harness detected」 title + hint copy (the detail panel stays
-inactive — no tabs, no sidebar — and activates automatically once a harness
-is detected; `data-mstar-empty="no-harness"` stays on the title,
-`data-mstar-graph` on the main container). Below 1200px the zones stack vertically.
+boxes). Refresh follows the session snapshot, no polling — a ledger
+record (dispatch/settle) invalidates the workspace's TTL-cached catalog
+row so the panel refreshes per step; while the main agent idles the panel
+keeps the last snapshot (no live push channel). Full realized layout
+detail: `packages/dsh/README.md` (§ Web client plugin).
+
 Build step: `bun run
 build-client` (`scripts/build-client-bundle.ts` — closure-factory CJS,
 CLIENT_EXTERNALS external, CSS modules hashed + `<style data-plugin>`
@@ -265,11 +183,11 @@ injection, purity gate, and inline assertions that the bundle carries **no
 and its plain-`.css` text loader were removed with the graph layer), zero
 `@deepseek-ai/*` value imports and no `import.meta` / ESM statements — the
 web loader executes plugin bundles as classic `<script>`s); the full `bun run
-build` runs it after the node half. Verified locally: boot graph entry, the
+build` runs it after the node half. Verified against the realized install
+surface: boot graph entry, the
 `/plugins/<id>/client.js` route serving the exact built bundle, and the
 browser-handoff materialization (`inject`/`apply`/CSS injection under
-classic-script semantics) — see the
-`install-verification.md` guide of the panel-beautify iteration (local harness root).
+classic-script semantics).
 
 Known limitations (this iteration): the iteration stepper's Step 1
 (iteration-start) IS the current step while the steering compass is
@@ -289,9 +207,10 @@ never faked); the current-iteration filter with NO steering compass infers
 the iteration from plan ids (8-digit date prefix) + doneAt — a
 deterministic, documented heuristic, and only provably cross-iteration
 events are dropped; no historical
-back-scan of resumed long logs; no custom top-level slot (the
-`conversation.view` tab is the only session-level panel seat without
-dsh-private layout changes). Browser UI observation is the user-restart
+back-scan of resumed long logs; the sidebar chip title is captured at open
+time (a mid-session locale switch does not flip it), and a docked body
+renders nothing while the column is collapsed or another pane tab is active
+(`tab.visible === false`). Browser UI observation is the user-restart
 acceptance (R1 folded into this iteration's AC-1/2).
 
 ## Known constraints

package/dist/client/index.d.ts

@@ -1,14 +1,29 @@
 /**
- * Morning Star workflow panel — dsh client plugin entry (spec §4.1):
+ * Morning Star workflow panel — dsh client plugin entry (plan sidebar §L1.3):
  * `inject` (cordis service waits) + `apply(ctx: ClientContext)`.
  *
- * On apply: registers the `mstar-panel` dictionaries, then waits for the
- * ui-conversation `conversation.view` declaration and registers the panel as
- * a view tab (`id: 'mstar-workflow'`, `order: 20`, locale-following label
- * thunk — the trajectory precedent shape). The tab label re-reads through
- * `ctx.locale.bind(NS)` so a locale switch flips it without re-registering.
+ * On apply: creates the engine-status client over the client `connection`
+ * service (the panel's data path is the host's shared `/api` typert gateway —
+ * the persisted catalog row is only the anchor), registers the `mstar-panel`
+ * dictionaries, registers the panel as a right-Sidebar page tab type
+ * (`ctx.sidebarRightTabs.register`, `kind: 'mstar-workflow'`, one guide
+ * capsule at order 20), then waits for the ui-sidebar-right seat
+ * declarations and registers the panel body and its chip title as keyed
+ * entries under the definition's `id` — the two-stage seat contract. The old
+ * conversation-area view-tab registration is gone: the sidebar tab REPLACES
+ * the conversation-area tab (a migration, not a second surface).
+ *
+ * The client is created ONCE per apply and disposed with the fiber, so a
+ * reloaded plugin starts from a clean snapshot cache. Every registration
+ * sits in its own `ctx.effect` so unload disposes it.
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-/** Cordis service faces the plugin waits for (spec §4.4: slots + sessions + locale). */
+/**
+ * Cordis service faces the plugin waits for (spec §4.4: slots + sessions +
+ * locale + the wire + the tab-type registry). `sessions` is load-bearing as
+ * the session standard scope's wait and `connection` carries the
+ * engine-status transport; `sidebarRightTabs` is the registry `apply`
+ * registers the page tab type into.
+ */
 export declare const inject: string[];
 export declare function apply(ctx: ClientContext): void;

package/dist/client/panel/MstarPanelTitle.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The panel's chip title seat (plan sidebar §L1.3): draws the MStar glyph
+ * before the tab title, exactly as the shipped glyph-bearing title seats do,
+ * so the chip does not read as a bare label next to first-party chips. It is
+ * decoration only — the copy comes from the registry's `title(address)` text
+ * captured at open time, so it does not follow a live locale switch
+ * (documented regression F2; restoring liveness would cost a store-backed
+ * title registration for no user-visible gain).
+ */
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** The chip title seat's props: the framework-injected tab information hook. */
+export type MstarPanelTitleProps = PropsRuntime<'sidebar.right.pane.tab.title'>;
+export declare function MstarPanelTitle({ useTabInfo }: MstarPanelTitleProps): import("react").JSX.Element;