railbow 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c42f0f6d8162662344a6ef8fb12388e8dd6a2a579384cab3829a85d806cb1571
-  data.tar.gz: 064fb908f8cd7567e9d8be53800e6972aa48faf65348aff7338c6088aa7427dd
+  metadata.gz: 55d44fb326ce90c9bc4e843104639b49c2d96c866401bb53c962f226166bb22f
+  data.tar.gz: 808baadb49bf2e7d96586a1a809501bdbe87cfa454db019d184ca36804cc813a
 SHA512:
-  metadata.gz: f7af392359a26db27919f6bac5d31ce22d6736615bbbe8d514c794e5114a2a71ff61081160340a3177fd4b172207b8c07ae2948fcfdaeaccbc0498b28370fb1c
-  data.tar.gz: e5a9364c62c93fa530cbde3222c2249b3f251043514fda4d4cf51a33cfaf27ad54bffed5d5abae43befe065634faee0d96ec60581adc22004cd45790e7f87534
+  metadata.gz: c256343dee985473f88c27aa26e0bb827587d49001eaf82f7a8d85dbf3a56197d65ba12e3641d64c87cfbcac290a2b787020d1850a53ce0e8fbf746dc2d3ef9e
+  data.tar.gz: 4d5740b3a9a98aa692b7b031fa26a811709c4724c996ee9dfd00f0dfc3f339bf431499c27c3af46b354a7aeb7ae9bd95503f99402b1d5e44f3b1fc6314cd64a1

data/CHANGELOG.md

@@ -5,6 +5,47 @@ 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

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,6 +105,46 @@ 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
+
+#### 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`.
 
@@ -181,7 +221,7 @@ Every option can also be set via `RBW_*` environment variables, which override c
 | `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 |

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"
@@ -226,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,6 +6,7 @@ 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
@@ -270,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
@@ -376,36 +377,44 @@ 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)
 
@@ -419,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
@@ -481,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
@@ -545,7 +555,7 @@ module Railbow
       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)
@@ -565,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",
@@ -590,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")
@@ -602,7 +616,7 @@ 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 ghost status + name + badge.
+          # 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 ? "🪦" : "👻"
@@ -701,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).
@@ -736,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(
@@ -783,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.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railbow
 version: !ruby/object:Gem::Version
-  version: 0.3.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