ecs_on_rails 0.2.2 → 0.3.0

data/lib/generators/ecs_rails/upgrade/templates/markers_migration.rb.tt

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Moves markers onto the shared `markers` table (ADR-0018 §4).
+#
+# A marker has no state: an entity IS a moderator exactly when its row exists.
+# Every marker is a row here, the slot being the marker name, so declaring
+# `marker :moderator` no longer needs a table of its own.
+#
+# Generated by `rails g ecs_rails:upgrade`, which found the tables below by
+# their shape: component tables with no attribute columns at all. The `markers`
+# table itself is created by the catalogue migration that precedes this one.
+# Review the list before running — each is copied into `markers` under its
+# singular name and dropped. Irreversible, hence `up`/`down`.
+class EcsRailsSharedMarkers < ActiveRecord::Migration[<%= migration_version %>]
+  def up
+<% marker_tables.each do |marker| -%>
+
+    # <%= marker[:table] %> -> slot "<%= marker[:slot] %>"
+    execute <<~SQL
+      INSERT INTO markers (id, entity_id, slot, created_at, updated_at)
+      SELECT id, entity_id, '<%= marker[:slot] %>', created_at, updated_at
+      FROM <%= marker[:table] %>
+    SQL
+    drop_table :<%= marker[:table] %>
+<% end -%>
+  end
+
+  def down
+    raise ActiveRecord::IrreversibleMigration, "the per-marker tables were dropped"
+  end
+end

data/lib/generators/ecs_rails/upgrade/templates/relationships_migration.rb.tt

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# Moves relationships onto the shared `relationships` table (ADR-0017).
+#
+# Every `relates_to` is a row here: the owner is entity_id, the relationship
+# name is the slot, the pointed-at entity is target_id. Declaring a relationship
+# no longer needs a migration; this is the one that gets an existing
+# application there.
+#
+# Generated by `rails g ecs_rails:upgrade`, which found the tables below by
+# their ADR-0013 shape (entity_id + one `<name>_id` + timestamps) and name
+# (`<owner>_<names>`). The `relationships` table itself is created by the
+# catalogue migration that precedes this one. Review the list before running:
+# each is copied into `relationships` and dropped. Irreversible — the old
+# tables are gone once the rows have moved — hence `up`/`down`.
+class EcsRailsSharedRelationships < ActiveRecord::Migration[<%= migration_version %>]
+  def up
+<% backing_tables.each do |backing| -%>
+
+    # <%= backing[:table] %> -> slot "<%= backing[:slot] %>" on <%= backing[:owner_model] %>
+    execute <<~SQL
+      INSERT INTO relationships (id, entity_id, slot, target_id, owner_model, exclusive, created_at, updated_at)
+      SELECT id, entity_id, '<%= backing[:slot] %>', <%= backing[:foreign_key] %>, '<%= backing[:owner_model] %>', false, created_at, updated_at
+      FROM <%= backing[:table] %>
+    SQL
+    drop_table :<%= backing[:table] %>
+<% end -%>
+  end
+
+  def down
+    raise ActiveRecord::IrreversibleMigration, "the per-relationship tables were dropped"
+  end
+end

data/lib/generators/ecs_rails/upgrade/templates/slots_migration.rb.tt

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Adds the slot column to every existing component table (RFC-0014 / ADR-0015).
+#
+# A component may now be declared more than once on an entity under distinct
+# labels (`component PostalAddress, prefix: :business`); the `slot` column is
+# the label, "" for the singular default. The one-per-entity unique index
+# (ADR-0005) becomes one-per-(entity, slot). Safe on existing data: every row
+# already here is the single slot = "" row, so the new index admits exactly what
+# the old one did.
+#
+# Generated by `rails g ecs_rails:upgrade`, which found these tables by looking
+# for an entity_id column and no slot column.
+class EcsRailsAddSlots < ActiveRecord::Migration[<%= migration_version %>]
+  def change
+<% tables_missing_slot.each do |table| -%>
+    add_column :<%= table %>, :slot, :string, null: false, default: ""
+    remove_index :<%= table %>, column: :entity_id, unique: true
+    add_index :<%= table %>, [:entity_id, :slot], unique: true
+<%= "\n" unless table == tables_missing_slot.last -%>
+<% end -%>
+  end
+end

data/lib/generators/ecs_rails/upgrade/upgrade_generator.rb

