@ai-setting/roy-plugin-task-show 0.6.11 → 0.8.4

package/dist/task-detail-mermaid.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @fileoverview Mermaid "task lifecycle + tool calls" diagram generator.
+ *
+ * v0.8.0: replaces the per-task page's old "Execution flow (Mermaid)"
+ * section (which only listed tool calls in a flat sequence) with a
+ * two-level view that nests each tool call under the operation record
+ * that produced it. The structure is:
+ *
+ *   Start([Task #X start]) --> opN subgraph  --> End([Task #X end])
+ *                                │
+ *                                ├── tool_1["🔧 edit_file / adapter.ts"]
+ *                                └── tool_2["🔧 bash / ls -la"]
+ *
+ * Each tool node has a `click tool_1 callback` directive so the browser
+ * navigates to the tool table row when the user clicks the node. The
+ * callback is `window.__toolClick(toolId)` — see `public/app.js` and
+ * `public/mermaid-renderer.js` for the implementation.
+ *
+ * v0.8.2 (fix/mermaid-readable-labels): replaces the raw
+ * `<seq>. <title>` operation-subgraph labels (which leaked technical
+ * details such as `plan_doc: docs/.../plan.md - 485 - worktree: HEAD
+ * a487b25f from main`) with a concise, human-readable label derived
+ * from a `PHASE_LABELS` metadata map. The map is keyed by a canonical
+ * phase id (`init-task`, `setup-worktree`, `plan`, `tdd-implement`,
+ * `code-review`, `cli-e2e-test`, `final-verify`, `merge-to-main`,
+ * `summary-report`, `task-complete`) and each entry has an emoji, a
+ * friendly name, and a short description. `getPhaseLabel(op)` parses
+ * the operation title for a `Phase N: <name>` pattern, looks up the
+ * matching phaseId via `PHASE_ALIASES`, and returns
+ * `<emoji> Phase N: <friendly-name><br/><description>`. Unknown
+ * titles fall back to a sanitized version (technical fields stripped
+ * at the first ` - <field>:` marker). The same logic is mirrored in
+ * `public/app.js` so the client-side re-render stays in sync.
+ *
+ * This module is a pure function. No DOM access. No I/O. Easy to unit
+ * test and to compose with other renderers.
+ */
+import type { OperationRecord } from "./cli-tasks-adapter.js";
+import type { ToolCallRecord } from "./types.js";
+/**
+ * Canonical phase metadata. Each phase is a node in the workflow
+ * (tongagent-rd-pipeline in our reference deployment). The `name`
+ * field is what the user sees in the Mermaid label; the `description`
+ * is a one-line tooltip-like context. We keep this list small and
+ * frozen — adding a phase means a deliberate change to the workflow.
+ */
+export interface PhaseMeta {
+    emoji: string;
+    name: string;
+    description: string;
+}
+export declare const PHASE_LABELS: Record<string, PhaseMeta>;
+/**
+ * Aliases that map the various spellings the workflow uses in
+ * `milestoneTitle` to a canonical phaseId. The lookup is performed
+ * case-insensitively, with whitespace + punctuation normalised, so
+ * "Plan" / "plan" / "(Plan)" / "Plan — ..." all resolve the same way.
+ * Extend this map (rather than special-casing in `getPhaseLabel`) when
+ * the workflow grows new phase aliases.
+ */
+export declare const PHASE_ALIASES: Record<string, string>;
+/**
+ * Try to extract "Phase N" + name from an operation title. Returns
+ * `null` if no `Phase N` token is present. Exported for tests so the
+ * parser is independently testable.
+ *
+ * Recognised shapes:
+ *   "Phase 3: Plan - plan_doc: ..."
+ *   "Phase 3 (Plan) 完成 — ..."
+ *   "Phase 3 Plan 完整循环 ..."
+ *   "Phase 3. Plan: ..."
+ *   "phase 5 code-review: PASS"          (lowercase ok)
+ *   "Task #X 创建成功（Phase 1 任务管理完成）"  (Phase N anywhere in the title)
+ *
+ * The name is captured up to the first stop-token (`-`, `—`, `:`,
+ * `,`, `。`, `完成`, `pass`, newline), so trailing technical details
+ * like `plan_doc:` or `worktree: HEAD ...` don't leak in. Hyphens
+ * inside the name (e.g. `setup-worktree`, `code-review`) are
+ * preserved.
+ */
+export declare function extractPhaseInfo(title: string): {
+    num: string;
+    name: string;
+} | null;
+/**
+ * Map a raw phase name to a canonical phaseId via `PHASE_ALIASES`.
+ * Returns `null` if no alias matches.
+ */
+export declare function resolvePhaseId(phaseName: string): string | null;
+export declare function sanitiseTitleForLabel(title: string): string;
+/**
+ * Build a human-readable Mermaid label for a single operation
+ * record. The output is a single line (with `<br/>` for visual
+ * line-break in the Mermaid render) and contains no Mermaid-hostile
+ * characters. Examples:
+ *
+ *   getPhaseLabel({ title: "Phase 3: Plan - plan_doc: ... - worktree: HEAD ..." })
+ *     -> "📝 Phase 3: Plan<br/>brainstorming + writing-plans"
+ *
+ *   getPhaseLabel({ title: "Phase 5 code-review: PASS" })
+ *     -> "🔍 Phase 5: Code Review<br/>BLOCKING/IMPORTANT/MINOR/NIT"
+ *
+ *   getPhaseLabel({ title: "TDD 完整循环结束" })
+ *     -> "🧪 TDD 循环<br/>RED → GREEN → REFACTOR"
+ *
+ *   getPhaseLabel({ title: "RED: 3 failing tests added" })
+ *     -> "⚙️ RED: 3 failing tests added"   (fallback, no Phase prefix)
+ *
+ *   getPhaseLabel({ title: "" })
+ *     -> "⚙️ op"                          (milestoneType fallback)
+ */
+export declare function getPhaseLabel(op: Pick<OperationRecord, "title" | "milestoneType">): string;
+/** Minimal shape we need from a tool call. Re-export for convenience. */
+export type { ToolCallRecord };
+/** What the Mermaid node identifier looks like for a given tool call. */
+export declare function toolNodeId(sequence: number): string;
+/** Mermaid node identifier for an operation record (by sequence). */
+export declare function opNodeId(sequence: number): string;
+/** Mermaid node identifier for the "pre-task" / "post-task" bookends. */
+export declare const PRE_TASK_NODE = "pre_task";
+export declare const POST_TASK_NODE = "post_task";
+export declare const START_NODE = "task_start";
+export declare const END_NODE = "task_end";
+/** Options controlling the diagram. */
+export interface BuildTaskLifecycleDiagramOpts {
+    /** Task id — used only in the start/end labels. */
+    taskId: number;
+    /** Operations in ascending sequence order (sorted by `timestamp`). */
+    operations: OperationRecord[];
+    /** Tool calls in ascending sequence order (sorted by `timestamp`). */
+    toolCalls: ToolCallRecord[];
+    /**
+     * If true, the diagram will be returned as a fully-rendered Mermaid
+     * `flowchart TD` block. If false, returns just the body (no header).
+     * Defaults to true.
+     */
+    withHeader?: boolean;
+    /**
+     * Optional label suffix for the end node (e.g. "✅ completed" or
+     * "❌ failed"). Defaults to "end".
+     */
+    endLabel?: string;
+}
+/** Outcome of a single tool-call → operation assignment (mostly for tests). */
+export interface ToolAssignment {
+    toolSequence: number;
+    opSequence: number | null;
+    bucket: "pre-task" | "post-task" | "in-op";
+}
+/**
+ * Decide which operation (if any) "owns" a given tool call. The
+ * heuristic: a tool with timestamp T belongs to opN if
+ *   opN.timestamp <= T < opN+1.timestamp
+ * (sorted ascending by timestamp). Tools before the first op go to
+ * "pre-task", tools after the last op go to "post-task".
+ *
+ * Exported so tests can verify the bucketing independently of the
+ * Mermaid rendering.
+ */
+export declare function assignToolsToOps(operations: OperationRecord[], toolCalls: ToolCallRecord[]): ToolAssignment[];
+/**
+ * Pick the most descriptive path label from a tool's args. We try a
+ * bunch of canonical field names; if none matches, return the empty
+ * string (the caller will decide whether to show just the tool name).
+ */
+export declare function pickPathLabel(args: Record<string, unknown> | undefined): string;
+/** Replace Mermaid-unfriendly characters in a label with safe equivalents. */
+export declare function escapeMermaidLabel(s: string): string;
+/** Build the diagram source. */
+export declare function buildTaskLifecycleDiagram(opts: BuildTaskLifecycleDiagramOpts): string;
+//# sourceMappingURL=task-detail-mermaid.d.ts.map

package/dist/task-detail-mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-detail-mermaid.d.ts","sourceRoot":"","sources":["../src/task-detail-mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAmDlD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmFhD,CAAC;AAiBF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBpF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY/D;AA+CD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAuC3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,eAAe,CAAC,GACnD,MAAM,CAuFR;AAED,yEAAyE;AACzE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,yEAAyE;AACzE,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC,uCAAuC;AACvC,MAAM,WAAW,6BAA6B;IAC5C,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,sEAAsE;IACtE,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,eAAe,EAAE,EAC7B,SAAS,EAAE,cAAc,EAAE,GAC1B,cAAc,EAAE,CAsClB;AAaD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAoB/E;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,gCAAgC;AAChC,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,6BAA6B,GAClC,MAAM,CAyHR"}