roast-ai 0.5.2 → 1.0.0.pre.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45106bfcf14cd8dac143f9b31331d5c272cba04152390097debb22a466edd4cd
-  data.tar.gz: 8097250f8cc80405c0002928a946a0635c430e6d631de51f62487e356ec19891
+  metadata.gz: 3a4f73f62805433be6e39c1f2e12ddec2fa11029445992b2f294bc846283fb58
+  data.tar.gz: f59f4afade96ca5d2cc71bd28f69f6f8eb8d3ab5f8f81231a83464ce3c1c9b14
 SHA512:
-  metadata.gz: 9b6a836153aeeda05efd1c30b0be46453709bb9a4bb3480aed00b136da3ecd566f4b6d8a2ad6f88e5a19ee5774dfe42621a0239b7b0a5b3c0d192f29e25efc08
-  data.tar.gz: d4591075f64cc6e4ca0e14d0ea8555026f4bd3211fb6ebfd80c03c4a92897abbd47a0269e9f40e356a3b8e420165aa231d4e8196b7827c4cac6d3955c645b24c
+  metadata.gz: 5b63320779a1ea8b7dc4fb39a770c7f1d0f25df6c70f61859c9c2f389f035e1ca3fe8f68b668cfdbc4ec1ab3d1a58024b5fc473702784a6c21ef854eff8dd6f6
+  data.tar.gz: ce9bc888dd4a7972946be41131d9ec9f80299f630cff7a74954ac12a2db4bba0e72f36c7d2e1261fd16396d143adefee4f0db21f990062f208450e9b647119c5

data/.claude/commands/docs/write-comments.md

@@ -4,7 +4,7 @@ Write documentation comments for public methods in the specified file or class.
 
 Accepts either:
 - A file path, like `lib/roast/dsl/cogs/chat/config.rb`
-- A class name, like `Roast::DSL::Cogs::Chat::Config`
+- A class name, like `Roast::Cogs::Chat::Config`
 
 ## Task
 

data/.claude/commands/write-tests.md

