alembic 0.1.0

data/app/models/alembic/summary/run.rb

@@ -0,0 +1,13 @@
+module Alembic
+  module Summary
+    Run = Data.define(:state, :steps) do
+      def initialize(state:, steps: {})
+        super
+      end
+
+      def step(id)
+        steps[id.to_s].to_h
+      end
+    end
+  end
+end

data/app/models/alembic/summary.rb

@@ -0,0 +1,15 @@
+module Alembic
+  module Summary
+    class UnknownOutputType < KeyError; end
+
+    class << self
+      def output(id, &declaration)
+        registry.register(OutputType.define(id, &declaration))
+      end
+
+      def registry
+        @registry ||= Registry.new
+      end
+    end
+  end
+end

data/app/views/alembic/flow/steps/_choosing.html.erb

@@ -0,0 +1,9 @@
+<fieldset>
+  <legend class="mb-5 text-xl font-semibold leading-snug text-gray-900"><%= step.text %></legend>
+
+  <div class="space-y-3">
+    <% step.choices.each do |choice| %>
+      <%= ui_radio_card(name: "answers[#{step.id}]", value: choice.value, label: choice.label.presence || choice.value, hint: choice.hint) %>
+    <% end %>
+  </div>
+</fieldset>

data/app/views/alembic/flows/complete.html.erb

@@ -0,0 +1,34 @@
+<% content_for(:title, "Complete") %>
+
+<% starting_over = flow_start_path(@guide.slug) %>
+
+<%= ui_page(max_width: :md) do %>
+  <%= ui_page_header(title: "That's everything", subtitle: "Thanks — here's what you told us") do |header| %>
+    <% header.action do %>
+      <%= ui_button(label: "Start over", href: starting_over, variant: :secondary) %>
+    <% end %>
+  <% end %>
+
+  <% if @outputs.any? %>
+    <%= ui_section do %>
+      <%= ui_grid(cols: { default: 1, sm: 2 }, gap: :lg) do %>
+        <% @outputs.each do |output| %>
+          <div data-output="<%= output.id %>">
+            <%= ui_stat_card(label: output.label, value: alembic_output_lines(output.value).join(" · ")) %>
+          </div>
+        <% end %>
+      <% end %>
+    <% end %>
+  <% end %>
+
+  <%= ui_section(title: @outputs.any? ? "What you told us" : nil) do %>
+    <ul class="divide-y divide-gray-100 border-y border-gray-100">
+      <% @answered.each do |step, value| %>
+        <li data-answer="<%= step %>" class="flex items-baseline justify-between gap-6 py-3">
+          <span class="text-gray-600"><%= @guide.question_text(step) %></span>
+          <span class="shrink-0 font-medium text-gray-900"><%= @guide.choice_label(step, value) %></span>
+        </li>
+      <% end %>
+    </ul>
+  <% end %>
+<% end %>

data/app/views/alembic/flows/show.html.erb

@@ -0,0 +1,17 @@
+<% content_for(:title, @diagnostic.title.presence || @diagnostic.slug) %>
+
+<%= ui_page(max_width: :md) do %>
+  <%= ui_page_header(title: @diagnostic.title.presence || @diagnostic.slug, subtitle: @diagnostic.summary) %>
+
+  <%= ui_section do %>
+    <div class="flex flex-wrap items-center gap-3">
+      <% if @diagnostic.each_step? && @diagnostic.definition.present? && !previewing? %>
+        <%= ui_form(action: alembic.flow_runs_path(@diagnostic.slug), method: :post) do %>
+          <%= ui_button(label: @diagnostic.start_label.presence || "Start", type: :submit) %>
+        <% end %>
+      <% else %>
+        <%= ui_button(label: @diagnostic.start_label.presence || "Start", href: flow_step_path(@diagnostic.slug)) %>
+      <% end %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/alembic/flows/step.html.erb

@@ -0,0 +1,27 @@
+<% content_for(:title, @guide.headline) %>
+
+<%= ui_page(max_width: :md) do %>
+  <%= link_to "← Start over", flow_start_path(@guide.slug), class: "text-sm text-accent-600 hover:text-accent-700" %>
+
+  <div class="mt-6 mb-6">
+    <%= ui_progress(value: @answers.size, max: [ @guide.steps_on_path(@answers).size, 1 ].max, label: "Question #{@answers.size + 1}") %>
+  </div>
+
+  <%= form_with url: step_form[:url], method: step_form[:method], data: { turbo: false } do %>
+    <% if carries_answers? %>
+      <% @answers.each do |key, value| %>
+        <%= hidden_field_tag "answers[#{key}]", value %>
+      <% end %>
+    <% end %>
+
+    <%= render @drawing, step: @question %>
+
+    <div class="mt-8 flex items-center gap-4">
+      <%= ui_button(label: "Next", type: :submit) %>
+
+      <% if @answers.any? %>
+        <button type="submit" name="back" value="1" formnovalidate class="cursor-pointer text-sm text-gray-500 underline underline-offset-2 hover:text-gray-900">← Back</button>
+      <% end %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/alembic/manage/definitions/edit.html.erb

