agent-teams-dashboard 0.10.0 → 0.10.1

package/README.md

@@ -7,12 +7,14 @@ Real-time monitoring dashboard for [Claude Code](https://claude.ai/code) agent t
 ## Features
 
 - **Dual-Sidebar Navigation** — Three-panel layout: TeamsPanel (collapsible) → AgentsPanel → MainPanel
+- **Three Sidebar Modes** — Toggle the top-left switcher between **Teams**, **Convos**, and **Workflows**
 - **Responsive Design** — Full RWD: mobile (drawer + tab bar), tablet (auto-collapsed sidebar), desktop (three-column)
 - **Team Overview** — Live status cards with status dots, progress bars, and member counts
 - **Agent Sessions** — Per-agent session grouping with expandable timeline
 - **Agent Sort Toggle** — Switch between time-sorted (default) and team-grouped view in Conversations mode
 - **Session Resume** — Hover any session in Conversations mode → click `⎘` to copy `cd <path> && claude --resume <sessionId>` to clipboard
 - **Project Source Display** — Agent panel header shows the source project name; visible when navigating from search results or Conversations mode
+- **Workflows View** — Browse [workflow](https://code.claude.com/docs/en/workflows) runs grouped by project: phase progress, sub-agents (expandable to their conversations), token/tool-call stats, result, and the run's script. Workflow sub-agents also surface in **Convos**, marked with a ⚙ icon.
 - **Kanban Task Board** — Pending / In Progress / Completed columns
 - **Agent Activity Monitor** — Real-time messages and tool usage per agent
 - **WebSocket Streaming** — File system changes pushed to browser instantly

package/README.zh-TW.md

@@ -7,10 +7,12 @@
 ## 功能
 
 - **雙側邊欄導航** — 三欄式佈局：TeamsPanel（可摺疊）→ AgentsPanel → MainPanel
+- **三種側邊欄模式** — 左上角切換器可在 **Teams**、**Convos**、**Workflows** 之間切換
 - **團隊總覽** — 即時狀態卡片，含 status dots、進度條、成員數
 - **Agent Sessions** — 按 agent 分組的 session 時間軸，可展開檢視
 - **Session Resume** — 在 Conversations 模式 hover 任一 session → 點 `⎘` 複製 `cd <path> && claude --resume <sessionId>` 到剪貼簿
 - **顯示來源 Project** — Agent 面板 header 右側顯示所屬 project 名稱；從搜尋結果或 Conversations 模式進入時自動帶入
+- **Workflows 檢視** — 依 project 分組瀏覽 [workflow](https://code.claude.com/docs/en/workflows) 執行紀錄：phases 進度、sub-agents（可展開看其對話）、token／tool-call 統計、result 與執行腳本。Workflow sub-agent 也會出現在 **Convos**，以 ⚙ 圖示標記。
 - **看板式任務面板** — Pending / In Progress / Completed 三欄式任務追蹤
 - **Agent 活動監控** — 即時顯示每個 agent 的訊息與工具使用紀錄
 - **WebSocket 即時更新** — 檔案系統變更自動推送至瀏覽器

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-teams-dashboard",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Real-time monitoring dashboard for Claude Code agent teams",
   "type": "module",
   "author": "pingshian0131",

package/server-dist/server/teamsCache.js

@@ -23,11 +23,20 @@ const subagentToMember = new Map(); // subagent filePath -> memberAgentId
 const removedTeams = new Map(); // teams deleted from disk
 // --- Workflows ---
 // Full workflow run journals (includes script/result/logs), keyed by runId.
+// Only present once a run COMPLETES (Claude Code writes wf_*.json on completion).
 const workflowRuns = new Map();
 const workflowFileMtimes = new Map(); // wf_*.json filePath -> mtimeMs (skip re-parse if unchanged)
 const workflowAgentType = new Map(); // workflow sub-agent jsonl filePath -> agentType (from meta.json)
 // workflow sub-agent agentId ("wf:<runId>:<hash>") -> run association
 const workflowAgentMeta = new Map();
+// Parsed script meta (name/phases) keyed by runId — present from launch, lets us
+// label RUNNING workflows that have no completion journal yet. The script may live
+// under a different project dir than the sub-agents (same session reused across worktrees),
+// so we correlate by runId.
+const workflowScripts = new Map();
+// Where a run's sub-agents live (project/session), keyed by runId — used to anchor a
+// running run to the project where its conversations actually appear.
+const workflowRunLocation = new Map();
 export const onChange = new EventEmitter();
 // --- Helpers ---
 async function safeReaddir(dir) {
@@ -200,9 +209,12 @@ export async function scanAgentJsonl() {
                     continue;
                 await readNewEntries(join(subagentsDir, file), false, projDir, parentSessionId);
             }
-            // Workflow run journals: session/workflows/wf_*.json
+            // Workflow run journals: session/workflows/wf_*.json (completed runs only)
             // (scan runs first so sub-agents can resolve their workflowName)
             await scanWorkflowRuns(join(entryPath, 'workflows'), projDir, parentSessionId);
+            // Workflow scripts: session/workflows/scripts/<name>-wf_<runId>.js
+            // (present from launch — gives name/phases for RUNNING runs without a journal)
+            await scanWorkflowScripts(join(entryPath, 'workflows', 'scripts'));
             // Workflow sub-agent conversations: session/subagents/workflows/wf_<runId>/agent-*.jsonl
             await scanWorkflowSubagents(join(subagentsDir, 'workflows'), projDir, parentSessionId);
         }
@@ -273,6 +285,45 @@ async function scanWorkflowRuns(wfDir, projDir, sessionId) {
         }
     }
 }
+/** Best-effort parse of `export const meta = { name, phases:[{title}] }` from a workflow script. */
+function parseWorkflowScriptMeta(src) {
+    let workflowName = '';
+    const nameMatch = src.match(/name:\s*['"]([^'"]+)['"]/);
+    if (nameMatch)
+        workflowName = nameMatch[1];
+    const phases = [];
+    const phasesMatch = src.match(/phases:\s*\[([\s\S]*?)\]/);
+    if (phasesMatch) {
+        const titleRe = /title:\s*['"]([^'"]+)['"]/g;
+        let m;
+        while ((m = titleRe.exec(phasesMatch[1])) !== null) {
+            phases.push({ title: m[1] });
+        }
+    }
+    return { workflowName, phases };
+}
+/** Scan session/workflows/scripts/*-wf_<runId>.js to learn name/phases of (possibly running) runs. */
+async function scanWorkflowScripts(scriptsDir) {
+    const files = await safeReaddir(scriptsDir);
+    for (const file of files) {
+        if (!file.endsWith('.js'))
+            continue;
+        const m = file.match(/(wf_[A-Za-z0-9-]+)\.js$/);
+        if (!m)
+            continue;
+        const runId = m[1];
+        if (workflowScripts.has(runId))
+            continue; // parse once per run
+        const filePath = join(scriptsDir, file);
+        const st = await safeFileStat(filePath);
+        if (!st || Date.now() - st.mtimeMs > MAX_FILE_AGE_MS)
+            continue;
+        const src = await safeReadFile(filePath);
+        if (!src)
+            continue;
+        workflowScripts.set(runId, parseWorkflowScriptMeta(src));
+    }
+}
 /** Scan session/subagents/workflows/wf_<runId>/agent-*.jsonl conversations. */
 async function scanWorkflowSubagents(wfRoot, projDir, parentSessionId) {
     const runDirs = await safeReaddir(wfRoot);
@@ -281,6 +332,10 @@ async function scanWorkflowSubagents(wfRoot, projDir, parentSessionId) {
             continue;
         const runPath = join(wfRoot, runDir);
         const files = await safeReaddir(runPath);
+        // Anchor this run to where its sub-agents live (the project shown in Convos).
+        if (files.some((f) => f.startsWith('agent-') && f.endsWith('.jsonl'))) {
+            workflowRunLocation.set(runDir, { projectDir: projDir, sessionId: parentSessionId });
+        }
         for (const file of files) {
             if (!file.startsWith('agent-') || !file.endsWith('.jsonl'))
                 continue;
@@ -846,24 +901,67 @@ function leanWorkflow(run, agents) {
     const { script: _s, scriptPath: _sp, result: _r, logs: _l, ...lean } = run;
     return { ...lean, agents };
 }
-/** Lean workflow runs (no script/result/logs) for the snapshot. */
+/** Synthesize a `running` WorkflowRun from live data (script meta + sub-agents) — used
+ *  for runs that have launched but not yet written a completion journal. */
+function buildRunningWorkflow(runId, agents) {
+    const script = workflowScripts.get(runId);
+    const loc = workflowRunLocation.get(runId);
+    if (!loc)
+        return null; // no sub-agents anchored → nothing meaningful to show
+    const lastTs = agents.reduce((max, a) => (a.lastTimestamp > max ? a.lastTimestamp : max), '');
+    const startTime = lastTs ? new Date(lastTs).getTime() : 0;
+    return {
+        runId,
+        workflowName: script?.workflowName || runId,
+        summary: '',
+        status: 'running',
+        startTime: Number.isNaN(startTime) ? 0 : startTime,
+        timestamp: lastTs,
+        agentCount: agents.length,
+        phases: script?.phases ?? [],
+        completedPhases: 0,
+        projectDir: loc.projectDir,
+        projectName: resolveProjectName(loc.projectDir, knownProjectDirs),
+        sessionId: loc.sessionId,
+        agents,
+    };
+}
+/** Lean workflow runs (no script/result/logs) for the snapshot — completed + running. */
 export function getWorkflows() {
     const byRun = buildWorkflowAgentsByRun();
     const runs = [];
+    const seen = new Set();
+    // Completed runs (authoritative journal)
     for (const [runId, run] of workflowRuns) {
+        seen.add(runId);
         runs.push(leanWorkflow(run, byRun.get(runId) ?? []));
     }
-    // Most recently started first
-    runs.sort((a, b) => b.startTime - a.startTime || b.timestamp.localeCompare(a.timestamp));
+    // Running runs: have live sub-agents/script but no completion journal yet
+    const liveRunIds = new Set([...workflowRunLocation.keys(), ...workflowScripts.keys()]);
+    for (const runId of liveRunIds) {
+        if (seen.has(runId))
+            continue;
+        const running = buildRunningWorkflow(runId, byRun.get(runId) ?? []);
+        if (running)
+            runs.push(running);
+    }
+    // Running first, then most recent activity first
+    runs.sort((a, b) => {
+        const ar = a.status === 'running' ? 1 : 0;
+        const br = b.status === 'running' ? 1 : 0;
+        if (ar !== br)
+            return br - ar;
+        return b.timestamp.localeCompare(a.timestamp) || b.startTime - a.startTime;
+    });
     return runs;
 }
-/** Full workflow run (with script/result/logs) for the detail endpoint. */
+/** Full workflow run (with script/result/logs) for the detail endpoint; falls back to a running run. */
 export function getWorkflowDetail(runId) {
-    const run = workflowRuns.get(runId);
-    if (!run)
-        return null;
     const agents = buildWorkflowAgentsByRun().get(runId) ?? [];
-    return { ...run, agents };
+    const run = workflowRuns.get(runId);
+    if (run)
+        return { ...run, agents };
+    return buildRunningWorkflow(runId, agents);
 }
 export function getAgentSessions(agentId) {
     const entries = agentEntries.get(agentId);