ruby_coded 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 458d56c13426096bb1d553aad86f7d2502a94022cc53de44ca7c74ab48cf2b5a
-  data.tar.gz: 128c5c97ccf42e93a7671ad5641d85c3f0c80f425c74506f0f22f7a4d4e95652
+  metadata.gz: 45aa4262fb573ca03510db92e2d3bd9795136b935fe7ffe8ba02821a570b107b
+  data.tar.gz: ed299052fcaa75af5a03951d18fbae6021fccd2463d28f73ea7f57cacdca28d7
 SHA512:
-  metadata.gz: a244f39012eb45e2396f61a94fb2b14f23ffd1269c4b235a1ea7ce456763cd674f13e51c4cc3584f95ab4d15517ce63aaff1c113848b2ff467aae70606770726
-  data.tar.gz: b1ba816f5deb3e7051764602bb2bb3afcac031af219f6523eb1d54f021d77fc97844068952c914a2d7f1bd441f62968141678ec09b169bf6d855cbed3f1c0848
+  metadata.gz: f06c04df1359024f169e00185535ab2f8be8f24a6eee94f3f231c130dc31d385a48163072a843330ac83a79060e553d94a59dc4224e5a93679066894d5642e81
+  data.tar.gz: 66e264de72737cbe9b3158267faf941de67156c2e05b855e7cf679ca640ceb3ecaa16c15f694aa5c2e549578004b8851aeb2ed7513a358bcb8396603eb217f34

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [0.3.1] - 2026-06-28
+
+### Added
+
+- **Git integration tool**: New git tool for common git workflows in projects (status, diff, add, commit) backed by a shared `GitBaseTool`.
+
+### Changed
+
+- **Agent mode enabled by default**: Sessions now start in Agent mode automatically instead of requiring manual activation.
+
 ## [0.3.0] - 2026-04-24
 
 ### Added

data/README.md

@@ -82,6 +82,10 @@ When agent mode is active, the model has access to these tools:
 | `create_directory` | Confirm | Create a new directory |
 | `delete_path` | Dangerous | Delete a file or directory |
 | `run_command` | Dangerous | Execute a shell command |
+| `git_status` | Safe | Show repository status |
+| `git_diff` | Safe | Show staged or unstaged diff |
+| `git_add` | Confirm | Stage files or all changes |
+| `git_commit` | Confirm | Create a local git commit with a message |
 
 Safe tools run without asking. Confirm and dangerous tools show the operation details and wait for your approval (`y` to approve, `n` to reject, `a` to approve all remaining).
 

data/lib/ruby_coded/chat/app.rb

@@ -37,6 +37,7 @@ module RubyCoded
         @fallback_from_model = fallback_from_model
         apply_plugin_extensions!
         build_components!
+        enable_default_agent_mode!
         announce_model_fallback
       end
 
@@ -123,6 +124,12 @@ module RubyCoded
         )
       end
 
+      def enable_default_agent_mode!
+        return if @llm_bridge.agentic_mode
+
+        @llm_bridge.toggle_agentic_mode!(true)
+      end
+
       def apply_selected_model
         selected = @state.selected_model
         return @state.exit_model_select! unless selected

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.3.0"
+  VERSION = "0.3.1"
 
   def self.gem_version
     Gem::Version.new(VERSION).freeze

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_coded
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Cesar Rodriguez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-24 00:00:00.000000000 Z
+date: 2026-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -204,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