Aller au contenu

Les garde-fous (arc_guardrails.py)

La progression d'entraînement est confiée au LLM (l'agent coach). Principale critique adressée aux coachs IA : une progression trop agressive — des blessures ont été rapportées avec des outils comparables. scripts/ arc_guardrails.py est un second avis purement calculé, déterministe et testé, que le coach consulte avant d'écrire une semaine et avant de la pousser au calendrier Garmin — câblage effectif dans agents/coach.md et skills/garmin-workout-scheduling/SKILL.md (#53, voir « Câblage agent » ci-dessous), ce moteur restant lui-même indépendant de ce câblage.

Le plan qui sait dire non

En vidéo · Étape 03 · 1 min 46

Le plan qui sait dire non — Sept garde-fous calculés relisent la semaine avant son écriture et son envoi au calendrier Garmin : un second avis déterministe et testé.

Regarder · English · Toutes les vidéos

Les huit règles

id vérifie sévérité par défaut
r1_acwr_projected ACWR (charge aiguë/chronique) projeté, maximum sur la semaine proposée warn
r2_weekly_volume_jump hausse de la durée (+ distance en road) hebdomadaire planifiée warn
r3_weekly_elevation_jump hausse du D+ hebdomadaire planifié (trail seulement) warn
r4_monotony_projected monotonie de Foster projetée sur la semaine proposée warn
r5_quality_after_red séance de qualité le jour même ou le lendemain d'un verdict santé rouge block
r6_long_run_share part de la plus longue sortie dans le volume hebdomadaire warn
r7_consecutive_quality deux séances de qualité le même jour ou sur deux jours consécutifs warn
r8_session_spike pic de charge d'une séance : sa distance vs la plus longue sortie course des 30 jours précédents warn

Seuils et sévérités : [guardrails] de config/workspace.toml, voir Configuration.

R1 (ACWR) est warn, pas block, par défaut

Voir Sources ci-dessous pour le détail des réserves scientifiques. Remettez severity_r1_acwr_projected = "block" dans [guardrails] si vous préférez la fermeté.

R8 : pic de charge d'une séance

R1 et R6 regardent la semaine ; R8 regarde une séance et complète les deux. D'après Frandsen J.S.B. et al. (dernier auteur Nielsen R.O.), « How much running is too much? Identifying high-risk running sessions in a 5200-person cohort study », Br J Sports Med 2025;59(17):1203-1210, doi 10.1136/bjsports-2024-109380. Selon le résumé de l'article, la cohorte compte 5205 coureurs (âge moyen 45,8 ans, 22 % de femmes), suivis 18 mois avec des données Garmin (588 071 séances).

ratio = distance de la séance / plus longue distance de course des 30 jours précédents

Le jour de la séance est exclu ; la fenêtre est [J-30, J-1] (J-30 inclus, J-31 exclu : choix du projet). Seuls running (route, tapis) et trail comptent, des deux côtés : le trail est inclus parce que l'étude compte toute séance de course enregistrée ; randonnée et marche sont exclues (contrairement à R6), et un vélo n'est ni évalué ni pris comme référence. Hazard ratios de blessure de surcharge rapportés par l'article :

Catégorie Ratio Hazard ratio (IC95)
référence ≤ 1,10 1
faible ]1,10 ; 1,30] 1,64 (1,31–2,05)
modéré ]1,30 ; 2,00] 1,52 (1,16–2,00)
important > 2,00 2,28 (1,50–3,48)

