caruso 0.5.4

data/Rakefile

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = "--tag ~live"
+end
+
+RSpec::Core::RakeTask.new("spec:live") do |t|
+  ENV["RUN_LIVE_TESTS"] = "true"
+  t.rspec_opts = "--tag live"
+end
+
+RSpec::Core::RakeTask.new("spec:all") do |_t|
+  ENV["RUN_LIVE_TESTS"] = "true"
+end
+
+task default: :spec
+
+desc "Run all tests including live tests"
+task test_all: "spec:all"
+
+desc "Run only live tests (requires network)"
+task test_live: "spec:live"
+
+namespace :bump do
+  def bump_version(type)
+    version_file = "lib/caruso/version.rb"
+    content = File.read(version_file)
+
+    unless content =~ /VERSION = "(\d+)\.(\d+)\.(\d+)"/
+      raise "Could not find version in #{version_file}"
+    end
+
+    major, minor, patch = $1.to_i, $2.to_i, $3.to_i
+
+    case type
+    when :major
+      major += 1
+      minor = 0
+      patch = 0
+    when :minor
+      minor += 1
+      patch = 0
+    when :patch
+      patch += 1
+    end
+
+    new_version = "#{major}.#{minor}.#{patch}"
+    new_content = content.sub(/VERSION = ".*"/, "VERSION = \"#{new_version}\"")
+
+    File.write(version_file, new_content)
+    puts "Bumped version to #{new_version}"
+  end
+
+  desc "Bump patch version"
+  task :patch do
+    bump_version(:patch)
+  end
+
+  desc "Bump minor version"
+  task :minor do
+    bump_version(:minor)
+  end
+
+  desc "Bump major version"
+  task :major do
+    bump_version(:major)
+  end
+end

data/bin/caruso

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "caruso"
+
+Caruso::CLI.start(ARGV)

data/caruso.gemspec

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "lib/caruso/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "caruso"
+  spec.version = Caruso::VERSION
+  spec.authors = ["Philipp Comans"]
+  spec.email = ["philipp.comans@gmail.com"]
+
+  spec.summary = "Sync steering docs from Claude Marketplaces to other agents."
+  spec.description = "A tool to fetch Claude Code plugins and adapt them into Cursor Rules or other agent contexts."
+  spec.homepage = "https://github.com/pcomans/caruso"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/pcomans/caruso"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[test/ spec/ features/ .git .circleci appveyor Gemfile])
+    end
+  end
+  spec.bindir = "bin"
+  spec.executables = ["caruso"]
+  spec.require_paths = ["lib"]
+
+  # Runtime dependencies
+  spec.add_dependency "faraday", "~> 2.0" # For HTTP requests
+  spec.add_dependency "git", "~> 1.19" # For cloning repos
+  spec.add_dependency "thor", "~> 1.3" # For CLI
+
+  # Development dependencies
+  spec.add_development_dependency "aruba", "~> 2.1"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.13"
+  spec.add_development_dependency "rubocop", "~> 1.60"
+  spec.add_development_dependency "timecop", "~> 0.9"
+end

data/lib/caruso/adapter.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "yaml"
+
+module Caruso
+  class Adapter
+    attr_reader :files, :target_dir, :agent, :marketplace_name, :plugin_name
+
+    def initialize(files, target_dir:, marketplace_name:, plugin_name:, agent: :cursor)
+      @files = files
+      @target_dir = target_dir
+      @agent = agent
+      @marketplace_name = marketplace_name
+      @plugin_name = plugin_name
+      FileUtils.mkdir_p(@target_dir)
+    end
+
+    def adapt
+      created_files = []
+      files.each do |file_path|
+        content = File.read(file_path)
+        adapted_content = inject_metadata(content, file_path)
+        created_file = save_file(file_path, adapted_content)
+        created_files << created_file
+      end
+      created_files
+    end
+
+    private
+
+    def inject_metadata(content, file_path)
+      # Check if frontmatter exists
+      if content.match?(/\A---\s*\n.*?\n---\s*\n/m)
+        # If it exists, we might need to append to it or modify it
+        # For now, we assume existing frontmatter is "good enough" but might need 'globs' for Cursor
+        ensure_cursor_globs(content) if agent == :cursor
+      else
+        # No frontmatter, prepend it
+        create_frontmatter(file_path) + content
+      end
+    end
+
+    def ensure_cursor_globs(content)
+      # Add required Cursor metadata fields if missing
+      # globs: [] enables semantic search (Apply Intelligently)
+      # alwaysApply: false means it won't apply to every chat session
+
+      unless content.include?("globs:")
+        content.sub!(/\A---\s*\n/, "---\nglobs: []\n")
+      end
+
+      unless content.include?("alwaysApply:")
+        # Add after the first line of frontmatter
+        content.sub!(/\A---\s*\n/, "---\nalwaysApply: false\n")
+      end
+
+      content
+    end
+
+    def create_frontmatter(file_path)
+      filename = File.basename(file_path)
+      <<~YAML
+        ---
+        description: Imported rule from #{filename}
+        globs: []
+        alwaysApply: false
+        ---
+      YAML
+    end
+
+    def save_file(original_path, content)
+      filename = File.basename(original_path, ".*")
+
+      # Rename SKILL.md to the skill name (parent directory) to avoid collisions
+      if filename.casecmp("skill").zero?
+        filename = File.basename(File.dirname(original_path))
+      end
+
+      extension = agent == :cursor ? ".mdc" : ".md"
+      output_filename = "#{filename}#{extension}"
+
+      # Extract component type from original path (commands/agents/skills)
+      component_type = extract_component_type(original_path)
+
+      # Build nested directory structure for Cursor
+      # Build nested directory structure for Cursor
+      # Structure: .cursor/rules/caruso/marketplace/plugin/component-type/file.mdc
+      subdirs = File.join("caruso", marketplace_name, plugin_name, component_type)
+      output_dir = File.join(@target_dir, subdirs)
+      FileUtils.mkdir_p(output_dir)
+      target_path = File.join(output_dir, output_filename)
+
+      File.write(target_path, content)
+      puts "Saved: #{target_path}"
+
+      # Return relative path from target_dir
+      File.join(subdirs, output_filename)
+    end
+
+    def extract_component_type(file_path)
+      # Extract component type (commands/agents/skills) from path
+      return "commands" if file_path.include?("/commands/")
+      return "agents" if file_path.include?("/agents/")
+      return "skills" if file_path.include?("/skills/")
+
+      raise Caruso::Error, "Cannot determine component type from path: #{file_path}"
+    end
+  end
+end