feat(discord): connector pilot for the Sage seat, reviewed candidate (#1509)

Zero-dependency Discord connector under packages/discord: binding validation, REST and gateway clients, pi engine adapter, journal with append-only inbox, outbox, admissions and notices, and a run.lock ownership record {pid, start, boot} whose identity is checked three ways and whose cleanup is gated by STOP. CLI check|run|stop|unlock via scripts/discord.sh; offline suite scripts/test-discord.sh (28 checks, 87 node tests). Reviewed by rev-code-02 on #1509 over nine rounds; approved exact tree 4e0feb6758c0a7e4a71483912a8e0d3e3ec95aef at comment 26170. Corrections (1) to (12) recorded in BUILD-LOG. No listener started, no token read, no Discord write; the live pilot follows this commit per the brief. Co-Authored-By: Claude Fable 5.1 <[email protected]>
2026-09-13 01:15:37 -05:00
parent b023841c8a
commit 786e379c49
34 changed files with 4641 additions and 1 deletions
@@ -0,0 +1,30 @@
+// Race participant for the lock tests: waits for the go file, then claims the
+// binding once. Prints "claimed" or "refused" on stdout and its pid on
+// stderr. A winner stays alive (holding the lock) until the done file
+// appears, then releases it.
+import { existsSync } from "node:fs";
+import { writePid, clearPid } from "../src/journal.mjs";
+
+const [dir, go, done] = process.argv.slice(2);
+function waitFor(path) {
+  const deadline = Date.now() + 10_000;
+  while (!existsSync(path)) {
+    if (Date.now() > deadline) { process.stderr.write(" timeout"); process.exit(2); }
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 2);
+  }
+}
+waitFor(go);
+process.stderr.write(String(process.pid));
+let claimed = false;
+try {
+  writePid(dir, process.pid);
+  claimed = true;
+  process.stdout.write("claimed\n");
+} catch (err) {
+  if (!/another connector is running|without an owner record|which is gone|cannot be verified|cannot be read|STOP is present/.test(err.message)) { process.stderr.write(" " + err.message); process.exit(1); }
+  process.stdout.write(/STOP is present/.test(err.message) ? "stopped\n" : "refused\n");
+}
+if (claimed) {
+  waitFor(done);
+  clearPid(dir, process.pid);
+}