wayfarer 0.4.10 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39fd7cefe2a4a7e07e2c3f69c0d13f96603e983432c56616444407a04af55442
-  data.tar.gz: 465b842759a03128413d66ff59b5116f0f7d444b193ad0929ed3a3914f55d5ad
+  metadata.gz: 775539013b38816a1cc15583b6416cd596a28ce72866cdbc624c2b045b4ca740
+  data.tar.gz: '001657096ad53a1c860bc261a80efd3204fc6683f44093fb30a8d51d4937aea6'
 SHA512:
-  metadata.gz: 21111b9d58ab7d0286f2f0a8c575485f0553cc4ddb8f19ebcad9f82f67e70dd53290832de6a4da137839a22151f0d06a47b0c606bc139b1491c5ce3d2accf188
-  data.tar.gz: '049cc40ee6973ecc66ce921d1ca8bf746ae9066ef88ebe3a364a0b859d125d9857daba149dfffd0b630f9addf88d2330ca3f9de5e57dab521d1dc2908a1d5cde'
+  metadata.gz: fc734cccedfc842f528b71adc961c01d2d104af58556b508bbd98ed80c635dff6385765b14223e765e6d40ab7c273c807b42cd9cfe44fbcb1e670a325319d53c
+  data.tar.gz: b4916f7291ec3cf62935cf69cc078fbe259f1b5dc5c8c877b8256b660f19d93515a76289157dff147df1f0725a4e95c457e38bef3a048adae1cda02ac5a0d34f

data/.env

@@ -1,17 +1,17 @@
 CI=true
 WAYFARER_PORT=9876
 
-REDIS_IMAGE=redis
-REDIS_VERSION=latest
+# redis:8-alpine
+REDIS_IMAGE=redis@sha256:8096655e437712b07503796fb64d81359256cfcff0ab29d95a7da72863786efb
 
-CHROME_IMAGE=browserless/chrome
-CHROME_VERSION=latest
+# browserless/chrome:1.61.1-chrome-stable
+CHROME_IMAGE=browserless/chrome@sha256:efac47cfff3830d9a50b27d29f8bbb61949058ae336c823fbe9bd3c0d1debcc8
 CHROME_PORT=3000
 
-FIREFOX_IMAGE=selenium/standalone-firefox
-FIREFOX_VERSION=latest
+# selenium/standalone-firefox:4.46.0
+FIREFOX_IMAGE=selenium/standalone-firefox@sha256:68754beb3956735905fe9a49004d71c3e1de7b410885151fd8f139618e9537dc
 FIREFOX_PORT=4444
 
-DOCS_IMAGE=squidfunk/mkdocs-material
-DOCS_VERSION=latest
+# squidfunk/mkdocs-material:9.7.7
+DOCS_IMAGE=squidfunk/mkdocs-material@sha256:51b87149d227691486b5f08993d28c65ca7e4990010664b697265b8e6fcd5287
 DOCS_PORT=8000

data/.github/CODEOWNERS

@@ -0,0 +1 @@
+/terraform/ @bauerd

data/.github/actions/setup-mise/action.yaml

@@ -0,0 +1,22 @@
+name: Setup mise
+description: Installs mise and tools
+runs:
+  using: composite
+  steps:
+    - name: Install mise
+      shell: bash
+      run: |
+        sudo apt update -y && sudo apt install -y curl
+        sudo install -dm 755 /etc/apt/keyrings
+        curl -fSs https://mise.jdx.dev/gpg-key.pub | sudo tee /etc/apt/keyrings/mise-archive-keyring.asc 1> /dev/null
+        echo "deb [signed-by=/etc/apt/keyrings/mise-archive-keyring.asc] https://mise.jdx.dev/deb stable main" | sudo tee /etc/apt/sources.list.d/mise.list
+        sudo apt update -y
+        sudo apt install -y mise
+
+    - name: Add mise shims to PATH
+      shell: bash
+      run: echo "$HOME/.local/share/mise/shims" >> $GITHUB_PATH
+
+    - name: Install tools
+      shell: bash
+      run: mise install -y

data/.github/workflows/push.yaml

