textus 0.54.2 → 0.55.1

data/lib/textus/workflow/runner.rb

@@ -57,12 +57,12 @@ module Textus
       end
 
       def built_in_publish(key, data, ctx)
-        normalized = normalize(data, ctx.entry.format)
+        normalized = Textus::Format.data_to_payload(data, ctx.entry.format)
         Gate::Auth.new(@container).check_action!(action: :converge, actor: @call.role, key: key)
-        Envelope::Writer.from(container: @container, call: @call).put(
+        Textus::Store::Envelope::Writer.from(container: @container, call: @call).put(
           key,
           mentry: ctx.entry,
-          payload: Envelope::Writer::Payload.new(**normalized),
+          payload: Textus::Store::Envelope::Writer::Payload.new(**normalized),
         )
         publish_external(key, ctx)
       end
@@ -74,26 +74,12 @@ module Textus
         entry_path = @container.manifest.resolver.resolve(key).path
         return unless entry.publish_tree || File.exist?(entry_path)
 
-        reader = Textus::Envelope::Reader.from(container: @container)
+        reader = Textus::Store::Envelope::Reader.from(container: @container)
         pctx   = Textus::Manifest::Entry::Base::PublishContext.new(
           container: @container, call: @call, reader: reader.method(:read),
         )
         entry.publish_via(pctx)
       end
-
-      def normalize(data, format)
-        return { meta: {}, body: "", content: nil } if data.nil?
-
-        data = data.transform_keys(&:to_s) if data.is_a?(Hash)
-        case format.to_s
-        when "markdown", "text"
-          { meta: data["_meta"] || {}, body: (data["body"] || "").to_s, content: nil }
-        when "json", "yaml"
-          { meta: data["_meta"] || {}, body: nil, content: data["content"] || data }
-        else
-          { meta: {}, body: data.to_s, content: nil }
-        end
-      end
     end
   end
 end

data/lib/textus.rb

@@ -1,8 +1,9 @@
 require "zeitwerk"
+require "dry-monads"
 require_relative "textus/version"
 require_relative "textus/errors"
-require_relative "textus/surfaces/mcp"
-require_relative "textus/surfaces/mcp/errors"
+require_relative "textus/surface/mcp"
+require_relative "textus/surface/mcp/errors"
 
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect(
@@ -14,8 +15,8 @@ loader.inflector.inflect(
   "dsl" => "DSL",
 )
 loader.ignore(File.expand_path("textus/errors.rb", __dir__))
-loader.ignore(File.expand_path("textus/surfaces/mcp.rb", __dir__))
-loader.ignore(File.expand_path("textus/surfaces/mcp/errors.rb", __dir__))
+loader.ignore(File.expand_path("textus/surface/mcp.rb", __dir__))
+loader.ignore(File.expand_path("textus/surface/mcp/errors.rb", __dir__))
 loader.ignore(File.expand_path("textus/workflow/errors.rb", __dir__))
 # Scaffold sources copied verbatim into user stores by `textus init`. They are
 # templates for user-owned step classes, not gem constants — Zeitwerk must not
@@ -64,15 +65,14 @@ Textus::Boot::CLI_VERBS = Textus::Boot.build_cli_verbs.freeze
 
 # Dynamic verb methods on Store (deferred after VERBS is defined).
 Textus::Action::VERBS.each_key do |verb|
-  Textus::Store.define_method(verb) do |*args, role: Textus::Role::DEFAULT, **kwargs|
+  Textus::Store.define_method(verb) do |*args, role: Textus::Value::Role::DEFAULT, **kwargs|
     as(role).public_send(verb, *args, **kwargs)
   end
 
-  Textus::Surfaces::RoleScope.define_method(verb) do |*args, **kwargs|
+  Textus::Surface::RoleScope.define_method(verb) do |*args, **kwargs|
     klass     = Textus::Action::VERBS[verb]
-    cmd_class = Textus::Gate::VERB_COMMAND[verb]
     inputs    = if klass.respond_to?(:contract?) && klass.contract?
-                  Textus::Contract::Binder.inputs_from_ordered(klass.contract, args, kwargs)
+                  Textus::Gate::Binder.inputs_from_ordered(klass.contract, args, kwargs)
                 else
                   kwargs.transform_keys(&:to_sym)
                 end
@@ -84,8 +84,7 @@ Textus::Action::VERBS.each_key do |verb|
                    @role
                  end
 
-    filled = cmd_class.members.to_h { |m| [m, inputs.merge(role: role_value)[m]] }
-    @container.gate.dispatch(cmd_class.new(**filled), correlation_id: @correlation_id)
+    @container.gate.dispatch(spec: klass.contract, inputs: inputs, role: role_value, correlation_id: @correlation_id)
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.54.2
+  version: 0.55.1
 platform: ruby
 authors:
 - Patrick
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: dry-monads
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: dry-schema
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +107,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
@@ -182,18 +210,11 @@ files:
 - 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/contract/arg.rb
+- lib/textus/contract/dsl.rb
+- lib/textus/contract/spec.rb
 - lib/textus/core/duration.rb
 - lib/textus/core/freshness.rb
 - lib/textus/core/freshness/evaluator.rb
@@ -201,7 +222,6 @@ files:
 - lib/textus/core/retention.rb
 - lib/textus/core/retention/sweep.rb
 - lib/textus/core/sentinel.rb
-- lib/textus/cursor_store.rb
 - lib/textus/doctor.rb
 - lib/textus/doctor/check.rb
 - lib/textus/doctor/check/audit_log.rb
@@ -223,33 +243,23 @@ files:
 - 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/shared.rb
 - lib/textus/format/text.rb
 - lib/textus/format/yaml.rb
 - lib/textus/gate.rb
 - lib/textus/gate/auth.rb
+- lib/textus/gate/binder.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
@@ -283,53 +293,80 @@ 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/meta.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_store.rb
+- lib/textus/port/storage/file_stat.rb
+- lib/textus/port/storage/file_store.rb
+- lib/textus/port/store.rb
+- lib/textus/port/watcher_lock.rb
 - lib/textus/produce/engine.rb
 - lib/textus/produce/render.rb
-- lib/textus/role.rb
 - lib/textus/schema.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/compositor.rb
+- lib/textus/store/container.rb
+- lib/textus/store/cursor.rb
+- lib/textus/store/envelope/reader.rb
+- lib/textus/store/envelope/writer.rb
+- lib/textus/store/geometry.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/sweep.rb
+- lib/textus/store/jobs/worker.rb
+- lib/textus/store/session.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/server.rb
+- lib/textus/surface/projector.rb
+- lib/textus/surface/role_scope.rb
+- lib/textus/surface/watcher.rb
+- lib/textus/value/call.rb
+- lib/textus/value/command.rb
+- lib/textus/value/envelope.rb
+- lib/textus/value/etag.rb
+- lib/textus/value/result.rb
+- lib/textus/value/role.rb
+- lib/textus/value/types.rb
+- lib/textus/value/uid.rb
 - lib/textus/version.rb
 - lib/textus/workflow.rb
 - lib/textus/workflow/collector.rb

data/lib/textus/action/write_verb.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-module Textus
-  module Action
-    class WriteVerb < Base
-      private
-
-      def auth(container)
-        Textus::Gate::Auth.new(container)
-      end
-
-      def writer(container, call)
-        Textus::Envelope::Writer.from(container: container, call: call)
-      end
-
-      def reader(container)
-        Textus::Envelope::Reader.from(container: container)
-      end
-
-      def run_with_cascade(target_key, container:, call:)
-        result = yield
-        cascade_to_rdeps(target_key, container, call) if target_key
-        result
-      end
-
-      def cascade_to_rdeps(key, container, call)
-        rdeps = Textus::Action::Rdeps.new(key: key).call(container: container, call: call).fetch("rdeps", [])
-        producible = rdeps.select { |dep_key| producible?(dep_key, container) }
-        return if producible.empty?
-
-        producible.each do |dep_key|
-          Textus::Jobs::Materialize.new(key: dep_key).call(container:, call:)
-        end
-      end
-
-      def producible?(key, container)
-        entry = container.manifest.resolver.resolve(key).entry
-        !entry.publish_tree.nil?
-      rescue Textus::Error
-        false
-      end
-    end
-  end
-end

data/lib/textus/call.rb

@@ -1,28 +0,0 @@
-require "securerandom"
-
-module Textus
-  # Immutable per-invocation value. Carries who is acting (role), the
-  # request correlation id, the wall clock, and the dry_run flag — the
-  # bits Use Cases need that are not part of the Container.
-  Call = Data.define(:role, :correlation_id, :now, :dry_run) do
-    def self.build(role:, correlation_id: nil, now: nil, dry_run: false)
-      new(
-        role: role.to_s,
-        correlation_id: correlation_id || SecureRandom.uuid,
-        now: now || Textus::Ports::Clock.new.now,
-        dry_run: dry_run,
-      )
-    end
-
-    def dry_run? = dry_run
-
-    def with_role(new_role)
-      self.class.new(
-        role: new_role.to_s,
-        correlation_id: correlation_id,
-        now: now,
-        dry_run: dry_run,
-      )
-    end
-  end
-end

data/lib/textus/command.rb

@@ -1,41 +0,0 @@
-module Textus
-  module Command
-    Get             = Data.define(:key, :role)
-    Put             = Data.define(:key, :meta, :body, :content, :if_etag, :role)
-    Propose         = Data.define(:key, :meta, :body, :content, :role, :pending_key) do
-      def initialize(key:, role:, meta: nil, body: nil, content: nil, pending_key: nil)
-        super
-      end
-    end
-    KeyDelete       = Data.define(:key, :if_etag, :role)
-    KeyMv           = Data.define(:old_key, :new_key, :dry_run, :role)
-    Accept          = Data.define(:pending_key, :role)
-    Reject          = Data.define(:pending_key, :role)
-    Enqueue         = Data.define(:type, :args, :role)
-    Ingest          = Data.define(:kind, :slug, :url, :path, :zone, :label, :role) do
-      def initialize(kind:, slug:, role:, url: nil, path: nil, zone: nil, label: nil)
-        super
-      end
-    end
-    List            = Data.define(:prefix, :lane, :role)
-    Where           = Data.define(:key, :role)
-    Uid             = Data.define(:key, :role)
-    Blame           = Data.define(:key, :limit, :role)
-    Audit           = Data.define(:key, :lane, :verb, :since, :seq_since, :correlation_id, :limit, :role)
-    Deps            = Data.define(:key, :role)
-    Rdeps           = Data.define(:key, :role)
-    Pulse           = Data.define(:since, :role)
-    RuleExplain     = Data.define(:key, :detail, :role)
-    RuleList        = Data.define(:role)
-    RuleLint        = Data.define(:candidate_yaml, :role)
-    Published       = Data.define(:role)
-    SchemaShow      = Data.define(:key, :role)
-    Doctor          = Data.define(:checks, :role)
-    Boot            = Data.define(:role)
-    Jobs            = Data.define(:state, :action, :job_id, :role)
-    DataMv          = Data.define(:from, :to, :dry_run, :role)
-    KeyMvPrefix     = Data.define(:from_prefix, :to_prefix, :dry_run, :role)
-    KeyDeletePrefix = Data.define(:prefix, :dry_run, :role)
-    Drain           = Data.define(:prefix, :lane, :role)
-  end
-end

data/lib/textus/container.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require "dry-struct"
-
-module Textus
-  # Single capability record handed to every use case. Replaces the
-  # ReadCaps/WriteCaps/HookCaps trio from 0.26.x. Built once per Store
-  # (see Store#initialize); Store delegates its readers to this record,
-  # so this struct is the single source of truth for the field set.
-  class Container < Dry::Struct
-    attribute :manifest,   Types::Any
-    attribute :file_store, Types::Any
-    attribute :schemas,    Types::Any
-    attribute :root,       Types::String
-    attribute :audit_log,  Types::Any
-    attribute :workflows,  Types::Any
-    attribute :gate,       Types::Any
-
-    def with(**attrs) = self.class.new(to_h.merge(attrs))
-
-    def initialize(*)
-      super
-      freeze
-    end
-  end
-end

data/lib/textus/contract/around.rb

@@ -1,29 +0,0 @@
-module Textus
-  module Contract
-    # Registry of named, stateful wrappers a verb may declare via `around :name`.
-    # A resource implements
-    #   `wrap(scope:, inputs:, session:) { |effective_inputs| ... }`:
-    # it may adjust the inputs before the call and post-process the result after
-    # — exactly what build's lock and pulse's cursor need, without a hand-authored
-    # CLI class (ADR 0068). `session:` is the dispatching session (nil for the
-    # sessionless CLI/Ruby surfaces, present for MCP), so a session-aware resource
-    # like the cursor can defer to the session's own state instead of its file.
-    module Around
-      @registry = {}
-
-      module_function
-
-      def register(name, resource)
-        @registry[name] = resource
-      end
-
-      def fetch(name)
-        @registry.fetch(name) { raise "no around resource registered: #{name.inspect}" }
-      end
-
-      def with(name, scope:, inputs:, session: nil, &call)
-        fetch(name).wrap(scope: scope, inputs: inputs, session: session, &call)
-      end
-    end
-  end
-end

data/lib/textus/contract/binder.rb

@@ -1,88 +0,0 @@
-module Textus
-  module Contract
-    # Raised when a required arg is absent from the bound input. Surface
-    # adapters translate this to their native error (MCP ToolError, CLI
-    # UsageError); a direct Ruby call lets it surface as-is.
-    class MissingArgs < Textus::Error
-      attr_reader :spec, :missing
-
-      def initialize(spec, missing)
-        @spec = spec
-        @missing = missing
-        super("missing_args", "#{spec.verb}: missing #{missing.map(&:wire).join(", ")}")
-      end
-    end
-
-    # The single argument binder for every surface (spike: collapses the three
-    # historical implementations — MCP::Catalog.map_args, CLI::Runner.call_args,
-    # and RoleScope's default-injection loop — into one algorithm).
-    #
-    # Input is a uniform `inputs` hash keyed by arg NAME (the use-case kwarg
-    # name, never the wire name): each surface normalizes its own raw transport
-    # shape (MCP JSON keyed by wire-name, CLI argv+flags, Ruby args+kwargs) into
-    # this hash. Binder owns the shared algorithm and nothing transport-specific:
-    #
-    #   1. validate every required arg is present in `inputs`;
-    #   2. for absentees, fall back to session_default (when a session is given)
-    #      then to the literal default; otherwise omit the arg entirely;
-    #   3. split into the (positional, keyword) pair to splat into the use-case,
-    #      routing by `arg.positional`.
-    #
-    # Returns `[positional_array, keyword_hash]` — exactly what
-    # `RoleScope#<verb>(*pos, **kw)` expects.
-    module Binder
-      module_function
-
-      # Validation is unconditional: a `required:` arg absent from `inputs` is a
-      # contract violation on every surface (ADR 0069). `required:` is now an
-      # honest contract invariant, not a surface policy — args the use-case
-      # treats as optional (e.g. `meta`, whose real requiredness lives in schema
-      # validation downstream) are declared `required: false`, so this check
-      # never fires spuriously and never needs an opt-out.
-      def bind(spec, inputs, session: nil)
-        missing = spec.required_args.reject { |a| inputs.key?(a.name) }
-        raise MissingArgs.new(spec, missing) unless missing.empty?
-
-        pos = []
-        kw  = {}
-        spec.args.each do |a|
-          if inputs.key?(a.name)
-            value = inputs[a.name]
-          elsif a.session_default && session
-            value = session.public_send(a.session_default)
-          elsif !a.default.nil?
-            value = a.default
-          else
-            next
-          end
-
-          if a.positional
-            pos << value
-          else
-            kw[a.name] = value
-          end
-        end
-        [pos, kw]
-      end
-
-      # Normalize an ordered positional list + a by-name keyword hash (the shape
-      # CLI argv+flags and Ruby args+kwargs both arrive in) into the uniform
-      # by-name `inputs` hash bind expects. Positionals beyond what was supplied
-      # are dropped so bind's required-check sees them as absent.
-      def inputs_from_ordered(spec, ordered_positionals, by_name_keywords)
-        names = spec.args.select(&:positional).map(&:name)
-        names.zip(ordered_positionals).to_h.compact.merge(by_name_keywords)
-      end
-
-      # Normalize a raw transport hash keyed by WIRE name (the shape MCP JSON
-      # arrives in) into the uniform by-name `inputs` hash bind expects. Keys
-      # not declared on the contract are ignored.
-      def inputs_from_wire(spec, raw)
-        raw ||= {}
-        spec.args.each_with_object({}) do |a, h|
-          h[a.name] = raw[a.wire.to_s] if raw.key?(a.wire.to_s)
-        end
-      end
-    end
-  end
-end

data/lib/textus/contract/resources/build_lock.rb

@@ -1,17 +0,0 @@
-module Textus
-  module Contract
-    module Resources
-      # Serializes builds across every surface (CLI, MCP, Ruby). Previously the
-      # CLI verb wrapped each build in a BuildLock by hand; lifting it into the
-      # contract means the MCP surface inherits the single-writer guarantee and
-      # cannot collide with a concurrent CLI or background build.
-      class BuildLock
-        def wrap(scope:, inputs:, session: nil) # rubocop:disable Lint/UnusedMethodArgument
-          Textus::Ports::BuildLock.with(root: scope.container.root) { yield(inputs) }
-        end
-      end
-    end
-  end
-end
-
-Textus::Contract::Around.register(:build_lock, Textus::Contract::Resources::BuildLock.new)

data/lib/textus/contract/resources/cursor.rb

@@ -1,26 +0,0 @@
-module Textus
-  module Contract
-    module Resources
-      # Reads the persisted file cursor as the `since` default when the caller
-      # did not supply one, runs pulse, then persists the returned cursor.
-      # Replaces CLI::Verb::Pulse's hand-coded CursorStore read/write (ADR 0068).
-      #
-      # A session-bearing surface (MCP) carries its own cursor via the contract's
-      # `session_default: :cursor`, so this defers entirely when a session is
-      # present — it is the sessionless CLI/Ruby surfaces that need the file.
-      class Cursor
-        def wrap(scope:, inputs:, session:)
-          return yield(inputs) if session
-
-          store = Textus::CursorStore.new(root: scope.container.root, role: scope.role)
-          effective = inputs.key?(:since) ? inputs : inputs.merge(since: store.read)
-          result = yield(effective)
-          store.write(result["cursor"]) if result.is_a?(Hash) && result["cursor"]
-          result
-        end
-      end
-    end
-  end
-end
-
-Textus::Contract::Around.register(:cursor, Textus::Contract::Resources::Cursor.new)