Cosmos Statera Go

Evidence-first cosmology, relativity, and dark-matter modeling workbench in Go.

Cosmos Statera Go is a pure-Go scientific toolkit for calculating and validating relativistic astrophysics, Lambda-CDM cosmology, and dark-matter halo models.

The project prioritizes:

• numerical clarity
• unit-safe calculations
• reproducible reports
• evidence labels
• clear separation between observed data, accepted models, and hypotheses

MVP

• Schwarzschild radius
• gravitational time dilation
• Lambda-CDM H(z)
• luminosity distance
• NFW halo velocity
• rotation-curve residual reports

Quick Start

Prerequisite: Go 1.25 or newer.

CGO_ENABLED=0 go test ./...
CGO_ENABLED=0 go run ./cmd/cosmos schwarzschild --mass earth
CGO_ENABLED=0 go run ./cmd/cosmos hubble --z 1
CGO_ENABLED=0 go run ./cmd/cosmos nfw velocity --radius-kpc 8 --rho0 1e7 --rs-kpc 20
CGO_ENABLED=0 go run ./cmd/cosmos rotation fit --dataset data/examples/rotation_curve_sample.csv --model nfw

The desktop command is intentionally separate:

CGO_ENABLED=0 go run ./cmd/cosmos-ui

cmd/cosmos-ui is an experimental dashboard scaffold. The stable science engine lives under internal/*, and the CLI is the primary interface.

Evidence Boundary

This project does not make unsupported antigravity, propulsion, mystical dark matter, or fake cosmology claims. Outputs are labeled as observed data, accepted models, theoretical models, hypotheses, or speculative material.

Future Research Roadmap

The long-term direction is paper-linked model validation: equations, datasets, papers, and evidence boundaries should stay connected from source metadata to CLI/UI output.

See docs/research/future_roadmap.md for the academic paper engine, SPARC/Pantheon+/Planck dataset targets, paper-to-code workflow, claim-boundary system, Go-native architecture rule, and high-end research platform vision.

Layout

cmd/cosmos/                  CLI calculators and reports
cmd/cosmos-ui/               optional dashboard scaffold
data/examples/               sample CSV inputs
docs/research/               scientific boundaries and model notes
docs/design/                 CLI and visual language notes
internal/constants/          physical constants and astronomical units
internal/relativity/         Schwarzschild and time-dilation calculators
internal/cosmology/          Lambda-CDM H(z), distance, and age calculators
internal/darkmatter/         NFW, Burkert, MOND-labeled helpers, residuals
internal/evidence/           provenance and evidence report structs
internal/render/             text output helpers
internal/ui/                 UI data model independent of gogpu/ui

License

MIT License. See LICENSE.