@sctg/openclaw-coach 0.1.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +296 -66
- package/assets/fonts/Inter_400Regular.ttf +0 -0
- package/assets/fonts/Inter_600SemiBold.ttf +0 -0
- package/assets/fonts/LICENSE.txt +93 -0
- package/assets/logo.png +0 -0
- package/assets/logo.svg +62 -0
- package/dist/charts/build.d.ts +71 -0
- package/dist/charts/build.js +276 -0
- package/dist/charts/labels.d.ts +38 -0
- package/dist/charts/labels.js +73 -0
- package/dist/charts/render.d.ts +10 -0
- package/dist/charts/render.js +26 -0
- package/dist/charts/svg.d.ts +47 -0
- package/dist/charts/svg.js +92 -0
- package/dist/config.d.ts +25 -0
- package/dist/config.js +38 -0
- package/dist/dates.d.ts +22 -0
- package/dist/dates.js +71 -0
- package/dist/garmin/gc.d.ts +25 -0
- package/dist/garmin/gc.js +81 -0
- package/dist/garmin/normalize.d.ts +20 -0
- package/dist/garmin/normalize.js +132 -0
- package/dist/index.js +188 -163
- package/dist/profile.d.ts +4 -0
- package/dist/profile.js +43 -0
- package/dist/science/associations.d.ts +56 -0
- package/dist/science/associations.js +102 -0
- package/dist/science/healthspan.d.ts +25 -0
- package/dist/science/healthspan.js +89 -0
- package/dist/science/hrv.d.ts +61 -0
- package/dist/science/hrv.js +119 -0
- package/dist/science/load.d.ts +107 -0
- package/dist/science/load.js +228 -0
- package/dist/science/performance.d.ts +93 -0
- package/dist/science/performance.js +191 -0
- package/dist/science/readiness.d.ts +47 -0
- package/dist/science/readiness.js +97 -0
- package/dist/science/recovery.d.ts +74 -0
- package/dist/science/recovery.js +173 -0
- package/dist/science/sleep.d.ts +79 -0
- package/dist/science/sleep.js +165 -0
- package/dist/science/stats.d.ts +50 -0
- package/dist/science/stats.js +201 -0
- package/dist/science/strength.d.ts +47 -0
- package/dist/science/strength.js +120 -0
- package/dist/store.d.ts +36 -0
- package/dist/store.js +78 -0
- package/dist/sync.d.ts +36 -0
- package/dist/sync.js +145 -0
- package/dist/tools.d.ts +427 -0
- package/dist/tools.js +721 -0
- package/dist/types.d.ts +143 -0
- package/dist/types.js +2 -0
- package/docs/SCIENCE.md +717 -0
- package/examples/ATHLETE-fr.md +72 -0
- package/examples/ATHLETE.md +74 -0
- package/examples/PLAN-fr.md +55 -0
- package/examples/PLAN.md +55 -0
- package/openclaw.plugin.json +152 -5
- package/package.json +14 -3
- package/skills/coach/SKILL.md +283 -208
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Profil de l'Athlète
|
|
2
|
+
|
|
3
|
+
<!--
|
|
4
|
+
EXEMPLE. Toutes les valeurs ci-dessous sont fictives : remplacez-les par vos propres informations.
|
|
5
|
+
Copiez ce fichier dans l'espace de travail d'OpenClaw sous le nom ATHLETE.md (voir la README, "Fichiers de l'espace de travail").
|
|
6
|
+
Gardez-le court et à jour : le contenu de ce fichier est envoyé au fournisseur LLM dans chaque session.
|
|
7
|
+
Ne mettez rien ici que vous ne seriez pas prêt à envoyer à ce fournisseur.
|
|
8
|
+
-->
|
|
9
|
+
|
|
10
|
+
## Bio
|
|
11
|
+
|
|
12
|
+
- Année de naissance, sexe : 1978, homme
|
|
13
|
+
- Taille / poids : 178 cm / 72 kg
|
|
14
|
+
- Historique athlétique : course à pied pendant 12 ans (meilleur marathon 3:18, 2019), course en trail pendant
|
|
15
|
+
5 ans. Deux séances de force par semaine depuis 2023.
|
|
16
|
+
|
|
17
|
+
## Points d'ancrage mesurés
|
|
18
|
+
|
|
19
|
+
<!-- Les valeurs mesurées surpassent les estimations. Réglez également ces valeurs dans la configuration du plugin coach (hrMax, lthr). -->
|
|
20
|
+
|
|
21
|
+
- Fréquence cardiaque maximale : 183 bpm, atteinte à la fin d'un test de 5 x 3 min en côte le 2026-03-14
|
|
22
|
+
(bracelet pectoral). La valeur maximale enregistrée par la montre est 181.
|
|
23
|
+
- Fréquence cardiaque / allure au seuil lactique : environ 164 bpm / 4:35 min/km sur le plat, provenant d'un test de 30 minutes
|
|
24
|
+
sur 2026-04-02 (moyenne des 20 dernières minutes). L'estimation de Garmin n'est pas définie.
|
|
25
|
+
- Résultats de courses récents :
|
|
26
|
+
- 10 km route, 44:10, 2026-05-17
|
|
27
|
+
- Semi-marathon, 1:36:40, 2026-09-27
|
|
28
|
+
|
|
29
|
+
## Objectif actuel
|
|
30
|
+
|
|
31
|
+
- Course / événement : Exemple Mountain Trail, 42 km
|
|
32
|
+
- Date : 2027-06-12
|
|
33
|
+
- Distance / dénivelé : 42 km, 2 300 m de dénivelé positif, deux longues descentes techniques
|
|
34
|
+
- Objectif : terminer confortablement sous 7 heures sans aggravation de la douleur. Le temps est secondaire.
|
|
35
|
+
|
|
36
|
+
## Antécédents médicaux et blessures
|
|
37
|
+
|
|
38
|
+
<!-- Une entrée par événement : qu'est-ce que c'était, quand, statut actuel (en récupération / approuvé /
|
|
39
|
+
approuvé avec restrictions), qui l'a approuvé. Cette section est la principale contrainte de sécurité du coach : gardez-la à jour. -->
|
|
40
|
+
|
|
41
|
+
- Tendinopathie du tendon d'Achille droit, 2025-10, traitée avec un chargement progressif. Statut : approuvé avec
|
|
42
|
+
restrictions par le physiothérapeute le 2026-02-20 (restrictions ci-dessous).
|
|
43
|
+
- Asthme induit par l'exercice dans l'enfance, aucun traitement pendant 15 ans. Statut : approuvé.
|
|
44
|
+
- Aucun antécédent cardiaque. Dernier ECG de repos et test d'effort : 2025-03, normal (médecin sportif).
|
|
45
|
+
|
|
46
|
+
## Contraintes actuelles
|
|
47
|
+
|
|
48
|
+
<!-- Tout ce qui est applicable maintenant : "pas de descentes techniques jusqu'à clearance du physio",
|
|
49
|
+
"pas de course les jours consécutifs", médicament qui modifie la fréquence cardiaque
|
|
50
|
+
(beta-blockers...), etc. -->
|
|
51
|
+
|
|
52
|
+
- Pas plus de 3 jours de course consécutifs, et pas de course le jour après une session de descente longue.
|
|
53
|
+
- Descentes techniques (plus de 15 % de pente ou rocheuses) : limitées à 300 m de descente par
|
|
54
|
+
session jusqu'à la révision du physiothérapeute le 2026-12-15. L'escalade n'est pas restreinte.
|
|
55
|
+
- Arrêtez et informez-moi si le tendon d'Achille droit fait mal au repos, le matin, ou au-dessus de 3/10 pendant la course.
|
|
56
|
+
- Pas de médicaments qui affectent la fréquence cardiaque. Deux cafés par jour, aucun après 14:00.
|
|
57
|
+
|
|
58
|
+
## Disponibilité d'entraînement
|
|
59
|
+
|
|
60
|
+
- Jours par semaine : 5 (mardi, jeudi, samedi, dimanche course ; lundi et vendredi force, 45 min).
|
|
61
|
+
- Durée habituelle des séances : 45-70 min en semaine, jusqu'à 3 h 30 le samedi ou dimanche.
|
|
62
|
+
- Terrain et dénivelé : collines et trails à 15 minutes de chez moi (environ 600 m de dénivelé positif sur un circuit de 12 km).
|
|
63
|
+
- Indisponible : semaine du 2026-12-21 (en famille), du 2027-02-08 au 2027-02-12 (voyage d'affaires).
|
|
64
|
+
|
|
65
|
+
## Préférences
|
|
66
|
+
|
|
67
|
+
- Sommeil : besoin d'environ 8 h. Au lit autour de 22:30, levé à 06:30 les jours de semaine, une heure plus tard le week-end.
|
|
68
|
+
Jeune enfant à la maison : certaines nuits perturbées, je le mentionnerai dans le journal.
|
|
69
|
+
- Habitudes à étudier dans le journal : alcool (unités), caféine après 14:00, repas tardif (après 21:00).
|
|
70
|
+
- Style de coaching : direct, court, nombres avec leur référence. Zones de fréquence cardiaque plutôt que d'allure sur
|
|
71
|
+
les trails. Briefing par e-mail chaque matin à 08:00, revue hebdomadaire le dimanche soir.
|
|
72
|
+
- Langue des briefings : français.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Athlete Profile
|
|
2
|
+
|
|
3
|
+
<!--
|
|
4
|
+
EXAMPLE. Every value below is fictional: replace all of it with your own.
|
|
5
|
+
Copy this file to the OpenClaw workspace as ATHLETE.md (see the README, "Workspace files").
|
|
6
|
+
Keep it short and current: the whole file is sent to the LLM provider in every session.
|
|
7
|
+
Do not put anything here you would not accept sending to that provider.
|
|
8
|
+
-->
|
|
9
|
+
|
|
10
|
+
## Bio
|
|
11
|
+
|
|
12
|
+
- Birth year, sex: 1978, male
|
|
13
|
+
- Height / weight: 178 cm / 72 kg
|
|
14
|
+
- Athletic background: road running for 12 years (marathon best 3:18, 2019), trail running for
|
|
15
|
+
5 years. Two strength sessions a week since 2023.
|
|
16
|
+
|
|
17
|
+
## Measured anchors
|
|
18
|
+
|
|
19
|
+
<!-- Measured values beat estimates. Also set them in the coach plugin config (hrMax, lthr). -->
|
|
20
|
+
|
|
21
|
+
- Maximum heart rate: 183 bpm, reached at the end of a 5 x 3 min uphill test on 2026-03-14
|
|
22
|
+
(chest strap). The watch's highest recorded value is 181.
|
|
23
|
+
- Lactate-threshold heart rate / pace: about 164 bpm / 4:35 min/km on the flat, from a 30-minute
|
|
24
|
+
time trial on 2026-04-02 (average of the last 20 minutes). Garmin's own estimate is not set.
|
|
25
|
+
- Recent race results:
|
|
26
|
+
- 10 km road, 44:10, 2026-05-17
|
|
27
|
+
- Half marathon, 1:36:40, 2026-09-27
|
|
28
|
+
|
|
29
|
+
## Current goal
|
|
30
|
+
|
|
31
|
+
- Race / event: Example Mountain Trail, 42 km
|
|
32
|
+
- Date: 2027-06-12
|
|
33
|
+
- Distance / elevation: 42 km, 2,300 m of ascent, two long technical descents
|
|
34
|
+
- Target: finish comfortably under 7 hours without a pain flare-up. Time is secondary.
|
|
35
|
+
|
|
36
|
+
## Injury and medical history
|
|
37
|
+
|
|
38
|
+
<!-- One entry per event: what, when, current status (recovering / cleared /
|
|
39
|
+
cleared with restrictions), who cleared it. This section is the coach's
|
|
40
|
+
primary safety constraint: keep it current. -->
|
|
41
|
+
|
|
42
|
+
- Right Achilles tendinopathy, 2025-10, treated with progressive loading. Status: cleared with
|
|
43
|
+
restrictions by the physiotherapist on 2026-02-20 (restrictions below).
|
|
44
|
+
- Mild exercise-induced asthma in childhood, no treatment for 15 years. Status: cleared.
|
|
45
|
+
- No cardiac history. Last resting ECG and exercise test: 2025-03, normal (sports physician).
|
|
46
|
+
|
|
47
|
+
## Current constraints
|
|
48
|
+
|
|
49
|
+
<!-- Anything actionable now: "no technical descents until physio clearance",
|
|
50
|
+
"no running on consecutive days", medication that changes heart rate
|
|
51
|
+
(beta-blockers...), etc. -->
|
|
52
|
+
|
|
53
|
+
- No more than 3 running days in a row, and no running on the day after a long descent session.
|
|
54
|
+
- Steep or technical descents (more than 15 % grade or rocky): limited to 300 m of descent per
|
|
55
|
+
session until the physiotherapist reviews it on 2026-12-15. Climbing is not restricted.
|
|
56
|
+
- Stop and tell me if the right Achilles hurts at rest, in the morning, or above 3/10 while running.
|
|
57
|
+
- No medication that affects heart rate. Two coffees a day, none after 14:00.
|
|
58
|
+
|
|
59
|
+
## Training availability
|
|
60
|
+
|
|
61
|
+
- Days per week: 5 (Tuesday, Thursday, Saturday, Sunday run; Monday and Friday strength, 45 min).
|
|
62
|
+
- Usual session length: 45-70 min on weekdays, up to 3 h 30 on Saturday or Sunday.
|
|
63
|
+
- Terrain and elevation: hills and trails 15 minutes from home (about 600 m of ascent on a 12 km
|
|
64
|
+
loop). No treadmill. A weekend trip to the mountains about once a month.
|
|
65
|
+
- Unavailable: week of 2026-12-21 (family), 2027-02-08 to 2027-02-12 (work travel).
|
|
66
|
+
|
|
67
|
+
## Preferences
|
|
68
|
+
|
|
69
|
+
- Sleep: need about 8 h. In bed around 22:30, up at 06:30 on weekdays, one hour later on weekends.
|
|
70
|
+
Young child at home: some broken nights, I will say so in the journal.
|
|
71
|
+
- Habits to study in the journal: alcohol (units), caffeine after 14:00, late meal (after 21:00).
|
|
72
|
+
- Coaching style: direct, short, numbers with their reference. Heart-rate zones rather than pace on
|
|
73
|
+
trails. Briefing by e-mail every morning at 08:00, weekly review on Sunday evening.
|
|
74
|
+
- Language of the briefings: French.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Plan d'Entraînement
|
|
2
|
+
|
|
3
|
+
<!--
|
|
4
|
+
EXEMPLE. Toutes les valeurs ci-dessous sont fictives. Copiez ce fichier dans l'espace de travail d'OpenClaw sous le nom PLAN.md
|
|
5
|
+
(voir la README, "Fichiers de l'espace de travail"). Le coach le lit chaque matin et le réécrit lorsque le plan
|
|
6
|
+
change : c'est pourquoi c'est du Markdown simple et non un fichier de données. Gardez le tableau "Prochaines 7 jours"
|
|
7
|
+
à jour ; le coach le transforme en `plan` pour que `coach_training_load` vérifie la projection de charge.
|
|
8
|
+
-->
|
|
9
|
+
|
|
10
|
+
- Dernière mise à jour : 2026-11-16 (revue hebdomadaire)
|
|
11
|
+
- Objectif : Exemple Mountain Trail, 42 km / 2 300 m D+, 2027-06-12 (30 semaines restantes)
|
|
12
|
+
- Phase actuelle : **Base**, semaine 4 sur 8 (volume aérobique, impact repris progressivement)
|
|
13
|
+
- Contraintes en vigueur (depuis ATHLETE.md) : max 300 m de descente par session jusqu'au 2026-12-15, pas
|
|
14
|
+
plus de 3 jours de course consécutifs.
|
|
15
|
+
|
|
16
|
+
## Phases
|
|
17
|
+
|
|
18
|
+
| Phase | Dates | Objectif | Objectif hebdomadaire |
|
|
19
|
+
|---|---|---|---|
|
|
20
|
+
| Base | 2026-10-26 à 2026-12-20 | Volume aérobique, rechargement du tendon, force 2x | 4 h 30 à 6 h, 600 à 1 200 m D+ |
|
|
21
|
+
| Build 1 | 2026-12-28 à 2027-03-07 | Force en escalade, seuil, longues escalades | 6 à 8 h, 1 500 à 2 500 m D+ |
|
|
22
|
+
| Build 2 | 2027-03-08 à 2027-05-02 | Spécificité de course, longues journées, descentes (si autorisées) | 7 à 9 h, 2 000 à 3 000 m D+ |
|
|
23
|
+
| Taper | 2027-05-24 à 2027-06-11 | Volume réduit d'environ la moitié sur 2,5 semaines, garder une certaine intensité | 3 à 5 h |
|
|
24
|
+
| Course | 2027-06-12 | | |
|
|
25
|
+
|
|
26
|
+
Une semaine plus légère (environ 70 % de la précédente) toutes les quatre semaines : la suivante est la semaine 8, débutant le 2026-12-14.
|
|
27
|
+
|
|
28
|
+
## Prochaines 7 jours
|
|
29
|
+
|
|
30
|
+
Les zones sont les zones de fréquence cardiaque de `coach_zones_and_paces` (zone 2 = 70-80 % de max). Le plafond d'aujourd'hui
|
|
31
|
+
provenant de la briefing l'annule toujours.
|
|
32
|
+
|
|
33
|
+
| Date | Jour | Séance | Durée | Zone | Notes |
|
|
34
|
+
|---|---|---|---|---|---|
|
|
35
|
+
| 2026-11-17 | Mar | Course facile, boucle en côte | 55 min | 2 | Marche les parties pentues, pas de descente au-dessus de 300 m |
|
|
36
|
+
| 2026-11-18 | Mer | Repos | | | |
|
|
37
|
+
| 2026-11-19 | Jeu | Course avec 6 x 3 min en zone 4 en montée | 60 min | 2 + 4 | Skip the intervals if the ceiling is "easy" |
|
|
38
|
+
| 2026-11-20 | Ven | Force : jambes et tronc | 45 min | | Levées de mollets, fentes, soulevé de terre monobras |
|
|
39
|
+
| 2026-11-21 | Sam | Course longue en trail | 2 h 15 | 2 | Environ 900 m D+, alimentation toutes les 30 min |
|
|
40
|
+
| 2026-11-22 | Dim | Course facile | 45 min | 1-2 | Plat, terrain souple |
|
|
41
|
+
| 2026-11-23 | Lun | Force : haut du corps et tronc | 45 min | | |
|
|
42
|
+
|
|
43
|
+
## Règles d'ajustement
|
|
44
|
+
|
|
45
|
+
- Plafond "easy" ou "rest" : remplacez la séance par une facile (zone 1-2, moitié de la durée) ou par du repos.
|
|
46
|
+
Ne compenser jamais une séance annulée le jour suivant.
|
|
47
|
+
- Plafond "moderate" : gardez la séance, supprimez les intervalles.
|
|
48
|
+
- Douleur d'Achille au-dessus de 3/10, ou tout symptôme de maladie : arrêtez et signalez-le avant tout autre chose.
|
|
49
|
+
- Si deux séances consécutives sont remplacées, la revue hebdomadaire réduit la semaine suivante au lieu de compenser.
|
|
50
|
+
|
|
51
|
+
## Journal des changements
|
|
52
|
+
|
|
53
|
+
- 2026-11-16 : HRV trend below the personal range for 6 days; replaced Monday's 70-minute run by
|
|
54
|
+
rest, and moved the intervals from Tuesday to Thursday.
|
|
55
|
+
- 2026-11-15 : Week 3 completed as planned (5 h 10, 740 m D+).
|
package/examples/PLAN.md
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Training Plan
|
|
2
|
+
|
|
3
|
+
<!--
|
|
4
|
+
EXAMPLE. Every value below is fictional. Copy this file to the OpenClaw workspace as PLAN.md
|
|
5
|
+
(see the README, "Workspace files"). The coach reads it every morning and rewrites it when the plan
|
|
6
|
+
changes: that is why it is plain Markdown and not a data file. Keep the "Next 7 days" table
|
|
7
|
+
current; the coach turns it into a `plan` for `coach_training_load` to check the load projection.
|
|
8
|
+
-->
|
|
9
|
+
|
|
10
|
+
- Last updated: 2026-11-16 (weekly review)
|
|
11
|
+
- Goal: Example Mountain Trail, 42 km / 2,300 m D+, 2027-06-12 (30 weeks away)
|
|
12
|
+
- Current phase: **Base**, week 4 of 8 (aerobic volume, impact returned step by step)
|
|
13
|
+
- Constraints in force (from ATHLETE.md): max 300 m of descent per session until 2026-12-15, no
|
|
14
|
+
more than 3 running days in a row.
|
|
15
|
+
|
|
16
|
+
## Phases
|
|
17
|
+
|
|
18
|
+
| Phase | Dates | Purpose | Weekly target |
|
|
19
|
+
|---|---|---|---|
|
|
20
|
+
| Base | 2026-10-26 to 2026-12-20 | Aerobic volume, tendon reloading, strength 2x | 4 h 30 to 6 h, 600 to 1,200 m D+ |
|
|
21
|
+
| Build 1 | 2026-12-28 to 2027-03-07 | Climbing strength, threshold, long climbs | 6 to 8 h, 1,500 to 2,500 m D+ |
|
|
22
|
+
| Build 2 | 2027-03-08 to 2027-05-02 | Race specificity, long days, descents (if cleared) | 7 to 9 h, 2,000 to 3,000 m D+ |
|
|
23
|
+
| Taper | 2027-05-24 to 2027-06-11 | Volume down by about half over 2.5 weeks, keep some intensity | 3 to 5 h |
|
|
24
|
+
| Race | 2027-06-12 | | |
|
|
25
|
+
|
|
26
|
+
A lighter week (about 70 % of the previous one) every fourth week: the next one is week 8, starting 2026-12-14.
|
|
27
|
+
|
|
28
|
+
## Next 7 days
|
|
29
|
+
|
|
30
|
+
Zones are the heart-rate zones from `coach_zones_and_paces` (zone 2 = 70-80 % of max). Today's ceiling
|
|
31
|
+
from the briefing always overrides this table.
|
|
32
|
+
|
|
33
|
+
| Date | Day | Session | Duration | Zone | Notes |
|
|
34
|
+
|---|---|---|---|---|---|
|
|
35
|
+
| 2026-11-17 | Tue | Easy run, hilly loop | 55 min | 2 | Walk the steep parts, no descent above 300 m |
|
|
36
|
+
| 2026-11-18 | Wed | Rest | | | |
|
|
37
|
+
| 2026-11-19 | Thu | Run with 6 x 3 min at zone 4 uphill | 60 min | 2 + 4 | Skip the intervals if the ceiling is "easy" |
|
|
38
|
+
| 2026-11-20 | Fri | Strength: legs and core | 45 min | | Calf raises, split squats, single-leg deadlift |
|
|
39
|
+
| 2026-11-21 | Sat | Long trail run | 2 h 15 | 2 | About 900 m D+, fuel every 30 min |
|
|
40
|
+
| 2026-11-22 | Sun | Easy run | 45 min | 1-2 | Flat, soft ground |
|
|
41
|
+
| 2026-11-23 | Mon | Strength: upper body and core | 45 min | | |
|
|
42
|
+
|
|
43
|
+
## Rules of adjustment
|
|
44
|
+
|
|
45
|
+
- Ceiling "easy" or "rest": replace the session by an easy one (zone 1-2, half the duration) or rest.
|
|
46
|
+
Never make up a skipped session the next day.
|
|
47
|
+
- Ceiling "moderate": keep the session, drop the intervals.
|
|
48
|
+
- Achilles pain above 3/10, or any symptom of illness: stop and report it before anything else.
|
|
49
|
+
- If two sessions in a row are replaced, the weekly review reduces the next week instead of catching up.
|
|
50
|
+
|
|
51
|
+
## Log of changes
|
|
52
|
+
|
|
53
|
+
- 2026-11-16: HRV trend below the personal range for 6 days; replaced Monday's 70-minute run by
|
|
54
|
+
rest, and moved the intervals from Tuesday to Thursday.
|
|
55
|
+
- 2026-11-15: Week 3 completed as planned (5 h 10, 740 m D+).
|
package/openclaw.plugin.json
CHANGED
|
@@ -1,17 +1,41 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "coach",
|
|
3
3
|
"name": "AI Coach",
|
|
4
|
-
"description": "Endurance
|
|
4
|
+
"description": "Endurance and recovery coach: documented physiological models (HRV baseline, recovery, sleep, training load, early warning) computed on Garmin Connect data via garmin-cli's gc CLI.",
|
|
5
5
|
"requiresPlugins": [],
|
|
6
|
-
"skills": [
|
|
6
|
+
"skills": [
|
|
7
|
+
"skills/coach"
|
|
8
|
+
],
|
|
7
9
|
"activation": {
|
|
8
10
|
"onStartup": true
|
|
9
11
|
},
|
|
10
12
|
"contracts": {
|
|
11
|
-
"tools": [
|
|
13
|
+
"tools": [
|
|
14
|
+
"coach_daily_briefing",
|
|
15
|
+
"coach_trends",
|
|
16
|
+
"coach_training_load",
|
|
17
|
+
"coach_activity_deep_dive",
|
|
18
|
+
"coach_zones_and_paces",
|
|
19
|
+
"coach_strength_analysis",
|
|
20
|
+
"coach_journal_log",
|
|
21
|
+
"coach_journal_insights",
|
|
22
|
+
"coach_workout_push",
|
|
23
|
+
"coach_briefing_charts",
|
|
24
|
+
"coach_data_status"
|
|
25
|
+
]
|
|
12
26
|
},
|
|
13
27
|
"toolMetadata": {
|
|
14
|
-
"
|
|
28
|
+
"coach_daily_briefing": {
|
|
29
|
+
"optional": false,
|
|
30
|
+
"sideEffecting": false,
|
|
31
|
+
"replaySafe": true
|
|
32
|
+
},
|
|
33
|
+
"coach_trends": {
|
|
34
|
+
"optional": false,
|
|
35
|
+
"sideEffecting": false,
|
|
36
|
+
"replaySafe": true
|
|
37
|
+
},
|
|
38
|
+
"coach_training_load": {
|
|
15
39
|
"optional": false,
|
|
16
40
|
"sideEffecting": false,
|
|
17
41
|
"replaySafe": true
|
|
@@ -20,6 +44,41 @@
|
|
|
20
44
|
"optional": false,
|
|
21
45
|
"sideEffecting": false,
|
|
22
46
|
"replaySafe": true
|
|
47
|
+
},
|
|
48
|
+
"coach_zones_and_paces": {
|
|
49
|
+
"optional": false,
|
|
50
|
+
"sideEffecting": false,
|
|
51
|
+
"replaySafe": true
|
|
52
|
+
},
|
|
53
|
+
"coach_strength_analysis": {
|
|
54
|
+
"optional": false,
|
|
55
|
+
"sideEffecting": false,
|
|
56
|
+
"replaySafe": true
|
|
57
|
+
},
|
|
58
|
+
"coach_journal_log": {
|
|
59
|
+
"optional": false,
|
|
60
|
+
"sideEffecting": true,
|
|
61
|
+
"replaySafe": false
|
|
62
|
+
},
|
|
63
|
+
"coach_journal_insights": {
|
|
64
|
+
"optional": false,
|
|
65
|
+
"sideEffecting": false,
|
|
66
|
+
"replaySafe": true
|
|
67
|
+
},
|
|
68
|
+
"coach_workout_push": {
|
|
69
|
+
"optional": false,
|
|
70
|
+
"sideEffecting": true,
|
|
71
|
+
"replaySafe": false
|
|
72
|
+
},
|
|
73
|
+
"coach_briefing_charts": {
|
|
74
|
+
"optional": false,
|
|
75
|
+
"sideEffecting": true,
|
|
76
|
+
"replaySafe": true
|
|
77
|
+
},
|
|
78
|
+
"coach_data_status": {
|
|
79
|
+
"optional": false,
|
|
80
|
+
"sideEffecting": false,
|
|
81
|
+
"replaySafe": true
|
|
23
82
|
}
|
|
24
83
|
},
|
|
25
84
|
"configSchema": {
|
|
@@ -28,7 +87,95 @@
|
|
|
28
87
|
"properties": {
|
|
29
88
|
"gcBinary": {
|
|
30
89
|
"type": "string",
|
|
31
|
-
"description": "Path to the garmin-cli `gc` binary. Defaults to \"gc\" (resolved from PATH)."
|
|
90
|
+
"description": "Path to the garmin-cli `gc` binary (>= 0.4.0). Defaults to \"gc\" (resolved from PATH)."
|
|
91
|
+
},
|
|
92
|
+
"timezone": {
|
|
93
|
+
"type": "string",
|
|
94
|
+
"description": "IANA timezone of the athlete, used for day boundaries (e.g. Europe/Paris). Defaults to the Gateway timezone."
|
|
95
|
+
},
|
|
96
|
+
"dataDir": {
|
|
97
|
+
"type": "string",
|
|
98
|
+
"description": "Directory of the local store (nightly aggregates, activities, journal). Defaults to ~/.openclaw/coach."
|
|
99
|
+
},
|
|
100
|
+
"historyDays": {
|
|
101
|
+
"type": "integer",
|
|
102
|
+
"minimum": 30,
|
|
103
|
+
"maximum": 365,
|
|
104
|
+
"description": "Days of recovery history kept in sync. Default 90."
|
|
105
|
+
},
|
|
106
|
+
"loadHistoryDays": {
|
|
107
|
+
"type": "integer",
|
|
108
|
+
"minimum": 42,
|
|
109
|
+
"maximum": 365,
|
|
110
|
+
"description": "Days of activities used by the training-load model. Default 180."
|
|
111
|
+
},
|
|
112
|
+
"retentionDays": {
|
|
113
|
+
"type": "integer",
|
|
114
|
+
"minimum": 90,
|
|
115
|
+
"maximum": 3650,
|
|
116
|
+
"description": "Stored data older than this is deleted. Default 730."
|
|
117
|
+
},
|
|
118
|
+
"cacheMinutes": {
|
|
119
|
+
"type": "integer",
|
|
120
|
+
"minimum": 0,
|
|
121
|
+
"maximum": 1440,
|
|
122
|
+
"description": "Minimum delay between two Garmin fetches of recent days. Default 15."
|
|
123
|
+
},
|
|
124
|
+
"sex": {
|
|
125
|
+
"type": "string",
|
|
126
|
+
"enum": [
|
|
127
|
+
"male",
|
|
128
|
+
"female"
|
|
129
|
+
],
|
|
130
|
+
"description": "Used for the training-load (TRIMP) coefficients."
|
|
131
|
+
},
|
|
132
|
+
"birthYear": {
|
|
133
|
+
"type": "integer",
|
|
134
|
+
"minimum": 1920,
|
|
135
|
+
"maximum": 2020,
|
|
136
|
+
"description": "Used only to estimate maximum heart rate when none is measured."
|
|
137
|
+
},
|
|
138
|
+
"hrMax": {
|
|
139
|
+
"type": "integer",
|
|
140
|
+
"minimum": 120,
|
|
141
|
+
"maximum": 230,
|
|
142
|
+
"description": "Measured maximum heart rate (bpm). Strongly recommended."
|
|
143
|
+
},
|
|
144
|
+
"hrRest": {
|
|
145
|
+
"type": "integer",
|
|
146
|
+
"minimum": 25,
|
|
147
|
+
"maximum": 100,
|
|
148
|
+
"description": "Resting heart rate (bpm). Defaults to the 60-day median measured by the watch."
|
|
149
|
+
},
|
|
150
|
+
"lthr": {
|
|
151
|
+
"type": "integer",
|
|
152
|
+
"minimum": 100,
|
|
153
|
+
"maximum": 210,
|
|
154
|
+
"description": "Lactate-threshold heart rate (bpm). Defaults to Garmin's estimate."
|
|
155
|
+
},
|
|
156
|
+
"sleepNeedHours": {
|
|
157
|
+
"type": "number",
|
|
158
|
+
"minimum": 6,
|
|
159
|
+
"maximum": 10,
|
|
160
|
+
"description": "Personal sleep need used when Garmin does not report one. Default 8."
|
|
161
|
+
},
|
|
162
|
+
"hrZoneFloorsPctMax": {
|
|
163
|
+
"type": "array",
|
|
164
|
+
"items": {
|
|
165
|
+
"type": "number"
|
|
166
|
+
},
|
|
167
|
+
"minItems": 5,
|
|
168
|
+
"maxItems": 5,
|
|
169
|
+
"description": "Lower bound of heart-rate zones 1-5 in percent of maximum heart rate. Default [50,60,70,80,90]."
|
|
170
|
+
},
|
|
171
|
+
"language": {
|
|
172
|
+
"type": "string",
|
|
173
|
+
"enum": ["en", "fr"],
|
|
174
|
+
"description": "Language of the labels drawn in charts (coach_briefing_charts). Default en."
|
|
175
|
+
},
|
|
176
|
+
"allowWorkoutPush": {
|
|
177
|
+
"type": "boolean",
|
|
178
|
+
"description": "Allow coach_workout_push to create workouts in Garmin Connect (after explicit confirmation). Default false."
|
|
32
179
|
}
|
|
33
180
|
}
|
|
34
181
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sctg/openclaw-coach",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "AI endurance coach plugin for OpenClaw:
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "AI endurance and recovery coach plugin for OpenClaw: documented physiological models (HRV baseline, recovery, sleep, training load, early warning) computed on Garmin Connect data via garmin-cli, with a coaching skill.",
|
|
5
|
+
"icon": "assets/logo.png",
|
|
5
6
|
"type": "module",
|
|
6
7
|
"license": "MIT",
|
|
7
8
|
"author": "Ronan LE MEILLAT",
|
|
@@ -14,18 +15,26 @@
|
|
|
14
15
|
"files": [
|
|
15
16
|
"dist",
|
|
16
17
|
"skills",
|
|
18
|
+
"docs",
|
|
19
|
+
"examples",
|
|
20
|
+
"assets",
|
|
21
|
+
"!assets/logo.ai",
|
|
17
22
|
"openclaw.plugin.json",
|
|
18
23
|
"README.md",
|
|
19
24
|
"LICENSE"
|
|
20
25
|
],
|
|
21
26
|
"scripts": {
|
|
22
27
|
"build": "tsc",
|
|
28
|
+
"typecheck": "tsc --noEmit -p tsconfig.test.json",
|
|
29
|
+
"test": "node --test \"test/*.test.ts\"",
|
|
23
30
|
"prepublishOnly": "npm run build"
|
|
24
31
|
},
|
|
25
32
|
"dependencies": {
|
|
33
|
+
"@resvg/resvg-js": "2.6.2",
|
|
26
34
|
"typebox": "1.3.17"
|
|
27
35
|
},
|
|
28
36
|
"devDependencies": {
|
|
37
|
+
"@types/node": "^22.20.3",
|
|
29
38
|
"openclaw": ">=2026.8.2",
|
|
30
39
|
"typescript": "^5.9.0"
|
|
31
40
|
},
|
|
@@ -33,7 +42,9 @@
|
|
|
33
42
|
"openclaw": ">=2026.8.2"
|
|
34
43
|
},
|
|
35
44
|
"openclaw": {
|
|
36
|
-
"extensions": [
|
|
45
|
+
"extensions": [
|
|
46
|
+
"./dist/index.js"
|
|
47
|
+
],
|
|
37
48
|
"compat": {
|
|
38
49
|
"pluginApi": ">=2026.8.2",
|
|
39
50
|
"minGatewayVersion": "2026.8.2"
|