roast-ai 0.4.10 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef6e5b6234cde031dbec2498a1edfe20822de1afb336292ff0e55d3abada5748
-  data.tar.gz: 26992714777862482a9935b7b924f7064db3eed24d3fb25b18b21ef7b741385c
+  metadata.gz: 2ee882d792c1c09ecc9a023aa1f26825dff3442a8c4152da789078157e26540e
+  data.tar.gz: 51d5d1238e32c5ad6ce9f3d24c3d224d0709da3f3da4e10905f75049dd02f6d7
 SHA512:
-  metadata.gz: 4dc6d30fa71c300fb83ae5144e6fbd55ab7770b25534daa6dadc24c58484276d590951840d196b074038328db317adda90c885d3f6779cfadc0125348e40cf23
-  data.tar.gz: 0d35f0494140641ec3c2a643e86f4b6b174adbbf44af866d617471c405b0247f51a45f53514488a28b4dbd6b0175ff87521752ffba663ab926e51259b7398eeb
+  metadata.gz: 440bdf957c01418d111bdea73de04b707baf7034f1277ddc5c78fa09ee68833cf1f4538d0f0a5eb691ece68f9c80ad9f159949b818658e4a97ef029a6ec999a3
+  data.tar.gz: dc01a98d049b9fae42a28697bb09eacf9dc0766c734eafa6bd1bc1402d8c50109d79d5e03304a3e9914e92a718a4fbbd5cf58cbb7beeeee46a643aa167090e5a

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

@@ -0,0 +1,36 @@
+Write documentation comments for public methods in the specified file or class.
+
+## Arguments
+
+Accepts either:
+- A file path, like `lib/roast/dsl/cogs/chat/config.rb`
+- A class name, like `Roast::DSL::Cogs::Chat::Config`
+
+## Task
+
+Following the guidelines in `internal/documentation/`:
+
+1. **Determine documentation type:**
+   - For Config, Input, Output classes → Use `doc-comments-external.md` (user-facing, thorough)
+   - For cog classes, Params classes, `execute` methods, internal utilities → Use `doc-comments-internal.md` (developer-facing, concise)
+   - See `doc-comments.md` for the distinction
+
+2. Review existing documentation comments in the target file/class
+3. Write doc comments for any public methods that lack them
+4. Update existing doc comments to match current standards
+5. Cross-reference related methods (for user-facing documentation only)
+6. Replace any rough developer notes with polished documentation
+
+**Note:** User-facing documentation should be thorough with `#### See Also` sections.
+Developer-facing documentation should be concise without cross-references.
+
+## Important Constraints
+
+- Only examine and modify files in the `lib/roast/dsl/` directory
+- Only write/edit comments in the specific file or class requested
+- Ignore `field` definitions in Config classes
+- Do not modify any other files
+
+## Immediate Instructions
+
+Operate on this file/class: $ARGUMENTS

data/.github/CODEOWNERS

@@ -1,2 +1,2 @@
-* @nfgrep @dersam @obie @juniper-shopify
+* @nfgrep @dersam @juniper-shopify @mathiusj
 

data/.github/workflows/ci.yaml

@@ -3,13 +3,16 @@ name: ci
 on:
   pull_request:
     branches:
-      - main
+      - '**'
   push:
     branches:
       - main
   schedule:
     - cron:  '45 4 * * *'
 
+env:
+  CI: true
+
 jobs:
   rubies:
     strategy:
@@ -24,13 +27,14 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install dependencies
-        run: sudo apt-get update && sudo apt-get install -y ripgrep graphviz
+        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 minitest_old
-      - run: bundle exec rake minitest_functional
+      - run: bundle exec rake sorbet
       - run: bundle exec rake rubocop_ci
-      - run: bin/srb tc
-
+      - 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

data/.gitignore

@@ -22,5 +22,4 @@ bin/claude-swarm
 coverage
 
 .dev
-dev.yml
 .shadowenv

data/.rubocop.yml

@@ -20,6 +20,10 @@ AllCops:
   TargetRubyVersion: 3.4
   UseCache: true
 
+Naming/FileName:
+  Exclude:
+    - "lib/roast-ai.rb"
+
 Sorbet/FalseSigil:
   Enabled: true
   Include:
@@ -27,12 +31,14 @@ Sorbet/FalseSigil:
   Exclude:
     - "test/**/*"
     - "examples/**/*"
+    - "lib/roast/sorbet_runtime_stub.rb"
 
 Roast/UseCmdRunner:
   Enabled: true
   Exclude:
     - 'lib/roast/helpers/cmd_runner.rb'
-    - 'roast.gemspec'
+    - 'lib/roast/dsl/command_runner.rb'
+    - 'roast-ai.gemspec'
 
 Style/MethodCallWithArgsParentheses:
   Enabled: true

data/CLAUDE.md

@@ -28,7 +28,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - Documentation: Include method/class documentation with examples when appropriate
 - Dependencies: Prefer existing gems in the Gemfile before adding new ones
 - Define class methods inside `class << self; end` declarations.
-- Add runtime dependencies to `roast.gemspec`.
+- Add runtime dependencies to `roast-ai.gemspec`.
 - Add development dependencies to `Gemfile`.
 - Don't ever test private methods directly. Specs should test behavior, not implementation.
 - I do not like test-specific code embedded in production code, don't ever do that
@@ -264,4 +264,4 @@ gh project item-add {project_number} --url https://github.com/Shopify/roast/issu
 - To apply color to terminal output using CLI::UI, use the following syntax:
   ```ruby
   puts ::CLI::UI.fmt("{{red:This field is required. Please provide a value.}}")
-  ```
+  ```

data/CONTRIBUTING.md

@@ -1,5 +1,7 @@
 # How to contribute
 
+> **📢 Code Freeze Notice**: This project is currently under a limited code freeze while we work on an alternative frontend (a DSL). We are still accepting **bug fixes**, but **new features** will not be merged until the DSL is released. Thank you for your understanding!
+
 ## Things we will merge
 
 * Bugfixes

data/Gemfile

@@ -4,23 +4,24 @@ source "https://rubygems.org"
 
 git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
-# Specify your gem's dependencies in roast.gemspec
+# Specify your gem's dependencies in roast-ai.gemspec
 gemspec
 
-gem "cgi"
-gem "claude_swarm"
-gem "cli-ui", "2.3.0"
-gem "dotenv"
-gem "guard-minitest"
-gem "guard"
-gem "minitest-rg"
-gem "mocha"
-gem "rake", require: false
-gem "rubocop-shopify", require: false
-gem "rubocop-sorbet", require: false
-gem "ruby_llm"
-gem "simplecov", require: false
-gem "sorbet", require: false
-gem "tapioca", require: false
-gem "vcr", require: false
-gem "webmock", require: false
+# 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"
+  gem "minitest-rg"
+  gem "mocha"
+  gem "rake", require: false
+  gem "rubocop-shopify", require: false
+  gem "rubocop-sorbet", require: false
+  gem "simplecov", require: false
+  gem "sorbet", "~> 0.5.12414", require: false
+  gem "tapioca", "~> 0.16.11", require: false
+  gem "vcr", require: false
+  gem "webmock", require: false
+end

data/Gemfile.lock

@@ -1,14 +1,24 @@
+GIT
+  remote: https://github.com/Shopify/cli-ui
+  revision: 6bdefd1d06305e5d6ae312ac76f9c88f88658dda
+  branch: main
+  specs:
+    cli-ui (2.7.0)
+
 PATH
   remote: .
   specs:
-    roast-ai (0.4.10)
+    roast-ai (0.5.0)
       activesupport (>= 7.0)
-      cli-kit (~> 5.0)
-      cli-ui (= 2.3.0)
+      async (~> 2.34)
+      benchmark (~> 0.4.1)
+      cli-kit (~> 5.2)
+      cli-ui (~> 2.7)
       diff-lcs (~> 1.5)
       json-schema
       open_router (~> 0.3)
       raix (~> 1.0.2)
+      rake (~> 13.3.0)
       ruby-graphviz (~> 1.2)
       ruby_llm
       sqlite3 (~> 2.6)
@@ -34,19 +44,24 @@ GEM
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
     ast (2.4.3)
+    async (2.34.0)
+      console (~> 1.29)
+      fiber-annotation
+      io-event (~> 1.11)
+      metrics (~> 0.12)
+      traces (~> 0.18)
     base64 (0.3.0)
     benchmark (0.4.1)
     bigdecimal (3.2.2)
-    cgi (0.5.0)
-    claude_swarm (0.1.19)
-      fast-mcp-annotations
-      thor (~> 1.3)
-    cli-kit (5.0.1)
-      cli-ui (~> 2.0)
-    cli-ui (2.3.0)
+    cli-kit (5.2.0)
+      cli-ui (~> 2.4)
     coderay (1.1.3)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.3)
+    console (1.34.2)
+      fiber-annotation
+      fiber-local (~> 1.1)
+      json
     crack (1.0.0)
       bigdecimal
       rexml
@@ -54,35 +69,6 @@ GEM
     docile (1.4.1)
     dotenv (3.1.8)
     drb (2.2.3)
-    dry-configurable (1.3.0)
-      dry-core (~> 1.1)
-      zeitwerk (~> 2.6)
-    dry-core (1.1.0)
-      concurrent-ruby (~> 1.0)
-      logger
-      zeitwerk (~> 2.6)
-    dry-inflector (1.2.0)
-    dry-initializer (3.2.0)
-    dry-logic (1.6.0)
-      bigdecimal
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 1.1)
-      zeitwerk (~> 2.6)
-    dry-schema (1.14.1)
-      concurrent-ruby (~> 1.0)
-      dry-configurable (~> 1.0, >= 1.0.1)
-      dry-core (~> 1.1)
-      dry-initializer (~> 3.2)
-      dry-logic (~> 1.5)
-      dry-types (~> 1.8)
-      zeitwerk (~> 2.6)
-    dry-types (1.8.3)
-      bigdecimal (~> 3.0)
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 1.0)
-      dry-inflector (~> 1.0)
-      dry-logic (~> 1.4)
-      zeitwerk (~> 2.6)
     erubi (1.13.1)
     event_stream_parser (1.0.0)
     faraday (2.13.1)
@@ -95,15 +81,12 @@ GEM
       net-http (>= 0.5.0)
     faraday-retry (2.3.2)
       faraday (~> 2.0)
-    fast-mcp-annotations (1.5.3)
-      addressable (~> 2.8)
-      base64
-      dry-schema (~> 1.14)
-      json (~> 2.0)
-      mime-types (~> 3.4)
-      rack (< 3)
     ffi (1.17.2-arm64-darwin)
     ffi (1.17.2-x86_64-linux-gnu)
+    fiber-annotation (0.2.0)
+    fiber-local (1.1.0)
+      fiber-storage
+    fiber-storage (1.0.1)
     formatador (1.1.0)
     guard (2.19.1)
       formatador (>= 0.2.4)
@@ -123,6 +106,7 @@ GEM
     hashdiff (1.2.0)
     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)
@@ -136,10 +120,7 @@ GEM
     lumberjack (1.2.10)
     marcel (1.1.0)
     method_source (1.1.0)
-    mime-types (3.7.0)
-      logger
-      mime-types-data (~> 3.2025, >= 3.2025.0507)
-    mime-types-data (3.2025.0617)
+    metrics (0.15.0)
     minitest (5.25.5)
     minitest-rg (5.3.0)
       minitest (~> 5.0)
@@ -169,7 +150,6 @@ GEM
       method_source (~> 1.0)
     public_suffix (6.0.2)
     racc (1.8.1)
-    rack (2.2.20)
     rainbow (3.1.1)
     raix (1.0.2)
       activesupport (>= 6.0)
@@ -260,6 +240,7 @@ GEM
       thor (>= 1.2.0)
       yard-sorbet
     thor (1.4.0)
+    traces (0.18.2)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.1.4)
@@ -283,10 +264,7 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  cgi
-  claude_swarm
-  cli-ui (= 2.3.0)
-  dotenv
+  cli-ui!
   guard
   guard-minitest
   minitest-rg
@@ -295,10 +273,9 @@ DEPENDENCIES
   roast-ai!
   rubocop-shopify
   rubocop-sorbet
-  ruby_llm
   simplecov
-  sorbet
-  tapioca
+  sorbet (~> 0.5.12414)
+  tapioca (~> 0.16.11)
   vcr
   webmock