robot_lab-a2a 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b79d098ef9b24711b48d41af7140e3bf331594f427b5518814e4ff58cde38a2d
-  data.tar.gz: e38b9117d0b2d2dae5f3483ff7dd826ef25e0f7525738cf30941aead87214f77
+  metadata.gz: 06fea066d630fe600e2f5e4aeebb95ef5d36ce1003a7808cf5a2bb6d2abbe52a
+  data.tar.gz: a1825a21bb7ad7fda768df531f376cb877a7b668429ef97a164e168b6cabb599
 SHA512:
-  metadata.gz: 13b98611d8ef81ce10a0bddb1010a932e4b52a032546beb44eb3791d94f82d02fb3691a40c42222e3931824278cf31511fa9ec2fa864243dcbacdcf7779a2895
-  data.tar.gz: a284690e28a7967c3784bbeebee40fd4019ca9c0c1f712d48f6cf5c0e42b33cc41881ddb866e9f7f7ad77b399d52b35da2ee92d2e55d3bc059de77b20714e473
+  metadata.gz: 0c387fb5ab2a628f94327ca5d86b96d1f16413c9aa4d76dfd22ed587a467c2ce9af25f530858ab51de6c1a62b83854f800cd7901a7a8c6d5d87b3d186a2ce469
+  data.tar.gz: a8a70420bdb2702311677af2b7ff7e231d6d97013e15d94129b9e48b57038664864cc7c95ed0cfe4b2ba082dfdf640edb37dbf6d7d17ff82ebf6dcdb08f4a06f

data/.rubocop.yml

@@ -1,29 +1,173 @@
 AllCops:
   NewCops: enable
   SuggestExtensions: false
+  TargetRubyVersion: 4.0
   Exclude:
     - 'examples/**/*'
+    - 'vendor/**/*'
+    - 'dead_code/**/*'
+
+# ── Style: disabled cops ───────────────────────────────────────────────────
+Style/StringLiterals:
+  Enabled: false
+
+Style/StringLiteralsInInterpolation:
+  Enabled: false
 
 Style/Documentation:
   Enabled: false
 
+# Ruby 4.0 freezes string literals by default
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/RescueModifier:
+  Enabled: false
+
+Style/TrivialAccessors:
+  Enabled: false
+
+Style/MultilineTernaryOperator:
+  Enabled: false
+
+Style/SafeNavigation:
+  Enabled: false
+
+Style/EmptyClassDefinition:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/RescueStandardError:
+  Enabled: false
+
+Style/OneClassPerFile:
+  Enabled: false
+
+# Both % and format/sprintf are acceptable
+Style/FormatString:
+  Enabled: false
+
+# String concatenation and interpolation are both acceptable
+Style/StringConcatenation:
+  Enabled: false
+
+# ── Layout ─────────────────────────────────────────────────────────────────
+Layout/LineLength:
+  Max: 140
+
 Layout/ExtraSpacing:
   Enabled: false
 
+Layout/HashAlignment:
+  Enabled: false
+
+Layout/FirstHashElementIndentation:
+  Enabled: false
+
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false
+
+# ── Naming ─────────────────────────────────────────────────────────────────
+# Single-char params (c, e, n) are acceptable throughout
+Naming/MethodParameterName:
+  Enabled: false
+
+Naming/VariableNumber:
+  Exclude:
+    - 'test/**/*'
+
+Naming/RescuedExceptionsVariableName:
+  Enabled: false
+
+# set_results and similar explicit setters are clear and conventional
+Naming/AccessorMethodName:
+  Enabled: false
+
+
+# has_tool_calls? and similar are clear and conventional
+Naming/PredicatePrefix:
+  Enabled: false
+
+# Test helper methods don't need to follow predicate naming rules
+Naming/PredicateMethod:
+  Exclude:
+    - 'test/**/*'
+
+# ── Lint: relax noisy cops on intentional patterns ─────────────────────────
+# Library and framework methods commonly accept args for API/documentation purposes
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+
+Lint/EmptyBlock:
+  Exclude:
+    - 'test/**/*'
+
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'Rakefile'
+    - 'test/**/*'
+
+# ── Gemspec ────────────────────────────────────────────────────────────────
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: Gemfile
+
+Gemspec/RequiredRubyVersion:
+  Enabled: false
+
+Gemspec/OrderedDependencies:
+  Enabled: false
+
+# ── Metrics ────────────────────────────────────────────────────────────────
+# Framework-level code (routers, parsers, orchestrators) is inherently complex.
+# Flog is the primary complexity gate — these RuboCop thresholds catch only
+# egregious outliers without false-positiving every dispatch method.
+
 Metrics/MethodLength:
-  Max: 25
+  Max: 35
   CountAsOne:
     - heredoc
     - array
     - hash
+  Exclude:
+    - 'test/**/*'
 
 Metrics/AbcSize:
-  Max: 25
+  Max: 40
+  Exclude:
+    - 'test/**/*'
 
 Metrics/ClassLength:
-  Max: 150
+  Max: 600
+  Exclude:
+    - 'test/**/*'
+
+Metrics/ModuleLength:
+  Max: 200
+  Exclude:
+    - 'test/**/*'
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+  Exclude:
+    - 'test/**/*'
+
+Metrics/PerceivedComplexity:
+  Max: 20
+  Exclude:
+    - 'test/**/*'
+
+# Long method signatures with keyword args are a Ruby framework idiom
+Metrics/ParameterLists:
+  Enabled: false
 
 Metrics/BlockLength:
   Exclude:
     - 'Rakefile'
     - '*.gemspec'
