Model/backend/documents_parser
Khalim Conn-Kowlessar 49622f5525 Slice S0380.84: RR mapper spec-correct routing + cascade common_wall handling per RdSAP 10 §3.9.2/§3.10
Cascades the spec-correct §3.10 Room-in-Roof routing through the
mapper + heat-transmission section. Three coupled changes:

1. **Mapper drops "Connected" gables** — per RdSAP 10 Table 4 (PDF p.22)
   row 4 a gable wall "Connected to heated space" is an internal
   partition, NOT a heat-loss surface. The Elmhurst Summary §8.1 PDF
   may lodge the short form "Connected" or the verbose "Connected to
   heated space"; both route to `return None` in
   `_map_elmhurst_rir_surface`.

2. **Mapper routes "Exposed" gables → `gable_wall_external` with the
   lodged U** — per Table 4 row 1 an exposed RR gable wall bills at the
   lodged U-value (or the storey-below main-wall U). For non-flat
   dwellings the `default_u_value` rides through as `u_value` override
   so the cascade uses the lodged figure directly. Flats preserve their
   legacy no-override routing so the cascade falls through to main-wall
   U (cert 9501).

3. **Mapper surfaces Common Wall surfaces + applies spec area formula**
   per RdSAP 10 §3.9.2 + Table 4:

       Detailed assessment           → raw L × H per surface
       Simplified + Common Walls     → L × (0.25 + H) for common walls;
                                        L × (0.25 + H_gable)
                                          − Σ_n (H_gable − H_common,n)² / 2
                                        for gables
       Simplified + no Common Walls  → raw L × H for gables

   The 0.25-m structural-gap offset accounts for the space between the
   RR floor and the storey-below ceiling. The gable correction
   subtracts the triangular slice above each common wall.

4. **Cascade adds `common_wall` kind** in `heat_transmission.py` — mirror
   of `gable_wall_external`: walls += area × (`surf.u_value` or main-wall
   U). Mapper precomputes the spec area so the cascade reads `area_m2`
   directly.

Verified against the cert 000565 U985 worksheet PDF "External Walls"
section per BP:

  | BP | Surface             | Formula                                   | Worksheet | Cascade |
  |----|---------------------|-------------------------------------------|-----------|---------|
  | 0  | Main GW1 (Exposed)  | 4 × 2.45 (Simplified, no CW)              | 9.80      | 9.80 ✓ |
  | 0  | Main GW2 (Sheltered)| 6 × 2.45                                  | 14.70     | 14.70 ✓|
  | 1  | Ext1 CW1            | 9 × (0.25 + 1.0)        (Simplified + CW) | 11.25     | 11.25 ✓|
  | 1  | Ext1 CW2            | 5 × (0.25 + 1.8)                          | 10.25     | 10.25 ✓|
  | 1  | Ext1 GW2 (Exposed)  | 8 × (0.25 + 9) − ((9−1)²+(9−1.8)²)/2      | 16.08     | 16.08 ✓|
  | 2  | Ext2 GW2 (Exposed)  | 3 × 8                  (Detailed)         | 24.00     | 24.00 ✓|
  | 3  | Ext3 CW1            | 5 × (0.25 + 1.5)        (Simplified + CW) | 8.75      | 8.75 ✓ |
  | 3  | Ext3 CW2            | 7.5 × (0.25 + 0.3)                        | 4.13      | 4.13 ✓ |
  | 3  | Ext3 GW1 (Exposed)  | 9 × (0.25+7) − ((7−1.5)²+(7−0.3)²)/2      | 27.68     | 27.68 ✓|
  | 4  | Ext4 CW1            | 4 × 1                  (Detailed)         | 4.00      | 4.00 ✓ |
  | 4  | Ext4 CW2            | 3.5 × 0.6                                 | 2.10      | 2.10 ✓ |

Cohort impact:
  - Cert 9501 (top-floor flat with Detailed RR + Exposed gables) —
    PASSES (the flat-RR elif still routes; gables stay at main-wall U
    via cascade fall-through).
  - All other cohort fixtures: unaffected (no RR or fully-Detailed RR
    where raw L × H is also the spec answer).

Cert 000565 cascade subtotals close substantially:
  walls       322.21 → 443.51  (worksheet 604.07, Δ −282 → Δ −161, 43% closed)
  party walls 153.46 →  93.26  (worksheet  65.13, Δ  +88 → Δ  +28, 68% closed)
  HTC fabric  716.43 → 795.24  (Δ +79 W/K — cascade closer to worksheet)

The remaining 161 W/K under-count in walls + 28 W/K over-count in
party walls localise to the BP main-wall cascade (NOT RR). The cert
000565 sap_score e2e pin regresses from EXACT (29) to Δ−3 (26) because
the previous compensating cascade gaps are now exposed — the
spec-correct fix is real, the residual is real, and the next slice
closes the BP main-wall gap (likely the "External walls Main alt.1"
basement-override at 23 m² × U=2.34 = 53.82 W/K + per-BP main-wall
U/area refinements). Per [[feedback-spec-citation-in-commits]] +
[[feedback-spec-floor-skepticism]] the spec-correct fix ships even
when the test pin temporarily regresses; the diagnostic signal is
sharper now.

Test baseline: 555 pass + 9 expected `test_sap_result_pin[000565-*]`
fails (was 555 + 8; sap_score now in the failing set with cascade-
exposed BP main-wall gap surfaced). Cohort + golden fixtures
unaffected. Pyright net-zero on touched files (59 errors, matches
baseline).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-29 23:16:34 +00:00
..
handler address JTK review comments 2026-04-20 15:11:17 +00:00
tests Slice S0380.84: RR mapper spec-correct routing + cascade common_wall handling per RdSAP 10 §3.9.2/§3.10 2026-05-29 23:16:34 +00:00
__init__.py Map to RdSapSiteNotes from site notes JSON 🟥 2026-04-16 13:54:03 +00:00
db_writer.py include updating epc_property_data to pashub to ara workflow 2026-04-29 09:55:14 +00:00
elmhurst_extractor.py Slice S0380.83: Extractor + mapper recognise Exposed / Connected gable_type per RdSAP 10 §3.10 2026-05-29 23:00:31 +00:00
extractor.py Handle wall thickness "Unmeasurable" 🟩 2026-04-30 16:41:16 +00:00
local_runner.py update local runner to work for elmhurst 2026-04-24 14:01:36 +00:00
parser.py load ecmk site notes to db 2026-04-29 11:20:47 +00:00
pdf.py update local runner to work for elmhurst 2026-04-24 14:01:36 +00:00