ruby_coded 0.3.1 → 0.4.0

data/lib/ruby_coded/skills/prompt_formatter.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module RubyCoded
+  module Skills
+    # Formats active skills for prompt injection.
+    module PromptFormatter
+      def self.append(base_instructions, skills)
+        skills = Array(skills)
+        return base_instructions if skills.empty?
+
+        <<~PROMPT
+          #{base_instructions}
+
+          ## Active project skills
+
+          Apply the following project-local skills when relevant. If a skill conflicts with higher-priority system instructions or the user's explicit request, follow the higher-priority instruction.
+
+          #{format_skills(skills)}
+        PROMPT
+      end
+
+      def self.format_skills(skills)
+        skills.map { |skill| format_skill(skill) }.join("\n\n")
+      end
+
+      def self.format_skill(skill)
+        (["### #{skill.name}"] + skill_metadata_lines(skill) + ["", skill.content.to_s]).join("\n")
+      end
+
+      def self.skill_metadata_lines(skill)
+        description = skill.description.to_s
+        trigger = skill.trigger.to_s
+        [
+          (description unless description.empty?),
+          "Modes: #{skill.modes.join(", ")}",
+          ("Tags: #{skill.tags.join(", ")}" if skill.tags.any?),
+          ("Trigger: #{trigger}" unless trigger.empty?)
+        ].compact
+      end
+    end
+  end
+end

data/lib/ruby_coded/skills/skill_definition.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module RubyCoded
+  module Skills
+    # Normalized project-local skill metadata.
+    class SkillDefinition
+      ATTRIBUTES = %i[name description modes content path priority tags trigger].freeze
+
+      attr_reader(*ATTRIBUTES)
+
+      def initialize(**attrs)
+        ATTRIBUTES.each { |attr| instance_variable_set(ivar(attr), attrs[attr]) }
+        @modes = Array(@modes).map(&:to_s)
+        @tags = Array(@tags).map(&:to_s)
+        @priority = (@priority || 0).to_i
+      end
+
+      def applies_to_mode?(mode)
+        @modes.include?(mode.to_s)
+      end
+
+      private
+
+      def ivar(name)
+        :"@#{name}"
+      end
+    end
+  end
+end

data/lib/ruby_coded/skills.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Skills are **automatic instruction overlays** applied to the
+# system prompt for a given mode.
+#
+# The user does not invoke a skill directly; the PromptBuilder
+# consults the Skills::Catalog for the active RuntimeMode and
+# appends the relevant skills to the final instructions. Skills
+# are defined as markdown files under `.rubycoded/skills`.
+#
+# See also:
+# - RubyCoded::Commands — explicit user-invoked slash actions.
+# - RubyCoded::Plugins  — code-level behavioral extensions.
+
+require_relative "skills/skill_definition"
+require_relative "skills/markdown_loader"
+require_relative "skills/catalog"
+require_relative "skills/prompt_formatter"

data/lib/ruby_coded/tools/base_tool.rb

@@ -2,6 +2,7 @@
 
 require "ruby_llm"
 require_relative "tool_rejected_error"
+require_relative "execution_pipeline"
 
 module RubyCoded
   module Tools
@@ -28,6 +29,19 @@ module RubyCoded
 
       private
 
+      # Runs the shared execution pipeline (path validation, project-root
+      # guard, filesystem error normalization) around the given block.
+      # Prefer this over calling validate_path! directly for tools that
+      # need the full pipeline; use validate_path! when only path
+      # resolution is required (e.g. read-only tools with custom flows).
+      def run_pipeline(path: nil, forbid_root: false, &)
+        pipeline.call(path: path, forbid_root: forbid_root, &)
+      end
+
+      def pipeline
+        @pipeline ||= ExecutionPipeline.new(project_root: @project_root)
+      end
+
       def resolve_path(relative_path)
         expanded = File.expand_path(relative_path, @project_root)
         File.realpath(expanded)

data/lib/ruby_coded/tools/delete_path_tool.rb

@@ -15,14 +15,11 @@ module RubyCoded
       end
 
       def execute(path:)
