Boxrunner

.github/workflows/ci.yml

@@ -65,6 +65,34 @@ jobs:
       - name: Lint code for consistent style
         run: bin/rubocop -f github
 
+  spec:
+    runs-on: ubuntu-latest
+
+    # services:
+    #  redis:
+    #    image: valkey/valkey:8
+    #    ports:
+    #      - 6379:6379
+    #    options: --health-cmd "redis-cli ping" --health-interval 10s --health-timeout 5s --health-retries 5
+    steps:
+      - name: Install packages
+        run: sudo apt-get update && sudo apt-get install --no-install-recommends -y libvips node-gyp
+
+      - name: Checkout code
+        uses: actions/checkout@v7
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: Run specs
+        env:
+          RAILS_ENV: test
+          # RAILS_MASTER_KEY: ${{ secrets.RAILS_MASTER_KEY }}
+          # REDIS_URL: redis://localhost:6379/0
+        run: bin/rspec
+
   test:
     runs-on: ubuntu-latest
 

.gitignore

@@ -51,3 +51,8 @@
 
 # Ignore key files for decrypting credentials and more.
 /config/*.key
+
+# Ignore data files that are generated by the application and should not be committed to the repository.
+/data/ead
+/data/xml
+/data/pdf

.rspec

@@ -0,0 +1 @@
+--require spec_helper

.rubocop.yml

@@ -1,8 +1,15 @@
+inherit_from: .rubocop_todo.yml
+
 # Omakase Ruby styling for Rails
 inherit_gem: { rubocop-rails-omakase: rubocop.yml }
 
 # Overwrite or add rules to create your own house style
 #
+# Enforce explicit frozen string literal magic comments.
+#Style/FrozenStringLiteralComment:
+#  Enabled: true
+#  EnforcedStyle: always_true
+
 # # Use `[a, [b, c]]` not `[ a, [ b, c ] ]`
 # Layout/SpaceInsideArrayLiteralBrackets:
 #   Enabled: false

.rubocop_todo.yml

@@ -0,0 +1,21 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --auto-gen-only-exclude --no-exclude-limit`
+# on 2026-06-25 15:59:23 UTC using RuboCop version 1.87.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: 2
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'app/services/package/generator.rb'
+    - 'lib/box/package/generator.rb'
+
+# Offense count: 4
+# Configuration parameters: CountComments, Max, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Exclude:
+    - 'app/services/package/generator.rb'
+    - 'lib/box/package/generator.rb'

Dockerfile

@@ -17,6 +17,14 @@ WORKDIR /rails
 # Install base packages
 RUN apt-get update -qq && \
     apt-get install --no-install-recommends -y curl libjemalloc2 libvips sqlite3 && \
+    # wkhtmltopdf is no longer packaged in Debian bookworm; install the official
+    # static build (.deb) so the PDF packager can shell out to it. Installing a
+    # local .deb via apt lets it resolve the font/X11 dependencies automatically.
+    arch="$(dpkg --print-architecture)" && \
+    curl -fsSL -o /tmp/wkhtmltox.deb \
+      "https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.bookworm_${arch}.deb" && \
+    apt-get install --no-install-recommends -y /tmp/wkhtmltox.deb && \
+    rm -f /tmp/wkhtmltox.deb && \
     ln -s /usr/lib/$(uname -m)-linux-gnu/libjemalloc.so.2 /usr/local/lib/libjemalloc.so && \
     rm -rf /var/lib/apt/lists /var/cache/apt/archives
 

Gemfile

@@ -44,6 +44,14 @@ gem "image_processing", "~> 1.2"
 
 # date range chart
 gem "blacklight_range_limit", ">= 9.2"
+# job worker queue
+gem "resque", "~> 3.0"
+gem "redis"
+gem "resque-scheduler"
+# NOTE: The Resque dashboard is served by Resque::Server (bundled with the
+# `resque` gem) via config/resque_web.ru. The separate `resque-web` gem is
+# intentionally NOT used: it depends on sass-rails/sprockets, which conflicts
+# with this app's Propshaft asset pipeline and breaks `assets:precompile`.
 
 group :development, :test do
   # See https://guides.rubyonrails.org/debugging_rails_applications.html#debugging-with-the-debug-gem
@@ -53,7 +61,7 @@ group :development, :test do
   gem "bundler-audit", require: false
 
   # Static analysis for security vulnerabilities [https://brakemanscanner.org/]
-  gem "brakeman", "~> 8.0.5", require: false
+  gem "brakeman", "~> 8.0.6", require: false
 
   # Omakase Ruby styling [https://github.com/rails/rubocop-rails-omakase/]
   gem "rubocop-rails-omakase", require: false
@@ -73,9 +81,11 @@ gem "arclight"
 
 group :development, :test do
   gem "solr_wrapper", ">= 0.3"
+  gem "rspec-rails", "~> 8.0"
 end
 gem "rsolr", ">= 1.0", "< 3"
 gem "bootstrap", "~> 5.3"
 gem "devise"
 gem "devise-guests", "~> 0.8"
 gem "blacklight-locale_picker"
+gem "benchmark"