railbow 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61c0c3ed9ad2e0c2218e9f2b5e69f6eecec3253a82722408649e91b2822873be
-  data.tar.gz: 2179f41a4dfd77f4630940ce0280130a612d75202faede974611c27b0729058d
+  metadata.gz: cdfe578f284175c30e3b9f4c77a83f62b8e63b8019e575590f8ad471e5639efb
+  data.tar.gz: 5874946340d18626a566b0190f734f6a94a55a3d40dfb0777760ab377b9d295d
 SHA512:
-  metadata.gz: c777b8cf30ac567ba71c6cc16f16e7f6bbfdc604d8fa1b161cafc17879cea825b446e02f72e43fa9f383d03752c2506a6653c951928302b6d290b689f5a4fa39
-  data.tar.gz: 87b8b0d21c779637d0f6c9c20271bec519677feda8d790cadd9644a33413d352550b6a883a96da0774bb7009f9f2667b55d9e23a670800684bbf824b58607b78
+  metadata.gz: 3fc62787e1bfd0913be00ca297c5c9210a312b067c68960c13699298a3a064e396a20bc952e65544d19059a03c02454c99413b8f59fd84e6890d9145e8ba03c1
+  data.tar.gz: e2253cf2117f5ed4a6702f9500774789d05007876f09ad043b014f9e7b0d53f9616ea21fc32247463081e131aa533b2bf149cb65be99f8f08b37478a281e22ee

data/CHANGELOG.md

@@ -5,6 +5,84 @@ 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.7.0] - 2026-10-09
+
+### Added
+
+- `RBW_TZ` (or `tz:` in `.railbow.yml`) picks the timezone railbow shows
+  dates in: `local` (the default), `utc`, or any zone Rails knows, such as
+  `America/New_York`. It covers the `db:migrate:status` date column, calendar
+  separators and landed badges, `rails notes` blame dates, the `rails about`
+  schema version, and where `RBW_SINCE` windows start.
+- A railbow bug no longer breaks the command it decorates. If rendering
+  raises, railbow prints a one-line `railbow:` warning to stderr and falls back
+  to the stock Rails output for `rails about`, `rails stats`, `rails notes`,
+  `rails routes`, migrations and `db:migrate:status` (including multi-database
+  runs), then stays plain for the rest of the process. A migration body is
+  never re-run by the fallback.
+
+### Changed
+
+- Dates in `db:migrate:status` (and calendar separators) are now shown in
+  local time. They used to repeat the UTC digits of the Migration ID, so on a
+  machine outside UTC the column shifts by the UTC offset. Set `tz: utc` (or
+  `RBW_TZ=utc`) for the previous display.
+- `rails about` now says something the stock output does not. The environment
+  is colored (production in bold red, development green, anything else
+  yellow), the database schema version shows its time and age, version
+  numbers share one accent color, the application root steps back, and list
+  values such as Middleware get a line per item. The Rails title line is kept,
+  and the old "Property / Value" header row is gone.
+- `rails stats` is redrawn in the `db:migrate:status` table style: code and
+  test directories under their own headings, thousands grouped, zeros dimmed,
+  M/C and LOC/M dimmed for tests, a bar for each directory's share of all LOC,
+  and a bold Total row. Directories registered by other gems (such as
+  rspec-rails) are included.
+- The default `since` window is now 90 days (was 70), close to three months.
+  Set `since: 70d` (or `RBW_SINCE=70d`) to keep the old window.
+
+### Fixed
+
+- `rails routes` no longer leaves a blank line before every piece of a wrapped
+  route name when the other columns nearly fill the terminal. A group too wide
+  for the terminal drops its Prefix column, and a table never wraps its last
+  column into lines that would run past the edge: the value stays on its row.
+- `RBW_DATE=rel` ages are no longer off by the machine's UTC offset.
+  Migration IDs are UTC timestamps but were read as local time.
+- `rails about` no longer crashes with `uninitialized class variable
+  @@properties in Railbow::AboutFormatter`.
+- `rails stats` is formatted again. Since Rails 8.0 it is a Rails command
+  that never loads rake tasks, so railbow's hook never ran, and on every Rails
+  version the formatter read the wrong data and printed nothing of its own.
+  On Rails 7.2 and 8.0, `rake stats` no longer risks running railbow's
+  Rails 8.1 replacement task next to the stock one.
+- `rails notes` no longer prints `fatal: no such path ... in HEAD` for notes
+  in untracked or gitignored files (such as `app/assets/builds`), and no
+  longer hides those notes as older than the `since` window. They are dated
+  as uncommitted, the way `git blame` dates uncommitted lines, and with
+  `RBW_GIT=author` they show dim dashes in the author column instead of git's
+  "Not Committed Yet" squeezed into a name like "No Y".
+
+## [0.6.2] - 2026-09-21
+
+### Changed
+
+- Demo fixtures, README examples and spec data now use the PawShop sample
+  project throughout.
+
+## [0.6.1] - 2026-08-10
+
+### Fixed
+
+- On a narrow terminal, a migration's branch and landing badges no longer
+  vanish from the `db:migrate:status` name column, leaving a stray `...`
+  hanging in the padding where they used to sit. The badges are padded flush
+  against the right edge of the column, which is exactly where the width
+  budget was cutting; the name now gives up the space instead and the badges
+  stay put. When a badge is so wide that keeping it would leave under 12
+  columns for the name, it is dropped outright rather than squeezing the name
+  down to nothing.
+
 ## [0.6.0] - 2026-08-03
 
 ### Fixed

