refactor: rename RECLAIM_TOKEN to RECLAIM_API_KEY

Make the environment variable name more intuitive and aligned with
common API key naming conventions.

Changes:
- lib/reclaim/client.rb: Update ENV variable and error message
- lib/reclaim.rb: Update environment variable comment
- README.md: Update all documentation references
- test/test_reclaim.rb: Update all test references

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: benjaminjackson

README.md

@@ -35,7 +35,7 @@ gem 'reclaim'
 Set your Reclaim.ai API token as an environment variable:
 
 ```bash
-export RECLAIM_TOKEN='your_api_token_here'
+export RECLAIM_API_KEY='your_api_token_here'
 ```
 
 Get your API token from your [Reclaim.ai settings](https://app.reclaim.ai/settings/developer).
@@ -46,7 +46,7 @@ If you have the `dotenv` gem installed, the library will automatically load envi
 
 ```bash
 # .env
-RECLAIM_TOKEN='your_api_token_here'
+RECLAIM_API_KEY='your_api_token_here'
 ```
 
 **For users of this gem**: If you're using reclaim-ruby as a library in your own project and want .env file support, add dotenv to your project's Gemfile:
@@ -66,7 +66,7 @@ gem 'dotenv', '~> 2.8'
 ```ruby
 require 'reclaim'
 
-# Initialize client (uses ENV['RECLAIM_TOKEN'] by default)
+# Initialize client (uses ENV['RECLAIM_API_KEY'] by default)
 client = Reclaim::Client.new
 
 # Or pass token explicitly
@@ -286,7 +286,7 @@ bundle install
 # Run unit tests only (no API calls)
 SKIP_INTEGRATION_TESTS=true bundle exec rake test
 
-# Run all tests (requires RECLAIM_TOKEN)
+# Run all tests (requires RECLAIM_API_KEY)
 bundle exec rake test
 
 # Run only integration tests
@@ -308,7 +308,7 @@ Main client for API interactions.
 
 **Methods:**
 
-- `initialize(token = nil)` - Create client (uses ENV['RECLAIM_TOKEN'] if token not provided)
+- `initialize(token = nil)` - Create client (uses ENV['RECLAIM_API_KEY'] if token not provided)
 - `create_task(**options)` - Create a new task
 - `list_tasks(filter: nil)` - List all tasks (filter: :active, :completed, :overdue, or nil)
 - `get_task(task_id)` - Get a specific task by ID

lib/reclaim.rb

@@ -7,7 +7,7 @@
 # time scheme resolution, and caching.
 #
 # Environment Variables:
-#   RECLAIM_TOKEN - Your Reclaim API token
+#   RECLAIM_API_KEY - Your Reclaim API token
 #
 # Usage:
 #   require 'reclaim'

lib/reclaim/client.rb

@@ -11,8 +11,8 @@ class Client
     BASE_URL = 'https://api.app.reclaim.ai/api'
 
     def initialize(token = nil)
-      @token = token || ENV['RECLAIM_TOKEN']
-      raise AuthenticationError, 'RECLAIM_TOKEN environment variable not set' unless @token
+      @token = token || ENV['RECLAIM_API_KEY']
+      raise AuthenticationError, 'RECLAIM_API_KEY environment variable not set' unless @token
 
       @time_schemes_cache = nil
     end

test/test_reclaim.rb

@@ -122,13 +122,13 @@ def test_task_to_hash
 class TestReclaimClient < Minitest::Test
   def setup
     # Set a test token for unit tests
-    @original_token = ENV['RECLAIM_TOKEN']
-    ENV['RECLAIM_TOKEN'] = 'test_token_12345'
+    @original_token = ENV['RECLAIM_API_KEY']
+    ENV['RECLAIM_API_KEY'] = 'test_token_12345'
     @client = Reclaim::Client.new
   end
 
   def teardown
-    ENV['RECLAIM_TOKEN'] = @original_token
+    ENV['RECLAIM_API_KEY'] = @original_token
   end
 
   def test_client_initialization_with_token
@@ -137,17 +137,17 @@ def test_client_initialization_with_token
   end
 
   def test_client_initialization_without_token
-    ENV['RECLAIM_TOKEN'] = nil
+    ENV['RECLAIM_API_KEY'] = nil
 
     error = assert_raises(Reclaim::AuthenticationError) do
       Reclaim::Client.new
     end
 
-    assert_equal 'RECLAIM_TOKEN environment variable not set', error.message
+    assert_equal 'RECLAIM_API_KEY environment variable not set', error.message
   end
 
   def test_client_initialization_with_env_token
-    ENV['RECLAIM_TOKEN'] = 'env_token_test'
+    ENV['RECLAIM_API_KEY'] = 'env_token_test'
     client = Reclaim::Client.new
 
     assert_instance_of Reclaim::Client, client
@@ -408,9 +408,9 @@ def setup
     end
 
     # Validate we have a real API token
-    token = ENV['RECLAIM_TOKEN']
+    token = ENV['RECLAIM_API_KEY']
     if !token || token == 'test_token_12345'
-      skip "Real RECLAIM_TOKEN required for integration tests"
+      skip "Real RECLAIM_API_KEY required for integration tests"
     end
 
     @client = Reclaim::Client.new(token)
@@ -655,14 +655,14 @@ def setup
     @original_argv = ARGV.dup
 
     # Mock environment variable for tests
-    @original_token = ENV['RECLAIM_TOKEN']
-    ENV['RECLAIM_TOKEN'] = 'test_token_for_cli_tests'
+    @original_token = ENV['RECLAIM_API_KEY']
+    ENV['RECLAIM_API_KEY'] = 'test_token_for_cli_tests'
   end
 
   def teardown
     # Restore original ARGV and environment
     ARGV.replace(@original_argv)
-    ENV['RECLAIM_TOKEN'] = @original_token
+    ENV['RECLAIM_API_KEY'] = @original_token
   end
 
   def test_default_command_and_filter_logic
@@ -891,12 +891,12 @@ def capture_io
 
 class TestReclaimEnv < Minitest::Test
   def setup
-    @original_token = ENV['RECLAIM_TOKEN']
+    @original_token = ENV['RECLAIM_API_KEY']
     @original_load_path = $LOAD_PATH.dup
   end
 
   def teardown
-    ENV['RECLAIM_TOKEN'] = @original_token
+    ENV['RECLAIM_API_KEY'] = @original_token
     $LOAD_PATH.replace(@original_load_path)
   end
 
@@ -964,13 +964,13 @@ def test_integration_env_loading_on_require
 
     begin
       FileUtils.mkdir_p(test_project_dir)
-      File.write(env_file, "RECLAIM_TOKEN=integration_test_token\n")
+      File.write(env_file, "RECLAIM_API_KEY=integration_test_token\n")
 
-      # Run in subprocess with clean environment (unset RECLAIM_TOKEN)
+      # Run in subprocess with clean environment (unset RECLAIM_API_KEY)
       lib_path = File.expand_path('../../lib', __FILE__)
       result = Dir.chdir(test_project_dir) do
-        # Use env to unset RECLAIM_TOKEN before running ruby
-        `env -u RECLAIM_TOKEN ruby -I#{lib_path} -e "require 'reclaim'; puts ENV['RECLAIM_TOKEN']" 2>&1`
+        # Use env to unset RECLAIM_API_KEY before running ruby
+        `env -u RECLAIM_API_KEY ruby -I#{lib_path} -e "require 'reclaim'; puts ENV['RECLAIM_API_KEY']" 2>&1`
       end
 
       # Verify the .env file was loaded
@@ -1018,14 +1018,14 @@ def test_graceful_fallback_without_dotenv
   end
 
   def test_reclaim_token_from_environment
-    # Verify that RECLAIM_TOKEN can be set and used
-    ENV['RECLAIM_TOKEN'] = 'test_token_value'
+    # Verify that RECLAIM_API_KEY can be set and used
+    ENV['RECLAIM_API_KEY'] = 'test_token_value'
 
     client = Reclaim::Client.new
     assert_equal 'test_token_value', client.instance_variable_get(:@token)
 
     # Clean up
-    ENV['RECLAIM_TOKEN'] = @original_token
+    ENV['RECLAIM_API_KEY'] = @original_token
   end
 end