+    - 'test/**/*'

data/CHANGELOG.md

@@ -1,5 +1,7 @@
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-19
+
 ### Added
 
 - Demo examples infrastructure: `examples/run` lifecycle script, shared `examples/common_config.rb`, and three complete demos:
@@ -13,6 +15,7 @@
 ### Changed
 
 - Interactive mode `:acp_tool` renamed to `:a2a_tool` across all source, tests, and documentation
+- Version synchronized with robot_lab core 0.2.1
 
 ### Fixed
 

data/CLAUDE.md

@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Gem Does
+
+`robot_lab-a2a` is an Agent2Agent (A2A) protocol adapter that exposes RobotLab robots and networks as A2A agents over HTTP+SSE. It bridges RobotLab's terminal-based `AskUser` tool to A2A's `input_required`/resume lifecycle, enabling multi-turn conversational flows without terminal dependency. It delegates HTTP serving to the `simple_a2a` gem.
+
+## Commands
+
+```bash
+rake test              # Run full test suite (default rake task)
+rake build             # Build the gem package
+rake install           # Install gem locally
+
+bin/setup              # Install dependencies
+bin/console            # IRB session with gem loaded
+
+# Run a single test file
+ruby -Ilib -Itest test/robot_lab/test_a2a.rb
+
+# Run a single test by name
+ruby -Ilib -Itest test/robot_lab/test_a2a.rb -n test_registry_stores_and_retrieves
+```
+
+## Architecture
+
+All source lives under `lib/robot_lab/a2a/`. The gem uses an adapter pattern — the two adapters both implement the `A2A::Server::AgentExecutor` interface with a single `call(context)` method.
+
+### Key Abstractions
+
+**Registry** (`registry.rb`) — Thread-safe singleton tracking active robot sessions across HTTP requests. Entries are `Data.define(:thread, :event_queue, :answer_queue)` stored by session ID. Required because A2A `tasks/send` resumes an in-flight robot thread.
+
+**RobotAdapter** (`robot_adapter.rb`) — Wraps a `RobotLab::Robot` as an executor. Supports three interactive modes:
+- `:none` — Synchronous, robot runs to completion with no input prompts.
+- `:acp_tool` — Injects `AskUserTool` into the robot's `@local_tools`, converting terminal blocking to Queue signaling. Restores original tools on teardown.
+- `:io_bridge` — Replaces the robot's I/O streams with an `IoBridge` instance; works with robots that use `puts`/`gets` directly.
+
+**AskUserTool** (`ask_user_tool.rb`) — Drop-in replacement for `RobotLab::AskUser`. On `call`, pushes `{type: :ask, prompt:}` to the event_queue then blocks on answer_queue until the A2A client sends a resume.
+
+**IoBridge** (`io_bridge.rb`) — IO-compatible object. Buffers all writes; on `gets`, flushes the buffer as the prompt event and blocks on answer_queue. Enables interactive mode for robots that don't use the AskUser tool directly.
+
+**NetworkAdapter** (`network_adapter.rb`) — Wraps a `RobotLab::Network`. Currently supports only `:none` mode; interactive mode per network node is not yet implemented.
+
+**Server** (`server.rb`) — Fluent builder. `add_robot` / `add_network` register adapters keyed by DNS-safe path labels (underscores→hyphens, RFC 1123). `run(port:)` starts the HTTP server; `to_app` returns a Rack app for embedding in Rails/Puma.
+
+### Thread Safety
+
+Interactive modes run each robot on its own Ruby Thread. `Registry` uses a `Mutex`. `AskUserTool` and `IoBridge` use Ruby's `Queue` for producer/consumer coordination between the robot thread and the HTTP request handler.
+
+### Extension Registration
+
+The gem hooks into RobotLab's extension system at require time (`a2a.rb`) and registers itself as the `:a2a` extension.
+
+## Tests
+
+Tests live in `test/robot_lab/test_a2a.rb` using Minitest with autorun. The test helper is `test/test_helper.rb`. There is no `.rspec` or RuboCop config — no linter is configured.

data/Rakefile

@@ -6,7 +6,7 @@ require 'rake/testtask'
 Rake::TestTask.new(:test) do |t|
   t.libs << 'test'
   t.libs << 'lib'
-  t.test_files = FileList['test/**/*_test.rb']
+  t.test_files = FileList['test/**/*_test.rb', 'test/**/test_*.rb'].exclude('**/*_helper.rb')
   t.verbose = true
   t.ruby_opts << '-rtest_helper'
 end
@@ -102,3 +102,15 @@ task :quality do
   abort "\nQuality gate failed" if results.values.any?(:fail)
   puts "\nAll quality gates passed."
 end
+
+namespace :docs do
+  desc 'Build MkDocs documentation'
+  task :build do
+    sh 'mkdocs build'
+  end
+
+  desc 'Serve MkDocs documentation locally on http://localhost:8000'
+  task :serve do
+    sh 'mkdocs serve'
+  end
+end

data/lib/robot_lab/a2a/version.rb

@@ -2,6 +2,6 @@
 
 module RobotLab
   module A2A
-    VERSION = '0.1.1'
+    VERSION = '0.2.1'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: robot_lab-a2a
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -27,16 +27,16 @@ dependencies:
   name: robot_lab
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: simple_a2a
   requirement: !ruby/object:Gem::Requirement
@@ -65,6 +65,7 @@ files:
 - ".github/workflows/deploy-github-pages.yml"
 - ".rubocop.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - COMMITS.md
 - LICENSE.txt
 - README.md