@mstar-harness/dsh 3.8.0 → 3.8.1

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

@@ -1,60 +1,67 @@
 /**
- * Morning Star workflow panel page — the `conversation.view` tab component
- * (spec §4.2): render of the session's engine-status snapshot.
+ * Morning Star workflow panel page — the right-Sidebar pane body (the keyed
+ * `sidebar.right.pane.tab` seat component, plan sidebar §L1.5): render of the
+ * session's engine-status snapshot.
  *
- * Inputs: the session standard kit (`ConvViewProps` + the session-list seat),
- * the plugin's engine-status client (bound to the client `connection` service
- * by the plugin entry) and the typed `t` seat (`locale: 'mstar-panel'`). The
- * `useMstarEngineStatus()` hook turns the anchor row + the served snapshot
- * into ONE explicit render state (spec §5) — the render body is a pure
- * function of (state, payload, snapshot `at`, t).
+ * Inputs: the sidebar seat's props (`MstarPanelBodyProps` — the seat's
+ * runtime share incl. the framework-injected `useTabInfo()` + the session
+ * standard kit + the entry store share (`useStore` + baked `select`, backed
+ * by the registration's `store` option) + the plugin's engine-status client
+ * bound by the plugin entry + the typed `t` seat (`locale: 'mstar-panel'`)).
+ * The `useMstarEngineStatus()` hook turns the anchor row + the served
+ * snapshot into ONE explicit render state (spec §5) — the render body is a
+ * pure function of (state, payload, snapshot `at`, t).
  *
- * Layout (spec panel-tabs §2): root grid
- * `"main sidebar"` fills the Tab (height 100%, overflow hidden — the page
- * never scrolls); the right sidebar is RESIDENT (all tabs share it, its props
- * `{ t, state, source }` unchanged); main = the fixed header nav (TabNav, 3
- * MenuTabs) + the content region (switches per tab) + the freshness footer.
- * The `data-mstar-graph` anchor now marks the CONTENT container (spec §6.1 —
- * previously the canvas container), so tests pin the layout contract, not the
- * per-tab page internals.
+ * Visibility (plan sidebar §L2.6): a docked body is projected only while its
+ * sidebar column is expanded and the tab is active —
+ * `useTabInfo().tab.visible` — so a collapsed column renders NOTHING (no
+ * projection, no DOM). A floating pane is always visible.
  *
- * Tab state (spec §6.2): local `useState<PanelTab>` (default 'tasks', D1, no
- * routing) — `renderToStaticMarkup` renders the default tasks page, keeping
- * SSR assertions stable. The tasks tab renders the IterationTaskPage (Content
- * Head + Steps 横排/收拢 + full-width kanban, spec §3 —
- * replacing the WorkflowCanvas zone dashboard); the agents tab renders the
- * draggable AgentCanvasPage (spec §4 — replacing the muted placeholder + the AgentFlowZone); the events tab
- * renders the EventLogPage (spec §5 — the non-canvas log page with per-row
- * `<details>` expansion, replacing
- * the muted placeholder AND the AgentEventDock — 无双份日志).
+ * Layout (plan sidebar §L2.1): the narrow-column shell is a single flex
+ * column with exactly three zones — the section nav (`flex: none`), the
+ * panel-owned scroll body (`[data-mstar-scroll]`, flex: 1 1 auto ·
+ * min-height: 0 · the ONLY `overflow-y: auto` element in the panel; it also
+ * carries the `data-mstar-graph` content-container anchor), and the pinned
+ * meta dock (`flex: none`). The workspace-state digest renders IN FLOW at the
+ * end of the scroll body (the old 300px sibling column and its nested
+ * scroller are gone); the freshness footer follows it in the same flow.
  *
- * Empty branches (spec §2): waiting / loading / unavailable / no-harness render
- * no tabs and no sidebar — each with its OWN anchor and copy, so a degraded
- * read is never mistakable for an empty workspace. Waiting keeps the muted
- * hint; loading states the pending read; unavailable carries the
- * machine-readable reason; the no-harness branch renders a CENTERED
- * inactive-state card (icon + title + hint) with the freshness footer, and its
- * main keeps `data-mstar-graph` on the content container. Degradation stays
- * total: `projectGraph` never throws; no iteration → the IterationTaskPage's
- * collapsed muted head (spec §8); `state` null / plans missing → muted kanban
- * skeleton.
+ * Section state (plan sidebar §L2.4): the entry store, keyed by
+ * `tabInfo.tab.id` (default `'tasks'`, D1) — it survives the body's unmount
+ * when another pane tab activates, which `useState` cannot. The render is
+ * SSR-stable: an untouched store reads `undefined` → the default tasks page.
+ *
+ * Empty branches (spec §2): waiting / loading / unavailable / no-harness
+ * render no tabs, no digest and no meta dock — each with its OWN anchor and
+ * copy, so a degraded read is never mistakable for an empty workspace.
+ * Degradation stays total: `projectGraph` never throws; no iteration → the
+ * IterationTaskPage's collapsed muted head (spec §8); `state` null / plans
+ * missing → muted kanban skeleton.
  */
 import * as React from 'react';
-import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
-import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PropsLocale, PropsRuntime, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-session';
 import type { MstarEngineStatusPayload } from '../../types.ts';
+import type { PropsStore } from '@deepseek-ai/dsh-client-store';
 import type { MstarEngineStatusClient } from './engine-status-client.ts';
-import { type PanelTab } from './TabNav.tsx';
 import { type UseSessions } from './use-mstar-engine-status.ts';
