robot_lab-cyborg 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5289e0bf089059f451300a62b776b06141d684bb60ed6df407624313a695500
-  data.tar.gz: eab4d957cbd19ca2fb66e97d2ba2ddd806167c0dab6ffb623fad10204386cdd4
+  metadata.gz: 19b6539c5fe90feaed90c3e1d06f0124f6f6c29d053d67f4bb04e217d04420d1
+  data.tar.gz: b6d43f26ccd0d8b8a210f17c5236caaf60b136c1a192d24c8338f5c769e74761
 SHA512:
-  metadata.gz: f6a29be1c412e3005a55e25bfaacfbb60d6a535a636e9692f188da47ee09da8736268561570beba5d2164066dca8abbbac68f8f538a8171be2815697e8929d41
-  data.tar.gz: 01b49e8eed2356da4eafb1bf7e48dc408a84e877bcd52aae5e5a75a80927dab83a8d4daf73ad875199cf44ef5e5bcf33b8d9b0aa2379d7e8d9b52433ba7bf17c
+  metadata.gz: 3be112aedc248e8c29b68926013e69cc3841512a3ecd43bc22a132a4cdd8d84a8a1a593f702c052c6ff26978a97d64b5626406e11b46677422768cfb708dabe2
+  data.tar.gz: 941f2990dcaa5ca1df929448b937fb545f543cbd0879cfe8b019c3fac2154490dd14e2deaa540db907eea4f8d77623aae1b2dda2931c317915165282396c70f0

data/.envrc

@@ -1 +1,7 @@
+# robot_lab_project/robot_lab-cyborg/.envrc
+
+source_up
+
 export RR=$(pwd)
+
+export BUNDLE_GEMFILE=Gemfile

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/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/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.2.8"
   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.2.8
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -45,6 +45,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- _typos.toml
 - docs/api_reference.md
 - docs/custom_channels.md
 - docs/getting_started.md
@@ -84,7 +85,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Cyborg extension for the RobotLab multi-robot LLM orchestration framework.
 test_files: []