railbow 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de5537d849ecc612b80236db0a17543d6fad2ea18aeb0c3872dd48ced2dfdf5f
-  data.tar.gz: a6833af7828722eee5153a48bcf96f7008760948324337c46af90ecee3a86520
+  metadata.gz: cdfe578f284175c30e3b9f4c77a83f62b8e63b8019e575590f8ad471e5639efb
+  data.tar.gz: 5874946340d18626a566b0190f734f6a94a55a3d40dfb0777760ab377b9d295d
 SHA512:
-  metadata.gz: e9d7ae02de3f895c3300dbcd547ad52ddb0309a53a999b2ad52694bc3d46430d90a0518451721df72868fed730f9b60e1c66ffa0e616d01207d2908b560950d0
-  data.tar.gz: 9fd9c71099808af2b42b186f13ff31112e9195e39af6b94f9650f649e6c7e1b7346d06133992229f9d354a24b955dd2c98ed9b4c77c85a1d727c31c7800bbdb6
+  metadata.gz: 3fc62787e1bfd0913be00ca297c5c9210a312b067c68960c13699298a3a064e396a20bc952e65544d19059a03c02454c99413b8f59fd84e6890d9145e8ba03c1
+  data.tar.gz: e2253cf2117f5ed4a6702f9500774789d05007876f09ad043b014f9e7b0d53f9616ea21fc32247463081e131aa533b2bf149cb65be99f8f08b37478a281e22ee

data/CHANGELOG.md

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

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
 
@@ -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/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])
@@ -55,13 +54,12 @@ module Railbow
             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|
@@ -74,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])
@@ -87,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))
@@ -102,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?,

data/lib/railbow/formatters/base.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "zlib"
+require_relative "../clock"
 require_relative "../text_utils"
 
 module Railbow
@@ -69,23 +70,20 @@ module Railbow
         table_names.map { |t| table_tag(t) }.join(" ")
       end
 
-      # Re-fits a pre-formatted table_tags string within max_width,
-      # showing full table names and "+N" for overflow.
-      # Accepts the full formatted string (with ANSI) and splits it into segments.
+      # Re-fits a formatted table_tags string within max_width: as many whole
+      # tags as fit plus "+N" for the rest, then one truncated tag, then "+N".
       def table_tags_fitted(formatted_str, max_width)
         return formatted_str if formatted_str.nil? || formatted_str.empty?
 
-        # Split into individual tag segments: each is "\e[38;5;NNNm● name\e[0m"
+        # Each tag is "\e[38;5;NNNm● name\e[0m"
         segments = formatted_str.scan(/\e\[38;5;\d+m● [^\e]+\e\[0m/)
         return formatted_str if segments.empty?
 
         total = segments.size
         plain_segments = segments.map { |s| strip_ansi(s) }
 
-        # Try fitting all tags
         return formatted_str if display_width(plain_segments.join(" ")) <= max_width
 
-        # Try fitting progressively fewer tags with +N suffix
         (total - 1).downto(1) do |count|
           remaining = total - count
           suffix = " +#{remaining}"
@@ -95,17 +93,13 @@ module Railbow
           end
         end
 
-        # Try fitting a truncated first table name + overflow.
-        # Need at least 7 chars: "● t… +N" (dot + color prefix use no visible width beyond the dot)
+        # A truncated first tag needs 7 columns at least: "● t… +N"
         if max_width >= 7
           suffix = (total > 1) ? " +#{total - 1}" : ""
-          # Available width for "● name…" part
           avail = max_width - display_width(suffix)
-          # "● " prefix = 2 chars visible, plus at least 1 char of name + ellipsis (1 char)
           if avail >= 4 # "● " (2) + at least 1 char + "…" (1)
             first_plain = plain_segments[0] # e.g. "● some_table"
             name_part = first_plain.sub(/^● /, "")
-            # Truncate name to fit: avail - 2 ("● ") - 1 ("…") = chars for name
             name_max = avail - 2 - 1
             truncated_name = name_part[0, name_max]
             color_match = segments[0].match(/\e\[38;5;\d+m/)
@@ -114,16 +108,13 @@ module Railbow
           end
         end
 
-        # Absolute fallback: just +N
         "+#{total}"
       end
 
-      # Re-fits a Migration Name cell whose tags (branch, landed) were padded
-      # flush against the right edge of a wider column. Truncating such a cell
-      # from the right eats the tags whole and leaves a bare ellipsis floating
-      # after the padding, so the name gives up the space instead and the tags
-      # stay put. Below NAME_TAGS_FLOOR there is no room for both and the tags
-      # are dropped outright - the name is what the row is about.
+      # Re-fits a Migration Name cell whose tags (branch, landed) sit flush
+      # right. Cutting from the right would eat the tags and leave a bare
+      # ellipsis, so the name gives up the space instead. Below NAME_TAGS_FLOOR
+      # the tags go: the name is what the row is about.
       def name_with_tags_fitted(cell, max_width)
         str = cell.to_s
         return truncate_ansi(str, max_width) if display_width(strip_ansi(str)) <= max_width
@@ -170,16 +161,8 @@ module Railbow
 
       def format_date(timestamp, mode = "full")
         ts = timestamp.to_s
-        return ts if ts.length != 14
-
-        time = begin
-          Time.new(
-            ts[0..3].to_i, ts[4..5].to_i, ts[6..7].to_i,
-            ts[8..9].to_i, ts[10..11].to_i, ts[12..13].to_i
-          )
-        rescue ArgumentError
-          return ts
-        end
+        time = Railbow::Clock.from_version(ts)
+        return ts unless time
 
         case mode
         when "full"
@@ -195,8 +178,6 @@ module Railbow
         end
       end
 
-      private
-
       def format_relative_time_from(time)
         diff = Time.now - time
         return "just now" if diff < 0
@@ -217,8 +198,6 @@ module Railbow
         else "~#{years}y ago"
         end
       end
-
-      public
     end
   end
 end

data/lib/railbow/init.rb

@@ -20,7 +20,7 @@ module Railbow
       # Every key can also be overridden via RBW_* environment variables.
 
       # Time window for migrations to display (e.g. 30d, 2mo, 1y, all)
-      since: "70d"
+      since: "90d"
 
       # Never show fewer than this many migrations, however old they are.
       # The window above is a soft limit: a database with five migrations shows
@@ -60,6 +60,10 @@ module Railbow
       # Date format: full, rel, short, or custom(%b %d, %Y)
       # date: "full"
 
+      # Timezone dates are shown in: local (this machine), utc, or any zone
+      # Rails knows, e.g. America/New_York or "Eastern Time (US & Canada)"
+      # tz: "local"
+
       # Multi-database runs (comma-separated). Leave empty ("") to expand every
       # database into its own section, in database.yml order; a database with
       # nothing in the time window collapses to a one-line summary either way.