@mstar-harness/dsh 3.8.0 → 3.8.1

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

@@ -1,10 +1,15 @@
 /**
- * Panel right sidebar (spec panel-zones §5): fixed 300px column, full height,
- * flex column — the workspace-state digest scrolls in its own region
- * (`flex: 1; min-height: 0; overflow-y: auto`), while the bottom meta dock
- * (version + harness dir) stays pinned and does NOT scroll with the digest.
+ * Workspace-state digest (plan sidebar §L2.1): the former 300px sidebar
+ * column, now IN FLOW at the end of the panel's scroll body — the digest is
+ * not a column any more, and its own nested scroller
+ * (`data-mstar-sidebar-scroll`) is retired: `[data-mstar-scroll]` is the
+ * panel's single scroller and this block is flow content inside it. The
+ * bottom meta dock moved to the shell's third zone (PanelView renders it
+ * directly), so this component renders ONLY the digest.
+ *
+ * `data-mstar-sidebar` stays on the digest block (anchor lineage).
  * Degradation: `state === null` renders the no-state note instead of the
- * digest (never a crash); the meta dock still renders from the source.
+ * digest (never a crash).
  */
 import * as React from 'react';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';

package/dist/client/panel/use-mstar-engine-status.d.ts

@@ -1,16 +1,17 @@
 /**
  * Data hook for the workflow panel (spec §5): the panel's ONE data path.
  *
- * The persisted catalog row is an ANCHOR, not a data source: since the source
- * reduction the row carries exactly `{ kind: 'plugin', plugin:
- * 'mstar-engine-status', form: 'catalog' }`, and the structured payload lives
- * in the host's per-session snapshot store. So the hook
+ * The persisted catalog row is an ANCHOR, not a data source: rows are emitted
+ * as `{ kind: 'plugin', plugin: 'mstar-engine', form: 'catalog' }`, and the
+ * structured payload lives in the host's per-session snapshot store. So the
+ * hook
  *
  * 1. finds the LATEST anchor row in the active session's conversation log
  *    (`kind === 'context'` + `form === 'catalog'` + the first-party `plugin`
- *    arm with this plugin's identity) and takes its message time as the
- *    refresh key — a re-emission appends a new row, the snapshot bump re-runs
- *    this selection, and the newest anchor asks for the newest snapshot;
+ *    arm with one of this plugin's anchor identities) and takes its message
+ *    time as the refresh key — a re-emission appends a new row, the snapshot
+ *    bump re-runs this selection, and the newest anchor asks for the newest
+ *    snapshot;
  * 2. reads the session's workspace directory from the session standard kit's
  *    session feed (the host cross-checks the asserted `cwd` against the
  *    session AND the stored snapshot, so it must be the real one);
@@ -85,11 +86,11 @@ export type MstarEngineStatusView =
 };
 /** The seats the hook needs: the session standard kit + the plugin's client. */
 export interface MstarEngineStatusSeats {
-    /** Selector hook over the chat target snapshot (the `conversation.view` kit). */
+    /** Selector hook over the chat target snapshot (the session standard kit's chat face). */
     useChat: SnapshotSelectorHook<ChatSnapshot>;
     /**
      * Selector hook over the Host session list (the global standard seat). The
-     * view ring always hands it to a `conversation.view` entry; it stays
+     * session-scope slot dispatch always hands it to the panel; it stays
      * optional here because a program without the ui-session adapter does not
      * see the declaration merge (the panel then reports `session-cwd-unknown`).
      */
@@ -99,7 +100,7 @@ export interface MstarEngineStatusSeats {
     /** The plugin's engine-status client (absent in a composition without one). */
     engineStatus: MstarEngineStatusClient | undefined;
 }
-/** Latest `mstar-engine-status` anchor row in snapshot order, or null. */
+/** Latest engine-status anchor row (either accepted identity) in snapshot order, or null. */
 export declare function latestEngineStatusRow(nodes: readonly ConversationNode[]): ContextMessageNode | null;
 /** Anchor row message time, or null when the log carries no anchor row. */
 export declare function selectAnchorTime(snapshot: ChatSnapshot): number | null;

package/dist/client/panel/zones/Legend.d.ts

@@ -1,8 +1,10 @@
 /**
  * Legend (spec panel-tabs §4/§6.2):
- * mounted on the AgentCanvasPage (the zone-dashboard footer legend is gone
- * with the WorkflowCanvas — spec §6.1). Describes ONLY the role-card status
- * treatments of the agent canvas — plan
+ * mounted on the AgentListPage, IN FLOW below the grouped list (the
+ * zone-dashboard footer legend is gone with the WorkflowCanvas — spec §6.1;
+ * the list page keeps the legend placement the canvas page established,
+ * after the content). Describes ONLY the role-card status
+ * treatments of the agent rows — plan
  *  Task 1 (图例精简): the 7
  * collaboration-edge / layout entries (flow-actual / port / group /
  * sub-bucket / supervise / on-demand / unknown) are REMOVED — the legend is

package/dist/client/panel/zones/TaskBoard.d.ts

@@ -1,13 +1,17 @@
 /**
  * TaskBoard  — the tasks-zone kanban: the 5
- * PLAN_STATE_IDS columns (Todo / InProgress / InReview / Done /
- * blocked-unknown, in the projection's constant order), each with a localized
- * state-name header + count badge, plan cards (mono ellipsized id + status
- * chip — the `data-plan-id` / `data-plan-status` anchors shared with the
- * sidebar plan board), the dim inter-column flow arrows (spec §2.4:
- * Todo→InProgress→InReview→Done plus the InProgress↔Blocked back-edge, now
- * docking at the merged blocked-unknown column), the per-column 「更多」
- * expand affordance, and the muted "no plans" empty state.
+ * PLAN_STATE_IDS groups (Todo / InProgress / InReview / Done /
+ * blocked-unknown, in the projection's constant order) STACKED in flow (plan
+ * sidebar §L4.2 — the horizontal 5-column row cannot fit the 300px column),
+ * each with a header row carrying the flow glyph (the
+ * `data-kanban-arrow` labels + the `⇄` back-edge glyph: Todo→InProgress→
+ * InReview→Done plus the InProgress↔Blocked back-edge, docking at the merged
+ * blocked-unknown group), the localized state-name + count badge, plan cards
+ * (mono ellipsized id + status chip — the `data-plan-id` /
+ * `data-plan-status` anchors shared with the sidebar plan board), and the
+ * per-group 「更多」 expand affordance. The board rides the shell's shared
+ * `.groupGrid` class, so the ≥720px container spread reaches the groups
+ * (plan sidebar §L4.3 — one wide rule, not a second layout).
  *
  * The projection KEEPS every row (`column.plans` = the full column) and
  * reports `column.capped` (PLAN_CAP) when a column overflows. This render
@@ -19,7 +23,7 @@
  * keeps input order.
  *
  * Degradation (spec §8): state null / plans missing project to the same
- * 5-column skeleton with count 0 — the board renders it with a muted
+ * 5-group skeleton with count 0 — the board renders it with a muted
  * "no plans" note (`data-zone-empty="no-plans"`), NEVER an orange warn box.
  */
 import * as React from 'react';