ADR-0037: Increase WBT Least-Cost Breach Distance Default
Status: Accepted
Date: 2026-07-30
Context
WEPPpy WBT configurations that define blc_dist currently use 1,000 m.
Least-cost breaching is again the selected default for
disturbed9002_wbt, and bounded searches that cannot resolve every depression
now fail explicitly instead of silently filling unresolved terrain.
Decision
Change blc_dist from 1,000 m to 3,000 m in every configuration that defines
the attribute. Do not add the attribute to configurations that do not already
define it. Existing projects retain their persisted value.
Decision Provenance
Decision Venue: Codex API workspace thread, 2026-07-30 23:20 PDT
Participants Present: requesting WEPPcloud operator; Codex
Decision Owner(s): requesting WEPPcloud operator
Implementer(s): Codex
Change Summary
Old behavior: the 13 defining configurations initialized blc_dist=1000.
New behavior: the same 13 configurations initialize blc_dist=3000.
No conditioning token, formula, unit conversion, or configuration membership changes.
Rationale
A larger bounded search gives least-cost breaching more opportunity to resolve depressions before the existing fail-on-unresolved guard stops delineation. Applying the same literal to every defining configuration keeps the default consistent across WBT workflows.
Alternatives Considered
- Retain 1,000 m - rejected because the operator selected a 3,000 m default.
- Change only
disturbed9002_wbt- rejected because the operator explicitly requested every configuration that defines the attribute. - Add the attribute to other configurations - rejected because that broadens behavior beyond the requested scope.
Consequences
New projects may spend longer searching and may produce different least-cost breach paths than projects initialized with 1,000 m. Existing persisted projects are unchanged. The fail-on-unresolved contract remains active when a 3,000 m search is still insufficient.
Evidence
- Direct inventory of
wepppy/nodb/configs/*.cfg: 13 definitions, all at 1,000 m before this change. docs/adrs/ADR-0035-wbt-least-cost-unresolved-depression-failure.md
Risk and Rollback Notes
Monitor least-cost channel duration, controlled unresolved-depression failures,
and conditioning diagnostics. Rollback restores the same 13 literals to
blc_dist=1000; it does not rewrite existing projects.
Implementation Notes
Validation is limited to direct inventory/readback of the defining config lines. No dedicated literal assertion or full test suite is warranted.