overule 0.1.0

data/app/views/overule/rules/_form.html.erb

@@ -0,0 +1,95 @@
+<%= form_with model: rule, url: rule.persisted? ? rule_path(rule) : rules_path, local: true, html: { "x-data" => "ruleBuilder(#{rule.definition.to_json})", class: "space-y-6" } do |f| %>
+  <% if rule.errors.any? %>
+    <div class="bg-rose-50 border border-rose-200 text-rose-900 px-4 py-3 rounded">
+      <p class="font-medium mb-1"><%= pluralize(rule.errors.count, "error") %> prevented saving:</p>
+      <ul class="list-disc list-inside text-sm">
+        <% rule.errors.full_messages.each do |msg| %>
+          <li><%= msg %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <section class="bg-white border border-slate-200 rounded-lg p-5 space-y-4">
+    <div>
+      <%= f.label :name, class: "block text-sm font-medium text-slate-700 mb-1" %>
+      <%= f.text_field :name, required: true, class: "w-full border border-slate-300 rounded px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-slate-900/20" %>
+    </div>
+    <div>
+      <%= f.label :description, class: "block text-sm font-medium text-slate-700 mb-1" %>
+      <%= f.text_area :description, rows: 2, class: "w-full border border-slate-300 rounded px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-slate-900/20" %>
+    </div>
+    <div class="flex items-center gap-2">
+      <%= f.check_box :enabled, class: "rounded border-slate-300" %>
+      <%= f.label :enabled, class: "text-sm text-slate-700" %>
+    </div>
+  </section>
+
+  <section class="bg-white border border-slate-200 rounded-lg p-5">
+    <h2 class="text-sm font-medium text-slate-600 mb-3">When (conditions)</h2>
+    <template x-if="whenNode">
+      <div x-data="ruleGroup(whenNode)">
+        <%= render "group", depth: 0 %>
+      </div>
+    </template>
+  </section>
+
+  <section class="bg-white border border-slate-200 rounded-lg p-5 space-y-3">
+    <h2 class="text-sm font-medium text-slate-600">Then ($static action)</h2>
+    <p class="text-xs text-slate-500">Outputs returned when the rule matches. Each value has a datatype; <code>array</code> and <code>object</code> can be nested recursively.</p>
+
+    <div class="space-y-3">
+      <template x-for="(entry, i) in staticEntries" :key="i">
+        <div class="border border-slate-200 rounded-lg bg-white shadow-sm" x-data="staticNode(entry.node)">
+          <div class="flex items-center gap-2 px-4 py-2.5 border-b border-slate-100 bg-slate-50/60 rounded-t-lg">
+            <span class="text-xs text-slate-400 font-mono select-none">key</span>
+            <input type="text" placeholder="output name" x-model="entry.k"
+                   class="flex-1 bg-transparent border-0 px-0 text-sm font-mono font-medium text-slate-900 placeholder-slate-400 focus:outline-none focus:ring-0">
+            <select x-model="node.kind" @change="onKindChange()"
+                    class="border border-slate-300 rounded px-2 py-1 text-xs font-mono bg-white">
+              <option value="string">string</option>
+              <option value="number">number</option>
+              <option value="boolean">boolean</option>
+              <option value="null">null</option>
+              <option value="array">array</option>
+              <option value="object">object</option>
+            </select>
+            <button type="button" @click="$parent.removeStaticEntry(i)"
+                    class="text-rose-600 hover:bg-rose-50 rounded px-2 py-1">&times;</button>
+          </div>
+          <div class="px-4 py-3">
+            <%= render "static_node", depth: 0 %>
+          </div>
+        </div>
+      </template>
+    </div>
+
+    <button type="button" @click="addStaticEntry()"
+            class="text-sm px-3 py-1.5 rounded border border-dashed border-slate-300 hover:border-slate-400 hover:bg-slate-50 text-slate-600">
+      + Add output
+    </button>
+  </section>
+
+  <section class="bg-slate-900 text-slate-100 rounded-lg p-4" x-data="{ copied: false }">
+    <details>
+      <summary class="text-xs uppercase tracking-wide text-slate-400 cursor-pointer">JSON preview</summary>
+      <div class="relative mt-3">
+        <button type="button"
+                @click="navigator.clipboard.writeText(JSON.stringify(computedRoot, null, 2)).then(() => { copied = true; setTimeout(() => copied = false, 1500) })"
+                class="absolute top-2 right-2 text-xs px-2 py-1 rounded bg-slate-700 hover:bg-slate-600 text-slate-100">
+          <span x-text="copied ? 'Copied!' : 'Copy'"></span>
+        </button>
+        <pre class="text-xs overflow-x-auto pr-16"><code x-text="JSON.stringify(computedRoot, null, 2)"></code></pre>
+      </div>
+    </details>
+  </section>
+
+  <%= f.hidden_field :definition, "x-bind:value": "serialized" %>
+
+  <div class="flex items-center gap-3">
+    <%= f.submit (rule.persisted? ? "Save changes" : "Create rule"),
+          class: "px-4 py-2 rounded bg-slate-900 text-white text-sm hover:bg-slate-700 cursor-pointer" %>
+    <%= link_to "Cancel", (rule.persisted? ? rule_path(rule) : rules_path),
+          class: "px-4 py-2 rounded text-sm text-slate-600 hover:bg-slate-100" %>
+  </div>
+<% end %>

