robot_lab-cyborg 0.2.7 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5289e0bf089059f451300a62b776b06141d684bb60ed6df407624313a695500
-  data.tar.gz: eab4d957cbd19ca2fb66e97d2ba2ddd806167c0dab6ffb623fad10204386cdd4
+  metadata.gz: dfbcf7adcfb8b32603238e8a5eb110c99398669178dda48509e8311effac3f57
+  data.tar.gz: f61c2ed79996d438c3e19169a39f93fb182d6c375ee817687c0d8279fc057c32
 SHA512:
-  metadata.gz: f6a29be1c412e3005a55e25bfaacfbb60d6a535a636e9692f188da47ee09da8736268561570beba5d2164066dca8abbbac68f8f538a8171be2815697e8929d41
-  data.tar.gz: 01b49e8eed2356da4eafb1bf7e48dc408a84e877bcd52aae5e5a75a80927dab83a8d4daf73ad875199cf44ef5e5bcf33b8d9b0aa2379d7e8d9b52433ba7bf17c
+  metadata.gz: '0825678ce77712d0ed11e87b892fdb820a4a71d3d4b32829135de88d017facde8a0387d600d30e21576c2696c0cae4708bf7a58ec3430c5b926b295147edcdf4'
+  data.tar.gz: d4448896b249569e150f7af9fc33c57820b34ac36a77db363547e6c97bf18d0904d3e4d4d79e72dda7e08fb2bbc176bff30e67aff7fc381171a0641280fc6739

data/.envrc

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

data/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.8] - 2026-09-09
+
+Released in lockstep with `robot_lab` core v0.2.8: this gem now resolves the released core gem from RubyGems instead of the local sibling checkout (local-path development remains available via `BUNDLE_GEMFILE=Gemfile.local`). Also in this release: 17 reek false positives annotated inline, reek added to the development bundle, gem lifecycle tasks moved to asgard, and the release `Gemfile` no longer overrides `robot_lab` with the local checkout.
+
 ### Fixed (from the design/architecture review)
 - **Consumer no longer wedges on a handler error.** An exception in an
   `on_initiative`/channel path used to kill the Interviewer's consumer thread and

data/README.md

@@ -112,8 +112,8 @@ A human step currently holds a thread while it waits. `ask_async` returns the pe
 Runnable demos in [`examples/`](examples) — one feature area each:
 
 - `01_human_in_the_network.rb` — a human as a pipeline step, peers messaging over a bus, shared memory (network → human). Key-free.
-- `02_terminal_mentions.rb` — a **live** human addresses peers by `@mention` via the library `Conversation` (fan-out, and no-mention broadcast); replies return on their own through the duplex. Includes a real **LLM robot** (`@assistant`, Ollama) cooperating via `serve`, plus key-free canned peers.
-- `03_robot_interviews_cyborg.rb` — the Interviewer the *other* way round: an **LLM robot** (Ollama) interviews the human via `delegate`, starting with a **typed** intake (`ask_confirm`/`ask_int`, which re-ask on bad input), then builds a categorized profile.
+- `02_terminal_mentions.rb` — a **live** human addresses peers by `@mention` via the library `Conversation` (fan-out, and no-mention broadcast); replies return on their own through the duplex. Includes a real **LLM robot** (`@assistant`, LM Studio via the :lms provider) cooperating via `serve`, plus key-free canned peers.
+- `03_robot_interviews_cyborg.rb` — the Interviewer the *other* way round: an **LLM robot** (LM Studio via the :lms provider) interviews the human via `delegate`, starting with a **typed** intake (`ask_confirm`/`ask_int`, which re-ask on bad input), then builds a categorized profile.
 - `04_presence_and_availability.rb` — routing to a peer who's actually there: `online`/`away`/`offline`, an offline human declining immediately, and a bounded-timeout escalation. Key-free.
 - `05_listening_and_duplex.rb` — always-on `listen`: the human speaks to the network **unprompted** and replies come back on the channel — both directions handled by the library. Key-free.
 
@@ -122,9 +122,9 @@ ruby examples/01_human_in_the_network.rb
 ruby examples/04_presence_and_availability.rb
 ruby examples/05_listening_and_duplex.rb
 
