harvest-worklog 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1397fdec13d0a89c0023e926fa42043f701c351e0fbca487e40331c61bbfbcf
-  data.tar.gz: '09b9a725ea95df79e94cf204a1f12735c6db8e4d55d4a38f8442fc3f947f981f'
+  metadata.gz: 6dcc34ed6ba1cee2e39e8dea71a9b05d80fa42b598366f16332eb1676e197789
+  data.tar.gz: 30e312eecb4f435930b74c2aa72a2a68e4f973d22f946e824bb8fee863ae8faa
 SHA512:
-  metadata.gz: 33f8bbfa7e4d6f4b98bcc014d6ba3cdb51193a2582a3fd3bed37e3d4051fb606440065f60076d9afd1efc9ab64aa4d6f14a4d6fdb4dd0ff92775419a34012d74
-  data.tar.gz: 32d59d73fc353d159e7e7a6c93373147f0a7756b4f3b0ba56b4bb877b2cd177000ee8898739eeb1813c3830640cb8a6ce57d1272ab9aa1a5f1bdec1146f3adf9
+  metadata.gz: fed0b9fa6998e23a607cb447e108d9849192ebdc209fc263e65ac850f19306a6430f628ccb2c5f8c9548d16d10197793ef2283e917391c2bca553aa12f7a5350
+  data.tar.gz: 1fcb49e4868b5c8e3d5eaadd37a0c6961c5be474164a6dc5ddd346f1286e82093b6b6698e176fc95c08a92f785873d7a2e8232b8b7f723daf1a351a3d572467a

data/README.md

@@ -22,6 +22,7 @@ Personal Access Tokens are the intended Harvest authentication method for person
 ```text
 harvest-worklog time-off FROM TO --project NAME --task NAME [options]
 harvest-worklog work-entry DATE --project NAME --task NAME --hours HOURS --notes NOTES [options]
+harvest-worklog aggregate FROM TO [--project NAME] [--task NAME]
 ```
 
 ### Time off
@@ -44,6 +45,18 @@ A time-off block never creates weekend entries. When names are supplied, it reso
 
 The `work-entry` command checks for existing or locked entries for its project, task, and date before creating a new duration entry. Use `--dry-run` to complete that preflight without a write. OMP Project Time uses the same path.
 
+### Read-only aggregates
+
+The `aggregate` command reads all matching Harvest time-entry pages and prints totals grouped by spent date and project/task. It lists every date in the inclusive range, including weekend or empty dates, and never writes a Harvest record.
+
+```bash
+harvest-worklog aggregate 2026-07-17 2026-07-19 \
+  --project WRAP \
+  --task Programming
+```
+
+The `harvest_time_aggregates` OMP tool exposes the same optional filters and is approval-gated as a read.
+
 ## OMP settings
 
 - `defaultHours`: hours per business day when a time-off tool call omits `hours`; defaults to `7`.
@@ -80,8 +93,11 @@ harvest-worklog time-off 2026-08-17 2026-08-28 \
   --task 'Vacation / PTO' \
   --holiday-region ca_yt \
   --dry-run
+VERSION="$(ruby -Ilib -rharvest_worklog/version -e 'puts HarvestWorklog::VERSION')"
 gem build harvest-worklog.gemspec
-gem push harvest-worklog-<version>.gem
+gem push "harvest-worklog-${VERSION}.gem"
+gem uninstall harvest-time-off --all --executables --ignore-dependencies
+gem install --clear-sources --source https://rubygems.org harvest-worklog --version "$VERSION" --no-document
 omp plugin uninstall harvest-time-off
 omp plugin install --force github:klondikemarlen/harvest-worklog
 omp plugin list

