jirametrics 2.25 → 2.30

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 615528aa77577881d7658b0ce059e9e3972ce4285aeb3c1081c4347dd1a20ca4
-  data.tar.gz: 483cc9b7535da95ca2249813e5ad8ff924334f65c8b7fa84c5705367a9d1b147
+  metadata.gz: a1f64f63f13e8cb59d3b18fb1e1ad90f77ca06d0e2f59a75ff7b7bae4db1870f
+  data.tar.gz: 9b7d6b8759102d7590e86c114d2ac8b1b2e7c4cc9f45a168002752196a6bf797
 SHA512:
-  metadata.gz: 36acebeef4d036c6ed043f0073177944c390d5c80ba6ef162319f6a9bbb67bb2762ca4a345f4160d0f1d3fdc7047e257474920c09da9c5770c8a0e45a4748e59
-  data.tar.gz: 2c6f92cdb1d61b49ed7b318bc5c2108649ad387e9af51c312ade43f1522f3cc842dc949dde7d0373d41dc25630bbf9e5a3f883fc9255423ecd6e19c9008b3a4f
+  metadata.gz: 8ec0bee468f8c34c001ea9151b0d78b1018d246cc86f9c2588a70ee55e3940b6263f69032884ec5c2dc596d3182909829f6ee63fe51b6c65444ce667bf70a6ca
+  data.tar.gz: 9b9f5337d0fc671639f9f651977cb2ecc60b2d27105cdce1b75a2a4188c093c111ba29ed880adccb515d548b8bd9209b4cf703482a0ede4ccea6b182212a3a57

data/bin/jirametrics-mcp

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'jirametrics'
+JiraMetrics.start(['mcp'] + ARGV)

data/lib/jirametrics/aging_work_bar_chart.rb

@@ -15,7 +15,7 @@ class AgingWorkBarChart < ChartBase
         newest at the bottom.
       </p>
       <p>
-        There are <%= current_board.scrum? ? 'four' : 'three' %> bars for each issue, and hovering over any of the bars will provide more details.
+        There are <%= (aggregated_project? || current_board.scrum?) ? 'four' : 'three' %> bars for each issue, and hovering over any of the bars will provide more details.
         <ol>
           <li>Status: The status the issue was in at any time. The colour indicates the
           status category, which will be one of #{color_block '--status-category-todo-color'} To Do,
@@ -25,7 +25,7 @@ class AgingWorkBarChart < ChartBase
           or #{color_block '--stalled-color'} stalled.</li>
           <li>Priority: This shows the priority over time. If one of these priorities is considered expedited
           then it will be drawn with diagonal lines.</li>
-          <% if current_board.scrum? %>
+          <% if aggregated_project? || current_board.scrum? %>
             <li>Sprints: The sprints that the issue was in.</li>
           <% end %>
         </ol>
@@ -84,7 +84,7 @@ class AgingWorkBarChart < ChartBase
       ['blocked', collect_blocked_stalled_ranges(issue: issue, issue_start_time: issue_start_time)],
       ['priority', collect_priority_ranges(issue: issue)]
     ]
-    bar_data << ['sprints', collect_sprint_ranges(issue: issue)] if current_board.scrum?
+    bar_data << ['sprints', collect_sprint_ranges(issue: issue)] if aggregated_project? || current_board.scrum?
 
     bar_data.each { |entry| clip_ranges_to_start_time(ranges: entry.last, issue_start_time: issue_start_time) }
 
@@ -113,7 +113,7 @@ class AgingWorkBarChart < ChartBase
   def grow_chart_height_if_too_many_issues aging_issue_count:
     px_per_bar = 10
     bars_per_issue = 3
-    bars_per_issue += 1 if current_board.scrum?
+    bars_per_issue += 1 if aggregated_project? || current_board.scrum?
 
     preferred_height = aging_issue_count * px_per_bar * bars_per_issue
     @canvas_height = preferred_height if @canvas_height.nil? || @canvas_height < preferred_height
@@ -235,10 +235,12 @@ class AgingWorkBarChart < ChartBase
       previous_change = change
     end
 
-    results << create_range_for_priority(
-      previous_change: previous_change, stop_time: time_range.end,
-      expedited_priority_names: expedited_priority_names
-    )
+    if previous_change
+      results << create_range_for_priority(
+        previous_change: previous_change, stop_time: time_range.end,
+        expedited_priority_names: expedited_priority_names
+      )
+    end
     results
   end
 

