open_blog 0.1.0

data/lib/generators/open_blog/install/templates/views/open_blog/search/show.html.erb

@@ -0,0 +1,13 @@
+<%= render "open_blog/shared/breadcrumbs" %>
+<header class="ob-list-heading">
+  <h1><%= open_blog_translate("search.heading") %></h1>
+  <p class="ob-list-description"><%= open_blog_translate("search.description") %></p>
+</header>
+<div class="ob-list-layout">
+  <%= render "open_blog/shared/sidebar" %>
+  <div class="ob-list-main">
+    <% if @posts.empty? %><p class="ob-empty"><%= open_blog_translate("search.empty") %></p><% end %>
+    <div class="ob-post-grid"><%= render partial: "open_blog/shared/post_card", collection: @posts, as: :post %></div>
+    <%= render "open_blog/shared/pagination" %>
+  </div>
+</div>

data/lib/generators/open_blog/install/templates/views/open_blog/series/show.html.erb

@@ -0,0 +1,13 @@
+<%= render "open_blog/shared/breadcrumbs" %>
+<header class="ob-list-heading">
+  <h1><%= @open_blog_page.record.name %></h1>
+  <p class="ob-list-description"><%= open_blog_page_description(@open_blog_page) %></p>
+</header>
+<div class="ob-list-layout">
+  <%= render "open_blog/shared/sidebar" %>
+  <div class="ob-list-main">
+    <% if @posts.empty? %><p class="ob-empty"><%= open_blog_translate("lists.empty") %></p><% end %>
+    <div class="ob-post-grid"><%= render partial: "open_blog/shared/post_card", collection: @posts, as: :post %></div>
+    <%= render "open_blog/shared/pagination" %>
+  </div>
+</div>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_author_box.html.erb

@@ -0,0 +1,6 @@
+<section class="ob-author-box" aria-labelledby="ob-author-heading">
+  <h2 id="ob-author-heading"><%= open_blog_translate("headings.about_author") %></h2>
+  <%= open_blog_avatar(post.author, name: post.author_name) %>
+  <%= link_to post.author_name, open_blog_list_path(:author, post.author) %>
+  <% if post.author.bio.present? %><p class="ob-author-bio"><%= post.author.bio %></p><% end %>
+</section>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_breadcrumbs.html.erb

@@ -0,0 +1 @@
+<%= open_blog_breadcrumbs(@open_blog_page) %>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_call_to_action.html.erb

@@ -0,0 +1,7 @@
+<% if (cta = OpenBlog.config.call_to_action).present? && OpenBlog::Renderer::Sanitizer.safe_url?(cta[:url]) %>
+  <section class="ob-call-to-action" aria-labelledby="ob-call-to-action-heading">
+    <h2 id="ob-call-to-action-heading"><%= cta[:title] %></h2>
+    <p><%= cta[:text] %></p>
+    <%= link_to cta[:label], cta[:url] %>
+  </section>
+<% end %>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_featured_card.html.erb

@@ -0,0 +1,11 @@
+<article class="ob-featured-card">
+  <%= link_to post.path, aria: { label: post.title }, class: "ob-card-media" do %><%= open_blog_card_image(post) %><% end %>
+  <div class="ob-featured-details">
+    <p class="ob-featured-label"><%= open_blog_translate("cards.featured") %></p>
+    <h2><%= link_to post.title, post.path %></h2>
+    <p class="ob-card-description"><%= post.description %></p>
+    <div class="ob-card-author"><%= open_blog_avatar(post.author, name: post.author_name) %> <%= link_to post.author_name, open_blog_list_path(:author, post.author) %></div>
+    <%= open_blog_dates(post) %>
+    <%= open_blog_reading_time(post) %>
+  </div>
+</article>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_footer.html.erb

