bible270 0.17.1 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70091a35da0211de345d0a946f8fe25aea94c7656d7f9fb7b305aa63c6a1b7e6
-  data.tar.gz: 98e6db18fb16bdb784b7b2ad095b05860a43a81cb3111279f33b7285345bcbd0
+  metadata.gz: 7ba4b388cfe909e84f06899d72159471aab1a506154fc72854659d64320a3390
+  data.tar.gz: ebcf629ca6a12f57bf87d72073115c9a4655cec15e018e9349813aaab11a2e41
 SHA512:
-  metadata.gz: e03f11e9596c52e59413478a3c5c615ce5bc9f4289ecbed3a037906d51d70e515d56767d18324ba331dded40de502d0d6b7c741c603836d7e351d147375187df
-  data.tar.gz: f2496c1342b3be1625927fdbbecd333c1792d96c8c52742359bdfc9cb66e9de7ac0f3617b20b291ee081811e4d937a92e3dbbecc9c5ee29a3c3d0788db9f473a
+  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/Rakefile

@@ -2,6 +2,7 @@
 
 require 'bundler/gem_tasks' # provides build / install / release
 require 'rake/testtask'
+require 'coveralls/rake/task'
 
 Rake::TestTask.new(:test) do |t|
   t.libs << 'test' << 'lib'
@@ -9,4 +10,6 @@ Rake::TestTask.new(:test) do |t|
   t.warning = false
 end
 
+Coveralls::RakeTask.new
+
 task default: :test

data/app/controllers/bible270/admin_controller.rb

@@ -8,6 +8,9 @@ module Bible270
   # neither set the panel is unreachable, and every action 404s rather than 403s
   # so its existence isn't advertised.
   class AdminController < ApplicationController
+    LAST_BROADCAST_AT = 'last_broadcast_at'
+    LAST_BROADCAST_SUBJECT = 'last_broadcast_subject'
+
     before_action :require_admin!
     before_action :load_reader,
                   only: %i[show destroy update_start update_profile remove_avatar complete_through toggle_day]
@@ -32,6 +35,9 @@ module Bible270
       counts = Checkoff.group(:reader_id, :day).count
       @days_completed = Hash.new(0)
       counts.each { |(rid, day), n| @days_completed[rid] += 1 if n >= Plan.total_parts(day) }
+      @reachable = Reader.where.not(email: [nil, '']).count
+      @last_broadcast_at = parsed_time(Setting.read(LAST_BROADCAST_AT))
+      @last_broadcast_subject = Setting.read(LAST_BROADCAST_SUBJECT)
     end
 
     def show
@@ -75,6 +81,53 @@ module Bible270
     end
 
     # Put the reader on a given day as of today, or set an explicit start date.
+    def broadcast
+      subject = params[:subject].to_s.strip
+      body = params[:body].to_s.strip
+
+      if subject.empty? || body.empty?
+        return redirect_to(admin_path, alert: 'A message needs both a subject and something to say.')
+      end
+
+      recipients = Reader.where.not(email: [nil, '']).order(:id)
+      return redirect_to(admin_path, alert: 'Nobody has an email address.') if recipients.empty?
+
+      sent = deliver_broadcast(recipients, subject, body)
+      Setting.write(LAST_BROADCAST_AT, Time.current.iso8601)
+      Setting.write(LAST_BROADCAST_SUBJECT, subject)
+
+      redirect_to admin_path,
+                  notice: "Sent to #{sent} #{'reader'.pluralize(sent)}."
+    end
+
+    def update_bible_version
+      reader = Reader.find_by(id: params[:id])
+      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, 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
+        redirect_to admin_reader_path(reader), alert: 'That is not a translation on the list.'
+      end
+    end
+
     def update_start
       if params[:start_date].present?
         # set_start_date!, not update_start_date!: an admin is not subject to
@@ -138,6 +191,33 @@ module Bible270
       end
     end
 
