textus 0.54.2 → 0.55.2

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.54.2
+  version: 0.55.2
 platform: ruby
 authors:
 - Patrick
@@ -93,6 +93,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -152,63 +166,22 @@ files:
 - docs/reference/conventions.md
 - exe/textus
 - lib/textus.rb
-- lib/textus/action/accept.rb
-- lib/textus/action/audit.rb
-- lib/textus/action/base.rb
-- lib/textus/action/blame.rb
-- lib/textus/action/boot.rb
-- lib/textus/action/data_mv.rb
-- lib/textus/action/deps.rb
-- lib/textus/action/doctor.rb
-- lib/textus/action/drain.rb
-- lib/textus/action/enqueue.rb
-- lib/textus/action/get.rb
-- lib/textus/action/ingest.rb
-- lib/textus/action/jobs.rb
-- lib/textus/action/key_delete.rb
-- lib/textus/action/key_delete_prefix.rb
-- lib/textus/action/key_mv.rb
-- lib/textus/action/key_mv_prefix.rb
-- lib/textus/action/list.rb
-- lib/textus/action/propose.rb
-- lib/textus/action/published.rb
-- lib/textus/action/pulse.rb
-- lib/textus/action/put.rb
-- lib/textus/action/rdeps.rb
-- lib/textus/action/reject.rb
-- lib/textus/action/rule_explain.rb
-- lib/textus/action/rule_lint.rb
-- lib/textus/action/rule_list.rb
-- lib/textus/action/schema_envelope.rb
-- lib/textus/action/uid.rb
-- lib/textus/action/where.rb
-- lib/textus/action/write_verb.rb
 - lib/textus/boot.rb
-- lib/textus/call.rb
-- lib/textus/command.rb
-- lib/textus/container.rb
-- lib/textus/contract.rb
-- lib/textus/contract/around.rb
-- lib/textus/contract/binder.rb
-- lib/textus/contract/resources/build_lock.rb
-- lib/textus/contract/resources/cursor.rb
-- lib/textus/contract/sources.rb
-- lib/textus/contract/view.rb
-- lib/textus/core/duration.rb
-- lib/textus/core/freshness.rb
-- lib/textus/core/freshness/evaluator.rb
-- lib/textus/core/freshness/verdict.rb
-- lib/textus/core/retention.rb
-- lib/textus/core/retention/sweep.rb
-- lib/textus/core/sentinel.rb
-- lib/textus/cursor_store.rb
+- lib/textus/dispatch/binder.rb
+- lib/textus/dispatch/contracts.rb
+- lib/textus/dispatch/handler_registry.rb
+- lib/textus/dispatch/middleware/audit_index.rb
+- lib/textus/dispatch/middleware/auth.rb
+- lib/textus/dispatch/middleware/base.rb
+- lib/textus/dispatch/middleware/binder.rb
+- lib/textus/dispatch/middleware/cascade.rb
+- lib/textus/dispatch/pipeline.rb
 - lib/textus/doctor.rb
 - lib/textus/doctor/check.rb
 - lib/textus/doctor/check/audit_log.rb
 - lib/textus/doctor/check/generator_drift.rb
 - lib/textus/doctor/check/illegal_keys.rb
 - lib/textus/doctor/check/manifest_files.rb
-- lib/textus/doctor/check/notebook_sources.rb
 - lib/textus/doctor/check/orphaned_publish_targets.rb
 - lib/textus/doctor/check/proposal_targets.rb
 - lib/textus/doctor/check/protocol_version.rb
@@ -218,38 +191,54 @@ files:
 - lib/textus/doctor/check/schema_parse_error.rb
 - lib/textus/doctor/check/schema_violations.rb
 - lib/textus/doctor/check/schemas.rb
+- lib/textus/doctor/check/scratchpad_sources.rb
 - lib/textus/doctor/check/sentinels.rb
 - lib/textus/doctor/check/stale_reviewed_stamp.rb
 - lib/textus/doctor/check/templates.rb
 - lib/textus/doctor/check/unowned_schema_fields.rb
 - lib/textus/doctor/validator.rb
-- lib/textus/envelope.rb
-- lib/textus/envelope/reader.rb
-- lib/textus/envelope/writer.rb
 - lib/textus/errors.rb
