# QFD-Universe

**Quantum Field Dynamics: A geometric algebra framework deriving fundamental constants from alpha = 1/137.036**

[![Lean4](https://img.shields.io/badge/Lean4-1100+_Theorems-green)](formalization/)
[![Visualizations](https://img.shields.io/badge/Visualizations-21_Interactive-blue)](visualizations/)
[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)

---

## Quick Start: Replicate Everything

```bash
git clone https://github.com/tracyphasespace/QFD-Universe.git
cd QFD-Universe
pip install -r requirements.txt
python run_all.py
```

This runs all validated sector tests and prints:

```
  QFD-Universe Validation Summary
  ======================================================================
  Sector         Test                             Time     Status
  ----------------------------------------------------------------------
  lepton         Lepton masses (Golden Loop)       20.1s   PASS
  lepton         g-2 anomaly prediction            18.3s   PASS
  lepton         Koide relation Q=2/3               0.2s   PASS
  nuclear        Nuclide scaling law                42.0s   PASS
  cosmology      Supernova cosmology fit           480.0s   PASS
  cross-scale    Golden Loop pipeline               28.0s   PASS
  ----------------------------------------------------------------------
  Total: 6 passed, 0 failed, 0 skipped
  ======================================================================
```

Run a single sector: `python run_all.py --sector lepton`

---

## What is QFD?

**Quantum Field Dynamics** proposes that:

1. **Vacuum is a dynamic medium** with stiffness parameter beta derived from alpha
2. **Particles are topological structures** (solitons, vortices) in this medium
3. **Mass arises geometrically** from energy balance in these structures
4. **One input (alpha = 1/137) derives the rest** via the Golden Loop equation

For the full theoretical background, see [THEORY.md](THEORY.md).

---

## Validated Sectors

### Lepton Physics — [lepton/](lepton/)
| Test | Result | Runtime |
|------|--------|---------|
| [Golden Loop](lepton/golden-loop/) (alpha -> beta -> e, mu, tau) | chi^2 < 10^-11 | 20s |
| [g-2 Prediction](lepton/g2-prediction/) (anomalous magnetic moment) | 0.45% error, no free params | 20s |
| [Koide Relation](lepton/koide-relation/) (Q = 2/3 geometric proof) | Exact | instant |

### Nuclear Physics — [nuclear/](nuclear/)
| Test | Result | Runtime |
|------|--------|---------|
| [Soliton Solver](nuclear/soliton-solver/) (3,558 nuclear masses) | <1% error (light nuclei) | 5-30m |
| [Nuclide Scaling](nuclear/nuclide-scaling/) (5,842 isotopes) | R^2 = 0.98 | <1m |

### Cosmology — [cosmology/](cosmology/)
| Test | Result | Runtime |
|------|--------|---------|
| [Supernova Fit](cosmology/supernova-fit/) (1,829 Type Ia SNe) | chi^2/nu = 0.939 (matches Lambda-CDM) | 10-20m |
| [SN Transparency](cosmology/sn-transparency/) (full raw pipeline) | Reproducible end-to-end | 30m-4h |
| [Black Hole Dynamics](cosmology/blackhole-dynamics/) (escape simulation) | ~1% escape rate | variable |

### Cross-Scale — [cross-scale/](cross-scale/)
| Test | Result | Runtime |
|------|--------|---------|
| [Ten Realms Pipeline](cross-scale/ten-realms/) (alpha -> beta -> masses) | chi^2 < 10^-9 | 30s |

---

## Exploration Lab — [exploration/](exploration/)

Active investigations, **not validated predictions**. Includes MCMC parameter estimation, CMB derivations, deuterium tests, model comparisons, and more. See [exploration/README.md](exploration/README.md) for the full list.

---

## Interactive Visualizations

**No installation required** — open in any browser:

- **[QFD Engine](https://tracyphasespace.github.io/QFD-Universe/visualizations/qfd_engine.html)** — 21 interdependent parameters from vacuum stiffness beta
- [QFD Primer](https://tracyphasespace.github.io/QFD-Universe/visualizations/field-theory/qfd-primer.html) — Start here
- [Vortex Dynamics](https://tracyphasespace.github.io/QFD-Universe/visualizations/field-theory/vortex-dynamics.html) — Topological structures
- [Black Hole Dynamics](https://tracyphasespace.github.io/QFD-Universe/visualizations/astrophysics/blackhole-dynamics.html)
- [Lepton Analysis](https://tracyphasespace.github.io/QFD-Universe/visualizations/particle-physics/leptons-analysis.html)
- [Nuclide Table](https://tracyphasespace.github.io/QFD-Universe/visualizations/particle-physics/nuclide-table.html)

Full list: [visualizations/README.md](visualizations/README.md)

---

## Formal Proofs (Lean 4)

The `formalization/` directory contains 1,100+ formally verified theorems proving:

- Spacetime emergence from Clifford algebra Cl(3,3)
- Charge quantization from topological boundary conditions
- CMB axis alignment (paper-ready cosmology proofs)
- Lepton mass spectrum geometric derivation
- Nuclear binding from vacuum stiffness

```bash
cd formalization
lake update && lake build QFD
```

---

## Repository Structure

```
QFD-Universe/
├── run_all.py              # Master validation runner
├── requirements.txt        # pip install -r requirements.txt
│
├── lepton/                 # Validated: masses, g-2, Koide
├── nuclear/                # Validated: soliton solver, nuclide scaling
├── cosmology/              # Validated: supernovae, black holes
├── cross-scale/            # Validated: alpha -> beta -> masses pipeline
├── exploration/            # Active research (not validated)
│
├── formalization/          # Lean 4 proofs (1,100+ theorems)
├── visualizations/         # Interactive HTML demos (21)
├── data/experimental/      # Reference values (PDG, AME2020)
│
├── scripts/publish.sh      # Sync from working repo
├── THEORY.md               # Physics background
└── docs/                   # GitHub Pages, LLM indexes
```

---

## Epistemic Honesty

This framework is mathematically rigorous (1,100 Lean proofs) but **empirically unproven**.

**What the proofs establish**: Internal consistency. IF the framework is correct, THEN it is self-consistent.

**What they don't establish**: That the framework describes nature. Fitting 3 masses with 3 parameters is necessary but not sufficient.

**The acid test**: The g-2 prediction (0.45% accuracy on an independent observable) is the strongest evidence. Everything else is fitted.

**What's needed**: Independent predictions tested against new data (charge radius, form factors, beta from first principles).

---

## For AI/LLM Tools

| Resource | URL |
|----------|-----|
| File Index | https://tracyphasespace.github.io/QFD-Universe/llms.txt |
| JSON Index | https://tracyphasespace.github.io/QFD-Universe/files.json |

---

## License

MIT License — See [LICENSE](LICENSE)

---

## Citation

See [CITATION.cff](CITATION.cff) for citation information.