textus 0.10.5 → 0.14.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.10.5
+  version: 0.14.0
 platform: ruby
 authors:
 - Patrick
@@ -112,17 +112,28 @@ files:
 - lib/textus/application/context.rb
 - lib/textus/application/reads/audit.rb
 - lib/textus/application/reads/blame.rb
+- lib/textus/application/reads/deps.rb
 - lib/textus/application/reads/freshness.rb
 - lib/textus/application/reads/get.rb
+- lib/textus/application/reads/list.rb
 - lib/textus/application/reads/policy_explain.rb
+- lib/textus/application/reads/published.rb
+- lib/textus/application/reads/rdeps.rb
+- lib/textus/application/reads/schema_envelope.rb
+- lib/textus/application/reads/stale.rb
+- lib/textus/application/reads/uid.rb
+- lib/textus/application/reads/validate_all.rb
+- lib/textus/application/reads/where.rb
 - lib/textus/application/refresh/all.rb
 - lib/textus/application/refresh/orchestrator.rb
 - lib/textus/application/refresh/worker.rb
 - lib/textus/application/writes/accept.rb
 - lib/textus/application/writes/build.rb
 - lib/textus/application/writes/delete.rb
+- lib/textus/application/writes/mv.rb
 - lib/textus/application/writes/publish.rb
 - lib/textus/application/writes/put.rb
+- lib/textus/application/writes/reject.rb
 - lib/textus/builder/pipeline.rb
 - lib/textus/builder/renderer.rb
 - lib/textus/builder/renderer/json.rb
@@ -133,7 +144,8 @@ files:
 - lib/textus/cli/group.rb
 - lib/textus/cli/group/hook.rb
 - lib/textus/cli/group/key.rb
-- lib/textus/cli/group/policy.rb
+- lib/textus/cli/group/refresh.rb
+- lib/textus/cli/group/rule.rb
 - lib/textus/cli/group/schema.rb
 - lib/textus/cli/verb.rb
 - lib/textus/cli/verb/accept.rb
@@ -149,24 +161,23 @@ files:
 - lib/textus/cli/verb/hooks.rb
 - lib/textus/cli/verb/init.rb
 - lib/textus/cli/verb/intro.rb
+- lib/textus/cli/verb/key_normalize.rb
 - lib/textus/cli/verb/list.rb
-- lib/textus/cli/verb/migrate_keys.rb
 - lib/textus/cli/verb/mv.rb
-- lib/textus/cli/verb/policy_explain.rb
-- lib/textus/cli/verb/policy_list.rb
 - lib/textus/cli/verb/published.rb
 - lib/textus/cli/verb/put.rb
 - lib/textus/cli/verb/rdeps.rb
 - lib/textus/cli/verb/refresh.rb
 - lib/textus/cli/verb/refresh_stale.rb
 - lib/textus/cli/verb/reject.rb
+- lib/textus/cli/verb/rule_explain.rb
+- lib/textus/cli/verb/rule_list.rb
 - lib/textus/cli/verb/schema.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/uid.rb
 - lib/textus/cli/verb/where.rb
-- lib/textus/composition.rb
 - lib/textus/dependencies.rb
 - lib/textus/doctor.rb
 - lib/textus/doctor/check.rb
@@ -176,7 +187,8 @@ files:
 - lib/textus/doctor/check/illegal_keys.rb
 - lib/textus/doctor/check/intake_registration.rb
 - lib/textus/doctor/check/manifest_files.rb
-- lib/textus/doctor/check/policy_ambiguity.rb
+- lib/textus/doctor/check/protocol_version.rb
+- lib/textus/doctor/check/rule_ambiguity.rb
 - lib/textus/doctor/check/schema_parse_error.rb
 - lib/textus/doctor/check/schema_violations.rb
 - lib/textus/doctor/check/schemas.rb
@@ -192,7 +204,10 @@ files:
 - lib/textus/domain/policy.rb
 - lib/textus/domain/policy/handler_allowlist.rb
 - lib/textus/domain/policy/matcher.rb
+- lib/textus/domain/policy/predicates/human_accept.rb
+- lib/textus/domain/policy/predicates/schema_valid.rb
 - lib/textus/domain/policy/promote.rb
+- lib/textus/domain/policy/promotion.rb
 - lib/textus/domain/policy/refresh.rb
 - lib/textus/entry.rb
 - lib/textus/entry/base.rb
@@ -220,18 +235,28 @@ files:
 - lib/textus/key/path.rb
 - lib/textus/manifest.rb
 - lib/textus/manifest/entry.rb
-- lib/textus/manifest/policies.rb
+- lib/textus/manifest/entry/parser.rb
+- lib/textus/manifest/entry/validators.rb
+- lib/textus/manifest/entry/validators/events.rb
+- lib/textus/manifest/entry/validators/format_matrix.rb
+- lib/textus/manifest/entry/validators/index_filename.rb
+- lib/textus/manifest/entry/validators/inject_intro.rb
+- lib/textus/manifest/entry/validators/publish_each.rb
+- lib/textus/manifest/rules.rb
+- lib/textus/manifest/schema.rb
 - lib/textus/migrate_keys.rb
 - lib/textus/mustache.rb
+- lib/textus/operations.rb
+- lib/textus/operations/reads.rb
+- lib/textus/operations/refresh.rb
+- lib/textus/operations/writes.rb
 - lib/textus/projection.rb
-- lib/textus/proposal.rb
 - lib/textus/refresh.rb
 - lib/textus/role.rb
 - lib/textus/schema.rb
 - lib/textus/schema/tools.rb
 - lib/textus/store.rb
 - lib/textus/store/audit_log.rb
-- lib/textus/store/mover.rb
 - lib/textus/store/reader.rb
 - lib/textus/store/sentinel.rb
 - lib/textus/store/staleness.rb

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

@@ -1,11 +0,0 @@
-module Textus
-  class CLI
-    class Group
-      class Policy < Group
-        self.cli_name = "policy"
-        subcommands["list"]    = Verb::PolicyList
-        subcommands["explain"] = Verb::PolicyExplain
-      end
-    end
-  end
-end

data/lib/textus/composition.rb

@@ -1,72 +0,0 @@
-module Textus
-  module Composition
-    module_function
-
-    def context(store, role:, correlation_id: nil, dry_run: false)
-      Textus::Application::Context.new(
-        store: store,
-        role: role,
-        correlation_id: correlation_id,
-        dry_run: dry_run,
-      )
-    end
-
-    def reads_get(ctx)
-      Textus::Application::Reads::Get.new(ctx: ctx, orchestrator: refresh_orchestrator(ctx))
-    end
-
-    def freshness(ctx)
-      Textus::Application::Reads::Freshness.new(ctx: ctx)
-    end
-
-    def audit(ctx)
-      Textus::Application::Reads::Audit.new(ctx: ctx)
-    end
-
-    def blame(ctx)
-      Textus::Application::Reads::Blame.new(ctx: ctx)
-    end
-
-    def policy_explain(ctx)
-      Textus::Application::Reads::PolicyExplain.new(ctx: ctx)
-    end
-
-    def refresh_worker(ctx)
-      Textus::Application::Refresh::Worker.new(ctx: ctx, bus: ctx.store.bus)
-    end
-
-    def refresh_orchestrator(ctx)
-      Textus::Application::Refresh::Orchestrator.new(
-        worker: refresh_worker(ctx),
-        bus: ctx.store.bus,
-        store_root: ctx.store.root,
-        store: ctx.store,
-        role: ctx.role,
-      )
-    end
-
-    def writes_put(ctx)
-      Textus::Application::Writes::Put.new(ctx: ctx, bus: ctx.store.bus)
-    end
-
-    def writes_delete(ctx)
-      Textus::Application::Writes::Delete.new(ctx: ctx, bus: ctx.store.bus)
-    end
-
-    def writes_build(ctx)
-      Textus::Application::Writes::Build.new(ctx: ctx, bus: ctx.store.bus)
-    end
-
-    def writes_accept(ctx)
-      Textus::Application::Writes::Accept.new(ctx: ctx, bus: ctx.store.bus)
-    end
-
-    def writes_publish(ctx)
-      Textus::Application::Writes::Publish.new(ctx: ctx, bus: ctx.store.bus)
-    end
-
-    def event_bus(ctx)
-      Textus::Infra::EventBus.new(registry: ctx.store.registry)
-    end
-  end
-end

data/lib/textus/proposal.rb

@@ -1,10 +0,0 @@
-module Textus
-  module Proposal
-    # Deprecated as of 0.9.1: use Textus::Application::Writes::Accept (via
-    # Textus::Composition.writes_accept).
-    def self.accept(store, pending_key, as:)
-      ctx = Textus::Composition.context(store, role: as)
-      Textus::Application::Writes::Accept.new(ctx: ctx, bus: store.bus).call(pending_key)
-    end
-  end
-end

data/lib/textus/store/mover.rb

@@ -1,167 +0,0 @@
-require "fileutils"
-
-module Textus
-  class Store
-    class Mover
-      MovePlan = Data.define(
-        :old_key, :new_key, :old_path, :new_path,
-        :new_mentry, :uid, :etag_before, :as
-      )
-
-      def initialize(store:, reader:, writer:, manifest:, audit_log:)
-        @store = store
-        @reader = reader
-        @writer = writer
-        @manifest = manifest
-        @audit_log = audit_log
-      end
-
-      def call(old_key, new_key, as: Role::DEFAULT, dry_run: false, correlation_id: nil)
-        plan, pre_env = prepare_plan(old_key, new_key, as: as)
-        return dry_run_result(plan) if dry_run
-
-        plan = ensure_uid!(plan, pre_env: pre_env)
-        etag_after = perform_move!(plan)
-        new_envelope = record_move(plan, etag_after: etag_after, correlation_id: correlation_id)
-        success_result(plan, new_envelope: new_envelope)
-      end
-
-      private
-
-      # Validates inputs, resolves manifest entries, and reads the source
-      # envelope. Returns [MovePlan, pre_envelope]; the pre_envelope is only
-      # needed by ensure_uid! and is threaded separately to keep MovePlan
-      # focused on the planned operation.
-      def prepare_plan(old_key, new_key, as:)
-        @manifest.validate_key!(old_key)
-        @manifest.validate_key!(new_key)
-        raise UsageError.new("mv: old and new keys are identical") if old_key == new_key
-
-        old_mentry, old_path, = @manifest.resolve(old_key)
-        raise UnknownKey.new(old_key) unless File.exist?(old_path)
-
-        new_mentry, new_path, = @manifest.resolve(new_key)
-        validate_zone_and_format!(old_mentry, new_mentry)
-        validate_writer!(old_mentry, old_key, as)
-        raise UsageError.new("mv: target '#{new_key}' already exists at #{new_path}") if File.exist?(new_path)
-
-        pre_env = @reader.get(old_key)
-        plan = MovePlan.new(
-          old_key: old_key, new_key: new_key,
-          old_path: old_path, new_path: new_path,
-          new_mentry: new_mentry,
-          uid: pre_env["uid"], etag_before: pre_env["etag"], as: as
-        )
-        [plan, pre_env]
-      end
-
-      def validate_zone_and_format!(old_mentry, new_mentry)
-        if old_mentry.zone != new_mentry.zone
-          raise UsageError.new(
-            "mv: cross-zone move refused (#{old_mentry.zone} → #{new_mentry.zone}). " \
-            "Use put+delete for cross-zone moves.",
-          )
-        end
-        return if old_mentry.format == new_mentry.format
-
-        raise UsageError.new(
-          "mv: format mismatch (#{old_mentry.format} → #{new_mentry.format}); refusing.",
-        )
-      end
-
-      def validate_writer!(mentry, key, as)
-        writers = @manifest.zone_writers(mentry.zone)
-        return if writers.include?(as)
-
-        raise WriteForbidden.new(key, mentry.zone, writers: writers)
-      end
-
-      def ensure_uid!(plan, pre_env:)
-        return plan if plan.uid
-
-        env = @writer.put(
-          plan.old_key,
-          meta: pre_env["_meta"],
-          body: pre_env["body"],
-          content: pre_env["content"],
-          as: plan.as,
-          suppress_events: true,
-        )
-        plan.with(uid: env["uid"], etag_before: env["etag"])
-      end
-
-      def perform_move!(plan)
-        FileUtils.mkdir_p(File.dirname(plan.new_path))
-        FileUtils.mv(plan.old_path, plan.new_path)
-        rewrite_name_for_mv!(plan.new_mentry, plan.new_path, plan.new_key)
-        Etag.for_file(plan.new_path)
-      end
-
-      def record_move(plan, etag_after:, correlation_id:)
-        extras = {
-          "from_key" => plan.old_key, "to_key" => plan.new_key,
-          "from_path" => plan.old_path, "to_path" => plan.new_path,
-          "uid" => plan.uid
-        }
-        extras["correlation_id"] = correlation_id if correlation_id
-
-        @audit_log.append(
-          role: plan.as, verb: "mv", key: plan.new_key,
-          etag_before: plan.etag_before, etag_after: etag_after,
-          extras: extras
-        )
-        new_envelope = @reader.get(plan.new_key)
-        @store.fire_event(
-          :mv,
-          key: plan.new_key, from_key: plan.old_key, to_key: plan.new_key,
-          envelope: new_envelope
-        )
-        new_envelope
-      end
-
-      def dry_run_result(plan)
-        {
-          "protocol" => PROTOCOL, "ok" => true, "dry_run" => true,
-          "from_key" => plan.old_key, "to_key" => plan.new_key,
-          "from_path" => plan.old_path, "to_path" => plan.new_path,
-          "uid" => plan.uid
-        }
-      end
-
-      def success_result(plan, new_envelope:)
-        {
-          "protocol" => PROTOCOL, "ok" => true,
-          "from_key" => plan.old_key, "to_key" => plan.new_key,
-          "from_path" => plan.old_path, "to_path" => plan.new_path,
-          "uid" => plan.uid,
-          "envelope" => new_envelope
-        }
-      end
-
-      # If the moved file carries a `name:` field (markdown) or `_meta.name`
-      # (json/yaml), rewrite it to the new basename so enforce_name_match! stays
-      # happy on the next read. Only touches the bytes when name actually changes.
-      def rewrite_name_for_mv!(mentry, new_path, new_key)
-        strategy = Entry.for_format(mentry.format)
-        raw = File.binread(new_path)
-        parsed = strategy.parse(raw, path: new_path)
-        basename = new_key.split(".").last
-
-        case mentry.format
-        when "markdown"
-          meta = parsed["_meta"] || {}
-          return unless meta.is_a?(Hash) && meta["name"].is_a?(String) && meta["name"] != basename
-
-          meta = meta.merge("name" => basename)
-          File.binwrite(new_path, strategy.serialize(meta: meta, body: parsed["body"]))
-        when "json", "yaml"
-          meta = parsed["_meta"]
-          return unless meta.is_a?(Hash) && meta["name"].is_a?(String) && meta["name"] != basename
-
-          new_meta = meta.merge("name" => basename)
-          File.binwrite(new_path, strategy.serialize(meta: new_meta, body: "", content: parsed["content"]))
-        end
-      end
-    end
-  end
-end