alembic 0.1.0

data/db/migrate/20260822130000_remove_definition_from_alembic_diagnostics.rb

@@ -0,0 +1,28 @@
+class RemoveDefinitionFromAlembicDiagnostics < 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
+    record_definitions_held_only_by_the_column
+    remove_column :alembic_diagnostics, :definition
+  end
+
+  def down
+    add_column :alembic_diagnostics, :definition, :json
+  end
+
+  private
+
+  def record_definitions_held_only_by_the_column
+    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

data/db/migrate/20260822140000_create_alembic_responses.rb

@@ -0,0 +1,14 @@
+class CreateAlembicResponses < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_responses do |t|
+      t.references :diagnostic, null: false, foreign_key: { to_table: :alembic_diagnostics }
+      t.references :definition_version, null: false, foreign_key: { to_table: :alembic_definition_versions }
+      t.references :owner, polymorphic: true, null: true
+      t.json :answers
+      t.string :status
+      t.string :label
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260824120000_create_alembic_transitions.rb

@@ -0,0 +1,10 @@
+class CreateAlembicTransitions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_transitions do |t|
+      t.references :from_question, null: false, foreign_key: { to_table: :alembic_questions }
+      t.references :to_question, null: false, foreign_key: { to_table: :alembic_questions }
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260824130000_drop_alembic_builder_tables.rb

@@ -0,0 +1,17 @@
+class DropAlembicBuilderTables < ActiveRecord::Migration[8.1]
+  def up
+    drop_table :alembic_condition_options
+    drop_table :alembic_conditions
+    drop_table :alembic_transitions
+    drop_table :alembic_options
+    drop_table :alembic_build_steps
+    drop_table :alembic_rule_results
+    drop_table :alembic_rules
+    drop_table :alembic_results
+    drop_table :alembic_questions
+    drop_table :alembic_nodes
+    drop_table :alembic_warnings
+    drop_table :alembic_bands
+    drop_table :alembic_domains
+  end
+end

data/db/migrate/20260824140000_add_definition_cursor_to_alembic_diagnostics.rb

@@ -0,0 +1,5 @@
+class AddDefinitionCursorToAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_diagnostics, :definition_cursor, :integer
+  end
+end

data/db/migrate/20260824160000_add_summary_definition_to_alembic_diagnostics.rb

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

data/db/migrate/20260824170000_drop_alembic_guide_copy_columns.rb

@@ -0,0 +1,8 @@
+class DropAlembicGuideCopyColumns < ActiveRecord::Migration[8.1]
+  def up
+    remove_column :alembic_diagnostics, :kicker
+    remove_column :alembic_diagnostics, :headline
+    remove_column :alembic_diagnostics, :blurb
+    remove_column :alembic_diagnostics, :resolver_key
+  end
+end

data/db/migrate/20260825120000_create_alembic_summary_versions.rb

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

data/db/migrate/20260825130000_add_summary_cursor_to_alembic_diagnostics.rb

@@ -0,0 +1,5 @@
+class AddSummaryCursorToAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_diagnostics, :summary_cursor, :integer
+  end
+end

data/db/migrate/20260825140000_move_summary_definitions_into_versions.rb

@@ -0,0 +1,26 @@
+class MoveSummaryDefinitionsIntoVersions < ActiveRecord::Migration[8.1]
+  class Diagnostic < ActiveRecord::Base
+    self.table_name = "alembic_diagnostics"
+  end
+
+  class SummaryVersion < ActiveRecord::Base
+    self.table_name = "alembic_summary_versions"
+  end
+
+  def up
+    Diagnostic.where.not(summary_definition: nil).find_each do |diagnostic|
+      version = SummaryVersion.create!(diagnostic_id: diagnostic.id, number: 1,
+        summary: diagnostic.summary_definition, created_at: Time.current)
+
+      diagnostic.update_columns(summary_cursor: version.number)
+    end
+  end
+
+  def down
+    SummaryVersion.where(number: 1).find_each do |version|
+      Diagnostic.where(id: version.diagnostic_id)
+        .update_all(summary_definition: version.summary, summary_cursor: nil)
+      version.delete
+    end
+  end
+end

data/db/migrate/20260825150000_drop_summary_definition_from_alembic_diagnostics.rb

