whodunit-chronicles 0.3.0 → 0.4.0

metadata

@@ -1,372 +1,86 @@
 --- !ruby/object:Gem::Specification
 name: whodunit-chronicles
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Ken C. Demanawa
-- Spherical Cow
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: concurrent-ruby
+  name: cdc-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
-  name: dry-configurable
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: dry-logger
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: pg
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.5'
-- !ruby/object:Gem::Dependency
-  name: trilogy
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.9'
-- !ruby/object:Gem::Dependency
-  name: bigdecimal
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.1'
-- !ruby/object:Gem::Dependency
-  name: kramdown
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.5'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.20'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.20'
-- !ruby/object:Gem::Dependency
-  name: mocha
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.14'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.14'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec_junit_formatter
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.0
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.60'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.60'
-- !ruby/object:Gem::Dependency
-  name: rubocop-minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.34'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.34'
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.19'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.19'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-- !ruby/object:Gem::Dependency
-  name: rubocop-thread_safety
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.22'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.22'
-- !ruby/object:Gem::Dependency
-  name: simplecov-cobertura
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: brakeman
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.1'
-- !ruby/object:Gem::Dependency
-  name: bundler-audit
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-description: While Whodunit tracks who made changes, Chronicles captures what changed
-  by streaming database events into comprehensive audit trails with zero Rails application
-  overhead.
+        version: '2.0'
+description: |
+  Whodunit Chronicles records CDC change events as immutable ledger entries.
+  It provides a tiny Chronicler processor, a Ledger abstraction,
+  and simple ledger implementations without owning replication, runtime execution, or orchestration.
 email:
 - kenneth.c.demanawa@gmail.com
-executables: []
+executables:
+- whodunit-chronicles
 extensions: []
 extra_rdoc_files: []
 files:
-- ".codeclimate.yml"
-- ".rubocop.yml"
-- ".yardopts"
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
 - LICENSE
 - README.md
-- Rakefile
-- docker-compose.yml
-- docker/mysql/init.sql
-- docker/postgres/init.sql
-- examples/images/campaign-performance-analytics.png
-- examples/images/candidate-journey-analytics.png
-- examples/images/recruitment-funnel-analytics.png
-- lib/.gitkeep
+- exe/whodunit-chronicles
 - lib/whodunit-chronicles.rb
 - lib/whodunit/chronicles.rb
-- lib/whodunit/chronicles/adapter_loader.rb
-- lib/whodunit/chronicles/adapters/mysql.rb
-- lib/whodunit/chronicles/adapters/postgresql.rb
-- lib/whodunit/chronicles/change_event.rb
-- lib/whodunit/chronicles/composite_processor.rb
-- lib/whodunit/chronicles/configuration.rb
-- lib/whodunit/chronicles/connection.rb
+- lib/whodunit/chronicles/chronicler.rb
+- lib/whodunit/chronicles/cli.rb
 - lib/whodunit/chronicles/errors.rb
-- lib/whodunit/chronicles/persistence.rb
-- lib/whodunit/chronicles/processor.rb
-- lib/whodunit/chronicles/service.rb
-- lib/whodunit/chronicles/stream_adapter.rb
-- lib/whodunit/chronicles/table.rb
+- lib/whodunit/chronicles/ledger.rb
+- lib/whodunit/chronicles/ledger_entry.rb
+- lib/whodunit/chronicles/ledger_factory.rb
+- lib/whodunit/chronicles/ledgers/file_ledger.rb
+- lib/whodunit/chronicles/ledgers/memory_ledger.rb
+- lib/whodunit/chronicles/ledgers/sqlite_ledger.rb
 - lib/whodunit/chronicles/version.rb
-- whodunit-chronicles.gemspec
+- sig/whodunit/chronicles.rbs
+- sig/whodunit/chronicles/chronicler.rbs
+- sig/whodunit/chronicles/cli.rbs
+- sig/whodunit/chronicles/errors.rbs
+- sig/whodunit/chronicles/ledger.rbs
+- sig/whodunit/chronicles/ledger_entry.rbs
+- sig/whodunit/chronicles/ledger_factory.rbs
+- sig/whodunit/chronicles/ledgers/file_ledger.rbs
+- sig/whodunit/chronicles/ledgers/memory_ledger.rbs
+- sig/whodunit/chronicles/ledgers/sqlite_ledger.rbs
 homepage: https://github.com/kanutocd/whodunit-chronicles
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/kanutocd/whodunit-chronicles
-  source_code_uri: https://github.com/kanutocd/whodunit-chronicles
+  source_code_uri: https://github.com/kanutocd/whodunit-chronicles/tree/main
   changelog_uri: https://github.com/kanutocd/whodunit-chronicles/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
