textus 0.43.2 → 0.46.0

data/lib/textus/cli/verb/list.rb

@@ -1,16 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class List < Verb
-        command_name "list"
-
-        option :prefix, "--prefix=KEY"
-        option :zone, "--zone=Z"
-
-        def call(store)
-          emit({ "entries" => session_for(store).list(prefix: prefix, zone: zone) })
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/migrate.rb

@@ -1,18 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Migrate < Verb
-        command_name "migrate"
-
-        option :as_flag, "--as=ROLE"
-        option :dry_run, "--dry-run"
-
-        def call(store)
-          path = positional.shift or raise UsageError.new("migrate requires <plan.yaml>")
-          plan_yaml = File.read(path)
-          emit(session_for(store).migrate(plan_yaml: plan_yaml, dry_run: dry_run || false).to_h)
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/mv.rb

@@ -1,27 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Mv < Verb
-        command_name "mv"
-        parent_group Group::Key
-
-        option :as_flag, "--as=ROLE"
-        option :dry_run, "--dry-run"
-        option :prefix, "--prefix"
-
-        def call(store)
-          if prefix
-            from_p = positional.shift or raise UsageError.new("mv --prefix requires <from-prefix> <to-prefix>")
-            to_p   = positional.shift or raise UsageError.new("mv --prefix requires <from-prefix> <to-prefix>")
-            emit(session_for(store).key_mv_prefix(from_prefix: from_p, to_prefix: to_p,
-                                                  dry_run: dry_run || false).to_h)
-          else
-            old_key = positional.shift or raise UsageError.new("mv requires <old-key> <new-key>")
-            new_key = positional.shift or raise UsageError.new("mv requires <old-key> <new-key>")
-            emit(session_for(store).mv(old_key, new_key, dry_run: dry_run || false))
-          end
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/propose.rb

@@ -1,28 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      # Queue a proposal. Mirrors the MCP `propose` tool: resolves the
-      # manifest's propose_zone and prefixes the key, so the author does not
-      # need to know the queue zone's name. ADR 0036.
-      class Propose < Verb
-        command_name "propose"
-
-        option :as_flag, "--as=ROLE"
-        option :use_stdin, "--stdin"
-
-        def call(store)
-          rel = positional.shift or raise UsageError.new("propose requires a key")
-          raise UsageError.new("propose requires --stdin") unless use_stdin
-
-          payload = JSON.parse(@stdin.read)
-          env = store.as(resolved_role(store)).propose(
-            rel,
-            meta: payload["_meta"] || {},
-            body: payload["body"] || "",
-          )
-          emit(env.to_h_for_wire)
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/published.rb

@@ -1,13 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Published < Verb
-        command_name "published"
-
-        def call(store)
-          emit({ "published" => session_for(store).published })
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/pulse.rb

@@ -1,26 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Pulse < Verb
-        command_name "pulse"
-
-        option :as_flag, "--as=ROLE"
-        option :since, "--since=N"
-
-        def call(store)
-          role = resolved_role(store)
-          ops = store.as(role)
-
-          if since
-            emit(ops.pulse(since: since.to_i))
-          else
-            cursors = Textus::CursorStore.new(root: store.root, role: role)
-            result = ops.pulse(since: cursors.read)
-            cursors.write(result["cursor"])
-            emit(result)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/rdeps.rb

@@ -1,14 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Rdeps < Verb
-        command_name "rdeps"
-
-        def call(store)
-          key = positional.shift or raise UsageError.new("rdeps requires a key")
-          emit({ "key" => key, "rdeps" => session_for(store).rdeps(key) })
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/reject.rb

@@ -1,16 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Reject < Verb
-        command_name "reject"
-
-        option :as_flag, "--as=ROLE"
-
-        def call(store)
-          key = positional.shift or raise UsageError.new("reject requires a key")
-          emit(session_for(store).reject(key))
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/retain.rb

@@ -1,19 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Retain < Verb
-        command_name "retain"
-
-        option :prefix, "--prefix=KEY"
-        option :zone, "--zone=Z"
-        option :as_flag, "--as=ROLE"
-
-        def call(store)
-          result = session_for(store).retention_sweep(prefix: prefix, zone: zone)
-          emit(result)
-          result["ok"] ? 0 : 1
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/rule_explain.rb

