feat(benchmark): publish oracle readiness dashboard

This commit is contained in:
732642856
2026-06-26 17:21:51 +08:00
parent 486c6063d9
commit cba4e85d05
5 changed files with 342 additions and 0 deletions
+11
View File
@@ -203,6 +203,17 @@ python3 scripts/oracle_boundary_audit.py \
审计报告中的 `template_comparisons` 会列出 external-verified template 的 Dasha 起点差异、Shadbala 七曜分量/总分差异、每个分量的 Rupa 容差、单位说明和 `global_scaling_check.recommendation: reject_global_scaling`,并继续保持 `production_tuning_recommended: false`,防止用单个样本或全局倍率调生产常数。
公开 benchmark 看板用于长期展示能力状态、oracle readiness 和“是否可宣称全球第一”的诚实边界:
```bash
python3 scripts/public_benchmark_dashboard.py \
--oracle-file references/oracle/dasha_shadbala_oracle_cases.json \
--format markdown \
--output docs/benchmark/public_jyotish_benchmark_dashboard.md
```
当前看板固定输出 `can_claim_global_first: false`,直到外部 oracle 样本、差异审计和长期公开 benchmark 都达到生产调参标准。
`full-reading` 也会输出 `ai_prompt_pack`:这是给网页/app、skill 或后端 AI 代理使用的结构化 Prompt/RAG 上下文包。它不会硬编码断语,而是携带 D1/D9/Dasha/Shadbala/Ashtakavarga 的证据快照、推荐检索文档和边界提示,要求大模型基于计算证据交叉验证,避免单一配置下结论。
### Prerequisites
@@ -0,0 +1,55 @@
{
"scope": "public_jyotish_benchmark_dashboard",
"schema_version": 1,
"generated_at": "2026-06-26T09:20:53.904412+00:00",
"summary": {
"technique_count": 68,
"capability_valid": true,
"problem_count": 0,
"status_counts": {
"complete": 9,
"covered": 59,
"knowledge-only": 0,
"missing": 0,
"not-integrated": 0,
"partial": 0,
"workflow-only": 0
}
},
"oracle_readiness": {
"total_packets": 5,
"valid_packets": 0,
"ready_for_calibration": 0,
"production_tuning_allowed": false,
"all_packets_external_verified": false,
"queue_status_counts": {
"template_only": 5
},
"boundary": "Evidence packets can become review-ready only with external artifacts and filled target values. Local engine output remains rejected as an external oracle source."
},
"boundary_audit": {
"template_cases": 5,
"external_verified_template_cases": 0,
"dasha_cases": 1,
"longitude_cases": 1,
"shadbala_cases": 1,
"production_tuning_recommended": false,
"open_items": [
"Promote template cases to external_verified only after filling external target rows.",
"Add multi-source Vimshottari rows with Moon longitude, ayanamsa and start-boundary settings.",
"Add Shadbala component targets before claiming external absolute calibration."
],
"template_comparison_count": 0
},
"public_claim": {
"can_claim_global_first": false,
"reason": "Do not claim global first until Dasha/Shadbala external oracle packets are valid, production tuning is allowed, and public benchmark history is stable."
},
"global_first_gap": "Dasha/Shadbala external oracle readiness remains 0, Shadbala absolute values still need component-level external evidence, and public long-term benchmark history is not yet comparable to the strongest global open-source projects.",
"next_actions": [
"Fill the first external JHora/PyJHora packet under references/oracle/artifacts/pending_packets.",
"Run oracle_evidence_validator.py until at least one packet is valid.",
"Run oracle_boundary_audit.py to inspect Dasha/Shadbala deltas without tuning constants.",
"Publish this dashboard after each validated sample batch."
]
}
@@ -0,0 +1,38 @@
# Public Jyotish Benchmark Dashboard
Generated: `2026-06-26T09:20:54.438994+00:00`
## Capability Registry
- technique_count: `68`
- capability_valid: `true`
- problem_count: `0`
## Dasha/Shadbala Oracle Readiness
- total_packets: `5`
- valid_packets: `0`
- ready_for_calibration: `0`
- production_tuning_allowed: `false`
## Boundary Audit
- external_verified_template_cases: `0`
- template_comparison_count: `0`
- production_tuning_recommended: `false`
## Global First Claim
- can_claim_global_first: `false`
- reason: Do not claim global first until Dasha/Shadbala external oracle packets are valid, production tuning is allowed, and public benchmark history is stable.
## Remaining Gap
Dasha/Shadbala external oracle readiness remains 0, Shadbala absolute values still need component-level external evidence, and public long-term benchmark history is not yet comparable to the strongest global open-source projects.
## Next Actions
- Fill the first external JHora/PyJHora packet under references/oracle/artifacts/pending_packets.
- Run oracle_evidence_validator.py until at least one packet is valid.
- Run oracle_boundary_audit.py to inspect Dasha/Shadbala deltas without tuning constants.
- Publish this dashboard after each validated sample batch.
+176
View File
@@ -0,0 +1,176 @@
#!/usr/bin/env python3
"""Generate a public benchmark dashboard for Jyotish skill readiness."""
from __future__ import annotations
import argparse
import json
import subprocess
import sys
import tempfile
from datetime import datetime, timezone
from pathlib import Path
from typing import Any
ROOT = Path(__file__).resolve().parents[1]
PYTHON = sys.executable
def _run_json(command: list[str]) -> dict[str, Any]:
completed = subprocess.run(
command,
cwd=ROOT,
text=True,
capture_output=True,
timeout=90,
check=False,
)
if completed.returncode != 0:
raise RuntimeError(completed.stderr.strip() or completed.stdout.strip())
return json.loads(completed.stdout)
def _oracle_readiness(oracle_file: str) -> dict[str, Any]:
queue = _run_json([PYTHON, "scripts/oracle_collection_queue.py", "--oracle-file", oracle_file, "--format", "json"])
with tempfile.NamedTemporaryFile("w+", suffix=".json", encoding="utf-8", delete=True) as fh:
json.dump(queue, fh, ensure_ascii=False)
fh.flush()
validation = _run_json([PYTHON, "scripts/oracle_evidence_validator.py", "--queue-file", fh.name])
summary = validation["summary"]
return {
"total_packets": summary["total_packets"],
"valid_packets": summary["valid_packets"],
"ready_for_calibration": summary["ready_for_calibration"],
"production_tuning_allowed": summary["production_tuning_allowed"],
"all_packets_external_verified": summary["all_packets_external_verified"],
"queue_status_counts": queue["summary"].get("by_status", {}),
"boundary": validation["boundary"],
}
def _boundary_audit(oracle_file: str) -> dict[str, Any]:
report = _run_json([PYTHON, "scripts/oracle_boundary_audit.py", "--oracle-file", oracle_file])
summary = report["summary"]
return {
"template_cases": summary["template_cases"],
"external_verified_template_cases": summary.get("external_verified_template_cases", 0),
"dasha_cases": summary["dasha_cases"],
"longitude_cases": summary["longitude_cases"],
"shadbala_cases": summary["shadbala_cases"],
"production_tuning_recommended": summary["production_tuning_recommended"],
"open_items": summary["open_items"],
"template_comparison_count": len(report.get("template_comparisons", [])),
}
def build_dashboard(oracle_file: str) -> dict[str, Any]:
capability = _run_json([PYTHON, "scripts/audit_capabilities.py", "--mode", "validate"])
oracle = _oracle_readiness(oracle_file)
boundary = _boundary_audit(oracle_file)
global_first_gap = (
"Dasha/Shadbala external oracle readiness remains 0, Shadbala absolute values still need "
"component-level external evidence, and public long-term benchmark history is not yet comparable "
"to the strongest global open-source projects."
)
can_claim_global_first = bool(
capability.get("valid")
and oracle["production_tuning_allowed"]
and boundary["production_tuning_recommended"]
)
return {
"scope": "public_jyotish_benchmark_dashboard",
"schema_version": 1,
"generated_at": datetime.now(timezone.utc).isoformat(),
"summary": {
"technique_count": capability["technique_count"],
"capability_valid": capability["valid"],
"problem_count": capability["problem_count"],
"status_counts": capability["status_counts"],
},
"oracle_readiness": oracle,
"boundary_audit": boundary,
"public_claim": {
"can_claim_global_first": can_claim_global_first,
"reason": (
"Do not claim global first until Dasha/Shadbala external oracle packets are valid, "
"production tuning is allowed, and public benchmark history is stable."
),
},
"global_first_gap": global_first_gap,
"next_actions": [
"Fill the first external JHora/PyJHora packet under references/oracle/artifacts/pending_packets.",
"Run oracle_evidence_validator.py until at least one packet is valid.",
"Run oracle_boundary_audit.py to inspect Dasha/Shadbala deltas without tuning constants.",
"Publish this dashboard after each validated sample batch.",
],
}
def render_markdown(report: dict[str, Any]) -> str:
oracle = report["oracle_readiness"]
boundary = report["boundary_audit"]
claim = report["public_claim"]
lines = [
"# Public Jyotish Benchmark Dashboard",
"",
f"Generated: `{report['generated_at']}`",
"",
"## Capability Registry",
"",
f"- technique_count: `{report['summary']['technique_count']}`",
f"- capability_valid: `{str(report['summary']['capability_valid']).lower()}`",
f"- problem_count: `{report['summary']['problem_count']}`",
"",
"## Dasha/Shadbala Oracle Readiness",
"",
f"- total_packets: `{oracle['total_packets']}`",
f"- valid_packets: `{oracle['valid_packets']}`",
f"- ready_for_calibration: `{oracle['ready_for_calibration']}`",
f"- production_tuning_allowed: `{str(oracle['production_tuning_allowed']).lower()}`",
"",
"## Boundary Audit",
"",
f"- external_verified_template_cases: `{boundary['external_verified_template_cases']}`",
f"- template_comparison_count: `{boundary['template_comparison_count']}`",
f"- production_tuning_recommended: `{str(boundary['production_tuning_recommended']).lower()}`",
"",
"## Global First Claim",
"",
f"- can_claim_global_first: `{str(claim['can_claim_global_first']).lower()}`",
f"- reason: {claim['reason']}",
"",
"## Remaining Gap",
"",
report["global_first_gap"],
"",
"## Next Actions",
"",
]
lines.extend(f"- {item}" for item in report["next_actions"])
lines.append("")
return "\n".join(lines)
def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
parser = argparse.ArgumentParser(description="Generate public Jyotish benchmark dashboard")
parser.add_argument("--oracle-file", default="references/oracle/dasha_shadbala_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_dashboard(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())
+62
View File
@@ -0,0 +1,62 @@
#!/usr/bin/env python3
"""Tests for the public Jyotish benchmark dashboard."""
from __future__ import annotations
import json
import subprocess
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
def run_dashboard(*args: str) -> subprocess.CompletedProcess[str]:
return subprocess.run(
[
sys.executable,
"scripts/public_benchmark_dashboard.py",
"--oracle-file",
"references/oracle/dasha_shadbala_oracle_cases.json",
*args,
],
cwd=ROOT,
text=True,
capture_output=True,
timeout=60,
check=False,
)
def test_public_benchmark_dashboard_outputs_stable_json_summary() -> None:
completed = run_dashboard("--format", "json")
assert completed.returncode == 0, completed.stderr or completed.stdout
report = json.loads(completed.stdout)
assert report["scope"] == "public_jyotish_benchmark_dashboard"
assert report["schema_version"] == 1
assert report["summary"]["technique_count"] >= 60
assert report["summary"]["capability_valid"] is True
assert report["oracle_readiness"]["total_packets"] == 5
assert report["oracle_readiness"]["valid_packets"] == 0
assert report["oracle_readiness"]["ready_for_calibration"] == 0
assert report["oracle_readiness"]["production_tuning_allowed"] is False
assert report["boundary_audit"]["production_tuning_recommended"] is False
assert "Dasha/Shadbala" in report["global_first_gap"]
assert report["public_claim"]["can_claim_global_first"] is False
assert report["public_claim"]["reason"]
def test_public_benchmark_dashboard_outputs_markdown_and_can_write_file(tmp_path: Path) -> None:
output = tmp_path / "benchmark.md"
completed = run_dashboard("--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 "# Public Jyotish Benchmark Dashboard" in markdown
assert "Dasha/Shadbala Oracle Readiness" in markdown
assert "Global First Claim" in markdown
assert "can_claim_global_first: `false`" in markdown
assert "production_tuning_allowed: `false`" in markdown