brute 2.0.4 → 2.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb6f6ec73748584e7df3e3c1ed715964c4730f185336ce4d5278a6683e8c99f1
-  data.tar.gz: ea812e4c86d8c8fbf6737ba794aaafa094e70867e5820831a8e6cd10019fd982
+  metadata.gz: f1feb1c397c976722644f4f8dd5d90e8ddc3ab372d7aea7085a08baa122b65e7
+  data.tar.gz: eeaadf2902925f6538b31affacbf997b0c26da5a331c1576b4b393935a4f3444
 SHA512:
-  metadata.gz: c22b7d3b038edd1949e5a9e53e502649d661e865d0bd33a81df18129dfb03acf7b12af535e6444c54eabca1eeeeb74d63b1c4af2900114d5239d7ebcfa330cbe
-  data.tar.gz: 05eabd1386316af7cbbb037c49eae9379e3d270f3a8edc5cc0f625ec570bf26c46e97d3e4efee894d3a68c6369c6a21959f6f0ee58f54101cf943b683ea649cc
+  metadata.gz: 7896dfb66cb867dfc7492933fc65306eedad2d4db367d844233a8dca9e7e5a0419e950547c090f42f670b38eac8cd8d343439743b31354d14911574fe49702b5
+  data.tar.gz: 4c0f483938302514b0ec111a1b531c1babd3c84d45932069178163d43b9398804a41a6f480588342de3e203bf5abcb29092b28da9793e1f8aee2e246b0a968b0

data/lib/brute/events/handler.rb

@@ -4,57 +4,18 @@ require 'bundler/setup'
 require 'brute'
 
 module Brute
+  # @namespace
   module Events
-    # EXAMPLES:
-    # class TerminalOutput < Brute::Events::Handler
-    #   def <<(event)
-    #     h = event.to_h
-    #     case h[:type]
-    #     when :content       then write(h[:data])
-    #     when :tool_result   then write("  ✓ #{h[:data][:name]}\n")
-    #     when :log           then write("[#{h[:data]}]\n")
-    #     end
-    #     super  # forward to whatever's wrapped underneath
-    #   end
-    # 
-    #   private
-    #   def write(text); $stderr.write(text); $stderr.flush; end
-    # end
-    # 
-    # class JsonlTrace < Brute::Events::Handler
-    #   def initialize(inner, path:)
-    #     super(inner)
-    #     @file = File.open(path, "a")
-    #   end
-    # 
-    #   def <<(event)
-    #     @file.puts(JSON.generate(event.to_h))
-    #     @file.flush
-    #     super
-    #   end
-    # end
-    # 
-    # class FilterNoise < Brute::Events::Handler
-    #   # Drop reasoning chunks before they reach the terminal
-    #   def <<(event)
-    #     return self if event.to_h[:type] == :reasoning
-    #     super
-    #   end
-    # end
-    #
-    # pipeline = Brute::Pipeline.new do
-    #   use Brute::Middleware::EventHandler, handler_class: JsonlTrace, path: "trace.jsonl"
-    #   use Brute::Middleware::EventHandler, handler_class: FilterNoise
-    #   use Brute::Middleware::EventHandler, handler_class: TerminalOutput
-    # end
-    #
+    # Stackable event handler base class. Subclasses override the
+    # append method, do their thing, then call super (or don't, to
+    # swallow the event).
     class Handler
       def initialize(inner)
         @inner = inner
       end
 
-      # Default: pass through. Subclasses override <<, do their thing,
-      # then super (or don't, to swallow the event).
+      # Default: pass through. Subclasses override this method, do their
+      # thing, then call super (or don't, to swallow the event).
       def <<(event)
         tap do
           @inner << event if @inner

data/lib/brute/middleware/020_system_prompt.rb

@@ -18,7 +18,7 @@ module Brute
     #
     #   use Brute::Middleware::SystemPrompt,
     #       system_prompt: Brute::SystemPrompt.build { |p, _ctx|
-    #         p << Brute::Prompts.agent_prompt("explore")
+    #         p.append Brute::Prompts.agent_prompt("explore")
     #       }
     #
     # Skips injection when env[:messages] already contains a :system

data/lib/brute/middleware/060_questions.rb

@@ -11,26 +11,7 @@ module Brute
       end
 
       def call(env)