@@ -0,0 +1,281 @@
+# frozen_string_literal: true
+
+# See the note in install_generator.rb: rails/generators/active_record/migration
+# references ActiveRecord::Migration without loading it.
+require "active_record"
+require "rails/generators/base"
+require "rails/generators/active_record/migration"
+
+# Stands on its own requires, like the other generators (RFC-0008's isolation
+# note and spec/generators/generator_isolation_spec.rb).
+require "ecs_rails"
+require_relative "../catalogue_options"
+
+module EcsRails
+  module Generators
+    # `rails g ecs_rails:upgrade`
+    #
+    # Brings an existing application's schema up to the gem's current one.
+    # ADR-0018 makes this the *only* migration a user ever runs after
+    # `ecs_rails:install`. It has two jobs today, each its own migration file so
+    # that a later gem version can add a third without renaming either:
+    #
+    # 1. **Slots** (RFC-0014 / ADR-0015) — for every component table without a
+    #    `slot` column:
+    #
+    #      add_column   :emails, :slot, :string, null: false, default: ""
+    #      remove_index :emails, column: :entity_id, unique: true
+    #      add_index    :emails, [:entity_id, :slot], unique: true
+    #
+    #    Safe on shipped data: every existing row is the single `slot = ""`, so
+    #    the new composite index admits exactly the rows the old one did.
+    #
+    # 2. **Shared relationships** (ADR-0017) — creates the `relationships` table
+    #    if it is missing, and moves every pre-0.3 per-relationship backing table
+    #    (`post_authors`, `membership_users`, ...) into it: each row becomes a
+    #    row with `slot` = the relationship name, `target_id` = the old
+    #    `<name>_id`, `owner_model` = the owner's discriminator; the old table is
+    #    then dropped. Irreversible, and written as `up`/`down` to say so.
+    #
+    # 3. **Shared markers** (ADR-0018 §4) — moves every pre-0.3 marker table (a
+    #    component table with no attribute columns at all: `moderators`,
+    #    `administrators`) into `markers`, slot = the table's singular name; the
+    #    old table is then dropped. Irreversible.
+    #
+    # Before 2 and 3, **the catalogue** (ADR-0018): for every catalogue
+    # component in the selected `--sets` (and every catalogue table that already
+    # exists, whatever its set), a missing table is created and a table that
+    # predates a column or index is brought forward — both rendered from the
+    # gem's schema declarations, the same recordings install renders. Missing
+    # one-line classes are written too; existing files are never touched. This
+    # is how a newer gem version's catalogue additions, or a set added later,
+    # reach an application.
+    #
+    # Tables are found by inspecting the database, not the registry: a generator
+    # runs before the app's classes are loaded, and the registry would miss a
+    # component whose entity is never referenced. Any table with an `entity_id`
+    # column is a component table (architecture.md §2). A backing table is
+    # recognised by its shape — entity_id, exactly one other `<name>_id` uuid
+    # column, timestamps, nothing else — and its ADR-0013 name,
+    # `<owner>_<names>`. The developer reviews the file before running it, as
+    # with any generated migration. When nothing is pending, nothing is written
+    # and the generator says so.
+    class UpgradeGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      include CatalogueOptions
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Upgrades an existing schema to the gem's current one: the slot column " \
+           "on component tables, and the shared relationships and markers tables."
+
+      # Inspects every selected catalogue table before any generator writes.
+      # An incompatible schema must not leave a partial set of upgrade files.
+      #
+      # @return [void]
+      def verify_catalogue_schema
+        catalogue_changes
+      rescue EcsRails::SchemaMismatch => error
+        raise Thor::Error, error.message
+      end
+
+      # Emits the slot migration for component tables that lack the column, or
+      # says there is nothing to do. Backing tables about to be moved into
+      # `relationships`, and marker tables about to be moved into `markers`, are
+      # skipped — they are dropped a migration later.
+      #
+      # A Thor task: invoked as a generator step, not called directly.
+      #
+      # @return [void]
+      def create_slots_migration
+        if tables_missing_slot.empty?
+          say "Every component table already has a slot column.", :green
+          return
+        end
+
+        migration_template(
+          "slots_migration.rb.tt",
+          File.join(db_migrate_path, "ecs_rails_add_slots.rb")
+        )
+      end
+
+      # Emits the catalogue migration — missing tables and missing columns or
+      # indexes on existing ones — or says everything is current, and writes any
+      # missing one-line classes for the selected sets.
+      #
+      # A Thor task: invoked as a generator step, not called directly.
+      #
+      # @return [void]
+      def create_catalogue_migration
+        create_catalogue_class_files(catalogue_components)
+
+        if catalogue_changes.empty?
+          say "Every catalogue table is current.", :green
+          return
+        end
+
+        migration_template(
+          "catalogue_migration.rb.tt",
+          File.join(db_migrate_path, "ecs_rails_catalogue.rb")
+        )
+      end
+
+      # Emits the shared-relationships data move when per-relationship backing
+      # tables remain, or says so. The `relationships` table itself is the
+      # catalogue migration's business, which runs first.
+      #
+      # A Thor task: invoked as a generator step, not called directly.
+      #
+      # @return [void]
+      def create_relationships_migration
+        if backing_tables.empty?
+          say "Relationships already live in the shared relationships table.", :green
+          return
+        end
+
+        migration_template(
+          "relationships_migration.rb.tt",
+          File.join(db_migrate_path, "ecs_rails_shared_relationships.rb")
+        )
+      end
+
+      # Emits the shared-markers data move when empty per-marker tables remain,
+      # or says so. The `markers` table itself is the catalogue migration's
+      # business, which runs first.
+      #
+      # A Thor task: invoked as a generator step, not called directly.
+      #
+      # @return [void]
+      def create_markers_migration
+        if marker_tables.empty?
+          say "Markers already live in the shared markers table.", :green
+          return
+        end
+
+        migration_template(
+          "markers_migration.rb.tt",
+          File.join(db_migrate_path, "ecs_rails_shared_markers.rb")
+        )
+      end
+
+      private
+
+      # Component tables (any table with an entity_id column, other than
+      # `entities` itself) that have no `slot` column yet — minus the backing
+      # tables the relationships migration drops. Sorted, so the migration is
+      # deterministic; uniq, because a multi-schema search_path can list one
+      # name twice (the columns then resolve to the first schema).
+      def tables_missing_slot
+        @tables_missing_slot ||= component_tables.select do |table|
+          !column_names(table).include?("slot") &&
+            backing_tables.none? { |b| b[:table] == table } &&
+            marker_tables.none? { |m| m[:table] == table }
+        end
+      end
+
+      # Pre-0.3 marker tables: a component table with no attribute columns at all
+      # — only id, entity_id, (slot,) timestamps — other than `markers` itself.
+      # Each becomes `{ table: "moderators", slot: "moderator" }`. Catalogue
+      # ownership wins over shape: missing attributes must never trigger a move.
+      def marker_tables
+        @marker_tables ||= component_tables.filter_map do |table|
+          next if table == "markers" || upgradeable_components.any? { |component| component.table == table }
+          next unless (column_names(table) - %w[id entity_id slot created_at updated_at]).empty?
+
+          { table: table, slot: table.singularize }
+        end
+      end
+
+      def component_tables
+        @component_tables ||= connection.tables.uniq.sort.select do |table|
+          table != "entities" && column_names(table).include?("entity_id")
+        end
+      end
+
+      # The catalogue components this upgrade brings forward: the selected sets,
+      # plus any component the application already has a one-line class for,
+      # whatever its set (an app that installed `commerce` earlier keeps getting
+      # its upgrades). The class file, not the table, is the evidence: a bespoke
+      # table that merely shares a catalogue name (`names`, say) must not be
+      # "upgraded" with the catalogue's columns. Within a selected set the table
+      # IS treated as the catalogue's — the developer asked for that set.
+      def upgradeable_components
+        @upgradeable_components ||= (catalogue_components +
+          EcsRails::Catalogue.components.select { |c| catalogue_class_file?(c) }).uniq
+      end
+
+      # Does the components directory hold a class including this concern?
+      def catalogue_class_file?(component)
+        dir = File.join(destination_root, EcsRails.config.components_path)
+        return false unless File.directory?(dir)
+
+        Dir.glob(File.join(dir, "*.rb")).any? do |file|
+          File.read(file).include?("include EcsRails::Catalogue::#{component.class_name}")
+        end
+      end
+
+      # `[{ component:, source: }]` — the migration source for each component
+      # whose table is missing, or is missing a column or index. Empty when the
+      # catalogue is current.
+      def catalogue_changes
+        @catalogue_changes ||= upgradeable_components.filter_map do |component|
+          table = component.table
+          source =
+            if connection.tables.include?(table)
+              component.schema.to_ruby_diff(
+                table_name: table,
+                connection: connection,
+                slot_upgrade: tables_missing_slot.include?(table)
+              )
+            else
+              component.schema.to_ruby(table_name: table)
+            end
+          { component: component, source: source } unless source.empty?
+        end
+      end
+
+      # ADR-0013 backing tables, recognised by shape and name: columns are
+      # exactly id, entity_id, one `<name>_id` uuid, timestamps (plus slot, if a
+      # slots upgrade already ran), and the table is `<owner>_<names>` with a
+      # non-empty owner. Each becomes
+      # `{ table:, slot: "author", foreign_key: "author_id", owner_model: "posts" }`.
+      # The `relationships` table itself is excluded by shape (it has more
+      # columns), and a bespoke component with a single foreign key but its own
+      # name (`sponsors`) is excluded by the name rule.
+      def backing_tables
+        @backing_tables ||= component_tables.filter_map do |table|
+          next if upgradeable_components.any? { |component| component.table == table }
+
+          columns = column_names(table) - %w[id entity_id slot created_at updated_at]
+          next unless columns.size == 1
+
+          foreign_key = columns.first
+          next unless foreign_key.end_with?("_id") && column_type(table, foreign_key) == :uuid
+
+          name = foreign_key.delete_suffix("_id")
+          suffix = "_#{name.pluralize}"
+          next unless table.end_with?(suffix) && table.length > suffix.length
+
+          owner = table.delete_suffix(suffix)
+          { table: table, slot: name, foreign_key: foreign_key, owner_model: owner.pluralize }
+        end
+      end
+
+      def column_names(table)
+        connection.columns(table).map(&:name)
+      end
+
+      def column_type(table, column)
+        connection.columns(table).find { |c| c.name == column }&.type
+      end
+
+      def connection
+        ActiveRecord::Base.connection
+      end
+
+      def migration_version
+        "#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}"
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ecs_on_rails
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Jason Hutchens
@@ -9,6 +9,26 @@ 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: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
@@ -86,31 +106,68 @@ files:
 - README.md
 - lib/ecs_on_rails.rb
 - lib/ecs_rails.rb
