fewald-worklog 0.3.27 → 0.3.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5884616a7ecad2f07046d271cdd4d56a10d4d67afac7583f077b58d70c1adb2b
-  data.tar.gz: 895be92dee9fe678bef8b108ba316f8d29a69ee4132ad4155d7e0bcb1a57b450
+  metadata.gz: 98413c2f56d95220ed96323e1bd719273a010fed346334650078e45adb7ca6e4
+  data.tar.gz: 42eadd693d07e91ac3e13a814c986671b62427d8c98488b809f5fb420b8a9aef
 SHA512:
-  metadata.gz: 0f5e94a954a83e34ec9ccfcb026e253fa8122336eae4fccfe5e63ffbfe6005a8fb1c3740be5603d2d366eb309fc9909cc8163819e10e52be1645c4e5ec9b53a5
-  data.tar.gz: 4f321c340d27c2cf3d6b9394d68cc21c3f5273749bbc9a51c0a6e2f80b4b7c9a4d7216b0d6d471c90ba79837e6edd8a9dc8670a6199028279459d0ac86191320
+  metadata.gz: f04df40355750a5c4efc7519faac0e5041f73e5ecd55b1ae9fbacdf694cb7f036b49b9d6d47c7edfc3316d29589b814969cbdfd5932fe3c77bcfe284667d84a3
+  data.tar.gz: 7cb02f4167a272f6f6da1ad58c8571cc3fdf9a9369afeb2f32887a8c679e9b269f1bd47e283e7978734a508d9997ee520559b732cbccbd63ff175bf01d4268ed

data/.version

@@ -1 +1 @@
-0.3.27
+0.3.28

