railbow 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 783c8ab9f75f889cd1c54cd36dbc258e06b411b9ae5132af6815564f83d73312
-  data.tar.gz: 1200e9edbd432786044d0ac0992773de513390e787500eecd48dc745a473da4e
+  metadata.gz: c42f0f6d8162662344a6ef8fb12388e8dd6a2a579384cab3829a85d806cb1571
+  data.tar.gz: 064fb908f8cd7567e9d8be53800e6972aa48faf65348aff7338c6088aa7427dd
 SHA512:
-  metadata.gz: be4c900efd96d11e1d896eb0facd145a928fc93b2b08d30b02cf14a3638e0cf5f133f0c929d037cf828cb3862387ad63725cbbc1cdad4fb84afa353b77ef32fe
-  data.tar.gz: 5231639b5beaefce4ee54e9d0e81b0309d8370b66e4cb7ca9a0e496ad64d0bebcd8b8a69458fe056789947a216e6b6cbdd3c8ad0fb442ddfebf38d25cbf196b8
+  metadata.gz: f7af392359a26db27919f6bac5d31ce22d6736615bbbe8d514c794e5114a2a71ff61081160340a3177fd4b172207b8c07ae2948fcfdaeaccbc0498b28370fb1c
+  data.tar.gz: e5a9364c62c93fa530cbde3222c2249b3f251043514fda4d4cf51a33cfaf27ad54bffed5d5abae43befe065634faee0d96ec60581adc22004cd45790e7f87534

data/CHANGELOG.md

