versacommerce-cli 0.2.3 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: dc48bd66e513f0e6526ab288844e78457e58ea91
-  data.tar.gz: 66d12de31dd7a2a4330f810c1c1d3c658e0f9bbc
+SHA256:
+  metadata.gz: ce6e6eb254839dc2b0430f8c38d723e66d1e48b6b19ed9c80fe4c1de6a78db29
+  data.tar.gz: adb69f5b440ff0f018207f852c5b58c9500070d1b49844decfad159238021ce9
 SHA512:
-  metadata.gz: e2a905a388313e5897fef9dfa98951a3abd652997a86a91b170b22180d0edde5401041d265bc16928ad0275a9ae9f2558637fabda799bcf9b78ecf075a24a397
-  data.tar.gz: 2dc4b4592a839c4cce6a4f3163ca734fe0e90f49384ae13704f49fc5768ea958514bcf34c759bbb0abe15e9923fdcdbc98b0b9a45e64006da103e509892bf5eb
+  metadata.gz: f2e909f28e56fd257a3dd47ca595b46b5900203c60381e4ca6c2f1f578d78da1346f3db52e050c2bfa45f7abdcc720db88e48a21b50dcf34a4e902bad6ab130a
+  data.tar.gz: 6e06f2cf2048def28ab240226fa430d09cc3c7b8acfe9bc76810f8ebbe4e3ba6f984f2a2612f73e13c6cf2d80c575c45bda31d3b9e0f327dd0b725ea321bec99

data/.claude/commands/bump-version.md

