railbow 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e976b8252fe6a3ad465f8df1ae11fa0bcdca3baaa03883d7aa2c3ff4dc1f073f
-  data.tar.gz: e6e498789b4c15c1932b3a96db8b429a18194336119ad56d5bfeaf9ddb85ca25
+  metadata.gz: 55d44fb326ce90c9bc4e843104639b49c2d96c866401bb53c962f226166bb22f
+  data.tar.gz: 808baadb49bf2e7d96586a1a809501bdbe87cfa454db019d184ca36804cc813a
 SHA512:
-  metadata.gz: 0f1eaa898dfc630a06d9a7515603eb46537ee06ede2d92ac2ba45a0de4ad6413b54d9d0b2c4afa9eb8538ad656e1b94829f828fa4de370cd7cbb4060f8bd2d14
-  data.tar.gz: 0ae1860fe55db53d8b3d9eb47459838101ebb056d8b942dcfe9d7cfc1e2d0201e8e7afccb98896c4f0bf2ec0a450128e0d6fa48bfb710d82d6b0f9437d302260
+  metadata.gz: c256343dee985473f88c27aa26e0bb827587d49001eaf82f7a8d85dbf3a56197d65ba12e3641d64c87cfbcac290a2b787020d1850a53ce0e8fbf746dc2d3ef9e
+  data.tar.gz: 4d5740b3a9a98aa692b7b031fa26a811709c4724c996ee9dfd00f0dfc3f339bf431499c27c3af46b354a7aeb7ae9bd95503f99402b1d5e44f3b1fc6314cd64a1

data/CHANGELOG.md

@@ -5,6 +5,74 @@ 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.4.0] - 2026-07-28
+
+### Added
+
+- `RBW_CALENDAR=wdividers` gives every ISO week its own separator row, the
+  fuller counterpart to `wticks`. A week that opens a new month is left to the
+  month row rather than being announced twice. The default stays `wticks`, so
+  existing output is unchanged until you opt in.
+- `RBW_CALENDAR=counts` appends `· N migrations` to every separator row: how
+  many migrations that section holds, counted up to the next separator.
+- `RBW_CALENDAR=wlabel:<fmt>` sets the strftime pattern for week rows,
+  alongside the existing `label:` for month rows. It defaults to the month
+  pattern, so the week number sits at the same offset on every separator row
+  rather than shifting left when no new month is announced.
+- `railbow demo status` now honors `RBW_CALENDAR`, so the calendar modes can be
+  tried without a Rails project.
+- An empty `RBW_CALENDAR` (month separators, no week markers) is now documented
+  in the help output, the `railbow init` template, and the README. It always
+  worked; nobody could have guessed it.
+
+### Changed
+
+- Calendar separator rows are drawn in a muted purple (256-color 97) instead of
+  the brighter 141, so they frame the migrations without competing with them.
+- Migrations that are not applied (`down`) now render as a greyed-out row in
+  `db:migrate:status`, instead of signalling their state through the status
+  column alone. The row keeps its layout and its status glyph keeps its color;
+  everything else drops its own colors, so pending migrations read as inactive
+  next to the applied ones.
+
+### Fixed
+
+- Rows whose last column wrapped were indented with too wide a blank prefix:
+  building the row mutated the very cell that the wrapped-line indent is
+  measured from. Reachable from `routes`, `about`, and `stats`.
+- A separator label wider than its column no longer pushes the rest of the row
+  sideways. Separator rows are drawn as empty walls with the label laid over
+  them, so a long label spills into the blank space to its right.
+- `RBW_HELP` output for `db:migrate:status` uses plain hyphens instead of
+  em-dashes, matching the rest of the user-facing text.
+
+## [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

data/README.md

@@ -21,7 +21,7 @@
 - **Notes** - `rails notes` with git blame, author colors, date filtering, and sorting
 - **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
+- **Calendar View** - month separators plus week ticks or full week rows, with optional per-section counts
 - **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
 
@@ -105,8 +105,48 @@ Out of the box you get:
 - **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
+- **Pending migrations greyed out** - a `down` row keeps its status glyph but loses its colors
 
