redis-objects-periodical 0.7.0 → 0.8.0

data/.github/workflows/ci.yml

@@ -0,0 +1,191 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [master, release]
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  dependabot_policy:
+    name: dependabot-policy
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Test auto-merge policy without API writes
+        run: node --test .github/scripts/*.test.cjs
+
+  active_support_timezone:
+    name: active-support-timezone
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    container:
+      image: cimg/ruby:3.3
+      options: --user 0
+    services:
+      redis:
+        image: redis:latest@sha256:97ec88159e6d7cfb5ddef9015386087d58a912de80112f06ebdfa78fa5989901
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 5s
+          --health-timeout 3s
+          --health-retries 10
+    defaults:
+      run:
+        shell: bash
+    env:
+      TZ: UTC
+      BUNDLE_GEMFILE: gemfiles/active_support/Gemfile
+      BUNDLE_FROZEN: 'true'
+      BUNDLE_PATH: vendor/bundle
+      SIMPLECOV_COMMAND_NAME: active-support-timezone
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Install locked optional integration dependencies
+        run: |
+          git config --global --add safe.directory "$GITHUB_WORKSPACE"
+          git ls-files --error-unmatch lib/redis-objects-periodical.rb >/dev/null
+          gem install bundler -v 4.0.23 --no-document
+          bundle _4.0.23_ install
+      - name: Verify real ActiveSupport timezone behavior in a separate process
+        run: |
+          mkdir -p test-results
+          bundle exec rspec spec/integration/redis/recurring_at_intervals_spec.rb --exclude-pattern '' \
+            --format RspecJunitFormatter --out test-results/active-support.xml \
+            --format json --out test-results/active-support.json
+      - name: Verify every intended timezone example passed
+        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        with:
+          script: |
+            const { readFileSync } = require('node:fs');
+            const { validateInventory } = require('./.github/scripts/timezone-inventory.cjs');
+            const report = JSON.parse(readFileSync('test-results/active-support.json', 'utf8'));
+            core.info(`Verified ${validateInventory(report)} passed timezone integration examples`);
+      - name: Store integration results
+        if: ${{ always() }}
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
+        with:
+          name: active-support-timezone
+          path: |
+            test-results/
+            coverage/
+          retention-days: 14
+
+  checks:
+    uses: ./.github/workflows/checks.yml
+
+  yardoc:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    container:
+      image: cimg/ruby:3.3
+      options: --user 0
+    defaults:
+      run:
+        shell: bash
+    env:
+      BUNDLE_FROZEN: 'true'
+      BUNDLE_PATH: vendor/bundle
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Install locked dependencies
+        run: |
+          git config --global --add safe.directory "$GITHUB_WORKSPACE"
+          git ls-files --error-unmatch lib/redis-objects-periodical.rb >/dev/null
+          gem install bundler -v 4.0.23 --no-document
+          bundle _4.0.23_ install
+      - name: Generate YARD documentation
+        run: bundle exec yardoc -o yardoc
+      - name: Store documentation
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
+        with:
+          name: yardoc
+          path: yardoc/
+          if-no-files-found: error
+          retention-days: 14
+
+  upload_coverage:
+    name: upload-coverage
+    needs: checks
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    container:
+      image: cimg/ruby:3.3
+      options: --user 0
+    defaults:
+      run:
+        shell: bash
+    env:
+      BUNDLE_FROZEN: 'true'
+      BUNDLE_PATH: vendor/bundle
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Install locked dependencies
+        run: |
+          git config --global --add safe.directory "$GITHUB_WORKSPACE"
+          git ls-files --error-unmatch lib/redis-objects-periodical.rb >/dev/null
+          gem install bundler -v 4.0.23 --no-document
+          bundle _4.0.23_ install
+      - name: Download coverage merge inputs
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8
+        with:
+          pattern: simplecov-ruby-*
+          path: tmp/simplecov-results
+      - name: Collate all three Ruby results
+        run: |
+          bundle exec ruby -e '
+            require "simplecov"
+            require "simplecov_json_formatter"
+
+            resultset_files = %w[3.3 3.4 4.0].map do |version|
+              "tmp/simplecov-results/simplecov-ruby-#{version}/resultset.json"
+            end
+            missing = resultset_files.reject { |file| File.file?(file) }
+            abort("Missing coverage results: #{missing.join(", ")}") unless missing.empty?
+
+            SimpleCov.collate(resultset_files, ignore_timeout: true) do
+              formatter SimpleCov::Formatter::JSONFormatter
+              coverage_dir "coverage"
+            end
+          '
+      - name: Store merged coverage
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
+        with:
+          name: merged-coverage
+          path: coverage/coverage.json
+          if-no-files-found: error
+          retention-days: 14
+      - name: Check Qlty authentication
+        id: qlty
+        env:
+          QLTY_COVERAGE_TOKEN: ${{ secrets.QLTY_COVERAGE_TOKEN }}
+        run: |
+          if [ -n "$QLTY_COVERAGE_TOKEN" ]; then
+            echo "available=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "available=false" >> "$GITHUB_OUTPUT"
+            echo "QLTY_COVERAGE_TOKEN is not set. Coverage is saved; skipping Qlty upload."
+          fi
+      - name: Publish coverage to Qlty
+        if: ${{ steps.qlty.outputs.available == 'true' }}
+        uses: qltysh/qlty-action/coverage@ebcd284bf32e36a030afe15f1e136c7be08b9506 # v2.5.0
+        with:
+          token: ${{ secrets.QLTY_COVERAGE_TOKEN }}
+          files: coverage/coverage.json
+          skip-errors: false

data/.github/workflows/dependabot-auto-merge.yml

@@ -0,0 +1,61 @@
+name: Dependabot Auto Merge
+
+on:
+  # Metadata only: never check out or execute the PR head in this privileged job.
+  # Required for a write token on Dependabot events; only the trusted base policy runs.
+  pull_request_target: # zizmor: ignore[dangerous-triggers]
+    types: [opened, reopened, synchronize, ready_for_review]
+
+concurrency:
+  group: dependabot-auto-merge-${{ github.event.pull_request.number }}
+  # Serialize enable/revoke operations; cancellation has no expected-head API guard.
+  cancel-in-progress: false
+
+permissions: {}
+
+jobs:
+  enable:
+    if: >-
+      ${{ github.event.pull_request.user.login == 'dependabot[bot]' &&
+          github.event.pull_request.base.ref == 'master' &&
+          github.event.pull_request.head.repo.full_name == github.repository }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
+    permissions:
+      contents: write
+      pull-requests: write
+      actions: read # Verify the originating workflow run of an ownership marker.
+    steps:
+      - name: Check out trusted base policy only
+        id: policy_checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.event.pull_request.base.sha }}
+          persist-credentials: false
+          sparse-checkout: .github/scripts
+      - name: Fetch Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@25dd0e34f4fe68f24cc83900b1fe3fe149efef98 # v3.1.0
+        with:
+          github-token: ${{ github.token }}
+      - name: Reconcile workflow-owned auto-merge
+        # An earlier metadata failure must still revoke an owned reservation.
+        if: ${{ always() && steps.policy_checkout.outcome == 'success' }}
+        id: policy
+        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        env:
+          METADATA_OUTCOME: ${{ steps.metadata.outcome }}
+          ECOSYSTEM: ${{ steps.metadata.outputs.package-ecosystem }}
+          UPDATE_TYPE: ${{ steps.metadata.outputs.update-type }}
+          DEPENDENCY_NAMES: ${{ steps.metadata.outputs.dependency-names }}
+        with:
+          script: |
+            const { reconcile } = require('./.github/scripts/dependabot-auto-merge.cjs');
+            await reconcile({ github, context, core,
+              metadataOutcome: process.env.METADATA_OUTCOME,
+              metadata: {
+                ecosystem: process.env.ECOSYSTEM,
+                updateType: process.env.UPDATE_TYPE,
+                dependencyNames: process.env.DEPENDENCY_NAMES || '',
+              },
+            });

data/.github/workflows/release.yml

@@ -0,0 +1,59 @@
+name: Release
+
+on:
+  push:
+    branches: [release]
+  workflow_dispatch:
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  checks:
+    if: ${{ github.ref == 'refs/heads/release' }}
+    uses: ./.github/workflows/checks.yml
+
+  publish:
+    needs: checks
+    if: ${{ github.ref == 'refs/heads/release' }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    environment: release
+    permissions:
+      contents: write
+      id-token: write
+    env:
+      BUNDLE_FROZEN: 'true'
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Set up Ruby without dependency caches
+        uses: ruby/setup-ruby@26e5b7d197ebf60545ee9667bcbace0be11ccaec # v1.334.0
+        with:
+          ruby-version: '3.3'
+          bundler: '4.0.23'
+          bundler-cache: false
+      - name: Install locked dependencies
+        run: bundle install
+      - name: Check release version and prepare the tested commit
+        run: |
+          git checkout -B release "$GITHUB_SHA"
+          version=$(bundle exec ruby -r ./lib/redis/objects/periodical/version -e 'puts Redis::Objects::Periodical::VERSION')
+          if git show-ref --verify --quiet "refs/tags/v$version"; then
+            echo "Tag v$version already exists. Inspect the previous release before retrying."
+            exit 1
+          fi
+          status=$(curl --silent --show-error --output /dev/null --write-out '%{http_code}' \
+            "https://rubygems.org/api/v2/rubygems/redis-objects-periodical/versions/$version.json")
+          if [ "$status" != 404 ]; then
+            echo "Expected an unpublished version (HTTP 404); received HTTP $status."
+            exit 1
+          fi
+      - name: Publish via RubyGems Trusted Publishing
+        uses: rubygems/release-gem@7f9650160c1a4e7989fdc9855807bdbd421d8b6b # v1.4.1

data/.github/workflows/rubocop_challenge.yml

@@ -0,0 +1,71 @@
+name: Rubocop Challenge
+
+on:
+  schedule:
+    - cron: '30 23 * * *' # 08:30 JST every day
+  workflow_dispatch:
+    inputs:
+      dry-run:
+        description: 'Check the challenge without pushing a branch or creating a PR'
+        type: boolean
+        default: true
+
+concurrency:
+  group: rubocop-challenge
+  cancel-in-progress: false
+
+permissions: {}
+
+jobs:
+  dry_run:
+    if: ${{ github.event_name == 'workflow_dispatch' && inputs.dry-run && github.ref == 'refs/heads/master' }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: ruby/setup-ruby@26e5b7d197ebf60545ee9667bcbace0be11ccaec # v1.334.0
+        with:
+          ruby-version: '3.3'
+          bundler: '4.0.23'
+          bundler-cache: false
+      - name: Install dependencies and Challenger
+        run: |
+          bundle install
+          gem install rubocop_challenger --no-document
+      - name: Run without remote writes
+        # PrComet checks for a token even when --no-create-pr skips remote writes.
+        env:
+          GITHUB_ACCESS_TOKEN: ${{ github.token }}
+        run: rubocop_challenger go --email=ryz310@gmail.com --name=ryz310 --no-create-pr
+
+  challenge:
+    if: >-
+      ${{ github.ref == 'refs/heads/master' &&
+          (github.event_name == 'schedule' || !inputs.dry-run) }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          # PrComet authenticates its push using GITHUB_ACCESS_TOKEN below.
+          persist-credentials: false
+      - uses: ruby/setup-ruby@26e5b7d197ebf60545ee9667bcbace0be11ccaec # v1.334.0
+        with:
+          ruby-version: '3.3'
+          bundler: '4.0.23'
+          bundler-cache: false
+      - name: Install dependencies and Challenger
+        run: |
+          bundle install
+          gem install rubocop_challenger --no-document
+      - name: Create challenge PR
+        env:
+          GITHUB_ACCESS_TOKEN: ${{ github.token }}
+        run: rubocop_challenger go --email=ryz310@gmail.com --name=ryz310

data/.rspec

@@ -1,3 +1,4 @@
 --format documentation
 --color
 --require spec_helper
+--exclude-pattern spec/integration/**/*_spec.rb