R8 se déclenche dès ratio > 1,10, quelle que soit la catégorie : l'étude conclut que le risque de blessure de surcharge augmente dès +10 %, et la catégorie « faible » a même le hazard ratio ponctuel le plus élevé. Les trois catégories ne forment pas un gradient régulier ; le message n'en suggère aucun (catégorie et hazard ratio exact restent dans le JSON).

  • Plan : R8 évalue chaque séance planifiée de course dont la date est aujourd'hui ou à venir, qui porte une planned_distance_m et sans activité de course déjà réalisée ce jour-là (une séance faite relève de session-spike). Historique = activités réalisées de la fenêtre + séances planifiées encore à venir (lues dans l'index, tous fichiers semaine confondus, y compris quand chaque semaine a son fichier) + séances planifiées antérieures de la même semaine. Le réalisé remplace le plan du même jour ; une séance passée sans activité ne compte pas. warn, jamais bloquante.
  • Plusieurs séances le même jour : chacune est comparée séparément (la « séance unique » de l'étude). Conséquence : la séance du matin ne compte pas dans l'historique de celle du soir, puisque le jour est exclu.
  • Séance sans distance : aucune conclusion, jamais de distance déduite d'une durée (reason_code: "missing_planned_distance").
  • Aucune sortie dans la fenêtre : pas de ratio, « historique insuffisant » (insufficient_history). Aucune séance de course à évaluer : nothing_to_evaluate. Semaine de course : sautée.
  • Séance réalisée : python3 scripts/arc_guardrails.py session-spike --date AAAA-MM-JJ rend en JSON (ou --text) le ratio, la catégorie, le hazard ratio et la FC moyenne de chaque séance de course du jour. La sync quotidienne ajoute un segment à la ligne Alerte : pour une séance nouvellement synchronisée avec un ratio > 1,10 (notification), sans rien écrire.

Limites

Les hazard ratios sont des risques relatifs de groupe, jamais la probabilité qu'un athlète précis se blesse. L'article ne valide que la dimension distance : dénivelé, descente et effort perçu (trail) sont hors périmètre, faute de seuils validés.

Le verdict du matin appliqué à la séance prévue

Le bilan matinal pose un verdict (maintenir, alléger, repos) à partir de la VFC, de la FC de repos et de la readiness. Seul, il ne dit pas quoi faire de la séance du planning : « footing facile au plus » un jour de renforcement laisse l'athlète sans consigne. La commande day-advice lit la séance prévue ce jour-là et rend une action par séance, avec la phrase à afficher :

python3 scripts/arc_guardrails.py day-advice --date 2026-11-15 --verdict amber
Verdict Séance prévue Consigne
Maintenir (vert) toutes maintenue telle que prévue
Alléger (orange) qualité (tempo, seuil, VO2max, course) remplacée par de l'endurance facile
Alléger (orange) renforcement maintenue allégée : effort modéré, ni charge maximale ni pliométrie
Alléger (orange) récupération maintenue
Alléger (orange) endurance, sortie longue, vélo maintenue allégée : effort facile strict, sans dénivelé
Repos (rouge) toutes annulée

La consigne est écrite dans le fichier santé du jour (session_advice), affichée sous le verdict du tableau de bord et reprise dans la notification. Une séance remplacée ou annulée donne en plus une décision « proposée » ; une séance maintenue ou allégée n'en crée pas. La table est une approximation du projet : elle ne change jamais le verdict, elle le traduit sur le planning.

La consigne est un point de départ, pas un ordre. L'athlète reste libre de faire autrement, et peut en discuter avec le coach dans le chat pour l'affiner selon ses sensations ou les contraintes du jour : ce qui est convenu remplace alors la consigne et est tracé comme une décision.

La dérive de charge réalisée

Les règles ci-dessus vérifient ce que le coach prescrit. Une semaine courue au double du plan ne déclenchait rien : l'ACWR peut rester bas quand un gros bloc ancien gonfle la charge chronique. load-drift compare le réalisé de la semaine en cours (course à pied, du lundi au jour même) :

  • au plan de la semaine entière : alerte au-delà de 20 % de dépassement ;
  • à la moyenne des trois semaines précédentes : alerte au-delà de 1,5 fois.

Dans les deux cas le dépassement doit atteindre 3 km (300 m pour le D+), pour ne pas alerter sur le bruit. La sync quotidienne lance la commande quand une séance de course vient d'être synchronisée et ajoute un segment à la ligne Alerte :, par exemple « Dérive de charge : 34,9 km cette semaine pour 17 km prévus (× 2,05) ». Semaine de course : aucune alerte.

python3 scripts/arc_guardrails.py load-drift --today 2026-11-13

Au-delà de la semaine : la projection jusqu'à la course

Avant, après

En vidéo · Étape 17 · 1 min 57

Avant, après — Regarder devant et derrière, sans jamais inventer : forme projetée jusqu'au jour J et affûtage chiffré, pénalité d'altitude du plan de course, ce qui a suivi chaque décision du coach, puis le débrief qui propose des coefficients personnels.

Regarder · English · Toutes les vidéos

Les règles R1/R4 ne regardent que la semaine proposée. Pour voir l'effet d'un plan sur tout le bloc (forme prévue le jour J, semaine de pic de fatigue, ACWR projeté), python3 scripts/arc_index.py load-forecast réutilise exactement la même estimation de charge planifiée (recalée sur le rapport réel / estimé de vos séances passées, ce que R1 ne fait pas) et le même plancher d'historique (84 jours) : voir Forme & charge. Une estimation, jamais une mesure.

Ce qui n'est jamais bloqué

  • Historique réel insuffisant — trois gardes distinctes :
    • moins de 84 jours d'historique réel avant week_start (MIN_HISTORY_DAYS_FOR_PROJECTION, 2× la fenêtre de condition de 42 jours) : R1 est sautée (reason_code: "insufficient_history"), jamais évaluée sur un démarrage à froid du modèle impulsion-réponse de Banister — sans cette garde, un nouvel utilisateur avec 1 à 8 semaines d'historique lirait un ACWR de 3,18 à 1,34 sur une semaine pourtant parfaitement stable ;
    • moins de 14 jours d'historique réel : R4 (monotonie) est sautée — un plancher bien plus court que celui de R1, la fenêtre de monotonie (moyenne/écart-type de charge brute sur 7 jours) n'ayant pas le biais de démarrage à froid d'une moyenne mobile exponentielle ;
    • moins de 4 séances de la famille course dans la semaine proposée : R6 est sautée (reason_code: "too_few_sessions") — avec 3 séances ou moins, la plus longue dépasse presque toujours 35 % par pure construction arithmétique.
  • Référence sans historique de la bonne famille (R2/R3 : la fenêtre de référence n'a aucune activité de la famille course, ex. une semaine 100 % vélo) : sautées avec reason_code: "no_reference".
  • Séance prescrite en distance sans allure récente pour estimer sa durée (R1/R2/R4) : sautées avec reason_code: "missing_planned_duration" — voir Séances prescrites en distance ci-dessous.
  • Semaine de course (date de planning/active_objective.md dans la semaine proposée) : R1, R2, R3, R4, R6, R7 et R8 sont sautées (reason_code: "race_week") — l'objectif est d'éviter une progression trop agressive à l'entraînement, jamais de bloquer la course elle-même. R5 reste active (une alerte santé reste pertinente juste avant une course).
  • Semaine qui SUIT une course (récupération) : R1 ne compare pas l'ACWR projeté au seuil brut, mais à un scénario « repos complet » calculé sur la même semaine (mêmes séances mises à zéro) — elle ne bloque QUE si la semaine proposée aggrave le ratio par rapport à ce repos complet. Sinon, une violation info est quand même rendue (« ACWR déjà élevé [...] la proposition ne l'augmente pas ») pour que le coach voie le chiffre : une fatigue résiduelle de course, seule, ne bloque jamais une semaine de récupération, mais n'est pas non plus passée sous silence.
  • Bilan matinal désactivé ([health].morning_check = "off") : R5 est sautée (reason_code: "health_check_disabled") — aucune donnée de santé n'est de toute façon récupérée dans ce mode.
  • Séances annulées, déplacées ou manquées (status), ou de repos : exclues de toutes les règles.
  • Semaine de récupération (deload) : R2/R3 ne réagissent qu'à une hausse — une baisse de volume ne déclenche jamais rien.
  • Sport hors périmètre d'une règle : R3 (D+) ne s'applique qu'en trail (reason_code: "not_applicable_sport").

Approximation de charge d'une séance planifiée

Une séance planifiée n'a pas de FC : impossible d'y calculer un vrai TRIMP (arc_metrics.trimp_banister). R1/R4 projettent donc une charge à partir de l'intensité prescrite (rest → 0 … race → 10 sur l'échelle RPE 0-10), passée dans exactement la même formule que le repli session-RPE de arc_metrics.session_load, pour rester sur la même échelle que la charge réelle déjà indexée. C'est une approximation d'une approximation, jamais présentée comme mesurée — voir arc_guardrails.ASSUMPTIONS["projected_load"].

