HS: hypersphere workflow + reproducible artifacts

[viral-satan]

HS: hypersphere workflow + reproducible artifacts

This PR adds a small, self-contained “hypersphere (HS)” workflow on top of vanilla CLASS to generate paper-ready summary tables and bundled artifacts in a fully reproducible way. It also introduces an optional S³ distance mapping (guarded by parameters), without changing default vanilla behavior.

What’s included
New make targets (developer UX)

make hs-run-all → one-shot run; writes:

hs_cmb_summary.tsv (z*, r_s, D_M(z*), θ*, ℓ*, and drag-epoch z_d, r_d, θ_d, ℓ_d)

hs_bao_summary.tsv (D_M, D_A, H, D_V, D_H, F_AP + ratios D_M/r_d, D_V/r_d, D_A/r_d, D_H/r_d)

hs_distances.tsv (dense grid: z, χ, D_M, D_A, H)

hs_distances_plus.tsv (adds D_L, E(z)=H/H₀, and distance modulus μ)

hs_summary.csv (consolidated table for the paper)

hs_meta.txt (rev/date/compiler/python metadata)

hs_artifacts.zip (bundle of the above)

make hs-cls-all → parses CLASS C_ℓ output and exports TSVs:

hs_cls_TT.tsv, hs_cls_EE.tsv, hs_cls_TE.tsv, hs_cls_BB.tsv

Derived D_ℓ = ℓ(ℓ+1) C_ℓ / 2π: hs_cls_TT_Dl.tsv, hs_cls_EE_Dl.tsv, hs_cls_TE_Dl.tsv

Zipped as hs_cls_artifacts.zip

make hs-publish → composes a timestamped bundle:

hs_artifacts__.zip containing hs_artifacts.zip, hs_cls_artifacts.zip, hs_meta.txt, README-HS.md

Helper targets: hs-summary, hs-dist-plus, hs-bundle, hs-verify, hs-release (wiring for CI/packaging)

Code changes (scoped & guarded)

Adds HS fields to background and parser hooks (INI params), defaulting to no-op on master.

Implements S³-mapped distances with guardrails (e.g., θ(z) = (τ₀ − τ(z))/R₀, D_M protection near π).

CMB/BAO summaries emitted before free, so they’re always captured.

All Python invocations routed via $(PYTHON) (defaults to python3), improving portability.

Scripts

scripts/hs_run.sh (repro runner)

scripts/hs_dist_plus.sh (derives D_L, E(z), μ from hs_distances.tsv)

scripts/hs_cls_tsv.sh (robust parsing of CLASS spectra to TSV + D_ℓ)

Docs

README-HS.md (two-line quickstart for the HS workflow)

[viral-satan]

HS run status (macOS / Apple clang / Python 3.9.6):

• Built hs_summary.csv
• Generated hs_cmb_summary.tsv, hs_bao_summary.tsv, hs_distances.tsv, hs_distances_plus.tsv
• Created hs_artifacts.zip (includes logs, TSVs, summary, meta)
• hs_meta.txt:
  rev: 800e252
  date: 2025-10-21T18:47:28Z
  cc: Apple clang version 17.0.0 (clang-1700.3.19.1)
  python: Python 3.9.6

No NaNs/Infs detected via make hs-verify.
hs_artifacts.zip

[viral-satan]

HS: hypersphere workflow run (macOS, Apple clang, Python 3.9.6)

Artifacts produced:

• hs_cmb_summary.tsv
• hs_bao_summary.tsv
• hs_distances.tsv
• hs_distances_plus.tsv
• hs_summary.csv
• hs_cls_{TT,EE,TE,BB}.tsv and *_Dl variants
• hs_all.log
• hs_meta.txt

hs_meta.txt:
rev: dd32b3c
date: 2025-10-21T18:51:39Z
cc: Apple clang version 17.0.0 (clang-1700.3.19.1)
python: Python 3.9.6

Verification:

• make hs-verify → No NaNs/Infs ✅

Bundle:

• hs_artifacts_dd32b3c_20251021T185139Z.zip (contains all above)
  hs_artifacts_dd32b3c_20251021T185139Z.zip