cmdx 1.13.0 → 1.15.0

data/lib/locales/ru.yml

@@ -26,6 +26,7 @@ ru:
       symbol: "символ"
       time: "время"
     validators:
+      absence: "должен быть пустым"
       exclusion:
         of: "не должен быть одним из: %{values}"
         within: "не должен быть между %{min} и %{max}"

data/lib/locales/sc.yml

@@ -26,6 +26,7 @@ sc:
       symbol: "sìmbulu"
       time: "ora"
     validators:
+      absence: "deve èssere bòidu"
       exclusion:
         of: "non deve èssere unu de: %{values}"
         within: "non deve èssere intre %{min} e %{max}"

data/lib/locales/sk.yml

@@ -26,6 +26,7 @@ sk:
       symbol: "symbol"
       time: "čas"
     validators:
+      absence: "musí byť prázdne"
       exclusion:
         of: "nesmie byť jedným z: %{values}"
         within: "nesmie byť medzi %{min} a %{max}"

data/lib/locales/sl.yml

@@ -26,6 +26,7 @@ sl:
       symbol: "simbol"
       time: "čas"
     validators:
+      absence: "mora biti prazno"
       exclusion:
         of: "ne sme biti eden od: %{values}"
         within: "ne sme biti med %{min} in %{max}"

data/lib/locales/sq.yml

@@ -26,6 +26,7 @@ sq:
       symbol: "simbol"
       time: "koha"
     validators:
+      absence: "duhet të jetë bosh"
       exclusion:
         of: "nuk duhet të jetë një nga: %{values}"
         within: "nuk duhet të jetë mes %{min} dhe %{max}"

data/lib/locales/sr.yml

@@ -26,6 +26,7 @@ sr:
       symbol: "симбол"
       time: "време"
     validators:
+      absence: "мора бити празно"
       exclusion:
         of: "не сме бити један од: %{values}"
         within: "не сме бити између %{min} и %{max}"

data/lib/locales/st.yml

@@ -26,6 +26,7 @@ st:
       symbol: "mokhoa"
       time: "nako"
     validators:
+      absence: "e tlameha ho ba e se na letho"
       exclusion:
         of: "ha e tlameha ho ba e mong oa: %{values}"
         within: "ha e tlameha ho ba pakeng tsa %{min} le %{max}"

data/lib/locales/sv.yml

@@ -26,6 +26,7 @@ sv:
       symbol: "symbol"
       time: "tid"
     validators:
+      absence: "måste vara tom"
       exclusion:
         of: "får inte vara en av: %{values}"
         within: "får inte vara mellan %{min} och %{max}"

data/lib/locales/sw.yml

@@ -26,6 +26,7 @@ sw:
       symbol: "ishara"
       time: "wakati"
     validators:
+      absence: "lazima iwe tupu"
       exclusion:
         of: "haipaswi kuwa moja ya: %{values}"
         within: "haipaswi kuwa kati ya %{min} na %{max}"

data/lib/locales/ta.yml

@@ -26,6 +26,7 @@ ta:
       symbol: "குறியீடு"
       time: "நேரம்"
     validators:
+      absence: "வெறுமையாக இருக்க வேண்டும்"
       exclusion:
         of: "பின்வருவனவற்றில் ஒன்றாக இருக்கக்கூடாது: %{values}"
         within: "%{min} மற்றும் %{max} இடையே இருக்கக்கூடாது"

data/lib/locales/te.yml

@@ -26,6 +26,7 @@ te:
       symbol: "చిహ్నం"
       time: "సమయం"
     validators:
+      absence: "ఖాళీగా ఉండాలి"
       exclusion:
         of: "ఈ క్రింది వాటిలో ఒకటి కాకూడదు: %{values}"
         within: "%{min} మరియు %{max} మధ్య ఉండకూడదు"

data/lib/locales/th.yml

@@ -26,6 +26,7 @@ th:
       symbol: "สัญลักษณ์"
       time: "เวลา"
     validators:
+      absence: "ต้องเป็นค่าว่าง"
       exclusion:
         of: "ต้องไม่ใช่หนึ่งใน: %{values}"
         within: "ต้องไม่อยู่ระหว่าง %{min} และ %{max}"

data/lib/locales/tl.yml

@@ -26,6 +26,7 @@ tl:
       symbol: "symbol"
       time: "oras"
     validators:
+      absence: "dapat na walang laman"
       exclusion:
         of: "hindi dapat na isa sa: %{values}"
         within: "hindi dapat na nasa pagitan ng %{min} at %{max}"

data/lib/locales/tr.yml

@@ -26,6 +26,7 @@ tr:
       symbol: "sembol"
       time: "zaman"
     validators:
+      absence: "boş olmalıdır"
       exclusion:
         of: "şunlardan biri olmamalıdır: %{values}"
         within: "%{min} ve %{max} arasında olmamalıdır"

data/lib/locales/tt.yml

@@ -26,6 +26,7 @@ tt:
       symbol: "символ"
       time: "вакыт"
     validators:
+      absence: "буш булырга тиеш"
       exclusion:
         of: "боларның берсе булмасын: %{values}"
         within: "%{min} һәм %{max} арасында булмасын"

data/lib/locales/ug.yml

@@ -26,6 +26,7 @@ ug:
       symbol: "بەلگە"
       time: "ۋاقىت"
     validators:
+      absence: "بوش بولۇشى كېرەك"
       exclusion:
         of: "بۇلارنىڭ بىرى بولماسلىقى كېرەك: %{values}"
         within: "%{min} ۋە %{max} ئارىسىدا بولماسلىقى كېرەك"

data/lib/locales/uk.yml

@@ -26,6 +26,7 @@ uk:
       symbol: "символ"
       time: "час"
     validators:
+      absence: "має бути порожнім"
       exclusion:
         of: "не може бути одним з: %{values}"
         within: "не може бути між %{min} та %{max}"

data/lib/locales/ur.yml

@@ -26,6 +26,7 @@ ur:
       symbol: "علامت"
       time: "وقت"
     validators:
+      absence: "خالی ہونا ضروری ہے"
       exclusion:
         of: "ان میں سے کوئی ایک نہیں ہونا چاہیے: %{values}"
         within: "%{min} اور %{max} کے درمیان نہیں ہونا چاہیے"

data/lib/locales/uz.yml

@@ -26,6 +26,7 @@ uz:
       symbol: "belgi"
       time: "vaqt"
     validators:
+      absence: "bo'sh bo'lishi kerak"
       exclusion:
         of: "bularning biri bo'lmasligi kerak: %{values}"
         within: "%{min} va %{max} oralig'ida bo'lmasligi kerak"

data/lib/locales/vi.yml

@@ -26,6 +26,7 @@ vi:
       symbol: "ký hiệu"
       time: "thời gian"
     validators:
+      absence: "phải để trống"
       exclusion:
         of: "không được là một trong: %{values}"
         within: "không được nằm giữa %{min} và %{max}"

data/lib/locales/wo.yml

@@ -26,6 +26,7 @@ wo:
       symbol: "simbol"
       time: "jamono"
     validators:
+      absence: "dafa war a nekk lu nekk"
       exclusion:
         of: "duñu war a nekk benn ci: %{values}"
         within: "duñu war a nekk ci digg %{min} ak %{max}"

data/lib/locales/zh-CN.yml

@@ -26,6 +26,7 @@ zh-CN:
       symbol: "符号"
       time: "时间"
     validators:
+      absence: "必须为空"
       exclusion:
         of: "不能是以下之一: %{values}"
         within: "不能在 %{min} 和 %{max} 之间"

data/lib/locales/zh-HK.yml

@@ -26,6 +26,7 @@ zh-HK:
       symbol: "符號"
       time: "時間"
     validators:
+      absence: "必須是空白"
       exclusion:
         of: "不可以是其中一個：%{values}"
         within: "不可以在 %{min} 和 %{max} 之間"

data/lib/locales/zh-TW.yml

@@ -26,6 +26,7 @@ zh-TW:
       symbol: "符號"
       time: "時間"
     validators:
+      absence: "必須是空白"
       exclusion:
         of: "不可以是其中一個：%{values}"
         within: "不可以在 %{min} 和 %{max} 之間"

data/lib/locales/zh-YUE.yml

@@ -26,6 +26,7 @@ zh-YUE:
       symbol: "符號"
       time: "時間"
     validators:
+      absence: "必須係空白"
       exclusion:
         of: "唔可以係其中一個：%{values}"
         within: "唔可以喺 %{min} 同 %{max} 之間"

data/mkdocs.yml

@@ -54,6 +54,8 @@ theme:
     - navigation.expand
     - navigation.path
     - navigation.sections
+    - navigation.tabs
+    - navigation.tabs.sticky
     - navigation.top
     - navigation.tracking
     - search.highlight
@@ -81,9 +83,26 @@ markdown_extensions:
   - tables
   - toc:
       permalink: true
+      title: On this page
 
 plugins:
   - search
+  - rss:
+      match_path: blog/posts/.*
+      date_from_meta:
+        as_creation: date
+      categories:
+        - categories
+  - blog:
+      blog_dir: blog
+      blog_toc: true
+      post_date_format: long
+      post_url_format: "{slug}"
+      archive_date_format: MMMM yyyy
+      draft_if_future_date: true
+      categories_allowed:
+        - Tutorials
+        - Updates
   - llmstxt:
       markdown_description: >-
         CMDx is a Ruby framework for building maintainable, observable business logic through composable command/service objects.
@@ -124,51 +143,61 @@ plugins:
           - workflows.md: Composing multiple tasks into sequential pipelines with conditional execution
         More:
           - tips_and_tricks.md: Best practices, patterns, and techniques for maintainable CMDx applications