data/lib/harvest_worklog/aggregate_cli.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module HarvestWorklog
+  class AggregateCLI
+    PER_PAGE = 100
+
+    def self.run(arguments, output: $stdout, error: $stderr, client: nil)
+      options = {}
+      parser = option_parser(options)
+      dates = parser.parse(arguments)
+      validate!(dates)
+
+      from = Date.iso8601(dates[0])
+      to = Date.iso8601(dates[1])
+      raise Error, "end date must not be before start date" if to < from
+
+      client ||= Marlens::HarvestApiV2::Client.from_environment
+      entries = fetch_entries(client, from:, to:).select { |entry| matches?(entry, options) }
+      print_summary(output, entries, from:, to:)
+      0
+    rescue Error, Marlens::HarvestApiV2::Error, OptionParser::ParseError, Date::Error => e
+      error.puts "Error: #{e.message}"
+      error.puts parser if parser
+      1
+    end
+
+    def self.option_parser(options)
+      OptionParser.new do |opts|
+        opts.banner = "Usage: harvest-worklog aggregate FROM TO [--project NAME] [--task NAME]"
+        opts.on("--project NAME", "Filter by Harvest project name") { |value| options[:project] = value }
+        opts.on("--task NAME", "Filter by Harvest task name") { |value| options[:task] = value }
+        opts.on("-h", "--help", "Show this help") do
+          puts opts
+          exit 0
+        end
+      end
+    end
+
+    def self.validate!(dates)
+      raise Error, "FROM and TO are required" unless dates.length == 2
+    end
+
+    def self.fetch_entries(client, from:, to:)
+      entries = []
+      page = 1
+      loop do
+        response = client.request(
+          :get,
+          "/v2/time_entries",
+          params: { from: from.iso8601, to: to.iso8601, page:, per_page: PER_PAGE }
+        )
+        entries.concat(response.fetch("time_entries"))
+        page = response["next_page"]
+        break if page.nil?
+      end
+      entries
+    end
+
+    def self.matches?(entry, options)
+      name_matches?(entry.dig("project", "name"), options[:project]) &&
+        name_matches?(entry.dig("task", "name"), options[:task])
+    end
+
+    def self.name_matches?(actual, expected)
+      expected.nil? || actual&.casecmp?(expected)
+    end
+
+    def self.print_summary(output, entries, from:, to:)
+      output.puts "#{entries.length} #{entry_label(entries.length)}, #{HarvestWorklog.display_hours(total_hours(entries))}h from #{from.iso8601} through #{to.iso8601}"
+      output.puts "By date:"
+      (from..to).each do |date|
+        date_entries = entries.select { |entry| entry.fetch("spent_date") == date.iso8601 }
+        output.puts "  #{date.iso8601}: #{date_entries.length} #{entry_label(date_entries.length)}, #{HarvestWorklog.display_hours(total_hours(date_entries))}h"
+      end
+      output.puts "By project/task:"
+
+      groups = entries.group_by { |entry| [entry.dig("project", "name"), entry.dig("task", "name")] }
+      if groups.empty?
+        output.puts "  none"
+        return
+      end
+
+      groups.keys.sort_by { |project, task| [project.downcase, task.downcase] }.each do |project, task|
+        group = groups.fetch([project, task])
+        output.puts "  #{project} / #{task}: #{group.length} #{entry_label(group.length)}, #{HarvestWorklog.display_hours(total_hours(group))}h"
+      end
+    end
+
+    def self.total_hours(entries)
+      entries.sum { |entry| Float(entry.fetch("hours")) }
+    end
+
+    def self.entry_label(count)
+      count == 1 ? "entry" : "entries"
+    end
+  end
+end

data/lib/harvest_worklog/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HarvestWorklog
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/lib/harvest_worklog.rb

@@ -34,11 +34,13 @@ module HarvestWorklog
         TimeOffCLI.run(command_arguments, output:, error:, client:)
       when "work-entry"
         WorkEntryCLI.run(command_arguments, output:, error:, client:)
+      when "aggregate"
+        AggregateCLI.run(command_arguments, output:, error:, client:)
       when "-h", "--help"
         output.puts usage
         0
       else
-        error.puts "Error: choose time-off or work-entry"
+        error.puts "Error: choose time-off, work-entry, or aggregate"
         error.puts usage
         1
       end
@@ -49,10 +51,12 @@ module HarvestWorklog
         Usage:
           harvest-worklog time-off FROM TO --project NAME --task NAME [options]
           harvest-worklog work-entry DATE --project NAME --task NAME --hours HOURS --notes NOTES [options]
+          harvest-worklog aggregate FROM TO [--project NAME] [--task NAME]
 
         Commands:
           time-off    Create one entry per local business day in a date range.
           work-entry  Create one reviewed ordinary-work entry.
+          aggregate   Read time-entry totals without writing Harvest records.
       USAGE
     end
   end
@@ -165,3 +169,4 @@ module HarvestWorklog
 end
 
 require "harvest_worklog/work_entry_cli"
+require "harvest_worklog/aggregate_cli"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: harvest-worklog
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Marlen Brunner
@@ -62,6 +62,7 @@ files:
 - bin/harvest-worklog
 - harvest-worklog.rb
 - lib/harvest_worklog.rb
+- lib/harvest_worklog/aggregate_cli.rb
 - lib/harvest_worklog/version.rb
 - lib/harvest_worklog/work_entry_cli.rb
 homepage: https://github.com/klondikemarlen/harvest-worklog