Chaque jour de la semaine proposée est apparié séance par séance à une activité réelle déjà indexée (même logique que arc_metrics.week_compliance) : une séance déjà réalisée compte sa charge RÉELLE, une séance encore prévue compte sa charge PROJETÉE — plusieurs séances le même jour sont sommées, jamais l'une écrasant l'autre. Un jour déjà passé (avant --today) sans activité réelle appariée compte 0, jamais la charge projetée : un jour manqué sans donnée ne doit jamais recevoir le bénéfice d'une charge qui n'a peut-être jamais eu lieu.

Séances prescrites en distance

Une séance planifiée seulement en distance (planned_distance_m, sans planned_duration_s — ex. « Sortie longue 25 km / 900 m D+ ») ne compte jamais une durée/charge de zéro : sa durée est estimée depuis l'allure course récente de l'athlète (médiane sur 90 jours, famille course à pied) et l'équivalence D+/plat déjà utilisée pour les prédictions (arc_metrics.TRAIL_FLAT_M_PER_M_DPLUS). Les dates estimées sont exposées dans context.distance_only_sessions_estimated, pour transparence. Sans aucune allure récente disponible, R1/R2/R4 sont sautées plutôt que d'inventer une estimation sans donnée — voir arc_guardrails.ASSUMPTIONS["distance_only_estimate"].