@@ -0,0 +1,5 @@
+class DropSummaryDefinitionFromAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    remove_column :alembic_diagnostics, :summary_definition, :json
+  end
+end

data/db/migrate/20260825160000_add_summary_version_to_alembic_responses.rb

@@ -0,0 +1,6 @@
+class AddSummaryVersionToAlembicResponses < ActiveRecord::Migration[8.1]
+  def change
+    add_reference :alembic_responses, :summary_version, null: true,
+      foreign_key: { to_table: :alembic_summary_versions }
+  end
+end

data/db/migrate/20260825170000_rename_question_settings_in_current_definitions.rb

@@ -0,0 +1,51 @@
+class RenameQuestionSettingsInCurrentDefinitions < ActiveRecord::Migration[8.1]
+  RENAMED = { "text" => "question", "options" => "answers", "tag" => "category" }.freeze
+
+  class Diagnostic < ActiveRecord::Base
+    self.table_name = "alembic_diagnostics"
+  end
+
+  class DefinitionVersion < ActiveRecord::Base
+    self.table_name = "alembic_definition_versions"
+  end
+
+  def up
+    Diagnostic.find_each do |diagnostic|
+      definition = current_definition(diagnostic)
+      renamed = rename(definition)
+      next if renamed.nil? || renamed == definition
+
+      record_definition(diagnostic, renamed)
+    end
+  end
+
+  def down
+    raise ActiveRecord::IrreversibleMigration,
+      "definition versions are append-only; step back the diagnostic's cursor to undo this"
+  end
+
+  private
+
+  def current_definition(diagnostic)
+    versions = DefinitionVersion.where(diagnostic_id: diagnostic.id)
+    versions.find_by(number: diagnostic.definition_cursor || versions.maximum(:number))&.definition
+  end
+
+  def record_definition(diagnostic, definition)
+    number = (DefinitionVersion.where(diagnostic_id: diagnostic.id).maximum(:number) || 0) + 1
+    DefinitionVersion.create!(diagnostic_id: diagnostic.id, number: number, definition: definition)
+    diagnostic.update!(definition_cursor: number)
+  end
+
+  def rename(definition)
+    return if definition.blank?
+
+    definition.merge("nodes" => Array(definition["nodes"]).map { |node| rename_node(node) })
+  end
+
+  def rename_node(node)
+    return node unless node["type"] == "question"
+
+    node.to_h { |key, value| [ RENAMED.fetch(key, key), value ] }
+  end
+end

data/db/migrate/20260825180000_add_document_to_alembic_diagnostics.rb

@@ -0,0 +1,6 @@
+class AddDocumentToAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_diagnostics, :document, :json
+    add_column :alembic_diagnostics, :changes_since_version, :json
+  end
+end

data/db/migrate/20260825190000_seed_documents_from_current_definitions.rb

@@ -0,0 +1,29 @@
+class SeedDocumentsFromCurrentDefinitions < 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.find_each do |diagnostic|
+      definition = current_definition(diagnostic)
+      next if definition.blank?
+
+      diagnostic.update_columns(document: definition)
+    end
+  end
+
+  def down
+    Diagnostic.update_all(document: nil)
+  end
+
+  private
+
+  def current_definition(diagnostic)
+    versions = DefinitionVersion.where(diagnostic_id: diagnostic.id)
+    versions.find_by(number: diagnostic.definition_cursor || versions.maximum(:number))&.definition
+  end
+end

data/db/migrate/20260825200000_add_published_version_to_alembic_diagnostics.rb

@@ -0,0 +1,6 @@
+class AddPublishedVersionToAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    add_reference :alembic_diagnostics, :published_version, null: true,
+      foreign_key: { to_table: :alembic_definition_versions }
+  end
+end

data/db/migrate/20260825210000_publish_current_definitions.rb

@@ -0,0 +1,29 @@
+class PublishCurrentDefinitions < 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.find_each do |diagnostic|
+      current = current_definition_version(diagnostic)
+      next if current.nil?
+
+      diagnostic.update_columns(published_version_id: current.id, status: "published")
+    end
+  end
+
+  def down
+    Diagnostic.update_all(published_version_id: nil)
+  end
+
+  private
+
+  def current_definition_version(diagnostic)
+    versions = DefinitionVersion.where(diagnostic_id: diagnostic.id)
+    versions.find_by(number: diagnostic.definition_cursor || versions.maximum(:number))
+  end
+end

