neurain 0.1.0-alpha.0

package/src/core/queue_write.mjs

@@ -0,0 +1,28 @@
+// Writeback-queue write primitives (W-B). The single place that appends to or
+// rewrites the flat root writeback queue, always under the durable lock. Capture
+// (B4) appends a row here; complete (B4) and queue-archive (B3) rewrite rows here.
+// The append is LOCKED — a deliberate fix over the vault capture's unserialized
+// appendText, while the per-row bytes stay identical so later parity holds.
+import path from 'node:path';
+import { appendJsonlLocked, rewriteJsonlLocked } from './durable.mjs';
+
+function queueAbs(root, vaultCfg, queueRel) {
+  return path.join(root, queueRel || vaultCfg.writeback_queue);
+}
+
+// Append a fully-formed queue row. The caller owns the row shape (capture builds
+// it); this only guarantees the append is atomic against concurrent writers.
+export function appendQueueRow(root, vaultCfg, row, { queueRel } = {}) {
+  const abs = queueAbs(root, vaultCfg, queueRel);
+  const appended = appendJsonlLocked(abs, [row]);
+  return { queue_path: path.relative(root, abs).split(path.sep).join('/'), appended };
+}
+
+// Read-modify-write the queue under one lock. `mutate(rows)` receives the rows as
+// they exist at lock time and returns the next array, so a row appended between a
+// caller's earlier read and this rewrite is never lost.
+export function rewriteQueueLocked(root, vaultCfg, mutate, { queueRel } = {}) {
+  const abs = queueAbs(root, vaultCfg, queueRel);
+  const next = rewriteJsonlLocked(abs, mutate);
+  return { queue_path: path.relative(root, abs).split(path.sep).join('/'), rows: next.length };
+}