Files
Jyotisha/scripts/book_admission_gate.py
T
ClaudeandClaude Opus 5.5 8ed5b5f3c9 feat(engine): port upstream skill calculation fixes into the engine (BUG-1699)
- affliction_evidence / career_semantic_profile / career_analysis (functional
  roles, affliction signals, user-industry gate)
- sade_sati.build_saturn_cycle_timeline with bisected ingress moments
  (FLG_SIDEREAL frame, BUG-1275)
- Chesta profile candidates and PL9 AV cell profile as sidecars
  (shadbala.py / ashtakavarga.py stay frozen, ERR-110)
- Raman Sahams in the annual pack; book rule packets + admission gate
- consultation_native_layers: affliction_evidence, career_analysis,
  sade_sati_timeline, shadbala_chesta_profiles, book_rules,
  annual_tajika.raman_sahams

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DbBXoyn7Hj3LCW3BUs5bZ8
2026-11-07 14:42:54 +08:00

119 lines
4.4 KiB
Python

"""Promotion gate for copyright-safe book rule packets.
Admission to ``runtime_packet_ids`` is a provenance-reference status only.
A ``validated_reference`` packet may become runtime-visible only when ALL of
the following are true:
* ``validation.status`` is one of the validated receipts
(``fixture_passed`` / ``engine_cross_checked`` / ``case_calibrated``);
* ``validation.validation_kind`` is a formula-grade kind
(``fixture_numeric`` / ``engine_cross_checked`` / ``case_calibrated``) --
a status alone is never trusted;
* ``validation.validated_assertions`` is a non-empty list of concrete
assertions the fixture actually checks;
* ``validation.test_path`` matches the expected ``tests/...py[::node]``
format AND the referenced test file exists in the main repo.
Packets that only wire source paths, boundary text, or unrelated legacy tests
must stay ``candidate_mapped`` / ``reference_only`` with
``validation.status: not_validated``; they never enter ``runtime_packet_ids``.
"""
from __future__ import annotations
import re
from pathlib import Path
from typing import Any
VALIDATION_RECEIPTS = {
"fixture_passed",
"engine_cross_checked",
"case_calibrated",
}
# Formula-grade validation kinds: real numeric/formula assertions with a
# verifiable receipt. Wiring/boundary-text checks are not validation.
VALIDATED_KINDS = {
"fixture_numeric",
"engine_cross_checked",
"case_calibrated",
}
TEST_PATH_PATTERN = re.compile(r"^tests/[A-Za-z0-9_./\-]+\.py(::[A-Za-z0-9_]+){0,2}$")
BOUNDARY = "Admission state never implies Technique Audit execution."
ROOT = Path(__file__).resolve().parents[1]
def _test_path_reason(test_path: Any) -> str | None:
"""Return a failure reason when the test path is not a verifiable receipt."""
if not isinstance(test_path, str) or not test_path.strip():
return "validated_reference_requires_test_path"
if not TEST_PATH_PATTERN.match(test_path.strip()):
return "invalid_test_path_format"
file_part = test_path.strip().split("::", 1)[0]
if not (ROOT / file_part).is_file():
return f"test_file_missing:{file_part}"
return None
def _packet_validation_failure(packet: dict[str, Any]) -> str | None:
"""Return the reason a validated_reference packet fails the gate, if any."""
validation = packet.get("validation")
if not isinstance(validation, dict):
return "validated_reference_requires_validation_block"
status = validation.get("status")
if status not in VALIDATION_RECEIPTS:
return "validated_reference_requires_validation_receipt"
kind = validation.get("validation_kind")
if kind not in VALIDATED_KINDS:
return (
"validated_reference_requires_formula_grade_validation_kind"
+ (f":{kind}" if kind is not None else "")
)
assertions = validation.get("validated_assertions")
if not isinstance(assertions, list) or not assertions:
return "validated_reference_requires_non_empty_validated_assertions"
test_path_reason = _test_path_reason(validation.get("test_path"))
if test_path_reason is not None:
return test_path_reason
return None
def build_report(cards_document: dict[str, Any], packets_document: dict[str, Any]) -> dict[str, Any]:
"""Return the packets permitted as provenance references, never execution records."""
del cards_document # Cards are supplied for the shared report contract, not promotion.
runtime_packet_ids: list[str] = []
blocked_packet_ids: list[str] = []
failures: list[dict[str, str]] = []
for packet in packets_document.get("packets", []):
rule_id = packet.get("rule_id", "")
admission_state = packet.get("admission_state")
if admission_state == "blocked":
blocked_packet_ids.append(rule_id)
continue
if admission_state != "validated_reference":
continue
failure_reason = _packet_validation_failure(packet)
if failure_reason is None:
runtime_packet_ids.append(rule_id)
else:
failures.append(
{
"id": "invalid_validated_packet",
"rule_id": rule_id,
"reason": failure_reason,
}
)
return {
"runtime_packet_ids": sorted(runtime_packet_ids),
"blocked_packet_ids": sorted(blocked_packet_ids),
"failures": sorted(failures, key=lambda failure: failure["rule_id"]),
"boundary": BOUNDARY,
}