data/db/migrate/20260825220000_add_undone_changes_to_alembic_diagnostics.rb

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

data/db/migrate/20260825223322_add_status_to_alembic_definition_versions.rb

@@ -0,0 +1,8 @@
+class AddStatusToAlembicDefinitionVersions < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_definition_versions, :status, :string, null: false, default: "draft"
+
+    add_index :alembic_definition_versions, :diagnostic_id, unique: true,
+      where: "status = 'live'", name: "index_alembic_definition_versions_on_one_live_per_diagnostic"
+  end
+end

data/db/migrate/20260825224538_remove_published_version_from_alembic_diagnostics.rb

@@ -0,0 +1,5 @@
+class RemovePublishedVersionFromAlembicDiagnostics < ActiveRecord::Migration[8.1]
+  def change
+    remove_reference :alembic_diagnostics, :published_version, foreign_key: { to_table: :alembic_definition_versions }
+  end
+end

data/db/migrate/20260825225015_change_alembic_diagnostic_status_to_availability.rb

@@ -0,0 +1,16 @@
+class ChangeAlembicDiagnosticStatusToAvailability < ActiveRecord::Migration[8.1]
+  class Diagnostic < ActiveRecord::Base
+    self.table_name = "alembic_diagnostics"
+  end
+
+  def up
+    Diagnostic.update_all(status: "active")
+    change_column_default :alembic_diagnostics, :status, "active"
+    change_column_null :alembic_diagnostics, :status, false, "active"
+  end
+
+  def down
+    change_column_null :alembic_diagnostics, :status, true
+    change_column_default :alembic_diagnostics, :status, nil
+  end
+end

data/db/migrate/20260825230000_add_undo_history_to_alembic_diagnostics.rb

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

data/db/migrate/20260825230500_add_changes_to_alembic_definition_versions.rb

@@ -0,0 +1,5 @@
+class AddChangesToAlembicDefinitionVersions < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_definition_versions, :changes_captured, :json
+  end
+end

data/db/migrate/20260826230000_rename_alembic_responses_to_flow_runs.rb

@@ -0,0 +1,5 @@
+class RenameAlembicResponsesToFlowRuns < ActiveRecord::Migration[8.1]
+  def change
+    rename_table :alembic_responses, :alembic_flow_runs
+  end
+end

data/db/migrate/20260826234500_rename_answers_to_recorded_on_flow_runs.rb

@@ -0,0 +1,5 @@
+class RenameAnswersToRecordedOnFlowRuns < ActiveRecord::Migration[8.1]
+  def change
+    rename_column :alembic_flow_runs, :answers, :recorded
+  end
+end

data/db/migrate/20260826235000_rename_definition_versions_to_flow_versions.rb

@@ -0,0 +1,5 @@
+class RenameDefinitionVersionsToFlowVersions < ActiveRecord::Migration[8.1]
+  def change
+    rename_table :alembic_definition_versions, :alembic_flow_versions
+  end
+end

data/db/migrate/20260826235500_rename_summary_versions_to_flow_summaries.rb

@@ -0,0 +1,5 @@
+class RenameSummaryVersionsToFlowSummaries < ActiveRecord::Migration[8.1]
+  def change
+    rename_table :alembic_summary_versions, :alembic_flow_summaries
+  end
+end

data/db/migrate/20260827000000_rename_diagnostics_to_flows.rb

@@ -0,0 +1,8 @@
+class RenameDiagnosticsToFlows < ActiveRecord::Migration[8.1]
+  def change
+    rename_table :alembic_diagnostics, :alembic_flows
+    rename_column :alembic_flow_versions, :diagnostic_id, :flow_id
+    rename_column :alembic_flow_summaries, :diagnostic_id, :flow_id
+    rename_column :alembic_flow_runs, :diagnostic_id, :flow_id
+  end
+end

data/db/migrate/20260831000000_add_persists_to_alembic_flows.rb

