reclaim 0.2.0

data/lib/reclaim/task.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+module Reclaim
+  # Represents a Reclaim task with all its properties and methods
+  class Task
+    # Task priority levels matching Reclaim API
+    PRIORITIES = {
+      p1: 'P1',
+      p2: 'P2',
+      p3: 'P3',
+      p4: 'P4'
+    }.freeze
+
+    # Task status values
+    STATUSES = %w[
+      NEW SCHEDULED IN_PROGRESS COMPLETE ARCHIVED CANCELLED
+    ].freeze
+
+    # Event colors for calendar display
+    EVENT_COLORS = %w[
+      BLUE GREEN YELLOW ORANGE RED PURPLE PINK BROWN GRAY
+    ].freeze
+
+    # All task attributes with accessor methods
+    attr_accessor :id, :title, :notes, :due_date, :priority, :duration,
+                  :min_chunk_size, :max_chunk_size, :min_work_duration,
+                  :max_work_duration, :snooze_until, :start, :time_scheme_id,
+                  :always_private, :event_category, :event_color, :status,
+                  :created_at, :updated_at, :deleted
+
+    def initialize(attributes = {})
+      # Convert API field names to internal format
+      converted_attrs = {}
+      attributes.each do |key, value|
+        case key.to_s
+        when 'timeChunksRequired'
+          converted_attrs['duration'] = (value / 4.0) # Convert from 15-min chunks to hours
+        when 'timeSchemeId'
+          converted_attrs['time_scheme_id'] = value
+        when 'alwaysPrivate'
+          converted_attrs['always_private'] = value
+        when 'eventCategory'
+          converted_attrs['event_category'] = value
+        when 'eventColor'
+          converted_attrs['event_color'] = value
+        when 'minChunkSize'
+          converted_attrs['min_chunk_size'] = (value / 4.0) if value
+        when 'maxChunkSize'
+          converted_attrs['max_chunk_size'] = (value / 4.0) if value
+        when 'due'
+          converted_attrs['due_date'] = value
+        else
+          converted_attrs[key.to_s] = value
+        end
+      end
+
+      converted_attrs.each do |key, value|
+        setter = "#{key}="
+        public_send(setter, value) if respond_to?(setter)
+      end
+
+      # Set defaults
+      @priority ||= :p3
+      @duration ||= 1.0
+      @always_private ||= false
+      @deleted ||= false
+      @status ||= 'NEW'
+    end
+
+    # Convert task to hash for API requests
+    def to_h
+      {
+        id: id,
+        title: title,
+        notes: notes,
+        due_date: due_date,
+        priority: priority_for_api,
+        duration: duration,
+        min_chunk_size: min_chunk_size,
+        max_chunk_size: max_chunk_size,
+        min_work_duration: min_work_duration,
+        max_work_duration: max_work_duration,
+        snooze_until: snooze_until,
+        start: start,
+        time_scheme_id: time_scheme_id,
+        always_private: always_private,
+        event_category: event_category,
+        event_color: event_color,
+        status: status,
+        created_at: created_at,
+        updated_at: updated_at,
+        deleted: deleted
+      }.compact
+    end
+
+    # Check if task is active (not deleted and not archived/cancelled)
+    def active?
+      !deleted && !%w[ARCHIVED CANCELLED].include?(status)
+    end
+
+    # Check if task is completed
+    def completed?
+      %w[COMPLETE ARCHIVED].include?(status)
+    end
+
+    # Check if task is overdue
+    def overdue?
+      return false unless due_date && active?
+
+      due_time = parse_datetime(due_date)
+      due_time && due_time < Time.now
+    end
+
+    # Get formatted due date string
+    def due_date_formatted
+      return nil unless due_date
+
+      parsed = parse_datetime(due_date)
+      parsed&.strftime('%Y-%m-%d %H:%M')
+    end
+
+    # Get priority as symbol
+    def priority_symbol
+      case priority
+      when 'P1' then :p1
+      when 'P2' then :p2
+      when 'P3' then :p3
+      when 'P4' then :p4
+      else :p3
+      end
+    end
+
+    private
+
+    # Convert priority symbol to API format
+    def priority_for_api
+      PRIORITIES[priority] || PRIORITIES[priority_symbol] || 'P3'
+    end
+
+    # Parse various datetime formats
+    def parse_datetime(date_string)
+      return nil unless date_string
+
+      Time.parse(date_string.to_s)
+    rescue ArgumentError
+      nil
+    end
+  end
+end

