textus 0.52.0 → 0.53.0

data/lib/textus.rb

@@ -1,48 +1,90 @@
 require "zeitwerk"
 require_relative "textus/version"
 require_relative "textus/errors"
-require_relative "textus/mcp"
-require_relative "textus/mcp/errors"
+require_relative "textus/surfaces/mcp"
+require_relative "textus/surfaces/mcp/errors"
 
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect(
   "cli" => "CLI",
   "json" => "Json",
   "yaml" => "Yaml",
-  "hook_dsl_scanner" => "HookDSLScanner",
   "io" => "IO",
   "mcp" => "MCP",
   "mcp_serve" => "MCPServe",
 )
 loader.ignore(File.expand_path("textus/errors.rb", __dir__))
-loader.ignore(File.expand_path("textus/mcp.rb", __dir__))
-loader.ignore(File.expand_path("textus/mcp/errors.rb", __dir__))
+loader.ignore(File.expand_path("textus/surfaces/mcp.rb", __dir__))
+loader.ignore(File.expand_path("textus/surfaces/mcp/errors.rb", __dir__))
 # Scaffold sources copied verbatim into user stores by `textus init`. They are
-# file templates (one calls `Textus.hook` at load time), not gem constants —
-# Zeitwerk must not manage or eager-load them (ADR 0043).
+# templates for user-owned step classes, not gem constants — Zeitwerk must not
+# manage or eager-load them.
 loader.ignore(File.expand_path("textus/init/templates", __dir__))
 loader.setup
 loader.eager_load
 
-# Derive CLI_VERBS after eager_load so all contract-declaring files are present
-# (boot.rb loads first alphabetically; Dispatcher contracts are declared later).
+# Verb symbol → Action class mapping. Replaces Textus::Dispatcher::VERBS.
+Textus::Action::VERBS = {
+  put: Textus::Action::Put,
+  propose: Textus::Action::Propose,
+  key_delete: Textus::Action::KeyDelete,
+  key_mv: Textus::Action::KeyMv,
+  accept: Textus::Action::Accept,
+  reject: Textus::Action::Reject,
+  enqueue: Textus::Action::Enqueue,
+  get: Textus::Action::Get,
+  list: Textus::Action::List,
+  where: Textus::Action::Where,
+  uid: Textus::Action::Uid,
+  blame: Textus::Action::Blame,
+  audit: Textus::Action::Audit,
+  # materialize, refresh, sweep are Worker-only — not in VERBS
+  deps: Textus::Action::Deps,
+  rdeps: Textus::Action::Rdeps,
+  pulse: Textus::Action::Pulse,
+  rule_explain: Textus::Action::RuleExplain,
+  rule_list: Textus::Action::RuleList,
+  published: Textus::Action::Published,
+  schema_show: Textus::Action::SchemaEnvelope,
+  doctor: Textus::Action::Doctor,
+  boot: Textus::Action::Boot,
+  jobs: Textus::Action::Jobs,
+  data_mv: Textus::Action::DataMv,
+  key_mv_prefix: Textus::Action::KeyMvPrefix,
+  key_delete_prefix: Textus::Action::KeyDeletePrefix,
+  drain: Textus::Action::Drain,
+  rule_lint: Textus::Action::RuleLint,
+}.freeze
+
+# Derive CLI_VERBS after VERBS is available.
 Textus::Boot::CLI_VERBS = Textus::Boot.build_cli_verbs.freeze
 
-module Textus
-  @hook_mutex  = Mutex.new
-  @hook_blocks = []
+# Dynamic verb methods on Store (deferred after VERBS is defined).
+Textus::Action::VERBS.each_key do |verb|
+  Textus::Store.define_method(verb) do |*args, role: Textus::Role::DEFAULT, **kwargs|
+    as(role).public_send(verb, *args, **kwargs)
+  end
 
-  def self.hook(&blk)
-    raise UsageError.new("hook block required") unless blk
+  Textus::Surfaces::RoleScope.define_method(verb) do |*args, **kwargs|
+    klass     = Textus::Action::VERBS[verb]
+    cmd_class = Textus::Gate::VERB_COMMAND[verb]
+    inputs    = if klass.respond_to?(:contract?) && klass.contract?
+                  Textus::Contract::Binder.inputs_from_ordered(klass.contract, args, kwargs)
+                else
+                  kwargs.transform_keys(&:to_sym)
+                end
 
-    @hook_mutex.synchronize { @hook_blocks << blk }
-  end
+    role_value = if klass.respond_to?(:contract?) && klass.contract? &&
+                    klass.contract.args.any? { |a| a.name == :role }
+                   inputs[:role]
+                 else
+                   @role
+                 end
 
