open_blog 0.1.0

data/db/migrate/20261003012517_create_open_blog_faqs.rb

@@ -0,0 +1,13 @@
+class CreateOpenBlogFaqs < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_faqs do |t|
+      t.references :post, null: false, foreign_key: { to_table: :open_blog_posts }
+      t.integer :position, null: false
+      t.text :question, null: false
+      t.text :answer, null: false
+      t.timestamps
+    end
+    add_index :open_blog_faqs, [ :post_id, :position ], unique: true
+    add_check_constraint :open_blog_faqs, "position > 0", name: "open_blog_faqs_position"
+  end
+end

data/db/migrate/20261003012518_create_open_blog_tags.rb

@@ -0,0 +1,17 @@
+class CreateOpenBlogTags < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_tags do |t|
+      t.string :name, null: false, **(connection.adapter_name == "SQLite" ? { collation: "NOCASE" } : {})
+      t.string :slug, null: false
+      t.datetime :created_at, null: false
+    end
+    add_index :open_blog_tags, connection.adapter_name == "PostgreSQL" ? "lower(name)" : :name, unique: true, name: "index_open_blog_tags_on_name"
+    add_index :open_blog_tags, :slug, unique: true
+    create_table :open_blog_taggings do |t|
+      t.references :post, null: false, foreign_key: { to_table: :open_blog_posts }
+      t.references :tag, null: false, foreign_key: { to_table: :open_blog_tags }
+      t.datetime :created_at, null: false
+    end
+    add_index :open_blog_taggings, [ :post_id, :tag_id ], unique: true
+  end
+end

data/db/migrate/20261003012519_create_open_blog_redirects.rb

@@ -0,0 +1,14 @@
+class CreateOpenBlogRedirects < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_redirects do |t|
+      t.string :old_path, null: false
+      t.string :new_path
+      t.string :source, null: false
+      t.date :occurred_on, null: false
+      t.references :post, foreign_key: { to_table: :open_blog_posts }
+      t.timestamps
+    end
+    add_index :open_blog_redirects, :old_path, unique: true
+    add_check_constraint :open_blog_redirects, "source IN ('slug_change', 'removal', 'unpublish', 'adoption', 'manual')", name: "open_blog_redirects_source"
+  end
+end

data/db/migrate/20261003012520_create_open_blog_revisions.rb

@@ -0,0 +1,14 @@
+class CreateOpenBlogRevisions < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_revisions do |t|
+      t.references :post, null: false, foreign_key: { to_table: :open_blog_posts }
+      t.string :identifier, limit: 64, null: false
+      t.text :payload, null: false
+      t.string :actor
+      t.boolean :made_by_ai
+      t.datetime :created_at, null: false
+    end
+    add_index :open_blog_revisions, [ :post_id, :identifier ], unique: true
+    add_foreign_key :open_blog_posts, :open_blog_revisions, column: :public_revision_id
+  end
+end

data/db/migrate/20261003012521_create_open_blog_approvals.rb

@@ -0,0 +1,21 @@
+class CreateOpenBlogApprovals < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_approvals do |t|
+      t.references :post, null: false, foreign_key: { to_table: :open_blog_posts }
+      t.references :revision, null: false, foreign_key: { to_table: :open_blog_revisions }
+      t.string :kind, null: false
+      t.string :reviewer_name, null: false
+      t.boolean :facts_checked, null: false
+      t.datetime :approved_at, null: false
+      t.date :declared_on
+      t.string :declared_by
+      t.string :confirmed_by
+      t.text :evidence
+      t.string :recorded_by
+      t.datetime :created_at, null: false
+    end
+    add_check_constraint :open_blog_approvals, "kind IN ('sent', 'imported', 'declared')", name: "open_blog_approvals_kind"
+    add_check_constraint :open_blog_approvals, "kind != 'declared' OR (declared_on IS NOT NULL AND declared_by IS NOT NULL)", name: "open_blog_approvals_declaration"
+    add_check_constraint :open_blog_approvals, "kind != 'imported' OR (confirmed_by IS NOT NULL AND evidence IS NOT NULL)", name: "open_blog_approvals_import"
+  end
+end

data/db/migrate/20261003012522_create_open_blog_publications.rb