@@ -0,0 +1,13 @@
+<%= ui_page(max_width: :lg) do %>
+  <p class="mb-4">
+    <%= link_to "← Back to the flow", alembic.manage_flow_path(@diagnostic), class: "text-sm text-accent-600 hover:text-accent-700" %>
+  </p>
+
+  <%= ui_form_page(title: "Definition", back_url: alembic.manage_flow_path(@diagnostic), subtitle: @diagnostic.slug) %>
+
+  <%= ui_form(action: alembic.manage_flow_definition_path(@diagnostic), method: :patch) do %>
+    <%= ui_textarea(name: "definition", value: JSON.pretty_generate(@diagnostic.document), rows: 30) %>
+
+    <%= ui_button(label: "Save", type: :submit) %>
+  <% end %>
+<% end %>

data/app/views/alembic/manage/flows/edit.html.erb

@@ -0,0 +1,29 @@
+<%= ui_page(max_width: :lg) do %>
+  <p class="mb-4">
+    <%= link_to "← Back to the flow", alembic.manage_flow_path(@diagnostic), class: "text-sm text-accent-600 hover:text-accent-700" %>
+  </p>
+
+  <%= ui_form_page(title: "Edit details", back_url: alembic.manage_flow_path(@diagnostic)) %>
+
+  <%= ui_form(action: alembic.manage_flow_path(@diagnostic), method: :patch) do %>
+    <%= ui_section(title: "How this is introduced") do %>
+      <label class="block text-sm font-medium mb-1">Title</label>
+      <%= ui_input(name: "flow[title]", value: @diagnostic.title) %>
+
+      <label class="block text-sm font-medium mb-1 mt-4">Summary</label>
+      <%= ui_textarea(name: "flow[summary]", value: @diagnostic.summary, rows: 4) %>
+
+      <label class="block text-sm font-medium mb-1 mt-4">Start label</label>
+      <%= ui_input(name: "flow[start_label]", value: @diagnostic.start_label) %>
+    <% end %>
+
+    <%= ui_section(title: "What this keeps of a run") do %>
+      <%= ui_select(name: "flow[persists]", selected: @diagnostic.persists,
+            options: [ [ "Nothing", "unsaved" ],
+                       [ "Every answer as it is given", "each_step" ],
+                       [ "The whole run once it finishes", "on_finish" ] ]) %>
+    <% end %>
+
+    <%= ui_button(label: "Save", type: :submit) %>
+  <% end %>
+<% end %>

data/app/views/alembic/manage/flows/index.html.erb

@@ -0,0 +1,32 @@
+<%= ui_page(max_width: :xl) do %>
+  <%= ui_page_header(title: "Flows", subtitle: "Build and edit your flows") %>
+
+  <%= ui_data_table(
+    items: @diagnostics,
+    columns: [ { title: "Title" }, { slug: "Slug" }, { kind: "Kind" }, { status: "Status" } ],
+    empty_message: "No diagnostics yet."
+  ) do |table| %>
+    <% table.link(:title) { |diagnostic| alembic.manage_flow_path(diagnostic) } %>
+    <% table.actions do |diagnostic| %>
+      <%= ui_form(action: alembic.manage_flow_path(diagnostic), method: :delete) do %>
+        <%= ui_button(label: "Remove", type: :submit, variant: :secondary) %>
+      <% end %>
+    <% end %>
+  <% end %>
+
+  <%= ui_section(title: "Create a diagnostic") do %>
+    <% if @diagnostic&.errors&.any? %>
+      <%= ui_alert(message: @diagnostic.errors.full_messages.to_sentence, type: :error) %>
+    <% end %>
+
+    <%= ui_form(action: alembic.manage_flows_path, method: :post) do %>
+      <label class="block text-sm font-medium mb-1">Slug</label>
+      <%= ui_input(name: "flow[slug]", placeholder: "e.g. business-scorecard") %>
+
+      <label class="block text-sm font-medium mb-1 mt-4">Kind</label>
+      <%= ui_select(name: "flow[kind]", options: [ [ "Scored", "scored" ], [ "Guide", "guide" ] ]) %>
+
+      <%= ui_button(label: "Create", type: :submit, variant: :secondary) %>
+    <% end %>
+  <% end %>
+<% end %>