-  def self.drain_hook_blocks
-    @hook_mutex.synchronize do
-      blocks = @hook_blocks
-      @hook_blocks = []
-      blocks
-    end
+    filled = cmd_class.members.to_h { |m| [m, inputs.merge(role: role_value)[m]] }
+    @container.gate.dispatch(cmd_class.new(**filled), correlation_id: @correlation_id)
   end
 end
+
+module Textus
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.52.0
+  version: 0.53.0
 platform: ruby
 authors:
 - Patrick
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: mustache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: psych
   requirement: !ruby/object:Gem::Requirement
@@ -110,29 +124,49 @@ files:
 - docs/reference/conventions.md
 - exe/textus
 - lib/textus.rb
+- lib/textus/action/accept.rb
+- lib/textus/action/audit.rb
+- lib/textus/action/base.rb
+- lib/textus/action/blame.rb
+- lib/textus/action/boot.rb
+- lib/textus/action/data_mv.rb
+- lib/textus/action/deps.rb
+- lib/textus/action/doctor.rb
+- lib/textus/action/drain.rb
+- lib/textus/action/enqueue.rb
+- lib/textus/action/get.rb
+- lib/textus/action/jobs.rb
+- lib/textus/action/key_delete.rb
+- lib/textus/action/key_delete_prefix.rb
+- lib/textus/action/key_mv.rb
+- lib/textus/action/key_mv_prefix.rb
+- lib/textus/action/list.rb
+- lib/textus/action/propose.rb
+- lib/textus/action/published.rb
+- lib/textus/action/pulse.rb
+- lib/textus/action/pulse/scanner.rb
+- lib/textus/action/put.rb
+- lib/textus/action/rdeps.rb
+- lib/textus/action/reject.rb
+- lib/textus/action/rule_explain.rb
+- lib/textus/action/rule_lint.rb
+- lib/textus/action/rule_list.rb
+- lib/textus/action/schema_envelope.rb
+- lib/textus/action/uid.rb
+- lib/textus/action/where.rb
+- lib/textus/action/write_verb.rb
+- lib/textus/background/job.rb
+- lib/textus/background/job/base.rb
+- lib/textus/background/job/materialize.rb
+- lib/textus/background/job/refresh.rb
+- lib/textus/background/job/sweep.rb
+- lib/textus/background/plan.rb
+- lib/textus/background/planner/plan.rb
+- lib/textus/background/retention/apply.rb
+- lib/textus/background/worker.rb
 - lib/textus/boot.rb
 - lib/textus/call.rb
-- lib/textus/cli.rb
-- lib/textus/cli/group.rb
-- lib/textus/cli/group/hook.rb
-- lib/textus/cli/group/key.rb
-- lib/textus/cli/group/mcp.rb
-- lib/textus/cli/group/rule.rb
-- lib/textus/cli/group/schema.rb
-- lib/textus/cli/group/zone.rb
-- lib/textus/cli/runner.rb
-- lib/textus/cli/verb.rb
-- lib/textus/cli/verb/doctor.rb
-- lib/textus/cli/verb/get.rb
-- lib/textus/cli/verb/hook_run.rb
-- lib/textus/cli/verb/hooks.rb
-- lib/textus/cli/verb/init.rb
-- lib/textus/cli/verb/mcp_serve.rb
-- lib/textus/cli/verb/put.rb
-- lib/textus/cli/verb/schema_diff.rb
-- lib/textus/cli/verb/schema_init.rb
-- lib/textus/cli/verb/schema_migrate.rb
-- lib/textus/cli/verb/serve.rb
+- lib/textus/command.rb
 - lib/textus/container.rb
 - lib/textus/contract.rb
 - lib/textus/contract/around.rb
@@ -141,13 +175,19 @@ files:
 - lib/textus/contract/resources/cursor.rb
 - lib/textus/contract/sources.rb
 - lib/textus/contract/view.rb
+- lib/textus/core/duration.rb
+- lib/textus/core/freshness.rb
+- lib/textus/core/freshness/evaluator.rb
+- lib/textus/core/freshness/verdict.rb
+- lib/textus/core/retention.rb
+- lib/textus/core/retention/sweep.rb
+- lib/textus/core/sentinel.rb
 - lib/textus/cursor_store.rb
-- lib/textus/dispatcher.rb
 - lib/textus/doctor.rb
 - lib/textus/doctor/check.rb
 - lib/textus/doctor/check/audit_log.rb
 - lib/textus/doctor/check/generator_drift.rb
