feature/05-exercise-encyclopedia #4

Merged
sphinxen merged 28 commits from feature/05-exercise-encyclopedia into main 2026-03-06 12:29:20 +01:00

28 Commits

Author SHA1 Message Date
clawd 6268356c9d fix: Correct relative path to exercises.json from exerciseRecommendations.js 2026-03-06 12:19:24 +01:00
clawd 80654de67b fix: Include exercises.json in src/data for Docker build context 2026-03-06 12:18:15 +01:00
clawd 5af6d5c6e5 fix: Include exercises.json in Docker context for backend 2026-03-06 12:17:41 +01:00
clawd 516c8a600e docs(08-01): Add comprehensive phase summary 2026-03-03 21:29:22 +01:00
clawd 9f4362ac66 chore(08-01): Update checkpoint - Health monitoring complete 2026-03-03 21:28:57 +01:00
clawd e09017d2e0 feat(08-01): Health monitoring & logging infrastructure
- Set up Winston structured logging with console and file outputs
- Create GET /api/health endpoint with uptime, database status, response times
- Add request logging middleware (method, path, statusCode, duration)
- Create health monitoring module with database connectivity checks
- Log all HTTP requests with timing information
- Log auth events (login, register) and data modifications
- Replace console.log/error with structured logger calls
- Update backend README with logging configuration documentation
- Add tests for health endpoint and logging middleware
- Logs directory: logs/combined.log and logs/error.log

Deliverables met:
✓ Structured logging (Winston) integrated
✓ Enhanced health endpoint with uptime & database info
✓ Request logging middleware attached to all routes
✓ Comprehensive logging documentation in README.md
✓ Tests passing for health and logging functionality
✓ All critical operations logged with context
2026-03-03 21:28:46 +01:00
clawd 1104f6360e chore(07-03): Stage deployment scripts and documentation updates 2026-03-03 19:24:29 +01:00
clawd fa766b21f7 docs(07-03): Deployment testing plan and documentation 2026-03-03 18:23:19 +01:00
clawd 53f4df6e3c feat(07-02): Add CI/CD deployment scripts
- scripts/deploy.sh: Full deploy flow with fresh builds (--no-cache)
- scripts/build-check.sh: Pre-flight staleness check
- Docker labels for build tracking (git commit + timestamp)
- Prevents stale container bug from recurring
2026-03-03 17:20:23 +01:00
clawd 355919e07d checkpoint: PHASE 06 COMPLETE - E2E testing infrastructure + 20 test suite ready 2026-03-03 14:10:18 +01:00
clawd dbaaf78de5 feat(06-05): Expand E2E test coverage 2026-03-03 12:11:40 +01:00
clawd 0ff29a5d3b feat(06-04): Playwright E2E test suite execution 2026-03-03 09:05:46 +01:00
clawd 99ff53250d checkpoint: PHASE 06-03 - E2E testing infrastructure validated 2026-03-03 04:57:12 +01:00
clawd 1f93f2d4ad feat(06-03): Update Playwright config and tests to ES modules syntax 2026-03-03 04:56:51 +01:00
clawd fbba2d894d feat(06-01): Exercise recommendations API endpoint + frontend components (coach-assisted suggestions) 2026-03-03 03:54:12 +01:00
clawd f580fa81a6 feat(05-03): Implement API fallback handling for research display
- Enhanced exaSearch service with Exa API + fallback tier system
  * Tier 1: Exa API (primary)
  * Tier 2: Synthetic results with suggested web sources
  * Improved error handling with graceful degradation

- Updated backend exerciseResearch route to return provider info
  * Returns 'provider' field identifying which API was used
  * Returns 'status' field (success/degraded) for UI feedback
  * Better error messages for debugging

- Enhanced ResearchDisplay component with fallback feedback
  * New ResearchProviderBadge shows which provider was used
  * Visual indicators for fallback results (Suggested badge)
  * Support for multiple provider types (exa, fallback, gemini, etc.)
  * Improved error handling and recovery flows

- Updated ExerciseResearchPanel with better error handling
  * Proper response parsing from backend
  * Forwards provider and status info to display component
  * Improved accessibility with tooltip hints

- Added comprehensive Research Display styling
  * Responsive layout for mobile and desktop
  * Visual hierarchy for summaries and sources
  * Provider badge styling with color-coding
  * Fallback state indicators for user awareness
2026-03-02 23:45:07 +01:00
clawd 2a0496b915 feat(05-03): frontend fallback integration for research display
- ExerciseResearchPanel: add ProviderBadge component showing which AI
  tier (Ollama/Gemini/OpenRouter/OpenCode/Exa) served the response