@@ -0,0 +1,11 @@
+<footer class="ob-footer">
+  <nav aria-label="<%= open_blog_translate("navigation.footer") %>">
+    <% OpenBlog::Page::KINDS.each do |kind| %>
+      <% url = OpenBlog.policy_url(kind) %>
+      <% if url.present? && OpenBlog::Renderer::Sanitizer.safe_url?(url) %>
+        <%= link_to open_blog_translate("policies.#{kind}"), url %>
+      <% end %>
+    <% end %>
+    <%= link_to open_blog_translate("navigation.feed"), "#{open_blog_index_path.chomp('/')}/feed.xml" %>
+  </nav>
+</footer>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_header.html.erb

@@ -0,0 +1,7 @@
+<header class="ob-header">
+  <%= link_to OpenBlog.config.site_name, open_blog_index_path, class: "ob-site-name" %>
+  <nav aria-label="<%= open_blog_translate("navigation.blog") %>">
+    <%= link_to OpenBlog.config.blog_title, open_blog_index_path %>
+  </nav>
+  <%= render "open_blog/shared/theme_toggle" %>
+</header>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_pagination.html.erb

@@ -0,0 +1 @@
+<%= open_blog_paginate(@open_blog_page.pagination) %>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_post_card.html.erb

@@ -0,0 +1,9 @@
+<article class="ob-post-card">
+  <%= link_to post.path, aria: { label: post.title }, class: "ob-card-media" do %><%= open_blog_card_image(post) %><% end %>
+  <% if post.category %><%= link_to post.category.name, open_blog_list_path(:category, post.category), class: "ob-card-category" %><% end %>
+  <%= content_tag(local_assigns.fetch(:heading, :h2), class: "ob-card-title") do %><%= link_to post.title, post.path %><% end %>
+  <p class="ob-card-description"><%= post.description %></p>
+  <div class="ob-card-author"><%= open_blog_avatar(post.author, name: post.author_name) %> <%= link_to post.author_name, open_blog_list_path(:author, post.author) %></div>
+  <%= open_blog_dates(post) %>
+  <%= open_blog_reading_time(post) %>
+</article>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_related_posts.html.erb

@@ -0,0 +1,10 @@
+<% cache_unless @open_blog_page.kind == :preview, @related_cache_key do %>
+<% if @related_posts.any? %>
+  <section class="ob-related-posts" aria-labelledby="ob-related-heading">
+    <h2 id="ob-related-heading"><%= open_blog_translate("headings.related") %></h2>
+    <div class="ob-post-grid">
+      <%= render partial: "open_blog/shared/post_card", collection: @related_posts, as: :post, locals: { heading: :h3 } %>
+    </div>
+  </section>
+<% end %>
+<% end %>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_search.html.erb

@@ -0,0 +1,9 @@
+<% search_path = "#{OpenBlog.mount_path.chomp('/')}/search" %>
+<form action="<%= search_path %>" method="get" role="search" class="ob-search" data-controller="open-blog--search" data-open-blog--search-url-value="<%= search_path %>.json">
+  <label for="open-blog-search"><%= open_blog_translate("search.label") %></label>
+  <div class="ob-search-controls">
+    <input id="open-blog-search" type="search" name="q" maxlength="100" value="<%= @query %>" data-open-blog--search-target="input" data-action="input->open-blog--search#search" autocomplete="off">
+    <button type="submit"><%= open_blog_translate("search.submit") %></button>
+  </div>
+  <ul class="ob-search-results" aria-label="<%= open_blog_translate("search.suggestions") %>" aria-live="polite" data-open-blog--search-target="results" hidden></ul>
+</form>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_share.html.erb