data/lib/jirametrics/aging_work_in_progress_chart.rb

@@ -6,6 +6,7 @@ require 'jirametrics/board_movement_calculator'
 
 class AgingWorkInProgressChart < ChartBase
   include GroupableIssueChart
+
   attr_accessor :possible_statuses, :board_id
   attr_reader :board_columns
 
@@ -55,7 +56,7 @@ class AgingWorkInProgressChart < ChartBase
   def run
     determine_board_columns
 
-    @header_text += " on board: #{@all_boards[@board_id].name}"
+    @header_text += " on board: #{current_board.name}"
     data_sets = make_data_sets
 
     adjust_visibility_of_unmapped_status_column data_sets: data_sets
@@ -76,7 +77,7 @@ class AgingWorkInProgressChart < ChartBase
 
     @fake_column = BoardColumn.new({
       'name' => '[Unmapped Statuses]',
-      'statuses' => unmapped_statuses.collect { |id| { 'id' => id.to_s } }.uniq # rubocop:disable Performance/ChainArrayAllocation
+      'statuses' => unmapped_statuses.collect { |id| { 'id' => id.to_s } }.uniq
     })
     @board_columns = columns + [@fake_column]
   end
@@ -114,14 +115,7 @@ class AgingWorkInProgressChart < ChartBase
 
     calculator = BoardMovementCalculator.new board: @all_boards[@board_id], issues: issues, today: date_range.end
 
-    column_indexes_to_remove = []
-    unless @show_all_columns
-      column_indexes_to_remove = indexes_of_leading_and_trailing_zeros(calculator.age_data_for(percentage: 100))
-
-      column_indexes_to_remove.reverse_each do |index|
-        @board_columns.delete_at index
-      end
-    end
+    column_indexes_to_remove = trim_board_columns data_sets: data_sets, calculator: calculator
 
     @row_index_offset = data_sets.size
 
@@ -177,6 +171,44 @@ class AgingWorkInProgressChart < ChartBase
     result
   end
 
+  def trim_board_columns data_sets:, calculator:
+    return [] if @show_all_columns
+
+    columns_with_aging_items = data_sets.flat_map do |set|
+      set['data'].filter_map { |d| d['x'] if d.is_a? Hash }
+    end.uniq
+
+    # @fake_column is always the last element and is handled separately.
+    real_column_count = @board_columns.size - 1
+
+    # The last visible column always has artificially inflated age_data because
+    # ages_of_issues_when_leaving_column uses `today` as end_date when there is no
+    # next column. Exclude it from the right-boundary search so it is only kept when
+    # it has current aging items (handled by the last_aging fallback below).
+    age_data = calculator.age_data_for(percentage: 100)
+    last_data = (0...(real_column_count - 1)).to_a.reverse.find { |i| !age_data[i].zero? }
+
+    in_current = ->(i) { columns_with_aging_items.include?(@board_columns[i].name) }
+    first_aging = (0...real_column_count).find(&in_current)
+    last_aging  = (0...real_column_count).to_a.reverse.find(&in_current)
+
+    # Combine: include any column with age_data (up to but not including the last visible
+    # column) and any column with current aging items.
+    first_data = (0...real_column_count).find { |i| !age_data[i].zero? }
+    left_bound  = [first_data, first_aging].compact.min
+    right_bound = [last_data, last_aging].compact.max
+
+    indexes_to_remove =
+      if left_bound && right_bound
+        (0...left_bound).to_a + ((right_bound + 1)...real_column_count).to_a
+      else
+        (0...real_column_count).to_a
+      end
+
+    indexes_to_remove.reverse_each { |index| @board_columns.delete_at index }
+    indexes_to_remove
+  end
+
   def column_for issue:
     @board_columns.find do |board_column|
       board_column.status_ids.include? issue.status.id
@@ -192,7 +224,7 @@ class AgingWorkInProgressChart < ChartBase
       end
     end
 
-    if has_unmapped
+    if has_unmapped && @description_text
       @description_text += "<p>The items shown in #{column_name.inspect} are not visible on the " \
         'board but are still active. Most likely everyone has forgotten about them.</p>'
     else

data/lib/jirametrics/aging_work_table.rb

@@ -45,7 +45,9 @@ class AgingWorkTable < ChartBase
   # This is its own method simply so the tests can initialize the calculator without doing a full run.
   def initialize_calculator
     @today = date_range.end