-- lib/textus/etag.rb
 - lib/textus/format.rb
 - lib/textus/format/base.rb
 - lib/textus/format/json.rb
 - lib/textus/format/markdown.rb
 - lib/textus/format/text.rb
 - lib/textus/format/yaml.rb
-- lib/textus/gate.rb
-- lib/textus/gate/auth.rb
+- lib/textus/handlers/maintenance/boot_store.rb
+- lib/textus/handlers/maintenance/doctor_store.rb
+- lib/textus/handlers/maintenance/drain_store.rb
+- lib/textus/handlers/maintenance/ingest_entry.rb
+- lib/textus/handlers/maintenance/jobs_action.rb
+- lib/textus/handlers/maintenance/published_entries.rb
+- lib/textus/handlers/maintenance/rule_explain.rb
+- lib/textus/handlers/maintenance/rule_lint.rb
+- lib/textus/handlers/maintenance/rule_list.rb
+- lib/textus/handlers/maintenance/schema_envelope.rb
+- lib/textus/handlers/read/audit_entries.rb
+- lib/textus/handlers/read/blame_entry.rb
+- lib/textus/handlers/read/deps_entry.rb
+- lib/textus/handlers/read/get_entry.rb
+- lib/textus/handlers/read/list_keys.rb
+- lib/textus/handlers/read/pulse_entries.rb
+- lib/textus/handlers/read/rdeps_entry.rb
+- lib/textus/handlers/read/uid_entry.rb
+- lib/textus/handlers/read/where_entry.rb
+- lib/textus/handlers/write/accept_proposal.rb
+- lib/textus/handlers/write/data_mv.rb
+- lib/textus/handlers/write/delete_key.rb
+- lib/textus/handlers/write/enqueue_job.rb
+- lib/textus/handlers/write/key_delete_prefix.rb
+- lib/textus/handlers/write/key_mv_prefix.rb
+- lib/textus/handlers/write/move_key.rb
+- lib/textus/handlers/write/propose_entry.rb
+- lib/textus/handlers/write/put_entry.rb
+- lib/textus/handlers/write/reject_proposal.rb
 - lib/textus/init.rb
 - lib/textus/jobs.rb
-- lib/textus/jobs/base.rb
-- lib/textus/jobs/materialize.rb
-- lib/textus/jobs/plan.rb
-- lib/textus/jobs/planner.rb
-- lib/textus/jobs/retention.rb
-- lib/textus/jobs/sweep.rb
-- lib/textus/jobs/worker.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/manifest.rb
 - lib/textus/manifest/capabilities.rb
 - lib/textus/manifest/data.rb
@@ -273,6 +262,16 @@ files:
 - lib/textus/manifest/entry/validators/publish.rb
 - lib/textus/manifest/policy.rb
 - lib/textus/manifest/policy/matcher.rb
+- lib/textus/manifest/policy/predicates.rb
+- lib/textus/manifest/policy/predicates/author_held.rb
+- lib/textus/manifest/policy/predicates/etag_match.rb
+- lib/textus/manifest/policy/predicates/fresh_within.rb
+- lib/textus/manifest/policy/predicates/lane_deletable_by.rb
+- lib/textus/manifest/policy/predicates/lane_writable_by.rb
+- lib/textus/manifest/policy/predicates/raw_lane_ingest_only.rb
+- lib/textus/manifest/policy/predicates/raw_write_once.rb
+- lib/textus/manifest/policy/predicates/schema_valid.rb
+- lib/textus/manifest/policy/predicates/target_is_canon.rb
 - lib/textus/manifest/policy/publish_target.rb
 - lib/textus/manifest/policy/react.rb
 - lib/textus/manifest/policy/retention.rb
@@ -283,53 +282,91 @@ files:
 - lib/textus/manifest/schema/contract.rb
 - lib/textus/manifest/schema/keys.rb
 - lib/textus/manifest/schema/semantics.rb
+- lib/textus/manifest/schema/semantics/cross_field.rb
+- lib/textus/manifest/schema/semantics/invariants.rb
+- lib/textus/manifest/schema/semantics/migration.rb
 - lib/textus/manifest/schema/validator.rb
 - lib/textus/manifest/schema/vocabulary.rb