@@ -0,0 +1,13 @@
+<nav class="ob-share" aria-label="<%= open_blog_translate("share.heading") %>"
+  data-controller="open-blog--share"
+  data-open-blog--share-url-value="<%= open_blog_absolute_url(post.path) %>"
+  data-open-blog--share-title-value="<%= post.title %>"
+  data-open-blog--share-copy-label-value="<%= open_blog_translate("share.copy") %>"
+  data-open-blog--share-copied-label-value="<%= open_blog_translate("share.copied") %>"
+  data-open-blog--share-error-label-value="<%= open_blog_translate("share.failed") %>">
+  <button type="button" class="ob-share-button" hidden data-open-blog--share-target="device" data-action="open-blog--share#share"><%= open_blog_icon("share") %> <%= open_blog_translate("share.device") %></button>
+  <%= link_to open_blog_translate("share.x"), "https://twitter.com/intent/tweet?url=#{ERB::Util.url_encode(open_blog_absolute_url(post.path))}&text=#{ERB::Util.url_encode(post.title)}", rel: "noopener" %>
+  <%= link_to open_blog_translate("share.linkedin"), "https://www.linkedin.com/sharing/share-offsite/?url=#{ERB::Util.url_encode(open_blog_absolute_url(post.path))}", rel: "noopener" %>
+  <button type="button" class="ob-share-button" hidden data-open-blog--share-target="copy" data-action="open-blog--share#copy"><%= open_blog_icon("copy") %> <%= open_blog_translate("share.copy") %></button>
+  <span class="ob-share-status" data-open-blog--share-target="status" aria-live="polite"></span>
+</nav>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_sidebar.html.erb

@@ -0,0 +1,38 @@
+<aside class="ob-sidebar">
+  <%= render "open_blog/shared/search" %>
+<% cache @sidebar_cache_key do %>
+  <nav class="ob-sidebar-categories" aria-label="<%= open_blog_translate("navigation.categories") %>">
+    <h2><%= open_blog_translate("navigation.categories") %></h2>
+    <ul>
+      <li><%= link_to open_blog_translate("navigation.all_posts"), open_blog_index_path, aria: { current: (@open_blog_page.kind == :index ? "page" : nil) } %></li>
+      <% @sidebar_categories.each do |entry| %>
+        <li>
+          <%= link_to open_blog_list_path(:category, entry[:category]), aria: { current: (@open_blog_page.kind == :category && @open_blog_page.record == entry[:category] ? "page" : nil) } do %>
+            <span><%= entry[:category].name %></span> <span class="ob-count"><%= entry[:count] %></span>
+          <% end %>
+        </li>
+      <% end %>
+    </ul>
+  </nav>
+  <% if @sidebar_tags.any? %>
+    <nav class="ob-sidebar-tags" aria-label="<%= open_blog_translate("navigation.tags") %>">
+      <h2><%= open_blog_translate("navigation.tags") %></h2>
+      <ul>
+        <% @sidebar_tags.each do |entry| %>
+          <li><%= link_to entry[:tag].name, open_blog_list_path(:tag, entry[:tag]), aria: { current: (@open_blog_page.kind == :tag && @open_blog_page.record == entry[:tag] ? "page" : nil) } %></li>
+        <% end %>
+      </ul>
+    </nav>
+  <% end %>
+<% end %>
+  <% if @popular_posts.any? %>
+    <nav class="ob-sidebar-popular" aria-label="<%= open_blog_translate("navigation.popular") %>">
+      <h2><%= open_blog_translate("navigation.popular") %></h2>
+      <ol>
+        <% @popular_posts.each do |post| %>
+          <li><%= link_to post.title, post.path %></li>
+        <% end %>
+      </ol>
+    </nav>
+  <% end %>
+</aside>

data/lib/generators/open_blog/install/templates/views/open_blog/shared/_theme_toggle.html.erb

@@ -0,0 +1,10 @@
+<% unless open_blog_fixed_theme %>
+  <button type="button" class="ob-theme-toggle" hidden
+    data-controller="open-blog--theme" data-action="open-blog--theme#cycle"
+    data-open-blog--theme-system-label-value="<%= open_blog_translate("theme.system") %>"
+    data-open-blog--theme-light-label-value="<%= open_blog_translate("theme.light") %>"
+    data-open-blog--theme-dark-label-value="<%= open_blog_translate("theme.dark") %>">
+    <%= open_blog_icon("monitor") %>
+    <span data-open-blog--theme-target="label"><%= open_blog_translate("theme.system") %></span>
+  </button>
+<% end %>

data/lib/generators/open_blog/install/templates/views/open_blog/tags/show.html.erb

