feature/05-exercise-encyclopedia #4

2026-03-06T12:28:24+01:00

sphinxen commented

2026-03-06 12:28:24 +01:00

No description provided.

sphinxen added 28 commits 2026-03-06 12:28:25 +01:00

checkpoint: phase 05 (exercise encyclopedia) ready to start 5a9ea9c9a8

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)

feat(05-01): Exercise database schema + CRUD API 994cc9e984

feat(05-02): exa-search research integration 53f026aee2

feat(05-03): Exercise research frontend integration 83ccd6c601

- 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>

checkpoint: 05-03 completed f7c654325f

config: add OpenCode API fallback for Gemini quota 0c37d6ea91

- 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

config: upgrade to 3-tier fallback system (Gemini → OpenCode → OpenRouter) 2bc4c947ae

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.

config: reorder API fallbacks - Gemini → OpenRouter → OpenCode 2f6392a807

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.

config: switch to Ollama-first strategy (local AI priority) 210a2d15a9

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.

feat(05-03): ResearchDisplay component + dark-theme encyclopedia UI 6472eb8c6c

- 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>

feat(05-03): Integrate AI fallback system into research search (Exa → Ollama/Gemini/OpenRouter/OpenCode) ab87e54630

feat(05-03): frontend fallback integration for research display 2a0496b915

- 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

feat(05-03): Implement API fallback handling for research display f580fa81a6

- 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

feat(06-01): Exercise recommendations API endpoint + frontend components (coach-assisted suggestions) fbba2d894d

feat(06-03): Update Playwright config and tests to ES modules syntax 1f93f2d4ad

checkpoint: PHASE 06-03 - E2E testing infrastructure validated 99ff53250d

feat(06-04): Playwright E2E test suite execution 0ff29a5d3b

feat(06-05): Expand E2E test coverage dbaaf78de5

checkpoint: PHASE 06 COMPLETE - E2E testing infrastructure + 20 test suite ready 355919e07d

feat(07-02): Add CI/CD deployment scripts 53f4df6e3c

- 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

docs(07-03): Deployment testing plan and documentation fa766b21f7

chore(07-03): Stage deployment scripts and documentation updates 1104f6360e

feat(08-01): Health monitoring & logging infrastructure e09017d2e0

- 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

chore(08-01): Update checkpoint - Health monitoring complete 9f4362ac66

docs(08-01): Add comprehensive phase summary 516c8a600e

fix: Include exercises.json in Docker context for backend 5af6d5c6e5

fix: Include exercises.json in src/data for Docker build context 80654de67b

fix: Correct relative path to exercises.json from exerciseRecommendations.js 6268356c9d

sphinxen merged commit bfb6606127 into main

2026-03-06 12:29:20 +01:00

sphinxen referenced this issue from a commit

2026-03-06 12:29:21 +01:00

Merge pull request 'feature/05-exercise-encyclopedia' (#4) from feature/05-exercise-encyclopedia into main

Sign in to join this conversation.