vedic-ghadi 1.0.0__tar.gz

vedic_ghadi-1.0.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: vedic-ghadi
+Version: 1.0.0
+Summary: Substrate-derived Vedic clock — Kāmākhyā-anchored, Sūrya-Siddhānta-canonical, zero foreign theorem.
+Author-email: Pardeep Sehrawat <theunholyindianmagician@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/theunholyindianmagician-lab/vedic-ghadi
+Project-URL: Issues, https://github.com/theunholyindianmagician-lab/vedic-ghadi/issues
+Keywords: vedic,jyotish,panchang,tithi,ghadi,kaal,sanskrit
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110; extra == "server"
+Requires-Dist: uvicorn[standard]>=0.27; extra == "server"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+
+# vedic-ghadi (Python)
+
+Substrate-derived Vedic clock library + CLI + FastAPI service.
+
+```bash
+pip install -e .                # CLI only
+pip install -e ".[server]"      # + FastAPI service
+pip install -e ".[dev]"         # + pytest
+
+vedic-ghadi
+vedic-ghadi --loop
+vedic-ghadi --at "2026-05-17 16:30" --json
+uvicorn vedic_ghadi.api:app --port 8765
+```
+
+See the project root README for full architecture + deployment notes.

vedic_ghadi-1.0.0/README.md

@@ -0,0 +1,16 @@
+# vedic-ghadi (Python)
+
+Substrate-derived Vedic clock library + CLI + FastAPI service.
+
+```bash
+pip install -e .                # CLI only
+pip install -e ".[server]"      # + FastAPI service
+pip install -e ".[dev]"         # + pytest
+
+vedic-ghadi
+vedic-ghadi --loop
+vedic-ghadi --at "2026-05-17 16:30" --json
+uvicorn vedic_ghadi.api:app --port 8765
+```
+
+See the project root README for full architecture + deployment notes.

vedic_ghadi-1.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vedic-ghadi"
+version = "1.0.0"
+description = "Substrate-derived Vedic clock — Kāmākhyā-anchored, Sūrya-Siddhānta-canonical, zero foreign theorem."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Pardeep Sehrawat", email = "theunholyindianmagician@gmail.com" },
+]
+keywords = ["vedic", "jyotish", "panchang", "tithi", "ghadi", "kaal", "sanskrit"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = []
+
+[project.optional-dependencies]
+server = [
+    "fastapi>=0.110",
+    "uvicorn[standard]>=0.27",
+]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "httpx>=0.27",
+]
+
+[project.urls]
+Homepage = "https://github.com/theunholyindianmagician-lab/vedic-ghadi"
+Issues = "https://github.com/theunholyindianmagician-lab/vedic-ghadi/issues"
+
+[project.scripts]
+vedic-ghadi = "vedic_ghadi.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["vedic_ghadi*"]
+exclude = ["tests*"]

vedic_ghadi-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vedic_ghadi-1.0.0/tests/test_api.py

@@ -0,0 +1,64 @@
+"""🔱 FastAPI service — endpoint smoke tests."""
+
+from __future__ import annotations
+
+import pytest
+
+try:
+    from fastapi.testclient import TestClient
+    from vedic_ghadi.api import app
+    client = TestClient(app)
+    _have_fastapi = True
+except ImportError:
+    _have_fastapi = False
+
+
+pytestmark = pytest.mark.skipif(not _have_fastapi, reason="fastapi not installed")
+
+
+def test_healthz():
+    r = client.get("/healthz")
+    assert r.status_code == 200
+    assert r.json()["status"] == "ok"
+
+
+def test_landing_html():
+    r = client.get("/")
+    assert r.status_code == 200
+    assert "Vedic Ghaḍī" in r.text
+    assert "/now" in r.text
+    assert "/docs" in r.text
+
+
+def test_now_default_tz():
+    r = client.get("/now")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["input_civil"]["tz_h"] == 5.5
+    assert "year_layer" in body
+    assert "day_subdivision" in body
+
+
+def test_now_with_tz():
+    r = client.get("/now?tz=0")
+    assert r.status_code == 200
+    assert r.json()["input_civil"]["tz_h"] == 0.0
+
+
+def test_at_iso_format():
+    r = client.get("/at?date=2026-05-17T16:00:00&tz=5.5")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["year_layer"]["samvatsara"]["name"] == "Parābhava"
+    assert body["vara_layer"]["vara_name"] == "Ravivāra"
+    assert body["month_layer"]["masa_name"] == "Jyeṣṭha"
+
+
+def test_at_date_only():
+    r = client.get("/at?date=2026-05-17")
+    assert r.status_code == 200
+
+
+def test_at_bad_format():
+    r = client.get("/at?date=not-a-date")
+    assert r.status_code == 400

