textus 0.4.0 → 0.8.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Patrick
@@ -51,6 +51,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -95,25 +109,75 @@ files:
 - docs/conventions.md
 - exe/textus
 - lib/textus.rb
-- lib/textus/audit_log.rb
 - lib/textus/builder.rb
-- lib/textus/builtin_actions.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/cli.rb
+- lib/textus/cli/group.rb
+- lib/textus/cli/group/hook.rb
+- lib/textus/cli/group/key.rb
+- lib/textus/cli/group/schema.rb
+- lib/textus/cli/verb.rb
+- lib/textus/cli/verb/accept.rb
+- lib/textus/cli/verb/build.rb
+- lib/textus/cli/verb/delete.rb
+- lib/textus/cli/verb/deps.rb
+- lib/textus/cli/verb/doctor.rb
+- lib/textus/cli/verb/get.rb
+- 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/migrate_keys.rb
+- lib/textus/cli/verb/mv.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/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/stale.rb
+- lib/textus/cli/verb/uid.rb
+- lib/textus/cli/verb/where.rb
 - lib/textus/dependencies.rb
 - lib/textus/doctor.rb
+- lib/textus/doctor/check.rb
+- lib/textus/doctor/check/audit_log.rb
+- lib/textus/doctor/check/hooks.rb
+- lib/textus/doctor/check/illegal_keys.rb
+- lib/textus/doctor/check/manifest_files.rb
+- lib/textus/doctor/check/schema_violations.rb
+- lib/textus/doctor/check/schemas.rb
+- lib/textus/doctor/check/sentinels.rb
+- lib/textus/doctor/check/templates.rb
+- lib/textus/doctor/check/unowned_schema_fields.rb
 - lib/textus/entry.rb
+- lib/textus/entry/base.rb
 - lib/textus/entry/json.rb
 - lib/textus/entry/markdown.rb
 - lib/textus/entry/text.rb
 - lib/textus/entry/yaml.rb
+- lib/textus/envelope.rb
 - lib/textus/errors.rb
 - lib/textus/etag.rb
-- lib/textus/extension_registry.rb
-- lib/textus/extensions.rb
+- lib/textus/hooks/builtin.rb
+- lib/textus/hooks/dispatcher.rb
+- lib/textus/hooks/loader.rb
+- lib/textus/hooks/registry.rb
 - lib/textus/init.rb
 - lib/textus/intro.rb
-- lib/textus/key_distance.rb
+- lib/textus/key/distance.rb
+- lib/textus/key/grammar.rb
+- lib/textus/key/path.rb
 - lib/textus/manifest.rb
+- lib/textus/manifest/entry.rb
 - lib/textus/migrate_keys.rb
 - lib/textus/mustache.rb
 - lib/textus/projection.rb
@@ -122,9 +186,15 @@ files:
 - lib/textus/refresh.rb
 - lib/textus/role.rb
 - lib/textus/schema.rb
-- lib/textus/schema_tools.rb
+- lib/textus/schema/tools.rb
 - lib/textus/store.rb
-- lib/textus/store_view.rb
+- lib/textus/store/audit_log.rb
+- lib/textus/store/mover.rb
+- lib/textus/store/reader.rb
+- lib/textus/store/staleness.rb
+- lib/textus/store/validator.rb
+- lib/textus/store/view.rb
+- lib/textus/store/writer.rb
 - lib/textus/version.rb
 homepage: https://github.com/patrick204nqh/textus
 licenses:

data/lib/textus/audit_log.rb

