roast-ai 0.4.6 → 0.4.8

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: roast-ai
 version: !ruby/object:Gem::Version
-  version: 0.4.6
+  version: 0.4.8
 platform: ruby
 authors:
 - Shopify
@@ -180,7 +180,6 @@ files:
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - ".ruby-version"
-- CHANGELOG.md
 - CLAUDE.md
 - CLAUDE_NOTES.md
 - CODE_OF_CONDUCT.md
@@ -203,248 +202,14 @@ files:
 - docs/ITERATION_SYNTAX.md
 - docs/VALIDATION.md
 - dsl/simple.rb
-- examples/agent_continue/add_documentation/prompt.md
-- examples/agent_continue/add_error_handling/prompt.md
-- examples/agent_continue/analyze_codebase/prompt.md
-- examples/agent_continue/combined_workflow.yml
-- examples/agent_continue/continue_adding_features/prompt.md
-- examples/agent_continue/create_integration_tests/prompt.md
-- examples/agent_continue/document_with_context/prompt.md
-- examples/agent_continue/explore_api/prompt.md
-- examples/agent_continue/implement_client/prompt.md
-- examples/agent_continue/inline_workflow.yml
-- examples/agent_continue/refactor_code/prompt.md
-- examples/agent_continue/verify_changes/prompt.md
-- examples/agent_continue/workflow.yml
-- examples/agent_workflow/README.md
-- examples/agent_workflow/apply_refactorings/prompt.md
-- examples/agent_workflow/identify_code_smells/prompt.md
-- examples/agent_workflow/summarize_improvements/prompt.md
-- examples/agent_workflow/workflow.png
-- examples/agent_workflow/workflow.yml
-- examples/api_workflow/README.md
-- examples/api_workflow/fetch_api_data/prompt.md
-- examples/api_workflow/generate_report/prompt.md
-- examples/api_workflow/prompt.md
-- examples/api_workflow/transform_data/prompt.md
-- examples/api_workflow/workflow.png
-- examples/api_workflow/workflow.yml
-- examples/apply_diff_demo/README.md
-- examples/apply_diff_demo/apply_simple_change/prompt.md
-- examples/apply_diff_demo/create_sample_file/prompt.md
-- examples/apply_diff_demo/workflow.yml
+- examples/README.md
 - examples/available_tools_demo/README.md
 - examples/available_tools_demo/analyze_files/prompt.md
 - examples/available_tools_demo/explore_directory/prompt.md
-- examples/available_tools_demo/workflow.png
 - examples/available_tools_demo/workflow.yml
 - examples/available_tools_demo/write_summary/prompt.md
-- examples/bash_prototyping/README.md
-- examples/bash_prototyping/analyze_network/prompt.md
-- examples/bash_prototyping/analyze_system/prompt.md
-- examples/bash_prototyping/api_testing.png
-- examples/bash_prototyping/api_testing.yml
-- examples/bash_prototyping/check_processes/prompt.md
-- examples/bash_prototyping/generate_report/prompt.md
-- examples/bash_prototyping/process_json_response/prompt.md
-- examples/bash_prototyping/system_analysis.png
-- examples/bash_prototyping/system_analysis.yml
-- examples/bash_prototyping/test_public_api/prompt.md
-- examples/case_when/README.md
-- examples/case_when/detect_language/prompt.md
-- examples/case_when/workflow.png
-- examples/case_when/workflow.yml
-- examples/cmd/README.md
-- examples/cmd/analyze_project/prompt.md
-- examples/cmd/basic_demo/prompt.md
-- examples/cmd/basic_workflow.png
-- examples/cmd/basic_workflow.yml
-- examples/cmd/check_repository/prompt.md
-- examples/cmd/create_and_verify/prompt.md
-- examples/cmd/dev_workflow.png
-- examples/cmd/dev_workflow.yml
-- examples/cmd/explore_project/prompt.md
-- examples/cmd/explorer_workflow.png
-- examples/cmd/explorer_workflow.yml
-- examples/cmd/smart_tool_selection/prompt.md
-- examples/coding_agent_with_model.yml
-- examples/coding_agent_with_retries.yml
-- examples/conditional/README.md
-- examples/conditional/check_condition/prompt.md
-- examples/conditional/simple_workflow.png
-- examples/conditional/simple_workflow.yml
-- examples/conditional/workflow.png
-- examples/conditional/workflow.yml
-- examples/context_management_demo/README.md
-- examples/context_management_demo/workflow.yml
-- examples/direct_coerce_syntax/README.md
-- examples/direct_coerce_syntax/workflow.png
-- examples/direct_coerce_syntax/workflow.yml
-- examples/dot_notation/README.md
-- examples/dot_notation/workflow.png
-- examples/dot_notation/workflow.yml
-- examples/exit_on_error/README.md
-- examples/exit_on_error/analyze_lint_output/prompt.md
-- examples/exit_on_error/apply_fixes/prompt.md
-- examples/exit_on_error/workflow.png
-- examples/exit_on_error/workflow.yml
-- examples/grading/README.md
-- examples/grading/analyze_coverage/prompt.md
-- examples/grading/calculate_final_grade.rb
-- examples/grading/format_result.rb
-- examples/grading/generate_grades/prompt.md
-- examples/grading/generate_recommendations/output.txt
-- examples/grading/generate_recommendations/prompt.md
-- examples/grading/js_test_runner
-- examples/grading/rb_test_runner
-- examples/grading/read_dependencies/prompt.md
-- examples/grading/run_coverage.rb
-- examples/grading/verify_mocks_and_stubs/prompt.md
-- examples/grading/verify_test_helpers/prompt.md
-- examples/grading/workflow.md
-- examples/grading/workflow.png
-- examples/grading/workflow.rb.md
-- examples/grading/workflow.ts+tsx.md
-- examples/grading/workflow.yml
-- examples/instrumentation.rb
-- examples/interpolation/README.md
-- examples/interpolation/analyze_file/prompt.md
-- examples/interpolation/analyze_patterns/prompt.md
-- examples/interpolation/generate_report_for_js/prompt.md
-- examples/interpolation/generate_report_for_rb/prompt.md
-- examples/interpolation/sample.js
-- examples/interpolation/sample.rb
-- examples/interpolation/workflow.md
-- examples/interpolation/workflow.png
-- examples/interpolation/workflow.yml
-- examples/iteration/IMPLEMENTATION.md
-- examples/iteration/README.md
-- examples/iteration/analyze_complexity/prompt.md
-- examples/iteration/generate_recommendations/prompt.md
-- examples/iteration/generate_report/prompt.md
-- examples/iteration/implement_fix/prompt.md
-- examples/iteration/prioritize_issues/prompt.md
-- examples/iteration/prompts/analyze_file.md
-- examples/iteration/prompts/generate_summary.md
-- examples/iteration/prompts/update_report.md
-- examples/iteration/prompts/write_report.md
-- examples/iteration/read_file/prompt.md
-- examples/iteration/select_next_issue/prompt.md
-- examples/iteration/simple_workflow.md
-- examples/iteration/simple_workflow.yml
-- examples/iteration/update_fix_count/prompt.md
-- examples/iteration/verify_fix/prompt.md
-- examples/iteration/workflow.png
-- examples/iteration/workflow.yml
-- examples/json_handling/README.md
-- examples/json_handling/workflow.png
-- examples/json_handling/workflow.yml
-- examples/mcp/README.md
-- examples/mcp/analyze_changes/prompt.md
-- examples/mcp/analyze_issues/prompt.md
-- examples/mcp/analyze_schema/prompt.md
-- examples/mcp/check_data_quality/prompt.md
-- examples/mcp/check_documentation/prompt.md
-- examples/mcp/create_recommendations/prompt.md
-- examples/mcp/database_workflow.png
-- examples/mcp/database_workflow.yml
-- examples/mcp/env_demo/workflow.png
-- examples/mcp/env_demo/workflow.yml
-- examples/mcp/fetch_pr_context/prompt.md
-- examples/mcp/filesystem_demo/create_test_file/prompt.md
-- examples/mcp/filesystem_demo/list_files/prompt.md
-- examples/mcp/filesystem_demo/read_with_mcp/prompt.md
-- examples/mcp/filesystem_demo/workflow.png
-- examples/mcp/filesystem_demo/workflow.yml
-- examples/mcp/generate_insights/prompt.md
-- examples/mcp/generate_report/prompt.md
-- examples/mcp/generate_review/prompt.md
-- examples/mcp/github_workflow.png
-- examples/mcp/github_workflow.yml
-- examples/mcp/multi_mcp_workflow.png
-- examples/mcp/multi_mcp_workflow.yml
-- examples/mcp/post_review/prompt.md
-- examples/mcp/save_report/prompt.md
-- examples/mcp/search_issues/prompt.md
-- examples/mcp/summarize/prompt.md
-- examples/mcp/test_filesystem/prompt.md
-- examples/mcp/test_github/prompt.md
-- examples/mcp/test_read/prompt.md
-- examples/mcp/workflow.png
-- examples/mcp/workflow.yml
-- examples/no_model_fallback/README.md
-- examples/no_model_fallback/analyze_file/prompt.md
-- examples/no_model_fallback/analyze_patterns/prompt.md
-- examples/no_model_fallback/generate_report_for_md/prompt.md
-- examples/no_model_fallback/generate_report_for_rb/prompt.md
-- examples/no_model_fallback/sample.rb
-- examples/no_model_fallback/workflow.yml
-- examples/openrouter_example/README.md
-- examples/openrouter_example/analyze_input/prompt.md
-- examples/openrouter_example/generate_response/prompt.md
-- examples/openrouter_example/workflow.png
-- examples/openrouter_example/workflow.yml
-- examples/pre_post_processing/README.md
-- examples/pre_post_processing/analyze_test_file/prompt.md
-- examples/pre_post_processing/improve_test_coverage/prompt.md
-- examples/pre_post_processing/optimize_test_performance/prompt.md
-- examples/pre_post_processing/post_processing/aggregate_metrics/prompt.md
-- examples/pre_post_processing/post_processing/cleanup_environment/prompt.md
-- examples/pre_post_processing/post_processing/generate_summary_report/prompt.md
-- examples/pre_post_processing/post_processing/output.txt
-- examples/pre_post_processing/pre_processing/gather_baseline_metrics/prompt.md
-- examples/pre_post_processing/pre_processing/setup_test_environment/prompt.md
-- examples/pre_post_processing/validate_changes/prompt.md
-- examples/pre_post_processing/workflow.png
-- examples/pre_post_processing/workflow.yml
-- examples/retry/workflow.yml
-- examples/rspec_to_minitest/README.md
-- examples/rspec_to_minitest/analyze_spec/prompt.md
-- examples/rspec_to_minitest/create_minitest/prompt.md
-- examples/rspec_to_minitest/run_and_improve/prompt.md
-- examples/rspec_to_minitest/workflow.md
-- examples/rspec_to_minitest/workflow.png
-- examples/rspec_to_minitest/workflow.yml
-- examples/shared_config/README.md
-- examples/shared_config/example_with_shared_config/workflow.png
-- examples/shared_config/example_with_shared_config/workflow.yml
-- examples/shared_config/shared.png
-- examples/shared_config/shared.yml
-- examples/single_target_prepost/README.md
-- examples/single_target_prepost/post_processing/output.txt
-- examples/single_target_prepost/pre_processing/gather_dependencies/prompt.md
-- examples/single_target_prepost/workflow.png
-- examples/single_target_prepost/workflow.yml
-- examples/smart_coercion_defaults/README.md
-- examples/smart_coercion_defaults/workflow.png
-- examples/smart_coercion_defaults/workflow.yml
-- examples/step_configuration/README.md
-- examples/step_configuration/workflow.png
-- examples/step_configuration/workflow.yml
-- examples/swarm_example.yml
-- examples/tool_config_example/README.md
-- examples/tool_config_example/example_step/prompt.md
-- examples/tool_config_example/workflow.png
-- examples/tool_config_example/workflow.yml
-- examples/user_input/README.md
-- examples/user_input/funny_name/create_backstory/prompt.md
-- examples/user_input/funny_name/workflow.png
-- examples/user_input/funny_name/workflow.yml
-- examples/user_input/generate_summary/prompt.md
-- examples/user_input/simple_input_demo/workflow.png
-- examples/user_input/simple_input_demo/workflow.yml
-- examples/user_input/survey_workflow.png
-- examples/user_input/survey_workflow.yml
-- examples/user_input/welcome_message/prompt.md
-- examples/user_input/workflow.png
-- examples/user_input/workflow.yml
-- examples/workflow_generator/README.md
-- examples/workflow_generator/analyze_user_request/prompt.md
-- examples/workflow_generator/create_workflow_files/prompt.md
-- examples/workflow_generator/get_user_input/prompt.md
-- examples/workflow_generator/info_from_roast.rb
-- examples/workflow_generator/workflow.png
-- examples/workflow_generator/workflow.yml
+- examples/basic_prompt_workflow/workflow.md
+- examples/basic_prompt_workflow/workflow.yml
 - exe/roast
 - gemfiles/activesupport7.gemfile
 - gemfiles/activesupport8.gemfile
@@ -453,13 +218,13 @@ files:
 - lib/roast/dsl/executor.rb
 - lib/roast/errors.rb
 - lib/roast/factories/api_provider_factory.rb
+- lib/roast/helpers/cmd_runner.rb
 - lib/roast/helpers/function_caching_interceptor.rb
 - lib/roast/helpers/logger.rb
 - lib/roast/helpers/metadata_access.rb
 - lib/roast/helpers/minitest_coverage_runner.rb
 - lib/roast/helpers/path_resolver.rb
 - lib/roast/helpers/prompt_loader.rb
-- lib/roast/helpers/timeout_handler.rb
 - lib/roast/initializers.rb
 - lib/roast/resources.rb
 - lib/roast/resources/api_resource.rb
@@ -561,6 +326,8 @@ files:
 - lib/roast/workflow_diagram_generator.rb
 - package-lock.json
 - roast.gemspec
+- rubocop/cop/roast.rb
+- rubocop/cop/roast/use_cmd_runner.rb
 - schema/workflow.json
 - shipit.rubygems.yml
 - sorbet/config
@@ -582,6 +349,7 @@ files:
 - sorbet/rbi/gems/connection_pool@2.5.3.rbi
 - sorbet/rbi/gems/crack@1.0.0.rbi
 - sorbet/rbi/gems/diff-lcs@1.6.2.rbi
+- sorbet/rbi/gems/docile@1.4.1.rbi
 - sorbet/rbi/gems/dotenv@3.1.8.rbi
 - sorbet/rbi/gems/drb@2.2.3.rbi
 - sorbet/rbi/gems/dry-configurable@1.3.0.rbi
@@ -643,6 +411,7 @@ files:
 - sorbet/rbi/gems/rexml@3.4.1.rbi
 - sorbet/rbi/gems/rubocop-ast@1.45.1.rbi
 - sorbet/rbi/gems/rubocop-shopify@2.17.1.rbi
+- sorbet/rbi/gems/rubocop-sorbet@0.10.5.rbi
 - sorbet/rbi/gems/rubocop@1.77.0.rbi
 - sorbet/rbi/gems/ruby-graphviz@1.2.5.rbi
 - sorbet/rbi/gems/ruby-openai@8.1.0.rbi
@@ -650,6 +419,9 @@ files:
 - sorbet/rbi/gems/ruby2_keywords@0.0.5.rbi
 - sorbet/rbi/gems/securerandom@0.4.1.rbi
 - sorbet/rbi/gems/shellany@0.0.1.rbi
+- sorbet/rbi/gems/simplecov-html@0.13.2.rbi
+- sorbet/rbi/gems/simplecov@0.22.0.rbi
+- sorbet/rbi/gems/simplecov_json_formatter@0.1.4.rbi
 - sorbet/rbi/gems/spoom@1.6.3.rbi
 - sorbet/rbi/gems/sqlite3@2.7.0.rbi
 - sorbet/rbi/gems/tapioca@0.16.11.rbi

data/CHANGELOG.md