data/app/views/overule/rules/_group.html.erb

@@ -0,0 +1,106 @@
+<%# Recursive group partial. Expects an enclosing element with x-data="ruleGroup(node)". %>
+<%# ERB recursion is bounded by MAX_DEPTH so we can pre-render enough levels for users to nest into; %>
+<%# anything beyond MAX_DEPTH is reachable only after the user reloads against a deeper saved rule. %>
+<% depth = local_assigns.fetch(:depth, 0) %>
+<% max_depth = local_assigns.fetch(:max_depth, 6) %>
+<div class="<%= "border-l-2 pl-3 ml-1" unless depth.zero? %> <%= depth.zero? ? "" : "border-slate-200" %>">
+  <div class="flex items-center gap-2 mb-3">
+    <label class="flex items-center gap-2 text-xs text-slate-500 uppercase tracking-wide">
+      <span>Match</span>
+      <select x-model="node.op"
+              class="border border-slate-300 rounded px-2 py-1 text-xs normal-case tracking-normal">
+        <option value="and">AND</option>
+        <option value="or">OR</option>
+      </select>
+    </label>
+    <span class="text-xs text-slate-500">of the following</span>
+  </div>
+
+  <div class="space-y-2">
+    <template x-for="(c, i) in node.cond" :key="i">
+      <div class="flex flex-wrap gap-2 items-start bg-slate-50 border border-slate-200 rounded p-2">
+        <input type="text" x-model="c.var" placeholder="variable"
+               class="flex-1 min-w-[120px] border border-slate-300 rounded px-2 py-1.5 text-sm font-mono">
+
+        <select x-model="c.datatype" @change="onDatatypeChange(i)"
+                class="border border-slate-300 rounded px-2 py-1.5 text-sm">
+          <option value="string">string</option>
+          <option value="select">select</option>
+          <option value="array">array</option>
+          <option value="number">number</option>
+          <option value="integer">integer</option>
+          <option value="float">float</option>
+          <option value="decimal">decimal</option>
+        </select>
+
+        <select x-model="c.op" @change="onOperatorChange(i)"
+                x-effect="$nextTick(() => { if ($el.value !== c.op) $el.value = c.op; })"
+                class="border border-slate-300 rounded px-2 py-1.5 text-sm">
+          <template x-for="op in operatorsFor(c.datatype)" :key="op">
+            <option :value="op" x-text="op"></option>
+          </template>
+        </select>
+
+        <template x-if="!isArrayValue(c)">
+          <input type="text" :value="valueText(i)" @input="setValue(i, $event.target.value)"
+                 placeholder="value"
+                 class="flex-[2] min-w-[160px] border border-slate-300 rounded px-2 py-1.5 text-sm font-mono">
+        </template>
+
+        <template x-if="isArrayValue(c)">
+          <div class="flex-[2] min-w-[160px] space-y-1.5 border-l-2 border-slate-200 pl-3">
+            <template x-for="(item, j) in c.value" :key="j">
+              <div class="flex gap-2 items-start">
+                <span class="text-xs text-slate-400 font-mono mt-2 select-none w-6 text-right" x-text="'[' + j + ']'"></span>
+                <input type="text" :value="valueItemText(i, j)" @input="setValueItem(i, j, $event.target.value)"
+                       placeholder="value"
+                       class="flex-1 border border-slate-300 rounded px-2 py-1.5 text-sm font-mono">
+                <button type="button" @click="removeValueItem(i, j)"
+                        class="px-2 py-1.5 text-rose-600 hover:bg-rose-50 rounded">&times;</button>
+              </div>
+            </template>
+            <button type="button" @click="addValueItem(i)"
+                    class="text-xs px-2 py-1 rounded border border-dashed border-slate-300 hover:border-slate-400 hover:bg-slate-50 text-slate-600">
+              + Item
+            </button>
+          </div>
+        </template>
+
+        <button type="button" @click="removeCondition(i)"
+                class="px-2 py-1.5 text-rose-600 hover:bg-rose-50 rounded">&times;</button>
+      </div>
+    </template>
+
+    <% if depth < max_depth %>
+      <template x-for="(child, i) in node.set" :key="i">
+        <div class="bg-white border border-slate-200 rounded p-2" x-data="ruleGroup(child)">
+          <div class="flex items-center justify-between mb-2">
+            <span class="text-xs text-slate-500">Nested group</span>
+            <button type="button" @click="$parent.removeGroup(i)"
+                    class="px-2 py-1 text-rose-600 text-xs hover:bg-rose-50 rounded">Remove group</button>
+          </div>
+          <%= render "group", depth: depth + 1, max_depth: max_depth %>
+        </div>
+      </template>
+    <% else %>
+      <template x-if="node.set.length > 0">
+        <div class="bg-amber-50 border border-amber-200 text-amber-900 text-xs rounded p-2">
+          Nesting depth limit reached (<%= max_depth %>). Save and reload to edit deeper levels.
+        </div>
+      </template>
+    <% end %>
+  </div>
+
+  <div class="flex gap-2 mt-3">
+    <button type="button" @click="addCondition"
+            class="text-sm px-3 py-1.5 rounded border border-slate-300 hover:bg-slate-100">
+      + Condition
+    </button>
+    <% if depth < max_depth %>
+      <button type="button" @click="addGroup"
+              class="text-sm px-3 py-1.5 rounded border border-slate-300 hover:bg-slate-100">
+        + Nested group
+      </button>
+    <% end %>
+  </div>
+</div>

