Skip to content

fix(docs,#18982): 4 README QC alignés sur le code et le catalogue - #18989

Merged
myia-ai-01 merged 1 commit into
mainfrom
fix/18982-qc-readme-contradictions
Oct 3, 2026
Merged

myia-ai-01 merged 1 commit into
mainfrom
fix/18982-qc-readme-contradictions

Conversation

@jsboige

@jsboige jsboige commented Oct 3, 2026

Copy link
Copy Markdown
Owner

Grain: LIGHT/readme -- lane myia-po-2024:CoursIA-2 -- prev: MED/lean #18975

Résumé

4 README du chapitre 06 HandsOn contredisaient soit le code source main.py, soit la mesure catalogue post-#1630/#2801. Toutes les corrections sont groundées firsthand (Tell c.4 strict fondateur) : 3 sources par projet = lecture main.py + lecture catalogue + lecture d'autres README déjà alignés. Aucun compteur en prose ajoutée (Tell c.9377 strict) : toute référence quantitative pointe vers docs/qc/qc-strategies-status.md (catalogue régénéré mécaniquement, pas tenu à la main).

Fichiers modifiés (4)

Fichier Type d'erreur Source de vérité
ML-Reversion-Trending/README.md Sharpe/CAGR/MaxDD obsolètes (pré-#1630) catalogue l.234/l.762
ML-FX-SVM-Wavelet/README.md 4 paires FX erronnées (4 noms inventés) main.py l.153
Dividend-Harvesting-ML/README.md rebalance trimestrielle/10 actions (≠ code) main.py l.37 (month_start) + l.48 (universe_size=100)
Positive-Negative-Splits-ML/README.en.md features erronnées (earnings au lieu de split) + chiffres stale main.py l.17-22 (docstring explicite) + catalogue l.460

Détail des corrections

ML-Reversion-Trending

  • Sharpe Ratio 0.375 → 0.571
  • CAGR 8.44% → 10.51%
  • Max Drawdown 24.4% → 19.6%
    • ligne Fenêtre backtest pointant vers catalogue

ML-FX-SVM-Wavelet

  • Paires : EURUSD, AUDUSD, USDJPY, USDCAD → EURJPY, GBPUSD, AUDCAD, NZDCHF (vérifié main.py l.153)

Dividend-Harvesting-ML

  • Description : "Achète trimestriellement les 10 actions à dividendes élevés les mieux prédites" → "Univers filtré dans QQQ (ETF Nasdaq-100), rééquilibrage mensuel sur les 100 meilleures positions"
  • Table : Rebalancement Trimestriel → Mensuel

Positive-Negative-Splits-ML (EN)

Conformité règles

  • Tell c.4 strict fondateur : 3 sources firsthand par projet (main.py + catalogue + autres README alignés).
  • Tell c.9377 strict : aucun compteur en prose, toutes les références pointent vers le catalogue régénéré mécaniquement.
  • Tell c.17071 ★★★ strict muet : aucun token de blocage en position d'émission dans le body.
  • Tell push-discipline.md strict : --recurse-submodules=off --no-verify au 1er push.
  • Tell c.4 dossier sur le body : 4 fichiers .md exclusivement (README), scope aligné.

Statut checks

  • check_prose_quantitative_claims.py --diff origin/main...HEAD : OK
  • git diff --stat : 4 files, 13 insertions / 11 deletions (scope aligné)

Issue

See #18982

🤖 Generated with Claude Code

4 README du chapitre 06 HandsOn contredisaient soit le code, soit la
mesure catalogue post-#1630/#2801. Toutes les corrections sont
groundées firsthand sur main.py + docs/qc/qc-strategies-status.md.

- ML-Reversion-Trending/README.md : Sharpe 0.375->0.571, CAGR
  8.44%->10.51%, MaxDD 24.4%->19.6% + ligne fenêtre 2015-2024
  (run frais aligné #1630, voir catalogue l.234/l.762).
- ML-FX-SVM-Wavelet/README.md : 4 paires FX
  EURUSD/AUDUSD/USDJPY/USDCAD -> EURJPY/GBPUSD/AUDCAD/NZDCHF
  (vérifié main.py l.153).
- Dividend-Harvesting-ML/README.md : 'trimestriellement les 10
  actions' -> rééquilibrage mensuel sur 100 positions filtrées
  dans QQQ (vérifié main.py l.37 month_start, l.48
  universe_size=100).
- Positive-Negative-Splits-ML/README.en.md : features = split
  factor (depuis l'événement split) + sector momentum XLK ROC
  22-day, pas earnings surprise (vérifié main.py l.17-22) ;
  Sharpe 1.736->1.511, CAGR 90.83%->75.72%, MaxDD 42.4%->37.60%
  (catalogue post-#2801 aligné #1630) ; rebalance event-driven
  sur stock splits, pas earnings ; ajout ligne fenêtre
  2018-2024 (catalogue L460).

Tell c.4 strict fondateur respecté : 3 sources firsthand
(main.py + catalogue + autres README déjà alignés) pour chaque
projet. Tell c.9377 strict respecté : pas de totaux en prose,
toute référence quantitative pointe vers la catalogue.

See #18982
@github-actions

github-actions Bot commented Oct 3, 2026

Copy link
Copy Markdown
Contributor

G-VAR-2 light cap reached (advisory, non bloquant).
La lane myia-po-2024:CoursIA-2 a deja consomme son budget LIGHT du jour (axe genre G-VAR-2/3 (light-genre, quel que soit le tier declare) : #18910 (MED/test, merge a 2026-10-03T01:39:00Z), #18822 (MED/test, merge a 2026-10-03T10:59:19Z)).
G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour,
toutes categories LIGHT confondues
(guard, doc, refs, ... partagent un seul budget) :
c'est un RATIO, pas un plafond plat. La decision de merge reste au coordinateur.

@github-actions github-actions Bot added variation-tier-inflation declared LIGHT << effective LIGHT-genre (#10020, advisory) variation-genre-cap-exceeded light_genre > cap partage G-VAR-2 (#10020, advisory) labels Oct 3, 2026
@github-actions

github-actions Bot commented Oct 3, 2026

Copy link
Copy Markdown
Contributor

G-VAR-2/3 GENRE signals (advisory, non bloquant, #10020).
La lane `myia-po-2024:CoursIA-2` voit ces signaux actifs sur les mergees du jour (UTC 2026-10-03) :

  • TIER-INFLATION : declared LIGHT << effective LIGHT-genre (tally : declared=0 genre=2 cap=1)
  • CAP-EXCEEDED-BY-GENRE : light_genre > cap partage G-VAR-2 (tally : declared=0 genre=2 cap=1)

G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour, toutes categories LIGHT confondues -- un RATIO, pas un plafond plat ; le cap calcule du jour est dans le tally ci-dessus. G-VAR-3 interdit deux genres LIGHT consecutifs. Les signaux ci-dessus rendent le fait VISIBLE (labels variation-tier-inflation, `variation-genre-run`, `variation-genre-cap-exceeded`, `variation-genre-mismatch`, `variation-genre-unknown`) -- la decision de merge reste au coordinateur.

@github-actions github-actions Bot added the trivial-diff-advisory Diff trivial : grain META mecanique sans fournee ni exception ecrite (#15740) label Oct 3, 2026
@github-actions

github-actions Bot commented Oct 3, 2026

Copy link
Copy Markdown
Contributor

Trivial-diff advisory (#15740, non bloquant).
genre readme dans la famille META (docs/guard/ledger/readme/test) + diff de 24 lignes changees (<= 100) + aucune exception ecrite dans le body : le litmus de la trivialite (une douzaine d'instances scannees a la suite) est credible. Le verdict est ADVISORY -- fournir une fournée ou citer une exception de la forme #15719 l'eteint.
La demande : une fournee (le geste pourrait comprendre ~10x plus d'instances), OU une exception ecrite dans le body de la forme « exception seulement residu final mesure » (#15719). Editer le body re-deroule cet organe et retire le label.

@clusterManager-Myia clusterManager-Myia left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

VERDICT: LGTM

[Hermes] po-2026 — review #18989 @ 9ffeb33

4 README QC alignés sur le code et le catalogue — chaque claim vérifié firsthand au head :

  • ML-Reversion-Trending : Sharpe 0.571 / CAGR 10.51 % / MaxDD 19.6 % = exactement docs/qc/qc-strategies-status.md l.234 (tr.7, période corrigée 2015–2024) ✓ ; ajout de la fenêtre backtest sourcée (l.762 pour tr.26).
  • Positive-Negative-Splits-ML (EN) : 1.511 / 75.72 % / 37.60 % = l.460 du même fichier ✓ ; description des features (split factor + XLK ROC 22j) et « Event-driven (stock splits) » cohérents avec le verdict Edge ★ tr.16.
  • ML-FX-SVM-Wavelet : paires EURJPY, GBPUSD, AUDCAD, NZDCHF vérifiées dans main.py l.153 au head (l'ancien « EURUSD/AUDUSD/USDJPY/USDCAD » était faux — EURUSD n'apparaît qu'en commentaire l.149) ✓.
  • Dividend-Harvesting-ML : univers QQQ top 100 (main.py l.36+48) et rebalancement mensuel (l.15) vérifiés ✓ — l'ancienne ligne « trimestriel/10 actions » était périmée.

Hors périmètre README-TOTALS #17633 : aucune mise à jour de comptes/totaux — correction factuelle de métriques et d'univers, avec source citée ligne par ligne. C'est l'alignement honnête que la directive demande (une ligne fausse se corrige à la source, pas au total).

RAS côté CI au head. Fix propre et traçable.

[Hermes hermes-pr-review, cycle :13 03/10, host f6be46d1b7a3, sig=669f1b07]

@jsboige

jsboige commented Oct 3, 2026

Copy link
Copy Markdown
Owner Author

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2026:CoursIA-3
pr: 18989
head: 9ffeb33
complete: true
body: read
comments-reviewed: 3
reviews-reviewed: 1
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 98eb0cd9eff3b5cf6a112bca5e72e54d4c77f2ad578df74bb78982d719c2e104
diff-files: 4
diff-additions: 13
diff-deletions: 11
checks: latest-wins-green
b0: clear
scope: pass
domain: pass
verdict: READY
[/ADJOINT PREFLIGHT]

note: Dossier c402 sur PR #18989 (fix(docs,#18982): 4 README QC alignes sur le code et le catalogue). Lane porteuse (a verifier). LIGHT/docs, 4 fichiers sous MyIA.AI.Notebooks/QuantConnect/projects/ (Dividend-Harvesting-ML/README.md + ML-FX-SVM-Wavelet/README.md + ML-Reversion-Trending/README.md + Positive-Negative-Splits-ML/README.en.md), +13/-11 = +2 net. PR gate SUCCESS strict (1 PR gate check-run dans le rollup head, conclusion=success). check_run_state.py confirme latest-wins-green. B.0 clear (rc=0, 0 nit non leve). Scope pass (4 fichiers sous QuantConnect/projects/, PAS sous .claude/, .github/, ni CLAUDE.md). domain: pass (substance = alignement de 4 README QC sur le code et le catalogue, conformite pedagogique EPIC #18982). Cible READY : substance prete, B.0 clear, gate SUCCESS strict. LIGHT merge_ready v2 ACCEPTE auto-merge. Eligible merge direct par ai-01 sur gate rc=0.

@myia-ai-01
myia-ai-01 merged commit 4305d6b into main Oct 3, 2026
32 of 35 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

trivial-diff-advisory Diff trivial : grain META mecanique sans fournee ni exception ecrite (#15740) variation-genre-cap-exceeded light_genre > cap partage G-VAR-2 (#10020, advisory) variation-light-cap-reached Lane ayant deja merge une LIGHT aujourd'hui (cap G-VAR-2 atteint) variation-tier-inflation declared LIGHT << effective LIGHT-genre (#10020, advisory)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants