docs(05-02): complete progress bars and data plan

Tasks completed: 3/3
- Wire useScientificMuscleVolume hook and add loading/error states
- Add muscle row with progress bar
- Add group summary in header

SUMMARY: .planning/phases/05-muscle-list/05-02-SUMMARY.md

Author: jtomaszewski-gx

.planning/STATE.md

@@ -5,24 +5,24 @@
 See: .planning/PROJECT.md (updated 2026-01-18)
 
 **Core value:** The body itself must carry the primary signal - users see training distribution at a glance without reading numbers.
-**Current focus:** Phase 5 - Muscle List
+**Current focus:** Phase 5 - Muscle List (Complete)
 
 ## Current Position
 
 Phase: 5 of 9 (Muscle List)
-Plan: 1 of 2 in current phase
-Status: In progress
-Last activity: 2026-01-22 - Completed 05-01-PLAN.md
+Plan: 2 of 2 in current phase
+Status: Phase complete
+Last activity: 2026-01-22 - Completed 05-02-PLAN.md
 
-Progress: [======....] 58%
+Progress: [=======...] 67%
 
 ## Performance Metrics
 
 **Velocity:**
 
-- Total plans completed: 7
-- Average duration: 3 min
-- Total execution time: 21 min
+- Total plans completed: 8
+- Average duration: 2.9 min
+- Total execution time: 23 min
 
 **By Phase:**
 
@@ -32,11 +32,11 @@ Progress: [======....] 58%
 | 02-visual-system        | 2     | 7 min | 3.5 min  |
 | 03-heatmap-core         | 2     | 7 min | 3.5 min  |
 | 04-front-back-toggle    | 1     | 2 min | 2 min    |
-| 05-muscle-list          | 1     | 1 min | 1 min    |
+| 05-muscle-list          | 2     | 3 min | 1.5 min  |
 
 **Recent Trend:**
 
-- Last 5 plans: 3 min, 3 min, 4 min, 2 min, 1 min
+- Last 5 plans: 3 min, 4 min, 2 min, 1 min, 2 min
 - Trend: Stable (faster on smaller plans)
 
 _Updated after each plan completion_
@@ -65,6 +65,9 @@ Recent decisions affecting current work:
 - Button shows opposite view label ('Back'/'Front') for discoverability (TOGGLE-LABEL)
 - First group starts expanded for mobile muscle list (LIST-MOBILE-01)
 - Use existing 7 UI_MUSCLE_GROUPS for consistency with WeeklyGoalEditor
+- Progress bar width clamped to 100% (data can exceed but bar fills at max)
+- Group totals replace muscle count badge in headers for actionable info
+- formatVolume shows whole numbers without decimals, fractions with one decimal
 
 ### Patterns Established
 
@@ -85,17 +88,21 @@ Recent decisions affecting current work:
 - **FLIP-02:** Both faces have backfaceVisibility hidden, back face pre-rotated 180deg
 - **LIST-EXPAND-01:** useState<Set<string>> for tracking multiple expanded sections
 - **LIST-MOBILE-01:** First item expanded by default for mobile scroll optimization
+- **LIST-DATA-01:** useScientificMuscleVolume for muscle-level volume data
+- **LIST-DATA-02:** statsMap via useMemo for O(1) muscle lookup
+- **LIST-PROGRESS-01:** w-24 h-2 progress bar with rounded-full and dynamic backgroundColor
+- **LIST-SUMMARY-01:** Group headers show aggregate volume with getVolumeColor
 
 ### Pending Todos
 
 None.
 
 ### Blockers/Concerns
 
-None - Plan 05-01 complete, ready for 05-02 (progress bars and data wiring).
+None - Phase 05 complete, ready for Phase 06 (mobile layout integration).
 
 ## Session Continuity
 
-Last session: 2026-01-22T21:47:24Z
-Stopped at: Completed 05-01-PLAN.md
+Last session: 2026-01-22T21:51:38Z
+Stopped at: Completed 05-02-PLAN.md (Phase 05 complete)
 Resume file: None

.planning/phases/05-muscle-list/05-02-SUMMARY.md

@@ -0,0 +1,102 @@
+---
+phase: 05-muscle-list
+plan: 02
+subsystem: ui
+tags: [react, mobile, progress-bar, volume-stats, color-scale]
+
+# Dependency graph
+requires:
+  - phase: 05-muscle-list
+    plan: 01
+    provides: Collapsible muscle groups structure with expand/collapse UI
+  - phase: 02-visual-system
+    provides: getVolumeColor from @core/color-scale for progress bar colors
+provides:
+  - MobileMuscleList with real volume data integration
+  - Horizontal progress bars colored by volume percentage
+  - Group summary totals in headers with dynamic coloring
+affects: [mobile-layout-integration, future mobile muscle detail views]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - useMemo for statsMap and groupSummaries calculation
+    - Progress bar pattern (h-2 rounded-full bg-primary-800 container with dynamic fill)
+    - formatVolume helper for clean number display
+
+key-files:
+  created: []
+  modified:
+    - src/ui/components/mobile/MobileMuscleList.tsx
+
+key-decisions:
+  - "Progress bar width clamped to 100% (data can exceed but bar fills at max)"
+  - "Group totals replace muscle count badge in headers for more useful at-a-glance info"
+  - "formatVolume shows whole numbers without decimals, fractions with one decimal"
+
+patterns-established:
+  - "LIST-DATA-01: useScientificMuscleVolume for muscle-level volume data"
+  - "LIST-DATA-02: statsMap via useMemo for O(1) muscle lookup"
+  - "LIST-PROGRESS-01: w-24 h-2 progress bar with rounded-full and dynamic backgroundColor"
+  - "LIST-SUMMARY-01: Group headers show aggregate volume with getVolumeColor"
+
+# Metrics
+duration: 2min
+completed: 2026-01-22
+---
+
+# Phase 5 Plan 02: Progress Bars and Data Summary
+
+**Wired useScientificMuscleVolume hook to collapsible muscle list with colored progress bars, group totals, and loading/error states**
+
+## Performance
+
+- **Duration:** 2 min
+- **Started:** 2026-01-22T21:49:12Z
+- **Completed:** 2026-01-22T21:51:38Z
+- **Tasks:** 3
+- **Files modified:** 1
+
+## Accomplishments
+- Integrated useScientificMuscleVolume hook for real workout volume data
+- Added horizontal progress bars colored by getVolumeColor (purple -> green -> red)
+- Group headers now show aggregate volume with dynamic color indicating progress
+- Loading spinner and error state for edge case handling
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Wire useScientificMuscleVolume hook and add loading/error states** - `20bd84d` (feat)
+2. **Task 2: Add muscle row with progress bar** - `2156ff3` (feat)
+3. **Task 3: Add group summary in header** - `f3516d3` (feat)
+
+## Files Created/Modified
+- `src/ui/components/mobile/MobileMuscleList.tsx` - Complete muscle list with progress bars and data integration (194 lines)
+
+## Decisions Made
+- Progress bar width clamped to 100% even when data exceeds goal (bar fills completely at goal)
+- Group totals replaced muscle count badge for more actionable at-a-glance information
+- formatVolume helper provides clean number display (whole numbers vs decimals)
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None - all tasks completed successfully.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+- MobileMuscleList fully functional with real data
+- Phase 05 complete - ready for mobile layout integration
+- Component props (profileId, daysBack) ready for parent component wiring
+
+---
+*Phase: 05-muscle-list*
+*Completed: 2026-01-22*