data/README.md

@@ -19,7 +19,7 @@
 - **Routes** - color-coded HTTP verbs and highlighted parameters in `rails routes`
 - **Stats** - beautiful `rails stats` tables
 - **Notes** - `rails notes` with git blame, author colors, date filtering, and sorting
-- **About** - polished `rails about` output
+- **About** - `rails about` with the environment color-coded (production in red) and the schema version shown as a date and age
 - **Git Integration** - authors, diffs, branch origin, landing dates, uncommitted file indicators
 - **Calendar View** - month separators plus week ticks or full week rows, with optional per-section counts
 - **Multiple Databases** - read one table by default, the rest summarized in a line each (and expanded when they have migrations pending); sharded databases merged with a status per shard
@@ -104,7 +104,7 @@ Out of the box you get:
 - **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`), as a soft limit: never fewer than 10 migrations, however old (`since_min: 10`)
+- **Time filtering** - only the last 90 days shown by default (`since: 90d`), as a soft limit: never fewer than 10 migrations, however old (`since_min: 10`)
 - **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
 
@@ -158,13 +158,13 @@ By default you read one table: the first database in `database.yml` is rendered
 in full and every other one is summarized in a line each (`db: focus`).
 
 ```
-📊 2 databases · primary, raw
+📊 2 databases · primary, log
 
-──── primary · myapp_development ──── 122 of 1500 ──────────────────────
- ↑↑  │ 20260721130000 │ 2026-07-21 13:00:00 │ Partition sms notifications  ● sms_notifications
- ↓↓  │ 20260727170000 │ 2026-07-27 17:00:00 │ Add cr push columns to lines ● lines
+──── primary · myapp_development ──── 12 of 240 ────────────────────────
+ ↑↑  │ 20260721130000 │ 2026-07-21 13:00:00 │ Partition visit reminders    ● visit_reminders
+ ↓↓  │ 20260727170000 │ 2026-07-27 17:00:00 │ Add microchip ids to animals ● animals
 
-⋯ raw · 5 migrations, all applied · latest Jul 22 2026
+⋯ log · 5 migrations, all applied · latest Jul 22 2026
 ```
 
 **A database with migrations pending is always expanded**, however focused the
@@ -179,14 +179,14 @@ db: ""            # or RBW_DB= on the command line
 ```
 
 ```
-──── primary · myapp_development ──── 122 of 1500 ──────────────────────
- ↑↑  │ 20260721130000 │ 2026-07-21 13:00:00 │ Partition sms notifications  ● sms_notifications
+──── primary · myapp_development ──── 12 of 240 ────────────────────────
+ ↑↑  │ 20260721130000 │ 2026-07-21 13:00:00 │ Partition visit reminders    ● visit_reminders
 
-──── raw · raw_development ─────────────────────────────────────────────
- ↑↑  │ 20260722120000 │ 2026-07-22 12:00:00 │ Drop archived activity logs  ● archived_activity_logs
+──── log · log_development ─────────────────────────────────────────────
+ ↑↑  │ 20260722120000 │ 2026-07-22 12:00:00 │ Drop archived visit logs     ● archived_visit_logs
 ```
 
