rubydb 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 569e9ce02867a64e165f0703b4c2f3135255666ac938b05bed690b846df8b9b7
-  data.tar.gz: 29d7e3cb03885093407d20c51e52bfb4bb17257b701b862b5070fff5bc8f9eb3
+  metadata.gz: 1c9eda84a67f7461880366d67d049e384b92d16735bfa453c8ab580ed4394c86
+  data.tar.gz: 577ab7b7758ebfbf4fa6ccbdd3fc6bc6ca022ab47253acc025fd55cdfe6935da
 SHA512:
-  metadata.gz: 1a3a33eb843e173974500f6848e395d10b4004b30c05c5c14b3afc353d3eff1c128d3d4ed6c3779889384aa0554b08c28d3722a0bcd623dca8d3576454fcc467
-  data.tar.gz: 3784d9d65f06788ab7e6e934b46e9916e1cd3ce0fc86f30bc677fb9b23c0b0d6cc04223b6b7acdcf38122d9ce0972b71eff1681bb02e6c07c350bf73f06d0d3f
+  metadata.gz: 301264ede8f046b3d5cb2c8c3fa90d220ae184dc4a72bca0962144876702d3b2a11ab570afd8acd786893cde098df8241fd7b95bfc6f1f5d2958dee4b7c4ae5a
+  data.tar.gz: 8ec1f26484273234980dd643b040a14d500f9551a1a873f3d293d3dc089b743b3e449f134c77083ad534045cd38ebcd7f98eb0f7770b6cc38283d4b87b69bdf1

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,15 +1,15 @@
-## Summary
-
-Describe the change and the user or operator problem it solves.
-
-## Validation
-
-- [ ] Tests added or updated for changed behavior
-- [ ] `bundle exec rspec` passes, or failures are explained
-- [ ] Documentation and compatibility claims are updated
-- [ ] Production, security, migration, and rollback impact reviewed
-
-## Operational impact
-
-Describe storage-format, WAL, migration, configuration, protocol, replication,
-security, and upgrade implications. Include rollback and observability notes.
+## Summary
+
+Describe the change and the user or operator problem it solves.
+
+## Validation
+
+- [ ] Tests added or updated for changed behavior
+- [ ] `bundle exec rspec` passes, or failures are explained
+- [ ] Documentation and compatibility claims are updated
+- [ ] Production, security, migration, and rollback impact reviewed
+
+## Operational impact
+
+Describe storage-format, WAL, migration, configuration, protocol, replication,
+security, and upgrade implications. Include rollback and observability notes.

data/.github/workflows/benchmark.yml

@@ -1,26 +1,26 @@
-name: Workload smoke benchmark
-
-on:
-  pull_request:
-    branches: [main]
-  push:
-    branches: [main]
-
-permissions:
-  contents: read
-
-jobs:
-  workload:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Deterministic storage workload
-        run: RUBYDB_BENCHMARK_ITERATIONS=100 bundle exec ruby -Ilib benchmarks/basic_workload.rb
-      - name: Concurrent durability workload
-        run: RUBYDB_WORKLOAD_THREADS=4 RUBYDB_WORKLOAD_OPERATIONS=100 bundle exec ruby -Ilib benchmarks/concurrent_workload.rb
-      - name: Server protocol durability workload
-        run: RUBYDB_SERVER_WORKLOAD_CLIENTS=2 RUBYDB_SERVER_WORKLOAD_OPERATIONS=25 bundle exec ruby -Ilib benchmarks/server_workload.rb
+name: Workload smoke benchmark
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  workload:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - name: Deterministic storage workload
+        run: RUBYDB_BENCHMARK_ITERATIONS=100 bundle exec ruby -Ilib benchmarks/basic_workload.rb
+      - name: Concurrent durability workload
+        run: RUBYDB_WORKLOAD_THREADS=4 RUBYDB_WORKLOAD_OPERATIONS=100 bundle exec ruby -Ilib benchmarks/concurrent_workload.rb
+      - name: Server protocol durability workload
+        run: RUBYDB_SERVER_WORKLOAD_CLIENTS=2 RUBYDB_SERVER_WORKLOAD_OPERATIONS=25 bundle exec ruby -Ilib benchmarks/server_workload.rb