@@ -1,16 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class RuleExplain < Verb
-        command_name "explain"
-        parent_group Group::Rule
-
-        def call(store)
-          key = positional.shift or raise UsageError.new("policy explain requires a KEY")
-          result = session_for(store).policy_explain(key: key)
-          emit({ "verb" => "policy_explain" }.merge(result.transform_keys(&:to_s)))
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/rule_lint.rb

@@ -1,18 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class RuleLint < Verb
-        command_name "lint"
-        parent_group Group::Rule
-
-        option :against, "--against=FILE"
-
-        def call(store)
-          path = against or raise UsageError.new("rule lint --against=FILE required")
-          yaml = File.read(path)
-          emit(session_for(store).rule_lint(candidate_yaml: yaml).to_h)
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/rule_list.rb

@@ -1,29 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class RuleList < Verb
-        command_name "list"
-        parent_group Group::Rule
-
-        def call(store)
-          policies = store.manifest.rules.blocks.map do |b|
-            row = { "match" => b.match }
-            if b.fetch
-              row["fetch"] = {
-                "ttl_seconds" => b.fetch.ttl_seconds,
-                "on_stale" => b.fetch.on_stale,
-                "sync_budget_ms" => b.fetch.sync_budget_ms,
-                "fetch_timeout_seconds" => b.fetch.fetch_timeout_seconds,
-              }
-            end
-            row["handler_allowlist"] = b.handler_allowlist.handlers if b.handler_allowlist
-            row["guard"] = b.guard if b.guard
-            row["retention"] = { "expire_after" => b.retention.expire_after, "archive_after" => b.retention.archive_after } if b.retention
-            row
-          end
-          emit({ "verb" => "policy_list", "policies" => policies })
-        end
-      end
-    end
-  end
-end

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

@@ -1,15 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Schema < Verb
-        command_name "show"
-        parent_group Group::Schema
-
-        def call(store)
-          key = positional.shift or raise UsageError.new("schema requires a key")
-          emit(session_for(store).schema(key))
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/uid.rb

@@ -1,15 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Uid < Verb
-        command_name "uid"
-        parent_group Group::Key
-
-        def call(store)
-          key = positional.shift or raise UsageError.new("uid requires a key")
-          emit({ "key" => key, "uid" => session_for(store).uid(key) })
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/where.rb

@@ -1,14 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Where < Verb
-        command_name "where"
-
-        def call(store)
-          key = positional.shift or raise UsageError.new("where requires a key")
-          emit(session_for(store).where(key))
-        end
-      end
-    end
-  end
-end

data/lib/textus/cli/verb/zone_mv.rb

@@ -1,19 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class ZoneMv < Verb
-        command_name "mv"
-        parent_group Group::Zone
-
-        option :as_flag, "--as=ROLE"
-        option :dry_run, "--dry-run"
-
-        def call(store)
-          from = positional.shift or raise UsageError.new("zone mv requires <from> <to>")
-          to   = positional.shift or raise UsageError.new("zone mv requires <from> <to>")
-          emit(session_for(store).zone_mv(from: from, to: to, dry_run: dry_run || false).to_h)
-        end
-      end
-    end
-  end
-end

data/lib/textus/read/get_or_fetch.rb

