robot_lab-rails 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93f8a8d257c9dfe599fde397b4be1cc979df53eed8d38a3adca987e493852311
-  data.tar.gz: a41afb0b4132c1c245a10f44d3b5d9dd40ced45ad264e0a7e08c342cf9fb5711
+  metadata.gz: aea941ab401ce28705914a98694a577399c78cff4cbebb6513b6a3fba02a4525
+  data.tar.gz: aeb31e16dec1408a62bd4fb3424e2b09b7096f845084e6a7ed664ccc253cac29
 SHA512:
-  metadata.gz: d84d9c25a0379bca316619e0268c9f727228572c09048cb2717591acf145f1459c4292617f3ba836d756a9bd0f79b4922fdec43812cf3d111ab57d8dc591d945
-  data.tar.gz: e908c4bee35578e1ecd313b126ea87b7cc3719eba286cbe01ed11000fdd65dc09b41ba49fc069da64137d783d8c19076ae5dac4dd5418b8aac7b8b89c32b31ad
+  metadata.gz: e5e0201b324dc571199341a6616a22ac18fe477b0c70ac2c86a25614360f8e87074c6142646baba92e9562442c03a42155f9368a5d9bea060e508182b9c4fb5f
+  data.tar.gz: 57b6d986ba10d5c08eee1ea4f0ef97dccfde83b5bccf558cbba62dde9389a899fc532f9890a0c0a65c5fc4d1e2adb5320383e44f58f11eccc699ebc2c757455e

data/.rubocop.yml

@@ -0,0 +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: 35
+  CountAsOne:
+    - heredoc
+    - array
+    - hash
+  Exclude:
+    - 'test/**/*'
+
+Metrics/AbcSize:
+  Max: 40
+  Exclude:
+    - 'test/**/*'
+
+Metrics/ClassLength:
+  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,21 @@
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-19
+
+### Added
+- Rails Engine — autoloads `app/robots/` and `app/tools/` in the host application via Zeitwerk
+- Railtie — wires `RobotLab.config.logger` to `Rails.logger` on boot and applies Rails-specific defaults
+- `RobotLab::Job` (`RobotLab::RailsIntegration::Job`) — ActiveJob base class handling robot-class resolution, `RobotLabThread` persistence, Turbo Stream wiring, and completion/error broadcasting
+- `robot_class` DSL on `RobotLab::Job` subclasses — binds a dedicated job to a specific robot class without requiring `robot_class:` at enqueue time
+- `TurboStreamCallbacks` — streams content tokens and tool-call badges to `#robot_response` and `#robot_tools` targets in real time; graceful no-op when `turbo-rails` is absent
+- Generator `robot_lab:install` — creates initializer, migration, models (`RobotLabThread`, `RobotLabResult`), `RobotRunJob`, and `app/robots/` / `app/tools/` directories
+- Generator `robot_lab:robot NAME` — generates a robot class stub in `app/robots/`
+- Generator `robot_lab:job NAME [--queue QUEUE]` — generates a dedicated job subclass pre-bound to a robot class
+- Default retry/discard policy on `RobotLab::Job`: `retry_on StandardError` (3 attempts, 5 s wait); `discard_on ActiveJob::DeserializationError`
+
+### Changed
+- Version synchronized with robot_lab core 0.2.1
+
 ## [0.1.0] - 2026-05-07
 
 - Initial release

data/Rakefile