@@ -0,0 +1,102 @@
+name: Push
+
+on:
+  push:
+    branches:
+      - '*'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+
+      - name: Start services
+        run: docker compose up -d wayfarer
+
+      - name: RuboCop
+        run: docker compose run --rm --name test wayfarer bundle exec rake lint:rubocop
+
+      - name: Verify RubyGem platforms
+        if: success() || failure()
+        run: docker compose run --rm wayfarer bundle exec rake lint:platforms
+
+      - name: Setup mise
+        if: success() || failure()
+        uses: ./.github/actions/setup-mise
+
+      - name: Vale
+        if: success() || failure()
+        env:
+          VALE_STYLES_PATH: /tmp/value
+        run: |
+          vale sync
+          vale --glob="*.md" $(git diff --name-only origin/${{ github.base_ref }}...HEAD)
+
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+
+      - name: Set up Docker Compose
+        run: docker compose up -d
+
+      - name: Run tests
+        run: docker compose exec -T -e CI=$CI wayfarer bundle exec rake test
+
+      - name: Verify gem version
+        run: docker compose exec -T -e CI=true wayfarer bundle exec rake release:guard_versions
+
+  check-links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+
+      - name: Setup mise
+        uses: ./.github/actions/setup-mise
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Build site (Strict)
+        run: python -m mkdocs build --strict
+
+      - name: Upload artifact
+        if: github.ref_name == github.event.repository.default_branch
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa  # v3.0.1
+        with:
+          path: 'site'
+
+  secret-scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+        with:
+          fetch-depth: 0
+
+      - name: Setup mise
+        uses: ./.github/actions/setup-mise
+
+      - name: gitleaks
+        run: gitleaks detect --source . --redact --no-banner
+
+  deploy-docs:
+    needs: check-links
+    if: github.ref_name == github.event.repository.default_branch
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e  # v4.0.5

data/.github/workflows/release.yaml

@@ -4,10 +4,10 @@ on: workflow_dispatch
 
 jobs:
   release:
-    if: github.ref_name == 'master' || github.ref_name == 'develop'
+    if: github.ref_name == 'master'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
 
       - run: docker compose up -d
 

data/.github/workflows/terraform.yaml

@@ -0,0 +1,78 @@
+name: Terraform
+
+on:
+  push:
+    paths:
+      - 'terraform/**'
+      - 'mise.toml'
+      - '.github/workflows/terraform.yaml'
+      - '.github/actions/setup-mise/**'
+
+jobs:
+  lint-terraform:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+
+      - name: Setup mise
+        uses: ./.github/actions/setup-mise
+
+      - name: terraform fmt
+        run: terraform -chdir=terraform fmt -check -recursive -diff
+
+      - name: terraform init
+        if: success() || failure()
+        run: terraform -chdir=terraform init -backend=false -input=false
+
+      - name: terraform validate
+        if: success() || failure()
+        run: terraform -chdir=terraform validate
+
+      - name: checkov
+        if: success() || failure()
+        run: checkov --directory terraform --framework terraform --quiet --compact --skip-download --skip-check CKV_GIT_3
+
+  terraform-plan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+
+      - name: Setup mise
+        uses: ./.github/actions/setup-mise
+
+      - name: terraform init
+        run: terraform -chdir=terraform init -input=false
+
+      - name: terraform plan
+        env:
+          GITHUB_TOKEN: ${{ secrets.TF_GITHUB_TOKEN }}
+        run: terraform -chdir=terraform plan -input=false -no-color
+
+  terraform-apply:
+    needs: [lint-terraform, terraform-plan]
+    if: github.ref_name == github.event.repository.default_branch
+    runs-on: ubuntu-latest
+    environment: terraform-apply
+    concurrency:
+      group: terraform-apply
+      cancel-in-progress: false
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+        with:
+          token: ${{ secrets.TF_APPLY_TOKEN }}
+
+      - name: Setup mise
+        uses: ./.github/actions/setup-mise
+
+      - name: terraform init
+        run: terraform -chdir=terraform init -input=false
+
+      - name: terraform apply
+        env:
+          GITHUB_TOKEN: ${{ secrets.TF_APPLY_TOKEN }}
+        run: terraform -chdir=terraform apply -auto-approve -input=false -no-color
+
+      - name: commit updated state
+        run: rake -f rake/terraform.rake terraform:commit_state