- Add auto-retry on 429/503 with 2s delay and retry counter in button
- Normalize error messages for common failure modes (network, rate-limit)
- ResearchDisplay: pass onRetry prop to error state for inline retry button
- CSS: .research-panel-controls flex row, .provider-badge with per-provider
  colour coding, .rd-error-actions + .rd-retry button styles
2026-03-02 23:44:32 +01:00
clawd ab87e54630 feat(05-03): Integrate AI fallback system into research search (Exa → Ollama/Gemini/OpenRouter/OpenCode) 2026-03-02 23:44:03 +01:00
clawd 6472eb8c6c feat(05-03): ResearchDisplay component + dark-theme encyclopedia UI
- Add ResearchDisplay.jsx: pure presentational component for research
  data with loading skeleton, accessible error state, and source cards
- Refactor ExerciseResearchPanel to delegate rendering to ResearchDisplay
  (separates fetch/state logic from display)
- Add ExerciseEncyclopediaPage.css: full dark-theme stylesheet using
  CSS variables (--bg-*, --text-*, --accent, --border, --radius-*)
  replacing the light-theme WorkoutEditPage.css import
- Update ExerciseEncyclopediaPage.jsx: new semantic class names,
  keyboard-accessible card toggle (Enter key + role=button + aria-expanded)
- Mobile-responsive at 600px breakpoint

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-02 20:38:14 +01:00
clawd 210a2d15a9 config: switch to Ollama-first strategy (local AI priority)
Changed API fallback chain:
- Tier 1: Ollama (local, free, always available)
- Tier 2: Gemini (free tier with quota limits)
- Tier 3: OpenRouter (cheap, flexible fallback)
- Tier 4: OpenCode (final backup)

This saves costs by using local Ollama for most tasks.
OpenRouter only used when Ollama unavailable.
2026-03-02 19:48:41 +01:00
clawd 2f6392a807 config: reorder API fallbacks - Gemini → OpenRouter → OpenCode
Changed priority:
- Tier 1: Gemini (primary, free but quota-limited)
- Tier 2: OpenRouter (secondary, cheaper & more flexible)
- Tier 3: OpenCode (tertiary, final fallback)

OpenRouter is better: supports multiple models, cheaper per-token,
intelligent routing. Moved to primary fallback position.
2026-03-02 19:43:55 +01:00
clawd 2bc4c947ae config: upgrade to 3-tier fallback system (Gemini → OpenCode → OpenRouter)
Added OpenRouter as tertiary fallback:
- Primary: Gemini (free tier, quota-limited)
- Secondary: OpenCode (fallback if Gemini quota exceeded)
- Tertiary: OpenRouter (final fallback, supports multiple models)

gemini-fallback.js now tries all three in sequence with proper error handling.
2026-03-02 19:39:33 +01:00
clawd 0c37d6ea91 config: add OpenCode API fallback for Gemini quota
- Configured OpenCode as fallback when Gemini quota exceeded
- Created gemini-fallback.js utility (tries Gemini → OpenCode)
- API keys stored in .env (excluded from git)
- PM unblocked: can resume 05-03 with fallback system

Flow: Gemini (primary) → OpenCode (fallback) → fail gracefully
2026-03-02 19:38:25 +01:00
clawd f7c654325f checkpoint: 05-03 completed 2026-03-02 19:23:04 +01:00
clawd 83ccd6c601 feat(05-03): Exercise research frontend integration
- Add ExerciseResearchPanel component with Get Research button, loading state, summary display, and source links
- Add ExerciseEncyclopediaPage with exercise list and integrated research panel
- Wire encyclopedia view into App.jsx navigation
- Add encyclopedia nav button to Dashboard
- Add CSS for research panel and encyclopedia search

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-02 19:20:40 +01:00
clawd 53f026aee2 feat(05-02): exa-search research integration 2026-03-02 14:10:32 +01:00
clawd 994cc9e984 feat(05-01): Exercise database schema + CRUD API 2026-03-02 13:03:30 +01:00
clawd 5a9ea9c9a8 checkpoint: phase 05 (exercise encyclopedia) ready to start
Phase 04 (workout modification) complete:
- 14 commits rebased onto main
- All features verified and staged
- Ready for merge

Phase 05 structure defined:
- 05-01: Exercise DB schema & CRUD API
- 05-02: AI research integration (exa-search)
- 05-03: Demo video generation (Veo)
- 05-04: Search & Add UI
- 05-05: Exercise detail view
- 05-06: User ratings & feedback

Next: PM starts 05-01 (backend foundation)
2026-03-02 09:26:32 +01:00