data/lib/activity_graph.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'rainbow'
+
+# Renders a GitHub-style ASCII activity heatmap for worklog entries.
+# Accepts an array of DailyLog objects and produces a 53-column × 7-row grid
+# where each cell represents one day and darker (brighter) color means more activity.
+#
+# @example
+#   graph = ActivityGraph.new(storage.all_days)
+#   puts graph.render
+class ActivityGraph
+  DAYS_OF_WEEK = %w[Mon Tue Wed Thu Fri Sat Sun].freeze
+
+  # Number of weeks to display (approx. one year).
+  NUM_WEEKS = 53
+
+  # Minimum column distance between consecutive month labels to prevent overlap.
+  MIN_MONTH_GAP = 3
+
+  def initialize(daily_logs)
+    @daily_logs = Array(daily_logs)
+  end
+
+  # Render the activity graph as a printable multi-line string.
+  # @return [String]
+  def render
+    counts    = count_by_date
+    today     = Date.today
+    start_date = week_start(today - ((NUM_WEEKS * 7) - 1))
+    weeks      = build_weeks(start_date, today)
+    max_count  = counts.values.max || 0
+
+    lines = []
+    lines << "  #{Rainbow('Activity — past year').bold}"
+    lines << ''
+    lines << month_header(weeks)
+
+    DAYS_OF_WEEK.each_with_index do |day_name, day_idx|
+      cells = weeks.map do |week|
+        date = week[day_idx]
+        next '  ' if date > today
+
+        count = counts[date] || 0
+        "#{colored_block(intensity_level(count, max_count))} "
+      end
+      lines << "#{day_name} #{cells.join}"
+    end
+
+    lines << ''
+    lines << legend
+    lines.join("\n")
+  end
+
+  private
+
+  # Build a Hash mapping Date → entry count from the provided DailyLog objects.
+  # @return [Hash{Date => Integer}]
+  def count_by_date
+    @daily_logs.each_with_object({}) do |daily_log, hash|
+      date = daily_log.date.is_a?(Date) ? daily_log.date : Date.parse(daily_log.date.to_s)
+      hash[date] = daily_log.entries.length
+    end
+  end
+
+  # Return the Monday of the week that contains +date+.
+  # @param date [Date]
+  # @return [Date]
+  def week_start(date)
+    date - ((date.wday - 1) % 7)
+  end
+
+  # Build an array of weeks between +start_date+ and +end_date+.
+  # Each week is an Array of 7 Date objects (index 0 = Monday … index 6 = Sunday).
+  # +start_date+ must be a Monday.
+  # @param start_date [Date]
+  # @param end_date [Date]
+  # @return [Array<Array<Date>>]
+  def build_weeks(start_date, end_date)
+    weeks = []
+    current = start_date
+    while current <= end_date
+      weeks << (0..6).map { |i| current + i }
+      current += 7
+    end
+    weeks
+  end
+
+  # Map an entry count to an intensity level 0–4.
+  # Uses relative scaling so the full colour range adapts to the user's habits.
+  # Any day with at least one entry is guaranteed level ≥ 1.
+  # @param count [Integer]
+  # @param max_count [Integer]
+  # @return [Integer] 0–4
+  def intensity_level(count, max_count)
+    return 0 if count.zero? || max_count.zero?
+
+    ratio = count.to_f / max_count
+    return 1 if ratio <= 0.25
+    return 2 if ratio <= 0.50
+    return 3 if ratio <= 0.75
+
+    4
+  end
+
+  # Return a Rainbow-coloured Unicode block for the given intensity level.
+  # Brighter green = more activity (optimised for dark-background terminals).
+  # @param level [Integer] 0–4
+  # @return [String]
+  def colored_block(level)
+    case level
+    when 0 then Rainbow('░').color(0x4a, 0x4a, 0x4a)    # dark grey  – no activity
+    when 1 then Rainbow('█').color(0x0e, 0x44, 0x29)    # very dark green
+    when 2 then Rainbow('█').color(0x30, 0xa1, 0x4e)    # medium green
+    when 3 then Rainbow('█').color(0x40, 0xc4, 0x63)    # bright green
+    else        Rainbow('█').color(0x9b, 0xe9, 0xa8)    # very bright green – peak activity
+    end
+  end
+
+  # Build the month-label header row aligned with the week columns.
+  # Month names are placed at the column where the month first appears.
+  # A label is skipped when fewer than MIN_MONTH_GAP columns separate it from
+  # the previous one, preventing overlapping abbreviations at the graph edges.
+  # @param weeks [Array<Array<Date>>]
+  # @return [String]
+  def month_header(weeks)
+    # 4-char prefix to align with "Mon " row labels; 2 chars per week column.
+    buffer         = ' ' * (4 + (weeks.length * 2))
+    prev_month     = nil
+    last_label_col = -ActivityGraph::MIN_MONTH_GAP # allow first label at col 0
+
+    weeks.each_with_index do |week, col_idx|
+      month = week.first.month
+      next if month == prev_month
+      next if col_idx - last_label_col < MIN_MONTH_GAP
+
+      name = week.first.strftime('%b')
+      pos  = 4 + (col_idx * 2)
+      buffer[pos, name.length] = name
+      prev_month     = month
+      last_label_col = col_idx
+    end
+
+    buffer
+  end
+
+  # Return the legend row.
+  # @return [String]
+  def legend
+    blocks = (0..4).map { |level| colored_block(level) }
+    "     Less #{blocks.join(' ')} More"
+  end
+end

data/lib/worklog.rb

@@ -18,6 +18,7 @@ require 'printer'
 require 'project_storage'
 require 'standup'
 require 'statistics'
+require 'activity_graph'
 require 'storage'
 require 'summary'
 require 'takeout'
@@ -441,6 +442,8 @@ module Worklog
       puts "#{format_left('Entries per day')}: #{format('%.2f', stats.avg_entries)}"
       puts "#{format_left('First entry')}: #{stats.first_entry}"
       puts "#{format_left('Last entry')}: #{stats.last_entry}"
+      puts ''
+      puts ActivityGraph.new(@storage.all_days).render
     end
 
     def summary(options = {})

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fewald-worklog
 version: !ruby/object:Gem::Version
-  version: 0.3.27
+  version: 0.3.28
 platform: ruby
 authors:
 - Friedrich Ewald
@@ -166,6 +166,7 @@ files:
 - assets/prompts/standup.system.md.erb
 - assets/prompts/standup.user.md.erb
 - bin/wl
+- lib/activity_graph.rb
 - lib/cli.rb
 - lib/configuration.rb
 - lib/daily_log.rb