+- lib/ecs_rails/catalogue.rb
+- lib/ecs_rails/catalogue/address.rb
+- lib/ecs_rails/catalogue/calendar_date.rb
+- lib/ecs_rails/catalogue/counter.rb
+- lib/ecs_rails/catalogue/discard.rb
+- lib/ecs_rails/catalogue/email.rb
+- lib/ecs_rails/catalogue/geolocation.rb
+- lib/ecs_rails/catalogue/identifier.rb
+- lib/ecs_rails/catalogue/image.rb
+- lib/ecs_rails/catalogue/link.rb
+- lib/ecs_rails/catalogue/marker.rb
+- lib/ecs_rails/catalogue/money.rb
+- lib/ecs_rails/catalogue/name.rb
+- lib/ecs_rails/catalogue/password.rb
+- lib/ecs_rails/catalogue/period.rb
+- lib/ecs_rails/catalogue/phone.rb
+- lib/ecs_rails/catalogue/position.rb
+- lib/ecs_rails/catalogue/rating.rb
+- lib/ecs_rails/catalogue/relationship.rb
+- lib/ecs_rails/catalogue/role.rb
+- lib/ecs_rails/catalogue/schema_diff.rb
+- lib/ecs_rails/catalogue/search_vector.rb
+- lib/ecs_rails/catalogue/state.rb
+- lib/ecs_rails/catalogue/tags.rb
+- lib/ecs_rails/catalogue/text.rb
+- lib/ecs_rails/catalogue/timestamp.rb
+- lib/ecs_rails/catalogue/token.rb
 - lib/ecs_rails/component.rb
 - lib/ecs_rails/config.rb
 - lib/ecs_rails/dsl.rb
 - lib/ecs_rails/entity.rb
 - lib/ecs_rails/errors.rb