data/app/views/overule/rules/_static_node.html.erb

@@ -0,0 +1,79 @@
+<%# Recursive typed-value editor. Expects enclosing element with x-data="staticNode(node)". %>
+<%# Single recursive render site so server-side renders grow linearly with max_depth. %>
+<% depth     = local_assigns.fetch(:depth, 0) %>
+<% max_depth = local_assigns.fetch(:max_depth, 5) %>
+
+<template x-if="node.kind === 'string'">
+  <input type="text" x-model="node.value"
+         class="w-full border border-slate-300 rounded px-3 py-1.5 text-sm font-mono focus:outline-none focus:ring-2 focus:ring-slate-900/15">
+</template>
+
+<template x-if="node.kind === 'number'">
+  <input type="number" step="any" :value="node.value"
+         @input="node.value = $event.target.value === '' ? 0 : Number($event.target.value)"
+         class="w-full border border-slate-300 rounded px-3 py-1.5 text-sm font-mono focus:outline-none focus:ring-2 focus:ring-slate-900/15">
+</template>
+
+<template x-if="node.kind === 'boolean'">
+  <select :value="String(node.value)"
+          @change="node.value = $event.target.value === 'true'"
+          class="border border-slate-300 rounded px-3 py-1.5 text-sm font-mono bg-white">
+    <option value="true">true</option>
+    <option value="false">false</option>
+  </select>
+</template>
+
+<template x-if="node.kind === 'null'">
+  <span class="inline-block text-slate-400 text-sm italic font-mono px-2 py-1.5">null</span>
+</template>
+
+<%# Array and object share one recursive branch — only the child accessor and labels differ. %>
+<template x-if="node.kind === 'array' || node.kind === 'object'">
+  <div class="space-y-1.5 border-l-2 border-slate-200 pl-3 w-full">
+    <template x-for="(entry, idx) in node.value" :key="idx">
+      <div class="flex gap-2 items-start flex-wrap"
+           x-data="staticNode($parent.node.kind === 'array' ? entry : entry.node)">
+
+        <template x-if="$parent.node.kind === 'array'">
+          <span class="text-xs text-slate-400 font-mono mt-2 select-none w-6 text-right" x-text="'[' + idx + ']'"></span>
+        </template>
+        <template x-if="$parent.node.kind === 'object'">
+          <input type="text" x-model="$parent.node.value[idx].k" placeholder="key"
+                 class="w-32 border border-slate-300 rounded px-2 py-1.5 text-sm font-mono">
+        </template>
+
+        <select x-model="node.kind" @change="onKindChange()"
+                class="border border-slate-300 rounded px-2 py-1.5 text-xs font-mono bg-white">
+          <option value="string">string</option>
+          <option value="number">number</option>
+          <option value="boolean">boolean</option>
+          <option value="null">null</option>
+          <option value="array">array</option>
+          <option value="object">object</option>
+        </select>
+
+        <div class="flex-1 min-w-[160px]">
+          <% if depth < max_depth %>
+            <%= render "static_node", depth: depth + 1, max_depth: max_depth %>
+          <% else %>
+            <div class="text-xs text-amber-700 bg-amber-50 border border-amber-200 rounded px-2 py-1">
+              Max nesting depth (<%= max_depth %>) reached. Save and reload to edit deeper levels.
+            </div>
+          <% end %>
+        </div>
+
+        <button type="button"
+                @click="$parent.node.kind === 'array' ? $parent.removeArrayItem(idx) : $parent.removeObjectEntry(idx)"
+                class="px-2 py-1.5 text-rose-600 hover:bg-rose-50 rounded">&times;</button>
+      </div>
+    </template>
+
+    <% if depth < max_depth %>
+      <button type="button"
+              @click="node.kind === 'array' ? addArrayItem() : addObjectEntry()"
+              class="text-xs px-2 py-1 rounded border border-dashed border-slate-300 hover:border-slate-400 hover:bg-slate-50 text-slate-600">
+        <span x-text="node.kind === 'array' ? '+ Item' : '+ Field'"></span>
+      </button>
+    <% end %>
+  </div>
+</template>

