# Handoff — Chantier watchOS Live Workout

**Pour** : Claude Code lancé sur le Mac mini Sylvain (`cd ~/coach-ios && claude`).
**De** : Claude Code session Linux du 2026-05-24 (sandbox sans Xcode).
**Pourquoi le handoff** : la phase native Swift/watchOS nécessite Xcode +
Apple Watch device, indispo sur le sandbox Linux.

## Première chose à faire avant de coder

1. **Lis** `coach-ios/CLAUDE.md` (règles projet).
2. **Lis** `coach-ios/docs/watchos-live-workout-plan.md` (plan technique complet).
3. **Vérifie** que tu es bien sur le Mac mini avec Xcode 16+ : `xcodebuild -version`.
4. **Vérifie** que `coach-ios` est à jour : `git pull` (les commits préparatoires
   sont déjà poussés sur `main`).

## Contexte session Linux (2026-05-24)

Sylvain a confirmé vouloir attaquer le chantier watchOS Live Workout
(memory `project_coach_watchos_live.md`). On a estimé ensemble qu'écrire
du Swift à l'aveugle depuis le sandbox Linux était risqué (training data
peut diverger des dernières APIs Apple, pas de compile Xcode pour valider).

D'où ce handoff : toute la phase native (Phases 1-3 du plan) doit être
exécutée par toi sur le Mac avec lecture des docs Apple en direct.

Memories à charger pour contexte complet (probablement déjà dans `~/.claude/projects/-home-coder/memory/` synchronisé via Gitea ou autre, sinon
demande à Sylvain de te briefer) :

- `project_coach_watchos_live.md` — chantier original
- `project_coach_ios.md` — état wrapper Capacitor
- `project_coach_app_commercial.md` — pivot commercial (le watchOS live est un
  différenciateur clé pour vendre à 39 ou 99 CHF/mois)
- `user_sante_cardio.md` — FCmax Sylvain 145-155 bpm (à respecter dans tests)
- `feedback_inline_display_none_toggle.md` — règle apprise hier : grep JS avant
  de migrer du `style="display:none"` initial vers du CSS

## État actuel à ton arrivée

```
coach-ios/
├── CLAUDE.md ............. Règles projet (à jour)
├── HANDOFF-WATCHOS.md .... Ce fichier
├── docs/
│   └── watchos-live-workout-plan.md ... Plan technique complet
├── ios/App/App/
│   ├── AppDelegate.swift .......... Bootstrap + cookie inject (NE PAS CASSER)
│   ├── MainViewController.swift ... WKWebView config
│   ├── CoachHealthRoute.swift ..... HealthKit web bridge existant
│   ├── CoachWorkoutKit.swift ...... HKWorkoutPlan push (iOS 17+)
│   └── CoachWorkoutObserver.swift . Observer fin de séance
└── ios/App/App.xcodeproj ......... Projet Xcode (PAS de target watchOS encore)
```

**Aucun fichier Swift watchOS écrit pour l'instant** — décision conjointe :
tu écris depuis zéro après avoir lu les docs Apple à jour.

## Workflow recommandé sur ton Mac

### Step 1 — Setup environnement (30 min)

```bash
cd ~/coach-ios
git pull origin main
xcodebuild -version          # Xcode 16+ requis (watchOS 11+ SDK)
xcrun simctl list devicetypes | grep Watch  # voir simulateurs watchOS dispo
```

Vérifie aussi que ton Apple Watch est jumelée à l'iPhone et tournée vers
watchOS 11+ (cf. About sur la Watch).

### Step 2 — Création de la target watchOS (1-2h)

**2 voies possibles** :

**Voie A — Manuelle dans Xcode UI** (recommandée pour la 1ère fois) :
1. Ouvre `ios/App/App.xcworkspace`
2. `File > New > Target...` → watchOS → App
3. Suis le plan section "Phase 1.1" du fichier `docs/watchos-live-workout-plan.md`
4. Commit le diff sur `project.pbxproj`

**Voie B — Édition pbxproj directe** (si tu veux être 100% reproducible) :
- Édite `ios/App/App.xcodeproj/project.pbxproj` à la main
- Risque : format propriétaire Xcode, fragile. À éviter sauf si Voie A
  bloquée.

### Step 3 — Lecture des docs Apple à jour (45 min)

Avant de coder, lis ces 4 pages doc Apple **dans ton browser** ou via
`mcp__claude_ai_*` si tu as un MCP fetch dispo :

1. `developer.apple.com/documentation/healthkit/hkliveworkoutbuilder`
2. `developer.apple.com/documentation/watchconnectivity/wcsession`
3. `developer.apple.com/documentation/healthkit/hkworkoutsession`
4. `capacitorjs.com/docs/plugins/creating-plugins/ios-guide`

