brute 0.4.1 → 1.0.0

data/lib/brute/tools/fs_write.rb

@@ -1,10 +1,7 @@
 # frozen_string_literal: true
 
-if __FILE__ == $0
-  require "bundler/setup"
-  require "brute"
-end
-
+require "bundler/setup"
+require "brute"
 require 'fileutils'
 
 module Brute
@@ -19,9 +16,9 @@ module Brute
 
       def call(file_path:, content:)
         path = File.expand_path(file_path)
-        Brute::FileMutationQueue.serialize(path) do
+        Brute::Queue::FileMutationQueue.serialize(path) do
           old_content = File.exist?(path) ? File.read(path) : ''
-          Brute::SnapshotStore.save(path)
+          Brute::Store::SnapshotStore.save(path)
           FileUtils.mkdir_p(File.dirname(path))
           File.write(path, content)
           diff = Brute::Diff.unified(old_content, content)
@@ -32,47 +29,38 @@ module Brute
   end
 end
 
-if __FILE__ == $0
-  require_relative "../../../spec/spec_helper"
-
-  RSpec.describe Brute::Tools::FSWrite do
-    around(:each) { |ex| Dir.mktmpdir { |d| @dir = d; ex.run } }
+test do
+  require "tmpdir"
 
-    let(:tool) { described_class.new }
-
-    it "writes content to a new file" do
-      path = File.join(@dir, "new.rb")
-      result = tool.call(file_path: path, content: "hello\n")
-      expect(result[:success]).to be true
-      expect(File.read(path)).to eq("hello\n")
-    end
-
-    it "returns a diff for new files" do
-      path = File.join(@dir, "new.rb")
-      result = tool.call(file_path: path, content: "line1\nline2\n")
-      expect(result[:diff]).to include("+line1")
-      expect(result[:diff]).to include("+line2")
+  it "writes content to a new file" do
+    Dir.mktmpdir do |dir|
+      path = File.join(dir, "new.rb")
+      Brute::Tools::FSWrite.new.call(file_path: path, content: "hello\n")
+      File.read(path).should == "hello\n"
     end
+  end
 
-    it "returns a diff for overwritten files" do
-      path = File.join(@dir, "existing.rb")
-      File.write(path, "old content\n")
-      result = tool.call(file_path: path, content: "new content\n")
-      expect(result[:diff]).to include("-old content")
-      expect(result[:diff]).to include("+new content")
+  it "returns a diff for new files" do
+    Dir.mktmpdir do |dir|
+      path = File.join(dir, "new.rb")
+      result = Brute::Tools::FSWrite.new.call(file_path: path, content: "line1\nline2\n")
+      result[:diff].should =~ /\+line1/
     end
+  end
 
-    it "creates parent directories" do
-      path = File.join(@dir, "deep", "nested", "file.rb")
-      result = tool.call(file_path: path, content: "nested\n")
-      expect(result[:success]).to be true
-      expect(File.exist?(path)).to be true
+  it "creates parent directories" do
+    Dir.mktmpdir do |dir|
+      path = File.join(dir, "deep", "nested", "file.rb")
+      result = Brute::Tools::FSWrite.new.call(file_path: path, content: "nested\n")
+      result[:success].should.be.true
     end
+  end
 
-    it "returns byte count" do
-      path = File.join(@dir, "test.rb")
-      result = tool.call(file_path: path, content: "hello")
-      expect(result[:bytes]).to eq(5)
+  it "returns byte count" do
+    Dir.mktmpdir do |dir|
+      path = File.join(dir, "test.rb")
+      result = Brute::Tools::FSWrite.new.call(file_path: path, content: "hello")
+      result[:bytes].should == 5
     end
   end
 end

data/lib/brute/tools/todo_read.rb

@@ -13,7 +13,7 @@ module Brute
       param :_placeholder, String, "Unused, pass any value"
 
       def call(_placeholder: nil)
-        {todos: Brute::TodoStore.all}
+        {todos: Brute::Store::TodoStore.all}
       end
     end
   end

data/lib/brute/tools/todo_write.rb

@@ -29,7 +29,7 @@ module Brute
           t = t.transform_keys(&:to_sym) if t.is_a?(Hash)
           {id: t[:id], content: t[:content], status: t[:status]}
         end
-        Brute::TodoStore.replace(items)
+        Brute::Store::TodoStore.replace(items)
         {success: true, count: items.size}
       end
     end

data/lib/brute/tools.rb

