# SWOOSH Change Log  
All notable changes to this project will be documented in this file.

The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and adheres to [Semantic Versioning](https://semver.org/).

---

## [Unreleased]

### Planned
- Metrics endpoint (`/metrics`) for transition throughput, WAL size, snapshot count.
- GuardProvider extensions:
  - Quorum validation
  - License enforcement
  - BACKBEAT cadence checks
- Integration with HMMM message envelopes (age-encrypted TransitionProposal transport).
- Catalog governance automation (generate YAML catalog from reducer.go).

---

## [1.0.0] – 2025-10-25
### Added
- **Deterministic core architecture** (reducer + executor + WAL + snapshot + replay).  
- **HTTP adapter layer** for CHORUS compatibility:
  - `/transition`, `/state`, `/health`
  - WHOOSH compatibility stubs returning 501.
- **BadgerDB WAL store** with fsync per append; replay-safe ordering.
- **Atomic snapshot writer** using fsync + rename semantics.
- **Determinism tests** (`TestDeterministicReplay`, `TestQuarantineEnforced`).
- **Integration guide** (`API_INTEGRATION.md`) for CHORUS commit 17673c3.
- **Durability documentation** (`DURABILITY.md`) covering fsync points and crash recovery.
- **Production bootstrap** (`cmd/swoosh-server/main.go`) with recovery from WAL + snapshot.

### Changed
- Exported `ComputeStateHash()` from reducer for verification in replay and tests.

### Fixed
- N/A — initial stable release.

### Security
- Single-writer executor prevents race-condition state corruption.
- Atomic snapshot replacement eliminates partial-file risk on crash.

---

## [1.1.0] – *TBD*
### Added
- `/metrics` endpoint (JSON).
- Configurable snapshot cadence.
- GuardProvider: Quorum and License guards.

### Changed
- Internal logging unified under structured logger (no concurrency).

### Fixed
- WAL GC scheduling to avoid latency spikes.

---

## [1.2.0] – *TBD*
### Added
- BACKBEAT-synchronized transition windows.
- `BeatIndex`, `WindowID`, and `HLC` exposure via `/state`.
- Cluster gossip integration for replicated guard consensus.

### Deprecated
- Static snapshot interval (replaced by cadence-aware scheduler).

---

## [2.0.0] – *Future: Multi-Node Determinism*
### Added
- Multi-executor synchronization via signed HMMM envelopes.
- Deterministic cross-node commit proofs.
- Distributed replay validation tools.

### Breaking
- TransitionProposal schema extended with `OriginNodeID` and `Signature`.
- API layer moved to `/v2/` namespace.

---

## Legend
- ✅ Completed
- ⚙️ In Progress
- 🧭 Planned