WORK-046
ID:WORK-046Status:done

Enhanced plan dashboard with progress and milestone scoping

Improve the auto-generated dashboard to show project health at a glance: status count summaries, a blocked items callout, per-milestone grouping when multiple milestones exist, and a recent activity section.

Priority:mediumComplexity:moderate
claude/align-sidenav-styling-4MuxV View source

Criteria completion

No incremental history — criteria tracking started on Apr 17.

Relationships

Implements 1
Related 1
Branches 3
claude/align-sidenav-styling-4MuxV current done
main doneclaude/file-naming-convention-LJdwR donechangeset-release/main done
History 3
  1. 4707ead
    Content editedby Claude
    Add enhanced dashboard with progress summaries, milestone grouping, and
  2. 3d8d331
    Content editedby Claude
    Add WORK-050: converge plan renderer with shared layout engine
  3. f5b8bf8
    Created (done)by Claude
    Add work items WORK-037 through WORK-049 for plan site specs

Acceptance Criteria

  • Dashboard shows a progress summary line per entity type (e.g., "35 work items: 12 done, 3 in progress, 7 ready, 2 blocked, 11 draft")
  • Status counts are color-coded using the existing status palette
  • Blocked items section with warning styling surfaces all status: blocked entities
  • When multiple milestones exist, work items and bugs are grouped by milestone with per-milestone progress
  • When one or zero milestones exist, flat layout is used (current behavior)
  • Recent activity section shows last 10 items by file modification time
  • Existing dashboard sections (active milestone, ready, in-progress, recent decisions) are preserved

Approach

Extend the dashboard generation in @refrakt-md/plan's aggregate pipeline phase. Progress summaries and milestone grouping are computed from the entity registry. Recent activity uses mtime from the file scanner.

Note: The dashboard page uses generateDashboardContent() which produces Markdoc content, not raw HTML. This approach is independent of WORK-050's renderer convergence — the dashboard generation creates content that flows through whatever renderer is active.

References

  • SPEC-015 (Plan Site UX at Scale — Feature 3)
  • WORK-039 (HTML adapter refactor — prerequisite)