-        @app.call(env).tap do
-          #if env[:messages].last.tool_call?
-          #  questions = last_message.tool_calls.select { |_id, tc| tc.name == "question" }
-
-          #  if questions.any?
-          #    env[:events] << {
-          #      type: :tool_call_start,
-          #      data: questions.map { |_id, tc| { name: tc.name, call_id: tc.id, arguments: tc.arguments } }
-          #    }
-
-          #    questions.each do |_id, question|
-          #      result = question.call
-
-          #      env[:events] << { type: :tool_result, data: { name: tc.name, content: content } }
-
-          #      env[:messages] << RubyLLM::Message.new(role: :tool, content: content, tool_call_id: tc.id)
-          #    end
-          #  end
-          #end
-        end
+        @app.call(env)
       end
     end
   end

data/lib/brute/queue/file_mutation_queue.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Brute
+  # @namespace
   module Queue
   # Per-file serialization queue for concurrent tool execution.
   #
@@ -36,9 +37,9 @@ module Brute
       # sequentially in FIFO order. Calls targeting different paths
       # proceed in parallel with zero contention.
       #
-      # @param path [String] The file path to serialize on.
-      # @yield The mutation work to perform (snapshot, read, write, etc.)
-      # @return Whatever the block returns.
+      # @parameter path [String] The file path to serialize on.
+      # @yields {block} The mutation work to perform (snapshot, read, write, etc.)
+      # @returns Whatever the block returns.
       def serialize(path, &block)
         key = canonical_path(path)
         mutex = acquire_mutex(key)

data/lib/brute/session.rb

@@ -20,7 +20,7 @@ module Brute
         if File.exist?(path)
           File.foreach(path).map(&:strip).each do |line|
             if line.present?
-              # Use push to bypass << persistence (avoids re-writing existing lines)
+              # Use push to bypass append persistence (avoids re-writing existing lines)
               session.push(RubyLLM::Message.new(**JSON.parse(line, symbolize_names: true)))
             end
           end

data/lib/brute/store/snapshot_store.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Brute
+  # @namespace
   module Store
     # Per-path stack of file snapshots used by fs_write, fs_patch, fs_remove
     # to enable undo. Each call to .save pushes the current content (or

data/lib/brute/store/todo_store.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Brute
+  # @namespace
   module Store
   # In-memory todo list storage. The agent uses this to track multi-step tasks.
   # The list is replaced wholesale on each todo_write call.

data/lib/brute/system_prompt.rb

@@ -10,9 +10,9 @@ module Brute
   # is called with a runtime context hash (provider_name, model_name, cwd, etc).
   #
   #   sp = Brute::SystemPrompt.build do |prompt, ctx|
-  #     prompt << Brute::Prompts::Identity.call(ctx)
-  #     prompt << Brute::Prompts::ToneAndStyle.call(ctx)
-  #     prompt << Brute::Prompts::Environment.call(ctx)
+  #     prompt.append Brute::Prompts::Identity.call(ctx)
+  #     prompt.append Brute::Prompts::ToneAndStyle.call(ctx)
+  #     prompt.append Brute::Prompts::Environment.call(ctx)
   #   end
   #
   #   result = sp.prepare(provider_name: "anthropic", model_name: "claude-sonnet-4-20250514", cwd: Dir.pwd)

data/lib/brute/tools/fs_read.rb

@@ -20,7 +20,7 @@ module Brute
     #    When reading completes, append "(End of file - total N lines)".
     # 5. Binary file detection — read first 4 KB sample, check for null bytes
     #    and known binary extensions (.zip, .exe, .so, .pyc, etc.).
-    #    Reject with "Cannot read binary file: <path>".
+    #    Reject with "Cannot read binary file: (path)".
     # 6. Directory listing — when file_path points to a directory, list entries
     #    (paginated, respecting limit) instead of raising an error.
     # 7. File-not-found suggestions — on miss, scan the parent directory for

data/lib/brute/tools/shell.rb

@@ -61,41 +61,41 @@ module Brute
 end
 
 test do
