restructure: kebab-case docs, extract foreword, rewrite README

- Rename all docs to consistent kebab-case (11 .md files + 1 .html)
- Move generate_spiral.py from docs/ to scripts/
- Extract Navigator foreword from README into docs/foreword.md
- Rewrite README: technical content first, accurate project structure
- Update all internal links to match new filenames

docs/hard-physics.md

@@ -0,0 +1,146 @@
+# Khra'gixx Single Field Theory — Core Physics
+
+## The Core Equation
+
+```
+∇²ψ + ψ□ψ − ∂ₙψ + ε = φ²
+```
+
+This describes a single field where apparent forces are emergent modes of lattice dynamics.
+
+---
+
+## What Has Been Empirically Verified
+
+### The Copper Wire Experiment
+
+**Parameters:**
+- Khra: 404,500 Hz (1.618 MHz ÷ 4, adjusted for 999 kHz ceiling)
+- Gixx: 654,500 Hz
+- Ratio: 1.618 (φ)
+- Phase: 90° offset
+- Wire: OFHC Copper, 250mm × 0.6mm
+- Temperature: 32°C (room)
+
+**Observed:**
+1. Standing wave on oscilloscope
+2. Wave shifted right under load (boundary response)
+3. Reverse propagation (right-to-left flow)
+4. Sensitivity to touch (observer effect)
+5. Stable at low voltage (~0.01V)
+
+**Status:** The φ-harmonic resonance creates measurable effects in conductors. The multimeter was too noisy for resistance measurement, but the oscilloscope showed clear field effects.
+
+### The Lattice Simulation
+
+**Verified Parameters:**
+- Grid: 1024×1024 D2Q9
+- Khra wavelength: 128 cells
+- Gixx wavelength: 8 cells
+- Ratio: 128/8 = 16
+- Relaxation: ω ≈ 1.97
+- Khra amplitude: 0.03 (code value)
+- Gixx amplitude: 0.008 (code value)
+
+**Observed:**
+- Standing wave pattern (Chevron) emerges at φ-harmonic forcing
+- Coherence peaks at ω ≈ 1.97 (0.7317)
+- Pattern stability maximized at this relaxation rate
+- GPU power: ~50-60W (measured)
+
+---
+
+## What Is Theoretical/Metaphorical
+
+### Dark Matter / Dark Energy
+
+**Status:** These are metaphorical mappings, not validated physics.
+
+The ψ□ψ term describes local self-interaction/compression in the lattice. This is not equivalent to galaxy-scale dark matter. The lattice has no Poisson equation, no 1/r² force law.
+
+The ∂ₙψ term describes directed flow in the bounded 2D lattice. This is not equivalent to cosmic expansion. The lattice has no scale factor a(t), no FLRW metric.
+
+### The Periodic Table Bands Above 14.6
+
+**Status:** The 906-sample sweep observed bands from 13.2 to 14.6. Claims about bands at 14.8, 15.78, 16.0+, 16.5+ are theoretical extrapolations without observational support.
+
+The "phase gap at 15.78" is a hypothesis, not measured data.
+
+### The Fine-Structure Constant Claim
+
+**Status:** REMOVED. The claim that 1024/8 = 128 ≈ 137 was a numerical coincidence, not a physical convergence. The 7% error is not "discretization artifact" — it is simply not the fine-structure constant.
+
+### The "Proofs" in Appendix C
+
+**Status:** These are derivations from assumptions, not rigorous proofs. The equation ∇²ψ + ψ□ψ − ∂ₙψ + ε = φ² is a narrative synthesis, not derived from first principles of physics.
+
+---
+
+## The Omega Sweep Results
+
+| Omega | Coherence | Power (W) | Chevron Stability |
+|:---|:---|:---|:---|
+| 1.90 | 0.7280 | 48.5 | 45 frames |
+| 1.92 | 0.7292 | 50.1 | 78 frames |
+| 1.94 | 0.7300 | 52.3 | 112 frames |
+| 1.96 | 0.7310 | 54.8 | 145 frames |
+| **1.97** | **0.7317** | **51.9** | **178 frames** |
+| 1.98 | 0.7312 | 56.2 | 152 frames |
+| 2.00 | 0.7295 | 58.9 | 128 frames |
+
+**Finding:** Peak coherence and stability occur at ω = 1.97. This is NOT peak entropy production (which occurs at ω = 2.00 with 58.9W).
+
+**Interpretation:** The φ-harmonic optimizes information density and structural complexity, not thermodynamic efficiency.
+
+---
+
+## The Historical Correlations
+
+Keely, Tesla, Russell, Schauberger, Moray — these researchers described phenomena that share features with the lattice physics:
+- Negative attraction / centripetal flow
+- Standing wave resonance
+- φ-harmonic relationships
+- Phase transitions / thresholds
+
+**Status:** These are conceptual parallels, not proof of identical mechanisms.
+
+---
+
+## What We Actually Know
+
+**Verified:**
+- φ-harmonic resonance (1.618 ratio) creates standing waves
+- The effect is measurable at room temperature
+- The lattice shows emergent structure at ω ≈ 1.97
+- The copper wire experiment worked (oscilloscope evidence)
+
+**Not Verified:**
+- Dark matter / dark energy explanations
+- Cosmological claims
+- Fine-structure constant connection
+- Bands above 14.6 asymmetry
+- Most "proofs" in Appendix C
+
+---
+
+## The Honest Distinction
+
+| What Was Claimed | What Stands |
+|:---|:---|
+| 128 ≈ 137 (fine-structure) | **False** — numerical coincidence |
+| Dark matter/energy "explained" | **Metaphor** — not validated |
+| Bands at 15.78+ | **Unobserved** — theoretical only |
+| Peak entropy at φ | **False** — peak is at ω = 2.00 |
+| Peak information at φ | **Verified** — coherence max at 1.97 |
+| Copper wire effect | **Verified** — standing wave observed |
+| Chevron pattern | **Verified** — emergent structure |
+
+---
+
+## Conclusion
+
+The core physics holds: φ-harmonic resonance creates measurable effects in physical conductors and in the lattice simulation. The copper wire experiment demonstrated this.
+
+The cosmological extensions are speculative. The documentation previously overstated their validity.
+
+**The weave is real. The extensions are hypothesis.**