@@ -0,0 +1,126 @@
+Write tests for classes that do not have test coverage.
+
+## Arguments
+
+Accepts either:
+- A file path, like `lib/roast/cog_input_context.rb`
+- A class name, like `Roast::CogInputContext`
+
+## Task
+
+1. **Locate the source file:**
+   - If given a class name, find the corresponding file in `lib/`
+   - Read the source file to understand the class's behavior
+
+2. **Check for existing tests:**
+   - Search `test/` for existing test files for this class
+   - If tests exist, identify gaps in coverage
+
+3. **Study project test patterns:**
+   - Look at similar test files in `test/roast/` to understand conventions
+   - Note the test framework (ActiveSupport::TestCase) and assertion styles
+
+4. **Write the tests:**
+   - Create the test file at the appropriate location (e.g., `test/roast/<filename>_test.rb`)
+   - Test only behavior defined in the class itself, not inherited behavior
+   - Test each public method with representative cases
+   - Test edge cases (nil arguments, error conditions, etc.)
+
+5. **Run the tests:**
+   - Execute the test file to verify all tests pass
+   - Fix any failures before completing
+
+## Important Constraints
+
+- **Avoid mocking direct dependencies** - use real instances where possible
+- **Simple mocks are acceptable for second-order dependencies** (dependencies of dependencies)
+- **Do not test inherited behavior** - only test methods defined in the class itself
+- **Do not test type signatures** - Sorbet handles type checking, so don't test that methods return the correct type (e.g., `assert_instance_of String, @context.tmpdir`)
+- **Do not test class hierarchies** - Don't test inheritance relationships like "InputError is a subclass of Roast::Error". These are not useful tests.
+- **Do not test simple data classes** - Classes that only have `attr_reader`/`attr_accessor` and an initializer don't need tests unless they have complex initialization logic
+- **Follow existing test conventions** in the project
+
+## Test Helpers
+
+### `TestCogSupport` (from `test/support/test_cog.rb`)
+
+Shared test cog infrastructure. Use this when you need a generic cog for integration testing instead of defining your own. Provides:
+
+- `TestCogSupport::TestInput` - A `Cog::Input` with `value` accessor, validation, and coercion
+- `TestCogSupport::TestOutput` - A `Cog::Output` with a `value` reader
+- `TestCogSupport::TestCog` - A `Cog` subclass that executes input into output, with its own `Config` and `Input` classes
+
+Use these directly or alias them in your test class:
+
+```ruby
+class MyTest < ActiveSupport::TestCase
+  # For integration tests that need a cog registered in a Registry:
+  def setup
+    @registry = Cog::Registry.new
+    @registry.use(TestCogSupport::TestCog)
+  end
+
+  # For SystemCog subclasses that need a concrete Input:
+  class TestSystemCog < SystemCog
+    class Input < TestCogSupport::TestInput; end
+  end
+end
+```
+
+Only define a custom test cog when the class under test requires specific Config fields (e.g., `field :timeout, 30`) that `Cog::Config` doesn't provide.
+
+### `run_cog(cog, config: nil, scope_value: nil, scope_index: 0)`
+
+Run a cog through the full async execution path for integration testing. Use this when testing cog execution rather than testing individual Input/Output/Config classes in isolation.
+
+```ruby
+test "cog executes and returns expected output" do
+  cog = MyCog.new(:test_cog, ->(_input, _scope, _index) { "some value" })
+
+  run_cog(cog)
+
+  assert cog.succeeded?
+  assert_equal "expected", cog.output.value
+end
+```
+
+Parameters:
+- `cog` - The cog instance to run
+- `config:` - Optional config (defaults to cog's config class)
+- `scope_value:` - Optional executor scope value passed to input proc
+- `scope_index:` - Optional executor scope index passed to input proc
+
+## Style Rules
+
+- Do NOT use `%w[]` word arrays — use `["a", "b"]` bracket style
+- Do NOT add section comments (e.g., `# --- Config ---`) in test files
+- Use `class << self` for class method definitions, not `def self.method_name`
+- Use Ruby 1.9 hash syntax (`key:` not `:key =>`)
+
+## Test File Structure
+
+```ruby
+# frozen_string_literal: true
+
+require "test_helper"
+
+module Roast
+  class <ClassName>Test < ActiveSupport::TestCase
+    def setup
+      # Create instance and any required fixtures
+    end
+
+    def teardown
+      # Clean up temporary resources if needed
+    end
+
+    test "method_name does expected behavior" do
+      # Arrange, Act, Assert
+    end
+  end
+end
+```
+
+## Immediate Instructions
+
+Write tests for: $ARGUMENTS

data/.github/workflows/ci.yaml

@@ -14,27 +14,15 @@ env:
   CI: true
 
 jobs:
-  rubies:
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu]
-        ruby: ['3.2', '3.3', '3.4']
-        gemfile: ['activesupport7', 'activesupport8']
-    runs-on: ${{ matrix.os }}-latest
-    env:
-      BUNDLE_GEMFILE: ${{ github.workspace }}/gemfiles/${{ matrix.gemfile }}.gemfile
+  ci:
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - name: Install dependencies
         run: sudo apt-get update && sudo apt-get install -y ripgrep graphviz wamerican
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
       - run: bundle exec rake sorbet
       - run: bundle exec rake rubocop_ci
-      - run: bundle exec rake minitest_dsl_fast
-      - run: bundle exec rake minitest_dsl_slow
-      - run: bundle exec rake minitest_functional
-      - run: bundle exec rake minitest_old
+      - run: bundle exec rake test

data/.rubocop.yml

@@ -1,8 +1,5 @@
 inherit_from: .rubocop_todo.yml
 
-require:
-  - ./rubocop/cop/roast
-
 plugins:
   - rubocop-sorbet
 
@@ -33,13 +30,6 @@ Sorbet/FalseSigil:
     - "examples/**/*"
     - "lib/roast/sorbet_runtime_stub.rb"
 
-Roast/UseCmdRunner:
-  Enabled: true
-  Exclude:
-    - 'lib/roast/helpers/cmd_runner.rb'
-    - 'lib/roast/dsl/command_runner.rb'
-    - 'roast-ai.gemspec'
-
 Style/MethodCallWithArgsParentheses:
   Enabled: true
   Exclude:

data/Gemfile.lock

@@ -8,8 +8,8 @@ GIT
 PATH
   remote: .
   specs:
-    roast-ai (0.5.2)
-      activesupport (>= 7.0)
+    roast-ai (1.0.0.pre.rc1)
+      activesupport (~> 8.0)
       async (>= 2.34)
       benchmark (>= 0.4.1)
       cli-kit (>= 5.2)
@@ -71,14 +71,14 @@ GEM
     drb (2.2.3)
     erubi (1.13.1)
     event_stream_parser (1.0.0)
-    faraday (2.13.1)
+    faraday (2.14.1)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
     faraday-multipart (1.1.1)
       multipart-post (~> 2.0)
-    faraday-net_http (3.4.1)
-      net-http (>= 0.5.0)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
     faraday-retry (2.3.2)
       faraday (~> 2.0)
     ffi (1.17.2-arm64-darwin)
