algo/docs/collatz_run_report_format.md
ncantu 9d702cd1d3 Collatz: certify H6(E1) and add run report profiles
**Motivations:**
- Certify local completeness H6(E1) via explicit covered-union on lifts
- Support additional run-report scopes (D16/D17 pipeline, fusion 2^25)

**Root causes:**
- H6(E1) needed a concrete certified artefact set to be citable
- Report generator profiles were too limited for other paliers outputs

**Correctifs:**
- Produce local certificates for E1 lifts and verify covered union equals L

**Evolutions:**
- Add generator profiles: pipeline_d16_d17, fusion_palier2p25
- Document usage in docs/ and docs/features/

**Pages affectées:**
- applications/collatz/out/local_E1_palier2p13/noyaux/noyau_E1_B12.json
- applications/collatz/out/local_E1_palier2p13/noyaux/noyau_post_D8_E1_palier2p13.json
- applications/collatz/out/local_E1_palier2p13/noyaux/noyau_missing_after_D8_F9to12.json
- applications/collatz/out/local_E1_palier2p13/candidats/candidats_D8_E1_palier2p13.csv
- applications/collatz/out/local_E1_palier2p13/candidats/candidats_F9to12_E1_palier2p13.csv
- applications/collatz/out/local_E1_palier2p13/candidats/candidats_F13to20_E1_palier2p13.csv
- applications/collatz/out/local_E1_palier2p13/candidats/candidats_F9to40_E1_palier2p13.csv
- applications/collatz/out/local_E1_palier2p13/certificats/certificat_D8_E1_palier2p13.json
- applications/collatz/out/local_E1_palier2p13/certificats/certificat_F9to12_E1_palier2p13.json
- applications/collatz/out/local_E1_palier2p13/certificats/certificat_F13to20_E1_palier2p13.json
- applications/collatz/out/local_E1_palier2p13/certificats/certificat_F9to40_E1_palier2p13.json
- applications/collatz/out/local_E1_palier2p13/audits/verification_H6_E1_palier2p13.md
- applications/collatz/collatz_k_scripts/collatz_generate_run_report.py
- docs/collatz_run_report_format.md
- docs/features/collatz_run_report_generator.md
2026-03-09 00:31:41 +01:00

3.0 KiB
Raw Blame History

Auteur : Équipe 4NK

Format standard de rapport dexécution (Collatz)

Objectif

Standardiser la rédaction dun rapport dexécution séparé du texte de preuve, afin que :

  • le texte de preuve ne contienne pas de transcript terminal ;
  • chaque résultat computationnel soit citable avec une assertion explicite et des artefacts vérifiables ;
  • la reproduction soit déterministe (commande, paramètres, empreintes).

Emplacement stable

Le rapport dexécution doit être ajouté dans docs/ (par exemple docs/collatz_run_report_<YYYY-MM-DD>_<scope>.md) et référencé depuis les documents mathématiques par un chemin stable.

Gabarit (à copier-coller)

Génération automatisée

Le script applications/collatz/collatz_k_scripts/collatz_generate_run_report.py génère un rapport à partir des logs et des artefacts dun OUT existant (sha256 + compteurs extraits des logs) :

python3 applications/collatz/collatz_k_scripts/collatz_generate_run_report.py \
  --profile extend_finale \
  --out-dir applications/collatz/out \
  --docs-dir docs

Pour la validation “section 7” (N*, certificat complet, coverage) :

python3 applications/collatz/collatz_k_scripts/collatz_generate_run_report.py \
  --profile validation_section7 \
  --scope validation_section7 \
  --out-dir applications/collatz/out \
  --docs-dir docs

Pour le pipeline D16/D17 après fusion :

python3 applications/collatz/collatz_k_scripts/collatz_generate_run_report.py \
  --profile pipeline_d16_d17 \
  --scope pipeline_d16_d17 \
  --out-dir applications/collatz/out \
  --docs-dir docs

Pour les fusions au palier 2^{25} (t=11,12,14) :

python3 applications/collatz/collatz_k_scripts/collatz_generate_run_report.py \
  --profile fusion_palier2p25 \
  --scope fusion_palier2p25 \
  --out-dir applications/collatz/out \
  --docs-dir docs

Contexte

  • But du run : (énoncé court)
  • Assertion ciblée : (ex. “montrer |R_M|=0 pour (M=\dots)” ou “produire certificat_F16...”)
  • Statut logique : (ce que le run prouve, et ce quil ne prouve pas)

Code et reproductibilité

  • Commit Git : (hash)
  • Commande exacte : (copier-coller)
  • Paramètres : (liste structurée)
  • Environnement :
    • OS
    • Python
    • dépendances (si pertinent)

Entrées (artefacts consommés)

Liste exhaustive avec chemins et empreintes :

  • path/to/input_1 : (sha256)
  • path/to/input_2 : (sha256)

Sorties (artefacts produits)

Liste exhaustive avec chemins et empreintes :

  • path/to/output_1 : (sha256)
  • path/to/output_2 : (sha256)

Compteurs et métriques

  • |R_m|, |B_m|, q_m (si calculés)
  • tailles fichiers (optionnel)
  • bornes / maxima observés (ex. max_r)

Vérification

  • Script de vérification : (chemin + commande)
  • Résultat : (succès/échec, et valeur vérifiée, par ex. |R_M|=0 ou |R_M|>0)

Notes (optionnel)

Informations dexploitation non mathématiques (temps, mémoire) si elles sont utiles, sans les mélanger au texte de preuve.