textus 0.50.0 → 0.51.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.50.0
+  version: 0.51.0
 platform: ruby
 authors:
 - Patrick
@@ -111,12 +111,6 @@ files:
 - exe/textus
 - lib/textus.rb
 - lib/textus/boot.rb
-- lib/textus/builder/pipeline.rb
-- lib/textus/builder/renderer.rb
-- lib/textus/builder/renderer/json.rb
-- lib/textus/builder/renderer/markdown.rb
-- lib/textus/builder/renderer/text.rb
-- lib/textus/builder/renderer/yaml.rb
 - lib/textus/call.rb
 - lib/textus/cli.rb
 - lib/textus/cli/group.rb
@@ -128,8 +122,6 @@ files:
 - lib/textus/cli/group/zone.rb
 - lib/textus/cli/runner.rb
 - lib/textus/cli/verb.rb
-- lib/textus/cli/verb/boot.rb
-- lib/textus/cli/verb/build.rb
 - lib/textus/cli/verb/doctor.rb
 - lib/textus/cli/verb/get.rb
 - lib/textus/cli/verb/hook_run.rb
@@ -153,13 +145,11 @@ files:
 - lib/textus/doctor.rb
 - lib/textus/doctor/check.rb
 - lib/textus/doctor/check/audit_log.rb
-- lib/textus/doctor/check/fetch_locks.rb
 - lib/textus/doctor/check/generator_drift.rb
 - lib/textus/doctor/check/handler_allowlist.rb
 - lib/textus/doctor/check/hooks.rb
 - lib/textus/doctor/check/illegal_keys.rb
 - lib/textus/doctor/check/intake_registration.rb
-- lib/textus/doctor/check/lifecycle_action_invalid.rb
 - lib/textus/doctor/check/manifest_files.rb
 - lib/textus/doctor/check/orphaned_publish_targets.rb
 - lib/textus/doctor/check/proposal_targets.rb
@@ -176,17 +166,13 @@ files:
 - lib/textus/domain/duration.rb
 - lib/textus/domain/freshness.rb
 - lib/textus/domain/freshness/evaluator.rb
-- lib/textus/domain/freshness/policy.rb
 - lib/textus/domain/freshness/verdict.rb
-- lib/textus/domain/lifecycle.rb
-- lib/textus/domain/outcome.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/lifecycle.rb
 - lib/textus/domain/policy/matcher.rb
 - lib/textus/domain/policy/predicates/author_held.rb
 - lib/textus/domain/policy/predicates/etag_match.rb
@@ -195,9 +181,12 @@ files:
 - 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/domain/staleness.rb
-- lib/textus/domain/staleness/generator_check.rb
 - lib/textus/entry.rb
 - lib/textus/entry/base.rb
 - lib/textus/entry/json.rb
@@ -223,25 +212,25 @@ files:
 - lib/textus/init/templates/orientation_reducer.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/key_delete_prefix.rb
 - lib/textus/maintenance/key_mv_prefix.rb
+- lib/textus/maintenance/reconcile.rb
 - lib/textus/maintenance/rule_lint.rb
-- lib/textus/maintenance/tend.rb
 - lib/textus/maintenance/zone_mv.rb
 - lib/textus/manifest.rb
 - lib/textus/manifest/capabilities.rb
 - lib/textus/manifest/data.rb
 - lib/textus/manifest/entry.rb
 - lib/textus/manifest/entry/base.rb
-- lib/textus/manifest/entry/derived.rb
 - lib/textus/manifest/entry/ignore_matcher.rb
-- lib/textus/manifest/entry/intake.rb
 - lib/textus/manifest/entry/leaf.rb
 - lib/textus/manifest/entry/nested.rb
 - lib/textus/manifest/entry/parser.rb
+- lib/textus/manifest/entry/produced.rb
 - lib/textus/manifest/entry/publish.rb
 - lib/textus/manifest/entry/publish/mode.rb
 - lib/textus/manifest/entry/publish/none.rb
@@ -253,30 +242,40 @@ files:
 - lib/textus/manifest/entry/validators/events.rb
 - lib/textus/manifest/entry/validators/format_matrix.rb
 - lib/textus/manifest/entry/validators/ignore.rb
-- lib/textus/manifest/entry/validators/inject_boot.rb
 - lib/textus/manifest/entry/validators/publish.rb
 - lib/textus/manifest/policy.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/mcp/tools.rb
 - lib/textus/mustache.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/fetch/detached.rb
-- lib/textus/ports/fetch/lock.rb
+- lib/textus/ports/produce_on_write_subscriber.rb
 - lib/textus/ports/publisher.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/projection.rb
 - lib/textus/read/audit.rb
 - lib/textus/read/blame.rb
@@ -307,14 +306,8 @@ files:
 - lib/textus/uid.rb
 - lib/textus/version.rb
 - lib/textus/write/accept.rb
-- lib/textus/write/build.rb
-- lib/textus/write/fetch_events.rb
-- lib/textus/write/fetch_orchestrator.rb
-- lib/textus/write/fetch_worker.rb
-- lib/textus/write/intake_fetch.rb
 - lib/textus/write/key_delete.rb
 - lib/textus/write/key_mv.rb
-- lib/textus/write/materializer.rb
 - lib/textus/write/propose.rb
 - lib/textus/write/put.rb
 - lib/textus/write/reject.rb

data/lib/textus/builder/pipeline.rb

@@ -1,88 +0,0 @@
-require "fileutils"
-
-module Textus
-  module Builder
-    module InjectMeta
-      # Returns a new hash with _meta as the first key, per SPEC §6 ordering.
-      # Carries only deterministic provenance (`from`/`reduce`/`template`) — the
-      # volatile `generated_at` is deliberately NOT stamped, so the built
-      # artifact is content-addressed and a rebuild is a byte-for-byte no-op
-      # (ADR 0070). Build time lives out of the tracked artifact.
-      def self.call(content_hash, mentry)
-        meta = {}
-        if mentry.is_a?(Textus::Manifest::Entry::Derived)
-          src = mentry.source
-          if src.is_a?(Textus::Manifest::Entry::Derived::Projection)
-            from = Array(src.select).compact
-            meta["from"] = from unless from.empty?
-            meta["reduce"] = src.transform if src.transform
-          end
-        end
-        meta["template"] = mentry.template if mentry.template
-
-        out = { "_meta" => meta }
-        content_hash.each { |k, v| out[k] = v unless k == "_meta" }
-        out
-      end
-    end
-
-    module Pipeline
-      Deps = Data.define(
-        :manifest, :reader, :lister, :rpc, :template_loader, :transform_context, :inject_boot
-      )
-
-      def self.renderers
-        @renderers ||= {
-          "markdown" => Renderer::Markdown,
-          "text" => Renderer::Text,
-          "json" => Renderer::Json,
-          "yaml" => Renderer::Yaml,
-        }
-      end
-
-      def self.run(mentry:, deps:)
-        # 1. Load sources + project + reduce. Only projection-derived entries are
-        # buildable in-process; External entries are generated out-of-band and are
-        # filtered out upstream (Derived#publish_via), so reaching here with a
-        # non-projection source is a wiring bug — fail loudly rather than emit an
-        # empty payload (and never re-stamp the volatile generated_at, ADR 0070).
-        unless mentry.is_a?(Textus::Manifest::Entry::Derived) && mentry.projection?
-          raise UsageError.new(
-            "builder: '#{mentry.key}' is not a projection-derived entry; only projections are buildable",
-          )
-        end
-
-        data =
-          Textus::Projection.new(
-            reader: deps.reader,
-            spec: mentry.source.to_h.transform_keys(&:to_s),
-            lister: deps.lister,
-            rpc: deps.rpc,
-            transform_context: deps.transform_context,
-          ).run
-        data = data.merge("boot" => deps.inject_boot.call) if mentry.inject_boot && deps.inject_boot
-
-        # 2. Render
-        klass = renderers[mentry.format] or
-          raise UsageError.new("builder: unsupported format #{mentry.format.inspect} for '#{mentry.key}'")
-        bytes = klass.new(template_loader: deps.template_loader).call(mentry: mentry, data: data)
-
-        # 3. Write (idempotent: skip if only generated_at would differ)
-        target_path = Key::Path.resolve(deps.manifest.data, mentry)
-        FileUtils.mkdir_p(File.dirname(target_path))
-        write_if_changed(target_path, bytes, mentry.format)
-
-        target_path
-      end
-
-      # Built artifacts are content-addressed (no volatile timestamp, ADR 0070),
-      # so identity is plain byte-equality: skip the write when nothing changed.
-      # `format` is retained for signature stability across renderers.
-      def self.write_if_changed(target_path, bytes, _format)
-        return if File.exist?(target_path) && File.binread(target_path) == bytes
-
-        File.binwrite(target_path, bytes)
-      end
-    end
-  end
-end

data/lib/textus/builder/renderer/json.rb

@@ -1,45 +0,0 @@
-require "json"
-
-module Textus
-  module Builder
-    class Renderer
-      class Json < Renderer
-        def call(mentry:, data:)
-          content = mentry.template ? parse_rendered_template!(mentry, data) : default_shape(mentry, data)
-          final = mentry.provenance ? InjectMeta.call(content, mentry) : content
-          Entry.for_format("json").serialize(meta: {}, body: "", content: final)
-        end
-
-        private
-
-        def parse_rendered_template!(mentry, data)
-          rendered = Mustache.render(@template_loader.call(mentry.template), data)
-          begin
-            parsed = ::JSON.parse(rendered)
-          rescue ::JSON::ParserError => e
-            raise BadRender.new("entry '#{mentry.key}': template did not render valid json: #{e.message}", format: "json")
-          end
-          unless parsed.is_a?(Hash)
-            raise BadRender.new("entry '#{mentry.key}': template must render a top-level object/mapping",
-                                format: "json")
-          end
-
-          parsed
-        end
-
-        def default_shape(mentry, data)
-          has_transform = mentry.is_a?(Textus::Manifest::Entry::Derived) &&
-                          mentry.source.is_a?(Textus::Manifest::Entry::Derived::Projection) &&
-                          mentry.source.transform
-          if has_transform && data.is_a?(Hash) && !data.key?("entries")
-            data
-          elsif data.is_a?(Hash) && data["entries"].is_a?(Array)
-            { "entries" => data["entries"] }
-          else
-            data.is_a?(Hash) ? data : { "entries" => Array(data) }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/textus/builder/renderer/markdown.rb

@@ -1,24 +0,0 @@
-module Textus
-  module Builder
-    class Renderer
-      class Markdown < Renderer
-        def call(mentry:, data:)
-          raise TemplateError.new("entry '#{mentry.key}': markdown build requires a template") unless mentry.template
-
-          body = Mustache.render(@template_loader.call(mentry.template), data)
-          from = if mentry.is_a?(Textus::Manifest::Entry::Derived) &&
-                    mentry.source.is_a?(Textus::Manifest::Entry::Derived::Projection)
-                   Array(mentry.source.select).compact
-                 else
-                   []
-                 end
-          # Deterministic frontmatter only — `from` (the source keys), never a
-          # volatile `generated.at` (ADR 0070): the artifact is content-addressed
-          # so a rebuild is a byte-for-byte no-op and a revert never drifts.
-          frontmatter = { "generated" => { "from" => from } }
-          Entry.for_format("markdown").serialize(meta: frontmatter, body: body)
-        end
-      end
-    end
-  end
-end

data/lib/textus/builder/renderer/text.rb

@@ -1,14 +0,0 @@
-module Textus
-  module Builder
-    class Renderer
-      class Text < Renderer
-        def call(mentry:, data:)
-          raise TemplateError.new("entry '#{mentry.key}': text build requires a template") unless mentry.template
-
-          body = Mustache.render(@template_loader.call(mentry.template), data)
-          Entry.for_format("text").serialize(meta: {}, body: body)
-        end
-      end
-    end
-  end
-end

data/lib/textus/builder/renderer/yaml.rb

@@ -1,45 +0,0 @@
-require "yaml"
-
-module Textus
-  module Builder
-    class Renderer
-      class Yaml < Renderer
-        def call(mentry:, data:)
-          content = mentry.template ? parse_rendered_template!(mentry, data) : default_shape(mentry, data)
-          final = InjectMeta.call(content, mentry)
-          Entry.for_format("yaml").serialize(meta: {}, body: "", content: final)
-        end
-
-        private
-
-        def parse_rendered_template!(mentry, data)
-          rendered = Mustache.render(@template_loader.call(mentry.template), data)
-          begin
-            parsed = ::YAML.safe_load(rendered, permitted_classes: [Date, Time], aliases: false)
-          rescue Psych::SyntaxError, Psych::DisallowedClass, Psych::AliasesNotEnabled => e
-            raise BadRender.new("entry '#{mentry.key}': template did not render valid yaml: #{e.message}", format: "yaml")
-          end
-          unless parsed.is_a?(Hash)
-            raise BadRender.new("entry '#{mentry.key}': template must render a top-level object/mapping",
-                                format: "yaml")
-          end
-
-          parsed
-        end
-
-        def default_shape(mentry, data)
-          has_transform = mentry.is_a?(Textus::Manifest::Entry::Derived) &&
-                          mentry.source.is_a?(Textus::Manifest::Entry::Derived::Projection) &&
-                          mentry.source.transform
-          if has_transform && data.is_a?(Hash) && !data.key?("entries")
-            data
-          elsif data.is_a?(Hash) && data["entries"].is_a?(Array)
-            { "entries" => data["entries"] }
-          else
-            data.is_a?(Hash) ? data : { "entries" => Array(data) }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/textus/builder/renderer.rb

@@ -1,17 +0,0 @@
-module Textus
-  module Builder
-    # Abstract base for output renderers. Each concrete renderer owns
-    # producing the bytes for one manifest format (markdown/json/yaml/text).
-    class Renderer
-      def initialize(template_loader:)
-        @template_loader = template_loader
-      end
-
-      def call(mentry:, data:)
-        _ = mentry
-        _ = data
-        raise NotImplementedError.new("#{self.class.name}#call not implemented")
-      end
-    end
-  end
-end

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

@@ -1,14 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Boot < Verb
-        command_name "boot"
-        option :lean, "--lean"
-
-        def call(store)
-          emit(store.boot(lean: !!lean))
-        end
-      end
-    end
-  end
-end

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

@@ -1,15 +0,0 @@
-module Textus
-  class CLI
-    class Verb
-      class Build < Runner::Base
-        self.spec = Textus::Write::Build.contract
-
-        option :prefix, "--prefix=K"
-
-        def invoke(store)
-          emit(store.as(resolved_role(store)).build(prefix: prefix))
-        end
-      end
-    end
-  end
-end

data/lib/textus/doctor/check/fetch_locks.rb

@@ -1,49 +0,0 @@
-module Textus
-  module Doctor
-    class Check
-      # Lists per-key fetch lock files under <root>/.run/locks/ whose
-      # recorded PID is no longer running. These are forensic artifacts only:
-      # Fetch::Lock uses flock(2), which the kernel releases on process
-      # death, so stale files do not block subsequent acquires. The check
-      # exists to let users clean up clutter and notice unexpected accumulation
-      # (e.g. a fetch path that crashes repeatedly).
-      class FetchLocks < Check
-        def call
-          dir = Textus::Layout.locks(root)
-          return [] unless File.directory?(dir)
-
-          Dir.glob(File.join(dir, "*.lock")).filter_map { |path| inspect_lock(path) }
-        end
-
-        private
-
-        def inspect_lock(path)
-          pid = File.read(path).strip.to_i
-          return nil if pid.zero?
-          return nil if pid_alive?(pid)
-
-          {
-            "code" => "fetch_lock.stale",
-            "level" => "info",
-            "subject" => path,
-            "message" => "fetch lock file at #{path} records dead PID #{pid} " \
-                         "(does not block fetch; flock is kernel-released on exit)",
-            "fix" => "safe to delete: rm #{path}",
-          }
-        rescue Errno::ENOENT
-          nil
-        end
-
-        def pid_alive?(pid)
-          Process.kill(0, pid)
-          true
-        rescue Errno::ESRCH
-          false
-        rescue Errno::EPERM
-          # Process exists but owned by another user — treat as alive.
-          true
-        end
-      end
-    end
-  end
-end

data/lib/textus/doctor/check/lifecycle_action_invalid.rb

@@ -1,39 +0,0 @@
-module Textus
-  module Doctor
-    class Check
-      # ADR 0079: refresh is valid only for intake entries; drop/archive are
-      # invalid for intake entries (they would re-fetch, not prune).
-      class LifecycleActionInvalid < Check
-        def call
-          manifest.data.entries.filter_map do |mentry|
-            policy = manifest.rules.for(mentry.key).lifecycle
-            next if policy.nil?
-
-            intake = mentry.is_a?(Textus::Manifest::Entry::Intake)
-            bad = (policy.on_expire == :refresh && !intake) || (policy.destructive? && intake)
-            next unless bad
-
-            issue_for(mentry, policy, intake)
-          end
-        end
-
-        private
-
-        def issue_for(mentry, policy, intake)
-          {
-            "code" => "lifecycle.action_invalid",
-            "level" => "error",
-            "subject" => mentry.key,
-            "message" => "on_expire: #{policy.on_expire} is not valid for a " \
-                         "#{intake ? "intake" : "stored"} entry",
-            "fix" => if intake
-                       "use on_expire: refresh|warn for intake entries"
-                     else
-                       "use on_expire: drop|archive|warn for stored entries"
-                     end,
-          }
-        end
-      end
-    end
-  end
-end

data/lib/textus/domain/freshness/policy.rb

@@ -1,18 +0,0 @@
-module Textus
-  module Domain
-    class Freshness
-      Policy = Data.define(:ttl_seconds, :on_stale, :sync_budget_ms) do
-        def decide(verdict)
-          return Action::Return.new if verdict.fresh?
-
-          case on_stale
-          when :warn       then Action::Return.new
-          when :sync       then Action::FetchSync.new
-          when :timed_sync then Action::FetchTimed.new(budget_ms: sync_budget_ms)
-          else                  Action::Return.new
-          end
-        end
-      end
-    end
-  end
-end

data/lib/textus/domain/lifecycle.rb

@@ -1,83 +0,0 @@
-require "time"
-
-module Textus
-  module Domain
-    # Unified lifecycle reporter (ADR 0079): which entries are past their ttl,
-    # and the on_expire action that applies. Replaces both Staleness::IntakeCheck
-    # and Retention. Age basis: _meta.last_fetched_at (intake) when present, else
-    # file mtime (stored). `self.verdict` is the pure per-entry decision that BOTH
-    # this reporter and `Read::Get` (Plan 2) call, so the basis logic lives once.
-    class Lifecycle
-      # Pure: is the entry past its ttl? -> [expired(bool), reason(String|nil)].
-      def self.verdict(policy:, last_fetched_at:, mtime:, now:)
-        ttl = policy.ttl_seconds
-        return [false, nil] if ttl.nil?
-
-        basis = parse_time(last_fetched_at) || mtime
-        return [true, "never recorded"] if basis.nil?
-
-        age = (now - basis).to_i
-        age > ttl ? [true, "ttl exceeded (age=#{age}s, ttl=#{ttl}s)"] : [false, nil]
-      end
-
-      def self.parse_time(str)
-        return nil if str.nil?
-
-        Time.parse(str.to_s)
-      rescue ArgumentError, TypeError
-        nil
-      end
-
-      def initialize(manifest:, file_stat:, clock:)
-        @manifest  = manifest
-        @file_stat = file_stat
-        @clock     = clock
-      end
-
-      def call(prefix: nil, zone: nil)
-        @manifest.data.entries
-                 .select { |m| entry_matches?(m, prefix: prefix, zone: zone) }
-                 .flat_map { |m| rows_for(m) }
-      end
-
-      private
-
-      def entry_matches?(mentry, prefix:, zone:)
-        return false if zone && mentry.zone != zone
-        return false if prefix && !(mentry.key == prefix || mentry.key.start_with?("#{prefix}."))
-
-        true
-      end
-
-      def rows_for(mentry)
-        policy = @manifest.rules.for(mentry.key).lifecycle
-        return [] if policy.nil?
-
-        @manifest.resolver.enumerate(prefix: mentry.key).filter_map do |row|
-          path = row[:path]
-          next unless @file_stat.exists?(path)
-
-          expired, _reason = self.class.verdict(
-            policy: policy,
-            last_fetched_at: last_fetched_at_of(mentry, path),
-            mtime: @file_stat.mtime(path),
-            now: @clock.now,
-          )
-          next unless expired
-
-          {
-            "key" => row[:key], "path" => path,
-            "action" => policy.on_expire.to_s, "expired" => true
-          }
-        end
-      end
-
-      # Reads _meta.last_fetched_at from the on-disk envelope (intake basis).
-      def last_fetched_at_of(mentry, path)
-        Entry.for_format(mentry.format).parse(@file_stat.read(path), path: path)["_meta"]["last_fetched_at"]
-      rescue StandardError
-        nil
-      end
-    end
-  end
-end

data/lib/textus/domain/outcome.rb

@@ -1,10 +0,0 @@
-module Textus
-  module Domain
-    module Outcome
-      Skipped = Data.define
-      Fetched = Data.define(:envelope)
-      Detached  = Data.define
-      Failed    = Data.define(:error)
-    end
-  end
-end

data/lib/textus/domain/policy/lifecycle.rb

@@ -1,35 +0,0 @@
-module Textus
-  module Domain
-    module Policy
-      # Unified per-entry lifecycle policy (ADR 0079): one ttl + one action.
-      # Replaces the separate Fetch (ttl/on_stale) and Retention
-      # (expire_after/archive_after) policies. The action's destructiveness
-      # decides WHERE it runs: lazy actions (refresh/warn) on get/list reads;
-      # destructive actions (drop/archive) only on the tend sweep.
-      class Lifecycle
-        LAZY        = %i[refresh warn].freeze
-        DESTRUCTIVE = %i[drop archive].freeze
-        ALLOWED     = (LAZY + DESTRUCTIVE).freeze
-
-        attr_reader :on_expire, :budget_ms
-
-        def initialize(ttl:, on_expire:, budget_ms: nil)
-          action = on_expire.is_a?(Symbol) ? on_expire : on_expire.to_s.to_sym
-          unless ALLOWED.include?(action)
-            raise Textus::UsageError.new(
-              "lifecycle on_expire must be one of #{ALLOWED.join("|")}, got #{on_expire.inspect}",
-            )
-          end
-
-          @ttl       = ttl
-          @on_expire = action
-          @budget_ms = budget_ms
-        end
-
-        def ttl_seconds = Textus::Domain::Duration.seconds(@ttl)
-        def destructive? = DESTRUCTIVE.include?(@on_expire)
-        def lazy?        = LAZY.include?(@on_expire)
-      end
-    end
-  end
-end