feat(oracle): add tajika annual closure status board

tests/test_tajika_annual_closure_status.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+"""Tests for the shortest Tajika/Sahams annual external closure status board."""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def run_status(*args: str) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        [
+            sys.executable,
+            "scripts/tajika_annual_closure_status.py",
+            "--oracle-file",
+            "references/oracle/tajika_annual_oracle_cases.json",
+            *args,
+        ],
+        cwd=ROOT,
+        text=True,
+        capture_output=True,
+        timeout=60,
+        check=False,
+    )
+
+
+def test_tajika_annual_closure_status_identifies_first_annual_packet() -> None:
+    completed = run_status("--format", "json")
+
+    assert completed.returncode == 0, completed.stderr or completed.stdout
+    report = json.loads(completed.stdout)
+    assert report["scope"] == "tajika_sahams_annual_closure_status"
+    assert report["schema_version"] == 1
+    assert report["summary"]["annual_task_count"] == 5
+    assert report["summary"]["external_verified_annual_tasks"] == 0
+    assert report["summary"]["can_claim_tajika_sahams_closure"] is False
+    assert report["first_priority"]["case_id"] == "template_steve_jobs_varshaphala_1984_lahiri"
+    assert report["first_priority"]["capture_id"] == "external_template_steve_jobs_varshaphala_1984_lahiri"
+    assert report["first_priority"]["required_target_fields"] == [
+        "target.solar_return_datetime",
+        "target.varsha_lagna_deg",
+        "target.muntha_sign",
+        "target.year_lord",
+        "target.mudda_dasha_first_lord",
+        "target.sahams.punya_saham",
+        "target.sahams.rajya_saham",
+        "target.sahams.vivah_saham",
+        "target.tajika_yogas",
+        "target.source_artifact",
+    ]
+    assert "metadata.tool_name" in report["first_priority"]["missing_fields"]
+    assert "target.solar_return_datetime" in report["first_priority"]["missing_fields"]
+    assert "target.sahams.punya_saham" in report["first_priority"]["missing_fields"]
+    assert report["first_priority"]["validate_command"]
+
+
+def test_tajika_annual_closure_status_markdown_can_be_written(tmp_path: Path) -> None:
+    output = tmp_path / "tajika_status.md"
+    completed = run_status("--format", "markdown", "--output", str(output))
+
+    assert completed.returncode == 0, completed.stderr or completed.stdout
+    assert output.exists()
+    markdown = output.read_text(encoding="utf-8")
+    assert "# Tajika/Sahams Annual Closure Status" in markdown
+    assert "can_claim_tajika_sahams_closure: `false`" in markdown
+    assert "external_template_steve_jobs_varshaphala_1984_lahiri" in markdown
+    assert "target.sahams.punya_saham" in markdown

tests/test_tajika_annual_oracle_queue.py

@@ -56,3 +56,88 @@ def test_tajika_annual_queue_markdown_lists_sahams_and_yogas() -> None:
     assert "Punya Saham" in markdown
     assert "Tajika Yogas" in markdown
     assert "production_tuning_allowed: `false`" in markdown
+
+
+def test_tajika_annual_queue_can_write_and_apply_evidence_packet(tmp_path: Path) -> None:
+    oracle = json.loads((ROOT / ORACLE_FILE).read_text(encoding="utf-8"))
+    oracle_path = tmp_path / "tajika_oracle.json"
+    oracle_path.write_text(json.dumps(oracle, ensure_ascii=False), encoding="utf-8")
+    packet_dir = tmp_path / "packets"
+
+    generated = subprocess.run(
+        [
+            sys.executable,
+            "scripts/tajika_annual_oracle_queue.py",
+            "--oracle-file",
+            str(oracle_path),
+            "--write-packet-dir",
+            str(packet_dir),
+            "--format",
+            "json",
+        ],
+        cwd=ROOT,
+        text=True,
+        capture_output=True,
+        timeout=60,
+        check=False,
+    )
+    assert generated.returncode == 0, generated.stderr or generated.stdout
+    queue = json.loads(generated.stdout)
+    assert queue["summary"]["written_evidence_packets"] == 5
+
+    packet_path = packet_dir / "external_template_steve_jobs_varshaphala_1984_lahiri.json"
+    assert packet_path.exists()
+    packet = json.loads(packet_path.read_text(encoding="utf-8"))
+    packet["status"] = "external_verified"
+    packet["metadata"].update(
+        {
+            "tool_name": "JHora",
+            "tool_version_or_url": "manual-jhora-varshaphala",
+            "capture_date": "2026-06-26",
+            "source_artifact": "references/oracle/artifacts/steve_jobs_1984_varshaphala_redacted.png",
+            "operator_note": "Typed from redacted external annual chart screenshot.",
+        }
+    )
+    packet["target_placeholders"].update(
+        {
+            "target.solar_return_datetime": "1984-02-24T21:04:00-08:00",
+            "target.varsha_lagna_deg": 123.45,
+            "target.muntha_sign": "Cancer",
+            "target.year_lord": "Moon",
+            "target.mudda_dasha_first_lord": "Moon",
+            "target.sahams.punya_saham": 210.1,
+            "target.sahams.rajya_saham": 88.2,
+            "target.sahams.vivah_saham": 301.3,
+            "target.tajika_yogas": ["Ithasala"],
+            "target.source_artifact": "references/oracle/artifacts/steve_jobs_1984_varshaphala_redacted.png",
+        }
+    )
+    packet_path.write_text(json.dumps(packet, ensure_ascii=False), encoding="utf-8")
+
+    applied = subprocess.run(
+        [
+            sys.executable,
+            "scripts/tajika_annual_oracle_queue.py",
+            "--oracle-file",
+            str(oracle_path),
+            "--apply-packet",
+            str(packet_path),
+            "--format",
+            "json",
+        ],
+        cwd=ROOT,
+        text=True,
+        capture_output=True,
+        timeout=60,
+        check=False,
+    )
+    assert applied.returncode == 0, applied.stderr or applied.stdout
+    report = json.loads(applied.stdout)
+    assert report["summary"]["applied_evidence_packets"] == 1
+
+    updated = json.loads(oracle_path.read_text(encoding="utf-8"))
+    case = next(row for row in updated["template_cases"] if row["id"] == "template_steve_jobs_varshaphala_1984_lahiri")
+    assert case["status"] == "external_verified"
+    assert case["target"]["solar_return_datetime"] == "1984-02-24T21:04:00-08:00"
+    assert case["target"]["sahams"]["punya_saham"] == 210.1
+    assert case["evidence_packet"]["metadata"]["tool_name"] == "JHora"