diff --git a/domain/sap10_calculator/docs/HANDOVER_FRESH_API_DEBUG.md b/domain/sap10_calculator/docs/HANDOVER_FRESH_API_DEBUG.md index 9dd46134..2a982f38 100644 --- a/domain/sap10_calculator/docs/HANDOVER_FRESH_API_DEBUG.md +++ b/domain/sap10_calculator/docs/HANDOVER_FRESH_API_DEBUG.md @@ -4,10 +4,26 @@ Point-in-time note. Start from [`AGENT_GUIDE.md`](AGENT_GUIDE.md) for methodolog 1e-4 bar, the per-line debugging loop, the section helpers, and the suite command. - **Branch:** `feature/per-cert-mapper-validation` -- **HEAD:** `f895dd3a` (S0380.217). Confirm with `git rev-parse HEAD`. +- **HEAD:** `6d9ef114` (S0380.218). Confirm with `git rev-parse HEAD`. - **Baseline (AGENT_GUIDE §4 suite):** `tests/domain/sap10_calculator/ backend/documents_parser/tests/` - → green (2388 passed, 1 skipped at HEAD; the golden + worksheet pins all pass). -- **Next slice number:** **S0380.218**. + → green (2392 passed, 1 skipped at HEAD; the golden + worksheet pins all pass). +- **Next slice number:** **S0380.219**. + +> **S0380.218 (DONE) — Part 1 closed for the "with api 3" pair.** The two +> certs the user dropped under `sap worksheets/with api 3/` — +> `0340-2467-9260-2006-6521` (Summary_000922 / dr87 000922) and +> `5500-5070-0822-0201-3663` (Summary_000920 / dr87 000920) — are **clean**. +> Fetched fresh, run through BOTH front-ends, both paths agree to <1e-4 on +> SAP/cost/CO2/PE AND reproduce the worksheet (255)/(272)/(286)/(33)/(37) +> exactly. SAP integer = lodged (resid +0) on both. **No mapper/calculator +> bug surfaced.** Dropped-field audit clean (only `created_at` + +> `_normalize_shower_outlets`-handled shower keys). Locked in as golden +> fixtures: 2 JSONs under `fixtures/golden/` + entries in `_EXPECTATIONS` +> and `_WORKSHEET_PE_CO2` (test_golden_fixtures.py). The Summary path was +> validated manually but is NOT pinned in a committed test (would need the +> Summary PDFs copied into `backend/documents_parser/tests/fixtures/` + a +> textract-preprocessed chain test) — a cheap follow-up if cross-mapper +> parity wants a standing regression guard beyond the API-path golden pin. - **Pre-existing failures (NOT yours, out of scope):** - `domain/sap10_ml/tests/test_rdsap_uvalues.py` — 2 stone-§5.6 thin-wall failures (granite + sandstone band A, 3.7408 vs Table-6 1.7 cap). Run this suite when you touch