cmdx 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b679253afacaaa6d2b1ef842026e3b535ee1b0378167bfa0ebfe5b8c93508e83
-  data.tar.gz: 1751b980c3af7d2e4950d6f1447d17883f94ba1e26ff1a550d90043fbb30b956
+  metadata.gz: f2cf3294b8f53c29043999fe6749ffee42f6c9a52d2e4e327f1ac4589ae96c47
+  data.tar.gz: 8d73284f355b01e171bb75f69c3fab37240462140e834f96e07831402517b89c
 SHA512:
-  metadata.gz: b6998f0a2d795797ca412008afb29eb8c7b8240eeda91a6f88cccae9b77c3250b1b8616d67d661bb82aab6f8d8c2b7f32b9cbc5e099fe1989eb7efd3d927d457
-  data.tar.gz: a4240ac375f5488dc3b312f19d0f556f8f1e78ed84189288de3fea8d82a3eda1586094d2ef45722450c95426ec007f400d926c327f5c2ddb8ad25415f2246187
+  metadata.gz: 5c1e9c43bddefec0085027447651b20de2e1ef16c57492c060d411b08fc036435c7358bcc910fcb7b7f14a8a3d166f45d4a856b17aaa2454bdb2f5f609ca4be3
+  data.tar.gz: 382b8a147035f476f2b03fda8fc1573a4b729bfc336d9776bf04d6c3f5bd95f6617d9efa77b0bbd3576a3feae828537618c06cfa53df1b119d8ac2425ac63682

data/CHANGELOG.md

@@ -4,7 +4,16 @@ 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.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.0.0] - UNRELEASED
+## [2.x.x] - UNRELEASED
+
+### Changed
+- Link cause of a raised Fault exception
+- Simplify context `method_missing` lookup order (small perf boost)
+- Attempt translation of errors `full_messages`
+- Emit `:task_rolled_back` telemetry event on workflow rollback
+- `around_execution` callbacks now wrap only `Task#work` (and any `#rollback`); `before_validation` runs *before* the around-block and `after_execution` runs *after* it. Previously both were nested inside the around-block
+
+## [2.0.0] - 2026-05-05
 
 Full runtime rewrite: the v1 state-machine plus Zeitwerk architecture is replaced by an explicit signal-based runtime, immutable results, fiber-local chains, and a slimmer registry surface. See [docs/v2-migration.md](docs/v2-migration.md) for the full upgrade guide.
 

data/lib/cmdx/context.rb

@@ -281,14 +281,14 @@ module CMDx
     # @raise [NoMethodError] when {#strict?} is true and the key is missing
     # @api private
     def method_missing(method_name, *args, **_kwargs, &)
-      if method_name.end_with?("=")
+      if @table.key?(method_name)
+        @table[method_name]
+      elsif method_name.end_with?("=")
         @table[method_name[..-2].to_sym] = args.first
       elsif method_name.end_with?("?")
         !!@table[method_name[..-2].to_sym]
-      elsif strict? && !@table.key?(method_name)
+      elsif strict?
         raise NoMethodError, "unknown context key #{method_name.inspect} (strict mode)"
-      else
-        @table[method_name]
       end
     end
 

data/lib/cmdx/errors.rb

@@ -113,7 +113,10 @@ module CMDx
     #   (e.g. `{ name: ["name is required"] }`)
     def full_messages
       messages.each_with_object({}) do |(key, set), hash|
-        hash[key] = set.map { |message| "#{key} #{message}" }
+        hash[key] = set.map do |message|
+          i18n_message = I18nProxy.t(message, default: message)
+          "#{key} #{i18n_message}"
+        end
       end
     end
 

data/lib/cmdx/i18n_proxy.rb

@@ -62,7 +62,7 @@ module CMDx
     # @option options [Hash{Symbol => Object}] extra keys interpolated via `String#%` for bundled translations
     # @return [String, Object] the translated/interpolated message
     def translate(key, **options)
-      return ::I18n.translate(key, **options) if defined?(::I18n) && ::I18n.respond_to?(:translate)
+      return ::I18n.translate(key, **options) if defined?(::I18n)
 
       message = translation_default(key) || options[:default]
 

data/lib/cmdx/pipeline.rb

@@ -70,8 +70,6 @@ module CMDx
 
     private
 
-    # @param group [Workflow::ExecutionGroup]
-    # @return [Result, nil] failed result to halt on, or nil when the group succeeds
     def run_sequential(group)
       continue = group.options[:continue_on_failure]
       failures = group.tasks.each_with_object([]) do |task_class, bucket|
@@ -87,8 +85,6 @@ module CMDx
       aggregate(failures, continue:)
     end
 
-    # @param group [Workflow::ExecutionGroup]
-    # @return [Result, nil] failed result to halt on, or nil when the group succeeds
     def run_parallel(group)
       tasks     = group.tasks
       chain     = Chain.current
@@ -146,17 +142,23 @@ module CMDx
         next unless result.success?
         next unless instance.respond_to?(:rollback)
 
-        instance.rollback
-
         old_opts = result.instance_variable_get(:@options)
         new_opts = old_opts.merge(rolled_back: true).freeze
         result.instance_variable_set(:@options, new_opts)
+
+        emit_telemetry(instance, :task_rolled_back)
+        instance.rollback
       end
     end
 
-    # @param failures [Array<Result>]
-    # @param continue [Boolean] when true, merges failures into the workflow's errors
-    # @return [Result, nil] first failure (echoed upstream), or nil when `failures` is empty
+    def emit_telemetry(instance, name, payload = EMPTY_HASH)
+      telemetry = instance.class.telemetry
+      return unless telemetry.subscribed?(name)
+
+      event = Telemetry::Event.build(instance, name, root: false, payload:)
+      telemetry.emit(name, event)
+    end
+
     def aggregate(failures, continue:)
       return if failures.empty?
       return failures.first unless continue

data/lib/cmdx/runtime.rb

@@ -90,12 +90,12 @@ module CMDx
     def run_lifecycle
       measure_duration do
         run_callbacks(:before_execution)
+        run_callbacks(:before_validation)
         run_around(:around_execution) do
-          run_callbacks(:before_validation)
           perform_work
           perform_rollback if @signal.failed?
-          run_callbacks(:after_execution)
         end
+        run_callbacks(:after_execution)
         run_callbacks(:"on_#{@signal.state}")
         run_callbacks(:"on_#{@signal.status}")
         run_callbacks(:on_ok) if @signal.ok?
@@ -109,7 +109,7 @@ module CMDx
       cause = @signal.cause
       raise cause if cause && !cause.is_a?(Fault)
 
-      raise Fault, @result.caused_failure
+      raise Fault, @result.caused_failure, cause:
     end
 
     def finalize_result
@@ -151,8 +151,6 @@ module CMDx
       @duration = Process.clock_gettime(Process::CLOCK_MONOTONIC, :float_millisecond) - start
     end
 
-    # @param event [Symbol] callback event from {Callbacks::EVENTS}
-    # @return [void]
     def run_callbacks(event)
       callbacks = @task.class.callbacks
       return if callbacks.empty?
@@ -160,9 +158,6 @@ module CMDx
       callbacks.process(event, @task)
     end
 
-    # @param event [Symbol] callback event from {Callbacks::EVENTS}
-    # @yield nested lifecycle segment wrapped by `around_execution` callbacks
-    # @return [Object] the wrapped block's return value
     def run_around(event, &)
       callbacks = @task.class.callbacks
       return yield if callbacks.empty?
@@ -225,25 +220,11 @@ module CMDx
       throw(Signal::TAG, Signal.failed(@task.errors.to_s, metadata: @task.metadata))
     end
 
-    # @param name [Symbol] telemetry channel from {Telemetry::EVENTS}
-    # @param payload [Hash{Symbol => Object}] forwarded onto {Telemetry::Event#payload}
-    # @return [void]
     def emit_telemetry(name, payload = EMPTY_HASH)
       telemetry = @task.class.telemetry
       return unless telemetry.subscribed?(name)
 
-      event = Telemetry::Event.new(
-        xid: Chain.current.xid,
-        cid: Chain.current.id,
-        root: @root,
-        type: @task.class.type,
-        task: @task.class,
-        tid: @task.tid,
-        name:,
-        payload:,
-        timestamp: Time.now.utc
-      )
-
+      event = Telemetry::Event.build(@task, name, root: @root, payload:)
       telemetry.emit(name, event)
     end
 

data/lib/cmdx/telemetry.rb

@@ -7,7 +7,21 @@ module CMDx
   class Telemetry
 
     # Immutable event payload passed to subscribers.
-    Event = Data.define(:xid, :cid, :root, :type, :task, :tid, :name, :payload, :timestamp)
+    Event = Data.define(:xid, :cid, :root, :type, :task, :tid, :name, :payload, :timestamp) do
+      def self.build(task, name, root: false, payload: EMPTY_HASH)
+        new(
+          xid: Chain.current.xid,
+          cid: Chain.current.id,
+          root:,
+          type: task.class.type,
+          task: task.class,
+          tid: task.tid,
+          name:,
+          payload:,
+          timestamp: Time.now.utc
+        )
+      end
+    end
 
     # Lifecycle event names Runtime emits.
     EVENTS = %i[

data/lib/cmdx/version.rb

@@ -3,6 +3,6 @@
 module CMDx
 
   # Gem version. Bumped on release; mirrored in the gemspec.
-  VERSION = "2.0.0"
+  VERSION = "2.0.1"
 
 end

data/lib/generators/cmdx/templates/install.rb

@@ -108,6 +108,28 @@ CMDx.configure do |config|
   #   end
   # end)
 
+  # ===========================================================================
+  # Retriers
+  # ===========================================================================
+  # Registered retriers compute the sleep duration between `retry_on` attempts.
+  # Built-ins: `:exponential` (default), `:linear`, `:fibonacci`, `:half_random`,
+  # `:full_random`, `:bounded_random`, `:decorrelated_jitter`. A callable
+  # receives `call(attempt, delay, prev_delay)` and returns seconds.
+  #
+  # config.retriers.register(:capped_exponential, proc do |attempt, delay, _prev|
+  #   [delay * (2**(attempt - 1)), 30.0].min
+  # end)
+
+  # ===========================================================================
+  # Deprecators
+  # ===========================================================================
+  # Registered deprecators dispatch a task class's `deprecation` declaration.
+  # Built-ins: `:log`, `:warn`, `:error`. A callable receives `call(task)`.
+  #
+  # config.deprecators.register(:notify, proc do |task|
+  #   Bugsnag.notify("Deprecated task invoked: #{task.class.name}")
+  # end)
+
   # ===========================================================================
   # Executors
   # ===========================================================================

data/mkdocs.yml

@@ -195,6 +195,7 @@ nav:
       - llms-full.txt: https://drexed.github.io/cmdx/llms-full.txt
       - AI Skills: https://github.com/drexed/cmdx/blob/main/skills
     - Ecosystem:
+      - cmdx-i18n: https://github.com/drexed/cmdx-i18n
       - cmdx-rspec: https://github.com/drexed/cmdx-rspec
   - Blog: blog/index.md
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Juan Gomez