-- lib/textus/ports/audit_log.rb
-- lib/textus/ports/build_lock.rb
-- lib/textus/ports/clock.rb
-- lib/textus/ports/job_store.rb
-- lib/textus/ports/job_store/job.rb
-- lib/textus/ports/publisher.rb
-- lib/textus/ports/raw_index.rb
-- lib/textus/ports/sentinel_store.rb
-- lib/textus/ports/storage/file_stat.rb
-- lib/textus/ports/storage/file_store.rb
-- lib/textus/ports/watcher_lock.rb
+- lib/textus/orchestration.rb
+- lib/textus/port/audit_log.rb
+- lib/textus/port/build_lock.rb
+- lib/textus/port/clock.rb
+- lib/textus/port/publisher.rb
+- lib/textus/port/sentinel.rb
+- lib/textus/port/sentinel_store.rb
+- lib/textus/port/storage/file_stat.rb
+- lib/textus/port/storage/file_store.rb
+- lib/textus/port/storage/interface.rb
+- lib/textus/port/store.rb
+- lib/textus/port/watcher_lock.rb
 - lib/textus/produce/engine.rb
+- lib/textus/produce/publisher.rb
 - lib/textus/produce/render.rb
-- lib/textus/role.rb
 - lib/textus/schema.rb
+- lib/textus/schema/registry.rb
 - lib/textus/schema/tools.rb
-- lib/textus/schemas.rb
-- lib/textus/session.rb
 - lib/textus/store.rb
-- lib/textus/surfaces/cli.rb
-- lib/textus/surfaces/cli/group.rb
-- lib/textus/surfaces/cli/group/data.rb
-- lib/textus/surfaces/cli/group/key.rb
-- lib/textus/surfaces/cli/group/mcp.rb
-- lib/textus/surfaces/cli/group/rule.rb
-- lib/textus/surfaces/cli/group/schema.rb
-- lib/textus/surfaces/cli/runner.rb
-- lib/textus/surfaces/cli/verb.rb
-- lib/textus/surfaces/cli/verb/doctor.rb
-- lib/textus/surfaces/cli/verb/get.rb
-- lib/textus/surfaces/cli/verb/init.rb
-- lib/textus/surfaces/cli/verb/mcp_serve.rb
-- lib/textus/surfaces/cli/verb/put.rb
-- lib/textus/surfaces/cli/verb/schema_diff.rb
-- lib/textus/surfaces/cli/verb/schema_init.rb
-- lib/textus/surfaces/cli/verb/schema_migrate.rb
-- lib/textus/surfaces/cli/verb/watch.rb
-- lib/textus/surfaces/mcp.rb
-- lib/textus/surfaces/mcp/catalog.rb
-- lib/textus/surfaces/mcp/errors.rb
-- lib/textus/surfaces/mcp/server.rb
-- lib/textus/surfaces/role_scope.rb
-- lib/textus/surfaces/watcher.rb
-- lib/textus/types.rb
-- lib/textus/uid.rb
+- lib/textus/store/container.rb
+- lib/textus/store/cursor.rb
+- lib/textus/store/entry/reader.rb
+- lib/textus/store/entry/writer.rb
+- lib/textus/store/envelope/meta.rb
+- lib/textus/store/freshness.rb
+- lib/textus/store/freshness/drift_detector.rb
+- lib/textus/store/freshness/evaluator.rb
+- lib/textus/store/freshness/ttl_evaluator.rb
+- lib/textus/store/freshness/verdict.rb
+- lib/textus/store/index/builder.rb
+- lib/textus/store/index/lookup.rb
+- lib/textus/store/jobs/base.rb
+- lib/textus/store/jobs/index.rb
+- lib/textus/store/jobs/materialize.rb
+- lib/textus/store/jobs/plan.rb
+- lib/textus/store/jobs/planner.rb
+- lib/textus/store/jobs/queue.rb
+- lib/textus/store/jobs/registry.rb
+- lib/textus/store/jobs/retention.rb
+- lib/textus/store/jobs/retention/base.rb
+- lib/textus/store/jobs/retention/sweep.rb
+- lib/textus/store/jobs/sweep.rb
+- lib/textus/store/jobs/worker.rb
+- lib/textus/store/layout.rb
+- lib/textus/surface/cli.rb
+- lib/textus/surface/cli/group.rb
+- lib/textus/surface/cli/group/data.rb
+- lib/textus/surface/cli/group/key.rb
+- lib/textus/surface/cli/group/mcp.rb
+- lib/textus/surface/cli/group/rule.rb
+- lib/textus/surface/cli/group/schema.rb
+- lib/textus/surface/cli/runner.rb
+- lib/textus/surface/cli/sources.rb
+- lib/textus/surface/cli/verb.rb
+- lib/textus/surface/cli/verb/doctor.rb
+- lib/textus/surface/cli/verb/get.rb
+- lib/textus/surface/cli/verb/init.rb
+- lib/textus/surface/cli/verb/mcp_serve.rb
+- lib/textus/surface/cli/verb/put.rb
+- lib/textus/surface/cli/verb/schema_diff.rb
+- lib/textus/surface/cli/verb/schema_init.rb
+- lib/textus/surface/cli/verb/schema_migrate.rb
+- lib/textus/surface/cli/verb/watch.rb
+- lib/textus/surface/mcp.rb
+- lib/textus/surface/mcp/catalog.rb
+- lib/textus/surface/mcp/errors.rb
+- lib/textus/surface/mcp/projector.rb
+- lib/textus/surface/mcp/server.rb
+- lib/textus/surface/watcher.rb
+- lib/textus/value/call.rb
+- lib/textus/value/command.rb
+- lib/textus/value/duration.rb
+- lib/textus/value/envelope.rb
+- lib/textus/value/etag.rb
+- lib/textus/value/payload.rb
+- lib/textus/value/result.rb
+- lib/textus/value/role.rb
+- lib/textus/value/types.rb
+- lib/textus/value/uid.rb
+- lib/textus/verb_registry.rb
 - lib/textus/version.rb
 - lib/textus/workflow.rb
 - lib/textus/workflow/collector.rb

