textus 0.14.2 → 0.14.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a732844e2441328f7519ffd93571c3ff611fd0514c2b1f927b5c4ada499db16
-  data.tar.gz: 63a3e530439c37fbbff8c8b3864b1489cd34c88c88bd1c10f03ae980f4a66041
+  metadata.gz: 65cfe5f73a64dda44280d1dd58e418aecdc94b79e1abb68340e973d364da3465
+  data.tar.gz: c35f1428a0965c11c946395a8fb7dfeb60202e2fac2514b1bb04dfae1e426ed2
 SHA512:
-  metadata.gz: 5470a6aaf29f1b081144b2eca3b1e87e5b1d465977422c967366196d259041cdbb8e0993ce293d87d7903f9446649f80ea99e1e6367b9731f7b839bf18f9d67f
-  data.tar.gz: dcd3f57064d2f6753f049daf1315a937566e3b77a9ec130455a54410292f73ec55104bafe1e1b20431dc186a1c13735a7e6c6018ef8f54b77122f0eb2e267e8c
+  metadata.gz: edeefd203bb0f4af807457cb96353affd3a21de846331481bb3d6e69e344fc1ea8054f8066ed278e7a7ced366704a65df00269d38b58a5b729d408477bc4f5a5
+  data.tar.gz: 4c30fa46409c381bfa8ef381c38314ce988786b9f2cf81c8b1c76f7508301587b9e5562ce1ced415f85484fe794fe3aeff5186203f733cedea34443d43a4eb57

data/CHANGELOG.md

@@ -9,6 +9,21 @@ The **gem version** (`0.x.y`) is distinct from the **protocol version**
 bump is a breaking change that requires a store migration; the gem version
 tracks both additive improvements and breaking protocol bumps independently.
 
+## 0.14.3 — 2026-05-26
+
+### Added
+
+- Top-level `flock(2)` mutex at `<root>/.build.lock` prevents concurrent
+  `textus build` invocations against the same store. A second build
+  while one is already running exits with code `75` (`EX_TEMPFAIL`) and
+  emits a `build_in_progress` error envelope, so wrappers like `rake
+  update` and CI can distinguish "another build is busy" from "this
+  build is broken". The lock is FD-bound and released by the kernel on
+  process death (including SIGKILL/OOM), so no stale-lock takeover
+  logic is needed. `close_on_exec` prevents the lock from leaking into
+  `bundle exec` and lefthook child processes. Per-key locks under
+  `.locks/` are unchanged. (#56)
+
 ## 0.14.2 — 2026-05-26
 
 ### Added

data/lib/textus/cli/verb/build.rb

@@ -5,12 +5,14 @@ module Textus
         option :prefix, "--prefix=K"
 
         def call(store)
-          ops = Textus::Operations.for(store, role: "builder")
-          build_res   = ops.writes.build.call(prefix: prefix)
-          publish_res = ops.writes.publish.call(prefix: prefix)
-          emit({ "protocol" => Textus::PROTOCOL,
-                 "built" => build_res["built"],
-                 "published_leaves" => publish_res["published_leaves"] })
+          Textus::Infra::BuildLock.with(root: store.root) do
+            ops = Textus::Operations.for(store, role: "builder")
+            build_res   = ops.writes.build.call(prefix: prefix)
+            publish_res = ops.writes.publish.call(prefix: prefix)
+            emit({ "protocol" => Textus::PROTOCOL,
+                   "built" => build_res["built"],
+                   "published_leaves" => publish_res["published_leaves"] })
+          end
         end
       end
     end

data/lib/textus/errors.rb

@@ -122,6 +122,18 @@ module Textus
     def initialize(m) = super("io_error", m, exit_code: 64)
   end
 
+  class BuildInProgress < Error
+    def initialize(holder)
+      super(
+        "build_in_progress",
+        "textus build already running (#{holder})",
+        details: { "holder" => holder },
+        exit_code: 75,
+        hint: "wait for the running build to finish, or check for a recursive hook trigger"
+      )
+    end
+  end
+
   class UsageError < Error
     def initialize(m, hint: nil) = super("usage", m, exit_code: 2, hint: hint)
   end

data/lib/textus/infra/build_lock.rb

@@ -0,0 +1,59 @@
+require "fileutils"
+require "socket"
+require "time"
+
+module Textus
+  module Infra
+    class BuildLock
+      LOCK_FILENAME = ".build.lock"
+      MAX_HOLDER_BYTES = 512
+
+      def self.with(root:, &)
+        new(root: root).acquire_or_raise(&)
+      end
+
+      def initialize(root:)
+        @path = File.join(root, LOCK_FILENAME)
+        @file = nil
+      end
+
+      def acquire_or_raise
+        FileUtils.mkdir_p(File.dirname(@path))
+        @file = File.open(@path, File::RDWR | File::CREAT, 0o644)
+        @file.close_on_exec = true
+
+        unless @file.flock(File::LOCK_EX | File::LOCK_NB)
+          holder = read_holder_safely
+          @file.close
+          @file = nil
+          raise Textus::BuildInProgress.new(holder)
+        end
+
+        @file.truncate(0)
+        @file.write("pid=#{Process.pid} started=#{Time.now.utc.iso8601} host=#{Socket.gethostname}\n")
+        @file.flush
+
+        yield
+      ensure
+        release
+      end
+
+      private
+
+      def release
+        return unless @file
+
+        @file.flock(File::LOCK_UN)
+        @file.close
+        @file = nil
+      end
+
+      def read_holder_safely
+        content = File.read(@path, MAX_HOLDER_BYTES)
+        content.gsub(/[^[:print:]\t ]/, "").strip
+      rescue StandardError
+        "unknown"
+      end
+    end
+  end
+end

data/lib/textus/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.14.2
+  version: 0.14.3
 platform: ruby
 authors:
 - Patrick
@@ -223,6 +223,7 @@ files:
 - lib/textus/hooks/dsl.rb
 - lib/textus/hooks/loader.rb
 - lib/textus/hooks/registry.rb
+- lib/textus/infra/build_lock.rb
 - lib/textus/infra/clock.rb
 - lib/textus/infra/event_bus.rb
 - lib/textus/infra/publisher.rb