Sources

Chaque règle cite sa source dans son champ source (littérature vérifiable pour R1/R4/R7/R8 — Gabbett 2016, Foster 1998, Seiler & Kjerland 2006, Frandsen et al. 2025 — ou « convention du projet » explicite pour R2/R3/R6, faute de source unique et consensuelle). Le détail complet, avec les citations complètes, est dans scripts/arc_guardrails.py::ASSUMPTIONS.

Réserves scientifiques sur R1 (ACWR)

Les seuils de Gabbett (2016) viennent d'études en sports collectifs (rugby, football australien), avec des moyennes glissantes simples sur 7 jours (aigu) et 28 jours (chronique). Ce moteur utilise le modèle impulsion-réponse de Banister (moyennes mobiles exponentielles 7 j/42 j), une définition mathématiquement différente, jamais validée par les mêmes études — et évaluée au maximum de la semaine proposée plutôt qu'en fin de semaine, pour limiter (sans l'éliminer complètement) un biais de motif hebdomadaire (une longue sortie systématiquement le dimanche gonflerait sinon l'ACWR du seul dernier jour). La preuve elle-même est contestée dans la littérature de course à pied : voir Impellizzeri F.M. et al. (2020), déjà cité dans docs/marques.md (« ACWR : la zone 0,8-1,3 est un repère indicatif [...] discuté dans la littérature »). C'est pourquoi R1 est warn par défaut, pas block.

Pourquoi ces citations sont dans le code, pas dans resources/

resources/ est un dossier privé du workspace de chaque utilisateur (gitignoré, créé par install.sh) : il n'existe pas dans ce dépôt public, et une règle ne peut donc pas y citer un fichier vérifiable. Les sources citées ici sont donc des références de littérature directement dans arc_guardrails.ASSUMPTIONS (même convention que arc_metrics.ASSUMPTIONS déjà dans ce projet), et les règles sans source unique et consensuelle (R2/R3/R6) sont explicitement étiquetées « convention du projet ».