+- lib/ecs_rails/inverses.rb
 - lib/ecs_rails/lazy.rb
+- lib/ecs_rails/markers.rb
 - lib/ecs_rails/preloading.rb
 - lib/ecs_rails/presence.rb
 - lib/ecs_rails/querying.rb
 - lib/ecs_rails/railtie.rb
 - lib/ecs_rails/registry.rb
 - lib/ecs_rails/relationships.rb
+- lib/ecs_rails/slots.rb
 - lib/ecs_rails/validations.rb
 - lib/ecs_rails/version.rb
+- lib/generators/ecs_rails/catalogue_options.rb
 - lib/generators/ecs_rails/component/component_generator.rb
 - lib/generators/ecs_rails/component/templates/component_spec.rb.tt
 - lib/generators/ecs_rails/component/templates/migration.rb.tt
 - lib/generators/ecs_rails/component/templates/model.rb.tt
+- lib/generators/ecs_rails/entity/entity_generator.rb
+- lib/generators/ecs_rails/entity/templates/entity.rb.tt
 - lib/generators/ecs_rails/install/install_generator.rb
 - lib/generators/ecs_rails/install/templates/application_component.rb.tt
 - lib/generators/ecs_rails/install/templates/application_entity.rb.tt
 - lib/generators/ecs_rails/install/templates/initializer.rb.tt