@@ -1,364 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.4.6]
-
-### Added
-- Step retries
-
-### Fixed
-- Tokens containing whitespace
-
-## [0.4.5]
-
-### Added
-- **Sorbet static type checking** (#359, #360, #362)
-  - Initial setup of Sorbet for static type analysis
-  - Added `bin/srb tc` command for type checking
-  - Gradually adding type signatures to improve code safety and navigation
-  - Fixed invalid constants that were undefined and never reached
-  - Added to CI pipeline for continuous type checking
-- **Workflow name in step event payloads** (#333, #351)
-  - Added `workflow_name` field to all step-related ActiveSupport::Notification events
-  - Enables better tracking of which workflow a step belongs to in monitoring systems
-  - Updated events: `roast.step.start`, `roast.step.complete`, `roast.step.error`
-
-### Changed
-- **Improved error output formatting** (#358)
-  - Error messages now show concise output by default (just the error message)
-  - Full exception details and stack traces only shown in verbose mode (`-v`)
-  - Makes error output cleaner and more user-friendly
-- **Consolidated workflow runner architecture** (#355)
-  - Merged ConfigurationParser functionality into WorkflowRunner for better cohesion
-  - Simplified the codebase by removing redundant abstraction layers
-
-### Fixed
-- **Removed duplicated pre/post processing code** (#357)
-  - Extracted common pre/post processing logic from individual step executors
-  - Eliminated code duplication across different step types
-  - Improved maintainability and consistency
-
-## [0.4.3] - 2025-07-10
-
-### Changed
-- **Updated to raix-openai-eight gem** - Upgraded from `raix` to `raix-openai-eight` gem which supports OpenAI Ruby client v8.1
-
-## [0.4.2] - 2025-06-20
-
-### Added
-- **Multiline bash command support** (#289)
-  - Enhanced CommandExecutor to properly handle commands spanning multiple lines
-  - Enables sophisticated bash scripts in workflow steps
-  - Maintains backward compatibility with single-line commands
-- **Comprehensive shell security enhancements** (#289)
-  - Smart interpolation that detects shell commands and escapes dangerous characters
-  - Protection against shell injection for all major metacharacters:
-    - Backslashes (`\`) to prevent path injection
-    - Double quotes (`"`) to prevent breaking quoted contexts
-    - Dollar signs (`$`) to prevent variable expansion
-    - Backticks (`` ` ``) to prevent command substitution
-  - Context-aware escaping only in shell commands, preserving text elsewhere
-- **Early detection for missing Raix configuration** (#292)
-  - Provides helpful error messages when Raix is not properly initialized
-  - Shows example configuration for both OpenAI and OpenRouter
-  - Prevents cryptic "undefined method 'chat' for nil" errors
-- **Exit early feature for input steps** (#291)
-  - Pressing Ctrl-C during input steps now exits cleanly
-  - No more confusing stack traces when canceling input
-- **Default --dangerously-skip-permissions flag for CodingAgent** (#290)
-  - Avoids permission prompts during automated workflows
-  - Improves workflow automation experience
-
-### Fixed
-- Test isolation issue causing CI failures (#289)
-- Flaky test in StepExecutorRegistryTest due to executor registration conflicts (#289)
-- Shell command interpolation security vulnerabilities (#289)
-- Missing dependency declarations (cli-kit, sqlite3) (#292)
-
-### Changed
-- Updated cli-kit dependency to ~> 5.0 for better error handling
-- Updated sqlite3 dependency to ~> 2.6 to resolve version conflicts
-
-[0.4.2]: https://github.com/Shopify/roast/compare/v0.4.1...v0.4.2
-
-## [0.4.1] - 2025-06-18
-
-### Added
-- **SQLite session storage** as the default storage backend (#252)
-  - Provides better performance and advanced querying capabilities
-  - Sessions are stored in `~/.roast/sessions.db` by default (configurable via `ROAST_SESSIONS_DB`)
-  - New `roast sessions` command to list and filter stored sessions
-  - New `roast session <id>` command to view detailed session information
-  - Session cleanup with `roast sessions --cleanup --older-than <duration>`
-  - Filter sessions by status, workflow name, or age
-  - Maintains full backward compatibility with filesystem storage
-- **`--file-storage` CLI option** to use legacy filesystem storage instead of SQLite
-  - Use `-f` or `--file-storage` flag to opt into filesystem storage
-  - Environment variable `ROAST_STATE_STORAGE=file` still supported for compatibility
-- **Foundation for wait_for_event feature** (#251)
-  - New `roast resume` command infrastructure for resuming paused workflows
-  - Event storage and tracking in SQLite sessions table
-- **Configurable agent step options** for CodingAgent (#266)
-  - New `continue` option for agent steps to maintain session context across multiple agent invocations
-  - New `include_context_summary` option to provide AI-generated workflow context summaries to agents
-  - Context summaries are intelligently tailored to the agent's specific task using LLM analysis
-  - Helps reduce token usage by including only relevant context information
-- **Token consumption reporting** for step execution (#264)
-  - Displays token usage (prompt and completion) after each step execution
-  - Helps users monitor and optimize their LLM token consumption
-  - Automatically enabled for all workflow runs
-- **Timeout functionality for bash and cmd steps** (#261)
-  - New `timeout` option for bash and cmd steps to prevent hanging commands
-  - Configurable timeout duration in seconds
-  - Commands are automatically terminated if they exceed the specified timeout
-  - Prevents workflows from getting stuck on unresponsive commands
-- **Claude Swarm tool integration** (#254)
-  - New `Roast::Tools::Swarm` for integrating with Claude Swarm framework
-  - Enables using Swarm's multi-agent orchestration capabilities within Roast workflows
-  - Provides seamless handoffs between specialized AI agents
-- **Workflow visualization with diagram command** (#256)
-  - New `roast diagram` command to generate visual representations of workflows
-  - Creates GraphViz-based diagrams showing workflow structure and flow
-  - Supports both DOT format output and PNG/SVG image generation
-  - Helps understand complex workflow logic at a glance
-- **Comprehensive workflow validation** (#244)
-  - New `roast validate` command to check workflow syntax and structure
-  - Validates YAML syntax, step references, and configuration options
-  - Provides detailed error messages for invalid workflows
-  - Helps catch errors before running workflows
-- **apply_diff tool** (#246)
-  - New built-in tool for applying unified diff patches to files
-  - Supports standard diff format for making precise file modifications
-  - Enables AI models to suggest changes in diff format
-  - More reliable than search-and-replace for complex edits
-- **Model fallback mechanism** (#257)
-  - Workflows without explicit model configuration now use a sensible default
-  - Prevents errors when model is not specified at workflow or step level
-  - Improves user experience for simple workflows
-- **Context management foundation for auto-compaction** (#264)
-  - Infrastructure for future automatic context size management
-  - Enables intelligent token usage optimization in long-running workflows
-
-### Changed
-- Session storage now defaults to SQLite instead of filesystem
-  - Existing filesystem sessions remain accessible when using `--file-storage` flag
-  - No migration required - both storage backends can coexist
-
-[0.4.1]: https://github.com/Shopify/roast/compare/v0.4.0...v0.4.1
-
-## [0.4.0] - 2025-06-12
-
-### Added
-- **Input step type** for collecting user input during workflow execution (#154)
-  - Interactive prompts pause workflow execution to collect user input
-  - Supports multiple input types: `text` (default), `confirm`, `select`, and `password`
-  - `confirm` type provides yes/no prompts with boolean results
-  - `select` type allows choosing from a list of options
-  - `password` type masks input for sensitive data using io/console
-  - Input values are stored in workflow output and accessible via dot notation (e.g., `{{output.step_name}}`)
-  - Integrates with CLI::UI for consistent formatting and user experience
-- **Agent step type** for direct pass-through to coding agents (#151)
-  - Steps prefixed with `^` send prompts directly to the CodingAgent tool
-  - Supports both file-based and inline agent prompts
-  - Bypasses LLM interpretation for precise agent instructions
-
-### Fixed
-- DotAccessHash array wrapping and template response handling
-- CLI::UI formatting and color handling for better terminal output
-
-## [0.3.1] - 2025-06-05
-
-### Added
-- Default `print_response: true` for the last step in a workflow (#100)
-  - The last step now automatically prints its response unless explicitly configured otherwise
-  - Helps newcomers who would otherwise see no output from their workflows
-  - Works with all step types: string steps, hash steps with variable assignment, and conditional steps
-  - Parallel steps and iteration steps are intelligently handled (no automatic output since there's no single "last" step)
-
-### Fixed
-- PromptStep now properly passes `print_response`, `json`, and `params` parameters to chat_completion
-
-## [0.3.0] - 2025-06-04
-
-### Changed
-- **BREAKING**: Upgraded to Raix 1.0.0 (#141)
-  - Removed the deprecated `loop` parameter from chat_completion calls
-  - Raix 1.0 automatically continues after tool calls until providing a text response
-  - All chat completions now return strings (no longer arrays or complex structures)
-  - JSON responses are automatically parsed when `json: true` is specified
-- **BREAKING**: Removed configurable `loop` and `auto_loop` options from workflow configuration (#140)
-  - The `loop:` and `auto_loop:` YAML configuration options have been removed entirely
-  - Looping behavior is now automatic: always enabled when tools are present, disabled when no tools exist
-  - This simplifies the codebase and makes behavior more predictable
-  - To migrate: remove any `loop: true/false` or `auto_loop: true/false` settings from your workflow YAML files
-
-### Fixed
-- Enhanced boolean coercion to treat empty strings as false
-- Improved iterable coercion to handle JSON array strings
-- Fixed all tests to work with Raix 1.0's string-only responses
-
-## [0.2.3] - 2025-05-29
-
-### Fixed
-- Model inheritance for nested steps in iteration steps (#105)
-  - Nested steps within `repeat` and `each` blocks now properly inherit model configuration
-  - Configuration hierarchy works correctly: step-specific → workflow-level → default model
-  - Previously, nested steps always used the default model regardless of configuration
-
-## [0.2.2] - 2025-05-29
-
-### Added
-- Pre/post processing framework for workflows with `pre_processing` and `post_processing` sections (#86)
-  - Support for `output.txt` ERB templates in post-processing phase for custom output formatting
-  - Pre/post processing support for single-target workflows (not just multi-target)
-  - Simplified access to pre-processing data in target workflows (removed `output` intermediary level)
-- Verbose mode improvements for better debugging experience (#98)
-  - Command outputs are now displayed when using the `--verbose` flag
-  - Commands executed within conditional branches also show output in verbose mode
-- User-friendly error reporting for workflow failures (#98)
-  - Clear ❌ indicators when commands or steps fail
-  - Command failures show exit status and output (no verbose needed for failures)
-  - Step failures provide helpful context about what might be wrong
-  - Exit handler displays actionable suggestions for resolving issues
-- Automatic workflow discovery by name (#97)
-  - Can now run workflows by name without full path: `roast execute my_workflow`
-  - Automatically looks for `roast/my_workflow/workflow.yml` in current directory
-- Configurable base URI for API endpoints (#83)
-
-### Fixed
-- Search file tool now correctly prefixes paths when searching (#92)
-- Support for Ruby projects using ActiveSupport 7.0+ (#95)
-
-### Changed
-- ActiveSupport dependency relaxed to >= 7.0 for broader compatibility
-
-## [0.2.1]
-
-### Added
-- Smart coercion defaults for boolean expressions based on step type
-  - Ruby expressions (`{{expr}}`) default to regular boolean coercion
-  - Bash commands (`$(cmd)`) default to exit code interpretation
-  - Inline prompts and regular steps default to "smart" LLM-powered interpretation (looks for truthy or falsy language)
-- Direct syntax for step configuration - `coerce_to` and other options are now specified directly on iteration steps
-
-## [0.2.0] - 2025-05-26
-
-### Added
-- Conditional execution support with `if` and `unless` clauses for workflow steps
-- Iteration mechanisms for workflows with `repeat` and `each` constructs (resolving issue #48)
-- Support for conditional repetition with `until` condition and safety limits
-- Collection iteration with variable binding for processing lists of items
-- State persistence for loop iterations to enable resumption after failure
-- Standardized evaluation of Ruby expressions in iteration constructs using `{{}}` syntax
-- Support for using bash commands, step names, and Ruby expressions in iteration conditions and collections
-- Intelligent LLM response to boolean conversion with pattern-based recognition for natural language responses
-- `exit_on_error` configuration option for command steps to continue workflow on failure (resolving issue #71)
-- Dot notation access for workflow outputs (e.g., `workflow.output.step.field`)
-- `--pause` flag for stepping through workflow execution interactively
-
-### Fixed
-- Automatically add `.gitignore` file to cache directory when created (completing issue #22)
-- Load initializers before trying to load tools in case custom tools are defined in initializers (thanks @palkan)
-- Fix loading of targetless workflows (thanks @palkan)
-- Fix OpenRouter support (thanks @xrendan)
-- API authentication error handling and model access issues
-- Conditional step transcript replay regression
-- DotAccessHash serialization for AI prompts
-
-### Improved
-- Enhanced search file tool logging to show full expanded paths instead of relative paths
-- Major refactoring to eliminate circular dependencies and improve architecture
-- Extracted command execution logic into dedicated CommandExecutor class
-- Separated conditional execution from iteration logic for better SOLID compliance
-- Enhanced error messages for API authentication failures
-- Replaced all `require_relative` with `require` statements for consistency
-
-### Changed
-- Refactored god objects to improve code organization and maintainability
-- Improved separation of concerns between workflow components
-
-[0.2.0]: https://github.com/Shopify/roast/compare/v0.1.7...v0.2.0
-
-## [0.1.7] - 2024-05-16
-
-### Added
-- `UpdateFiles` tool for applying diffs/patches to multiple files at once
-- Support for atomic file updates with rollback capability
-- Comprehensive documentation for all built-in tools
-- Enhanced README with detailed tool usage examples
-
-``[0.1.7]: https://github.com/Shopify/roast/compare/v0.1.6...v0.1.7
-
-## [0.1.6] - 2024-05-15
-
-### Added
-- Support for OpenRouter as an API provider
-- `api_provider` configuration option allowing choice between OpenAI and OpenRouter
-- Added separate CI rake task for improved build pipeline
-- Version command to check current Roast version
-- Walking up to home folder for config root
-- Improved initializer support for better project configuration
-
-### Changed
-- Enhanced search tool to work with globs for more flexible searches
-- Improved error handling in configuration and initializers
-- Fixed and simplified interpolation examples
-
-### Fixed
-- Better error messages for search file tool
-- Improved initializer loading and error handling
-- Fixed tests for nested .roast folders
-
-[0.1.6]: https://github.com/Shopify/roast/compare/v0.1.5...v0.1.6
-
-## [0.1.5] - 2024-05-13
-
-### Added
-- Interpolation feature for dynamic workflows using `{{}}` syntax
-- Support for injecting values from workflow context into step names and commands
-- Ability to access file metadata and step outputs using interpolation expressions
-- Examples demonstrating interpolation usage with different file types
-
-[0.1.5]: https://github.com/Shopify/roast/releases/tag/v0.1.5
-
-## [0.1.4] - 2024-05-13
-
-### Fixed
-- Remove test directory restriction from WriteTool. (Thank you @endoze)
-
-[0.1.4]: https://github.com/Shopify/roast/releases/tag/v0.1.4
-
-
-## [0.1.3] - 2024-05-12
-
-### Fixed
-- ReadFile tool now handles absolute and relative paths correctly
-
-[0.1.3]: https://github.com/Shopify/roast/releases/tag/v0.1.3
-
-
-## [0.1.2] - 2024-05-09
-
-### Fixed
-- problem with step loading using `--replay` option
-- made access to `workflow.output` more robust by using hash with indifferent access
-
-[0.1.2]: https://github.com/Shopify/roast/releases/tag/v0.1.2
-
-## [0.1.1] - 2024-05-09
-
-### Added
-- Initial public release of Roast, extracted from Shopify's internal AI orchestration tools
-- Core workflow execution engine for structured AI interactions
-- Step-based workflow definition system
-- Instrumentation hooks for monitoring and debugging
-- Integration with various LLM providers (via [Raix](https://github.com/OlympiaAI/raix))
-- Schema validation for workflow inputs and outputs
-- Command-line interface for running workflows
-- Comprehensive documentation and examples
-
-[0.1.1]: https://github.com/Shopify/roast/releases/tag/v0.1.1