robot_lab 0.2.7 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36b770d963e004a951cdf35d07a2e867e4e661a9e342e8047184cfd9dafd6e15
-  data.tar.gz: f53bb5c52efcd6169bf36afc69306a9c03e9cfcabdaf5b0a94871802e2909f55
+  metadata.gz: 411c496dec788609f2ac0d2e1eb02ce7fd0523f40424b9437de0ffb24c00c644
+  data.tar.gz: 9fb9bb55b865734dc7c9ae1ac8d1994685575c1ee206d6cf9865c0af3d3a522c
 SHA512:
-  metadata.gz: 850bde0e9ac1b7d65176bd067f42751d6d9db64517ca665d4765837fc5493e204f9b333cac08019cb451962d4d95789f986dee2ff08e55ae5e6a0d3d034f4f50
-  data.tar.gz: 97eb4dc66458a9a43f861e3f9c927eb6cfa63d33ddfff150b4181a45dc2c0db9570095f2e71d1182b76b4ee85e7086a6014b5536e805d9956f0860f9b4a03f50
+  metadata.gz: b34ce72ebe6443c5f25423a595c0ffd468416ea1be02531b125efed33289ae8ea898c5413697fe373cebd658bddb510f322ef09623bb7b74f7587cf58b9ad064
+  data.tar.gz: e9884f0c8b501bfc57eafdc6c5492fea7455eb807267c370fc68b59e7322f97c0360e3af6f7e61b7c2493df3e2026f72095b9c287e65e6bf5f1ec5274948ef7d

data/.envrc

@@ -1,2 +1,6 @@
-export RR=`pwd`
-export BUNDLE_GEMFILE=Gemfile
+# robot_lab_project/robot_lab/.envrc
+
+source_up
+
+export RR=$(pwd)
+# BUNDLE_GEMFILE is inherited from the project root .envrc (asgard dev|prod)

data/.loki

@@ -18,6 +18,11 @@ class Tasks
     sh "ruby -Ilib:test \"#{path}\""
   end
 
+  desc "Check architecture boundaries with ArchSpec"
+  def archspec
+    sh "bundle exec archspec check"
+  end
+
   class DocsCommands < Tasks
     desc "Build YARD + MkDocs documentation"
     def build

data/Archspec.rb

@@ -0,0 +1,44 @@
+component :robot,         in: "lib/robot_lab/robot.rb"
+component :robot_support, in: "lib/robot_lab/robot/**/*.rb"
+component :network,       in: ["lib/robot_lab/network.rb", "lib/robot_lab/bus_poller.rb"]
+component :memory,        in: ["lib/robot_lab/memory.rb", "lib/robot_lab/memory_change.rb"]
+component :mcp,           in: "lib/robot_lab/mcp/**/*.rb"
+component :sandbox,       in: ["lib/robot_lab/sandbox.rb", "lib/robot_lab/sandbox/**/*.rb"]
+component :streaming,     in: "lib/robot_lab/streaming/**/*.rb"
+component :budget,        in: "lib/robot_lab/budget/**/*.rb"
+component :hooks,         in: %w[
+  lib/robot_lab/hook.rb
+  lib/robot_lab/hook_context.rb
+  lib/robot_lab/hook_registry.rb
+  lib/robot_lab/hooks.rb
+]
+component :tools, in: %w[
+  lib/robot_lab/tool.rb
+  lib/robot_lab/tool_config.rb
+  lib/robot_lab/tool_manifest.rb
+  lib/robot_lab/script_tool.rb
+]
+component :config, in: ["lib/robot_lab/config.rb", "lib/robot_lab/run_config.rb"]
+
+# NOTE: every file here reopens `module RobotLab`, so a `dependencies.forbid`
+# rule keyed on components (e.g. `memory.cannot_use :robot`) treats a plain
+# `RobotLab.config` call as "depends on every component" — every file
+# "defines" the bare RobotLab constant. Naming the actual target constants
+# instead of components sidesteps that ambiguity.
+
+# Memory is a low-level primitive shared by Robot and Network; it must not
+# depend back on the things that depend on it.
+memory.cannot_reference_constants "RobotLab::Robot", "RobotLab::Network"
+
+# MCP is an external-tool integration layer that Robot/Network consume; it
+# must not reach back into the objects that use it.
+mcp.cannot_reference_constants "RobotLab::Robot", "RobotLab::Network"
+
+# Sandbox runs untrusted/generated code paths and should have the smallest
+# possible surface area — no reaching into orchestration or memory internals.
+sandbox.cannot_reference_constants "RobotLab::Robot", "RobotLab::Network", "RobotLab::Memory"
+
+# Config/RunConfig sits at the bottom of the configuration cascade
+# (RobotLab.config -> Network -> Robot -> template -> task -> runtime) and
+# must not depend upward on the objects it configures.
+config.cannot_reference_constants "RobotLab::Robot", "RobotLab::Network"

