WORK-025
ID:WORK-025Status:done

Milestone Auto-Backlog and Checklist Progress

Priority:lowComplexity:moderateSource:SPEC-021
changeset-release/main View source

Criteria completion

No incremental history — criteria tracking started on Apr 19.

Relationships

Implements 1
Related 2
Branches 3
changeset-release/main current done
main doneclaude/file-naming-convention-LJdwR doneclaude/align-sidenav-styling-4MuxV done
History 5
  1. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand
  2. f262d7b
    Content editedby Claude
    Backfill source attributes on all 123 work items
  3. 8ec4542
    Content editedby Claude
    Implement milestone auto-backlog, checklist progress, and directory supp
  4. ebe0c64
    Content editedby Claude
    Migrate plan files to {% ref %} xref syntax (WORK-021)
  5. 3fc7634
    Created (done)by Claude
    Add work items for remaining SPEC-021 plan runes gaps

Summary

Two related rendering enhancements for the plan package:

  1. Milestone auto-backlog: The milestone rune automatically appends a filtered view of all work items and bugs assigned to its name, grouped by status. This makes milestones self-updating — as work items are created with milestone="v0.5.0", they appear in the v0.5.0 milestone page automatically.

  2. Checklist progress: Work items with - [ ] / - [x] checkbox lists show a progress indicator in their header (e.g., 2/5 or a progress bar). The milestone view shows aggregate progress across all assigned items.

Acceptance Criteria

  • Milestone postProcess hook queries entity registry for work/bug entities with matching milestone field
  • Queried items rendered as summary cards below the milestone's own content
  • Items grouped by status (done, in-progress, ready, etc.)
  • Work items with checkbox lists show checked/total count in header
  • Milestone shows aggregate progress (total checked / total checkboxes across all items)
  • CSS for progress indicator (bar or fraction display)
  • Tests for milestone query, progress counting, and rendering

Approach

Checklist progress likely uses a postTransform hook on the work rune config that walks the renderable tree counting checkbox list items. The count is injected as a data attribute or structural element.

Milestone auto-backlog uses a postProcess pipeline hook that queries the entity registry and appends backlog card markup to the milestone's renderable tree.

Dependencies

  • WORK-020 (entity registration) — entities must be registered first
  • WORK-022 (backlog rune) — card layout rendering can be shared