textus 0.53.0 → 0.54.0

data/lib/textus/step/registry_store.rb

@@ -1,66 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Step
-    # The single home for registered steps. Reuses Step::EventBus for observe
-    # (pub/sub) dispatch — including its timeout isolation and error ring buffer
-    # — and holds a kind->{name->instance} table for the invocable kinds
-    # (fetch/transform/validate). Replaces the EventBus+RpcRegistryStore pair.
-    class RegistryStore
-      def initialize(error_log: Step::ErrorLog.new)
-        @bus   = Step::EventBus.new(error_log: error_log)
-        @table = Hash.new { |h, k| h[k] = {} }
-      end
-
-      # Register either a Step instance (invocable/observe table) or a pub/sub
-      # subscriber (`register(event, name, keys:, &block)`) for internal/spec
-      # probes.
-      def register(step, *, keys: nil, &)
-        return @bus.register(step, *, keys: keys, &) unless step.is_a?(Step::Base)
-
-        kind = step.class.kind
-        name = step.name.to_sym
-        return register_observe(step) if kind == :observe
-
-        raise UsageError.new("#{kind} '#{name}' already registered") if @table[kind].key?(name)
-
-        @table[kind][name] = step
-      end
-
-      # Invoke an invocable step. Mirrors the old RpcRegistryStore#invoke: inject
-      # caps only when #call declares :caps or accepts keyrest.
-      def invoke(kind, name, caps:, **other)
-        step = @table[kind][name.to_sym] or raise UsageError.new("unknown #{kind}: #{name}")
-        sig = Step::Signature.new(step.method(:call))
-        kwargs = other.dup
-        kwargs[:caps] = caps if sig.accepts_keyrest? || sig.declared_keys.include?(:caps)
-        step.call(**kwargs)
-      end
-
-      def names(kind)
-        return @bus.pubsub_handlers_names if kind.to_sym == :observe
-
-        @table[kind.to_sym].keys
-      end
-
-      def pubsub_handlers(event)
-        @bus.pubsub_handlers(event)
-      end
-
-      # Pub/sub passthrough (observe + internal built-in subscribers).
-      def publish(event, **) = @bus.publish(event, **)
-      def on(event, name, keys: nil, &) = @bus.register(event, name, keys: keys, &)
-      def on_error(&) = @bus.on_error(&)
-      def error_log = @bus.error_log
-
-      private
-
-      def register_observe(step)
-        sig = Step::Signature.new(step.method(:call))
-        @bus.register(step.class.event, step.name, keys: step.class.match) do |**kw|
-          step.call(**sig.filter(kw))
-        end
-      end
-    end
-  end
-end

data/lib/textus/step/signature.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Step
-    class Signature
-      def initialize(callable)
-        @params = callable.parameters
-      end
-
-      def accepts_keyrest?
-        @params.any? { |type, _| type == :keyrest }
-      end
-
-      def declared_keys
-        @params.each_with_object([]) { |(t, n), acc| acc << n if %i[keyreq key].include?(t) }
-      end
-
-      def missing(required)
-        return [] if accepts_keyrest?
-
-        required - declared_keys
-      end
-
-      def filter(kwargs)
-        return kwargs if accepts_keyrest?
-
-        kwargs.slice(*declared_keys)
-      end
-    end
-  end
-end

data/lib/textus/step/transform.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Step
-    # Combines/reshapes projected rows into an artifact shape. Returns a Hash
-    # (the structured payload base) or an Array of rows. Replaces the
-    # :transform_rows RPC. (Phase 2 will widen `rows:` to a named `inputs:` map.)
-    class Transform < Base
-      def self.required_kwargs = %i[rows config]
-    end
-  end
-end

data/lib/textus/step/validate.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Step
-    # Checks an artifact/store state and returns diagnostics. Replaces the
-    # :validate RPC. Receives only `caps:` (injected by the registry).
-    class Validate < Base
-      def self.required_kwargs = []
-    end
-  end
-end

data/lib/textus/step.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  # A Step is a unit of user-extensible behaviour discovered by convention at
-  # .textus/steps/<kind>/<name>.rb. Five kinds: fetch (external acquisition),
-  # transform (combine/reshape into an artifact), validate (check an artifact),
-  # observe (react to a lifecycle event). Replaces the Textus.hook block queue.
-  module Step
-  end
-end