-# Examples 2 and 3 use a real robot on Ollama (ollama pull qwen3.6; override with
-# OLLAMA_MODEL / OLLAMA_API_BASE). In example 2 the canned peers still work
-# without it — only @assistant needs Ollama.
+# Examples 2 and 3 use a real robot on LM Studio (lms server start &&
+# lms get openai/gpt-oss-20b; override with LMS_MODEL / LMS_API_BASE). In
+# example 2 the canned peers still work without it — only @assistant needs it.
 ruby examples/02_terminal_mentions.rb        # then type: @analyst and @scribe: status?
 ruby examples/03_robot_interviews_cyborg.rb  # the robot asks you the questions
 ```

data/Rakefile

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'bundler/gem_tasks'
 require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|

data/_typos.toml

@@ -0,0 +1,7 @@
+# False-positive suppressions for the typos quality gate (asgard).
+# Everything here was reviewed by hand — see git history for context.
+
+[default.extend-identifiers]
+# Docs and comments hyphenate "mis-attributed"/"mis-attribution"; typos
+# tokenizes the prefix alone and flags it.
+mis = "mis"

data/examples/02_terminal_mentions.rb

@@ -13,10 +13,10 @@
 # delivers inbound bus traffic to its channel (the output half of the duplex),
 # so this demo never has to poll or render replies.
 #
-# @assistant is a real LLM robot (Ollama) that cooperates via #serve — the
-# one-call symmetric responder. @analyst and @scribe are key-free canned peers.
-# Set OLLAMA_API_BASE/OLLAMA_MODEL, or run without Ollama and just use the canned
-# peers (@assistant will simply not answer).
+# @assistant is a real LLM robot (LM Studio via :lms) that cooperates via
+# #serve — the one-call symmetric responder. @analyst and @scribe are key-free
+# canned peers. Set LMS_API_BASE/LMS_MODEL, or run without LM Studio and just
+# use the canned peers (@assistant will simply not answer).
 #
 #   ruby examples/02_terminal_mentions.rb
 #   # then type:  @analyst and @scribe: status?
@@ -31,13 +31,14 @@ core_lib = File.expand_path("../../robot_lab/lib", __dir__)
 $LOAD_PATH.unshift(core_lib) if File.directory?(core_lib)
 
 require "robot_lab"
+require "ruby_llm/providers/lms"
 require_relative "../lib/robot_lab/cyborg"
 
 Cyborg   = RobotLab::Cyborg
 Channel  = RobotLab::Cyborg::Channel
 
 RubyLLM.configure do |c|
-  c.ollama_api_base = ENV.fetch("OLLAMA_API_BASE", "http://localhost:11434/v1")
+  c.lms_api_base = ENV.fetch("LMS_API_BASE", "http://localhost:1234/v1")
   c.logger          = Logger.new(File::NULL)
 end
 RobotLab.configure { |c| c.logger = Logger.new(File::NULL) }
@@ -69,8 +70,8 @@ you = Cyborg.new(name: "you", bus: bus, channel: Channel::Terminal.new(name: "ne
 
 # A real LLM robot that serves bus tasks — the symmetric counterpart to how the
 # Cyborg answers its human. One call, no hand-wired on_message.
-RobotLab.build(name: "assistant", bus: bus, provider: "ollama",
-               model: ENV.fetch("OLLAMA_MODEL", "qwen3.6"),
+RobotLab.build(name: "assistant", bus: bus, provider: "lms",
+               model: ENV.fetch("LMS_MODEL", "openai/gpt-oss-20b"),
                system_prompt: "You are a concise teammate. Answer in 1-2 sentences.").serve
 
 # Two key-free canned peers.

data/examples/03_robot_interviews_cyborg.rb

@@ -14,8 +14,9 @@
 # You can answer each question, type "skip" to pass on one, or "done" to end the
 # interview early. The robot builds the profile from whatever you chose to share.
 #
-# Requires a running Ollama with the model pulled:  ollama pull qwen3.6
-# Override with OLLAMA_MODEL / OLLAMA_API_BASE if yours differ.
+# Requires a running LM Studio server with the model downloaded:
+#   lms server start && lms get openai/gpt-oss-20b
+# Override with LMS_MODEL / LMS_API_BASE if yours differ.
 #
 #   ruby examples/03_robot_interviews_cyborg.rb
 
@@ -25,20 +26,21 @@ core_lib = File.expand_path("../../robot_lab/lib", __dir__)
 $LOAD_PATH.unshift(core_lib) if File.directory?(core_lib)
 
 require "robot_lab"
+require "ruby_llm/providers/lms"
 require_relative "../lib/robot_lab/cyborg"
 
 Cyborg  = RobotLab::Cyborg
 Channel = RobotLab::Cyborg::Channel
 
-OLLAMA_API_BASE = ENV.fetch("OLLAMA_API_BASE", "http://localhost:11434/v1")
-OLLAMA_MODEL    = ENV.fetch("OLLAMA_MODEL", "qwen3.6")
+LMS_API_BASE = ENV.fetch("LMS_API_BASE", "http://localhost:1234/v1")
+LMS_MODEL    = ENV.fetch("LMS_MODEL", "openai/gpt-oss-20b")
 MAX_QUESTIONS   = Integer(ENV.fetch("MAX_QUESTIONS", "5"))
 
 ENDING_WORDS   = %w[done stop quit exit].freeze
 SKIPPING_WORDS = %w[skip pass].freeze
 
 RubyLLM.configure do |c|
-  c.ollama_api_base = OLLAMA_API_BASE
+  c.lms_api_base = LMS_API_BASE
   c.logger          = Logger.new(File::NULL)
 end
 RobotLab.configure { |c| c.logger = Logger.new(File::NULL) }
@@ -48,8 +50,8 @@ RobotLab.configure { |c| c.logger = Logger.new(File::NULL) }
 # single Interviewer ask.
 robot = RobotLab.build(
   name: "ProfileBot",
-  provider: "ollama",
-  model: OLLAMA_MODEL,
+  provider: "lms",
+  model: LMS_MODEL,
   system_prompt: <<~PROMPT
     You are ProfileBot, a warm, concise interviewer. Your goal is to learn as much
     as the person is willing to share so you can later classify them across these

data/lib/robot_lab/cyborg/channel.rb

@@ -19,6 +19,8 @@ module RobotLab
     # @!attribute kind         [Symbol] :question | :answer | :message | :notice
     # @!attribute at           [Time] when the message was created
     ChannelMessage = Data.define(:id, :content, :in_reply_to, :sender, :kind, :at) do
+      # :reek:ControlParameter -- nil at means "stamp with Time.now"; a default,
+      # not a behavior switch.
       def initialize(content:, id: nil, in_reply_to: nil, sender: nil, kind: :message, at: nil)
         super(id:, content: content.to_s, in_reply_to:, sender:, kind:, at: at || Time.now)
       end

data/lib/robot_lab/cyborg/conversation.rb

@@ -62,6 +62,8 @@ module RobotLab
       #
       # @param line [String]
       # @return [Array<String>] the peers the message was sent to
+      # :reek:FeatureEnvy -- parsing the human's raw line (strip/scan for
+      # mentions) is this router's whole job; the String has no better home.
       def route(line)
         line = line.to_s.strip
         return [] if line.empty?

data/lib/robot_lab/cyborg/interviewer.rb

@@ -155,6 +155,8 @@ module RobotLab
       end
 
       # If +id+ was the active question, clear it and deliver the next queued one.
+      # :reek:ControlParameter -- id is correlation data compared against
+      # @active_id to decide whether this question held the wire; not a mode flag.
       def release_active(id)
         advanced = @mutex.synchronize do
           next false unless @active_id == id

data/lib/robot_lab/cyborg/version.rb

@@ -4,6 +4,6 @@ module RobotLab
   # RobotLab::Cyborg is a class (a human peer worker), so its VERSION and the
   # nested helper classes hang off the class itself rather than a module.
   class Cyborg
-    VERSION = "0.2.7"
+    VERSION = "0.3.0"
   end
 end

data/lib/robot_lab/cyborg.rb

@@ -36,6 +36,11 @@ module RobotLab
   #   analyst.send_message(to: :dewayne, content: "Approve deploy? (yes/no)")
   #   # dewayne's human is prompted; the answer is sent back as a reply
   #
+  # :reek:TooManyInstanceVariables :reek:TooManyMethods -- a Cyborg is a full
+  # network peer: it must carry the ivars the BusMessaging mixin expects plus
+  # its own channel/interviewer/presence state, and mirror Robot's member
+  # surface (run/call/delegate/remember/recall) so humans and robots are
+  # interchangeable.
   class Cyborg
     include RobotLab::Robot::BusMessaging
 
@@ -72,6 +77,10 @@ module RobotLab
     # @param memory [RobotLab::Memory, nil] standalone memory (default: fresh)
     # @param ask_timeout [Numeric, nil] seconds to wait for the human before
     #   giving up on an answer (nil = wait indefinitely)
+    # :reek:BooleanParameter -- auto_reply is a stored config flag, read later
+    # by the bus handlers, not a mode switch inside this method.
+    # :reek:ControlParameter -- nil memory/channel/interviewer mean "build the
+    # default"; each `||` is a fallback, not a behavior switch.
     def initialize(name:, bus: nil, channel: nil, interviewer: nil,
                    auto_reply: true, memory: nil, ask_timeout: nil)
       @name = name.to_s
@@ -136,6 +145,8 @@ module RobotLab
     # @param network_memory [RobotLab::Memory, nil] shared memory when in a network
     # @param memory [RobotLab::Memory, nil] explicit memory override
     # @return [RobotResult]
+    # :reek:ControlParameter -- nil memory/network_memory fall back to this
+    # peer's own memory; defaults, not behavior switches.
     def run(message = nil, network_memory: nil, memory: nil, **_kwargs)
       active = memory || network_memory || @memory
       attach_memory(network_memory) if network_memory
@@ -159,6 +170,10 @@ module RobotLab
     #   answer is acceptable, or nil to reject and re-ask
     # @param retries [Integer] extra attempts allowed when validation rejects
     # @return [Object, nil] the human's answer (coerced when validated)
+    # :reek:LongParameterList { max_params: 6 } -- one keyword per aspect of a
+    # question (choices/default/timeout/validation/retries).
+    # :reek:TooManyStatements -- the ask/validate/re-ask retry loop, one step
+    # per line; flog gates its real complexity.
     def ask(question, choices: nil, default: nil, timeout: @ask_timeout, validate: nil, retries: 2)
       attempt = 0
       loop do
@@ -315,6 +330,9 @@ module RobotLab
     # @param task [String] the task message
     # @param async [Boolean] when true, returns a DelegationFuture immediately
     # @return [RobotResult, DelegationFuture]
+    # :reek:BooleanParameter :reek:ControlParameter :reek:TooManyStatements --
+    # mirrors Robot#delegate's API and shape exactly: async picks the
+    # future-vs-sync return, and the two branches are the whole method.
     def delegate(to:, task:, async: false, **)
       if async
         future = DelegationFuture.new(robot_name: to.name, delegated_by: @name)
@@ -353,6 +371,8 @@ module RobotLab
     # @param key [Object]
     # @param wait [Boolean, Numeric] false, true, or seconds to wait
     # @return [Object, nil]
+    # :reek:BooleanParameter -- wait is forwarded verbatim to Memory#get, whose
+    # API it belongs to.
     def recall(key, wait: false)
       current_memory.get(key, wait: wait)
     end
@@ -407,6 +427,8 @@ module RobotLab
 
     # Run the block with +memory+'s current writer set to this peer, restoring it
     # afterward. A no-op for memories that don't track a writer.
+    # :reek:FeatureEnvy -- save/set/restore of the writer on whichever memory is
+    # active for this run; the bookkeeping is the wrapper's job, not Memory's.
     def with_writer(memory)
       return yield unless memory.respond_to?(:current_writer=)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: robot_lab-cyborg
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.3.0
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -15,20 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.2.6
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.2.6
+        version: 0.3.0
 description: 'Adds a human peer worker to RobotLab networks: same bus and memory,
   receiving and issuing tasks alongside robots.'
 email:
@@ -45,6 +39,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- _typos.toml
 - docs/api_reference.md
 - docs/custom_channels.md
 - docs/getting_started.md
@@ -84,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.21
 specification_version: 4
 summary: Cyborg extension for the RobotLab multi-robot LLM orchestration framework.
 test_files: []