375 lines
13 KiB
Python
375 lines
13 KiB
Python
from __future__ import annotations
|
|
|
|
from datetime import date, datetime
|
|
from uuid import uuid4
|
|
|
|
import pytest
|
|
|
|
from scripts import dynamic_rectification
|
|
|
|
|
|
def _base_request() -> dict:
|
|
return {
|
|
"case_id": "case-1",
|
|
"birth_date": "1990-01-01",
|
|
"as_of_date": "2026-07-18",
|
|
"start_time": "05:30",
|
|
"end_time": "05:33",
|
|
"lat": 31.23,
|
|
"lon": 121.47,
|
|
"tz": 8.0,
|
|
"evidence": [],
|
|
"dismissed_opportunity_ids": [],
|
|
"question_fingerprints": [],
|
|
"partition_fingerprints": [],
|
|
"recent_ranges": [],
|
|
}
|
|
|
|
|
|
def _fake_rows(_request: dict) -> list[dict]:
|
|
return [
|
|
{
|
|
"dimension_code": "career",
|
|
"window_start": "2014-01-01",
|
|
"window_end": "2017-12-31",
|
|
"activations": {"05:30": 5.0, "05:31": 1.0, "05:32": 0.0, "05:33": 0.0},
|
|
"missing_layers": [],
|
|
},
|
|
{
|
|
"dimension_code": "career",
|
|
"window_start": "2018-01-01",
|
|
"window_end": "2021-12-31",
|
|
"activations": {"05:30": 0.0, "05:31": 5.0, "05:32": 4.0, "05:33": 0.0},
|
|
"missing_layers": [],
|
|
},
|
|
{
|
|
"dimension_code": "career",
|
|
"window_start": "2022-01-01",
|
|
"window_end": "2026-07-18",
|
|
"activations": {"05:30": 0.0, "05:31": 0.0, "05:32": 1.0, "05:33": 5.0},
|
|
"missing_layers": [],
|
|
},
|
|
]
|
|
|
|
|
|
def _fake_model() -> dict:
|
|
return {
|
|
"version": "birth-time-choice-scoring-v2",
|
|
"birth_date": "1990-01-01",
|
|
"as_of_date": "2026-07-18",
|
|
"range": {"start_time": "05:30", "end_time": "05:33"},
|
|
"candidate_times": ["05:30", "05:31", "05:32", "05:33"],
|
|
"windows": _fake_rows({}),
|
|
}
|
|
|
|
|
|
def _score_request() -> dict:
|
|
return {
|
|
"birth_date": "1990-01-01",
|
|
"start_time": "05:30",
|
|
"end_time": "05:33",
|
|
"lat": 31.23,
|
|
"lon": 121.47,
|
|
"tz": 8.0,
|
|
"choice_evidence": [],
|
|
}
|
|
|
|
|
|
def _decisive_rows() -> list[dict]:
|
|
return [
|
|
{"time": "05:30", "score": 20.0},
|
|
{"time": "05:31", "score": 20.0},
|
|
{"time": "05:32", "score": 20.0},
|
|
{"time": "05:33", "score": 10.0},
|
|
]
|
|
|
|
|
|
def test_packet_contains_only_candidate_backed_high_gain_opportunities(monkeypatch) -> None:
|
|
monkeypatch.setattr(dynamic_rectification, "_candidate_window_rows", _fake_rows)
|
|
|
|
packet = dynamic_rectification.build_difference_packet(_base_request())
|
|
|
|
assert packet["scoring_version"] == "birth-time-choice-scoring-v2"
|
|
assert packet["current_range"] == {"start_time": "05:30", "end_time": "05:33"}
|
|
assert len(packet["opportunities"]) >= 1
|
|
for opportunity in packet["opportunities"]:
|
|
assert opportunity["estimated_information_gain"] >= 0.15
|
|
assert 2 <= len(opportunity["partitions"]) <= 4
|
|
assert len({item["partition_id"] for item in opportunity["partitions"]}) == len(
|
|
opportunity["partitions"]
|
|
)
|
|
for partition in opportunity["partitions"]:
|
|
assert set(partition["candidate_scores"]) == {"05:30", "05:31", "05:32", "05:33"}
|
|
|
|
|
|
def test_packet_excludes_used_opportunity_and_partition_fingerprints(monkeypatch) -> None:
|
|
monkeypatch.setattr(dynamic_rectification, "_candidate_window_rows", _fake_rows)
|
|
first = dynamic_rectification.build_difference_packet(_base_request())
|
|
used = first["opportunities"][0]
|
|
request = _base_request()
|
|
request["dismissed_opportunity_ids"] = [used["opportunity_id"]]
|
|
request["partition_fingerprints"] = [used["candidate_partition_fingerprint"]]
|
|
|
|
second = dynamic_rectification.build_difference_packet(request)
|
|
|
|
assert all(item["opportunity_id"] != used["opportunity_id"] for item in second["opportunities"])
|
|
assert all(
|
|
item["candidate_partition_fingerprint"] != used["candidate_partition_fingerprint"]
|
|
for item in second["opportunities"]
|
|
)
|
|
|
|
|
|
def test_packet_reuses_the_persisted_candidate_model(monkeypatch) -> None:
|
|
calls: list[dict] = []
|
|
monkeypatch.setattr(
|
|
dynamic_rectification,
|
|
"_compute_candidate_model",
|
|
lambda request: calls.append(request) or _fake_model(),
|
|
)
|
|
first = dynamic_rectification.build_difference_packet(_base_request())
|
|
|
|
second = dynamic_rectification.build_difference_packet(
|
|
{**_base_request(), "candidate_model": first["candidate_model"]}
|
|
)
|
|
|
|
assert len(calls) == 1
|
|
assert second["candidate_model"] == first["candidate_model"]
|
|
|
|
|
|
def test_candidate_model_rejects_wrong_range_and_non_finite_activation() -> None:
|
|
model = _fake_model()
|
|
model["range"] = {"start_time": "05:31", "end_time": "05:33"}
|
|
with pytest.raises(ValueError, match="candidate model"):
|
|
dynamic_rectification.build_difference_packet({**_base_request(), "candidate_model": model})
|
|
|
|
model = _fake_model()
|
|
model["windows"][0]["activations"]["05:30"] = float("nan")
|
|
with pytest.raises(ValueError, match="candidate model"):
|
|
dynamic_rectification.build_difference_packet({**_base_request(), "candidate_model": model})
|
|
|
|
|
|
def test_candidate_model_rejects_out_of_bounds_windows_and_boolean_activations() -> None:
|
|
model = _fake_model()
|
|
model["windows"][0]["window_end"] = "2027-01-01"
|
|
with pytest.raises(ValueError, match="candidate model"):
|
|
dynamic_rectification.build_difference_packet({**_base_request(), "candidate_model": model})
|
|
|
|
model = _fake_model()
|
|
model["windows"][0]["activations"]["05:30"] = True
|
|
with pytest.raises(ValueError, match="candidate model"):
|
|
dynamic_rectification.build_difference_packet({**_base_request(), "candidate_model": model})
|
|
|
|
|
|
def test_existing_evidence_summary_must_be_effective_partition_evidence(monkeypatch) -> None:
|
|
monkeypatch.setattr(dynamic_rectification, "_candidate_window_rows", _fake_rows)
|
|
|
|
with pytest.raises(ValueError, match="partition evidence"):
|
|
dynamic_rectification.build_difference_packet(
|
|
{**_base_request(), "evidence": [{"kind": "unmatched", "note": "free text"}]}
|
|
)
|
|
|
|
|
|
def test_candidate_charts_are_computed_once_and_missing_layers_stay_dimension_scoped(
|
|
monkeypatch,
|
|
) -> None:
|
|
from scripts import active_rectification_event_engine
|
|
|
|
candidates = [datetime(1990, 1, 1, 5, 30), datetime(1990, 1, 1, 5, 31)]
|
|
calls: list[datetime] = []
|
|
monkeypatch.setattr(
|
|
active_rectification_event_engine,
|
|
"_candidate_datetimes",
|
|
lambda _request: candidates,
|
|
)
|
|
|
|
def fake_candidate_row(request: dict, candidate: datetime) -> dict:
|
|
calls.append(candidate)
|
|
return {
|
|
"time": candidate.strftime("%H:%M"),
|
|
"score": 0.0,
|
|
"evidence": [
|
|
{
|
|
"event_id": event["id"],
|
|
"domain": event["domain"],
|
|
"candidate_time": candidate.strftime("%H:%M"),
|
|
"rule_ids": ["fixture"],
|
|
"points": 1.0,
|
|
}
|
|
for event in request["events"]
|
|
if event["domain"] != "career"
|
|
],
|
|
"missing_layers": ["D10"],
|
|
}
|
|
|
|
monkeypatch.setattr(active_rectification_event_engine, "_candidate_row", fake_candidate_row)
|
|
|
|
rows = dynamic_rectification._candidate_window_rows(_base_request())
|
|
|
|
assert calls == candidates
|
|
assert {tuple(row["missing_layers"]) for row in rows if row["dimension_code"] == "career"} == {("D10",)}
|
|
assert {tuple(row["missing_layers"]) for row in rows if row["dimension_code"] != "career"} == {()}
|
|
|
|
|
|
def test_experience_windows_remain_valid_on_the_twelfth_birthday() -> None:
|
|
windows = dynamic_rectification._experience_windows("2000-01-01", "2012-01-01")
|
|
|
|
assert windows == [(date(2012, 1, 1), date(2012, 1, 1))]
|
|
|
|
|
|
def test_candidate_engine_is_not_called_before_age_twelve(monkeypatch) -> None:
|
|
from scripts import active_rectification_event_engine
|
|
|
|
monkeypatch.setattr(
|
|
active_rectification_event_engine,
|
|
"_candidate_row",
|
|
lambda *_args: pytest.fail("candidate chart should not be computed"),
|
|
)
|
|
|
|
rows = dynamic_rectification._candidate_window_rows(
|
|
{**_base_request(), "birth_date": "2020-01-01"}
|
|
)
|
|
|
|
assert rows == []
|
|
|
|
def test_primary_choice_changes_rankings_and_returns_a_real_range() -> None:
|
|
result = dynamic_rectification.score_choice_evidence(
|
|
{
|
|
**_score_request(),
|
|
"choice_evidence": [
|
|
{
|
|
"question_id": str(uuid4()),
|
|
"opportunity_id": "career-window",
|
|
"partition_id": "career-2020-2022",
|
|
"dimension_code": "career",
|
|
"candidate_scores": {"05:30": 0.0, "05:31": 1.0, "05:32": 1.0, "05:33": 0.0},
|
|
"information_gain": 0.5,
|
|
}
|
|
],
|
|
}
|
|
)
|
|
|
|
assert result["effective_answer_count"] == 1
|
|
assert result["winning_segment"] == {
|
|
"start_time": "05:31",
|
|
"end_time": "05:32",
|
|
"representative_time": "05:31",
|
|
"width_minutes": 2,
|
|
}
|
|
assert result["can_apply"] is False
|
|
assert result["evidence"] == []
|
|
|
|
|
|
def test_score_accepts_canonical_candidate_membership_independent_of_json_key_order() -> None:
|
|
result = dynamic_rectification.score_choice_evidence(
|
|
{
|
|
**_score_request(),
|
|
"choice_evidence": [
|
|
{
|
|
"question_id": str(uuid4()),
|
|
"opportunity_id": "career-window",
|
|
"partition_id": "career-2020-2022",
|
|
"dimension_code": "career",
|
|
"candidate_scores": {"05:33": 0.0, "05:32": 1.0, "05:31": 1.0, "05:30": 0.0},
|
|
"information_gain": 0.5,
|
|
}
|
|
],
|
|
}
|
|
)
|
|
|
|
assert result["winning_segment"]["start_time"] == "05:31"
|
|
|
|
|
|
def test_unknown_and_unmatched_are_never_choice_evidence() -> None:
|
|
with pytest.raises(ValueError, match="partition evidence"):
|
|
dynamic_rectification.score_choice_evidence(
|
|
{**_score_request(), "choice_evidence": [{"kind": "unknown"}]}
|
|
)
|
|
|
|
|
|
def test_high_confidence_requires_versioned_hard_gates() -> None:
|
|
result = dynamic_rectification.adjudicate_choice_rows(
|
|
_decisive_rows(),
|
|
effective_answer_count=4,
|
|
dimension_count=3,
|
|
missing_layers=[],
|
|
)
|
|
|
|
assert result["confidence"] == "high"
|
|
assert result["can_apply"] is True
|
|
assert result["winning_segment"]["width_minutes"] <= 5
|
|
assert result["margin_percent"] >= 20
|
|
assert result["algorithm_version"] == "birth-time-choice-scoring-v2"
|
|
|
|
|
|
def test_medium_and_missing_layers_never_allow_application() -> None:
|
|
medium = dynamic_rectification.adjudicate_choice_rows(
|
|
_decisive_rows(),
|
|
effective_answer_count=3,
|
|
dimension_count=2,
|
|
missing_layers=[],
|
|
)
|
|
blocked = dynamic_rectification.adjudicate_choice_rows(
|
|
_decisive_rows(),
|
|
effective_answer_count=4,
|
|
dimension_count=3,
|
|
missing_layers=["D10"],
|
|
)
|
|
|
|
assert medium["confidence"] == "medium"
|
|
assert medium["can_apply"] is False
|
|
assert blocked["confidence"] == "low"
|
|
assert blocked["can_apply"] is False
|
|
|
|
|
|
def test_score_rejects_client_fields_duplicates_caps_and_invalid_scores() -> None:
|
|
evidence = {
|
|
"question_id": str(uuid4()),
|
|
"opportunity_id": "career-window",
|
|
"partition_id": "career-2020-2022",
|
|
"dimension_code": "career",
|
|
"candidate_scores": {"05:30": 0.0, "05:31": 1.0, "05:32": 1.0, "05:33": 0.0},
|
|
"information_gain": 0.5,
|
|
}
|
|
with pytest.raises(ValueError, match="option_id"):
|
|
dynamic_rectification.score_choice_evidence(
|
|
{**_score_request(), "choice_evidence": [{**evidence, "option_id": "client-owned"}]}
|
|
)
|
|
with pytest.raises(ValueError, match="duplicate question"):
|
|
dynamic_rectification.score_choice_evidence(
|
|
{**_score_request(), "choice_evidence": [evidence, evidence]}
|
|
)
|
|
with pytest.raises(ValueError, match="at most 10"):
|
|
dynamic_rectification.score_choice_evidence(
|
|
{
|
|
**_score_request(),
|
|
"choice_evidence": [
|
|
{**evidence, "question_id": str(uuid4())} for _ in range(11)
|
|
],
|
|
}
|
|
)
|
|
with pytest.raises(ValueError, match="candidate scores"):
|
|
dynamic_rectification.score_choice_evidence(
|
|
{
|
|
**_score_request(),
|
|
"choice_evidence": [
|
|
{**evidence, "candidate_scores": {**evidence["candidate_scores"], "05:34": 1.0}}
|
|
],
|
|
}
|
|
)
|
|
with pytest.raises(ValueError, match="candidate scores"):
|
|
dynamic_rectification.score_choice_evidence(
|
|
{
|
|
**_score_request(),
|
|
"choice_evidence": [
|
|
{
|
|
**evidence,
|
|
"candidate_scores": {**evidence["candidate_scores"], "05:30": -1.0},
|
|
}
|
|
],
|
|
}
|
|
)
|
|
with pytest.raises(ValueError, match="identifier"):
|
|
dynamic_rectification.score_choice_evidence(
|
|
{**_score_request(), "choice_evidence": [{**evidence, "partition_id": ""}]}
|
|
)
|