-    @calculator = BoardMovementCalculator.new board: current_board, issues: issues, today: @today
+    @calculators = @all_boards.transform_values do |board|
+      BoardMovementCalculator.new board: board, issues: issues, today: @today
+    end
   end
 
   def expedited_but_not_started
@@ -123,7 +125,8 @@ class AgingWorkTable < ChartBase
     due = issue.due_date
     message = nil
 
-    days_remaining, error = @calculator.forecasted_days_remaining_and_message issue: issue, today: @today
+    calculator = @calculators[issue.board.id]
+    days_remaining, error = calculator.forecasted_days_remaining_and_message issue: issue, today: @today
 
     unless error
       if due

data/lib/jirametrics/board.rb

@@ -72,7 +72,7 @@ class Board
     return true if board_type == 'scrum'
     return false unless board_type == 'simple'
 
-    @features.any? { |f| f.name == 'jsw.agility.sprints' && f.enabled? }
+    has_sprints_feature?
   end
 
   def kanban?
@@ -82,6 +82,14 @@ class Board
     !scrum?
   end
 
+  def team_managed_kanban?
+    board_type == 'simple' && !has_sprints_feature?
+  end
+
+  def has_sprints_feature?
+    @features.any? { |f| f.name == 'jsw.agility.sprints' && f.enabled? }
+  end
+
   def id
     @raw['id'].to_i
   end

data/lib/jirametrics/cfd_data_builder.rb

@@ -31,12 +31,17 @@ class CfdDataBuilder
 
   # Returns { hwm_timeline: [[date, hwm_value], ...], correction_windows: [...] }
   def process_issue issue, column_map
+    start_time = issue.started_stopped_times.first
+    return { hwm_timeline: [], correction_windows: [] } if start_time.nil?
+
     high_water_mark = nil
     correction_open_since = nil
     correction_windows = []
     hwm_timeline = [] # sorted chronologically by date
 
     issue.status_changes.each do |change|
+      next if change.time < start_time
+
       col_index = column_map[change.value_id]
       next if col_index.nil?
 

data/lib/jirametrics/chart_base.rb

@@ -1,6 +1,17 @@
 # frozen_string_literal: true
 
 class ChartBase
+  # Okabe-Ito palette — perceptually distinct under the most common forms of colour blindness.
+  # Ordered from most- to least-commonly useful for chart series.
+  OKABE_ITO_PALETTE = %w[
+    #0072B2
+    #E69F00
+    #009E73
+    #56B4E9
+    #D55E00
+    #CC79A7
+    #F0E442
+  ].freeze
   attr_accessor :timezone_offset, :board_id, :all_boards, :date_range,
     :time_range, :data_quality, :holiday_dates, :settings, :issues, :file_system,
     :atlassian_document_format, :x_axis_title, :y_axis_title, :fix_versions
@@ -328,7 +339,8 @@ class ChartBase
   end
 
   def random_color
-    "##{Random.bytes(3).unpack1('H*')}"
+    @palette_index = (@palette_index || -1) + 1
+    OKABE_ITO_PALETTE[@palette_index % OKABE_ITO_PALETTE.size]
   end
 
   def canvas width:, height:, responsive: true
@@ -377,7 +389,7 @@ class ChartBase
   end
 
   def seam_start type = 'chart'
-    "\n<!-- seam-start | chart#{@@chart_counter} | #{self.class} | #{header_text} | #{type} -->"
+    "\n<!-- seam-start | chart#{@@chart_counter} | #{self.class} | #{header_text} | #{type} -->\n"
   end
 
   def seam_end type = 'chart'

data/lib/jirametrics/cumulative_flow_diagram.rb

@@ -64,6 +64,14 @@ class CumulativeFlowDiagram < ChartBase
         <b>average throughput (TP)</b> (items completed per day). Use the checkbox above the chart to toggle
         between the triangle and the normal data tooltips.
       </div>
+      <div class="p">
+        CT and TP require a future point C where cumulative completions catch up to current arrivals.
+        When the cursor is near the right edge and that point falls outside the visible date range,
+        CT and TP cannot be calculated and are hidden; only WIP is shown.
+      </div>
+      <div class="p">
+        See also: This article on <a href="https://blog.mikebowler.ca/2026/03/27/cumulative-flow-diagram/">how to read a CFD</a>.
+      </div>      
     HTML
     instance_eval(&block)
   end

data/lib/jirametrics/cycletime_scatterplot.rb

@@ -35,6 +35,10 @@ class CycletimeScatterplot < TimeBasedScatterplot
     end
   end
 