-export interface MstarPanelViewProps extends ConvViewProps {
+import { createPanelStore, type PanelSection } from './panel-store.ts';
+/**
+ * The sidebar body seat's props (plan sidebar §L1.5): the seat's runtime
+ * share (owner + keyed + the seat's inject face — `useTabInfo()` — + the
+ * session standard kit, incl. the ui-chat-merged `useChat`) + the entry
+ * store share (plan §L2.4 — the registration's `store` option) + the typed
+ * `t` seat from the registration's `locale:` option.
+ */
+export interface MstarPanelBodyProps extends PropsRuntime<'sidebar.right.pane.tab'>, PropsStore<ReturnType<typeof createPanelStore>>, PropsLocale<'mstar-panel'> {
     /** Namespace-bound translate seat (`locale: 'mstar-panel'`). */
     t: TranslateNS<'mstar-panel'>;
     /**
      * Current session identity — the session standard kit's own prop. Declared
      * here (rather than inherited) because this package does not depend on the
      * ui-session adapter that merges the session-kit declarations into
-     * `ConvViewProps`; the view ring always supplies it at runtime.
+     * `SessionStandardProps`; the seat's session scope always supplies it at
+     * runtime.
      */
     sessionId?: SessionId;
     /** Host session-list selector hook (the global standard seat, same reason). */
@@ -67,20 +74,17 @@ export interface MstarPanelViewProps extends ConvViewProps {
     engineStatus?: MstarEngineStatusClient;
 }
 export interface PanelContentProps {
-    tab: PanelTab;
+    /** The active panel section (plan sidebar §L1.5 vocabulary — not a sidebar tab record). */
+    section: PanelSection;
     source: MstarEngineStatusPayload;
     t: TranslateNS<'mstar-panel'>;
 }
 /**
- * Tab → page mapping (spec §6.2): the only per-tab-switching part of the
- * layout. tasks = the IterationTaskPage (spec §3 — Content Head + Steps
- * 横排/收拢 + full-width kanban, it replaced the
- * WorkflowCanvas zone dashboard, whose file is removed by the plan close);
- * agents = the draggable AgentCanvasPage (spec §4 — full KNOWN_AGENTS roster
- * + idle states + AgentEdge collaboration edges; it replaced the muted placeholder and the AgentFlowZone); events =
- * the real EventLogPage (spec §5 — non-canvas log page: Agent 流转事件 +
- * 违规记录 partitions with per-row `<details>` expansion; it replaced the muted placeholder AND the
- * AgentEventDock — 无双份日志, the dock is removed with this plan).
+ * Section → page mapping (spec §6.2): the only per-section-switching part of
+ * the layout. tasks = the IterationTaskPage (spec §3 — Content Head + Steps
+ * + the plan board); agents = the AgentListPage (spec §4 — the vertical
+ * grouped list, plan sidebar §L3); events = the EventLogPage (spec §5 — the
+ * log page with per-row `<details>` expansion).
  */
-export declare function PanelContent({ tab, source, t }: PanelContentProps): React.JSX.Element;
-export declare function PanelView({ t, useChat, useSessions, sessionId, engineStatus }: MstarPanelViewProps): React.JSX.Element;
+export declare function PanelContent({ section, source, t }: PanelContentProps): React.JSX.Element;
+export declare function PanelView({ t, useChat, useSessions, sessionId, engineStatus, useTabInfo, useStore, actions }: MstarPanelBodyProps): React.JSX.Element | null;

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

@@ -1,28 +1,31 @@
 /**
  * TabNav (spec panel-tabs §2/§6.1) —
- * the fixed header nav: 3 MenuTabs (任务迭代 / 代理执行 / 事件记录, F1.2)
- * switching the main content. Tab state is owned by PanelView
- * (`useState<PanelTab>`, default 'tasks', no routing — SSR-stable under
- * `renderToStaticMarkup`); TabNav is a controlled component receiving
- * `active` + `onChange` (spec §6.1 interface contract).
+ * the section nav, the shell's first flex zone (`flex: none`): the three
+ * internal sections (任务迭代 / 代理执行 / 事件记录) of the one sidebar tab.
+ * Section state is owned by the panel entry store (plan sidebar §L2.4 —
+ * keyed by the sidebar tab record, default 'tasks', no routing); TabNav is a
+ * controlled component receiving `active` + `onChange` (spec §6.1 interface
+ * contract).
  *
  * Anchors: `data-mstar-tab-nav` (the nav frame), `data-mstar-tab="{id}"` on
  * every tab and `data-mstar-tab-active="true|false"` (activation state). The
  * active tab gets the business-token underline; inactive tabs stay secondary.
+ * Visual language (plan sidebar §L2.3): the strip ABOVE this nav is the dsh
+ * tab chrome (chips with borders — the host's, untouched); this nav is
+ * content — `role="tablist"`, `role="tab"` + `aria-selected`, the underline
+ * via `box-shadow`, no borders on the tabs.
  *
- * A11y: the nav is a WAI-ARIA tablist and each tab is a
- * `role="tab"` button with `aria-selected` (APG Tabs pattern, replacing the
- * former `aria-pressed` toggle). Deliberately minimal: every tab stays Tab-
- * reachable (no roving tabindex / arrow-key handling — that behavior would
- * be scope creep without an explicit keyboard contract).
+ * A11y: WAI-ARIA tablist, each tab a `role="tab"` button with
+ * `aria-selected` (APG Tabs pattern). Deliberately minimal: every tab stays
+ * Tab-reachable (no roving tabindex / arrow-key handling — that behavior
+ * would be scope creep without an explicit keyboard contract).
  */
 import * as React from 'react';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
-/** The three fixed panel tabs (spec §2 — D1 default = 'tasks'). */
-export type PanelTab = 'tasks' | 'agents' | 'events';
+import type { PanelSection } from './panel-store.ts';
 export interface TabNavProps {
-    active: PanelTab;
-    onChange: (tab: PanelTab) => void;
+    active: PanelSection;
+    onChange: (tab: PanelSection) => void;
     t: TranslateNS<'mstar-panel'>;
 }
 export declare function TabNav({ active, onChange, t }: TabNavProps): React.JSX.Element;

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

@@ -0,0 +1,23 @@
+/**
+ * The panel's right-Sidebar tab-type definition (plan sidebar §L1.2) — stage
+ * one of the two-stage seat registration: what the panel IS in the tab
+ * system. Stage two (the keyed `sidebar.right.pane.tab` body and
+ * `sidebar.right.pane.tab.title` chip under the same `id`) lives in the
+ * plugin entry (`src/client/index.ts`).
+ *
+ * A page type: `patterns`/`canOpen` omitted (it recognizes no resource
+ * address — it is opened by `kind`), `priority` omitted (defaults to the
+ * `extension` band, the right band for a type from outside the product), and
+ * exactly one guide entry so the start page carries the MStar capsule. The
+ * `title` thunk is re-read on every use, so the guide capsule follows the
+ * current locale; the chip's copy is captured at open time by the host.
+ */
+import type { SidebarRightTabDefinition } from '@deepseek-ai/dsh-client-ui-sidebar-right/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/** This implementation's identity in the tab system — the key its body and title register under. */
+export declare const MSTAR_PANEL_ID = "@mstar-harness/dsh";
+/** The page kind the panel owns (U2: one sidebar tab). */
+export declare const MSTAR_PANEL_KIND = "mstar-workflow";
+/** The guide capsule's position among every registered type's entries (files ships order 10). */
+export declare const MSTAR_GUIDE_ORDER = 20;
+export declare function mstarPanelDefinition(t: TranslateNS<'mstar-panel'>): SidebarRightTabDefinition;

package/dist/client/panel/graph/project-graph.d.ts

@@ -35,8 +35,7 @@
  *   (the stage skeleton + entities/edges now live in the `agents` projection —
  *   spec §4);
  * - added: `iteration.steps / currentStep / branches`, `tasks.columns / total
- *   / truncated`, `agents` (entities + actual/supervise edges + executing/
- *   pending counts — spec §4).
+ *   / truncated`, `agents` (entities + executing/pending counts — spec §4).
  *
  * Agent-entity semantics (the per-role aggregation): entities aggregate by ROLE, not by session
  * — a KNOWN_AGENTS roster role keys its own card (same role across sessions
@@ -48,8 +47,8 @@
  * RENDER places `zone: 'general'` entities in an unknown sub-partition at
  * the bottom of the LAST column (the standalone rightmost unknown column
  * is superseded: 4 columns total). The SDD loop back-edge (sdd-implement →
- * general) stays REMOVED from the projection; the supervise line is a SEPARATE sub-bucket edge
- * (`kind: 'supervise'`, see `superviseEdges`). The event-log `unexpected`
+ * general) and the sub-bucket supervise line are both REMOVED from the
+ * projection — the agents zone projects entities only. The event-log `unexpected`
  * badge is a SEPARATE, unchanged semantic (`expected` ⟺ role ∈
  * EXPECTED_ROLE_FLOW union). The `sdd-implement` column is further split
  * into implementor / reviewer SUB-BUCKETS: every entity carries a projected `bucket` field ('implementor' /
@@ -215,7 +214,7 @@ export interface AgentEntityView {
      * non-roster dispatch); the KNOWN_AGENTS role id for idle cards. INVARIANT
      * (spec §6.2): keys are UNIQUE across the whole `entities` array —
      * an evidence-derived `general` key suppresses the idle general twin in
-     * `idleEntities`, so the React `key` / `layoutAgents` `cards.set` never see
+     * `idleEntities`, so the render layer's entity `key` space never sees
      * duplicates.
      */
     key: string;
@@ -291,44 +290,6 @@ export type AgentEmphasis = 'current' | 'next' | 'off' | null;
 export type AgentEntityStatus = 'running' | 'settled' | 'error' | 'denied'
 /** Retained for shape compat; the derivation (entityStatus) no longer emits it. */
  | 'advisory' | 'idle';
-/** Edge kinds (spec §4 — the finalized line semantics, design doc §2.2): handoff / sub-bucket
- * supervision arrows. `expected` (stage skeleton) and `next` (running
- * animation) are REMOVED — the column order implies the flow, the running
- * card glow/status point carries the position. */
-export type AgentEdgeKind = 'actual' | 'supervise';
-/**
- * One agents-zone arrow (spec §4):
- * - `actual`: same-plan handoff between ts-adjacent dispatch ENTITY keys
- *   (source/target = entity key — role-based). The line set filters
- *   general-bucket endpoints
- *   (a general handoff is noise, not a meaningful transfer) and keeps at most
- *   ONE edge per entity-key pair (the latest direction) — design doc §2.2;
- * - `supervise`: ONE static sub-bucket line inside the `sdd-implement`
- *   column — implementor ↔ reviewer mutual supervision (the mstar-sdd
- *   mutual-supervision contract; the render draws it as a bidirectional
- *   double arrow).
- *   source/target embed the column id as an anchor prefix:
- *   `<stage-id>:implementor` / `<stage-id>:reviewer`. NOT per-entity pairs —
- *   drawing per-role pairs would fabricate concrete supervision relations
- *   where no evidence exists (evidence-level handoffs are covered by
- *   `actualEdges`). STATIC presence (design knowledge) + evidence-driven
- *   lighting via `evidenced` (dim without implement/review dispatch
- *   evidence, lit with it — never a fabricated activation).
- */
-export interface AgentEdge {
-    kind: AgentEdgeKind;
-    /** actual: entity key; supervise: `<stage-id>:implementor|reviewer`. */
-    source: string;
-    target: string;
-    /** Unused by the line edge set (the removed `next` arrow carried the
-     * running entity key); kept for shape stability — always null. */
-    entityKey: string | null;
-    /** Supervise edges only:
-     * evidence-driven lighting — true when any dispatch row's role belongs to
-     * an SDD sub-bucket (implementor ∪ reviewer), false otherwise (dim).
-     * Absent (undefined) for actual. */
-    evidenced?: boolean;
-}
 /**
  * The canvas degradation-note classification (spec §8): the projection
  * decides the note from the RAW ledger (never a UI-side heuristic on the
@@ -341,8 +302,8 @@ export interface AgentEdge {
 export type AgentZoneNote = 'empty' | 'settle-only' | null;
 /**
  * The projected agents zone (spec §4 + §6.2): the EXPECTED_ROLE_FLOW stage
- * skeleton plus the dispatch-derived entity cards and the actual/supervise
- * arrows. Total function — NEVER throws and NEVER fabricates: the KNOWN_AGENTS
+ * skeleton plus the dispatch-derived entity cards. Total function — NEVER
+ * throws and NEVER fabricates: the KNOWN_AGENTS
  * roster always projects as entities (idle cards when there is no evidence) —
  * agentFlow missing/unreadable → `degraded` (full idle roster + no
  * executing/pending claims); 0 events → `empty` (full idle roster + pending
@@ -360,8 +321,6 @@ export interface AgentZoneView {
     note: AgentZoneNote;
     /** Evidence-derived dispatch entities ∪ idle KNOWN_AGENTS cards — the full roster is NEVER hidden (spec §6.2). */
     entities: readonly AgentEntityView[];
-    /** expected (stage skeleton) + actual (same-plan handoffs) + at most one next (latest running). */
-    edges: readonly AgentEdge[];
     /** `running` entity count — the summary "N 执行中" (idle cards never count). */
     executing: number;
     /** Sum of expected roles of stages with no dispatch evidence — the summary "M 待执行". */
@@ -458,8 +417,7 @@ export declare function projectGraph(source: MstarEngineStatusPayload | null): Z
  *   role is pending);
  * - otherwise: entities aggregated from dispatch rows (with `idle: false`),
  *   statuses via the shared pairing walk, the un-evidenced KNOWN_AGENTS
- *   members appended as idle cards, actual/supervise edges (design doc §2.2 —
- *   the `expected` skeleton and `next` animation edges are REMOVED), and the
+ *   members appended as idle cards, and the
  *   executing (running entities — idle never counts) / pending
  *   (un-evidenced stage roles) counts.
  *
@@ -468,8 +426,8 @@ export declare function projectGraph(source: MstarEngineStatusPayload | null): Z
  * suppresses a known role's idle card when its id already exists as an
  * evidence-derived entity key (a NON-roster dispatch produces a lit `general`
  * key while the roster `general` id stays un-evidenced — the twin is
- * suppressed via `litKeys`), so the render layer's `key`/`cards.set` never
- * collide.
+ * suppressed via `litKeys`), so the render layer's entity `key` space never
+ * collides.
  *
  * Canvas note: `note` classifies the readable ledger in
  * the projection ('empty' / 'settle-only' / null — see `AgentZoneNote`); the

package/dist/client/panel/graph/schema.d.ts

@@ -82,8 +82,7 @@ export declare const TRANSITION_TO_PHASE: Readonly<Record<string, PhaseId>>;
  * placement (BOTTOM INSIDE the `sdd-implement` column bucket) is
  * superseded by the F5; the former SDD implement ↔ review
  * skeleton EDGE (sdd-implement → general back-edge, the `loop: true` arrow)
- * stays REMOVED from the projection ; the F5 supervise line is a SEPARATE sub-bucket edge (see
- * project-graph.ts `superviseEdges`).
+ * and the F5 sub-bucket supervise line are both REMOVED from the projection.
  *
  * Matching rules (spec §2.3 — implemented by `projectGraph`'s flow
  * projection): `expected` ⟺ `event.role` ∈ the union of ALL `roles` below

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

@@ -122,7 +122,7 @@ import type { LocaleDictOf } from '@deepseek-ai/dsh-client-ui-slots';
 /** Locale namespace id for the workflow-viz panel. */
 export declare const NS = "mstar-panel";
 /** Panel dictionary keys (union of every translatable string the panel renders). */
-export type PanelKey = 'view.mstar-workflow' | 'tab.tasks' | 'tab.agents' | 'tab.events' | 'page.iteration.not-started' | 'page.iteration.expand' | 'page.iteration.collapse' | 'event-log.section.events' | 'event-log.section.violations' | 'event-log.empty' | 'event-log.empty.events' | 'event-log.empty.violations' | 'event-log.field.role' | 'event-log.field.agent' | 'event-log.field.stage' | 'event-log.field.plan' | 'event-log.field.task' | 'event-log.field.category' | 'event-log.field.time' | 'event-log.field.kind' | 'event-log.field.status' | 'event-log.field.expected' | 'event-log.field.settled' | 'event-log.field.duration' | 'event-log.field.run-id' | 'event-log.field.name' | 'event-log.field.members' | 'event-log.field.stop-reason' | 'event-log.field.severity' | 'event-log.field.code' | 'event-log.field.message' | 'event-log.kind.dispatch' | 'event-log.kind.settle' | 'event-log.yes' | 'event-log.no' | 'empty.waiting' | 'empty.loading' | 'empty.unavailable' | 'empty.no-harness' | 'empty.no-harness-hint' | 'watermark.version' | 'watermark.harness' | 'watermark.none' | 'panel.unknown' | 'graph.pass' | 'graph.fail' | 'zone.legend.title' | 'zone.legend.agent-running' | 'zone.legend.agent-settled' | 'zone.legend.agent-idle' | 'zone.iteration.step-label' | 'zone.iteration.step-badge' | 'zone.iteration.step.current' | 'zone.iteration.step.next' | 'zone.iteration.step.done' | 'zone.iteration.step.idle' | 'zone.phase.iteration-start' | 'zone.phase.autonomous-execute' | 'zone.phase.iteration-close' | 'zone.phase.pr-delivery' | 'zone.phase.merge-ready' | 'zone.branches.title' | 'zone.branches.iteration-base' | 'zone.branches.target' | 'zone.branches.spec-integration' | 'zone.tasks.title' | 'zone.tasks.total' | 'zone.tasks.no-plans' | 'zone.tasks.more' | 'zone.tasks.collapse' | 'zone.project.title' | 'zone.project.milestones' | 'zone.project.residuals' | 'zone.project.none' | 'zone.state.Todo' | 'zone.state.InProgress' | 'zone.state.InReview' | 'zone.state.Done' | 'zone.state.blocked-unknown' | 'zone.agents.title' | 'zone.agents.summary' | 'zone.agents.on-demand' | 'zone.agents.unknown-sub' | 'zone.agents.bucket.implementor' | 'zone.agents.bucket.reviewer' | 'zone.agents.group.phase-1' | 'zone.agents.group.phase-2' | 'zone.agents.group.phase-n' | 'zone.agents.group.plan' | 'zone.agents.group.no-plan' | 'zone.agents.group.plan-more' | 'flow.empty' | 'flow.settle-only' | 'flow.degraded' | 'flow.unexpected' | 'flow.in-flight' | 'flow.settled-ok' | 'flow.error' | 'flow.advisory' | 'flow.denied' | 'state.title' | 'state.selection' | 'state.selection.history' | 'state.plans' | 'state.residuals' | 'state.policy' | 'state.leases' | 'state.knowledge' | 'state.direction' | 'state.none' | 'state.enforcement' | 'state.enforcement.hard' | 'state.enforcement.soft' | 'state.plans.more' | 'state.residual.more' | 'state.policy.push' | 'state.policy.worktree' | 'state.policy.control-worktree' | 'state.knowledge.docs' | 'freshness.last-updated' | 'freshness.refresh-note';
+export type PanelKey = 'view.mstar-workflow' | 'guide.description' | 'tab.tasks' | 'tab.agents' | 'tab.events' | 'page.iteration.not-started' | 'page.iteration.expand' | 'page.iteration.collapse' | 'event-log.section.events' | 'event-log.section.violations' | 'event-log.empty' | 'event-log.empty.events' | 'event-log.empty.violations' | 'event-log.field.role' | 'event-log.field.agent' | 'event-log.field.stage' | 'event-log.field.plan' | 'event-log.field.task' | 'event-log.field.category' | 'event-log.field.time' | 'event-log.field.kind' | 'event-log.field.status' | 'event-log.field.expected' | 'event-log.field.settled' | 'event-log.field.duration' | 'event-log.field.run-id' | 'event-log.field.name' | 'event-log.field.members' | 'event-log.field.stop-reason' | 'event-log.field.severity' | 'event-log.field.code' | 'event-log.field.message' | 'event-log.kind.dispatch' | 'event-log.kind.settle' | 'event-log.yes' | 'event-log.no' | 'empty.waiting' | 'empty.loading' | 'empty.unavailable' | 'empty.no-harness' | 'empty.no-harness-hint' | 'watermark.version' | 'watermark.harness' | 'watermark.none' | 'panel.unknown' | 'graph.pass' | 'graph.fail' | 'zone.legend.title' | 'zone.legend.agent-running' | 'zone.legend.agent-settled' | 'zone.legend.agent-idle' | 'zone.iteration.step-label' | 'zone.iteration.step-badge' | 'zone.iteration.step.current' | 'zone.iteration.step.next' | 'zone.iteration.step.done' | 'zone.iteration.step.idle' | 'zone.phase.iteration-start' | 'zone.phase.autonomous-execute' | 'zone.phase.iteration-close' | 'zone.phase.pr-delivery' | 'zone.phase.merge-ready' | 'zone.branches.title' | 'zone.branches.iteration-base' | 'zone.branches.target' | 'zone.branches.spec-integration' | 'zone.tasks.title' | 'zone.tasks.total' | 'zone.tasks.no-plans' | 'zone.tasks.more' | 'zone.tasks.collapse' | 'zone.project.title' | 'zone.project.milestones' | 'zone.project.residuals' | 'zone.project.none' | 'zone.state.Todo' | 'zone.state.InProgress' | 'zone.state.InReview' | 'zone.state.Done' | 'zone.state.blocked-unknown' | 'zone.agents.title' | 'zone.agents.summary' | 'zone.agents.on-demand' | 'zone.agents.unknown-sub' | 'zone.agents.bucket.implementor' | 'zone.agents.bucket.reviewer' | 'zone.agents.group.phase-1' | 'zone.agents.group.phase-2' | 'zone.agents.group.phase-n' | 'zone.agents.group.plan' | 'zone.agents.group.no-plan' | 'zone.agents.group.plan-more' | 'flow.empty' | 'flow.settle-only' | 'flow.degraded' | 'flow.unexpected' | 'flow.in-flight' | 'flow.settled-ok' | 'flow.error' | 'flow.advisory' | 'flow.denied' | 'state.title' | 'state.selection' | 'state.selection.history' | 'state.plans' | 'state.residuals' | 'state.policy' | 'state.leases' | 'state.knowledge' | 'state.direction' | 'state.none' | 'state.enforcement' | 'state.enforcement.hard' | 'state.enforcement.soft' | 'state.plans.more' | 'state.residual.more' | 'state.policy.push' | 'state.policy.worktree' | 'state.policy.control-worktree' | 'state.knowledge.docs' | 'freshness.last-updated' | 'freshness.refresh-note';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         'mstar-panel': PanelKey;

package/dist/client/panel/mstar-glyph.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The panel's own inline glyph (plan sidebar §L1.3): the icon the guide
+ * capsule draws before its title, and the chip title seat draws before the
+ * captured tab title. Deliberately NOT imported from
+ * `@deepseek-ai/dsh-client-ui-primitives` — dynamic client plugins may not
+ * import runtime values from other client plugins (types only), and the
+ * client bundle's purity gate rejects `@deepseek-ai/*` value imports — so the
+ * glyph is our own `<svg>` on `currentColor`, `IconProps`-shaped like the
+ * shipped `CompassGlyph`/`CubeGlyph`.
+ */
+import type { IconProps } from '@deepseek-ai/dsh-client-ui-primitives';
+/**
+ * The brand star on `currentColor` — the plugin's mark at guide and chip
+ * sizes (14–16px). `size` defaults to 16 (the guide-capsule size — the
+ * definition registers this component with no props); the chip title seat
+ * passes 14 explicitly. The geometry is the brand mark from the repo's
+ * `assets/` logos (`logo.svg` / `logo-dark.svg`): the star path reused
+ * verbatim (viewBox 512), the assets' colored rounded tile dropped — no
+ * tile, no hardcoded colors — `fill='currentColor'` so the host's chip/guide
+ * styling themes the mark.
+ */
+export declare function MstarGlyph({ size, className }: IconProps): import("react").JSX.Element;

package/dist/client/panel/pages/AgentListPage.d.ts

@@ -0,0 +1,71 @@
+/**
+ * AgentListPage (plan sidebar §L3) — the 代理执行 tab: a VERTICAL GROUPED
+ * LIST. Replaces the deleted absolutely-positioned agent canvas: every
+ * geometry concept (the coordinate-space content layer, the pointer pan, the
+ * stage columns, the card boxes, the SVG edge layer, the card ports) is
+ * gone — the flow itself is carried by the group/stage/sub-bucket headings
+ * in constant order, exactly as the column order did before.
+ *
+ * Grouping (plan sidebar §L3.2 — locked, PROJECTION-driven, never a render
+ * guess): two levels. The OUTER group is the phase of the entity's stage
+ * (`entity.stage.phase`, or `entity.zone` when `stage === null`), in the
+ * `EXPECTED_ROLE_FLOW`/`view.stages` constant order — Phase 1
+ * (iteration-start: the sequential review-edit-chain) then Phase 2
+ * (autonomous-execute: the iterative plan loop, annotated with the current
+ * `activePlanId`). The INNER group is the stage with the implementor stage
+ * split by the PROJECTED `entity.bucket`: the implementor partition above
+ * (flow roles in `SDD_BUCKET_ROLES.implementor` order, then the on-demand
+ * roles, carrying the on-demand badge) and the reviewer partition below —
+ * plus the「unknown / 未匹配角色」sub-bucket at the bottom of the LAST stage
+ * group for `zone: 'general'` entities, rendered only when it has members
+ * (the canvas's placement rule, unchanged). Every stage group always
+ * renders, because the projection always yields the full 14-role roster as
+ * cards (idle at minimum). The implementor-partition host stage is DERIVED
+ * from the projected skeleton (the stage whose expected roles intersect
+ * `SDD_BUCKET_ROLES.implementor`), so a phase/stage rename can never
+ * silently orphan the sub-buckets; absent that stage the LAST stage group is
+ * the total-function sink (never a throw).
+ *
+ * Card anatomy (plan sidebar §L3.3): each entity is a FULL-WIDTH FLOW ROW —
+ * no inline box style, no absolute positioning, no ports. The status point,
+ * done-✓ restriction (`status === 'settled' && emphasis !== 'off'`), the
+ * title rule, the ×N count, the role chip, the record line and the on-demand
+ * badge are all carried over unchanged.
+ *
+ * Emphasis tiers (design doc §3): the projected `data-agent-emphasis` tier
+ * fades the card CHROME only (chrome colors mix toward the layer background
+ * by tier — current 100% / next 75% / off 45%, theme-independent per
+ * `DESIGN.md` §3.5) — NEVER a whole-card opacity, so the status point and
+ * the ✓ never fade.
+ *
+ * Shared iteration section: the page renders the SAME `IterationInfoSection`
+ * the tasks tab uses, from the SAME `view.iteration` data — 两个 tab 显示同一
+ * 迭代信息块. The degradation note (degraded / empty / settle-only) is
+ * PROJECTED metadata, never inferred from the entity list, and the `Legend`
+ * (the 3 role-card status treatments) sits in flow BELOW the list.
+ *
+ * Scrolling (plan sidebar §L2.2): the page owns NO scroller — the rows grow
+ * the panel's single scroll body (`[data-mstar-scroll]`). The phase groups
+ * ride the shell's shared `.groupGrid` class (one column below the 720px
+ * container breakpoint, the two-column spread above it is that rule's).
+ */
+import * as React from 'react';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ZoneView } from '../graph/project-graph.ts';
+export interface AgentListPageProps {
+    /** The projected agents zone (spec §6.2 — `ZoneView['agents']`). */
+    view: ZoneView['agents'];
+    /** The projected iteration zone (spec §3) — the SHARED iteration info
+     * block: BOTH the tasks tab and this page render the SAME
+     * `IterationInfoSection` from the SAME `view.iteration` data. */
+    iteration: ZoneView['iteration'];
+    t: TranslateNS<'mstar-panel'>;
+}
+/**
+ * The unknown sub-bucket id : `zone: 'general'` entities render in the
+ * 「unknown / 未匹配角色」sub-bucket at the bottom of the LAST stage group,
+ * marked `data-sub-bucket="unknown"`. The constant survives the canvas
+ * deletion — it names the sub-bucket VALUE, not a column.
+ */
+export declare const UNKNOWN_COLUMN = "unknown";
+export declare function AgentListPage({ view, iteration, t }: AgentListPageProps): React.JSX.Element;

package/dist/client/panel/pages/EventLogPage.d.ts

@@ -10,10 +10,13 @@
  * keyboard-accessible, SSR-stable) whose body shows the FULL catalog fields;
  * a missing field renders「—」— never a guessed value (spec §5/§8).
  *