-A section header counts what it is showing: `122 of 1500` means 122 fell inside
+A section header counts what it is showing: `12 of 240` means 12 fell inside
 the time window. When the window found too few and the `since_min` floor topped
 the section back up, it reads `last 10 of 50` instead, because the rows are
 then the newest ten rather than a window's worth.
@@ -197,7 +197,7 @@ rather than an empty table, which is what keeps the `cache`, `queue` and
 
 ```
 ⋯ cache · 5 migrations, all applied · latest Feb 12 2024
-⋯ queue · 12 migrations, 3 pending outside the 70d window - RBW_SINCE=all
+⋯ queue · 12 migrations, 3 pending outside the 90d window - RBW_SINCE=all
 ```
 
 Databases that share a `migrations_paths` (horizontal sharding) run the same
@@ -236,7 +236,21 @@ HTTP verbs are color-coded (GET=green, POST=yellow, PATCH/PUT=cyan, DELETE=red),
 
 ### `rails stats`
 
-Code statistics rendered as a colorful table with highlighted totals and code-to-test ratio.
+Code statistics in the same table style as `db:migrate:status`, code and tests grouped, with each directory's share of all LOC:
+
+```
+ Name          Lines     LOC       Classes   Methods   M/C   LOC/M   Share of LOC
+ Code        │         │         │         │         │     │       │
+ Controllers │  57,143 │  42,693 │     212 │   3,472 │  16 │    10 │ █████████▊       22.0%
+ Models      │  76,529 │  48,353 │     302 │   4,819 │  15 │     8 │ ███████████      24.9%
+ Views       │  98,412 │  70,120 │       0 │       0 │   0 │     0 │ ████████████████ 36.1%
+ Tests       │         │         │         │         │     │       │
+ Model specs │  40,210 │  33,000 │       0 │     120 │   0 │   273 │ ███████▌         17.0%
+             │         │         │         │         │     │       │
+ Total       │ 272,294 │ 194,166 │     514 │   8,411 │  16 │    21 │
+
+  Code 161,166 LOC   ·   Tests 33,000 LOC   ·   Code to Test Ratio 1:0.2
+```
 
 ### `rails notes`
 
@@ -266,7 +280,7 @@ rake railbow:init
 ### Example `.railbow.yml`
 
 ```yaml
-since: 70d
+since: 90d
 since_min: 10
 date: rel
 git: "author:me,diff,mask:auto"
@@ -293,9 +307,10 @@ Every option can also be set via `RBW_*` environment variables, which override c
 |---|---|---|
 | `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_SINCE` | `2mo`, `90d`, `1y`, `all` | Filter migrations by time period |
 | `RBW_SINCE_MIN` | `10`, `0` | Never show fewer than this many migrations, however old (default 10; `0` disables) |
 | `RBW_DATE` | `full`, `rel`, `short`, `custom(%b %d)` | Date display format |
+| `RBW_TZ` | `local` (default), `utc`, `America/New_York` | Timezone dates are shown in. Migration IDs are UTC; this picks the clock they are displayed on |
 | `RBW_GIT` | `author:me,diff,mask:auto` | Git integration options |
 | `RBW_VIEW` | `calendar,tables` | Enable calendar view and table detection |
 | `RBW_CALENDAR` | `wticks`, `wdividers,counts`, `` (empty) | Week markers: tick marks, full week separator rows, per-section counts. Empty means month separators only |
@@ -344,6 +359,11 @@ Formatting auto-disables when:
 formatted output to a file, or letting an agent inspect the real rendering).
 An explicit `RBW_PLAIN=1` always wins over `RBW_FORCE`.
 
+If railbow itself hits an error while rendering, the command still works: it
+prints a one-line `railbow:` warning to stderr naming the error, then shows the
+stock Rails output and stays plain for the rest of the run. Migrations are never
+re-run by this; only their output falls back.
+
 ## Requirements
 
 - Ruby >= 3.1.0
@@ -357,6 +377,10 @@ bundle exec rake   # Run tests + linting (RSpec + Standard)
 bin/console        # Interactive prompt
 ```
 
