algo/docs/features/collatz_universal_clause_extraction_optionA.md
ncantu bd529682bf collatz: add palier2p15/p16 artefacts and Sm refinement tooling
**Motivations:**
- Publish new Collatz palier runs and associated artefacts (C3 local descent, universal clauses, iteration protocol).
- Extend the scripts toolbox to generate/verify clauses and build refinement certificates over S_m.

**Root causes:**
- Universal clause witnesses were lifted to 2^(A+1) even when the witness is already fixed modulo the domain palier, leading to unstable or unnecessarily weak/ambiguous modulus choices.
- CSV palier inference in scission could mis-detect short column names (e.g. "m") by substring matching.

**Correctifs:**
- Lift D_exact/F witnesses to m_stable := max(m, A+1) in universal clause extraction and run reports.
- Make scission palier/m column detection exact-match to avoid false positives.
- Update C3 local descent verification/reporting to use strict fusion witness selection prioritizing lower modular stability and refreshed D/F metrics.
- Add a dedicated run report profile for per-palier universal clauses.

**Evolutions:**
- Add scripts for terminal clauses and minorated descent clauses over S_m, their deterministic verification, and multi-level refinement certificate building.
- Add modular tooling for register_K and incremental comparison of D_minor families.
- Add/update feature documentation for the new pipelines and generated reports.

**Pages affectées:**
- applications/collatz/collatz_k_scripts/README.md
- applications/collatz/collatz_k_scripts/collatz_extract_universal_clauses.py
- applications/collatz/collatz_k_scripts/collatz_generate_run_report.py
- applications/collatz/collatz_k_scripts/collatz_iterate_palier_protocol.py
- applications/collatz/collatz_k_scripts/collatz_scission.py
- applications/collatz/collatz_k_scripts/collatz_verify_c3_local_descent.py
- applications/collatz/collatz_k_scripts/collatz_verify_universal_clauses.py
- applications/collatz/collatz_k_scripts/*refinement*over_Sm*.py
- applications/collatz/collatz_k_scripts/collatz_generate_*clauses_over_Sm.py
- applications/collatz/collatz_k_scripts/collatz_verify_minorated_descent_clauses_over_Sm.py
- applications/collatz/collatz_k_scripts/collatz_build_register_K_modular.py
- applications/collatz/collatz_k_scripts/collatz_compare_dminor_families_incremental.py
- applications/collatz/*.md
- docs/features/*.md
- docs/artefacts/collatz/**
- docs/collatz_run_report_2026-03-09_*.md
2026-03-09 23:29:59 +01:00

87 lines
4.1 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
# Collatz — Extraction de clauses universelles (Option A : Lift(B12))
## Objectif
Industrialiser la conversion « témoin local → clause universelle candidate » (H4/H5) dans le périmètre **Option A** :
- domaine des témoins : une instance locale de clôture (C3) sur \(L=\mathrm{Lift}_{12\to 13}(B_{12})\) ;
- entrée standard : un artefact déterministe `verification_c3_local_descent.json` contenant, pour chaque \(n\in L\), un témoin \(D\) (exact / brother) ou \(F\) (fusion) ;
- sortie : un ensemble versionné de **clauses candidates** \(D/F\) relevées au module \(2^{m_{stable}}\) avec \(m_{stable}=\max(m, A+1)\) (où \(m\) est le palier du domaine), afin de figer le préfixe de valuations, plus une vérification déterministe de cohérence.
Le but est de rendre la notion « certificat ⇒ clause universelle utilisable dans une induction bien fondée » exploitable de manière répétable, sans transcript, et sans dépendre dun seul représentant.
## Impacts
- Ajoute un format dartefacts versionnés `docs/artefacts/collatz/universal_clauses/` pour stocker :
- clauses extraites (JSON + MD),
- vérification (JSON + MD).
- Naltère pas la pipeline de génération de certificats ; le flux est en lecture seule visàvis des artefacts C3.
## Modifications
### Scripts
- `applications/collatz/collatz_k_scripts/collatz_extract_universal_clauses.py`
- lit `docs/artefacts/collatz/c3_local_descent/verification_c3_local_descent.json`,
- pour chaque témoin `D_exact` ou `F`, calcule \(m_{stable}=\max(m, A+1)\) et relève le résidu au palier stable par un relèvement déterministe (choix unique du bon enfant à chaque palier),
- conserve `D_brother` sous forme de dépendance locale `D_brother_local` (référence `mate_exact`).
- `applications/collatz/collatz_k_scripts/collatz_verify_universal_clauses.py`
- vérifie la cohérence arithmétique et la cohérence de relèvement avec le fichier source C3,
- vérifie aussi les dépendances `D_brother_local` (relation de sœur au palier de domaine, et existence du `mate_exact` en `D_exact`).
### Artefacts
- `docs/artefacts/collatz/universal_clauses/clauses_universelles.{json,md}`
- `docs/artefacts/collatz/universal_clauses/verification_universal_clauses.{json,md}`
## Modalités de déploiement
Pas de déploiement : scripts exécutés localement, artefacts versionnés.
## Modalités danalyse / reproduction
Commande dextraction :
```bash
python3 applications/collatz/collatz_k_scripts/collatz_extract_universal_clauses.py \
--verification-json docs/artefacts/collatz/c3_local_descent/verification_c3_local_descent.json \
--output-dir docs/artefacts/collatz/universal_clauses \
--repo-root /home/ncantu/code/algo
```
Commande de vérification :
```bash
python3 applications/collatz/collatz_k_scripts/collatz_verify_universal_clauses.py \
--verification-json docs/artefacts/collatz/c3_local_descent/verification_c3_local_descent.json \
--clauses-json docs/artefacts/collatz/universal_clauses/clauses_universelles.json \
--output-dir docs/artefacts/collatz/universal_clauses \
--repo-root /home/ncantu/code/algo
```
Exemple palier \(2^{15}\) :
```bash
python3 applications/collatz/collatz_k_scripts/collatz_extract_universal_clauses.py \
--verification-json docs/artefacts/collatz/c3_local_descent/verification_c3_local_descent_palier2p15.json \
--output-dir docs/artefacts/collatz/universal_clauses/palier2p15 \
--repo-root /home/ncantu/code/algo
python3 applications/collatz/collatz_k_scripts/collatz_verify_universal_clauses.py \
--verification-json docs/artefacts/collatz/c3_local_descent/verification_c3_local_descent_palier2p15.json \
--clauses-json docs/artefacts/collatz/universal_clauses/palier2p15/clauses_universelles.json \
--output-dir docs/artefacts/collatz/universal_clauses/palier2p15 \
--repo-root /home/ncantu/code/algo
```
Entrée attendue :
- `docs/artefacts/collatz/c3_local_descent/verification_c3_local_descent.json`
Sorties attendues :
- `docs/artefacts/collatz/universal_clauses/clauses_universelles.json`
- `docs/artefacts/collatz/universal_clauses/verification_universal_clauses.json`