data/.rubocop.yml

@@ -5,7 +5,7 @@ require:
   - rubocop-rspec
 
 AllCops:
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.3
   NewCops: enable
 
 Layout/LineLength:

data/.rubocop_todo.yml

@@ -1,26 +1,26 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2023-02-08 23:31:05 UTC using RuboCop version 1.45.1.
+# on 2024-03-07 00:36:04 UTC using RuboCop version 1.62.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 12
+# Offense count: 13
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Exclude:
-    - "spec/**/*"
-    - "test/**/*"
-    - "lib/redis-objects-periodical.rb"
-    - "lib/redis/base_counter_object.rb"
-    - "lib/redis/base_hash_key_object.rb"
-    - "lib/redis/base_set_object.rb"
-    - "lib/redis/base_value_object.rb"
-    - "lib/redis/recurring_at_intervals.rb"
-    - "lib/redis/recurring_at_intervals/annual.rb"
-    - "lib/redis/recurring_at_intervals/daily.rb"
-    - "lib/redis/recurring_at_intervals/hourly.rb"
-    - "lib/redis/recurring_at_intervals/minutely.rb"
-    - "lib/redis/recurring_at_intervals/monthly.rb"
-    - "lib/redis/recurring_at_intervals/weekly.rb"
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/redis-objects-periodical.rb'
+    - 'lib/redis/base_counter_object.rb'
+    - 'lib/redis/base_hash_key_object.rb'
+    - 'lib/redis/base_set_object.rb'
+    - 'lib/redis/base_value_object.rb'
+    - 'lib/redis/recurring_at_intervals.rb'
+    - 'lib/redis/recurring_at_intervals/annual.rb'
+    - 'lib/redis/recurring_at_intervals/daily.rb'
+    - 'lib/redis/recurring_at_intervals/hourly.rb'
+    - 'lib/redis/recurring_at_intervals/minutely.rb'
+    - 'lib/redis/recurring_at_intervals/monthly.rb'
+    - 'lib/redis/recurring_at_intervals/weekly.rb'

