textus 0.20.2 → 0.22.0

data/lib/textus/manifest/entry.rb

@@ -5,6 +5,9 @@ module Textus
       # constants on Entry. Canonical source is the PublishEach validator.
       PUBLISH_EACH_VARS = Validators::PublishEach::KNOWN_VARS
       PUBLISH_EACH_VAR_RE = Validators::PublishEach::VAR_RE
+
+      # Populated by each Entry::* subclass at load time.
+      REGISTRY = {}
     end
   end
 end

data/lib/textus/manifest/resolver.rb

@@ -42,7 +42,7 @@ module Textus
       # entry with nested: true in the raw YAML — e.g. Intake entries covering
       # a directory of leaf files).
       def nested_entry?(entry)
-        entry.is_a?(Textus::Manifest::Entry::Nested) || entry.raw["nested"] == true
+        entry.nested?
       end
 
       def build_resolution(entry, remaining, key)
@@ -51,7 +51,7 @@ module Textus
         else
           raise UnknownKey.new(key, suggestions: suggestions_for(key)) unless nested_entry?(entry)
 
-          index_fn = entry.respond_to?(:index_filename) ? entry.index_filename : nil
+          index_fn = entry.index_filename
           path = if index_fn
                    File.join(@manifest.root, "zones", entry.path, *remaining, index_fn)
                  else
@@ -71,14 +71,14 @@ module Textus
         base = File.join(@manifest.root, "zones", entry.path)
         return [] unless File.directory?(base)
 
-        entry_index_filename = entry.respond_to?(:index_filename) ? entry.index_filename : nil
+        entry_index_filename = entry.index_filename
         glob_pattern = entry_index_filename ? "**/#{entry_index_filename}" : nested_glob(entry.format)
         Dir.glob(File.join(base, glob_pattern)).filter_map { |path| nested_row_for(entry, base, path) }
       end
 
       def nested_row_for(entry, base, path)
         rel = path.sub(%r{\A#{Regexp.escape(base)}/?}, "")
-        entry_if = entry.respond_to?(:index_filename) ? entry.index_filename : nil
+        entry_if = entry.index_filename
         stripped = entry_if ? File.dirname(rel) : rel.sub(/#{Regexp.escape(File.extname(rel))}\z/, "")
         segs = stripped.split("/").reject { |s| s.empty? || s == "." }
         return nil if segs.empty?

data/lib/textus/manifest/schema.rb

@@ -1,14 +1,14 @@
 module Textus
   class Manifest
     module Schema
-      ROOT_KEYS    = %w[version roles zones entries rules].freeze
+      ROOT_KEYS    = %w[version roles zones entries rules audit].freeze
       ROLE_KEYS    = %w[name kind].freeze
       ROLE_KINDS   = %w[accept_authority generator proposer runner].freeze
       ZONE_KEYS    = %w[name write_policy read_policy].freeze
       ENTRY_KEYS   = %w[
         key path zone kind schema owner nested format
         compute template publish_to publish_each
-        intake events inject_intro index_filename
+        intake events inject_boot index_filename
       ].freeze
       COMPUTE_KEYS = %w[kind select pluck sort_by limit transform command sources].freeze
       INTAKE_KEYS  = %w[handler config].freeze
@@ -16,22 +16,37 @@ module Textus
       REFRESH_KEYS = %w[ttl on_stale sync_budget_ms fetch_timeout_seconds].freeze
       FETCH_TIMEOUT_SECONDS_CEILING = 3600
       PROMOTION_KEYS = %w[requires].freeze
+      AUDIT_KEYS     = %w[max_size keep].freeze
 
       def self.validate!(raw)
         raise BadManifest.new("manifest must be a hash") unless raw.is_a?(Hash)
 
         walk(raw, ROOT_KEYS, "$")
         validate_roles!(raw["roles"])
-        Array(raw["zones"]).each_with_index do |z, i|
+        validate_zones!(raw["zones"])
+        validate_entries!(raw["entries"])
+        validate_rules!(raw["rules"])
+        walk(raw["audit"], AUDIT_KEYS, "$.audit") if raw["audit"].is_a?(Hash)
+        validate_zone_writers_declared!(raw)
+      end
+
+      def self.validate_zones!(zones)
+        Array(zones).each_with_index do |z, i|
           walk(z, ZONE_KEYS, "$.zones[#{i}]")
         end
-        Array(raw["entries"]).each_with_index do |e, i|
+      end
+
+      def self.validate_entries!(entries)
+        Array(entries).each_with_index do |e, i|
           path = "$.entries[#{i}]"
           walk(e, ENTRY_KEYS, path)
           walk(e["compute"], COMPUTE_KEYS, "#{path}.compute") if e["compute"].is_a?(Hash)
           walk(e["intake"], INTAKE_KEYS, "#{path}.intake") if e["intake"].is_a?(Hash)
         end
-        Array(raw["rules"]).each_with_index do |r, i|
+      end
+
+      def self.validate_rules!(rules)
+        Array(rules).each_with_index do |r, i|
           path = "$.rules[#{i}]"
           walk(r, RULE_KEYS, path)
           if r["refresh"].is_a?(Hash)
@@ -40,7 +55,6 @@ module Textus
           end
           walk(r["promotion"], PROMOTION_KEYS, "#{path}.promotion") if r["promotion"].is_a?(Hash)
         end
-        validate_zone_writers_declared!(raw)
       end
 
       def self.validate_zone_writers_declared!(raw)

data/lib/textus/manifest.rb

@@ -30,6 +30,16 @@ module Textus
       )
     end
 
+    AUDIT_DEFAULTS = { max_size: 10_485_760, keep: 5 }.freeze
+
+    def audit_config
+      raw = @raw["audit"] || {}
+      {
+        max_size: raw["max_size"] || AUDIT_DEFAULTS[:max_size],
+        keep: raw["keep"] || AUDIT_DEFAULTS[:keep],
+      }
+    end
+
     def role_mapping
       @role_mapping ||= RoleKinds.resolve(@raw["roles"])
     end

data/lib/textus/operations.rb

@@ -115,11 +115,18 @@ module Textus
     def rdeps(...)           = Application::Reads::Rdeps.new(manifest: @manifest).call(...)
     def published(...)       = Application::Reads::Published.new(manifest: @manifest).call(...)
     def stale(...)           = Application::Reads::Stale.new(manifest: @manifest).call(...)
-    def audit(...)           = Application::Reads::Audit.new(manifest: @manifest, root: @root).call(...)
+    def audit(...)           = Application::Reads::Audit.new(manifest: @manifest, root: @root, audit_log: @audit_log).call(...)
     def blame(...)           = Application::Reads::Blame.new(manifest: @manifest, root: @root).call(...)
     def policy_explain(...)  = Application::Reads::PolicyExplain.new(manifest: @manifest).call(...)
     def freshness(...)       = Application::Reads::Freshness.new(ctx: @ctx, manifest: @manifest, file_store: @file_store).call(...)
 
+    def pulse(...)
+      Application::Reads::Pulse.new(
+        ctx: @ctx, manifest: @manifest, file_store: @file_store,
+        audit_log: @audit_log, root: @root, store: @store
+      ).call(...)
+    end
+
     def validate_all(...)
       Application::Reads::ValidateAll.new(
         ctx: @ctx, manifest: @manifest, file_store: @file_store, schemas: @schemas, audit_log: @audit_log,

data/lib/textus/store.rb

@@ -33,7 +33,11 @@ module Textus
       @manifest   = Manifest.load(@root)
       @schemas    = Schemas.new(File.join(@root, "schemas"))
       @file_store = Infra::Storage::FileStore.new
-      @audit_log  = Infra::AuditLog.new(@root)
+      @audit_log  = Infra::AuditLog.new(
+        @root,
+        max_size: @manifest.audit_config[:max_size],
+        keep: @manifest.audit_config[:keep],
+      )
       @bus = Hooks::Bus.new
       Infra::AuditSubscriber.new(@audit_log).attach(@bus)
       Hooks::Builtin.register_all(@bus)

data/lib/textus/version.rb

@@ -1,4 +1,4 @@
 module Textus
-  VERSION = "0.20.2"
+  VERSION = "0.22.0"
   PROTOCOL = "textus/3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.20.2
+  version: 0.22.0
 platform: ruby
 authors:
 - Patrick
@@ -123,6 +123,7 @@ files:
 - lib/textus/application/reads/list.rb
 - lib/textus/application/reads/policy_explain.rb
 - lib/textus/application/reads/published.rb
+- lib/textus/application/reads/pulse.rb
 - lib/textus/application/reads/rdeps.rb
 - lib/textus/application/reads/schema_envelope.rb
 - lib/textus/application/reads/stale.rb
@@ -142,6 +143,7 @@ files:
 - lib/textus/application/writes/publish.rb
 - lib/textus/application/writes/put.rb
 - lib/textus/application/writes/reject.rb
+- lib/textus/boot.rb
 - lib/textus/builder/pipeline.rb
 - lib/textus/builder/renderer.rb
 - lib/textus/builder/renderer/json.rb
@@ -159,6 +161,7 @@ files:
 - lib/textus/cli/verb/accept.rb
 - lib/textus/cli/verb/audit.rb
 - lib/textus/cli/verb/blame.rb
+- lib/textus/cli/verb/boot.rb
 - lib/textus/cli/verb/build.rb
 - lib/textus/cli/verb/delete.rb
 - lib/textus/cli/verb/deps.rb
@@ -168,10 +171,10 @@ files:
 - lib/textus/cli/verb/hook_run.rb
 - lib/textus/cli/verb/hooks.rb
 - lib/textus/cli/verb/init.rb
-- lib/textus/cli/verb/intro.rb
 - lib/textus/cli/verb/list.rb
 - lib/textus/cli/verb/mv.rb
 - lib/textus/cli/verb/published.rb
+- lib/textus/cli/verb/pulse.rb
 - lib/textus/cli/verb/put.rb
 - lib/textus/cli/verb/rdeps.rb
 - lib/textus/cli/verb/refresh.rb
@@ -242,7 +245,6 @@ files:
 - lib/textus/infra/refresh/lock.rb
 - lib/textus/infra/storage/file_store.rb
 - lib/textus/init.rb
-- lib/textus/intro.rb
 - lib/textus/key/distance.rb
 - lib/textus/key/grammar.rb
 - lib/textus/key/path.rb
@@ -258,7 +260,7 @@ files:
 - 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/inject_boot.rb
 - lib/textus/manifest/entry/validators/publish_each.rb
 - lib/textus/manifest/resolver.rb
 - lib/textus/manifest/role_kinds.rb

data/lib/textus/manifest/entry/validators/inject_intro.rb

@@ -1,21 +0,0 @@
-module Textus
-  class Manifest
-    class Entry
-      module Validators
-        module InjectIntro
-          def self.call(entry)
-            inject_intro = entry.respond_to?(:inject_intro) ? entry.inject_intro : false
-            return unless inject_intro
-
-            raise UsageError.new("entry '#{entry.key}': inject_intro: is only valid on derived entries") unless entry.in_generator_zone?
-
-            has_template = entry.respond_to?(:template) && !entry.template.nil?
-            return if has_template
-
-            raise UsageError.new("entry '#{entry.key}': inject_intro: requires a template:")
-          end
-        end
-      end
-    end
-  end
-end