feat: import 6 physics modules from trinity monolith

README.md

@@ -1,45 +1,67 @@
 # zig-physics
 
-**Physics Simulation Library for Zig** — Quantum mechanics, QCD, gravity, dark matter, and beyond.
+[![Zig](https://img.shields.io/badge/Zig-0.15+-F7A41D?logo=zig&logoColor=white)](https://ziglang.org/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![DARPA CLARA](https://img.shields.io/badge/DARPA-CLARA-red)](https://www.darpa.mil/)
+[![Depends](https://img.shields.io/badge/depends-zig--golden--float-gold)](https://github.com/gHashTag/zig-golden-float)
 
-## Overview
+> **Theoretical physics library** — quantum mechanics, QCD, gravity, dark matter, baryogenesis, string theory — grounded in golden-ratio constants.
 
-A comprehensive physics simulation library covering:
+## ✨ Features
 
-| Module | Description |
-|--------|-------------|
-| `quantum/` | Quantum mechanics, wave functions, operators |
-| `quantum_gravity/` | Quantum gravity theories |
-| `qcd/` | Quantum Chromodynamics (strong force) |
-| `gravity/` | General relativity, spacetime metrics |
-| `dark_matter/` | Dark matter models and simulations |
-| `particle_physics/` | Standard Model, particles, interactions |
-| `plasma/` | Plasma physics, magnetohydrodynamics |
-| `baryogenesis/` | Early universe baryogenesis |
-| `monopoles/` | Magnetic monopole theory |
+- 🔬 **Quantum** — CHSH inequality, Bell states, wavefunctions, quantum gravity
+- 🔮 **QCD** — Quantum chromodynamics, color charge, particle physics
+- 🌑 **Gravity** — Gravitational constants, geodesics, sacred cosmology
+- ⚫ **Dark Matter** — Halo profiles, cosmological ratios
+- 🧪 **Baryogenesis** — Matter-antimatter asymmetry, before big bang
+- 🔻 **Plasma** — Plasma physics primitives
+- 🧲 **Monopoles** — Magnetic monopole models
+- ⚡ **Maxwell** — Electromagnetism with φ-optimization
+- 🎸 **String Theory** — Dualities, E8 lattice, spectrum, φ-bridge
 
-## Usage
+## 🏗️ Architecture
 
-```zig
-const physics = @import("zig-physics");
-
-// Quantum mechanics
-const psi = try physics.quantum.WaveFunction.init(allocator, 100);
+```
+src/
+├── quantum/           Quantum mechanics fundamentals
+├── qcd/               Quantum chromodynamics
+├── particle_physics/  Particle physics
+├── gravity/           General relativity, geodesics
+├── quantum_gravity/   Quantum gravity theories
+├── dark_matter/       Dark matter models
+├── baryogenesis/      Matter-antimatter asymmetry
+├── plasma/            Plasma physics
+├── monopoles/         Magnetic monopoles
+├── maxwell/           Maxwell equations
+├── string/            String theory foundations
+├── string_theory/     Advanced string theory
+├── superconductivity/ Superconductivity models
+├── cosmos/            Cosmology: big bang, dark energy
+└── root.zig           Main entry point
+```
 
-// Gravity
-const metric = physics.gravity.SchwarzschildMetric{ .mass = 1.989e30 };
+## 📦 Installation
 
-// Dark matter
-const halo = try physics.dark_matter.NFWHalo.init(allocator, params);
+```bash
+zig fetch --save https://github.com/gHashTag/zig-physics/archive/refs/heads/main.tar.gz
 ```
 
-## Scientific Context
+## 🌌 Trinity Ecosystem
+
+> Golden Ratio mathematics meets computational physics and AI.
 
-This library is designed for:
-- DARPA CLARA grant applications
-- Trinity AI physics simulations
-- Academic research publications
+| Repository | Purpose | Status |
+|---|---|---|
+| [trinity](https://github.com/gHashTag/trinity) | 🎯 Orchestrator, agents, API, MCP server | ✅ Main |
+| [zig-golden-float](https://github.com/gHashTag/zig-golden-float) | 🔢 Numeric core: GF16, TF3, VSA, JIT | ✅ Core |
+| [trinity-training](https://github.com/gHashTag/trinity-training) | 🧠 ML: HSLM, benchmarks, datasets | ✅ |
+| [zig-physics](https://github.com/gHashTag/zig-physics) | ⚛️ Physics: QCD, gravity, cosmology | ✅ Here |
+| [zig-agents](https://github.com/gHashTag/zig-agents) | 🤖 Agents: MCP, autonomous | ✅ |
+| [t27](https://github.com/gHashTag/t27) | 📜 Ternary SSOT + Rust bootstrap | 📜 Language |
+| [vibee-lang](https://github.com/gHashTag/vibee-lang) | 🎵 VIBEE language spec (.tri/.vibee) | 📜 Language |
+| [zig-hdc](https://github.com/gHashTag/zig-hdc) | 🧩 Hyperdimensional: VSA, HRR | ✅ |
+| [zig-sacred-geometry](https://github.com/gHashTag/zig-sacred-geometry) | 📐 Sacred φ-geometry, Beal | ✅ |
 
-## License
+## 📜 License
 
-MIT — Copyright (c) 2026 Trinity Project
+MIT © gHashTag

build.zig.zon

@@ -1 +1,9 @@
-{.name: "zig-physics", version: "0.1.0", dependencies: {}}
+{
+  .name = zig_physics,
+  .version = "0.1.0",
+  .dependencies = .{
+    .zig_golden_float = .{
+      .url = "https://github.com/gHashTag/zig-golden-float/archive/main.tar.gz",
+    },
+  },
+}