# DFD-QCD Lattice Boundary Program II — Reproducibility Supplement

This directory is the full reproducibility/archival supplement for **Appendix AQ**
("Executed Lattice-QCD Validation of the DFD QCD Ledger") and **Appendix AS**
("Lattice Boundary Program: Staged Execution and Provenance") of the DFD v4.0
master manuscript. It contains the validated code, the actual run outputs, the
analysis scripts, the figures, and the standalone Program II paper.

## Contents
- `src/` — validated SU(3) lattice code:
  - `su3_fast.py` — numba pure-gauge engine (Metropolis + Cabibbo–Marinari
    overrelaxation; red-black checkerboard **parallel** update; APE smearing with
    maximal-trace SU(3) projection; Wilson loops; 0++ glueball operator).
  - `wilson_hmc.py` — from-scratch Nf=2 unimproved-Wilson HMC (validation gates;
    loose-CG force / tight-CG Hamiltonian split; parallel force/link kernels).
  - `kscan_driver.py` — multi-κ-per-process driver for the dynamical κ-scan.
  - `analyze_potential.py`, `continuum_extrap.py`, `analyze_glueball.py`,
    `make_potential_plots.py` — analysis + figure generation.
  - `su3_pure_gauge.py`, `unquenched_hmc_scaffold.py`, `make_plots.py` — the
    original Program I prototype code (archived).
- `results/` — actual run outputs:
  - `results_prod/` — 16⁴ and 20⁴ pure-gauge string-tension runs (β=5.8–6.2),
    per-measurement CSVs + summary JSONs + the continuum/string-tension analyses.
  - `results_glue/` — 16⁴ β=6.0 glueball ensemble (timeslice operators .npz) + analysis.
  - `results_kscan/` — 6⁴ β=5.6 dynamical Nf=2 κ-scan summaries + quenched reference.
  - `results_hmc/` — HMC validation/tuning runs and the matched quenched references.
- `data/` — compact curated CSV result tables (one row per reported number).
- `figures/` — figure renders for the standalone Program II paper and analysis
  outputs (some are script outputs not embedded in any document). Same-named
  files under the deposit root `figures/` are the main paper's own independent
  renders — intentionally different plots (e.g. the root `static_potential.png`
  is Appendix AQ's Cornell-form reconstruction; this directory's is the
  five-beta data plot of the standalone paper).
- `main_program_II_standalone.tex` — LaTeX source of the standalone Program II
  paper (per-run execution logs are inside `results/results_*/`).
- `RESULTS.md` — full prose results writeup with honest boundaries.
- `main_program_II_standalone.pdf` — the standalone Program II paper.
- `requirements.txt` — Python dependencies (numpy, numba, matplotlib).

## Reproduce (representative)
```bash
python3 src/su3_fast.py  --L 16 --beta 6.0 --potential --parallel   # string tension
python3 src/su3_fast.py  --L 20 --beta 6.2 --potential --parallel   # box-size check
python3 src/su3_fast.py  --L 16 --beta 6.0 --glueball               # 0++ glueball
python3 src/wilson_hmc.py --test                                    # HMC validation gates
python3 src/kscan_driver.py 0.148 0.150 0.152 0.154 0.155 0.156     # dynamical kappa-scan
python3 src/analyze_potential.py ; python3 src/continuum_extrap.py
python3 src/analyze_glueball.py ; python3 src/make_potential_plots.py
```

## Status discipline
Pure-gauge (string tension, glueball) is quenched; the dynamical sector is an HMC
engine validation + κ-scan, not a physical-point ensemble; no continuum or
infinite-volume extrapolation is claimed. Scale-free dimensionless ratios
(r₀√σ ≈ 1.19, m₀₊₊/√σ ≈ 3.7) are the primary outputs; MeV values are
scale-convention dependent. See Appendix AQ for the consolidated discussion.
