jirametrics 2.5 → 2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22daa10ce05dd421522069d3b5d73868f8f7bc1a6a53128acab515ca98644892
-  data.tar.gz: 8d797de1b80fe8f35fde593bc578012af92080e32000a905ea90ed286754bccd
+  metadata.gz: 749f92d4329a18999bf8954aee5b41955047ef263d7a37fe766b2233d697a8c9
+  data.tar.gz: f174b2241d23a3d7a9ff34b20093ff0716406197563df4b7f4f6447773fc7a51
 SHA512:
-  metadata.gz: b00a94c9c676625ff698ecf61211dea8b8bbc6d3fde400e23f349a888147b0245616f8944646eac4435106d1156dca08327fe596dcc0402e92169c67cc72cdb1
-  data.tar.gz: c85706281f71b2b0adf5dae8f99bcab478dadeb86b014ce88874879051ac0e4288d3d7cda1e0fd949e03b70878969f918248649423704ae5d757f63c83b12733
+  metadata.gz: f89eb6c1a9655163d91b19d9f5b92f79a7d714e6b45fe53e972248f20c5d788a356e6d5be0cbfe24a70665381bf0a7a28ce898b0e31cef9c4c3349d8ce335558
+  data.tar.gz: b95ee06e9b3ef78aba0635aa634fa56082da2aa8bfa759f7e38be2eb2b6889a04a23e99dc8aa9a021391d8db4fe797247fb2b9379c5801fc2c5ec7a3bc3ff103

data/lib/jirametrics/downloader.rb

@@ -6,7 +6,7 @@ require 'json'
 class Downloader
   CURRENT_METADATA_VERSION = 4
 
-  attr_accessor :metadata, :quiet_mode
+  attr_accessor :metadata
   attr_reader :file_system
 
   # For testing only
@@ -54,8 +54,7 @@ class Downloader
   end
 
   def log text, both: false
-    @file_system.log text
-    puts text if both && !@quiet_mode
+    @file_system.log text, also_write_to_stderr: both
   end
 
   def find_board_ids
@@ -137,13 +136,6 @@ class Downloader
     issue.raw['fields']['subtasks']&.each do |raw_subtask|
       @issue_keys_pending_download << raw_subtask['key']
     end
-
-    # Links
-    # We shouldn't blindly follow links as some, like cloners, aren't valuable and are just wasting time/effort
-    # to download
-    # issue.raw['fields']['issuelinks'].each do |raw_link|
-    #   @issue_keys_pending_download << IssueLink(raw: raw_link).other_issue.key
-    # end
   end
 
   def exit_if_call_failed json

data/lib/jirametrics/file_system.rb

@@ -27,8 +27,9 @@ class FileSystem
     File.write(filename, content)
   end
 
-  def log message
+  def log message, also_write_to_stderr: false
     logfile.puts message
+    $stderr.puts message if also_write_to_stderr
   end
 
   # In some Jira instances, a sizeable portion of the JSON is made up of empty fields. I've seen

data/lib/jirametrics/issue.rb

@@ -137,7 +137,15 @@ class Issue
     status = board.possible_statuses.find_by_name(name)
     return status if status
 
-    raise "Status name #{name.inspect} for issue #{key} not found in #{board.possible_statuses.collect(&:name).inspect}"
+    @board.project_config.file_system.log(
+      "Warning: Status name #{name.inspect} for issue #{key} not found in" \
+      " #{board.possible_statuses.collect(&:name).inspect}" \
+      "\n  See Q1 in the FAQ for more details: https://github.com/mikebowler/jirametrics/wiki/FAQ\n",
+      also_write_to_stderr: true
+    )
+    status = Status.new(name: name, category_name: 'In Progress')
+    board.possible_statuses << status
+    status
   end
 
   def first_status_change_after_created
@@ -251,6 +259,7 @@ class Issue
 
     blocked_link_texts = settings['blocked_link_text']
     stalled_threshold = settings['stalled_threshold_days']
+    flagged_means_blocked = !!settings['flagged_means_blocked']
 
     blocking_issue_keys = []
 
@@ -273,7 +282,7 @@ class Issue
         blocking_stalled_changes: result
       )
 
-      if change.flagged?
+      if change.flagged? && flagged_means_blocked
         flag = change.value
         flag = nil if change.value == ''
       elsif change.status?
@@ -362,6 +371,46 @@ class Issue
     inserted_stalled
   end
 
+  # return [number of active seconds, total seconds] that this issue had up to the end_time.
+  # It does not include data before issue start or after issue end
+  def flow_efficiency_numbers end_time:, settings: {}
+    issue_start = @board.cycletime.started_time(self)
+    return [0.0, 0.0] if !issue_start || issue_start > end_time
+
+    value_add_time = 0.0
+    issue_stop = @board.cycletime.stopped_time(self)
+    end_time = issue_stop if issue_stop && issue_stop < end_time
+
+    active_start = nil
+    blocked_stalled_changes(end_time: end_time, settings: settings).each_with_index do |change, index|
+      break if change.time > end_time
+
+      if index.zero?
+        active_start = change.time if change.active?
+        next
+      end
+
+      # Already active and we just got another active.
+      next if active_start && change.active?
+
+      if change.active?
+        active_start = change.time
+      elsif active_start && change.time >= issue_start
+        # Not active now but we have been. Record the active time.
+        change_delta = change.time - [issue_start, active_start].max
+        value_add_time += change_delta
+        active_start = nil
+      end
+    end
+
+    if active_start
+      change_delta = end_time - [issue_start, active_start].max
+      value_add_time += change_delta if change_delta.positive?
+    end
+
+    [value_add_time, end_time - issue_start]
+  end
+
   def all_subtask_activity_times
     subtask_activity_times = []
     @subtasks.each do |subtask|

data/lib/jirametrics/settings.json

@@ -4,6 +4,7 @@
 
   "blocked_link_text": ["is blocked by"],
   "blocked_statuses": [],
+  "flagged_means_blocked": true,
 
   "expedited_priority_names": ["Critical", "Highest"]
 }

data/lib/jirametrics/status.rb

@@ -38,8 +38,18 @@ class Status
   end
 
   def to_s
-    "Status(name=#{@name.inspect}, id=#{@id.inspect}," \
-      " category_name=#{@category_name.inspect}, category_id=#{@category_id.inspect}, project_id=#{@project_id})"
+    result = +"Status(name=#{@name.inspect}," \
+      " id=#{@id.inspect}," \
+      " category_name=#{@category_name.inspect}," \
+      " category_id=#{@category_id.inspect}," \
+      " project_id=#{@project_id}"
+    result << ' artificial' if artificial?
+    result << ')'
+    result
+  end
+
+  def artificial?
+    @raw.nil?
   end
 
   def value_equality_ignored_variables

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jirametrics
 version: !ruby/object:Gem::Version
-  version: '2.5'
+  version: '2.6'
 platform: ruby
 authors:
 - Mike Bowler
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-22 00:00:00.000000000 Z
+date: 2024-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: random-word