data/app/views/alembic/manage/flows/show.html.erb

@@ -0,0 +1,26 @@
+<% content_for :head do %>
+  <%= javascript_include_tag "keystone_ui/react", defer: true %>
+  <%= javascript_include_tag "alembic/canvas", defer: true %>
+<% end %>
+
+<div class="flex h-screen flex-col overflow-hidden">
+  <header class="flex shrink-0 items-center justify-between gap-4 border-b border-gray-200 px-6 py-3">
+    <div>
+      <h1 class="text-lg font-semibold text-gray-900" data-flow-heading><%= @diagnostic.title.presence || @diagnostic.slug %></h1>
+      <p class="text-sm text-gray-500"><%= @diagnostic.slug %></p>
+    </div>
+    <div class="flex items-center gap-2">
+      <button type="button" data-open-panel
+              onclick="document.dispatchEvent(new CustomEvent('alembic:open-flow'))"
+              class="inline-flex items-center justify-center font-semibold rounded-lg border-0 cursor-pointer bg-accent-600 text-white hover:bg-accent-700 text-base px-4 py-2">This flow</button>
+
+      <%= ui_button(label: "Try it", href: alembic.manage_flow_preview_path(@diagnostic), variant: :secondary) %>
+
+      <%= ui_button(label: "All diagnostics", href: alembic.manage_flows_path, variant: :secondary) %>
+    </div>
+  </header>
+
+  <%= react_ui("alembic/flow-editor", { base: alembic.manage_flow_canvas_path(@diagnostic), token: form_authenticity_token, initial: @canvas },
+               class: "min-h-0 flex-1",
+               data: { flow_canvas: true }) %>
+</div>

data/app/views/alembic/manage/pages/_block_content.html.erb

@@ -0,0 +1 @@
+<%= KsBlocks.registry.block_types(kind: :pages).find { |type| type.key.to_s == block["type"] }&.name %>

data/app/views/alembic/manage/pages/index.html.erb

@@ -0,0 +1,20 @@
+<%= ui_page(max_width: :xl) do %>
+  <%= ui_page_header(title: "Pages", subtitle: "Build and edit your pages") %>
+
+  <%= ui_data_table(
+    items: @pages,
+    columns: [ { name: "Name" } ],
+    empty_message: "No pages yet."
+  ) do |table| %>
+    <% table.link(:name) { |page| alembic.manage_page_path(page) } %>
+  <% end %>
+
+  <%= ui_section(title: "Create a page") do %>
+    <%= ui_form(action: alembic.manage_pages_path, method: :post) do %>
+      <label class="block text-sm font-medium mb-1">Name</label>
+      <%= ui_input(name: "page[name]", placeholder: "e.g. Welcome") %>
+
+      <%= ui_button(label: "Create", type: :submit, variant: :secondary) %>
+    <% end %>
+  <% end %>
+<% end %>

data/app/views/alembic/manage/pages/show.html.erb

@@ -0,0 +1,11 @@
+<% content_for :head do %>
+  <%= stylesheet_link_tag "alembic/page_builder" %>
+  <%= javascript_include_tag "keystone_ui/react", defer: true %>
+  <%= javascript_include_tag "alembic/page_builder", defer: true %>
+<% end %>
+
+<%= react_ui("alembic/page-builder", @payload.merge(token: form_authenticity_token)) %>
+
+<%= block_contents(@page.blocks) do |block| %>
+  <%= render "alembic/manage/pages/block_content", block: block %>
+<% end %>

data/app/views/alembic/manage/versions/index.html.erb