vedic_ghadi-1.0.0/tests/test_parity.py

@@ -0,0 +1,92 @@
+"""
+🔱 Python / TypeScript parity test.
+
+Runs the TypeScript port via Node's --experimental-strip-types on the same
+anchor inputs as the Python reference, and asserts agreement on every
+named/integer field of the stamp.
+
+Skipped automatically if Node is missing or older than 22 (no native TS stripping).
+"""
+
+from __future__ import annotations
+
+import json
+import shutil
+import subprocess
+from pathlib import Path
+
+import pytest
+
+from vedic_ghadi import ghadi_at
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+SHIM = REPO_ROOT / "frontend" / "lib" / "_parity_shim.mts"
+
+
+def _node_supports_strip_types() -> bool:
+    if not shutil.which("node"):
+        return False
+    try:
+        out = subprocess.check_output(
+            ["node", "--version"], stderr=subprocess.STDOUT, timeout=5,
+        ).decode().strip().lstrip("v")
+        major = int(out.split(".")[0])
+        return major >= 22
+    except (subprocess.CalledProcessError, ValueError, IndexError):
+        return False
+
+
+HAVE_NODE = _node_supports_strip_types()
+
+
+def _ts_stamp(args: tuple[int, int, int, int, int, float, float]) -> dict:
+    cmd = [
+        "node", "--experimental-strip-types", "--no-warnings",
+        str(SHIM),
+        *[str(a) for a in args],
+    ]
+    try:
+        proc = subprocess.run(cmd, capture_output=True, timeout=15, check=True)
+    except subprocess.CalledProcessError as e:
+        pytest.fail(f"Node parity shim failed:\n{e.stderr.decode()}")
+    return json.loads(proc.stdout.decode())
+
+
+@pytest.mark.skipif(not HAVE_NODE, reason="node ≥ 22 not available (needs --experimental-strip-types)")
+@pytest.mark.parametrize("args", [
+    (2026, 5, 17, 16, 0, 0.0, 5.5),    # Today's anchor
+    (2026, 1, 1, 0, 0, 0.0, 5.5),      # Year start
+    (2000, 6, 15, 12, 30, 0.0, 5.5),   # Y2K
+    (1947, 8, 15, 0, 0, 0.0, 5.5),     # Independence
+])
+def test_python_ts_parity(args):
+    py = ghadi_at(*args)
+    ts = _ts_stamp(args)
+
+    # Year layer
+    assert py["year_layer"]["kali_year_current"] == ts["year_layer"]["kali_year_current"]
+    assert py["year_layer"]["kali_year_completed"] == ts["year_layer"]["kali_year_completed"]
+    assert py["year_layer"]["vikrama_samvat"] == ts["year_layer"]["vikrama_samvat"]
+    assert py["year_layer"]["shaka_samvat"] == ts["year_layer"]["shaka_samvat"]
+    assert py["year_layer"]["samvatsara"]["name"] == ts["year_layer"]["samvatsara"]["name"]
+    assert py["year_layer"]["samvatsara"]["index"] == ts["year_layer"]["samvatsara"]["index"]
+
+    # Month / tithi / vāra
+    assert py["month_layer"]["masa_name"] == ts["month_layer"]["masa_name"]
+    assert py["month_layer"]["masa_index"] == ts["month_layer"]["masa_index"]
+    assert py["month_layer"]["sun_sign_index"] == ts["month_layer"]["sun_sign_index"]
+    assert py["tithi_layer"]["tithi_name"] == ts["tithi_layer"]["tithi_name"]
+    assert py["tithi_layer"]["tithi_index"] == ts["tithi_layer"]["tithi_index"]
+    assert py["tithi_layer"]["paksha_name"] == ts["tithi_layer"]["paksha_name"]
+    assert py["vara_layer"]["vara_name"] == ts["vara_layer"]["vara_name"]
+    assert py["vara_layer"]["vara_index"] == ts["vara_layer"]["vara_index"]
+
+    # Day subdivision (every integer must match)
+    assert py["day_subdivision"]["muhurta_index"] == ts["day_subdivision"]["muhurta_index"]
+    assert py["day_subdivision"]["ghati_index"] == ts["day_subdivision"]["ghati_index"]
+    assert py["day_subdivision"]["vighati_index"] == ts["day_subdivision"]["vighati_index"]
+    assert py["day_subdivision"]["prana_index"] == ts["day_subdivision"]["prana_index"]
+
+    # Kali day count — within a microsecond
+    assert abs(py["kali_civil_days_at_kamakhya"]
+               - ts["kali_civil_days_at_kamakhya"]) < 1e-5