@@ -0,0 +1,13 @@
+<%= render "open_blog/shared/breadcrumbs" %>
+<header class="ob-list-heading">
+  <h1><%= open_blog_translate("titles.tag", name: @open_blog_page.record.name) %></h1>
+  <p class="ob-list-description"><%= open_blog_page_description(@open_blog_page) %></p>
+</header>
+<div class="ob-list-layout">
+  <%= render "open_blog/shared/sidebar" %>
+  <div class="ob-list-main">
+    <% if @posts.empty? %><p class="ob-empty"><%= open_blog_translate("lists.empty") %></p><% end %>
+    <div class="ob-post-grid"><%= render partial: "open_blog/shared/post_card", collection: @posts, as: :post %></div>
+    <%= render "open_blog/shared/pagination" %>
+  </div>
+</div>

data/lib/generators/open_blog/views/views_generator.rb

@@ -0,0 +1,21 @@
+require "rails/generators"
+require_relative "../generator_support"
+
+module OpenBlog
+  module Generators
+    class ViewsGenerator < Rails::Generators::Base
+      include GeneratorSupport
+      source_root File.expand_path("../install/templates", __dir__)
+      class_option :skip_tailwind, type: :boolean, default: nil
+
+      def copy_views
+        css = if options[:skip_tailwind].nil? && host_read("app/views/layouts/open_blog.html.erb").include?("open_blog_stylesheets")
+          :fallback
+        else
+          css_setup
+        end
+        copy_reader_views(css: css)
+      end
+    end
+  end
+end

data/lib/open_blog/actor.rb

@@ -0,0 +1,7 @@
+module OpenBlog
+  Actor = Data.define(:name, :scopes, :id) do
+    def initialize(name:, scopes: %w[read write publish], id: nil)
+      super(name: name.to_s, scopes: Array(scopes).map(&:to_s).freeze, id: id || name.to_s)
+    end
+  end
+end

data/lib/open_blog/admin_suite.rb

@@ -0,0 +1,73 @@
+require "admin_suite"
+require "admin_suite/ui/field_renderer_registry"
+
+module OpenBlog
+  module AdminSuite
+    RESOURCES = { "open_blog_posts" => "Post", "open_blog_categories" => "Category",
+      "open_blog_authors" => "Author", "open_blog_pages" => "Page" }.freeze
+    FAQ_FIELDS = %i[id question answer position _destroy].freeze
+
+    module ResourceParameters
+      private
+
+      def resource_config
+        name = RESOURCES[resource_name]
+        return super unless current_portal.to_s == "open_blog" && name
+        ensure_resources_loaded!
+        definition = "::Admin::Resources::OpenBlog::#{name}Resource".safe_constantize
+        return unless definition.is_a?(Class) && definition < ::Admin::Base::Resource
+        definition if definition.model_class == "::OpenBlog::#{name}".constantize
+      end
+
+      def resource_params
+        fields = resource_config&.form_config&.fields_list || []
+        nested = resource_class == ::OpenBlog::Post && fields.any? do |field|
+          field.respond_to?(:name) && field.name.to_sym == :faqs_attributes && field.type == :open_blog_faq
+        end
+        return super unless nested
+
+        original = params
+        key = resource_class.model_name.param_key
+        faq = original.require(key).slice(:faqs_attributes).permit(faqs_attributes: FAQ_FIELDS)
+        filtered = original.deep_dup
+        filtered[key].delete(:faqs_attributes)
+        self.params = filtered
+        super.merge(faq)
+      ensure
+        self.params = original if original
+      end
+    end
+
+    def self.install!
+      return if @installed
+      ::AdminSuite::UI::FieldRendererRegistry.register(:open_blog_faq) do |view, form, field, resource, field_class|
+        render_faqs(view, form, field, resource, field_class)
+      end
+      Rails.application.reloader.to_prepare { install_controller! }
+      install_controller!
+      @installed = true
+    end
+
+    def self.install_controller!
+      controller = ::AdminSuite::ResourcesController
+      controller.prepend(ResourceParameters) unless controller.ancestors.include?(ResourceParameters)
+    end
+
+    def self.render_faqs(view, form, field, resource, field_class)
+      entries = resource.faqs.to_a
+      next_position = entries.filter_map(&:position).max.to_i + 1
+      entries += [ ::OpenBlog::Faq.new(position: next_position) ] unless field.readonly
+      form.fields_for(:faqs, entries, include_id: false) do |nested|
+        view.tag.fieldset(class: "open-blog-faq-fields") do
+          view.safe_join([
+            view.tag.legend(nested.object.persisted? ? "FAQ #{nested.object.position}" : "Add a FAQ"),
+            nested.hidden_field(:id), nested.label(:position), nested.number_field(:position, min: 1, class: field_class, readonly: field.readonly),
+            nested.label(:question), nested.text_field(:question, class: field_class, readonly: field.readonly),
+            nested.label(:answer), nested.text_area(:answer, class: field_class, rows: 4, readonly: field.readonly),
+            nested.check_box(:_destroy, disabled: field.readonly), nested.label(:_destroy, "Remove this FAQ")
+          ])
+        end
+      end
+    end
+  end
+end