-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`.
+#### Weekly view
+
+By default each new ISO week is marked with a tick on the date column
+(`calendar: wticks`). For a fuller weekly breakdown, `wdividers` gives every
+week its own separator row, and `counts` appends how many migrations sit under
+each separator, week or month:
+
+```bash
+RBW_CALENDAR=wdividers,counts rake db:migrate:status
+```
+
+```
+         Feb 2026   W06 · 2 migrations
+ ↑↑    │ 20260202145343 │ 2026-02-02 14:53:43 │ Add weight field to animals          ● animals
+ ↑↑    │ 20260203134528 │ 2026-02-03 13:45:28 │ Create vaccination records           ● vaccination_records
+         Feb 2026   W07 · 1 migration
+ ↑↑    │ 20260210183902 │ 2026-02-10 18:39:02 │ Create pet tags                      ● pet_tags
+         Mar 2026   W10 · 1 migration
+ ↑↑    │ 20260303120000 │ 2026-03-03 12:00:00 │ Add breed restrictions to…           ● adoption_policies
+         Mar 2026   W11 · 1 migration
+ ↑↑    │ 20260313132325 │ 2026-03-13 13:23:25 │ Create veterinary appointm…  ⎇ PS-142  ● veterinary_appointments
+```
+
+Every separator carries the month, so the week number always sits at the same
+offset instead of shifting left on rows that open no new month, and every
+separator is drawn in the same muted purple. Both labels are `strftime`
+patterns: `label:` for months, `wlabel:` for weeks (defaulting to the same
+pattern).
+
+`RBW_CALENDAR` is the list of *week* markers, so an empty value leaves you with
+month separators and nothing else:
+
+```yaml
+view: "calendar,tables"
+calendar: ""            # month separators only
+```
+
+Dropping `calendar` from `view` instead removes the month separators too.
+
+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`
 
@@ -176,11 +216,12 @@ 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 |
 | `RBW_VIEW` | `calendar,tables` | Enable calendar view and table detection |
-| `RBW_CALENDAR` | `wticks` | Show week tick markers |
+| `RBW_CALENDAR` | `wticks`, `wdividers,counts`, `` (empty) | Week markers: tick marks, full week separator rows, per-section counts. Empty means month separators only |
 | `RBW_COMPACT` | `oneline,dense,noheader,maxw:80` | Compact display options |
 | `RBW_VERB` | `GET,POST` | Filter routes by HTTP method |
 | `RBW_SORT` | `file`, `date` | Sort order for notes |
@@ -221,6 +262,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/calendar.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "date"
+
+module Railbow
+  # Turns an ordered list of migration versions into the calendar furniture that
+  # gives the status table its shape: a separator row when the month changes,
+  # optionally one when the ISO week changes, and optionally a tick mark on the
+  # date column at each week boundary.
+  #
+  # A separator introduces the rows beneath it and runs until the next separator,
+  # so the optional count always answers "how many migrations in this section".
+  module Calendar
+    DEFAULT_MONTH_LABEL = "%b %Y   W%V"
+    # Week rows carry the month too, so the week number sits at the same offset
+    # on every separator row rather than jumping left when the month is absent.
+    DEFAULT_WEEK_LABEL = DEFAULT_MONTH_LABEL
+
+    # What the renderer needs to draw the calendar: a label per separator row,
+    # and which rows open a week (for tick marks). Both keyed by row index.
+    class Furniture
+      attr_reader :separators, :tick_rows
+
+      def initialize
+        @separators = {}
+        @tick_rows = Set.new
+      end
+    end
+
+    module_function
+
+    def none
+      Furniture.new
+    end
+
+    def build(versions, weeks: false, ticks: false, counts: false,
+      month_label: DEFAULT_MONTH_LABEL, week_label: DEFAULT_WEEK_LABEL)
+      dates = versions.map { |v| parse_date(v) }
+      furniture = none
+
+      dates.each_with_index do |date, i|
+        prev = (i > 0) ? dates[i - 1] : nil
+        next unless date && prev
+
+        opens_week = week_key(prev) != week_key(date)
+
+        if month_key(prev) != month_key(date)
+          furniture.separators[i] = date.strftime(month_label)
+        elsif weeks && opens_week
+          furniture.separators[i] = date.strftime(week_label)
+        end
+
+        furniture.tick_rows << i if ticks && opens_week
+      end
+
+      append_counts(furniture.separators, dates.size) if counts
+      furniture
+    end
+
+    def parse_date(version)
+      v = version.to_s
+      Date.new(v[0..3].to_i, v[4..5].to_i, v[6..7].to_i)
+    rescue Date::Error
+      nil
+    end
+
+    def month_key(date)
+      [date.year, date.month]
+    end
+
+    # cwyear, not year: the ISO week of Jan 1 can belong to the year before.
+    def week_key(date)
+      [date.cwyear, date.cweek]
+    end
+
+    def append_counts(separators, total)
+      indices = separators.keys.sort
+      indices.each_with_index do |index, nth|
+        section_end = indices[nth + 1] || total
+        separators[index] = "#{separators[index]} · #{migration_count(section_end - index)}"
+      end
+    end
+
+    # Spelled out: a bare number next to a week label reads as part of the date.
+    def migration_count(count)
+      "#{count} #{(count == 1) ? "migration" : "migrations"}"
+    end
+  end
+end

