moco-ruby 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94fd15c735a242e23f7a1e20dd49408d12dbfbb21f1665ca64bfd85ba3251cae
-  data.tar.gz: 710f5ce6be51b2c363c6d2b3df871d755e5b21e90e9ad53cbb535ac249b46b6f
+  metadata.gz: 7527d151ba5f10b9406932d5f6e488d73897fab49ef9ab9a89341166adde7d42
+  data.tar.gz: ce1efd8024e78ab0541229172735ac27c8ec4595eeaf86d3183bc09d72b59504
 SHA512:
-  metadata.gz: 272eede87d5a02636ca02354ea0ef592f0d21662378fb6817b68cc6fa73e66922b43623f6ac5da5c4c76ac3db9c6ebaee12a340fcc9920df93104303f96668fd
-  data.tar.gz: 12f55e014641e51ecf2f666c04bff0a5f330ae68b91cf63e70060b6f85e5fc759eed517854060190651581a7ffba5bfa8345fdd25b8e2e59a96193a32cdece9a
+  metadata.gz: ecad34b5401422a64351c4814c262ad9328bde6cdfa096f2295ae58b5aa56aa015dbd2c06905a6c212a6efa3b13236c45df12dd8534c15861d61dbb5071630bd
+  data.tar.gz: fe46f175939e575b1b63459a10b2ababb5137e4fae30230e59ea45185c996f6e52e9b56ecc11184a2a8fc8a7c28deda74d134594a0940cc3358d7100b4cd735b

data/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-01-14
+
+### Added
+- Complete MOCO API coverage with 48+ entity types
+- New entities: Offer, Contact, Tagging, DealCategory, CatalogService, CustomProperty,
+  ExpenseTemplate, FixedCost, HourlyRate, InternalHourlyRate, TaskTemplate, UserRole,
+  VatCodeSale, VatCodePurchase, Profile, WorkTimeAdjustment, ProjectContract,
+  PaymentSchedule, RecurringExpense, InvoicePayment, InvoiceReminder, OfferApproval,
+  PurchaseCategory, PurchaseDraft, ProjectGroup, InvoiceBookkeepingExport,
+  PurchaseBookkeepingExport, PurchaseBudget, PurchasePayment
+- Inline attribute documentation for all entity classes
+- Reports API support via `moco.reports.absences`, `.cashflow`, `.finance`, `.utilization`
+- Integration tests for all entity types
+- GitHub Actions CI for tests and auto-release
+- Ruby 4.0 support
+
+### Fixed
+- Debug output now correctly shows request body for POST/PUT/PATCH requests
+
+## [1.1.0] - 2025-11-15
+
+### Added
+- Support for limited-permission accounts with auto-create missing tasks
+- `--default-task` flag for limited-permission accounts
+- `copy_project` tool for copying projects between MOCO instances
+
+### Fixed
+- Enable auto-require for Bundler
+- Loosen dependency constraints for Rails 8 compatibility
+
+### Security
+- Update rexml to 3.4.4 to fix CVE-2025-58767
+
 ## [1.0.0] - 2025-10-08
 
 ### Fixed
@@ -125,7 +158,9 @@
 ## [0.1.0] - 2024-02-27
 - Initial release
 
-[Unreleased]: https://github.com/starsong-consulting/moco-ruby/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/starsong-consulting/moco-ruby/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/starsong-consulting/moco-ruby/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/starsong-consulting/moco-ruby/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/starsong-consulting/moco-ruby/compare/v1.0.0.beta...v1.0.0
 [1.0.0.beta]: https://github.com/starsong-consulting/moco-ruby/compare/v1.0.0.alpha...v1.0.0.beta
 [1.0.0.alpha]: https://github.com/starsong-consulting/moco-ruby/compare/v1.0.0.alpha-initial...v1.0.0.alpha

data/Gemfile.lock

@@ -1,67 +1,70 @@
 PATH
   remote: .
   specs:
-    moco-ruby (1.0.0)
-      activesupport (~> 7.0)
-      faraday (~> 2.9.0)
+    moco-ruby (1.2.0)
+      activesupport (>= 7.0)
+      faraday (>= 2.0)
       fuzzy_match (~> 2.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.2.2.1)