@@ -1,8 +1,116 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "minitest/test_task"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
-Minitest::TestTask.create
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb', 'test/**/test_*.rb'].exclude('**/*_helper.rb')
+  t.verbose = true
+  t.ruby_opts << '-rtest_helper'
+end
 
 task default: :test
+
+desc 'Run tests with verbose output'
+task :test_verbose do
+  ENV['TESTOPTS'] = '--verbose'
+  Rake::Task[:test].invoke
+end
+
+desc 'Run a single test file'
+task :test_file, [:file] do |_t, args|
+  ruby "test/#{args[:file]}"
+end
+
+desc 'Check code style with RuboCop'
+task :rubocop do
+  sh 'bundle exec rubocop'
+end
+
+desc 'Auto-correct RuboCop offenses'
+task :rubocop_fix do
+  sh 'bundle exec rubocop -a'
+end
+
+desc 'Check code complexity with Flog (warn >=20, fail >=50)'
+task :flog_check do
+  require 'flog'
+
+  method_warn = 20.0
+  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')
+
+    if score > method_fail
+      failures << "#{format('%.1f', score)}: #{method}"
+    elsif score > method_warn
+      warnings << "#{format('%.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 'Run all quality checks: tests (with coverage), RuboCop, and Flog'
+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('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 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 :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/docs/guides/rails-integration.md

@@ -35,7 +35,7 @@ rails db:migrate
 
 ## Configuration
 
-RobotLab uses [MywayConfig](https://github.com/madbomber/myway_config) for configuration. There is no `RobotLab.configure` block. Instead, settings are loaded from YAML files and environment variables in the following priority order:
+RobotLab uses [MywayConfig](https://github.com/madbomber/myway_config) for static configuration. Settings are loaded from YAML files and environment variables in the following priority order:
 
 1. **Bundled defaults** (`lib/robot_lab/config/defaults.yml`)
 2. **Environment-specific overrides** (development, test, production sections)
@@ -85,14 +85,21 @@ ROBOT_LAB_RUBY_LLM__REQUEST_TIMEOUT=180
 
 RobotLab also falls back to standard provider environment variables (e.g. `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`) when the prefixed versions are not set.
 
-### Initializer (Logger Only)
+### Initializer
 
-The only runtime-writable config attribute is the logger. The generated initializer sets it to the Rails logger:
+Use `RobotLab.configure` to set runtime attributes. The generated initializer wires the logger to `Rails.logger`:
 
 ```ruby title="config/initializers/robot_lab.rb"
 # frozen_string_literal: true
 
-# Set the RobotLab logger to use Rails.logger
+RobotLab.configure do |c|
+  c.logger = Rails.logger
+end
+```
+
+You can also assign it directly if you prefer a one-liner:
+
+```ruby
 RobotLab.config.logger = Rails.logger
 ```
 

data/lib/robot_lab/rails/version.rb

@@ -2,6 +2,6 @@
 
 module RobotLab
   module Rails
-    VERSION = "0.1.0"
+    VERSION = "0.2.1"
   end
 end

data/lib/robot_lab/rails.rb

@@ -3,8 +3,12 @@
 require_relative "rails/version"
 require_relative "rails_integration/turbo_stream_callbacks"
 
-if defined?(::Rails)
+if defined?(Rails)
   require_relative "rails_integration/engine"
   require_relative "rails_integration/railtie"
   require_relative "rails_integration/job"
 end
+
+if defined?(RobotLab) && RobotLab.respond_to?(:register_extension)
+  RobotLab.register_extension(:rails, RobotLab::Rails)
+end

data/lib/robot_lab/rails_integration/job.rb

@@ -39,9 +39,10 @@ module RobotLab
 
       def resolve_robot_class(runtime_class)
         klass = runtime_class || self.class.robot_class
-        raise ArgumentError,
-              "No robot class specified. Pass robot_class: to perform or set robot_class on the job class." \
-          unless klass
+        unless klass
+          raise ArgumentError,
+                "No robot class specified. Pass robot_class: to perform or set robot_class on the job class."
+        end
 
         return klass if klass.is_a?(Class)
 

data/lib/robot_lab/rails_integration/turbo_stream_callbacks.rb

@@ -13,7 +13,7 @@ module RobotLab
       end
 
       def self.build_content_callback(stream_name:, target: "robot_response")
-        ->(chunk) {
+        lambda { |chunk|
           content = chunk.respond_to?(:content) ? chunk.content : chunk.to_s
           return unless content && TurboStreamCallbacks.available?
 
@@ -26,7 +26,7 @@ module RobotLab
       end
 
       def self.build_tool_call_callback(stream_name:, target: "robot_tools")
-        ->(tool_call) {
+        lambda { |tool_call|
           return unless TurboStreamCallbacks.available?
 
           name = tool_call.respond_to?(:name) ? tool_call.name : tool_call.to_s

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: robot_lab-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -13,16 +13,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: railties
   requirement: !ruby/object:Gem::Requirement
@@ -75,6 +75,7 @@ extra_rdoc_files: []
 files:
 - ".envrc"
 - ".github/workflows/deploy-github-pages.yml"
+- ".rubocop.yml"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md