@@ -1,32 +0,0 @@
-require "json"
-require "time"
-
-module Textus
-  class AuditLog
-    def initialize(root)
-      @path = File.join(root, "audit.log")
-    end
-
-    def last_writer_for(key)
-      return nil unless File.exist?(@path)
-
-      File.foreach(@path).map { |l| l.chomp.split("\t") }
-                         .select { |row| row[3] == key && %w[put delete].include?(row[2]) }
-                         .last&.fetch(1)
-    end
-
-    def append(role:, verb:, key:, etag_before:, etag_after:, extras: nil)
-      fields = [
-        Time.now.utc.iso8601, role, verb, key,
-        etag_before || "NULL",
-        etag_after  || "NULL"
-      ]
-      fields << JSON.generate(extras) if extras && !extras.empty?
-      line = fields.join("\t") + "\n"
-      File.open(@path, File::WRONLY | File::APPEND | File::CREAT, 0o644) do |f|
-        f.flock(File::LOCK_EX)
-        f.write(line)
-      end
-    end
-  end
-end

data/lib/textus/builtin_actions.rb

@@ -1,68 +0,0 @@
-require "json"
-require "csv"
-require "yaml"
-require "rexml/document"
-
-module Textus
-  module BuiltinActions
-    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-    def self.register_all
-      Textus.action(:json) do |config:, store:, args:|
-        _ = store
-        _ = args
-        data = JSON.parse(config["bytes"].to_s)
-        { frontmatter: {}, body: YAML.dump(data) }
-      end
-
-      Textus.action(:csv) do |config:, store:, args:|
-        _ = store
-        _ = args
-        rows = CSV.parse(config["bytes"].to_s, headers: true).map(&:to_h)
-        { frontmatter: {}, body: YAML.dump(rows) }
-      end
-
-      Textus.action(:"markdown-links") do |config:, store:, args:|
-        _ = store
-        _ = args
-        links = config["bytes"].to_s.scan(%r{\[([^\]]+)\]\((https?://[^)\s]+)\)}).map do |text, href|
-          { "text" => text, "href" => href }
-        end
-        { frontmatter: {}, body: YAML.dump(links) }
-      end
-
-      Textus.action(:"ical-events") do |config:, store:, args:|
-        _ = store
-        _ = args
-        events = []
-        current = nil
-        config["bytes"].to_s.each_line do |line|
-          line = line.strip
-          case line
-          when "BEGIN:VEVENT" then current = {}
-          when "END:VEVENT"
-            events << current if current
-            current = nil
-          when /\A(SUMMARY|DTSTART|DTEND|UID|LOCATION|DESCRIPTION):(.*)\z/
-            current[Regexp.last_match(1).downcase] = Regexp.last_match(2) if current
-          end
-        end
-        { frontmatter: {}, body: YAML.dump(events) }
-      end
-
-      Textus.action(:rss) do |config:, store:, args:|
-        _ = store
-        _ = args
-        doc = REXML::Document.new(config["bytes"].to_s)
-        items = doc.elements.to_a("//item").map do |item|
-          {
-            "title" => item.elements["title"]&.text,
-            "link" => item.elements["link"]&.text,
-            "pubDate" => item.elements["pubDate"]&.text,
-          }
-        end
-        { frontmatter: {}, body: YAML.dump(items) }
-      end
-    end
-    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
-  end
-end

data/lib/textus/extension_registry.rb

@@ -1,61 +0,0 @@
-module Textus
-  class ExtensionRegistry
-    EVENTS = %i[put delete refresh build accept].freeze
-
-    def initialize
-      @actions = {}
-      @reducers = {}
-      @hooks = {}
-      @doctor_checks = {}
-    end
-
-    def register_action(name, &blk)
-      name = name.to_sym
-      raise UsageError.new("action '#{name}' already registered") if @actions.key?(name)
-
-      @actions[name] = blk
-    end
-
-    def register_reducer(name, &blk)
-      name = name.to_sym
-      raise UsageError.new("reducer '#{name}' already registered") if @reducers.key?(name)
-
-      @reducers[name] = blk
-    end
-
-    def register_hook(event, name, &blk)
-      event = event.to_sym
-      raise UsageError.new("unknown event: #{event}") unless EVENTS.include?(event)
-
-      (@hooks[event] ||= []) << { name: name.to_sym, callable: blk }
-    end
-
-    def register_doctor_check(name, &blk)
-      name = name.to_sym
-      raise UsageError.new("doctor_check '#{name}' already registered") if @doctor_checks.key?(name)
-
-      @doctor_checks[name] = blk
-    end
-
-    def action(name)
-      @actions[name.to_sym] or raise UsageError.new("unknown action: #{name}")
-    end
-
-    def reducer(name)
-      @reducers[name.to_sym] or raise UsageError.new("unknown reducer: #{name}")
-    end
-
-    def hooks(event)
-      @hooks[event.to_sym] || []
-    end
-
-    def doctor_check(name)
-      @doctor_checks[name.to_sym] or raise UsageError.new("unknown doctor_check: #{name}")
-    end
-
-    def action_names        = @actions.keys
-    def reducer_names       = @reducers.keys
-    def hook_events         = @hooks.keys
-    def doctor_check_names  = @doctor_checks.keys
-  end
-end

data/lib/textus/extensions.rb

@@ -1,33 +0,0 @@
-module Textus
-  THREAD_REGISTRY_KEY = :__textus_active_registry__
-  private_constant :THREAD_REGISTRY_KEY
-
-  def self.with_registry(registry)
-    prev = Thread.current[THREAD_REGISTRY_KEY]
-    Thread.current[THREAD_REGISTRY_KEY] = registry
-    yield
-  ensure
-    Thread.current[THREAD_REGISTRY_KEY] = prev
-  end
-
-  def self.current_registry
-    Thread.current[THREAD_REGISTRY_KEY] or
-      raise UsageError.new("no active registry; extension code must be loaded by a Store")
-  end
-
-  def self.action(name, &)
-    current_registry.register_action(name, &)
-  end
-
-  def self.reducer(name, &)
-    current_registry.register_reducer(name, &)
-  end
-
-  def self.hook(event, name, &)
-    current_registry.register_hook(event, name, &)
-  end
-
-  def self.doctor_check(name, &)
-    current_registry.register_doctor_check(name, &)
-  end
-end

data/lib/textus/key_distance.rb

@@ -1,53 +0,0 @@
-module Textus
-  # Small utilities for ranking key suggestions. Bounded inputs only —
-  # Levenshtein is O(n*m) so we refuse to compute on long strings.
-  module KeyDistance
-    MAX_LEN = 200
-
-    # Length of the shared dot-separated prefix between two dotted keys.
-    def self.shared_prefix_segments(left, right)
-      asegs = left.split(".")
-      bsegs = right.split(".")
-      n = [asegs.length, bsegs.length].min
-      i = 0
-      i += 1 while i < n && asegs[i] == bsegs[i]
-      i
-    end
-
-    # Classic iterative Levenshtein with two rows. Bounded to MAX_LEN.
-    def self.levenshtein(left, right)
-      return nil if left.length > MAX_LEN || right.length > MAX_LEN
-      return right.length if left.empty?
-      return left.length if right.empty?
-
-      prev = (0..right.length).to_a
-      curr = Array.new(right.length + 1, 0)
-      (1..left.length).each do |i|
-        curr[0] = i
-        (1..right.length).each do |j|
-          cost = left[i - 1] == right[j - 1] ? 0 : 1
-          curr[j] = [
-            curr[j - 1] + 1,      # insertion
-            prev[j] + 1,          # deletion
-            prev[j - 1] + cost,   # substitution
-          ].min
-        end
-        prev, curr = curr, prev
-      end
-      prev[right.length]
-    end
-
-    # Rank candidate keys against requested. Returns up to `limit` keys.
-    # Sort: longer shared prefix first; then smaller Levenshtein distance.
-    def self.suggest(requested, candidates, limit: 5)
-      return [] if requested.nil? || requested.empty?
-
-      scored = candidates.first(200).map do |k|
-        prefix = shared_prefix_segments(requested, k)
-        dist = levenshtein(requested, k) || Float::INFINITY
-        [k, prefix, dist]
-      end
-      scored.sort_by { |(_, prefix, dist)| [-prefix, dist] }.first(limit).map(&:first)
-    end
-  end
-end

data/lib/textus/schema_tools.rb

@@ -1,87 +0,0 @@
-require "yaml"
-require "fileutils"
-
-module Textus
-  module SchemaTools
-    # textus schema-init NAME --from=KEY  → infer YAML schema from an entry's frontmatter
-    def self.init(store, name:, from:)
-      env = store.get(from)
-      fm = env["frontmatter"]
-      schema = {
-        "name" => name,
-        "required" => fm.keys,
-        "optional" => [],
-        "fields" => fm.each_with_object({}) { |(k, v), h| h[k] = { "type" => infer_type(v) } },
-      }
-      FileUtils.mkdir_p(File.join(store.root, "schemas"))
-      target = File.join(store.root, "schemas", "#{name}.yaml")
-      File.write(target, YAML.dump(schema))
-      { "protocol" => PROTOCOL, "schema_name" => name, "path" => target }
-    end
-
-    # textus schema-diff NAME  → list keys whose frontmatter violates the schema
-    def self.diff(store, name:)
-      schema = load_schema(store, name)
-      drift = []
-      store.manifest.enumerate.each do |row|
-        env = store.get(row[:key])
-        begin
-          schema.validate!(env["frontmatter"])
-        rescue SchemaViolation => e
-          drift << { "key" => row[:key], "details" => e.details }
-        end
-      end
-      { "protocol" => PROTOCOL, "schema_name" => name, "drift" => drift }
-    end
-
-    # textus schema-migrate NAME --rename=OLD:NEW → rewrites frontmatter across affected entries
-    # If --rename is omitted, falls back to schema.evolution.migrate_from.
-    def self.migrate(store, name:, rename: nil)
-      renames =
-        if rename
-          old_field, new_field = rename.split(":", 2)
-          raise UsageError.new("--rename=OLD:NEW") unless old_field && new_field && !new_field.empty?
-
-          { old_field => new_field }
-        else
-          load_schema(store, name).evolution["migrate_from"] || {}
-        end
-      raise UsageError.new("schema-migrate needs --rename=OLD:NEW or schema.evolution.migrate_from") if renames.empty?
-
-      touched = []
-      store.manifest.enumerate.each do |row|
-        env = store.get(row[:key])
-        fm = env["frontmatter"]
-        changed = false
-        renames.each do |old, new|
-          if fm.key?(old)
-            fm[new] = fm.delete(old)
-            changed = true
-          end
-        end
-        next unless changed
-
-        store.put(row[:key], frontmatter: fm, body: env["body"], as: "human")
-        touched << row[:key]
-      end
-      { "protocol" => PROTOCOL, "migrated" => touched, "renames" => renames }
-    end
-
-    def self.infer_type(value)
-      case value
-      when String  then "string"
-      when Numeric then "number"
-      when true, false then "boolean"
-      when Array   then "array"
-      when Hash    then "object"
-      else "string"
-      end
-    end
-
-    def self.load_schema(store, name)
-      store.schema_for(name)
-    rescue IoError
-      raise UsageError.new("schema not found: #{name}")
-    end
-  end
-end

data/lib/textus/store_view.rb

@@ -1,27 +0,0 @@
-module Textus
-  class StoreView
-    READ_METHODS  = %i[get list where schema_envelope deps rdeps published stale validate_all].freeze
-    WRITE_METHODS = %i[put delete accept].freeze
-
-    def initialize(store, writable: false, as: nil)
-      raise UsageError.new("writable StoreView requires an as: role") if writable && (as.nil? || as.to_s.empty?)
-
-      @store = store
-      @writable = writable
-      @as = as
-    end
-
-    READ_METHODS.each do |m|
-      define_method(m) { |*args, **kw| @store.public_send(m, *args, **kw) }
-    end
-
-    WRITE_METHODS.each do |m|
-      define_method(m) do |*args, **kw|
-        raise UsageError.new("StoreView is read-only") unless @writable
-
-        kw[:as] = @as unless kw.key?(:as)
-        @store.public_send(m, *args, **kw)
-      end
-    end
-  end
-end