ace-git-worktree 0.19.0

data/lib/ace/git/worktree/cli/commands/list.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "ace/support/cli"
+require_relative "shared_helpers"
+require_relative "../../commands/list_command"
+
+module Ace
+  module Git
+    module Worktree
+      module CLI
+        module Commands
+          class List < Ace::Support::Cli::Command
+            include SharedHelpers
+
+            desc "List all worktrees with optional filtering"
+
+            example [
+              "                          # List all worktrees",
+              "--show-tasks              # Include task associations",
+              "--format json             # JSON output",
+              "--search auth             # Filter by branch pattern"
+            ]
+
+            option :format, desc: "Output format: table, json, simple", aliases: [], default: "table"
+            option :show_tasks, desc: "Include task associations", type: :boolean, aliases: ["--show-tasks"]
+            option :task_associated, desc: "Show only task-associated worktrees", type: :boolean, aliases: ["--task-associated"]
+            option :usable, desc: "Show only usable worktrees", type: :boolean, aliases: ["--usable"]
+            option :search, desc: "Filter by branch name pattern", aliases: []
+            option :quiet, type: :boolean, aliases: ["-q"], desc: "Suppress non-essential output"
+            option :verbose, type: :boolean, aliases: ["-v"], desc: "Show verbose output"
+            option :debug, type: :boolean, aliases: ["-d"], desc: "Show debug output"
+
+            def call(**options)
+              display_config_summary("list", options) unless options[:format] == "json"
+
+              # Keep explicit false values as --no-* flags so legacy parser receives filters.
+              args = list_options_to_args(options)
+
+              Ace::Git::Worktree::Commands::ListCommand.new.run(args)
+            end
+
+            private
+
+            def list_options_to_args(options)
+              args = []
+              args.concat(format_arg(options))
+              args << "--show-tasks" if options[:show_tasks]
+
+              unless options[:task_associated].nil?
+                args << (options[:task_associated] ? "--task-associated" : "--no-task-associated")
+              end
+
+              unless options[:usable].nil?
+                args << (options[:usable] ? "--usable" : "--no-usable")
+              end
+
+              if options[:search].is_a?(String) && !options[:search].empty?
+                args << "--search"
+                args << options[:search]
+              end
+
+              args
+            end
+
+            def format_arg(options)
+              format = options[:format]
+              return [] if format.nil? || format.empty?
+
+              ["--format", format]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ace/git/worktree/cli/commands/prune.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "ace/support/cli"
+require_relative "shared_helpers"
+require_relative "../../commands/prune_command"
+
+module Ace
+  module Git
+    module Worktree
+      module CLI
+        module Commands
+          class Prune < Ace::Support::Cli::Command
+            include SharedHelpers
+
+            desc "Clean up deleted worktrees from git metadata"
+
+            example [
+              "                        # Prune deleted worktrees",
+              "--dry-run              # Preview what would be pruned",
+              "--cleanup-directories  # Also remove orphaned directories"
+            ]
+
+            option :dry_run, desc: "Show what would be pruned", type: :boolean, aliases: ["--dry-run"]
+            option :cleanup_directories, desc: "Remove orphaned worktree directories", type: :boolean, aliases: ["--cleanup-directories"]
+            option :force, desc: "Force cleanup", type: :boolean, aliases: []
+            option :verbose, desc: "Show verbose output", type: :boolean, aliases: ["-v"]
+            option :quiet, type: :boolean, aliases: ["-q"], desc: "Suppress non-essential output"
+            option :debug, type: :boolean, aliases: ["-d"], desc: "Show debug output"
+
+            def call(**options)
+              display_config_summary("prune", options)
+
+              # Convert ace-support-cli options to args array format
+              args = options_to_args(options)
+
+              Ace::Git::Worktree::Commands::PruneCommand.new.run(args)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ace/git/worktree/cli/commands/remove.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "ace/support/cli"
+require_relative "shared_helpers"
+require_relative "../../commands/remove_command"
+
+module Ace
+  module Git
+    module Worktree
+      module CLI
+        module Commands
+          class Remove < Ace::Support::Cli::Command
+            include SharedHelpers
+
+            desc "Remove a git worktree with safety checks"
+
+            example [
+              "--task 081           # Remove task worktree",
+              "feature-branch       # Remove by branch name",
+              "--task 081 --force   # Force removal with changes"
+            ]
+
+            argument :identifier, required: false, desc: "Worktree identifier (task ID, branch, directory, or path)"
+
+            option :task, desc: "Remove worktree for specific task", aliases: []
+            option :force, desc: "Force removal even with uncommitted changes", type: :boolean, aliases: []
+            option :keep_directory, desc: "Keep the worktree directory", type: :boolean, aliases: ["--keep-directory"]
+            option :delete_branch, desc: "Also delete the associated branch", type: :boolean, aliases: ["-D"]
+            option :dry_run, desc: "Show what would be removed", type: :boolean, aliases: ["--dry-run"]
+            option :quiet, type: :boolean, aliases: ["-q"], desc: "Suppress non-essential output"
+            option :verbose, type: :boolean, aliases: ["-v"], desc: "Show verbose output"
+            option :debug, type: :boolean, aliases: ["-d"], desc: "Show debug output"
+
+            def call(identifier: nil, **options)
+              display_config_summary("remove", options)
+
+              # Convert ace-support-cli options to args array format
+              args = options_to_args(options)
+              args << identifier if identifier
+
+              Ace::Git::Worktree::Commands::RemoveCommand.new.run(args)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ace/git/worktree/cli/commands/shared_helpers.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "ace/core"
+
+module Ace
+  module Git
+    module Worktree
+      module CLI
+        module Commands
+          # Shared helper methods for CLI commands
+          #
+          # Include this module in CLI command classes to avoid code duplication
+          # of common patterns like config summary display and options conversion.
+          module SharedHelpers
+            include Ace::Support::Cli::Base
+
+            private
+
+            # Display config summary unless quiet mode is enabled
+            #
+            # @param command [String] Command name for display
+            # @param options [Hash] CLI options hash
+            def display_config_summary(command, options)
+              return if quiet?(options)
+
+              Ace::Core::Atoms::ConfigSummary.display(
+                command: command,
+                config: Ace::Git::Worktree.config,
+                defaults: {},
+                options: options
+              )
+            end
+
+            # Convert ace-support-cli options hash to args array format for legacy commands
+            #
+            # @param options [Hash] CLI options hash
+            # @return [Array<String>] Arguments array
+            #
+            # @note Boolean false values are skipped (not converted to --no-flag).
+            #   This means there's no distinction between "not specified" and "explicitly
+            #   set to false". If a command needs to distinguish these cases, it should
+            #   handle the option directly rather than using this converter.
+            def options_to_args(options)
+              args = []
+              options.each do |key, value|
+                next if value.nil? || %i[quiet verbose debug].include?(key)
+
+                arg_key = key.to_s.tr("_", "-")
+                if value == true
+                  args << "--#{arg_key}"
+                elsif value == false
+                  # Skip boolean false options - no distinction between unset and false
+                  next
+                elsif value.is_a?(String)
+                  args << "--#{arg_key}"
+                  args << value
+                end
+              end
+              args
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ace/git/worktree/cli/commands/switch.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "ace/support/cli"
+require_relative "shared_helpers"
+require_relative "../../commands/switch_command"
+
+module Ace
+  module Git
+    module Worktree
+      module CLI
+        module Commands
+          class Switch < Ace::Support::Cli::Command
+            include SharedHelpers
+
+            desc "Switch to a worktree by returning its path"
+
+            example [
+              "081                   # Switch by task ID",
+              "feature-branch        # Switch by branch name",
+              "--list                # List available worktrees"
+            ]
+
+            argument :identifier, required: false, desc: "Worktree identifier (task ID, branch, directory, or path)"
+
+            option :list, desc: "List available worktrees", type: :boolean, aliases: ["-l"]
+            option :verbose, desc: "Show verbose output", type: :boolean, aliases: ["-v"]
+            option :quiet, type: :boolean, aliases: ["-q"], desc: "Suppress non-essential output"
+            option :debug, type: :boolean, aliases: ["-d"], desc: "Show debug output"
+
+            def call(identifier: nil, **options)
+              display_config_summary("switch", options)
+
+              # Convert ace-support-cli options to args array format
+              args = options_to_args(options)
+              args << identifier if identifier
+
+              Ace::Git::Worktree::Commands::SwitchCommand.new.run(args)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ace/git/worktree/cli.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require "ace/support/cli"
+
+require_relative "version"
+require_relative "cli/commands/create"
+require_relative "cli/commands/list"
+require_relative "cli/commands/switch"
+require_relative "cli/commands/remove"
+require_relative "cli/commands/prune"
+require_relative "cli/commands/config"
+require "ace/core"
+require "ace/support/cli"
+
+module Ace
+  module Git
+    module Worktree
+      # ace-support-cli based CLI registry for ace-git-worktree
+      #
+      # This follows the Hanami pattern with all commands in CLI::Commands:: namespace.
+      module CLI
+        extend Ace::Support::Cli::RegistryDsl
+
+        PROGRAM_NAME = "ace-git-worktree"
+
+        REGISTERED_COMMANDS = [
+          ["create", "Create a new worktree for task, PR, or branch"],
+          ["list", "List active worktrees with optional task metadata"],
+          ["switch", "Resolve a worktree path for cd navigation"],
+          ["remove", "Remove a worktree by task, branch, or path"],
+          ["prune", "Prune stale/deleted worktree references"],
+          ["config", "Show and validate configuration"]
+        ].freeze
+
+        HELP_EXAMPLES = [
+          "ace-git-worktree create --task 148    # Isolated worktree for task",
+          "ace-git-worktree list --show-tasks    # Worktrees with task context",
+          "ace-git-worktree switch 148           # Get path for cd",
+          "ace-git-worktree prune --dry-run      # Preview stale cleanup"
+        ].freeze
+
+        # Captured command exit code from last run.
+        @captured_exit_code = nil
+
+        # Start the CLI.
+        #
+        # @param args [Array<String>] Command-line arguments
+        # @return [Integer] Exit code (0 for success, non-zero for failure)
+        def self.start(args)
+          @captured_exit_code = nil
+          Ace::Support::Cli::Runner.new(self).call(args: args)
+          @captured_exit_code || 0
+        end
+
+        # Wrap a command to capture its exit code.
+        #
+        # @param command_class [Class] The command class to wrap
+        # @return [Class] Wrapped command class
+        def self.wrap_command(command_class)
+          wrapped = Class.new(Ace::Support::Cli::Command) do
+            define_method(:call) do |**kwargs|
+              result = command_class.new.call(**kwargs)
+              Ace::Git::Worktree::CLI.instance_variable_set(:@captured_exit_code, result) if result.is_a?(Integer)
+              result
+            end
+          end
+
+          command_class.instance_variables.each do |ivar|
+            wrapped.instance_variable_set(ivar, command_class.instance_variable_get(ivar))
+          end
+
+          wrapped
+        end
+
+        # Register commands (Hanami pattern: CLI::Commands::*)
+        register "create", wrap_command(CLI::Commands::Create), aliases: []
+        register "list", wrap_command(CLI::Commands::List), aliases: ["ls"]
+        register "switch", wrap_command(CLI::Commands::Switch), aliases: ["cd"]
+        register "remove", wrap_command(CLI::Commands::Remove), aliases: ["rm"]
+        register "prune", wrap_command(CLI::Commands::Prune), aliases: []
+        register "config", wrap_command(CLI::Commands::Config), aliases: []
+
+        # Version command
+        version_cmd = Ace::Support::Cli::VersionCommand.build(
+          gem_name: "ace-git-worktree",
+          version: Ace::Git::Worktree::VERSION
+        )
+        register "version", version_cmd
+        register "--version", version_cmd
+
+        help_cmd = Ace::Support::Cli::HelpCommand.build(
+          program_name: PROGRAM_NAME,
+          version: Ace::Git::Worktree::VERSION,
+          commands: REGISTERED_COMMANDS,
+          examples: HELP_EXAMPLES
+        )
+        register "help", help_cmd
+        register "--help", help_cmd
+        register "-h", help_cmd
+      end
+    end
+  end
+end