@@ -376,14 +90,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.15
 specification_version: 4
-summary: The complete historical record of your data
+summary: A minimal CDC audit sink for immutable ledger entries
 test_files: []

data/.codeclimate.yml

@@ -1,50 +0,0 @@
-version: "2"
-checks:
-  argument-count:
-    config:
-      threshold: 4
-  complex-logic:
-    config:
-      threshold: 4
-  file-lines:
-    config:
-      threshold: 250
-  method-complexity:
-    config:
-      threshold: 5
-  method-count:
-    config:
-      threshold: 20
-  method-lines:
-    config:
-      threshold: 25
-  nested-control-flow:
-    config:
-      threshold: 4
-  return-statements:
-    config:
-      threshold: 4
-  similar-code:
-    config:
-      threshold: # language-specific defaults. an integer indicates the minimum number of lines within a block of similar code.
-  identical-code:
-    config:
-      threshold: # language-specific defaults. an integer indicates the minimum number of lines within a block of identical code.
-plugins:
-  rubocop:
-    enabled: true
-    config:
-      file: .rubocop.yml
-exclude_patterns:
-- "config/"
-- "db/"
-- "dist/"
-- "features/"
-- "**/node_modules/"
-- "script/"
-- "**/spec/"
-- "**/test/"
-- "**/tests/"
-- "**/vendor/"
-- "**/*_test.rb"
-- "**/*_spec.rb"

data/.rubocop.yml

@@ -1,93 +0,0 @@
-# Ruby version
-AllCops:
-  TargetRubyVersion: 3.2
-  NewCops: enable
-  Exclude:
-    - 'vendor/**/*'
-    - 'tmp/**/*'
-    - 'bin/**/*'
-    - 'node_modules/**/*'
-    - 'examples/**/*'
-
-# Use plugins for extensions
-plugins:
-  - rubocop-performance
-  - rubocop-minitest
-
-# Layout cops
-Layout/LineLength:
-  Max: 120
-  AllowedPatterns: ['\A\s*#']
-
-Layout/MultilineMethodCallBraceLayout:
-  Enabled: false
-
-Layout/ArgumentAlignment:
-  EnforcedStyle: with_fixed_indentation
-
-# Metrics cops - relax for complex business logic
-Metrics/ClassLength:
-  Max: 250  # Allow larger classes for database adapters and processors
-  Exclude:
-    - 'test/**/*'  # Test classes can be longer
-
-Metrics/MethodLength:
-  Max: 50  # Allow longer methods for SQL generation and complex logic
-
-Metrics/AbcSize:
-  Max: 40  # Allow higher complexity for database operations
-
-Metrics/CyclomaticComplexity:
-  Max: 15  # Allow more complex conditional logic
-
-Metrics/PerceivedComplexity:
-  Max: 15
-
-Metrics/ParameterLists:
-  Max: 12  # Allow more params for configuration objects and event initialization
-
-# Style cops
-Style/Documentation:
-  Enabled: false  # We have YARD docs
-
-Style/FrozenStringLiteralComment:
-  Enabled: true
-  EnforcedStyle: always
-
-# Style/StringLiterals:
-#   EnforcedStyle: double_quotes
-
-Style/HashSyntax:
-  EnforcedStyle: ruby19
-
-Style/TrailingCommaInArguments:
-  EnforcedStyleForMultiline: comma
-
-Style/TrailingCommaInArrayLiteral:
-  EnforcedStyleForMultiline: comma
-
-Style/TrailingCommaInHashLiteral:
-  EnforcedStyleForMultiline: comma
-
-# Naming
-Naming/FileName:
-  Exclude:
-    - 'lib/whodunit-chronicles.rb'  # Main gem file
-
-# Gemspec
-Gemspec/DevelopmentDependencies:
-  Enabled: false  # We're fine with dev dependencies in gemspec
-
-# Minitest specific cops
-Minitest/MultipleAssertions:
-  Max: 10  # Allow more assertions in comprehensive tests
-
-Minitest/AssertNil:
-  Enabled: false  # Prefer assert_nil over assert_equal(nil, ...)
-
-# Performance cops
-Performance/Casecmp:
-  Enabled: true
-
-Performance/StringReplacement:
-  Enabled: true

data/.yardopts

@@ -1,14 +0,0 @@
---markup markdown
---markup-provider kramdown
---main README.md
---output-dir docs
---protected
---private
---title "Whodunit Chronicles API Documentation"
---readme README.md
---files CHANGELOG.md,LICENSE
-lib/**/*.rb
--
-README.md
-CHANGELOG.md
-LICENSE