vedic_ghadi-1.0.0/tests/test_substrate.py

@@ -0,0 +1,189 @@
+"""
+🔱 Substrate correctness — anchor tests against known canonical values.
+
+These are not approximate vibe-checks; they are anchor points where the
+substrate's output is determined by Sūrya Siddhānta constants alone, so
+the values are reproducible across any compliant implementation.
+"""
+
+from __future__ import annotations
+
+import math
+
+import pytest
+
+from vedic_ghadi import (
+    ghadi_at,
+    civil_input_to_kali_civil_days,
+)
+from vedic_ghadi.substrate import (
+    KALI_DAYS_PER_YEAR, MAHAYUGA_CIVIL_DAYS, MAHAYUGA_YEARS,
+    samvatsara_at_kali_year, vedic_mean_longitude,
+    vedic_vara_at_kali_days,
+    KAMAKHYA_LMT_OFFSET_H,
+)
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Sūrya Siddhānta constants — verbatim from canon
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_mahayuga_constants():
+    assert MAHAYUGA_YEARS == 4_320_000
+    assert MAHAYUGA_CIVIL_DAYS == 1_577_917_500
+    # Exact division: 1_577_917_500 / 4_320_000 = 365.258680555…
+    assert KALI_DAYS_PER_YEAR == pytest.approx(365.25868055555554, abs=1e-9)
+
+
+def test_kamakhya_meridian():
+    # 91.7059° / 15 = 6.11373... LMT offset from Greenwich
+    assert KAMAKHYA_LMT_OFFSET_H == pytest.approx(6.1137267, abs=1e-6)
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Kali day count — anchor at the substrate's snapshot moment
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_known_kali_day_anchor():
+    """2026-05-17 16:00:00 IST — the substrate's canonical day count."""
+    kd = civil_input_to_kali_civil_days(2026, 5, 17, 16, 0, 0, 5.5)
+    # Computed canonically from JD-UT → Kāmākhyā Kali days (Sūrya Siddhānta)
+    assert kd == pytest.approx(1_872_712.647997, abs=1e-5)
+
+
+def test_kali_day_progresses_one_per_civil_day():
+    a = civil_input_to_kali_civil_days(2026, 1, 1, 0, 0, 0, 5.5)
+    b = civil_input_to_kali_civil_days(2026, 1, 2, 0, 0, 0, 5.5)
+    assert (b - a) == pytest.approx(1.0, abs=1e-9)
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Saṃvatsara cycle — Parābhava (#40) at 2026-05-17 anchor
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_samvatsara_at_anchor():
+    stamp = ghadi_at(2026, 5, 17, 16, 0, 0, 5.5)
+    sv = stamp["year_layer"]["samvatsara"]
+    assert sv["name"] == "Parābhava"
+    assert sv["index"] == 39   # 0-based
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Vāra — Kali Yuga begins on Śukravāra, so day-0 must be Friday
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_kali_day_zero_is_shukravara():
+    v = vedic_vara_at_kali_days(0.0)
+    assert v["vara_name"] == "Śukravāra"
+    assert v["vara_index"] == 5
+    assert v["vara_lord_graha"] == "Venus"
+
+
+def test_kali_day_one_is_shanivara():
+    v = vedic_vara_at_kali_days(1.0)
+    assert v["vara_name"] == "Śanivāra"
+
+
+def test_2026_05_17_is_ravivara():
+    """17 May 2026 is a Sunday (verified independently)."""
+    stamp = ghadi_at(2026, 5, 17, 12, 0, 0, 5.5)
+    assert stamp["vara_layer"]["vara_name"] == "Ravivāra"
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Tithi: Moon − Sun elongation mod 360 / 12 gives tithi index
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_tithi_at_anchor():
+    """At 2026-05-17 16:00 IST the moon is Śukla Dvitīyā (verified)."""
+    stamp = ghadi_at(2026, 5, 17, 16, 0, 0, 5.5)
+    t = stamp["tithi_layer"]
+    assert t["paksha_name"] == "Śukla-pakṣa"
+    assert t["tithi_name"] == "Dvitīyā"
+    assert t["tithi_index"] == 2
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Māsa — Sun in Vṛṣabha (#2) → Jyeṣṭha
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_masa_at_anchor():
+    stamp = ghadi_at(2026, 5, 17, 16, 0, 0, 5.5)
+    m = stamp["month_layer"]
+    assert m["masa_name"] == "Jyeṣṭha"
+    assert m["sun_sign_index"] == 2  # Vṛṣabha
+    assert 0 <= m["sun_sidereal_lon_deg"] < 360
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Day subdivision — every count factors over (2, 3, 5)
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_day_subdivision_factors():
+    stamp = ghadi_at(2026, 5, 17, 16, 0, 0, 5.5)
+    d = stamp["day_subdivision"]
+    assert 1 <= d["muhurta_index"] <= 30
+    assert 1 <= d["ghati_index"] <= 60
+    assert 1 <= d["vighati_index"] <= 60
+    assert 1 <= d["prana_index"] <= 6
+    assert 0 <= d["vipala_fractional"] < 10
+
+
+def test_muhurta_ghati_consistency():
+    """muhūrta = 1/30 day, ghaṭi = 1/60 day → muhūrta_count = ghaṭi_count / 2."""
+    stamp = ghadi_at(2026, 5, 17, 16, 0, 0, 5.5)
+    d = stamp["day_subdivision"]
+    # We can't directly assert ghati = 2 * muhurta because they tick
+    # at different rates within their fractional parts, but the
+    # *index pair* is always consistent: floor(frac*30) and floor(frac*60).
+    frac = d["fraction_of_day"]
+    assert d["muhurta_index"] == math.floor(frac * 30) + 1
+    assert d["ghati_index"] == math.floor(frac * 60) + 1
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Sun mean motion — should circle the zodiac in ~365.26 days
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_sun_one_year_returns_to_origin():
+    days_per_year = MAHAYUGA_CIVIL_DAYS / MAHAYUGA_YEARS
+    lon0 = vedic_mean_longitude("Sun", 0.0)
+    lon1 = vedic_mean_longitude("Sun", days_per_year)
+    # Sun should return to the same longitude after one sidereal year (mod 360)
+    delta = abs((lon1 - lon0 + 180) % 360 - 180)
+    assert delta < 1e-6
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Stamp shape — every documented key is present
+# ──────────────────────────────────────────────────────────────────────────
+
+def test_stamp_keys():
+    stamp = ghadi_at(2026, 5, 17, 16, 0, 0, 5.5)
+    for k in ("input_civil", "kali_civil_days_at_kamakhya",
+              "year_layer", "month_layer", "tithi_layer",
+              "vara_layer", "day_subdivision", "substrate_alignment",
+              "discipline"):
+        assert k in stamp, f"missing key: {k}"
+
+
+# ──────────────────────────────────────────────────────────────────────────
+# Substrate factor table — every count truly factors over (2, 3, 5)
+# (except vāra=7 which is graha-special, called out explicitly)
+# ──────────────────────────────────────────────────────────────────────────
+
+def _factors_over_235(n: int) -> bool:
+    for p in (2, 3, 5):
+        while n % p == 0:
+            n //= p
+    return n == 1
+
+
+def test_substrate_table_factors():
+    stamp = ghadi_at(2026, 5, 17, 16, 0, 0, 5.5)
+    table = stamp["substrate_alignment"]
+    for key, (count, _desc) in table.items():
+        if key in ("vara_count", "saptamukhi"):
+            assert count == 7
+            continue
+        assert _factors_over_235(int(count)), f"{key}={count} doesn't factor over (2,3,5)"

vedic_ghadi-1.0.0/vedic_ghadi/__init__.py

@@ -0,0 +1,42 @@
+"""
+🔱 vedic_ghadi — substrate-derived Vedic clock for any civil moment
+
+Every Vedic time-unit emitted by this package is derived from a SINGLE
+quantity: Kāli civil days elapsed since the sacred epoch (Friday midnight
+17/18 February 3102 BCE, Ujjayinī meridian, Sūrya Siddhānta 1.45–1.57).
+
+NO Gregorian calendar arithmetic below the input boundary.
+NO Western timezone reasoning below the input boundary.
+ZERO foreign theorem in the chain.
+
+Public API:
+    >>> from vedic_ghadi import ghadi_now, ghadi_at
+    >>> ghadi_now()                       # current moment, IST
+    >>> ghadi_at(2026, 5, 17, 16, 30, 0)  # any moment
+"""
+
+from .substrate import (
+    KAMAKHYA_LAT_DEG, KAMAKHYA_LON_DEG, KAMAKHYA_ELEV_M,
+    KAMAKHYA_LMT_OFFSET_H, KALI_YUGA_EPOCH_JD,
+    MAHAYUGA_YEARS, MAHAYUGA_CIVIL_DAYS, KALI_DAYS_PER_YEAR,
+    MASA_NAMES, MASA_DEV, VARA_NAMES, VARA_DEV, VARA_LORD,
+    SAMVATSARA_NAMES, PAKSHA_NAMES, PAKSHA_DEV, TITHI_NAMES,
+    VEDIC_TIME_SUBSTRATE,
+    civil_input_to_kali_civil_days,
+    kali_year_at_civil_days, vikrama_year, shaka_year,
+    samvatsara_at_kali_year,
+    vedic_month_at_kali_days, vedic_tithi_at_kali_days,
+    vedic_vara_at_kali_days, vedic_time_of_day,
+    kala_substrate_stamp,
+)
+from .ghadi import ghadi_at, ghadi_now, render_ghadi_text
+
+__version__ = "1.0.0"
+__all__ = [
+    "ghadi_now", "ghadi_at", "render_ghadi_text",
+    "kala_substrate_stamp", "civil_input_to_kali_civil_days",
+    "KAMAKHYA_LAT_DEG", "KAMAKHYA_LON_DEG", "KAMAKHYA_ELEV_M",
+    "KALI_DAYS_PER_YEAR",
+    "MASA_NAMES", "VARA_NAMES", "SAMVATSARA_NAMES",
+    "TITHI_NAMES", "PAKSHA_NAMES",
+]

vedic_ghadi-1.0.0/vedic_ghadi/__main__.py

@@ -0,0 +1,6 @@
+"""Entry-point so `python -m vedic_ghadi` works without install."""
+from .cli import main
+import sys
+
+if __name__ == "__main__":
+    sys.exit(main())

vedic_ghadi-1.0.0/vedic_ghadi/api.py

@@ -0,0 +1,129 @@
+"""
+🔱 FastAPI service — exposes the Vedic ghaḍī over HTTP.
+
+Endpoints:
+    GET  /              → simple HTML landing (link to /docs and /now)
+    GET  /healthz       → liveness
+    GET  /now           → current moment (default tz = 5.5)
+    GET  /at?date=…     → specific moment (ISO-ish)
+    GET  /stream        → SSE feed — one event per prāṇa (4 sec)
+    GET  /docs          → OpenAPI / Swagger UI
+
+Run:
+    pip install -e backend[server]
+    uvicorn vedic_ghadi.api:app --reload --port 8765
+
+CORS is open by default so the Next.js frontend can call this from anywhere.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+
+from fastapi import FastAPI, HTTPException, Query
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import HTMLResponse, StreamingResponse
+
+from . import __version__
+from .ghadi import ghadi_at, ghadi_now
+
+app = FastAPI(
+    title="Vedic Ghaḍī",
+    version=__version__,
+    description=(
+        "🔱 Substrate-derived Vedic clock — every unit derived from a single "
+        "quantity: Kāli civil days from the sacred epoch (Friday midnight "
+        "17/18 February 3102 BCE, Ujjayinī meridian). ZERO foreign theorem "
+        "in the chain."
+    ),
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=False,
+    allow_methods=["GET"],
+    allow_headers=["*"],
+)
+
+
+@app.get("/", response_class=HTMLResponse, include_in_schema=False)
+def landing() -> str:
+    return f"""<!doctype html>
+<html><head><meta charset="utf-8"><title>Vedic Ghaḍī API</title>
+<style>
+  body{{font-family:Georgia,serif;background:#0a0703;color:#f1c97a;
+       padding:40px;max-width:720px;margin:auto;line-height:1.6}}
+  h1{{color:#e9b863;font-weight:300;letter-spacing:2px}}
+  a{{color:#d4a44c;text-decoration:none;border-bottom:1px solid #4a3a1a}}
+  code{{background:#1a1106;padding:2px 6px;border-radius:3px;color:#e9b863}}
+</style></head>
+<body>
+<h1>🔱 Vedic Ghaḍī &middot; v{__version__}</h1>
+<p>Substrate-derived Vedic clock. Every unit traces to a single quantity:
+Kāli civil days from the sacred epoch.</p>
+<ul>
+  <li><a href="/now">GET /now</a> &middot; current moment</li>
+  <li><a href="/at?date=2026-05-17T16:30:00">GET /at?date=…</a> &middot; any moment</li>
+  <li><a href="/stream">GET /stream</a> &middot; SSE feed (one event per prāṇa = 4 sec)</li>
+  <li><a href="/docs">GET /docs</a> &middot; OpenAPI / Swagger</li>
+  <li><a href="/healthz">GET /healthz</a> &middot; liveness</li>
+</ul>
+<p style="opacity:.7">ॐ कालाय नमः &middot; JAI MAA KAMAKHYA</p>
+</body></html>"""
+
+
+@app.get("/healthz")
+def healthz() -> dict:
+    return {"status": "ok", "version": __version__}
+
+
+@app.get("/now")
+def now(tz: float = Query(5.5, description="Timezone offset in hours (default IST = 5.5)")) -> dict:
+    return ghadi_now(tz_h=tz)
+
+
+@app.get("/at")
+def at(
+    date: str = Query(..., description='ISO-ish: "2026-05-17" or "2026-05-17T16:30:00"'),
+    tz: float = Query(5.5, description="Timezone offset in hours"),
+) -> dict:
+    try:
+        s = date.replace("T", " ").strip()
+        if " " in s:
+            d_part, t_part = s.split(" ", 1)
+        else:
+            d_part, t_part = s, "00:00:00"
+        y, mo, d = [int(x) for x in d_part.split("-")]
+        bits = t_part.split(":")
+        h = int(bits[0]) if len(bits) >= 1 and bits[0] else 0
+        mi = int(bits[1]) if len(bits) >= 2 and bits[1] else 0
+        sec = float(bits[2]) if len(bits) >= 3 and bits[2] else 0.0
+    except (ValueError, IndexError) as e:
+        raise HTTPException(
+            status_code=400,
+            detail=f"Bad date format ({e}). Use 2026-05-17 or 2026-05-17T16:30:00",
+        )
+    return ghadi_at(y, mo, d, h, mi, sec, tz)
+
+
+async def _stream_loop(tz_h: float):
+    """Yield one SSE event per prāṇa (4 sec). Goes forever; client disconnects."""
+    while True:
+        stamp = ghadi_now(tz_h=tz_h)
+        yield f"data: {json.dumps(stamp, ensure_ascii=False)}\n\n"
+        await asyncio.sleep(4.0)
+
+
+@app.get("/stream")
+async def stream(tz: float = Query(5.5)) -> StreamingResponse:
+    return StreamingResponse(
+        _stream_loop(tz),
+        media_type="text/event-stream",
+        headers={
+            "Cache-Control": "no-cache",
+            "X-Accel-Buffering": "no",
+            "Connection": "keep-alive",
+        },
+    )