@@ -0,0 +1,18 @@
+class CreateOpenBlogPublications < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_publications do |t|
+      t.references :post, null: false, foreign_key: { to_table: :open_blog_posts }
+      t.references :revision, null: false, foreign_key: { to_table: :open_blog_revisions }
+      t.string :entry_type, null: false
+      t.datetime :occurred_at, null: false
+      t.string :released_by
+      t.string :description
+      t.text :note
+      t.datetime :created_at, null: false
+    end
+    add_index :open_blog_publications, [ :post_id, :occurred_at ]
+    add_index :open_blog_publications, :post_id, unique: true, where: "entry_type = 'first'", name: "index_open_blog_publications_first"
+    add_check_constraint :open_blog_publications, "entry_type IN ('first', 'substantive', 'correction', 'maintenance', 'adopted')", name: "open_blog_publications_entry_type"
+    add_check_constraint :open_blog_publications, "entry_type != 'correction' OR note IS NOT NULL", name: "open_blog_publications_correction"
+  end
+end

data/db/migrate/20261003012523_create_open_blog_baselines.rb

@@ -0,0 +1,24 @@
+class CreateOpenBlogBaselines < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_baselines do |t|
+      t.references :post, null: false, index: { unique: true }, foreign_key: { to_table: :open_blog_posts }
+      t.datetime :adopted_at, null: false
+      t.references :adopted_revision, null: false, foreign_key: { to_table: :open_blog_revisions }
+      t.string :provenance, null: false
+      t.text :provenance_evidence
+      t.datetime :first_published_at
+      t.text :first_published_evidence
+      t.datetime :declared_first_published_at
+      t.datetime :last_modified_at
+      t.text :last_modified_evidence
+      t.string :source_system
+      t.string :source_id
+      t.string :source_body_sha256, limit: 64
+      t.string :adopted_by
+      t.datetime :created_at, null: false
+    end
+    add_index :open_blog_baselines, [ :source_system, :source_id ], unique: true
+    add_check_constraint :open_blog_baselines, "first_published_at IS NULL OR declared_first_published_at IS NULL", name: "open_blog_baselines_first_date"
+    add_check_constraint :open_blog_baselines, "provenance IN ('ai_assisted', 'human_written', 'unknown')", name: "open_blog_baselines_provenance"
+  end
+end

data/db/migrate/20261003012524_create_open_blog_connection_declarations.rb

@@ -0,0 +1,13 @@
+class CreateOpenBlogConnectionDeclarations < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_connection_declarations do |t|
+      t.references :post, null: false, foreign_key: { to_table: :open_blog_posts }
+      t.public_send(connection.adapter_name == "PostgreSQL" ? :jsonb : :json, :connections, null: false, default: [])
+      t.boolean :third_party_paid, null: false
+      t.string :declared_by, null: false
+      t.date :declared_on, null: false
+      t.string :recorded_by
+      t.datetime :created_at, null: false
+    end
+  end
+end

data/db/migrate/20261003031410_add_body_image_manifest_to_open_blog_posts.rb

@@ -0,0 +1,7 @@
+class AddBodyImageManifestToOpenBlogPosts < ActiveRecord::Migration[8.0]
+  def change
+    format = connection.adapter_name == "PostgreSQL" ? :jsonb : :json
+    add_column :open_blog_posts, :body_image_manifest, format, null: false, default: []
+    add_column :open_blog_posts, :body_image_source_digest, :string, limit: 64
+  end
+end

data/db/migrate/20261003164418_create_open_blog_api_tokens.rb

@@ -0,0 +1,15 @@
+class CreateOpenBlogApiTokens < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_api_tokens do |t|
+      t.string :name, null: false
+      t.string :token_digest, limit: 64, null: false
+      t.string :token_prefix, limit: 8, null: false
+      t.public_send(connection.adapter_name == "PostgreSQL" ? :jsonb : :json, :scopes, null: false, default: %w[read write publish])
+      t.datetime :last_used_at
+      t.datetime :expires_at
+      t.datetime :revoked_at
+      t.timestamps
+    end
+    add_index :open_blog_api_tokens, :token_digest, unique: true
+  end
+end

data/db/migrate/20261003175454_create_open_blog_pages.rb

@@ -0,0 +1,16 @@
+class CreateOpenBlogPages < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_pages do |t|
+      t.string :kind, null: false
+      t.string :slug, null: false
+      t.string :title, null: false
+      t.text :body_markdown, null: false, default: ""
+      t.string :status, null: false, default: "draft"
+      t.string :approved_by
+      t.date :approved_on
+      t.datetime :updated_at, null: false
+    end
+    add_index :open_blog_pages, :kind, unique: true
+    add_index :open_blog_pages, :slug, unique: true
+  end
+end

data/db/migrate/20261003182919_create_open_blog_page_views.rb

@@ -0,0 +1,11 @@
+class CreateOpenBlogPageViews < ActiveRecord::Migration[8.0]
+  def change
+    create_table :open_blog_page_views do |t|
+      t.references :post, null: false, foreign_key: { to_table: :open_blog_posts }, index: false
+      t.date :day, null: false
+      t.integer :views, null: false, default: 0
+    end
+    add_index :open_blog_page_views, [ :post_id, :day ], unique: true
+    add_index :open_blog_page_views, :day
+  end
+end

data/lib/generators/open_blog/admin_suite/admin_suite_generator.rb

@@ -0,0 +1,27 @@
+require "rails/generators"
+require "pathname"
+require_relative "../generator_support"
+
+module OpenBlog
+  module Generators
+    class AdminSuiteGenerator < Rails::Generators::Base
+      include GeneratorSupport
+      source_root File.expand_path("templates", __dir__)
+      class_option :dir, type: :string, default: "app/admin", desc: "Host directory for admin definitions"
+
+      def copy_definitions
+        path = Pathname.new(options[:dir])
+        if path.absolute? || path.each_filename.include?("..") || options[:dir].match?(/[\x00-\x1f*?\[\]{}]/)
+          raise Thor::Error, "Choose a relative host directory without traversal or glob characters."
+        end
+        @admin_dir = path.cleanpath.to_s
+        %w[post category author page].each do |name|
+          template "#{name}_resource.rb.tt", "#{@admin_dir}/resources/open_blog/#{name}_resource.rb", **copy_options
+        end
+        template "blog_portal.rb.tt", "#{@admin_dir}/portals/open_blog_portal.rb", **copy_options
+        template "initializer.rb.tt", "config/initializers/open_blog_admin_suite.rb", **copy_options
+        say "Admin definitions written. Install AdminSuite 0.6.1 or later to activate them; restart the host after adding definitions."
+      end
+    end
+  end
+end

data/lib/generators/open_blog/admin_suite/templates/author_resource.rb.tt

@@ -0,0 +1,29 @@
+module Admin
+  module Resources
+    module OpenBlog
+      class AuthorResource < ::Admin::Base::Resource
+        model ::OpenBlog::Author
+        portal :open_blog
+        section :content
+        def self.resource_name = "open_blog_author"
+
+        index do
+          searchable :name, :slug
+          sortable :name, default: :name, direction: :asc
+          columns do
+            column :name
+            column :slug
+            column :author_type
+          end
+        end
+        form do
+          field :name, required: true
+          field :slug
+          field :author_type, type: :select, collection: %w[person organization]
+          field :bio, type: :textarea
+          field :url, type: :url
+        end
+      end
+    end
+  end
+end

data/lib/generators/open_blog/admin_suite/templates/blog_portal.rb.tt

@@ -0,0 +1,16 @@
+module Admin
+  module Portals
+    class OpenBlogPortal
+      def self.register!
+        ::AdminSuite.portal :open_blog do
+          label "Blog"
+          icon "book-open"
+          section :content do
+            label "Publishing"
+          end
+        end
+      end
+      register!
+    end
+  end
+end

data/lib/generators/open_blog/admin_suite/templates/category_resource.rb.tt

@@ -0,0 +1,28 @@
+module Admin
+  module Resources
+    module OpenBlog
+      class CategoryResource < ::Admin::Base::Resource
+        model ::OpenBlog::Category
+        portal :open_blog
+        section :content
+        def self.resource_name = "open_blog_category"
+
+        index do
+          searchable :name, :slug
+          sortable :position, default: :position, direction: :asc
+          columns do
+            column :name
+            column :slug
+            column :position
+          end
+        end
+        form do
+          field :name, required: true
+          field :slug
+          field :description, type: :textarea
+          field :position, type: :number
+        end
+      end
+    end
+  end
+end

data/lib/generators/open_blog/admin_suite/templates/initializer.rb.tt

@@ -0,0 +1,19 @@
+Rails.autoloaders.main.ignore(
+  Rails.root.join(<%= "#{@admin_dir}/resources/open_blog".inspect %>),
+  Rails.root.join(<%= "#{@admin_dir}/portals/open_blog_portal.rb".inspect %>)
+)
+
+if defined?(::AdminSuite)
+  Rails.application.config.after_initialize do
+    require "open_blog/admin_suite"
+    ::OpenBlog::AdminSuite.install!
+    ::AdminSuite.configure do |config|
+      config.resource_globs |= [ Rails.root.join(<%= "#{@admin_dir}/resources/open_blog/*_resource.rb".inspect %>).to_s ]
+      config.portal_globs |= [ Rails.root.join(<%= "#{@admin_dir}/portals/open_blog_portal.rb".inspect %>).to_s ]
+    end
+    ::AdminSuite::DefinitionLoader.load!(:resources)
+    ::AdminSuite::DefinitionLoader.load!(:portals)
+    Dir[Rails.root.join(<%= "#{@admin_dir}/resources/open_blog/*_resource.rb".inspect %>)].sort.each { |path| require path }
+    require Rails.root.join(<%= "#{@admin_dir}/portals/open_blog_portal.rb".inspect %>).to_s
+  end
+end

data/lib/generators/open_blog/admin_suite/templates/page_resource.rb.tt

@@ -0,0 +1,32 @@
+module Admin
+  module Resources
+    module OpenBlog
+      class PageResource < ::Admin::Base::Resource
+        model ::OpenBlog::Page
+        portal :open_blog
+        section :content
+        def self.resource_name = "open_blog_page"
+
+        index do
+          searchable :title, :slug
+          sortable :updated_at, default: :updated_at, direction: :desc
+          columns do
+            column :title
+            column :kind
+            column :status
+            column :updated_at
+          end
+        end
+        form do
+          field :kind, type: :select, required: true, collection: ::OpenBlog::Page::KINDS
+          field :title, required: true
+          field :slug
+          field :body_markdown, type: :textarea, rows: 18
+          field :status, type: :select, collection: %w[draft published]
+          field :approved_by
+          field :approved_on, type: :date
+        end
+      end
+    end
+  end
+end

data/lib/generators/open_blog/admin_suite/templates/post_resource.rb.tt

@@ -0,0 +1,58 @@
+require "open_blog/admin_suite"
+::OpenBlog::AdminSuite.install!
+
+module Admin
+  module Resources
+    module OpenBlog
+      class PostResource < ::Admin::Base::Resource
+        model ::OpenBlog::Post
+        portal :open_blog
+        section :content
+        def self.resource_name = "open_blog_post"
+
+        index do
+          searchable :title, :slug
+          sortable :updated_at, default: :updated_at, direction: :desc
+          columns do
+            column :title
+            column :status
+            column :author_name
+            column :updated_at
+          end
+        end
+
+        form do
+          field :title, required: true
+          field :slug, required: true, if: ->(post) { post.new_record? }
+          field :description, type: :textarea
+          field :author_id, type: :select, required: true, collection: -> { ::OpenBlog::Author.order(:name).pluck(:name, :id) }
+          field :author_name, required: true, label: "Byline"
+          field :category_id, type: :select, collection: -> { ::OpenBlog::Category.order(:name).pluck(:name, :id) }
+          field :body_markdown, type: :textarea, rows: 18, if: ->(post) { post.markdown? }
+          field :rich_body, type: :rich_text, if: ->(post) { post.rich_text? }
+          field :faqs_attributes, type: :open_blog_faq, help: "Each FAQ needs a unique positive position."
+          field :search_title
+          field :search_description, type: :textarea
+          field :featured, type: :toggle
+          field :status, type: :select, collection: %w[draft published archived], unless: ->(post) { post.scheduled? }
+        end
+
+        show do
+          panel :article, fields: %i[title slug status author_name published_at modified_at]
+          panel :revisions, title: "Recent revisions", association: :revisions, render: :table_from,
+            source: ->(post) { post.revisions.order(id: :desc).limit(20).map { |row| row.attributes.symbolize_keys } },
+            columns: %i[id identifier actor created_at]
+          panel :approvals, title: "Recent approvals", association: :approvals, render: :table_from,
+            source: ->(post) { post.approvals.order(id: :desc).limit(20).map { |row| row.attributes.symbolize_keys } },
+            columns: %i[id revision_id kind reviewer_name facts_checked approved_at]
+          panel :publications, title: "Recent publications", association: :publications, render: :table_from,
+            source: ->(post) { post.publications.order(id: :desc).limit(20).map { |row| row.attributes.symbolize_keys } },
+            columns: %i[id revision_id entry_type occurred_at released_by note]
+          panel :baseline, association: :baseline, render: :table_from,
+            source: ->(post) { Array(post.baseline).map { |row| row.attributes.symbolize_keys } },
+            columns: %i[id source_system source_id provenance first_published_at declared_first_published_at adopted_at]
+        end
+      end
+    end
+  end
+end