+  def minimum_y_value
+    1 # Values under 1 day are data quality problems; they're flagged in the quality report instead
+  end
+
   def all_items
     completed_issues_in_range include_unstarted: false
   end

data/lib/jirametrics/daily_view.rb

@@ -24,7 +24,7 @@ class DailyView < ChartBase
   def run
     aging_issues = select_aging_issues
 
-    return "<h1 class='foldable'>#{@header_text}</h1>There are no items currently in progress" if aging_issues.empty?
+    return "<h1 class='foldable'>#{@header_text}</h1><div>There are no items currently in progress</div>" if aging_issues.empty?
 
     result = +''
     result << render_top_text(binding)
@@ -87,13 +87,14 @@ class DailyView < ChartBase
       lines << ["#{marker} Blocked by flag"] if blocked_stalled.flag
       lines << ["#{marker} Blocked by status: #{blocked_stalled.status}"] if blocked_stalled.blocked_by_status?
       blocked_stalled.blocking_issue_keys&.each do |key|
-        blocking_issue = issues.find { |i| i.key == key }
+        blocking_issue = issues.find_by_key key: key, include_hidden: true
         if blocking_issue
-          lines << "<section><div class=\"foldable startFolded\">#{marker} Blocked by issue: #{key}</div>"
+          lines << "<section><div class=\"foldable startFolded\">#{marker} Blocked by issue: " \
+            "#{make_issue_label issue: blocking_issue, done: blocking_issue.done?}</div>"
           lines << blocking_issue
           lines << '</section>'
         else
-          lines << ["#{marker} Blocked by issue: #{key}"]
+          lines << ["#{marker} Blocked by issue: #{key} (no description found)"]
         end
       end
     elsif blocked_stalled.stalled_by_status?

data/lib/jirametrics/data_quality_report.rb

@@ -434,8 +434,10 @@ class DataQualityReport < ChartBase
   end
 
   def render_issue_not_visible_on_board problems
+    unique_issue_count = problems.map(&:first).uniq.size
     <<-HTML
-      #{label_issues problems.size} were not visible on the board for some period of time. This may impact
+      #{problems.size} #{'time'.then { |w| problems.size == 1 ? w : "#{w}s" }} across #{label_issues unique_issue_count},
+      an item was not visible on the board. This may impact
       timings as the work was likely to have been forgotten if it wasn't visible. An issue can be not visible
       for two reasons: the issue was in a status that is not mapped to any visible column on the board
       (look in "unmapped statuses" on your board), or for scrum boards, the issue was not in an active sprint.

data/lib/jirametrics/dependency_chart.rb

@@ -57,7 +57,7 @@ class DependencyChart < ChartBase
     end
 
     svg = execute_graphviz(dot_graph.join("\n"))
-    "<h1>#{@header_text}</h1><div>#{@description_text}</div>#{shrink_svg svg}"
+    "<h1 class='foldable'>#{@header_text}</h1><div>#{@description_text}#{shrink_svg svg}</div>"
   end
 
   def link_rules &block

data/lib/jirametrics/downloader.rb

@@ -74,6 +74,7 @@ class Downloader
     download_statuses
     find_board_ids.each do |id|
       board = download_board_configuration board_id: id
+      board.project_config = @download_config.project_config
       download_issues board: board
     end
     download_users
@@ -86,6 +87,23 @@ class Downloader
     @file_system.log text, also_write_to_stderr: both
   end
 
+  def log_start text
+    @file_system.log_start text
+  end
+
+  def start_progress
+    @file_system.start_progress
+  end
+
+  def progress_dot message = nil
+    @file_system.log message if message
+    @file_system.progress_dot
+  end
+
+  def end_progress
+    @file_system.end_progress
+  end
+
   def find_board_ids
     ids = @download_config.project_config.board_configs.collect(&:id)
     raise 'Board ids must be specified' if ids.empty?
@@ -232,13 +250,6 @@ class Downloader
         @metadata[key] = value
       end
 
-      # If rolling_date_count has changed, we may be missing data outside the previous range,
-      # so force a full re-download.
-      if @metadata['rolling_date_count'] != @download_config.rolling_date_count
-        log '  rolling_date_count has changed. Forcing a full download.', both: true
-        @cached_data_format_is_current = false
-        @metadata = {}
-      end
     end
 
     # Even if this is the old format, we want to obey this one tag

data/lib/jirametrics/downloader_for_cloud.rb

