harvest-worklog 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dcc34ed6ba1cee2e39e8dea71a9b05d80fa42b598366f16332eb1676e197789
-  data.tar.gz: 30e312eecb4f435930b74c2aa72a2a68e4f973d22f946e824bb8fee863ae8faa
+  metadata.gz: c7177cf851e2cf1de7dea85c719e9482cddb7e75b205c4579b3955044dfd2f90
+  data.tar.gz: 55080b09e031a6fa8076fca5e1a51825e583c628a619f63ef04cc442af117b03
 SHA512:
-  metadata.gz: fed0b9fa6998e23a607cb447e108d9849192ebdc209fc263e65ac850f19306a6430f628ccb2c5f8c9548d16d10197793ef2283e917391c2bca553aa12f7a5350
-  data.tar.gz: 1fcb49e4868b5c8e3d5eaadd37a0c6961c5be474164a6dc5ddd346f1286e82093b6b6698e176fc95c08a92f785873d7a2e8232b8b7f723daf1a351a3d572467a
+  metadata.gz: 589caf5b05eb1770cc06ac4eb9554c94d20218275d7cfb3191ceff09d6d4fb6f62e237d0722504e2e4542b3f99505064f7486228ec51aca4580bb9bce90a5165
+  data.tar.gz: 9aa1ba60998427c430e1ee7d8f9dde6500d864ef6ce1921303aec3192359ae34df49d0bdcd3c4c90c9b17ad42502818ec101c020c111591e71d8fa8ca163366d

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,16 @@ 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.
+
 ## OMP settings
 
 - `defaultHours`: hours per business day when a time-off tool call omits `hours`; defaults to `7`.
@@ -77,6 +88,26 @@ Configure `projectTimeMappings` with the recorded OMP Project Time project name
 
 `harvest_preview_project_time_entries` reads the configured time log, splits sessions across local dates, generates descriptions from the project and repository, and checks Harvest for existing or locked entries without writing. `harvest_record_project_time_entries` performs the same preflight then creates only new entries; OMP treats it as a write requiring approval. Unmapped sessions are reported and never written.
 
+### Activity transforms
+
+`harvest_preview_project_time_transforms` emits deterministic JSON for local raw intervals. It accepts an inclusive date range and optional exact `repositoryId`, `project`, and `sourceKind` filters; each matching interval is split by local date and grouped by activity, with missing labels reported as `unlabelled`. Set `applyMappings` to include configured Harvest project/task mappings. The output reports `groups`, proposed mapped `entries`, and any `unmapped` or `excluded` rows.
+
+`harvest_record_project_time_transforms` is a separate approval-gated write step. It always applies configured mappings and records the reviewed activity entries through the existing locked and duplicate preflight. Different activity labels may share a date/project/task; rerunning the same activity label is skipped, as are locked or unrelated existing entries.
+
+## Reconciling WRAP hours with manual entries
+
+Use a closed date range and record the expected OMP Project Time and manually entered hours for each day. Preview OMP entries first, then compare the final Harvest total for each day:
+
+```bash
+harvest-worklog aggregate FROM TO \
+  --project WRAP \
+  --task Programming
+```
+
+OMP-created entries use an `OMP Project Time:` note; use a `Manual reconciliation:` note for manual entries while testing. Inspect the Harvest entry details to distinguish their source—the aggregate intentionally combines all matching entries.
+
+The standard work-entry importer allows only one entry for a date, project, and task. If a manual `WRAP / Programming` entry exists for a date, importing ordinary OMP Project Time for that same mapping skips it rather than adding hours. Activity transforms are the exception: distinct activity labels can create separate entries while the same label, locked entries, and unrelated manual entries are still skipped. Reconcile ordinary entries as either OMP or manual hours, not their sum.
+
 ## Migration from harvest-time-off
 
 Version `0.5.0` is a clean identity cutover. Uninstall the prior `harvest-time-off` gem and OMP plugin, then install `harvest-worklog`; replace former top-level CLI commands with the `harvest-worklog time-off` and `harvest-worklog work-entry` subcommands. The old package, executables, and `workEntryCommand` setting are not retained.

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.6.0"
+  VERSION = "0.8.0"
 end

data/lib/harvest_worklog/work_entry_cli.rb

@@ -6,7 +6,7 @@ module HarvestWorklog
     LOCKED_ENTRY = 3
 
     def self.run(arguments, output: $stdout, error: $stderr, client: nil)
-      options = { dry_run: false }
+      options = { dry_run: false, activity_entry: false }
       parser = option_parser(options)
       dates = parser.parse(arguments)
       validate!(dates, options)
@@ -29,7 +29,14 @@ module HarvestWorklog
         return LOCKED_ENTRY
       end
 
-      if existing_entries.any?
+      if options[:activity_entry]
+        activity_key = options[:notes].lines.first
+        unrelated_entries = existing_entries.reject { |entry| entry["notes"]&.lines&.first&.start_with?("OMP Project Time activity: ") }
+        if unrelated_entries.any? || existing_entries.any? { |entry| entry["notes"]&.lines&.first == activity_key }
+          output.puts "Existing Harvest entry on #{spent_date.iso8601}; skipped"
+          return EXISTING_ENTRY
+        end
+      elsif existing_entries.any?
         output.puts "Existing Harvest entry on #{spent_date.iso8601}; skipped"
         return EXISTING_ENTRY
       end
@@ -64,6 +71,7 @@ module HarvestWorklog
         opts.on("--hours HOURS", Float, "Hours for this entry") { |value| options[:hours] = value }
         opts.on("--notes NOTES", "Entry description") { |value| options[:notes] = value }
         opts.on("--dry-run", "Check for existing entries without writing") { options[:dry_run] = true }
+        opts.on("--activity-entry", "Allow distinct OMP Project Time activity entries on the same date, project, and task") { options[:activity_entry] = true }
         opts.on("-h", "--help", "Show this help") do
           puts opts
           exit 0

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.6.0
+  version: 0.8.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