wg-html-declutter — Workgraph live mirror

Metadata

Status	done
Assigned	`agent-1282`
Agent identity	`f51439356729d112a6c404803d88015d5b44832c6c584c62b96732b63c2b0c7e`
Created	2026-04-30T16:34:56.223540474+00:00
Started	2026-04-30T16:35:23.445984400+00:00
Completed	2026-04-30T17:04:49.349980813+00:00
Tags	`fix,html,viz,polish`, `eval-scheduled`
Eval score	0.83
└ blocking impact	0.90
└ completeness	1.00
└ coordination overhead	0.90
└ correctness	0.95
└ downstream usability	0.85
└ efficiency	0.85
└ intent fidelity	0.63
└ style adherence	0.95

Description

The wg html output has redundant explanatory text at the top:

Workgraph
921 tasks shown · click a task id to inspect
Dependency graph (click a task to inspect — magenta = upstream deps · cyan = downstream consumers)

Two near-duplicate 'click a task id to inspect' instructions, plus a long parenthetical explanation of edge colors. Visually heavy at the top of every page.

User quote 2026-04-30: 'This text is kind of redundant. Basically, we could just have the top, and then the only thing you want to do is explain that the... Maybe this is just shown when you click. ... yeah, just explain the coloring of the edges. Maybe there's some legend you can click that has a full description of everything that kind of pops up in the side window?'

Spec

New top header (clean)

Workgraph
921 tasks shown

That's it. Two lines. No 'click to inspect' redundancy (clicking is naturally discoverable; the cursor changes on hover).

Legend / help button

Small icon or 'Legend' link in the corner of the page header. Clicking opens the side panel with a full legend covering:

Edge colors: magenta (upstream deps), cyan (downstream consumers), yellow (cycle)
Status colors: open/in-progress/done/failed/blocked/abandoned/pending-eval (with the corrected palette from the polish-wg-html task)
Click behaviors: 'click any task id or status glyph to inspect; click links inside the panel to navigate'
Theme toggle reminder
Any other affordances (--chat content, --since filter, etc. — short notes)

The legend is the single source of UI explanation; the page header stays clean.

Side panel reuse

Reuse the existing side-panel infrastructure from wg-html-v2 — clicking 'Legend' just sets the panel content to the legend instead of a task detail. Closing the panel (Esc, click X) returns to the previous task detail or empty state.

Validation

Failing test: top of page shows 'Workgraph' + task count, NO 'Dependency graph (click...)' parenthetical
Live smoke: open html in browser, confirm clean header. Click 'Legend' button, confirm side panel opens with full legend covering edges + statuses + interactions
Closing the legend panel returns to default state (or last-shown task detail)
No regression of any other wg-html-v2 features
cargo build + cargo test pass
cargo install --path . was run before claiming done

## Description
The wg html output has redundant explanatory text at the top:

```
Workgraph
921 tasks shown · click a task id to inspect
Dependency graph (click a task to inspect — magenta = upstream deps · cyan = downstream consumers)
```

Two near-duplicate 'click a task id to inspect' instructions, plus a long parenthetical explanation of edge colors. Visually heavy at the top of every page.

User quote 2026-04-30: 'This text is kind of redundant. Basically, we could just have the top, and then the only thing you want to do is explain that the... Maybe this is just shown when you click. ... yeah, just explain the coloring of the edges. Maybe there's some legend you can click that has a full description of everything that kind of pops up in the side window?'

## Spec

### New top header (clean)
```
Workgraph
921 tasks shown
```

That's it. Two lines. No 'click to inspect' redundancy (clicking is naturally discoverable; the cursor changes on hover).

### Legend / help button
Small icon or 'Legend' link in the corner of the page header. Clicking opens the side panel with a full legend covering:
- Edge colors: magenta (upstream deps), cyan (downstream consumers), yellow (cycle)
- Status colors: open/in-progress/done/failed/blocked/abandoned/pending-eval (with the corrected palette from the polish-wg-html task)
- Click behaviors: 'click any task id or status glyph to inspect; click links inside the panel to navigate'
- Theme toggle reminder
- Any other affordances (--chat content, --since filter, etc. — short notes)

The legend is the single source of UI explanation; the page header stays clean.

### Side panel reuse
Reuse the existing side-panel infrastructure from wg-html-v2 — clicking 'Legend' just sets the panel content to the legend instead of a task detail. Closing the panel (Esc, click X) returns to the previous task detail or empty state.

## Validation
- [ ] Failing test: top of page shows 'Workgraph' + task count, NO 'Dependency graph (click...)' parenthetical
- [ ] Live smoke: open html in browser, confirm clean header. Click 'Legend' button, confirm side panel opens with full legend covering edges + statuses + interactions
- [ ] Closing the legend panel returns to default state (or last-shown task detail)
- [ ] No regression of any other wg-html-v2 features
- [ ] cargo build + cargo test pass
- [ ] cargo install --path . was run before claiming done

Depends on

done .assign-wg-html-declutter

Required by

(none)

Log

2026-04-30T16:34:56.207058533+00:00 Task paused
2026-04-30T16:34:56.256692760+00:00 Task published
2026-04-30T16:35:21.247095693+00:00 Lightweight assignment: agent=Careful Programmer (f5143935), exec_mode=full, context_scope=task, reason=Careful Programmer excels at HTML/UI implementation with 0.79 score on 430 similar tasks; Careful tradeoff ensures exhaustive browser testing and no regression of existing side-panel infrastructure.
2026-04-30T16:35:23.445989950+00:00 Spawned by coordinator --executor claude --model opus
2026-04-30T16:35:34.208032278+00:00 Starting work — examining current wg html implementation
2026-04-30T16:49:18.894531259+00:00 STASH RECOVERED — never stash again per memory rules
2026-04-30T17:04:06.014875803+00:00 Validated: cargo build clean. integration_html.rs 28/28 tests pass (incl. 2 new declutter assertions). Pre-existing unrelated test_global_config_path failure not introduced by us (don't touch src/config.rs).
2026-04-30T17:04:06.056819101+00:00 Live smoke (real wg binary, real graph): clean header rendered as 'Workgraph' + 'N tasks shown'. Legend button + template emitted. wg_html_v2_tui_parity + wg_html_ascii_viz + wg_html_chat smokes all PASS. New tests/smoke/scenarios/wg_html_declutter.sh PASSes.
2026-04-30T17:04:06.087519619+00:00 JSDOM live test confirms full flow: click task → panel opens; click Legend → panel swaps to legend; close → restores prior task; close again → panel closes. All 8 JSDOM checks pass.
2026-04-30T17:04:06.122670113+00:00 cargo install --path . done; binary at /home/erik/.cargo/bin/wg now built from this worktree.
2026-04-30T17:04:32.859179081+00:00 Committed: ab16eed69 — pushed to remote
2026-04-30T17:04:49.349983748+00:00 Task pending eval (agent reported done; awaiting `.evaluate-*` to score)
2026-04-30T17:07:25.613353877+00:00 PendingEval → Done (evaluator passed; downstream unblocks)