@@ -53,6 +53,7 @@ class DownloaderForCloud < Downloader
     next_page_token = nil
     issue_count = 0
 
+    start_progress
     loop do
       relative_url = +''
       relative_url << '/rest/api/3/search/jql'
@@ -75,11 +76,12 @@ class DownloaderForCloud < Downloader
         issue_count += 1
       end
 
-      message = "    Found #{issue_count} issues"
-      log message, both: true
+      progress_dot "    Found #{issue_count} issues"
 
       break unless next_page_token
     end
+    end_progress
+
     hash
   end
 
@@ -88,7 +90,7 @@ class DownloaderForCloud < Downloader
     # that only returns the "recent" changes, not all of them. So now we get the issue
     # without changes and then make a second call for that changes. Then we insert it
     # into the raw issue as if it had been there all along.
-    log "  Downloading #{issue_datas.size} issues", both: true
+    log "  Downloading #{issue_datas.size} issues"
     payload = {
       'fields' => ['*all'],
       'issueIdsOrKeys' => issue_datas.collect(&:key)
@@ -106,11 +108,24 @@ class DownloaderForCloud < Downloader
       }
       issue = Issue.new(raw: issue_json, board: board)
       data = issue_datas.find { |d| d.key == issue.key }
+      unless data
+        log "  Skipping #{issue.key}: returned by Jira but key not in request (issue may have been moved)"
+        next
+      end
       data.up_to_date = true
       data.last_modified = issue.updated
       data.issue = issue
     end
 
+    # Mark any unmatched requests as up_to_date to prevent infinite re-fetching.
+    # This happens when Jira returns a different key (moved issue) leaving the original unmatched.
+    issue_datas.each do |data|
+      next if data.up_to_date
+
+      log "  Skipping #{data.key}: not returned by Jira (issue may have been deleted or moved)"
+      data.up_to_date = true
+    end
+
     issue_datas
   end
 
@@ -166,16 +181,20 @@ class DownloaderForCloud < Downloader
 
     issue_data_hash = search_for_issues jql: jql, board_id: board.id, path: path
 
+    checked_for_related = Set.new
+    in_related_phase = false
+
     loop do
       related_issue_keys = Set.new
-      issue_data_hash
-        .values
-        .reject { |data| data.up_to_date }
-        .each_slice(100) do |slice|
-          slice = bulk_fetch_issues(
-            issue_datas: slice, board: board, in_initial_query: true
-          )
+      stale = issue_data_hash.values.reject { |data| data.up_to_date }
+      unless stale.empty?
+        log_start '  Downloading more issues ' unless in_related_phase
+        stale.each_slice(100) do |slice|
+          slice = bulk_fetch_issues(issue_datas: slice, board: board, in_initial_query: true)
+          progress_dot
           slice.each do |data|
+            next unless data.issue
+
             @file_system.save_json(
               json: data.issue.raw, filename: data.cache_path
             )
@@ -183,20 +202,25 @@ class DownloaderForCloud < Downloader
             # to parse the file just to find the timestamp
             @file_system.utime time: data.issue.updated, file: data.cache_path
 
-            issue = data.issue
-            next unless issue
-
-            parent_key = issue.parent_key(project_config: @download_config.project_config)
-            related_issue_keys << parent_key if parent_key
-
-            # Sub-tasks
-            issue.raw['fields']['subtasks']&.each do |raw_subtask|
-              related_issue_keys << raw_subtask['key']
-            end
+            collect_related_issue_keys issue: data.issue, related_issue_keys: related_issue_keys
+            checked_for_related << data.key
           end
         end
+        end_progress unless in_related_phase
+      end
+
+      # Also scan up-to-date cached issues we haven't checked yet — they may reference
+      # related issues that are not in the primary query result.
+      issue_data_hash.each_value do |data|
+        next if checked_for_related.include?(data.key)
+        next unless @file_system.file_exist?(data.cache_path)
 
-      # Remove all the ones we already downloaded
+        checked_for_related << data.key
+        raw = @file_system.load_json(data.cache_path)
+        collect_related_issue_keys issue: Issue.new(raw: raw, board: board), related_issue_keys: related_issue_keys
+      end
+
+      # Remove all the ones we already have
       related_issue_keys.reject! { |key| issue_data_hash[key] }
 
       related_issue_keys.each do |key|
@@ -208,9 +232,15 @@ class DownloaderForCloud < Downloader
       end
       break if related_issue_keys.empty?
 
