shiplog 0.3.2 → 0.4.0

data/lib/shiplog/configuration.rb

@@ -8,6 +8,7 @@ module Shiplog
       :roadmap_path
 
     ADMIN_CHROMES = %i[standalone hosted].freeze
+    ANNOUNCEMENT_MODES = [ :page, :external, false ].freeze
     # Segments of only dots ("." and "..") are path traversal, not names.
     REPOSITORY_NAME = %r{\A(?!\.+/)[\w.-]+/(?!\.+\z)[\w.-]+\z}
     REPOSITORY_OPTION_KEYS = %i[name changelog gem].freeze
@@ -59,6 +60,44 @@ module Shiplog
     attr_reader :images, :max_images_per_entry
     LOCALE_FORMAT = /\A[A-Za-z][A-Za-z0-9_-]*\z/
 
+    # Monthly announcements (see Shiplog::Announcements). `announcements` is where they are published:
+    #   :page      (default) Shiplog renders /changelog/2026-10, links it from the changelog's month heading and
+    #              puts it in the Atom feed;
+    #   :external  no Shiplog page: the month heading links to `announcement_url`, and the host publishes the text
+    #              itself (on_announcement_approved);
+    #   false      no announcements at all: nothing is drafted, rendered or announced.
+    attr_reader :announcements
+    # Where an announcement is published when `announcements` is :external: a callable
+    # `->(announcement, locale) { url }` evaluated in the view (instance_exec, so `main_app` route helpers work).
+    # A nil or unsafe result renders no link. Not part of the ETag: bump cache_version when its output changes.
+    attr_reader :announcement_url
+    # Called with the announcement (a Shiplog::Entry) once it is approved and every configured locale has a current
+    # translation, from Shiplog::AnnounceJob. Once per approval: an announcement regenerated and approved again
+    # is announced again. An `announcement_approved.shiplog` ActiveSupport notification is sent at the same time.
+    attr_reader :on_announcement_approved
+
+    # The newsletter (see Shiplog::Newsletter): the approved announcement emailed to the host's users who opted in
+    # and to the visitors who subscribed through Shiplog's form. Off by default, and nothing without announcements.
+    attr_reader :newsletter
+    # A callable returning the host's recipients, each responding to #email, #locale and #id (an Active Record
+    # relation is read in batches with find_each). Shiplog never stores them.
+    attr_reader :newsletter_recipients
+    # `->(recipient) { url }`: the host's own unsubscribe or settings page, linked in the footer for its users. The
+    # one-click unsubscribe (List-Unsubscribe-Post) always goes through Shiplog's endpoint, which calls
+    # on_newsletter_unsubscribe. Without it the footer links Shiplog's unsubscribe page.
+    attr_reader :newsletter_unsubscribe_url
+    # `->(email) { ... }`, called on every unsubscribe (one-click, the footer link or the preferences page), so the
+    # host turns its own user's setting off. Errors are logged, never shown to the visitor.
+    attr_reader :on_newsletter_unsubscribe
+    # The sender, e.g. "Acme <updates@acme.com>" (also used by the confirmation email); the postal address the
+    # footer carries (CAN-SPAM requires one); the logo (an http(s) URL) and the accent colour ("#rrggbb") of the
+    # email; extra ActionMailer options for every newsletter message, e.g. { message_stream: "broadcast" } for a
+    # Postmark broadcast stream; how many recipients a job claims at a time (default 500).
+    attr_reader :newsletter_from, :newsletter_address, :newsletter_logo_url, :newsletter_accent,
+      :newsletter_mailer_options, :newsletter_batch_size
+    ACCENT_FORMAT = /\A#(?:\h{3}|\h{6})\z/
+    MAX_NEWSLETTER_BATCH_SIZE = 10_000
+
     EXTRA_PAGE_KEYS = %i[label path].freeze
 
     # A path (not "//host", "/\host" or "/ x", which browsers read as other targets), an http(s) URL or mailto:.
@@ -78,7 +117,8 @@ module Shiplog
         stylesheet, roadmap_shipped_count, cache_version, product_name, canonical_url,
         extra_pages.map { |page| [ stable.(page[:label]), stable.(page[:path]) ] },
         repository_labels.sort_by { |name, _| name.to_s }.map { |name, label| [ name, stable.(label) ] },