data/lib/open_blog/adopt/contract.rb

@@ -0,0 +1,152 @@
+module OpenBlog
+  class Adopt
+    class Contract
+      CONTENT_FIELDS = (PostAttributes::CONTENT_FIELDS + %i[provenance provenance_evidence]).freeze
+      EXTRA_FIELDS = %i[source_system source_id source_body_sha256 old_slugs category_description first_published_at first_published_evidence last_modified_at last_modified_evidence imported_approval declaration connections dry_run].freeze
+      attr_reader :attributes, :baseline, :approval, :connections
+
+      def initialize(input, now: Time.current)
+        @now = now
+        invalid("attributes") unless input.is_a?(Hash) && input.keys.all? { |key| key.is_a?(String) || key.is_a?(Symbol) }
+        @attributes = input.symbolize_keys
+        unknown = @attributes.keys - CONTENT_FIELDS - EXTRA_FIELDS
+        raise Error::UnknownField.new(details: unknown.map(&:to_s)) if unknown.any?
+        %i[source_system source_id slug title body_format].each { |field| required_text(@attributes, field, field.to_s) }
+        invalid("body") unless @attributes[:body].is_a?(String)
+        raise Error::SlugNotSupported.new(details: [ "slug" ]) unless Post::SLUG_PATTERN.match?(@attributes[:slug])
+        invalid("dry_run") if @attributes.key?(:dry_run) && ![ true, false ].include?(@attributes[:dry_run])
+        %i[category_description provenance_evidence first_published_evidence last_modified_evidence].each do |field|
+          invalid(field.to_s) if @attributes.key?(field) && !@attributes[field].nil? && !@attributes[field].is_a?(String)
+        end
+        if !@attributes[:source_body_sha256].nil? && !(@attributes[:source_body_sha256].is_a?(String) && @attributes[:source_body_sha256].match?(/\A[0-9a-f]{64}\z/))
+          invalid("source_body_sha256")
+        end
+        normalize_approval
+        normalize_baseline
+        normalize_connections
+      end
+
+      def dry_run?
+        @attributes[:dry_run] == true
+      end
+
+      def content
+        defaults = { description: "", search_title: "", search_description: "", cover_alt: "", faq: [], tags: [],
+          category: nil, series: nil, series_position: nil, featured: false, canonical_url: nil, external_id: nil,
+          cover_image: nil, social_image: nil, author: OpenBlog.config.default_author, provenance: "unknown", provenance_evidence: nil }
+        defaults.merge(@attributes.slice(*CONTENT_FIELDS)).merge(provenance: @baseline[:provenance], provenance_evidence: @baseline[:provenance_evidence])
+      end
+
+      def redirects(default_date:, current_slug:)
+        value = @attributes.fetch(:old_slugs, [])
+        invalid("old_slugs") unless value.is_a?(Array)
+        value.map do |item|
+          entry = item.is_a?(String) ? { slug: item } : nested(item, %i[slug moved_on], "old_slugs")
+          slug = required_text(entry, :slug, "old_slugs.slug")
+          unless Post::SLUG_PATTERN.match?(slug)
+            raise Error::SlugNotSupported.new(details: [ "old_slugs.slug" ])
+          end
+          invalid("old_slugs.slug") if slug == current_slug
+          { old_path: "#{OpenBlog.mount_path.chomp('/')}/#{slug}", new_path: "#{OpenBlog.mount_path.chomp('/')}/#{current_slug}",
+            occurred_on: entry[:moved_on].nil? ? default_date : date(entry[:moved_on], "old_slugs.moved_on") }
+        end.uniq.sort_by { |entry| entry[:old_path] }
+      end
+
+      private
+
+      def invalid(field)
+        raise Error::ValidationFailed.new(details: Array(field))
+      end
+
+      def required_text(input, field, path)
+        value = input[field]
+        invalid(path) unless value.is_a?(String) && value.present?
+        value
+      end
+
+      def nested(value, allowed, path)
+        invalid(path) unless value.is_a?(Hash) && value.keys.all? { |key| key.is_a?(String) || key.is_a?(Symbol) }
+        result = value.symbolize_keys
+        unknown = result.keys - allowed
+        raise Error::UnknownField.new(details: unknown.map { |field| "#{path}.#{field}" }) if unknown.any?
+        result
+      end
+
+      def timestamp(value, path)
+        return if value.nil?
+        invalid(path) unless value.is_a?(String) || value.is_a?(Time) || value.is_a?(ActiveSupport::TimeWithZone) || value.is_a?(DateTime)
+        result = value.is_a?(String) ? Time.iso8601(value) : value.to_time
+        result.utc.floor(6)
+      rescue ArgumentError, TypeError
+        invalid(path)
+      end
+
+      def date(value, path)
+        invalid(path) unless value.is_a?(String) || value.is_a?(Date)
+        invalid(path) if value.is_a?(String) && !value.match?(/\A\d{4}-\d{2}-\d{2}\z/)
+        value.is_a?(String) ? Date.iso8601(value) : value.to_date
+      rescue ArgumentError, TypeError
+        invalid(path)
+      end
+
+      def normalize_approval
+        if @attributes.key?(:declaration) && @attributes.key?(:imported_approval)
+          invalid(%w[declaration imported_approval])
+        end
+        key = @attributes.key?(:declaration) ? :declaration : (@attributes.key?(:imported_approval) ? :imported_approval : nil)
+        return unless key
+        allowed = %i[reviewer_name approved_at facts_checked] + (key == :declaration ? %i[declared_on declared_by declared_first_published_at] : %i[evidence confirmed_by])
+        value = nested(@attributes[key], allowed, key.to_s)
+        unless value[:reviewer_name].is_a?(String) && value[:reviewer_name].present? && [ true, false ].include?(value[:facts_checked])
+          raise Error::ApprovalIncomplete
+        end
+        invalid("#{key}.approved_at") unless value[:approved_at]
+        value[:approved_at] = timestamp(value[:approved_at], "#{key}.approved_at")
+        if key == :declaration
+          required_text(value, :declared_by, "declaration.declared_by")
+          value[:declared_on] = date(value[:declared_on], "declaration.declared_on")
+          @declared_first = timestamp(value.delete(:declared_first_published_at), "declaration.declared_first_published_at")
+          invalid("declaration.declared_first_published_at") if @attributes[:first_published_at] && @declared_first
+        else
+          required_text(value, :evidence, "imported_approval.evidence")
+          required_text(value, :confirmed_by, "imported_approval.confirmed_by")
+        end
+        @approval = value.merge(kind: key == :declaration ? "declared" : "imported")
+      end
+
+      def normalize_baseline
+        provenance = @attributes.fetch(:provenance, "unknown").to_s
+        invalid("provenance") unless %w[ai_assisted human_written unknown].include?(provenance)
+        evidence = @attributes[:provenance_evidence]
+        if evidence.blank? && @approval && @approval[:kind] == "declared"
+          evidence = "Declared by #{@approval[:declared_by]} on #{@approval[:declared_on].iso8601}"
+        end
+        invalid("provenance_evidence") if provenance != "unknown" && evidence.blank?
+        @baseline = @attributes.slice(:source_system, :source_id, :source_body_sha256).merge(
+          source_body_sha256: @attributes[:source_body_sha256], provenance: provenance,
+          provenance_evidence: evidence, declared_first_published_at: @declared_first)
+        %i[first_published last_modified].each do |name|
+          time = timestamp(@attributes[:"#{name}_at"], "#{name}_at")
+          evidence = @attributes[:"#{name}_evidence"].presence
+          @baseline[:"#{name}_at"] = evidence ? time : nil
+          @baseline[:"#{name}_evidence"] = evidence
+        end
+      end
+
+      def normalize_connections
+        return unless @attributes.key?(:connections)
+        value = nested(@attributes[:connections], %i[connections third_party_paid declared_by declared_on], "connections")
+        required_text(value, :declared_by, "connections.declared_by")
+        invalid("connections.third_party_paid") unless [ true, false ].include?(value[:third_party_paid])
+        value[:declared_on] = value.key?(:declared_on) ? date(value[:declared_on], "connections.declared_on") : @now.to_date
+        invalid("connections.connections") unless value[:connections].is_a?(Array)
+        value[:connections] = value[:connections].map do |entry|
+          normalized = nested(entry, %i[party relation], "connections.connections")
+          %i[party relation].each { |field| required_text(normalized, field, "connections.connections.#{field}") }
+          normalized.stringify_keys
+        end
+        @connections = value
+      end
+    end
+  end
+end