-- lib/textus/doctor/check/handler_allowlist.rb
+- lib/textus/doctor/check/handler_permit.rb
 - lib/textus/doctor/check/hooks.rb
 - lib/textus/doctor/check/illegal_keys.rb
 - lib/textus/doctor/check/intake_registration.rb
@@ -163,33 +203,7 @@ files:
 - lib/textus/doctor/check/sentinels.rb
 - lib/textus/doctor/check/templates.rb
 - lib/textus/doctor/check/unowned_schema_fields.rb
-- lib/textus/domain/action.rb
-- lib/textus/domain/duration.rb
-- lib/textus/domain/freshness.rb
-- lib/textus/domain/freshness/evaluator.rb
-- lib/textus/domain/freshness/verdict.rb
-- lib/textus/domain/jobs/job.rb
-- lib/textus/domain/jobs/registry.rb
-- lib/textus/domain/permission.rb
-- lib/textus/domain/policy/base_guards.rb
-- lib/textus/domain/policy/evaluation.rb
-- lib/textus/domain/policy/guard.rb
-- lib/textus/domain/policy/guard_factory.rb
-- lib/textus/domain/policy/handler_allowlist.rb
-- lib/textus/domain/policy/matcher.rb
-- lib/textus/domain/policy/predicates/author_held.rb
-- lib/textus/domain/policy/predicates/etag_match.rb
-- lib/textus/domain/policy/predicates/fresh_within.rb
-- lib/textus/domain/policy/predicates/registry.rb
-- lib/textus/domain/policy/predicates/schema_valid.rb
-- lib/textus/domain/policy/predicates/target_is_canon.rb
-- lib/textus/domain/policy/predicates/zone_writable_by.rb
-- lib/textus/domain/policy/publish_target.rb
-- lib/textus/domain/policy/retention.rb
-- lib/textus/domain/policy/source.rb
-- lib/textus/domain/retention.rb
-- lib/textus/domain/retention/sweep.rb
-- lib/textus/domain/sentinel.rb
+- lib/textus/doctor/validator.rb
 - lib/textus/entry.rb
 - lib/textus/entry/base.rb
 - lib/textus/entry/json.rb
@@ -201,35 +215,17 @@ files:
 - lib/textus/envelope/io/writer.rb
 - lib/textus/errors.rb
 - lib/textus/etag.rb
-- lib/textus/hooks/builtin.rb
-- lib/textus/hooks/catalog.rb
-- lib/textus/hooks/context.rb
-- lib/textus/hooks/error_log.rb
-- lib/textus/hooks/event_bus.rb
-- lib/textus/hooks/fire_report.rb
-- lib/textus/hooks/loader.rb
-- lib/textus/hooks/rpc_registry.rb
-- lib/textus/hooks/signature.rb
+- lib/textus/events.rb
+- lib/textus/gate.rb
+- lib/textus/gate/auth.rb
 - lib/textus/init.rb
 - lib/textus/init/templates/machine_intake.rb
 - lib/textus/init/templates/orientation_reducer.rb
-- lib/textus/jobs/handlers.rb
-- lib/textus/jobs/scheduler.rb
-- lib/textus/jobs/seeder.rb
 - lib/textus/key/distance.rb
 - lib/textus/key/grammar.rb
 - lib/textus/key/matching.rb
 - lib/textus/key/path.rb
 - lib/textus/layout.rb
-- lib/textus/maintenance.rb
-- lib/textus/maintenance/drain.rb
-- lib/textus/maintenance/key_delete_prefix.rb
-- lib/textus/maintenance/key_mv_prefix.rb
-- lib/textus/maintenance/retention/apply.rb
-- lib/textus/maintenance/rule_lint.rb
-- lib/textus/maintenance/serve.rb
-- lib/textus/maintenance/worker.rb
-- lib/textus/maintenance/zone_mv.rb
 - lib/textus/manifest.rb
 - lib/textus/manifest/capabilities.rb
 - lib/textus/manifest/data.rb
@@ -253,76 +249,94 @@ files:
 - lib/textus/manifest/entry/validators/ignore.rb
 - lib/textus/manifest/entry/validators/publish.rb
 - lib/textus/manifest/policy.rb
+- lib/textus/manifest/policy/handler_permit.rb
+- lib/textus/manifest/policy/matcher.rb
+- lib/textus/manifest/policy/publish_target.rb
+- lib/textus/manifest/policy/react.rb
+- lib/textus/manifest/policy/retention.rb
+- lib/textus/manifest/policy/source.rb
 - lib/textus/manifest/resolver.rb
 - lib/textus/manifest/rules.rb
 - lib/textus/manifest/schema.rb
 - lib/textus/manifest/schema/keys.rb
 - lib/textus/manifest/schema/validator.rb
 - lib/textus/manifest/schema/vocabulary.rb