@@ -1,69 +0,0 @@
-module Textus
-  module Read
-    # Composes pure `Read::Get` with the fetch orchestrator: runs Get
-    # to obtain the envelope and freshness verdict, then if the verdict
-    # is stale and the rule's `on_stale` policy demands action, hands
-    # off to the orchestrator. Use for interactive reads where the
-    # caller wants the freshest obtainable envelope.
-    #
-    # Pure reads (build, projection, schema tooling) should use
-    # `Read::Get` directly; it has no orchestrator dependency.
-    class GetOrFetch
-      def initialize(container:, call:, get: nil, orchestrator: nil)
-        @container    = container
-        @call         = call
-        @manifest     = container.manifest
-        @get          = get || Read::Get.new(container: container, call: call)
-        @orchestrator = orchestrator || build_orchestrator
-      end
-
-      private
-
-      def hook_context
-        @hook_context ||= Textus::Hooks::Context.for(container: @container, call: @call)
-      end
-
-      def build_orchestrator
-        worker = Textus::Write::FetchWorker.new(
-          container: @container, call: @call,
-        )
-        Textus::Write::FetchOrchestrator.new(
-          worker: worker, store_root: @container.root, events: @container.events,
-          hook_context: hook_context
-        )
-      end
-
-      public
-
-      def call(key)
-        envelope = @get.call(key)
-        return nil if envelope.nil?
-        return envelope unless envelope.freshness&.stale
-
-        policy_set = @manifest.rules.for(key)
-        fetch_policy = policy_set.fetch
-        return envelope if fetch_policy.nil?
-
-        policy = fetch_policy.to_freshness_policy
-        verdict = Textus::Domain::Freshness::Verdict.stale(envelope.freshness.reason)
-        action = policy.decide(verdict)
-        outcome = @orchestrator.execute(action, key: key)
-
-        case outcome
-        when Textus::Domain::Outcome::Skipped
-          envelope
-        when Textus::Domain::Outcome::Fetched
-          outcome.envelope.with(
-            freshness: Textus::Domain::Freshness.build(stale: false, reason: nil, fetching: false),
-          )
-        when Textus::Domain::Outcome::Detached
-          envelope.with(freshness: envelope.freshness.with(fetching: true))
-        when Textus::Domain::Outcome::Failed
-          envelope.with(
-            freshness: envelope.freshness.with(fetch_error: outcome.error.message),
-          )
-        end
-      end
-    end
-  end
-end

data/lib/textus/read/policy_explain.rb

@@ -1,46 +0,0 @@
-module Textus
-  module Read
-    # For one key, surface every matching policy block along with the
-    # per-slot effective value (which loses ties win-by-specificity) and the
-    # effective guard predicate names for every write transition (ADR 0031).
-    class PolicyExplain
-      def initialize(container:, call: nil) # rubocop:disable Lint/UnusedMethodArgument
-        @manifest = container.manifest
-        @schemas  = container.schemas
-      end
-
-      def call(key:)
-        matching = @manifest.rules.explain(key)
-        winners  = @manifest.rules.for(key)
-        factory  = Textus::Domain::Policy::GuardFactory.new(manifest: @manifest, schemas: @schemas)
-
-        {
-          key: key,
-          matched_blocks: matching.map do |b|
-            {
-              match: b.match,
-              fetch: !b.fetch.nil?,
-              handler_allowlist: !b.handler_allowlist.nil?,
-              guard: !b.guard.nil?,
-              retention: !b.retention.nil?,
-            }
-          end,
-          effective: {
-            fetch: winners.fetch && {
-              ttl_seconds: winners.fetch.ttl_seconds,
-              on_stale: winners.fetch.on_stale,
-            },
-            handler_allowlist: winners.handler_allowlist&.handlers,
-            retention: winners.retention && {
-              expire_after: winners.retention.expire_after,
-              archive_after: winners.retention.archive_after,
-            },
-          },
-          guards: Textus::Domain::Policy::BaseGuards::BASE.keys.to_h do |transition|
-            [transition, factory.for(transition, key).predicates.map(&:name)]
-          end,
-        }
-      end
-    end
-  end
-end

data/lib/textus/read/rules.rb

@@ -1,25 +0,0 @@
-module Textus
-  module Read
-    # Effective rule set (fetch + guard) for a key. Was the inlined MCP
-    # `rules` tool; promoted to a first-class verb so MCP is a pure projection
-    # (ADR 0039).
-    class Rules
-      extend Textus::Contract::DSL
-
-      verb     :rules
-      summary  "Return effective rules for a key (fetch, guard, ...)."
-      surfaces :ruby, :mcp
-      arg :key, String, required: true, positional: true,
-                        description: "dotted key whose effective rules you want (fetch ttl/action, write guard, ...)"
-
-      def initialize(container:, call: nil) # rubocop:disable Lint/UnusedMethodArgument
-        @manifest = container.manifest
-      end
-
-      def call(key)
-        set = @manifest.rules.for(key)
-        { "fetch" => set.fetch&.to_h, "guard" => set.guard }.compact
-      end
-    end
-  end
-end