data/lib/textus/action/accept.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class Accept < WriteVerb
-      extend Textus::Contract::DSL
-
-      verb :accept
-      summary "apply a queued proposal to its target zone; requires the author capability"
-      surfaces :cli, :mcp
-      cli "accept"
-      arg :pending_key, String, required: true, positional: true, description: "the queued proposal's key"
-
-      def initialize(pending_key:)
-        super()
-        @pending_key = pending_key
-      end
-
-      def call(container:, call:)
-        env = Textus::Action::Get.new(key: @pending_key).call(container: container, call: call)
-        proposal = env.meta["proposal"] or raise Textus::ProposalError.new("entry has no proposal block: #{@pending_key}")
-        target = proposal["target_key"] or raise Textus::ProposalError.new("proposal missing target_key")
-        action = proposal["action"] || "put"
-
-        case action
-        when "put"
-          Textus::Action::Put.new(
-            key: target,
-            meta: env.meta["_meta"] || {},
-            body: env.body,
-          ).call(container: container, call: call)
-        when "delete"
-          Textus::Action::KeyDelete.new(key: target).call(container: container, call: call)
-        else
-          raise Textus::ProposalError.new("unknown action: #{action}")
-        end
-
-        Textus::Action::KeyDelete.new(key: @pending_key).call(container: container, call: call)
-
-        { "protocol" => Textus::PROTOCOL, "accepted" => @pending_key, "target_key" => target, "action" => action }
-      end
-    end
-  end
-end

data/lib/textus/action/audit.rb