@@ -0,0 +1,31 @@
+require_relative 'tools/fs_read'
+require_relative 'tools/fs_write'
+require_relative 'tools/fs_patch'
+require_relative 'tools/fs_remove'
+require_relative 'tools/fs_search'
+require_relative 'tools/fs_undo'
+require_relative 'tools/shell'
+require_relative 'tools/net_fetch'
+require_relative 'tools/todo_write'
+require_relative 'tools/todo_read'
+require_relative 'tools/delegate'
+require_relative 'tools/question'
+
+module Brute
+  module Tools
+    ALL = [
+      Tools::FSRead,
+      Tools::FSWrite,
+      Tools::FSPatch,
+      Tools::FSRemove,
+      Tools::FSSearch,
+      Tools::FSUndo,
+      Tools::Shell,
+      Tools::NetFetch,
+      Tools::TodoWrite,
+      Tools::TodoRead,
+      Tools::Delegate,
+      Tools::Question
+    ].freeze
+  end
+end

data/lib/brute/version.rb

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

data/lib/brute.rb

@@ -3,6 +3,7 @@
 require 'llm'
 require 'timeout'
 require 'logger'
+require 'scampi/kernel_ext'
 
 # Brute — a coding agent built on llm.rb
 #
@@ -11,220 +12,55 @@ require 'logger'
 #
 #   Tracing → Retry → Session → Tokens → Compaction → ToolErrors → DoomLoop → Reasoning → [LLM Call]
 #
+# Entry point:
+#
+#   agent = Brute::Agent.new(provider:, model:, tools:, system_prompt:)
+#   step  = Brute::Loop::AgentTurn.perform(agent:, session:, pipeline:, input:)
+#
 require_relative 'brute/version'
 
 module Brute
-  module Tools; end
-  module Hooks; end
-  module Middleware; end
+  def self.provider
+    @provider ||= Brute::Providers.guess_from_env
+  end
+
+  def self.provider=(p)
+    @provider = p
+  end
 end
 
-# Infrastructure
 require_relative 'brute/diff'
-require_relative 'brute/snapshot_store'
-require_relative 'brute/todo_store'
-require_relative 'brute/file_mutation_queue'
-require_relative 'brute/doom_loop'
-require_relative 'brute/hooks'
-require_relative 'brute/compactor'
-require_relative 'brute/prompts/base'
-require_relative 'brute/prompts/identity'
-require_relative 'brute/prompts/tone_and_style'
-require_relative 'brute/prompts/objectivity'
-require_relative 'brute/prompts/task_management'
-require_relative 'brute/prompts/doing_tasks'
-require_relative 'brute/prompts/tool_usage'
-require_relative 'brute/prompts/conventions'
-require_relative 'brute/prompts/git_safety'
-require_relative 'brute/prompts/code_references'
-require_relative 'brute/prompts/environment'
-require_relative 'brute/prompts/instructions'
-require_relative 'brute/prompts/editing_approach'
-require_relative 'brute/prompts/autonomy'
-require_relative 'brute/prompts/editing_constraints'
-require_relative 'brute/prompts/frontend_tasks'
-require_relative 'brute/prompts/proactiveness'
-require_relative 'brute/prompts/code_style'
-require_relative 'brute/prompts/security_and_safety'
-require_relative 'brute/prompts/skills'
-require_relative 'brute/prompts/plan_reminder'
-require_relative 'brute/prompts/max_steps'
-require_relative 'brute/prompts/build_switch'
 require_relative 'brute/skill'
+require_relative 'brute/prompts'
 require_relative 'brute/system_prompt'
-require_relative 'brute/message_store'
-require_relative 'brute/session'
 require_relative 'brute/pipeline'
-require_relative 'brute/agent_stream'
+require_relative 'brute/agent'
+
+# Brute::Store
+require_relative 'brute/store/snapshot_store'
+require_relative 'brute/store/todo_store'
+require_relative 'brute/store/message_store'
+require_relative 'brute/store/session'
+
+# Brute::Loop (before Queue — queue tests reference Loop::Step)
+require_relative 'brute/loop/doom_loop'
+require_relative 'brute/loop/compactor'
+require_relative 'brute/loop/agent_stream'
+require_relative 'brute/loop/step'
+require_relative 'brute/loop/tool_call_step'
+
+# Brute::Queue
+require_relative 'brute/queue/file_mutation_queue'
+require_relative 'brute/queue/base_queue'
+require_relative 'brute/queue/sequential_queue'
+require_relative 'brute/queue/parallel_queue'
+
+# Brute::Loop (agent_turn depends on Queue)
+require_relative 'brute/loop/agent_turn'
 
-# Provider patches
 require_relative 'brute/patches/anthropic_tool_role'
 require_relative 'brute/patches/buffer_nil_guard'
 