- * Layout (user feedback「左右
- * 排两列 + 锁定一个高内部滚动」): the two partitions render side by side in a
- * locked-height two-column grid; the page never scrolls as a whole — each
- * partition pins its title and scrolls internally (`event-log.module.css`).
+ * Layout (plan sidebar §L2.5/§L4.1): the two partitions are FLOW ROWS in
+ * the panel's single scroll body (`[data-mstar-scroll]`) — the old
+ * locked-height two-column grid and both per-partition internal scrollers
+ * are retired; rows grow the scroll body instead of owning a scrollbar.
+ * The grid rides the shell's shared `.groupGrid` class, so the ≥720px
+ * container spread is the shell's one rule. The iteration head is NOT
+ * rendered in this section.
  *
  * Dock migration decision (spec §5 — 无双份日志): the AgentEventDock is
  * REMOVED, not degraded. The dock's content (row layout + status chips)

package/dist/client/panel/pages/IterationInfoSection.d.ts

@@ -2,9 +2,10 @@
  * IterationInfoSection (spec panel-tabs §3
  * — the SHARED iteration info block): the
  * Content Head — iteration summary (the collapsible toggle row) + the 5
- * horizontal iteration steps + the branches panel — rendered by BOTH tabs
+ * iteration steps stacked VERTICALLY + the branches panel — rendered by BOTH
+ * tabs
  * from the SAME `view.iteration` data (the tasks tab inside IterationTaskPage
- * above the kanban, the agents tab inside AgentCanvasPage above the canvas).
+ * above the board, the agents tab inside AgentListPage above the list).
  * One implementation, two mounts — 任务迭代与代理执行共用同一迭代信息块.
  *
  * The component is extracted VERBATIM from the former inline head of
