ruby_coded 0.2.2 → 0.3.0

data/lib/ruby_coded/commands/markdown_loader.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module RubyCoded
+  module Commands
+    # Loads project-local markdown command files.
+    class MarkdownLoader
+      def initialize(project_root:)
+        @project_root = project_root
+      end
+
+      def load_files
+        load_report[:entries]
+      end
+
+      def load_report
+        return empty_report unless Dir.exist?(commands_dir)
+
+        build_report(command_paths)
+      end
+
+      private
+
+      def empty_report
+        { entries: [], invalid_count: 0, invalid_files: [] }
+      end
+
+      def build_report(paths)
+        entries, invalid_files = paths.each_with_object([[], []]) do |path, memo|
+          collect_report_entry(path, *memo)
+        end
+
+        {
+          entries: entries,
+          invalid_count: invalid_files.size,
+          invalid_files: invalid_files
+        }
+      end
+
+      def collect_report_entry(path, entries, invalid_files)
+        parsed = parse_file(path)
+        parsed ? entries << parsed : invalid_files << File.basename(path)
+      end
+
+      def command_paths
+        Dir.glob(File.join(commands_dir, "*.md"))
+      end
+
+      def commands_dir
+        File.join(@project_root, ".ruby_coded", "commands")
+      end
+
+      def parse_file(path)
+        frontmatter, body = extract_frontmatter(File.read(path))
+        return nil unless frontmatter
+
+        build_entry(path, extract_attributes(frontmatter, body))
+      rescue StandardError
+        nil
+      end
+
+      def extract_attributes(frontmatter, body)
+        data = YAML.safe_load(frontmatter) || {}
+        {
+          command: data["command"]&.strip,
+          description: data["description"]&.strip,
+          usage: data["usage"]&.strip,
+          content: body.to_s.strip
+        }
+      end
+
+      def build_entry(path, attrs)
+        return nil unless valid_entry?(attrs)
+
+        attrs.merge(path: path)
+      end
+
+      def valid_entry?(attrs)
+        valid_command_name?(attrs[:command]) &&
+          !attrs[:description].to_s.empty? &&
+          !attrs[:content].to_s.empty?
+      end
+
+      def extract_frontmatter(raw)
+        match = raw.match(/\A---\s*\n(.*?)\n---\s*\n?(.*)\z/m)
+        return [nil, nil] unless match
+
+        [match[1], match[2]]
+      end
+
+      def valid_command_name?(name)
+        return false if name.to_s.empty?
+        return false unless name.start_with?("/")
+        return false if name.include?(" ")
+
+        true
+      end
+    end
+  end
+end

data/lib/ruby_coded/commands/markdown_provider.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative "command_definition"
+require_relative "markdown_loader"
+
+module RubyCoded
+  module Commands
+    # Converts markdown command files into command definitions.
+    class MarkdownProvider
+      def initialize(project_root:)
+        @loader = MarkdownLoader.new(project_root: project_root)
+      end
+
+      def definitions
+        load_report[:definitions]
+      end
+
+      def load_report
+        report = @loader.load_report
+        {
+          definitions: build_definitions(report[:entries]),
+          invalid_count: report[:invalid_count],
+          invalid_files: report[:invalid_files]
+        }
+      end
+
+      private
+
+      def build_definitions(entries)
+        entries.map { |entry| build_definition(entry) }
+      end
+
+      def build_definition(entry)
+        CommandDefinition.new(
+          name: entry[:command],
+          description: entry[:description],
+          source: :markdown,
+          usage: entry[:usage] || entry[:command],
+          content: entry[:content],
+          path: entry[:path]
+        )
+      end
+    end
+  end
+end

data/lib/ruby_coded/commands/plugin_provider.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "command_definition"
+
+module RubyCoded
+  module Commands
+    # Adapts plugin-registered commands to the unified command catalog.
+    class PluginProvider
+      def initialize(registry:)
+        @registry = registry
+      end
+
+      def definitions
+        commands.map { |name, handler| build_definition(name, handler) }
+      end
+
+      private
+
+      def commands
+        @registry.all_commands
+      end
+
+      def descriptions
+        @registry.all_command_descriptions
+      end
+
+      def build_definition(name, handler)
+        CommandDefinition.new(
+          name: name,
+          description: descriptions[name] || "Plugin command",
+          handler: handler,
+          source: :plugin,
+          usage: name
+        )
+      end
+    end
+  end
+end

