Skip to content

Fix(qc,#18063): tranche 3a -- presentation notebooks manquants (15 projets) + refs perimees - #19555

Merged
myia-ai-01 merged 2 commits into
mainfrom
fix/18063-qc-readme-tranche3a
Oct 7, 2026
Merged

myia-ai-01 merged 2 commits into
mainfrom
fix/18063-qc-readme-tranche3a

Conversation

@jsboige

@jsboige jsboige commented Oct 6, 2026

Copy link
Copy Markdown
Owner

Grain: MED/docs — lane myia-po-2023:CoursIA — prev: MED/docs #19553

Audit READMEs QuantConnect — tranche 3a (15 projets, findings mécaniques, re-vérification intégrale)

Suite de #19524 (tranche 1) et #19553 (tranche 2). Périmètre : findings MISSING_PRESENTATION (notebook présent dans le projet mais absent du README) et STALE_STRUCTURE (référence à un fichier qui n'existe pas). Les items DESCRIPTION_MISMATCH restants (HIGH) sont hors périmètre — tranche 3b à venir.

Chaque finding re-vérifié firsthand sur origin/main (audit-reassessment) : existence du fichier sur disque + titre de la première cellule markdown du notebook (JSON parsé, jamais grep brut — le base64 des images fabrique des faux hits) + lecture de la section Files/Fichiers/Architecture du README. 20/20 CONFIRMÉS.

Notebooks ajoutés à leur README (15)

Projet Notebook Titre vérifié (cellule 0)
ML-EnhancedPairs quantbook.ipynb Research QuantBook: ML-Enhanced Pairs
ML-Ensemble quantbook.ipynb Research QuantBook: ML Ensemble
ML-FeatureEngineering quantbook.ipynb Research QuantBook: ML Feature Engineering
ML-RandomForest quantbook.ipynb ML Random Forest - Classification pour Trading
ML-Regression quantbook.ipynb Research QuantBook: ML Regression
ML-TextClassification quantbook.ipynb ML Text Classification for Trading
MeanReversion quantbook.ipynb Research QuantBook: Mean Reversion (Sector ETFs)
Options-VGT quantbook.ipynb (via stale ref) Research QuantBook: Options Wheel Tech Stocks
OptionsIncome quantbook.ipynb Research QuantBook: Covered Call Strategy
RegimeSwitching quantbook.ipynb Research QuantBook: RegimeSwitching Alpha Model
RiskParity quantbook.ipynb (prose, pas de section Files) Research QuantBook: RiskParity (Inverse-Volatility Weighting)
RL-Portfolio quantbook.ipynb + research.ipynb RL Portfolio Allocation / Stratégie Q-Learning (31 cellules)
Reinforcement-Learning-Trading research.ipynb Research: Reinforcement Learning Trading (Ex08)
Research-Executor research.ipynb (ligne table) Research-Executor — index des notebooks de recherche

Références périmées corrigées (5)

Projet Avant (fichier absent) Après (fichier vérifié présent)
Options-VGT essai_pour_voir.ipynb quantbook.ipynb — ligne remplacée (rôle équivalent : exploration des chaînes d'options)
Portfolio-Optimization-ML QC-Py-21-Portfolio-Optimization-ML.ipynb (ancien nom de corpus) research.ipynb, ancien nom conservé entre parenthèses
Research-Executor research_short_harvest.ipynb research_long_short_harvest.ipynb (présent sur disque)
OptionsIncome variantes main_v71_ivrank.py / main_v72_strikeavail.py absentes de l'arbre 2 lignes ajoutées (descriptions dérivées des noms de fichiers)
RL-Portfolio « Template structure » sans mention des notebooks les 2 notebooks ajoutés ; la ligne note que la stratégie Q-Learning effective vit dans research.ipynb, main.py restant un template

Rider : description MeanReversion précisée

La ligne research.ipynb décrivait seulement « Optimisation RSI, stop-loss et tests de période de détention » — le notebook porte le pivot stocks → ETF sectoriels (déjà revendiqué par main.py v4.0) et énumère H1-H8 (mesuré : les 8 marqueurs présents dans les cellules). Ligne réécrite en conséquence.

Gardes

  • check_prose_quantitative_claims.py --diff origin/main...HEAD --strict : rc=0 — vérifié sur le diff committé (leçon consignée : l'organe juge les commits, pas le worktree)
  • Aucun notebook modifié — 15 fichiers, tous README.md (pas d'exposition C.2/H.3)
  • Prose ajoutée en français y compris dans les READMEs EN (readme-french-first HARD 1)
  • Catalogue : byte-identique à main (pas dans le diff)
  • Descriptions des notebooks dérivées des titres de cellule 0 mesurés, jamais du nom de fichier seul

See #18063

🤖 Generated with Claude Code

…uants + refs perimees (essai_pour_voir, QC-Py-21, short_harvest, variantes v71/v72)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@github-actions github-actions Bot added the variation-light-cap-reached Lane ayant deja merge une LIGHT aujourd'hui (cap G-VAR-2 atteint) label Oct 6, 2026
@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

G-VAR-2 light cap reached (advisory, non bloquant).
La lane myia-po-2023:CoursIA a deja consomme son budget LIGHT du jour (axe genre G-VAR-2/3 (light-genre, quel que soit le tier declare) : #19260 (MED/docs, merge a 2026-10-06T06:40:03Z), #19430 (LIGHT/docs, merge a 2026-10-06T06:43:31Z), #19479 (MED/docs, merge a 2026-10-06T14:43:56Z)).
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-run >= 2 grains consecutifs du meme genre LIGHT pour la lane (#10020, advisory) variation-genre-cap-exceeded light_genre > cap partage G-VAR-2 (#10020, advisory) variation-genre-mismatch declared genre != genre infere depuis les chemins du diff (#10020, advisory) labels Oct 6, 2026
@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

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

  • TIER-INFLATION : declared LIGHT << effective LIGHT-genre (tally : declared=1 genre=3 cap=2)
  • GENRE-RUN : run consecutif d'un genre LIGHT (voir signals.runs dans le log du job)
  • CAP-EXCEEDED-BY-GENRE : light_genre > cap partage G-VAR-2 (tally : declared=1 genre=3 cap=2)
  • GENRE-MISMATCH : declared genre != genre infere depuis les chemins du diff

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 6, 2026
@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Trivial-diff advisory (#15740, non bloquant).
genre docs dans la famille META (docs/guard/ledger/readme/test) + diff de 25 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.

…rendus (organe readme-ipynb-links)

Riders preexistants dans les fichiers touches : research.ipynb (RiskParity, ML-RandomForest).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@jsboige

jsboige commented Oct 6, 2026

Copy link
Copy Markdown
Owner Author

Rouge readme-ipynb-links-guard repare (commit 95484cf) : 3 liens .ipynb convertis en .html dans les READMEs rendus — le lien quantbook ajoute par cette PR (RiskParity) + 2 riders preexistants dans les fichiers touches (research.ipynb RiskParity + ML-RandomForest). Reproduit localement via l'organe (fix_ipynb_links.py --check : 3 STALE_LINK -> 0), prose-counts strict rc=0 re-verifie sur le diff commite.

@github-actions

github-actions Bot commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Path-collision (organ #13359/#13615)

Cette PR #19555 (Fix(qc,#18063): tranche 3a -- presentation notebooks manquants (15 projets) + refs perimees) touche au moins un chemin de fichier aussi modifie par d'autres PRs ouvertes. Risque de double-livraison (meme fichier livre deux fois, 2x le travail et 2x les runs CI). Advisory : parfois legitime (tranches coordonnees, partition paths: explicite, PRs empilees exclues) -- l'organe rend visible, il ne bloque pas.

@github-actions github-actions Bot added the pr-overlap Advisory: another open PR touches the same files (organ #13615) label Oct 6, 2026
@jsboige

jsboige commented Oct 7, 2026

Copy link
Copy Markdown
Owner Author

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2026:CoursIA-3
pr: 19555
head: 95484cf
complete: true
body: read
comments-reviewed: 5
reviews-reviewed: 0
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 17b0863598215fae3391fe530f1ef0f43f169948ca9b682658046fd40ff9b0d2
diff-files: 15
diff-additions: 23
diff-deletions: 6
checks: latest-wins-green
b0: clear
scope: pass
domain: pass
verdict: READY
organ: check_adjoint_prevalidation.py
organ-command: python scripts/check_adjoint_prevalidation.py --derive-verdict 19555
organ-rc: 0
[/ADJOINT PREFLIGHT]

@jsboige

jsboige commented Oct 7, 2026

Copy link
Copy Markdown
Owner Author

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2026:CoursIA-3
pr: 19555
head: 95484cf
complete: true
body: read
comments-reviewed: 6
reviews-reviewed: 0
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: ed7e1e3d9d09db2e66cded7582ffea7cf4cd45045b56aba5ad74d59fed896d8d
diff-files: 15
diff-additions: 23
diff-deletions: 6
checks: latest-wins-green
b0: clear
scope: pass
domain: pass
verdict: READY
organ: check_adjoint_prevalidation.py
organ-command: python scripts/check_adjoint_prevalidation.py --derive-verdict 19555
organ-rc: 0
[/ADJOINT PREFLIGHT]

@myia-ai-01
myia-ai-01 merged commit d4e5cea into main Oct 7, 2026
34 of 35 checks passed
@jsboige
jsboige deleted the fix/18063-qc-readme-tranche3a branch October 7, 2026 07:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr-overlap Advisory: another open PR touches the same files (organ #13615) 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-genre-mismatch declared genre != genre infere depuis les chemins du diff (#10020, advisory) variation-genre-run >= 2 grains consecutifs du meme genre LIGHT pour la lane (#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.

2 participants