data/lib/railbow/demo/status_demo.rb

@@ -3,7 +3,9 @@
 require "date"
 require_relative "../formatters/base"
 require_relative "../table"
+require_relative "../calendar"
 require_relative "../config"
+require_relative "../params"
 require_relative "fixtures"
 
 module Railbow
@@ -20,7 +22,8 @@ module Railbow
         puts "\n#{formatter.emoji(:status)} Database: #{formatter.cyan("db/development.sqlite3")}"
         puts
 
-        # Use default config: author:me, diff, calendar, tables, wticks, full date
+        # Fixed for the showcase: author:me, diff, tables, full date. The calendar
+        # options below come from the real params, so RBW_CALENDAR still applies.
         date_format = "full"
         tables_enabled = true
         diff_enabled = true
@@ -28,7 +31,7 @@ module Railbow
         git_email = Fixtures::DEMO_USER_EMAIL
         git_name = Fixtures::DEMO_USER_NAME
 
-        # Latest migration date — for "fresh" landed badge detection
+        # Latest migration date - for "fresh" landed badge detection
         latest_version = migrations.last[:version]
         latest_mig_date = parse_version_date(latest_version)
 
@@ -43,7 +46,7 @@ module Railbow
         name_col_width = needs_name_truncation ? 60 : nil
 
         table_columns = [
-          Railbow::Table::Column.new(label: "Status", max_width: 6, sticky: true),
+          Railbow::Table::Column.new(label: "Status", max_width: 6, sticky: true, accent: true),
           Railbow::Table::Column.new(label: "Migration ID", sticky: true),
           Railbow::Table::Column.new(label: "Created At"),
           Railbow::Table::Column.new(label: "Migration Name",
@@ -57,7 +60,9 @@ module Railbow
 
         # Build rows
         highlight_rows = Set.new
+        down_rows = Set.new
         rows = migrations.each_with_index.map do |m, idx|
+          down_rows << idx if m[:status] == "down"
           colored_status = case m[:status]
           when "up" then formatter.green_bold("up")
           when "down" then formatter.yellow_bold("down")
@@ -106,40 +111,16 @@ module Railbow
           [colored_status, m[:version], created_at, display_name, table_tags]
         end
 
-        # Calendar separators
-        separators = {}
-        versions = migrations.map { |m| m[:version] }
-        month_keys = versions.map { |v| v[0..5] }
-        calendar_label_fmt = "%b %Y   W%V"
-
-        if month_keys.uniq.size > 1
-          month_keys.each_with_index do |mk, i|
-            next if i == 0
-            if mk != month_keys[i - 1]
-              v = versions[i]
-              date = Date.new(v[0..3].to_i, v[4..5].to_i, v[6..7].to_i)
-              separators[i] = date.strftime(calendar_label_fmt)
-            end
-          end
-        end
-
-        # Week ticks
-        tick_rows = Set.new
-        prev_week = nil
-        versions.each_with_index do |v, i|
-          y = v[0..3].to_i
-          m = v[4..5].to_i
-          d = v[6..7].to_i
-          next if y == 0 || m == 0 || d == 0
-
-          week = Date.new(y, m, d).cweek
-
-          if i > 0 && prev_week && week != prev_week
-            tick_rows << i
-          end
-
-          prev_week = week
-        end
+        # Calendar furniture. Driven by the real params, so RBW_CALENDAR can be
+        # tried out here without a Rails project.
+        calendar = Railbow::Calendar.build(
+          migrations.map { |m| m[:version] },
+          weeks: Railbow::Params.calendar_wdividers?,
+          ticks: Railbow::Params.calendar_wticks?,
+          counts: Railbow::Params.calendar_counts?,
+          month_label: Railbow::Params.calendar_label,
+          week_label: Railbow::Params.calendar_week_label
+        )
 
         aliases = Railbow::Config.table_aliases
         renderer = Railbow::Table::Renderer.new(
@@ -148,7 +129,10 @@ module Railbow
           compact: {oneline: false, dense: false, noheader: false, maxw: nil, hidden_columns: []},
           aliases: aliases
         )
-        puts renderer.render(rows, separators: separators, highlight_rows: highlight_rows, tick_rows: tick_rows, tick_col: 2)
+        puts renderer.render(rows,
+          separators: calendar.separators,
+          highlight_rows: highlight_rows, dim_rows: down_rows,
+          tick_rows: calendar.tick_rows, tick_col: 2)
       end
 
       private

data/lib/railbow/init.rb

@@ -43,7 +43,13 @@ module Railbow
       # View mode (comma-separated): calendar, tables
       view: "calendar,tables"
 
-      # Calendar options: wticks (show week tick separators)
+      # Calendar options (comma-separated), all require view: calendar.
+      # Leave empty ("") for month separators only, with no week markers.
+      #   wticks       - week tick marks on the date column
+      #   wdividers    - a separator row per ISO week
+      #   counts       - append "· N migrations" to separator rows (per section)
+      #   label:<fmt>  - strftime for month separators (default: %b %Y   W%V)
+      #   wlabel:<fmt> - strftime for week separators (default: same as label)
       calendar: "wticks"
 
       # Date format: full, rel, short, or custom(%b %d, %Y)

data/lib/railbow/params.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "date"
+require_relative "calendar"
 require_relative "config"
 require_relative "name_formatter"
 require_relative "name_collision_resolver"
@@ -71,6 +72,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
@@ -222,8 +227,26 @@ module Railbow
       calendar["wticks"] == true
     end
 
+    # A separator row per ISO week, the fuller counterpart to wticks.
+    def calendar_wdividers?
+      return false unless view_calendar?
+
+      calendar["wdividers"] == true
+    end
+
+    # Append "· N migrations" to every separator row: how many it introduces.
+    def calendar_counts?
+      return false unless view_calendar?
+
+      calendar["counts"] == true
+    end
+
     def calendar_label
-      calendar["label"] || "%b %Y   W%V"
+      calendar["label"] || Calendar::DEFAULT_MONTH_LABEL
+    end
+
+    def calendar_week_label
+      calendar["wlabel"] || Calendar::DEFAULT_WEEK_LABEL
     end
   end
 end

data/lib/railbow/table/column.rb

@@ -3,9 +3,11 @@
 module Railbow
   module Table
     class Column
-      attr_reader :label, :width, :min_width, :max_width, :align, :truncate, :truncate_fn, :sticky
+      attr_reader :label, :width, :min_width, :max_width, :align, :truncate, :truncate_fn, :sticky, :accent
 
-      def initialize(label:, width: :auto, min_width: nil, max_width: nil, align: :left, truncate: false, truncate_fn: nil, sticky: false)
+      # accent: the column carries its own meaning through color (a status
+      # glyph, say), so it keeps that color when the row is dimmed.
+      def initialize(label:, width: :auto, min_width: nil, max_width: nil, align: :left, truncate: false, truncate_fn: nil, sticky: false, accent: false)
         @label = label
         @width = width
         @min_width = min_width
@@ -14,6 +16,7 @@ module Railbow
         @truncate = truncate
         @truncate_fn = truncate_fn
         @sticky = sticky
+        @accent = accent
       end
 
       def fixed?

data/lib/railbow/table/renderer.rb

@@ -10,8 +10,9 @@ module Railbow
 
       RESET = "\e[0m"
       WHITE = "\e[97m"
-      GHOST_BG = "\e[48;5;52m"    # deep red/maroon background — stands out as abnormal
+      GHOST_BG = "\e[48;5;52m"    # deep red/maroon background - stands out as abnormal
       GHOST_FG = "\e[38;5;217m"   # warm pink foreground for contrast
+      DIMMED_FG = "\e[38;5;242m"  # muted grey - a row that is not currently in effect
 
       attr_reader :columns, :theme
 
@@ -23,7 +24,7 @@ module Railbow
         @theme = theme
       end
 
-      def render(rows, separators: {}, highlight_rows: Set.new, ghost_rows: Set.new, tick_rows: Set.new, tick_col: nil)
+      def render(rows, separators: {}, highlight_rows: Set.new, ghost_rows: Set.new, dim_rows: Set.new, tick_rows: Set.new, tick_col: nil)
         return "" if columns.empty?
 
         # Remap rows if columns were hidden
@@ -64,12 +65,11 @@ module Railbow
         rows.each_with_index do |row, i|
           tc = (tick_rows.include?(i) && tick_col) ? tick_col : nil
           if separators.key?(i) && theme.format_separator
-            sep_row = Array.new(columns.size, "")
-            sep_row[1] = theme.format_separator.call(separators[i]) if columns.size > 1
-            lines << render_row(sep_row, resolved, tick_col: tc, tick_cross: true)
+            lines << render_separator_row(separators[i], resolved, tick_col: tc)
             tc = nil # tick already shown on separator row
           end
-          formatted = render_row(row, resolved, tick_col: tc, highlight: highlight_rows.include?(i), ghost: ghost_rows.include?(i))
+          formatted = render_row(row, resolved, tick_col: tc, highlight: highlight_rows.include?(i),
+            ghost: ghost_rows.include?(i), dim: dim_rows.include?(i))
           lines << formatted
         end
         lines.join("\n")
@@ -112,44 +112,65 @@ module Railbow
         }.join(theme.header_col_separator)
       end
 
-      def render_row(row, widths, tick_col: nil, tick_cross: false, highlight: false, ghost: false)
+      # A separator row is furniture, not data: the walls are drawn empty and the
+      # label is laid over them starting at the second column. Writing over the
+      # blanks rather than filling a cell means a label wider than its column
+      # spills into the empty space to its right instead of shifting the row.
+      def render_separator_row(label, widths, tick_col: nil)
+        pad = effective_padding
+        cells = widths.map { |w| "#{pad}#{" " * w}#{pad}" }
+
+        skeleton = cells.first.to_s.dup
+        (1...cells.size).each do |i|
+          skeleton << "#{separator_at(i - 1, tick_col, cross: true)}#{cells[i]}"
+        end
+        return skeleton if cells.size < 2 || label.nil? || label.empty?
+
+        offset = display_width(cells[0]) + display_width(separator_at(0, tick_col, cross: true)) + display_width(pad)
+        tail = skeleton[(offset + display_width(label))..] || ""
+        "#{skeleton[0, offset]}#{theme.format_separator.call(label)}#{tail}"
+      end
+
+      # The separator character between column index and index + 1. Columns
+      # flanking the tick column get the tick variant so the week line reads
+      # as one continuous rule.
+      def separator_at(index, tick_col, cross: false)
+        flanks_tick = tick_col && (index == tick_col - 1 || index == tick_col)
+        return theme.col_separator unless flanks_tick
+
+        cross ? theme.tick_cross_separator : theme.tick_separator
+      end
+
+      def render_row(row, widths, tick_col: nil, highlight: false, ghost: false, dim: false)
         last = columns.size - 1
         pad = effective_padding
-        default_sep = theme.col_separator
-        tick_sep = tick_cross ? theme.tick_cross_separator : theme.tick_separator
 
         prefix_parts = row[0...last].each_with_index.map { |cell, i|
           s = cell.to_s
           cell_w = display_width(strip_ansi(s))
           padding = " " * [widths[i] - cell_w, 0].max
           content = (columns[i].align == :right) ? "#{padding}#{s}" : "#{s}#{padding}"
-          if ghost
-            content = "#{GHOST_BG}#{GHOST_FG}#{content}#{RESET}"
-          elsif highlight
-            content = "#{WHITE}#{content}#{RESET}"
-          end
+          content = style_cell(content, highlight: highlight, ghost: ghost, dim: dim, accent: columns[i].accent)
           "#{pad}#{content}#{RESET}#{pad}"
         }
 
-        # Join prefix parts with per-position separators
-        # Loop index i joins column i-1 and column i (separator_index = i-1)
-        # For tick_col, flanking separator indices are tick_col-1 and tick_col
-        prefix = prefix_parts.first.to_s
+        # Join prefix parts with per-position separators.
+        # Loop index i joins column i-1 and column i (separator index = i-1).
+        # dup: appending to prefix_parts.first itself would corrupt the parts
+        # that render_last_cell measures for the wrapped-line indent.
+        prefix = prefix_parts.first.to_s.dup
         (1...prefix_parts.size).each do |i|
-          sep_idx = i - 1
-          sep = (tick_col && (sep_idx == tick_col - 1 || sep_idx == tick_col)) ? tick_sep : default_sep
-          prefix << "#{sep}#{prefix_parts[i]}"
+          prefix << "#{separator_at(i - 1, tick_col)}#{prefix_parts[i]}"
         end
 
         last_cell_raw = row[last].to_s
 
         # Separator before the last column has index (last - 1)
-        last_sep_idx = last - 1
-        last_sep = (tick_col && (last_sep_idx == tick_col - 1 || last_sep_idx == tick_col)) ? tick_sep : default_sep
-        render_last_cell(prefix, prefix_parts, last_cell_raw, widths, last, col_sep: last_sep, highlight: highlight, ghost: ghost)
+        last_sep = separator_at(last - 1, tick_col)
+        render_last_cell(prefix, prefix_parts, last_cell_raw, widths, last, col_sep: last_sep, highlight: highlight, ghost: ghost, dim: dim)
       end
 
-      def render_last_cell(prefix, prefix_parts, last_cell_raw, widths, last, col_sep: nil, highlight: false, ghost: false)
+      def render_last_cell(prefix, prefix_parts, last_cell_raw, widths, last, col_sep: nil, highlight: false, ghost: false, dim: false)
         pad = effective_padding
         sep = col_sep || theme.col_separator
 
@@ -167,7 +188,7 @@ module Railbow
         if columns[last].truncate_fn && last_col_max &&
             display_width(last_cell_plain) > last_col_max
           last_cell_raw = columns[last].truncate_fn.call(last_cell_raw, last_col_max)
-          last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost)
+          last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost, dim: dim, accent: columns[last].accent)
           return "#{prefix}#{sep}#{pad}#{last_cell_raw}#{RESET}#{pad}"
         end
 
