bible270 0.17.2 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e3c27f2336f3e2a809205242bbc42c46d241e49b9ea2b1bf49ca288523d7c88
-  data.tar.gz: 8e8c25b59eafde481a17546ac14b563527dd591ca64d9cf7541d95a01dd1f36c
+  metadata.gz: 7ba4b388cfe909e84f06899d72159471aab1a506154fc72854659d64320a3390
+  data.tar.gz: ebcf629ca6a12f57bf87d72073115c9a4655cec15e018e9349813aaab11a2e41
 SHA512:
-  metadata.gz: 06af092550c30ded960e3611301d941e10fdea25e79fcfcab8aa97c4d68fee7b3780961f22bc4f81be4ba3f065ebe57642386ba318c69f80e2f1bd1e07ce0dec
-  data.tar.gz: ed69c75af0e88e8dfeb347b756c6c10692f46b6e90196e96851aecc026a664752ce6f2fbb3de3b324734eff316555c229d19aa15270d26061b370b4db643f3ae
+  metadata.gz: 1b202223f06388e4b7f95d53b52f84cc84018ed7ac7ad8e49c48467525e7d76a0bd60185e46bd9b6223a83d7939666b6d7e7d6f1360ca625967452691d1fc528
+  data.tar.gz: 8c0b363492837cf5fb715ad13effdee46829cb34dad426e2bbfa8b24c4834f61ea16b2411b5c2e0fc0098d6b0fa397e8fe0cee487a763670f75f8f9fbb2bbb6c

data/CHANGELOG.md

@@ -6,7 +6,51 @@ All notable changes to bible270. Format follows [Keep a Changelog](https://keepa
 
 See the changes since the last release:
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.16.0...main)**
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.17.2...main)**
+
+## [0.17.2] - 2026-08-08
+
+### Added
+
+- reader Bible translation preferences editable by admin users
+- admin broadcast email tools
+
+### Changed
+
+- extract first and last names from OmniAuth display names
+- expand CI coverage reporting and add Ruby 4.0 coverage
+
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.17.1...v0.17.2)**
+
+## [0.17.1] - 2026-08-06
+
+### Added
+
+- likes for reflections
+
+### Changed
+
+- display timestamps using the local time zone
+- rename reflections to 'posts' in UI headers, because we like alliteration
+
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.17.0...v0.17.1)**
+
+## [0.17.0] - 2026-08-05
+
+### Added
+
+- a reflections page for browsing recent comments
+- the ability for readers to edit their reflections
+
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.16.1...v0.17.0)**
+
+## [0.16.1] - 2026-08-05
+
+### Changed
+
+- refactor mailer URL helpers to use the engine's routes
+
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.16.0...v0.16.1)**
 
 ## [0.16.0] - 2026-08-05
 
@@ -19,8 +63,6 @@ See the changes since the last release:
 
 ## [0.15.3] - 2026-08-04
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.15.2...v0.15.3)**
-
 ### Added
 
 - `Bible270::Checkoff.reset_column_information` to migrations to prevent `UnknownAttributeError` during backfills.
@@ -30,9 +72,9 @@ See the changes since the last release:
 
 - 'Today' now derived from system time, not UTC
 
-## [0.15.2] - 2026-08-04
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.15.2...v0.15.3)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.15.1...v0.15.2)**
+## [0.15.2] - 2026-08-04
 
 ### Added 
 
@@ -42,9 +84,9 @@ See the changes since the last release:
 
 - consistent reader sort order by first name in 'People' and 'Admin'
 
-## [0.15.1] - 2026-08-03
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.15.1...v0.15.2)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.15.0...v0.15.1)**
+## [0.15.1] - 2026-08-03
 
 ### Added
 
@@ -59,9 +101,9 @@ See the changes since the last release:
 
 - old zip file of tests
 
-## [0.15.0] - 2026-08-02
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.15.0...v0.15.1)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.14.1...v0.15.0)**
+## [0.15.0] - 2026-08-02
 
 ### Added
 
@@ -73,9 +115,9 @@ See the changes since the last release:
 
 - mobile session requiring sign-in every time: use persistent sessions using 'remember-me' cookie
 
-## [0.14.1] - 2026-07-30
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.14.1...v0.15.0)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.14.0...v0.14.1)**
+## [0.14.1] - 2026-07-30
 
 ### Changed
 
@@ -87,9 +129,9 @@ See the changes since the last release:
 - display 'Start' not 'Continue' if reader is on day 1
 - adjust badge vertical alignment in styles
 
-## [0.14.0] - 2026-07-30
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.14.0...v0.14.1)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.13.1...v0.14.0)**
+## [0.14.0] - 2026-07-30
 
 ### Added
 
@@ -107,16 +149,10 @@ See the changes since the last release:
   wrote an initializer that crashed the host app on boot. A test now renders every generator template
   and compiles the result, across three mount points.
 
-## [0.13.1] — 2026-07-29
-
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.13.0...v0.13.1)**
-
-Nothing consequential.
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.13.0...v0.14.0)**
 
 ## [0.13.0] — 2026-07-29
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.12.0...v0.13.0)**
-
 ### Added
 
 - favicon support