-      log "  Downloading linked issues for board #{board.id}", both: true
+      unless in_related_phase
+        in_related_phase = true
+        log "  Identifying related issues (parents, subtasks, links) for board #{board.id}", both: true
+        log_start '  Downloading more issues '
+      end
     end
 
+    end_progress if in_related_phase
+
     delete_issues_from_cache_that_are_not_in_server(
       issue_data_hash: issue_data_hash, path: path
     )
@@ -235,6 +265,22 @@ class DownloaderForCloud < Downloader
     end
   end
 
+  def collect_related_issue_keys issue:, related_issue_keys:
+    parent_key = issue.parent_key(project_config: @download_config.project_config)
+    related_issue_keys << parent_key if parent_key
+
+    issue.raw['fields']['subtasks']&.each do |raw_subtask|
+      related_issue_keys << raw_subtask['key']
+    end
+
+    issue.raw['fields']['issuelinks']&.each do |link|
+      next if link['type']['name'] == 'Cloners'
+
+      linked = link['inwardIssue'] || link['outwardIssue']
+      related_issue_keys << linked['key'] if linked
+    end
+  end
+
   def last_modified filename:
     File.mtime(filename) if File.exist?(filename)
   end

data/lib/jirametrics/downloader_for_data_center.rb

@@ -25,7 +25,7 @@ class DownloaderForDataCenter < Downloader
       keys_to_request = @issue_keys_pending_download[0..99]
       @issue_keys_pending_download.reject! { |key| keys_to_request.include? key }
       jql = "key in (#{keys_to_request.join(', ')})"
-      jira_search_by_jql(jql: jql, initial_query: false, board: board, path: path)
+      jira_search_by_jql(jql: jql, initial_query: true, board: board, path: path)
     end
   end
 

data/lib/jirametrics/examples/aggregated_project.rb

@@ -10,7 +10,7 @@
 class Exporter
   def aggregated_project name:, project_names:, settings: {}
     project name: name do
-      puts name
+      file_system.log name
       file_prefix name
       self.settings.merge! stringify_keys(settings)
 

data/lib/jirametrics/examples/standard_project.rb

@@ -9,7 +9,7 @@ class Exporter
       show_experimental_charts: false, github_repos: nil
     exporter = self
     project name: name do
-      puts name
+      file_system.log name, also_write_to_stderr: true
       file_prefix file_prefix
 
       self.anonymize if anonymize
@@ -35,7 +35,7 @@ class Exporter
       download do
         self.rolling_date_count(rolling_date_count) if rolling_date_count
         self.no_earlier_than(no_earlier_than) if no_earlier_than
-        github_repo github_repos if github_repos
+        github_repo *github_repos if github_repos
       end
 
       issues.reject! do |issue|
@@ -82,6 +82,9 @@ class Exporter
           end
 
           aging_work_in_progress_chart
+          wip_by_column_chart do
+            show_recommendations
+          end
           aging_work_bar_chart
           aging_work_table
           daily_wip_by_age_chart

data/lib/jirametrics/exporter.rb

@@ -8,7 +8,13 @@ class Exporter
 
   def self.configure &block
     logfile_name = 'jirametrics.log'
-    logfile = File.open logfile_name, 'w'
+    logfile = File.open(logfile_name, 'w')
+  rescue Errno::EACCES
+    # FileSystem can't be used here — it hasn't been created yet (it depends on this logfile).
+    warn "Error: Cannot write to #{File.expand_path(logfile_name)}. " \
+      'Please ensure the current directory is writable.'
+    exit 1
+  else
     file_system = FileSystem.new
     file_system.logfile = logfile
     file_system.logfile_name = logfile_name
@@ -67,18 +73,23 @@ class Exporter
 
   def info key, name_filter:
     selected = []
+    file_system.log_only = true
     each_project_config(name_filter: name_filter) do |project|
       project.evaluate_next_level
 
       project.run load_only: true
       project.issues.each do |issue|
         selected << [project, issue] if key == issue.key
+        issue.subtasks.each do |subtask|
+          selected << [project, subtask] if key == subtask.key
+        end
       end
     rescue => e # rubocop:disable Style/RescueStandardError
       # This happens when we're attempting to load an aggregated project because it hasn't been
       # properly initialized. Since we don't care about aggregated projects, we just ignore it.
       raise unless e.message.start_with? 'This is an aggregated project and issues should have been included'
     end
+    file_system.log_only = false
 
     if selected.empty?
       file_system.log "No issues found to match #{key.inspect}"