shiplog 0.1.1 → 0.3.0

data/app/frontend/shiplog/shiplog.css

@@ -67,6 +67,37 @@
   .shiplog-page__title { font-size: 1.875rem; line-height: 1.2; margin: 0; }
   .shiplog-page__lede { color: var(--sl-muted); margin: 0.5rem 0 0; }
 
+  /* Switcher: Roadmap / Changelog / host pages. It can sit outside .shiplog-page (host pages), so it
+     falls back to the host-safe palette when the page variables are not inherited. */
+  .shiplog-switcher {
+    --sw-border: var(--sl-border, var(--shiplog-border, color-mix(in srgb, currentColor 22%, transparent)));
+    --sw-card: var(--sl-card, var(--shiplog-card, color-mix(in srgb, currentColor 5%, transparent)));
+    --sw-muted: var(--sl-muted, var(--shiplog-muted, color-mix(in srgb, currentColor 65%, transparent)));
+    --sw-accent: var(--sl-accent, var(--shiplog-accent, #2f81f7));
+    background: var(--sw-card);
+    border: 1px solid var(--sw-border);
+    border-radius: 999px;
+    display: inline-flex;
+    flex-wrap: wrap;
+    font-size: 0.875rem;
+    font-weight: 500;
+    gap: 0.25rem;
+    margin-top: var(--sl-space, 1rem);
+    padding: 0.25rem;
+  }
+  .shiplog-switcher__link {
+    border-radius: 999px;
+    color: var(--sw-muted);
+    padding: 0.25rem 1rem;
+    text-decoration: none;
+    transition: background-color 0.15s, color 0.15s;
+  }
+  .shiplog-switcher__link:hover { color: inherit; }
+  .shiplog-switcher__link:focus-visible { outline: 2px solid var(--sw-accent); outline-offset: 2px; }
+  .shiplog-switcher__link--current,
+  .shiplog-switcher__link--current:hover { background: var(--sw-accent); color: #fff; }
+  @media (prefers-reduced-motion: reduce) { .shiplog-switcher__link { transition: none; } }
+
   .shiplog-empty,
   .shiplog-column__empty { color: var(--sl-muted); margin: 0; }
 
@@ -77,17 +108,21 @@
     grid-template-columns: repeat(auto-fit, minmax(min(16rem, 100%), 1fr));
   }
 
+  /* A rule on top and a marker carry the column's place in time: in progress is solid, coming soon
+     is the accent, later is neutral. */
   .shiplog-column {
     --sl-dot: var(--sl-muted);
+    --sl-rule: var(--sl-border);
+    border-top: 2px solid var(--sl-rule);
     min-width: 0;
+    padding-top: 1rem;
   }
-  .shiplog-column--in-progress { --sl-dot: #1a7f37; }
-  .shiplog-column--coming-soon { --sl-dot: var(--sl-accent); }
-  .shiplog-column--later { --sl-dot: var(--sl-muted); }
+  .shiplog-column--in-progress { --sl-dot: #1a7f37; --sl-rule: var(--sl-dot); }
+  .shiplog-column--coming-soon { --sl-dot: var(--sl-accent); --sl-rule: var(--sl-dot); }
+  .shiplog-column--later { --sl-dot: var(--sl-muted); --sl-rule: var(--sl-border); }
 
   .shiplog-column__header {
     align-items: baseline;
-    border-bottom: 1px solid var(--sl-border);
     display: flex;
     flex-wrap: wrap;
     gap: 0 0.5rem;
@@ -95,13 +130,14 @@
     padding-bottom: 0.75rem;
   }
   .shiplog-column__title { align-items: center; display: flex; font-size: 1.125rem; gap: 0.5rem; margin: 0; }
-  .shiplog-column__title::before {
+  .shiplog-column__marker {
     background: var(--sl-dot);
     border-radius: 50%;
-    content: "";
+    flex-shrink: 0;
     height: 0.625rem;
     width: 0.625rem;
   }
+  .shiplog-column__marker--in-progress { box-shadow: 0 0 0 4px color-mix(in srgb, var(--sl-dot) 20%, transparent); }
   .shiplog-column__count {
     background: var(--sl-card);
     border: 1px solid var(--sl-border);
@@ -116,7 +152,8 @@
   .shiplog-entries { display: grid; gap: 0.75rem; list-style: none; margin: 0; padding: 0; }
 
   .shiplog-card,
-  .shiplog-entry {
+  .shiplog-entry,
+  .shiplog-permalink {
     background: var(--sl-card);
     border: 1px solid var(--sl-border);
     border-radius: var(--sl-radius);
@@ -132,6 +169,58 @@
   .shiplog-entry__body p { margin: 0.25rem 0; }
   .shiplog-card__body { color: var(--sl-muted); font-size: 0.9375rem; }
 
+  .shiplog-card__meta {
+    align-items: center;
+    color: var(--sl-muted);
+    display: flex;
+    flex-wrap: wrap;
+    font-size: 0.75rem;
+    font-weight: 500;
+    gap: 0.5rem;
+    margin: 0.75rem 0 0;
+  }
+  .shiplog-card__tag {
+    border: 1px solid var(--sl-border);
+    border-radius: 0.375rem;
+    padding: 0 0.5rem;
+  }
+
+  /* Recently shipped: a title, a link to the full changelog, then a grid of the latest entries */
+  .shiplog-shipped {
+    align-items: baseline;
+    border-top: 1px solid var(--sl-border);
+    display: grid;
+    gap: 0.5rem 1rem;
+    grid-template-columns: 1fr auto;
+    margin-top: calc(var(--sl-space) * 2.5);
+    padding-top: calc(var(--sl-space) * 1.5);
+  }
+  .shiplog-shipped__title { font-size: 1.125rem; margin: 0; }
+  .shiplog-shipped__list {
+    display: grid;
+    gap: var(--sl-space) calc(var(--sl-space) * 1.5);
+    grid-column: 1 / -1;
+    grid-template-columns: repeat(auto-fit, minmax(min(12rem, 100%), 1fr));
+    list-style: none;
+    margin: 0;
+    padding: 0;
+  }
+  .shiplog-shipped__item { display: grid; gap: 0.25rem; align-content: start; }
+  .shiplog-shipped__date { color: var(--sl-muted); font-size: 0.75rem; }
+  .shiplog-shipped__link { color: inherit; font-weight: 600; text-decoration: none; }
+  .shiplog-shipped__link:hover { color: var(--sl-accent); }
+  .shiplog-shipped__link--all { color: var(--sl-accent); font-size: 0.875rem; font-weight: 500; }
+
+  .shiplog-footnote {
+    border-top: 1px solid var(--sl-border);
+    color: var(--sl-muted);
+    font-size: 0.875rem;
+    margin: calc(var(--sl-space) * 2) 0 0;
+    padding-top: var(--sl-space);
+    text-align: center;
+  }
+  .shiplog-footnote__link { color: var(--sl-accent); font-weight: 500; }
+
   /* Changelog: months hang off a vertical line */
   .shiplog-months { display: grid; gap: calc(var(--sl-space) * 2); }
 
@@ -153,10 +242,14 @@
     width: 0.75rem;
   }
 
-  .shiplog-entry { align-items: center; display: flex; flex-wrap: wrap; gap: 0.25rem 0.625rem; }
+  .shiplog-entry,
+  .shiplog-permalink { align-items: center; display: flex; flex-wrap: wrap; gap: 0.25rem 0.625rem; }
   .shiplog-entry__title,
   .shiplog-entry__body { flex-basis: 100%; }
   .shiplog-entry__title { font-size: 1rem; margin: 0.25rem 0 0; }
+  .shiplog-entry__title a { color: inherit; text-decoration: none; }
+  .shiplog-entry__title a:hover { color: var(--sl-accent); text-decoration: underline; }
+  .shiplog-entry__title a:focus-visible { outline: 2px solid var(--sl-accent); outline-offset: 2px; }
   .shiplog-entry__body { color: var(--sl-muted); }
   .shiplog-entry__date { color: var(--sl-muted); font-size: 0.8125rem; }
 
@@ -168,6 +261,9 @@
     font-weight: 600;
     padding: 0 0.5rem;
   }
+  .shiplog-permalink .shiplog-entry__title { font-size: 1.5rem; }
+  .shiplog-permalink--feature { border-left: 4px solid var(--sl-accent); }
+  .shiplog-permalink--feature .shiplog-entry__category { background: var(--sl-accent); border-color: var(--sl-accent); color: #fff; }
   .shiplog-entry--feature { border-left: 4px solid var(--sl-accent); padding: var(--sl-space) calc(var(--sl-space) * 1.25); }
   .shiplog-entry--feature .shiplog-entry__title { font-size: 1.25rem; }
   .shiplog-entry--feature .shiplog-entry__category { background: var(--sl-accent); border-color: var(--sl-accent); color: #fff; }
@@ -176,6 +272,70 @@
   .shiplog-pagination__link { color: var(--sl-accent); }
   .shiplog-pagination__link--older { margin-left: auto; }
 
+  .shiplog-permalink__back { color: var(--sl-accent); display: inline-block; margin-top: var(--sl-space); }
+  .shiplog-permalink__nav {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--sl-space);
+    justify-content: space-between;
+    margin-top: calc(var(--sl-space) * 2);
+  }
+  .shiplog-permalink__nav-link { color: var(--sl-accent); }
+  .shiplog-permalink__nav-link--older { margin-left: auto; text-align: right; }
+  .shiplog-permalink__back:focus-visible,
+  .shiplog-permalink__nav-link:focus-visible { outline: 2px solid var(--sl-accent); outline-offset: 2px; }
+
+  .shiplog-entry__area {
+    color: var(--sl-muted);
+    font-size: 0.75rem;
+    font-weight: 600;
+    letter-spacing: 0.02em;
+    text-transform: uppercase;
+  }
+
+  .shiplog-entry__images { display: grid; flex-basis: 100%; gap: 0.75rem; margin-top: 0.5rem; }
+  .shiplog-entry__image { border: 1px solid var(--sl-border); border-radius: 0.5rem; display: block; height: auto; max-width: 100%; }
+
+  .shiplog-areas { display: flex; flex-wrap: wrap; gap: 0.5rem; margin: var(--sl-space) 0; }
+  .shiplog-areas__link {
+    border: 1px solid var(--sl-border);
+    border-radius: 1rem;
+    color: var(--sl-fg);
+    font-size: 0.875rem;
+    padding: 0.125rem 0.75rem;
+    text-decoration: none;
+  }
+  .shiplog-areas__link:hover { border-color: var(--sl-accent); }
+  .shiplog-areas__link:focus-visible { outline: 2px solid var(--sl-accent); outline-offset: 2px; }
+  .shiplog-areas__link--current { background: var(--sl-accent); border-color: var(--sl-accent); color: #fff; }
+
+  .shiplog-search { display: flex; flex-wrap: wrap; gap: 0.5rem; margin: var(--sl-space) 0; }
+  .shiplog-search__input {
+    flex: 1 1 14rem;
+    min-width: 0;
+    font: inherit;
+    color: inherit;
+    background: var(--sl-card);
+    border: 1px solid var(--sl-border);
+    border-radius: var(--sl-radius);
+    padding: 0.4rem 0.75rem;
+  }
+  .shiplog-search__input:focus-visible,
+  .shiplog-search__button:focus-visible,
+  .shiplog-search__clear:focus-visible { outline: 2px solid var(--sl-accent); outline-offset: 2px; }
+  .shiplog-search__button {
+    font: inherit;
+    color: #fff;
+    background: var(--sl-accent);
+    border: 1px solid var(--sl-accent);
+    border-radius: var(--sl-radius);
+    padding: 0.4rem 1rem;
+    cursor: pointer;
+  }
+  .shiplog-search__summary { color: var(--sl-muted); margin: 0 0 var(--sl-space); }
+  .shiplog-search__clear { color: var(--sl-accent); margin-left: 0.5rem; }
+  .shiplog-search__empty { color: var(--sl-muted); margin: 0; }
+
   @media (max-width: 40rem) {
     .shiplog-page { padding: var(--sl-space) 0.75rem; }
     .shiplog-page__title { font-size: 1.5rem; }

data/app/helpers/shiplog/admin/entries_helper.rb

@@ -19,6 +19,21 @@ module Shiplog
         entry.title.presence || source_title(entry.subject)
       end
 
+      # The URL of an image's thumbnail: a 200x200 variant when the host can make them (image_processing and a
+      # processor, see Shiplog.image_variants?), else the original (the stylesheet sizes it).
+      def image_thumbnail_path(image)
+        source = Shiplog.image_variants? && image.variable? ? image.variant(resize_to_limit: [ 200, 200 ]) : image
+        polymorphic_path(source)
+      rescue ActionController::UrlGenerationError, NoMethodError, ArgumentError
+        nil
+      end
+
+      # "Spanish (es)" for a locale of config.locales; the code alone when Shiplog has no name for the language.
+      def translation_language_label(locale)
+        name = Shiplog::Translator.language_name(locale)
+        name == locale.to_s ? name : "#{name} (#{locale})"
+      end
+
       def entries_filter_path(status: nil, kind: nil, page: nil)
         root_path({ status:, kind:, page: }.compact_blank)
       end

data/app/helpers/shiplog/callable_helper.rb

@@ -0,0 +1,12 @@
+module Shiplog
+  module CallableHelper
+    # A config value that is a String, or a callable evaluated in the view so it can use route helpers
+    # and I18n (`-> { main_app.news_path }`, `-> { t("...") }`).
+    def shiplog_resolve(value)
+      case value
+      when Proc then instance_exec(&value)
+      else value.respond_to?(:call) ? value.call : value
+      end
+    end
+  end
+end

data/app/helpers/shiplog/frontend_helper.rb

@@ -1,6 +1,7 @@
 module Shiplog
   module FrontendHelper
     def shiplog_stylesheet_tag(name)
+      @_shiplog_stylesheet_emitted = true if name == "shiplog" # shiplog_switcher then skips its own link
       tag.link rel: "stylesheet", href: shiplog_asset_path("#{name}.css"), nonce: content_security_policy_nonce
     end
 

data/app/helpers/shiplog/permalink_helper.rb

@@ -0,0 +1,113 @@
+module Shiplog
+  # Markup helpers of the permalink pages, the Atom feed and the entries' screenshots.
+  module PermalinkHelper
+    DESCRIPTION_LENGTH = 160
+
+    # The path of an entry's permalink page, or nil when the entry has no slug the route accepts (a link is
+    # an extra, never a reason to fail the page).
+    def shiplog_entry_path(entry)
+      changelog_entry_path(entry.slug) if entry.permalink?
+    rescue ActionController::UrlGenerationError
+      nil
+    end
+
+    # The absolute URL of a named engine route: config.canonical_url plus the route's path (which carries the
+    # engine's mount prefix) when it is set, the request's own origin otherwise.
+    #   shiplog_absolute_url(:changelog_feed)  # => "https://trackberry.com/changelog.atom"
+    def shiplog_absolute_url(route, *args)
+      canonical = Shiplog.config.canonical_url
+      canonical ? "#{canonical}#{public_send("#{route}_path", *args)}" : public_send("#{route}_url", *args)
+    end
+
+    # The absolute URL of an entry's permalink page, or nil when it has no valid slug.
+    def shiplog_entry_url(entry)
+      shiplog_absolute_url(:changelog_entry, entry.slug) if shiplog_entry_path(entry)
+    end
+
+    # The authority of the feed's tag URIs: the canonical host, else the request's.
+    def shiplog_tag_host
+      canonical = Shiplog.config.canonical_url
+      canonical ? URI.parse(canonical).host : request.host
+    end
+
+    # A link to an entry's permalink page, or the plain content in a span when it has none.
+    def shiplog_entry_link(entry, name = nil, html_options = {}, &block)
+      name, html_options = capture(&block), name || {} if block
+      path = shiplog_entry_path(entry)
+      path ? link_to(name, path, html_options) : content_tag(:span, name, html_options.slice(:class))
+    end
+
+    # The id of a month's section on the changelog list.
+    def shiplog_month_anchor(date) = "shiplog-month-#{date.strftime("%Y-%m")}"
+
+    # The body, on one line and cut for a meta description. Plain text: tag helpers escape it.
+    def shiplog_entry_description(entry)
+      truncate(entry.display_body.to_s.squish, length: DESCRIPTION_LENGTH, separator: " ")
+    end
+
+    # The Open Graph meta tags of a permalink page, for `content_for :shiplog_og`.
+    def shiplog_og_tags(entry, url:)
+      tags = {
+        "og:title" => entry.display_title, "og:description" => shiplog_entry_description(entry),
+        "og:type" => "article", "og:url" => url, "og:image" => shiplog_entry_og_image(entry)
+      }
+      safe_join(tags.compact_blank.map { |property, content| tag.meta(property:, content:) }, "\n")
+    end
+
+    # The absolute URL of the image to show when the page is shared (the first image), or nil.
+    def shiplog_entry_og_image(entry)
+      image = shiplog_images(entry).first
+      shiplog_image_url(image) if image
+    end
+
+    # The HTML of an entry in the Atom feed: its text, then its images with absolute URLs.
+    def shiplog_feed_content(entry)
+      images = shiplog_images(entry).filter_map do |image|
+        url = shiplog_image_url(image)
+        tag.p(tag.img(src: url, alt: entry.image_alt(image), **shiplog_image_size(image))) if url
+      end
+      safe_join([ simple_format(h(entry.display_body)), *images ], "\n")
+    end
+
+    # An entry's images in order, or none while screenshots are off.
+    def shiplog_images(entry)
+      Shiplog.images? ? entry.ordered_images : []
+    end
+
+    # The images of an entry under its body: `limit` of them (all by default). Nil when it has none to show.
+    def shiplog_entry_images(entry, limit: nil)
+      images = shiplog_images(entry)
+      images = images.first(limit) if limit
+      tags = images.filter_map do |image|
+        path = shiplog_image_path(image)
+        tag.img(src: path, alt: entry.image_alt(image), loading: "lazy", class: shiplog_class(:entry_image), **shiplog_image_size(image)) if path
+      end
+      tag.div(safe_join(tags), class: shiplog_class(:entry_images)) if tags.any?
+    end
+
+    # Active Storage's routes belong to the host: url_for reaches them through main_app (see HostRoutesHelper).
+    # Nil when the host can't build the route.
+    def shiplog_image_path(image)
+      polymorphic_path(image)
+    rescue ActionController::UrlGenerationError, NoMethodError, ArgumentError
+      nil
+    end
+
+    # The image's absolute URL: config.canonical_url plus its path when set, the request's origin otherwise.
+    def shiplog_image_url(image)
+      canonical = Shiplog.config.canonical_url
+      return polymorphic_url(image) unless canonical
+
+      path = shiplog_image_path(image)
+      "#{canonical}#{path}" if path
+    rescue ActionController::UrlGenerationError, NoMethodError, ArgumentError
+      nil
+    end
+
+    # width and height from the blob's analysis, when it has run and found them.
+    def shiplog_image_size(image)
+      metadata = image.blob.metadata
+      { width: metadata[:width], height: metadata[:height] }.select { |_, value| value.to_i.positive? }
+    end
+  end
+end

data/app/helpers/shiplog/roadmap_helper.rb

@@ -0,0 +1,24 @@
+module Shiplog
+  module RoadmapHelper
+    include Shiplog::SwitcherHelper
+
+    # English texts of the roadmap columns, used when the host's locale has no shiplog.columns translations.
+    COLUMN_DEFAULTS = {
+      in_progress: { title: "In progress", description: "What we're building now" },
+      coming_soon: { title: "Coming soon", description: "Planned next" },
+      later: { title: "Later", description: "On our radar" }
+    }.freeze
+
+    def shiplog_column_defaults = COLUMN_DEFAULTS
+
+    # The configured label of a repository (config.repository_labels, matched case-insensitively), or nil.
+    def shiplog_repository_label(repository)
+      labels = Shiplog.config.repository_labels
+      label = labels[repository.full_name] || labels.find { |name, _| name.casecmp?(repository.full_name) }&.last
+      shiplog_resolve(label).presence
+    end
+
+    # The "suggest a feature" target (String or callable), or nil.
+    def shiplog_feedback_path = shiplog_safe_url(shiplog_resolve(Shiplog.config.feedback_path))
+  end
+end

data/app/helpers/shiplog/switcher_helper.rb

@@ -0,0 +1,101 @@
+module Shiplog
+  # The Roadmap / Changelog / extra pages switcher. The default page header renders it, and a host adds
+  # `helper Shiplog::SwitcherHelper` to render it on its own pages (e.g. a news page): `<%= shiplog_switcher %>`.
+  # It uses the engine's own route helpers, or the proxy of the host's mount (whatever its `as:`), so it works in
+  # main-app views too.
+  module SwitcherHelper
+    include Shiplog::StylingHelper
+    include Shiplog::CallableHelper
+
+    # URLs already warned about. Capped, since a callable path could return a new bad URL on every request.
+    WARNED = Set.new
+    MAX_WARNED = 100
+    private_constant :WARNED, :MAX_WARNED
+
+    def self.reset_warnings! = WARNED.clear
+
+    NotMounted = Class.new(StandardError)
+
+    # The name the host gave the engine's mount in its routes (`mount Shiplog::Engine => "/", as: :updates`; the
+    # default is "shiplog"), which is the name of its route proxy in host views. Found by looking for the route
+    # of config/routes.rb whose Rack app is the engine (the Constraints wrapper's `app`; Rails::Engine is what
+    # `mount` stores) and remembered while that route exists.
+    def self.mount_name
+      cached = @mount_name
+      return cached if cached && Rails.application.routes.named_routes.key?(cached)
+
+      route = Rails.application.routes.routes.find { |candidate| candidate.app.try(:app) == Shiplog::Engine }
+      raise NotMounted, "Shiplog::Engine is not mounted in the host's routes: add `mount Shiplog::Engine => \"/\"` to config/routes.rb" unless route&.name
+
+      @mount_name = route.name
+    end
+
+    def self.reset_mount_name! = (@mount_name = nil)
+
+    # The switcher for host pages: the bundled stylesheet (once per page, and not when the engine page already
+    # linked it; unless config.stylesheet is false) and the nav.
+    def shiplog_switcher
+      stylesheet = if Shiplog.config.stylesheet && !@_shiplog_stylesheet_emitted
+        @_shiplog_stylesheet_emitted = true
+        tag.link(rel: "stylesheet", nonce: content_security_policy_nonce,
+          href: shiplog_routes.frontend_path(version: Shiplog::VERSION, name: "shiplog.css"))
+      end
+      safe_join([ stylesheet, render("shiplog/switcher") ])
+    end
+
+    # The nav's aria-label: a plain String (never html_safe markup, never a translation-missing span).
+    def shiplog_switcher_label = String.new(I18n.t("shiplog.switcher.label", default: "Product updates"))
+
+    # [{ label:, path:, current: }] in display order. A path with an unsafe scheme is nil (rendered as text).
+    # Only the page with the longest matching path is current.
+    def shiplog_switcher_pages
+      pages = [
+        { label: t("shiplog.switcher.roadmap", default: "Roadmap"), path: shiplog_routes.roadmap_path },
+        { label: t("shiplog.switcher.changelog", default: "Changelog"), path: shiplog_routes.changelog_path },
+        *Shiplog.config.extra_pages.map { |page| { label: shiplog_resolve(page[:label]), path: shiplog_safe_url(shiplog_resolve(page[:path])) } }
+      ]
+      lengths = pages.map { |page| shiplog_match_length(page[:path]) }
+      best = lengths.compact.max
+      current = best && lengths.index(best)
+      pages.each_with_index.map { |page, index| page.merge(current: index == current) }
+    end
+
+    # The URL when it is safe to link (see Configuration.safe_url?); otherwise nil, with a warning logged once.
+    def shiplog_safe_url(url)
+      return if url.blank?
+      return url.to_s if Shiplog::Configuration.safe_url?(url)
+
+      if WARNED.size < MAX_WARNED && WARNED.add?(url.to_s)
+        Rails.logger.warn("[Shiplog] Not linking #{url.inspect}: only paths, http(s) and mailto: URLs are allowed")
+      end
+      nil
+    end
+
+    private
+
+    # Where the engine's route helpers live: the view itself inside the engine's own pages, otherwise (host pages)
+    # the proxy the host's mount defined, whatever its name.
+    def shiplog_routes
+      return self if controller.try(:_routes) == Shiplog::Engine.routes
+
+      public_send(SwitcherHelper.mount_name)
+    end
+
+    # Length of the link's path when it contains the request path (equal, or a parent segment), else nil.
+    # An absolute URL counts only for http(s) and the request's own host.
+    def shiplog_match_length(url)
+      return if url.nil?
+
+      uri = URI.parse(url)
+      return if uri.scheme && !(uri.scheme.match?(/\Ahttps?\z/i) && uri.host.to_s.casecmp?(request.host))
+
+      prefix = (uri.path || "").chomp("/")
+      current = request.path.to_s.chomp("/")
+      return (prefix.length if current == prefix) if prefix.empty?
+
+      prefix.length if current == prefix || current.start_with?("#{prefix}/")
+    rescue URI::InvalidURIError
+      nil
+    end
+  end
+end

data/app/helpers/shiplog/unseen_helper.rb

@@ -0,0 +1,9 @@
+module Shiplog
+  # The "what's new" count for host views: `helper Shiplog::UnseenHelper`, then
+  # `shiplog_unseen_count(current_user.changelog_seen_at)`. Shiplog doesn't know about users, so the host
+  # supplies the "last seen" time (and stamps it from config.on_changelog_seen).
+  module UnseenHelper
+    # The number of approved features and changes approved after `since` (all of them while it is nil), at most 99.
+    def shiplog_unseen_count(since) = Shiplog.unseen_count(since:)
+  end
+end

data/app/jobs/shiplog/detect_areas_job.rb

@@ -0,0 +1,18 @@
+module Shiplog
+  # Backfills product areas for entries that have none (see AreaDetector). Enqueued by the admin's Areas page.
+  # A failure is logged and recorded for the Areas page (Setting "area_detection"), never raised: the job is not
+  # retried, the admin clicks again once the cause (usually the rewriter) is fixed.
+  class DetectAreasJob < ApplicationJob
+    SETTING = "area_detection".freeze
+    MAX_ERROR_CHARS = 500
+
+    # recheck: true first makes the entries the AI left unplaced eligible again.
+    def perform(recheck: false)
+      assigned = AreaDetector.new.call(recheck:)
+      Setting.write(SETTING, at: Time.current.iso8601, assigned:) if assigned # nil: another run was in progress
+    rescue StandardError => error
+      Rails.logger.error("[shiplog] Detect areas failed: #{error.class}: #{error.message}\n#{error.backtrace&.first(5)&.join("\n")}")
+      Setting.write(SETTING, at: Time.current.iso8601, error: "#{error.class}: #{error.message}".truncate(MAX_ERROR_CHARS))
+    end
+  end
+end

data/app/jobs/shiplog/refresh_job.rb

@@ -15,6 +15,7 @@ module Shiplog
       when "pull_request" then import(repository, number, Github::Queries::PULL_REQUEST, "pullRequest", Sync::PullRequestImporter)
       else raise ArgumentError, "Unknown kind: #{kind.inspect}"
       end
+      Sync::UpgradeDetector.call_isolated(repository) if kind.to_s == "pull_request"
       Drafter.call
     end
 

data/app/jobs/shiplog/rewrite_entry_job.rb

@@ -2,8 +2,11 @@ module Shiplog
   class RewriteEntryJob < ApplicationJob
     discard_on ActiveRecord::RecordNotFound
 
+    # After writing the draft, screenshots from the GitHub body are attached to a draft that has none (the
+    # fetcher checks, never raises, and leaves approved entries alone).
     def perform(entry_id, force: false)
-      Rewriter.new(Entry.find(entry_id)).call(force:)
+      entry = Rewriter.new(Entry.find(entry_id)).call(force:)
+      ImageFetcher.call(entry)
     end
   end
 end

data/app/jobs/shiplog/scan_changes_job.rb

@@ -2,9 +2,13 @@ module Shiplog
   class ScanChangesJob < ApplicationJob
     DEFAULT_WINDOW = 7.days
 
+    # Where a repository's next scan starts, and so the oldest merge nothing will draft before: the end of the
+    # last scan, or DEFAULT_WINDOW ago for a repository never scanned.
+    def self.window_start(repository) = repository.changes_scanned_at || DEFAULT_WINDOW.ago
+
     def perform
       client = Github::Client.new
-      Shiplog.config.repositories.each do |full_name|
+      Shiplog.config.repository_names.each do |full_name|
         scan(Repository.find_or_create_by!(full_name:), client)
       end
       Drafter.call
@@ -12,19 +16,29 @@ module Shiplog
 
     private
       def scan(repository, client)
-        since = repository.changes_scanned_at || DEFAULT_WINDOW.ago
+        since = self.class.window_start(repository)
         started_at = Time.current
         # Import late-synced PRs first so anything merged before `started_at` is visible to the scan.
         Sync::RepositorySync.new(repository, client:).call
-        Sync::CommitScanner.new(repository, client:).call(since:)
-        draft_changes(ChangeCandidates.new(repository:, since:, before: started_at).to_a)
-        repository.update!(changes_scanned_at: started_at)
+        if Shiplog.config.changelog_repository?(repository.full_name)
+          Sync::CommitScanner.new(repository, client:).call(since:)
+          draft_changes(ChangeCandidates.new(repository:, since:, before: started_at).to_a)
+        end
+        repository.update!(changes_scanned_at: window_end(repository, started_at, since))
       rescue Github::RateLimited
         raise
       rescue StandardError => error
         Rails.error.report(error, handled: true, context: { repository: repository.full_name })
       end
 
+      # Pull requests of this window that await upgrade detection are held back by ChangeCandidates, so the window
+      # stays at the oldest one and the next scan reconsiders it once it is checked. It never ends before `since`:
+      # older pending pull requests are outside the window, and the window must not move backwards.
+      def window_end(repository, started_at, since)
+        oldest_pending = Shiplog.config.changelog_repository?(repository.full_name) ? ChangeCandidates.oldest_pending(repository, since:) : nil
+        [ [ started_at, oldest_pending ].compact.min, since ].max
+      end
+
       def draft_changes(candidates)
         candidates.each { |subject| Drafter.draft(subject, "change", released_on: released_on(subject)) }
       end

data/app/jobs/shiplog/sync_job.rb

@@ -2,7 +2,7 @@ module Shiplog
   class SyncJob < ApplicationJob
     def perform
       client = Github::Client.new
-      repositories = Shiplog.config.repositories.map { |full_name| Repository.find_or_create_by!(full_name:) }
+      repositories = Shiplog.config.repository_names.map { |full_name| Repository.find_or_create_by!(full_name:) }
       repositories.each { |repository| sync(repository, client) }
       Drafter.call
     end

data/app/jobs/shiplog/translate_area_job.rb

@@ -0,0 +1,25 @@
+module Shiplog
+  # Translates an area's name into every locale of config.locales with one LLM call (see AreaTranslator).
+  # Enqueued when an area is created or renamed, by "Translate names" (with `force: true`) and by
+  # `shiplog:translate_approved`. Without force a locale that has a name is left alone, an admin's edit included;
+  # a repeat when every locale has one makes no LLM call.
+  #
+  # A failure (the rewriter raised, or its reply was unusable) is logged and retried twice, with a growing wait,
+  # then logged again and dropped: never an endless retry. The English name stays shown meanwhile.
+  class TranslateAreaJob < ApplicationJob
+    ATTEMPTS = 3
+
+    retry_on StandardError, attempts: ATTEMPTS, wait: :polynomially_longer do |job, error|
+      Rails.logger.error("[shiplog] Giving up translating area #{job.arguments.first.try(:id)} after #{ATTEMPTS} attempts: #{error.class}: #{error.message}")
+    end
+    # Declared after retry_on, which makes it win: an area deleted since the job was enqueued is not an error.
+    discard_on ActiveJob::DeserializationError, ActiveRecord::RecordNotFound
+
+    def perform(area, force: false)
+      AreaTranslator.new(area).call(force:)
+    rescue StandardError => error
+      Rails.logger.error("[shiplog] Translating area #{area.id} failed (attempt #{executions} of #{ATTEMPTS}): #{error.class}: #{error.message}")
+      raise
+    end
+  end
+end