awoooi/apps/api/tests/test_dependency_upgrade_approval_package_template.py

from __future__ import annotations

import json

import pytest

from src.services.dependency_upgrade_approval_package_template import (
    load_latest_dependency_upgrade_approval_package_template,
)


def test_load_latest_dependency_upgrade_approval_package_template_reads_newest_file(tmp_path):
    older = _snapshot(generated_at="2026-06-03T00:00:00+08:00", completion=99)
    newer = _snapshot(generated_at="2026-06-04T00:00:00+08:00", completion=100)
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-03.json").write_text(
        json.dumps(older),
        encoding="utf-8",
    )
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-04.json").write_text(
        json.dumps(newer),
        encoding="utf-8",
    )

    loaded = load_latest_dependency_upgrade_approval_package_template(tmp_path)

    assert loaded["generated_at"] == "2026-06-04T00:00:00+08:00"
    assert loaded["program_status"]["overall_completion_percent"] == 100
    assert loaded["rollups"]["total_templates"] == 2
    assert loaded["operation_boundaries"]["package_upgrade_allowed"] is False


def test_dependency_upgrade_approval_package_template_requires_read_only_mode(tmp_path):
    snapshot = _snapshot()
    snapshot["program_status"]["read_only_mode"] = False
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-04.json").write_text(
        json.dumps(snapshot),
        encoding="utf-8",
    )

    with pytest.raises(ValueError, match="read_only_mode"):
        load_latest_dependency_upgrade_approval_package_template(tmp_path)


def test_dependency_upgrade_approval_package_template_requires_blocked_operations(tmp_path):
    snapshot = _snapshot()
    snapshot["operation_boundaries"]["lockfile_write_allowed"] = True
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-04.json").write_text(
        json.dumps(snapshot),
        encoding="utf-8",
    )

    with pytest.raises(ValueError, match="operation boundaries"):
        load_latest_dependency_upgrade_approval_package_template(tmp_path)


def test_dependency_upgrade_approval_package_template_requires_total_consistency(tmp_path):
    snapshot = _snapshot()
    snapshot["rollups"]["total_templates"] = 999
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-04.json").write_text(
        json.dumps(snapshot),
        encoding="utf-8",
    )

    with pytest.raises(ValueError, match="total_templates"):
        load_latest_dependency_upgrade_approval_package_template(tmp_path)


def test_dependency_upgrade_approval_package_template_requires_ready_id_consistency(tmp_path):
    snapshot = _snapshot()
    snapshot["rollups"]["template_ready_ids"] = []
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-04.json").write_text(
        json.dumps(snapshot),
        encoding="utf-8",
    )

    with pytest.raises(ValueError, match="template_ready_ids"):
        load_latest_dependency_upgrade_approval_package_template(tmp_path)


def test_dependency_upgrade_approval_package_template_requires_hitl_consistency(tmp_path):
    snapshot = _snapshot()
    snapshot["rollups"]["hitl_required_template_ids"] = []
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-04.json").write_text(
        json.dumps(snapshot),
        encoding="utf-8",
    )

    with pytest.raises(ValueError, match="hitl_required_template_ids"):
        load_latest_dependency_upgrade_approval_package_template(tmp_path)


def test_dependency_upgrade_approval_package_template_requires_hitl_gate(tmp_path):
    snapshot = _snapshot()
    snapshot["decision_gate_contract"]["hitl_required"] = False
    (tmp_path / "dependency_upgrade_approval_package_template_2026-06-04.json").write_text(
        json.dumps(snapshot),
        encoding="utf-8",
    )

    with pytest.raises(ValueError, match="hitl_required"):
        load_latest_dependency_upgrade_approval_package_template(tmp_path)


def test_dependency_upgrade_approval_package_template_fails_when_missing(tmp_path):
    with pytest.raises(FileNotFoundError):
        load_latest_dependency_upgrade_approval_package_template(tmp_path)


def _snapshot(
    *,
    generated_at: str = "2026-06-04T00:00:00+08:00",
    completion: int = 100,
) -> dict:
    return {
        "schema_version": "dependency_upgrade_approval_package_template_v1",
        "generated_at": generated_at,
        "program_status": {
            "overall_completion_percent": completion,
            "current_priority": "P1",
            "current_task_id": "P1-206",
            "next_task_id": "P1-103",
            "read_only_mode": True,
        },
        "source_refs": ["docs/evaluations/dependency_drift_check_plan_2026-06-04.json"],
        "rollups": {
            "total_templates": 2,
            "by_domain": {"python": 1, "docker": 1},
            "template_ready_ids": [
                "python_manifest_authority_package",
                "docker_base_digest_pin_package",
            ],
            "hitl_required_template_ids": [
                "python_manifest_authority_package",
                "docker_base_digest_pin_package",
            ],
        },
        "approval_fields": [
            {
                "field_id": "evidence_refs",
                "required": True,
                "description": "evidence",
            }
        ],
        "package_templates": [
            _template("python_manifest_authority_package", "python", "openclaw"),
            _template("docker_base_digest_pin_package", "docker", "openclaw"),
        ],
        "decision_gate_contract": {
            "openclaw_role": "arbitrate",
            "hermes_role": "summarize",
            "nemotron_role": "offline compare",
            "hitl_required": True,
            "expires_after": "7 days",
        },
        "operation_boundaries": {
            "read_only_template_allowed": True,
            "external_source_activation_allowed": False,
            "sdk_installation_allowed": False,
            "paid_api_call_allowed": False,
            "package_installation_allowed": False,
            "package_upgrade_allowed": False,
            "lockfile_write_allowed": False,
            "manifest_write_allowed": False,
            "dockerfile_write_allowed": False,
            "docker_build_allowed": False,
            "image_pull_allowed": False,
            "image_rebuild_allowed": False,
            "registry_push_allowed": False,
            "package_publish_allowed": False,
            "shadow_or_canary_allowed": False,
            "production_routing_allowed": False,
        },
        "approval_boundaries": {
            "sdk_installation_allowed": False,
            "paid_api_call_allowed": False,
            "shadow_or_canary_allowed": False,
            "production_routing_allowed": False,
            "destructive_operation_allowed": False,
        },
    }


def _template(template_id: str, domain: str, owner_agent: str) -> dict:
    return {
        "template_id": template_id,
        "domain": domain,
        "status": "template_ready",
        "owner_agent": owner_agent,
        "purpose": "approval package",
        "required_evidence": ["docs/evaluations/dependency_risk_policy_2026-06-04.json"],
        "required_decisions": ["approve or reject"],
        "required_tests": ["schema validation"],
        "rollback_requirements": ["revert patch"],
        "manual_approvals": ["OpenClaw arbitration", "HITL approval"],
        "prohibited_without_approval": ["package upgrade"],
        "evidence_refs": ["docs/evaluations/dependency_drift_check_plan_2026-06-04.json"],
    }