@@ -127,9 +163,9 @@ Nothing consequential.
 
 - Correct verb for reading prompt: 'Start' and 'Continue
 
-## [0.12.0] — 2026-07-29
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.12.0...v0.13.0)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.11.0...v0.12.0)**
+## [0.12.0] — 2026-07-29
 
 ### Added
 
@@ -141,9 +177,9 @@ Nothing consequential.
 - Top menu shows 'Progress' in place of user display name
 - Dependabot gem updates to minitest and rubocop
 
-## [0.11.0] — 2026-07-28
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.11.0...v0.12.0)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.10.0...v0.11.0)** 
+## [0.11.0] — 2026-07-28
 
 ### Added
 
@@ -195,9 +231,9 @@ Nothing consequential.
 - Migrations: `20260101000007` (settings). Active Storage tables are the host app's
   (`bin/rails active_storage:install`).
 
-## [0.10.0] — 2026-07-26
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.10.0...v0.11.0)** 
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.9.0...v0.10.0)**
+## [0.10.0] — 2026-07-26
 
 ### Reading plan
 
@@ -270,9 +306,9 @@ Nothing consequential.
 
 - Table names changed from `bible_reading_plan_*` in the 0.9.0 line; this is a fresh install.
 
-## [0.9.0] — 2026-07-25
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.9.0...v0.10.0)**
 
-**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.6.2...v0.9.0)**
+## [0.9.0] — 2026-07-25
 
 ### Changed
 
@@ -290,6 +326,8 @@ Nothing consequential.
 * `Plan.nt_groups`, `format_pp_segment`, `pp_segment_length` (superseded by the shared `format_segment` and `segment_length`), and `totals[:nt_rest_days]`.
 * `nt_rest_days` remains but now always returns an empty array.
 
