Metadata-Version: 2.4
Name: paicer
Version: 0.1.0
Summary: Training plan tool: YAML to Garmin workouts and readable documents
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: click>=8.0
Requires-Dist: garminconnect<0.3.0,>=0.2.40
Requires-Dist: keyring>=24.0
Requires-Dist: markdown>=3.10.2
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# p**ai**cer

AI-powered training plan manager. Provide your race goals, schedule, and fitness level to create a plan, with structured workouts that can be synced to your Garmin watch. After each training week, run the progress review command to pull your Garmin activity and training status data, compare it against the plan, and adjust targets based on how your body is responding.

**Disclaimer:** This tool is not a substitute for professional coaching or medical advice. Always listen to your body and consult a qualified professional for health or injury concerns.

## Get Started

```bash
git clone https://github.com/cvitan/paicer && cd paicer
```

Open the project in Claude Code and run `/paicer:create-plan` to create a YAML-based training plan through a guided conversation. It handles setup, configuration, and walks you through the process.

After each week of training, run `/paicer:review-progress` to review your plan progress and make any tweaks if needed. The review will also be appended to your plan for future reference.

### Plan output options
- **Markdown**
- **HTML** — set up to print 1 wk/page
- **Garmin** — sync scheduled structured workouts

## Commands

```bash
make markdown               # Generate Markdown
make html                   # Generate HTML (A4 for metric, letter for imperial)
make workouts SCOPE=w7      # Sync week 7 to Garmin
make workouts SCOPE=w7d2    # Sync specific workout
make workouts SCOPE=p2      # Sync entire phase
make test                   # Validate plan
```

## Supported Sports

Running, cycling, swimming (pool and open water), track sessions, and multisport/brick workouts (bike + run with transition tracking). Requires a Garmin watch — multisport needs a compatible model (Fenix, Forerunner 570/970, Enduro).

## Roadmap

1. **Strava activity enrichment**
2. **Zwift Integrations**
3. **Additional Formats** - PDF, iCal, JSON, CSV export
4. **HR-zone fallback for cycling** - generate bike workouts with `heart.rate.zone` targets for users without a power meter (current plans assume one)
5. **Ad-hoc activity data tool** - extend `src/review_data.py` or add `src/activity_data.py` with `--activity-id`, `--latest N`, `--from-date/--to-date` flags so single-activity / cross-week queries don't require throwaway scripts. Expose `get_activity_typed_splits` as the primary intervals fetch.
