chore(release): harden premium skill packaging

2026-07-10 22:31:28 +08:00
parent 52266a3b64
commit 3cbc9ca585
30 changed files with 1567 additions and 40 deletions
@@ -0,0 +1,25 @@
+{
+  "case_id": "contract_ready_no_same_chart_rows",
+  "birth_data_policy": "operator_local_only",
+  "status": "not_started",
+  "engines": {
+    "VedAstro": {
+      "status": "blocked",
+      "official_raw_response_path": "",
+      "artifact_hash": ""
+    },
+    "PyJHora_JHora": {
+      "status": "blocked",
+      "raw_output_path": "",
+      "settings": {}
+    },
+    "jyotishganit": {
+      "status": "blocked",
+      "raw_output_path": "",
+      "settings": {}
+    }
+  },
+  "comparison_rows": [],
+  "blocked_reason": "no_same_chart_oracle_rows_imported",
+  "runtime_boundary": "This manifest defines the same-chart parity replay contract only. It does not prove VedAstro/PyJHora/JHora/jyotishganit parity until raw oracle rows are imported."
+}
@@ -0,0 +1,76 @@
+# Western Oracle Adapter Contract
+
+This contract defines how external Western astrology outputs enter the high-rigor Jyotish workflow.
+
+## Purpose
+
+`scripts/western_oracle_adapter.py` converts an external Western astrology JSON export into the standard `western_evidence_packet`.
+
+It is an evidence adapter, not a bundled Western astrology engine.
+
+## Accepted Input
+
+```json
+{
+  "source_engine": "kerykeion_external_json",
+  "natal": {
+    "ascendant": "Virgo",
+    "mc": "Gemini"
+  },
+  "timing_techniques": {
+    "solar_return": {
+      "annual_focus": "career"
+    }
+  },
+  "aspects": [
+    {
+      "date": "2026-07-07",
+      "planet": "Uranus",
+      "aspect": "conjunction",
+      "target": "MC"
+    }
+  ]
+}
+```
+
+Explicit `signals` may be provided. When present, explicit signals are preserved and aspect-derived signals are not guessed.
+
+## Derived Signal Rules
+
+The adapter currently maps only a small auditable subset:
+
+| Aspect Pattern | Signal |
+|---|---|
+| Uranus conjunction MC/Midheaven | `career_relocation / career_triggered_relocation` |
+| Jupiter trine/sextile Mercury/Venus/MC | `career / client_cooperation_opportunity` |
+| Saturn conjunction Sun/Mercury/Venus | `career / career_responsibility_test` |
+
+More mappings require tests and source notes before being added.
+
+## Entry Points
+
+API and MCP callers may pass either field:
+
+- `western_oracle_payload`: raw external Western astrology JSON export; the project normalizes it with `western_oracle_adapter`.
+- `western_evidence_packet`: pre-normalized packet; the project carries it directly into `runtime_evidence_log`.
+
+When Jyotish evidence also carries matching `cross_system_signals`, `Cross-System Arbitration` can become `used`. If only Western evidence is present, arbitration stays `partial` or `blocked`.
+
+## CLI
+
+```bash
+python3 scripts/western_oracle_adapter.py \
+  --input /path/to/western_oracle.json \
+  --theme career \
+  --question-type career
+```
+
+The command prints a `western_evidence_packet` JSON object.
+
+## License Boundary
+
+The premium skill may accept JSON exports from Kerykeion, Flatlib, Immanuel, Astro.com, GongShenXing, or desktop software.
+
+Do not copy third-party source code into the premium package unless the exact project and dependency licenses permit bundling.
+
+The adapter stores derived evidence and source labels only.