textus 0.55.1 → 0.55.2

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.55.1
+  version: 0.55.2
 platform: ruby
 authors:
 - Patrick
@@ -23,20 +23,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: dry-monads
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: dry-schema
   requirement: !ruby/object:Gem::Requirement
@@ -180,55 +166,22 @@ 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/ingest.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/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/boot.rb
-- lib/textus/contract.rb
-- lib/textus/contract/arg.rb
-- lib/textus/contract/dsl.rb
-- lib/textus/contract/spec.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/dispatch/binder.rb
+- lib/textus/dispatch/contracts.rb
+- lib/textus/dispatch/handler_registry.rb
+- lib/textus/dispatch/middleware/audit_index.rb
+- lib/textus/dispatch/middleware/auth.rb
+- lib/textus/dispatch/middleware/base.rb
+- lib/textus/dispatch/middleware/binder.rb
+- lib/textus/dispatch/middleware/cascade.rb
+- lib/textus/dispatch/pipeline.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/illegal_keys.rb
 - lib/textus/doctor/check/manifest_files.rb
-- lib/textus/doctor/check/notebook_sources.rb
 - lib/textus/doctor/check/orphaned_publish_targets.rb
 - lib/textus/doctor/check/proposal_targets.rb
 - lib/textus/doctor/check/protocol_version.rb
@@ -238,6 +191,7 @@ files:
 - lib/textus/doctor/check/schema_parse_error.rb
 - lib/textus/doctor/check/schema_violations.rb
 - lib/textus/doctor/check/schemas.rb
+- lib/textus/doctor/check/scratchpad_sources.rb
 - lib/textus/doctor/check/sentinels.rb
 - lib/textus/doctor/check/stale_reviewed_stamp.rb
 - lib/textus/doctor/check/templates.rb
@@ -248,12 +202,37 @@ files:
 - lib/textus/format/base.rb
 - lib/textus/format/json.rb
 - lib/textus/format/markdown.rb
-- lib/textus/format/shared.rb
 - lib/textus/format/text.rb
 - lib/textus/format/yaml.rb
-- lib/textus/gate.rb
-- lib/textus/gate/auth.rb
-- lib/textus/gate/binder.rb
+- lib/textus/handlers/maintenance/boot_store.rb
+- lib/textus/handlers/maintenance/doctor_store.rb
+- lib/textus/handlers/maintenance/drain_store.rb
+- lib/textus/handlers/maintenance/ingest_entry.rb
+- lib/textus/handlers/maintenance/jobs_action.rb
+- lib/textus/handlers/maintenance/published_entries.rb
+- lib/textus/handlers/maintenance/rule_explain.rb
+- lib/textus/handlers/maintenance/rule_lint.rb
+- lib/textus/handlers/maintenance/rule_list.rb
+- lib/textus/handlers/maintenance/schema_envelope.rb
+- lib/textus/handlers/read/audit_entries.rb
+- lib/textus/handlers/read/blame_entry.rb
+- lib/textus/handlers/read/deps_entry.rb
+- lib/textus/handlers/read/get_entry.rb
+- lib/textus/handlers/read/list_keys.rb
+- lib/textus/handlers/read/pulse_entries.rb
+- lib/textus/handlers/read/rdeps_entry.rb
+- lib/textus/handlers/read/uid_entry.rb
+- lib/textus/handlers/read/where_entry.rb
+- lib/textus/handlers/write/accept_proposal.rb
+- lib/textus/handlers/write/data_mv.rb
+- lib/textus/handlers/write/delete_key.rb
+- lib/textus/handlers/write/enqueue_job.rb
+- lib/textus/handlers/write/key_delete_prefix.rb
+- lib/textus/handlers/write/key_mv_prefix.rb
+- lib/textus/handlers/write/move_key.rb
+- lib/textus/handlers/write/propose_entry.rb
+- lib/textus/handlers/write/put_entry.rb
+- lib/textus/handlers/write/reject_proposal.rb
 - lib/textus/init.rb
 - lib/textus/jobs.rb
 - lib/textus/key/distance.rb