@@ -175,18 +196,18 @@ module Railbow
         if columns[last].truncate && !columns[last].max_width && last_col_max &&
             display_width(last_cell_plain) > last_col_max
           last_cell_raw = truncate_by_words(last_cell_raw, last_col_max)
-          last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost)
+          last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost, dim: dim, accent: columns[last].accent)
           return "#{prefix}#{sep}#{pad}#{last_cell_raw}#{RESET}#{pad}"
         end
 
         # In oneline mode, truncate instead of wrapping
         if @compact[:oneline] && last_col_max && display_width(last_cell_plain) > last_col_max
           last_cell_raw = truncate_by_words(last_cell_raw, last_col_max)
-          last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost)
+          last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost, dim: dim, accent: columns[last].accent)
           return "#{prefix}#{sep}#{pad}#{last_cell_raw}#{RESET}#{pad}"
         end
 
-        last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost)
+        last_cell_raw = style_cell(last_cell_raw, highlight: highlight, ghost: ghost, dim: dim, accent: columns[last].accent)
 
         if last_col_max && display_width(strip_ansi(last_cell_raw)) > last_col_max
           blank_prefix = prefix_parts.map { |part|
@@ -201,9 +222,17 @@ module Railbow
         end
       end
 
-      def style_cell(content, highlight: false, ghost: false)
+      def style_cell(content, highlight: false, ghost: false, dim: false, accent: false)
         if ghost
           "#{GHOST_BG}#{GHOST_FG}#{content}#{RESET}"
+        elsif dim
+          # An accent column keeps its color - on a dimmed row it is the one
+          # cell still carrying meaning. Everything else drops its own colors:
+          # one flat grey is what reads as "not in effect", and the resets that
+          # end each inner color would break the grey run anyway.
+          return content if accent
+
+          "#{DIMMED_FG}#{strip_ansi(content)}#{RESET}"
         elsif highlight
           "#{WHITE}#{content}#{RESET}"
         else
@@ -315,7 +344,7 @@ module Railbow
             current << token
             current_width += token_width
           elsif current_width.zero?
-            # Single token wider than max — try to break on underscores
+            # Single token wider than max - try to break on underscores
             broken = break_long_token(token, max_width)
             lines.concat(broken[0...-1])
             current = +broken.last

data/lib/railbow/table/theme.rb

@@ -8,7 +8,8 @@ module Railbow
         :format_header_cell, :format_separator
 
       def initialize(col_separator:, header_col_separator:, cell_padding:,
-        format_header_cell:, format_separator: nil, tick_separator: nil, tick_cross_separator: nil)
+        format_header_cell:, format_separator: nil,
+        tick_separator: nil, tick_cross_separator: nil)
         @col_separator = col_separator
         @tick_separator = tick_separator || col_separator
         @tick_cross_separator = tick_cross_separator || @tick_separator
