@openrig/cli 0.4.6 → 0.4.8

package/dist/slack/state-store.js

@@ -0,0 +1,132 @@
+// Slice-11 slack-connector — durable, restart-surviving state.
+//
+// Two append-only JSONL stores, both written to disk so they survive BOTH a
+// connector restart AND a queue-daemon restart (locked item 2 + item 8):
+//   - SeenStore     : delivery-dedup by id; a line is appended ONLY AFTER the
+//                     side effect succeeds (outbound: after a 200 from Slack;
+//                     inbound: after the durable qitem exists). At-least-once —
+//                     a crash between success and append re-delivers a
+//                     BYTE-IDENTICAL duplicate next run, never a drop.
+//   - DeadLetterStore : the inbound never-drop net. An event that fails to land
+//                     in the queue is appended (attempt-counted) BEFORE the
+//                     failure path returns; drain() truncates and hands the
+//                     lines back so the caller re-appends any that fail again
+//                     ("zero-drop means zero, not zero-until-the-second-failure").
+//
+// FS + clock are injected so the whole thing is unit-testable with no real disk.
+import fs from "node:fs";
+import path from "node:path";
+export const nodeStateFs = {
+    readFileSync: (p) => fs.readFileSync(p, "utf8"),
+    appendFileSync: (p, d) => fs.appendFileSync(p, d),
+    writeFileSync: (p, d) => fs.writeFileSync(p, d),
+    rename: (from, to) => fs.renameSync(from, to),
+    mkdirp: (dir) => {
+        fs.mkdirSync(dir, { recursive: true });
+    },
+};
+function parseLines(raw) {
+    return raw
+        .trim()
+        .split("\n")
+        .filter(Boolean)
+        .map((l) => {
+        try {
+            return JSON.parse(l);
+        }
+        catch {
+            return null; // tolerate a torn final line from a crash mid-append
+        }
+    })
+        .filter((x) => x !== null);
+}
+/**
+ * Delivery-dedup log. `load()` reads the durable set from disk; `mark()` appends
+ * AFTER the guarded side effect. Idempotent on id: a repeated id collapses in
+ * `load()`'s Set, and callers gate the side effect on `!seen.has(id)` so a
+ * duplicate is never re-delivered within a run.
+ */
+export class SeenStore {
+    file;
+    fsops;
+    now;
+    constructor(file, fsops = nodeStateFs, now = () => new Date()) {
+        this.file = file;
+        this.fsops = fsops;
+        this.now = now;
+    }
+    load() {
+        let raw;
+        try {
+            raw = this.fsops.readFileSync(this.file);
+        }
+        catch {
+            return new Set();
+        }
+        return new Set(parseLines(raw).map((r) => r.id).filter((id) => typeof id === "string"));
+    }
+    /** Append a seen record. MUST be called only after the guarded side effect succeeds. */
+    mark(id, status) {
+        this.fsops.mkdirp(path.dirname(this.file));
+        this.fsops.appendFileSync(this.file, JSON.stringify({ id, ts: this.now().toISOString(), status }) + "\n");
+    }
+    /**
+     * Seed existing ids as already-seen WITHOUT triggering the side effect
+     * (locked item 9: enable-time backlog seeds as history, zero replay storm).
+     */
+    seed(ids, status = "seeded") {
+        if (ids.length === 0)
+            return 0;
+        this.fsops.mkdirp(path.dirname(this.file));
+        const at = this.now().toISOString();
+        const chunk = ids.map((id) => JSON.stringify({ id, ts: at, status })).join("\n") + "\n";
+        this.fsops.appendFileSync(this.file, chunk);
+        return ids.length;
+    }
+}
+/**
+ * Inbound never-drop net. Every event that fails to land is appended
+ * (attempt-counted) BEFORE the error path returns.
+ *
+ * INTERRUPTION-SAFE retry (the B2 fix): retry does NOT truncate first. The
+ * caller `readAll()`s (non-destructive), attempts each, then `replaceAll()`s the
+ * file with ONLY the still-failing entries via an atomic temp-write + rename. So
+ * the durable file always reflects the unrecovered set: a crash at ANY point
+ * before the rename leaves the ORIGINAL file fully intact (at-least-once — a
+ * since-landed event is skipped on re-read via the seen-set, so not even a dup).
+ * There is no truncate-before-success window.
+ */
+export class DeadLetterStore {
+    file;
+    fsops;
+    now;
+    constructor(file, fsops = nodeStateFs, now = () => new Date()) {
+        this.file = file;
+        this.fsops = fsops;
+        this.now = now;
+    }
+    append(ev, attempts) {
+        this.fsops.mkdirp(path.dirname(this.file));
+        this.fsops.appendFileSync(this.file, JSON.stringify({ ev, at: this.now().toISOString(), attempts }) + "\n");
+    }
+    /** Non-destructive read of all durable entries. */
+    readAll() {
+        let raw;
+        try {
+            raw = this.fsops.readFileSync(this.file);
+        }
+        catch {
+            return [];
+        }
+        return parseLines(raw);
+    }
+    /** Atomically replace the durable set (temp-write + rename). Used after a retry pass. */
+    replaceAll(entries) {
+        this.fsops.mkdirp(path.dirname(this.file));
+        const body = entries.map((e) => JSON.stringify(e)).join("\n") + (entries.length ? "\n" : "");
+        const tmp = `${this.file}.tmp`;
+        this.fsops.writeFileSync(tmp, body);
+        this.fsops.rename(tmp, this.file); // atomic: original intact until this instant
+    }
+}
+//# sourceMappingURL=state-store.js.map

package/dist/slack/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../src/slack/state-store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrig/cli",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "type": "module",
   "description": "Local control plane for multi-agent coding topologies",
   "keywords": [