Model/docs/sap-spec
Khalim Conn-Kowlessar 61e369faf7 HANDOVER_NEXT: rewrite for strict zero-error cascade pin closure
Replaces the previous handover. The previous one framed the work as
"close three tickets to integer Δ=0" — a weak gate. The user has
since made clear the real requirement is **abs=1e-4 on every line ref
of every output for every fixture**, and that previous agents have
repeatedly made the following mistakes:

1. Treated SAP integer Δ=0 as "closed" (it hides ±0.5 continuous
   drift).
2. Widened tolerances (rel=0.15 / rel=0.05 / <=0.5) to make tests
   green — masking real residuals.
3. Tested sections in isolation using PDF values as INPUTS — that
   verifies the section formula but not the cascade.
4. Diagnosed downstream first when upstream sections still drift.
5. Missed fixture-lodgement defects (bulbs / windows / sap_heating /
   detailed RR / exposed_floor / door_count / per-window u_value) —
   the cascade pin failure was the fixture, not the calculator.
6. Labelled code "SAP 10.3" when implementing 10.2.

The new handover front-loads these anti-patterns (§A.3), then states
the current cascade-pin scoreboard, the work queue in priority order
(rooflight, 000487 RR + U=0.86 gable, then §5/§6/§7/§8/§9a/§10a/§11a/
§12 pins in worksheet order), the diagnostic loop, and the spec page
anchors the user has already given.

Three new memories were also written:
- feedback-zero-error-strict (abs=1e-4, no widening)
- feedback-cascade-pin-methodology (test the cascade, not isolation)
- feedback-fixture-defects-common (audit fixture first)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-23 07:35:25 +00:00
..
CALCULATOR_DESIGN_SKETCH.md ADR-0009: pivot to deterministic SAP 10.3 calculator (Accepted) 2026-05-17 21:27:21 +00:00
HANDOVER_NEXT.md HANDOVER_NEXT: rewrite for strict zero-error cascade pin closure 2026-05-23 07:35:25 +00:00
HANDOVER_SECTION_6.md docs: handover for §6 Solar gains agent 2026-05-20 19:29:30 +00:00
PARITY_FINDINGS.md Record post-P5 parity-probe baseline (2026-05-19) 2026-05-19 16:19:01 +00:00
pcdb10.dat pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_105_gas_oil_boilers.jsonl §4 HW slice 1: PCDB Table 3b combi-loss override 2026-05-21 22:26:41 +00:00
pcdb_table_122_solid_fuel_boilers.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_143_micro_cogen.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_313_flue_gas_heat_recovery.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_353_waste_water_heat_recovery.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_362_heat_pumps.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_391_high_heat_retention_storage_heaters.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
pcdb_table_506_heat_interface_units.jsonl pcdb slice 1: pcdb10.dat ETL → 8 per-table NDJSON files + parser + 8 tests 2026-05-21 09:43:41 +00:00
rdsap-10-specification-2025-06-10.pdf ADR-0009: pivot to deterministic SAP 10.3 calculator (Accepted) 2026-05-17 21:27:21 +00:00
sap-10-2-full-specification-2025-03-14.pdf slice S-B9: SAP 10.2/10.3 Table 12 spec-correct prices + Table 12a fix 2026-05-18 15:14:11 +00:00
sap-10-3-full-specification-2026-01-13.pdf ADR-0009: pivot to deterministic SAP 10.3 calculator (Accepted) 2026-05-17 21:27:21 +00:00
SPEC_COVERAGE.md docs: handover for Table 3c two-profile combi loss → close 4 Elmhurst fixtures 2026-05-22 12:14:00 +00:00