@mstar-harness/dsh 2.1.1

package/dist/client/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Morning Star workflow panel — dsh client plugin entry (spec §4.1):
+ * `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.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+/** Cordis service faces the plugin waits for (spec §4.4: slots + sessions + locale). */
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): void;

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

@@ -0,0 +1,67 @@
+/**
+ * Morning Star workflow panel page — the `conversation.view` tab component
+ * (spec §4.2): pure render of the latest `mstar-engine-status` catalog row.
+ *
+ * Inputs: the session standard kit (`ConvViewProps`) and the typed `t` seat
+ * (`locale: 'mstar-panel'`). The catalog row + message time come from the
+ * `useMstarEngineStatus()` hook riding the kit's `useSession` selector (spec
+ * §5) — the render body is a pure function of (source, lastUpdated, t).
+ *
+ * Layout (spec panel-tabs §2, plan 20260811-panel-tabs-shell): 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.
+ *
+ * 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 — landed with Task 2,
+ * replacing the WorkflowCanvas zone dashboard); the agents tab renders the
+ * draggable AgentCanvasPage (spec §4 — landed with the agent-canvas plan,
+ * replacing the muted placeholder + the AgentFlowZone); the events tab
+ * renders the EventLogPage (spec §5 — the non-canvas log page with per-row
+ * `<details>` expansion, landed with the event-log plan Task 2, replacing
+ * the muted placeholder AND the AgentEventDock — 无双份日志).
+ *
+ * Empty branches (spec §2): waiting / no-harness render no tabs / no
+ * sidebar. Waiting keeps the muted hint; the no-harness branch renders a
+ * CENTERED inactive-state card (icon + title + hint, plan
+ * 20260812-panel-f5-agent-layout T3 — replaces the left-aligned hint) with
+ * the freshness footer; the no-harness main keeps `data-mstar-graph` on its
+ * 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.
+ */
+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 { MstarEngineStatusSource } from '../../types.ts';
+import { type PanelTab } from './TabNav.tsx';
+export interface MstarPanelViewProps extends ConvViewProps {
+    /** Namespace-bound translate seat (`locale: 'mstar-panel'`). */
+    t: TranslateNS<'mstar-panel'>;
+}
+export interface PanelContentProps {
+    tab: PanelTab;
+    source: MstarEngineStatusSource;
+    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, landed with Task 2; 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, landed with the agent-canvas
+ * plan; 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, landed with the
+ * event-log plan Task 2; it replaced the muted placeholder AND the
+ * AgentEventDock — 无双份日志, the dock is removed with this plan).
+ */
+export declare function PanelContent({ tab, source, t }: PanelContentProps): React.JSX.Element;
+export declare function PanelView({ t, useSession }: MstarPanelViewProps): React.JSX.Element;

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

@@ -0,0 +1,28 @@
+/**
+ * TabNav (spec panel-tabs §2/§6.1, plan 20260811-panel-tabs-shell Task 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).
+ *
+ * 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.
+ *
+ * A11y (QC wave): 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).
+ */
+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';
+export interface TabNavProps {
+    active: PanelTab;
+    onChange: (tab: PanelTab) => void;
+    t: TranslateNS<'mstar-panel'>;
+}
+export declare function TabNav({ active, onChange, t }: TabNavProps): React.JSX.Element;

package/dist/client/panel/graph/event-log.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Event-log entry assembly (spec panel-tabs §5 — plan 20260811-panel-event-log
+ * Task 1): `eventLogEntries(view)` turns the projected `ZoneView` slices
+ * (`events` / `violations`) into display-ready log entries for the 事件记录
+ * tab (`EventLogPage`, Task 2). A pure function over the projection output —
+ * the projection interfaces (`ZoneView` / `FlowEventView` / `GraphViolation`)
+ * are consumed unchanged, ZERO projection changes.
+ *
+ * Total function (spec §8 discipline): NEVER throws, NEVER fabricates. Every
+ * field degrades individually — a missing value becomes '' (string fields),
+ * `0` (`ts`) or `null` (`durationMs`), mirroring the `guards.ts` contract;
+ * the render side shows「—」for those (spec §5 — never a guessed value).
+ *
+ * Shape: one array, two entry kinds (spec §5 partitions):
+ * - `event` rows — `view.events` in projection order (latest-first; the ≤50
+ *   window is `classifyFlowRows`' FLOW_EVENT_WINDOW, consumed NOT
+ *   re-implemented). Off-pipeline (unexpected) DISPATCHES fold in via
+ *   `expected: false`: `view.unexpected` is a RE-LIST of rows already inside
+ *   `view.events`, so reading it here would double-append — the page decides
+ *   how to section/badge them.
+ * - `violation` rows — `view.violations` (gate violations, str()-guarded)
+ *   after the event rows; the page renders them in their own 违规记录
+ *   partition.
+ */
+import type { FlowEventStatus, FlowEventView, ZoneView } from './project-graph.ts';
+/** One agent-flow event row: the log's 流转事件 partition (spec §5). */
+export interface EventLogEventEntry {
+    /** Entry discriminator — this row is an agent-flow event. */
+    kind: 'event';
+    /** Stable per-projection id (reuses the projected event's window id — React key). */
+    id: string;
+    /** 'dispatch' | 'settle' — the page distinguishes settle rows (✓ glyph, no role). */
+    eventKind: FlowEventView['kind'];
+    /** `Execute as`; '' for settle rows and missing roles (never fabricated). */
+    role: string;
+    /** Session id; '' when missing (render shows「—」). */
+    agent: string;
+    /** `${phase}:${stage}` when the role matched an expected stage; '' otherwise. */
+    stage: string;
+    /** planId#taskId tag (deterministic planId / #taskId fallbacks); '' when neither present. */
+    task: string;
+    /** Event timestamp; 0 when missing (the render shows「—」— never a guessed time). */
+    ts: number;
+    /** Dispatch → dispatched|advisory|denied; settle → ok|error|denied (token-colored). */
+    status: FlowEventStatus;
+    /** Dispatch with an exact-identity-paired settle (an unpaired settle stays unpaired — honest); settle rows are never "settled". */
+    settled: boolean;
+    /** Settle duration in ms; null when missing/illegal (render shows「—」). */
+    durationMs: number | null;
+    /** role ∈ EXPECTED_ROLE_FLOW union — false = off-pipeline (unexpected) dispatch. */
+    expected: boolean;
+}
+/** One gate violation row: the log's 违规记录 partition (spec §5). */
+export interface EventLogViolationEntry {
+    /** Entry discriminator — this row is a gate violation. */
+    kind: 'violation';
+    /** Stable per-projection id (`violation-${index}` — React key). */
+    id: string;
+    /** str()-guarded severity; '' when missing. */
+    severity: string;
+    /** str()-guarded code; '' when missing. */
+    code: string;
+    /** str()-guarded message; '' when missing. */
+    message: string;
+}
+/** One display-ready event-log row: an agent-flow event or a gate violation. */
+export type EventLogEntry = EventLogEventEntry | EventLogViolationEntry;
+/**
+ * Assemble the event-log rows (spec §5): `view.events` (latest-first, ≤50 —
+ * the projection's window, NOT re-windowed here) mapped to `event` entries,
+ * then `view.violations` mapped to `violation` entries. Empty slices produce
+ * no rows — the mixed empty states (0 events + violations, events + 0
+ * violations) fall out naturally; the page renders the muted「暂无记录」empty
+ * state when the whole array is empty (spec §8).
+ */
+export declare function eventLogEntries(view: ZoneView): EventLogEntry[];