root/Jyotisha
1
0
Fork 0
Code Issues Pull Requests 1 Actions 1 Packages Projects Releases Wiki Activity

feat(oracle): add tajika annual closure status board

Browse Source
This commit is contained in:
732642856
2026-06-26 18:06:18 +08:00
parent e3a84ee73b
commit e3215a6609
7 changed files with 580 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+27
View File
@@ -255,6 +255,33 @@ python3 scripts/tajika_annual_benchmark_dashboard.py \
当前 Tajika/Sahams 看板固定输出 `can_claim_tajika_sahams_closure: false`：本地 skill 已有年运计算与解释骨架，但太阳回归精确时刻、Varsha Lagna、Muntha、Mudda Dasha、Punya/Rajya/Vivah Saham 和 Tajika Yogas 仍需 JHora/PyJHora/书例级外部证据后，才能宣称年运闭环。
年运第一条最短闭环状态板：
```bash
python3 scripts/tajika_annual_closure_status.py \
--oracle-file references/oracle/tajika_annual_oracle_cases.json \
--format markdown \
--output docs/benchmark/tajika_sahams_annual_closure_status.md
```
如需导出可填写的年运证据包：
```bash
python3 scripts/tajika_annual_oracle_queue.py \
--oracle-file references/oracle/tajika_annual_oracle_cases.json \
--write-packet-dir references/oracle/artifacts/pending_packets \
--format json
```
填完 `external_template_steve_jobs_varshaphala_1984_lahiri.json` 后，可合并回年运 oracle：
```bash
python3 scripts/tajika_annual_oracle_queue.py \
--oracle-file references/oracle/tajika_annual_oracle_cases.json \
--apply-packet references/oracle/artifacts/pending_packets/external_template_steve_jobs_varshaphala_1984_lahiri.json \
--format json
```
`full-reading` 也会输出 `ai_prompt_pack`：这是给网页/app、skill 或后端 AI 代理使用的结构化 Prompt/RAG 上下文包。它不会硬编码断语，而是携带 D1/D9/Dasha/Shadbala/Ashtakavarga 的证据快照、推荐检索文档和边界提示，要求大模型基于计算证据交叉验证，避免单一配置下结论。
### Prerequisites
docs/benchmark/tajika_sahams_annual_closure_status.json
+76
View File
@@ -0,0 +1,76 @@
{
"scope": "tajika_sahams_annual_closure_status",
"schema_version": 1,
"summary": {
"annual_task_count": 5,
"external_verified_annual_tasks": 0,
"can_claim_tajika_sahams_closure": false,
"production_tuning_allowed": false
},
"first_priority": {
"case_id": "template_steve_jobs_varshaphala_1984_lahiri",
"capture_id": "external_template_steve_jobs_varshaphala_1984_lahiri",
"packet_path": "references/oracle/artifacts/pending_packets/external_template_steve_jobs_varshaphala_1984_lahiri.json",
"birth": {
"year": 1955,
"month": 2,
"day": 24,
"hour": 19,
"minute": 15,
"second": 0,
"lat": 37.7749,
"lon": -122.4194,
"tz": -8
},
"settings": {
"ayanamsa": "lahiri",
"node_mode": "true",
"annual_system": "varshaphala",
"target_year": 1984
},
"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"
],
"missing_fields": [
"metadata.tool_name",
"metadata.tool_version_or_url",
"metadata.capture_date",
"metadata.operator_note",
"metadata.source_artifact",
"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"
],
"external_sources": [
"JHora Varshaphala screenshot",
"PyJHora black-box annual output",
"printed Tajika/Varshaphala example"
],
"artifact_policy": "Save redacted screenshots, stdout snippets or book citations under references/oracle/artifacts/.",
"apply_command": "python3 scripts/tajika_annual_oracle_queue.py --oracle-file references/oracle/tajika_annual_oracle_cases.json --apply-packet references/oracle/artifacts/pending_packets/external_template_steve_jobs_varshaphala_1984_lahiri.json --format json",
"validate_command": "python3 scripts/tajika_annual_oracle_queue.py --oracle-file references/oracle/tajika_annual_oracle_cases.json --format json && python3 scripts/tajika_annual_benchmark_dashboard.py --oracle-file references/oracle/tajika_annual_oracle_cases.json --format json"
},
"next_actions": [
"Fill solar return datetime, Varsha Lagna, Muntha, Year Lord, first Mudda Dasha lord, three Sahams and Tajika Yogas from an external annual source.",
"Document timezone/DST and solar-return convention before promoting the row.",
"Set the row to external_verified only after target.source_artifact and metadata.source_artifact point to reviewable evidence.",
"Regenerate the annual queue and benchmark dashboard."
],
"boundary": "This board isolates Tajika/Sahams annual closure. Local scripts/varshaphala.py output is not an external oracle and must not be used as production tuning evidence."
}
docs/benchmark/tajika_sahams_annual_closure_status.md
+35
View File
@@ -0,0 +1,35 @@
# Tajika/Sahams Annual Closure Status
- annual_task_count: `5`
- external_verified_annual_tasks: `0`
- can_claim_tajika_sahams_closure: `false`
- production_tuning_allowed: `false`
## First Priority Packet
- case_id: `template_steve_jobs_varshaphala_1984_lahiri`
- capture_id: `external_template_steve_jobs_varshaphala_1984_lahiri`
- packet_path: `references/oracle/artifacts/pending_packets/external_template_steve_jobs_varshaphala_1984_lahiri.json`
- 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`
- missing_fields: `metadata.tool_name, metadata.tool_version_or_url, metadata.capture_date, metadata.operator_note, metadata.source_artifact, 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`
## Commands
```bash
python3 scripts/tajika_annual_oracle_queue.py --oracle-file references/oracle/tajika_annual_oracle_cases.json --apply-packet references/oracle/artifacts/pending_packets/external_template_steve_jobs_varshaphala_1984_lahiri.json --format json
```
```bash
python3 scripts/tajika_annual_oracle_queue.py --oracle-file references/oracle/tajika_annual_oracle_cases.json --format json && python3 scripts/tajika_annual_benchmark_dashboard.py --oracle-file references/oracle/tajika_annual_oracle_cases.json --format json
```
## Next Actions
- Fill solar return datetime, Varsha Lagna, Muntha, Year Lord, first Mudda Dasha lord, three Sahams and Tajika Yogas from an external annual source.
- Document timezone/DST and solar-return convention before promoting the row.
- Set the row to external_verified only after target.source_artifact and metadata.source_artifact point to reviewable evidence.
- Regenerate the annual queue and benchmark dashboard.
## Boundary
This board isolates Tajika/Sahams annual closure. Local scripts/varshaphala.py output is not an external oracle and must not be used as production tuning evidence.
scripts/tajika_annual_closure_status.py
+202
View File
@@ -0,0 +1,202 @@
#!/usr/bin/env python3
"""Report the shortest path to Tajika/Sahams annual external closure."""
from __future__ import annotations
import argparse
import json
import subprocess
import sys
from pathlib import Path
from typing import Any
ROOT = Path(__file__).resolve().parents[1]
PYTHON = sys.executable
FIRST_PRIORITY_CASE_ID = "template_steve_jobs_varshaphala_1984_lahiri"
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",
]
def _run_json(command: list[str]) -> dict[str, Any]:
completed = subprocess.run(
command,
cwd=ROOT,
text=True,
capture_output=True,
timeout=60,
check=False,
)
if completed.returncode != 0:
raise RuntimeError(completed.stderr.strip() or completed.stdout.strip())
return json.loads(completed.stdout)
def _metadata_missing(packet: dict[str, Any]) -> list[str]:
metadata = packet.get("metadata", {})
missing: list[str] = []
for field in packet.get("required_metadata_fields", []):
value = metadata.get(field)
if value is None or value == "" or value == [] or value == {}:
missing.append(f"metadata.{field}")
source_artifact = metadata.get("source_artifact")
if source_artifact in {"references/oracle/artifacts/", "references/oracle/artifacts", "", None}:
if "metadata.source_artifact" not in missing:
missing.append("metadata.source_artifact")
return missing
def _target_missing(packet: dict[str, Any]) -> list[str]:
placeholders = packet.get("target_placeholders", {})
missing: list[str] = []
for field in REQUIRED_TARGET_FIELDS:
value = placeholders.get(field)
if value is None or value == "" or value == [] or value == {}:
missing.append(field)
return missing
def _apply_command(packet_path: str, oracle_file: str) -> str:
return (
"python3 scripts/tajika_annual_oracle_queue.py "
f"--oracle-file {oracle_file} "
f"--apply-packet {packet_path} "
"--format json"
)
def _validate_command(oracle_file: str) -> str:
return (
"python3 scripts/tajika_annual_oracle_queue.py "
f"--oracle-file {oracle_file} --format json && "
"python3 scripts/tajika_annual_benchmark_dashboard.py "
f"--oracle-file {oracle_file} --format json"
)
def build_status(oracle_file: str) -> dict[str, Any]:
queue = _run_json([PYTHON, "scripts/tajika_annual_oracle_queue.py", "--oracle-file", oracle_file, "--format", "json"])
annual_tasks = queue.get("tasks", [])
priority = next((task for task in annual_tasks if task.get("case_id") == FIRST_PRIORITY_CASE_ID), None)
if priority is None and annual_tasks:
priority = annual_tasks[0]
if priority is None:
raise RuntimeError("No Tajika annual task found")
packet = priority["evidence_packet"]
capture_id = packet["capture_id"]
packet_path = f"references/oracle/artifacts/pending_packets/{capture_id}.json"
missing_fields = _metadata_missing(packet) + _target_missing(packet)
external_verified = [
task for task in annual_tasks
if task.get("status") == "external_verified" and not _target_missing(task.get("evidence_packet", {}))
]
return {
"scope": "tajika_sahams_annual_closure_status",
"schema_version": 1,
"summary": {
"annual_task_count": len(annual_tasks),
"external_verified_annual_tasks": len(external_verified),
"can_claim_tajika_sahams_closure": bool(annual_tasks) and len(external_verified) == len(annual_tasks),
"production_tuning_allowed": False,
},
"first_priority": {
"case_id": priority["case_id"],
"capture_id": capture_id,
"packet_path": packet_path,
"birth": priority.get("birth", {}),
"settings": priority.get("settings", {}),
"required_target_fields": REQUIRED_TARGET_FIELDS,
"missing_fields": missing_fields,
"external_sources": [
"JHora Varshaphala screenshot",
"PyJHora black-box annual output",
"printed Tajika/Varshaphala example",
],
"artifact_policy": "Save redacted screenshots, stdout snippets or book citations under references/oracle/artifacts/.",
"apply_command": _apply_command(packet_path, oracle_file),
"validate_command": _validate_command(oracle_file),
},
"next_actions": [
"Fill solar return datetime, Varsha Lagna, Muntha, Year Lord, first Mudda Dasha lord, three Sahams and Tajika Yogas from an external annual source.",
"Document timezone/DST and solar-return convention before promoting the row.",
"Set the row to external_verified only after target.source_artifact and metadata.source_artifact point to reviewable evidence.",
"Regenerate the annual queue and benchmark dashboard.",
],
"boundary": (
"This board isolates Tajika/Sahams annual closure. Local scripts/varshaphala.py output is not an "
"external oracle and must not be used as production tuning evidence."
),
}
def render_markdown(report: dict[str, Any]) -> str:
summary = report["summary"]
first = report["first_priority"]
lines = [
"# Tajika/Sahams Annual Closure Status",
"",
f"- annual_task_count: `{summary['annual_task_count']}`",
f"- external_verified_annual_tasks: `{summary['external_verified_annual_tasks']}`",
f"- can_claim_tajika_sahams_closure: `{str(summary['can_claim_tajika_sahams_closure']).lower()}`",
f"- production_tuning_allowed: `{str(summary['production_tuning_allowed']).lower()}`",
"",
"## First Priority Packet",
"",
f"- case_id: `{first['case_id']}`",
f"- capture_id: `{first['capture_id']}`",
f"- packet_path: `{first['packet_path']}`",
f"- required_target_fields: `{', '.join(first['required_target_fields'])}`",
f"- missing_fields: `{', '.join(first['missing_fields'])}`",
"",
"## Commands",
"",
"```bash",
first["apply_command"],
"```",
"",
"```bash",
first["validate_command"],
"```",
"",
"## Next Actions",
"",
]
lines.extend(f"- {item}" for item in report["next_actions"])
lines.extend(["", "## Boundary", "", report["boundary"], ""])
return "\n".join(lines)
def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
parser = argparse.ArgumentParser(description="Report Tajika/Sahams annual external closure status")
parser.add_argument("--oracle-file", default="references/oracle/tajika_annual_oracle_cases.json")
parser.add_argument("--format", choices=["json", "markdown"], default="json")
parser.add_argument("--output", help="Optional output path")
return parser.parse_args(argv)
def main(argv: list[str] | None = None) -> int:
args = parse_args(argv)
report = build_status(args.oracle_file)
text = json.dumps(report, ensure_ascii=False, indent=2) if args.format == "json" else render_markdown(report)
if args.output:
output = Path(args.output)
output.parent.mkdir(parents=True, exist_ok=True)
output.write_text(text, encoding="utf-8")
print(text)
return 0
if __name__ == "__main__":
raise SystemExit(main())
scripts/tajika_annual_oracle_queue.py
+83 -1
View File
@@ -10,6 +10,7 @@ from __future__ import annotations
import argparse
import json
import os
import re
from typing import Any
@@ -61,6 +62,12 @@ def _load_json(path: str) -> dict[str, Any]:
return json.load(fh)
def _write_json(path: str, value: dict[str, Any]) -> None:
with open(_resolve_path(path), "w", encoding="utf-8") as fh:
json.dump(value, fh, ensure_ascii=False, indent=2)
fh.write("\n")
def _target_fields(value: Any, prefix: str = "target") -> list[str]:
if prefix == "target" and isinstance(value, dict):
fields: list[str] = []
@@ -210,16 +217,91 @@ def render_markdown(queue: dict[str, Any]) -> str:
return "\n".join(lines)
def _safe_filename(value: str) -> str:
safe = re.sub(r"[^A-Za-z0-9_.-]+", "_", value).strip("._")
return safe or "external_tajika_annual_packet"
def _set_target_value(target: dict[str, Any], field: str, value: Any) -> None:
parts = field.split(".")
if not parts or parts[0] != "target":
return
cursor = target
for part in parts[1:-1]:
child = cursor.get(part)
if not isinstance(child, dict):
child = {}
cursor[part] = child
cursor = child
cursor[parts[-1]] = value
def apply_evidence_packet(oracle: dict[str, Any], packet: dict[str, Any]) -> bool:
case_id = packet.get("case_id")
if not case_id:
return False
for case in oracle.get("template_cases", []):
if case.get("id") != case_id and case.get("case_id") != case_id:
continue
target = case.setdefault("target", {})
placeholders = packet.get("target_placeholders", {})
if isinstance(placeholders, dict):
for field, value in placeholders.items():
_set_target_value(target, field, value)
case["status"] = packet.get("status", case.get("status", "draft"))
case["evidence_packet"] = {
"capture_id": packet.get("capture_id"),
"status": packet.get("status"),
"metadata": packet.get("metadata", {}),
}
return True
return False
def write_evidence_packets(queue: dict[str, Any], output_dir: str) -> int:
output_path = _resolve_path(output_dir)
os.makedirs(output_path, exist_ok=True)
written = 0
for task in queue.get("tasks", []):
packet = task.get("evidence_packet", {})
capture_id = packet.get("capture_id") or f"external_{task.get('case_id', 'unknown')}"
packet_path = os.path.join(output_path, f"{_safe_filename(str(capture_id))}.json")
with open(packet_path, "w", encoding="utf-8") as fh:
json.dump(packet, fh, ensure_ascii=False, indent=2)
fh.write("\n")
written += 1
return written
def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
parser = argparse.ArgumentParser(description="Generate Tajika/Sahams annual oracle collection tasks")
parser.add_argument("--oracle-file", required=True)
parser.add_argument("--format", choices=["json", "markdown"], default="json")
parser.add_argument("--write-packet-dir", help="Optional directory where draft annual evidence packets are written.")
parser.add_argument(
"--apply-packet",
action="append",
default=[],
help="Filled annual evidence packet JSON to merge back into the oracle file.",
)
return parser.parse_args(argv)
def main(argv: list[str] | None = None) -> int:
args = parse_args(argv)
queue = build_queue(_load_json(args.oracle_file))
oracle = _load_json(args.oracle_file)
applied_packets = 0
for packet_path in args.apply_packet:
packet = _load_json(packet_path)
if apply_evidence_packet(oracle, packet):
applied_packets += 1
if applied_packets:
_write_json(args.oracle_file, oracle)
queue = build_queue(oracle)
if applied_packets:
queue["summary"]["applied_evidence_packets"] = applied_packets
if args.write_packet_dir:
queue["summary"]["written_evidence_packets"] = write_evidence_packets(queue, args.write_packet_dir)
if args.format == "markdown":
print(render_markdown(queue))
else:
tests/test_tajika_annual_closure_status.py
+72
View File
@@ -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
+85
View File
@@ -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"