sync: import runtime closure oracle packets

2026-07-21 12:15:49 +08:00
parent e6db072b0f
commit de37342a3e
35 changed files with 1988 additions and 61 deletions
@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""Audit KP/Gochara/Muhurta/Panchanga fragments and runtime entrypoints."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+
+
+def _text(path: Path) -> str:
+    return path.read_text(encoding="utf-8", errors="ignore") if path.exists() else ""
+
+
+def build_audit(root: Path) -> dict:
+    api = _text(root / "scripts/jyotish_api_server.py")
+    research_main_js = _text(root / "jyotish-app/main.js")
+    commercial_page = _text(root / "frontend/src/app/page.tsx")
+    dashaflow_muhurtha = root / "references/open_source_sources/dashaflow/muhurtha.py"
+    panchanga_license = _text(root / "references/open_source_sources/panchanga_api/LICENSE").splitlines()
+    kp_reference = root / "/Users/wuyongnaren/.workbuddy/backups/jyotish-vedic-astrology-20260711-154109/references/kp-astrology-complete-system.md"
+    gochara_template = Path("/tmp/jyotisha-optimize/assets/event_timing_template.md")
+    panchanga_called = (
+        "/api/panchanga_range" in api
+        and (
+            ("panchanga-range" in research_main_js and "panchanga-csv" in research_main_js)
+            or ("panchanga-range" in commercial_page and "panchanga-csv" in commercial_page)
+        )
+    )
+
+    items = [
+        {
+            "technique_id": "panchanga_calendar",
+            "current_call_status": "formally_called_in_api_and_web" if panchanga_called else "partial",
+            "main_artifacts": [
+                "scripts/jyotish_api_server.py",
+                "frontend/src/app/page.tsx",
+                "jyotish-app/main.js (research static UI only, absent in commercial repo)",
+            ],
+            "external_or_reference_artifacts": ["references/open_source_sources/panchanga_api"],
+            "reuse_decision": "do_not_duplicate_runtime",
+            "source_or_license_boundary": "Existing runtime/UI present; panchanga_api license observed as "
+            + (panchanga_license[0] if panchanga_license else "unknown")
+            + ". Treat external panchanga_api as reference unless license/API contract is separately audited.",
+            "next_action": "add panchanga claim/display contract and source/oracle packet for tithi/nakshatra/yoga/karana/rahu-kalam outputs",
+            "claim_boundary": "Panchanga is runtime-visible but still needs field-level external oracle examples for high-rigor claims.",
+        },
+        {
+            "technique_id": "muhurta_dashaflow_candidate",
+            "current_call_status": "oss_reference_not_main_runtime",
+            "main_artifacts": [],
+            "external_or_reference_artifacts": [str(dashaflow_muhurtha)],
+            "reuse_decision": "license_audit_before_reuse",
+            "source_or_license_boundary": "dashaflow/muhurtha.py exists under references/open_source_sources; verify license and formula sources before adapting.",
+            "next_action": "audit dashaflow license, extract formula surface, then compare Tarabala/Chandrabala/Rahu Kalam against local Panchanga.",
+            "claim_boundary": "Muhurta remains reference-only until license, formula, and worked examples close.",
+        },
+        {
+            "technique_id": "kp_astrology",
+            "current_call_status": "reference_only_not_main_runtime",
+            "main_artifacts": [],
+            "external_or_reference_artifacts": [str(kp_reference)],
+            "reuse_decision": "reference_only",
+            "source_or_license_boundary": "KP backup/reference may contain useful notes but must pass privacy/license/source audit; do not copy blindly.",
+            "next_action": "create KP separate track: cusp system, ayanamsa, star lord/sub lord, ruling planets, public oracle examples.",
+            "claim_boundary": "KP is not part of current main Jyotish runtime truth.",
+        },
+        {
+            "technique_id": "gochara_event_timing_template",
+            "current_call_status": "template_reference_not_main_runtime",
+            "main_artifacts": [],
+            "external_or_reference_artifacts": [str(gochara_template)],
+            "reuse_decision": "reference_only",
+            "source_or_license_boundary": "Template in /tmp must be privacy/source reviewed before promotion.",
+            "next_action": "turn Gochara template into scoring contract only after Dasha+Varga+Transit features and negative holdout are ready.",
+            "claim_boundary": "Transit template is not a calibrated timing engine.",
+        },
+    ]
+    return {
+        "scope": "technique_promotion_audit_kp_gochara_muhurta",
+        "created_at": "2026-07-19",
+        "truth_policy": "runtime_presence_not_oracle_closure",
+        "production_tuning_allowed": False,
+        "summary": {
+            "items_checked": len(items),
+            "formally_called_count": sum("formally_called" in item["current_call_status"] for item in items),
+            "reference_only_count": sum("not_main_runtime" in item["current_call_status"] or "template_reference" in item["current_call_status"] for item in items),
+        },
+        "items": items,
+    }
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--root", type=Path, default=Path("."))
+    parser.add_argument("--output", type=Path)
+    args = parser.parse_args()
+    audit = build_audit(args.root)
+    text = json.dumps(audit, ensure_ascii=False, indent=2, sort_keys=True) + "\n"
+    if args.output:
+        args.output.parent.mkdir(parents=True, exist_ok=True)
+        args.output.write_text(text, encoding="utf-8")
+    print(text, end="")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())