@@ -13,18 +14,20 @@
  * - Content Head (spec §3): the iteration info (iterationId / gate verdict /
  *   status note) rides the summary row, which IS the toggle (a native button
  *   with aria-expanded + aria-controls pointing at the body). The
- *   expanded body renders the Steps HORIZONTALLY as 5 EQUAL full-width unit
- *   blocks (badge/phase/chip
- *   centered, --mstar-space-* gap; no connector bars) with the current step
- *   highlighted on the block itself (the same honesty as the zone stepper:
- *   no "completed" checkmarks) plus the branch panel (rendered ONLY while the
- *   iteration is active, spec §3). Plan (spec panel-f4 §2.3 R8/R9): the expanded body is a LEFT-RIGHT
- *   SPLIT — branches (small half, DOM-first) + steps (large half), with the
- *   `data-iteration-head-split` container present only while branches render;
+ *   expanded body renders the Steps as a VERTICAL 5-item stacked stepper
+ *   (one row per step: badge · phase · chip · verdict seat; plan sidebar
+ *   §L4.2 — the horizontal row cannot fit the 300px column) with the current
+ *   step highlighted on the block itself (the same honesty as the zone
+ *   stepper: no "completed" checkmarks) plus the branch panel (rendered ONLY
+ *   while the iteration is active, spec §3). Plan (spec panel-f4 §2.3
+ *   R8/R9, re-shaped by plan sidebar §L4.2): the expanded body STACKS —
+ *   branches (DOM-first) above the steps; the `data-iteration-head-split`
+ *   container is present only while branches render;
  *   each step reserves the fixed-height verdict seat (`data-step-verdict-seat`)
  *   and the PASS/FAIL badge renders only for a current step with a real gate
  *   verdict (`state === 'current' && verdict !== 'unknown'` — Phase 1 renders
- *   no badge), so the centered content groups align across steps.
+ *   no badge), so every step row has the SAME children (badge/phase/chip/seat)
+ *   and the rows align across steps.
  *
  * Collapse/expand (spec §3): a local `useState` defaulted to
  * the iteration state — `active === false` → collapsed to a one-line summary