@@ -283,6 +262,16 @@ files:
 - lib/textus/manifest/entry/validators/publish.rb
 - lib/textus/manifest/policy.rb
 - lib/textus/manifest/policy/matcher.rb
+- lib/textus/manifest/policy/predicates.rb
+- lib/textus/manifest/policy/predicates/author_held.rb
+- lib/textus/manifest/policy/predicates/etag_match.rb
+- lib/textus/manifest/policy/predicates/fresh_within.rb
+- lib/textus/manifest/policy/predicates/lane_deletable_by.rb
+- lib/textus/manifest/policy/predicates/lane_writable_by.rb
+- lib/textus/manifest/policy/predicates/raw_lane_ingest_only.rb
+- lib/textus/manifest/policy/predicates/raw_write_once.rb
+- lib/textus/manifest/policy/predicates/schema_valid.rb
+- lib/textus/manifest/policy/predicates/target_is_canon.rb
 - lib/textus/manifest/policy/publish_target.rb
 - lib/textus/manifest/policy/react.rb
 - lib/textus/manifest/policy/retention.rb
@@ -298,28 +287,35 @@ files:
 - lib/textus/manifest/schema/semantics/migration.rb
 - lib/textus/manifest/schema/validator.rb
 - lib/textus/manifest/schema/vocabulary.rb
-- lib/textus/meta.rb
+- lib/textus/orchestration.rb
 - lib/textus/port/audit_log.rb
 - lib/textus/port/build_lock.rb
 - lib/textus/port/clock.rb
 - lib/textus/port/publisher.rb
+- lib/textus/port/sentinel.rb
 - lib/textus/port/sentinel_store.rb
 - lib/textus/port/storage/file_stat.rb
 - lib/textus/port/storage/file_store.rb
+- lib/textus/port/storage/interface.rb
 - lib/textus/port/store.rb
 - lib/textus/port/watcher_lock.rb
 - lib/textus/produce/engine.rb
+- lib/textus/produce/publisher.rb
 - lib/textus/produce/render.rb
 - lib/textus/schema.rb
+- lib/textus/schema/registry.rb
 - lib/textus/schema/tools.rb
-- lib/textus/schemas.rb
 - lib/textus/store.rb
-- lib/textus/store/compositor.rb
 - lib/textus/store/container.rb
 - lib/textus/store/cursor.rb
-- lib/textus/store/envelope/reader.rb
-- lib/textus/store/envelope/writer.rb
-- lib/textus/store/geometry.rb
+- lib/textus/store/entry/reader.rb
+- lib/textus/store/entry/writer.rb
+- lib/textus/store/envelope/meta.rb
+- lib/textus/store/freshness.rb
+- lib/textus/store/freshness/drift_detector.rb
+- lib/textus/store/freshness/evaluator.rb
+- lib/textus/store/freshness/ttl_evaluator.rb
+- lib/textus/store/freshness/verdict.rb
 - lib/textus/store/index/builder.rb
 - lib/textus/store/index/lookup.rb
 - lib/textus/store/jobs/base.rb
@@ -330,9 +326,11 @@ files:
 - lib/textus/store/jobs/queue.rb
 - lib/textus/store/jobs/registry.rb
 - lib/textus/store/jobs/retention.rb
+- lib/textus/store/jobs/retention/base.rb
+- lib/textus/store/jobs/retention/sweep.rb
 - lib/textus/store/jobs/sweep.rb
 - lib/textus/store/jobs/worker.rb
-- lib/textus/store/session.rb
+- lib/textus/store/layout.rb
 - lib/textus/surface/cli.rb
 - lib/textus/surface/cli/group.rb
 - lib/textus/surface/cli/group/data.rb