@@ -23,7 +24,7 @@ module Railbow
       RESET = "\e[0m"
       BOLD = "\e[1m"
       WHITE = "\e[97m"
-      PURPLE = "\e[38;5;141m"
+      PURPLE = "\e[38;5;97m" # separator rows: present, but never louder than the data
       BG_PURPLE = "\e[48;5;99m"
       DIM = "\e[2m"
 

data/lib/railbow/tasks/migrate_status.rake

@@ -6,14 +6,120 @@ require_relative "../formatters/base"
 require_relative "../migration_parser"
 require_relative "../config"
 require_relative "../table"
+require_relative "../calendar"
 require_relative "../logo"
 
 # Override DatabaseTasks.migrate_status which is called by both
 # 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
@@ -165,7 +271,7 @@ module Railbow
         # 1. Filter out child branches: if branch A is an ancestor of branch B,
         #    the commit was introduced in A, not B.
         # 2. Among remaining, prefer the branch with the MOST commits after the
-        #    adding commit — it has been active longer since the commit was made,
+        #    adding commit - it has been active longer since the commit was made,
         #    indicating it is the original branch (not a newer fork).
         best = if branches.size == 1
           branches.first
@@ -271,39 +377,50 @@ module Railbow
                                    Units: d (days), w (weeks), mo/m (months), y (years)
 
           RBW_DATE=<mode>          Date column format (default: full):