data/app/views/overule/rules/edit.html.erb

@@ -0,0 +1,2 @@
+<h1 class="text-2xl font-semibold mb-6">Edit <%= @rule.name %></h1>
+<%= render "form", rule: @rule %>

data/app/views/overule/rules/index.html.erb

@@ -0,0 +1,45 @@
+<div class="flex items-center justify-between mb-6">
+  <h1 class="text-2xl font-semibold">Rules</h1>
+  <%= link_to "New rule", new_rule_path, class: "px-4 py-2 rounded bg-slate-900 text-white text-sm hover:bg-slate-700" %>
+</div>
+
+<% if @rules.empty? %>
+  <div class="bg-white border border-dashed border-slate-300 rounded-lg p-12 text-center text-slate-500">
+    No rules yet. <%= link_to "Create the first one", new_rule_path, class: "text-slate-900 underline" %>.
+  </div>
+<% else %>
+  <div class="bg-white border border-slate-200 rounded-lg overflow-hidden">
+    <table class="min-w-full text-sm">
+      <thead class="bg-slate-50 text-slate-600 text-left">
+        <tr>
+          <th class="px-4 py-2 font-medium">Name</th>
+          <th class="px-4 py-2 font-medium">Description</th>
+          <th class="px-4 py-2 font-medium">Enabled</th>
+          <th class="px-4 py-2 font-medium">Updated</th>
+          <th class="px-4 py-2"></th>
+        </tr>
+      </thead>
+      <tbody class="divide-y divide-slate-200">
+        <% @rules.each do |rule| %>
+          <tr>
+            <td class="px-4 py-3 font-medium"><%= link_to rule.name, rule, class: "hover:underline" %></td>
+            <td class="px-4 py-3 text-slate-500"><%= truncate(rule.description.to_s, length: 60) %></td>
+            <td class="px-4 py-3">
+              <span class="<%= rule.enabled? ? "text-emerald-700" : "text-slate-400" %>">
+                <%= rule.enabled? ? "yes" : "no" %>
+              </span>
+            </td>
+            <td class="px-4 py-3 text-slate-500"><%= rule.updated_at.strftime("%Y-%m-%d %H:%M") %></td>
+            <td class="px-4 py-3 text-right space-x-2">
+              <%= link_to "Edit", edit_rule_path(rule), class: "text-slate-700 hover:underline" %>
+              <%= button_to "Delete", rule, method: :delete,
+                    data: { turbo_confirm: "Delete #{rule.name}?" },
+                    form: { class: "inline" },
+                    class: "text-rose-600 hover:underline bg-transparent border-0 p-0 cursor-pointer" %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+<% end %>