@@ -0,0 +1,41 @@
+<%= ui_page(max_width: :lg) do %>
+  <p class="mb-4">
+    <%= link_to "← Back to the flow", alembic.manage_flow_path(@diagnostic), class: "text-sm text-accent-600 hover:text-accent-700" %>
+  </p>
+
+  <%= ui_page_header(title: "History", subtitle: @diagnostic.title.presence || @diagnostic.slug) %>
+
+  <%= ui_section do %>
+    <ul class="divide-y divide-gray-100 border-y border-gray-100">
+      <% @versions.each do |version| %>
+        <li data-version="<%= version.number %>" class="py-4">
+          <div class="flex items-baseline justify-between gap-4">
+            <span class="font-medium text-gray-900">Version <%= version.number %></span>
+            <span class="text-sm text-gray-500"><%= version.created_at.to_fs(:long) %></span>
+          </div>
+
+          <% if version == @diagnostic.live_version %>
+            <p data-live class="mt-1 text-sm font-medium text-green-700">Visitors run this version</p>
+          <% end %>
+
+          <% if version.changes.any? %>
+            <ul class="mt-2 space-y-0.5">
+              <% version.changes.each do |change| %>
+                <li data-captured class="text-sm text-gray-600"><%= Alembic::Flow::Change.phrase(change) %></li>
+              <% end %>
+            </ul>
+          <% else %>
+            <p class="mt-2 text-sm text-gray-500">Nothing was recorded against this version.</p>
+          <% end %>
+
+          <% unless version == @versions.first %>
+            <%= button_to "Return the flow to this version",
+                  alembic.return_manage_flow_version_path(@diagnostic, version),
+                  form: { data: { turbo: false } }, data: { return: true },
+                  class: "mt-3 inline-flex items-center rounded-lg border border-gray-300 bg-white px-3 py-1.5 text-sm text-gray-900 hover:bg-gray-50 cursor-pointer" %>
+          <% end %>
+        </li>
+      <% end %>
+    </ul>
+  <% end %>
+<% end %>

data/app/views/layouts/alembic/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Alembic</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "alembic/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,42 @@
+Alembic::Engine.routes.draw do
+  namespace :manage do
+    resources :pages, only: [ :index, :create, :show ] do
+      get "layout", to: "page_blocks#layout", as: :layout
+      post "blocks", to: "page_blocks#add_block", as: :blocks
+      patch "blocks", to: "page_blocks#place_blocks"
+      patch "blocks/:block_id", to: "page_blocks#fill_block"
+      delete "blocks/:block_id", to: "page_blocks#remove_block", as: :block
+    end
+
+    resources :flows, only: [ :index, :create, :show, :edit, :update, :destroy ] do
+      resource :definition, only: [ :edit, :update ]
+      resource :preview, only: :show, controller: "previews" do
+        get :step
+      end
+      resources :versions, only: :index do
+        post :return, on: :member
+      end
+
+      resource :canvas, only: :show, controller: "canvas" do
+        post   "steps",       action: :add_step
+        patch  "steps/:step", action: :configure_step
+        delete "steps/:step",      action: :remove_step
+        patch  "steps/:step/move", action: :move_step
+        post   "versions",    action: :create
+        post   "publish",     action: :publish
+        patch  "details",     action: :details
+        post   "undo",        action: :undo
+        post   "redo",        action: :redo
+        post   "edges",       action: :connect
+        delete "edges",       action: :disconnect
+      end
+    end
+  end
+
+  post ":slug/runs", to: "flows#start", as: :flow_runs
+  get "runs/:id", to: "flows#step", as: :run
+  patch "runs/:id", to: "flows#update"
+
+  get ":slug", to: "flows#show", as: :flow
+  get ":slug/step", to: "flows#step", as: :flow_step
+end

data/db/migrate/20260604215031_create_alembic_diagnostics.rb

@@ -0,0 +1,14 @@
+class CreateAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_diagnostics do |t|
+      t.string :slug
+      t.string :title
+      t.text :summary
+      t.string :kind
+      t.string :status
+
+      t.timestamps
+    end
+    add_index :alembic_diagnostics, :slug, unique: true
+  end
+end

data/db/migrate/20260605015051_create_alembic_questions.rb

@@ -0,0 +1,12 @@
+class CreateAlembicQuestions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_questions do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.integer :position
+      t.string :key
+      t.text :text
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605021526_create_alembic_options.rb

@@ -0,0 +1,14 @@
+class CreateAlembicOptions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_options do |t|
+      t.references :question, null: false, foreign_key: { to_table: :alembic_questions }
+      t.integer :position
+      t.string :value
+      t.string :label
+      t.text :hint
+      t.integer :weight
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605023308_create_alembic_conditions.rb

@@ -0,0 +1,11 @@
+class CreateAlembicConditions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_conditions do |t|
+      t.references :question, null: false, foreign_key: { to_table: :alembic_questions }
+      t.string :depends_on
+      t.json :values
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605025623_create_alembic_bands.rb

@@ -0,0 +1,12 @@
+class CreateAlembicBands < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_bands do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.integer :ceiling
+      t.string :name
+      t.text :description
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605032859_create_alembic_condition_options.rb

@@ -0,0 +1,10 @@
+class CreateAlembicConditionOptions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_condition_options do |t|
+      t.references :condition, null: false, foreign_key: { to_table: :alembic_conditions }
+      t.references :option, null: false, foreign_key: { to_table: :alembic_options }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605032900_reshape_conditions_for_placement.rb