-- lib/generators/ecs_rails/install/templates/migration.rb.tt
-- lib/generators/ecs_rails/relationship/relationship_generator.rb
-- lib/generators/ecs_rails/relationship/templates/migration.rb.tt
+- lib/generators/ecs_rails/install/templates/install_migration.rb.tt
+- lib/generators/ecs_rails/templates/catalogue_class.rb.tt
+- lib/generators/ecs_rails/upgrade/templates/catalogue_migration.rb.tt
+- lib/generators/ecs_rails/upgrade/templates/markers_migration.rb.tt
+- lib/generators/ecs_rails/upgrade/templates/relationships_migration.rb.tt
+- lib/generators/ecs_rails/upgrade/templates/slots_migration.rb.tt
+- lib/generators/ecs_rails/upgrade/upgrade_generator.rb
 homepage: https://github.com/kranzky/ecs_rails
 licenses:
 - MIT

data/lib/generators/ecs_rails/install/templates/migration.rb.tt

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-# Creates the single `entities` table every ECS Rails entity shares.
-# See docs/architecture.md §2 and docs/adr/0002-single-entities-table.md.
-class EcsRailsCreateEntities < ActiveRecord::Migration[<%= migration_version %>]
-  def change
-    # gen_random_uuid() lives in pgcrypto on PostgreSQL < 13; enabling it is
-    # harmless on 13+, where the function is built in.
-    enable_extension "pgcrypto" unless extension_enabled?("pgcrypto")
-
-    create_table :entities, id: :uuid, default: -> { "gen_random_uuid()" } do |t|
-      # The entity subclass discriminator, e.g. "users". Indexed because
-      # User.all compiles to WHERE model = 'users'.
-      t.string :model, null: false, index: true
-      t.datetime :created_at, null: false
-      # No updated_at — an entity is written once and never changes.
-      # See RFC-0001 and docs/architecture.md §1.
-    end
-  end
-end

data/lib/generators/ecs_rails/relationship/relationship_generator.rb

