coach-ios/docs/watch-plan-origin-runbook-mac.md

Runbook Mac — le build qui rend l'envoi vérifiable

Écrit le 03/09/2026, à suivre sur le Mac mini. Compte 20 minutes, dont la moitié d'attente. Ce build ne change rien à ce que la montre reçoit : il rend l'app capable de dire ce qu'elle a fait, ce qu'elle ne savait pas faire.

Le dossier complet — deux épisodes de « la montre ne dit plus rien », leur chronologie et ce qu'elle élimine — est dans coach_sportif, docs/GUIDE-MONTRE.md §5quater et §5quinquies. Ici : les gestes.

Ce qui change

Deux fichiers, déjà déclarés dans la target App — donc rien à ajouter dans Xcode, pas de Target Membership à cocher, pas de nouveau framework à lier (WorkoutKit était déjà importé par CoachWorkoutKit.swift) :

• ios/App/App/CoachWorkoutKit.swift
• ios/App/App/CoachWorkoutObserver.swift

Branche : feat/watch-outdoor. Le côté serveur est déjà en prod, il attend juste que l'app l'appelle.

1. Récupérer et compiler

cd ~/coach-ios          # ou l'emplacement du clone sur le Mac
git checkout feat/watch-outdoor
git pull
npx cap sync ios
open ios/App/App.xcworkspace

Dans Xcode : cible App, ton iPhone connecté, ▶︎. Rien d'autre à toucher.

⚠️ Ce code n'a jamais été compilé — WorkoutKit et HealthKit n'existent pas dans Swift pour Linux, et tests-linux/ ne couvre que ce qui n'importe que Foundation. Les signatures Apple ont été vérifiées une par une dans la doc DocC avant d'être écrites, mais si quelque chose casse, c'est là que ça cassera :

symptôme	où regarder
value of type 'HKWorkout' has no member 'workoutPlan'	l'extension vient de WorkoutKit : vérifier que import WorkoutKit est bien pris (il est sous #if canImport)
erreur sur case .custom(let custom)	WorkoutPlan.workout est l'enum WorkoutPlan.Workout — cas custom, goal, pacer, swimBikeRun
erreur de conversion sur sw.date	c'est un DateComponents, pas une Date — d'où le Calendar.current.date(from:)

2. Vérifier sans courir (2 minutes, dans le canapé)

1. Ouvre Programme, la séance du jour, et appuie sur l'envoi Apple Watch. Le message doit maintenant nommer la séance programmée : « Programmée sur la montre : CDC · … ».

   • S'il dit « la montre ne la liste pas encore » : le scheduler n'a pas encore publié — regarde Exercice → Programmées au poignet avant de conclure.
   • S'il dit « Autorisation « Séances programmées » absente » : c'est la réponse au silence. Réglages iPhone → coach → autoriser, puis renvoyer. C'est exactement ce qu'une réinstallation de l'app remet à zéro, et l'ancienne version affichait « Envoyé » quand même.

2. Console Xcode (facultatif), filtre CoachWorkoutKit : schedule OK, authorizationState.

3. Après ta prochaine séance

Le plugin remonte tout seul, en fin de séance, si elle venait de la séance programmée ou d'un départ à la main. Pour le lire :

# sur nexus, là où vivent les données (node n'y est pas installé)
venv/bin/python3 tools/watch_alert_check.py <AAAA-MM-JJ> --dump /tmp/wac.json
# puis en local, là où node existe
python3 tools/watch_alert_check.py --from /tmp/wac.json

Trois réponses possibles, et une seule était disponible jusqu'ici :

• « Séance lancée depuis la séance programmée » → les alertes comptées étaient bien dues. Si tu n'as rien entendu, le défaut est ailleurs que dans l'envoi et le lancement.
• « Séance lancée À LA MAIN » → aucune alerte n'était possible, le silence est normal. C'est le cas que rien ne savait détecter, et qui devient plausible depuis que la Polar est la montre de sport.
• « Origine inconnue » → séance antérieure au build, ou lecture en échec. Ce n'est pas un « non » : l'app préfère se taire qu'affirmer à tort.