-- lib/textus/mcp.rb
-- lib/textus/mcp/catalog.rb
-- lib/textus/mcp/errors.rb
-- lib/textus/mcp/server.rb
-- lib/textus/mcp/session.rb
-- lib/textus/mcp/tool_schemas.rb
-- lib/textus/mustache.rb
+- lib/textus/pipeline/acquire/handler.rb
+- lib/textus/pipeline/acquire/intake.rb
+- lib/textus/pipeline/acquire/projection.rb
+- lib/textus/pipeline/acquire/serializer.rb
+- lib/textus/pipeline/acquire/serializer/json.rb
+- lib/textus/pipeline/acquire/serializer/text.rb
+- lib/textus/pipeline/acquire/serializer/yaml.rb
+- lib/textus/pipeline/engine.rb
+- lib/textus/pipeline/render.rb
 - lib/textus/ports/audit_log.rb
 - lib/textus/ports/audit_subscriber.rb
 - lib/textus/ports/build_lock.rb
 - lib/textus/ports/clock.rb
-- lib/textus/ports/produce_on_write_subscriber.rb
 - lib/textus/ports/publisher.rb
 - lib/textus/ports/queue.rb
+- lib/textus/ports/queue/job.rb
 - lib/textus/ports/sentinel_store.rb
 - lib/textus/ports/storage/file_stat.rb
 - lib/textus/ports/storage/file_store.rb
-- lib/textus/produce/acquire/handler.rb
-- lib/textus/produce/acquire/intake.rb
-- lib/textus/produce/acquire/projection.rb
-- lib/textus/produce/acquire/serializer.rb
-- lib/textus/produce/acquire/serializer/json.rb
-- lib/textus/produce/acquire/serializer/text.rb
-- lib/textus/produce/acquire/serializer/yaml.rb
-- lib/textus/produce/engine.rb
-- lib/textus/produce/events.rb
-- lib/textus/produce/render.rb
+- lib/textus/ports/watcher_lock.rb
 - lib/textus/projection.rb
-- lib/textus/read/audit.rb
-- lib/textus/read/blame.rb
-- lib/textus/read/boot.rb
-- lib/textus/read/capabilities.rb
-- lib/textus/read/deps.rb
-- lib/textus/read/doctor.rb
-- lib/textus/read/freshness.rb
-- lib/textus/read/get.rb
-- lib/textus/read/jobs.rb
-- lib/textus/read/list.rb
-- lib/textus/read/published.rb
-- lib/textus/read/pulse.rb
-- lib/textus/read/rdeps.rb
-- lib/textus/read/rule_explain.rb
-- lib/textus/read/rule_list.rb
-- lib/textus/read/schema_envelope.rb
-- lib/textus/read/uid.rb
-- lib/textus/read/validate_all.rb
-- lib/textus/read/validator.rb
-- lib/textus/read/where.rb
 - lib/textus/role.rb
-- lib/textus/role_scope.rb
 - lib/textus/schema.rb
 - lib/textus/schema/tools.rb
 - lib/textus/schemas.rb
 - lib/textus/session.rb
+- lib/textus/step.rb
+- lib/textus/step/base.rb
+- lib/textus/step/builtin.rb
+- lib/textus/step/builtin/csv_fetch.rb
+- lib/textus/step/builtin/ical_events_fetch.rb
+- lib/textus/step/builtin/json_fetch.rb
+- lib/textus/step/builtin/markdown_links_fetch.rb
+- lib/textus/step/builtin/rss_fetch.rb
+- lib/textus/step/catalog.rb
+- lib/textus/step/context.rb
+- lib/textus/step/discovery.rb
+- lib/textus/step/error_log.rb
+- lib/textus/step/event_bus.rb
+- lib/textus/step/fetch.rb
+- lib/textus/step/fire_report.rb
+- lib/textus/step/loader.rb
+- lib/textus/step/observe.rb
+- lib/textus/step/registry_store.rb
+- lib/textus/step/signature.rb
+- lib/textus/step/transform.rb
+- lib/textus/step/validate.rb
 - lib/textus/store.rb