Note les **signatures exactes** qui peuvent avoir changé. Le plan technique
du fichier `docs/watchos-live-workout-plan.md` contient du pseudocode qui
peut être périmé sur des détails (par exemple async/await sur certaines
méthodes en watchOS 11+).

### Step 4 — Implémentation Swift (6-8h sur 1-2 jours)

Suis les Phases 2 et 3 du plan technique. Commit petit par petit :

- Commit 1 : `CoachWatchApp.swift` + `ContentView.swift` minimal
  (juste affichage statique, vérifie que la target builde sur simulator).
- Commit 2 : `WorkoutManager.swift` (HKLiveWorkoutBuilder seul, sans
  Connectivity). Vérifie sur Apple Watch device que les samples HR arrivent.
- Commit 3 : `ConnectivityManager.swift` (WCSession). Test envoi simple.
- Commit 4 : `CoachLiveBridge.swift` côté iPhone (Capacitor plugin).
- Commit 5 : Tests + fixes itératifs.

Règle clé : **chaque commit doit compiler** (Watch + iPhone targets).

### Step 5 — Route web `/live` + template

Cette partie peut être faite par toi OU déléguée à une session Claude Code
sur le repo `coach_sportif/` (Linux Linux sandbox d'origine). Le code FastAPI
+ Jinja est trivial une fois le plugin Capacitor publie l'event JS
`liveSample`.

Si tu veux le faire toi-même sur Mac : Phase 4 du plan technique a le
squelette prêt à coller.

### Step 6 — Tests device + TestFlight internal (4-8h)

- Test E2E : lance app CoachWatch sur Apple Watch → choisis activité
  Course → vérifie /live sur iPhone affiche le BPM en moins de 10 sec.
- Test fallback : Bluetooth off pendant 30 sec, vérifie que les samples
  arrivent quand BLE revient.
- Test batterie : 1h de workout, vérifier % drop sur Watch (cible <15%).
- Upload TestFlight internal (juste pour Sylvain) avant la 1ère review
  publique.

## Garde-fous communs à respecter (depuis les memories)

1. **Pas d'extrapolation** : si une API Apple n'est pas vérifiée dans la doc
   live, **ne pas l'inventer**. Préfère commenter "TODO: vérifier signature"
   et demander à Sylvain.
2. **Default yes** : décide et exécute sauf actions destructives (push force,
   delete entitlements, etc.).
3. **Git push après chaque commit** atomique qui compile.
4. **descriptions Info.plist en FR** (App Store FR).
5. **`raise X from e`** ou `from None` côté Python (B904 fixé ce matin,
   préserver la norme).
6. **Tests à chaque feature** ; pas de merge sans test minimum.
7. **CLAUDE.md à jour** : si tu décides quelque chose qui change l'archi
   (ex : passer à Live Activity au lieu de webview /live), document-le.

## Quand revenir vers la session Linux

Le repo `coach_sportif/` (Linux sandbox source) reste mon terrain :

- Backend FastAPI (route `/live`, helpers)
- Template Jinja (`live_workout.html`)
- Tests pytest backend
- Refactor CSS / scope global

Quand tu finis le plugin Capacitor `CoachLiveBridge` et que tu as besoin
de la route `/live` côté serveur, soit tu la code toi-même (Phase 4), soit
tu demandes à Sylvain de relancer la session Linux pour que je l'écrive.

## Référence "qui possède quoi" pendant le chantier

| Composant | Owner | Notes |
|---|---|---|
| `coach-ios/ios/App/App/Coach*Watch.swift` | Toi (Mac) | Swift natif iOS |
| `coach-ios/watch/CoachWatch/*.swift` | Toi (Mac) | Swift natif watchOS |
| `coach-ios/ios/App/App/CoachLiveBridge.swift` | Toi (Mac) | Plugin Capacitor iOS |
| `coach-ios/project.pbxproj` | Toi (Mac) | Édition prudente |
| `coach_sportif/web/routers/misc.py` route /live | Moi (Linux) ou toi | Trivial |
| `coach_sportif/web/templates/live_workout.html` | Moi (Linux) ou toi | Squelette dans plan |
| `coach_sportif/web/static/style.css` ajouts .live-* | Moi (Linux) | Si je fais le template |
| Tests pytest backend | Moi (Linux) | |
| Tests Xcode XCTest | Toi (Mac) | |

## Bon courage

Quand tu auras fini : commit final qui résume l'état + ferme ce chantier
dans la memory (`project_coach_watchos_live.md` à update). Et appelle
Sylvain pour test device. 🚀