Releases: CooperBigFoot/hfx
hfx 0.3.0
HFX 0.3.0 — first curated release of the open HydroFabric Exchange format toolkit
HFX is the open HydroFabric Exchange format: a compiled, source-agnostic
on-disk contract for hydrographic fabrics (catchments, flow topology, and
optional D8 rasters) that any river-network dataset can be normalized into.
This release ships the toolkit that defines and enforces that contract — the
hfx-core and hfx-validator crates and the hfx CLI. shed is the
reference engine that consumes HFX datasets.
This toolkit release implements HFX spec 0.2.1 (frozen wire shape).
Curated releases begin here
0.3.0 is the first release under the curated-release policy described in
docs/VERSIONING.md.
It supersedes the per-commit-bump era, during which the workspace reached
version 0.2.64 across 87 v* tags. The crates.io snapshots from that era —
hfx-core 0.2.0 and hfx-validator 0.1.26 — are stale and target the legacy
0.1-era format; they should not be used against current datasets.
Highlights
Everything since the published crates.io snapshots:
- HFX spec 0.2.1 with RFC 2119 normative hardening, a Version
Compatibility section, and a dedicated spec changelog. - Manifest JSON schema and a conformance suite of valid/invalid fixtures
exercising it. hfxvalidator CLI, installed by thehfx-validatorcrate.grit-v2andmerit-v2reference adapters for compiling GRIT and
MERIT-Basins fabrics into HFX.examples/tinyreference dataset for quick-start and testing.- GitHub Actions CI plus issue and pull-request templates.
- Governance docs: the two-track version policy (VERSIONING.md),
CODE_OF_CONDUCT, and GOVERNANCE.
Lockstep versioning
hfx-core and hfx-validator both release as 0.3.0 and move in
lockstep: the validator pins hfx-core with an exact =0.3.0 dependency.
Links
- Version policy: https://github.com/CooperBigFoot/hfx/blob/main/docs/VERSIONING.md
- hfx-core on crates.io: https://crates.io/crates/hfx-core
- hfx-validator on crates.io: https://crates.io/crates/hfx-validator