data/CHANGELOG.md

@@ -6,7 +6,60 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
-## [Unreleased]
+## [0.3.0] - 2026-09-18
+
+The ruby_llm 2.0 release. Core moves from ruby_llm 1.x to the official 2.0.0
+release; every `robot_lab-*` extension gem releases in lockstep at 0.3.0 and
+now requires `robot_lab ~> 0.3.0`.
+
+### Changed (BREAKING)
+- **ruby_llm 1.x → 2.0.** The gemspec now requires `ruby_llm "~> 2.0"`
+  (official release). Robot tools written with the 1.x DSL must migrate:
+  `param` → `parameter`, `desc:` → `description:`; `halt` is gone (the caller
+  controls the loop). Token counts moved to `response.tokens.input/.output`,
+  and `finish_reason` (Symbol) replaces `stop_reason`. The `claude-sonnet-4`
+  registry alias no longer resolves; the default models are now
+  `claude-sonnet-4-6` (production) and `claude-haiku-4-5` (test).
+- **Dropped hard dependencies** on `ruby_llm-mcp`, `ruby_llm-schema`, and
+  `ruby_llm-semantic_cache`. Semantic caching is now optional: `Memory#cache`
+  returns `nil` when `ruby_llm-semantic_cache` is not installed and Memory
+  runs with caching disabled. (Its released versions still pin ruby_llm 1.x,
+  so it cannot co-resolve with 2.0 yet.)
+
+### Added
+- `ruby_llm-providers-apfel` and `ruby_llm-providers-lms` (`~> 0.2.1`) as
+  runtime dependencies, consumed as released gems — the local `path:`
+  overrides for sibling checkouts are gone from the Gemfiles.
+- `Robot::ResultBuilding` — extracted module that adapts a ruby_llm response
+  into a `RobotResult` (token accounting, stop-reason normalization, message
+  coercion).
+- `examples/run_all.rb` — runs every executable `NN_*.rb` demo serially with
+  a banner between each; works from any cwd, and Ctrl-C terminates only the
+  demo currently running (the runner notes it and moves on).
+- READMEs for the subdirectory demos: `15_memory_network_and_bus`,
+  `26_document_store` (corpus), and `27_incident_response`.
+- Fasterer quality gate now actually runs: `fasterer` added to the
+  development group, with a `.fasterer.yml` documenting the disabled
+  speed-over-readability checks.
+
+### Changed
+- Robot, Tool, RunConfig, and the hook system adapted to the ruby_llm 2.0
+  API; docs and examples synced to match.
+- Examples run against a local LM Studio server through the `:lms` provider;
+  `examples/common.rb` anchors `BUNDLE_GEMFILE` to the gem root so demos run
+  from any directory, and `examples/README.md` notes that demo speed and
+  answer quality depend on the provider/model in use.
+- `.envrc` no longer exports `BUNDLE_GEMFILE`; it is inherited from the
+  project root (`asgard dev` / `asgard prod`).
+
+### Fixed
+- amazing_print 3.0 crash at demo startup (`undefined method 'try' for
+  module ActiveSupport`): robot_lab's dependencies load parts of
+  ActiveSupport, which tricked amazing_print into loading its Rails
+  extension; `examples/common.rb` now preloads
+  `active_support/core_ext/object/try` and `active_support/log_subscriber`.
+
+## [0.2.8] - 2026-09-09
 
 ### Added
 - `BusMessaging#respond_to_tasks` and `#serve` — a member auto-answers inbound
