Tom Boucher 330e5200bc docs: add v2.18/v2.19 feature documentation (#631 )

New docs:
- dynamic-model-routing.md — complexity classification, tier models,
  escalation, budget pressure, cost table, adaptive learning
- captures-triage.md — fire-and-forget capture, triage pipeline,
  classification types, dashboard integration, worktree awareness
- visualizer.md — four-tab TUI overlay (progress, deps, metrics,
  timeline), controls, auto-refresh, auto_visualize preference

Updated docs:
- README.md — added links to three new docs
- commands.md — added capture, triage, visualize, knowledge, queue reorder
- configuration.md — added dynamic_routing and auto_visualize settings,
  updated full example with new config options
- auto-mode.md — added capture, visualize sections, dashboard badge,
  dynamic model routing reference
- architecture.md — updated dispatch pipeline (routing + captures steps),
  added key modules table for v2.19
- cost-management.md — added dynamic routing and visualizer tips

2026-03-16 09:00:58 -06:00

2 KiB

Raw Blame History

Workflow Visualizer

Introduced in v2.19.0

The workflow visualizer is a full-screen TUI overlay that shows project progress, dependencies, cost metrics, and execution timeline in an interactive four-tab view.

Opening the Visualizer

/gsd visualize

Or configure automatic display after milestone completion:

auto_visualize: true

Tabs

Switch tabs with Tab, 1-4, or arrow keys.

1. Progress

A tree view of milestones, slices, and tasks with completion status:

M001: User Management
  ✅ S01: Auth module
    ✅ T01: Core types
    ✅ T02: JWT middleware
    ✅ T03: Login flow
  ⏳ S02: User dashboard
    ✅ T01: Layout component
    ⬜ T02: Profile page
  ⬜ S03: Admin panel

Shows checkmarks for completed items, spinners for in-progress, and empty boxes for pending.

2. Dependencies

An ASCII dependency graph showing slice relationships:

S01 ──→ S02 ──→ S04
  └───→ S03 ──↗

Visualizes the depends: field from the roadmap, making it easy to see which slices are blocked and which can proceed.

3. Metrics

Bar charts showing cost and token usage breakdowns:

By phase — research, planning, execution, completion, reassessment
By slice — cost per slice with running totals
By model — which models consumed the most budget

Uses data from .gsd/metrics.json.

4. Timeline

Chronological execution history showing:

Unit type and ID
Start/end timestamps
Duration
Model used
Token counts

Ordered by execution time, showing the full history of auto-mode dispatches.

Controls

Key	Action
`Tab`	Next tab
`Shift+Tab`	Previous tab
`1`-`4`	Jump to tab
`↑`/`↓`	Scroll within tab
`Escape` / `q`	Close visualizer

Auto-Refresh

The visualizer refreshes data from disk every 2 seconds, so it stays current if opened alongside a running auto-mode session.

Configuration

auto_visualize: true    # show visualizer after milestone completion

2 KiB Raw Blame History