-  it "runs a command without error" do
-    result = Brute::Tools::Shell.new.call(command: "echo hello")
-    result.strip.should =~ /hello/
-  end
-
-  it "returns exit code" do
-    result = Brute::Tools::Shell.new.call(command: "false")
-    result.should =~ /exit code: 1/
-  end
-
-  it "returns a String, not a Hash" do
-    Brute::Tools::Shell.new.call(command: "echo hello").should.be.kind_of(String)
-  end
-
-  it "preserves the end of output when truncating (tail mode)" do
-    result = Brute::Tools::Shell.new.call(command: "seq 1 100000")
-    result.should =~ /100000/
-  end
-
-  # --- Save full output to disk ---
-
-  it "saves full output to disk when truncated" do
-    result = Brute::Tools::Shell.new.call(command: "seq 1 100000")
-    result.should =~ /Full output saved to:/
-  end
-
-  # --- Configurable timeout ---
-
-  it "accepts a timeout parameter" do
-    result = Brute::Tools::Shell.new.call(command: "sleep 0.1 && echo done", timeout: 10)
-    result.should =~ /done/
-  end
-
-  it "times out with a short timeout" do
-    result = Brute::Tools::Shell.new.call(command: "sleep 10", timeout: 1)
-    result.should =~ /timed out/i
-  end
+  #it "runs a command without error" do
+  #  result = Brute::Tools::Shell.new.call(command: "echo hello")
+  #  result.strip.should =~ /hello/
+  #end
+
+  #it "returns exit code" do
+  #  result = Brute::Tools::Shell.new.call(command: "false")
+  #  result.should =~ /exit code: 1/
+  #end
+
+  #it "returns a String, not a Hash" do
+  #  Brute::Tools::Shell.new.call(command: "echo hello").should.be.kind_of(String)
+  #end
+
+  #it "preserves the end of output when truncating (tail mode)" do
+  #  result = Brute::Tools::Shell.new.call(command: "seq 1 100000")
+  #  result.should =~ /100000/
+  #end
+
+  ## --- Save full output to disk ---
+
+  #it "saves full output to disk when truncated" do
+  #  result = Brute::Tools::Shell.new.call(command: "seq 1 100000")
+  #  result.should =~ /Full output saved to:/
+  #end
+
+  ## --- Configurable timeout ---
+
+  #it "accepts a timeout parameter" do
+  #  result = Brute::Tools::Shell.new.call(command: "sleep 0.1 && echo done", timeout: 10)
+  #  result.should =~ /done/
+  #end
+
+  #it "times out with a short timeout" do
+  #  result = Brute::Tools::Shell.new.call(command: "sleep 10", timeout: 1)
+  #  result.should =~ /timed out/i
+  #end
 end

data/lib/brute/truncation.rb

@@ -25,7 +25,7 @@ module Brute
   #    under TRUNCATION_DIR (e.g. ~/.local/share/brute/tool-output/).
   #    Return a preview + hint pointing to the saved file.
   # 5. Hint message — when truncated, append a contextual hint:
-  #    "Full output saved to: <path>. Use Read with offset/limit to
+  #    "Full output saved to: (path). Use Read with offset/limit to
   #    view specific sections."
   # 6. Configurable limits — allow overriding MAX_LINES / MAX_BYTES
   #    via per-call options.
@@ -47,12 +47,12 @@ module Brute
     # Returns the text unchanged if it fits. Otherwise returns a
     # truncated preview with a hint message.
     #
-    # @param text [String] the tool output to truncate
-    # @param max_lines [Integer] maximum number of lines to keep
-    # @param max_bytes [Integer] maximum byte size to keep
-    # @param direction [:head, :tail] which end to keep
-    # @param truncation_dir [String, nil] directory to save full output when truncating
-    # @return [String] the (possibly truncated) text
+    # @parameter text [String] the tool output to truncate
+    # @parameter max_lines [Integer] maximum number of lines to keep
+    # @parameter max_bytes [Integer] maximum byte size to keep
+    # @parameter direction [Symbol] which end to keep
+    # @parameter truncation_dir [String, nil] directory to save full output when truncating
+    # @returns [String] the (possibly truncated) text
     #
     def self.truncate(text, max_lines: MAX_LINES, max_bytes: MAX_BYTES, direction: :head, truncation_dir: nil)
       return text if text.nil? || text.empty?

data/lib/brute/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Brute
-  VERSION = "2.0.4"
+  VERSION = "2.0.5"
 end

data/lib/brute.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'ruby_llm'
+require "rack"
 require 'timeout'
 require 'logger'
 require 'scampi/kernel_ext'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brute
 version: !ruby/object:Gem::Version
-  version: 2.0.4
+  version: 2.0.5
 platform: ruby
 authors:
 - Brute Contributors
@@ -93,6 +93,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: net-http-persistent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.34'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.34'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -201,9 +257,11 @@ files:
 - lib/brute/truncation.rb
 - lib/brute/utils/diff.rb
 - lib/brute/version.rb
+homepage: https://github.com/general-intelligence-systems/brute
 licenses:
 - MIT
-metadata: {}
+metadata:
+  documentation_uri: https://general-intelligence-systems.github.io/brute/
 rdoc_options: []
 require_paths:
 - lib
@@ -211,7 +269,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.4'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="