-# Middleware (Rack-style)
-require_relative 'brute/middleware/base'
-require_relative 'brute/middleware/llm_call'
-require_relative 'brute/middleware/retry'
-require_relative 'brute/middleware/doom_loop_detection'
-require_relative 'brute/middleware/token_tracking'
-require_relative 'brute/middleware/compaction_check'
-require_relative 'brute/middleware/session_persistence'
-require_relative 'brute/middleware/message_tracking'
-require_relative 'brute/middleware/tracing'
-require_relative 'brute/middleware/tool_error_tracking'
-require_relative 'brute/middleware/reasoning_normalizer'
-require_relative "brute/middleware/tool_use_guard"
-require_relative "brute/middleware/otel"
-
-# Tools
-require_relative 'brute/tools/fs_read'
-require_relative 'brute/tools/fs_write'
-require_relative 'brute/tools/fs_patch'
-require_relative 'brute/tools/fs_remove'
-require_relative 'brute/tools/fs_search'
-require_relative 'brute/tools/fs_undo'
-require_relative 'brute/tools/shell'
-require_relative 'brute/tools/net_fetch'
-require_relative 'brute/tools/todo_write'
-require_relative 'brute/tools/todo_read'
-require_relative 'brute/tools/delegate'
-require_relative 'brute/tools/question'
-
-# Providers
-require_relative 'brute/providers/shell_response'
-require_relative 'brute/providers/shell'
-require_relative 'brute/providers/models_dev'
-require_relative 'brute/providers/opencode_zen'
-require_relative 'brute/providers/opencode_go'
-
-# Orchestrator (depends on tools, middleware, and infrastructure)
-require_relative 'brute/orchestrator'
-
-module Brute
-  # The complete set of tools available to the agent.
-  TOOLS = [
-    Tools::FSRead,
-    Tools::FSWrite,
-    Tools::FSPatch,
-    Tools::FSRemove,
-    Tools::FSSearch,
-    Tools::FSUndo,
-    Tools::Shell,
-    Tools::NetFetch,
-    Tools::TodoWrite,
-    Tools::TodoRead,
-    Tools::Delegate,
-    Tools::Question
-  ].freeze
-
-  # Default provider, resolved from environment.
-  def self.provider
-    @provider ||= resolve_provider
-  end
-
-  def self.provider=(p)
-    @provider = p
-  end
-
-  # Create a new orchestrator with sensible defaults.
-  def self.agent(cwd: Dir.pwd, model: nil, tools: TOOLS, session: nil, reasoning: {}, agent_name: nil, **callbacks)
-    Orchestrator.new(
-      provider: provider,
-      model: model,
-      tools: tools,
-      cwd: cwd,
-      session: session,
-      reasoning: reasoning,
-      agent_name: agent_name,
-      **callbacks
-    )
-  end
-
-  PROVIDERS = {
-    'anthropic' => ->(key) { LLM.anthropic(key: key).tap { Patches::AnthropicToolRole.apply! } },
-    'openai' => ->(key) { LLM.openai(key: key) },
-    'google' => ->(key) { LLM.google(key: key) },
-    'deepseek' => ->(key) { LLM.deepseek(key: key) },
-    'ollama' => ->(key) { LLM.ollama(key: key) },
-    'xai' => ->(key) { LLM.xai(key: key) },
-    'opencode_zen' => ->(key) { LLM::OpencodeZen.new(key: key) },
-    'opencode_go' => ->(key) { LLM::OpencodeGo.new(key: key) },
-    'shell' => ->(_key) { Providers::Shell.new },
-  }.freeze
-
-  # List provider names that have API keys configured in the environment.
-  # The shell provider is always available (no key needed).
-  def self.configured_providers
-    PROVIDERS.keys.select { |name| api_key_for(name) }
-  end
-
-  # Build a provider instance for the given name using available API keys.
-  # Returns nil if no key is found.
-  def self.provider_for(name)
-    key = api_key_for(name)
-    return nil unless key
-
-    factory = PROVIDERS[name]
-    return nil unless factory
-
-    factory.call(key)
-  end
-
-  # Look up the API key for a given provider name.
-  def self.api_key_for(name)
-    # Shell provider needs no key.
-    return "none" if name == "shell"
-
-    # OpenCode providers: check OPENCODE_API_KEY, fall back to "public" for anonymous access.
-    if name == "opencode_zen" || name == "opencode_go"
-      return ENV["OPENCODE_API_KEY"] || "public"
-    end
-
-    # Explicit generic key always works
-    return ENV["LLM_API_KEY"] if ENV["LLM_API_KEY"]
-
-    case name
-    when "anthropic" then ENV["ANTHROPIC_API_KEY"]
-    when "openai"    then ENV["OPENAI_API_KEY"]
-    when "google"    then ENV["GOOGLE_API_KEY"]
-    end
-  end
-
-  # Resolve the LLM provider from environment variables.
-  #
-  # Checks in order:
-  #   1. LLM_API_KEY + LLM_PROVIDER (explicit)
-  #   2. OPENCODE_API_KEY (implicit: provider = opencode_zen)
-  #   3. ANTHROPIC_API_KEY (implicit: provider = anthropic)
-  #   4. OPENAI_API_KEY   (implicit: provider = openai)
-  #   5. GOOGLE_API_KEY   (implicit: provider = google)
-  #
-  # Returns nil if no key is found. Error is deferred to Orchestrator#run.
-  def self.resolve_provider
-    if ENV['LLM_API_KEY']
-      key = ENV['LLM_API_KEY']
-      name = ENV.fetch('LLM_PROVIDER', 'opencode_zen').downcase
-    elsif ENV['OPENCODE_API_KEY']
-      key = ENV['OPENCODE_API_KEY']
-      name = 'opencode_zen'
-    elsif ENV['ANTHROPIC_API_KEY']
-      key = ENV['ANTHROPIC_API_KEY']
-      name = 'anthropic'
-    elsif ENV['OPENAI_API_KEY']
-      key = ENV['OPENAI_API_KEY']
-      name = 'openai'
-    elsif ENV['GOOGLE_API_KEY']
-      key = ENV['GOOGLE_API_KEY']
-      name = 'google'
-    else
-      return nil
-    end
-
-    factory = PROVIDERS[name]
-    raise "Unknown LLM provider: #{name}. Available: #{PROVIDERS.keys.join(', ')}" unless factory
-
-    factory.call(key)
-  end
-
-  private_class_method :resolve_provider
-end
+require_relative 'brute/middleware'
+require_relative 'brute/tools'
+require_relative 'brute/providers'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brute
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Brute Contributors
@@ -52,33 +52,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '4.11'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: scampi
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: '13.0'
 description: Production-grade coding agent with tool execution, middleware pipeline,
   context compaction, session persistence, and multi-provider LLM support.
 executables: []
