whodunit-chronicles 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa4438fb3140657b7b9d92db2988c0ca511c9fc0138ba42cfad061ab91dc0ac4
-  data.tar.gz: e3c5339e3ecce1b882be854bc906f9e1644bc812eb16302266d7b8ef68ba0f12
+  metadata.gz: c5860f6ea71bf324cb88c3962606f53c7292ba89cbf572ba408443f60248f366
+  data.tar.gz: 7333d83462ec43b3d93c38666ff51cacafff8af2579abc28594603e0d5e75a1a
 SHA512:
-  metadata.gz: '03590c69049ab8670411b6beb0e5bbb8d3fcf0989b163541fa606be5fc1c7b41f20c4e6cb5160632ed411b056664f16aa153499c947cd24c612912ff58504354'
-  data.tar.gz: 26d9cbc11e8efbf0aa716034b9ec46604d5bb78e066584f3e9674ef00732daf60fc7ba6a5506c3f9524b0ad216fcfb52e4418b2452451787b6c4498e84bab08a
+  metadata.gz: 8cce125043fb2152e3ba2e82a7c4df6a4294c624bce1278caa55ed4605166f7b658e7efe66b11a45168e154db8910a1cd5aca8c6266310e0df9e2943deb70880
+  data.tar.gz: 12bb800f8a9f0fe4b9f0355a2be1442195feeb58deab010bc25acdcc2e597cf041eb0c15bfe102b28f746b2c93e4aa1ff44677864ccaac9b2c2f501fcb03e8ff

data/CHANGELOG.md

@@ -1,228 +1,24 @@
 # 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.3.0] - 2026-05-17
