Added @api tags.

Author: postmodern

lib/command_kit/completion/task.rb

@@ -27,32 +27,44 @@ class Task < Rake::TaskLib
       # The file that the command_kit CLI is defined in.
       #
       # @return [String]
+      #
+      # @api private
       attr_reader :class_file
 
       # The class name of the command_kit CLI.
       #
       # @return [String]
+      #
+      # @api private
       attr_reader :class_name
 
       # The output file to write the shell completions to.
       #
       # @return [String]
+      #
+      # @api private
       attr_reader :output_file
 
       # Optional input YAML file to read additional shell completions from.
       #
       # @return [String, nil]
+      #
+      # @api private
       attr_reader :input_file
 
       # Specifies whether the shell completion logic should be wrapped in a
       # function.
       #
       # @return [Boolean]
+      #
+      # @api private
       attr_reader :wrap_function
 
       # Optional function name to wrap the shell completions within.
       #
       # @return [String, nil]
+      #
+      # @api private
       attr_reader :function_name
 
       #
@@ -73,6 +85,8 @@ class Task < Rake::TaskLib
       #
       #   [completely examples]: https://github.com/DannyBen/completely?tab=readme-ov-file#using-the-completely-command-line
       #
+      # @api public
+      #
       def initialize(class_file: ,
                      class_name: ,
                      output_file: ,
@@ -93,6 +107,8 @@ def initialize(class_file: ,
       #
       # Defines the `command_kit:completion` task.
       #
+      # @api private
+      #
       def define
         task(@output_file) do
           completions  = Completely::Completions.new(completion_rules)
@@ -117,6 +133,8 @@ def define
       #
       # @return [Class]
       #
+      # @api private
+      #
       def load_class
         require(@class_file)
         Object.const_get(@class_name)
@@ -128,6 +146,8 @@ def load_class
       # @return [Hash]
       #   The completion rules from the {#input_file}.
       #
+      # @api private
+      #
       def load_input_file
         YAML.load_file(@input_file, aliases: true)
       end
@@ -143,6 +163,8 @@ def load_input_file
       #
       # @since 0.2.0
       #
+      # @api private
+      #
       def suggestion_for_argument(arg)
         case arg
         when /\AFILE\z|_FILE\z/ then '<file>'
@@ -164,6 +186,8 @@ def suggestion_for_argument(arg)
       # @return [Hash{String => Array<String>}]
       #   The completion rules for the command class and any sub-commands.
       #
+      # @api private
+      #
       def completion_rules_for(command_class)
         command_name = command_class.command_name
         completions  = {command_name => []}
@@ -228,6 +252,8 @@ def completion_rules_for(command_class)
       #
       # @return [Hash{String => Array<String>}]
       #
+      # @api private
+      #
       def completion_rules
         completion_rules = completion_rules_for(load_class)