@@ -355,18 +353,20 @@ files:
 - lib/textus/surface/mcp.rb
 - lib/textus/surface/mcp/catalog.rb
 - lib/textus/surface/mcp/errors.rb
+- lib/textus/surface/mcp/projector.rb
 - lib/textus/surface/mcp/server.rb
-- lib/textus/surface/projector.rb
-- lib/textus/surface/role_scope.rb
 - lib/textus/surface/watcher.rb
 - lib/textus/value/call.rb
 - lib/textus/value/command.rb
+- lib/textus/value/duration.rb
 - lib/textus/value/envelope.rb
 - lib/textus/value/etag.rb
+- lib/textus/value/payload.rb
 - lib/textus/value/result.rb
 - lib/textus/value/role.rb
 - lib/textus/value/types.rb
 - lib/textus/value/uid.rb
+- lib/textus/verb_registry.rb
 - lib/textus/version.rb
 - lib/textus/workflow.rb
 - lib/textus/workflow/collector.rb

data/lib/textus/action/accept.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class Accept < Base
-      verb :accept
-      summary "apply a queued proposal to its target zone; requires the author capability"
-      surfaces :cli, :mcp
-      cli "accept"
-      arg :pending_key, String, required: true, positional: true, description: "the queued proposal's key"
-
-      def self.call(container:, call:, pending_key:)
-        env = container.compositor.read(pending_key)
-        parsed = proposal_from(env, key: pending_key)
-        return parsed if parsed.is_a?(Dry::Monads::Result::Failure)
-
-        target = parsed[:target_key]
-        action = parsed[:proposal]["action"] || "put"
-
-        case action
-        when "put"
-          mentry = container.manifest.resolver.resolve(target).entry
-          container.compositor.write(
-            target,
-            mentry: mentry,
-            payload: Textus::Store::Envelope::Writer::Payload.new(
-              meta: env.meta["_meta"] || {},
-              body: env.body,
-              content: nil,
-            ),
-            call: call,
-          )
-        when "delete"
-          container.compositor.delete(target, call: call)
-        else
-          return Failure(code: :proposal_error, message: "unknown action: #{action}")
-        end
-
-        container.compositor.delete(pending_key, call: call)
-
-        Success("protocol" => Textus::PROTOCOL, "accepted" => pending_key, "target_key" => target, "action" => action,
-                "cascade_key" => target)
-      end
-    end
-  end
-end

data/lib/textus/action/audit.rb

@@ -1,94 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "time"
-
-module Textus
-  module Action
-    class Audit < Base
-      verb :audit
-      summary "Query the audit log with optional filters."
-      surfaces :cli
-      cli "audit"
-      arg :key, String, required: false, description: "filter to rows for this key"
-      arg :lane, String, required: false, description: "filter to keys in this lane"
-      arg :role, String, required: false, description: "filter to rows written under this role"
-      arg :verb, String, required: false, description: "filter to rows for this verb"
-      arg :since, String, required: false,
-                          coerce: ->(s) { Textus::Action::Audit.parse_since(s, now: Time.now) },
-                          description: "ISO-8601 timestamp or relative offset (e.g. 1h, 30m)"
-      arg :seq_since, Integer, required: false, description: "return rows with seq > this cursor value"
-      arg :correlation_id, String, required: false, description: "filter to rows with this correlation_id"
-      arg :limit, Integer, required: false, description: "maximum number of rows to return"
-      view(:cli) { |rows, _i| { "verb" => "audit", "rows" => rows } }
-
-      def self.call(container:, key: nil, lane: nil, role: nil, verb: nil, since: nil, seq_since: nil, correlation_id: nil, limit: nil, **) # rubocop:disable Metrics/ParameterLists
-        audit_log = container.audit_log
-        manifest = container.manifest
-
-        cursor_check = check_cursor_expiry(seq_since, audit_log)
-        return cursor_check if cursor_check.is_a?(Dry::Monads::Result::Failure)
-
-        Success(audit_log.scan(
-          seq_since: seq_since,
-          key: key,
-          role: role,
-          verb: verb,
-          correlation_id: correlation_id,
-          limit: limit,
-        ).select do |row|
-          next false if lane && !key_in_lane?(row["key"], lane, manifest)
-          next false if since && (row["ts"].nil? || Time.parse(row["ts"]) < since)
-
-          true
-        end)
-      end
-
-      def self.parse_since(str, now: Time.now.utc)
-        return nil if str.nil? || str.empty?
-        return Time.parse(str) if str =~ /\A\d{4}-\d{2}-\d{2}/
-
-        match = str.match(/\A(\d+)([smhd])\z/) or return nil
-        mult = { "s" => 1, "m" => 60, "h" => 3600, "d" => 86_400 }[match[2]]
-        now - (match[1].to_i * mult)
-      end
-
-      Query = Data.define(:key, :lane, :role, :verb, :since, :seq_since, :correlation_id, :limit) do
-        # rubocop:disable Metrics/ParameterLists
-        def self.build(key: nil, lane: nil, role: nil, verb: nil,
-                       since: nil, seq_since: nil, correlation_id: nil, limit: nil)
-          new(key:, lane:, role:, verb:, since:, seq_since:, correlation_id:, limit:)
-        end
-        # rubocop:enable Metrics/ParameterLists
-
-        def matches?(row)
-          return false if key && row["key"] != key
-          return false if role && row["role"] != role
-          return false if verb && row["verb"] != verb
-          return false if since && (row["ts"].nil? || Time.parse(row["ts"]) < since)
-          return false if seq_since && (row["seq"].nil? || row["seq"] <= seq_since)
-          return false if correlation_id && row.dig("extras", "correlation_id") != correlation_id
-
-          true
-        end
-      end
-
-      def self.check_cursor_expiry(seq_since, audit_log)
-        return unless seq_since
-
-        min = audit_log.min_available_seq
-        return unless min && seq_since < min - 1
-
-        Failure(code: :cursor_expired, message: "requested seq #{seq_since} is below minimum available #{min}",
-                details: { requested: seq_since, min_available: min })
-      end
-
-      def self.key_in_lane?(key, lane, manifest)
-        mentry = manifest.resolver.resolve(key).entry
-        mentry && mentry.lane == lane
-      rescue Textus::Error
-        false
-      end
-    end
-  end
-end

data/lib/textus/action/base.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    @registry = {}
-
-    def self.registry = @registry
-
-    def self.register(klass)
-      @registry[klass.name.gsub("::", "/").downcase] = klass
-    end
-
-    def self.fetch(type)
-      return @registry[type] if @registry[type]
-
-      match = @registry.values.find { |k| k.const_defined?(:TYPE, false) && type == k::TYPE }
-      raise Textus::UsageError.new("unknown action type: #{type}") unless match
-
-      @registry[type] = match
-    end
-
-    class Base
-      extend Contract::DSL
-      extend Dry::Monads[:result]
-
-      def self.inherited(subclass)
-        super
-        Textus::Action.register(subclass) if subclass.name
-      end
-
-      def self.call(**)
-        raise NotImplementedError.new("#{name}.call")
-      end
-
-      def self.proposal_from(env, key:)
-        proposal = env.meta&.dig("proposal") or return Failure(code: :proposal_error, message: "entry has no proposal block: #{key}")
-        target = proposal["target_key"] or return Failure(code: :proposal_error, message: "proposal missing target_key")
-        { proposal:, target_key: target }
-      end
-    end
-  end
-end

data/lib/textus/action/blame.rb