-        stable.(feedback_path), changelog_search, images, max_images_per_entry, locales, structured_data, stable.(og_image)
+        stable.(feedback_path), changelog_search, images, max_images_per_entry, locales, structured_data, stable.(og_image),
+        announcements.to_s, stable.(announcement_url), newsletter
       ]
       Digest::SHA256.hexdigest(JSON.generate(data))
     end
@@ -169,11 +209,90 @@ module Shiplog
       @og_image = value
     end
 
+    def announcements=(value)
+      mode = value.is_a?(String) ? value.to_sym : value
+      unless ANNOUNCEMENT_MODES.include?(mode)
+        raise ArgumentError, "announcements must be :page, :external or false, got #{value.inspect}"
+      end
+      @announcements = mode
+    end
+
+    def announcement_url=(value)
+      raise ArgumentError, "announcement_url must be nil or a callable like ->(announcement, locale) { url }, got #{value.inspect}" unless value.nil? || value.respond_to?(:call)
+      @announcement_url = value
+    end
+
+    def on_announcement_approved=(value)
+      raise ArgumentError, "on_announcement_approved must be nil or a callable like ->(announcement) { ... }, got #{value.inspect}" unless value.nil? || value.respond_to?(:call)
+      @on_announcement_approved = value
+    end
+
     def on_changelog_seen=(value)
       raise ArgumentError, "on_changelog_seen must be nil or a callable, got #{value.inspect}" unless value.nil? || value.respond_to?(:call)
       @on_changelog_seen = value
     end
 
