activejob-temporal 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bd1d95e1a889d180f79f3d2eeb2ec31d5c5b4338776cc41656b9077cbdd96da7
+  data.tar.gz: 66c78d747c740b51e0320ca131d480160ef37af78496cf77632c68bfc1b7915d
+SHA512:
+  metadata.gz: 2d87ef5a4b8a31de5990da5a9effd53bc7e9b1c4a59ad185d632a31d73b23c9b566358785ae5e469a3c96322b092b7b46b6387dd08d9b245d044da102690eafd
+  data.tar.gz: b51db2d419c9301934241e0bb4b308ea7b398ecf3ba964cc8f7c82e73d75dfbf829839e79d1a42347dfe539b3d2cf289a74dff1516299806b0874face1e13449

data/CHANGELOG.md

@@ -0,0 +1,130 @@
+# 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).
+
+## [Unreleased]
+
+<!-- github_changelog_generator:start -->
+
+**Implemented enhancements:**
+
+- TASK.014 - Signals and Queries support [\#14](https://github.com/schovi/activejob-temporal/issues/14)
+- TASK.050 - Add child workflows [\#61](https://github.com/schovi/activejob-temporal/issues/61)
+- TASK.017 - Worker pool management [\#17](https://github.com/schovi/activejob-temporal/issues/17)
+- TASK.035 - Add rate limiting support [\#22](https://github.com/schovi/activejob-temporal/issues/22)
+- TASK.022 - Add payload serialization options [\#19](https://github.com/schovi/activejob-temporal/issues/19)
+- TASK.056 - Immediate Ruby 4+ migration task [\#56](https://github.com/schovi/activejob-temporal/issues/56)
+- TASK.053 - Immediate Ruby 4+ migration follow-up [\#53](https://github.com/schovi/activejob-temporal/issues/53)
+- TASK.052 - Reconfirm Ruby 4+ migration baseline [\#52](https://github.com/schovi/activejob-temporal/issues/52)
+- TASK.051 - Enforce Ruby 4+ migration baseline [\#51](https://github.com/schovi/activejob-temporal/issues/51)
+- TASK.050 - Migrate repository to Ruby 4+ [\#50](https://github.com/schovi/activejob-temporal/issues/50)
+- TASK.043 - Add conditional enqueueing support [\#44](https://github.com/schovi/activejob-temporal/issues/44)
+- TASK.039 - Add health check endpoint for workers [\#42](https://github.com/schovi/activejob-temporal/issues/42)
+- TASK.023 - Add configuration validation levels [\#28](https://github.com/schovi/activejob-temporal/issues/28)
+- TASK.021 - Extract WorkflowIdBuilder class [\#27](https://github.com/schovi/activejob-temporal/issues/27)
+- TASK.019 - Replace method\_missing with explicit methods in Configuration [\#25](https://github.com/schovi/activejob-temporal/issues/25)
+- TASK.042 - Add job tagging for search [\#24](https://github.com/schovi/activejob-temporal/issues/24)
+- TASK.018 - Job prioritization via task queue routing [\#18](https://github.com/schovi/activejob-temporal/issues/18)
+- TASK.016 - Built-in metrics integration [\#16](https://github.com/schovi/activejob-temporal/issues/16)
+- TASK.015 - Recurring jobs via Temporal Schedules [\#15](https://github.com/schovi/activejob-temporal/issues/15)
+- TASK.011 - Middleware system for cross-cutting concerns [\#11](https://github.com/schovi/activejob-temporal/issues/11)
+- TASK.010 - Job status inspection API [\#10](https://github.com/schovi/activejob-temporal/issues/10)
+- TASK.009 - Batch cancellation API [\#9](https://github.com/schovi/activejob-temporal/issues/9)
+- TASK.008 - Add workflow ID customization hook [\#8](https://github.com/schovi/activejob-temporal/issues/8)
+- TASK.007 - Extract configuration to separate file [\#7](https://github.com/schovi/activejob-temporal/issues/7)
+- TASK.006 - Add payload size monitoring warnings [\#6](https://github.com/schovi/activejob-temporal/issues/6)
+
+**Fixed bugs:**
+
+- TASK.020 - Add RetryMapper fallback strategy for ActiveJob internals [\#26](https://github.com/schovi/activejob-temporal/issues/26)
+- TASK.001 - Add explicit concurrent-ruby dependency [\#1](https://github.com/schovi/activejob-temporal/issues/1)
+
+**Closed issues:**
+
+- TASK.040 - Add Prometheus metrics exporter [\#43](https://github.com/schovi/activejob-temporal/issues/43)
+- TASK.038 - Add systemd unit file example [\#41](https://github.com/schovi/activejob-temporal/issues/41)
+- TASK.037 - Add Docker example with compose [\#40](https://github.com/schovi/activejob-temporal/issues/40)
+- TASK.030 - Add performance benchmarks [\#36](https://github.com/schovi/activejob-temporal/issues/36)
+- TASK.026 - Add gem comparison guide \(vs Sidekiq, GoodJob, etc\) [\#31](https://github.com/schovi/activejob-temporal/issues/31)
+- TASK.025 - Add performance tuning guide [\#30](https://github.com/schovi/activejob-temporal/issues/30)
+- TASK.024 - Add troubleshooting guide [\#29](https://github.com/schovi/activejob-temporal/issues/29)
+- TASK.005 - Add retry policy documentation examples [\#5](https://github.com/schovi/activejob-temporal/issues/5)
+- TASK.003 - Move SimpleCov configuration to standard location [\#3](https://github.com/schovi/activejob-temporal/issues/3)
+- TASK.002 - Document algorithmic wait limitation in migration guide [\#2](https://github.com/schovi/activejob-temporal/issues/2)
+
+<!-- github_changelog_generator:end -->
+
+### Changed
+- Replace Prometheus-specific metrics configuration with optional observability adapters backed by Rails notifications.
+- Reconfirm Ruby 4.0+ as the active repository baseline for local tooling, CI, dependency setup, and validation.
+- Migrate the supported Ruby baseline and CI validation target to Ruby 4.0+.
+- Pin the repository Ruby version for local development and document Ruby 4.0.3 validation commands.
+- Support Temporal Ruby SDK 1.4.x for Ruby 4 compatibility, contract-tested against 1.4.0 and 1.4.1.
+- Extract configuration state management into a dedicated `Configurable` concern.
+- Extract deterministic workflow ID construction into `WorkflowIdBuilder`.
+- Move SimpleCov configuration to `.simplecov` with coverage groups.
+- Document algorithmic wait strategy limitations for retry migration.
+- Serialize global activity timeout defaults into workflow payloads so workflows do not read mutable process configuration during replay.
+
+### Fixed
+- Declare `concurrent-ruby` as an explicit runtime dependency.
+
+### Added
+- Optional Prometheus, OpenTelemetry, and Datadog observability adapters with trace context propagation through job payloads.
+- Signal/query APIs via `ActiveJob::Temporal.signal` and `ActiveJob::Temporal.query`, with built-in pause/resume workflow state and deterministic custom job handlers.
+- Child workflow orchestration via `set(child_workflows:)`, with parent-owned child workflow IDs, cancellation propagation, result collection, and chain handoff.
+- Global and per-job rate limiting with a pluggable limiter backend and durable workflow waits.
+- Supervised worker pools via `ActiveJob::Temporal::WorkerPool` and `temporal-worker --pool-size`.
+- Configurable payload serializer envelopes for MessagePack and Marshal while keeping JSON as the default wire format.
+- Changelog generation configuration and `rake changelog:generate` release task.
+- Structured audit logging for job enqueue, execution, failure, and cancellation lifecycle events.
+- Optional AES-256-GCM payload encryption with key rotation support for job execution payloads.
+- Codecov coverage badge and CI coverage uploads.
+- Configurable `workflow_id_generator` hook for custom Temporal workflow IDs.
+- Batch cancellation APIs via `ActiveJob::Temporal.cancel_all` and `ActiveJob::Temporal.cancel_where`.
+- Job status inspection APIs via `ActiveJob::Temporal.status` and status predicates.
+- Conditional enqueueing via `perform_later_if` for callable or class-method conditions.
+- Optional worker health check endpoint via `temporal-worker --health-check-port PORT`.
+- Priority-based task queue routing via `config.priority_task_queues`.
+- Optional Prometheus metrics adapter and worker scrape endpoint via `temporal-worker --metrics-port PORT`.
+- Configuration validation levels via `validation_level` for strict, warning-only, or skipped validation.
+- Custom job search tags via `set(tags:)` and the `ajTags` Temporal search attribute.
+- Recurring job declarations and explicit Temporal Schedule registration via `schedule` and `create_temporal_schedule`.
+- Systemd worker deployment examples for VM and bare-metal hosts.
+- Docker Compose example configuration for the basic Rails app.
+- Structured payload size logs at 80%, 90%, and over-limit thresholds.
+- Retry policy guide with ActiveJob-to-Temporal mapping examples.
+- Per-job timeout configuration via `temporal_options` class method
+  - Support for `start_to_close_timeout`, `heartbeat_timeout`, `schedule_to_start_timeout`, and `schedule_to_close_timeout`
+  - Timeout values accept both integers (seconds) and `ActiveSupport::Duration` objects (e.g., `2.hours`, `30.seconds`)
+  - Per-job timeouts override global configuration defaults
+- Global timeout configuration options:
+  - `default_heartbeat_timeout` for long-running activities with heartbeat monitoring
+  - `default_schedule_to_start_timeout` to control max wait before activity starts
+  - `default_schedule_to_close_timeout` for total time including all retries
+- Comprehensive test coverage for timeout configuration (17 new unit tests, 3 integration tests)
+
+## [0.1.0] - 2025-10-29
+
+### Added
+- ActiveJob adapter backed by Temporal workflows as a drop-in replacement for existing adapters
+- Immediate job execution via `perform_later`
+- Scheduled job execution with `set(wait:)` and `set(wait_until:)`
+- Automatic retry policy mapping from `retry_on` declarations with exponential backoff
+- Automatic discard policy handling from `discard_on` declarations
+- Job cancellation API via `ActiveJob::Temporal.cancel(JobClass, job_id)`
+- Search attributes for filtering and debugging jobs in Temporal UI (job class, queue, job ID, tenant ID, enqueue timestamp)
+- Transactional enqueue support with automatic deferral until database transaction commits
+- GlobalID serialization support for ActiveRecord models and other GlobalID-compatible objects
+- Configurable activity timeouts and retry policies (global and per-job)
+- Temporal worker executable (`bin/temporal-worker`) for running workers
+- Structured JSON logging for observability integration
+- Comprehensive documentation including README, API documentation (YARD), migration guide, and example Rails application
+
+### Security
+- Payload size limit of 250KB enforced to prevent denial-of-service attacks from oversized job payloads
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Temporal Technologies, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,198 @@
+# activejob-temporal
+
+> Temporal-powered adapter for Rails ActiveJob.
+
+[![Gem Version](https://badge.fury.io/rb/activejob-temporal.svg)](https://badge.fury.io/rb/activejob-temporal)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/schovi/activejob-temporal/actions/workflows/ci.yml/badge.svg)](https://github.com/schovi/activejob-temporal/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/schovi/activejob-temporal/branch/main/graph/badge.svg)](https://codecov.io/gh/schovi/activejob-temporal)
+
+This gem is under active development. Expect breaking changes until v1.0.0.
+
+## What It Does
+
+`activejob-temporal` runs Rails ActiveJob work through [Temporal](https://temporal.io) workflows and activities. It is intended for jobs where durable execution, crash recovery, long-running retries, cancellation visibility, and Temporal UI history matter more than queue simplicity.
+
+Use a traditional ActiveJob backend when the work is short, simple, and does not justify operating Temporal.
+
+## Requirements
+
+- Ruby >= 4.0
+- Rails 8.1 through ActiveJob 8.1
+- Temporal cluster, either self-hosted or [Temporal Cloud](https://temporal.io/cloud)
+
+CI validates Ruby 4.0.0 and the latest Ruby 4.0 patch against Rails 8.1.
+Temporal Ruby SDK 1.4.x compatibility is contract-tested against 1.4.0 and the latest 1.4.x release.
+
+## Install
+
+```ruby
+gem "activejob-temporal"
+```
+
+```bash
+bundle install
+```
+
+Then configure ActiveJob:
+
+```ruby
+# config/application.rb or config/environments/production.rb
+config.active_job.queue_adapter = :temporal
+```
+
+## Quick Start
+
+Create a Temporal initializer:
+
+```ruby
+# config/initializers/activejob_temporal.rb
+ActiveJob::Temporal.configure do |config|
+  config.target = ENV.fetch("ACTIVEJOB_TEMPORAL_TARGET", "127.0.0.1:7233")
+  config.namespace = ENV.fetch("ACTIVEJOB_TEMPORAL_NAMESPACE", "default")
+  config.task_queue_prefix = ENV.fetch("ACTIVEJOB_TEMPORAL_TASK_QUEUE_PREFIX", nil)
+
+  config.default_activity_timeout = 15.minutes
+  config.default_retry_initial_interval = 30.seconds
+  config.default_retry_backoff = 2.0
+  config.default_retry_max_attempts = 1
+end
+```
+
+Register the built-in search attributes once per Temporal cluster:
+
+```bash
+tctl admin cluster add-search-attributes \
+  --name ajClass --type Keyword \
+  --name ajQueue --type Keyword \
+  --name ajJobId --type Keyword \
+  --name ajEnqueuedAt --type Datetime \
+  --name ajTenantId --type Int \
+  --name ajTags --type KeywordList
+```
+
+Temporal Cloud deployments may use the `temporal` CLI instead of `tctl`; keep the same attribute names and types.
+
+Define and enqueue normal ActiveJob jobs:
+
+```ruby
+class SendInvoiceJob < ApplicationJob
+  queue_as :billing
+
+  retry_on SomeTransientError, wait: 60.seconds, attempts: 5
+  discard_on SomeFatalError
+
+  def perform(invoice_id)
+    invoice = Invoice.find(invoice_id)
+    InvoiceMailer.invoice_ready(invoice).deliver_now
+  end
+end
+
+SendInvoiceJob.perform_later(invoice.id)
+SendInvoiceJob.set(wait: 5.minutes).perform_later(invoice.id)
+SendInvoiceJob.set(tags: [:urgent, :customer_123]).perform_later(invoice.id)
+```
+
+Start a worker for every task queue you use:
+
+```bash
+ACTIVEJOB_TEMPORAL_TARGET=localhost:7233 \
+ACTIVEJOB_TEMPORAL_NAMESPACE=default \
+ACTIVEJOB_TEMPORAL_TASK_QUEUE=billing \
+bundle exec temporal-worker
+```
+
+Open Temporal UI and look for workflows named `ajwf:SendInvoiceJob:<job_id>`.
+
+## Common Capabilities
+
+| Need | API | Detailed guide |
+| --- | --- | --- |
+| Delay a single job | `MyJob.set(wait: 5.minutes).perform_later(...)` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#scheduled-jobs) |
+| Register recurring cron work | `schedule cron: "0 2 * * *"` and `create_temporal_schedule` | [Recurring Jobs](https://github.com/schovi/activejob-temporal/blob/main/docs/recurring_jobs.md) |
+| Enqueue only when work exists | `perform_later_if(condition, *args)` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#conditional-enqueueing) |
+| Enqueue many prepared jobs | `ActiveJob::Temporal.enqueue_batch(jobs)` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#bulk-enqueueing) |
+| Run sequential jobs in one workflow | `set(chain: [NextJob])` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#job-chaining) |
+| Start child ActiveJob workflows | `set(child_workflows: [ChildJob])` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#child-workflows) |
+| Call external Temporal activities or workflows | `ActiveJob::Temporal.activity(...)`, `ActiveJob::Temporal.workflow(...)` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#external-temporal-steps) |
+| Wait for separately enqueued jobs | `set(depends_on: parent_job)` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#job-dependencies) |
+| Map ActiveJob retries to Temporal | `retry_on`, `discard_on` | [Retry Policy Guide](https://github.com/schovi/activejob-temporal/blob/main/docs/retry_policies.md) |
+| Park exhausted failures | `config.dead_letter_queue = "failed_jobs"` | [Configuration Reference](https://github.com/schovi/activejob-temporal/blob/main/docs/configuration_reference.md#dead-letter-queue) |
+| Tune activity timeouts | `temporal_options start_to_close_timeout: ...` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#per-job-timeouts) |
+| Add throughput limits | `rate_limit 100, per: :second` | [Configuration Reference](https://github.com/schovi/activejob-temporal/blob/main/docs/configuration_reference.md#rate-limit-configuration) |
+| Cancel or inspect jobs | `cancel`, `cancel_all`, `status`, `running?` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#cancellation-and-status) |
+| Pause, resume, query, or update workflow state | `signal`, `query`, `update` | [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md#signals-queries-and-updates) |
+| Add runtime middleware | `config.add_middleware MiddlewareClass` | [Middleware](https://github.com/schovi/activejob-temporal/blob/main/docs/middleware.md) |
+| Expose Prometheus metrics | `config.observability.use :prometheus` | [Metrics Guide](https://github.com/schovi/activejob-temporal/blob/main/docs/metrics.md) |
+| Encrypt job payloads | `encrypt_payload = true` | [Configuration Reference](https://github.com/schovi/activejob-temporal/blob/main/docs/configuration_reference.md#payload-encryption) |
+| Store large payloads externally | `payload_storage_adapter = MyPayloadStorage.new` | [Configuration Reference](https://github.com/schovi/activejob-temporal/blob/main/docs/configuration_reference.md#payload-size-limits) |
+
+Baseline behavior also includes transaction-aware enqueueing through ActiveJob, GlobalID-compatible argument serialization, structured JSON logs, searchable `set(tags:)` metadata, and JSON payloads with opt-in MessagePack or Marshal envelopes.
+
+## Configuration
+
+The full configuration surface lives in [Configuration Reference](https://github.com/schovi/activejob-temporal/blob/main/docs/configuration_reference.md). The machine-readable schema is [docs/config_schema.yaml](https://github.com/schovi/activejob-temporal/blob/main/docs/config_schema.yaml).
+
+The most common settings are:
+
+```ruby
+ActiveJob::Temporal.configure do |config|
+  config.target = "temporal.example.com:7233"
+  config.namespace = "production"
+  config.task_queue_prefix = "rails-"
+  config.priority_task_queues = { 10 => "high_priority", 90 => "low_priority" }
+  config.default_activity_timeout = 30.seconds
+  config.default_retry_initial_interval = 10.seconds
+  config.default_retry_backoff = 1.5
+  config.default_retry_max_attempts = 5
+end
+```
+
+Workers can also read environment variables such as `ACTIVEJOB_TEMPORAL_TARGET`, `ACTIVEJOB_TEMPORAL_NAMESPACE`, `ACTIVEJOB_TEMPORAL_TASK_QUEUE`, `ACTIVEJOB_TEMPORAL_MAX_CONCURRENT_ACTIVITIES`, `ACTIVEJOB_TEMPORAL_METRICS_PORT`, and TLS certificate settings. See [Worker Setup](https://github.com/schovi/activejob-temporal/blob/main/docs/worker_setup.md) for the worker-focused list.
+
+## Documentation
+
+Start with [docs/README.md](https://github.com/schovi/activejob-temporal/blob/main/docs/README.md) for the complete documentation map.
+
+High-use guides:
+
+- [Usage Patterns](https://github.com/schovi/activejob-temporal/blob/main/docs/usage_patterns.md)
+- [Configuration Reference](https://github.com/schovi/activejob-temporal/blob/main/docs/configuration_reference.md)
+- [Worker Setup](https://github.com/schovi/activejob-temporal/blob/main/docs/worker_setup.md)
+- [Troubleshooting](https://github.com/schovi/activejob-temporal/blob/main/docs/troubleshooting.md)
+- [Performance Tuning](https://github.com/schovi/activejob-temporal/blob/main/docs/performance_tuning.md)
+- [Comparison Guide](https://github.com/schovi/activejob-temporal/blob/main/docs/comparison.md)
+- [Security](https://github.com/schovi/activejob-temporal/blob/main/docs/security.md)
+
+See [examples/basic_rails_app](https://github.com/schovi/activejob-temporal/tree/main/examples/basic_rails_app) for a Docker Compose Rails app with Temporal, Temporal UI, search attribute setup, workers, seeded GlobalID records, and tests.
+
+## Contributing
+
+Install dependencies and run the focused local checks:
+
+```bash
+rvm 4.0.3 do bundle install
+rvm 4.0.3 do bundle exec rake spec:unit
+rvm 4.0.3 do bundle exec rubocop
+rvm 4.0.3 do bundle exec rake build
+```
+
+For changes near configured mutation subjects, also run:
+
+```bash
+rvm 4.0.3 do bundle exec rake mutation
+```
+
+Keep docs updated when behavior changes. The scoped mutation task runs on Ruby 4. Mutant 0.16 may warn about an older parser dependency; keep using the Ruby 4 toolchain and treat parser failures on new Ruby syntax as a mutation tooling limitation.
+
+Bug reports and feature requests belong in [GitHub issues](https://github.com/schovi/activejob-temporal/issues).
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Versioning
+
+This project follows [Semantic Versioning](https://semver.org/). See [CHANGELOG](CHANGELOG.md) for release history.
+
+Current development version: 0.1.0. Release commits must be tagged before publishing to RubyGems.

data/activejob-temporal.gemspec

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative "lib/activejob/temporal/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "activejob-temporal"
+  spec.version = ActiveJob::Temporal::VERSION
+  spec.authors = ["Temporal Technologies", "Ruby Community"]
+  spec.email = ["ruby@temporal.io"]
+
+  spec.summary = "Rails ActiveJob adapter backed by Temporal Workflows"
+  spec.description = <<~DESC
+    activejob-temporal bridges Rails ActiveJob with Temporal's durable execution engine.
+    It provides a drop-in ActiveJob adapter, Temporal workflows, and supporting tooling
+    so Rails apps gain fault-tolerant scheduling, retries, and observability with minimal changes.
+  DESC
+  spec.homepage = "https://github.com/schovi/activejob-temporal"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 4.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "#{spec.homepage}/tree/main"
+  spec.metadata["documentation_uri"] = "#{spec.homepage}/blob/main/docs/README.md"
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.start_with?("spec/", "docs/", "examples/", "tmp/", "tools/", "gemfiles/", ".codemachine/", ".github/") ||
+        f == "CLAUDE.md" ||
+        f == "CONTRIBUTING.md" ||
+        f.match?(%r{^(\.|docker-compose\.yml|coverage/|Gemfile|Rakefile)})
+    end
+  end
+  spec.bindir = "bin"
+  spec.executables = ["temporal-worker"]
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activejob", ">= 8.1", "< 9"
+  spec.add_dependency "activemodel", ">= 8.1", "< 9"
+  spec.add_dependency "concurrent-ruby", "~> 1.1"
+  spec.add_dependency "globalid", ">= 0.3"
+  spec.add_dependency "listen", "~> 3.9"
+  spec.add_dependency "temporalio", ">= 1.4.0", "< 1.5"
+
+  spec.add_development_dependency "benchmark-ips", "~> 2.14"
+  spec.add_development_dependency "bundler-audit", "~> 0.9"
+  spec.add_development_dependency "github_changelog_generator", "~> 1.18"
+  spec.add_development_dependency "msgpack", "~> 1.8"
+  spec.add_development_dependency "mutant-rspec", "~> 0.16"
+  spec.add_development_dependency "prometheus-client", "~> 4.2"
+  spec.add_development_dependency "rake", "~> 13.2"
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "rubocop", "~> 1.50"
+  spec.add_development_dependency "simplecov", "~> 0.22"
+  spec.add_development_dependency "simplecov-lcov", "~> 0.9"
+  spec.add_development_dependency "yard", "~> 0.9", ">= 0.9.42"
+end