@@ -1,79 +0,0 @@
-# frozen_string_literal: true
-
-require "open3"
-
-module Textus
-  module Action
-    class Blame < Base
-      verb :blame
-      summary "Annotate audit rows for a key with the git commit that introduced each file state."
-      surfaces :cli
-      cli "blame"
-      arg :key, String, required: true, positional: true, description: "entry key to blame"
-      arg :limit, Integer, required: false, description: "maximum number of audit rows to return"
-      view(:cli) { |rows, inputs| { "verb" => "blame", "key" => inputs[:key], "rows" => rows } }
-
-      def self.call(container:, key:, limit: nil, **)
-        manifest = container.manifest
-        root = container.root
-
-        audit_result = Textus::Action::Audit.call(container: container, key: key, limit: limit)
-        audit_rows = Value::Result.unwrap(audit_result)
-        path = resolve_path(key, manifest: manifest)
-        return Success(audit_rows.map { |row| row.merge("git" => nil) }) unless git_tracked?(path, root: root)
-
-        Success(audit_rows.map { |row| row.merge("git" => git_commit_at(path, timestamp: row["ts"], root: root)) })
-      end
-
-      def self.resolve_path(key, manifest:)
-        res = manifest.resolver.resolve(key)
-        mentry = res.entry
-        path = res.path
-        path || Textus::Key::Path.resolve(manifest.data, mentry)
-      rescue Textus::Error
-        nil
-      end
-
-      def self.git_tracked?(path, root:)
-        return false if path.nil?
-        return false unless File.exist?(path)
-        return false unless git_repo?(root)
-
-        _out, _err, status = Open3.capture3(
-          "git", "ls-files", "--error-unmatch", path,
-          chdir: root
-        )
-        status.success?
-      rescue Errno::ENOENT
-        false
-      end
-
-      def self.git_repo?(root)
-        dir = root
-        loop do
-          return true if File.directory?(File.join(dir, ".git"))
-
-          parent = File.dirname(dir)
-          return false if parent == dir
-
-          dir = parent
-        end
-      end
-
-      def self.git_commit_at(path, timestamp:, root:)
-        args = ["git", "log", "-1"]
-        args << "--before=#{timestamp}" if timestamp
-        args += ["--format=%H%x09%an%x09%aI%x09%s", "--", path]
-        out, _err, status = Open3.capture3(*args, chdir: root)
-        return nil unless status.success?
-
-        sha, author, date, subject = out.strip.split("\t", 4)
-        return nil if sha.nil? || sha.empty?
-
-        { "sha" => sha, "author" => author, "date" => date, "subject" => subject }
-      rescue Errno::ENOENT
-        nil
-      end
-    end
-  end
-end

data/lib/textus/action/boot.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class Boot < Base
-      verb :boot
-      summary "Return the orientation contract: lanes, agent_quickstart, agent_protocol, and pre-computed artifacts."
-      surfaces :cli, :mcp
-
-      def self.call(container:, **)
-        Success(Textus::Boot.build(container: container))
-      end
-    end
-  end
-end

