feat(oracle): add tajika annual closure status board

scripts/tajika_annual_oracle_queue.py

@@ -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: