agreement_engine 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 20b626073ba02a1bbcdb3512d51adae2aaffefd73eb31f1f1dc9a985969d89f0
+  data.tar.gz: 33445687584c472677c84c26d3e8e3dc151e911c8b3f375b7a15c7fe6f9854a4
+SHA512:
+  metadata.gz: 33bde405dbcf745dcfced2ddf15280b9491ddcc22dde298a14b8a6ebdbe6f7721fa00413f1e01b2b81fd16144590d6462a427c3bf61b962bab03ba8d89d13225
+  data.tar.gz: 8afb74c402eda31255db66d590b64a52661ed3b734bddfa42e6da518216f95bf9aaf29916c0f1f55b70ca92afee32bd56581cdb47b6539c2ca25428ca16d66c1

data/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rake test

data/.github/workflows/release.yml

@@ -0,0 +1,15 @@
+name: Release
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  release:
+    permissions:
+      contents: write
+      id-token: write
+      issues: write
+      actions: read
+    uses: DYB-Development/symphony/.github/workflows/gem-release.yml@main

data/.ruby-version

@@ -0,0 +1 @@
+3.4.6

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2026-02-12
+
+### Added
+
+- Rails engine with isolated namespace
+- `AgreementEngine::Document` model with versioned legal document management
+- `Signable` concern for user models to track agreement acceptance
+- `Enforceable` concern for controllers to require agreement acceptance
+- `AgreementsController` for user-facing acceptance flow
+- `DocumentsController` with public terms and privacy pages
+- `Admin::DocumentsController` with full CRUD and auth protection
+- Engine migrations for documents table and user tracking columns
+- Seed rake task (`agreement_engine:seed`) for initial legal documents
+- Host app route helpers exposed to engine views
+- GitHub Actions CI workflow

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Tyler Schneider
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,104 @@
+# AgreementEngine
+
+Versioned legal document management for Rails. Track and enforce user acceptance of Terms of Service, Privacy Policy, and other legal agreements with versioned documents and audit trails.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "agreement_engine"
+```
+
+Then run:
+
+```bash
+bundle install
+rails agreement_engine:install:migrations
+rails db:migrate
+```
+
+## Setup
+
+### 1. Configure agreements
+
+Create `config/initializers/agreement_engine.rb`:
+
+```ruby
+AgreementEngine.configure do |config|
+  config.agreements = [
+    AgreementEngine::Agreement.new(
+      id: :terms_of_service,
+      title: "Terms Of Service",
+      version_column: :accepted_terms_of_service_version_id,
+      document_type: :terms_of_service,
+      prompt_when_updated: true
+    ),
+    AgreementEngine::Agreement.new(
+      id: :privacy_policy,
+      title: "Privacy Policy",
+      version_column: :accepted_privacy_policy_version_id,
+      document_type: :privacy_policy,
+      prompt_when_updated: true
+    )
+  ]
+end
+```
+
+### 2. Include concerns
+
+```ruby
+# app/models/user.rb
+class User < ApplicationRecord
+  include AgreementEngine::Signable
+end
+
+# app/controllers/application_controller.rb
+class ApplicationController < ActionController::Base
+  include AgreementEngine::Enforceable
+end
+```
+
+### 3. Mount routes
+
+```ruby
+# config/routes.rb
+mount AgreementEngine::Engine, at: "/"
+```
+
+### 4. Seed initial documents
+
+```bash
+rails agreement_engine:seed
+```
+
+## Auth Configuration
+
+AgreementEngine defaults to Devise conventions. Override for other auth systems:
+
+```ruby
+AgreementEngine.configure do |config|
+  config.current_user_method = ->(c) { c.current_user }
+  config.signed_in_method = ->(c) { c.user_signed_in? }
+  config.auth_controller_method = ->(c) { c.devise_controller? }
+  config.sign_out_method = ->(c) { c.sign_out(c.current_user) }
+end
+```
+
+## Routes
+
+The engine provides:
+
+- `GET /agreements/:id` - Show agreement for acceptance
+- `PATCH /agreements/:id` - Accept agreement
+- `DELETE /agreements/:id` - Decline agreement (signs user out)
+- `GET /terms` - Public terms of service page
+- `GET /privacy` - Public privacy policy page
+- `GET /admin/documents` - Admin CRUD for managing document versions
+
+## Development
+
+```bash
+bundle install
+bundle exec rake test
+```

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/app/controllers/agreement_engine/admin/documents_controller.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  module Admin
+    class DocumentsController < ::ApplicationController
+      skip_before_action :require_accepted_agreements!, raise: false
+      before_action :authenticate_admin!
+      before_action :set_document, only: [:show, :edit, :update, :destroy]
+
+      def index
+        @documents = AgreementEngine::Document.order(created_at: :desc)
+        @documents = apply_scope(@documents)
+      end
+
+      def show
+      end
+
+      def new
+        @document = AgreementEngine::Document.new
+      end
+
+      def create
+        @document = AgreementEngine::Document.new(document_params)
+
+        if @document.save
+          redirect_to agreement_engine.admin_document_path(@document), notice: "Document was successfully created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def edit
+      end
+
+      def update
+        if @document.update(document_params)
+          redirect_to agreement_engine.admin_document_path(@document), notice: "Document was successfully updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        @document.destroy
+        redirect_to agreement_engine.admin_documents_path, notice: "Document was successfully deleted.", status: :see_other
+      end
+
+      private
+
+      def authenticate_admin!
+        AgreementEngine.config.authenticate_admin!(self)
+      end
+
+      def set_document
+        @document = AgreementEngine::Document.find(params[:id])
+      end
+
+      def document_params
+        params.require(:document).permit(:document_type, :version, :summary, :effective_at, :content)
+      end
+
+      def apply_scope(documents)
+        case params[:scope]
+        when "published" then documents.published
+        when "draft" then documents.draft
+        else documents
+        end
+      end
+    end
+  end
+end

data/app/controllers/agreement_engine/agreements_controller.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  class AgreementsController < ::ApplicationController
+    skip_before_action :require_accepted_agreements!, raise: false
+    before_action :agreement_engine_authenticate_user!
+    before_action :set_agreement
+    before_action :set_version
+
+    layout "agreement_engine/minimal"
+
+    def show
+    end
+
+    def update
+      if @version
+        agreement_engine_current_user.accept_version!(@agreement, @version)
+      end
+      redirect_to after_accepted_path, status: :see_other
+    end
+
+    def destroy
+      AgreementEngine.config.sign_out(self)
+      redirect_to main_app.root_path, status: :see_other, alert: t(".declined", agreement: @agreement.title)
+    end
+
+    private
+
+    def agreement_engine_current_user
+      AgreementEngine.config.current_user(self)
+    end
+
+    def agreement_engine_authenticate_user!
+      unless AgreementEngine.config.signed_in?(self)
+        redirect_to main_app.root_path
+      end
+    end
+
+    def set_agreement
+      @agreement = AgreementEngine.config.agreements.find { |a| a.id.to_s == params[:id] }
+
+      if @agreement.nil?
+        redirect_to main_app.root_path
+      elsif @agreement.accepted_by?(agreement_engine_current_user)
+        redirect_to after_accepted_path
+      end
+    end
+
+    def set_version
+      @version = @agreement&.current_version
+    end
+
+    def after_accepted_path
+      stored_location_for(:user) || main_app.root_path
+    end
+  end
+end

data/app/controllers/agreement_engine/documents_controller.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  class DocumentsController < ::ApplicationController
+    def terms
+      @agreement = AgreementEngine.config.agreements.find { |a| a.id == :terms_of_service }
+      @version = AgreementEngine::Document.current(:terms_of_service)
+    end
+
+    def privacy
+      @agreement = AgreementEngine.config.agreements.find { |a| a.id == :privacy_policy }
+      @version = AgreementEngine::Document.current(:privacy_policy)
+    end
+  end
+end

data/app/models/agreement_engine/document.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  class Document < ActiveRecord::Base
+    self.table_name = "agreement_engine_documents"
+
+    has_rich_text :content
+
+    validates :document_type, presence: true
+    validates :version, presence: true, uniqueness: {scope: :document_type}
+    validates :content, presence: true
+
+    scope :published, -> { where("effective_at <= ?", Time.current) }
+    scope :draft, -> { where(effective_at: nil) }
+
+    def self.current(document_type)
+      where(document_type: document_type)
+        .published
+        .order(effective_at: :desc)
+        .first
+    end
+
+    def published?
+      effective_at.present? && effective_at <= Time.current
+    end
+  end
+end

data/app/views/agreement_engine/admin/documents/_form.html.erb

@@ -0,0 +1,44 @@
+<%= form_with(model: document, url: url, class: "space-y-4") do |form| %>
+  <% if document.errors.any? %>
+    <div class="bg-red-50 border border-red-200 rounded p-4">
+      <h2 class="text-red-800 font-medium"><%= pluralize(document.errors.count, "error") %> prohibited this document from being saved:</h2>
+      <ul class="mt-2 list-disc list-inside text-red-700">
+        <% document.errors.full_messages.each do |message| %>
+          <li><%= message %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <div>
+    <%= form.label :document_type, class: "block text-sm font-medium text-gray-700" %>
+    <%= form.select :document_type,
+      AgreementEngine.config.agreements.map { |a| [a.title, a.document_type] },
+      {}, class: "mt-1 block w-full rounded-md border-gray-300 shadow-sm" %>
+  </div>
+
+  <div>
+    <%= form.label :version, class: "block text-sm font-medium text-gray-700" %>
+    <%= form.text_field :version, class: "mt-1 block w-full rounded-md border-gray-300 shadow-sm" %>
+  </div>
+
+  <div>
+    <%= form.label :summary, class: "block text-sm font-medium text-gray-700" %>
+    <%= form.text_area :summary, rows: 2, class: "mt-1 block w-full rounded-md border-gray-300 shadow-sm" %>
+  </div>
+
+  <div>
+    <%= form.label :effective_at, class: "block text-sm font-medium text-gray-700" %>
+    <%= form.datetime_local_field :effective_at, class: "mt-1 block w-full rounded-md border-gray-300 shadow-sm" %>
+    <p class="mt-1 text-sm text-gray-500">Leave blank to save as draft.</p>
+  </div>
+
+  <div>
+    <%= form.label :content, class: "block text-sm font-medium text-gray-700" %>
+    <%= form.rich_text_area :content, class: "mt-1 block w-full" %>
+  </div>
+
+  <div>
+    <%= form.submit class: "btn btn-primary" %>
+  </div>
+<% end %>

data/app/views/agreement_engine/admin/documents/edit.html.erb

@@ -0,0 +1,5 @@
+<div class="mx-auto max-w-4xl px-4 py-8">
+  <h1 class="text-2xl font-bold mb-6">Edit Document</h1>
+
+  <%= render "form", document: @document, url: agreement_engine.admin_document_path(@document) %>
+</div>

data/app/views/agreement_engine/admin/documents/index.html.erb

@@ -0,0 +1,38 @@
+<div class="mx-auto max-w-6xl px-4 py-8">
+  <div class="flex items-center justify-between mb-6">
+    <h1 class="text-2xl font-bold">Legal Documents</h1>
+    <%= link_to "New Document", agreement_engine.new_admin_document_path, class: "btn btn-primary" %>
+  </div>
+
+  <div class="mb-4 flex gap-2">
+    <%= link_to "All", agreement_engine.admin_documents_path, class: "px-3 py-1 rounded #{params[:scope].blank? ? 'bg-gray-900 text-white' : 'bg-gray-100'}" %>
+    <%= link_to "Published", agreement_engine.admin_documents_path(scope: "published"), class: "px-3 py-1 rounded #{params[:scope] == 'published' ? 'bg-gray-900 text-white' : 'bg-gray-100'}" %>
+    <%= link_to "Draft", agreement_engine.admin_documents_path(scope: "draft"), class: "px-3 py-1 rounded #{params[:scope] == 'draft' ? 'bg-gray-900 text-white' : 'bg-gray-100'}" %>
+  </div>
+
+  <table class="min-w-full divide-y divide-gray-200">
+    <thead>
+      <tr>
+        <th class="px-4 py-2 text-left text-sm font-medium text-gray-500">Type</th>
+        <th class="px-4 py-2 text-left text-sm font-medium text-gray-500">Version</th>
+        <th class="px-4 py-2 text-left text-sm font-medium text-gray-500">Status</th>
+        <th class="px-4 py-2 text-left text-sm font-medium text-gray-500">Effective</th>
+        <th class="px-4 py-2 text-left text-sm font-medium text-gray-500">Actions</th>
+      </tr>
+    </thead>
+    <tbody class="divide-y divide-gray-200">
+      <% @documents.each do |document| %>
+        <tr>
+          <td class="px-4 py-2"><%= document.document_type.titleize %></td>
+          <td class="px-4 py-2"><%= document.version %></td>
+          <td class="px-4 py-2"><%= document.published? ? "Published" : "Draft" %></td>
+          <td class="px-4 py-2"><%= document.effective_at&.strftime("%B %d, %Y") || "—" %></td>
+          <td class="px-4 py-2 flex gap-2">
+            <%= link_to "View", agreement_engine.admin_document_path(document) %>
+            <%= link_to "Edit", agreement_engine.edit_admin_document_path(document) %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>

data/app/views/agreement_engine/admin/documents/new.html.erb

@@ -0,0 +1,5 @@
+<div class="mx-auto max-w-4xl px-4 py-8">
+  <h1 class="text-2xl font-bold mb-6">New Document</h1>
+
+  <%= render "form", document: @document, url: agreement_engine.admin_documents_path %>
+</div>

data/app/views/agreement_engine/admin/documents/show.html.erb

@@ -0,0 +1,30 @@
+<div class="mx-auto max-w-4xl px-4 py-8">
+  <div class="flex items-center justify-between mb-6">
+    <h1 class="text-2xl font-bold"><%= @document.document_type.titleize %> v<%= @document.version %></h1>
+    <div class="flex gap-2">
+      <%= link_to "Edit", agreement_engine.edit_admin_document_path(@document), class: "btn btn-secondary" %>
+      <%= link_to "Back", agreement_engine.admin_documents_path, class: "btn btn-secondary" %>
+    </div>
+  </div>
+
+  <dl class="grid grid-cols-2 gap-4 mb-6">
+    <div>
+      <dt class="text-sm font-medium text-gray-500">Status</dt>
+      <dd><%= @document.published? ? "Published" : "Draft" %></dd>
+    </div>
+    <div>
+      <dt class="text-sm font-medium text-gray-500">Effective Date</dt>
+      <dd><%= @document.effective_at&.strftime("%B %d, %Y") || "Not set" %></dd>
+    </div>
+    <% if @document.summary.present? %>
+      <div class="col-span-2">
+        <dt class="text-sm font-medium text-gray-500">Summary</dt>
+        <dd><%= @document.summary %></dd>
+      </div>
+    <% end %>
+  </dl>
+
+  <article class="prose prose-gray dark:prose-invert max-w-none">
+    <%= @document.content %>
+  </article>
+</div>

data/app/views/agreement_engine/agreements/show.html.erb

@@ -0,0 +1,24 @@
+<div class="max-w-4xl mx-auto p-4 my-8 lg:my-24">
+  <h1 class="mb-4"><%= t(".title", agreement: @agreement.title) %></h1>
+
+  <% if @version %>
+    <%= tag.p t(".last_updated", date: l(@version.effective_at.to_date, format: :long)), class: "mb-4 text-gray-700 leading-normal italic" %>
+
+    <article class="prose prose-gray dark:prose-invert max-w-none">
+      <%= @version.content %>
+    </article>
+  <% else %>
+    <p class="text-gray-500">No version has been published yet.</p>
+  <% end %>
+
+  <div class="mt-8 sm:mt-16">
+    <div class="text-center">
+      <%= t(".description", agreement: @agreement.title) %>
+    </div>
+
+    <div class="mt-4 flex items-center justify-center gap-2">
+      <%= button_to t(".decline"), agreement_engine.agreement_path(@agreement), method: :delete, class: "btn btn-secondary btn-large" %>
+      <%= button_to t(".accept"), agreement_engine.agreement_path(@agreement), method: :patch, class: "btn btn-primary btn-large" %>
+    </div>
+  </div>
+</div>

data/app/views/agreement_engine/documents/privacy.html.erb

@@ -0,0 +1,16 @@
+<% content_for :title, "Privacy Policy" %>
+
+<div class="mx-auto max-w-4xl px-4 py-12 sm:px-6 lg:px-8">
+  <article class="prose prose-gray dark:prose-invert max-w-none">
+    <h1>Privacy Policy</h1>
+
+    <% if @version %>
+      <p class="text-sm text-gray-500 dark:text-gray-400">
+        Version <%= @version.version %> - Effective <%= @version.effective_at.strftime("%B %d, %Y") %>
+      </p>
+      <%= @version.content %>
+    <% else %>
+      <p class="text-gray-500">No privacy policy has been published yet.</p>
+    <% end %>
+  </article>
+</div>

data/app/views/agreement_engine/documents/terms.html.erb

@@ -0,0 +1,16 @@
+<% content_for :title, "Terms of Service" %>
+
+<div class="mx-auto max-w-4xl px-4 py-12 sm:px-6 lg:px-8">
+  <article class="prose prose-gray dark:prose-invert max-w-none">
+    <h1>Terms of Service</h1>
+
+    <% if @version %>
+      <p class="text-sm text-gray-500 dark:text-gray-400">
+        Version <%= @version.version %> - Effective <%= @version.effective_at.strftime("%B %d, %Y") %>
+      </p>
+      <%= @version.content %>
+    <% else %>
+      <p class="text-gray-500">No terms of service have been published yet.</p>
+    <% end %>
+  </article>
+</div>

data/app/views/layouts/agreement_engine/minimal.html.erb

@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title><%= yield :title %></title>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <%= csrf_meta_tags %>
+</head>
+<body>
+  <%= yield %>
+</body>
+</html>

data/config/locales/en.yml

@@ -0,0 +1,11 @@
+en:
+  agreement_engine:
+    agreements:
+      show:
+        title: "%{agreement} Changed"
+        last_updated: "Last updated %{date}"
+        description: "Before you can proceed, you must read and accept the new %{agreement}."
+        accept: "I Accept"
+        decline: "I Decline"
+      destroy:
+        declined: "To continue using the service, please sign in and accept the %{agreement}."

data/config/routes.rb

@@ -0,0 +1,10 @@
+AgreementEngine::Engine.routes.draw do
+  resources :agreements, only: [:show, :update, :destroy]
+
+  get "terms", to: "documents#terms", as: :terms
+  get "privacy", to: "documents#privacy", as: :privacy
+
+  namespace :admin do
+    resources :documents
+  end
+end

data/db/migrate/20260208000001_create_fine_print_documents.rb

@@ -0,0 +1,15 @@
+class CreateFinePrintDocuments < ActiveRecord::Migration[8.0]
+  def change
+    create_table :fine_print_documents do |t|
+      t.string :document_type, null: false
+      t.string :version, null: false
+      t.datetime :effective_at
+      t.text :summary
+
+      t.timestamps
+    end
+
+    add_index :fine_print_documents, [:document_type, :version], unique: true
+    add_index :fine_print_documents, [:document_type, :effective_at]
+  end
+end

data/db/migrate/20260208000002_add_fine_print_to_users.rb

@@ -0,0 +1,8 @@
+class AddFinePrintToUsers < ActiveRecord::Migration[8.0]
+  def change
+    add_column :users, :accepted_terms_of_service_version_id, :bigint
+    add_column :users, :accepted_privacy_policy_version_id, :bigint
+    add_foreign_key :users, :fine_print_documents, column: :accepted_terms_of_service_version_id
+    add_foreign_key :users, :fine_print_documents, column: :accepted_privacy_policy_version_id
+  end
+end

data/db/migrate/20260921200000_rename_fine_print_tables_to_agreement_engine.rb

@@ -0,0 +1,5 @@
+class RenameFinePrintTablesToAgreementEngine < ActiveRecord::Migration[8.0]
+  def change
+    rename_table :fine_print_documents, :agreement_engine_documents
+  end
+end

data/lib/agreement_engine/agreement.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  Agreement = Data.define(:id, :title, :version_column, :document_type, :prompt_when_updated) do
+    def current_version
+      AgreementEngine::Document.current(document_type)
+    end
+
+    def accepted_by?(user)
+      current = current_version
+      return true unless current
+      user.public_send(version_column) == current.id
+    end
+
+    def not_accepted_by?(user)
+      !accepted_by?(user)
+    end
+
+    def to_param = id
+
+    def to_partial_path = "agreement_engine/agreements/#{id}"
+  end
+end

data/lib/agreement_engine/configuration.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  class Configuration
+    attr_accessor :agreements
+    attr_accessor :current_user_method
+    attr_accessor :signed_in_method
+    attr_accessor :auth_controller_method
+    attr_accessor :sign_out_method
+    attr_accessor :admin_auth_method
+
+    def initialize
+      @agreements = []
+
+      @current_user_method = ->(c) { c.current_user }
+      @signed_in_method = ->(c) { c.user_signed_in? }
+      @auth_controller_method = ->(c) { c.respond_to?(:devise_controller?) && c.devise_controller? }
+      @sign_out_method = ->(c) {
+        if defined?(Devise) && Devise.sign_out_all_scopes
+          c.sign_out
+        else
+          c.sign_out(c.current_user)
+        end
+      }
+      @admin_auth_method = ->(c) {
+        c.redirect_to("/", alert: "Not authorized") unless signed_in?(c)
+      }
+    end
+
+    def current_user(controller) = current_user_method.call(controller)
+    def signed_in?(controller) = signed_in_method.call(controller)
+    def auth_controller?(controller) = auth_controller_method.call(controller)
+    def sign_out(controller) = sign_out_method.call(controller)
+    def authenticate_admin!(controller) = admin_auth_method.call(controller)
+  end
+end

data/lib/agreement_engine/enforceable.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  module Enforceable
+    extend ActiveSupport::Concern
+
+    included do
+      before_action :require_accepted_agreements!,
+        if: -> { request.get? && AgreementEngine.config.signed_in?(self) && !AgreementEngine.config.auth_controller?(self) }
+    end
+
+    def require_accepted_agreements!
+      AgreementEngine.config.agreements.select(&:prompt_when_updated).each do |agreement|
+        if agreement.not_accepted_by?(AgreementEngine.config.current_user(self))
+          store_location_for(:user, request.fullpath) unless request.fullpath.start_with?("/agreements/")
+          redirect_to agreement_engine.agreement_path(agreement)
+          break
+        end
+      end
+    end
+  end
+end

data/lib/agreement_engine/engine.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  class Engine < ::Rails::Engine
+    isolate_namespace AgreementEngine
+
+    initializer "agreement_engine.url_helpers" do
+      ActiveSupport.on_load(:action_controller) do
+        helper Rails.application.routes.url_helpers
+      end
+    end
+  end
+end

data/lib/agreement_engine/signable.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  module Signable
+    extend ActiveSupport::Concern
+
+    included do
+      AgreementEngine.config.agreements.each do |agreement|
+        belongs_to :"accepted_#{agreement.document_type}_version",
+          class_name: "AgreementEngine::Document",
+          optional: true
+      end
+    end
+
+    def needs_acceptance?(agreement)
+      agreement.not_accepted_by?(self)
+    end
+
+    def accept_version!(agreement, version)
+      update!(agreement.version_column => version.id)
+    end
+  end
+end

data/lib/agreement_engine/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AgreementEngine
+  VERSION = "0.1.0"
+end

data/lib/agreement_engine.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "agreement_engine/version"
+require_relative "agreement_engine/configuration"
+require_relative "agreement_engine/agreement"
+
+module AgreementEngine
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    def configure
+      yield config
+    end
+  end
+end
+
+require_relative "agreement_engine/engine"
+require_relative "agreement_engine/signable"
+require_relative "agreement_engine/enforceable"

data/lib/generators/agreement_engine/install_generator.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+
+module AgreementEngine
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Installs AgreementEngine: adds route, copies initializer and migrations."
+
+      def mount_engine
+        route 'mount AgreementEngine::Engine, at: "/legal"'
+      end
+
+      def copy_initializer
+        template "initializer.rb", "config/initializers/agreement_engine.rb"
+      end
+
+      def copy_migrations
+        migrations_dir = AgreementEngine::Engine.root.join("db/migrate")
+        Dir[migrations_dir.join("*.rb")].sort.each do |migration|
+          filename = File.basename(migration).sub(/^\d+_/, "")
+          migration_template migration, "db/migrate/#{filename}"
+        end
+      end
+    end
+  end
+end

data/lib/generators/agreement_engine/templates/initializer.rb

@@ -0,0 +1,18 @@
+AgreementEngine.configure do |config|
+  # Lambda called to get the current user (default: controller.current_user)
+  # config.current_user_method = ->(controller) { controller.current_user }
+
+  # Lambda called to check if a user is signed in (default: controller.user_signed_in?)
+  # config.signed_in_method = ->(controller) { controller.user_signed_in? }
+
+  # Lambda called to authorize admin access (default: redirects if not signed in)
+  # config.admin_auth_method = ->(controller) {
+  #   controller.redirect_to("/", alert: "Not authorized") unless config.signed_in?(controller)
+  # }
+
+  # Define your legal agreements:
+  # config.agreements = [
+  #   AgreementEngine::Agreement.new(:terms, title: "Terms of Service", required: true),
+  #   AgreementEngine::Agreement.new(:privacy, title: "Privacy Policy", required: true),
+  # ]
+end

data/lib/tasks/agreement_engine.rake

@@ -0,0 +1,23 @@
+namespace :agreement_engine do
+  desc "Seed initial legal document versions for each configured agreement"
+  task seed: :environment do
+    puts "Seeding legal documents..."
+
+    AgreementEngine.config.agreements.each do |agreement|
+      if AgreementEngine::Document.where(document_type: agreement.document_type).exists?
+        puts "  #{agreement.title} v1.0 already exists, skipping"
+      else
+        AgreementEngine::Document.create!(
+          document_type: agreement.document_type,
+          version: "1.0",
+          summary: "Initial #{agreement.title.downcase}",
+          content: "<h2>#{agreement.title}</h2><p>This is a placeholder. Please update with your actual #{agreement.title.downcase}.</p>",
+          effective_at: Time.current
+        )
+        puts "  Created #{agreement.title} v1.0"
+      end
+    end
+
+    puts "Done!"
+  end
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: agreement_engine
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- tylercschneider
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+description: Track and enforce user acceptance of Terms of Service, Privacy Policy,
+  and other legal agreements with versioned documents and audit trails.
+email:
+- tylercschneider@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
+- ".ruby-version"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- app/controllers/agreement_engine/admin/documents_controller.rb
+- app/controllers/agreement_engine/agreements_controller.rb
+- app/controllers/agreement_engine/documents_controller.rb
+- app/models/agreement_engine/document.rb
+- app/views/agreement_engine/admin/documents/_form.html.erb
+- app/views/agreement_engine/admin/documents/edit.html.erb
+- app/views/agreement_engine/admin/documents/index.html.erb
+- app/views/agreement_engine/admin/documents/new.html.erb
+- app/views/agreement_engine/admin/documents/show.html.erb
+- app/views/agreement_engine/agreements/show.html.erb
+- app/views/agreement_engine/documents/privacy.html.erb
+- app/views/agreement_engine/documents/terms.html.erb
+- app/views/layouts/agreement_engine/minimal.html.erb
+- config/locales/en.yml
+- config/routes.rb
+- db/migrate/20260208000001_create_fine_print_documents.rb
+- db/migrate/20260208000002_add_fine_print_to_users.rb
+- db/migrate/20260921200000_rename_fine_print_tables_to_agreement_engine.rb
+- lib/agreement_engine.rb
+- lib/agreement_engine/agreement.rb
+- lib/agreement_engine/configuration.rb
+- lib/agreement_engine/enforceable.rb
+- lib/agreement_engine/engine.rb
+- lib/agreement_engine/signable.rb
+- lib/agreement_engine/version.rb
+- lib/generators/agreement_engine/install_generator.rb
+- lib/generators/agreement_engine/templates/initializer.rb
+- lib/tasks/agreement_engine.rake
+homepage: https://github.com/DYB-Development/agreement_engine
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/DYB-Development/agreement_engine
+  source_code_uri: https://github.com/DYB-Development/agreement_engine
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Versioned legal document management for Rails
+test_files: []