feat(h4-5): calibración parcial CP-01c + ADR-0020 (CP-01c)

[Jacket-69]

Resumen

Quinta y última fase técnica de H4: ejecuta las tareas H4-cal-1 y H4-cal-2 del ADR-0013. El criterio CP-01c (duration ±15 % en ≥ 85/100) no se alcanza con solo estas dos mejoras — se cierra empíricamente que snap-to-edge (H5) es necesario. Resultado documentado en ADR-0020.

Cambios

Producción (calibración integrada, opt-in):

• adapters/grafo_osmnx.py: parámetro factor_calibracion: float = 1.0 agregado a cargar_grafo_iv_region. Aplica multiplicador al speed_kph in-memory tras la carga. Default 1.0 = sin cambio (preserva paridad RT-02). Helper _aplicar_factor_calibracion(grafo, factor).

Experimental (NO usado en orquestador):

• domain/routing/a_estrella_calibrado.py: A* con state extendido (nodo, nodo_previo) y turn_penalty_s=2.0 por giro >30°. Helpers _bearing_grados y _delta_bearing. No reemplaza al A* operativo — vive aislado para no romper paridad bit-exacta con Java.

Tests:

• 10 UT del A* calibrado (bearing/delta + 6 tests algoritmo).
• 5 UT del factor_calibracion (escala, identidad, fallback, ValueError).
• 1 IT nuevo test_cp01c_calibracion_y_turn_penalty marcado @pytest.mark.xfail(strict=True).

Resultado experimental (corrida 2026-05-21)

Métrica	Valor
dentro ±15 %	27/100 (mínimo CP-01c: 85/100)
mediana	0.250
p75	0.367
±20 %	37/100
±30 %	65/100

Veredicto: CP-01c NO alcanzado. Mejora real vs A* original (mediana cae de ~0.38 a 0.25), pero el 68 % de la dispersión sigue atribuida a snap-to-node — predicho por ADR-0011 §Diagnóstico.

Decisión documental

ADR	Status	Razón
ADR-0013	proposed (sigue)	Criterio numérico no alcanzado; promoverá a accepted cuando H5-cal-3 entregue snap-to-edge.
ADR-0020 (nuevo)	accepted	Congela el parcial, eleva H5-cal-3 de "stretch" a "bloqueante".
Test integration	xfail strict=True con razón apuntando a ADR-0020	Recordatorio público de la deuda.

Validación local

• ruff check + ruff format --check: ✓ (73 archivos).
• mypy src/sentinel_dispatch: ✓ (39 archivos).
• pytest tests/unit tests/integration --no-cov -m 'not slow': 265 passed + 3 deselected.
• Suite incluye 1 xfail intencional (test_cp01c_calibracion_y_turn_penalty).
• Cobertura global: 90.33 %.

DoD

• Tareas H4-cal-1 y H4-cal-2 ejecutadas y persistidas en código.
• ADR-0013 actualizado con sección "Resultado de ejecución".
• ADR-0020 nuevo accepted con plan H5-cal-3 detallado.
• Test xfail strict con razón concreta.
• Trazabilidad CP-01c → 🟡 H5 con referencias a ambos ADRs.
• CHANGELOG entry bajo [Unreleased].
• CI compare debe seguir 12/12 OK bit-exacto (calibración opt-in; A* calibrado aislado del operativo).

Commits

1. fa76357 feat(h4-5): calibración parcial CP-01c + ADR-0020
2. 273ad2f docs(quality): CP-01c 🟡 H5 + CHANGELOG

Próximo paso

H4 fase 6 (Fase 8 del plan global): FTR-03 formal de cierre H4. Suite estable, cobertura ≥ 90 %, RFs 06/11/12 cerrados, CP-12 y CP-01c documentados con sus respectivos ADRs.