@@ -5,6 +5,57 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-07-23
+
+### Added
+
+- Ghost rows in `db:migrate:status` now surface mighost 0.5's classification:
+  a superseded ghost (re-timestamped migration) shows a calmer 🪦 status with
+  a `≡ <version>` badge pointing at its successor, and a ghost deleted with no
+  surviving branch shows `✂ deleted in:<sha>`. Branch badges are unchanged and
+  take precedence right after supersession.
+- `RBW_FORCE=1` forces Railbow formatting past every auto-detection
+  (`NO_COLOR`, CI, piped output, LLM agent detection). An explicit
+  `RBW_PLAIN=1` still wins.
+
+### Changed
+
+- Ghost data now comes from `Mighost::API.orphaned_migrations`, so
+  `db:migrate:status` honors mighost dismissals and `hide_superseded` for the
+  first time: a dismissed or hidden ghost renders as plain `NO FILE` instead
+  of 👻. Live git/worktree recovery still kicks in for versions without a
+  stored snapshot, so fresh clones keep working with zero setup.
+
+### Fixed
+
+- A ghost row without a branch no longer inherits the previous ghost row's
+  branch badge (a stale local leaked across loop iterations; unreachable
+  before mighost 0.5 made branchless ghosts the normal case).
+
+## [0.2.0] - 2026-07-23
+
+### Added
+
+- Affected-table detection now recognizes tables passed via keyword
+  arguments (`table:`, `to_table:`, `from_table:`), covering project-level
+  migration helpers and DSLs that the ActiveRecord method allow-list missed.
+- `change_column_default` and `change_column_null` are recognized, and
+  foreign-key methods contribute their first table even when the target is
+  given as `to_table:`.
+
+### Fixed
+
+- Ruby comments no longer produce phantom tables: content is stripped of
+  `#` comments (preserving `#{}` interpolation) before scanning, so a
+  comment mentioning `ALTER TABLE` or a commented-out `create_table` does
+  not count.
+
+### Changed
+
+- Ghost recovery integration targets [mighost](https://github.com/amberpixels/mighost)
+  0.5, which classifies superseded ghosts and reports accurate branch
+  attribution.
+
 ## [0.1.0] - 2026-07-08
 
 First public release.

data/README.md

@@ -22,7 +22,7 @@
 - **About** - polished `rails about` output
 - **Git Integration** - authors, diffs, branch origin, landing dates, uncommitted file indicators
 - **Calendar View** - month separators and week tick markers for migration timelines
-- **Ghost Recovery** - pairs with the optional [mighost](https://github.com/amberpixels/mighost) gem to recover names, authors, and branch badges for `NO FILE` migrations
+- **Ghost Recovery** - uses the [mighost](https://github.com/amberpixels/mighost) gem (optional) to recover names, authors, and branch badges for `NO FILE` migrations
 - **Smart Defaults** - auto-disables in CI, piped output, `NO_COLOR`, and LLM agents
 
 ## Installation
@@ -97,16 +97,16 @@ becomes a rich, information-dense dashboard (with default config):
 
 Out of the box you get:
 
-- **Calendar separators** — month + ISO week headers to orient you in time
-- **Status aliases** — `↑↑` / `↓↓` instead of `up` / `down` (customizable)
-- **Created At** — timestamp parsed from the migration ID
-- **Landing dates** — `⤻ Mar 04` badge when a migration was merged to main after its creation
-- **Branch badges** — `⎇ PS-142` showing the source branch/ticket
-- **Affected tables** — color-coded table names extracted from migration files
-- **Time filtering** — only the last 70 days shown by default (`since: 70d`)
-- **Your migrations highlighted** — rows authored by you are visually distinct
+- **Calendar separators** - month + ISO week headers to orient you in time
+- **Status aliases** - `↑↑` / `↓↓` instead of `up` / `down` (customizable)
+- **Created At** - timestamp parsed from the migration ID
+- **Landing dates** - `⤻ Mar 04` badge when a migration was merged to main after its creation
+- **Branch badges** - `⎇ PS-142` showing the source branch/ticket
+- **Affected tables** - color-coded table names extracted from migration files
+- **Time filtering** - only the last 70 days shown by default (`since: 70d`)
+- **Your migrations highlighted** - rows authored by you are visually distinct
 
-If the [mighost](https://github.com/amberpixels/mighost) gem is installed, migrations whose files were deleted (e.g. after switching branches) show up with a 👻 status and their recovered name and origin branch instead of a bare `********** NO FILE **********` row.
+If the [mighost](https://github.com/amberpixels/mighost) gem is installed (`gem "mighost", group: [:development, :test]`), migrations whose files were deleted (e.g. after switching branches) show up with a 👻 status and their recovered name instead of a bare `********** NO FILE **********` row - Railbow talks to it through the stable `Mighost::API`. Each ghost row carries the most informative badge mighost can provide: `≡ <version>` when the migration was re-timestamped and lives on under another version (shown with a calmer 🪦 status), `⌥ <branch>` when a branch still holds the file, or `✂ deleted in:<sha>` pointing at the commit that removed it. Ghosts dismissed via `mighost:dismiss` (or hidden by `hide_superseded`) render as plain `NO FILE`.
 
 ### `rails db:migrate:down`
 
@@ -126,7 +126,7 @@ Code statistics rendered as a colorful table with highlighted totals and code-to
 
 ### `rails notes`
 
-Annotations enriched with git blame data — author names, commit dates, and color-coded tags (TODO=yellow, FIXME=red, OPTIMIZE=cyan, HACK=red, NOTE=green).
+Annotations enriched with git blame data - author names, commit dates, and color-coded tags (TODO=yellow, FIXME=red, OPTIMIZE=cyan, HACK=red, NOTE=green).
 
 ## Configuration
 
@@ -176,6 +176,7 @@ Every option can also be set via `RBW_*` environment variables, which override c
 | Variable | Example | Description |
 |---|---|---|
 | `RBW_PLAIN` | `1` | Disable all formatting |
+| `RBW_FORCE` | `1` | Force formatting even when piped, in CI, or run by an LLM agent (`RBW_PLAIN=1` still wins) |
 | `RBW_SINCE` | `2mo`, `70d`, `1y`, `all` | Filter migrations by time period |
 | `RBW_DATE` | `full`, `rel`, `short`, `custom(%b %d)` | Date display format |
 | `RBW_GIT` | `author:me,diff,mask:auto` | Git integration options |
@@ -207,7 +208,7 @@ RBW_SORT=date rails notes
 
 ## How It Works
 
-Railbow integrates through a Rails Railtie — it prepends formatter modules onto existing Rails classes without modifying your code:
+Railbow integrates through a Rails Railtie - it prepends formatter modules onto existing Rails classes without modifying your code:
 
 - `ActiveRecord::Migration` - migration output
 - `ActiveRecord::Tasks::DatabaseTasks` - migration status
@@ -221,6 +222,10 @@ Formatting auto-disables when:
 - Output is piped or redirected (non-TTY)
 - Running inside an LLM agent (`CLAUDECODE` env var)
 
+`RBW_FORCE=1` overrides all of the auto-detection above (useful for capturing
+formatted output to a file, or letting an agent inspect the real rendering).
+An explicit `RBW_PLAIN=1` always wins over `RBW_FORCE`.
+
 ## Requirements
 
 - Ruby >= 3.1.0

data/lib/railbow/init.rb

@@ -26,16 +26,16 @@ module Railbow
       # sort: "file"
 
       # Git integration (comma-separated compound value):
-      #   author       — add Author column (same as author:all)
-      #   author:me    — highlight your own migrations
-      #   author:all   — show all authors
-      #   diff         — tag migrations by git origin branch
-      #   base:<branch> — base branch for diff (default: auto-detected)
-      #   mask:auto    — auto-extract ticket id from branch name
-      #   mask:<re>    — custom regex to extract branch label, e.g. mask:(WS-[^/]+)/
+      #   author       - add Author column (same as author:all)
+      #   author:me    - highlight your own migrations
+      #   author:all   - show all authors
+      #   diff         - tag migrations by git origin branch
+      #   base:<branch> - base branch for diff (default: auto-detected)
+      #   mask:auto    - auto-extract ticket id from branch name
+      #   mask:<re>    - custom regex to extract branch label, e.g. mask:(WS-[^/]+)/
       git: "author:all,diff,mask:auto"
 
-      # Author display format — preset or custom pattern (FF L, FFF LL, etc.):
+      # Author display format - preset or custom pattern (FF L, FFF LL, etc.):
       #   initials (J D), short (Jo D), first_name (John), last_name (Doe),
       #   full_name (John Doe), full_name_short (John D.)
       author_format: "short"
@@ -50,11 +50,11 @@ module Railbow
       # date: "full"
 
       # Compact mode (comma-separated):
-      #   oneline       — one line per migration
-      #   dense         — reduce padding
-      #   noheader      — hide table headers
-      #   maxw:<N>      — max column width
-      #   hide:<col>    — hide a column (repeatable)
+      #   oneline       - one line per migration
+      #   dense         - reduce padding
+      #   noheader      - hide table headers
+      #   maxw:<N>      - max column width
+      #   hide:<col>    - hide a column (repeatable)
       # compact: ""
 
       # Rename column headers and cell values in table output

data/lib/railbow/migration_parser.rb

@@ -8,6 +8,7 @@ module Railbow
     SINGLE_TABLE_METHODS = %w[
       create_table drop_table change_table
       add_column remove_column rename_column change_column
+      change_column_default change_column_null
       add_index remove_index
       add_reference remove_reference
       add_belongs_to remove_belongs_to
@@ -19,7 +20,9 @@ module Railbow
       add_foreign_key remove_foreign_key
     ].freeze
 
-    SINGLE_TABLE_PATTERN = /\b(?:#{SINGLE_TABLE_METHODS.join("|")})\s+[:"](\w+)/
+    # Dual-table methods are included here too: their first argument is always a
+    # table, even when the second is passed as `to_table:` instead of positionally.
+    SINGLE_TABLE_PATTERN = /\b(?:#{(SINGLE_TABLE_METHODS + DUAL_TABLE_METHODS).join("|")})\s+[:"](\w+)/
     DUAL_TABLE_PATTERN = /\b(?:#{DUAL_TABLE_METHODS.join("|")})\s+[:"](\w+)["\s,]+[:"](\w+)/
 
     # SQL keywords followed by a table name
@@ -33,6 +36,17 @@ module Railbow
       /\bCREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?["']?(\w+)["']?/i
     ].freeze
 
+    # Helper/DSL calls that name their target table via a keyword argument, e.g.
+    # `convert_to_monthly_partitions(table: :apples)` or
+    # `remove_foreign_key :accounts, to_table: :owners`. Catches project-level
+    # migration helpers regardless of the method name. Bare `from:`/`to:` are
+    # deliberately not matched — `change_column_default :users, :status,
+    # from: nil, to: "active"` would yield phantom tables.
+    KEYWORD_TABLE_PATTERN = /\b(?:table|to_table|from_table):\s*[:"']?(\w+)/
+
+    # Ruby `#` comments up to end of line, but not `#{}` interpolation.
+    COMMENT_PATTERN = /#(?!\{).*/
+
     # AR class-level query/mutation methods that strongly signal a constant is a model.
     # Kept narrow on purpose — methods like `find`, `all`, `first`, `count`, `create`,
     # `new`, `transaction`, `order`, `includes` collide with stdlib/non-model constants
@@ -60,6 +74,11 @@ module Railbow
     def self.extract_tables_from_content(content)
       return [] if content.nil? || content.empty?
 
+      # Comments would otherwise produce phantom tables — an explanatory
+      # "# ALTER TABLE foo ..." or a commented-out create_table reads exactly
+      # like the real thing to the patterns below.
+      content = content.gsub(COMMENT_PATTERN, "")
+
       tables = []
 
       content.scan(SINGLE_TABLE_PATTERN) { |match| tables << match[0] }
@@ -67,6 +86,7 @@ module Railbow
       SQL_TABLE_PATTERNS.each do |pattern|
         content.scan(pattern) { |match| tables << match[0] }
       end
+      content.scan(KEYWORD_TABLE_PATTERN) { |match| tables << match[0] }
       tables.uniq!
 
       # Model-based detection is heuristic (a constant that happens to respond

data/lib/railbow/notes_formatter.rb

@@ -256,17 +256,17 @@ module Railbow
 
         \e[1mOptions:\e[0m
           RBW_GIT=<options>        Git integration (comma-separated):
-                                   author     — show all authors (same as author:all)
-                                   author:all — show author + date on each annotation
-                                   author:me  — highlight your own annotations
+                                   author     - show all authors (same as author:all)
+                                   author:all - show author + date on each annotation
+                                   author:me  - highlight your own annotations
 
           RBW_SINCE=<period>       Filter annotations by blame date (default: all)
                                    Values: all, 2mo, 1w, 30d, 1y, etc.
                                    Units: d (days), w (weeks), mo/m (months), y (years)
 
           RBW_SORT=<mode>          Sort order (default: file)
-                                   file — group by file (default Rails order)
-                                   date — sort by blame date (newest first)
+                                   file - group by file (default Rails order)
+                                   date - sort by blame date (newest first)
 
           RBW_PLAIN=1              Disable Railbow formatting (plain Rails output)
 

data/lib/railbow/params.rb

@@ -71,6 +71,10 @@ module Railbow
       truthy?(ENV["RBW_PLAIN"])
     end
 
+    def force?
+      truthy?(ENV["RBW_FORCE"])
+    end
+
     def since
       (ENV["RBW_SINCE"] || Config.load["since"] || "all").strip.downcase
     end

data/lib/railbow/tasks/migrate_status.rake

@@ -12,8 +12,113 @@ require_relative "../logo"
 # db:migrate:status and db:migrate:status:<database_name> tasks.
 module Railbow
   module MigrateStatusFormatter
+    # Ghost migration data normalized for rendering, whether it came from
+    # mighost's orphan classification or a live snapshot recovery.
+    class GhostRow
+      attr_reader :filename, :branch_name, :source, :superseded_by, :deleted_in_sha,
+        :author_name, :author_email, :content
+
+      def initialize(filename: nil, branch_name: nil, source: nil, superseded_by: nil,
+        deleted_in_sha: nil, author_name: nil, author_email: nil, content: nil)
+        @filename = filename
+        @branch_name = branch_name
+        @source = source
+        @superseded_by = superseded_by
+        @deleted_in_sha = deleted_in_sha
+        @author_name = author_name
+        @author_email = author_email
+        @content = content
+      end
+    end
+
     private
 
+    def mighost_attr(obj, name)
+      obj.respond_to?(name) ? obj.public_send(name) : nil
+    end
+
+    def mighost_snapshot_content(version)
+      Mighost::API.find_snapshot(version)&.content
+    rescue
+      nil
+    end
+
+    def load_ghost_rows(versions, with_content: false)
+      # Detect once: OrphanedMigration carries the classification (supersession,
+      # deletion commit) that a bare snapshot doesn't, and already honors
+      # dismissals and hide_superseded.
+      orphans = begin
+        Mighost::API.orphaned_migrations.to_h { |o| [o.version.to_s, o] }
+      rescue
+        return {}
+      end
+
+      rows = {}
+      versions.each do |v|
+        # Absent from detect = deliberately suppressed (dismissed, or superseded
+        # with hide_superseded on) - render as plain NO FILE, don't re-recover.
+        next unless (orphan = orphans[v])
+
+        if orphan.filename && !orphan.filename.empty?
+          rows[v] = GhostRow.new(
+            filename: orphan.filename,
+            branch_name: orphan.branch_name,
+            source: mighost_attr(orphan, :source),
+            superseded_by: mighost_attr(orphan, :superseded_by),
+            deleted_in_sha: mighost_attr(orphan, :deleted_in_sha),
+            author_name: mighost_attr(orphan, :author_name),
+            author_email: mighost_attr(orphan, :author_email),
+            content: with_content ? mighost_snapshot_content(v) : nil
+          )
+        else
+          # Detect reads stored snapshots only. A version it lists without a
+          # filename has no snapshot yet, so fall back to live git/worktree
+          # recovery - keeps fresh clones working with zero setup.
+          snapshot = begin
+            Mighost::API.find_or_recover_snapshot(v)
+          rescue
+            nil
+          end
+          next unless snapshot&.filename && !snapshot.filename.empty?
+
+          rows[v] = GhostRow.new(
+            filename: snapshot.filename,
+            branch_name: snapshot.branch_name,
+            source: mighost_attr(snapshot, :source),
+            superseded_by: api_superseded_by(v),
+            deleted_in_sha: mighost_attr(snapshot, :deleted_in_sha),
+            author_name: mighost_attr(snapshot, :author_name),
+            author_email: mighost_attr(snapshot, :author_email),
+            content: with_content ? snapshot.content : nil
+          )
+        end
+      end
+      rows
+    end
+
+    def api_superseded_by(version)
+      return nil unless Mighost::API.respond_to?(:superseded_by)
+
+      Mighost::API.superseded_by(version)
+    rescue
+      nil
+    end
+
+    # One tag slot per ghost row; most informative wins.
+    def ghost_tag(ghost)
+      if ghost.superseded_by
+        "\e[38;5;245m≡ #{ghost.superseded_by}\e[38;5;217m"
+      elsif ghost.branch_name
+        if ghost.source == "worktree"
+          "\e[38;5;222m⌥ₜ#{ghost.branch_name}\e[38;5;217m"
+        else
+          "\e[38;5;222m⌥ #{ghost.branch_name}\e[38;5;217m"
+        end
+      elsif ghost.deleted_in_sha
+        "\e[38;5;245m✂ deleted in:#{ghost.deleted_in_sha[0, 8]}\e[38;5;217m"
+      end
+    end
+
     def git_migration_authors(migrate_dir)
       output, _status = Railbow::GitUtils.capture2(
         "log", "--format=COMMIT:%aN\t%aE", "--diff-filter=AR", "--name-status", "--", migrate_dir
@@ -304,6 +409,9 @@ module Railbow
 
           RBW_PLAIN=1              Disable Railbow formatting (plain Rails output)
 
+          RBW_FORCE=1              Force Railbow formatting even when piped, in CI,
+                                   or called by an LLM agent (RBW_PLAIN=1 still wins)
+
           RBW_HELP=1               Show this help message
 
         \e[2mAuto-disabled when piped, in CI, or when called by an LLM agent.\e[0m
@@ -428,19 +536,12 @@ module Railbow
         uncommitted_files.each { |f| branch_origins[f] ||= current_branch }
       end
 
-      # Load mighost snapshots for "NO FILE" migrations (if mighost gem is available)
+      # Load mighost ghost data for "NO FILE" migrations (if mighost gem is available)
       mighost_snapshots = {}
       mighost_available = defined?(Mighost::API) && Mighost.enabled?
       if mighost_available
         no_file_versions = db_list.select { |_, _, n| n.include?("NO FILE") }.map { |_, v, _| v.to_s }
-        no_file_versions.each do |v|
-          snapshot = begin
-            Mighost::API.find_or_recover_snapshot(v)
-          rescue
-            nil
-          end
-          mighost_snapshots[v] = snapshot if snapshot&.filename && !snapshot.filename.empty?
-        end
+        mighost_snapshots = load_ghost_rows(no_file_versions, with_content: tables_enabled) if no_file_versions.any?
       end
 
       # Build columns
@@ -501,29 +602,25 @@ module Railbow
         ghost_snapshot = name.include?("NO FILE") ? mighost_snapshots[version.to_s] : nil
         if name.include?("NO FILE") && ghost_snapshot
           ghost_rows << idx
-          # Mighost recovered this ghost migration — show 👻 status + name + branch badge
-          colored_status = "👻"
+          # Mighost recovered this ghost migration — show ghost status + name + badge.
+          # A superseded ghost lives on under another version: stale bookkeeping,
+          # not a lost migration, so it gets a calmer glyph.
+          colored_status = ghost_snapshot.superseded_by ? "🪦" : "👻"
           ghost_name = ghost_snapshot.filename
             .sub(/\A\d+_/, "")    # strip version prefix
             .sub(/\.rb\z/, "")    # strip extension
             .tr("_", " ")
             .gsub(/\b\w/, &:upcase) # titleize
-          if ghost_snapshot.branch_name
-            branch_tag = if ghost_snapshot.respond_to?(:source) && ghost_snapshot.source == "worktree"
-              "\e[38;5;222m⌥ₜ#{ghost_snapshot.branch_name}\e[38;5;217m"
-            else
-              "\e[38;5;222m⌥ #{ghost_snapshot.branch_name}\e[38;5;217m"
-            end
-          end
-          if branch_tag && name_col_width
-            tag_width = formatter.display_width(formatter.strip_ansi(branch_tag))
+          ghost_badge = ghost_tag(ghost_snapshot)
+          if ghost_badge && name_col_width
+            tag_width = formatter.display_width(formatter.strip_ansi(ghost_badge))
             available = name_col_width - tag_width - 2
             ghost_name = formatter.truncate_str(ghost_name, available)
             name_width = formatter.display_width(ghost_name)
             padding = name_col_width - name_width - tag_width
-            display_name = "#{ghost_name}#{" " * [padding, 2].max}#{branch_tag}"
-          elsif branch_tag
-            display_name = "#{ghost_name}  #{branch_tag}"
+            display_name = "#{ghost_name}#{" " * [padding, 2].max}#{ghost_badge}"
+          elsif ghost_badge
+            display_name = "#{ghost_name}  #{ghost_badge}"
           else
             display_name = ghost_name
           end

data/lib/railbow/version.rb

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

data/lib/railbow.rb

@@ -9,8 +9,10 @@ module Railbow
 
   # Returns true when Railbow formatting should be disabled.
   # Checks for explicit opt-out, standard conventions, CI, and LLM agents.
+  # RBW_PLAIN always wins; RBW_FORCE beats every auto-detection below it.
   def self.plain?
     return true if Params.plain?
+    return false if Params.force?
     return true if ENV.key?("NO_COLOR")
     return true if ENV.key?("CLAUDECODE")
     return true if ENV.key?("CI")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railbow
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Eugene M