data/app/views/overule/rules/new.html.erb

@@ -0,0 +1,2 @@
+<h1 class="text-2xl font-semibold mb-6">New rule</h1>
+<%= render "form", rule: @rule %>

data/app/views/overule/rules/show.html.erb

@@ -0,0 +1,54 @@
+<div class="flex items-start justify-between mb-6 gap-4">
+  <div class="min-w-0">
+    <div class="flex items-center gap-2 mb-1">
+      <h1 class="text-2xl font-semibold truncate"><%= @rule.name %></h1>
+      <span class="<%= @rule.enabled? ? "bg-emerald-100 text-emerald-800 border-emerald-200" : "bg-slate-100 text-slate-600 border-slate-200" %> text-xs font-medium uppercase tracking-wide border rounded px-2 py-0.5">
+        <%= @rule.enabled? ? "enabled" : "disabled" %>
+      </span>
+    </div>
+    <p class="text-slate-500 text-sm"><%= @rule.description.presence || "No description." %></p>
+    <p class="text-xs text-slate-400 mt-1 font-mono">
+      created <%= @rule.created_at.strftime("%Y-%m-%d %H:%M") %>
+      · updated <%= @rule.updated_at.strftime("%Y-%m-%d %H:%M") %>
+      · <%= pluralize(@rule.activities.count, "activity entry") %>
+      · <%= link_to pluralize(@rule.versions.count, "version"), rule_versions_path(@rule), class: "hover:underline" %>
+    </p>
+  </div>
+  <div class="flex gap-2 shrink-0">
+    <%= link_to "Edit", edit_rule_path(@rule), class: "px-3 py-1.5 text-sm rounded border border-slate-300 hover:bg-slate-100" %>
+    <%= button_to "Delete", @rule, method: :delete,
+          data: { turbo_confirm: "Delete #{@rule.name}?" },
+          class: "px-3 py-1.5 text-sm rounded bg-rose-600 text-white hover:bg-rose-700 cursor-pointer" %>
+  </div>
+</div>
+
+<div class="grid grid-cols-1 lg:grid-cols-5 gap-4">
+  <section class="bg-white border border-slate-200 rounded-lg p-4 lg:col-span-3" x-data="{ copied: false }">
+    <div class="flex items-center justify-between mb-2">
+      <h2 class="text-sm font-medium text-slate-600">Definition</h2>
+      <button type="button"
+              @click="navigator.clipboard.writeText($refs.def.textContent).then(() => { copied = true; setTimeout(() => copied = false, 1500) })"
+              class="text-xs px-2 py-1 rounded bg-slate-700 hover:bg-slate-600 text-slate-100">
+        <span x-text="copied ? 'Copied!' : 'Copy'"></span>
+      </button>
+    </div>
+    <pre class="text-xs bg-slate-50 border border-slate-200 rounded p-3 overflow-x-auto"><code x-ref="def"><%= JSON.pretty_generate(@rule.definition) %></code></pre>
+  </section>
+
+  <section class="bg-white border border-slate-200 rounded-lg p-4 lg:col-span-2">
+    <div class="flex items-center justify-between mb-3">
+      <h2 class="text-sm font-medium text-slate-600">Activities</h2>
+      <span class="text-xs text-slate-400"><%= @rule.activities.count %> total</span>
+    </div>
+    <% activities = @rule.activities.recent.limit(100) %>
+    <% if activities.empty? %>
+      <p class="text-sm text-slate-400 italic">No activity recorded.</p>
+    <% else %>
+      <div class="space-y-2 max-h-[640px] overflow-y-auto pr-1">
+        <% activities.each do |activity| %>
+          <%= render "overule/activities/activity", activity: activity %>
+        <% end %>
+      </div>
+    <% end %>
+  </section>
+</div>

data/config/routes.rb

@@ -0,0 +1,8 @@
+Overule::Engine.routes.draw do
+  resources :rules do
+    resources :activities, only: [:index], controller: "activities"
+    resources :versions,   only: [:index, :show], controller: "rule_versions"
+  end
+  resources :activities, only: [:index]
+  root to: "rules#index"
+end

data/lib/generators/overule/install/USAGE