data/.gitignore

@@ -9,3 +9,4 @@ yard
 .tool-versions
 *.tar.gz
 styles
+.opencode

data/AGENTS.md

@@ -0,0 +1,291 @@
+# Wayfarer -- AI Assistant Guide
+
+## Project Overview
+
+Wayfarer is a Ruby gem (v0.5.1) for versatile web crawling, built on top of **ActiveJob**. It provides a middleware-based pipeline for fetching, parsing, deduplicating, and routing web pages, with support for plain HTTP, headless Chrome (Ferrum/Capybara), and Selenium browser automation.
+
+- **Gem name:** `wayfarer`
+- **Ruby version:** 3.4.4 (enforced via `mise.toml`)
+- **License:** MIT
+
+---
+
+## Technology Stack
+
+| Layer | Technology |
+|---|---|
+| Language | Ruby 3.4.4 |
+| Job framework | ActiveJob 7.1+ |
+| Deduplication/state | Redis 5.4+ |
+| Plain HTTP | net-http-persistent 4.0+ |
+| Headless Chrome (CDP) | Ferrum 0.17+ |
+| Browser (Selenium) | selenium-webdriver 4.35+ |
+| Browser wrapper | Capybara 3.4+ |
+| HTML/XML parsing | Nokogiri 1.18+ |
+| Meta-tag parsing | MetaInspector 5.16+ |
+| URL routing/matching | Mustermann 3.0+ |
+| URL normalization | Addressable 2.8+ |
+| Autoloading | Zeitwerk 2.7+ |
+| CLI | Thor 1.0+ |
+| Connection pooling | connection_pool 2.5+ |
+| Testing | RSpec 3.13+ |
+| Linting | RuboCop 1.80+ |
+| Documentation | MkDocs (Material theme) + YARD |
+
+---
+
+## Development Workflow
+
+### Initial Setup
+
+```bash
+mise install    # Install Ruby 3.4.4, Python 3.13, vale
+bundle install
+```
+
+### Docker (recommended for CI-equivalent runs)
+
+```bash
+docker compose up -d
+docker compose exec -T -e CI=true wayfarer bundle exec rake test
+docker compose run --rm wayfarer bundle exec rake lint:rubocop
+```
+
+### Interactive Console
+
+```bash
+bundle exec rake console   # Pry REPL with wayfarer loaded
+```
+
+---
+
+## Running Tests
+
+Tests use **RSpec** with tag-based filtering. Always run via Rake, not `rspec` directly.
+
+```bash
+bundle exec rake test             # All tests
+bundle exec rake test:isolated    # No browser/Redis -- fastest
+bundle exec rake test:integration # Redis + CLI
+bundle exec rake test:selenium    # Selenium browser
+bundle exec rake test:ferrum      # Ferrum (Chrome CDP)
+bundle exec rake test:cli         # CLI tests
+```
+
+**RSpec tags:** `:selenium`, `:ferrum`, `:cli`, `:redis`. Untagged tests run in `test:isolated`.
+
+A Sinatra test server starts automatically on port 9876 before the suite. FactoryBot factories are in `spec/factories/`. The shared context `"with Redis"` is auto-included for `:redis`-tagged examples.
+
+---
+
+## Linting
+
+```bash
+bundle exec rake lint:rubocop
+```
+
+Key RuboCop settings: 120-char line limit, double-quoted strings, outdented access modifiers, max 20-line methods, AbcSize <= 30, RSpec max 5 expectations/example and max 5 nested groups.
+
+---
+
+## Common Ruby Patterns
+
+### ActiveSupport::Concern for Mixins
+
+The codebase uses `extend ActiveSupport::Concern` throughout to structure reusable modules with `included` and `class_methods` blocks. The `included` block runs on inclusion; `class_methods` defines class-level behavior without verbose `def self.included` boilerplate.
+
+```ruby
+module Base
+  extend ActiveSupport::Concern
+
+  included do
+    include Wayfarer::Middleware::Controller
+    use Wayfarer::Middleware::Redis
+    use Wayfarer::Middleware::UriParser
+    # ...
+  end
+
+  class_methods do
+    def crawl(url, batch: SecureRandom.uuid)
+      Task.new(url, batch).tap { |task| perform_later(task) }
+    end
+  end
+end
+```
+
+### Middleware Chain via Recursive Lambda
+
+`Middleware::Chain` composes middleware as a recursive lambda. Each middleware receives a block representing the rest of the chain, and calls `yield` to continue or returns early to halt.
+
+```ruby
+def call(task)
+  traverse = lambda do |i|
+    if middlewares[i]
+      middlewares[i].call(task) { traverse.call(i + 1) }
+    elsif block_given?
+      yield
+    end
+  end
+  traverse.call(0)
+end
+```
+
+### Strategy Pattern via Module Inclusion
+
+`Networking::Strategy` defines the abstract interface (raising `NotImplementedError`) and shared helpers (`success`, `redirect`). Concrete agents (`HTTP`, `Ferrum`, `Selenium`, `Capybara`) include the mixin and override the required methods.
+
+```ruby
+module Strategy
+  extend ActiveSupport::Concern
+
+  def fetch(instance, url) = navigate(instance, url).then { live(instance) }
+  def navigate(_instance, _url) = raise NotImplementedError
+  def create = raise NotImplementedError
+  def destroy(_instance); end
+
+private
+  def success(...) = Networking::Result::Success.new(Page.new(...))
+  def redirect(...) = Networking::Result::Redirect.new(...)
+end
+```
+
+### Fluent Routing DSL
+
+`Routing::DSL` provides chainable builder methods. Each method calls `child_route`, which creates a child `Route` and appends it to `children`. Inline keyword arguments and blocks are both supported, enabling two equivalent syntaxes:
+
+```ruby
+# Inline
+route.host("example.com", path: "/articles/:id", to: :article)
+
+# Block
+route.host("example.com") do
+  path "/articles/:id", to: :article
+end
+```
+
+The method signature uses `**` and `&` forwarding to keep DSL methods concise. Last `.to()` call wins when routes conflict.
+
+### Visitor Pattern for Tree Traversal
+
+Routes form a tree searched depth-first by `Routing::PathFinder`. Routes call `accept(visitor)`, which calls `enter`, `visit`, and `leave` on the visitor. This separates traversal logic from matching logic while allowing the visitor to accumulate mutable state (params, matched actions).
+
+```ruby
+# In Route
+def accept(visitor)
+  visitor.enter(self)
+  return visitor.leave unless visitor.visit(self)
+  children.each { |child| child.accept(visitor) }
+  visitor.leave
+end
+```
+
+### Dynamic Method Generation via Module Subclasses
+
+`Logging.emit` returns an anonymous `Module` subclass whose `included` hook uses `define_method` to inject a `log` method. This lets each middleware declare its log messages declaratively at the class level.
+
+```ruby
+class Router
+  include Wayfarer::Logging.emit(
+    mismatch: [:info,  "No matching route"],
+    match:    [:info,  "Routing to %<action>s"],
+  )
+end
+```
+
+### Singleton + Connection Pooling
+
+`Networking::Pool` is a `Singleton` wrapping `ConnectionPool`. Cleanup is registered via `at_exit`. A `class_attribute :finalizer` lambda allows customizing shutdown behavior without subclassing. `ConnectionPool::TimeoutError` is wrapped into the gem's own error class at the boundary.
+
+### Configuration Syntax
+
+Use bracket syntax `Wayfarer.config[:key][:subkey]` instead of `dig` for predictable configuration access.
+
+### Value Objects with Declarative Stringify
+
+Value objects (`Task`, `Page`) include lightweight mixins like `Stringify` and `KV`. `stringify :url, :batch` registers which attributes appear in `#to_s`/`#inspect`. Custom `ActiveJob::Serializers::ObjectSerializer` subclasses handle serialization to/from JSON.
+
+### Inline Error Classes
+
+Lightweight custom errors are defined inline at module scope:
+
+```ruby
+UserAgentTimeoutError = Class.new(StandardError)
+```
+
+Rescue lists are built dynamically from configuration:
+
+```ruby
+rescue *strategy.class.renew_on, *Wayfarer.config[:network][:renew_on] => e
+  renew
+end
+```
+
+---
+
+## Documentation
+
+### Writing Style
+
+Documentation in `docs/` must strictly mimic the voice, tone, and typography of existing guides. Key rules:
+
+- **Address the reader directly** using second person ("you can", "use the")
+- **Use contractions** ("isn't", "doesn't", "it's") -- Vale enforces `Google.Contractions`
+- **Prefer active voice** over passive voice ("the graph compiles" not "the chain is compiled")
+- **Use ASCII characters** -- write `word--word` not Unicode em dashes. Avoid Unicode dashes, quotes, and other non-ASCII punctuation unless explicitly required.
+- **Headings use sentence-style capitalization** -- `## Adding middleware` not `## Adding Middleware`
+- **Keep paragraphs short** -- one concept per paragraph, 2-3 sentences max
+- **Code references use backticks** -- `` `use` ``, `` `dependency_graph.remove` ``
+- **Cross-link related guides** -- `[tasks](tasks.md)`, `[handlers](handlers.md)`
+- **Use mkdocs-material admonitions** for callouts -- `!!! note`, `!!! warning`, `!!! danger`
+
+### Linting with Vale
+
+Documentation is linted with [Vale](https://vale.sh) using the Google style guide. Configuration lives in `.vale.ini` and domain vocabulary in `styles/config/vocabularies/Wayfarer/accept.txt`.
+
+```bash
+vale sync                          # Download style packages (run once)
+vale docs/guides/middleware.md     # Lint a specific file
+vale docs/                         # Lint all documentation
+```
+
+Fix all errors and warnings. Suggestions (passive voice, acronym expansion) are acceptable when they match the existing documentation style.
+
+---
+
+## Pinning external artifacts
+
+Reference every container image and OCI artifact by immutable `@sha256:...`
+digest, not by tag. Tags are mutable and can silently change what runs; digests
+can't. This applies to `Dockerfile` `FROM` lines, image references in
+`docker-compose.yml` and `.env`, and anything else in the repository that pulls
+an image.
+
+Put the human-readable tag on a comment line above the pinned reference so
+future upgrades know which version was previously in use. Resolve a digest with
+a manifest HEAD request against Docker Hub, or with `crane digest <image>:<tag>`
+or `regctl image digest <image>:<tag>`.
+
+Pin GitHub Actions the same way. Use the commit SHA in the `uses:` line with the
+release tag as a trailing comment, e.g.:
+
+```yaml
+- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+```
+
+Tools installed via mise are exempt; the mise lock file already pins their
+integrity. Terraform providers are exempt for the same reason: `.terraform.lock.hcl`
+pins them by version and hash.
+
+---
+
+## Key Conventions
+
+- **All files:** `# frozen_string_literal: true` at the top
+- **Strings:** Always double-quoted
+- **Modules vs Classes:** Namespaced under `Wayfarer::*`; use `ActiveSupport::Concern` for mixins
+- **Autoloading:** Zeitwerk with custom inflections -- file names must match constant names after inflection (`cli` -> `CLI`, `dsl` -> `DSL`, `http` -> `HTTP`, `uri` -> `URI`, `url` -> `URL`, etc.)
+- **Numeric comparisons:** Use `== 0` not `.zero?`
+- **No module documentation cop** -- use YARD `@param`/`@return`/`@yield`/`@example`/`@see` tags to document complex logic, public APIs, and overridden template methods instead. Use comments to explain *why* something is done.
+- **Specs:** Tag browser tests (`:selenium`, `:ferrum`), Redis tests (`:redis`), CLI tests (`:cli`); all others run isolated
+- **Do not skip RuboCop** without an inline disable comment with justification
+- **Version consistency:** `VERSION::STRING` in `lib/wayfarer.rb` must match `wayfarer.gemspec`; CI enforces via `rake release:guard_versions`

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

data/Dockerfile

@@ -1,7 +1,9 @@
-FROM ruby:3.4.4-alpine
+# ruby:3.4.4-alpine
+FROM ruby@sha256:81096866ac15f906adc79867da3ed97a2aa271d6149363e216a174701345c53b
 RUN apk add --no-cache build-base git yaml-dev zlib-dev
 RUN git config --global --add safe.directory /opt/app
 WORKDIR /opt/app
+ENV BUNDLE_FROZEN=true
 COPY Gemfile Gemfile.lock *.gemspec ./
 RUN bundle install
 COPY . .

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    wayfarer (0.4.10)
+    wayfarer (0.5.1)
       activejob (>= 7.1)
       addressable (~> 2.8)
       capybara (~> 3.4)
@@ -98,6 +98,7 @@ GEM
       concurrent-ruby (~> 1.1)
       webrick (~> 1.7)
       websocket-driver (~> 0.7)
+    ffi (1.17.2-arm64-darwin)
     ffi (1.17.2-x86_64-darwin)
     ffi (1.17.2-x86_64-linux-musl)
     globalid (1.2.1)
@@ -148,6 +149,8 @@ GEM
     net-http-persistent (4.0.6)
       connection_pool (~> 2.2, >= 2.2.4)
     nio4r (2.7.4)
+    nokogiri (1.18.9-arm64-darwin)
+      racc (~> 1.4)
     nokogiri (1.18.9-x86_64-darwin)
       racc (~> 1.4)
     nokogiri (1.18.9-x86_64-linux-musl)
@@ -302,6 +305,7 @@ GEM
     zlib (3.2.1)
 
 PLATFORMS
+  arm64-darwin-25
   x86_64-darwin-24
   x86_64-linux-musl
 

data/MAINTENANCE.md

@@ -0,0 +1,17 @@
+# Maintenance
+
+## CI environment variables
+
+| Key | Value | Description |
+|---|---|---|
+| `GEM_HOST_API_KEY` | RubyGems API key | Publishes the `wayfarer` gem to rubygems.org from the `release` workflow. |
+| `TF_GITHUB_TOKEN` | Fine-grained PAT | Renders `terraform plan` against the live GitHub API in the `terraform-plan` job. Scopes: Metadata (R), Administration (R), Actions (R). |
+| `TF_APPLY_TOKEN` | Fine-grained PAT | Runs `terraform apply` and pushes updated state back to `master` in the `terraform-apply` job. Scopes: Metadata (R), Administration (RW), Actions (RW), Contents (RW). |
+
+## Releases
+
+1. Bump versions:
+  * `Wayfarer::VERSION` in `lib/wayfarer.rb`
+  * RubyGem version in `wayfarer.gemspec`
+  * Run `bundle install` to regenerate `Gemfile.lock`
+2. Push to `master` and run the manual `release` workflow

data/docker-compose.yml

@@ -16,22 +16,22 @@ services:
       - docs
 
   redis:
-    image: ${REDIS_IMAGE}:${REDIS_VERSION}
+    image: ${REDIS_IMAGE}
 
   chrome:
-    image: ${CHROME_IMAGE}:${CHROME_VERSION}
+    image: ${CHROME_IMAGE}
     ports:
       - "${CHROME_PORT}:${CHROME_PORT}"
 
   firefox:
-    image: ${FIREFOX_IMAGE}:${FIREFOX_VERSION}
+    image: ${FIREFOX_IMAGE}
     ports:
       - "${FIREFOX_PORT}:${FIREFOX_PORT}"
     volumes:
       - /dev/shm:/dev/shm
 
   docs:
-    image: ${DOCS_IMAGE}:${DOCS_VERSION}
+    image: ${DOCS_IMAGE}
     volumes:
       - ./:/docs
     ports:

data/docs/cookbook/batch_routing.md

@@ -4,7 +4,9 @@
 # Create a record in an external database and store the hostname
 record = Database::Row.create(hostname: "example.com")
 
-class DummyJob < Wayfarer::Base
+class DummyJob < ActiveJob::Base
+  include Wayfarer::Base
+
   route do |hostname|
     host hostname, to: :index
   end

data/docs/cookbook/consent_screen.md

@@ -8,7 +8,9 @@ iframe, clicked, and makes the live page behind the screen accessible to
 ```ruby
 Wayfarer.config[:network][:agent] = :ferrum
 
-class DummyJob < Wayfarer::Base
+class DummyJob < ActiveJob::Base
+  include Wayfarer::Base
+
   route.to :index, host: "example.com"
 
   before_action if: :consent_required? do