ruby_coded 0.2.2 → 0.3.1

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/tools/git_add_tool.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative "git_base_tool"
+
+module RubyCoded
+  module Tools
+    # Stage specific files or all current changes in the git repository.
+    class GitAddTool < GitBaseTool
+      description "Stage files in the git repository. Provide paths or set all to true to stage everything."
+      risk :confirm
+
+      params do
+        array :paths, of: :string,
+                      description: "Relative file paths to stage",
+                      required: false
+        boolean :all, description: "Stage all tracked and untracked changes", required: false
+      end
+
+      def execute(paths: nil, all: false)
+        return stage_all if all
+
+        stage_paths(paths)
+      end
+
+      private
+
+      def stage_all
+        result = run_git_command("add", "--all")
+        return result if result.is_a?(Hash)
+
+        "Staged all changes.\n#{result}"
+      end
+
+      def stage_paths(paths)
+        normalized_paths = Array(paths).map(&:to_s).reject(&:empty?)
+        return { error: "Provide at least one path or set all to true." } if normalized_paths.empty?
+
+        invalid = invalid_paths(normalized_paths)
+        return { error: "Paths are outside the project directory: #{invalid.join(", ")}" } unless invalid.empty?
+
+        result = run_git_command("add", *normalized_paths)
+        return result if result.is_a?(Hash)
+
+        "Staged paths: #{normalized_paths.join(", ")}\n#{result}"
+      end
+
+      def invalid_paths(normalized_paths)
+        normalized_paths.filter_map do |path|
+          validated = validate_path!(path)
+          path if validated.is_a?(Hash)
+        end
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/git_base_tool.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "open3"
+require "shellwords"
+require_relative "base_tool"
+
+module RubyCoded
+  module Tools
+    # Shared helpers for git-specific tools.
+    class GitBaseTool < BaseTool
+      GIT_ENV = {
+        "GIT_EDITOR" => "true",
+        "EDITOR" => "true",
+        "VISUAL" => "true",
+        "GIT_PAGER" => "cat",
+        "PAGER" => "cat"
+      }.freeze
+
+      MAX_OUTPUT_CHARS = 5000
+
+      def git_repo?
+        Dir.exist?(File.join(@project_root, ".git"))
+      end
+
+      def ensure_git_repo!
+        return nil if git_repo?
+
+        { error: "Not a git repository: #{@project_root}" }
+      end
+
+      def run_git_command(*)
+        repo_error = ensure_git_repo!
+        return repo_error if repo_error
+
+        stdout, stderr, status = Open3.capture3(GIT_ENV, "git", *, chdir: @project_root)
+        format_git_result(stdout, stderr, status)
+      rescue Errno::ENOENT => e
+        { error: "Git executable not found: #{e.message}" }
+      rescue StandardError => e
+        { error: "Git command failed: #{e.message}" }
+      end
+
+      def format_git_result(stdout, stderr, status)
+        output = String.new
+        output << stdout unless stdout.empty?
+        output << "\nSTDERR:\n#{stderr}" unless stderr.empty?
+        output = output.strip
+        output = "(no output)" if output.empty?
+        output = truncate_output(output)
+
+        return output if status.success?
+
+        { error: output }
+      end
+
+      def truncate_output(output)
+        return output if output.length <= MAX_OUTPUT_CHARS
+
+        "#{output[0, MAX_OUTPUT_CHARS]}...(truncated, #{output.length} total characters)"
+      end
+
+      def shell_join(parts)
+        parts.map { |part| Shellwords.escape(part.to_s) }.join(" ")
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/git_commit_tool.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative "git_base_tool"
+
+module RubyCoded
+  module Tools
+    # Create a non-interactive git commit.
+    class GitCommitTool < GitBaseTool
+      description "Create a git commit with a message. Supports staging all changes first if requested."
+      risk :confirm
+
+      params do
+        string :message, description: "Commit message"
+        boolean :add_all, description: "Stage all changes before committing", required: false
+      end
+
+      def execute(message:, add_all: false)
+        msg = message.to_s.strip
+        return { error: "Commit message cannot be empty." } if msg.empty?
+
+        if add_all
+          add_result = run_git_command("add", "--all")
+          return add_result if add_result.is_a?(Hash)
+        end
+
+        result = run_git_command("commit", "-m", msg)
+        return enhance_commit_error(result) if result.is_a?(Hash)
+
+        prefix = add_all ? "Staged all changes and created commit." : "Created commit."
+        "#{prefix}\n#{result}"
+      end
+
+      private
+
+      def enhance_commit_error(result)
+        message = result[:error].to_s
+
+        return { error: "Nothing to commit. Working tree clean or no staged changes." } if message.include?("nothing to commit")
+        return { error: "Git user identity is not configured. Set user.name and user.email before committing." } if message.include?("Author identity unknown")
+
+        result
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/git_diff_tool.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "git_base_tool"
+
+module RubyCoded
+  module Tools
+    # Show git diff output for the project repository.
+    class GitDiffTool < GitBaseTool
+      description "Show git diff output for the project repository. By default shows unstaged changes."
+      risk :safe
+
+      params do
+        boolean :staged, description: "Show staged changes instead of unstaged changes", required: false
+      end
+
+      def execute(staged: false)
+        args = ["diff"]
+        args << "--cached" if staged
+        run_git_command(*args)
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/git_status_tool.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "git_base_tool"
+
+module RubyCoded
+  module Tools
+    # Show the current git working tree status.
+    class GitStatusTool < GitBaseTool
+      description "Show the current git working tree status for the project repository"
+      risk :safe
+
+      def execute
+        run_git_command("status", "--short", "--branch")
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/registry.rb