@@ -68,9 +71,9 @@ export declare function nextExpandedOnActivation(prev: boolean, prevActive: bool
  * — exported pure for the render tests, the `nextExpandedOnActivation`
  * precedent): the `data-iteration-head-split` container renders ONLY while
  * the branch panel renders (`active && branches !== null`); otherwise the
- * expanded body renders the steps row ALONE — the expanded-inactive fallback
+ * expanded body renders the steps stack ALONE — the expanded-inactive fallback
  * (a user manually expands an inactive head → the 5-step idle skeleton
- * without the split). The `active + branches null` arm is projection-
+ * without the wrapper). The `active + branches null` arm is projection-
  * unreachable (branches are always projected non-null while active), but the
  * predicate keeps the decision a single, testable source of truth.
  */

package/dist/client/panel/pages/IterationTaskPage.d.ts

@@ -1,31 +1,30 @@
 /**
  * IterationTaskPage (spec panel-tabs §3
  * — the 任务迭代 tab: the SHARED IterationInfoSection (iteration
- * summary + the 5 horizontal iteration steps + branches — the same block the
+ * summary + the vertical 5-step stepper + branches — the same block the
  * agents tab renders, user
- * 2026-08-12 feedback #4) above the full-width standard kanban. Replaces the
+ * 2026-08-12 feedback #4) above the stacked plan board. Replaces the
  * WorkflowCanvas zone dashboard on the tasks tab (WorkflowCanvas is removed
  * by the plan close; its zone-level components stay untouched here).
  *
- * The head (collapse/expand, steps row, branches, verdict seats) lives in
- * `IterationInfoSection.tsx` — extracted from this page by Task 8 so BOTH
+ * The head (collapse/expand, vertical steps, branches, verdict seats) lives
+ * in `IterationInfoSection.tsx` — extracted from this page by Task 8 so BOTH
  * tabs render the SAME iteration info block from the SAME `view.iteration`
  * data (one implementation, two mounts; the anchor family `data-iteration-*`
  * is unchanged).
  *
- * Task area (spec §3/D2): the standard 5-column kanban (Todo / InProgress /
- * InReview / Done / blocked-unknown — Blocked + unknown merged) via the
- * REUSED TaskBoard
- * (`view.tasks`) — the Done overflow stays the projection's PLAN_CAP
- * handling (TaskBoard only surfaces the `+N more` hint). The page fills the
- * content region as a flex column: the head is flex:none (fixed), the tasks
- * area (`data-mstar-tasks-scroll`) is the page's independent vertical scroll
- * body (flex:1, min-height:0, overflow-y:auto) — the kanban spreads
- * full-width and is never compressed into a small box by a canvas height.
+ * Task area (plan sidebar §L4.2): the standard 5-group board (Todo /
+ * InProgress / InReview / Done / blocked-unknown — Blocked + unknown merged)
+ * via the REUSED TaskBoard (`view.tasks`) — the Done overflow stays the
+ * projection's PLAN_CAP handling (TaskBoard only surfaces the `+N more`
+ * hint). The page is FLOW CONTENT inside the panel's single scroll body
+ * (`[data-mstar-scroll]`, plan sidebar §L2.2 — the page-owned scroll body is
+ * retired): the board stacks as five groups, then the project rollup, then
+ * the in-flow digest.
  *
  * Degradation (spec §8): the projection never throws — an inactive/missing
  * iteration renders the collapsed muted summary; state/plans missing render
- * the muted 5-column kanban skeleton (TaskBoard) — never an orange warn box.
+ * the muted 5-group kanban skeleton (TaskBoard) — never an orange warn box.
  */
 import * as React from 'react';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';

