roast-ai 0.5.2 → 1.0.0.pre.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45106bfcf14cd8dac143f9b31331d5c272cba04152390097debb22a466edd4cd
-  data.tar.gz: 8097250f8cc80405c0002928a946a0635c430e6d631de51f62487e356ec19891
+  metadata.gz: d4c094250ff4a6e6203bda03a81547200c3d1b4f73899f597b359873648a6b5f
+  data.tar.gz: e033a49f41382b91b8569924124a86d84e423fafad502111a72f77febab05516
 SHA512:
-  metadata.gz: 9b6a836153aeeda05efd1c30b0be46453709bb9a4bb3480aed00b136da3ecd566f4b6d8a2ad6f88e5a19ee5774dfe42621a0239b7b0a5b3c0d192f29e25efc08
-  data.tar.gz: d4591075f64cc6e4ca0e14d0ea8555026f4bd3211fb6ebfd80c03c4a92897abbd47a0269e9f40e356a3b8e420165aa231d4e8196b7827c4cac6d3955c645b24c
+  metadata.gz: bbecea0581d3f1eec9e36b7885e2d67b7a5c5591d98d59fefa3717b5373c169caf8ed7b6f2c1bed679d36cc33523910a86727c28272776d7c31370004dd69ffa
+  data.tar.gz: 907636c73cc87935c25fbcbcd207b3824aec58db6531d07d1603417e9568cf0740a475b0cc1aa95ae0fb5c1fc310a90f5c4aa703aae26527a6100e210279376b

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

@@ -7,10 +7,6 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 # Specify your gem's dependencies in roast-ai.gemspec
 gemspec
 
-# TODO: remove this version pin when the next cli-ui version is released with this circular dependency fix
-#   https://github.com/Shopify/cli-ui/pull/606
-gem "cli-ui", github: "Shopify/cli-ui", branch: "main"
-
 group :development, :test do
   gem "guard-minitest"
   gem "guard"
@@ -22,6 +18,7 @@ group :development, :test do
   gem "rubocop-sorbet", require: false
   gem "simplecov", require: false
   gem "sorbet", "~> 0.5.12414", require: false
+  gem "sqlite3", require: false
   gem "tapioca", "~> 0.16.11", require: false
   gem "vcr", require: false
   gem "webmock", require: false

data/Gemfile.lock

@@ -1,27 +1,10 @@
-GIT
-  remote: https://github.com/Shopify/cli-ui
-  revision: 6bdefd1d06305e5d6ae312ac76f9c88f88658dda
-  branch: main
-  specs:
-    cli-ui (2.7.0)
-
 PATH
   remote: .
   specs:
-    roast-ai (0.5.2)
-      activesupport (>= 7.0)
+    roast-ai (1.0.0.pre.rc2)
+      activesupport (~> 8.0)
       async (>= 2.34)
-      benchmark (>= 0.4.1)
-      cli-kit (>= 5.2)
-      cli-ui (>= 2.7)
-      diff-lcs (>= 1.5)
-      json-schema (>= 5.1)
-      open_router (>= 0.3)
-      raix (~> 1.0.2)
-      rake (>= 13.3.0)
-      ruby-graphviz (>= 1.2)
       ruby_llm (>= 1.8)
-      sqlite3 (>= 2.6)
       thor (>= 1.3)
       zeitwerk (>= 2.6)
 
@@ -53,8 +36,6 @@ GEM
     base64 (0.3.0)
     benchmark (0.4.1)
     bigdecimal (3.2.2)
-    cli-kit (5.2.0)
-      cli-ui (~> 2.4)
     coderay (1.1.3)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.3)
@@ -65,20 +46,18 @@ GEM
     crack (1.0.0)
       bigdecimal
       rexml
-    diff-lcs (1.6.2)
     docile (1.4.1)
-    dotenv (3.1.8)
     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,10 +86,7 @@ GEM
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     io-event (1.14.0)
-    json (2.12.2)
-    json-schema (5.1.1)
-      addressable (~> 2.8)
-      bigdecimal (~> 3.1)
+    json (2.18.1)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     listen (3.9.0)
@@ -128,17 +104,12 @@ 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)
       shellany (~> 0.0)
-    open_router (0.3.3)
-      activesupport (>= 6.0)
-      dotenv (>= 2)
-      faraday (>= 1)
-      faraday-multipart (>= 1)
     ostruct (0.6.2)
     parallel (1.27.0)
     parser (3.3.8.0)
@@ -151,12 +122,6 @@ GEM
     public_suffix (6.0.2)
     racc (1.8.1)
     rainbow (3.1.1)
-    raix (1.0.2)
-      activesupport (>= 6.0)
-      faraday-retry (~> 2.0)
-      open_router (~> 0.2)
-      ostruct
-      ruby-openai (~> 8.1)
     rake (13.3.0)
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
@@ -187,12 +152,6 @@ GEM
     rubocop-sorbet (0.10.5)
       lint_roller
       rubocop (>= 1.75.2)
-    ruby-graphviz (1.2.5)
-      rexml
-    ruby-openai (8.1.0)
-      event_stream_parser (>= 0.3.0, < 2.0.0)
-      faraday (>= 1)
-      faraday-multipart (>= 1)
     ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
     ruby_llm (1.8.2)
@@ -227,8 +186,8 @@ GEM
       rexml (>= 3.2.6)
       sorbet-static-and-runtime (>= 0.5.10187)
       thor (>= 0.19.2)
-    sqlite3 (2.7.0-arm64-darwin)
-    sqlite3 (2.7.0-x86_64-linux-gnu)
+    sqlite3 (2.9.0-arm64-darwin)
+    sqlite3 (2.9.0-x86_64-linux-gnu)
     tapioca (0.16.11)
       benchmark
       bundler (>= 2.2.25)
@@ -246,7 +205,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)
@@ -264,7 +223,6 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  cli-ui!
   guard
   guard-minitest
   minitest (~> 5.0)
@@ -276,6 +234,7 @@ DEPENDENCIES
   rubocop-sorbet
   simplecov
   sorbet (~> 0.5.12414)
+  sqlite3
   tapioca (~> 0.16.11)
   vcr
   webmock

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"