+    def newsletter=(value)
+      raise ArgumentError, "newsletter must be true or false, got #{value.inspect}" unless [ true, false ].include?(value)
+      @newsletter = value
+    end
+
+    def newsletter_recipients=(value)
+      raise ArgumentError, "newsletter_recipients must be nil or a callable like -> { User.where(newsletter: true) }, got #{value.inspect}" unless value.nil? || value.respond_to?(:call)
+      @newsletter_recipients = value
+    end
+
+    def newsletter_unsubscribe_url=(value)
+      raise ArgumentError, "newsletter_unsubscribe_url must be nil or a callable like ->(recipient) { url }, got #{value.inspect}" unless value.nil? || value.respond_to?(:call)
+      @newsletter_unsubscribe_url = value
+    end
+
+    def on_newsletter_unsubscribe=(value)
+      raise ArgumentError, "on_newsletter_unsubscribe must be nil or a callable like ->(email) { ... }, got #{value.inspect}" unless value.nil? || value.respond_to?(:call)
+      @on_newsletter_unsubscribe = value
+    end
+
+    def newsletter_from=(value)
+      @newsletter_from = optional_string!(:newsletter_from, value, 'like "Acme <updates@acme.com>"')
+    end
+
+    def newsletter_address=(value)
+      @newsletter_address = optional_string!(:newsletter_address, value, "(the sender's postal address)")
+    end
+
+    def newsletter_logo_url=(value)
+      url = optional_string!(:newsletter_logo_url, value, "with an http(s) URL")
+      raise ArgumentError, "newsletter_logo_url must be an http(s) URL, got #{value.inspect}" if url && !url.match?(%r{\Ahttps?://\S+\z}i)
+      @newsletter_logo_url = url
+    end
+
+    def newsletter_accent=(value)
+      colour = optional_string!(:newsletter_accent, value, 'like "#0969da"')
+      raise ArgumentError, "newsletter_accent must be a hex colour like \"#0969da\", got #{value.inspect}" if colour && !ACCENT_FORMAT.match?(colour)
+      @newsletter_accent = colour&.downcase
+    end
+
+    # Merged into every newsletter message's `mail(...)` call: ActionMailer options (delivery_method,
+    # delivery_method_options) or headers your delivery gem reads (Postmark's message_stream). Keys that would
+    # change who receives the message or what it says are refused.
+    RESERVED_MAILER_OPTIONS = %i[to cc bcc from reply_to sender return_path subject body template_name template_path parts_order content_type charset mime_version date].freeze
+
+    def newsletter_mailer_options=(value)
+      options = value.nil? ? {} : value
+      raise ArgumentError, "newsletter_mailer_options must be a Hash like { message_stream: \"broadcast\" }, got #{value.inspect}" unless options.is_a?(Hash)
+      options = options.transform_keys { |key| key.to_s.to_sym }
+      reserved = options.keys & RESERVED_MAILER_OPTIONS
+      raise ArgumentError, "newsletter_mailer_options cannot set #{reserved.map(&:inspect).join(", ")}: the recipient, sender and content of a newsletter are Shiplog's" if reserved.any?
+      @newsletter_mailer_options = options.freeze
+    end
+
+    def newsletter_batch_size=(value)
+      unless value.is_a?(Integer) && value.between?(1, MAX_NEWSLETTER_BATCH_SIZE)
+        raise ArgumentError, "newsletter_batch_size must be an Integer between 1 and #{MAX_NEWSLETTER_BATCH_SIZE}, got #{value.inspect}"
+      end
+      @newsletter_batch_size = value
+    end
+
     # :standalone (default) wraps the admin in Shiplog's own page chrome; :hosted renders it inside the
     # layout of config.admin_layout (compact sub-nav, no page chrome of its own).
     def admin_chrome=(value)
@@ -245,6 +364,10 @@ module Shiplog
       @images = true
       @max_images_per_entry = 4
       @locales = [].freeze
+      @announcements = :page
+      @newsletter = false
+      @newsletter_mailer_options = {}.freeze
+      @newsletter_batch_size = 500
     end
 
     def resolved_github_token
@@ -283,6 +406,14 @@ module Shiplog
 
     private
 
+    # Nil (also for a blank String) or a stripped non-empty String; anything else raises.
+    def optional_string!(setting, value, hint)
+      return if value.nil? || (value.is_a?(String) && value.strip.empty?)
+      raise ArgumentError, "#{setting} must be nil or a String #{hint}, got #{value.inspect}" unless value.is_a?(String)
+
+      value.strip
+    end
+
     def normalize_canonical_url(value)
       return if value.nil? || (value.is_a?(String) && value.strip.empty?)
       raise ArgumentError, "canonical_url must be a String like \"https://example.com\", got #{value.inspect}" unless value.is_a?(String)

data/lib/shiplog/engine.rb

@@ -9,5 +9,7 @@ module Shiplog
 
     # Once per boot, after the host's initializers have set config.images: say why screenshots are off.
     config.after_initialize { Shiplog.log_images_status }
+    # And why the newsletter, when on, cannot be sent yet.
+    config.after_initialize { Shiplog.log_newsletter_status }
   end
 end

data/lib/shiplog/previews/shiplog/newsletter_mailer_preview.rb

@@ -0,0 +1,77 @@
+module Shiplog
+  # Previews of the newsletter's emails, for hosts iterating on the design locally. Add the directory to your
+  # preview paths (config/environments/development.rb):
+  #
+  #   config.action_mailer.preview_paths << Shiplog::Engine.root.join("lib/shiplog/previews").to_s
+  #
+  # then open /rails/mailers/shiplog/newsletter_mailer. The announcement is the newest approved one (with the
+  # month's real feature highlights), or a sample with sample highlights when there is none (no database rows
+  # needed); ?locale=es previews a configured locale.
+  class NewsletterMailerPreview < ActionMailer::Preview
+    SAMPLE_BODY = <<~MARKDOWN.freeze
+      This month we made imports faster and added a dark theme. Here is what shipped.
+
+      ## Highlights
+
+      ### Dark mode
+
+      Switch to a dark theme from your settings. Easier on the eyes at night.
+
+      ### Faster imports
+
+      Spreadsheets with thousands of rows now import in seconds.
+
+      ## Also improved
+
+      ### Billing
+
+      - Invoices show the tax breakdown.
+      - Refunds appear on the next statement.
+
+      ### Exports
+
+      - CSV files keep leading zeros.
+    MARKDOWN
+
+    SAMPLE_HIGHLIGHTS = [
+      { title: "Dark mode", summary: "Switch to a dark theme from your settings, easier on the eyes at night.", slug: "dark-mode",
+        image_url: "https://placehold.co/1200x700/png?text=Dark+mode", image_width: 1200, image_height: 700 },
+      { title: "Faster imports", summary: "Spreadsheets with thousands of rows now import in seconds.", slug: "faster-imports",
+        image_url: "https://placehold.co/1200x700/png?text=Faster+imports", image_width: 1200, image_height: 700 },
+      { title: "Shared views", summary: "Save a filtered view and share it with your team.", slug: "shared-views", image_url: nil }
+    ].freeze
+
+    def announcement
+      entry = Entry.published_announcements.order(released_on: :desc).first
+      locale = (params["locale"] || params[:locale]).presence || I18n.default_locale
+      email = "preview@example.com"
+      content = entry ? nil : Newsletter::Content.new(sample_announcement, locale, highlights: sample_highlights)
+      NewsletterMailer.announcement(entry || content.entry, email, locale:, content:, unsubscribe_url: Newsletter.unsubscribe_url(email),
+        preferences_url: Newsletter.preferences_url(sample_subscriber))
+    end
+
+    def confirmation
+      NewsletterMailer.confirmation(sample_subscriber)
+    end
+
+    private
+
+    def sample_announcement
+      month = Date.current.prev_month.beginning_of_month
+      Entry.new(kind: "announcement", status: "approved", title: Period.month_name(month), body: SAMPLE_BODY,
+        released_on: month.end_of_month, slug: month.strftime("%Y-%m"), subject: Period.new(starts_on: month, ends_on: month.end_of_month))
+    end
+
+    # Three cards, two with a (placeholder) screenshot, linking to sample permalinks under the email's origin.
+    def sample_highlights
+      SAMPLE_HIGHLIGHTS.map do |sample|
+        Newsletter::Content::Highlight.new(title: sample[:title], summary: sample[:summary], url: Newsletter.absolute_url(PublicLinks.path(:changelog_entry_path, sample[:slug])),
+          image_url: sample[:image_url], image_alt: sample[:title], image_width: sample[:image_width], image_height: sample[:image_height])
+      end
+    end
+
+    def sample_subscriber
+      NewsletterSubscriber.new(email: "preview@example.com", locale: I18n.default_locale.to_s, token: "preview-token", confirmation_nonce: "preview-nonce")
+    end
+  end
+end

data/lib/shiplog/version.rb

@@ -1,3 +1,3 @@
 module Shiplog
-  VERSION = "0.3.2"
+  VERSION = "0.4.0"
 end

data/lib/shiplog.rb

@@ -18,6 +18,38 @@ module Shiplog
     # at 99. Counted on approved_at (when the entry was approved), not released_on (the list's order). The host supplies the timestamp (Shiplog doesn't know its users): see config.on_changelog_seen.
     def unseen_count(since: nil) = Entry.unseen_count(since:)
 
+    # The number of approved monthly announcements approved after `since` (all of them while it is nil), capped
+    # at 99: the rare "what's new" signal, where unseen_count counts every daily entry. 0 while announcements are off.
+    def unseen_announcements_count(since: nil) = announcements? ? Entry.unseen_announcements_count(since:) : 0
+
+    # Whether monthly announcements are on (config.announcements is :page or :external).
+    def announcements? = config.announcements != false
+
+    # Whether Shiplog renders announcement pages (config.announcements is :page).
+    def announcement_pages? = config.announcements == :page
+
+    # Whether the newsletter is on: config.newsletter, and announcements (there is nothing else to send).
+    def newsletter? = config.newsletter && announcements?
+
+    # Logged once at boot (see Shiplog::Engine), while the newsletter is on: what keeps it from sending, a
+    # recipients callable without the unsubscribe hook (unsubscribes would not reach the host's list), and a
+    # cache that counts nothing (the subscribe form's rate limits are then off).
+    def log_newsletter_status
+      return unless newsletter?
+
+      missing = []
+      missing << "newsletter_from" if Newsletter.from.blank?
+      missing << "newsletter_address" if config.newsletter_address.blank?
+      missing << "canonical_url (or action_mailer.default_url_options)" if Newsletter.base_url.blank?
+      Rails.logger&.warn("[shiplog] config.newsletter is on, but the newsletter cannot be sent until these are set: #{missing.join(", ")}.") if missing.any?
+      if config.newsletter_recipients && config.on_newsletter_unsubscribe.nil?
+        Rails.logger&.warn("[shiplog] config.newsletter_recipients is set but config.on_newsletter_unsubscribe is not: Shiplog suppresses an address that unsubscribes, but your own list will not know.")
+      end
+      if Rails.cache.is_a?(ActiveSupport::Cache::NullStore)
+        Rails.logger&.warn("[shiplog] Rails.cache is a null store, so the newsletter's subscribe form is not rate limited. Configure a cache store.")
+      end
+    end
+
     ACTIVE_STORAGE_TABLES = %w[active_storage_attachments active_storage_blobs].freeze
 
     # Whether the host loaded Active Storage (its engine and the model macros). The declaration on Entry needs

data/lib/tasks/shiplog.rake

@@ -8,6 +8,28 @@ unless Rake::Task.task_defined?("shiplog:backfill_slugs")
       puts "Shiplog: gave #{count} #{count == 1 ? "entry" : "entries"} a slug."
     end
 
+    desc "Draft the announcement of a month (MONTH=2026-10; the previous month by default) and queue its rewrite"
+    task draft_announcement: :environment do
+      month = ENV["MONTH"].present? ? Date.strptime(ENV["MONTH"], "%Y-%m") : Date.current.prev_month
+      entry = Shiplog::Announcements.draft(month:)
+      label = month.strftime("%Y-%m")
+      if entry
+        puts "Shiplog: drafted the #{label} announcement (entry #{entry.id})."
+      elsif !Shiplog.announcements?
+        puts "Shiplog: config.announcements is false, nothing drafted."
+      else
+        puts "Shiplog: nothing drafted for #{label}: it has an announcement already, or no approved feature or change."
+      end
+    rescue Date::Error
+      abort "Shiplog: MONTH must look like 2026-10, got #{ENV["MONTH"].inspect}."
+    end
+
+    desc "Delete the newsletter subscribers who never confirmed within 30 days and the delivery rows older than 180 days (what Shiplog::PurgeNewsletterJob does)"
+    task purge_newsletter: :environment do
+      counts = Shiplog::PurgeNewsletterJob.perform_now
+      puts "Shiplog: purged #{counts[:subscribers]} unconfirmed newsletter #{counts[:subscribers] == 1 ? "subscriber" : "subscribers"} and #{counts[:deliveries]} old delivery #{counts[:deliveries] == 1 ? "row" : "rows"}."
+    end
+
     desc "Translate approved entries and area names that have no current translation into config.locales (entries approved before 0.3.0 get none). BATCH_SIZE=100"
     task translate_approved: :environment do
       if Shiplog.config.locales.empty?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shiplog
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Trackberry
@@ -39,6 +39,7 @@ files:
 - CHANGELOG.md
 - MIT-LICENSE
 - README.md
+- app/controllers/shiplog/admin/announcements_controller.rb
 - app/controllers/shiplog/admin/application_controller.rb
 - app/controllers/shiplog/admin/area_detections_controller.rb
 - app/controllers/shiplog/admin/area_translations_controller.rb
@@ -46,27 +47,39 @@ files:
 - app/controllers/shiplog/admin/areas/moves_controller.rb
 - app/controllers/shiplog/admin/areas_controller.rb
 - app/controllers/shiplog/admin/boards_controller.rb
+- app/controllers/shiplog/admin/entries/announcement_notifications_controller.rb
 - app/controllers/shiplog/admin/entries/approvals_controller.rb
 - app/controllers/shiplog/admin/entries/discards_controller.rb
+- app/controllers/shiplog/admin/entries/exports_controller.rb
 - app/controllers/shiplog/admin/entries/images/moves_controller.rb
 - app/controllers/shiplog/admin/entries/images_controller.rb
+- app/controllers/shiplog/admin/entries/newsletter_retries_controller.rb
+- app/controllers/shiplog/admin/entries/newsletter_tests_controller.rb
+- app/controllers/shiplog/admin/entries/newsletters_controller.rb
 - app/controllers/shiplog/admin/entries/rewrites_controller.rb
 - app/controllers/shiplog/admin/entries/translations/retranslations_controller.rb
 - app/controllers/shiplog/admin/entries/translations_controller.rb
 - app/controllers/shiplog/admin/entries_controller.rb
 - app/controllers/shiplog/admin/inbox_filters.rb
+- app/controllers/shiplog/admin/newsletter_subscribers_controller.rb
 - app/controllers/shiplog/admin/syncs_controller.rb
 - app/controllers/shiplog/application_controller.rb
 - app/controllers/shiplog/changelog_entries_controller.rb
 - app/controllers/shiplog/changelog_feeds_controller.rb
 - app/controllers/shiplog/changelogs_controller.rb
 - app/controllers/shiplog/frontends_controller.rb
+- app/controllers/shiplog/newsletter/confirmations_controller.rb
+- app/controllers/shiplog/newsletter/preferences_controller.rb
+- app/controllers/shiplog/newsletter/subscriptions_controller.rb
+- app/controllers/shiplog/newsletter/unsubscriptions_controller.rb
+- app/controllers/shiplog/newsletter_controller.rb
 - app/controllers/shiplog/public_controller.rb
 - app/controllers/shiplog/roadmaps_controller.rb
 - app/controllers/shiplog/webhooks_controller.rb
 - app/frontend/shiplog/admin.css
 - app/frontend/shiplog/board.js
 - app/frontend/shiplog/inbox.js
+- app/frontend/shiplog/once.js
 - app/frontend/shiplog/shiplog.css
 - app/helpers/shiplog/admin/entries_helper.rb
 - app/helpers/shiplog/application_helper.rb
@@ -74,20 +87,28 @@ files:
 - app/helpers/shiplog/frontend_helper.rb
 - app/helpers/shiplog/head_helper.rb
 - app/helpers/shiplog/host_routes_helper.rb
+- app/helpers/shiplog/newsletter_helper.rb
+- app/helpers/shiplog/newsletter_mailer_helper.rb
 - app/helpers/shiplog/permalink_helper.rb
 - app/helpers/shiplog/roadmap_helper.rb
 - app/helpers/shiplog/structured_data_helper.rb
 - app/helpers/shiplog/styling_helper.rb
 - app/helpers/shiplog/switcher_helper.rb
 - app/helpers/shiplog/unseen_helper.rb
+- app/jobs/shiplog/announce_job.rb
 - app/jobs/shiplog/application_job.rb
 - app/jobs/shiplog/detect_areas_job.rb
+- app/jobs/shiplog/draft_announcement_job.rb
+- app/jobs/shiplog/purge_newsletter_job.rb
 - app/jobs/shiplog/refresh_job.rb
 - app/jobs/shiplog/rewrite_entry_job.rb
 - app/jobs/shiplog/scan_changes_job.rb
+- app/jobs/shiplog/send_newsletter_job.rb
 - app/jobs/shiplog/sync_job.rb
 - app/jobs/shiplog/translate_area_job.rb
 - app/jobs/shiplog/translate_entry_job.rb
+- app/mailers/shiplog/newsletter_mailer.rb
+- app/models/shiplog/announcements.rb
 - app/models/shiplog/application_record.rb
 - app/models/shiplog/area.rb
 - app/models/shiplog/area_detector.rb
@@ -106,10 +127,21 @@ files:
 - app/models/shiplog/issue.rb
 - app/models/shiplog/issue_form.rb
 - app/models/shiplog/issue_link.rb
+- app/models/shiplog/markdown.rb
+- app/models/shiplog/newsletter.rb
+- app/models/shiplog/newsletter/content.rb
+- app/models/shiplog/newsletter/csv.rb
+- app/models/shiplog/newsletter/recipients.rb
+- app/models/shiplog/newsletter/tokens.rb
+- app/models/shiplog/newsletter_delivery.rb
+- app/models/shiplog/newsletter_subscriber.rb
+- app/models/shiplog/period.rb
+- app/models/shiplog/public_links.rb
 - app/models/shiplog/pull_request.rb
 - app/models/shiplog/pull_request_upgrade.rb
 - app/models/shiplog/repository.rb
 - app/models/shiplog/rewriter.rb
+- app/models/shiplog/rewriter/announcement_prompt.rb
 - app/models/shiplog/rewriter/prompt.rb
 - app/models/shiplog/roadmap.rb
 - app/models/shiplog/roadmap/column_resolver.rb
@@ -139,13 +171,18 @@ files:
 - app/views/shiplog/admin/areas/index.html.erb
 - app/views/shiplog/admin/boards/_card.html.erb
 - app/views/shiplog/admin/boards/show.html.erb
+- app/views/shiplog/admin/entries/_announcement.html.erb
 - app/views/shiplog/admin/entries/_badges.html.erb
 - app/views/shiplog/admin/entries/_entry_row.html.erb
 - app/views/shiplog/admin/entries/_images.html.erb
+- app/views/shiplog/admin/entries/_newsletter.html.erb
 - app/views/shiplog/admin/entries/_translations.html.erb
 - app/views/shiplog/admin/entries/edit.html.erb
 - app/views/shiplog/admin/entries/index.html.erb
+- app/views/shiplog/admin/entries/newsletters/show.html.erb
+- app/views/shiplog/admin/newsletter_subscribers/index.html.erb
 - app/views/shiplog/admin/syncs/show.html.erb
+- app/views/shiplog/changelog_entries/announcement.html.erb
 - app/views/shiplog/changelog_entries/show.html.erb
 - app/views/shiplog/changelog_feeds/show.atom.builder
 - app/views/shiplog/changelogs/_areas.html.erb
@@ -158,6 +195,21 @@ files:
 - app/views/shiplog/head/_meta.html.erb
 - app/views/shiplog/head/_open_graph.html.erb
 - app/views/shiplog/head/_structured_data.html.erb
+- app/views/shiplog/newsletter/_form.html.erb
+- app/views/shiplog/newsletter/_page.html.erb
+- app/views/shiplog/newsletter/confirmations/create.html.erb
+- app/views/shiplog/newsletter/confirmations/show.html.erb
+- app/views/shiplog/newsletter/invalid.html.erb
+- app/views/shiplog/newsletter/preferences/destroy.html.erb
+- app/views/shiplog/newsletter/preferences/show.html.erb
+- app/views/shiplog/newsletter/rate_limited.html.erb
+- app/views/shiplog/newsletter/subscriptions/show.html.erb
+- app/views/shiplog/newsletter/unsubscriptions/create.html.erb
+- app/views/shiplog/newsletter/unsubscriptions/show.html.erb
+- app/views/shiplog/newsletter_mailer/announcement.html.erb
+- app/views/shiplog/newsletter_mailer/announcement.text.erb
+- app/views/shiplog/newsletter_mailer/confirmation.html.erb
+- app/views/shiplog/newsletter_mailer/confirmation.text.erb
 - app/views/shiplog/roadmaps/_card.html.erb
 - app/views/shiplog/roadmaps/_column.html.erb
 - app/views/shiplog/roadmaps/_shipped.html.erb
@@ -169,6 +221,8 @@ files:
 - db/migrate/20261026000001_create_shiplog_tables.rb
 - db/migrate/20261027000001_create_shiplog_pull_request_upgrades.rb
 - db/migrate/20261027000002_shiplog_0_3_0.rb
+- db/migrate/20261028000001_shiplog_0_4_0.rb
+- db/migrate/20261028000002_shiplog_0_4_0_newsletter.rb
 - lib/generators/shiplog/install/install_generator.rb
 - lib/generators/shiplog/install/templates/initializer.rb.tt
 - lib/generators/shiplog/install/templates/shiplog-feature.yml
@@ -181,6 +235,7 @@ files:
 - lib/shiplog/github/errors.rb
 - lib/shiplog/github/queries.rb
 - lib/shiplog/head_tags_helper.rb
+- lib/shiplog/previews/shiplog/newsletter_mailer_preview.rb
 - lib/shiplog/version.rb
 - lib/tasks/shiplog.rake
 homepage: https://github.com/Trackberry/shiplog