data/lib/textus/action/data_mv.rb

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-require "yaml"
-
-module Textus
-  module Action
-    class DataMv < Base
-      verb :data_mv
-      summary "Rename a data lane — manifest + files. Refuses if destination exists."
-      surfaces :cli, :mcp
-      cli "data mv"
-      arg :from, String, required: true, positional: true, description: "current data lane name"
-      arg :to, String, required: true, positional: true,
-                       description: "new data lane name; refused if a lane by this name already exists"
-      arg :dry_run, :boolean, default: false,
-                              description: "when true, returns the planned zone move without applying it; " \
-                                           "defaults to false, so omitting it applies the move immediately"
-      view { |v, _i| v.to_h }
-
-      def self.call(container:, call:, from:, to:, dry_run: false, **) # rubocop:disable Lint/UnusedMethodArgument
-        manifest = container.manifest
-        geom = container.geometry
-
-        return Failure(code: :usage_error, message: "from and to required") if from.nil? || to.nil? || from.empty? || to.empty?
-        return Failure(code: :usage_error, message: "data lane '#{from}' not declared") unless manifest.data.declared_lane_kinds.key?(from)
-
-        dest_dir = geom.lane_path(to)
-        return Failure(code: :usage_error, message: "destination 'data/#{to}' already exists") if File.exist?(dest_dir)
-
-        affected_keys = manifest.data.entries.select { |entry| entry.lane == from }.map(&:key)
-
-        steps = [{ "op" => "rename_zone", "from" => from, "to" => to }]
-        steps += affected_keys.map do |key|
-          { "op" => "mv", "from" => key, "to" => "#{to}#{key[from.length..]}" }
-        end
-
-        plan = Textus::Store::Jobs::Plan.new(steps: steps, warnings: [])
-        return Success(plan) if dry_run
-
-        rewrite_manifest!(geom, from:, to:)
-        FileUtils.mv(geom.lane_path(from), dest_dir)
-        Success(plan)
-      end
-
-      def self.rewrite_manifest!(geom, from:, to:)
-        path = geom.manifest_path
-        raw = YAML.safe_load_file(path, permitted_classes: [Symbol], aliases: false)
-        raw["lanes"].each { |lane| lane["name"] = to if lane["name"] == from }
-        raw["entries"].each do |entry|
-          entry["lane"] = to if entry["lane"] == from
-          entry["key"] = entry["key"].sub(/\A#{Regexp.escape(from)}(\.|\z)/, "#{to}\\1")
-          entry["path"] = entry["path"].sub(%r{\A(data/)?#{Regexp.escape(from)}(/|\z)}, "\\1#{to}\\2")
-        end
-        File.write(path, YAML.dump(raw))
-      end
-    end
-  end
-end

data/lib/textus/action/deps.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class Deps < Base
-      verb :deps
-      summary "List the keys a derived entry depends on (its projection/external sources)."
-      surfaces :cli, :mcp
-      arg :key, String, required: true, positional: true,
-                        description: "dotted key of the derived entry whose source keys you want"
-
-      def self.call(container:, key:, **)
-        entry = container.manifest.data.entries.find { |e| e.key == key }
-        deps = entry&.external? ? Array(entry.source&.sources).compact : []
-        Success({ "key" => key, "deps" => deps.uniq })
-      end
-    end
-  end
-end

data/lib/textus/action/doctor.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class Doctor < Base
-      verb :doctor
-      summary "Run health checks on the textus store and report any issues."
-      surfaces :cli
-      cli "doctor"
-      arg :checks, Array, required: false, description: "subset of check names to run (default: all)"
-
-      def self.call(container:, call:, checks: nil, **)
-        Success(Textus::Doctor.build(container: container, checks: checks, role: call.role))
-      end
-    end
-  end
-end

data/lib/textus/action/drain.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class Drain < Base
-      verb :drain
-      summary "Seed materialize + sweep jobs then drain the queue to empty. " \
-              "Identical to one Watcher tick. Use when no watcher is running."
-      surfaces :cli, :mcp
-      arg :prefix, String, description: "restrict to keys under this dotted prefix"
-      arg :lane,   String, description: "restrict to entries in this lane"
-
-      def self.call(container:, call:, prefix: nil, lane: nil) # rubocop:disable Lint/UnusedMethodArgument
-        queue = Textus::Store::Jobs::Queue.new(store: container.job_store)
-        Textus::Store::Jobs::Planner.seed(
-          container: container,
-          queue: queue,
-          role: call.role,
-        )
-        queue.reclaim(now: Textus::Port::Clock.new.now)
-        summary = Textus::Store::Jobs::Worker.for(container:, queue:).drain
-        Success({
-                  "protocol" => Textus::PROTOCOL,
-                  "ok" => summary.failed.zero?,
-                  "completed" => summary.completed,
-                  "failed" => summary.failed,
-                })
-      end
-    end
-  end
-end