@@ -0,0 +1,25 @@
+Description:
+    Copies the Overule configuration initializer (and ActiveRecord migrations,
+    when applicable) into your host Rails application.
+
+Examples:
+    bin/rails generate overule:install
+
+    Creates:
+        config/initializers/overule.rb
+        db/migrate/<timestamp>_create_overule_rules.rb
+        db/migrate/<timestamp>_create_overule_rule_activities.rb
+        db/migrate/<timestamp>_create_overule_rule_versions.rb
+        db/migrate/<timestamp>_add_rule_version_to_overule_rule_activities.rb
+
+    Run `bin/rails db:migrate` afterward.
+
+    bin/rails generate overule:install --orm=mongoid
+
+    Creates:
+        config/initializers/overule.rb     (with config.orm = :mongoid set)
+
+    No migrations are emitted — Mongoid uses model-declared indexes. After
+    install, run `bin/rails db:mongoid:create_indexes`.
+
+    Safe to re-run after upgrading the gem: existing files are detected and skipped.

data/lib/generators/overule/install/install_generator.rb

@@ -0,0 +1,64 @@
+require "rails/generators"
+require "rails/generators/active_record"
+
+module Overule
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      include ::Rails::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :orm, type: :string, default: "active_record",
+                         desc: "ORM to back Overule (active_record or mongoid)"
+
+      desc "Copies the Overule configuration initializer (and migrations for ActiveRecord) into the host application"
+
+      def self.next_migration_number(dirname)
+        ActiveRecord::Generators::Base.next_migration_number(dirname)
+      end
+
+      def validate_orm
+        return if %w[active_record mongoid].include?(selected_orm)
+
+        raise ::Thor::Error, "Unsupported --orm=#{options[:orm]}. Use 'active_record' or 'mongoid'."
+      end
+
+      def copy_initializer
+        template "overule.rb.tt", "config/initializers/overule.rb"
+      end
+
+      def copy_migrations
+        if selected_orm == "mongoid"
+          return say_status(:skip,
+                            "migrations (mongoid uses model-declared indexes; run `rails db:mongoid:create_indexes` after install)",
+                            :yellow)
+        end
+
+        migration_template "create_overule_rules.rb.tt",
+                           "db/migrate/create_overule_rules.rb"
+        migration_template "create_overule_rule_activities.rb.tt",
+                           "db/migrate/create_overule_rule_activities.rb"
+        migration_template "create_overule_rule_versions.rb.tt",
+                           "db/migrate/create_overule_rule_versions.rb"
+        migration_template "add_rule_version_to_overule_rule_activities.rb.tt",
+                           "db/migrate/add_rule_version_to_overule_rule_activities.rb"
+      end
+
+      no_tasks do
+        # Used by the migration .tt templates to declare `class … < ActiveRecord::Migration[X.Y]`
+        # against whatever AR is loaded in the host app.
+        def migration_version
+          "ActiveRecord::Migration[#{::Rails::VERSION::MAJOR}.#{::Rails::VERSION::MINOR}]"
+        end
+      end
+
+      private
+
+      # Host apps configure `config.generators.orm :active_record` which makes
+      # Rails pass the value as a Symbol; CLI users pass it as a String. Normalize.
+      def selected_orm
+        options[:orm].to_s
+      end
+    end
+  end
+end

data/lib/generators/overule/install/templates/add_rule_version_to_overule_rule_activities.rb.tt

@@ -0,0 +1,21 @@
+class AddRuleVersionToOveruleRuleActivities < <%= migration_version %>
+  def up
+    add_reference :overule_rule_activities, :rule_version, foreign_key: false, index: true
+
+    # Backfill: link any pre-existing activities to their rule's v1 snapshot
+    # (the row created by CreateOveruleRuleVersions).
+    execute(<<~SQL.squish)
+      UPDATE overule_rule_activities
+      SET rule_version_id = (
+        SELECT id FROM overule_rule_versions
+        WHERE overule_rule_versions.rule_id = overule_rule_activities.rule_id
+          AND overule_rule_versions.version = 1
+      )
+      WHERE rule_id IS NOT NULL AND rule_version_id IS NULL
+    SQL
+  end
+
+  def down
+    remove_reference :overule_rule_activities, :rule_version
+  end
+end

data/lib/generators/overule/install/templates/create_overule_rule_activities.rb.tt