+    activesupport (8.1.2)
       base64
-      benchmark (>= 0.3)
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      json
       logger (>= 1.4.2)
       minitest (>= 5.1)
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+      uri (>= 0.13.1)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
-    base64 (0.2.0)
-    benchmark (0.4.0)
-    bigdecimal (3.1.9)
-    concurrent-ruby (1.3.5)
-    connection_pool (2.5.0)
-    crack (1.0.0)
+    base64 (0.3.0)
+    bigdecimal (4.0.1)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    crack (1.0.1)
       bigdecimal
       rexml
     dotenv (2.8.1)
-    drb (2.2.1)
-    faraday (2.9.2)
-      faraday-net_http (>= 2.0, < 3.2)
-    faraday-net_http (3.1.1)
-      net-http
+    drb (2.2.3)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
     fuzzy_match (2.1.0)
-    hashdiff (1.1.2)
-    i18n (1.14.7)
+    hashdiff (1.2.1)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
-    json (2.10.2)
-    language_server-protocol (3.17.0.4)
+    json (2.18.0)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    minitest (5.25.5)
-    net-http (0.6.0)
-      uri
-    parallel (1.26.3)
-    parser (3.3.7.4)
+    minitest (6.0.1)
+      prism (~> 1.5)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    parallel (1.27.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    power_assert (2.0.5)
-    prism (1.4.0)
-    public_suffix (6.0.1)
+    power_assert (3.0.1)
+    prism (1.7.0)
+    public_suffix (7.0.2)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.10.0)
-    rexml (3.4.1)
-    rubocop (1.75.2)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rubocop (1.82.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -69,23 +72,23 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.44.0)
+    rubocop-ast (1.49.0)
       parser (>= 3.3.7.2)