@@ -0,0 +1,18 @@
+# Bump version
+
+This command bump version, changes CHANGELOG.md if exists, commit and push changes.
+
+## Usage
+
+```
+/bump-version
+```
+
+## Process
+
+1. Find current app version in config/version.rb or in CHANGELOG.md
+2. Bump the app version number - new features should increase the minor version number, bug fixes should increase the patch version number. Breaking changes should increase the major version number. Follow [Semantic Versioning](https://semver.org/).
+3. Update config/version.rb if exists
+4. Update CHANGELOG.md if exists, ask user which changes that in not released section should be included in new version.
+5. commit the changes with a short, but descriptive message
+6. Ask user approval to push the changes to the remote repository

data/.claude/commands/code-review.md

@@ -0,0 +1,56 @@
+# Comprehensive Code Quality Review
+
+Perform comprehensive code quality review
+
+## Instructions
+
+Follow these steps to conduct a thorough code review:
+
+1. **Repository Analysis**
+    - Examine the repository structure and identify the primary language/framework
+    - Check for configuration files (package.json, requirements.txt, Cargo.toml, etc.)
+    - Review README and documentation for context
+
+2. **Code Quality Assessment**
+    - Scan for code smells, anti-patterns, and potential bugs
+    - Check for consistent coding style and naming conventions
+    - Identify unused imports, variables, or dead code
+    - Review error handling and logging practices
+
+3. **Security Review**
+    - Look for common security vulnerabilities (SQL injection, XSS, etc.)
+    - Check for hardcoded secrets, API keys, or passwords
+    - Review authentication and authorization logic
+    - Examine input validation and sanitization
+
+4. **Performance Analysis**
+    - Identify potential performance bottlenecks
+    - Check for inefficient algorithms or database queries
+    - Review memory usage patterns and potential leaks
+    - Analyze bundle size and optimization opportunities
+
+5. **Architecture & Design**
+    - Evaluate code organization and separation of concerns
+    - Check for proper abstraction and modularity
+    - Review dependency management and coupling
+    - Assess scalability and maintainability
+
+6. **Testing Coverage**
+    - Check existing test coverage and quality
+    - Identify areas lacking proper testing
+    - Review test structure and organization
+    - Suggest additional test scenarios
+
+7. **Documentation Review**
+    - Evaluate code comments and inline documentation
+    - Check API documentation completeness
+    - Review README and setup instructions
+    - Identify areas needing better documentation
+
+8. **Recommendations**
+    - Prioritize issues by severity (critical, high, medium, low)
+    - Provide specific, actionable recommendations
+    - Suggest tools and practices for improvement
+    - Create a summary report with next steps
+
+Remember to be constructive and provide specific examples with file paths and line numbers where applicable.

data/.claude/commands/new-task.md

@@ -0,0 +1,27 @@
+# Onboard
+You are given the following context:
+SARGUMENTS
+
+## Instructions
+"Al models are geniuses who start from scratch on every task." - Noam Brown
+
+Your job is to "onboard" yourself to the current task.
+Do this by:
+-   Using ultrathink
+-   Exploring the codebase
+-   Asking me questions if needed
+
+The goal is to get you fully prepared to start working on the task.
+Take as long as you need to get yourself ready. Overdoing it is better than underdoing it.
+
+Record everything in a .claude/tasks/[TASK_ID]/onboarding.md file. Save this file as soon as you have enough information to start working on the task. Save updates to this file as you go along.
+This file will be used to onboard you to the task in a new session if needed, so make sure it's comprehensive.
+
+Important:
+- The solution should generate as little code as possible
+- The solution should adhere to the existing patterns of the application
+- Implementation should be professional and lean: not everything that is possible, but only what is necessary
+
+Always add testing instructions for any new features or changes made. Beweise, dass deine durchgeführten Tests Real und Fehlerfrei sind.
+
+IMPORTANT: Create your todos AFTER creation of the comprehensive onboarding document.

data/.claude/commands/verco.md

@@ -0,0 +1,5 @@
+1. Analyze the changes made in this version
+2. bump the app version number (config/version.rb) - new features should increase the minor version number, bug fixes should increase the patch version number. breaking changes should increase the major version number.
+3. update a changelog file (CHANGELOG.md) with a short message to reflect the changes made in this version
+4. commit the changes with a short, but descriptive message, include version number
+5. push the changes to the remote repository

data/.claude/tasks/ruby-3.3-upgrade/onboarding.md

@@ -0,0 +1,350 @@
+# Ruby 2.6.9 to 3.3 Upgrade - Onboarding Document
+
+## Task Overview
+Upgrade the versacommerce-cli Ruby gem from Ruby 2.6.9 to Ruby 3.3, ensuring all dependencies are compatible and code follows Ruby 3.3 best practices.
+
+## Current State Analysis
+
+### Project Information
+- **Gem Name**: versacommerce-cli
+- **Current Version**: 0.2.3
+- **Type**: Ruby CLI tool for VersaCommerce Theme API
+- **Main Executable**: `vc-theme`
+- **Current Ruby Requirement**: >= 2.0.0 (very permissive)
+- **LOC**: ~220 lines of Ruby code across 4 files
+
+### System Ruby Version
+- Currently running: Ruby 3.1.3p185
+- Target: Ruby 3.3.x
+
+### Core Functionality
+1. **download** - Downloads theme from API to local directory
+2. **watch** - Monitors file changes and syncs to API in real-time
+3. **upload** - Uploads directory tree to API
+
+## Critical Issues Identified
+
+### 🚨 SECURITY VULNERABILITY: YAML.load_file
+**File**: `lib/versacommerce/cli/theme.rb`
+**Lines**: 160, 166, 173
+
+```ruby
+# Current (INSECURE):
+YAML.load_file(config)
+
+# Required (SECURE):
+YAML.load_file(config, permitted_classes: [Symbol])
+```
+
+**Why Critical**:
+- Deprecated in Ruby 3.1+
+- Arbitrary code execution vulnerability
+- Will be removed in future Ruby versions
+
+### 🔴 OUTDATED DEPENDENCIES (10 years old!)
+
+#### Runtime Dependencies
+| Gem | Current | Age | Target | Risk Level |
+|-----|---------|-----|--------|------------|
+| thor | 0.19.1 (exact) | 2015 | ~> 1.3 | HIGH |
+| listen | ~> 2.10 | 2015 | ~> 3.9 | HIGH |
+| colorize | 0.7.5 (exact) | 2015 | ~> 1.1 | LOW |
+| versacommerce-theme_api_client | 0.1.3 (exact) | Unknown | TBD | **UNKNOWN** |
+
+#### Development Dependencies
+| Gem | Current | Target | Risk Level |
+|-----|---------|--------|------------|
+| bundler | ~> 1.8 | >= 1.8 | MEDIUM |
+| rake | ~> 10.4 | ~> 13.0 | LOW |
+| pry | 0.10.1 (exact) | ~> 0.14 | LOW |
+| pry-stack_explorer | 0.4.9.2 (exact) | ~> 0.6 | LOW |
+
+**Key Problem**: Exact version pins (0.19.1, 0.7.5) prevent security updates!
+
+### ⚠️ POTENTIAL BLOCKER: versacommerce-theme_api_client
+
+**Status**: UNKNOWN Ruby 3.3 compatibility
+**Risk**: Could be complete blocker if incompatible
+**Action Required**: Must investigate this dependency before proceeding
+
+## Code Compatibility Analysis
+
+### ✅ Already Compatible
+- **Keyword arguments**: Correct Ruby 3.0+ syntax already in use
+- **Hash syntax**: Modern syntax (`key: value`)
+- **File operations**: Using Pathname and FileUtils properly
+- **No deprecated Ruby 2.x patterns found**
+
+### 🔧 Needs Fixing
+1. **YAML.load_file** (3 instances) - Security + deprecation
+2. **Gemspec dependency versions** (all outdated)
+3. **Documentation** (README.md mentions Ruby 2.0.0)
+
+### 💡 Optional Improvements
+- String formatting: `'[%s] -- %s' % [time, message]` → `"[#{time}] -- #{message}"`
+- Add `.ruby-version` file for consistency
+- Add basic tests (currently NO tests exist)
+
+## Files Requiring Changes
+
+### Must Modify:
+1. `versacommerce-cli.gemspec` (lines 21, 23-31)
+   - Update required_ruby_version
+   - Update all dependencies
+
+2. `lib/versacommerce/cli/theme.rb` (lines 160, 166, 173)
+   - Fix YAML.load_file security issue
+
+3. `README.md` (line 9)
+   - Update Ruby version requirement
+
+### Should Create:
+4. `.ruby-version` (optional but recommended)
+   - Ensures consistent Ruby version across environments
+
+## Ruby 2.6.9 → 3.3 Breaking Changes Impact
+
+| Change | Impact | Action Required |
+|--------|--------|-----------------|
+| Keyword arguments separation | ✅ None | Already using correct syntax |
+| YAML.load deprecation | 🚨 High | Must fix 3 instances |
+| Hash behavior changes | ✅ None | Using modern syntax |
+| String/Symbol handling | ✅ None | No issues found |
+| Integer division | ✅ None | Not used in code |
+| Pattern matching | ✅ None | Not used |
+
+## Testing Strategy
+
+### Current Test Coverage: **0%**
+- No `/test` directory
+- No `/spec` directory
+- No CI/CD configuration
+- **Risk**: No automated validation of changes
+
+### Manual Testing Required:
+1. **Install dependencies**: `bundle install` with new Gemfile.lock
+2. **CLI help commands**: Test all `--help` outputs
+3. **Config loading**: Test all 5 authorization methods
+4. **File operations**: Test download/upload/watch if possible
+
+### Testing Commands:
+```bash
+# Basic functionality
+bundle exec vc-theme --help
+bundle exec vc-theme download --help
+bundle exec vc-theme watch --help
+bundle exec vc-theme upload --help
+
+# Config file loading (all 5 auth methods)
+bundle exec vc-theme download --authorization=TEST_AUTH
+bundle exec vc-theme download --config=/tmp/test-config.yml
+cd /tmp && echo "authorization: TEST" > config.yml && bundle exec vc-theme download
+THEME_AUTHORIZATION=TEST bundle exec vc-theme download
+mkdir -p ~/.config/versacommerce/cli && echo "authorization: TEST" > ~/.config/versacommerce/cli/config.yml
+
+# Check for warnings
+ruby -w exe/vc-theme --help
+```
+
+## Known Risks & Blockers
+
+### HIGH RISK:
+1. **versacommerce-theme_api_client dependency** - Unknown compatibility (POTENTIAL BLOCKER)
+2. **No test coverage** - Manual testing only, risk of regression
+3. **Thor 0.19.1 → 1.3** - Major version jump, API may have changed
+
+### MEDIUM RISK:
+1. **Listen 2.10 → 3.9** - File watching behavior may differ
+2. **YAML permitted_classes** - May break if configs use unexpected classes
+3. **Bundler constraints** - Need to allow both 1.x and 2.x
+
+### LOW RISK:
+1. **Colorize, Rake, Pry updates** - Should be backward compatible
+2. **Documentation updates** - Simple text changes
+
+## Dependency Investigation Needed
+
+### versacommerce-theme_api_client
+**Action**: Must verify Ruby 3.3 compatibility before proceeding
+
+```bash
+# Check gem metadata
+gem fetch versacommerce-theme_api_client -v 0.1.3
+tar -xzf versacommerce-theme_api_client-0.1.3.gem
+tar -xzf data.tar.gz
+cat versacommerce-theme_api_client.gemspec | grep required_ruby_version
+
+# Or check online
+gem info versacommerce-theme_api_client --remote
+```
+
+**If incompatible**: This becomes a blocker and requires either:
+- Upgrading that gem first (if we control it)
+- Finding alternative API client
+- Staying on Ruby 2.6/2.7 until fixed
+
+## Implementation Approach
+
+### Phase 1: Investigation ✓
+- [x] Analyze current codebase
+- [x] Identify dependencies
+- [x] Find breaking changes
+- [ ] **Verify versacommerce-theme_api_client compatibility**
+
+### Phase 2: Core Updates
+1. Update gemspec Ruby requirement
+2. Update all dependency versions
+3. Fix YAML security issues
+4. Update README
+
+### Phase 3: Testing
+1. Remove Gemfile.lock
+2. Run bundle install
+3. Execute manual test suite
+4. Check for Ruby warnings
+
+### Phase 4: Documentation
+1. Update README.md
+2. Add .ruby-version (optional)
+3. Update CLAUDE.md
+4. Document any behavior changes
+
+## Testing Instructions
+
+After implementation, perform these tests:
+
+### 1. Dependency Installation
+```bash
+rm -f Gemfile.lock
+bundle install
+# Should complete without errors
+```
+
+### 2. Basic CLI Functionality
+```bash
+bundle exec vc-theme --help
+# Should show help without errors or warnings
+
+bundle exec vc-theme download --help
+bundle exec vc-theme watch --help
+bundle exec vc-theme upload --help
+# All should display help text
+```
+
+### 3. Config File Loading (5 methods)
+```bash
+# Method 1: Direct authorization flag
+bundle exec vc-theme download --authorization=dummy_auth --path=/tmp/test1
+# Should fail with API error (not config error)
+
+# Method 2: Explicit config file
+echo "authorization: test_auth" > /tmp/test-config.yml
+bundle exec vc-theme download --config=/tmp/test-config.yml --path=/tmp/test2
+# Should attempt to connect to API
+
+# Method 3: Implicit pwd config
+cd /tmp/test-dir
+echo "authorization: test_auth" > config.yml
+bundle exec vc-theme download --path=/tmp/test3
+# Should load from ./config.yml
+
+# Method 4: Environment variable
+THEME_AUTHORIZATION=test_auth bundle exec vc-theme download --path=/tmp/test4
+# Should use env var
+
+# Method 5: Global config
+mkdir -p ~/.config/versacommerce/cli
+echo "authorization: test_auth" > ~/.config/versacommerce/cli/config.yml
+bundle exec vc-theme download --path=/tmp/test5
+# Should load from global config
+```
+
+### 4. YAML Security Test
+```bash
+# Create a config with Symbol keys
+echo ":authorization: test_value" > /tmp/symbol-config.yml
+bundle exec vc-theme download --config=/tmp/symbol-config.yml
+# Should work without errors (permitted_classes: [Symbol])
+```
+
+### 5. Ruby Warnings Check
+```bash
+ruby -w exe/vc-theme --help 2>&1 | grep -i warning
+# Should not show YAML.load_file warnings
+```
+
+### 6. Build & Install Test
+```bash
+rake build
+gem install pkg/versacommerce-cli-0.2.3.gem
+vc-theme --help
+# Should work as standalone gem
+```
+
+## Success Criteria
+
+- [ ] All dependencies install successfully with Ruby 3.3
+- [ ] versacommerce-theme_api_client is compatible or updated
+- [ ] No YAML.load_file deprecation warnings
+- [ ] All CLI commands show help correctly
+- [ ] Config loading works for all 5 methods
+- [ ] No Ruby warnings when running with -w flag
+- [ ] Gem builds successfully
+- [ ] README reflects Ruby 3.3 requirement
+
+## Open Questions
+
+1. **Backward Compatibility**: Should we maintain Ruby 2.x support or hard require 3.3+?
+2. **Version Pinning**: Use exact versions (~> 1.3) or ranges (>= 1.3, < 2.0)?
+3. **versacommerce-theme_api_client**: Can we test/verify compatibility? Do we control this gem?
+4. **.ruby-version file**: Should we add this for developer consistency?
+5. **Test Suite**: Should basic tests be added as part of this upgrade?
+6. **Version Bump**: Should gem version be bumped (0.2.3 → 0.3.0) due to Ruby requirement change?
+
+## Existing Patterns to Follow
+
+### Logging Pattern
+```ruby
+logger.info('Message')
+logger.debug('Debug message')  # Only shown with --verbose
+logger.success('Success message')  # Green color
+logger.error('Error message')  # Red color
+```
+
+### Thor CLI Pattern
+```ruby
+class_option :option_name, aliases: :o, type: :boolean
+option :command_option, default: value
+def command_name
+  # Implementation
+end
+```
+
+### Error Handling Pattern
+```ruby
+unless condition
+  logger.error('Error message')
+  exit 1
+end
+```
+
+### File Operations Pattern
+```ruby
+path = Pathname.new(options[:path]).expand_path
+FileUtils.mkdir_p(path)
+File.open(path, 'wb') { |f| f.write(content) }
+```
+
+## Additional Context
+
+- User is running Ruby 3.1.3 currently
+- No test infrastructure exists
+- Gem is actively maintained (last commit: version bump to 0.2.3)
+- CLI is customer-facing tool (breaking changes impact users)
+- Git repository is clean (no uncommitted changes)
+
+---
+
+**Document Created**: 2025-10-29
+**Last Updated**: 2025-10-29
+**Task Status**: Planning phase

data/.ruby-version

@@ -0,0 +1 @@
+3.1.3

data/CLAUDE.md

@@ -0,0 +1,111 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+versacommerce-cli is a Ruby gem providing a Command Line Interface tool for interacting with VersaCommerce Theme API services. The primary executable is `vc-theme`, which provides theme management capabilities (download, watch, upload).
+
+**Ruby Version:** Requires Ruby >= 3.1.0 (upgraded from Ruby >= 2.0.0 in version 0.3.0)
+
+## Development Commands
+
+### Setup
+```sh
+bin/setup
+```
+Runs `bundle install` and any additional automated setup.
+
+### Interactive Console
+```sh
+bin/console
+```
+Opens an interactive prompt for experimentation.
+
+### Build & Release
+```sh
+rake build     # Build the gem
+rake install   # Install gem locally
+rake release   # Create git tag and push gem to RubyGems
+```
+
+### Testing the CLI Locally
+```sh
+bundle exec exe/vc-theme <command>
+```
+Run the CLI directly from source without installing the gem.
+
+### Running Tests
+```sh
+ruby test/smoke_test.rb
+```
+Runs basic smoke tests to verify CLI functionality.
+
+## Code Architecture
+
+### Entry Point
+- `exe/vc-theme` - Executable entry point that loads and starts `Versacommerce::CLI::Theme`
+
+### Core Structure
+The gem follows a simple modular architecture:
+
+- `lib/versacommerce/cli.rb` - Root module definition
+- `lib/versacommerce/cli/version.rb` - Version constant (update this when releasing)
+- `lib/versacommerce/cli/theme.rb` - Main Thor-based CLI class with all command logic
+- `lib/versacommerce/cli/simple_logger.rb` - Colorized logging utility
+
+### Theme Commands Architecture (lib/versacommerce/cli/theme.rb)
+
+The `Theme` class inherits from Thor and implements three main commands:
+
+1. **download** - Downloads complete theme from Theme API to local directory
+2. **watch** - Uses Listen gem to monitor file changes and sync to Theme API in real-time
+3. **upload** - Recursively uploads directory tree to Theme API (delete then add for each file)
+
+#### Authorization Resolution Chain
+The CLI checks for authorization in this priority order:
+1. `--authorization` command line option
+2. `--config` explicit config file path
+3. `config.yml` in current working directory
+4. `THEME_AUTHORIZATION` environment variable
+5. `~/.config/versacommerce/cli/config.yml` (implicit global config)
+
+This is implemented in the `authorization` method on lib/versacommerce/cli/theme.rb:156.
+
+#### File Operations Pattern
+All commands follow a pattern:
+1. Ensure authorization exists (`ensure_authorization!`)
+2. Save config if `--save-config` flag present
+3. Validate path is a directory
+4. Perform operation using `versacommerce-theme_api_client` gem
+
+The watch command uses `Listen.to()` with a block that handles modified/added/removed file arrays.
+
+### Dependencies
+- **thor** (~> 1.3) - CLI framework for building command-line interfaces (upgraded from 0.19.1)
+- **listen** (~> 3.9) - File system change monitoring for watch command (upgraded from ~> 2.10)
+- **colorize** (~> 1.1) - Terminal color output for logger (upgraded from 0.7.5)
+- **versacommerce-theme_api_client** (~> 0.1.3) - API client for VersaCommerce Theme API
+
+**Note:** For local development, the Gemfile references the local versacommerce-theme_api_client gem to use the Ruby 3.1+ compatible version.
+
+## Version Bumping
+Update `lib/versacommerce/cli/version.rb` with new version number before releasing.
+
+**Current version:** 0.3.0 (Ruby 3.1+ support, dependency updates, security fixes)
+
+## Recent Changes (v0.3.0)
+
+### Ruby 3.1+ Upgrade
+- Updated Ruby requirement from >= 2.0.0 to >= 3.1.0
+- Fixed YAML.load_file security vulnerabilities (3 instances in theme.rb)
+  - Now uses `YAML.load_file(path, permitted_classes: [Symbol])` for safe loading
+- Modernized string interpolation from % formatting to #{} syntax
+- Fixed Thor 1.x compatibility issues:
+  - Changed Pathname default values to strings
+  - Added `exit_on_failure?` method
+- Updated all dependencies to Ruby 3.1+ compatible versions
+
+### Testing
+- Added basic smoke tests in `test/smoke_test.rb`
+- Tests verify CLI loading, help commands, and YAML config loading

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 VersaCommerce
+Copyright (c) 2025 VersaCommerce
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -6,7 +6,7 @@ Versacommerce::CLI is a Command Line Interface tool that interacts with several
 
 ## Requirements
 
-Ruby ≥ 2.0.0
+Ruby ≥ 3.1.0
 
 ## Installation
 

data/lib/versacommerce/cli/simple_logger.rb

@@ -33,7 +33,7 @@ module Versacommerce
         time = Time.now.strftime('%F %R')
 
         messages.each do |message|
-          puts '[%s] -- %s' % [time, message]
+          puts "[#{time}] -- #{message}"
         end
       end
     end

data/lib/versacommerce/cli/theme.rb

@@ -11,22 +11,26 @@ require 'versacommerce/theme_api_client'
 module Versacommerce
   module CLI
     class Theme < Thor
+      def self.exit_on_failure?
+        true
+      end
+
       class_option :authorization, aliases: :a
       class_option :config, banner: 'CONFIG_PATH', aliases: :c
       class_option :verbose, type: :boolean, aliases: :v
       class_option :save_config, banner: 'CONFIG_PATH', aliases: :s
 
       desc 'download', 'Downloads a complete Theme from the Theme API.'
-      option :path, default: Pathname.pwd.join('theme')
+      option :path, default: './theme'
       def download
         ensure_authorization!
         save_config
 
         path = Pathname.new(options[:path]).expand_path
-        logger.info('Downloading Theme to %s' % path)
+        logger.info("Downloading Theme to #{path}")
 
         client.files(recursive: true).each do |file|
-          logger.debug('Downloading %s' % file.path)
+          logger.debug("Downloading #{file.path}")
           file.reload_content
           file_path = path.join(file.path)
           FileUtils.mkdir_p(file_path.parent)
@@ -37,7 +41,7 @@ module Versacommerce
       end
 
       desc 'watch', 'Watches a directory and pushes file changes to the Theme API.'
-      option :path, default: Pathname.pwd
+      option :path, default: '.'
       def watch
         ensure_authorization!
         save_config
@@ -45,7 +49,7 @@ module Versacommerce
         theme_path = Pathname.new(options[:path]).expand_path
         validate_path!(theme_path)
 
-        logger.info 'Watching %s' % theme_path
+        logger.info "Watching #{theme_path}"
 
         listener = Listen.to(theme_path) do |modified, added, removed|
           removed.each { |absolute_path| delete_file(theme_path, absolute_path) }
@@ -66,7 +70,7 @@ module Versacommerce
       end
 
       desc 'upload', 'Uploads a directory and its descendants to the Theme API.'
-      option :path, default: Pathname.pwd
+      option :path, default: '.'
       def upload
         ensure_authorization!
         save_config
@@ -74,9 +78,9 @@ module Versacommerce
         theme_path = Pathname.new(options[:path]).expand_path
         validate_path!(theme_path)
 
-        logger.info 'Uploading %s' % theme_path
+        logger.info "Uploading #{theme_path}"
         add_directory(theme_path, theme_path)
-        logger.success('Uploaded %s' % theme_path)
+        logger.success("Uploaded #{theme_path}")
       end
 
       private
@@ -86,17 +90,17 @@ module Versacommerce
         file = client.files.build(path: relative_path, content: File.read(absolute_path))
 
         if file.valid?
-          logger.debug('Trying to add %s' % relative_path)
+          logger.debug("Trying to add #{relative_path}")
 
           if file.save
-            logger.success('Added %s' % relative_path)
+            logger.success("Added #{relative_path}")
           else
-            logger.error('Could not add %s:' % relative_path)
-            file.errors.full_messages.each { |msg| logger.error('  %s' % msg) }
+            logger.error("Could not add #{relative_path}:")
+            file.errors.full_messages.each { |msg| logger.error("  #{msg}") }
           end
         else
-          logger.error('Could not add %s:' % relative_path)
-          file.errors.full_messages.each { |msg| logger.error('  %s' % msg) }
+          logger.error("Could not add #{relative_path}:")
+          file.errors.full_messages.each { |msg| logger.error("  #{msg}") }
         end
       end
 
@@ -134,7 +138,7 @@ module Versacommerce
           validate_path!(path)
           yaml = {'authorization' => authorization}.to_yaml
           File.write(path.join('config.yml'), yaml)
-          logger.debug('Saved config.yml to %s' % path)
+          logger.debug("Saved config.yml to #{path}")
         end
       end
 
@@ -147,7 +151,7 @@ module Versacommerce
 
       def validate_path!(path)
         unless path.directory?
-          logger.error('%s is not a directory.' % path)
+          logger.error("#{path} is not a directory.")
           exit 1
         end
       end
@@ -157,20 +161,20 @@ module Versacommerce
       end
 
       def explicit_config
-        @explicit_config ||= options[:config] ? YAML.load_file(options[:config]) : {}
+        @explicit_config ||= options[:config] ? YAML.load_file(options[:config], permitted_classes: [Symbol]) : {}
       end
 
       def implicit_pwd_config
         @implicit_pwd_config ||= begin
           config = Pathname.pwd.join('config.yml').expand_path
-          config.file? ? YAML.load_file(config) : {}
+          config.file? ? YAML.load_file(config, permitted_classes: [Symbol]) : {}
         end
       end
 
       def implicit_config
         @implicit_config ||= begin
           config = Pathname.new('~/.config/versacommerce/cli/config.yml').expand_path
-          config.file? ? YAML.load_file(config) : {}
+          config.file? ? YAML.load_file(config, permitted_classes: [Symbol]) : {}
         end
       end
 

data/lib/versacommerce/cli/version.rb

@@ -1,5 +1,5 @@
 module Versacommerce
   module CLI
-    VERSION = Gem::Version.new('0.2.3')
+    VERSION = Gem::Version.new('1.0.1')
   end
 end

data/versacommerce-cli.gemspec

@@ -5,9 +5,7 @@ require 'versacommerce/cli/version'
 Gem::Specification.new do |spec|
   spec.name          = 'versacommerce-cli'
   spec.version       = Versacommerce::CLI::VERSION
-  spec.authors       = ['Tobias Bühlmann']
-  spec.email         = ['buehlmann@versacommerce.de']
-
+  spec.authors       = ['VersaCommerce GmbH']
   spec.summary       = 'CLI tool for interacting with several VersaCommerce services.'
   spec.description   = 'Versacommerce::CLI is a Command Line Interface tool that interacts with several VersaCommerce-related services.'
   spec.homepage      = 'https://github.com/versacommerce/versacommerce-cli'
@@ -18,15 +16,15 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 2.0.0'
+  spec.required_ruby_version = '>= 3.1.0'
 
-  spec.add_runtime_dependency 'thor', '0.19.1'
-  spec.add_runtime_dependency 'listen', '~> 2.10'
-  spec.add_runtime_dependency 'colorize', '0.7.5'
-  spec.add_runtime_dependency 'versacommerce-theme_api_client', '0.1.3'
+  spec.add_runtime_dependency 'thor', '~> 1.3'
+  spec.add_runtime_dependency 'listen', '~> 3.9'
+  spec.add_runtime_dependency 'colorize', '~> 1.1'
+  spec.add_runtime_dependency 'versacommerce-theme_api_client', '~> 1.0.1'
 
-  spec.add_development_dependency 'bundler', '~> 1.8'
-  spec.add_development_dependency 'rake', '~> 10.4'
-  spec.add_development_dependency 'pry', '0.10.1'
-  spec.add_development_dependency 'pry-stack_explorer', '0.4.9.2'
+  spec.add_development_dependency 'bundler', '>= 1.8'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'pry', '~> 0.14'
+  spec.add_development_dependency 'pry-stack_explorer', '~> 0.6'
 end

metadata

@@ -1,83 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: versacommerce-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 1.0.1
 platform: ruby
 authors:
-- Tobias Bühlmann
-autorequire: 
+- VersaCommerce GmbH
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2015-06-18 00:00:00.000000000 Z
+date: 2025-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: listen
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: '3.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: '3.9'
 - !ruby/object:Gem::Dependency
   name: colorize
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.5
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.5
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: versacommerce-theme_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 1.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 1.0.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.8'
 - !ruby/object:Gem::Dependency
@@ -86,52 +86,60 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.4'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.4'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.1
+        version: '0.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.1
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: pry-stack_explorer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9.2
+        version: '0.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9.2
+        version: '0.6'
 description: Versacommerce::CLI is a Command Line Interface tool that interacts with
   several VersaCommerce-related services.
 email:
-- buehlmann@versacommerce.de
 executables:
 - vc-theme
 extensions: []
 extra_rdoc_files: []
 files:
+- ".DS_Store"
+- ".claude/.DS_Store"
+- ".claude/commands/bump-version.md"
+- ".claude/commands/code-review.md"
+- ".claude/commands/new-task.md"
+- ".claude/commands/verco.md"
+- ".claude/tasks/ruby-3.3-upgrade/onboarding.md"
 - ".gitignore"
+- ".ruby-version"
+- CLAUDE.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -148,7 +156,7 @@ homepage: https://github.com/versacommerce/versacommerce-cli
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -156,16 +164,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.5
-signing_key: 
+rubygems_version: 3.3.26
+signing_key:
 specification_version: 4
 summary: CLI tool for interacting with several VersaCommerce services.
 test_files: []