# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.1.2] - 2026-01-13

### Fixed

- Added `AGENTS.md` and `SECURITY.md` to ExDoc extras to fix broken documentation links.

## [0.1.1] - 2026-01-13

### Security

- Added payload size limit (4MB) to prevent Denial of Service (DoS) attacks.
- Added `SECURITY.md` with trust model and vulnerability reporting guidelines.
- Mapped storage errors to correct gRPC status codes (e.g., `RESOURCE_EXHAUSTED`).

## [0.1.0] - 2025-01-10

### Added

- Initial release of Converge Ledger
- **Append-only storage** with Mnesia backend
  - Sequential, immutable entries per context
  - Monotonic sequence numbers
  - Nanosecond timestamps
- **gRPC API** (Protobuf-based)
  - `Append` - Add entries to a context
  - `Get` - Retrieve entries with filters (key, after_sequence, limit)
  - `Snapshot` - Serialize entire context to binary
  - `Load` - Restore context from snapshot
  - `Watch` - Real-time streaming of new entries
- **WatchRegistry** for subscription management
  - Per-context subscriptions
  - Optional key filtering
  - Automatic cleanup on process exit
- **OTP Application** with supervision tree
- **Clustering support** via libcluster
- Documentation
  - README with architecture overview
  - ARCHITECTURE.md with design decisions
  - CONTRIBUTING.md with development guidelines

### Design Principles

- Derivative, not authoritative (Rust engine holds truth)
- Append-only (no updates, deletes, or rewrites)
- Eventually consistent (CRDT-style without conflicts)
- Fail-safe (data loss doesn't break correctness)

[Unreleased]: https://github.com/kpernyer/converge-ledger/compare/v0.1.2...HEAD
[0.1.2]: https://github.com/kpernyer/converge-ledger/compare/v0.1.1...v0.1.2
[0.1.1]: https://github.com/kpernyer/converge-ledger/compare/v0.1.0...v0.1.1
[0.1.0]: https://github.com/kpernyer/converge-ledger/releases/tag/v0.1.0