algo/docs/collatz_run_report_format.md
ncantu 242ec6c03f Collatz: formalize hybrid targets and standardize run reports
**Motivations:**
- Make the hybrid path (C1→C2→C3) operational with explicit targets
- Define R_m exactly as used by the pipeline for citable artefacts
- Keep execution transcripts out of proof documents via stable run reports

**Root causes:**
- Hybrid continuation lacked a concrete invariant/lemma agenda and a precise R_m definition
- No standardized run report format in docs/

**Correctifs:**
- Document the pipeline-level definition of R_m (D/F update rules and artefact schema)
- Add explicit prioritization and lemma targets for the hybrid trajectory

**Evolutions:**
- Add a standard run report template and a filled example with sha256 fingerprints

**Pages affectées:**
- applications/collatz/collatz_k_scripts/plan_lemmes_manquants_et_programme_de_preuve.md
- docs/fixKnowledge/collatz_docs_status_and_transcript_cleanup.md
- docs/collatz_run_report_format.md
- docs/collatz_run_report_2026-03-04_extend_D18_D21_resume_from_D20.md
2026-03-08 23:58:30 +01:00

64 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

**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)
### 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.