harvest-worklog 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd656e6ca496a7a7a5d08e0e1f407c5aaf030b80c75751abd354ce1259a3806d
-  data.tar.gz: cf38ac55098c083668f3df37774298c21b6329c39a6d017d1968fce9227bfd30
+  metadata.gz: 4ead4ee3da24a3522c5b5e09e694de573b4e10c2736b7e328377197efd349dcb
+  data.tar.gz: 41cce9ae00a04e151fd68914ddbb3200ae8451c837f93e95a8bd5b601ea1fc27
 SHA512:
-  metadata.gz: 72a0dc46a8551f9f3a6e8efd7bffd6ee9a2bbaf34021f86cdd98c0dc356d08edd88e96aa0da3e992b59f7ec5794f1656f2a3c785ebf7bc002f99c6a0f06e550b
-  data.tar.gz: 8fae9c3ecd9f91ac43280b854715532c4ea86221a9381793fea2674800e54d4577962e7a1adc8829a545544ff6b578727aee1396f979ccc4c02c554ad68f9121
+  metadata.gz: 2e2592d645f2153fab30539d0ad0fd103b8008c0025950c9222298fc1e06abf4cbd759f3b1a6e4a8eeba5ecf985670d13b994d430b870144afdf825a0ea44018
+  data.tar.gz: 11f9e301054fc944a9abf5a4509777cb9e6e538d3cd5be2fd50fc06b2a88feaf577b7ae22265ffe7d0a45972f5a7d25f58b99fb9ea36fd54b9eaee2edce0cd64

data/README.md

@@ -23,6 +23,7 @@ Personal Access Tokens are the intended Harvest authentication method for person
 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]
+harvest-worklog timesheet DATE --project NAME [--task NAME]
 ```
 
 ### Time off
@@ -57,6 +58,18 @@ harvest-worklog aggregate 2026-07-17 2026-07-19 \
 
 The `harvest_time_aggregates` OMP tool exposes the same optional filters and is approval-gated as a read.
 
+### Daily timesheets
+
+The `timesheet` command reads the authenticated user's compact daily Harvest view: task totals, entry durations when a task has multiple entries, and multiline notes. `DATE` accepts `today`, `yesterday`, or an ISO date in the CLI's local timezone.
+
+```bash
+harvest-worklog timesheet today --project WRAP
+```
+
+OMP exposes the same CLI-only path through `/harvest-worklog today WRAP` and the read-only `harvest_time_sheet` tool. The wrapper never calls Harvest directly. A later, separate feature may upload reviewed content through the Harvest API; keep that write path separate from this read-only formatter.
+
+Type `/harvest-worklog ` in OMP to discover the compact and explicit timesheet forms, relative date tokens, and context-valid `--project`/`--task` options. Completion keeps filter values as editable text, and the slash command delegates the selected timesheet argument vector to the CLI.
+
 ## OMP settings
 
 - `defaultHours`: hours per business day when a time-off tool call omits `hours`; defaults to `7`.

data/lib/harvest_worklog/aggregate_cli.rb

@@ -40,14 +40,16 @@ module HarvestWorklog
       raise Error, "FROM and TO are required" unless dates.length == 2
     end
 
-    def self.fetch_entries(client, from:, to:)
+    def self.fetch_entries(client, from:, to:, user_id: nil)
       entries = []
       page = 1
       loop do
+        params = { from: from.iso8601, to: to.iso8601, page:, per_page: PER_PAGE }
+        params[:user_id] = user_id if user_id
         response = client.request(
           :get,
           "/v2/time_entries",
-          params: { from: from.iso8601, to: to.iso8601, page:, per_page: PER_PAGE }
+          params:
         )
         entries.concat(response.fetch("time_entries"))
         page = response["next_page"]

data/lib/harvest_worklog/timesheet_cli.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module HarvestWorklog
+  class TimesheetCLI
+    def self.run(arguments, output: $stdout, error: $stderr, client: nil, today: Date.today)
+      options = {}
+      parser = option_parser(options)
+      dates = parser.parse(arguments)
+      validate!(dates, options)
+
+      spent_date = resolve_date(dates.first, today:)
+      client ||= Marlens::HarvestApiV2::Client.from_environment
+      user_id = current_user_id(client)
+      entries = AggregateCLI.fetch_entries(client, from: spent_date, to: spent_date, user_id:).select { |entry| AggregateCLI.matches?(entry, options) }
+      print_timesheet(output, entries, spent_date:, requested_project: options[:project])
+      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 timesheet DATE --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.resolve_date(value, today: Date.today)
+      case value.downcase
+      when "today" then today
+      when "yesterday" then today - 1
+      else Date.iso8601(value)
+      end
+    end
+
+    def self.current_user_id(client)
+      client.request(:get, "/v2/users/me", params: {}).fetch("id")
+    end
+
+    def self.validate!(dates, options)
+      raise Error, "DATE is required" unless dates.length == 1
+      raise Error, "--project is required" unless options[:project] && !options[:project].empty?
+    end
+
+    def self.print_timesheet(output, entries, spent_date:, requested_project:)
+      project = entries.first&.dig("project", "name") || requested_project
+      output.puts "#{project} · #{spent_date.strftime("%a, %b %-d")} · #{HarvestWorklog.display_hours(AggregateCLI.total_hours(entries))}h"
+      if entries.empty?
+        output.puts
+        output.puts "No time entries."
+        return
+      end
+
+      entries.group_by { |entry| entry.dig("task", "name") }.sort_by { |task, _| task.downcase }.each do |task, task_entries|
+        output.puts
+        output.puts "#{task} · #{HarvestWorklog.display_hours(AggregateCLI.total_hours(task_entries))}h"
+        if task_entries.one?
+          print_notes(output, task_entries.first["notes"].to_s, indent: 2)
+        else
+          task_entries.each do |entry|
+            output.puts "  #{HarvestWorklog.display_hours(Float(entry.fetch("hours")))}h"
+            print_notes(output, entry["notes"].to_s, indent: 4)
+          end
+        end
+      end
+    end
+
+    def self.print_notes(output, notes, indent:)
+      lines = notes.lines(chomp: true).reject(&:empty?)
+      lines = ["(no notes)"] if lines.empty?
+      lines.each { |line| output.puts "#{" " * indent}#{line}" }
+    end
+  end
+end

data/lib/harvest_worklog/version.rb

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

data/lib/harvest_worklog.rb

@@ -36,11 +36,13 @@ module HarvestWorklog
         WorkEntryCLI.run(command_arguments, output:, error:, client:)
       when "aggregate"
         AggregateCLI.run(command_arguments, output:, error:, client:)
+      when "timesheet"
+        TimesheetCLI.run(command_arguments, output:, error:, client:)
       when "-h", "--help"
         output.puts usage
         0
       else
-        error.puts "Error: choose time-off, work-entry, or aggregate"
+        error.puts "Error: choose time-off, work-entry, aggregate, or timesheet"
         error.puts usage
         1
       end
@@ -52,11 +54,13 @@ module HarvestWorklog
           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]
+          harvest-worklog timesheet DATE --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.
+          timesheet  Read a compact daily project timesheet without writing Harvest records.
       USAGE
     end
   end
@@ -170,3 +174,4 @@ end
 
 require "harvest_worklog/work_entry_cli"
 require "harvest_worklog/aggregate_cli"
+require "harvest_worklog/timesheet_cli"

metadata

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