package/dist/client/panel/panel-store.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The workflow panel's entry store (plan sidebar §L2.4): the selected
+ * internal section, keyed by the sidebar tab record's id.
+ *
+ * Why a slot store and not `useState`: a docked sidebar body is UNMOUNTED
+ * whenever another tab in the pane becomes active (and the sidebar layout is
+ * memory-only), so component state would silently reset the section on every
+ * glance at the file tree. The store instance is framework-cached per
+ * (entry, session) and survives the unmount by construction; keying inside
+ * the state by `tab.id` keeps two panes showing the panel independent. The
+ * registration passes the handle as the seat's `store` option, so the body
+ * receives `useStore` + the baked `select` action through its props share.
+ */
+/** The panel's three internal sections (one sidebar tab, three sections). */
+export type PanelSection = 'tasks' | 'agents' | 'events';
+/** The entry-store state: the selected section per sidebar tab record. */
+export interface PanelStoreState {
+    byTab: Record<string, PanelSection | undefined>;
+}
+/**
+ * The panel entry store handle. `undefined` reads as the `'tasks'` default —
+ * the body applies `?? 'tasks'` at the read site, so nothing writes the
+ * default into the state.
+ */
+export declare function createPanelStore(): import("@deepseek-ai/dsh-client-store").EngineStoreHandle<PanelStoreState, {
+    select(d: PanelStoreState, tabId: string, section: PanelSection): void;
+}>;
+export type PanelStore = ReturnType<typeof createPanelStore>;