feat: implement true lock-free bounded queues with committed flags

Replace ordered commit pattern (blocking while loops) with per-slot
committed flags for lock-free progress guarantees:

- Mupsic (MPSC): Add committed flags array, producers CAS reservedTail
  and mark committed without blocking. Consumer checks committed before
  reading. Uses head/tail distance for fullness to prevent wraparound.

- Sipmuc (SPMC): Add committed flags array, consumers CAS reservedHead
  and check committed before reading. Producer marks committed after
  writing. Uses committed flags for fullness check.

- Mupmuc (MPMC): Add MupmucProducer type that uses reservedHead for
  fullness check instead of head. This prevents livelock when consumers
  complete out-of-order causing head to lag behind reservedHead.

Key changes:
- committed: array[N, Atomic[bool]] per-slot flags signal data readiness
- Producers set committed[slot]=true after writing
- Consumers check committed[slot] before reading, clear after consuming
- Multi-consumer fullness uses reservedHead not head (avoids livelock)
- All threaded tests pass under high contention

This fixes race conditions where:
1. Ordered wait caused obstruction-free (not lock-free) behavior
2. Wraparound allowed producers to overwrite uncommitted slots
3. Stale head caused producers to think queue was full

Author: elijahr

examples/audio_buffer.nim

@@ -1,9 +1,3 @@
-# lockfreequeues
-# © Copyright 2020 Elijah Shaw-Rutschman
-#
-# See the file "LICENSE", included in this distribution for details about the
-# copyright.
-
 ## Audio Buffer Example
 ##
 ## Demonstrates using a bounded Sipsic (SPSC) queue for real-time audio processing.

examples/event_collector.nim

@@ -1,9 +1,3 @@
-# lockfreequeues
-# © Copyright 2020 Elijah Shaw-Rutschman
-#
-# See the file "LICENSE", included in this distribution for details about the
-# copyright.
-
 ## Event Collector Example
 ##
 ## Demonstrates using an unbounded Mupsic (MPSC) queue for collecting events

examples/job_scheduler.nim

@@ -1,9 +1,3 @@
-# lockfreequeues
-# © Copyright 2020 Elijah Shaw-Rutschman
-#
-# See the file "LICENSE", included in this distribution for details about the
-# copyright.
-
 ## Job Scheduler Example
 ##
 ## Demonstrates using an unbounded Mupmuc (MPMC) queue for a dynamic job

examples/mupmuc.nim

@@ -1,9 +1,3 @@
-# lockfreequeues
-# © Copyright 2020 Elijah Shaw-Rutschman
-#
-# See the file "LICENSE", included in this distribution for details about the
-# copyright.
-
 ## Example usage of Mupmuc, a multi-producer, multi-consumer (MPMC) bounded queue.
 
 import options

examples/mupsic.nim

@@ -1,9 +1,3 @@
-# lockfreequeues
-# © Copyright 2020 Elijah Shaw-Rutschman
-#
-# See the file "LICENSE", included in this distribution for details about the
-# copyright.
-
 ## Example usage of Mupsic, a multi-producer, single-consumer (MPSC) bounded queue.
 
 import options

examples/sipsic.nim

@@ -1,9 +1,3 @@
-# lockfreequeues
-# © Copyright 2020 Elijah Shaw-Rutschman
-#
-# See the file "LICENSE", included in this distribution for details about the
-# copyright.
-
 ## Example usage of Sipsic, a single-producer, single-consumer (SPSC) bounded queue.
 
 import options

examples/task_fanout.nim

@@ -1,9 +1,3 @@
-# lockfreequeues
-# © Copyright 2020 Elijah Shaw-Rutschman
-#
-# See the file "LICENSE", included in this distribution for details about the
-# copyright.
-
 ## Task Fan-Out Example
 ##
 ## Demonstrates using a bounded Sipmuc (SPMC) queue for distributing work

mkdocs.yml

@@ -48,7 +48,9 @@ plugins:
             docstring_style: rst
             show_source: true
             show_signature: true
-            heading_level: 2
+            heading_level: 3  # h3 so procs nest under h2 API section in TOC
+            source_url: https://github.com/elijahr/lockfreequeues
+            # source_ref auto-detected from git branch; set explicitly for releases
 
 markdown_extensions:
   - pymdownx.highlight:
@@ -63,6 +65,7 @@ markdown_extensions:
   - md_in_html
   - toc:
       permalink: true
+      toc_depth: 4  # Include h2, h3, h4 in right-side TOC
 
 nav:
   - Home: index.md
@@ -85,7 +88,9 @@ nav:
 
 watch:
   - docs
-  - src  # Reload when Nim source files change
+  - docs/api
+  - src
+  - src/lockfreequeues
 
 extra:
   version: