roast-ai 0.4.9 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc01ff6a90dbe17c735b17935bb75bcfda0ee47c0b9dbee6234292cc4f5f3799
-  data.tar.gz: caa21e581b5476a65c2dc8b0b7a27f1b20baf2f493260d954785724f73a3ff40
+  metadata.gz: 2ee882d792c1c09ecc9a023aa1f26825dff3442a8c4152da789078157e26540e
+  data.tar.gz: 51d5d1238e32c5ad6ce9f3d24c3d224d0709da3f3da4e10905f75049dd02f6d7
 SHA512:
-  metadata.gz: 6ea65bb2381627119b5740f9353b064d046e26b2769e0be36baf3f13b9696e30e6bd6332fbbf8c4305fea33d1b2bb12d81a4a56871f3793c3718e2ac8407c6ae
-  data.tar.gz: 23ff60c01817d64bae76bb16c0395d8cc7aa95cd621550cebc5fc6763fcf5ba8a023542bf07b49067fa9210d8f228f538b0e82159d897397d08532deece73bc4
+  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,24 +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 "cli-ui", "2.3.0"
-gem "dotenv"
-gem "guard"
-gem "guard-minitest"
-gem "mocha"
-gem "rake", require: false
-gem "rubocop-shopify", require: false
-gem "rubocop-sorbet", require: false
-gem "simplecov", require: false
-gem "minitest-rg"
-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"
 
-gem "sorbet", require: false
-gem "tapioca", require: false
-
-gem "claude_swarm"
+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,15 +1,26 @@
+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.9)
+    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)
       thor (~> 1.3)
       zeitwerk (~> 2.6)
@@ -33,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
@@ -53,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)
@@ -94,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)
@@ -122,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)
@@ -133,11 +118,9 @@ GEM
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
     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)
@@ -167,7 +150,6 @@ GEM
       method_source (~> 1.0)
     public_suffix (6.0.2)
     racc (1.8.1)
-    rack (2.2.19)
     rainbow (3.1.1)
     raix (1.0.2)
       activesupport (>= 6.0)
@@ -213,6 +195,15 @@ GEM
       faraday-multipart (>= 1)
     ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
+    ruby_llm (1.8.2)
+      base64
+      event_stream_parser (~> 1)
+      faraday (>= 1.10.0)
+      faraday-multipart (>= 1)
+      faraday-net_http (>= 1)
+      faraday-retry (>= 1)
+      marcel (~> 1.0)
+      zeitwerk (~> 2)
     securerandom (0.4.1)
     shellany (0.0.1)
     simplecov (0.22.0)
@@ -249,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)
@@ -272,10 +264,7 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  cgi
-  claude_swarm
-  cli-ui (= 2.3.0)
-  dotenv
+  cli-ui!
   guard
   guard-minitest
   minitest-rg
@@ -285,8 +274,8 @@ DEPENDENCIES
   rubocop-shopify
   rubocop-sorbet
   simplecov
-  sorbet
-  tapioca
+  sorbet (~> 0.5.12414)
+  tapioca (~> 0.16.11)
   vcr
   webmock