WEPPcloud

← Back to help

ADR-0095: Preserve strict least-cost breach through the terrain helper

Date: 2026-10-16

Status: accepted for implementation, 2026-10-16 UTC.

Decision and rationale

When derive_flow_stack receives breach_least_cost with blc_fill=false, forward blc_fail_on_unresolved=true to the emulator. Previously the helper omitted the flag, selecting the emulator's false default and producing artifacts rejected by the existing diagnostics validator. Other conditioning modes and existing distance/cost/fill defaults remain unchanged.

This restores the existing diagnostics contract, which requires no fallback filling and failure on unresolved depressions. Do not relax diagnostics or silently enable filling to make integration pass. No new configuration setting is necessary.

Alternatives

Skipping the real WBT tests hides a confirmed runtime defect. Permitting unresolved depressions or weakening diagnostics changes the accepted terrain contract. Adding another user-facing flag duplicates the existing strict choice.

Provenance and evidence

Venue: repository operator/Codex conversation, 2026-10-16 UTC. Participants: Roger Lew and Codex. Owner: existing diagnostics contract; implementation correction authorized by the operator's CI failure repair request. Implementer: Codex. Hosted run 38825109720 exposed two failing real WBT tests when selected individually; the broad suite normally skips their opt-in path. Focused correction passes both tests and the helper unit test with real WBT artifacts and unchanged diagnostics validation.

Risk and rollback

Inputs with unresolved depressions now fail at the WBT boundary rather than later diagnostics rejection. No successful fallback artifacts become accepted. Revert the helper forwarding change if parity fails, retaining diagnostics and recording the unsupported helper path; do not suppress the integration tests.