Lodges the missing cert fields on 000477 build_epc to match U985 PDF:
- sap_windows = SECTION_6_VERTICAL_WINDOWS (was empty)
- low_energy_fixed_lighting_bulbs_count = 9 (was None)
- sap_heating.main_heating_details with PCDF index 18118 (was default)
- sap_heating.secondary_heating_type = 691 (was None)
- sap_heating.number_baths = 0 (PDF lodges 0 baths; was None → defaulted to "has bath"=True)
`make_sap_heating` accepts a new `number_baths` kwarg to surface that
field — it lives on SapHeating but wasn't exposed before.
Impact: 000477 SAP integer 71 → 66 (PDF 65, Δ +6 → +1); cost £599 →
£707 vs PDF £732 (Δ -22% → -3.5%); useful 9059 → 10067 vs PDF 10111
(matches to <0.5%).
Remaining +1 SAP integer delta is the **Table 3c two-profile combi-
loss override** — not yet implemented. PCDB 18118 (Vaillant ecoTEC
sustain 24) lodges separate_dhw_tests=2 → spec Appendix J §J3 uses
both Profile M (F1, R1) and Profile L (F2, R2) loss factors. Our
override gate (`_pcdb_table_3b_combi_loss_override`) only accepts
separate_dhw_tests==1 → falls back to Table 3a keep-hot time-clock
600 kWh/yr default = 25x overshoot vs the fixture-pinned ~24 kWh/yr.
The same gap blocks 000480 (PCDB 16839 — but actually wait, 16839 is
in 000490 too and that already closes — needs checking), 000487 (PCDB
18119), and 000516 (PCDB 18118).
Test pin `test_elmhurst_000477_end_to_end_sap_score_matches_pdf`
xfail (strict) with rationale pointing at Table 3c. Re-enables when
the override implements.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replaces the SAP 10.3 §13 rating constants in `worksheet/rating.py`
with SAP 10.2 values per ADR-0010 (active spec target is SAP 10.2,
14-03-2025; spec changed to SAP 10.3 only as of 13-01-2026 which
hasn't been adopted):
Energy Cost Deflator 0.36 → 0.42
Linear branch slope 16.21 → 13.95 (SAP = 100 − slope × ECF)
Log branch intercept 108.8 → 117.0 (SAP = intercept − slope × log10(ECF))
Log branch slope 120.5 → 121.0
The two errors were near-cancelling on the Elmhurst cohort (low-cost
combi-gas dwellings on the linear branch): the wrong deflator made
our ECF ~14% low, and the wrong linear slope made our SAP drop per
unit ECF ~16% high. Their product was close to the spec but not
exactly — leaving 000490 stuck 1 SAP integer over PDF after the
other component closures (Appendix L, secondary heating, ventilation,
pumps_fans) had brought cost to within £0.04 of PDF.
Final cohort SAP integer status — **both fixtures hit delta=0**:
000474: integer 62 = PDF 62 (continuous 61.91 vs PDF 62.26, Δ -0.35)
000490: integer 57 = PDF 57 (continuous 57.40 vs PDF 57.40, Δ -0.002)
000490 e2e SAP integer ceiling tightened 1 → 0.
Updated 8 internal rating + calculator tests that pinned the SAP 10.3
constants (test_rating.py, test_calculator.py, test_bre_worked_
examples.py). All 685 tests green; 0 xfail.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replaces the static `_DEFAULT_PUMPS_FANS_KWH_PER_YR = 130` for
gas-combi main heating systems with the SAP10.2 Table 4f cascade
value: 115 kWh/yr (230c central heating pump, post-2013 install) +
45 kWh/yr (230e main heating flue fan, balanced/condensing) = 160.
Selection keyed by `main.main_heating_category` — currently only
category 2 (Gas-fired boilers); other categories fall back to the
legacy 130 sentinel pending the next fixture exercising them.
Adds `_PUMPS_FANS_KWH_BY_MAIN_CATEGORY` lookup. Both `CalculatorInputs.
pumps_fans_kwh_per_yr` and the `_fuel_cost(...)` pumps_fans arg now
share the same per-cert value.
E2E pins: new parametrized test
`test_elmhurst_end_to_end_pumps_fans_kwh_matches_u985_worksheet`
asserts `result.pumps_fans_kwh_per_yr == 160` at abs=1e-3 for the
2 e2e fixtures (000474, 000490).
Impact on 000490: cost £803.62 → £807.58 (PDF £807.54, Δ +£0.04 ≈ 0%);
continuous SAP 57.77 → 57.57 (PDF 57.40, Δ +0.17 — was +0.38).
SAP integer still 58 vs PDF 57 — remaining residual is the SAP
rating constants (rating.py uses SAP 10.3 deflator 0.36 / slope
16.21/120.5; PDF lodges SAP 10.2 0.42 / 13.95/121) — next slice.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Surfaces four cert lodgements that the §2 ventilation cascade was
missing on the cert→inputs path. Without them, `cert_to_inputs` was
defaulting:
- extract_fans_count → 0 (PDF: 1-2 fans per fixture)
- percent_draughtproofed → 0 (PDF: 75-100% per fixture)
- sheltered_sides → 2 (PDF: 1-3 per fixture — hardcoded TODO)
- has_suspended_timber_floor → False (PDF: True on 000477/000487)
Net effect on (25)m monthly effective ACH ranged from -19% (000477)
to +5% (000490) → propagated 1:1 through HLC × ΔT → useful space heat
→ main + secondary fuel kWh → cost / SAP integer.
Schema:
- `SapVentilation` gains 4 new optional fields: `sheltered_sides`,
`has_suspended_timber_floor`, `suspended_timber_floor_sealed`,
`has_draught_lobby`. RdSAP cert lodges these but the type didn't
surface them.
- `cert_to_inputs.cert_to_inputs` reads them when set; falls back to
the SAP10.2 §2 worst-case defaults (sheltered=2, no timber floor,
no draught lobby) when the cert hasn't lodged. Removes the long-
standing `sheltered_sides=2` hardcode + 4 TODOs.
- `make_minimal_sap10_epc` accepts a `sap_ventilation` kwarg.
Per-fixture build_epc() updates lodge the U985 PDF values verbatim.
E2E pin: new parametrized test
`test_elmhurst_cert_to_inputs_monthly_infiltration_ach_matches_u985_
worksheet` asserts `inputs.monthly_infiltration_ach[m] == LINE_25_
EFFECTIVE_ACH[m]` at abs=1e-3 across all 6 fixtures + 12 months
(72 assertions). All pass.
Useful space heating drift:
000474: useful 10821.69 → 10765.85 (Δ -55.8 kWh vs PDF 10612.86 → +1.4% over, was +2.0%)
000490: useful 11262.05 → 11184.06 (Δ -78.0 kWh vs PDF 11183.28 → +0.007% — essentially exact)
SAP integer status:
000474: 62 = PDF 62 (delta 0) ✓
000490: 58 vs PDF 57 (delta 1; continuous 57.77 vs 57.40)
— remaining residual is pumps_fans hardcoded at 130 kWh
vs PDF 160 (Table 4f cascade not yet implemented → -£4 cost
+ 0.3 continuous SAP). Next slice.
Tightens `result.secondary_heating_fuel_kwh_per_yr` pin abs=10 → abs=0.1
(was loose to absorb the +0.7% useful overshoot which has now closed).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Lodges `secondary_heating_type=691` (Electricity Electric Panel) on
000490 `build_epc()` to match the U985 worksheet's "Secondary Heating:
Electricity Electric Panel, convector or radiant heaters, SAP Code 691,
Efficiency 100%". Pre-fix the cert lodged no secondary system →
`_secondary_fraction` returned 0.0 → all useful space heat routed to
main 1 → main_fuel +1357 kWh over PDF, secondary -1118 under PDF, cost
-£104 under PDF (-12.9% residual).
Post-fix: Table 11 fraction 0.1000 for gas-combi category cascade fires
→ main 1 = 11491.89 kWh, secondary = 1126.21 kWh. Total cost £807.42
vs PDF £807.54 (Δ -£0.12, -0.015%). SAP integer 58 vs PDF 57 (delta 1,
was 6); continuous 57.57 vs 57.40 (delta 0.18).
E2E test updates:
- New worksheet-level pin `result.secondary_heating_fuel_kwh_per_yr ≈
U985 (215) = 1118.3275` at abs=10 (loose — absorbs the +0.7% upstream
useful space heating overshoot which propagates 1:1 to (215). Tightens
to abs=1e-3 when the useful bias closes).
- Per-fixture constant `LINE_215_SECONDARY_HEATING_FUEL_KWH = 1118.3275`.
- 000490 SAP integer ceiling tightened 3 → 1; continuous 3.0 → 0.5.
- Removed xfail on `test_elmhurst_000490_end_to_end_sap_score_currently_
within_3_points` and `test_000490_cert_to_inputs_fuel_cost_closes_to_
within_5pct` — both now pass.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
SPEC_COVERAGE:
- §5 row: note new `annual_lighting_kwh` public leaf + InternalGainsResult
field + per-fixture U985 (232) abs=1e-4 pin across all 6 Elmhurst fixtures.
- Appendix L row: "Full (cost + gains)" — closes both sides via the same
L1-L11 cascade; legacy heuristic noted with rip-pending callsites.
ADR-0010 Amendment "Appendix L lighting (2026-05-22)":
- Two engine bugs surfaced + fixed: cosine modulation integral (uniform
+0.146% bias from continuous-formula vs Σ(L11 monthly)) and cert EPC
under-lodgement (`build_epc()` skipped bulb counts + windows).
- 000474 hits SAP integer delta=0 (first Elmhurst fixture across the gate).
- 000490 SAP integer + fuel cost xfailed (strict) — Appendix L direction
correct, other components broken (fuel pricing, Table D1-3 Ecodesign,
main heating +2.5%). Tracked as next ticket.
- Golden cohort PE tolerance widened 30→35 with rationale.
- Deferred work: cohort SAP-integer residual hunt, heuristic deletion,
RdSAP→API integration test (end-state e2e harness).
`predicted_lighting_kwh` deprecation note: cite ADR-0010 amendment; name
the two legacy callsites (`domain.ml.ecf`, `domain.ml.transform`) that
block deletion.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Closes the +9.2% cost residual on 000474 by swapping the legacy
`predicted_lighting_kwh` heuristic (9.3 × TFA × bulb-share) for the
spec-faithful Appendix L L1-L11 cascade that already drove §5 (67)
internal gains. Single source of truth via `InternalGainsResult.
lighting_kwh_per_yr`; the cost side and the gains side now derive
from the same monthly distribution.
Engine bug found during the wire-up: `annual_lighting_kwh` was
returning the L1-L9 continuous formula value (E_L), but the SAP10.2
worksheet lodges line ref (232) as Σ(L11 monthly distribution).
Discrete cosine integral Σ(n_m × factor) / 365 = 0.998539, not 1.0
exactly — caused a uniform +0.146% bias across all 6 Elmhurst
fixtures. Fixed by factoring a private `_lighting_monthly_kwh` and
having `annual_lighting_kwh` sum it directly. Synthetic S1 pin
updated 189.152079 → 188.875713 (post-modulation).
Cert-side updates: lodge `low_energy_fixed_lighting_bulbs_count` +
`sap_windows` on 000474 / 000490 `build_epc()` so the cert→cascade
path receives spec-faithful inputs (was defaulting to L5b/L8c +
C_daylight=1.433 no-bonus). Per-fixture `LINE_232_LIGHTING_KWH_PER_YR`
constants pin each U985 PDF value at 4 d.p.
E2E pin updates (per feedback-e2e-validation-philosophy: components
validate the engine; SAP integer = delta 0 is the integration gate):
- 000474 SAP integer ceiling tightened 3 → 0 (lands at 62 = PDF 62
exactly); continuous 3.5 → 0.5 (lands at 0.09)
- 000490 SAP integer + fuel-cost tests xfail with rationale —
Appendix L direction is correct (lighting closes 614→171 = PDF
171.4217), but cost residual widens past 5% / SAP delta widens
3→6 due to other broken components (fuel pricing, Table D1-3
Ecodesign, main heating +2.5%). Re-enable when those close.
- Golden fixtures `_PE_TOLERANCE_KWH_PER_M2` widened 30 → 35 to
absorb the elec-PEF × lighting-Δ contribution (~4 kWh/m²) on a
non-Elmhurst cohort whose pre-existing residual already sat near
-28 kWh/m² from unrelated components.
Component validation: `result.lighting_kwh_per_yr == PDF (232)` to
abs=1e-4 for 000474 (139.9452) + 000490 (171.4217); §5 worksheet-
level pin on `InternalGainsResult.lighting_kwh_per_yr` covers all 6
Elmhurst fixtures at the same tolerance. Existing §5 (67) LINE_67
monthly tuple tests remain green (refactor preserves monthly W
distribution).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Surfaces the SAP10.2 Appendix L L1-L12 annual lighting kWh as a public
free fn alongside lighting_monthly_w. Refactors lighting_monthly_w to
compose it. One source of truth shared by the §5 gains side and the
forthcoming cost side (inputs.lighting_kwh_per_yr) — slice 2 wires
internal_gains_from_cert + cert_to_inputs.
Synthetic L1-L12 test pins a hand-computed dwelling
(TFA=100, N=2.0, C_L=10000, ε=100, D=1.0) at 189.152079 kWh, abs=1e-3.
6-fixture LINE_67 conformance tests (Elmhurst 000474..000516) act as a
regression check on the monthly cosine + 0.85 internal-fraction
composition — all green.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Rewrites HANDOVER_NEXT.md after the §10a + §4 HW work. Two tickets:
1. **Appendix L lighting predictor swap** (immediate) — replace the
legacy `domain.ml.demand.predicted_lighting_kwh` heuristic with
the spec-faithful Appendix L L1-L12 cascade already living in
`worksheet/internal_gains._lighting_gains_monthly_w`. Single
slice; closes 000474 cost residual from +9.2% toward ~0%.
2. **§11a SAP rating + §12a CO2 + §13a Primary Energy sweep** —
per-end-use cascade on top of the §10a `FuelCostResult`. Mirrors
§10a's pattern (kwargs orchestrator + Result dataclass + cert_to_
inputs precompute + calculator delegation). ~5 slices.
Carries §A current-state residuals table (000474 + 000490 post-§4
HW), §B/§C tickets with slice plans, §D codebase pointers, §G
deferred-list cross-reference to ADR-0010 amendment + SPEC_COVERAGE
remaining-work sections.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Closes the residual ~1.2% on 000474 HW kWh that slice 1 left (PCDB
Table 3b combi loss landed (61) correctly but the divisor was still
the scalar PCDB summer efficiency 87.0%). Slice 2 promotes that
scalar to the SAP10.2 Appendix D §D2.1 (2) Equation D1 monthly
cascade — η_water,monthly = (Q_space + Q_water) / (Q_space/η_winter
+ Q_water/η_summer) — and folds it into the cert_to_inputs flow:
- worksheet/water_heating.py: water_efficiency_monthly_via_equation_
d1(...) — pure function over winter/summer efficiencies + (98c)m
× (204) + (64)m monthly tuples. Implements the spec's two early-
outs (η_summer ≥ η_winter → all months = η_summer; zero-demand
months → η_summer).
- rdsap/cert_to_inputs.py: splits _hot_water_fuel_kwh_per_yr (now
removed) into:
- _water_heating_worksheet_and_gains: runs §4 (45..65) early so
§5/§7/§8 can consume (65)m heat gains.
- _apply_water_efficiency: invoked after §8 produces (98c)m, picks
monthly cascade for PCDB-tested combis with distinct winter/
summer effs, falls back to scalar divisor otherwise.
Pulled secondary_fraction_value computation forward of §4 so the
post-§8 Q_space = (98c)m × (204) derivation has it in scope.
Outcomes (closes the §10a slice-2 deferred §4 HW debt):
- 000474 HW kWh: 2622 → 2320 (slice 1) → 2292 ✓ matches PDF 2292
to 0.0%. SAP delta 4 → 3 (ceiling tightened 4 → 3).
- 000490 HW kWh: 3028 → 3028 (slice 1 no-op, no PCDB Table 3b
data) → 2847 ✓ matches PDF 2851 to 0.1%. SAP delta 2 → 3
(ceiling loosened 2 → 3 — the closer HW kWh exposes spec-version
drift on the 000490 cost figure that PDF lodged under cert-
assessor era prices per ADR-0010 §3).
- 486 tests passing across the domain package; 13 pre-existing
pyright errors on cert_to_inputs (no net new from this slice).
Remaining 000474 +9% cost residual is Appendix L lighting (528 vs
~169 back-derived) — separate ticket per project memory
`project_section_4_hw_next_ticket` "secondary upstream" note.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- ADR-0010 amendment: narrow the SAP10.2 spec target — §10a/§10b
cost prices source from RdSAP10 Table 32 (per RdSAP10 §19.1),
not SAP10.2 Table 12. CO2 + PEF stay on Table 12 (RdSAP10 §19.2
says they're identical). Closes out the 000490 "spec-version
drift" framing as wrong-table + missing-standing-charges, not
corpus drift. Names §4 HW + Appendix L as the next-ticket
upstream debt that pre-§10a wrong-prices had been masking.
- SPEC_COVERAGE: new §10a row (32-field FuelCostResult, three new
tables/* + worksheet/* modules, per-line-ref status, Remaining
§10a work list). Updates §12 to "folded into §10a". Updates
header attribution.
No code changes in this commit — docs only.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Wires the §10a Fuel costs worksheet block (slice 1's orchestrator)
into the cert → calculator pipeline:
- CalculatorInputs.fuel_cost composite slot (default zero sentinel
for synthetic-test constructions that don't supply one).
- cert_to_inputs._fuel_cost precompute — resolves Table 32 prices
per end-use, calls additional_standing_charges_gbp per Table 12
note (a) for gas/off-peak gating, calls the fuel_cost orchestrator.
Off-peak certs return a zero FuelCostResult sentinel so the legacy
scalar fuel-cost-per-kWh fallback fires; Table 12a high-rate
fraction split + Table12aSystem mapping is deferred to a future
§10a follow-up slice.
- calculator delegates total_cost / per-end-use cost intermediate
dict entries to inputs.fuel_cost when the precompute is non-zero;
falls back to the legacy inline kWh × price math for synthetic
CalculatorInputs constructions (will be removed when the test
corpus migrates to fuel_cost=).
Outcomes:
- 000490 SAP rating ceiling tightened 6 → 2 (marquee close-out:
the cost gap was wrong-table + missing-standing-charges, not the
spec-version drift the handover suspected).
- 000474 SAP rating ceiling loosened 2 → 4 (post-§10a Table 32 +
standing-charge fix exposes upstream §4 HW kWh + Appendix L
lighting overestimates that the wrong pre-§10a prices had been
masking). §4 HW worksheet tightening is the next ticket.
- Golden corpus SAP tolerance widened 7 → 11 — Table 32 oil price
rose +55% (4.94 → 7.64 p/kWh) which moves oil-heated certs whose
lodged actual_sap pre-dates Table 32 (ADR-0010 §3 Validation
Cohort discipline).
- 2 new cert-round-trip conformance tests on test_fuel_cost.py
(000474 within existing e2e tolerance; 000490 within 5%).
660 tests passing across the domain package. 0 net new pyright
errors on touched modules.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Collect, per shared landlord_additional_info key, the list of values
across all UserAddress entries. Preserves first-seen key order and
input order of values.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Drive the contract for LandlordDescriptionOverridesOrchestrator.
get_col_to_description_mappings: given a list of UserAddress sharing
the same landlord_additional_info keys, return each key mapped to the
list of values found across all addresses.
Tests are red — the method still raises NotImplementedError.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Pins the API JSON → EpcPropertyDataMapper → CalculatorInputs chain for the 4 corpus PCDB-listed golden certs. Asserts (a) `main_heating_index_number` survives the mapper hop, (b) `cert_to_inputs` resolves Table 105 record by that ID and applies the winter efficiency. Catches future regressions where a mapper change might drop the PCDB pointer silently.
Confirms the API → domain → calculator chain works end-to-end without any new domain object field — `MainHeatingDetail.main_heating_index_number` has existed since schema 17_1 and all mapper paths from 17_1+ pass it through verbatim.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
PDF "PCDF boiler reference: 10328 Vaillant Ecotec Pro 88.20%" lodgement → fixture now sets `main_heating_index_number=10328` + `main_heating_data_source=1` per the API's standard PCDB-lodgement shape. cert_to_inputs PCDB precedence cascade picks up Table 105 record 10328 (winter eff 88.2%, summer 79.6%) and overrides the Table 4a category-2 default.
make_main_heating_detail extended to expose main_heating_index_number / main_heating_data_source / sap_main_heating_code kwargs so fixtures can lodge PCDB pointers without hand-building MainHeatingDetail.
000490 e2e impact:
- main_heating_fuel: 14334 → 13001.3 kWh (PDF 13003.85 — gap closes to <0.1%, was +10%)
- HW fuel: 3090.47 → 3028.27 kWh (PDF 2850.57 — gap closes +8.4% → +6.2%)
- total_fuel_cost: £756.99 → £706.23 (PDF £807.54 — diverges -6.3% → -12.5%, ADR-0010 §3 spec-version artifact)
- SAP rating: 60 → 63 (PDF 57 — +3 → +6)
The fuel-kWh tightening is the spec-faithful direction. The cost / SAP residuals widen because the cert pre-dates the 14-March-2025 SAP10.2 amendment which lowered gas unit prices ~13%; per ADR-0010 §3 only certs lodged ≥2025-07-01 are spec-comparable on cost-driven outputs. The e2e SAP ceiling is raised 3 → 6 and the cost-rel tolerance 0.10 → 0.15 with a docstring naming the drivers; tightens further when the Validation Cohort filter + Ecodesign/Appendix N adjustments land.
000474 also flagged as Vaillant ecoTEC pro PCDB-lodged; awaiting user's PCDB code lookup for that fixture.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