-
-### Added
-
-- **`CompositeProcessor`** — fans out a single change event to multiple processors
-  in sequence, enabling pipeline architectures (e.g. simultaneously storing audit
-  records, streaming to Grafana, and triggering alerts) without coupling processors
-  to each other. Fail-open by default: if one processor raises, the error is logged
-  and the remaining processors still execute. Set `fail_fast: true` to halt the
-  chain on the first error.
-- **Typed error hierarchy** — base `Whodunit::Chronicles::Error` class with typed
-  subclasses: `ConfigurationError`, `AdapterLoadError`, `ConnectionError`,
-  `ProcessingError`, `PersistenceError`. Callers can now rescue the base class to
-  catch all gem errors, or rescue specific subclasses for targeted handling.
-- **Lazy adapter loading** — `pg` and `trilogy` are now required only when the
-  matching adapter is actually used. A friendly `AdapterLoadError` with install
-  instructions is raised if the gem is missing, instead of a cryptic `LoadError`.
-- **`bin/console`** — loads the gem with a sane test config and drops into Pry
-  for interactive development.
-- **Docker Compose test environment** — spins up PostgreSQL 16 (`wal_level=logical`),
-  MySQL 8, and MariaDB 11 with matching audit databases, init SQL scripts, test
-  tables, publication setup, and replication role grants.
-- Development environment setup guide added to docs.
-
-### Fixed
-
-- Gemspec `homepage_uri` metadata corrected.
-- `pg`, `trilogy`, and `bigdecimal` moved from runtime to `add_development_dependency`
-  — consuming apps are no longer forced to install database adapters they don't use.
-- `rubocop-rake` and `rubocop-thread_safety` added to development dependencies.
-
-### Chore
-
-- `Gemfile.lock` removed from repo.
-- `.gitignore` updated with recommended exclusions.
-
-### Docs
-
-- Broken links in README fixed.
-- Development environment setup guide added.
-
-### ⚠️ Breaking Changes
-
-- `pg`, `trilogy`, and `bigdecimal` are no longer runtime dependencies. If your
-  application relies on them being pulled in transitively via `whodunit-chronicles`,
-  add them explicitly to your own Gemfile.
-- remove ruby@3.1 from the supported versions of Ruby
-
-## [0.2.0] - 2025-01-28
-
-### Added
-
-- **MySQL/MariaDB Support**: Complete multi-database adapter architecture
-  - MySQL adapter using trilogy gem for high-performance connections
-  - Binary log streaming support for MySQL change capture
-  - Cross-database compatibility testing
-- **Enhanced Testing Suite**: Comprehensive test coverage improvements
-  - New test files: `table_test.rb`, `connection_test.rb`, `persistence_test.rb`
-  - Enhanced PostgreSQL adapter tests with connection and replication scenarios
-  - Increased line coverage from 91.28% to 97.29% (+6.01 percentage points)
-  - 227 tests with 552 assertions providing robust validation
-- **Ruby 3.4+ Compatibility**: Forward compatibility improvements
-  - Added `bigdecimal` dependency for Ruby 3.4+ support
-  - Explicit dependency management for removed stdlib components
-- **CI/CD Enhancements**: Improved automation and quality gates
-  - Matrix testing across PostgreSQL and MySQL databases
-  - Enhanced MySQL integration testing with proper connection handling
-  - Security scanning integration and automated dependency updates
-
-### Changed
-
-- **Architecture Refactoring**: Modular component extraction
-  - Extracted AuditProcessor into separate, focused components
-  - Improved service layer with multi-adapter support patterns
-  - Enhanced configuration system supporting both PostgreSQL and MySQL
-- **Database Adapter Pattern**: Extensible multi-database support
-  - Abstract adapter base class for consistent interface
-  - Database-specific implementations with optimized performance
-  - Unified change event system across different database types
-- **Test Infrastructure**: Comprehensive testing improvements
-  - Enhanced mock-based testing for complex database operations
-  - Improved test organization with better separation of concerns
-  - Integration test scenarios for real-world usage patterns
-
-### Fixed
-
-- **MySQL CI Integration**: Resolved connection and setup issues
-  - Fixed MySQL container configuration and health checks  
-  - Improved database readiness detection and timeout handling
-  - Enhanced error reporting and debugging for CI environments
-- **Dependency Management**: Ruby version compatibility
-  - Added explicit `bigdecimal ~> 3.1` dependency for Ruby 3.4+
-  - Resolved trilogy gem loading issues in newer Ruby versions
-  - Improved gem specification with proper version constraints
-
-### Technical Improvements
-
-- **Code Coverage**: Significant testing improvements
-  - Line coverage: 97.29% (647/665 lines covered)
-  - Branch coverage: 83.6% (158/189 branches covered)
-  - Comprehensive unit tests for all core modules
-- **Performance Optimizations**: Multi-adapter efficiency
-  - Database-specific SQL generation and parameter binding
-  - Optimized connection management across different adapters
-  - Efficient batch processing for both PostgreSQL and MySQL
-- **Error Handling**: Enhanced resilience and debugging
-  - Improved error messages and stack trace reporting
-  - Better handling of database-specific error conditions
-  - Enhanced logging for troubleshooting and monitoring
-
-### Development Experience
-
-- **Documentation**: Enhanced developer resources
-  - Updated README with MySQL/MariaDB configuration examples
-  - Improved inline documentation for multi-adapter usage
-  - Better error messages and troubleshooting guides
-- **Testing Framework**: Improved development workflow
-  - Faster test execution with better mock strategies
-  - More reliable CI/CD pipeline with matrix testing
-  - Enhanced debugging capabilities for test failures
-
-## [0.1.0] - 2025-01-21
-
-### Added
-
-- Comprehensive GitHub Actions CI/CD pipeline with multi-Ruby testing
-- Automated security scanning with bundler-audit and CodeQL
-- YARD documentation generation with GitHub Pages deployment
-- Automated gem publishing workflow for tagged releases
-- Structured issue and pull request templates for better contributor experience
-- Dependabot configuration for automated dependency updates
-- Security scanning dependencies (bundler-audit, brakeman)
-- Comprehensive README with architecture diagrams and examples
-- RuboCop configuration with relaxed metrics for test files
-
-### Changed
-
-- Updated dependencies to latest versions with security patches
-- Improved RuboCop configuration to exclude test files from ClassLength limits
-- Enhanced gemspec with proper metadata and security dependencies
-
-## [0.1.0] - 2025-01-21
-
-### Added
-
-- **Core Architecture**: Complete zero-latency audit streaming implementation
-- **PostgreSQL Adapter**: Logical replication streaming with WAL decoding
-- **ChangeEvent System**: Unified change representation across database adapters
-- **Processor**: Intelligent transformation of changes into audit records
-- **Configuration Management**: Comprehensive settings with validation using dry-configurable
-- **Service Orchestration**: Thread-safe service with error handling and retry logic
-- **Abstract Adapter Pattern**: Extensible design supporting multiple database systems
-- **User Attribution**: Automatic extraction of user information from creator/updater/deleter fields
-- **Batch Processing**: Efficient bulk processing of audit records
-- **Connection Management**: Robust database connection handling with retries
-- **Error Handling**: Comprehensive error recovery and logging
-- **Thread Safety**: Concurrent processing with thread pool management
-
-### Technical Implementation
-
-- **Modern Ruby Support**: Ruby 3.1+ with frozen string literals
-- **Database Features**:
-  - PostgreSQL logical replication with pgoutput plugin
-  - Publication and replication slot management
-  - WAL position tracking and resumption
-  - Connection pooling and management
-- **Event Processing**:
-  - Real-time change capture at database level
-  - Structured change events with metadata
-  - Configurable table and schema filtering
-  - Transaction ID and sequence number tracking
-- **Audit Records**:
-  - Complete before/after data capture
-  - Calculated field-level changes
-  - User attribution from standard columns
-  - Timestamps and version tracking
-  - JSON metadata storage
-
-### Development & Testing
-
-- **Test Coverage**: 94.3% code coverage (447/474 lines)
-- **Testing Framework**: Minitest with shoulda-style assertions and mocha mocking
-- **Test Suite**: 129 tests covering all components with comprehensive error scenarios
-- **Code Quality**: RuboCop compliance with modern Ruby standards
-- **Security**: bundler-audit integration for vulnerability scanning
-- **Documentation**: Inline YARD documentation for all public APIs
-
-### Dependencies
-
-- **Core**: concurrent-ruby, dry-configurable, dry-logger, pg
-- **Development**: minitest, rubocop, simplecov, yard
-- **Testing**: mocha for mocking, pry for debugging
-- **Security**: bundler-audit for vulnerability scanning
-
-### Configuration Options
-
-- Database connection URLs (source and audit)
-- PostgreSQL publication and replication slot names
-- Batch processing sizes and retry policies
-- Table and schema inclusion/exclusion filters
-- Logging levels and output configuration
-- Thread pool and concurrency settings
-
-### Performance Features
-
-- **Zero Application Overhead**: No Rails callbacks or Active Record hooks
-- **Efficient Streaming**: PostgreSQL logical replication optimization
-- **Memory Management**: Streaming processing without dataset loading
-- **Configurable Batching**: Tunable batch sizes for optimal throughput
-- **Connection Reuse**: Persistent connections with automatic recovery
-- **Background Processing**: Non-blocking operation with thread pools
-
-### Production Ready Features
-
-- **Monitoring**: Service status and health checking
-- **Resilience**: Automatic retry logic with exponential backoff
-- **Graceful Shutdown**: Clean service termination
-- **Error Recovery**: Robust error handling with detailed logging
-- **Position Tracking**: WAL position persistence for reliable resumption
-- **Resource Management**: Bounded thread pools and memory usage
+## Unreleased
+
+## 0.4.0
+
+- Rebuilt as a minimal CDC audit sink.
+- Added `Chronicler` as a `CDC::Core::Processor`.
+- Added runtime dependency on `cdc-core`.
+- Added immutable `LedgerEntry`.
+- Added `Ledger` base contract.
+- Added `MemoryLedger`.
+- Added `FileLedger`.
+- Added `SQLiteLedger`.
+- Added ledger lifecycle CLI.
+- Added RBS signatures.
+- Added 100% code coverage and 100% YARD coverage gates.
+- Added runtime dependency on `sqlite3` for built-in SQLite ledger support.
+- Added real SQLite integration coverage for persistence, custom tables, status counts, and duplicate event IDs.
+- Clarified SQLite duplicate append behavior: duplicate `event_id` values raise `Whodunit::Chronicles::AppendError`.
+- Added JSON status output and stricter option validation to the ledger lifecycle CLI.
+- Improved CLI errors for malformed configuration, missing required ledger options, unsupported lifecycle methods, and failed verification.
+- Completed the Steep-backed RBS quality gate.
+- Added GitHub Actions workflows for generated YARD documentation and tagged RubyGems releases.

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Ken C. Demanawa
+Copyright (c) 2026 Kenneth C. Demanawa
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal