textus 0.29.0 → 0.30.0

data/lib/textus/write/retention_sweep.rb

@@ -0,0 +1,55 @@
+require "fileutils"
+
+module Textus
+  module Write
+    # Applies retention actions reported by Read::Retainable. `expire` deletes
+    # the leaf through the role gate; `archive` copies it to
+    # <root>/archive/<relative-path> first, then deletes. Rows whose zone the
+    # caller's role cannot write surface in `failed` rather than aborting.
+    class RetentionSweep
+      def initialize(container:, call:)
+        @container = container
+        @call      = call
+      end
+
+      def call(prefix: nil, zone: nil)
+        rows = Textus::Read::Retainable.new(container: @container, call: @call)
+                                       .call(prefix: prefix, zone: zone)
+        delete_op = Textus::Write::Delete.new(container: @container, call: @call)
+        expired   = []
+        archived  = []
+        failed    = []
+
+        rows.each do |row|
+          key = row["key"]
+          begin
+            archive_leaf(row) if row["action"] == "archive"
+            delete_op.call(key)
+            (row["action"] == "archive" ? archived : expired) << key
+          rescue Textus::Error => e
+            failed << { "key" => key, "error" => e.message }
+          end
+        end
+
+        {
+          "protocol" => Textus::PROTOCOL,
+          "ok" => failed.empty?,
+          "expired" => expired,
+          "archived" => archived,
+          "failed" => failed,
+        }
+      end
+
+      private
+
+      def archive_leaf(row)
+        src  = row["path"]
+        root = @container.root.to_s
+        rel  = src.delete_prefix("#{root}/")
+        dest = File.join(root, "archive", rel)
+        FileUtils.mkdir_p(File.dirname(dest))
+        FileUtils.cp(src, dest)
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Patrick
@@ -152,6 +152,7 @@ files:
 - lib/textus/cli/verb/refresh.rb
 - lib/textus/cli/verb/refresh_stale.rb
 - lib/textus/cli/verb/reject.rb
+- lib/textus/cli/verb/retain.rb
 - lib/textus/cli/verb/rule_explain.rb
 - lib/textus/cli/verb/rule_lint.rb
 - lib/textus/cli/verb/rule_list.rb
@@ -183,6 +184,7 @@ files:
 - lib/textus/doctor/check/unowned_schema_fields.rb
 - lib/textus/domain/action.rb
 - lib/textus/domain/authorizer.rb
+- lib/textus/domain/duration.rb
 - lib/textus/domain/freshness.rb
 - lib/textus/domain/freshness/evaluator.rb
 - lib/textus/domain/freshness/policy.rb
@@ -196,6 +198,8 @@ files:
 - lib/textus/domain/policy/promote.rb
 - lib/textus/domain/policy/promotion.rb
 - lib/textus/domain/policy/refresh.rb
+- lib/textus/domain/policy/retention.rb
+- lib/textus/domain/retention.rb
 - lib/textus/domain/sentinel.rb
 - lib/textus/domain/staleness.rb
 - lib/textus/domain/staleness/generator_check.rb
@@ -218,6 +222,7 @@ files:
 - lib/textus/hooks/fire_report.rb
 - lib/textus/hooks/loader.rb
 - lib/textus/hooks/rpc_registry.rb
+- lib/textus/hooks/signature.rb
 - lib/textus/init.rb
 - lib/textus/key/distance.rb
 - lib/textus/key/grammar.rb
@@ -279,6 +284,7 @@ files:
 - lib/textus/read/published.rb
 - lib/textus/read/pulse.rb
 - lib/textus/read/rdeps.rb
+- lib/textus/read/retainable.rb
 - lib/textus/read/schema_envelope.rb
 - lib/textus/read/stale.rb
 - lib/textus/read/uid.rb
@@ -296,6 +302,7 @@ files:
 - lib/textus/write/accept.rb
 - lib/textus/write/authority_gate.rb
 - lib/textus/write/delete.rb
+- lib/textus/write/intake_fetch.rb
 - lib/textus/write/materializer.rb
 - lib/textus/write/mv.rb
 - lib/textus/write/publish.rb
@@ -304,6 +311,7 @@ files:
 - lib/textus/write/refresh_orchestrator.rb
 - lib/textus/write/refresh_worker.rb
 - lib/textus/write/reject.rb
+- lib/textus/write/retention_sweep.rb
 homepage: https://github.com/patrick204nqh/textus
 licenses:
 - MIT