-        full_path = validate_path!(path)
-        return full_path if full_path.is_a?(Hash)
-        return { error: "Path not found: #{path}" } unless File.exist?(full_path)
-        return { error: "Cannot delete the project root" } if full_path == @project_root
-
-        perform_delete(path, full_path)
-      rescue SystemCallError => e
-        { error: "Failed to delete #{path}: #{e.message}" }
+        run_pipeline(path: path, forbid_root: true) do |full_path|
+          next { error: "Path not found: #{path}" } unless File.exist?(full_path)
+
+          perform_delete(path, full_path)
+        end
       end
 
       private

data/lib/ruby_coded/tools/edit_file_tool.rb

@@ -16,14 +16,12 @@ module RubyCoded
       end
 
       def execute(path:, old_text:, new_text:)
-        full_path = validate_path!(path)
-        return full_path if full_path.is_a?(Hash)
-        return { error: "File not found: #{path}" } unless File.exist?(full_path)
-        return { error: "Not a file: #{path}" } unless File.file?(full_path)
-
-        apply_edit(path, full_path, old_text, new_text)
-      rescue SystemCallError => e
-        { error: "Failed to edit #{path}: #{e.message}" }
+        run_pipeline(path: path) do |full_path|
+          next { error: "File not found: #{path}" } unless File.exist?(full_path)
+          next { error: "Not a file: #{path}" } unless File.file?(full_path)
+
+          apply_edit(path, full_path, old_text, new_text)
+        end
       end
 
       private

data/lib/ruby_coded/tools/execution_pipeline.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module RubyCoded
+  module Tools
+    # Standardizes the internal execution flow shared by side-effecting tools:
+    #   1. validate input (project-relative path if given)
+    #   2. resolve to an absolute path inside the project root
+    #   3. optionally forbid operating on the project root itself
+    #   4. execute the tool's business logic (via block)
+    #   5. normalize filesystem errors into a structured response
+    #
+    # Policy, risk assessment and user approval intentionally live outside
+    # this pipeline: they are handled by Tools::ExecutionPolicy and by the
+    # bridges (BridgeCommon::ToolFlow), which sit above tool execution.
+    class ExecutionPipeline
+      def initialize(project_root:)
+        @project_root = File.realpath(project_root)
+      end
+
+      # Runs the pipeline. Yields the resolved full_path (or nil if `path`
+      # was not provided) to the caller-supplied block, which returns the
+      # tool result — either a success value (string/hash without :error)
+      # or an error hash of the form { error: "..." }.
+      #
+      # Any SystemCallError raised inside the block is normalized to an
+      # error hash.
+      def call(path: nil, forbid_root: false)
+        full_path = nil
+        if path
+          full_path = resolve_and_validate(path)
+          return full_path if full_path.is_a?(Hash)
+          return { error: "Cannot operate on the project root" } if forbid_root && full_path == @project_root
+        end
+
+        yield(full_path)
+      rescue SystemCallError => e
+        { error: "Filesystem error: #{e.message}" }
+      end
+
+      private
+
+      def resolve_and_validate(relative_path)
+        expanded = File.expand_path(relative_path, @project_root)
+        full_path = begin
+          File.realpath(expanded)
+        rescue Errno::ENOENT
+          expanded
+        end
+
+        return full_path if inside_project?(full_path)
+
+        { error: "Path is outside the project directory. Only paths within #{@project_root} are allowed." }
+      end
+
+      def inside_project?(full_path)
+        full_path.start_with?(@project_root)
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/execution_policy.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative "base_tool"
+require_relative "agent_iteration_limit_error"
+
+module RubyCoded
+  module Tools
+    # Centralizes runtime safety policy for tool execution:
+    #
+    # - risk lookup (delegated to the registry),
+    # - call budgeting (write vs total rounds, warning threshold),
+    # - confirmation requirement based on risk, mode, and auto-approve.
+    #
+    # Both LLMBridge and CodexBridge share a policy instance so
+    # limits and approval rules stay consistent across backends.
+    class ExecutionPolicy
+      MAX_WRITE_TOOL_ROUNDS = 50
+      MAX_TOTAL_TOOL_ROUNDS = 200
+      WARNING_THRESHOLD_RATIO = 0.8
+
+      def initialize(state:, registry:)
+        @state = state
+        @registry = registry
+        reset_counters!
+      end
+
+      def reset_counters!
+        @tool_call_count = 0
+        @write_tool_call_count = 0
+      end
+
+      def risk_for(tool_name)
+        @registry.risk_level_for(tool_name)
+      end
+
+      # Records the call, enforces hard limits, and returns the risk level.
+      # Raises AgentIterationLimitError when the total budget is exceeded.
+      def register_call!(tool_name)
+        risk = risk_for(tool_name)
+        @tool_call_count += 1
+        @write_tool_call_count += 1 unless risk == BaseTool::SAFE_RISK
+        enforce_limits!
+        risk
+      end
+
+      def warn_if_approaching_limit!
+        threshold = warning_threshold
+        return unless @tool_call_count == threshold
+
+        remaining = MAX_TOTAL_TOOL_ROUNDS - threshold
+        @state.add_message(:system,
+                           "Approaching total tool call limit: #{remaining} calls remaining. " \
+                           "Prioritize completing the most important work.")
+      end
+
+      # True when the user must confirm this call before it runs.
+      def requires_confirmation?(risk, mode)
+        return false if risk == BaseTool::SAFE_RISK
+        return false if @state.auto_approve_tools?
+
+        mode.requires_confirmation?
+      end
+
+      def risk_label_for(risk)
+        risk == BaseTool::DANGEROUS_RISK ? "DANGEROUS" : "WRITE"
+      end
+
+      private
+
+      def warning_threshold
+        (MAX_TOTAL_TOOL_ROUNDS * WARNING_THRESHOLD_RATIO).to_i
+      end
+
+      def enforce_limits!
+        if @write_tool_call_count >= MAX_WRITE_TOOL_ROUNDS
+          @write_tool_call_count = 0
+          @state.add_message(:system,
+                             "Write tool call budget (#{MAX_WRITE_TOOL_ROUNDS}) reached — auto-resetting counter.")
+        end
+
+        return unless @tool_call_count > MAX_TOTAL_TOOL_ROUNDS
+
+        raise AgentIterationLimitError,
+              "Reached maximum of #{MAX_TOTAL_TOOL_ROUNDS} total tool calls. " \
+              "Send a new message to continue, or use /agent on to reset counters."
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/write_file_tool.rb