@@ -1,99 +0,0 @@
-# frozen_string_literal: true
-
-# See the note in component_generator.rb: rails/generators/active_record/migration
-# references ActiveRecord::Migration without loading it, so these are required
-# explicitly for load-isolation (generator_isolation_spec.rb).
-require "active_record"
-require "rails/generators/named_base"
-require "rails/generators/active_record/migration"
-
-# ADR-0010: the generator reads EcsRails.config. Require the library explicitly so
-# the generator stands on its own requires (RFC-0008's isolation note).
-require "ecs_rails"
-
-module EcsRails
-  module Generators
-    # `rails g ecs_rails:relationship OWNER name:Target`
-    #
-    #   rails g ecs_rails:relationship Post author:User
-    #
-    # Implements RFC-0012 / ADR-0013. Unlike the component generator, this emits
-    # ONLY a migration — `relates_to` defines the backing component dynamically,
-    # so there is no model file to write. It prints a reminder to add the
-    # `relates_to` line to the entity.
-    #
-    # The migration creates the owner-scoped backing table `post_authors`:
-    #   - uuid PK,
-    #   - entity_id: not-null, UNIQUE index, ON DELETE CASCADE FK to entities —
-    #     the owner side (a post has at most one author; destroying the post
-    #     destroys the link),
-    #   - author_id: indexed, ON DELETE **NULLIFY** FK to entities — the target
-    #     side (destroying the target nullifies, does not cascade to the owner),
-    #   - timestamps.
-    #
-    # The single `name:Target` argument does not fit Rails' GeneratedAttribute
-    # (there is no `:Target` column type), so it is parsed by hand — see
-    # #parse_relationship!.
-    class RelationshipGenerator < Rails::Generators::NamedBase
-      include ActiveRecord::Generators::Migration
-
-      source_root File.expand_path("templates", __dir__)
-
-      argument :relationship, type: :string, banner: "name:Target"
-
-      desc "Creates the migration for a relationship's backing table (no model)."
-
-      # Emits the backing relationship table migration.
-      #
-      # A Thor task: invoked as a generator step, not called directly.
-      #
-      # @return [void]
-      def create_migration_file
-        parse_relationship!
-        migration_template(
-          "migration.rb.tt",
-          File.join(db_migrate_path, "create_#{backing_table_name}.rb")
-        )
-      end
-
-      # RFC-0012: no component file. The DSL defines the backing component; the
-      # developer only has to declare the relationship on the entity.
-      def print_relates_to_reminder
-        entity_path = File.join(EcsRails.config.entities_path, class_path, "#{file_name}.rb")
-        say "Add the relationship to #{entity_path}:", :green
-        say "    relates_to :#{relation_name}, #{target_class_name}"
-      end
-
-      private
-
-      # Splits the `name:Target` argument. `file_name` (from NamedBase) is the
-      # OWNER, e.g. "post"; `relationship` is "author:User".
-      def parse_relationship!
-        @relation_name, @target_class_name = relationship.split(":", 2)
-
-        return unless @relation_name.to_s.empty? || @target_class_name.to_s.empty?
-
-        raise Thor::Error,
-              "expected OWNER name:Target, e.g. " \
-              "`rails g ecs_rails:relationship Post author:User` (got #{relationship.inspect})"
-      end
-
-      attr_reader :relation_name, :target_class_name
-
-      # The owner-scoped backing table: #{owner.singular}_#{relation.plural} —
-      # `post_authors`. Mirrors the derivation in EcsRails::Relationships.
-      def backing_table_name
-        "#{singular_table_name}_#{relation_name.pluralize}"
-      end
-
-      # The target FK column: `author_id`. Mirrors EcsRails::Relationships.
-      def target_foreign_key
-        "#{relation_name}_id"
-      end
-
-      def migration_version
-        "#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}"
-      end
-    end
-  end
-end

data/lib/generators/ecs_rails/relationship/templates/migration.rb.tt

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-# Creates the <%= backing_table_name %> relationship backing table
-# (RFC-0012 / ADR-0013). This is what `relates_to :<%= relation_name %>,
-# <%= target_class_name %>` reads; there is no relationship component file — the
-# DSL defines the backing component dynamically.
-#
-# The owner side (entity_id) and the target side (<%= target_foreign_key %>) are
-# deliberately asymmetric:
-#   - entity_id: not-null, UNIQUE (ADR-0005: at most one per owner), ON DELETE
-#     CASCADE — destroying the owner destroys the link.
-#   - <%= target_foreign_key %>: nullable, ON DELETE NULLIFY — destroying the
-#     TARGET nullifies the link, it does NOT cascade to the owner.
-class Create<%= backing_table_name.camelize %> < ActiveRecord::Migration[<%= migration_version %>]
-  def change
-    create_table :<%= backing_table_name %>, id: :uuid, default: -> { "gen_random_uuid()" } do |t|
-      t.uuid :entity_id, null: false
-      t.uuid :<%= target_foreign_key %>, default: nil
-      t.timestamps
-    end
-
-    # ADR-0005: at most one relationship row per owner entity.
-    add_index :<%= backing_table_name %>, :entity_id, unique: true
-
-    # Destroying the owner destroys the link, at the database level.
-    add_foreign_key :<%= backing_table_name %>, :entities, column: :entity_id, on_delete: :cascade
-
-    # Destroying the TARGET nullifies the link — it does not cascade to the owner.
-    add_index :<%= backing_table_name %>, :<%= target_foreign_key %>
-    add_foreign_key :<%= backing_table_name %>, :entities, column: :<%= target_foreign_key %>, on_delete: :nullify
-  end
-end