From 928ce293d0a70a147b6ed3aa738be5893ce02d9a Mon Sep 17 00:00:00 2001
From: Jun-te Kim <juntekim@googlemail.com>
Date: Thu, 2 Jul 2026 19:48:10 +0000
Subject: [PATCH] docs(ledger): re-rank at 77.0% + triage electric-tariff &
 fabric tail

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../uprn_100040550095/epc.json                | 510 ++++++++++++++++++
 scripts/corpus_1000/worklist.md               |   8 +-
 2 files changed, 514 insertions(+), 4 deletions(-)
 create mode 100644 backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-21.0.1/uprn_100040550095/epc.json

diff --git a/backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-21.0.1/uprn_100040550095/epc.json b/backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-21.0.1/uprn_100040550095/epc.json
new file mode 100644
index 000000000..98b566cf4
--- /dev/null
+++ b/backend/epc_api/json_samples/real_life_examples/RdSAP-Schema-21.0.1/uprn_100040550095/epc.json
@@ -0,0 +1,510 @@
+{
+  "uprn": 100040550095,
+  "roofs": [
+    {
+      "description": "Pitched, 175 mm loft insulation",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "walls": [
+    {
+      "description": "Granite or whin, as built, no insulation (assumed)",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    },
+    {
+      "description": "Solid brick, as built, no insulation (assumed)",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 1
+    }
+  ],
+  "floors": [
+    {
+      "description": "Solid, no insulation (assumed)",
+      "energy_efficiency_rating": 0,
+      "environmental_efficiency_rating": 0
+    }
+  ],
+  "status": "entered",
+  "tenure": 3,
+  "window": {
+    "description": "Fully double glazed",
+    "energy_efficiency_rating": 2,
+    "environmental_efficiency_rating": 2
+  },
+  "addendum": {
+    "stone_walls": "true"
+  },
+  "lighting": {
+    "description": "Excellent lighting efficiency",
+    "energy_efficiency_rating": 5,
+    "environmental_efficiency_rating": 5
+  },
+  "postcode": "TQ1 2BW",
+  "hot_water": {
+    "description": "Electric immersion, standard tariff",
+    "energy_efficiency_rating": 1,
+    "environmental_efficiency_rating": 5
+  },
+  "post_town": "TORQUAY",
+  "built_form": 4,
+  "created_at": "2026-05-20 13:21:34",
+  "door_count": 2,
+  "region_code": 15,
+  "report_type": 2,
+  "sap_heating": {
+    "number_baths": 1,
+    "cylinder_size": 2,
+    "shower_outlets": [
+      {
+        "shower_wwhrs": 1,
+        "shower_outlet_type": 2
+      }
+    ],
+    "number_baths_wwhrs": 0,
+    "water_heating_code": 903,
+    "water_heating_fuel": 29,
+    "main_heating_details": [
+      {
+        "has_fghrs": "N",
+        "main_fuel_type": 29,
+        "heat_emitter_type": 0,
+        "emitter_temperature": "NA",
+        "main_heating_number": 1,
+        "main_heating_control": 2603,
+        "main_heating_category": 10,
+        "main_heating_fraction": 1,
+        "sap_main_heating_code": 691,
+        "main_heating_data_source": 2
+      }
+    ],
+    "immersion_heating_type": 2,
+    "cylinder_insulation_type": 2,
+    "has_fixed_air_conditioning": "false",
+    "cylinder_insulation_thickness": 38
+  },
+  "sap_version": 10.2,
+  "sap_windows": [
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_width": 0.91,
+      "window_height": 1.64,
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_width": 0.91,
+      "window_height": 1.64,
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 1,
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_width": 0.62,
+      "window_height": 0.91,
+      "draught_proofed": "true",
+      "window_location": 0,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 5,
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_width": 1.2,
+      "window_height": 0.88,
+      "draught_proofed": "true",
+      "window_location": 1,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 5,
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_width": 1.02,
+      "window_height": 0.82,
+      "draught_proofed": "true",
+      "window_location": 1,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    },
+    {
+      "pvc_frame": "true",
+      "glazing_gap": "16+",
+      "orientation": 5,
+      "window_type": 1,
+      "glazing_type": 3,
+      "window_width": 0.6,
+      "window_height": 1.14,
+      "draught_proofed": "true",
+      "window_location": 1,
+      "window_wall_type": 1,
+      "permanent_shutters_present": "N",
+      "permanent_shutters_insulated": "N"
+    }
+  ],
+  "schema_type": "RdSAP-Schema-21.0.1",
+  "uprn_source": "Energy Assessor",
+  "country_code": "ENG",
+  "main_heating": [
+    {
+      "description": "Room heaters, electric",
+      "energy_efficiency_rating": 1,
+      "environmental_efficiency_rating": 5
+    }
+  ],
+  "air_tightness": {
+    "description": "(not tested)",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "dwelling_type": "Mid-terrace house",
+  "language_code": 1,
+  "pressure_test": 4,
+  "property_type": 0,
+  "address_line_1": "11 Meadfoot Lane",
+  "assessment_type": "RdSAP",
+  "completion_date": "2026-05-20",
+  "inspection_date": "2026-05-20",
+  "extensions_count": 1,
+  "measurement_type": 1,
+  "total_floor_area": 59,
+  "transaction_type": 8,
+  "conservatory_type": 1,
+  "heated_room_count": 3,
+  "registration_date": "2026-05-20",
+  "sap_energy_source": {
+    "mains_gas": "Y",
+    "meter_type": 2,
+    "pv_connection": 0,
+    "photovoltaic_supply": {
+      "none_or_no_details": {
+        "percent_roof_area": 0
+      }
+    },
+    "wind_turbines_count": 0,
+    "gas_smart_meter_present": "true",
+    "is_dwelling_export_capable": "false",
+    "wind_turbines_terrain_type": 2,
+    "electricity_smart_meter_present": "true"
+  },
+  "secondary_heating": {
+    "description": "None",
+    "energy_efficiency_rating": 0,
+    "environmental_efficiency_rating": 0
+  },
+  "extract_fans_count": 1,
+  "sap_building_parts": [
+    {
+      "identifier": "Main Dwelling",
+      "wall_dry_lined": "N",
+      "wall_thickness": 510,
+      "floor_heat_loss": 7,
+      "roof_construction": 4,
+      "wall_construction": 1,
+      "building_part_number": 1,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.31,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 17.29,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.27,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 4.72,
+            "quantity": "metres"
+          }
+        },
+        {
+          "floor": 1,
+          "room_height": {
+            "value": 2.35,
+            "quantity": "metres"
+          },
+          "total_floor_area": {
+            "value": 17.29,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.27,
+            "quantity": "metres"
+          },
+          "heat_loss_perimeter": {
+            "value": 4.72,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "A",
+      "party_wall_construction": 1,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 2,
+      "roof_insulation_thickness": "175mm",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    },
+    {
+      "identifier": "Extension 1",
+      "wall_dry_lined": "N",
+      "wall_thickness": 185,
+      "floor_heat_loss": 7,
+      "sap_room_in_roof": {
+        "floor_area": 12.24,
+        "room_in_roof_type_2": {
+          "gable_wall_type_1": 1,
+          "gable_wall_type_2": 3,
+          "gable_wall_height_1": 2.5,
+          "gable_wall_height_2": 2.5,
+          "gable_wall_length_1": 7.39,
+          "gable_wall_length_2": 7.39,
+          "common_wall_height_1": 1.5,
+          "common_wall_height_2": 1.5,
+          "common_wall_length_1": 1.4,
+          "common_wall_length_2": 1.4
+        },
+        "construction_age_band": "A"
+      },
+      "roof_construction": 5,
+      "wall_construction": 3,
+      "building_part_number": 2,
+      "sap_floor_dimensions": [
+        {
+          "floor": 0,
+          "room_height": {
+            "value": 2.27,
+            "quantity": "metres"
+          },
+          "floor_insulation": 1,
+          "total_floor_area": {
+            "value": 12.24,
+            "quantity": "square metres"
+          },
+          "party_wall_length": {
+            "value": 7.39,
+            "quantity": "metres"
+          },
+          "floor_construction": 1,
+          "heat_loss_perimeter": {
+            "value": 2.8,
+            "quantity": "metres"
+          }
+        }
+      ],
+      "wall_insulation_type": 4,
+      "construction_age_band": "A",
+      "party_wall_construction": 0,
+      "wall_thickness_measured": "Y",
+      "roof_insulation_location": 4,
+      "roof_insulation_thickness": "ND",
+      "wall_insulation_thickness": "NI",
+      "floor_insulation_thickness": "NI"
+    }
+  ],
+  "solar_water_heating": "N",
+  "habitable_room_count": 3,
+  "heating_cost_current": {
+    "value": 1266,
+    "currency": "GBP"
+  },
+  "insulated_door_count": 0,
+  "co2_emissions_current": 1.1,
+  "energy_rating_average": 60,
+  "energy_rating_current": 40,
+  "lighting_cost_current": {
+    "value": 43,
+    "currency": "GBP"
+  },
+  "main_heating_controls": [
+    {
+      "description": "Programmer and appliance thermostats",
+      "energy_efficiency_rating": 4,
+      "environmental_efficiency_rating": 4
+    }
+  ],
+  "has_hot_water_cylinder": "true",
+  "heating_cost_potential": {
+    "value": 366,
+    "currency": "GBP"
+  },
+  "hot_water_cost_current": {
+    "value": 679,
+    "currency": "GBP"
+  },
+  "mechanical_ventilation": 0,
+  "percent_draughtproofed": 100,
+  "suggested_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 449,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a37,500 - \u00a311,000",
+      "improvement_type": "Q",
+      "improvement_details": {
+        "improvement_number": 7
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 55,
+      "environmental_impact_rating": 88
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 57,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a35,000 - \u00a310,000",
+      "improvement_type": "W2",
+      "improvement_details": {
+        "improvement_number": 58
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 56,
+      "environmental_impact_rating": 89
+    },
+    {
+      "sequence": 3,
+      "typical_saving": {
+        "value": 100,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a320 - \u00a340",
+      "improvement_type": "C",
+      "improvement_details": {
+        "improvement_number": 2
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 59,
+      "environmental_impact_rating": 89
+    },
+    {
+      "sequence": 4,
+      "typical_saving": {
+        "value": 671,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a33,500 - \u00a310,000",
+      "improvement_type": "T",
+      "improvement_details": {
+        "improvement_number": 29
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 76,
+      "environmental_impact_rating": 83
+    },
+    {
+      "sequence": 5,
+      "typical_saving": {
+        "value": 220,
+        "currency": "GBP"
+      },
+      "indicative_cost": "\u00a38,000 - \u00a310,000",
+      "improvement_type": "U",
+      "improvement_details": {
+        "improvement_number": 34
+      },
+      "improvement_category": 5,
+      "energy_performance_rating": 81,
+      "environmental_impact_rating": 84
+    }
+  ],
+  "co2_emissions_potential": 1.1,
+  "energy_rating_potential": 81,
+  "lighting_cost_potential": {
+    "value": 43,
+    "currency": "GBP"
+  },
+  "schema_version_original": "21.0.1",
+  "alternative_improvements": [
+    {
+      "sequence": 1,
+      "typical_saving": {
+        "value": 822,
+        "currency": "GBP"
+      },
+      "improvement_type": "J2",
+      "improvement_details": {
+        "improvement_number": 54
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 79,
+      "environmental_impact_rating": 96
+    },
+    {
+      "sequence": 2,
+      "typical_saving": {
+        "value": 524,
+        "currency": "GBP"
+      },
+      "improvement_type": "Z3",
+      "improvement_details": {
+        "improvement_number": 53
+      },
+      "improvement_category": 6,
+      "energy_performance_rating": 71,
+      "environmental_impact_rating": 74
+    }
+  ],
+  "hot_water_cost_potential": {
+    "value": 301,
+    "currency": "GBP"
+  },
+  "renewable_heat_incentive": {
+    "water_heating": 2452.35,
+    "space_heating_existing_dwelling": 4576.09
+  },
+  "draughtproofed_door_count": 2,
+  "energy_consumption_current": 189,
+  "has_fixed_air_conditioning": "false",
+  "multiple_glazed_proportion": 100,
+  "calculation_software_version": "5.02r0344",
+  "energy_consumption_potential": 102,
+  "environmental_impact_current": 84,
+  "current_energy_efficiency_band": "E",
+  "environmental_impact_potential": 84,
+  "led_fixed_lighting_bulbs_count": 7,
+  "has_heated_separate_conservatory": "false",
+  "potential_energy_efficiency_band": "B",
+  "co2_emissions_current_per_floor_area": 18,
+  "incandescent_fixed_lighting_bulbs_count": 0
+}
\ No newline at end of file
diff --git a/scripts/corpus_1000/worklist.md b/scripts/corpus_1000/worklist.md
index 24784b658..e40d688f2 100644
--- a/scripts/corpus_1000/worklist.md
+++ b/scripts/corpus_1000/worklist.md
@@ -25,7 +25,7 @@ Statuses: `[ ]` todo · `[x]` resolved ≤0.5 · 🔧 fix landed · ⚠ xfail en
 - ⚠ `10093237426` · L 81 / E 78.44 / Δ -2.56 <- LIG-21.0 software (calc 10.2.2.0) honours lodged 0 extract fans literally; Elmhurst-validated convention (case 46) treats 0 as unknown -> Table 5 default. Fans-as-0 experiment closes 1.42 of 2.56; residual -1.14 unexplained, same-software quadruplet.
 
 ### C006 · Σ|Δ| 10.1 · 1 certs · `h691/elec | granite or | pitched 175 | RR,ext1,whw903`
-- [ ] `100040550095` · L 40 / E 29.87 / Δ -10.13
+- [ ] `100040550095` · L 40 / E 29.87 / Δ -10.13 <- needs Elmhurst arbitration: PE+39/CO2+0.20 both over -> demand/fabric over-count (granite+solid-brick mixed walls + simplified RR type-2), not a cost bug
 
 ### C007 · Σ|Δ| 8.7 · 1 certs · `h125/fuel28 | cavity wall | pitched 250 | consv2,sec:room heaters`
 - [ ] `100121325434` · L 48 / E 56.75 / Δ +8.75
@@ -34,13 +34,13 @@ Statuses: `[ ]` todo · `[x]` resolved ≤0.5 · 🔧 fix landed · ⚠ xfail en
 - [ ] `100022294004` · L 75 / E 83.13 / Δ +8.13
 
 ### C009 · Σ|Δ| 7.8 · 1 certs · `h195/elec | cavity wall | (another dwelling`
-- [ ] `10091578598` · L 71 / E 78.81 / Δ +7.81
+- [ ] `10091578598` · L 71 / E 78.81 / Δ +7.81 <- electric-main off-peak tariff cohort: cost-only signature, storage/electric E7 high-rate-fraction split needs Elmhurst per-config arbitration (fixing blind regresses in-band storage certs)
 
 ### C010 · Σ|Δ| 7.7 · 1 certs · `h409/elec | solid brick | (another dwelling | consv2,sec:portable electric,whw909`
-- [ ] `74061136` · L 73 / E 80.72 / Δ +7.72
+- [ ] `74061136` · L 73 / E 80.72 / Δ +7.72 <- electric storage cat7 E7: over-rate = off-peak rate/fraction too generous; needs Elmhurst tariff arbitration
 
 ### C011 · Σ|Δ| 7.1 · 1 certs · `h408/elec | cavity wall | (another dwelling | whw941`
-- [ ] `200000322700` · L 58 / E 65.05 / Δ +7.05
+- [ ] `200000322700` · L 58 / E 65.05 / Δ +7.05 <- electric storage cat7 E7 over-rate; see 74061136
 
 ### C012 · Σ|Δ| 6.7 · 1 certs · `h691/elec | solid brick | pitched 100 | RR,ext1,whw909`
 - [ ] `100032223878` · L 11 / E 17.67 / Δ +6.67