@@ -1,131 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "time"
-
-module Textus
-  module Action
-    class Audit < Base
-      extend Textus::Contract::DSL
-
-      verb :audit
-      summary "Query the audit log with optional filters."
-      surfaces :cli
-      cli "audit"
-      arg :key, String, required: false, description: "filter to rows for this key"
-      arg :lane, String, required: false, description: "filter to keys in this lane"
-      arg :role, String, required: false, description: "filter to rows written under this role"
-      arg :verb, String, required: false, description: "filter to rows for this verb"
-      arg :since, String, required: false,
-                          coerce: ->(s) { Textus::Action::Audit.parse_since(s, now: Time.now) },
-                          description: "ISO-8601 timestamp or relative offset (e.g. 1h, 30m)"
-      arg :seq_since, Integer, required: false, description: "return rows with seq > this cursor value"
-      arg :correlation_id, String, required: false, description: "filter to rows with this correlation_id"
-      arg :limit, Integer, required: false, description: "maximum number of rows to return"
-      view(:cli) { |rows, _i| { "verb" => "audit", "rows" => rows } }
-
-      def initialize(**kwargs)
-        super()
-        @query = Query.build(**kwargs.slice(:key, :lane, :role, :verb, :since, :seq_since, :correlation_id, :limit))
-      end
-
-      def args
-        @query.to_h.compact
-      end
-
-      def call(container:, **)
-        @manifest = container.manifest
-        @root = container.root
-        @log_path = Textus::Layout.audit_log(container.root)
-        @audit_log = container.audit_log
-
-        query = @query
-        check_cursor_expiry!(query.seq_since)
-
-        files = all_log_files
-        return [] if files.empty?
-
-        rows = []
-        files.each do |file|
-          File.foreach(file) do |line|
-            parsed = parse_row(line.chomp)
-            next unless parsed
-            next unless query.matches?(parsed)
-            next if query.lane && !key_in_lane?(parsed["key"], query.lane)
-
-            rows << parsed
-            break if limit_reached?(rows, query)
-          end
-          break if limit_reached?(rows, query)
-        end
-
-        rows
-      end
-
-      def self.parse_since(str, now: Time.now.utc)
-        return nil if str.nil? || str.empty?
-        return Time.parse(str) if str =~ /\A\d{4}-\d{2}-\d{2}/
-
-        match = str.match(/\A(\d+)([smhd])\z/) or return nil
-        mult = { "s" => 1, "m" => 60, "h" => 3600, "d" => 86_400 }[match[2]]
-        now - (match[1].to_i * mult)
-      end
-
-      Query = Data.define(:key, :lane, :role, :verb, :since, :seq_since, :correlation_id, :limit) do
-        # rubocop:disable Metrics/ParameterLists
-        def self.build(key: nil, lane: nil, role: nil, verb: nil,
-                       since: nil, seq_since: nil, correlation_id: nil, limit: nil)
-          new(key:, lane:, role:, verb:, since:, seq_since:, correlation_id:, limit:)
-        end
-        # rubocop:enable Metrics/ParameterLists
-
-        def matches?(row)
-          return false if key && row["key"] != key
-          return false if role && row["role"] != role
-          return false if verb && row["verb"] != verb
-          return false if since && (row["ts"].nil? || Time.parse(row["ts"]) < since)
-          return false if seq_since && (row["seq"].nil? || row["seq"] <= seq_since)
-          return false if correlation_id && row.dig("extras", "correlation_id") != correlation_id
-
-          true
-        end
-      end
-
-      private
-
-      def limit_reached?(rows, query) = query.limit && rows.length >= query.limit
-
-      def check_cursor_expiry!(seq_since)
-        return unless seq_since
-
-        log = @audit_log || Textus::Ports::AuditLog.new(@root)
-        min = log.min_available_seq
-        raise Textus::CursorExpired.new(requested: seq_since, min_available: min) if min && seq_since < min - 1
-      end
-
-      def all_log_files
-        rotated = Dir.glob(File.join(Textus::Layout.audit_dir(@root), "audit.log.*"))
-                     .reject { |path| path.end_with?(".meta.json") }
-                     .sort_by { |path| -path.scan(/\d+$/).first.to_i }
-        active = File.exist?(@log_path) ? [@log_path] : []
-        rotated + active
-      end
-
-      def parse_row(line)
-        return nil if line.empty?
-        return nil unless line.start_with?("{")
-
-        JSON.parse(line)
-      rescue JSON::ParserError
-        nil
-      end
-
-      def key_in_lane?(key, lane)
-        mentry = @manifest.resolver.resolve(key).entry
-        mentry && mentry.lane == lane
-      rescue Textus::Error
-        false
-      end
-    end
-  end
-end