data/.github/workflows/compatibility.yml

@@ -1,63 +1,63 @@
-name: Compatibility
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  ruby:
-    name: Ruby ${{ matrix.ruby }} on ${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        ruby: ["3.3", "3.4"]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-      - name: Run regression suite with coverage gate
-        env:
-          RUBYDB_COVERAGE: "1"
-        run: bundle exec rspec
-
-      - name: Validate SQLite compatibility profile
-        run: bundle exec rspec spec/sqlite_compatibility_spec.rb
-
-  rails:
-    name: ActiveRecord ${{ matrix.rails }}
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        rails: ["7.1", "7.2", "8.0"]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Build current RubyDB gem
-        run: bundle exec rake build
-      - name: Install current RubyDB gem for adapter dependency
-        shell: bash
-        run: gem install "$(ls -t pkg/rubydb-*.gem | head -n 1)" --local --no-document
-      - name: Install adapter dependencies
-        working-directory: adapters/activerecord
-        env:
-          RUBYDB_RAILS_VERSION: ${{ matrix.rails }}
-        run: bundle install --jobs 4 --retry 3
-      - name: Run adapter integration suite
-        working-directory: adapters/activerecord
-        env:
-          RUBYDB_RAILS_VERSION: ${{ matrix.rails }}
-        run: bundle exec rspec
+name: Compatibility
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  ruby:
+    name: Ruby ${{ matrix.ruby }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        ruby: ["3.3", "3.4"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run regression suite with coverage gate
+        env:
+          RUBYDB_COVERAGE: "1"
+        run: bundle exec rspec
+
+      - name: Validate SQLite compatibility profile
+        run: bundle exec rspec spec/sqlite_compatibility_spec.rb
+
+  rails:
+    name: ActiveRecord ${{ matrix.rails }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        rails: ["7.1", "7.2", "8.0"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - name: Build current RubyDB gem
+        run: bundle exec rake build
+      - name: Install current RubyDB gem for adapter dependency
+        shell: bash
+        run: gem install "$(ls -t pkg/rubydb-*.gem | head -n 1)" --local --no-document
+      - name: Install adapter dependencies
+        working-directory: adapters/activerecord
+        env:
+          RUBYDB_RAILS_VERSION: ${{ matrix.rails }}
+        run: bundle install --jobs 4 --retry 3
+      - name: Run adapter integration suite
+        working-directory: adapters/activerecord
+        env:
+          RUBYDB_RAILS_VERSION: ${{ matrix.rails }}
+        run: bundle exec rspec

data/.github/workflows/fuzz.yml

@@ -1,33 +1,33 @@
-name: Fuzz safety
-
-on:
-  pull_request:
-    branches: [main]
-  schedule:
-    - cron: "17 3 * * 0"
-  workflow_dispatch:
-    inputs:
-      iterations:
-        description: "Iterations per fuzzer"
-        required: false
-        default: "1000"
-        type: string
-
-permissions:
-  contents: read
-
-jobs:
-  fuzz:
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Run bounded fuzzers
-        env:
-          RUBYDB_FUZZ_ITERATIONS: ${{ inputs.iterations || '100' }}
-          RUBYDB_FUZZ_SEED: "20260909"
-        run: ruby scripts/fuzz
+name: Fuzz safety
+
+on:
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "17 3 * * 0"
+  workflow_dispatch:
+    inputs:
+      iterations:
+        description: "Iterations per fuzzer"
+        required: false
+        default: "1000"
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  fuzz:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - name: Run bounded fuzzers
+        env:
+          RUBYDB_FUZZ_ITERATIONS: ${{ inputs.iterations || '100' }}
+          RUBYDB_FUZZ_SEED: "20260909"
+        run: ruby scripts/fuzz

data/.github/workflows/lint.yml

@@ -1,21 +1,21 @@
-name: Lint
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-permissions:
-  contents: read
-
-jobs:
-  rubocop:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - run: bundle exec rubocop
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  rubocop:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - run: bundle exec rubocop

data/.github/workflows/operations.yml

@@ -1,24 +1,24 @@
-name: Operations drills
-
-on:
-  schedule:
-    - cron: "47 3 * * 1"
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  restore:
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Run backup and restore drill
-        run: ruby scripts/restore_drill
-      - name: Run durability fault and recovery drill
-        run: ruby scripts/durability_drill
+name: Operations drills
+
+on:
+  schedule:
+    - cron: "47 3 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  restore:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - name: Run backup and restore drill
+        run: ruby scripts/restore_drill
+      - name: Run durability fault and recovery drill
+        run: ruby scripts/durability_drill

data/.github/workflows/production-validation.yml

@@ -1,111 +1,111 @@
-name: Production validation
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: "19 4 * * 3"
-
-permissions:
-  contents: read
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    timeout-minutes: 45
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-
-      - name: Run production safety regression set
-        run: |
-          bundle exec rspec \
-            spec/server_protocol_spec.rb \
-            spec/server_concurrency_durability_spec.rb \
-            spec/concurrent_soak_harness_spec.rb \
-            spec/multiprocess_server_workload_spec.rb \
-            spec/filesystem_fault_injection_spec.rb \
-            spec/metadata_persistence_safety_spec.rb \
-            spec/index_persistence_spec.rb \
-            spec/compaction_persistence_spec.rb \
-            spec/backup_restore_spec.rb \
-            spec/replication_network_spec.rb \
-            spec/replication_partition_spec.rb \
-            spec/replication_failover_integration_spec.rb \
-            spec/fencing_spec.rb \
-            spec/corruption_repair_spec.rb
-            spec/sqlite_compatibility_spec.rb
-
-      - name: Run sustained threaded workload
-        shell: bash
-        run: |
-          set -euo pipefail
-          mkdir -p production-results
-          RUBYDB_SOAK_ROUNDS=3 \
-          RUBYDB_SOAK_THREADS=16 \
-          RUBYDB_SOAK_OPERATIONS=2000 \
-          RUBYDB_SOAK_PAYLOAD_BYTES=512 \
-          ruby benchmarks/concurrent_soak.rb | tee production-results/threaded.json
-
-      - name: Run server and independent-process workloads
-        shell: bash
-        run: |
-          set -euo pipefail
-          RUBYDB_SERVER_WORKLOAD_CLIENTS=16 \
-          RUBYDB_SERVER_WORKLOAD_OPERATIONS=1000 \
-          ruby -Ilib benchmarks/server_workload.rb | tee production-results/server.json
-          RUBYDB_SERVER_WORKLOAD_PROCESSES=8 \
-          RUBYDB_SERVER_WORKLOAD_OPERATIONS=1000 \
-          ruby benchmarks/multiprocess_server_workload.rb | tee production-results/multiprocess.json
-
-      - name: Run production concurrency and resilience soak
-        shell: bash
-        run: |
-          set -euo pipefail
-          RUBYDB_PRODUCTION_SOAK_CLIENTS=16 \
-          RUBYDB_PRODUCTION_SOAK_OPERATIONS=2000 \
-          RUBYDB_PRODUCTION_SOAK_CANCEL_ROWS=250000 \
-          ruby benchmarks/production_soak.rb | tee production-results/production-soak.json
-
-      - name: Run process-level replication failover drill
-        run: ruby scripts/replication_failover_drill | tee production-results/replication-failover.json
-
-      - name: Run network partition and promotion drill
-        run: ruby scripts/replication_network_failover_drill | tee production-results/replication-network-failover.json
-
-      - name: Run backup and restore drill
-        run: ruby scripts/restore_drill | tee production-results/restore.txt
-
-      - name: Run durability fault and recovery drill
-        run: ruby scripts/durability_drill | tee production-results/durability.txt
-
-      - name: Run bounded fuzzers
-        env:
-          RUBYDB_FUZZ_ITERATIONS: "250"
-          RUBYDB_FUZZ_SEED: "20260909"
-        run: ruby scripts/fuzz | tee production-results/fuzz.txt
-
-      - name: Build and verify release artifact
-        run: |
-          bundle exec rake build
-          ruby scripts/release | tee production-results/release.txt
-
-      - name: Upload validation evidence
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: rubydb-production-validation-${{ github.sha }}
-          path: production-results/
-
-  container-topology:
-    name: Multi-node container topology
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-    steps:
-      - uses: actions/checkout@v4
-      - name: Validate compose topology
-        run: docker compose -f packaging/docker/docker-compose.failover.yml config
-      - name: Build production image
-        run: docker compose -f packaging/docker/docker-compose.failover.yml build primary replica
+name: Production validation
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "19 4 * * 3"
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Run production safety regression set
+        run: |
+          bundle exec rspec \
+            spec/server_protocol_spec.rb \
+            spec/server_concurrency_durability_spec.rb \
+            spec/concurrent_soak_harness_spec.rb \
+            spec/multiprocess_server_workload_spec.rb \
+            spec/filesystem_fault_injection_spec.rb \
+            spec/metadata_persistence_safety_spec.rb \
+            spec/index_persistence_spec.rb \
+            spec/compaction_persistence_spec.rb \
+            spec/backup_restore_spec.rb \
+            spec/replication_network_spec.rb \
+            spec/replication_partition_spec.rb \
+            spec/replication_failover_integration_spec.rb \
+            spec/fencing_spec.rb \
+            spec/corruption_repair_spec.rb
+            spec/sqlite_compatibility_spec.rb
+
+      - name: Run sustained threaded workload
+        shell: bash
+        run: |
+          set -euo pipefail
+          mkdir -p production-results
+          RUBYDB_SOAK_ROUNDS=3 \
+          RUBYDB_SOAK_THREADS=16 \
+          RUBYDB_SOAK_OPERATIONS=2000 \
+          RUBYDB_SOAK_PAYLOAD_BYTES=512 \
+          ruby benchmarks/concurrent_soak.rb | tee production-results/threaded.json
+
+      - name: Run server and independent-process workloads
+        shell: bash
+        run: |
+          set -euo pipefail
+          RUBYDB_SERVER_WORKLOAD_CLIENTS=16 \
+          RUBYDB_SERVER_WORKLOAD_OPERATIONS=1000 \
+          ruby -Ilib benchmarks/server_workload.rb | tee production-results/server.json
+          RUBYDB_SERVER_WORKLOAD_PROCESSES=8 \
+          RUBYDB_SERVER_WORKLOAD_OPERATIONS=1000 \
+          ruby benchmarks/multiprocess_server_workload.rb | tee production-results/multiprocess.json
+
+      - name: Run production concurrency and resilience soak
+        shell: bash
+        run: |
+          set -euo pipefail
+          RUBYDB_PRODUCTION_SOAK_CLIENTS=16 \
+          RUBYDB_PRODUCTION_SOAK_OPERATIONS=2000 \
+          RUBYDB_PRODUCTION_SOAK_CANCEL_ROWS=250000 \
+          ruby benchmarks/production_soak.rb | tee production-results/production-soak.json
+
+      - name: Run process-level replication failover drill
+        run: ruby scripts/replication_failover_drill | tee production-results/replication-failover.json
+
+      - name: Run network partition and promotion drill
+        run: ruby scripts/replication_network_failover_drill | tee production-results/replication-network-failover.json
+
+      - name: Run backup and restore drill
+        run: ruby scripts/restore_drill | tee production-results/restore.txt
+
+      - name: Run durability fault and recovery drill
+        run: ruby scripts/durability_drill | tee production-results/durability.txt
+
+      - name: Run bounded fuzzers
+        env:
+          RUBYDB_FUZZ_ITERATIONS: "250"
+          RUBYDB_FUZZ_SEED: "20260909"
+        run: ruby scripts/fuzz | tee production-results/fuzz.txt
+
+      - name: Build and verify release artifact
+        run: |
+          bundle exec rake build
+          ruby scripts/release | tee production-results/release.txt
+
+      - name: Upload validation evidence
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: rubydb-production-validation-${{ github.sha }}
+          path: production-results/
+
+  container-topology:
+    name: Multi-node container topology
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+      - name: Validate compose topology
+        run: docker compose -f packaging/docker/docker-compose.failover.yml config
+      - name: Build production image
+        run: docker compose -f packaging/docker/docker-compose.failover.yml build primary replica