-      prism (~> 1.4)
+      prism (~> 1.7)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
-    test-unit (3.6.8)
+    test-unit (3.7.7)
       power_assert
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (3.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
-    uri (1.0.3)
-    webmock (3.25.1)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    webmock (3.26.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -93,6 +96,7 @@ GEM
 PLATFORMS
   arm64-darwin-22
   arm64-darwin-23
+  x86_64-linux
 
 DEPENDENCIES
   dotenv (~> 2.8)

data/README.md

@@ -167,25 +167,54 @@ puts "Billable tasks: #{billable_tasks.map(&:name).join(', ')}"
 dev_task = project.tasks.find_by(name: "Development")
 ```
 
+### Profile
+
+Access the current user's profile:
+
+```ruby
+profile = moco.profile
+puts "Logged in as: #{profile.firstname} #{profile.lastname}"
+```
+
+### Reports
+
+Access read-only report endpoints:
+
+```ruby
+# Absences report
+absences = moco.reports.absences(year: 2024)
+
+# Utilization report (requires date range)
+utilization = moco.reports.utilization(from: "2024-01-01", to: "2024-12-31")
+
+# Financial reports
+cashflow = moco.reports.cashflow(from: "2024-01-01", to: "2024-03-31")
+finance = moco.reports.finance(from: "2024-01-01", to: "2024-03-31")
+```
+
 ### Supported Entities
 
 The gem supports all MOCO API entities with a Ruby-esque interface:
 
-- `Project`
-- `Activity`
-- `User`
-- `Company`
-- `Task`
-- `Invoice`
-- `Deal`
-- `Expense`
-- `WebHook`
-- `Schedule`
-- `Presence`
-- `Holiday`
-- `PlanningEntry`
-
-Access them via the moco using their plural, snake_case names (e.g., `moco.planning_entries`).
+**Core:**
+`Project`, `Activity`, `User`, `Company`, `Task`, `Invoice`, `Deal`, `Expense`, `WebHook`, `Schedule`, `Presence`, `Holiday`, `PlanningEntry`
+
+**Business:**
+`Contact`, `Offer`, `Purchase`, `Receipt`, `Comment`, `Tag`, `Tagging`, `DealCategory`, `ProjectGroup`, `Unit`
+
+**Account Settings:**
+`CatalogService`, `CustomProperty`, `ExpenseTemplate`, `FixedCost`, `HourlyRate`, `InternalHourlyRate`, `TaskTemplate`, `UserRole`
+
+**Financial:**
+`VatCodeSale`, `VatCodePurchase`, `PurchaseCategory`, `PurchaseDraft`, `PurchaseBudget`, `PurchasePayment`
+
+**Bookkeeping:**
+`InvoiceBookkeepingExport`, `PurchaseBookkeepingExport`
+
+**Nested Resources:**
+`Employment`, `WorkTimeAdjustment`, `ProjectContract`, `PaymentSchedule`, `RecurringExpense`, `InvoicePayment`, `InvoiceReminder`, `OfferApproval`
+
+Access them via the client using their plural, snake_case names (e.g., `moco.planning_entries`, `moco.vat_code_sales`).
 
 ## Utilities
 
@@ -226,26 +255,36 @@ Usage: sync_activity.rb [options] source_subdomain target_subdomain
         --match-project-threshold VALUE
                                      Fuzzy match threshold for projects (0.0 - 1.0), default 0.8
         --match-task-threshold VALUE Fuzzy match threshold for tasks (0.0 - 1.0), default 0.45
+        --default-task TASK_NAME     Map unmatched tasks to this default task instead of creating new tasks
+    -d, --debug                      Enable debug output
     -h, --help                       Show this message
 ```
 **Example:** `sync_activity.rb --from 2024-04-01 --to 2024-04-10 --dry-run source-instance target-instance`
 
+**Using Default Task Mapping:** If your target account has limited permissions and cannot create tasks, or if you want to consolidate multiple source tasks into a single target task, use the `--default-task` flag:
+
+```bash
+sync_activity.rb --from 2024-04-01 --to 2024-04-10 --default-task "Other" source-instance target-instance
+```
+
+This will map any unmatched source tasks to a task named "Other" in the corresponding target project, avoiding the need to create new tasks.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies.
 
 ### Running Tests
 
-The gem includes a comprehensive test suite with both unit tests (mocked) and integration tests (live API):
+The gem includes unit tests (mocked) and integration tests (live API):
 
 ```bash
-# Run all tests
-ruby test/test_v2_api.rb              # Unit tests (mocked, fast)
-ruby test/test_comprehensive.rb       # Integration tests (requires .env)
-ruby test/test_holidays_expenses.rb   # Holidays & Expenses tests (requires .env)
+# Unit tests (mocked, fast)
+bundle exec ruby -Ilib -Itest test/test_v2_api.rb
+bundle exec ruby -Ilib -Itest test/test_new_entities.rb
 
-# Or run individually
-ruby test/test_v2_api.rb
+# Integration tests (requires .env credentials)
+bundle exec ruby -Ilib -Itest test/test_integration.rb
+bundle exec ruby -Ilib -Itest test/test_comprehensive.rb
 ```
 
 For integration tests, create a `.env` file with your test instance credentials:
@@ -254,7 +293,7 @@ MOCO_API_TEST_SUBDOMAIN=your-test-subdomain
 MOCO_API_TEST_API_KEY=your-test-api-key
 ```
 
-**Note:** The MOCO API has rate limits (120 requests per 2 minutes on standard plans). Integration tests make real API calls.
+**Note:** The MOCO API has rate limits. The gem automatically retries rate-limited requests with exponential backoff.
 
 ### Installation
 
@@ -268,4 +307,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/starso
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).

data/copy_project.rb

@@ -0,0 +1,337 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require "yaml"
+require "fuzzy_match"
+require_relative "lib/moco"
+
+options = {
+  dry_run: false,
+  verbose: false,
+  copy_activities: true
+}
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{$PROGRAM_NAME} [options] source_instance target_instance project_identifier"
+
+  opts.on("-n", "--dry-run", "Show what would be copied without making changes") do
+    options[:dry_run] = true
+  end
+
+  opts.on("-v", "--verbose", "Enable verbose output") do
+    options[:verbose] = true
+  end
+
+  opts.on("--no-activities", "Skip copying activities (only copy project and tasks)") do
+    options[:copy_activities] = false
+  end
+
+  opts.on("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+end.parse!
+
+source_instance = ARGV.shift
+target_instance = ARGV.shift
+project_identifier = ARGV.shift
+
+if source_instance.nil? || target_instance.nil? || project_identifier.nil?
+  warn "Error: source_instance, target_instance, and project_identifier are required"
+  warn "Usage: #{$PROGRAM_NAME} [options] source_instance target_instance project_identifier"
+  exit 1
+end
+
+# Load configuration
+config = YAML.load_file("config.yml")
+source_config = config["instances"].fetch(source_instance, nil)
+target_config = config["instances"].fetch(target_instance, nil)
+
+if source_config.nil?
+  warn "Error: Source instance '#{source_instance}' not found in config.yml"
+  exit 1
+end
+
+if target_config.nil?
+  warn "Error: Target instance '#{target_instance}' not found in config.yml"
+  exit 1
+end
+
+# Initialize clients
+puts "Connecting to instances..."
+source_client = MOCO::Client.new(subdomain: source_instance, api_key: source_config["api_key"])
+target_client = MOCO::Client.new(subdomain: target_instance, api_key: target_config["api_key"])
+
+def log(message, verbose: false, options:)
+  return if verbose && !options[:verbose]
+  puts message
+end
+
+def get_id(obj)
+  return nil if obj.nil?
+  return obj[:id] if obj.is_a?(Hash)
+  return obj.id if obj.respond_to?(:id)
+  nil
+end
+
+def find_or_create_customer(source_customer, target_client, options)
+  log("Looking for customer '#{source_customer.name}' in target...", options: options)
+
+  # Try to find the customer by name
+  target_customers = target_client.companies.all
+  target_customer = target_customers.find { |c| c.name == source_customer.name }
+
+  if target_customer
+    log("✅ Found existing customer: #{target_customer.name} (ID: #{target_customer.id})", options: options)
+    return target_customer
+  end
+
+  log("Customer not found, creating new customer...", options: options)
+
+  if options[:dry_run]
+    log("🔍 [DRY RUN] Would create customer: #{source_customer.name}", options: options)
+    return nil
+  end
+
+  # Create the customer
+  customer_attrs = {
+    name: source_customer.name,
+    type: "customer"
+  }
+
+  # Add optional attributes if they exist
+  customer_attrs[:type] = source_customer.type if source_customer.respond_to?(:type) && source_customer.type
+  customer_attrs[:currency] = source_customer.currency if source_customer.respond_to?(:currency) && source_customer.currency
+  customer_attrs[:website] = source_customer.website if source_customer.respond_to?(:website) && source_customer.website
+  customer_attrs[:address] = source_customer.address if source_customer.respond_to?(:address) && source_customer.address
+  customer_attrs[:info] = source_customer.info if source_customer.respond_to?(:info) && source_customer.info
+  customer_attrs[:custom_properties] = source_customer.custom_properties if source_customer.respond_to?(:custom_properties) && source_customer.custom_properties
+  customer_attrs[:labels] = source_customer.labels if source_customer.respond_to?(:labels) && source_customer.labels
+
+  log("Creating customer: #{customer_attrs[:name]}", verbose: true, options: options)
+  new_customer = target_client.companies.create(customer_attrs)
+  log("✅ Created customer: #{new_customer.name} (ID: #{new_customer.id})", options: options)
+
+  new_customer
+end
+
+def copy_tasks(source_project, target_project, target_client, options)
+  log("\nCopying tasks...", options: options)
+  task_mapping = {}
+
+  source_tasks = source_project.tasks
+  log("Found #{source_tasks.count} tasks in source project", options: options)
+
+  source_tasks.each do |source_task|
+    log("  Task: #{source_task.name}", verbose: true, options: options)
+
+    if options[:dry_run]
+      log("  🔍 [DRY RUN] Would create task: #{source_task.name}", options: options)
+      next
+    end
+
+    # Create the task in the target project
+    task_attrs = {
+      name: source_task.name,
+      billable: source_task.billable,
+      active: source_task.active
+    }
+
+    # Add optional attributes if they exist
+    source_task_attrs = source_task.instance_variable_get(:@attributes)
+    task_attrs[:budget] = source_task_attrs[:budget] if source_task_attrs[:budget]
+    task_attrs[:hourly_rate] = source_task_attrs[:hourly_rate] if source_task_attrs[:hourly_rate]
+
+    log("  Creating task: #{task_attrs[:name]}", verbose: true, options: options)
+    # Use the NestedCollectionProxy to create the task
+    task_proxy = MOCO::NestedCollectionProxy.new(target_client, target_project, :tasks, "Task")
+    new_task = task_proxy.create(task_attrs)
+    task_mapping[source_task.id] = new_task
+    log("  ✅ Created task: #{new_task.name} (ID: #{new_task.id})", options: options)
+  end
+
+  task_mapping
+end
+
+def copy_activities(source_project, target_project, task_mapping, source_client, target_client, options)
+  log("\nCopying activities...", options: options)
+
+  # Get all activities for the source project
+  source_activities = source_client.activities.where(project_id: source_project.id).all
+  log("Found #{source_activities.count} activities in source project", options: options)
+
+  created_count = 0
+  skipped_count = 0
+
+  source_activities.each do |source_activity|
+    log("  Activity: #{source_activity.date} - #{source_activity.hours}h - #{source_activity.description}", verbose: true, options: options)
+
+    if options[:dry_run]
+      log("  🔍 [DRY RUN] Would create activity: #{source_activity.date} - #{source_activity.hours}h", options: options)
+      next
+    end
+
+    # Map the task
+    target_task = task_mapping[source_activity.task&.id]
+
+    if source_activity.task && !target_task
+      log("  ⚠️  Skipping activity - task not mapped: #{source_activity.task.name}", options: options)
+      skipped_count += 1
+      next
+    end
+
+    # Create the activity in the target project
+    activity_attrs = {
+      date: source_activity.date,
+      hours: source_activity.hours,
+      description: source_activity.description,
+      project_id: target_project.id,
+      billable: source_activity.billable,
+      tag: source_activity.tag,
+      remote_service: source_activity.remote_service,
+      remote_id: source_activity.id.to_s # Store original ID for reference
+    }
+
+    activity_attrs[:task_id] = target_task.id if target_task
+
+    log("  Creating activity: #{activity_attrs[:date]} - #{activity_attrs[:hours]}h", verbose: true, options: options)
+
+    begin
+      new_activity = target_client.activities.create(activity_attrs)
+      created_count += 1
+      log("  ✅ Created activity: #{new_activity.date} - #{new_activity.hours}h (ID: #{new_activity.id})", verbose: true, options: options)
+    rescue => e
+      log("  ❌ Error creating activity: #{e.message}", options: options)
+      skipped_count += 1
+    end
+  end
+
+  log("\n✅ Created #{created_count} activities", options: options)
+  log("⚠️  Skipped #{skipped_count} activities", options: options) if skipped_count > 0
+end
+
+# Main execution
+begin
+  log("=" * 80, options: options)
+  log("MOCO Project Copy Tool", options: options)
+  log("=" * 80, options: options)
+  log("Source: #{source_instance}", options: options)
+  log("Target: #{target_instance}", options: options)
+  log("Project: #{project_identifier}", options: options)
+  log("Mode: #{options[:dry_run] ? 'DRY RUN' : 'LIVE'}", options: options)
+  log("=" * 80, options: options)
+
+  # Find the source project
+  log("\nFinding source project...", options: options)
+  source_project = source_client.projects.where(identifier: project_identifier).all.first
+
+  if source_project.nil?
+    warn "Error: Project '#{project_identifier}' not found in source instance"
+    exit 1
+  end
+
+  log("✅ Found project: #{source_project.name} (ID: #{source_project.id})", options: options)
+  log("   Identifier: #{source_project.identifier}", verbose: true, options: options)
+  log("   Status: #{source_project.active ? 'Active' : 'Inactive'}", verbose: true, options: options)
+
+  # Get the customer
+  source_customer = source_project.customer
+  if source_customer.nil?
+    warn "Error: Project has no associated customer"
+    exit 1
+  end
+
+  log("   Customer: #{source_customer.name} (ID: #{source_customer.id})", options: options)
+
+  # Find or create the customer in the target
+  target_customer = find_or_create_customer(source_customer, target_client, options)
+
+  if options[:dry_run]
+    log("\n🔍 [DRY RUN] Would create project: #{source_project.name}", options: options)
+    log("   Identifier: #{source_project.identifier}", options: options)
+    log("   Customer: #{source_customer.name}", options: options)
+
+    # Still show what tasks would be copied
+    copy_tasks(source_project, source_project, target_client, options)
+
+    if options[:copy_activities]
+      log("\n🔍 [DRY RUN] Would copy activities...", options: options)
+      source_activities = source_client.activities.where(project_id: source_project.id).all
+      log("   Found #{source_activities.count} activities to copy", options: options)
+    end
+
+    log("\n" + "=" * 80, options: options)
+    log("DRY RUN COMPLETE - No changes made", options: options)
+    log("=" * 80, options: options)
+    exit 0
+  end
+
+  # Create the project in the target
+  log("\nCreating project in target...", options: options)
+
+  # Access attributes directly from the source project
+  source_attrs = source_project.instance_variable_get(:@attributes)
+
+  project_attrs = {
+    name: source_project.name,
+    identifier: source_project.identifier,
+    customer_id: target_customer.id,
+    currency: source_project.currency,
+    billable: source_project.billable,
+    fixed_price: source_attrs[:fixed_price] || false,
+    retainer: source_attrs[:retainer] || false,
+    finish_date: source_attrs[:finish_date],
+    start_date: source_attrs[:start_date]
+  }
+
+  # Get a default user from the target instance as leader
+  # TODO: implement proper user mapping between instances (match by name/email)
+  target_users = target_client.users.all
+  if target_users.empty?
+    raise "No users found in target instance - cannot set project leader"
+  end
+  project_attrs[:leader_id] = target_users.first.id
+  log("Using default leader: #{target_users.first.firstname} #{target_users.first.lastname} (ID: #{target_users.first.id})", verbose: true, options: options)
+
+  # Add optional attributes if they exist
+  project_attrs[:co_leader_id] = get_id(source_attrs[:co_leader]) if source_attrs[:co_leader]
+  project_attrs[:budget] = source_attrs[:budget] if source_attrs[:budget]
+  project_attrs[:budget_monthly] = source_attrs[:budget_monthly] if source_attrs[:budget_monthly]
+  project_attrs[:budget_expenses] = source_attrs[:budget_expenses] if source_attrs[:budget_expenses]
+  project_attrs[:hourly_rate] = source_attrs[:hourly_rate] if source_attrs[:hourly_rate]
+  project_attrs[:custom_properties] = source_attrs[:custom_properties] if source_attrs[:custom_properties]
+  project_attrs[:labels] = source_attrs[:labels] if source_attrs[:labels]
+  project_attrs[:tags] = source_attrs[:tags] if source_attrs[:tags]
+  project_attrs[:info] = source_attrs[:info] if source_attrs[:info]
+  project_attrs[:billing_address] = source_attrs[:billing_address] if source_attrs[:billing_address]
+  project_attrs[:billing_variant] = source_attrs[:billing_variant] if source_attrs[:billing_variant]
+
+  log("Creating project: #{project_attrs[:name]}", verbose: true, options: options)
+  target_project = target_client.projects.create(project_attrs)
+  log("✅ Created project: #{target_project.name} (ID: #{target_project.id})", options: options)
+
+  # Copy tasks
+  task_mapping = copy_tasks(source_project, target_project, target_client, options)
+
+  # Copy activities if requested
+  if options[:copy_activities]
+    copy_activities(source_project, target_project, task_mapping, source_client, target_client, options)
+  else
+    log("\nSkipping activities (--no-activities specified)", options: options)
+  end
+
+  log("\n" + "=" * 80, options: options)
+  log("✅ PROJECT COPY COMPLETE", options: options)
+  log("=" * 80, options: options)
+  log("Source project: #{source_project.name} (#{source_instance})", options: options)
+  log("Target project: #{target_project.name} (#{target_instance})", options: options)
+  log("Target project ID: #{target_project.id}", options: options)
+  log("Target project URL: https://#{target_instance}.mocoapp.com/projects/#{target_project.id}", options: options)
+  log("=" * 80, options: options)
+
+rescue => e
+  warn "\n❌ Error: #{e.message}"
+  warn e.backtrace.join("\n") if options[:verbose]
+  exit 1
+end