@@ -86,13 +86,15 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/brute.rb
-- lib/brute/agent_stream.rb
-- lib/brute/compactor.rb
+- lib/brute/agent.rb
 - lib/brute/diff.rb
-- lib/brute/doom_loop.rb
-- lib/brute/file_mutation_queue.rb
-- lib/brute/hooks.rb
-- lib/brute/message_store.rb
+- lib/brute/loop/agent_stream.rb
+- lib/brute/loop/agent_turn.rb
+- lib/brute/loop/compactor.rb
+- lib/brute/loop/doom_loop.rb
+- lib/brute/loop/step.rb
+- lib/brute/loop/tool_call_step.rb
+- lib/brute/middleware.rb
 - lib/brute/middleware/base.rb
 - lib/brute/middleware/compaction_check.rb
 - lib/brute/middleware/doom_loop_detection.rb
@@ -110,10 +112,11 @@ files:
 - lib/brute/middleware/tool_error_tracking.rb
 - lib/brute/middleware/tool_use_guard.rb
 - lib/brute/middleware/tracing.rb
-- lib/brute/orchestrator.rb
+- lib/brute/orchestrator/turn.rb
 - lib/brute/patches/anthropic_tool_role.rb
 - lib/brute/patches/buffer_nil_guard.rb
 - lib/brute/pipeline.rb
+- lib/brute/prompts.rb
 - lib/brute/prompts/autonomy.rb
 - lib/brute/prompts/base.rb
 - lib/brute/prompts/build_switch.rb
@@ -155,16 +158,24 @@ files:
 - lib/brute/prompts/text/tool_usage/google.txt
 - lib/brute/prompts/tone_and_style.rb
 - lib/brute/prompts/tool_usage.rb
+- lib/brute/providers.rb
 - lib/brute/providers/models_dev.rb
+- lib/brute/providers/ollama.rb
 - lib/brute/providers/opencode_go.rb
 - lib/brute/providers/opencode_zen.rb
 - lib/brute/providers/shell.rb
 - lib/brute/providers/shell_response.rb
-- lib/brute/session.rb
+- lib/brute/queue/base_queue.rb
+- lib/brute/queue/file_mutation_queue.rb
+- lib/brute/queue/parallel_queue.rb
+- lib/brute/queue/sequential_queue.rb
 - lib/brute/skill.rb
-- lib/brute/snapshot_store.rb
+- lib/brute/store/message_store.rb
+- lib/brute/store/session.rb
+- lib/brute/store/snapshot_store.rb
+- lib/brute/store/todo_store.rb
 - lib/brute/system_prompt.rb
-- lib/brute/todo_store.rb
+- lib/brute/tools.rb
 - lib/brute/tools/delegate.rb
 - lib/brute/tools/fs_patch.rb
 - lib/brute/tools/fs_read.rb