@@ -0,0 +1,15 @@
+class CreateOveruleRuleActivities < <%= migration_version %>
+  def change
+    create_table :overule_rule_activities do |t|
+      t.references :rule, foreign_key: false, index: true
+      t.string   :rule_name, null: false
+      t.string   :action,    null: false
+      t.string   :actor
+      t.json     :diff,      null: false, default: {}
+      t.datetime :created_at, null: false, precision: 6
+    end
+
+    add_index :overule_rule_activities, :created_at
+    add_index :overule_rule_activities, :action
+  end
+end

data/lib/generators/overule/install/templates/create_overule_rule_versions.rb.tt

@@ -0,0 +1,28 @@
+class CreateOveruleRuleVersions < <%= migration_version %>
+  def up
+    create_table :overule_rule_versions do |t|
+      t.references :rule, foreign_key: false, index: true
+      t.string   :rule_name,   null: false
+      t.integer  :version,     null: false
+      t.string   :name,        null: false
+      t.text     :description
+      t.boolean  :enabled,     null: false, default: true
+      t.json     :definition,  null: false, default: {}
+      t.datetime :created_at,  null: false, precision: 6
+    end
+    add_index :overule_rule_versions, [:rule_id, :version], unique: true
+
+    # Backfill: capture each existing rule's current state as version 1 so
+    # version history is contiguous going forward.
+    execute(<<~SQL.squish)
+      INSERT INTO overule_rule_versions
+        (rule_id, rule_name, version, name, description, enabled, definition, created_at)
+      SELECT id, name, 1, name, description, enabled, definition, created_at
+      FROM overule_rules
+    SQL
+  end
+
+  def down
+    drop_table :overule_rule_versions
+  end
+end

data/lib/generators/overule/install/templates/create_overule_rules.rb.tt

@@ -0,0 +1,13 @@
+class CreateOveruleRules < <%= migration_version %>
+  def change
+    create_table :overule_rules do |t|
+      t.string  :name,        null: false
+      t.text    :description
+      t.json    :definition,  null: false, default: {}
+      t.boolean :enabled,     null: false, default: true
+      t.timestamps
+    end
+
+    add_index :overule_rules, :name, unique: true
+  end
+end

data/lib/generators/overule/install/templates/overule.rb.tt

@@ -0,0 +1,35 @@
+# Overule configuration
+#
+# Customize how Overule behaves in this host application. Every block below is
+# optional — uncomment what you need.
+
+Overule.configure do |config|
+  # ORM that backs Overule::Rule, Overule::RuleActivity, Overule::RuleVersion.
+  #
+  # Supported values:
+  #   :active_record — uses ActiveRecord and the bundled migrations.
+  #   :mongoid       — uses Mongoid; no SQL migrations needed. After install,
+  #                    run `bin/rails db:mongoid:create_indexes` so the unique
+  #                    indexes declared on the models are created.
+<% if options[:orm].to_s == "mongoid" -%>
+  config.orm = :mongoid
+<% else -%>
+  # config.orm = :active_record
+<% end -%>
+
+  # Attribute every rule change (create / update / destroy) to a user in the
+  # activity log. The proc receives the current Overule::ApplicationController
+  # and should return a string identifier — typically an email, username, or
+  # external user id. When unset, activities are stored with `actor: nil` and
+  # rendered as "anonymous" in the UI.
+  #
+  # config.actor_proc = ->(controller) { controller.current_user&.email }
+
+  # Gate the Overule UI behind HTTP Basic auth. Defaults to false (no gate;
+  # the engine relies on whatever auth the host app already provides). When
+  # enabled, both username and password are constant-time compared.
+  #
+  # config.http_basic_auth          = true
+  # config.http_basic_auth_username = ENV.fetch("OVERULE_HTTP_BASIC_USERNAME")
+  # config.http_basic_auth_password = ENV.fetch("OVERULE_HTTP_BASIC_PASSWORD")
+end

data/lib/overule/action.rb

@@ -0,0 +1,22 @@
+module Overule
+  # Handles the execution of actions defined in rules
+  # Actions can be static assignments or dynamic operations to be performed
+  # when conditions are met
+  class Action
+    attr_reader :config, :ctx
+
+    def initialize(config, ctx)
+      @config = config
+      @ctx    = ctx
+    end
+
+    def fire
+      # Only static for now
+      config["$static"]
+    end
+
+    def fire!
+      # Implement
+    end
+  end
+end