data/lib/textus/action/base.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    @registry = {}
-
-    def self.registry = @registry
-
-    def self.register(klass)
-      @registry[klass.name.gsub("::", "/").downcase] = klass
-    end
-
-    def self.fetch(type)
-      return @registry[type] if @registry[type]
-
-      match = @registry.values.find { |k| k.const_defined?(:TYPE, false) && type == k::TYPE }
-      raise Textus::UsageError.new("unknown action type: #{type}") unless match
-
-      @registry[type] = match
-    end
-
-    class Base
-      def self.inherited(subclass)
-        super
-        Textus::Action.register(subclass) if subclass.name
-      end
-
-      def call(**)
-        raise NotImplementedError.new("#{self.class}#call")
-      end
-
-      def args
-        params = self.class.instance_method(:initialize).parameters
-        names = params.select { |t,| %i[key keyreq].include?(t) }.map(&:last)
-        names.each_with_object({}) do |name, h|
-          val = instance_variable_get(:"@#{name}")
-          h[name] = val unless val.nil?
-        end
-      end
-    end
-  end
-end

data/lib/textus/action/blame.rb

@@ -1,97 +0,0 @@
-# frozen_string_literal: true
-
-require "open3"
-
-module Textus
-  module Action
-    class Blame < Base
-      extend Textus::Contract::DSL
-
-      verb :blame
-      summary "Annotate audit rows for a key with the git commit that introduced each file state."
-      surfaces :cli
-      cli "blame"
-      arg :key, String, required: true, positional: true, description: "entry key to blame"
-      arg :limit, Integer, required: false, description: "maximum number of audit rows to return"
-      view(:cli) { |rows, inputs| { "verb" => "blame", "key" => inputs[:key], "rows" => rows } }
-
-      def initialize(key:, limit: nil)
-        super()
-        @key = key
-        @limit = limit
-      end
-
-      def call(container:, **)
-        @container = container
-        @manifest = container.manifest
-        @root = container.root
-
-        audit_rows = Textus::Action::Audit.new(key: @key, limit: @limit).call(container: container)
-        path = resolve_path(@key)
-        return audit_rows.map { |row| row.merge("git" => nil) } unless git_tracked?(path)
-
-        audit_rows.map { |row| row.merge("git" => git_commit_at(path, timestamp: row["ts"])) }
-      end
-
-      def self.new(*args, **kwargs)
-        return super(**kwargs) unless args.any?
-
-        positional = instance_method(:initialize).parameters.slice(:keyreq, :key).map(&:last)
-        mapped = positional.zip(args).to_h
-        super(**mapped.merge(kwargs))
-      end
-
-      private
-
-      def resolve_path(key)
-        res = @manifest.resolver.resolve(key)
-        mentry = res.entry
-        path = res.path
-        path || Textus::Key::Path.resolve(@manifest.data, mentry)
-      rescue Textus::Error
-        nil
-      end
-
-      def git_tracked?(path)
-        return false if path.nil?
-        return false unless File.exist?(path)
-        return false unless git_repo?
-
-        _out, _err, status = Open3.capture3(
-          "git", "ls-files", "--error-unmatch", path,
-          chdir: @root
-        )
-        status.success?
-      rescue Errno::ENOENT
-        false
-      end
-
-      def git_repo?
-        dir = @root
-        loop do
-          return true if File.directory?(File.join(dir, ".git"))
-
-          parent = File.dirname(dir)
-          return false if parent == dir
-
-          dir = parent
-        end
-      end
-
-      def git_commit_at(path, timestamp:)
-        args = ["git", "log", "-1"]
-        args << "--before=#{timestamp}" if timestamp
-        args += ["--format=%H%x09%an%x09%aI%x09%s", "--", path]
-        out, _err, status = Open3.capture3(*args, chdir: @root)
-        return nil unless status.success?
-
-        sha, author, date, subject = out.strip.split("\t", 4)
-        return nil if sha.nil? || sha.empty?
-
-        { "sha" => sha, "author" => author, "date" => date, "subject" => subject }
-      rescue Errno::ENOENT
-        nil
-      end
-    end
-  end
-end

data/lib/textus/action/boot.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class Boot < Base
-      extend Textus::Contract::DSL
-
-      verb :boot
-      summary "Return the orientation contract: lanes, agent_quickstart, agent_protocol, and pre-computed artifacts."
-      surfaces :cli, :mcp
-
-      def call(container:, **)
-        Textus::Boot.build(container: container)
-      end
-    end
-  end
-end