-                                   full       — 2026-01-30 12:08:54 (column: Created At)
-                                   rel        — ~3d ago
-                                   short      — Jan 30 (column: Date)
-                                   custom(…)  — user strftime, e.g. custom(%b %d, %Y)
+                                   full       - 2026-01-30 12:08:54 (column: Created At)
+                                   rel        - ~3d ago
+                                   short      - Jan 30 (column: Date)
+                                   custom(…)  - user strftime, e.g. custom(%b %d, %Y)
 
           RBW_VIEW=<options>       Display options (comma-separated):
-                                   calendar   — show month/year separator lines + week ticks
-                                   tables     — parse migration files, show Tables column
+                                   calendar   - show month/year separator lines + week ticks
+                                   tables     - parse migration files, show Tables column
 
           RBW_COMPACT=<options>    Compact display (comma-separated):
-                                   oneline    — truncate instead of wrapping
-                                   dense      — remove cell padding
-                                   noheader   — hide table header row
-                                   maxw:<n>   — cap column widths at n chars
-                                   hide:<col> — hide a column by name (repeatable)
-
-          RBW_CALENDAR=<options>  Calendar sub-options (requires RBW_VIEW=calendar):
-                                   wticks     — show week tick marks on date column
-                                   label:<fmt> — strftime format for month separator
-                                                (default: %b %Y   W%V)
+                                   oneline    - truncate instead of wrapping
+                                   dense      - remove cell padding
+                                   noheader   - hide table header row
+                                   maxw:<n>   - cap column widths at n chars
+                                   hide:<col> - hide a column by name (repeatable)
+
+          RBW_CALENDAR=<options>   Calendar sub-options (requires RBW_VIEW=calendar):
+                                   (empty)      - month separators only, no week
+                                                  markers at all
+                                   wticks       - week tick marks on the date column
+                                   wdividers    - a separator row per ISO week
+                                   counts       - append "· N migrations" to every
+                                                  separator row (that section)
+                                   label:<fmt>  - strftime for month separators
+                                                  (default: %b %Y   W%V)
+                                   wlabel:<fmt> - strftime for week separators
+                                                  (default: same as label, so the
+                                                  week number never shifts)
 
           RBW_GIT=<options>        Git integration (comma-separated):
