Skip to content

HydraCache 0.34.0

Choose a tag to compare

@github-actions github-actions released this 13 Jul 16:02
· 1393 commits to main since this release

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.md and 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.md and serialization contract tests for
    stable stats, diagnostics, overview, and actuator-facing snapshot fields.
  • Added docs/FEATURE_MATRIX.md and scripts/verify-feature-matrix.ps1 for
    package-level dependency-surface checks.
  • Added docs/POLICY_GUIDE.md and policy-shape tests for entity, catalog,
    search, permission, negative-cache, explicit-invalidation, and fragile
    upstream scenarios.
  • Added scripts/verify-release-readiness.ps1 for 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 -- --check
  • cargo check --workspace --all-targets --locked
  • cargo test --workspace --all-targets --locked
  • cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
  • cargo test --doc --workspace --locked
  • RUSTDOCFLAGS="-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.0 after publishing