@@ -15,16 +15,13 @@ module RubyCoded
       end
 
       def execute(path:, content:)
-        full_path = validate_path!(path)
-        return full_path if full_path.is_a?(Hash)
+        run_pipeline(path: path) do |full_path|
+          dir = File.dirname(full_path)
+          FileUtils.mkdir_p(dir) unless File.directory?(dir)
 
-        dir = File.dirname(full_path)
-        FileUtils.mkdir_p(dir) unless File.directory?(dir)
-
-        File.write(full_path, content)
-        "File written: #{path} (#{content.bytesize} bytes)"
-      rescue SystemCallError => e
-        { error: "Failed to write #{path}: #{e.message}" }
+          File.write(full_path, content)
+          "File written: #{path} (#{content.bytesize} bytes)"
+        end
       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.3.1"
+  VERSION = "0.4.0"
 
   def self.gem_version
     Gem::Version.new(VERSION).freeze

data/lib/ruby_coded.rb

@@ -6,6 +6,7 @@ require_relative "ruby_coded/auth/auth_manager"
 require_relative "ruby_coded/initializer"
 require_relative "ruby_coded/plugins"
 require_relative "ruby_coded/commands"
+require_relative "ruby_coded/skills"
 
 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.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Cesar Rodriguez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-28 00:00:00.000000000 Z
+date: 2026-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -127,6 +127,11 @@ files:
 - lib/ruby_coded/chat/app/event_dispatch.rb
 - lib/ruby_coded/chat/app/login_handler.rb
 - lib/ruby_coded/chat/app/oauth_handler.rb