data/lib/generators/open_blog/generator_support.rb

@@ -0,0 +1,64 @@
+require "json"
+
+module OpenBlog
+  module Generators
+    module GeneratorSupport
+      private
+
+      def host_file(path)
+        File.join(destination_root, path)
+      end
+
+      def host_read(path)
+        File.file?(host_file(path)) ? File.read(host_file(path)) : ""
+      end
+
+      def javascript_setup
+        return :importmap if File.file?(host_file("config/importmap.rb"))
+        return :bundler if File.file?(host_file("package.json"))
+        :none
+      end
+
+      def css_setup
+        return :fallback if options[:skip_tailwind]
+        package = JSON.parse(host_read("package.json").presence || "{}")
+        version = package.fetch("dependencies", {}).merge(package.fetch("devDependencies", {}))["tailwindcss"].to_s
+        gemfile = host_read("Gemfile")
+        old_gem = gemfile.match?(/^\s*gem\s+["']tailwindcss-rails["']\s*,\s*["'][~>\s]*3(?:\.|["'])/)
+        old_gem ||= host_read("Gemfile.lock").match?(/^    tailwindcss-rails \(3\./)
+        old_gem ||= host_read("app/assets/stylesheets/application.tailwind.css").match?(/@tailwind\s+(?:base|components|utilities)\b/)
+        return :legacy if version.match?(/\A[~^>=\s]*3(?:\.|\z)/) || old_gem
+        return :rails if File.file?(host_file("app/assets/tailwind/application.css"))
+        if version.match?(/\A[~^>=\s]*4(?:\.|\z)/) && File.file?(host_file("app/assets/stylesheets/application.tailwind.css"))
+          return :bundler
+        end
+        :none
+      rescue JSON::ParserError => error
+        raise Thor::Error, "Cannot read package.json: #{error.message}"
+      end
+
+      def copy_options
+        { force: options[:force], skip: options[:skip] || (!options[:force] && !$stdin.tty?) }
+      end
+
+      def copy_reader_views(css: css_setup, javascript: javascript_setup)
+        directory "views/open_blog", "app/views/open_blog", **copy_options
+        content = File.read(find_in_source_paths("views/layouts/open_blog.html.erb"))
+        stylesheet = case css
+        when :rails then 'stylesheet_link_tag "tailwind", "data-turbo-track": "reload"'
+        when :bundler then 'stylesheet_link_tag "application", "data-turbo-track": "reload"'
+        else "open_blog_stylesheets"
+        end
+        content = content.sub("open_blog_stylesheets", stylesheet)
+        if javascript == :bundler
+          content = content.sub("javascript_importmap_tags", 'javascript_include_tag "application", "data-turbo-track": "reload", defer: true')
+        end
+        create_file "app/views/layouts/open_blog.html.erb", content, **copy_options
+      end
+
+      def append_once(path, content)
+        append_to_file(path, content) unless host_read(path).include?(content.strip)
+      end
+    end
+  end
+end