fix(ffi): replace removed std.atomic.Mutex with std.Thread.Mutex

ffi/zig/src/catalogue.zig

@@ -12,15 +12,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 
 // ═══════════════════════════════════════════════════════════════════════
 // Types (must match src/abi/Catalogue.idr encodings)

ffi/zig/src/community.zig

@@ -15,15 +15,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 
 // ═══════════════════════════════════════════════════════════════════════
 // Constants

ffi/zig/src/coprocessor.zig

@@ -20,15 +20,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 
 extern fn getenv(name: [*:0]const u8) ?[*:0]const u8;
 

ffi/zig/src/federation.zig

@@ -20,15 +20,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 
 // ═══════════════════════════════════════════════════════════════════════
 // Proven-hardened: Circuit breaker, retry, and rate limiter state

ffi/zig/src/guardian.zig

@@ -22,15 +22,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 
 // ═══════════════════════════════════════════════════════════════════════
 // Constants

ffi/zig/src/loader.zig

@@ -13,15 +13,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 const crypto = std.crypto;
 const fs = std.fs;
 

ffi/zig/src/sdp.zig

@@ -16,15 +16,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 
 // ═══════════════════════════════════════════════════════════════════════
 // Constants

ffi/zig/src/sla.zig

@@ -15,15 +15,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 
 // ═══════════════════════════════════════════════════════════════════════
 // Constants

ffi/zig/src/verisimdb.zig

@@ -16,15 +16,12 @@
 
 const std = @import("std");
 
-const Mutex = struct {
-    state: std.atomic.Mutex = .unlocked,
-    pub fn lock(m: *Mutex) void {
-        while (!m.state.tryLock()) std.atomic.spinLoopHint();
-    }
-    pub fn unlock(m: *Mutex) void {
-        m.state.unlock();
-    }
-};
+// `std.atomic.Mutex` was removed from the standard library; its replacement is
+// `std.Thread.Mutex`, whose lock/unlock surface is identical to the hand-rolled
+// wrapper this replaces. The wrapper also busy-waited via `spinLoopHint`, burning
+// a core under contention; `std.Thread.Mutex` parks the thread instead. 81 other
+// files in this repo already use this form.
+const Mutex = std.Thread.Mutex;
 const Allocator = std.mem.Allocator;
 
 // ═══════════════════════════════════════════════════════════════════════