+- lib/ruby_coded/chat/bridge_common.rb
+- lib/ruby_coded/chat/bridge_common/auto_switch.rb
+- lib/ruby_coded/chat/bridge_common/mode_transitions.rb
+- lib/ruby_coded/chat/bridge_common/tool_flow.rb
+- lib/ruby_coded/chat/bridge_factory.rb
 - lib/ruby_coded/chat/codex_bridge.rb
 - lib/ruby_coded/chat/codex_bridge/error_handling.rb
 - lib/ruby_coded/chat/codex_bridge/request_builder.rb
@@ -142,6 +147,7 @@ files:
 - lib/ruby_coded/chat/command_handler/login_commands.rb
 - lib/ruby_coded/chat/command_handler/model_commands.rb
 - lib/ruby_coded/chat/command_handler/plan_commands.rb
+- lib/ruby_coded/chat/command_handler/skill_commands.rb
 - lib/ruby_coded/chat/command_handler/token_commands.rb
 - lib/ruby_coded/chat/command_handler/token_formatting.rb
 - lib/ruby_coded/chat/help.txt
@@ -150,21 +156,31 @@ files:
 - lib/ruby_coded/chat/input_handler/modal_inputs.rb
 - lib/ruby_coded/chat/input_handler/normal_mode_input.rb
 - lib/ruby_coded/chat/llm_bridge.rb
+- lib/ruby_coded/chat/llm_bridge/chat_configuration.rb
 - lib/ruby_coded/chat/llm_bridge/plan_mode.rb
 - lib/ruby_coded/chat/llm_bridge/streaming_retries.rb
 - lib/ruby_coded/chat/llm_bridge/tool_call_handling.rb
 - lib/ruby_coded/chat/model_filter.rb
 - lib/ruby_coded/chat/plan_clarification_parser.rb
+- lib/ruby_coded/chat/prompt_builder.rb
 - lib/ruby_coded/chat/renderer.rb
 - lib/ruby_coded/chat/renderer/chat_panel.rb
+- lib/ruby_coded/chat/renderer/chat_panel_cache.rb
+- lib/ruby_coded/chat/renderer/chat_panel_formatting.rb
 - lib/ruby_coded/chat/renderer/chat_panel_input.rb
+- lib/ruby_coded/chat/renderer/chat_panel_layout.rb
+- lib/ruby_coded/chat/renderer/chat_panel_sections.rb
 - lib/ruby_coded/chat/renderer/chat_panel_thinking.rb
+- lib/ruby_coded/chat/renderer/chat_panel_thinking_render.rb
 - lib/ruby_coded/chat/renderer/login_flow.rb
 - lib/ruby_coded/chat/renderer/login_flow_layout.rb
 - lib/ruby_coded/chat/renderer/model_selector.rb
 - lib/ruby_coded/chat/renderer/plan_clarifier.rb
 - lib/ruby_coded/chat/renderer/plan_clarifier_layout.rb
+- lib/ruby_coded/chat/renderer/rich_text.rb
+- lib/ruby_coded/chat/renderer/rich_text_inline.rb
 - lib/ruby_coded/chat/renderer/status_bar.rb
+- lib/ruby_coded/chat/runtime_mode.rb
 - lib/ruby_coded/chat/state.rb
 - lib/ruby_coded/chat/state/context_window.rb
 - lib/ruby_coded/chat/state/login_flow.rb
@@ -195,6 +211,11 @@ files:
 - lib/ruby_coded/plugins/command_completion/renderer_extension.rb
 - lib/ruby_coded/plugins/command_completion/state_extension.rb
 - lib/ruby_coded/plugins/registry.rb
+- lib/ruby_coded/skills.rb
+- lib/ruby_coded/skills/catalog.rb
+- lib/ruby_coded/skills/markdown_loader.rb
+- lib/ruby_coded/skills/prompt_formatter.rb
+- lib/ruby_coded/skills/skill_definition.rb
 - lib/ruby_coded/strategies/api_key_strategy.rb
 - lib/ruby_coded/strategies/base.rb
 - lib/ruby_coded/strategies/oauth_strategy.rb
@@ -204,6 +225,8 @@ 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/execution_pipeline.rb
+- lib/ruby_coded/tools/execution_policy.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