algo/docs/features/collatz_run_report_generator.md
ncantu 06fd3e920f collatz: add palier iteration tooling and C3 palier run reports
**Motivations:**
- Support deterministic iteration beyond 2^13 with palier-scoped artefacts and reports.

**Root causes:**
- C3 palier runs needed distinct report naming; universal clause reports referenced a hard-coded C3 input.
- Palier iteration lacked a deterministic way to mass-generate local H6 run reports and keep `local_H6_index.md` consistent.

**Correctifs:**
- Add `c3_local_descent_palier` report profile (distinct filename per palier) and fix C3 report wording to use the actual palier.
- Make `universal_clauses` report profile derive its C3 input from `clauses_universelles.json`.

**Evolutions:**
- Add `collatz_generate_local_h6_run_reports.py` and extend `collatz_iterate_palier_protocol.py` to include C1 reports + palier-scoped universal clause outputs.
- Update documentation and proof pointers for palier2p14 artefacts/reports.

**Pages affectées:**
- applications/collatz/collatz_k_scripts/collatz_generate_run_report.py
- applications/collatz/collatz_k_scripts/collatz_generate_local_h6_run_reports.py
- applications/collatz/collatz_k_scripts/collatz_iterate_palier_protocol.py
- docs/collatz_run_report_format.md
- docs/features/collatz_run_report_generator.md
- applications/collatz/démonstration collatz.md
- applications/collatz/conjoncture_collatz.md
2026-03-09 05:06:03 +01:00

2.7 KiB
Raw Blame History

Auteur : Équipe 4NK

Collatz — Génération automatisée des rapports dexécution

Objectif

Fournir un mécanisme standard et reproductible pour produire un rapport dexécution séparé du texte de preuve, contenant :

  • la commande,
  • les artefacts dentrée et de sortie,
  • les empreintes sha256,
  • des compteurs extraits des logs,

afin déviter toute insertion de transcript terminal dans les documents mathématiques.

Impacts

  • Les rapports dexécution sont centralisés dans docs/ et référencés depuis les documents de preuve par un chemin stable.
  • Les empreintes sha256 permettent de citer précisément les artefacts utilisés.

Modifications

  • Ajout dun format standard : docs/collatz_run_report_format.md.
  • Ajout dun générateur : applications/collatz/collatz_k_scripts/collatz_generate_run_report.py.
  • Ajout dun exemple réel de rapport : docs/collatz_run_report_2026-03-04_extend_D18_D21_resume_from_D20.md.
  • Profils supportés : extend_finale, validation_section7, pipeline_d16_d17, fusion_palier2p25, local_H6_E1, local_H6, c2_projective, c3_local_descent, c3_local_descent_palier, universal_clauses.
  • Pour local_H6/local_H6_E1, un audit automatique compare le palier attendu (artefacts) au palier certifié (certificats) et échoue en cas de désaccord.
  • Pour c2_projective, le rapport cite les artefacts déterministes docs/artefacts/collatz/c2_projective/verification_c2_projective.{json,md}.
  • Pour c3_local_descent, le rapport cite les artefacts déterministes docs/artefacts/collatz/c3_local_descent/verification_c3_local_descent.{json,md} (et, si --c3-palier != 13, les variantes suffixées ..._palier2p<m>.{json,md}).
  • Pour c3_local_descent_palier, le nom de fichier du rapport est déterministe : docs/collatz_run_report_<date>_c3_local_descent_palier2p<m>.md.
  • Pour universal_clauses, le rapport cite les artefacts déterministes docs/artefacts/collatz/universal_clauses/... et lentrée C3 est déduite de clauses_universelles.json (champ inputs.verification_c3_local_descent_json).

Modalités danalyse

  • Vérifier que applications/collatz/out/pipeline_extend.log et applications/collatz/out/paliers_finale.log existent et contiennent un run complet.
  • Vérifier la présence des artefacts listés (noyaux/candidats/certificats) dans applications/collatz/out/.
  • Pour local_H6_E1, vérifier la présence des artefacts versionnés dans docs/artefacts/collatz/local_E1_palier2p13/.
  • Pour local_H6, fournir --local-h6-artefacts-dir et vérifier la présence dun noyau base noyaux/noyau_*_B12.json et dau moins un certificat certificats/certificat_*.json.

Modalités de déploiement

Aucun déploiement.