HydraCache 0.34.0
HydraCache 0.34.0
0.34.0 is planned as a production-validation and operational-hardening
release after the 0.33.0 production ergonomics work.
Planned Highlights
- Unified production-style example that demonstrates local cache behavior,
database-cache policy usage, invalidation, refresh/stale behavior, and
diagnostics in one coherent flow. - Correctness stress tests around refresh, stale reads, invalidation, and
database-cache policy boundaries. - Observability contract for stable stats, diagnostics, events, and actuator
route expectations. - Feature/dependency matrix for supported crate combinations.
- Practical policy-selection guide for common production cache scenarios.
- Release automation hardening for staged multi-crate publishing.
Changes
- Added
docs/PRODUCTION_EXAMPLE.mdand an executable production-validation
test covering repeated hits, entity invalidation, refresh-ahead,
stale-on-loader-error, and diagnostics. - Added refresh correctness stress tests for background refresh invalidation
races, concurrent stale revalidation single-flight sharing, and bounded
stale-on-loader-error windows. - Added
docs/OBSERVABILITY_CONTRACT.mdand serialization contract tests for
stable stats, diagnostics, overview, and actuator-facing snapshot fields. - Added
docs/FEATURE_MATRIX.mdandscripts/verify-feature-matrix.ps1for
package-level dependency-surface checks. - Added
docs/POLICY_GUIDE.mdand policy-shape tests for entity, catalog,
search, permission, negative-cache, explicit-invalidation, and fragile
upstream scenarios. - Added
scripts/verify-release-readiness.ps1for version/tag/dirty-tree
checks, release gate command summaries, publish order visibility, and optional
local gate execution.
Verification
This release should pass:
cargo fmt --all -- --checkcargo check --workspace --all-targets --lockedcargo test --workspace --all-targets --lockedcargo clippy --workspace --all-targets --all-features --locked -- -D warningscargo test --doc --workspace --lockedRUSTDOCFLAGS="-D warnings" cargo doc --workspace --no-deps --locked.\scripts\package-publishable.ps1 -Set bootstrap -AllowDirty.\scripts\verify-feature-matrix.ps1.\scripts\verify-release-readiness.ps1 -Version 0.34.0 -DryRun.\scripts\verify-crates-io-consumer.ps1 -Version 0.34.0after publishing