data/lib/ruby_coded/commands.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "commands/command_definition"
+require_relative "commands/core_provider"
+require_relative "commands/plugin_provider"
+require_relative "commands/markdown_loader"
+require_relative "commands/markdown_provider"
+require_relative "commands/catalog"

data/lib/ruby_coded/plugins/command_completion/state_extension.rb

@@ -5,19 +5,6 @@ module RubyCoded
     module CommandCompletion
       # Mixed into Chat::State to add command-completion tracking.
       module StateExtension
-        COMMAND_INFO = {
-          "/help" => "Show help message",
-          "/model" => "Select or switch model",
-          "/clear" => "Clear conversation history",
-          "/history" => "Show conversation summary",
-          "/tokens" => "Show detailed token usage and cost",
-          "/agent" => "Toggle agent mode (on/off)",
-          "/plan" => "Toggle plan mode (on/off/save)",
-          "/login" => "Authenticate with an AI provider",
-          "/exit" => "Exit the chat",
-          "/quit" => "Exit the chat"
-        }.freeze
-
         def self.included(base)
           base.attr_reader :command_completion_index
         end
@@ -36,8 +23,8 @@ module RubyCoded
         def command_suggestions
           prefix = @input_buffer.downcase
           all_descriptions = merged_command_descriptions
-          all_descriptions.select { |cmd, _| cmd.start_with?(prefix) }
-                          .sort_by { |cmd, _| cmd }
+          all_descriptions.select { |cmd, _| cmd.downcase.start_with?(prefix) }
+                          .sort_by { |cmd, _| cmd.downcase }
         end
 
         def current_command_suggestion
@@ -81,9 +68,9 @@ module RubyCoded
         private
 
         def merged_command_descriptions
-          base = COMMAND_INFO.dup
-          base.merge!(RubyCoded.plugin_registry.all_command_descriptions) if RubyCoded.respond_to?(:plugin_registry)
-          base
+          return {} unless respond_to?(:command_catalog) && command_catalog
+
+          command_catalog.command_descriptions
         end
       end
     end

data/lib/ruby_coded/version.rb

@@ -2,7 +2,7 @@
 
 # This module contains the version of the RubyCoded gem
 module RubyCoded
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 
   def self.gem_version
     Gem::Version.new(VERSION).freeze

data/lib/ruby_coded.rb

@@ -5,6 +5,7 @@ require_relative "ruby_coded/config/user_config"
 require_relative "ruby_coded/auth/auth_manager"
 require_relative "ruby_coded/initializer"
 require_relative "ruby_coded/plugins"
+require_relative "ruby_coded/commands"
 
 raise "This gem requires Ruby 3.3.0 or higher" if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("3.3.0")
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_coded
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Cesar Rodriguez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-17 00:00:00.000000000 Z
+date: 2026-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -137,6 +137,7 @@ files:
 - lib/ruby_coded/chat/codex_models.rb
 - lib/ruby_coded/chat/command_handler.rb
 - lib/ruby_coded/chat/command_handler/agent_commands.rb
+- lib/ruby_coded/chat/command_handler/custom_commands.rb
 - lib/ruby_coded/chat/command_handler/history_commands.rb
 - lib/ruby_coded/chat/command_handler/login_commands.rb
 - lib/ruby_coded/chat/command_handler/model_commands.rb
@@ -165,6 +166,7 @@ files:
 - lib/ruby_coded/chat/renderer/plan_clarifier_layout.rb
 - lib/ruby_coded/chat/renderer/status_bar.rb
 - lib/ruby_coded/chat/state.rb
+- lib/ruby_coded/chat/state/context_window.rb
 - lib/ruby_coded/chat/state/login_flow.rb
 - lib/ruby_coded/chat/state/login_flow_steps.rb
 - lib/ruby_coded/chat/state/message_assistant.rb
@@ -175,6 +177,13 @@ files:
 - lib/ruby_coded/chat/state/scrollable.rb
 - lib/ruby_coded/chat/state/token_cost.rb
 - lib/ruby_coded/chat/state/tool_confirmation.rb
+- lib/ruby_coded/commands.rb
+- lib/ruby_coded/commands/catalog.rb
+- lib/ruby_coded/commands/command_definition.rb
+- lib/ruby_coded/commands/core_provider.rb
+- lib/ruby_coded/commands/markdown_loader.rb
+- lib/ruby_coded/commands/markdown_provider.rb
+- lib/ruby_coded/commands/plugin_provider.rb
 - lib/ruby_coded/config/user_config.rb
 - lib/ruby_coded/errors/auth_error.rb
 - lib/ruby_coded/initializer.rb