railbow 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 783c8ab9f75f889cd1c54cd36dbc258e06b411b9ae5132af6815564f83d73312
-  data.tar.gz: 1200e9edbd432786044d0ac0992773de513390e787500eecd48dc745a473da4e
+  metadata.gz: e976b8252fe6a3ad465f8df1ae11fa0bcdca3baaa03883d7aa2c3ff4dc1f073f
+  data.tar.gz: e6e498789b4c15c1932b3a96db8b429a18194336119ad56d5bfeaf9ddb85ca25
 SHA512:
-  metadata.gz: be4c900efd96d11e1d896eb0facd145a928fc93b2b08d30b02cf14a3638e0cf5f133f0c929d037cf828cb3862387ad63725cbbc1cdad4fb84afa353b77ef32fe
-  data.tar.gz: 5231639b5beaefce4ee54e9d0e81b0309d8370b66e4cb7ca9a0e496ad64d0bebcd8b8a69458fe056789947a216e6b6cbdd3c8ad0fb442ddfebf38d25cbf196b8
+  metadata.gz: 0f1eaa898dfc630a06d9a7515603eb46537ee06ede2d92ac2ba45a0de4ad6413b54d9d0b2c4afa9eb8538ad656e1b94829f828fa4de370cd7cbb4060f8bd2d14
+  data.tar.gz: 0ae1860fe55db53d8b3d9eb47459838101ebb056d8b942dcfe9d7cfc1e2d0201e8e7afccb98896c4f0bf2ec0a450128e0d6fa48bfb710d82d6b0f9437d302260

data/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.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 and origin branch instead of a bare `********** NO FILE **********` row - Railbow talks to it through the stable `Mighost::API`.
 
 ### `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
 
@@ -207,7 +207,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

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/version.rb

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

metadata

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