+**[Full Changelog](https://github.com/avonderluft/bible270/compare/v0.6.2...v0.9.0)**
+
 ## [0.6.2] — 2026-07-25
 
 This is the initial public release.
@@ -352,6 +390,10 @@ This is the initial public release.
 
 * Email sign-in requires working Action Mailer delivery in the host application. Set `config.mailer_from`; delivery is inline by default, or set `email_sign_in_deliver_later` when a queue backend is available.
 
+[0.17.2]: https://github.com/avonderluft/bible270/releases/tag/v0.17.2
+[0.17.1]: https://github.com/avonderluft/bible270/releases/tag/v0.17.1
+[0.17.0]: https://github.com/avonderluft/bible270/releases/tag/v0.17.0
+[0.16.1]: https://github.com/avonderluft/bible270/releases/tag/v0.16.1
 [0.16.0]: https://github.com/avonderluft/bible270/releases/tag/v0.16.0
 [0.15.3]: https://github.com/avonderluft/bible270/releases/tag/v0.15.3
 [0.15.2]: https://github.com/avonderluft/bible270/releases/tag/v0.15.2
@@ -359,7 +401,6 @@ This is the initial public release.
 [0.15.0]: https://github.com/avonderluft/bible270/releases/tag/v0.15.0
 [0.14.1]: https://github.com/avonderluft/bible270/releases/tag/v0.14.1
 [0.14.0]: https://github.com/avonderluft/bible270/releases/tag/v0.14.0
-[0.13.1]: https://github.com/avonderluft/bible270/releases/tag/v0.13.1
 [0.13.0]: https://github.com/avonderluft/bible270/releases/tag/v0.13.0
 [0.12.0]: https://github.com/avonderluft/bible270/releases/tag/v0.12.0
 [0.11.0]: https://github.com/avonderluft/bible270/releases/tag/v0.11.0

data/README.md

@@ -117,6 +117,29 @@ bin/rails bible270:install:migrations   # skips ones you already have
 bin/rails db:migrate
 ```
 
+### Reconciling a copied database
+
+A copied database can contain the Bible270 tables while its `schema_migrations` versions do not match
+the timestamped migration copies in the local app. In that case, preview the reconciliation:
+
+```bash
+bin/rails bible270:migrations:reconcile
+```
+
+The task recognizes Bible270 migrations—and the related generated Active Storage migration used for
+reader avatars—by name, then verifies their tables, columns, current indexes, and foreign keys. It
+does not treat an existing table alone as sufficient. After reviewing the list and backing up the
+database, record only the migrations already reflected in the schema:
+
+```bash
+APPLY=1 bin/rails bible270:migrations:reconcile
+bin/rails db:migrate
+```
+
+Preview mode never writes to the database. Apply mode only inserts verified local versions into
+`schema_migrations`; it does not create, remove, or alter application tables. Migrations whose changes
+are missing remain pending for the final `db:migrate` command.
+
 ## Bible270 Mount point in your Rails app
 
 The path lives in exactly **one** place, `config.mount_at`:
@@ -361,7 +384,10 @@ config.favicon = false                      # none; the host's favicon applies
 It's emitted by the engine's layout, so if you point `config.layout` at your own layout, add
 `<%= b270_favicon_tag %>` to its `<head>`.
 
-References link to Bible Gateway by default — point `passage_url_builder` at your another reader if you wish, or your own reader if you host one.
+References link to Bible Gateway by default. Readers choose Bible Gateway or Blue Letter Bible from
+their profile, and an admin can set the same source for any reader. The `HEB/GRK` option always uses
+Blue Letter Bible: WLC for Old Testament, Psalms, and Proverbs readings, and mGNT for New Testament
+readings. Set `passage_url_builder` to use another default reader, or a reader you host yourself.
 
 ## With ComfortableMediaSurfer
 
@@ -371,7 +397,7 @@ The CMS serves your content; this is a separate mounted app. Either **just link
 
 | Table | Holds |
 |-------|-------|
-| `bible270_readers` | identity: display name, avatar, provider/uid or polymorphic `owner`, `started_on` |
+| `bible270_readers` | identity, avatar, provider/uid or polymorphic `owner`, start date, translation and passage-reader preferences |
 | `bible270_checkoffs` | one row per reader per day per track (`ot`/`nt`/`pp`), unique-indexed |
 | `bible270_comments` | a reflection on a day, optionally scoped to a track, public to all |
 | `bible270_sign_in_tokens` | magic-link tokens: email, **digest only**, expiry, consumed-at |

data/app/controllers/bible270/admin_controller.rb

@@ -105,16 +105,22 @@ module Bible270
       return redirect_to(admin_path, alert: 'No such reader.') if reader.nil?
 
       code = params[:bible_version].to_s
+      source = params[:passage_source].presence || Reader::DEFAULT_PASSAGE_SOURCE
+      unless Reader::PASSAGE_SOURCES.include?(source)
+        return redirect_to admin_reader_path(reader), alert: 'That is not a reading-link source on the list.'
+      end
+
       # Blank means "no preference": the reader follows the site default, which is
       # not the same as choosing whichever translation the site happens to use now.
       if code.empty?
-        reader.update(bible_version: nil)
+        reader.update(bible_version: nil, passage_source: source)
         return redirect_to admin_reader_path(reader),
                            notice: "#{reader.display_name} now follows the site default " \
                                    "(#{Bible270.config.bible_version})."
       end
 
       if reader.update_bible_version(code)
+        reader.update_column(:passage_source, source)
         redirect_to admin_reader_path(reader),
                     notice: "#{reader.display_name} now reads the #{reader.bible_version_label}."
       else

data/app/controllers/bible270/profiles_controller.rb

@@ -21,6 +21,8 @@ module Bible270
       if params[:bible_version].present? && !current_reader.update_bible_version(params[:bible_version])
         problems << 'a translation from the list'
       end
+      source = params[:passage_source].presence || Reader::DEFAULT_PASSAGE_SOURCE
+      problems << 'a reading-link source from the list' unless current_reader.update_passage_source(source)
       if params[:avatar].present? && !current_reader.attach_avatar(params[:avatar])
         problems << (current_reader.errors[:avatar].first || 'a valid image')
       end

data/app/helpers/bible270/plan_helper.rb

@@ -112,13 +112,24 @@ module Bible270
     def b270_passage_url(reference, version = nil)
       return '#' if reference.blank?
 
-      Bible270.config.passage_url_builder.call(reference, version || b270_bible_version)
+      selected_version = version || b270_bible_version
+      if selected_version != Translations::ORIGINAL_LANGUAGES && current_reader&.blue_letter_bible?
+        return Translations.passage_url(reference, selected_version, blue_letter: true)
+      end
+
+      Bible270.config.passage_url_builder.call(reference, selected_version)
     end
 
     # Small grey "(NKJV)" after a reading, so it's clear which translation the
-    # link opens in.
-    def b270_version_tag(version = nil)
-      content_tag :span, "(#{version || b270_bible_version})", class: 'b270-version'
+    # link opens in. The original-language preference names the actual language
+    # used for each track rather than repeating the combined preference code.
+    def b270_version_tag(version = nil, track: nil)
+      label = version || b270_bible_version
+      if label == Translations::ORIGINAL_LANGUAGES && track
+        label = track.to_s == 'nt' ? 'Greek' : 'Hebrew'
+      end
+
+      content_tag :span, "(#{label})", class: 'b270-version'
     end
 
     def b270_avatar_src(reader)

data/app/models/bible270/reader.rb

@@ -25,8 +25,12 @@ module Bible270
     # transaction rolls back.
     after_create_commit :notify_of_registration
 
+    PASSAGE_SOURCES = %w[bible_gateway blue_letter_bible].freeze
+    DEFAULT_PASSAGE_SOURCE = 'bible_gateway'
+
     validates :display_name, presence: true
     validates :uid, uniqueness: { scope: :provider }, allow_nil: true
+    validates :passage_source, inclusion: { in: PASSAGE_SOURCES }
 
     # Build/refresh a reader from an OmniAuth auth hash. Tolerant of the various
     # shapes strategies return (OmniAuth::AuthHash, plain Hash, missing info).
@@ -164,6 +168,16 @@ module Bible270
       update(bible_version: Translations.normalize(code))
     end
 
+    def update_passage_source(source)
+      source = source.to_s
+      return false unless PASSAGE_SOURCES.include?(source)
+
+      update(passage_source: source)
+    end
+
+    def bible_gateway? = passage_source == 'bible_gateway'
+    def blue_letter_bible? = passage_source == 'blue_letter_bible'
+
     # Readers are listed by first name, matching how they are shown — the display
     # name is "First Last", so sorting on it needs only case folding. Surname
     # order was inconsistent with the community page and read oddly next to names

data/app/views/bible270/admin/show.html.erb

@@ -109,8 +109,9 @@
                                Bible270::Translations.options,
                                @reader.bible_version.to_s),
             class: "b270-select", style: "width:auto" %>
-      <%= submit_tag "Save", class: "b270-btn" %>
     </div>
+    <%= render "bible270/shared/passage_source", reader: @reader %>
+    <%= submit_tag "Save", class: "b270-btn" %>
   <% end %>
 </div>
 

data/app/views/bible270/days/_reading.html.erb

@@ -35,7 +35,7 @@
           <% end %>
         </ul>
         <div class="b270-parts-meta">
-          <%= read_parts.size %> of <%= parts.size %> chapters <%= b270_version_tag %>
+          <%= read_parts.size %> of <%= parts.size %> chapters <%= b270_version_tag(track: track) %>
         </div>
       </div>
     <% else %>
@@ -50,7 +50,7 @@
       <% end %>
       <div class="b270-rbody">
         <div class="b270-cat"><%= t[:label] %></div>
-        <div class="b270-ref"><%= link_to ref, b270_passage_url(ref), target: "_blank", rel: "noopener" %> <%= b270_version_tag %></div>
+        <div class="b270-ref"><%= link_to ref, b270_passage_url(ref), target: "_blank", rel: "noopener" %> <%= b270_version_tag(track: track) %></div>
       </div>
     <% end %>
   </div>

data/app/views/bible270/profiles/edit.html.erb

@@ -39,6 +39,7 @@
             class: "b270-select" %>
       <span class="b270-hint" style="margin:0">Reading links open in this translation.</span>
     </label>
+    <%= render "bible270/shared/passage_source", reader: current_reader %>
 
     <%= submit_tag "Save", class: "b270-btn" %>
   <% end %>

data/app/views/bible270/shared/_passage_source.html.erb

@@ -0,0 +1,13 @@
+<% original_languages = reader.effective_bible_version == Bible270::Translations::ORIGINAL_LANGUAGES %>
+<div class="b270-source-choices" role="radiogroup" aria-label="Reading link source">
+  <label class="b270-source-choice <%= 'disabled' if original_languages %>">
+    <%= radio_button_tag :passage_source, "bible_gateway",
+          !original_languages && reader.bible_gateway?, disabled: original_languages %>
+    <span>Bible Gateway</span>
+  </label>
+  <label class="b270-source-choice <%= 'disabled' if original_languages %>">
+    <%= radio_button_tag :passage_source, "blue_letter_bible",
+          original_languages || reader.blue_letter_bible?, disabled: original_languages %>
+    <span>Blue Letter Bible</span>
+  </label>
+</div>

data/app/views/bible270/shared/_styles.html.erb

@@ -134,6 +134,15 @@
   .b270-parts-meta{margin-top:10px;font-size:12.5px;color:var(--faint)}
   .b270-version{font-size:11.5px;color:var(--faint);font-weight:400;letter-spacing:.02em;white-space:nowrap}
   .b270-select{font:inherit;font-size:14px;padding:10px 30px 10px 12px;border:1px solid var(--line);border-radius:9px;background:#fff;color:var(--ink);width:100%;max-width:100%;text-overflow:ellipsis}
+  .b270-source-choices{display:flex;align-items:center;gap:18px;flex-wrap:wrap;margin:8px 0 2px;color:var(--muted);font-size:12.5px}
+  .b270-source-choice{display:inline-flex;align-items:center;gap:7px;cursor:pointer;white-space:nowrap}
+  .b270-source-choice input{appearance:none;width:17px;height:17px;margin:0;border:1px solid var(--line);border-radius:3px;background:#fff;display:grid;place-content:center;cursor:pointer}
+  .b270-source-choice input::before{content:"";width:9px;height:9px;transform:scale(0);transition:transform .1s;clip-path:polygon(14% 44%,0 59%,38% 100%,100% 18%,82% 0,37% 65%);background:var(--paper)}
+  .b270-source-choice input:checked{background:var(--gold);border-color:var(--gold)}
+  .b270-source-choice input:checked::before{transform:scale(1)}
+  .b270-source-choice input:focus-visible{outline:2px solid var(--gold);outline-offset:2px}
+  .b270-source-choice.disabled{cursor:default;opacity:.55}
+  .b270-source-choice input:disabled{cursor:default}
   .b270-ref a{text-decoration:none;border-bottom:1px solid transparent}
   .b270-ref a:hover{border-bottom-color:var(--gold)}
   .b270-reading.done .b270-ref{color:var(--muted)}

data/db/migrate/20260101000014_add_blue_letter_bible_to_bible270_readers.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class AddBlueLetterBibleToBible270Readers < ActiveRecord::Migration[7.0]
+  def change
+    add_column :bible270_readers, :blue_letter_bible, :boolean, default: false, null: false
+  end
+end

data/db/migrate/20260101000015_add_passage_source_to_bible270_readers.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+class AddPassageSourceToBible270Readers < ActiveRecord::Migration[7.0]
+  def up
+    add_column :bible270_readers, :passage_source, :string, default: 'bible_gateway', null: false
+
+    return unless column_exists?(:bible270_readers, :blue_letter_bible)
+
+    execute <<~SQL.squish
+      UPDATE bible270_readers
+      SET passage_source = 'blue_letter_bible'
+      WHERE blue_letter_bible = TRUE
+    SQL
+    remove_column :bible270_readers, :blue_letter_bible
+  end
+
+  def down
+    add_column :bible270_readers, :blue_letter_bible, :boolean, default: false, null: false
+    execute <<~SQL.squish
+      UPDATE bible270_readers
+      SET blue_letter_bible = TRUE
+      WHERE passage_source = 'blue_letter_bible'
+    SQL
+    remove_column :bible270_readers, :passage_source
+  end
+end

data/lib/bible270/configuration.rb

@@ -347,12 +347,7 @@ module Bible270
       @after_sign_out_path = nil
       @bible_version = 'NKJV'
       @bible_versions = Translations::VERSIONS.keys
-      @passage_url_builder = ->(reference, version) do
-        search  = URI.encode_www_form_component(reference)
-        # Translations.gateway_code maps 'NASB95' to Bible Gateway's 'NASB1995'.
-        version = URI.encode_www_form_component(Translations.gateway_code(version))
-        "https://www.biblegateway.com/passage/?search=#{search}&version=#{version}"
-      end
+      @passage_url_builder = ->(reference, version) { Translations.passage_url(reference, version) }
       @app_name = 'Daily Bread'
       @tagline = 'Journeying through Scripture in 9 months'
       @time_zone = nil

data/lib/bible270/migration_reconciler.rb

@@ -0,0 +1,252 @@
+# frozen_string_literal: true
+
+module Bible270
+  # Repairs schema_migrations after a database is copied without matching migration
+  # bookkeeping. A migration is safe to mark only when every table, column and
+  # current index it contributes is already present.
+  class MigrationReconciler
+    Status = Struct.new(:migration, :missing, keyword_init: true) do
+      def complete? = missing.empty?
+    end
+
+    CHECKS = {
+      'CreateBible270Readers' => :check_readers,
+      'CreateBible270Checkoffs' => :check_checkoffs,
+      'CreateBible270Comments' => :check_comments,
+      'CreateBible270SignInTokens' => :check_sign_in_tokens,
+      'AddNamesToBible270Readers' => :check_names,
+      'AddApprovalToBible270Comments' => :check_approval,
+      'CreateBible270Settings' => :check_settings,
+      'AddBibleVersionToBible270Readers' => :check_bible_version,
+      'AddPartToBible270Checkoffs' => :check_checkoff_parts,
+      'AddRememberTokenToBible270Readers' => :check_remember_token,
+      'AddMentionNoticesToBible270Readers' => :check_mention_notices,
+      'AddParentToBible270Comments' => :check_comment_parent,
+      'CreateBible270Likes' => :check_likes,
+      'AddBlueLetterBibleToBible270Readers' => :check_blue_letter_bible,
+      'AddPassageSourceToBible270Readers' => :check_passage_source,
+      'CreateActiveStorageTables' => :check_active_storage
+    }.freeze
+
+    def self.for_current_database
+      context = ActiveRecord::MigrationContext.new(ActiveRecord::Migrator.migrations_paths)
+      new(connection: ActiveRecord::Base.connection, migration_context: context)
+    end
+
+    def initialize(connection:, migration_context:)
+      @connection = connection
+      @migration_context = migration_context
+    end
+
+    def statuses
+      applied = migration_context.get_all_versions.map(&:to_i)
+      migration_context.migrations.filter_map do |migration|
+        check = CHECKS[migration.name]
+        next unless check
+        next if applied.include?(migration.version.to_i)
+
+        Status.new(migration: migration, missing: public_send(check))
+      end
+    end
+
+    def mark_applied!(status)
+      raise ArgumentError, "#{status.migration.name} is not reflected in the schema" unless status.complete?
+
+      migration_context.schema_migration.create_version(status.migration.version.to_s)
+    end
+
+    def check_readers
+      table_missing(
+        :bible270_readers,
+        columns: %i[id display_name email avatar_url provider uid owner_type owner_id started_on created_at updated_at],
+        indexes: [
+          { columns: %i[owner_type owner_id] },
+          { columns: %i[provider uid], unique: true }
+        ]
+      )
+    end
+
+    def check_checkoffs
+      table_missing(
+        :bible270_checkoffs,
+        columns: %i[id reader_id day track created_at updated_at],
+        indexes: [{ columns: %i[reader_id] }, { columns: %i[day] }],
+        foreign_keys: [{ column: :reader_id, to_table: :bible270_readers }]
+      )
+    end
+
+    def check_comments
+      table_missing(
+        :bible270_comments,
+        columns: %i[id reader_id day track body created_at updated_at],
+        indexes: [{ columns: %i[reader_id] }, { columns: %i[day created_at] }],
+        foreign_keys: [{ column: :reader_id, to_table: :bible270_readers }]
+      )
+    end
+
+    def check_sign_in_tokens
+      table_missing(
+        :bible270_sign_in_tokens,
+        columns: %i[id email token_digest display_name expires_at consumed_at created_at updated_at],
+        indexes: [
+          { columns: %i[token_digest], unique: true },
+          { columns: %i[email created_at] }
+        ]
+      )
+    end
+
+    def check_names
+      table_missing(
+        :bible270_readers,
+        columns: %i[first_name last_name],
+        indexes: [{ columns: %i[last_name first_name] }]
+      ) + table_missing(:bible270_sign_in_tokens, columns: %i[first_name last_name])
+    end
+
+    def check_approval
+      table_missing(
+        :bible270_comments,
+        columns: %i[approved moderated_at],
+        indexes: [{ columns: %i[approved day] }]
+      )
+    end
+
+    def check_settings
+      table_missing(
+        :bible270_settings,
+        columns: %i[id key value created_at updated_at],
+        indexes: [{ columns: %i[key], unique: true }]
+      )
+    end
+
+    def check_bible_version
+      table_missing(:bible270_readers, columns: %i[bible_version])
+    end
+
+    def check_checkoff_parts
+      table_missing(
+        :bible270_checkoffs,
+        columns: %i[part],
+        indexes: [{ columns: %i[reader_id day track part], unique: true }]
+      )
+    end
+
+    def check_remember_token
+      table_missing(
+        :bible270_readers,
+        columns: %i[remember_token],
+        indexes: [{ columns: %i[remember_token] }]
+      )
+    end
+
+    def check_mention_notices
+      table_missing(:bible270_readers, columns: %i[notify_on_mention])
+    end
+
+    def check_comment_parent
+      table_missing(
+        :bible270_comments,
+        columns: %i[parent_id],
+        indexes: [{ columns: %i[parent_id] }],
+        foreign_keys: [{ column: :parent_id, to_table: :bible270_comments }]
+      )
+    end
+
+    def check_likes
+      table_missing(
+        :bible270_likes,
+        columns: %i[id reader_id comment_id created_at updated_at],
+        indexes: [
+          { columns: %i[reader_id comment_id], unique: true },
+          { columns: %i[comment_id] }
+        ],
+        foreign_keys: [
+          { column: :reader_id, to_table: :bible270_readers },
+          { column: :comment_id, to_table: :bible270_comments }
+        ]
+      )
+    end
+
+    def check_blue_letter_bible
+      return [] if connection.column_exists?(:bible270_readers, :passage_source)
+
+      table_missing(:bible270_readers, columns: %i[blue_letter_bible])
+    end
+
+    def check_passage_source
+      table_missing(:bible270_readers, columns: %i[passage_source])
+    end
+
+    # The Bible270 installer can install Active Storage for reader avatars. A
+    # copied database can therefore have the same timestamp mismatch for Rails'
+    # generated Active Storage migration as it has for the engine migrations.
+    def check_active_storage
+      table_missing(
+        :active_storage_blobs,
+        columns: %i[id key filename content_type metadata service_name byte_size checksum created_at],
+        indexes: [{ columns: %i[key], unique: true }]
+      ) + table_missing(
+        :active_storage_attachments,
+        columns: %i[id name record_type record_id blob_id created_at],
+        indexes: [
+          { columns: %i[blob_id] },
+          { columns: %i[record_type record_id name blob_id], unique: true }
+        ],
+        foreign_keys: [{ column: :blob_id, to_table: :active_storage_blobs }]
+      ) + table_missing(
+        :active_storage_variant_records,
+        columns: %i[id blob_id variation_digest],
+        indexes: [{ columns: %i[blob_id variation_digest], unique: true }],
+        foreign_keys: [{ column: :blob_id, to_table: :active_storage_blobs }]
+      )
+    end
+
+  private
+
+    attr_reader :connection, :migration_context
+
+    def table_missing(table, columns:, indexes: [], foreign_keys: [])
+      return ["table #{table}"] unless connection.data_source_exists?(table)
+
+      missing_columns(table, columns) +
+        missing_indexes(table, indexes) +
+        missing_foreign_keys(table, foreign_keys)
+    end
+
+    def missing_columns(table, expected_columns)
+      existing = connection.columns(table).map { |column| column.name.to_s }
+      expected_columns.filter_map do |column|
+        "column #{table}.#{column}" unless existing.include?(column.to_s)
+      end
+    end
+
+    def missing_indexes(table, expected_indexes)
+      existing = connection.indexes(table)
+      expected_indexes.filter_map do |expected|
+        columns = expected.fetch(:columns).map(&:to_s)
+        next if existing.any? { |index| matching_index?(index, columns, expected) }
+
+        qualifier = expected[:unique] ? 'unique index' : 'index'
+        "#{qualifier} #{table}(#{columns.join(', ')})"
+      end
+    end
+
+    def matching_index?(index, columns, expected)
+      index.columns == columns && (!expected.key?(:unique) || index.unique == expected[:unique])
+    end
+
+    def missing_foreign_keys(table, expected_foreign_keys)
+      existing = connection.foreign_keys(table)
+      expected_foreign_keys.filter_map do |expected|
+        next if existing.any? { |foreign_key| matching_foreign_key?(foreign_key, expected) }
+
+        "foreign key #{table}.#{expected[:column]} -> #{expected[:to_table]}"
+      end
+    end
+
+    def matching_foreign_key?(foreign_key, expected)
+      foreign_key.column.to_s == expected.fetch(:column).to_s &&
+        foreign_key.to_table.to_s == expected.fetch(:to_table).to_s
+    end
+  end
+end

data/lib/bible270/translations.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'uri'
+require 'bible270/versification'
+
 module Bible270
   # The translations a reader may choose between, and how each maps onto the
   # external reader's own code. Kept free of Rails so it can be unit tested.
@@ -11,14 +14,22 @@ module Bible270
     # `label` is the full name, for prose. `short` is what goes in the select,
     # where "New American Standard Bible 1995" overflows the box.
     VERSIONS = {
-      'NKJV' => { label: 'New King James Version', short: 'New King James Version', gateway: 'NKJV' },
-      'NASB95' => { label: 'New American Standard Bible 1995', short: 'New American Standard 1995', gateway: 'NASB1995' },
-      'LSB' => { label: 'Legacy Standard Bible', short: 'Legacy Standard Version', gateway: 'LSB' },
-      'ESV' => { label: 'English Standard Version', short: 'English Standard Version', gateway: 'ESV' },
-      'KJV' => { label: 'King James Version', short: 'King James Version', gateway: 'KJV' }
+      'NKJV' => { label: 'New King James Version', short: 'New King James Version', gateway: 'NKJV', blue_letter: 'nkjv' },
+      'NASB95' => { label: 'New American Standard Bible 1995', short: 'New American Standard 1995', gateway: 'NASB1995', blue_letter: 'nasb95' },
+      'LSB' => { label: 'Legacy Standard Bible', short: 'Legacy Standard Version', gateway: 'LSB', blue_letter: 'lsb' },
+      'ESV' => { label: 'English Standard Version', short: 'English Standard Version', gateway: 'ESV', blue_letter: 'esv' },
+      'KJV' => { label: 'King James Version', short: 'King James Version', gateway: 'KJV', blue_letter: 'kjv' },
+      'HEB/GRK' => { label: 'Hebrew and Greek', short: 'Hebrew and Greek', gateway: 'WLC', blue_letter: 'wlc/mgnt' }
     }.freeze
 
     DEFAULT = 'NKJV'
+    ORIGINAL_LANGUAGES = 'HEB/GRK'
+    BLUE_LETTER_BASE_URL = 'https://www.blueletterbible.org'
+    BLUE_LETTER_BOOK_CODES = %w[
+      gen exo lev num deu jos jdg rut 1sa 2sa 1ki 2ki 1ch 2ch ezr neh est job psa pro ecc sng
+      isa jer lam eze dan hos joe amo oba jon mic nah hab zep hag zec mal mat mar luk joh act rom
+      1co 2co gal eph php col 1th 2th 1ti 2ti tit phm heb jas 1pe 2pe 1jo 2jo 3jo jud rev
+    ].freeze
 
   module_function
 
@@ -57,6 +68,51 @@ module Bible270
       codes.map { |code| ["#{code} — #{short_label(code)}", code] }
     end
 
+    def passage_url(reference, version, blue_letter: false)
+      if blue_letter || normalize(version) == ORIGINAL_LANGUAGES
+        return blue_letter_url(reference, version)
+      end
+
+      search = URI.encode_www_form_component(reference)
+      gateway = URI.encode_www_form_component(gateway_code(version))
+      "https://www.biblegateway.com/passage/?search=#{search}&version=#{gateway}"
+    end
+
+    # Blue Letter Bible identifies a verse with its canonical chapter number times
+    # 1,000 plus the verse number: Genesis 1:1 is 1001 and Matthew 1:1 is 930001.
+    # A plan reference can span chapters or books; BLB has no equivalent passage
+    # query URL, so link to the first chapter/verse and let its chapter navigation
+    # carry the reader onward.
+    def blue_letter_url(reference, version = ORIGINAL_LANGUAGES)
+      books = Versification::VERSES.keys
+      book_index = books.index { |book| reference.to_s.start_with?("#{book} ") }
+      return "#{BLUE_LETTER_BASE_URL}/" unless book_index
+
+      book = books[book_index]
+      location = reference.to_s.delete_prefix("#{book} ")
+      match = location.match(%r{\A(\d+)(?::(\d+))?})
+      return "#{BLUE_LETTER_BASE_URL}/" unless match
+
+      chapter = match[1].to_i
+      verse = match[2]&.to_i || 1
+      chapter_verses = Versification::VERSES[book]
+      return "#{BLUE_LETTER_BASE_URL}/" unless chapter.between?(1, chapter_verses.length)
+      return "#{BLUE_LETTER_BASE_URL}/" unless verse.between?(1, chapter_verses[chapter - 1])
+
+      canonical_chapter = books.first(book_index).sum { |prior| Versification::VERSES[prior].length } + chapter
+      new_testament = book_index >= books.index('Matthew')
+      reader = if normalize(version) == ORIGINAL_LANGUAGES
+                 new_testament ? 'mgnt' : 'wlc'
+               else
+                 VERSIONS.dig(normalize(version), :blue_letter)
+               end
+      return "#{BLUE_LETTER_BASE_URL}/" if reader.to_s.empty?
+
+      anchor = (canonical_chapter * 1000) + verse
+      "#{BLUE_LETTER_BASE_URL}/#{reader}/#{BLUE_LETTER_BOOK_CODES[book_index]}/" \
+        "#{chapter}/#{verse}/s_#{anchor}"
+    end
+
     # Falls back to the configured default, then to ESV, so a link is never built
     # with a blank version.
     def resolve(code)

data/lib/bible270/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bible270
-  VERSION = '0.17.2'
+  VERSION = '0.18.0'
 end

data/lib/tasks/bible270_migrations.rake

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'bible270/migration_reconciler'
+
+namespace :bible270 do
+  namespace :migrations do
+    desc 'Reconcile copied Bible270/Active Storage tables with schema_migrations (set APPLY=1 to write)'
+    task reconcile: :environment do
+      reconciler = Bible270::MigrationReconciler.for_current_database
+      statuses = reconciler.statuses
+
+      if statuses.empty?
+        puts 'No pending Bible270 or related Active Storage migrations were found.'
+        next
+      end
+
+      complete, incomplete = statuses.partition(&:complete?)
+
+      puts 'Already reflected in the database schema:'
+      if complete.empty?
+        puts '  (none)'
+      else
+        complete.each do |status|
+          puts "  #{status.migration.version} #{status.migration.name}"
+        end
+      end
+
+      unless incomplete.empty?
+        puts
+        puts 'Still missing schema changes (these will remain pending):'
+        incomplete.each do |status|
+          puts "  #{status.migration.version} #{status.migration.name}"
+          status.missing.each { |item| puts "    - #{item}" }
+        end
+      end
+
+      puts
+      unless ENV['APPLY'] == '1'
+        puts 'Preview only; schema_migrations was not changed.'
+        puts 'Review the list, back up the database, then rerun with APPLY=1.'
+        next
+      end
+
+      if complete.empty?
+        puts 'Nothing was safe to mark as applied.'
+        next
+      end
+
+      ActiveRecord::Base.transaction do
+        complete.each { |status| reconciler.mark_applied!(status) }
+      end
+
+      puts "Marked #{complete.size} verified #{'migration'.pluralize(complete.size)} as applied."
+      puts 'Run bin/rails db:migrate to apply the migrations whose schema changes are still missing.'
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bible270
 version: !ruby/object:Gem::Version
-  version: 0.17.2
+  version: 0.18.0
 platform: ruby
 authors:
 - Andrew vonderLuft
@@ -136,6 +136,7 @@ files:
 - app/views/bible270/shared/_footer.html.erb
 - app/views/bible270/shared/_grid_legend.html.erb
 - app/views/bible270/shared/_header.html.erb
+- app/views/bible270/shared/_passage_source.html.erb
 - app/views/bible270/shared/_progress.html.erb
 - app/views/bible270/shared/_reflections.html.erb
 - app/views/bible270/shared/_styles.html.erb
@@ -157,6 +158,8 @@ files:
 - db/migrate/20260101000011_add_mention_notices_to_bible270_readers.rb
 - db/migrate/20260101000012_add_parent_to_bible270_comments.rb
 - db/migrate/20260101000013_create_bible270_likes.rb
+- db/migrate/20260101000014_add_blue_letter_bible_to_bible270_readers.rb
+- db/migrate/20260101000015_add_passage_source_to_bible270_readers.rb
 - lib/bible270.rb
 - lib/bible270/avatars.rb
 - lib/bible270/configuration.rb
@@ -164,6 +167,7 @@ files:
 - lib/bible270/engine.rb
 - lib/bible270/favicon.rb
 - lib/bible270/mentions.rb
+- lib/bible270/migration_reconciler.rb
 - lib/bible270/names.rb
 - lib/bible270/plan.rb
 - lib/bible270/translations.rb
@@ -172,6 +176,7 @@ files:
 - lib/generators/bible270/install/install_generator.rb
 - lib/generators/bible270/install/templates/bible270.rb.tt
 - lib/generators/bible270/install/templates/omniauth.rb.tt
+- lib/tasks/bible270_migrations.rake
 homepage: https://github.com/avonderluft/bible270
 licenses:
 - MIT