+To see a change in a real app (one that loads this checkout), set `RBW_APP` to
+its path, then `just shot "rails routes"` saves a PNG and
+`just cast "rails routes" 100` a scrolling GIF at 100 columns, in `tmp/shots/`.
+
 ## Contributing
 
 Bug reports and pull requests are welcome at [github.com/amberpixels/railbow](https://github.com/amberpixels/railbow).

data/lib/railbow/about_formatter.rb

@@ -1,37 +1,73 @@
 # frozen_string_literal: true
 
 require_relative "formatters/base"
-require_relative "config"
-require_relative "table"
 
 module Railbow
   module AboutFormatter
+    TITLE = "About your application's environment"
+
     def to_s
       return super if Railbow.plain?
 
-      formatter = Formatters::Base.new
+      Railbow.guard(-> { super }) { railbow_to_s }
+    end
+
+    private
+
+    # Same shape as Rails' own listing (title, then one aligned row per
+    # property), with the values styled by what they mean. Properties other
+    # gems register render as plain text.
+    def railbow_to_s
+      f = Formatters::Base.new
+      width = properties.map { |(name, _)| name.length }.max.to_i
+      lines = [f.bold(TITLE)]
 
-      columns = [
-        Table::Column.new(label: "Property", sticky: true),
-        Table::Column.new(label: "Value")
-      ]
+      properties.each do |(name, value)|
+        # Lists such as Middleware get a line per item instead of one long run.
+        values = Array(value).map { |v| railbow_style_value(f, name, v.to_s) }
+        lines << "#{f.bold(name.ljust(width))}   #{values.first}"
+        values.drop(1).each { |v| lines << "#{" " * width}   #{v}" }
+      end
+
+      lines.join("\n")
+    end
 
-      rows = @@properties.map do |(name, value)|
-        val = value.respond_to?(:call) ? value.call : value
-        [formatter.bold(name), val.to_s]
+    def railbow_style_value(f, name, value)
+      case name
+      when "Environment" then railbow_style_environment(f, value)
+      when "Application root" then f.dim(value)
+      when "Database schema version" then railbow_style_schema_version(f, value)
+      when /version\z/i then railbow_style_version(f, value)
+      else value
       end
+    end
+
+    # Production is the one environment worth a jolt.
+    def railbow_style_environment(f, value)
+      case value
+      when "production" then f.bold(f.red(value))
+      when "development" then f.green(value)
+      else f.yellow(value)
+      end
+    end
+
+    # The version number takes the accent; anything trailing it, like Ruby's
+    # build date and platform, steps back.
+    def railbow_style_version(f, value)
+      match = value.match(/\d+(?:\.\w+)+/)
+      return value unless match
+
+      tail = match.post_match.empty? ? "" : f.dim(match.post_match)
+      "#{match.pre_match}#{f.cyan(match[0])}#{tail}"
+    end
+
+    # Shown on railbow's clock (RBW_TZ), with the zone named because the
+    # digits of the version itself are UTC.
+    def railbow_style_schema_version(f, value)
+      time = Railbow::Clock.from_version(value)
+      return value unless time
 
-      renderer = Table::Renderer.new(
-        columns: columns,
-        theme: Table::Themes::PLAIN,
-        compact: Railbow::Params.compact_options,
-        aliases: Railbow::Config.table_aliases
-      )
-
-      output = +"\n"
-      output << renderer.render(rows)
-      output << "\n"
-      output
+      "#{f.cyan(value)}  #{f.dim("(#{time.strftime("%Y-%m-%d %H:%M %Z")}, #{f.format_relative_time_from(time)})")}"
     end
   end
 end

data/lib/railbow/calendar.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "date"
+require_relative "clock"
 
 module Railbow
   # Turns an ordered list of migration versions into the calendar furniture that
@@ -58,10 +59,7 @@ module Railbow
     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
+      Railbow::Clock.from_version(version)&.to_date
     end
 
     def month_key(date)

data/lib/railbow/clock.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require "date"
+
+module Railbow
+  # The clock railbow shows times on. Migration IDs and git dates are fixed
+  # moments; RBW_TZ (or `tz:` in .railbow.yml) only picks the zone they are
+  # shown in: "local" (the default), "utc", or any zone name Rails accepts,
+  # e.g. "America/New_York" or "Eastern Time (US & Canada)".
+  module Clock
+    @zones = {}
+
+    module_function
+
+    # A migration ID is the UTC time the migration was generated, which is
+    # how Rails names them. Returns nil for anything that is not one.
+    def from_version(version)
+      v = version.to_s
+      return nil unless v.match?(/\A\d{14}\z/)
+
+      utc = Time.utc(
+        v[0..3].to_i, v[4..5].to_i, v[6..7].to_i,
+        v[8..9].to_i, v[10..11].to_i, v[12..13].to_i
+      )
+      in_zone(utc)
+    rescue ArgumentError
+      nil
+    end
+
+    def in_zone(time)
+      case (z = zone)
+      when :local then time.getlocal
+      when :utc then time.getutc
+      else time.in_time_zone(z)
+      end
+    end
+
+    def today
+      in_zone(Time.now).to_date
+    end
+
+    # The migration ID of the midnight that starts date on this clock, so a
+    # day-based window can be compared against migration IDs directly.
+    def version_at(date)
+      start = case (z = zone)
+      when :local then Time.local(date.year, date.month, date.day)
+      when :utc then Time.utc(date.year, date.month, date.day)
+      else z.local(date.year, date.month, date.day)
+      end
+      start.utc.strftime("%Y%m%d%H%M%S")
+    end
+
+    def zone
+      name = Params.tz
+      @zones[name] ||= resolve(name)
+    end
+
+    def resolve(name)
+      case name.downcase
+      when "local" then :local
+      when "utc" then :utc
+      else
+        require "active_support"
+        require "active_support/time"
+        ActiveSupport::TimeZone[name] || begin
+          warn "  Warning: unrecognized RBW_TZ=#{name}, showing local time"
+          :local
+        end
+      end
+    end
+  end
+end

data/lib/railbow/color_assigner.rb

@@ -1,22 +1,17 @@
 # frozen_string_literal: true
 
 module Railbow
-  # Assigns maximally-spaced colors to a set of unique labels.
+  # Spreads a set of labels evenly around the color wheel by rank. Hashing
+  # into a palette could land two labels on neighboring colors; by rank, two
+  # labels sit opposite each other, three about 120 deg apart, and so on.
   #
-  # Instead of hashing into a fixed palette (where two labels can collide
-  # onto adjacent colors), this assigns colors by rank — evenly spacing
-  # hues around the color wheel. Two labels always get maximally different
-  # colors, three labels get ~120 deg apart, etc.
-  #
-  # Usage:
   #   assigner = Railbow::ColorAssigner.new(["Alice", "Bob", "Carol"])
   #   assigner.color_for("Alice")  # => "\e[38;5;174m"
   #   assigner.code_for("Bob")     # => 116  (256-color code)
   #
   class ColorAssigner
-    # Soft/muted 256-color codes arranged around the hue wheel.
-    # 12 stops, evenly spaced in hue, all at moderate saturation/lightness
-    # so they look pleasant on dark terminals.
+    # Muted 256-color codes in hue order, at moderate saturation and
+    # lightness so they sit well on dark terminals.
     WHEEL = [
       174, # 0°   coral / muted rose
       216, # 30°  peach
@@ -39,13 +34,12 @@ module Railbow
       end
     end
 
-    # Returns the 256-color ANSI escape for the given label.
     def color_for(label)
       code = code_for(label)
       "\e[38;5;#{code}m"
     end
 
-    # Returns just the 256-color code integer for the given label.
+    # An unknown label gets the first color.
     def code_for(label)
       @mapping[label] || WHEEL[0]
     end

data/lib/railbow/config.rb

@@ -13,7 +13,7 @@ module Railbow
           "Status" => {"up" => "↑↑", "down" => "↓↓"}
         }
       },
-      "since" => "70d",
+      "since" => "90d",
       "since_min" => 10,
       "git" => "author:all,diff,mask:auto",
       "author_format" => "short",

data/lib/railbow/demo/fixtures.rb

@@ -5,15 +5,15 @@ require "date"
 module Railbow
   module Demo
     module Fixtures
-      # Fictional veterinary SaaS — "PawClinic"
+      # Fictional pet shop SaaS — "PawShop"
       # 4 authors: Alice Chen, Bob Wilson, Carol Davis, Me (current user)
       DEMO_USER_NAME = "Me"
       DEMO_USER_EMAIL = "me@example.com"
 
       AUTHORS = {
-        alice: {name: "Alice Chen", email: "alice@pawclinic.dev"},
-        bob: {name: "Bob Wilson", email: "bob@pawclinic.dev"},
-        carol: {name: "Carol Davis", email: "carol@pawclinic.dev"},
+        alice: {name: "Alice Chen", email: "alice@pawshop.dev"},
+        bob: {name: "Bob Wilson", email: "bob@pawshop.dev"},
+        carol: {name: "Carol Davis", email: "carol@pawshop.dev"},
         me: {name: DEMO_USER_NAME, email: DEMO_USER_EMAIL}
       }.freeze
 

data/lib/railbow/demo/status_demo.rb

@@ -31,11 +31,10 @@ module Railbow
         git_email = Fixtures::DEMO_USER_EMAIL
         git_name = Fixtures::DEMO_USER_NAME
 
-        # Latest migration date - for "fresh" landed badge detection
+        # Decides which landed badges count as fresh.
         latest_version = migrations.last[:version]
         latest_mig_date = parse_version_date(latest_version)
 
-        # Check if any landed tags exist
         has_landed_tags = migrations.any? { |m|
           next false unless m[:landed_date]
           mig_date = parse_version_date(m[:version])
@@ -52,15 +51,15 @@ module Railbow
           Railbow::Table::Column.new(label: "Migration Name",
             max_width: name_col_width,
             truncate: needs_name_truncation,
+            truncate_fn: ->(cell_raw, max_w) { formatter.name_with_tags_fitted(cell_raw, max_w) },
             shrinkable: true, shrink_floor: 24)
         ]
-        # No Author column in default config (author:me only highlights)
+        # No Who column: author:me only highlights.
 
         tables_truncate_fn = ->(cell_raw, max_w) { formatter.table_tags_fitted(cell_raw, max_w) }
         table_columns << Railbow::Table::Column.new(label: "Tables", droppable: 1,
           truncate: true, truncate_fn: tables_truncate_fn)
 
-        # Build rows
         highlight_rows = Set.new
         down_rows = Set.new
         rows = migrations.each_with_index.map do |m, idx|
@@ -73,10 +72,8 @@ module Railbow
 
           display_name = m[:name]
 
-          # Diff tag (branch badge)
           diff_tag = m[:branch] ? formatter.diff_tag_branch(m[:branch]) : nil
 
-          # Landed badge
           landed_tag = nil
           if m[:landed_date]
             mig_date = parse_version_date(m[:version])
@@ -86,7 +83,6 @@ module Railbow
             end
           end
 
-          # Append tags to display_name
           tags = [landed_tag, diff_tag].compact.join(" ")
           if !tags.empty? && name_col_width
             tags_width = formatter.display_width(formatter.strip_ansi(tags))
@@ -101,20 +97,18 @@ module Railbow
 
           created_at = formatter.format_date(m[:version], date_format)
 
-          # Highlight current user's rows (author:me mode)
+          # author:me highlighting.
           if m[:author_email] == git_email ||
               (git_name && m[:author_name] && m[:author_name].downcase == git_name.downcase)
             highlight_rows << idx
           end
 
-          # Table tags
           table_tags = formatter.table_tags(m[:tables])
 
           [colored_status, m[:version], created_at, display_name, table_tags]
         end
 
-        # Calendar furniture. Driven by the real params, so RBW_CALENDAR can be
-        # tried out here without a Rails project.
+        # Real params, so RBW_CALENDAR can be tried without a Rails project.
         calendar = Railbow::Calendar.build(
           migrations.map { |m| m[:version] },
           weeks: Railbow::Params.calendar_wdividers?,