+    # Failures are counted rather than raised: one bad address must not stop the
+    # rest of the message going out, and the admin is told how many were sent.
+    # A stored timestamp that cannot be read is treated as absent rather than
+    # blowing up the admin page.
+    def parsed_time(value)
+      return nil if value.blank?
+
+      Time.parse(value.to_s)
+    rescue ArgumentError, TypeError
+      nil
+    end
+
+    def deliver_broadcast(recipients, subject, body)
+      later = Bible270.config.registration_notice_deliver_later
+      sent = 0
+
+      recipients.find_each do |reader|
+        mail = NoticeMailer.broadcast(reader_id: reader.id, subject: subject, body: body)
+        later ? mail.deliver_later : mail.deliver_now
+        sent += 1
+      rescue StandardError => e
+        Rails.logger.error("[bible270] broadcast to reader #{reader.id} failed: #{e.class}: #{e.message}")
+      end
+
+      sent
+    end
+
   private
 
     def require_admin!

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/controllers/bible270/sessions_controller.rb

@@ -36,7 +36,9 @@ module Bible270
       remember_reader!(reader)
       @current_reader = reader
 
-      redirect_to destination, notice: "Welcome #{reader.first_name}."
+      # first_name is filled in for every route now, but a bridged host user may
+      # still arrive without one.
+      redirect_to destination, notice: "Welcome #{reader.first_name.presence || reader.display_name}."
     end
 
     def destroy

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/mailers/bible270/broadcast.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+  <body style="margin:0;padding:24px;background:#ece6da;font-family:-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#231f18">
+    <div style="max-width:520px;margin:0 auto;background:#f4efe6;border:1px solid #d7cfbf;border-radius:14px;padding:28px">
+      <p style="margin:0 0 16px;font-size:15px">
+        <%= @reader.first_name.presence || @reader.display_name %>,
+      </p>
+
+      <div style="font-size:15px;line-height:1.6"><%= simple_format(@body) %></div>
+
+      <p style="margin:24px 0 0;padding-top:16px;border-top:1px solid #d7cfbf;font-size:12px;color:#9a9082">
+        <%= @app_name %><% if @plan_url %> ·
+        <a href="<%= @plan_url %>" style="color:#a5812c"><%= @plan_url %></a><% end %>
+      </p>
+    </div>
+  </body>
+</html>

data/app/mailers/bible270/broadcast.text.erb

@@ -0,0 +1,7 @@
+<%= @reader.first_name.presence || @reader.display_name %>,
+
+<%= @body %>
+
+--
+<%= @app_name %><% if @plan_url %>
+<%= @plan_url %><% end %>

data/app/mailers/bible270/notice_mailer.rb

@@ -31,6 +31,22 @@ module Bible270
            subject: "#{@app_name}: #{@author.display_name} mentioned you on day #{@comment.day}"
     end
 
+    # A message from whoever runs the plan to one reader. Sent individually rather
+    # than as one email with everyone in bcc: a bcc list of a hundred addresses is
+    # a spam signal, and it means nobody can be greeted by name or unsubscribe
+    # meaningfully.
+    def broadcast(reader_id:, subject:, body:)
+      @reader = Reader.find_by(id: reader_id)
+      return message.perform_deliveries = false if @reader.nil? || @reader.email.blank?
+      return message.perform_deliveries = false if subject.to_s.strip.empty? || body.to_s.strip.empty?
+
+      @body = body.to_s
+      @app_name = Bible270.config.app_name
+      @plan_url = plan_url
+
+      mail to: @reader.email, subject: subject.to_s.strip
+    end
+
   private
 
     # A mailer has no request, so the host is config.mailer_host or nothing. No
@@ -41,6 +57,10 @@ module Bible270
     # config.mount_at was worse than useless — ignored when blank, and overriding
     # the true prefix when not, so a config that disagreed with routes.rb would
     # have produced links to nowhere.
+    def plan_url
+      engine_url(:root_url)
+    end
+
     def day_url_for(day)
       engine_url(:day_url, day)
     end

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).
@@ -45,10 +49,37 @@ module Bible270
       image = first_present(dig_auth(info, :image), dig_auth(info, :avatar_url))
       reader.email      = email if email.present?
       reader.avatar_url = image if image.present?
+      assign_names_from(reader, info)
       reader.save
       reader
     end
 
