Skip to content

CHANGELOG.md

Latest commit

 

History

History
81 lines (54 loc) · 4.08 KB

CHANGELOG.md

File metadata and controls

81 lines (54 loc) · 4.08 KB
Raw

Changelog

All notable changes to StreamHive are documented here. This project follows Semantic Versioning for the public Go API (p2p, storage, and stable CLI flags). Until v1.0.0, minor releases may include API adjustments; see entries below.

[Unreleased]

Added

  • p2p: PeerSnapshots exposes connected peer metadata for operational tooling.
  • Docs: protocol reference for SHV1 frames, replication messages, limits, and repair behavior.
  • Docs: TLS/mTLS peer identity guidance and remaining application-level auth gaps.

Changed

  • Ops: /peers now includes local address, connection timestamp, and connection age.

[0.6.0] — 2026-07-02

Added

  • Ops: /peers JSON endpoint for inspecting active peer addresses and connection direction.
  • Demo: make demo-status prints each Compose node's peers, metrics, and durable keys.
  • Demo: make demo-failure proves reconnect plus anti-entropy repair after a node restart.
  • CI: Docker Compose reconnect/failure demo verification.

[0.5.0] — 2026-07-01

Added

  • Metrics: duplicate blob counters for idempotent replication receives.
  • CLI: -sync-interval for periodic anti-entropy inventory after peer startup.
  • Demo: 3-node corruption repair demo for deleted durable blobs.
  • CI: Docker Compose corruption repair demo verification.

Changed

  • CLI: blob.put handling now skips exact duplicate key/data writes while still allowing opaque-key replacement.
  • CLI: SHA-256-shaped blob keys are verified against received data before storage.

[0.4.0] — 2026-07-01

Added

  • storage: SHA-256 content key helpers for content-addressed blob IDs.
  • storage: BlobKeyLister interface plus deterministic ListKeys support for memory and file stores.
  • replication: blob.has, blob.get, and blob.missing message types for anti-entropy sync.
  • CLI: startup anti-entropy sync for -replicate peers using blob.has / blob.missing / blob.put.
  • CLI: -put-content-key for sending blobs under SHA-256(-put-data) content keys.
  • CLI: -list-keys for inspecting durable -store-dir keys as hex.
  • Demo: 3-node Docker Compose demo with durable stores and node restart rehydration.
  • Metrics: Prometheus text endpoint at /metrics/prometheus.
  • CI: Docker Compose rehydration demo verification.

[0.3.0] — 2026-06-24

Added

  • replication: typed blob replication protocol with blob.put encoding, decoding, validation limits, and BlobStore apply helper.
  • storage: FileStore directory-backed BlobStore with hex-encoded keys and restart persistence.
  • p2p: TCPPeer.WriteFrame convenience method for framed peer writes.
  • CLI: -replicate, -store-dir, -put-key, -put-data, -exit-after-put, -peers, -peer-reconnect, -peer-reconnect-min, -peer-reconnect-max, and -max-blob-bytes for static replication demos and long-lived static-peer nodes.
  • Metrics: replication counters for stored/sent blobs, stored/sent bytes, and replication errors.
  • Demo: make demo-replication starts a receiver, sends one blob, waits for metrics, and prints the evidence.

[0.2.0] — 2026-04-05

Added

  • Semver Version constant and this changelog.
  • storage: BlobStore interface and in-memory implementation for content-keyed blobs.
  • p2p: length-prefixed wire framing (SHV1 magic), metrics, context.Context on ListenAndAccept / Dial, graceful accept-loop shutdown, peer removal on disconnect, optional max peers, dial / read idle deadlines, optional TLS, optional framed FrameHandler.
  • CLI: -version, -max-peers, -dial-timeout, -read-idle-timeout, optional -health (live/ready/metrics), optional TLS flags.
  • Ops docs: deployment (Docker/K8s sketch), governance (branch protection checklist), SBOM artifact in CI, pinned GitHub Actions by commit SHA.

Changed

  • Breaking: Transport.ListenAndAccept and Dial now take context.Context as the first argument.

[0.1.0]

  • Initial public foundation: TCP transport, tests, CI, documentation.