@@ -16,6 +69,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   without hand-wiring `on_message`.
 - `.loki` Asgard task file: `test`, `rubocop`, `rubocop_fix`, `flog`, `flay`, `quality`, `build`, `install`, `release`, `integration`, `docs`, and `examples` tasks via the Asgard task runner
 
+### Changed (BREAKING)
+- **Sandboxing extracted to `robot_lab-sandbox`.** `RobotLab::Sandbox`,
+  `RobotLab::Sandbox::Seatbelt`, and `RobotLab::Sandbox::Null` no longer live
+  in core; they moved verbatim to the new `robot_lab-sandbox` gem. Core has no
+  execution limitations of its own: `ScriptTool.execute` now delegates to an
+  optional `ScriptTool.executor` (`nil` by default, in which case it runs the
+  unconfined `Open3.capture2e` path with no timeout exactly as before).
+  Applications that want confined skill-script execution must add
+  `gem "robot_lab-sandbox"` and `require "robot_lab/sandbox"`, which installs
+  itself as the executor; `config.sandbox.*` behavior is unchanged from there.
+  `RobotLab::Capabilities` (the declarative fs_read/fs_write/network/timeout/
+  trust manifest parsed from `SKILL.md`) stays in core since `AgentSkill` needs
+  it regardless of whether sandboxing is enforced.
+- `ScriptTool.run_with_timeout` and `ScriptTool.terminate` moved to
+  `RobotLab::Sandbox::Executor` in `robot_lab-sandbox`.
+
 ### Fixed
 - `BusMessaging` now synchronizes its message counter and outbox with a mutex, so
   concurrent sends and poller-thread reply correlation can't clobber each other.

data/CLAUDE.md

@@ -55,7 +55,7 @@ bundle exec rake examples:run[1]
 
 ### Memory System
 
-- **`Memory`** (`lib/robot_lab/memory.rb`): Key-value store with reserved keys (`:data`, `:results`, `:messages`, `:session_id`, `:cache`). Supports Redis backend. Includes semantic caching via RubyLLM::SemanticCache
+- **`Memory`** (`lib/robot_lab/memory.rb`): Key-value store with reserved keys (`:data`, `:results`, `:messages`, `:session_id`, `:cache`). Supports Redis backend. Semantic caching via RubyLLM::SemanticCache when the optional ruby_llm-semantic_cache gem is installed (`memory.cache` is nil otherwise)
 
 ### MCP (Model Context Protocol)
 
@@ -119,7 +119,9 @@ Router receives `Router::Args` with: `context`, `network`, `stack`, `call_count`
 
 ## Dependencies
 
