**Motivations:** - Avoid one-profile-per-state duplication for local H6 completeness checks - Reuse a single strict verifier for any versioned local H6 artefacts set **Root causes:** - The initial local_H6_E1 profile was state-specific and not reusable for other E **Correctifs:** - Factor local H6 verification into a generic union-vs-lift equality check **Evolutions:** - Add `local_H6` profile with `--local-h6-artefacts-dir` - Keep `local_H6_E1` as a stable alias to the E1 artefacts directory - Document the generalized usage and update the E1 report output **Pages affectées:** - applications/collatz/collatz_k_scripts/collatz_generate_run_report.py - docs/collatz_run_report_format.md - docs/features/collatz_run_report_generator.md - docs/collatz_run_report_2026-03-09_local_H6_E1.md
3.7 KiB
Auteur : Équipe 4NK
Format standard de rapport d’exécution (Collatz)
Objectif
Standardiser la rédaction d’un rapport d’exé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 d’exé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 d’un 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
Pour la complétude locale H6(E1) au palier 2^{13} (rapport basé sur des artefacts versionnés dans docs/artefacts/) :
python3 applications/collatz/collatz_k_scripts/collatz_generate_run_report.py \
--profile local_H6_E1 \
--scope local_H6_E1 \
--out-dir applications/collatz/out \
--docs-dir docs
Pour une complétude locale H6 généralisée (artefacts versionnés, répertoire paramétrable) :
python3 applications/collatz/collatz_k_scripts/collatz_generate_run_report.py \
--profile local_H6 \
--scope local_H6_E42 \
--local-h6-artefacts-dir docs/artefacts/collatz/local_E42_palier2p13 \
--out-dir applications/collatz/out \
--docs-dir docs
Contexte
- But du run : (énoncé court)
- Assertion ciblée : (ex. “montrer
|R_M|=0pour (M=\dots)” ou “produirecertificat_F16...”) - Statut logique : (ce que le run prouve, et ce qu’il 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|=0ou|R_M|>0)
Notes (optionnel)
Informations d’exploitation non mathématiques (temps, mémoire) si elles sont utiles, sans les mélanger au texte de preuve.