data/AGENTS.md

@@ -0,0 +1,133 @@
+# AGENTS.md
+
+## Project and sources of truth
+
+- This Ruby gem extends `redis-objects` with counters, values, sets, and hashes
+  for six intervals: annual, monthly, weekly, daily, hourly, and minutely.
+- Read [README.md](README.md) for the public entry point, [docs/usage.md](docs/usage.md)
+  for detailed usage, and [CONTRIBUTING.md](CONTRIBUTING.md) for development commands.
+  Check implementation and specs before changing behavior.
+- When a repository's documentation and its existing code disagree, follow the
+  conventions used in the existing code, and in your final reply point out each
+  inconsistency you found between the documentation and the code.
+- Apply this default to descriptions of existing conventions. It does not
+  override explicit user requests, security or compatibility requirements,
+  configured test/lint checks, or an approved migration. If existing behavior
+  appears defective or intent is unclear, surface the decision rather than
+  treating the code as correct by definition.
+- Report inconsistencies encountered during the task with relevant file
+  references; this does not require a repository-wide audit. The precedence
+  sentence comes from [Xu and Wu (2026), section 4](https://arxiv.org/html/2610.30571v1#S4);
+  the scope and exceptions above are this repository's adaptation.
+- Entry point and generated classes: `lib/redis-objects-periodical.rb`,
+  `lib/redis/periodical_*.rb`, and `lib/redis/objects/periodical_*.rb`.
+- Shared date/range behavior: `lib/redis/recurring_at_intervals.rb`; key formats
+  and interval arithmetic: `lib/redis/recurring_at_intervals/`.
+- Type-specific reads, aggregation, and deletion: `lib/redis/base_*_object.rb`.
+- Behavior specs: `spec/lib/redis/`; Redis connection and cleanup:
+  [spec/spec_helper.rb](spec/spec_helper.rb).
+- Dependencies and packaging: [Gemfile](Gemfile),
+  [redis-objects-periodical.gemspec](redis-objects-periodical.gemspec), and
+  [Gemfile.lock](Gemfile.lock). CI lives in
+  [.github/workflows/](.github/workflows/). External cutover and rollback steps
+  are in [docs/maintaining.md](docs/maintaining.md#circleci-migration-checklist).
+
+## Task workflow
+
+- Check the checkout, branch, `git status`, and `git worktree list` first.
+  Preserve unrelated work and keep the task focused.
+- Start independent work from an up-to-date `master`: fetch `origin`, update
+  with a fast-forward only, re-read this file, and create `codex/<task-name>`
+  (`claude/<task-name>` for Claude Code). Continue an existing task on its branch.
+  Do not reset local changes or force a divergent branch to match the remote.
+- Explain scope and verification before substantial changes. Keep unrelated
+  cleanup, dependency upgrades, and support-policy changes separate.
+- At completion, report changes, verification results, and unverified items.
+  Propose a brief KPT retrospective when useful; keep it in the conversation
+  unless the user requests another destination. Propose durable guidance changes
+  based on findings rather than expanding this file for one-off workarounds.
+
+## Runtime and compatibility
+
+- Preserve the repository's declared Ruby minimum of 3.3 (`required_ruby_version`)
+  and `redis-objects ~> 1.0` dependency unless changing support is in scope.
+  The Docker development baseline and RuboCop target are Ruby 3.3; the configured
+  CI build matrix covers Ruby 3.3, 3.4, and 4.0. These describe this
+  repository's configuration, not upstream maintenance status.
+- This is a standalone gem. Rails/ActiveSupport is optional; preserve both
+  `Time.current` and plain Ruby `Time.now` behavior without adding a Rails runtime
+  dependency for convenience.
+- A support-policy change must align the gemspec, Dockerfile, Gemfile/lockfile,
+  RuboCop target, CI matrix/coverage reporting, README, and this guide.
+  Keep the Dockerfile's Bundler version compatible with Ruby and aligned with
+  the lockfile's `BUNDLED WITH` version.
+  Validate specs, lint, and gem build even if no `.rb` file changes.
+
+## Redis and development environment
+
+- Use the Compose `ruby` service for development and the `redis` service for
+  tests. Follow the setup and commands in [CONTRIBUTING.md](CONTRIBUTING.md#development).
+- Specs use real Redis at the hard-coded `redis:6379` address and call `flushdb`
+  after every example. Use only the disposable Redis belonging to this checkout;
+  never point that hostname at shared or production data. Do not assume setting
+  `REDIS_URL` redirects this test suite.
+- Compose does not publish Redis to a host port. For parallel checkouts, set a
+  distinct `COMPOSE_PROJECT_NAME` in each checkout's shell before any Compose
+  commands and keep it for setup, tests, and cleanup. Project names isolate the
+  Redis service, default network, and bundle volume; do not override them with
+  shared resource names or connect another project's Redis to the test network.
+  Use `docker compose exec redis redis-cli` for an interactive Redis client.
+- Use `bundle exec` for project tools. After dependency changes, rebuild the
+  image and run `bundle install` in the mounted service so the bundle volume
+  matches the lockfile. Avoid an unrelated `bundle update`.
+- Prefer `docker compose down` for cleanup. Volume deletion is unnecessary for
+  routine development. Do not invoke `rake release` as a validation command.
+
+## Validation and code review
+
+- For behavior changes, run focused specs first, then the full suite against
+  disposable Redis. Add regression coverage for the changed contract.
+- For shared interval/type changes, check affected combinations across all six
+  periods and four object types. Preserve persisted key formats, week/year
+  boundaries, time-zone selection, expiration options, range boundaries,
+  missing/empty values, aggregation, and standard `Redis::Objects` behavior
+  unless the requested change explicitly alters them.
+- Freeze or travel time with Timecop in specs; test boundaries deterministically
+  rather than sleeping. Existing cleanup restores Timecop after each example.
+- Run RuboCop for Ruby, gemspec, Gemfile, Rakefile, or lint configuration changes.
+  Use configured cops as the style authority; avoid mass autocorrection or
+  regenerating `.rubocop_todo.yml` to conceal new offenses.
+- Run `bundle exec rake build` through Compose for packaging/dependency changes;
+  use `bundle exec yardoc` for documentation-comment changes. The gemspec packages
+  Git-tracked files, so check the tracked file list when adding packaged sources.
+- For Markdown-only changes, check paths, commands, examples, and
+  `git diff --check`; application specs/lint are unnecessary unless the task also
+  requires validating the documented runtime procedure.
+- If validation is blocked, state the command and reason. Do not present static
+  checks or one local Ruby run as a successful CI compatibility matrix.
+- Validate workflow changes with actionlint and zizmor. Keep Actions SHA-pinned,
+  routine jobs read-only, and publishing free of restored dependency caches.
+
+## Documentation, pull requests, and releases
+
+- Keep the English `README.md` as the public entry point; detailed usage belongs
+  in `docs/usage.md`, contributor procedures in `CONTRIBUTING.md`, and maintainer
+  procedures in `docs/maintaining.md`. Do not create language-specific README
+  copies. Track unresolved work in GitHub Issues and keep agent workflow here.
+- When updating examples, check method names, arguments, key formats, return
+  values, and consistency with specs. Resolve references when renaming/removing
+  documentation.
+- Write PR titles and descriptions in English. Include `Purpose of this change`
+  and relevant verification results. Supply Markdown bodies through structured
+  tool arguments or a temporary file with `gh --body-file` to avoid shell
+  interpretation of backticks and other Markdown content.
+- Compile `CHANGELOG.md` at release time rather than editing it in every PR.
+  Follow existing release formatting and `-` bullets; categorize entries as
+  Feature, Bugfix, Security, Breaking Change, Rubocop Challenge, Dependabot, or
+  Misc as applicable, omitting empty sections. Reserve Breaking Change for
+  backward-incompatible behavior and combine repeated dependency bumps.
+- Releases require an explicit release task. The publisher uses the `release`
+  branch; pushing there or running `rake release` is not routine development.
+  Keep version changes, tags, and publishing within that scope. During migration,
+  stop the corresponding CircleCI writer before activating Actions publication
+  or scheduled writes; follow the maintainer guide cutover and rollback checklist.

data/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Change log
 
+## v0.8.0 (Oct 29, 2026)
+
+### Bugfix
+
+- [#264](https://github.com/ryz310/redis-objects-periodical/pull/264) Fix weekly keys for weeks spanning a year boundary across counters, values, sets, and hashes. ([@ashimomura](https://github.com/ashimomura))
+
+### Breaking Change
+
+- [#291](https://github.com/ryz310/redis-objects-periodical/pull/291) Require Ruby 3.3 or newer; drop Ruby 2.7, 3.0, 3.1, and 3.2 support and test Ruby 3.3, 3.4, and 4.0. Applications on older Ruby versions must upgrade Ruby or remain on a compatible gem release. ([@ryz310](https://github.com/ryz310))
+- [#264](https://github.com/ryz310/redis-objects-periodical/pull/264) Derive weekly keys from the Monday of the requested week. For example, January 1, 2022 now uses `2021W52` instead of `2022W00`. Existing January `W00` data is not migrated and affected accessors will select the preceding December key after upgrading. Assess retained weekly data and any application-specific migration before deployment. The keys still use `%Y`/`%W`, not ISO week-year numbering. ([@ashimomura](https://github.com/ashimomura))
+
+### Rubocop Challenge
+
+- [#192](https://github.com/ryz310/redis-objects-periodical/pull/192) Apply Layout/ExtraSpacing and Performance/StringIdentifierArgument corrections. ([@ryz310](https://github.com/ryz310))
+
+### Dependabot
+
+- [#288](https://github.com/ryz310/redis-objects-periodical/pull/288) Bump rubocop from 1.76.2 to 1.92.1 ([@ryz310](https://github.com/ryz310))
+- [#277](https://github.com/ryz310/redis-objects-periodical/pull/277) Bump rubocop-rspec from 3.6.0 to 3.10.2 ([@ryz310](https://github.com/ryz310))
+- [#281](https://github.com/ryz310/redis-objects-periodical/pull/281) Bump yard from 0.9.37 to 0.9.45 ([@ryz310](https://github.com/ryz310))
+- [#289](https://github.com/ryz310/redis-objects-periodical/pull/289) Bump rubocop-performance from 1.25.0 to 1.27.0 ([@ryz310](https://github.com/ryz310))
+- [#270](https://github.com/ryz310/redis-objects-periodical/pull/270) Bump timecop from 0.9.10 to 0.9.11 ([@ryz310](https://github.com/ryz310))
+- [#268](https://github.com/ryz310/redis-objects-periodical/pull/268) Bump rake from 13.3.0 to 13.4.2 ([@ryz310](https://github.com/ryz310))
+- [#273](https://github.com/ryz310/redis-objects-periodical/pull/273) Bump rspec from 3.13.1 to 3.13.2 ([@ryz310](https://github.com/ryz310))
+- [#286](https://github.com/ryz310/redis-objects-periodical/pull/286) Bump actions/checkout from 6.1.0 to 7.0.1 ([@ryz310](https://github.com/ryz310))
+- [#310](https://github.com/ryz310/redis-objects-periodical/pull/310) Bump rspec_junit_formatter from 0.6.2 to 0.8.0 ([@ryz310](https://github.com/ryz310))
+- [#311](https://github.com/ryz310/redis-objects-periodical/pull/311) Bump simplecov from 0.22.0 to 1.3.2 ([@ryz310](https://github.com/ryz310))
+- [#293](https://github.com/ryz310/redis-objects-periodical/pull/293) Bump dependabot/fetch-metadata from 3.0.0 to 3.1.0 ([@ryz310](https://github.com/ryz310))
+- [#294](https://github.com/ryz310/redis-objects-periodical/pull/294) Bump actions/github-script from 8.0.0 to 9.0.0 ([@ryz310](https://github.com/ryz310))
+
+### Misc
+
+- [#283](https://github.com/ryz310/redis-objects-periodical/pull/283) Restore CI while retiring unavailable Code Climate reporting. ([@ryz310](https://github.com/ryz310))
+- [#284](https://github.com/ryz310/redis-objects-periodical/pull/284) Migrate combined SimpleCov coverage reporting to Qlty. ([@ryz310](https://github.com/ryz310))
+- [#282](https://github.com/ryz310/redis-objects-periodical/pull/282) Add agent guidance and repair the Docker development setup. ([@ryz310](https://github.com/ryz310))
+- [#285](https://github.com/ryz310/redis-objects-periodical/pull/285) Migrate CI, release publishing, and scheduled maintenance from CircleCI to SHA-pinned GitHub Actions; document external cutover and rollback requirements. ([@ryz310](https://github.com/ryz310))
+- [#290](https://github.com/ryz310/redis-objects-periodical/pull/290) Add guarded Dependabot auto-merge and isolated ActiveSupport timezone verification; retain plain-Ruby coverage and optional ActiveSupport support. ([@ryz310](https://github.com/ryz310))
+- [#304](https://github.com/ryz310/redis-objects-periodical/pull/304) Reconcile workflow-owned auto-merge reservations on rejection and guard the clean-status merge fallback. ([@ryz310](https://github.com/ryz310))
+- [#305](https://github.com/ryz310/redis-objects-periodical/pull/305) Correct Actions ecosystem metadata matching for Dependabot policy. ([@ryz310](https://github.com/ryz310))
+- [#301](https://github.com/ryz310/redis-objects-periodical/pull/301) Allow isolated Compose projects to run concurrently without publishing the Redis host port. ([@ryz310](https://github.com/ryz310))
+- [#303](https://github.com/ryz310/redis-objects-periodical/pull/303) Pin development Redis to the immutable CI image digest. ([@ryz310](https://github.com/ryz310))
+- [#302](https://github.com/ryz310/redis-objects-periodical/pull/302) Fail timezone CI when expected integration examples are missing, duplicated, unexpected, or pending. ([@ryz310](https://github.com/ryz310))
+- [#306](https://github.com/ryz310/redis-objects-periodical/pull/306) Separate public usage, contributor, maintainer, and dated verification documentation. ([@ryz310](https://github.com/ryz310))
+- [#308](https://github.com/ryz310/redis-objects-periodical/pull/308) Remove the additional Dependabot auto-merge enable variable. ([@ryz310](https://github.com/ryz310))
+- [#309](https://github.com/ryz310/redis-objects-periodical/pull/309) Manage optional ActiveSupport dependencies across both lockfiles with Dependabot. ([@ryz310](https://github.com/ryz310))
+- [#313](https://github.com/ryz310/redis-objects-periodical/pull/313) Add a repository-local Dependabot batch-maintenance skill. ([@ryz310](https://github.com/ryz310))
+
 ## v0.7.0 (Feb 12, 2023)
 
 ### Feature