-                                   author     — add an Author column (same as author:all)
-                                   author:all — add an Author column
-                                   author:me  — highlight your own migrations
-                                   diff       — tag migrations by git origin
-                                   base:<branch> — base branch for diff (default: auto-detected)
-                                   mask:<re>  — regex to extract branch label
+                                   author     - add an Author column (same as author:all)
+                                   author:all - add an Author column
+                                   author:me  - highlight your own migrations
+                                   diff       - tag migrations by git origin
+                                   base:<branch> - base branch for diff (default: auto-detected)
+                                   mask:<re>  - regex to extract branch label
                                                 e.g. mask:(WS-[^/]+)/
-                                   mask:auto  — auto-extract ticket id from branch name
+                                   mask:auto  - auto-extract ticket id from branch name
 
           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
@@ -311,6 +428,7 @@ module Railbow
         \e[1mExamples:\e[0m
           rake db:migrate:status
           RBW_SINCE=2mo RBW_VIEW=calendar rake db:migrate:status
+          RBW_CALENDAR=wdividers,counts rake db:migrate:status
           RBW_VIEW=tables RBW_GIT=author rake db:migrate:status
           RBW_GIT=author:me RBW_SINCE=3mo rake db:migrate:status
           RBW_DATE=rel rake db:migrate:status
@@ -373,7 +491,7 @@ module Railbow
 
         skipped = total_count - db_list.size
         if skipped > 0
-          puts formatter.dim("  (#{skipped} older migrations hidden — SINCE=#{since_value})")
+          puts formatter.dim("  (#{skipped} older migrations hidden - SINCE=#{since_value})")
           puts
         end
       end
@@ -428,23 +546,16 @@ 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
-      # Latest migration ID date — used to determine "fresh" landed badges
+      # Latest migration ID date - used to determine "fresh" landed badges
       latest_version = db_list.last&.dig(1).to_s
       latest_mig_date = begin
         Date.new(latest_version[0..3].to_i, latest_version[4..5].to_i, latest_version[6..7].to_i)
@@ -464,7 +575,7 @@ module Railbow
       needs_name_truncation = tables_enabled || author_mode == "all" || diff_enabled || has_landed_tags
       name_col_width = needs_name_truncation ? 60 : nil
       table_columns = [
-        Railbow::Table::Column.new(label: "Status", max_width: 6, sticky: true),
+        Railbow::Table::Column.new(label: "Status", max_width: 6, sticky: true, accent: true),
         Railbow::Table::Column.new(label: "Migration ID", sticky: true),
         Railbow::Table::Column.new(label: (date_format == "full") ? "Created At" : "Date"),
         Railbow::Table::Column.new(label: "Migration Name",
@@ -489,10 +600,14 @@ module Railbow
         {}
       end
 
-      # Build rows and track highlight/ghost indices
+      # Build rows and track highlight/ghost/down indices
       highlight_rows = Set.new
       ghost_rows = Set.new
+      down_rows = Set.new
       rows = db_list.each_with_index.map do |(status, version, name), idx|
+        # A pending migration is not in effect yet: grey the whole row out so it
+        # reads as inactive next to the applied ones.
+        down_rows << idx if status == "down"
         colored_status = case status
         when "up" then formatter.green_bold("up")
         when "down" then formatter.yellow_bold("down")
@@ -501,29 +616,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
@@ -604,7 +715,7 @@ module Railbow
             filepath = version_to_file[version.to_s]
             basename = filepath ? File.basename(filepath) : nil
 
-            # Uncommitted migrations have no git author — treat them as mine.
+            # Uncommitted migrations have no git author - treat them as mine.
             # Match by email first; fall back to author name to handle cases where
             # the commit email differs from git config (e.g. GitHub noreply emails
             # after squash-merge, or mailmap rewrites).
@@ -639,44 +750,18 @@ module Railbow
         row
       end
 
-      # Calendar separators
-      separators = {}
-      if calendar_enabled
-        versions = db_list.map { |_, v, _| v.to_s }
-        month_keys = versions.map { |v| v[0..5] }
-        calendar_label_fmt = Railbow::Params.calendar_label
-
-        if month_keys.uniq.size > 1
-          month_keys.each_with_index do |mk, i|
-            next if i == 0
-            if mk != month_keys[i - 1]
-              v = versions[i]
-              date = Date.new(v[0..3].to_i, v[4..5].to_i, v[6..7].to_i)
-              separators[i] = date.strftime(calendar_label_fmt)
-            end
-          end
-        end
-      end
-
-      # Week tick separators: mark first row of each new ISO week
-      tick_rows = Set.new
-      if ticks_enabled
-        versions = db_list.map { |_, v, _| v.to_s }
-        prev_week = nil
-        versions.each_with_index do |v, i|
-          y = v[0..3].to_i
-          m = v[4..5].to_i
-          d = v[6..7].to_i
-          next if y == 0 || m == 0 || d == 0
-
-          week = Date.new(y, m, d).cweek
-
-          if i > 0 && prev_week && week != prev_week
-            tick_rows << i
-          end
-
-          prev_week = week
-        end
+      # Calendar furniture: month separators, week separators, week ticks
+      calendar = if calendar_enabled
+        Railbow::Calendar.build(
+          db_list.map { |_, v, _| v.to_s },
+          weeks: Railbow::Params.calendar_wdividers?,
+          ticks: ticks_enabled,
+          counts: Railbow::Params.calendar_counts?,
+          month_label: Railbow::Params.calendar_label,
+          week_label: Railbow::Params.calendar_week_label
+        )
+      else
+        Railbow::Calendar.none
       end
 
       renderer = Railbow::Table::Renderer.new(
@@ -686,7 +771,10 @@ module Railbow
         aliases: Railbow::Config.table_aliases
       )
       tick_col = 2 # Date column index
-      puts renderer.render(rows, separators: separators, highlight_rows: highlight_rows, ghost_rows: ghost_rows, tick_rows: tick_rows, tick_col: tick_col)
+      puts renderer.render(rows,
+        separators: calendar.separators,
+        highlight_rows: highlight_rows, ghost_rows: ghost_rows, dim_rows: down_rows,
+        tick_rows: calendar.tick_rows, tick_col: tick_col)
     end
   end
 end

data/lib/railbow/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Railbow
-  VERSION = "0.2.0"
+  VERSION = "0.4.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.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Eugene M
@@ -78,6 +78,7 @@ files:
 - exe/railbow
 - lib/railbow.rb
 - lib/railbow/about_formatter.rb
+- lib/railbow/calendar.rb
 - lib/railbow/color_assigner.rb
 - lib/railbow/config.rb
 - lib/railbow/demo/fixtures.rb