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

4.1 KiB
Raw Blame History

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 :

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 :

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} :

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