+          - comparison.md: Comparison with other command/service object frameworks
+        Ecosystem:
+          - cmdx-rspec: RSpec test matchers (https://github.com/drexed/cmdx-rspec)
 
 nav:
   - Home: index.md
-  - Getting Started: getting_started.md
-  - Configuration: configuration.md
-  - Basics:
-    - Setup: basics/setup.md
-    - Execution: basics/execution.md
-    - Context: basics/context.md
-    - Chain: basics/chain.md
-  - Interruptions:
-    - Halt: interruptions/halt.md
-    - Faults: interruptions/faults.md
-    - Exceptions: interruptions/exceptions.md
-  - Outcomes:
-    - Result: outcomes/result.md
-    - States: outcomes/states.md
-    - Statuses: outcomes/statuses.md
-  - Attributes:
-    - Definitions: attributes/definitions.md
-    - Naming: attributes/naming.md
-    - Coercions: attributes/coercions.md
-    - Validations: attributes/validations.md
-    - Defaults: attributes/defaults.md
-    - Transformations: attributes/transformations.md
-  - Features:
-    - Callbacks: callbacks.md
-    - Middlewares: middlewares.md
-    - Logging: logging.md
-    - Internationalization: internationalization.md
-    - Retries: retries.md
-    - Deprecation: deprecation.md
-    - Workflows: workflows.md
-  - More:
-    - Tips and Tricks: tips_and_tricks.md
-  - References:
-    - API Documentation: https://drexed.github.io/cmdx/api/index.html
-    - llms.txt: https://drexed.github.io/cmdx/llms.txt
-    - llms-full.txt: https://drexed.github.io/cmdx/llms-full.txt
+  - Documentation:
+    - Getting Started: getting_started.md
+    - Configuration: configuration.md
+    - Basics:
+      - Setup: basics/setup.md
+      - Execution: basics/execution.md
+      - Context: basics/context.md
+      - Chain: basics/chain.md
+    - Interruptions:
+      - Halt: interruptions/halt.md
+      - Faults: interruptions/faults.md
+      - Exceptions: interruptions/exceptions.md
+    - Outcomes:
+      - Result: outcomes/result.md
+      - States: outcomes/states.md
+      - Statuses: outcomes/statuses.md
+    - Attributes:
+      - Definitions: attributes/definitions.md
+      - Naming: attributes/naming.md
+      - Coercions: attributes/coercions.md
+      - Validations: attributes/validations.md
+      - Defaults: attributes/defaults.md
+      - Transformations: attributes/transformations.md
+    - Features:
+      - Callbacks: callbacks.md
+      - Middlewares: middlewares.md
+      - Logging: logging.md
+      - Internationalization: internationalization.md
+      - Retries: retries.md
+      - Deprecation: deprecation.md
+      - Workflows: workflows.md
+    - More:
+      - Tips and Tricks: tips_and_tricks.md
+      - Comparison: comparison.md
+    - References:
+      - API Documentation: https://drexed.github.io/cmdx/api/index.html
+      - llms.txt: https://drexed.github.io/cmdx/llms.txt
+      - llms-full.txt: https://drexed.github.io/cmdx/llms-full.txt
+    - Ecosystem:
+      - cmdx-rspec: https://github.com/drexed/cmdx-rspec
+  - Blog: blog/index.md
 
 extra:
   generator: false
   social:
     - icon: fontawesome/brands/github
       link: https://github.com/drexed/cmdx
+    - icon: fontawesome/solid/rss
+      link: https://drexed.github.io/cmdx/feed_rss_created.xml
 
 extra_css:
   - stylesheets/extra.css

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 1.13.0
+  version: 1.15.0
 platform: ruby
 authors:
 - Juan Gomez
@@ -227,61 +227,11 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".DS_Store"
-- ".cursor/prompts/docs.md"
-- ".cursor/prompts/llms.md"
-- ".cursor/prompts/rspec.md"
-- ".cursor/prompts/yardoc.md"
-- ".cursor/rules/cursor-instructions.mdc"
-- ".irbrc"
-- ".rspec"
-- ".rubocop.yml"
-- ".ruby-version"
-- ".yard-lint.yml"
-- ".yardopts"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
 - Rakefile
-- docs/.DS_Store
-- docs/assets/favicon.ico
-- docs/assets/favicon.svg
-- docs/attributes/coercions.md
-- docs/attributes/defaults.md
-- docs/attributes/definitions.md
-- docs/attributes/naming.md
-- docs/attributes/transformations.md
-- docs/attributes/validations.md
-- docs/basics/chain.md
-- docs/basics/context.md
-- docs/basics/execution.md
-- docs/basics/setup.md
-- docs/callbacks.md
-- docs/configuration.md
-- docs/deprecation.md
-- docs/getting_started.md
-- docs/index.md
-- docs/internationalization.md
-- docs/interruptions/exceptions.md
-- docs/interruptions/faults.md
-- docs/interruptions/halt.md
-- docs/logging.md
-- docs/middlewares.md
-- docs/outcomes/result.md
-- docs/outcomes/states.md
-- docs/outcomes/statuses.md
-- docs/retries.md
-- docs/stylesheets/extra.css
-- docs/tips_and_tricks.md
-- docs/workflows.md
-- examples/active_record_database_transaction.md
-- examples/active_record_query_tagging.md
-- examples/flipper_feature_flags.md
-- examples/paper_trail_whatdunnit.md
-- examples/redis_idempotency.md
-- examples/sentry_error_tracking.md
-- examples/sidekiq_async_execution.md
-- examples/stoplight_circuit_breaker.md
 - lib/cmdx.rb
 - lib/cmdx/.DS_Store
 - lib/cmdx/attribute.rb
@@ -329,6 +279,7 @@ files:
 - lib/cmdx/utils/condition.rb
 - lib/cmdx/utils/format.rb
 - lib/cmdx/validator_registry.rb
+- lib/cmdx/validators/absence.rb
 - lib/cmdx/validators/exclusion.rb
 - lib/cmdx/validators/format.rb
 - lib/cmdx/validators/inclusion.rb
@@ -431,13 +382,9 @@ files:
 - lib/locales/zh-TW.yml
 - lib/locales/zh-YUE.yml
 - mkdocs.yml
-- src/cmdx-dark-logo.png
-- src/cmdx-favicon.svg
-- src/cmdx-light-logo.png
-- src/cmdx-logo.svg
 homepage: https://github.com/drexed/cmdx
 licenses:
-- MIT
+- LGPL-3.0
 metadata:
   homepage_uri: https://github.com/drexed/cmdx
   source_code_uri: https://github.com/drexed/cmdx
@@ -459,7 +406,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: CMDx is a framework for building maintainable business processes.
 test_files: []

data/.cursor/prompts/docs.md

@@ -1,12 +0,0 @@
-You are a senior Ruby developer with expert knowledge of CMDx and writing documentation.
-
-Update the active tab using the following guidelines:
-
-- Follow best practices and implementation
-- Use a consistent warm, friendly and professional voice
-- Examples should be concise, non-repetitive, and realistic
-- Update any pre-existing documentation to match stated rules
-- Examples should not cross boundaries or focus
-- Docs must cover both typical use cases, including invalid and error conditions
-- Use mkdocs Admonitions to emphasize critical information (https://squidfunk.github.io/mkdocs-material/reference/admonitions/)
-- Optimize for LLM's including coding and AI agents

data/.cursor/prompts/llms.md

@@ -1,8 +0,0 @@
-Process the following instructions in the order given:
-
-1. Create an `LLM.md` file
-2. Append all files within `docs/**/*.md` into @LLM.md
-  2a. Use order outlined under the nav key in @mkdocs.yml
-  2b. Process one file at a time faster performance and improved accuracy
-  2c. Exclude @index.md and @LLM.md files
-  2d. All URLs should be absolute

data/.cursor/prompts/rspec.md

@@ -1,24 +0,0 @@
-You are a senior Ruby developer with expert knowledge of RSpec.
-
-Add tests for the active tab using the following guidelines:
-
-- Expectations should be concise, non-repetitive, and realistic (how it would be used in the real world)
-- Follow best practices and implementation
-- Update any pre-existing specs to match stated rules
-- New tests should be consistent with current `spec/cmdx` specs
-- Use custom matchers available within `lib/cmdx/rspec`
-- Use task helpers available within `spec/support/helpers`
-- Use stubs to return predefined values for specific methods. Isolate the unit being tested, but avoid over-mocking; test real behavior when possible (mocks should be used only when necessary)
-- Ensure each test is independent; avoid shared state between tests
-- Use let and let! to define test data, ensuring minimal and necessary setup
-- Context block descriptions should start with the following words: `when`, `with`, `without`
-- Organize tests logically using describe for classes/modules and context for different scenarios
-- Use subject to define the object under test when appropriate to avoid repetition
-- Ensure test file paths mirror the structure of the files being tested, but within the spec directory (e.g., lib/cmdx/task.rb → spec/cmdx/task_spec.rb)
-- Use clear and descriptive names for describe, context, and it blocks
-- Prefer the expect syntax for assertions to improve readability
-- Keep test code concise; avoid unnecessary complexity or duplication
-- Tests must cover both typical cases and edge cases, including Invalid and error conditions
-- Consider all possible scenarios for each method or behavior and ensure they are tested
-- Do NOT include integration or real world examples
-- Verify all specs are passing

data/.cursor/prompts/yardoc.md

@@ -1,15 +0,0 @@
-You are a senior Ruby developer with expert knowledge of YARDoc.
-
-Add yardoc to the active tab using the following guidelines:
-
-- Follow best practices and implementation
-- New documentation should be consistent with current `lib/cmdx` documentation
-- Examples should be concise, non-repetitive, and realistic
-- Avoid unnecessary complexity or duplication
-- Update any pre-existing documentation to match stated rules
-- Do NOT include `CMDx` module level docs
-- Module level docs description should NOT include `@example`
-- Method level docs should include `@example`, `param`, `@options`, `@return`, and any `@raise`
-- Hash `@params` should expand with possible `@option`
-- Module and method level docs should NOT include `@since`
-- Add RBS inline comments after YARDoc block

data/.cursor/rules/cursor-instructions.mdc

@@ -1,68 +0,0 @@
----
-description:
-globs:
-alwaysApply: true
----
-
-# Ruby Coding Standards
-
-Follow the official Ruby gem guides for best practices.
-Reference the guides outlined in https://guides.rubygems.org
-
-## Project Context
-CMDx provides a framework for designing and executing complex business logic within service/command objects.
-Reference the CMDx documentation in https://github.com/drexed/cmdx/blob/main/LLM.md
-
-## Technology Stack
-- Ruby 3.4+
-- RSpec 3.1+
-
-## Development Guidelines
-- Performance is critical - benchmark any changes that could affect speed
-- Follow existing code patterns and conventions
-- Maintain backward compatibility for public API
-
-## Code Style and Structure
-- Write concise, idiomatic Ruby code with accurate examples
-- Follow Ruby conventions and best practices
-- Use object-oriented and functional programming patterns as appropriate
-- Prefer iteration and modularization over code duplication
-- Use descriptive variable and method names (e.g., user_signed_in?, calculate_total)
-- Write comprehensive code documentation using the Yardoc format
-- Minimize object allocations in hot paths
-
-## Naming Conventions
-- Use snake_case for file names, method names, and variables
-- Use CamelCase for class and module names
-
-## Syntax and Formatting
-- Follow the Ruby Style Guide (https://rubystyle.guide/)
-- Follow Ruby style conventions (2-space indentation, snake_case methods)
-- Use Ruby's expressive syntax (e.g., unless, ||=, &.)
-- Prefer double quotes for strings
-- Respect my Rubocop options
-- Run `bundle exec rubocop .` before finalizing any code changes
-
-## Performance Optimization
-- Use memoization for expensive operations
-
-## Testing
-- Follow the RSpec Style Guide (https://rspec.rubystyle.guide/)
-- Write comprehensive tests using RSpec
-- It's ok to put multiple assertions in the same example
-- Include both BDD and TDD based tests
-- Create test objects to share across tests
-- Do NOT make tests for obvious or reflective expectations
-- Prefer real objects over mocks. Use `instance_double` if necessary; never `double`
-- Don't test declarative configuration
-- Use appropriate matchers
-- Update tests and update Yardocs after you write code
-- Run `bundle rspec .` before finalizing any code changes
-
-## Documentation
-- Utilize the YARDoc format when documenting Ruby code
-- Follow these best practices:
-  - Avoid redundant comments that merely restate the code
-  - Keep comments up-to-date with code changes
-  - Keep documentation consistent
-- Update CHANGELOG.md with any changes

data/.irbrc

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-require "pp"
-
-# rubocop:disable Style/MixinUsage
-unless defined?(CMDx)
-  require_relative "lib/cmdx"
-
-  require_relative "spec/support/helpers/task_builders"
-  require_relative "spec/support/helpers/workflow_builders"
-  include CMDx::Testing::TaskBuilders
-  include CMDx::Testing::WorkflowBuilders
-end
-# rubocop:enable Style/MixinUsage
-
-def reload!
-  exec("irb")
-end

data/.rspec

@@ -1,4 +0,0 @@
---backtrace
---color
---format progress
---order random