+    # Providers hand back one display name far more often than two fields, so the
+    # name is split when they do not. Without this an OmniAuth reader had no
+    # first_name — which made the greeting read "Welcome ." and, more seriously,
+    # made them unmentionable: Reader.mentioned_in only considers readers who have
+    # one.
+    #
+    # Only filled in when empty, so a reader who has since corrected their name on
+    # their profile does not have it overwritten at every sign-in.
+    def self.assign_names_from(reader, info)
+      return if reader.first_name.present?
+
+      given = dig_auth(info, :first_name)
+      family = dig_auth(info, :last_name)
+
+      if given.present?
+        reader.first_name = given
+        reader.last_name = family
+        return
+      end
+
+      split = Names.split_display_name(reader.display_name)
+      reader.first_name = split ? split[:first_name] : reader.display_name.to_s.split.first
+      reader.last_name = split ? split[:last_name] : nil
+    end
+    private_class_method :assign_names_from
+
     # Find or create the reader behind a verified email address. Uses the same
     # provider/uid identity columns as OmniAuth, with provider "email", so an
     # email reader is indistinguishable from any other downstream.
@@ -137,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/index.html.erb

@@ -47,4 +47,31 @@
   <p style="color:var(--faint)">No readers yet.</p>
 <% end %>
 
+<div class="b270-panel">
+  <h2 class="b270-subhead">Write to everyone</h2>
+
+  <% if @reachable.zero? %>
+    <p class="b270-hint" style="margin-top:0">No reader has an email address yet.</p>
+  <% else %>
+    <p class="b270-hint" style="margin-top:0">
+      Goes to <strong><%= @reachable %></strong>
+      <%= @reachable == 1 ? 'reader' : 'readers' %> individually, not as one message with
+      everyone in bcc — so each is greeted by name.
+      <% if @last_broadcast_at.present? %>
+        <br>Last sent <%= b270_datetime(@last_broadcast_at) %><%
+          %><% if @last_broadcast_subject.present? %>: <em><%= @last_broadcast_subject %></em><% end %>.
+      <% end %>
+    </p>
+
+    <%= form_with url: admin_broadcast_path, method: :post, class: "b270-form",
+          data: { turbo_confirm: "Send this to #{@reachable} #{@reachable == 1 ? 'reader' : 'readers'}?" } do %>
+      <%= text_field_tag :subject, params[:subject], placeholder: "Subject", class: "b270-input" %>
+      <%= text_area_tag :body, params[:body], placeholder: "What would you like to say?", rows: 6 %>
+      <div class="row">
+        <%= submit_tag "Send", class: "b270-btn" %>
+      </div>
+    <% end %>
+  <% end %>
+</div>
+
 <p style="margin-top:18px"><%= link_to '← Back to the plan', root_path %></p>

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

@@ -92,6 +92,29 @@
   <%= render "bible270/shared/reflections", comments: @comments, moderate: true %>
 </div>
 
+<div class="b270-panel">
+  <h2 class="b270-subhead">Which translation they read</h2>
+  <p class="b270-hint" style="margin-top:0">
+    Reading links open in this translation.
+    <% if @reader.bible_version.blank? %>
+      They have expressed no preference, so they follow the site default
+      (<%= Bible270.config.bible_version %>).
+    <% end %>
+  </p>
+
+  <%= form_with url: admin_reader_version_path(@reader), method: :patch, class: "b270-form" do %>
+    <div class="row">
+      <%= select_tag :bible_version,
+            options_for_select([["Site default (#{Bible270.config.bible_version})", ""]] +
+                               Bible270::Translations.options,
+                               @reader.bible_version.to_s),
+            class: "b270-select", style: "width:auto" %>
+    </div>
+    <%= render "bible270/shared/passage_source", reader: @reader %>
+    <%= submit_tag "Save", class: "b270-btn" %>
+  <% end %>
+</div>
+
 <div class="b270-panel">
   <h2 class="b270-subhead">Remove</h2>
   <p class="b270-hint" style="margin-top:0">Deletes the reader together with every check-off and

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/notice_mailer/broadcast.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+  <body style="margin:0;padding:24px;background:#ece6da;font-family:-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#231f18">
+    <div style="max-width:520px;margin:0 auto;background:#f4efe6;border:1px solid #d7cfbf;border-radius:14px;padding:28px">
+      <p style="margin:0 0 16px;font-size:15px">
+        <%= @reader.first_name.presence || @reader.display_name %>,
+      </p>
+
+      <div style="font-size:15px;line-height:1.6"><%= simple_format(@body) %></div>
+
+      <p style="margin:24px 0 0;padding-top:16px;border-top:1px solid #d7cfbf;font-size:12px;color:#9a9082">
+        <%= @app_name %><% if @plan_url %> ·
+        <a href="<%= @plan_url %>" style="color:#a5812c"><%= @plan_url %></a><% end %>
+      </p>
+    </div>
+  </body>
+</html>

