Task DAG
Follow an agent task graph in a tab or workspace popup. Both views use the same canvas to show progress. These views are for inspection; create and edit tasks through the CLI.
This page uses a saved copy of the design system, last changed on . It may differ from the current design source.
Graph canvas
Task DAG canvas — read-only observation
The one canvas both surfaces embed. Nodes are laid out top-down by dependency layer, edges are orthogonal with 4px elbows. This is not a node editor: there are no ports, no sockets, no drag-to-move — the only gestures are pan (drag empty canvas or middle-drag), zoom (Ctrl + wheel; bare wheel pans, because a terminal app reads bare wheel as scroll), select (click a node), and Esc to clear.
Position stability is the contract that makes a 0.5s poll survivable: layout is computed from ids + dependency edges only — never from status, duration or counts — so a task turning running → succeeded repaints one card and moves nothing. Layering is longest-path and capped by node count, so a cyclic graph still terminates and still draws.
Never add a connect handle, a port dot, or a drag-to-move affordance. Anything that looks editable promises an edit the host cannot honour — DAGs are built by agents over CLI/IPC.
Node card · 8 states
Task node — every execution state
One card = one task. Three channels carry state so colour is never alone: the leading 3px bar (position), a mono glyph (◦ ❯ ◑ ✓ ✗ − ⊘ ?), and the spelled label. running is the loudest — accent border + accent wash — and it is static: the 0ms terminal-motion policy holds, so there is no spinner and no pulse on the card.
Colour vs. text: the state colour is the recede channel — bar, border, glyph on a chip. The spelled label reads from its own --tasty-dag-status-<state>-label role: waiting takes --tasty-text-muted, and the two dimmed states take --tasty-text-secondary, which still measures 4.74:1 after the 0.75 card dim.
Truncation rule (i18n): the task name is a single line with ellipsis at the card edge — never wraps, never shrinks the font; the full name lives in the tooltip and the detail panel. On the meta row the status label yields first: it ellipses before the duration is dropped, so a long German or Japanese state string can't push the timing out of the card.
Task kinds
Five task kinds, told apart by the leading glyph: run (shell), custom (IPC call), reduce (result fan-in), wait_barrier (gate), agent (one Claude / Codex turn, 2026-10-07). Claude and Codex share the agent glyph; the provider is a detail-panel field, not a second shape.
New glyph: icons/agent.svg — a speech bubble carrying the prompt chevron (an agent turn is a conversation that runs commands). terminal, plug, layers and lock carry the other four. A dedicated barrier glyph would read better than lock if one is ever drawn.
Level of detail · selection · overflow
Zooming out never changes the box, only its content: full (≥70%) name + status + duration · compact (≥40%) glyph + name · block (<40%) status fill only. At 200 nodes the block tier keeps every state readable as colour while the graph shape stays legible.
55 nodes, auto-fitted on open — the canvas lands in the compact or block tier and says so in the bottom-left hint chip, so a user who sees colour blocks knows why and knows the way back.
Running phase · unknown reason (2026-10-07)
Running phase — only awaiting_input gets its own look
Typed (v2) tasks report a step while running. executing is the plain running card. awaiting_input stops the graph on a person, so it swaps the whole state look to the needs-input yellow — bar, border, wash, glyph ! and label — and stays readable at the compact tier (glyph + name). postprocessing and retry_wait keep the running tone and only swap the label, with the run number.
Labels (i18n). needs input · 입력 대기 · 入力待ち — postprocess · 후처리 · 後処理 — retry wait · 재시도 대기 · 再試行待ち — run {n} · {n}회차 · {n}回目. The meta row is caps for Latin scripts only.
Click. Selecting an awaiting node opens the detail panel with a yellow notice and an Open session button (secondary sm) that focuses the agent session surface. It is a user action only; agents never trigger it. The DAG list row adds a mono ! 1 needs input before the rollup chip; the rollup itself stays running.
Hover — the why-line for skipped, unknown and awaiting
The node tooltip is name — label plus one why-line. Unknown also says what unblocks it. The same text sits in the detail panel under Why unknown.
Labels (i18n). Why: · 이유: · 理由: — Why unknown · 알 수 없는 이유 · 不明の理由 — “Retry or cancel it to let the graph continue.” · “다시 실행하거나 취소해야 그래프가 이어집니다.” · “再実行またはキャンセルするとグラフが続行します。” — “Waiting for a person in the {provider} session” · “{provider} 세션이 사람의 입력을 기다리는 중” · “{provider} セッションが入力を待っています”. The reason text is the host's free text, shown as is.
Edges · 5 relations
Dependency edges
Relation is carried by dash pattern and colour together: depends_on solid neutral, fallback long-dash attention, reduce fine-dash info, binding dash-dot data (teal, 2026-10-07), transition long-dash route (lavender, 2026-10-07). When a pair has both depends_on and binding, only the binding is drawn — a binding already implies the order. A one_of binding draws one binding edge per source. Every edge ends in an arrowhead at the dependent task, so the direction reads as "waits for".
Dim the dead path: an edge leaving a failed/cancelled task, or entering a skipped one, drops to 0.4 along with the node. The failure stays loud; everything it stranded recedes.
Transitions · not selected (2026-10-07)
Transition selection — four states on one edge style
A transition edge always keeps its lavender long dash; its selection changes weight and opacity only. pending (producer not finished) = 1px, full opacity. selected = 2px (--tasty-dag-edge-selected-width). not_selected = 1px at --tasty-dag-edge-dim-opacity. unavailable (producer failed) = the existing dead-path dim, like any edge leaving a failed task. Nothing is hidden: the unchosen route stays readable.
A branch that was not taken is a normal outcome, so it gets no new colour: it shares the skipped card and differs only in its spelled label and tooltip. i18n: dag.status.not_selected “not selected” · dag.why.branch_not_selected · dag.why.upstream_unavailable (2026-10-09 — replaces the retired dag.skip.* keys) · dag.rel.binding “binds input” · dag.rel.transition “transition”.
Canvas chrome
Zoom cluster + minimap
Bottom-right overlay, 8px off the canvas edge: minimap above, zoom cluster below (− · % · + · fit · direction). Below 560px of surface width the minimap is dropped; below 400px the percentage readout goes too, leaving five 28px targets.
The minimap paints each node in its status colour, so it doubles as a health strip: a red block anywhere in the graph is visible without zooming out.
Runner badge
Host runner state
Four values in one pill: on/off, crashed, ready_count, running_count. The case that must be noticed is runner stopped with work ready — nothing is advancing the graph — so it takes the warning tone and carries the resume hint beside it.
"Stopped with no work" is not a warning — it is the resting state of a finished graph, so it stays muted. Only stopped-with-ready earns the yellow.
DAG list row
One row per DAG — across all workspaces
A ListCtrl row (36px, icon + label + description) plus the one new part: a trailing cluster of origin tag, rollup state (same 8-state vocabulary as a task) and a mono done/total. Progress is text, not a bar — at this density 7/12 is exact where a 60px bar is only a suggestion.
Rollup (2026-10-07). Seven values, in filter order: waiting · ready · running · succeeded · partially_failed · failed · skipped. partially_failed (◒, peach --tasty-dag-status-partially-failed) = no more progress, an unrecovered failure, and at least one branch succeeded to its end. Precedence is progress first: running → ready → waiting-that-can-run → partially_failed | failed → succeeded | skipped. dagRollup(DAG_PARTIAL.nodes) = partially_failed. Its own filter option, between succeeded and failed. done/total counts its failed tasks as done, same as failed. Label: Partially failed · 일부 실패 · 一部失敗.
The workspace name is part of the description line, not a separate column — the popup lists every workspace, and a column would waste the width the DAG name needs.
Node detail
Selected task — side panel · bottom sheet
Selecting a node opens a 288px right panel on a wide surface and a 220px bottom sheet when the surface is narrow (< 640px) or inside the popup. Failure output can run to dozens of lines, so the error tail is its own bounded, scrollable, copyable block — never an expanding wall that pushes the graph off screen.
Dependency rows are the graph's keyboard-free navigation: each row shows the upstream task's glyph + relation and jumps the selection there, so a failure can be walked back to its cause without hunting on the canvas.
Empty · cycle
Empty states and the cycle warning
Three non-happy states: no DAGs in this workspace (surface), no filter match (popup list), and cycle detected — a warning strip pinned to the canvas top. The cyclic graph keeps rendering behind it: this surface observes, it never hides state.
DAG list popup — empty and no match (2026-10-10 b12)
The popup list uses the same DagEmpty as the surface (one shared function): glyph, title, hint, stacked in the vertical centre of the list area (not the 1/3 point). No match is the search variant and echoes the query. No DAG at all is its own popup variant: the popup spans every workspace, so the surface hint with a workspace-scoped command does not fit; it keeps the app's two strings.
i18n: the search title is new — dag.popup.no_match “No DAGs match “{q}”” / ““{q}”와 일치하는 DAG 없음” / ““{q}” に一致する DAG はありません” · hint dag.popup.no_match_hint “Clear the filter or widen the scope to all workspaces.” / “필터를 지우거나 범위를 모든 워크스페이스로 넓히세요.” / “フィルターを消すか、範囲をすべてのワークスペースに広げてください。”. The old “No matching DAGs” / “Try a different filter.” go.
DAG list popup — no match without a query (2026-10-12)
The list can empty with no search text: the status filter or This workspace only alone filters everything out. There is no query to echo, so this is its own filtered variant: filter glyph (the cause is a filter, not the search field), a title without quotes, and the same hint as the search variant. Variant choice: trimmed query non-empty → search (echo the query only, even when status/scope filters are also on — the hint already says “clear the filter”); trimmed query empty and filters active → filtered; no DAG at all → popup.
i18n (new): dag.popup.no_match_filtered “No DAGs match the current filters” / “현재 필터와 일치하는 DAG 없음” / “現在のフィルターに一致する DAG はありません”. Hint reuses dag.popup.no_match_hint. The temporary dag_list.empty_filtered* (“No matching DAGs” / “Try a different filter.”) can now be removed.
Surface · popup
Full-tab surface — wide and narrow
A whole terminal tab. Header: DAG name + {done} / {total} done (spaces around the slash in every language, 2026-10-09) (mono caption, --tasty-dag-header-count-fg = the list row counter, skip suffix after it, 2026-10-07), the DAG Select, the runner badge, refresh. Under 640px the header wraps to two rows (identity above, controls below), the runner hint drops, the minimap goes, and the detail panel becomes a bottom sheet.
Switching DAG in the header Select replaces the canvas instantly (0ms) and re-fits — a new graph has no position to preserve, so fit is the honest default. Within one DAG the view never re-fits on its own.
Workspace popup — list ⇄ single DAG
A movable 560 × 460 popup. The list carries search, a this workspace only toggle and a status filter; picking a row swaps the whole area for that DAG's canvas via DrillDown — instant, with a back bar that keeps the runner badge in view. The bottom sheet holds node detail here, because 560px has no room for a side panel.
Detail view — the header keeps the runner badge only
The popup's list → detail flow reuses the graph screen, which drags the graph header along: the runner badge, the DAG selector and the zoom cluster all arrive in a view that shows one node — and the back bar's actions slot sits empty beneath them. Settled: no second header. The back bar is the detail's chrome, and its actions slot carries the compact zoom cluster (beside the graph it scales) and the runner badge (it describes the run the node belongs to). The DAG selector is hidden: the back-bar title already names the DAG, and switching DAGs under an open node detail has no meaning. Back restores the list, its header, and the selection.
The actions slot was empty in the current build; this fills it rather than inventing a second bar. If a future detail view needs no zoom, the slot simply goes back to empty.