# Postfire Debris Flow

- Current domain specification: [specification.md](specification.md).
- Accepted M1 Kf replacement: [source/runtime contract](docs/kf_source.md).
  Independent contract reviews passed; ancestor checkpoint `9395f4722`.
  Implementation `d5646ca95`; restarted forest UI/RQ acceptance and reviews pass.
- Track delivery and loose ends in [implementation_roadmap.md](implementation_roadmap.md).
  Update the roadmap, specification, and affected detailed contracts together
  as implementation progresses; roadmap proposals are not accepted contracts.
- Current scientific contract: [M3/shared support](docs/production_m3.md). M3 must
  consume raw soil records without changing SSURGO/STATSGO building behavior.
- Status: M1/M3 scientific backends and production NoDb/UI/RQ are implemented;
  development acceptance is complete in the closed M3 package. The saved report
  is implemented under the [report contract](../../../../docs/ui-docs/contracts/postfire-debris-flow-report-contract.md)
  (ancestor `ac4deb681`); dashboard work remains deferred.
- Run M3 prepares absent source pointers using bounded acquisition; state reads
  remain local. The 2026-09-15 runtime amendment governs attempt-safe promotion.
- Preserve accepted decisions and explicitly label proposals and unresolved inputs.
- Follow `../../AGENTS.md` and the repository contract-first standard before
  adding NoDb, UI, API, or RQ behavior. Contract ancestors for this increment are listed below.
- Implement published equations independently; do not copy or translate GPL
  pfdf code, tests, or documentation into this module.
- Reference PDF storage decisions live in `docs/pdfs/README.md`; gitignore
  publisher PDFs without established redistribution permission.
- Watershed/numerical engine package:
  [watershed/engine ExecPlan](../../../../docs/work-packages/20260908_staley_watershed_engine/prompts/completed/watershed_engine_execplan.md).
  Initial scope is one existing project watershed and outlet (ADR-0055), with
  no nested/channel assessment requirement. Accepted numerical policies are in
  [the engine contract](docs/staley2017_engine.md) and ADR-0056; future
  predictor and runtime integration remain separately scoped.
- Implemented local slope/SBS backend: [docs/slope_sbs.md](docs/slope_sbs.md).
  [WBT package](../../../../docs/work-packages/20260908_staley_slope_sbs/package.md)
  contains validation/reviews for StaleySlopeSbs and both bindings. Raw DEM and
  strict nine-valid-cell edges are recorded in ADR-0058; production M1 preparation and orchestration are implemented below. Unresolved intersection support retains
  bounds and unavailable point T in raw outputs (ADR-0058); ADR-0066 amends new
  production aggregation to implemented common valid support.
- Read [historical slope evidence](docs/historical_slope_evidence.md) before
  parity work: legacy ArcGIS surface slope and modern pfdf directional slope
  differ. Current pfdf is not the scientific oracle for M1 T; preserve the
  distinction between suspected preprocessing regression and proven error.
- Local composition package: [M1 predictors](../../../../docs/work-packages/20260909_staley_m1_predictors/package.md).
  Read [docs/m1_predictors.md](docs/m1_predictors.md) before composition work;
  K policy is accepted in ADR-0059. Local adapter validated with complete authentic
  Wallow T/F/S evidence. No NoDb/UI/RQ publication.
- Local stage-4 rainfall/results package: [rainfall/results](../../../../docs/work-packages/20260909_staley_rainfall_results/package.md).
  Read [docs/rainfall_results.md](docs/rainfall_results.md); result schemas are implemented locally;
  sparse-rank policy R02 is accepted in ADR-0062. No Climate rebuild or UI/RQ wiring.
- Production M1: [package](../../../../docs/work-packages/20260910_staley_m1_production/package.md),
  [workflow contract](docs/production_m1.md) and
  [UI contract](../../../../docs/ui-docs/contracts/postfire-debris-flow-control-contract.md).
  Contract ancestors: `5c0a172ee`, `595816476`; follow contract-first for later behavior changes.
  That initial package supplied the minimal upload/run control. Do not invent
  UI controls or implementation-heavy user messages beyond the accepted design.

- Active CLI ctime-only identity amendment: [shared contract](../../../../docs/schemas/file-dependency-freshness-contract.md#2026-09-17-active-cli-hard-link-amendment), checkpoint `567eacf7d`. Keep active-worker comparison separate from accepted-result freshness; require an uncached coherent hash and preserve all other identity checks.
