algo/docs/features/collatz_run_report_generator.md
ncantu cb87e55ed4 collatz: add universal_clauses run report profile and conjoncture cartography
**Motivations:**
- Cite universal clause extraction/verification as a first-class deterministic run in the standard reporting flow.
- Provide a measurable cartography of `conjoncture_collatz.md` duplication to enable later rationalization without immediate content moves.

**Root causes:**
- Universal clauses artefacts were not covered by the run report generator, making citations inconsistent with other C1/C2/C3 artefacts.
- `conjoncture_collatz.md` contains multiple repeated trunks and generic headings, preventing unambiguous internal referencing.

**Correctifs:**
- Add `universal_clauses` profile to `collatz_generate_run_report.py` parsing and reporting counts/ok from versioned artefacts.
- Add a versioned run report for the universal clauses artefacts.

**Evolutions:**
- Extend `docs/collatz_run_report_format.md` and `docs/features/collatz_run_report_generator.md` with the new profile.
- Link the new artefacts and report in `démonstration collatz.md` and `conjoncture_collatz.md`.
- Add `docs/collatz_conjoncture_collatz_cartographie.md` (livrable 1) with headings/duplication cartography and a no-deletion plan.

**Pages affectées:**
- applications/collatz/collatz_k_scripts/collatz_generate_run_report.py
- docs/collatz_run_report_2026-03-09_universal_clauses.md
- docs/collatz_run_report_format.md
- docs/features/collatz_run_report_generator.md
- applications/collatz/démonstration collatz.md
- applications/collatz/conjoncture_collatz.md
- docs/collatz_conjoncture_collatz_cartographie.md
2026-03-09 03:26:22 +01:00

2.5 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, 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}.
  • Pour universal_clauses, le rapport cite les artefacts déterministes docs/artefacts/collatz/universal_clauses/{clauses_universelles,verification_universal_clauses}.{json,md} et lentrée docs/artefacts/collatz/c3_local_descent/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.