data/app/views/bible270/notice_mailer/broadcast.text.erb

@@ -0,0 +1,7 @@
+<%= @reader.first_name.presence || @reader.display_name %>,
+
+<%= @body %>
+
+--
+<%= @app_name %><% if @plan_url %>
+<%= @plan_url %><% end %>

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)}
@@ -183,6 +192,7 @@
   .b270-comment.b270-editing{background:rgba(165,129,44,.05);border-radius:10px;padding:12px}
   .b270-editing textarea{min-height:64px}
   .b270-cdel{font-size:12px;color:var(--oxblood);background:none;border:none;cursor:pointer;padding:0;margin-left:8px}
+  .b270-input{width:100%;padding:9px 11px;border:1px solid var(--line);border-radius:9px;background:#fff;font:inherit;font-size:14px;margin-bottom:8px}
   .b270-form textarea{width:100%;font:inherit;font-size:15px;border:1px solid var(--line);border-radius:10px;padding:11px 13px;background:#fff;resize:vertical;min-height:76px}
   .b270-form .row{display:flex;align-items:center;gap:10px;margin-top:10px}
   .b270 .b270-btn{border:none;border-radius:10px;padding:8px 16px;margin-top:4px;font:inherit;font-weight:600;font-size:14px;cursor:pointer;background:var(--ink);color:var(--paper);text-decoration:none;display:inline-block}

data/config/routes.rb

@@ -22,10 +22,12 @@ Bible270::Engine.routes.draw do
   delete 'admin/readers/:id',            to: 'admin#destroy'
   patch  'admin/readers/:id/profile',    to: 'admin#update_profile',   as: :admin_reader_profile
   delete 'admin/readers/:id/avatar',     to: 'admin#remove_avatar',    as: :admin_reader_avatar
+  patch  'admin/readers/:id/version',    to: 'admin#update_bible_version', as: :admin_reader_version
   patch  'admin/readers/:id/start',      to: 'admin#update_start',     as: :admin_reader_start
   patch  'admin/readers/:id/through',    to: 'admin#complete_through', as: :admin_reader_through
   post   'admin/readers/:id/days/:day',  to: 'admin#toggle_day',       as: :admin_reader_day
 
+  post   'admin/broadcast',              to: 'admin#broadcast',        as: :admin_broadcast
   patch  'admin/enrollment',             to: 'admin#update_enrollment', as: :admin_enrollment
   get    'admin/comments',               to: 'admin#comments',         as: :admin_comments
   patch  'admin/comments/:id/hide',      to: 'admin#hide_comment',     as: :admin_hide_comment

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.1'
+  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.1
+  version: 0.18.0
 platform: ruby
 authors:
 - Andrew vonderLuft
@@ -91,6 +91,8 @@ files:
 - app/controllers/bible270/sessions_controller.rb
 - app/helpers/bible270/plan_helper.rb
 - app/mailers/bible270/application_mailer.rb
+- app/mailers/bible270/broadcast.html.erb
+- app/mailers/bible270/broadcast.text.erb
 - app/mailers/bible270/notice_mailer.rb
 - app/mailers/bible270/sign_in_mailer.rb
 - app/models/bible270/application_record.rb
@@ -119,6 +121,8 @@ files:
 - app/views/bible270/days/show.html.erb
 - app/views/bible270/likes/_likes.html.erb
 - app/views/bible270/likes/toggle.turbo_stream.erb
+- app/views/bible270/notice_mailer/broadcast.html.erb
+- app/views/bible270/notice_mailer/broadcast.text.erb
 - app/views/bible270/notice_mailer/mentioned.html.erb
 - app/views/bible270/notice_mailer/mentioned.text.erb
 - app/views/bible270/notice_mailer/new_reader.html.erb
@@ -132,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
@@ -153,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
@@ -160,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
@@ -168,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