CLI

# Sur un fichier semaine déjà écrit
python3 scripts/arc_guardrails.py check --week planning/2026-09-21_semaine.md

# AVANT d'écrire le fichier (fichier temporaire ou flux stdin, JSON ou Markdown ```arc)
echo '{"week_start": "2026-09-21", "sessions": [...]}' \
  | python3 scripts/arc_guardrails.py check --week -

python3 scripts/arc_guardrails.py check --week /tmp/proposed.json --workspace . --today 2026-09-20

La semaine proposée est validée avant tout calcul : contrat arc_contract (champs requis, types — un planned_duration_s non numérique est rejeté avant de pouvoir faire planter un calcul) et week_start sur un lundi (le moteur suppose partout des semaines Lundi-Dimanche).

Sortie JSON sur stdout. Codes de sortie — un agent en headless doit pouvoir les distinguer sans ambiguïté :

Code Signification
0 ok — aucune violation de sévérité block (des warn/info peuvent exister)
1 au moins une violation de sévérité block
2 erreur (fichier introuvable, semaine non conforme au contrat, date malformée…) — jamais confondu avec 1
{
  "ok": true,
  "violations": [
    {"rule_id": "r1_acwr_projected", "severity": "warn",
     "message": "ACWR projeté (maximum sur la semaine) : 1.42, au-delà du seuil 1.3.",
     "message_en": "Projected ACWR (weekly maximum): 1.42, above the 1.3 threshold.",
     "values": {"observed": 1.42, "threshold": 1.3},
     "session_dates": [], "source": "..."}
  ],
  "checked_rules": ["r1_acwr_projected", "r2_weekly_volume_jump", "..."],
  "skipped_rules": [{"rule_id": "r3_weekly_elevation_jump",
                      "reason_code": "not_applicable_sport",
                      "reason": "R3 ne s'applique qu'en trail ([sport].primary)."}],
  "context": {"week_start": "2026-09-21", "is_race_week": false,
              "acwr_projected": 1.42, "monotony_projected": 1.6,
              "distance_only_sessions_estimated": [], "...": "..."}
}

violations[].rule_id et le format ci-dessus sont repris tels quels par #54 (bloc decision, qui enregistre les rule_id déclenchés — voir « Câblage agent » ci-dessous) et pensés pour #57 (drapeau composite de risque de blessure, qui combine context.acwr_projected/ context.monotony_projected avec d'autres signaux).