@@ -107,7 +107,7 @@ GEM
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     io-event (1.14.0)
-    json (2.12.2)
+    json (2.18.1)
     json-schema (5.1.1)
       addressable (~> 2.8)
       bigdecimal (~> 3.1)
@@ -128,8 +128,8 @@ GEM
       ruby2_keywords (>= 0.0.5)
     multipart-post (2.4.1)
     nenv (0.3.0)
-    net-http (0.6.0)
-      uri
+    net-http (0.9.1)
+      uri (>= 0.11.1)
     netrc (0.11.0)
     notiffany (0.1.3)
       nenv (~> 0.1)
@@ -246,7 +246,7 @@ GEM
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
-    uri (1.0.3)
+    uri (1.1.1)
     vcr (6.3.1)
       base64
     webmock (3.25.1)

data/README.md

@@ -48,7 +48,7 @@ end
 
 Run with:
 ```bash
-bin/roast execute --executor=dsl analyze_codebase.rb
+bin/roast execute analyze_codebase.rb
 ```
 
 ## Core Cogs
@@ -82,7 +82,7 @@ gem 'roast-ai'
 
 The best way to learn Roast is through the interactive tutorial:
 
-📚 **[Start the Tutorial](https://github.com/Shopify/roast/blob/main/dsl/tutorial/README.md)**
+📚 **[Start the Tutorial](https://github.com/Shopify/roast/blob/main/tutorial/README.md)**
 
 The tutorial covers:
 1. Your first workflow
@@ -97,9 +97,8 @@ The tutorial covers:
 
 ## Documentation
 
-- [Tutorial](https://github.com/Shopify/roast/blob/main/dsl/tutorial/README.md) - Step-by-step guide with examples
-- [Functional Tests](https://github.com/Shopify/roast/tree/main/dsl) - Toy workflows that demonstrate all functional patterns, use for end-to-end test
-- [API Reference](https://github.com/Shopify/roast/tree/main/sorbet/rbi/shims/lib/roast/dsl) - Complete cog documentation
+- [Tutorial](https://github.com/Shopify/roast/blob/main/tutorial/README.md) - Step-by-step guide with examples
+- [Workflow Examples](https://github.com/Shopify/roast/tree/main/examples) - Toy workflows that demonstrate all functional patterns, use for end-to-end test
 
 ## Documentation & References
 
@@ -113,8 +112,8 @@ The public interfaces of the new Roast are extensively documented in
 class and method comments on the relevant classes.
 
 * __Tutorial and Examples__
-    * [Tutorial -- Table of Contents](https://github.com/Shopify/roast/tree/main/dsl/tutorial) (contains step-by-step guides and runnable examples showing real-world usage)
-    * [Additional Example Workflows](https://github.com/Shopify/roast/tree/main/dsl) (these comprise the Roast end-to-end test suite)
+    * [Tutorial -- Table of Contents](https://github.com/Shopify/roast/tree/main/tutorial) (contains step-by-step guides and runnable examples showing real-world usage)
+    * [Additional Example Workflows]([https://github.com/Shopify/roast/tree/main/dsl](https://github.com/Shopify/roast/tree/main/examples)) (these comprise the Roast end-to-end test suite)
 * __Configuation__
     * [General configuration block: `config-context.rbi`](https://github.com/Shopify/roast/blob/main/sorbet/rbi/shims/lib/roast/dsl/config_context.rbi)
     * [Global cog configuration: `cog/config.rb`](https://github.com/Shopify/roast/blob/main/lib/roast/dsl/cog/config.rb)

data/Rakefile

@@ -6,45 +6,21 @@ require "rake/testtask"
 
 ### Test Tasks
 
-Rake::TestTask.new(:minitest_all) do |t|
+Rake::TestTask.new(:minitest_fast) do |t|
   t.libs << "test"
   t.libs << "lib"
   t.test_files = FileList["test/**/*_test.rb"]
 end
 
-Rake::TestTask.new(:minitest_functional) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/functional/**/*_test.rb"]
-end
-
-Rake::TestTask.new(:minitest_old) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"].exclude(
-    "test/functional/**/*_test.rb",
-    "test/dsl/**/*_test.rb",
-    "test/roast/dsl/**/*_test.rb",
-  )
-end
-
-Rake::TestTask.new(:minitest_dsl_fast) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/dsl/**/*_test.rb", "test/roast/dsl/**/*_test.rb"]
-end
-
-Rake::TestTask.new(:minitest_dsl_slow) do |t|
+Rake::TestTask.new(:minitest_all) do |t|
   t.libs << "test"
   t.libs << "lib"
-  t.test_files = FileList["test/dsl/**/*_test.rb", "test/roast/dsl/**/*_test.rb"]
+  t.test_files = FileList["test/**/*_test.rb"]
 end
-task :set_slow_env do
+task :set_slow_test_env do
   ENV["ROAST_RUN_SLOW_TESTS"] = "true"
 end
-task minitest_dsl_slow: :set_slow_env
-
-task test: [:minitest_dsl_fast, :minitest_dsl_slow, :minitest_functional, :minitest_old]
+task minitest_all: :set_slow_test_env
 
 ### Rubocop Tasks
 
@@ -65,6 +41,8 @@ end
 
 ### Task Groups
 
-task default: [:sorbet, :rubocop, :minitest_dsl_fast]
+task default: [:sorbet, :rubocop, :minitest_fast]
 
 task check: [:sorbet, :rubocop]
+
+task test: [:minitest_all]

data/dev.yml

@@ -11,13 +11,13 @@ up:
 check:
   style: bundle exec rake rubocop
   tc: bundle exec rake sorbet
-  test: bundle exec rake minitest_dsl_fast
+  test: bundle exec rake minitest_fast
 
 commands:
   __default__: execute
   execute:
     desc: Execute a roast workflow
-    run: bundle exec roast execute --executor=dsl
+    run: bundle exec roast execute
   style:
     desc: Run Rubocop style checks (and autocorrect)
     run: bundle exec rake rubocop:autocorrect
@@ -26,4 +26,4 @@ commands:
     run: bundle exec rake sorbet
   test:
     desc: Run all tests
-    run: bundle exec rake minitest_dsl_fast
+    run: bundle exec rake minitest_fast

data/{dsl → examples}/agent_sessions.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   agent do

data/{dsl → examples}/async_cogs.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }

data/{dsl → examples}/async_cogs_complex.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }

data/{dsl → examples}/call.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd do

data/{dsl → examples}/collect_from.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }
@@ -33,7 +33,7 @@ execute do
     begin
       # There is no :to_upper cog that this could sensibly be referring to
       cmd(:to_upper)
-    rescue Roast::DSL::CogInputManager::CogDoesNotExistError
+    rescue Roast::CogInputManager::CogDoesNotExistError
       puts "Could not access :to_upper directly"
     end
 

data/{dsl → examples}/demo/Gemfile

@@ -1,4 +1,6 @@
 # frozen_string_literal: true
 
+source "https://rubygems.org"
+
 gem "roast-ai", path: "../.."
 gem "plugin-gem-example", path: "../plugin-gem-example"

data/{dsl → examples}/demo/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: ../..
   specs:
-    roast-ai (0.5.1)
-      activesupport (>= 7.0)
+    roast-ai (1.0.0.pre.rc1)
+      activesupport (~> 8.0)
       async (>= 2.34)
       benchmark (>= 0.4.1)
       cli-kit (>= 5.2)
@@ -10,7 +10,7 @@ PATH
       diff-lcs (>= 1.5)
       json-schema (>= 5.1)
       open_router (>= 0.3)
-      raix (>= 1.0.2)
+      raix (~> 1.0.2)
       rake (>= 13.3.0)
       ruby-graphviz (>= 1.2)
       ruby_llm (>= 1.8)
@@ -25,6 +25,7 @@ PATH
       roast-ai
 
 GEM
+  remote: https://rubygems.org/
   specs:
     activesupport (8.0.3)
       base64

data/{dsl → examples}/demo/cogs/local.rb

@@ -1,8 +1,8 @@
 # typed: true
 # frozen_string_literal: true
 
-class Local < Roast::DSL::Cog
-  class Input < Roast::DSL::Cog::Input
+class Local < Roast::Cog
+  class Input < Roast::Cog::Input
     def validate!
       true
     end

data/{dsl → examples}/demo/simple_external_cog.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 use "simple", from: "plugin_gem_example"
 use "MyCogNamespace::Other", from: "plugin_gem_example"

data/{dsl → examples}/json_output.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }

data/{dsl → examples}/map.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd do

data/{dsl → examples}/map_reduce.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }

data/{dsl → examples}/map_with_index.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd do

data/{dsl → examples}/next_break.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
 end

data/{dsl → examples}/next_break_parallel.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   map { parallel! }

data/{dsl → examples}/outputs.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }

data/{dsl → examples}/outputs_bang.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }

data/{dsl → examples}/parallel_map.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
 
-#: self as Roast::DSL::Workflow
+#: self as Roast::Workflow
 
 config do
   cmd { display! }

data/{dsl → examples}/plugin-gem-example/Gemfile

@@ -5,6 +5,8 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in plugin-gem-example.gemspec
 gemspec
 
+gem "roast-ai", path: "../.."
+
 gem "irb"
 gem "rake", "~> 13.0"