-Core: zeitwerk, ruby_llm (~> 1.12), ruby_llm-mcp, prompt_manager, ruby_llm-schema, ruby_llm-semantic_cache, async, simple_flow, state_machines
+Core: zeitwerk, ruby_llm (~> 2.0.0.rc3), prompt_manager, async, simple_flow, state_machines
+
+Optional: ruby_llm-semantic_cache (Memory#cache; no ruby_llm 2.0-compatible release yet — Memory runs with caching disabled when absent), classifier (compress_history), ruby_llm-providers-lms (local LM Studio provider used by the examples: qwen/qwen3.8-27b for complex work, openai/gpt-oss-20b for simple demos)
 
 ### Templates
 

data/README.md

@@ -21,7 +21,7 @@
 - <strong>Human-in-the-Loop</strong> - AskUser tool for interactive prompting<br>
 - <strong>Content Streaming</strong> - Stored callbacks, per-call blocks, or both<br>
 - <strong>MCP Integration</strong> - Connect to external tool servers with timeouts and retry<br>
-- <strong>Local LLM Providers</strong> - Ollama and GPUStack via provider passthrough<br>
+- <strong>Local LLM Providers</strong> - LM Studio (via ruby_llm-providers-lms), Ollama, and GPUStack via provider passthrough<br>
 - <strong>Shared Memory</strong> - Reactive key-value store with subscriptions<br>
 - <strong>Message Bus</strong> - Bidirectional robot communication via TypedBus<br>
 - <strong>Dynamic Spawning</strong> - Robots create new robots at runtime<br>
@@ -82,17 +82,15 @@ puts result.last_text_content
 
 ### Local LLM Providers
 
-For local LLM providers, use the `provider:` parameter. RubyLLM's provider list is the authority on valid values — `:ollama` and `:gpustack` are the local ones (alongside `:anthropic`, `:azure`, `:bedrock`, `:deepseek`, `:gemini`, `:mistral`, `:openai`, `:openrouter`, `:perplexity`, `:vertexai`, and `:xai`). The provider's API base must be configured first, or building the robot raises `RubyLLM::ConfigurationError`:
-
-```bash
-export ROBOT_LAB_RUBY_LLM__OLLAMA_API_BASE=http://localhost:11434/v1
-```
+For local LLM providers, use the `provider:` parameter. RubyLLM's provider list is the authority on valid values — `:ollama` and `:gpustack` are built in, and provider gems add more (alongside `:anthropic`, `:azure`, `:bedrock`, `:deepseek`, `:gemini`, `:mistral`, `:openai`, `:openrouter`, `:perplexity`, `:vertexai`, and `:xai`). The examples in this repo use LM Studio through the [ruby_llm-providers-lms](https://github.com/madbomber/ruby_llm-providers-lms) gem, which registers the `:lms` provider (defaults to `http://localhost:1234/v1`, no API key needed):
 
 ```ruby
+require "ruby_llm/providers/lms"
+
 robot = RobotLab.build(
   name: "local_bot",
-  model: "llama3.2",
-  provider: :ollama,
+  model: "qwen/qwen3.8-27b",   # complex work; use "openai/gpt-oss-20b" for simple chat
+  provider: :lms,
   system_prompt: "You are a helpful assistant."
 )
 ```
@@ -113,12 +111,12 @@ RobotLab uses [MywayConfig](https://github.com/MadBomber/myway_config) for layer
 # Set API keys via environment variables (double underscore for nesting)
 export ROBOT_LAB_RUBY_LLM__ANTHROPIC_API_KEY=sk-ant-...
 export ROBOT_LAB_RUBY_LLM__OPENAI_API_KEY=sk-...
-export ROBOT_LAB_RUBY_LLM__MODEL=claude-sonnet-4
+export ROBOT_LAB_RUBY_LLM__MODEL=claude-sonnet-4-6
 ```
 
 ```ruby
 # Access configuration values
-RobotLab.config.ruby_llm.model            #=> "claude-sonnet-4"
+RobotLab.config.ruby_llm.model            #=> "claude-sonnet-4-6"
 RobotLab.config.ruby_llm.request_timeout  #=> 120
 ```
 
@@ -126,7 +124,7 @@ Or create a project config file at `./config/robot_lab.yml`:
 
 ```yaml
 ruby_llm:
-  model: claude-sonnet-4
+  model: claude-sonnet-4-6
   anthropic_api_key: sk-ant-...
   request_timeout: 180
 ```
@@ -202,7 +200,7 @@ mcp:
       type: stdio
       command: npx
       args: ["-y", "@modelcontextprotocol/server-github"]
-model: claude-sonnet-4
+model: claude-sonnet-4-6
 ---
 You are a GitHub assistant. Use available tools to help with repository tasks.
 ```
@@ -265,7 +263,7 @@ robot = RobotLab.build(
 ```ruby
 # Create a shared config
 shared = RobotLab::RunConfig.new(
-  model: "claude-sonnet-4",
+  model: "claude-sonnet-4-6",
   temperature: 0.7,
   max_tokens: 2000
 )
@@ -302,16 +300,16 @@ RunConfig supports keyword construction, block DSL, and merge semantics:
 ```ruby
 # Block DSL
 config = RobotLab::RunConfig.new do |c|
-  c.model "claude-sonnet-4"
+  c.model "claude-sonnet-4-6"
   c.temperature 0.7
 end
 
 # Merge (more-specific wins)
-network_config = RobotLab::RunConfig.new(model: "claude-sonnet-4", temperature: 0.5)
+network_config = RobotLab::RunConfig.new(model: "claude-sonnet-4-6", temperature: 0.5)
 robot_config   = RobotLab::RunConfig.new(temperature: 0.9)
 effective      = network_config.merge(robot_config)
 effective.temperature  #=> 0.9
-effective.model        #=> "claude-sonnet-4"
+effective.model        #=> "claude-sonnet-4-6"
 ```
 
 ### Chaining Configuration
@@ -323,7 +321,7 @@ robot = RobotLab.build(name: "writer", system_prompt: "You are a creative writer
 
 result = robot
   .with_temperature(0.9)
-  .with_model("claude-sonnet-4")
+  .with_model("claude-sonnet-4-6")
   .run("Write a haiku about Ruby programming")
 ```
 

data/Rakefile

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rake/testtask"
+# Quality gates (quality, rubocop_check, flog_check, flay_check,
+# archspec_check, ...), doc *serving*, and the gem lifecycle (build, install,
+# release) live in asgard — see .loki and the shared dev/*.loki files it
+# imports. This Rakefile keeps the tasks asgard delegates to (tests,
+# integration, examples, docs:build).
 
-RUBOCOP_ENV = { "RUBOCOP_CACHE_ROOT" => "tmp/rubocop_cache" }.freeze
+require "rake/testtask"
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
@@ -36,100 +39,6 @@ Rake::TestTask.new(:integration) do |t|
   t.ruby_opts << "-rtest_helper"
 end
 
-desc "Check code complexity with Flog (warn ≥20, fail ≥50)"
-task :flog_check do
-  require 'flog'
-
-  # Target to work toward; methods above this are warned but don't fail the gate.
-  METHOD_WARN = 20.0
-  # Current baseline floor — established from first run. Reduce incrementally.
-  METHOD_FAIL = 50.0
-
-  flogger = Flog.new(all: true)
-  flogger.flog(*Dir.glob('lib/**/*.rb'))
-
-  warnings  = []
-  failures  = []
-
-  flogger.each_by_score do |method, score|
-    next if method.end_with?('#none')  # skip file-level non-method code
-    if score > METHOD_FAIL
-      failures  << "#{'%.1f' % score}: #{method}"
-    elsif score > METHOD_WARN
-      warnings  << "#{'%.1f' % score}: #{method}"
-    end
-  end
-
-  unless warnings.empty?
-    puts "\nFlog warnings (#{METHOD_WARN}–#{METHOD_FAIL}) — target for future refactoring:"
-    warnings.each { |v| puts "  #{v}" }
-  end
-
-  if failures.empty?
-    puts "\nFlog: no methods exceed the failure threshold (≥#{METHOD_FAIL})"
-  else
-    puts "\nFlog failures (≥#{METHOD_FAIL}) — must be refactored:"
-    failures.each { |v| puts "  #{v}" }
-    abort "\nFlog quality gate failed: #{failures.size} method(s) exceed #{METHOD_FAIL}"
-  end
-end
-
-desc "Check for structural code duplication with Flay (mass >= 50)"
-task :flay_check do
-  require 'flay'
-
-  mass_threshold = 50
-
-  flay = Flay.new({ mass: mass_threshold, diff: false, verbose: false, summary: false, timeout: 60 })
-  flay.process(*Dir.glob('lib/**/*.rb'))
-  flay.analyze
-
-  if flay.hashes.empty?
-    puts "\nFlay: no structural duplication detected (mass >= #{mass_threshold})"
-  else
-    puts "\nFlay found structural duplication (mass >= #{mass_threshold}):"
-    flay.report
-    abort "\nFlay quality gate failed: #{flay.hashes.length} pattern(s) detected"
-  end
-end
-
-desc "Run all quality checks: tests (with coverage), RuboCop, Flog, and Flay"
-task :quality do
-  results = {}
-
-  puts "\n#{'=' * 60}"
-  puts "Quality Gate: Tests + Coverage"
-  puts '=' * 60
-  results[:tests] = system("bundle exec rake test") ? :pass : :fail
-
-  puts "\n#{'=' * 60}"
-  puts "Quality Gate: RuboCop"
-  puts '=' * 60
-  results[:rubocop] = system(RUBOCOP_ENV, "bundle exec rubocop") ? :pass : :fail
-
-  puts "\n#{'=' * 60}"
-  puts "Quality Gate: Flog Complexity"
-  puts '=' * 60
-  results[:flog] = system("bundle exec rake flog_check") ? :pass : :fail
-
-  puts "\n#{'=' * 60}"
-  puts "Quality Gate: Flay Duplication"
-  puts '=' * 60
-  results[:flay] = system("bundle exec rake flay_check") ? :pass : :fail
-
-  puts "\n#{'=' * 60}"
-  puts "Quality Summary"
-  puts '=' * 60
-  results.each do |gate, status|
-    icon = status == :pass ? 'PASS' : 'FAIL'
-    puts "  [#{icon}] #{gate}"
-  end
-  puts '=' * 60
-
-  abort "\nQuality gate failed" if results.values.any?(:fail)
-  puts "\nAll quality gates passed."
-end
-
 namespace :examples do
   # Map of subdirectory-based demos to their entry point scripts
   SUBDIR_ENTRY_POINTS = {
@@ -277,22 +186,8 @@ namespace :docs do
     sh "yard doc"
   end
 
-  namespace :yard do
-    desc "Serve YARD documentation locally"
-    task :serve do
-      sh "yard server --reload"
-    end
-  end
-
   desc "Build MkDocs documentation"
   task :mkdocs do
     sh "mkdocs build"
   end
-
-  namespace :mkdocs do
-    desc "Serve MkDocs documentation locally"
-    task :serve do
-      sh "mkdocs serve"
-    end
-  end
 end

data/_typos.toml

@@ -0,0 +1,21 @@
+# False-positive suppressions for the typos quality gate (asgard).
+# Everything here was reviewed by hand — see git history for context.
+
+[files]
+extend-exclude = [
+  # Example transcripts / articles: prose quotes real names ("Damon Clark")
+  # and SQL-ish plurals ("SELECTs") that typos mis-parses.
+  "examples/ruboruby.md",
+  "examples/25_history_search/conversation.jsonl",
+]
+
+[default.extend-identifiers]
+# Robot names in lib/robot_lab/names.rb
+BATs     = "BATs"
+Damon    = "Damon"
+Mata_Nui = "Mata_Nui"
+Pris     = "Pris"
+S1MONE   = "S1MONE"
+# Test-local variable names
+ba  = "ba"   # b→a similarity (convergence_test.rb)
+thr = "thr"  # thread handle (connection_poller_test.rb)

data/docs/api/index.md

@@ -41,8 +41,8 @@ confines them:
 | [AgentSkill](skills.md#robotlabagentskill) | One skill bundle: instructions + `scripts/` |
 | [AgentSkillCatalog](skills.md#robotlabagentskillcatalog) | Lazy registry over `~/.prompts/skills/` |
 | [Capabilities](skills.md#robotlabcapabilities) | Declared vs. ceiling filesystem / network / timeout grant |
-| [ScriptTool](skills.md#robotlabscripttool) | Wraps an executable script as a `Tool` |
-| [Sandbox](skills.md#robotlabsandbox) | macOS Seatbelt confinement, or a passthrough |
+| [ScriptTool](skills.md#robotlabscripttool) | Wraps an executable script as a `Tool`; `ScriptTool.executor` is the confinement extension point |
+| [Sandbox](skills.md#confinement-robot_lab-sandbox) | macOS Seatbelt confinement, or a passthrough — ships in the optional `robot_lab-sandbox` gem |
 
 ## Support Classes