data/lib/reclaim/utils.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require 'time'
+require 'date'
+
+module Reclaim
+  # Utility methods for common operations
+  module Utils
+    # Format task for display
+    def self.format_task(task)
+      status_icon = task.completed? ? "✓" : "○"
+      due_str = task.due_date ? " (due: #{task.due_date_formatted})" : ""
+
+      "#{status_icon} #{task.title}#{due_str}\n" \
+      "   ID: #{task.id} | Priority: #{task.priority} | Status: #{task.status}"
+    end
+
+    # Format task list for display
+    def self.format_task_list(tasks, title = "Tasks")
+      return "No tasks found." if tasks.empty?
+
+      output = "\n#{title}:\n"
+      output += "-" * 50 + "\n"
+
+      tasks.each do |task|
+        output += format_task(task) + "\n"
+      end
+
+      output += "\nTotal: #{tasks.length} tasks\n"
+      output
+    end
+
+    # Parse various date formats into ISO string
+    def self.parse_date(date_input)
+      return nil unless date_input
+
+      case date_input
+      when Time
+        date_input.iso8601
+      when Date
+        date_input.to_time.iso8601
+      when String
+        # Try to parse and convert to ISO format
+        Time.parse(date_input).iso8601
+      else
+        date_input.to_s
+      end
+    rescue ArgumentError
+      date_input.to_s
+    end
+
+    # Format datetime for API (UTC with Z suffix like the Python SDK)
+    def self.format_datetime_for_api(date_input)
+      return nil unless date_input
+
+      case date_input
+      when Time
+        date_input.utc.iso8601
+      when Date
+        date_input.to_time.utc.iso8601
+      when String
+        # Try to parse and convert to UTC ISO format with Z suffix
+        Time.parse(date_input).utc.iso8601
+      else
+        Time.parse(date_input.to_s).utc.iso8601
+      end
+    rescue ArgumentError
+      date_input.to_s
+    end
+
+    # Validate priority value
+    def self.validate_priority(priority)
+      return :p3 unless priority
+
+      priority = priority.to_s.downcase.to_sym
+      Task::PRIORITIES.key?(priority) ? priority : :p3
+    end
+
+    # Validate duration value
+    def self.validate_duration(duration)
+      return 1.0 unless duration
+
+      duration = duration.to_f
+      duration.positive? ? duration : 1.0
+    end
+  end
+end

data/lib/reclaim/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Reclaim
+  VERSION = '0.2.0'
+end

data/lib/reclaim.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# Reclaim API Ruby Library
+#
+# A comprehensive Ruby library for interacting with the Reclaim.ai API.
+# Provides task management functionality with proper error handling,
+# time scheme resolution, and caching.
+#
+# Environment Variables:
+#   RECLAIM_API_KEY - Your Reclaim API token
+#
+# Usage:
+#   require 'reclaim'
+#
+#   client = Reclaim::Client.new
+#
+#   # Create a task
+#   task = client.create_task(
+#     title: 'Important Work',
+#     due_date: '2025-08-15T17:00:00-04:00',
+#     priority: :p1,
+#     duration: 2.0,
+#     time_scheme: 'work'
+#   )
+#
+#   # List tasks
+#   tasks = client.list_tasks(filter: :active)
+#
+#   # Update a task
+#   client.update_task(task.id, title: 'Updated Title')
+#
+#   # Complete a task
+#   client.complete_task(task.id)
+
+# Optionally load environment variables from .env files if dotenv is available.
+# This maintains zero runtime dependencies while supporting convenient local development.
+# Dotenv.load does not overwrite existing ENV vars, so shell variables take precedence.
+# .env files are loaded from the current working directory.
+begin
+  require 'dotenv'
+  Dotenv.load('.env.local', '.env')
+rescue LoadError
+  # dotenv not installed, skip .env loading
+rescue => e
+  # Malformed .env file or other dotenv error - warn but don't crash
+  warn "Warning: Could not load .env file: #{e.message}" if $VERBOSE
+end
+
+require_relative 'reclaim/version'
+require_relative 'reclaim/errors'
+require_relative 'reclaim/task'
+require_relative 'reclaim/utils'
+require_relative 'reclaim/client'
+require_relative 'reclaim/cli'
+
+module Reclaim
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: reclaim
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Benjamin Jackson
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: A comprehensive Ruby library for interacting with the Reclaim.ai API.
+  Provides task management functionality with proper error handling, time scheme resolution,
+  caching, and a command-line interface.
+email:
+- ben@hearmeout.co
+executables:
+- reclaim
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- bin/reclaim
+- lib/reclaim.rb
+- lib/reclaim/cli.rb
+- lib/reclaim/client.rb
+- lib/reclaim/errors.rb
+- lib/reclaim/task.rb
+- lib/reclaim/utils.rb
+- lib/reclaim/version.rb
+homepage: https://github.com/benjaminjackson/reclaim-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/benjaminjackson/reclaim-ruby
+  source_code_uri: https://github.com/benjaminjackson/reclaim-ruby
+  changelog_uri: https://github.com/benjaminjackson/reclaim-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/benjaminjackson/reclaim-ruby/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Ruby client for Reclaim.ai API
+test_files: []