Skip to content

Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.

4.2 KB
Raw Blame
#!/usr/bin/env python3
"""Pure scoring and accounting for synthetic evaluation trajectories."""
from __future__ import annotations

from typing import Any, Dict, Iterable, List

UNKNOWN = "unknown"


def _state(value: Any) -> Any:
    """Keep only explicit boolean observations; absence remains unknown."""
    return value if isinstance(value, bool) else UNKNOWN


def _count(value: Any) -> Any:
    """Keep only explicit non-negative integer counts; absence remains unknown.

    ``bool`` is a subclass of ``int``, so a JSON ``true`` would otherwise pass an
    ``isinstance(value, int)`` test and then be summed as 1 -- inventing a usage
    number this module promises never to estimate. Negative sentinels likewise
    cannot represent recorded token or call counts.
    """
    return value if isinstance(value, int) and not isinstance(value, bool) and value >= 0 else UNKNOWN


def score_trajectory(trajectory: Dict[str, Any]) -> Dict[str, Any]:
    """Score one trajectory without loading files or deriving missing observations."""
    expected = trajectory.get("expected", {})
    observed = trajectory.get("observed", {})
    target = expected.get("target")
    opens = observed.get("opens")
    opened_target = (
        any(opened == target for opened in opens)
        if isinstance(opens, list) and target is not None
        else UNKNOWN
    )
    # Where the target appears among the opens, or None when it does not appear
    # at all. `opens.index(target)` was called unguarded further down, so a
    # harness that recorded route_correct itself -- while `opens` did not contain
    # the target verbatim (an empty list, a "./" prefix, any path normalisation
    # difference) -- raised ValueError and killed the whole scoring run.
    target_position = (
        opens.index(target)
        if isinstance(opens, list) and target is not None and target in opens
        else None
    )
    answer_correct = _state(observed.get("answer_correct"))
    route_correct = _state(observed.get("route_correct"))
    evidence_reached = _state(observed.get("evidence_reached"))
    if "route_correct" not in observed and opened_target is not UNKNOWN:
        route_correct = opened_target
    if "evidence_reached" not in observed and opened_target is not UNKNOWN:
        evidence_reached = opened_target

    if UNKNOWN in (route_correct, evidence_reached, answer_correct):
        classification = UNKNOWN
    elif not route_correct:
        classification = "wrong_routing"
    elif not answer_correct:
        classification = "wrong_answer"
    elif target_position is not None and target_position > 0:
        classification = "irrelevant_opens_before_target"
    else:
        classification = "correct"

    usage = observed.get("usage")
    usage = usage if isinstance(usage, dict) else {}
    return {
        "question_id": trajectory["question_id"],
        "classification": classification,
        "routing_correct": route_correct,
        "evidence_reached": evidence_reached,
        "answer_correct": answer_correct,
        "usage": {key: _count(usage.get(key))
                  for key in ("input_tokens", "output_tokens", "calls")},
    }


def aggregate(results: Iterable[Dict[str, Any]]) -> Dict[str, Any]:
    """Aggregate recorded usage and classifications; never estimate missing usage."""
    items = list(results)
    counts: Dict[str, int] = {}
    totals = {"input_tokens": 0, "output_tokens": 0, "calls": 0}
    recorded = {key: 0 for key in totals}
    for result in items:
        label = result["classification"]
        counts[label] = counts.get(label, 0) + 1
        for key in totals:
            value = result["usage"][key]
            if value != UNKNOWN:
                totals[key] += value
                recorded[key] += 1
    return {
        "questions": len(items),
        "classifications": counts,
        "recorded_usage": totals,
        "usage_observations": recorded,
    }


def score(trajectories: Iterable[Dict[str, Any]]) -> Dict[str, Any]:
    """Return deterministic per-question and aggregate replay results."""
    questions: List[Dict[str, Any]] = [score_trajectory(item) for item in trajectories]
    questions.sort(key=lambda item: item["question_id"])
    return {"questions": questions, "aggregate": aggregate(questions)}