data/lib/open_blog/adopt/snapshot.rb

@@ -0,0 +1,35 @@
+module OpenBlog
+  class Adopt
+    class Snapshot
+      BASELINE_FIELDS = %i[source_system source_id source_body_sha256 provenance provenance_evidence first_published_at first_published_evidence last_modified_at last_modified_evidence declared_first_published_at].freeze
+      APPROVAL_FIELDS = %i[kind reviewer_name facts_checked approved_at declared_on declared_by confirmed_by evidence].freeze
+      CONNECTION_FIELDS = %i[connections third_party_paid declared_by declared_on].freeze
+      POST_FIELDS = %w[slug body_format author_id category_id series_id series_position featured canonical_url external_id provenance provenance_evidence status].freeze
+
+      def self.stored(post, baseline, include_connections:)
+        return unless baseline
+        capture(post,
+          baseline: baseline.attributes.symbolize_keys.slice(*BASELINE_FIELDS),
+          approvals: post.approvals.where(revision_id: baseline.adopted_revision_id).order(:id).map { |record| record.attributes.symbolize_keys.slice(*APPROVAL_FIELDS) },
+          redirects: Redirect.where(post: post, source: "adoption").order(:old_path).map { |record| record.attributes.symbolize_keys.slice(:old_path, :new_path, :occurred_on) },
+          connections: include_connections ? latest_connections(post) : nil)
+      end
+
+      def self.candidate(post, contract, redirects)
+        approval = contract.approval && APPROVAL_FIELDS.index_with { |field| contract.approval[field] }
+        capture(post, baseline: contract.baseline, approvals: [ approval ].compact,
+          redirects: redirects, connections: contract.connections)
+      end
+
+      def self.latest_connections(post)
+        post.connection_declarations.order(:id).last&.attributes&.symbolize_keys&.slice(*CONNECTION_FIELDS)
+      end
+
+      def self.capture(post, baseline:, approvals:, redirects:, connections:)
+        { identifier: RevisionPayload.new(post).identifier, post: post.attributes.slice(*POST_FIELDS),
+          category_description: post.category&.description, tags: post.taggings.reject(&:marked_for_destruction?).map(&:tag_id).sort,
+          baseline: baseline, approvals: approvals, redirects: redirects, connections: connections }
+      end
+    end
+  end
+end