feat(M12.2-M12.3): combine particle phenomenology, hadrons, and QCD

MODELS.md

@@ -8,6 +8,7 @@ OpenWave hosts multiple candidate field-theoretic models. Historical M4--M8 resu
 | **M9** | **CAT/EPT Pauli--Hartree--U(1) dynamics** | **`MODELS_M9.md`** | **stable M9.126 evidence aliases plus latest M9.141 integration aliases** |
 | **M10** | **CAT/EPT Dirac--Cartan--2I--Compton--Yukawa and SU(3) color matter** | **`MODELS_M10.md`** | **latest M10.8 registration, Wilson refinement and decoherence spectra** |
 | **M11** | **CAT/EPT pointwise soliton--Liouville--QDO model** | **`MODELS_M11.md`** | **M11.1--M11.5 executable lineage and theorem-pinned ledgers** |
+| **M12** | **CAT/EPT particle-zoo coverage model** | **`MODELS_M12.md`** | **M12.1--M12.3 executable identity, electroweak, flavor, hadron and QCD coverage** |
 
 ## M9 stable and latest lineage
 
@@ -22,3 +23,7 @@ M10 constructs a distinct four-spinor model rather than replacing M9. Its curren
 ## M11 pointwise soliton--Liouville--QDO comparison model
 
 M11 begins from an exact normalized pointwise bright soliton, constructs its pure Liouville density tensor in controlled finite cutoffs of an infinite mode set, and derives the Lennard--Jones `-C6/R6` and Axilrod--Teller `C9/R9` interactions from one QDO response model. Its optional QCD sector reuses M10's SU(3) engine. The final campaign adds conservative and entropic center dynamics plus tensor dephasing without claiming a completed infinite-particle Fock space or a calibrated physical particle identity.
+
+## M12 particle-zoo coverage model
+
+M12 mirrors the particle-zoo theorem surfaces as executable checks: the 17 Standard-Model particle types and 12 gauge states, CPT and additive selection rules, tree-level electroweak/lepton/neutrino relations, named-hadron flavor composition, SU(3) mass formulas and one-loop QCD running. Empirical masses, lifetimes, branching fractions, couplings and mixing parameters remain explicitly supplied inputs.

MODELS_M12.md

@@ -0,0 +1,43 @@
+# OpenWave M12 CAT/EPT particle-zoo coverage model
+
+M12 is an executable coverage layer over the particle, electroweak, lepton,
+neutrino, hadron, and QCD theorem surfaces in `entropic-physlib-linear-full`.
+It does not replace M9--M11.
+
+## Lineage
+
+| Milestone | Executable result |
+| --- | --- |
+| M12.1 | all 17 Standard-Model particle types, 12 gauge states, CPT pairing, additive `(Q,B,L)` and flavor selection rules |
+| M12.2 | tree-level electroweak mass matrix, couplings, cross sections and widths; charged-lepton identities; supplied-parameter PMNS vacuum oscillations |
+| M12.3 | six-flavor quark data, named-hadron flavor composition, Gell-Mann--Nishijima, SU(3) mass relations, one-loop `alpha_s` running, and M10 QCD integration |
+
+## Claim boundary
+
+M12 separates four classes of statements:
+
+1. **Exact finite structure:** particle counts, charges, spins, CPT conjugation,
+   additive conservation and flavor composition.
+2. **Exact consequences of supplied models:** tree-level electroweak relations,
+   PMNS unitarity, SU(3) mass-formula identities and one-loop QCD running.
+3. **Empirical inputs:** PDG masses, lifetimes, branching fractions, gauge
+   couplings, PMNS angles and mass splittings.
+4. **Not claimed:** radiative corrections, decay matrix elements, first-principles
+   Yukawa values, first-principles quark/hadron masses, or collider-grade cross
+   sections.
+
+## Formal authority
+
+The ledgers pin `jagg-ix/entropic-physlib-private`, branch
+`entropic-physlib-linear-full`, TIP
+`8bafa9ab93cbb39e85909fc3837bb4b6e0dec748`.
+
+## Reproduction
+
+```bash
+PYTHONPATH=. python - <<'PY'
+from openwave.xperiments.m12_particle_zoo import run_particle_zoo_model_study
+import json
+print(json.dumps(run_particle_zoo_model_study(), indent=2, sort_keys=True, default=str))
+PY
+```

openwave/xperiments/m12_particle_zoo/__init__.py

@@ -1,3 +1,5 @@
 """M12 CAT/EPT particle-zoo executable lineage."""
 from .standard_model_zoo_m121 import run_standard_model_zoo_study
-__all__ = ["run_standard_model_zoo_study"]
+from .electroweak_lepton_neutrino_m122 import run_electroweak_lepton_neutrino_study
+from .quark_hadron_qcd_spectrum_m123 import run_particle_zoo_model_study
+__all__ = ["run_standard_model_zoo_study", "run_electroweak_lepton_neutrino_study", "run_particle_zoo_model_study"]