+- lib/textus/surfaces/cli.rb
+- lib/textus/surfaces/cli/group.rb
+- lib/textus/surfaces/cli/group/data.rb
+- lib/textus/surfaces/cli/group/key.rb
+- lib/textus/surfaces/cli/group/mcp.rb
+- lib/textus/surfaces/cli/group/rule.rb
+- lib/textus/surfaces/cli/group/schema.rb
+- lib/textus/surfaces/cli/runner.rb
+- lib/textus/surfaces/cli/verb.rb
+- lib/textus/surfaces/cli/verb/doctor.rb
+- lib/textus/surfaces/cli/verb/get.rb
+- lib/textus/surfaces/cli/verb/init.rb
+- lib/textus/surfaces/cli/verb/mcp_serve.rb
+- lib/textus/surfaces/cli/verb/put.rb
+- lib/textus/surfaces/cli/verb/schema_diff.rb
+- lib/textus/surfaces/cli/verb/schema_init.rb
+- lib/textus/surfaces/cli/verb/schema_migrate.rb
+- lib/textus/surfaces/cli/verb/watch.rb
+- lib/textus/surfaces/mcp.rb
+- lib/textus/surfaces/mcp/catalog.rb
+- lib/textus/surfaces/mcp/errors.rb
+- lib/textus/surfaces/mcp/server.rb
+- lib/textus/surfaces/mcp/session.rb
+- lib/textus/surfaces/mcp/tool_schemas.rb
+- lib/textus/surfaces/role_scope.rb
+- lib/textus/surfaces/watcher.rb
 - lib/textus/uid.rb
 - lib/textus/version.rb
-- lib/textus/write/accept.rb
-- lib/textus/write/enqueue.rb
-- lib/textus/write/key_delete.rb
-- lib/textus/write/key_mv.rb
-- lib/textus/write/propose.rb
-- lib/textus/write/put.rb
-- lib/textus/write/reject.rb
 homepage: https://github.com/patrick204nqh/textus
 licenses:
 - MIT

data/lib/textus/cli/group/hook.rb

@@ -1,9 +0,0 @@
-module Textus
-  class CLI
-    class Group
-      class Hook < Group
-        command_name "hook"
-      end
-    end
-  end
-end

data/lib/textus/cli/group/key.rb

@@ -1,9 +0,0 @@
-module Textus
-  class CLI
-    class Group
-      class Key < Group
-        command_name "key"
-      end
-    end
-  end
-end

data/lib/textus/cli/group/mcp.rb

@@ -1,9 +0,0 @@
-module Textus
-  class CLI
-    class Group
-      class MCP < Group
-        command_name "mcp"
-      end
-    end
-  end
-end

data/lib/textus/cli/group/rule.rb

@@ -1,9 +0,0 @@
-module Textus
-  class CLI
-    class Group
-      class Rule < Group
-        command_name "rule"
-      end
-    end
-  end
-end

data/lib/textus/cli/group/schema.rb

@@ -1,9 +0,0 @@
-module Textus
-  class CLI
-    class Group
-      class Schema < Group
-        command_name "schema"
-      end
-    end
-  end
-end

data/lib/textus/cli/group/zone.rb

@@ -1,9 +0,0 @@
-module Textus
-  class CLI
-    class Group
-      class Zone < Group
-        command_name "zone"
-      end
-    end
-  end
-end

data/lib/textus/cli/group.rb

@@ -1,48 +0,0 @@
-module Textus
-  class CLI
-    class Group < Verb
-      class << self
-        # Subcommands are auto-derived: any Verb descendant whose
-        # `parent_group` is this group counts as a subcommand. Sorted
-        # alphabetically by command_name for stable help output.
-        def subcommands
-          Textus::CLI::Runner.install!
-          Verb.descendants
-              .select { |k| k.parent_group == self && k.command_name }
-              .sort_by(&:command_name)
-              .to_h { |k| [k.command_name, k] }
-        end
-
-        def needs_store?
-          # Delegate to the matched subcommand at parse time; default true.
-          true
-        end
-      end
-
-      def parse(argv)
-        subs = self.class.subcommands
-        subname = argv.shift
-        if subname.nil?
-          raise UsageError.new(
-            "#{self.class.command_name} requires a subcommand: #{subs.keys.join(", ")}",
-          )
-        end
-
-        @sub_klass = subs[subname]
-        unless @sub_klass
-          raise UsageError.new(
-            "unknown #{self.class.command_name} subcommand '#{subname}'. " \
-            "Valid: #{subs.keys.join(", ")}",
-          )
-        end
-
-        @sub = @sub_klass.new(stdin: @stdin, stdout: @stdout, stderr: @stderr, cwd: @cwd)
-        @sub.parse(argv)
-      end
-
-      def call(store)
-        @sub.call(@sub_klass.needs_store? ? store : nil)
-      end
-    end
-  end
-end