@@ -0,0 +1,5 @@
+class AddPersistsToAlembicFlows < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_flows, :persists, :string, default: "unsaved", null: false
+  end
+end

data/db/migrate/20260914120000_create_alembic_pages.rb

@@ -0,0 +1,9 @@
+class CreateAlembicPages < ActiveRecord::Migration[8.1]
+  def change
+    create_table :alembic_pages do |t|
+      t.string :name, null: false
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260915120000_add_blocks_to_alembic_pages.rb

@@ -0,0 +1,5 @@
+class AddBlocksToAlembicPages < ActiveRecord::Migration[8.1]
+  def change
+    add_column :alembic_pages, :blocks, :json, default: [], null: false
+  end
+end

data/lib/alembic/engine.rb

@@ -0,0 +1,43 @@
+require "alembic/leftover_stylesheet"
+require "keystone_ui-blocks"
+require "keystone_ui-react"
+
+module Alembic
+  class Engine < ::Rails::Engine
+    isolate_namespace Alembic
+
+    initializer "alembic.remove_leftover_stylesheet" do |app|
+      Alembic::LeftoverStylesheet.new(app.root).remove
+    end
+
+    initializer "alembic.tailwind" do
+      next unless Gem.loaded_specs.key?("keystone_ui")
+
+      require "keystone_ui"
+      KeystoneUi.configuration.tailwind_sources << root.join("app/views/**/*.erb").to_s
+      KeystoneUi.configuration.tailwind_sources << root.join("app/javascript/**/*.{js,jsx}").to_s
+      KeystoneUi.configuration.tailwind_sources << root.join("app/assets/builds/alembic/*.js").to_s
+    end
+
+    initializer "alembic.step_types" do |app|
+      app.config.to_prepare do
+        Alembic::Flow::Start.register
+        Alembic::Flow::Terminal.register
+
+        Alembic::Steps::Question.register
+        Alembic::Flow::Condition.register
+        Alembic::Flow::Switch.register
+
+        Alembic::Flow.check(:unrouted_value)
+        Alembic::Flow.check(:unfollowed_path)
+        Alembic::Flow.check(:dead_end)
+        Alembic::Outputs::WeightedSum.register
+        Alembic::Outputs::Percentage.register
+        Alembic::Outputs::Grouped.register
+        Alembic::Outputs::Lowest.register
+        Alembic::Outputs::Tally.register
+        Alembic::Outputs::Band.register
+      end
+    end
+  end
+end

data/lib/alembic/leftover_stylesheet.rb

@@ -0,0 +1,14 @@
+require "pathname"
+
+module Alembic
+  class LeftoverStylesheet
+    def initialize(root)
+      @root = Pathname.new(root)
+    end
+
+    def remove
+      leftover = @root.join("app/assets/builds/tailwind/alembic.css")
+      leftover.delete if leftover.exist?
+    end
+  end
+end

data/lib/alembic/version.rb

@@ -0,0 +1,3 @@
+module Alembic
+  VERSION = "0.1.0"
+end

data/lib/alembic.rb

@@ -0,0 +1,34 @@
+require "json"
+require "alembic/version"
+require "alembic/engine"
+
+module Alembic
+  class NotPublished < StandardError; end
+  class NotPermitted < StandardError; end
+  class OutOfService < StandardError; end
+  class Withdrawn < StandardError; end
+
+  class << self
+    attr_writer :layout, :base_controller, :admin_layout
+    attr_accessor :lead_partial, :admin_authentication_method, :visitor_authorization_method, :refusal_method
+
+    # The host app sets this to render the engine inside its own layout
+    # (e.g. "marketing"). Defaults to the engine's own layout.
+    def layout
+      @layout || "alembic/application"
+    end
+
+    # The host app sets this (e.g. "ApplicationController") so the engine's
+    # controllers inherit the host's helpers, layout chrome, and concerns.
+    # Defaults to a plain controller.
+    def base_controller
+      @base_controller || "ActionController::Base"
+    end
+
+    # The host app sets this to render the builder inside its own admin
+    # chrome. Defaults to the conventional application layout.
+    def admin_layout
+      @admin_layout || "application"
+    end
+  end
+end

data/lib/tasks/alembic_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :alembic do
+#   # Task goes here
+# end