@@ -7,6 +7,10 @@ require_relative "edit_file_tool"
 require_relative "create_directory_tool"
 require_relative "delete_path_tool"
 require_relative "run_command_tool"
+require_relative "git_status_tool"
+require_relative "git_diff_tool"
+require_relative "git_add_tool"
+require_relative "git_commit_tool"
 
 module RubyCoded
   module Tools
@@ -14,7 +18,9 @@ module RubyCoded
     class Registry
       READONLY_TOOL_CLASSES = [
         ReadFileTool,
-        ListDirectoryTool
+        ListDirectoryTool,
+        GitStatusTool,
+        GitDiffTool
       ].freeze
 
       TOOL_CLASSES = [
@@ -23,7 +29,11 @@ module RubyCoded
         EditFileTool,
         CreateDirectoryTool,
         DeletePathTool,
-        RunCommandTool
+        RunCommandTool,
+        GitStatusTool,
+        GitDiffTool,
+        GitAddTool,
+        GitCommitTool
       ].freeze
 
       def initialize(project_root:)

data/lib/ruby_coded/tools/run_command_tool.rb

@@ -12,6 +12,13 @@ module RubyCoded
 
       TIMEOUT_SECONDS = 30
       MAX_OUTPUT_CHARS = 5000
+      COMMAND_ENV = {
+        "GIT_EDITOR" => "true",
+        "EDITOR" => "true",
+        "VISUAL" => "true",
+        "GIT_PAGER" => "cat",
+        "PAGER" => "cat"
+      }.freeze
 
       params do
         string :command, description: "The shell command to execute"
@@ -35,7 +42,7 @@ module RubyCoded
       private
 
       def run_with_timeout(command)
-        stdin, stdout_io, stderr_io, wait_thr = Open3.popen3(command, chdir: @project_root)
+        stdin, stdout_io, stderr_io, wait_thr = Open3.popen3(COMMAND_ENV, command, chdir: @project_root)
         stdin.close
 
         unless wait_thr.join(TIMEOUT_SECONDS)

data/lib/ruby_coded/tools/system_prompt.rb

@@ -15,6 +15,9 @@ module RubyCoded
         - The user will be asked to confirm destructive operations (write, edit, delete).
         - When listing directories, start with the project root to orient yourself.
         - Be concise in your explanations but thorough in your actions.
+        - Git workflows are allowed when the user asks for them. Prefer dedicated git tools for status, diff, add, and commit.
+        - For git commits, always use a non-interactive commit message and never rely on opening an editor.
+        - Do not push, pull, fetch, rebase, or perform other remote/history-rewriting git actions unless the user explicitly asks.
 
         Efficiency:
         - You have a budget of %<max_write_rounds>d write/edit/delete tool calls that auto-resets when reached, and a hard limit of %<max_total_rounds>d total tool calls per request.

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.1"
 
   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.1
 platform: ruby
 authors:
 - Cesar Rodriguez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-17 00:00:00.000000000 Z
+date: 2026-06-28 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
@@ -195,6 +204,11 @@ files:
 - lib/ruby_coded/tools/create_directory_tool.rb
 - lib/ruby_coded/tools/delete_path_tool.rb
 - lib/ruby_coded/tools/edit_file_tool.rb
+- lib/ruby_coded/tools/git_add_tool.rb
+- lib/ruby_coded/tools/git_base_tool.rb
+- lib/ruby_coded/tools/git_commit_tool.rb
+- lib/ruby_coded/tools/git_diff_tool.rb
+- lib/ruby_coded/tools/git_status_tool.rb
 - lib/ruby_coded/tools/list_directory_tool.rb
 - lib/ruby_coded/tools/plan_system_prompt.rb
 - lib/ruby_coded/tools/read_file_tool.rb