Câblage agent (#53)

Le moteur ci-dessus ne fait rien tant que personne ne l'appelle : coach (agents/coach.md, section « GUARDRAILS MANDATE ») et le skill garmin-workout-scheduling lancent check avant d'écrire un fichier semaine et avant tout schedule_workouts/schedule_week, jamais après.

  • ok=false (exit 1, au moins un block), session interactive : un block ne bloque QUE la séance visée — les autres séances de la semaine s'écrivent et se poussent normalement. Pour la séance flaguée, le coach ne l'écrit ni ne la pousse telle quelle : il PROPOSE une alternative sûre (ex. remplacer une séance de qualité par du facile/repos) en une phrase citant le message de la violation, écrit tout de suite une decision outcome: "proposed", et ne pousse (ni n'écrit) l'alternative qu'une fois l'athlète d'accord. Une fois confirmée : la décision devient un NOUVEAU fichier decision (outcome: "applied", supersedes vers le proposed ci-dessus, qui repasse lui-même à outcome: "superseded"). Le style et l'intensité de coaching ([coaching].style/.intensity), et les « Préférences de coaching » du profil de l'athlète, ne changent que le ton de cette phrase — jamais la décision, jamais l'ordre écriture-après- confirmation.
  • ok=false, synchronisation headless (/garmin-daily-sync) : jamais de push ni d'écriture de plan, jamais même une proposition « applied » — seulement une decision outcome: "proposed", datée du jour de la séance flaguée (potentiellement DEMAIN, pas forcément le jour du run). Cette décision fait alors passer la 5e ligne du resume de Alerte : à Pourquoi : (raison de l'ajustement, #56 — l'étape 5 du skill interroge le journal des décisions pour aujourd'hui ET demain) plutôt que de s'y ajouter, et n'apparaît JAMAIS aussi dans la ligne Alerte : — voir skills/garmin-daily-sync/SKILL.md.
  • ok=true avec des warn/info : écriture/push autorisés, la violation est mentionnée brièvement.
  • Exit 2 : entrée invalide — le coach le signale et ne pousse rien ; ce n'est jamais interprété comme un verdict de garde-fou.
  • Traçabilité : toute séance changée, remplacée ou annulée à cause d'une violation (ou du bilan matinal, ou d'une donnée médicale) devient un fichier decision (planning/YYYY-MM-DD_decision_<slug>.md, type decision du contrat de données, détaillé champ par champ dans skills/workspace-data-contract/SKILL.md) — trigger: "guardrail", rule_ids repris tels quels depuis violations[].rule_id, before/after sur la séance concernée. Le fichier semaine n'est réécrit qu'avec le contenu réellement appliqué (jamais la version encore flaguée), et toujours AVANT le fichier decision qui le référence.

Drapeau composite de risque de blessure (#57)

Combine des signaux déjà calculés ailleurs — ACWR/monotonie réels (aucune semaine proposée n'entre ici, contrairement à check ci-dessus), douleur déclarée (health.pain, champ contractuel dédié — voir skills/workspace-data-contract/SKILL.md), et un écart entre l'effort perçu (RPE) et la charge mesurée par FC — en un score déterministe à 3 niveaux. Non-diagnostique : chaque sortie porte un disclaimer obligatoire (« signal de vigilance », jamais « risque de blessure avéré » ni le nom d'une pathologie).

python3 scripts/arc_guardrails.py injury-risk
python3 scripts/arc_guardrails.py injury-risk --today 2026-09-24 --workspace .

Facteurs, seuils et gates

id ce qu'il vérifie seuil par défaut poids si contributeur sauté quand
acwr ACWR réel du jour (mêmes constantes que R1) 1.3 1 historique réel < 84 j, ou condition trop faible
monotony monotonie de Foster réelle, 7 j glissants (mêmes constantes que R4) 2.0 1 historique réel < 14 j, ou fenêtre incomplète
pain douleur maximale déclarée (health.pain[].score), fenêtre glissante de 3 j 4/10 2 aucun fichier santé sur la fenêtre (no_health_file) — un fichier présent sans douleur compte comme une observation (observed: 0), pas un saut
rpe_hr_mismatch ratio (charge sRPE équivalente / charge TRIMP réelle) sur les séances avec FC ET RPE, médiane 14 j vs médiane de référence 90 j +30 % 1 moins de 3 séances avec les deux champs sur l'une des deux fenêtres
sleep_debt dette de sommeil 7 j (#37, réutilise arc_index.sleep_debt_today), exposée en HEURES 10 h cumulées 1 [health].morning_check != "full" (sauté à "minimal" ET à "off", pas seulement à "off")
red_verdict verdict santé rouge aujourd'hui ou hier — fait booléen, observed/threshold valent null — 1 [health].morning_check == "off"

Niveau = somme des poids des facteurs qui contribuent : < 2 faible, 2 à 3 modéré, >= 4 élevé — convention du projet, jamais une classification validée cliniquement. La douleur pèse double : c'est le seul facteur déclaré directement par l'athlète, les autres sont dérivés d'un modèle de charge ou d'une mesure Garmin. Un facteur sauté ne contribue jamais — un signal manquant n'est pas un signal favorable, mais le moteur ne devine jamais une aggravation depuis une absence de donnée ; chaque facteur sauté porte un reason_code explicite.

Douleur sévère : level forcé à high, consult: true

Si pain contribue ET que la douleur observée est >= [injury_risk].pain_consult_threshold (défaut 7/10), le niveau est forcé à high À LUI SEUL — pas besoin d'un second facteur. consult (booléen, toujours présent dans la sortie) vaut alors true, et plus généralement dès que level: "high" ET que pain contribue (même sous ce second seuil, si d'autres facteurs ont déjà porté le niveau à high). agents/medical.md/agents/coach.md recommandent explicitement un avis professionnel dans ce cas — voir « Câblage agent » ci-dessous.

Seuils réglables via [injury_risk] — voir Configuration.

Sortie JSON

{
  "level": "high", "score": 2, "consult": true,
  "factors": [
    {"id": "pain", "observed": 8.0, "threshold": 4.0, "contributes": true,
     "weight": 2, "label": "Douleur déclarée", "location": "genou droit"},
    {"id": "sleep_debt", "observed": 8.5, "threshold": 10.0, "contributes": false,
     "weight": 0, "label": "Dette de sommeil 7 jours"},
    {"id": "red_verdict", "observed": null, "threshold": null, "contributes": false,
     "weight": 0, "label": "Verdict santé rouge aujourd'hui ou hier"},
    {"id": "acwr", "observed": null, "threshold": null, "contributes": false,
     "weight": 0, "reason_code": "insufficient_history",
     "reason": "historique réel trop court (< 84 j)...", "label": "..."}
  ],
  "disclaimer": "Signal de vigilance calculé ... non-diagnostique ...",
  "context": {"today": "2026-09-24", "morning_check": "full"}
}

label est un texte COURT, sans jargon de schéma (jamais un nom de champ contractuel) — c'est ce qu'un agent ou le tableau de bord peuvent citer directement. pain porte en plus location (zone déclarée au score maximal, null si absente) ; sleep_debt est déjà en heures ; red_verdict n'a pas de observed/threshold numériques (un fait booléen n'a rien à comparer à un seuil).

Câblage agent

medical (gatekeeper) et coach lisent ce drapeau — voir la section « INJURY-RISK FLAG » de agents/medical.md/agents/coach.md. medical recommande explicitement un avis professionnel dès que consult: true (voir l'encart ci-dessus) ; ni l'un ni l'autre ne nomme jamais une pathologie précise. Le tableau de bord affiche une tuile compacte sur « Aujourd'hui » dès level >= "moderate" (/api/injury-risk, web/js/app.js::injuryRiskTile).

Sources

acwr/monotony reprennent les mêmes repères que R1/R4 ci-dessus (Gabbett 2016, réserves d'Impellizzeri 2020 ; Foster 1998) — voir Sources. pain_score_threshold (4/10), pain_consult_threshold (7/10 — repère d'échelle numérique de douleur 0-10 courant en clinique pour qualifier une douleur « sévère », pas une valeur calibrée sur ce moteur), la fenêtre de 3 jours, le ratio rpe_hr_mismatch (+30 %) et les poids par facteur sont des conventions du projet : aucune étude publiée ne fixe ces valeurs numériques précises pour un drapeau composite — seuls les principes documentés (charge aiguë/chronique, monotonie de Foster, effort perçu vs réponse cardiaque) le sont.

Pour aller plus loin

Fonction pure au cœur du moteur : evaluate(proposed_week, context, config) -> dict, testée par tests/data/test_arc_guardrails.py (un cas par règle, juste sous/juste au-dessus du seuil, plus les cas limites : historique court, séances le même jour, séances manquées, prescriptions en distance seule, semaine de récupération après une course). build_context(conn, config, gconf, week_start, today) lit l'index dérivé (charge réelle, activités de la semaine, allure récente, semaine(s) précédente(s), dernier verdict santé, objectif actif) — c'est la seule partie du module qui touche à la base SQLite.