@mstar-harness/dsh 3.8.0 → 3.8.1

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

@@ -1,345 +0,0 @@
-/**
- * AgentCanvasPage (spec panel-tabs §4/§6.2
- * — the 代理执行 tab: a DRAGGABLE agent canvas. Replaces the muted
- * placeholder page  and the stage-column AgentFlowZone
- * (deleted by this plan — the free canvas supersedes it).
- *
- * Canvas contract (spec §6.2 — zero third-party deps):
- * - pan ONLY (translate, no zoom / pinch / rotate) via native pointer events
- *   (pointerdown / pointermove / pointerup + setPointerCapture) on the
- *   viewport; `touch-action: none` + `preventDefault` on pointerdown stop
- *   native scroll / text selection; during capture the entity cards never
- *   receive the pointer (no click-through); no pan bounds (free pan).
- * - forced capture loss (window blur / alt-tab / element removal mid-gesture)
- *   fires `lostpointercapture` without pointerup — it binds the same end
- *   handler so `dragRef` never goes stale (review S-002).
- * - the content layer carries `data-canvas-pan` and exposes the pan state as
- *   `transform: translate(xpx, ypx)`; the grid background moves WITH the
- *   content. Pan is instant (no animation), so `prefers-reduced-motion`
- *   needs no pan-specific handling; the next-edge dash flow and the running
- *   card pulse are CSS animations killed by the panel root's reduced-motion
- *   rule (`* { animation: none !important }`).
- * - pan state `{ x, y }` is LOCAL useState; the drag math is extracted into
- *   the exported pure helpers (`panDragStart` / `panDragMove` / `panTransform`)
- *   so the pointer-event sequence is unit-testable without a DOM.
- *
- * Entities (spec §4/§6.2): every KNOWN_AGENTS roster member renders a card —
- * title = the AGENT NAME (role id, or displayName for idle cards via
- * `entity.name`); the session id / task tag are AUXILIARY record fields on
- * `data-agent-record` (never the title). Idle (no dispatch evidence) cards
- * are muted (`data-agent-idle`); lit cards follow the projection's status
- * priority (running/settled/error/denied/advisory). Settled cards get a
- * standalone GREEN DONE FRAME + green ✓ (
- * `data-agent-done="true"`, the frame is a full-strength success ring on the
- * rounded card body) ONLY when `emphasis !== 'off'` — an off-tier role
- * (already-passed / stage-less on-demand + general) never shows the
- * completion marker (the v3 leak: the ✓ survived the off-tier low
- * transparency).
- *
- * Shared iteration section : the page renders the
- * SAME `IterationInfoSection` the tasks tab uses, from the SAME
- * `view.iteration` data — 两个 tab 显示同一迭代信息块.
- *
- * Edges (spec §4 — the
- * finalized 2026-08-12 line semantics, design doc §2): ONLY the actual
- * handoffs (business entity→entity — role-keyed, general endpoints
- * filtered, one edge per pair) and the supervise line (plan
- *  Task 2 — the static bidirectional
- * implementor ↔ sdd-reviewer sub-bucket line inside the `sdd-implement`
- * column, dim dashed by default, lit business when the projected
- * `evidenced` flag is true — never a fabricated activation) — all drawn as
- * SVG bezier `C` paths (design doc §2.6) over the layout computed by the
- * exported pure `layoutAgents`. The `expected` stage skeleton and the
- * animated `next` edge are REMOVED ( — the column order
- * implies the flow, the running card glow + status point carry the
- * position). Every line anchors to a CARD PORT (4 fixed edge-midpoint
- * ports, design doc §2.5 — hover-visible dots, static-invisible) or the
- * supervise side-gap anchors (card right edge + 18px); the arrow tip sits
- * at the STANDOFF point 10px off the target port (arrow along the endpoint
- * tangent — H1) and no line crosses text (H2: standoff + side-gap routing
- * for caption-crossing same-column flows + column-gap crossings). Col-skip
- * cross-column edges  reroute via a multi-`L` side-gap DETOUR below the
- * intermediate card band instead of a direct bezier through the card bodies
- * (H1).
- *
- * Layout : deterministic columns per EXPECTED_ROLE_FLOW stage
- * (review-edit-chain → sdd-implement → qc-tri → qa-gate) — FOUR columns
- * total (: the standalone rightmost UNKNOWN
- * column is REMOVED; `zone: 'general'` entities render in an "unknown /
- * 未匹配角色" SUB-PARTITION at the bottom of the LAST column,
- * `data-sub-bucket="unknown"`), laid out in TWO SIDE-BY-SIDE PHASE GROUPS
- * — the
- * Phase 1 group LEFTMOST (review-edit-chain — the sequential Review & Edit
- * chain: product-manager → architect → writing-specialist) and the Phase 2
- * group to its RIGHT (sdd-implement → qc-tri → qa-gate — the iterative plan
- * loop, annotated with the current `activePlanId` from the projected
- * `state.plans[]` InProgress rows), top-aligned on ONE label row, each with
- * its group label (`data-canvas-group`). The
- * `sdd-implement` column is split into sub-buckets by the PROJECTED
- * `entity.bucket` (never a render guess): the implementor partition above —
- * flow roles in the stage's original order, then the on-demand roles
- * (ops-engineer / prompt-engineer, carrying the on-demand badge) — and the
- * reviewer partition (code-reviewer, idle included) below, with the
- * implementor / sdd-reviewer caption labels. `zone: 'on-demand'` entities
- * have NO standalone column anymore — they live in the implementor
- * partition. The former "general sinks to the bottom of
- * the sdd-implement column" placement is superseded, as is the
- * rightmost unknown column; the former
- * sdd-implement → general SDD loop back-edge stays REMOVED (the render
- * draws no loop branch).
- *
- * Degradation (spec §8 — never throws / never orange): the projection always
- * yields the full idle roster, so the canvas renders it with the muted
- * `data-canvas-note` (degraded = ledger missing; empty = no events;
- * settle-only = events but no dispatch rows — review T2-Imp-2 restored the
- * old zone's distinct settle-only anchor; the empty/settle-only note
- * is PROJECTED metadata, never inferred from the entity list). The Legend
- * (idle / collaboration swatches) sits BELOW the viewport.
- * `initialPan` is a deterministic SSR/test seed — the live page starts at the
- * origin.
- */
-import * as React from 'react';
-import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
-import type { AgentEdge, ZoneView } from '../graph/project-graph.ts';
-import { type PhaseId } from '../graph/schema.ts';
-export interface AgentCanvasPageProps {
-    /** 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'>;
-    /** Deterministic initial pan seed (SSR/tests); the live page starts at the origin. */
-    initialPan?: PanState;
-}
-/** Pan state: the content-layer translate (spec §6.2 — free pan, no bounds). */
-export interface PanState {
-    x: number;
-    y: number;
-}
-/** A live drag gesture: the pan at pointerdown + the pointer start position. */
-export interface PanDrag {
-    originX: number;
-    originY: number;
-    startX: number;
-    startY: number;
-}
-export declare const PAN_ORIGIN: PanState;
-/** Open a drag gesture: remember the pan at pointerdown and the pointer seat. */
-export declare function panDragStart(pan: PanState, x: number, y: number): PanDrag;
-/** Follow the pointer: pan = origin + (current − start) — free pan (spec §6.2). */
-export declare function panDragMove(drag: PanDrag, x: number, y: number): PanState;
-/** The `data-canvas-pan` transform string (spec §6.2 — translate only). */
-export declare function panTransform(pan: PanState): string;
-/** One positioned box in the canvas coordinate space. */
-export interface CanvasBox {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
-/** One stage column track (expected/next edge anchors + the column label). */
-export interface CanvasColumn extends CanvasBox {
-    id: string;
-}
-/**
- * One PHASE group of the canvas : the stage columns split into two SIDE-BY-SIDE groups by iteration
- * phase — **Phase 1** (review-edit-chain, the sequential Review & Edit
- * chain: product-manager → architect → writing-specialist) LEFTMOST,
- * **Phase 2** (sdd-implement → qc-tri → qa-gate, the iterative plan loop) to
- * its RIGHT — every group label row TOP-ALIGNED at PAD_Y; the Phase-2 row
- * additionally annotates the CURRENT PLAN (the projected `activePlanId` —
- * the first InProgress `state.plans[]` row, design doc §1.2). Group order =
- * first occurrence in the projected stage order (PHASE_IDS-aligned) —
- * derived, never literal, so a phase/stage rename can never orphan the
- * groups.
- */
-export interface CanvasGroup {
-    /** The group's iteration phase id. */
-    phase: PhaseId;
-    /** 1-based group ordinal in stage order (Phase 1 = 1, Phase 2 = 2). */
-    index: number;
-    /** The group label row seat (canvas coordinates; width = the group's
-     * content width — the Phase-2 current-plan chip rides the same row). */
-    label: {
-        x: number;
-        y: number;
-        w: number;
-        h: number;
-    };
-    /** The stage column ids of this group, stage order. */
-    columnIds: readonly string[];
-    /** Current-plan annotation host (design doc §1.2 —):
-     * true for the `autonomous-execute` phase group (the iterative plan loop)
-     * only. */
-    planNote: boolean;
-}
-/** The deterministic canvas geometry: stage columns + per-entity card boxes. */
-export interface CanvasLayout {
-    width: number;
-    height: number;
-    columns: readonly CanvasColumn[];
-    cards: ReadonlyMap<string, CanvasBox>;
-    /** Sub-bucket geometry per column id (the supervise line anchors to the band edges (the
-     * inter-partition gap; QC W-001).
-     * Columns without sub-buckets are absent from the map. */
-    subBuckets: ReadonlyMap<string, SubBucketGeometry>;
-    /** The unknown sub-partition at the bottom of the LAST column (plan
-     *  Task 5 —:
-     * `zone: 'general'` entities sink into a qa-gate-column-bottom sub-partition
-     * instead of a standalone fifth column). The caption seat + card band;
-     * null when the layout has no columns (total function — never a throw). */
-    unknown: UnknownSubPartition | null;
-    /** The Phase groups (user
-     * 2026-08-12 feedback #2; plan
-     * Phase 1 leftmost /
-     * Phase 2 right, top-aligned, each with its label seat; empty when the
-     * layout has no columns. */
-    groups: readonly CanvasGroup[];
-}
-/** The unknown sub-partition id : `zone: 'general'` entities render in a bottom
- * sub-partition of the LAST column titled「unknown / 未匹配角色」and marked
- * `data-sub-bucket="unknown"`. The former standalone rightmost UNKNOWN column
- *  is REMOVED — the constant
- * value survives as the sub-partition bucket id. */
-export declare const UNKNOWN_COLUMN = "unknown";
-/** One sub-bucket partition inside the `sdd-implement` column (plan
- * the caption seat + the cards'
- * band — the supervise line anchors to the band's edge (implementor:
- * bottom edge; reviewer: top edge — the inter-partition gap; QC W-001). */
-export interface SubBucketPartition {
-    /** The caption row's top-left seat (canvas coordinates; width = the card
-     * row width so the dashed rule fills the row). */
-    label: {
-        x: number;
-        y: number;
-        w: number;
-    };
-    /** The bucket's card bounding band (canvas coordinates); null when the
-     * partition has no cards (total function — the caption and the supervise
-     * line skip). */
-    band: CanvasBox | null;
-}
-/** The sub-bucket geometry of one column : implementor +
- * reviewer partitions. Present ONLY for the `sdd-implement` column — the
- * supervise anchors read the bands. */
-export interface SubBucketGeometry {
-    implementor: SubBucketPartition;
-    reviewer: SubBucketPartition;
-}
-/** The unknown sub-partition of the LAST column : the caption seat + the general cards' band. The
- * caption row (SUB_LABEL_H) sits ROW_GAP below the last flow card; the
- * general cards follow SUB_GAP below it. */
-export interface UnknownSubPartition {
-    /** The caption row's top-left seat (canvas coordinates; width = the card
-     * row width so the dashed rule fills the row). */
-    label: {
-        x: number;
-        y: number;
-        w: number;
-    };
-    /** The unknown partition's card bounding band; null when the partition has
-     * no general card (total function — the caption renders only with cards). */
-    band: CanvasBox | null;
-}
-/**
- * Deterministic canvas layout (spec §4
- * + Task 8 + plan
- *  Task 2 — the F5 rework + the
- * left-right rework): one column per EXPECTED_ROLE_FLOW stage (view order:
- * review-edit-chain → sdd-implement → qc-tri → qa-gate) — FOUR columns
- * total, laid out in TWO SIDE-BY-SIDE PHASE GROUPS (the **Phase 1 group
- * LEFTMOST** (review-edit-chain — the sequential Review & Edit chain:
- * product-manager → architect → writing-specialist) and the **Phase 2 group
- * to its RIGHT** (sdd-implement → qc-tri → qa-gate — the iterative plan
- * loop, annotated with the current `activePlanId`), every group label row
- * TOP-ALIGNED at PAD_Y (design doc §1.2; the standalone rightmost unknown
- * column is REMOVED ). The `sdd-implement` column
- * is split into sub-buckets by the
- * PROJECTED `entity.bucket` (never a render-side guess): the implementor
- * partition above — flow roles in the stage's original EXPECTED_ROLE_FLOW
- * order, then the on-demand roles (ops-engineer / prompt-engineer — the
- * standalone on-demand column is REMOVED) — and the reviewer partition
- * (code-reviewer) below, with the implementor / sdd-reviewer caption seats +
- * card bands recorded in `subBuckets` (the supervise-line anchors).
- * `zone: 'general'` entities (the general bucket — unmatched / anonymous
- * dispatches) render in the "unknown / 未匹配角色" SUB-PARTITION at the
- * bottom of the LAST column (`layout.unknown` — design doc §1.2: caption row
- * ROW_GAP below the last flow card, general cards SUB_GAP below it). The
- * column bucket comes from the PROJECTED `entity.zone`: 'flow' → the
- * entity's stage column, 'on-demand' → the sdd-implement column's implementor
- * partition, 'general' → the last column's unknown partition. Total function —
- * every entity gets a box; absent sdd-implement stage → on-demand falls back
- * to the LAST column; unknown column ids fall back to the same sink; no
- * stages → empty groups/columns; never a throw.
- */
-export declare function layoutAgents(view: ZoneView['agents']): CanvasLayout;
-/** The fixed port points of a card box (design doc §2.5 — 4 edge-midpoint
- * ports, no new tokens). */
-export type PortId = 'north' | 'south' | 'west' | 'east';
-/** One edge's bezier geometry (design doc §2.6): the `d` path + the
- * endpoint coordinates (start = the source port, end = the target STANDOFF
- * point — the arrow tip lands there, 10px off the card border H1). Null
- * when an anchor is missing (total function). */
-export interface EdgeGeometry {
-    /** The SVG path `d` — a single `C` cubic-bezier command for the standard
-     * curves, or the multi-command `M … L … L … L … L … L …` side-gap detour
-     * polyline for col-skip cross-column edges . The render
-     * passes `d` through verbatim; `marker-end orient="auto"` follows the
-     * FINAL segment, so the arrow always rides the endpoint tangent (H1). */
-    d: string;
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-}
-/**
- * One edge's SVG bezier geometry ; null when an anchor is missing (total
- * function).
- *
- * Port selection (design doc §2.5 — lines connect ports only, never through
- * a card): forward (source column < target column) → source EAST → target
- * WEST; reverse (source column > target column) → source WEST → target
- * EAST; same column → the vertical flow (direction-aware. The
- * path END stands off STANDOFF px from the target port along the endpoint
- * tangent (arrow tip off the card, H1); the source starts AT its port (no
- * arrow there).
- *
- * Direction-aware vertical endpoints : a same-column
- * (or side-gap) flow whose SOURCE sits BELOW the target — the implement →
- * review → rework cycle collapses to `code-reviewer → fullstack-dev` (the
- * projection pair-dedupe keeps the LATEST direction) — must approach the
- * target's SOUTH port, not its north: the arrow tip lands `standoff` below
- * the target's bottom edge pointing UP into it. The old code put the tip
- * above the target (pointing AWAY) and the center-x line ran through both
- * card bodies (H1/H2 violations). Forward (source above) keeps source SOUTH
- * → target NORTH. The reverse side-gap detour below is direction-aware by
- * construction (it enters the target from its RIGHT side gap and lands 10px
- * off the EAST edge, tip pointing LEFT into the card).
- *
- * Same-column flows whose center-x vertical line would cross a sub-bucket
- * CAPTION row (the implementor↔reviewer flow crosses the "sdd-reviewer"
- * caption, the qa-gate↔unknown flow crosses the「unknown / 未匹配角色」
- * caption) OR another CARD body (a handoff between non-adjacent cards, e.g.
- * fullstack-dev → frontend-dev skips the idle fullstack-dev-2 — the
- * 2026-08-13 "线穿过卡片" report) route in the column's LEFT side gap instead
- * (design doc §2.0 绕行策略 ② — 同列关系线移到卡片列外侧的间隙带): the vertical
- * bezier hangs at `card left edge − SIDE_GAP`, clear of every text (H2) and
- * every card body (H1).
- *
- * Inter-phase flows : a Phase 1 → Phase 2 handoff (e.g. writing-specialist →
- * fullstack-dev — a real same-plan Review&Edit→implement transfer) is a
- * normal FORWARD horizontal bezier (source east → target west) — the groups
- * sit side-by-side at one top-aligned y band, so no label row lies between
- * the cards. The CARD-AWARE guard : a
- * cross-column edge whose columns SKIP an intermediate column (e.g.
- * writing-specialist → qc-specialist — a real docs-only / inline / QA-gate
- * ledger chain) would run its direct horizontal bezier THROUGH the
- * intermediate column's card bodies; when the direct bbox intersects ANY
- * card box other than the source/target cards, the edge reroutes via the
- * side-gap DETOUR (see `sideGapDetour`) — a polyline below the intermediate
- * band, clear of every card (H1) and text seat (H2).
- */
-export declare function edgePath(edge: AgentEdge, layout: CanvasLayout): EdgeGeometry | null;
-export declare function AgentCanvasPage({ view, iteration, t, initialPan }: AgentCanvasPageProps): React.JSX.Element;