@@ -0,0 +1,11 @@
+class ReshapeConditionsForPlacement < ActiveRecord::Migration[8.1]
+  def change
+    add_reference :alembic_conditions, :subject, polymorphic: true, null: false
+    add_reference :alembic_conditions, :tested_question, null: false,
+      foreign_key: { to_table: :alembic_questions }
+
+    remove_reference :alembic_conditions, :question, foreign_key: { to_table: :alembic_questions }
+    remove_column :alembic_conditions, :depends_on, :string
+    remove_column :alembic_conditions, :values, :json
+  end
+end

data/db/migrate/20260605125119_create_alembic_results.rb

@@ -0,0 +1,14 @@
+class CreateAlembicResults < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_results do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.string :slot
+      t.string :key
+      t.string :title
+      t.text :body
+      t.integer :position
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605130338_create_alembic_rules.rb

@@ -0,0 +1,10 @@
+class CreateAlembicRules < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_rules do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.integer :position
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605130339_create_alembic_rule_results.rb

@@ -0,0 +1,10 @@
+class CreateAlembicRuleResults < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_rule_results do |t|
+      t.references :rule, null: false, foreign_key: { to_table: :alembic_rules }
+      t.references :result, null: false, foreign_key: { to_table: :alembic_results }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260605210714_add_definition_to_alembic_diagnostics.rb

@@ -0,0 +1,5 @@
+class AddDefinitionToAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_diagnostics, :definition, :json
+  end
+end

data/db/migrate/20260606000855_add_guide_copy_to_alembic_diagnostics.rb

@@ -0,0 +1,9 @@
+class AddGuideCopyToAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_diagnostics, :kicker, :string
+    add_column :alembic_diagnostics, :headline, :string
+    add_column :alembic_diagnostics, :blurb, :text
+    add_column :alembic_diagnostics, :start_label, :string
+    add_column :alembic_diagnostics, :resolver_key, :string
+  end
+end

data/db/migrate/20260606005430_create_alembic_nodes.rb

@@ -0,0 +1,22 @@
+class CreateAlembicNodes < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_nodes do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.string :kind
+      t.string :key
+      t.integer :position
+      t.string :name
+      t.text :tagline
+      t.text :complexity
+      t.text :setup
+      t.text :maintenance
+      t.text :captures
+      t.text :why
+      t.text :pains
+      t.text :avoid
+      t.text :avoid_pain
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260606010312_create_alembic_build_steps.rb

@@ -0,0 +1,12 @@
+class CreateAlembicBuildSteps < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_build_steps do |t|
+      t.references :node, null: false, foreign_key: { to_table: :alembic_nodes }
+      t.integer :position
+      t.string :title
+      t.text :code
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260606011110_create_alembic_warnings.rb

@@ -0,0 +1,11 @@
+class CreateAlembicWarnings < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_warnings do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.string :key
+      t.text :text
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260804180000_create_alembic_domains.rb

@@ -0,0 +1,14 @@
+class CreateAlembicDomains < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_domains do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.string :key
+      t.string :name
+      t.text :gap_meaning
+      t.text :gap_cost
+      t.integer :position
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260804180100_add_domain_to_alembic_questions.rb

@@ -0,0 +1,5 @@
+class AddDomainToAlembicQuestions < ActiveRecord::Migration[8.1]
+  def change
+    add_reference :alembic_questions, :domain, foreign_key: { to_table: :alembic_domains }
+  end
+end

data/db/migrate/20260822120000_create_alembic_definition_versions.rb

@@ -0,0 +1,14 @@
+class CreateAlembicDefinitionVersions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_definition_versions do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.integer :number, null: false
+      t.json :definition
+
+      t.datetime :created_at, null: false
+    end
+
+    add_index :alembic_definition_versions, [ :diagnostic_id, :number ], unique: true,
+      name: "index_alembic_definition_versions_on_diagnostic_and_number"
+  end
+end

data/db/migrate/20260822120100_backfill_alembic_definition_versions.rb

@@ -0,0 +1,17 @@
+class BackfillAlembicDefinitionVersions < ActiveRecord::Migration[8.1]
+  class Diagnostic < ActiveRecord::Base
+    self.table_name = "alembic_diagnostics"
+  end
+
+  class DefinitionVersion < ActiveRecord::Base
+    self.table_name = "alembic_definition_versions"
+  end
+
+  def up
+    Diagnostic.where.not(definition: nil).find_each do |diagnostic|
+      next if DefinitionVersion.exists?(diagnostic_id: diagnostic.id)
+
+      DefinitionVersion.create!(diagnostic_id: diagnostic.id, number: 1, definition: diagnostic.definition)
+    end
+  end
+end