WEPPcloud

← Back to help

ADR-0134: Preserve specialized revegetation reference semantics

Date: 2026-11-03

Status: accepted; implemented and validated in local undeployed revision 7.

Decision provenance

  • Decision venue: this Codex task, 2026-11-03 UTC (2026-11-02 America/Los_Angeles).
  • Participants present: operator Roger Lew and Codex.
  • Decision owner: Roger Lew; specialized scientific semantics belong to Anurag Srivastava. No claim that Anurag attended or reviewed this implementation.
  • Implementer: Codex, with independent review gates.
  • Explicit direction: “preserve reference. that is anurag's domain”.

Decision and exact delta

Adopt the bound reference's 9005 hydraulic and RAP vegetation behavior only in the specialized lanes of undeployed 261029. The specialized consumer contract contains the field/mode matrix, equations, constants, units, activation and compatibility exceptions. Source authority is model 2e5928702 from the separate revegetation repository, not a similarly named generic release. Preserve existing ordinary modes and revision-6 PMET/FC/HK corrections.

Before: selected 261029 misbinds the seven-field header, reads a restrictive record twice and lacks specialized cover consumers. After: correct field/record binding plus the reference's distinct cover-dependent conductivity, layer feedback, canopy/biomass/root/LAI and fire-residue sequence. This is an adopted specialized parameterization, not just parser repair or evidence of field calibration.

Preserve recurring anniversary fire comparisons, differing comparison/assignment cover quantities, crop-wide specialized root-depth mutation and logarithm/clamp ordering. Do not infer scientific corrections. Protocol reconciliation changes calendar validation, band binding, date serialization and stale flags so the intended current scenario reaches that unchanged specialized numerical sequence.

Rationale and alternatives

The operator assigns scientific ownership to Anurag and requests compatibility. Correcting suspected fire/canopy/root rules would change that model without its owner's decision. A 9003 minimum-only extension implements the wrong hydraulics. Copying the whole divergent branch would erase unrelated selected-release repairs. An isolated specialized growth routine and bounded other consumer changes retain reference arithmetic while keeping ordinary consumers intact.

Evidence and risk

Bound source/binary and actual reader evidence and producer discrepancies precede implementation. Discriminating actual-consumer and full-history evidence must follow; no old gate result is reused as a fresh revision-7 result.

Inherited reference behavior can increase canopy, depend on OFE processing order, or fail on log(0). Preserve and disclose those limits; do not claim universal heterogeneous correctness, field validity or full water conservation. Rollback uses retained matched revision-6 binaries/sidecars and prior reports; old passes must never be mixed with new watershed execution. No default switch, deployment, Windows release, installed Rust promotion or existing-project regeneration.

Implementation evidence: MIPA-03 execution. The reference graphics disturbance-age F10.5 overflow is also retained and disclosed; changing its output format is outside this port.