@runcore-sh/runcore 0.3.1 → 0.4.0

package/dist/runtime-lock.js

@@ -0,0 +1,147 @@
+/**
+ * Runtime Lock — PID file with port for instance discovery.
+ *
+ * On startup: writes brain/runtime/instance.json with pid, port, name, startedAt.
+ * On shutdown: deletes it.
+ * Discovery: other processes read the file to find running instances.
+ *
+ * Stale lock detection: if the PID in the file isn't running, the lock is stale
+ * and gets cleaned up automatically.
+ */
+import { writeFileSync, readFileSync, unlinkSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { BRAIN_DIR } from "./lib/paths.js";
+import { createLogger } from "./utils/logger.js";
+const log = createLogger("runtime-lock");
+const RUNTIME_DIR = join(BRAIN_DIR, "runtime");
+const LOCK_FILE = join(RUNTIME_DIR, "instance.json");
+/** Check if a process with the given PID is alive. */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0); // signal 0 = existence check, no kill
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write the runtime lock file. Call after the server starts
+ * and the actual port is known.
+ */
+export function acquireLock(port, name) {
+    mkdirSync(RUNTIME_DIR, { recursive: true });
+    // Check for existing lock — might be stale
+    const existing = readLock();
+    if (existing) {
+        if (isProcessAlive(existing.pid)) {
+            log.warn(`Another instance is already running (pid=${existing.pid}, port=${existing.port}, name=${existing.name})`);
+            // Don't block — multiple instances are valid (different brains, or intentional)
+        }
+        else {
+            log.info(`Cleaning stale lock from pid=${existing.pid}`);
+        }
+    }
+    const lock = {
+        pid: process.pid,
+        port,
+        name,
+        brainDir: BRAIN_DIR,
+        startedAt: new Date().toISOString(),
+    };
+    writeFileSync(LOCK_FILE, JSON.stringify(lock, null, 2));
+    log.info(`Lock acquired: pid=${lock.pid}, port=${lock.port}, name=${lock.name}`);
+    return lock;
+}
+/**
+ * Release the runtime lock file. Call during graceful shutdown.
+ * Only deletes if the lock belongs to this process (prevents
+ * a shutting-down instance from deleting a freshly-started one's lock).
+ */
+export function releaseLock() {
+    try {
+        const existing = readLock();
+        if (existing && existing.pid === process.pid) {
+            unlinkSync(LOCK_FILE);
+            log.info("Lock released");
+        }
+    }
+    catch {
+        // File already gone or unreadable — fine
+    }
+}
+/**
+ * Read the current lock file. Returns null if no lock exists
+ * or the file is malformed.
+ */
+export function readLock() {
+    try {
+        if (!existsSync(LOCK_FILE))
+            return null;
+        const raw = readFileSync(LOCK_FILE, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Discover a running instance from the lock file.
+ * Returns the lock if the process is alive, null otherwise.
+ * Cleans up stale locks automatically.
+ */
+export function discoverRunning() {
+    const lock = readLock();
+    if (!lock)
+        return null;
+    if (isProcessAlive(lock.pid)) {
+        return lock;
+    }
+    // Stale — clean up
+    try {
+        unlinkSync(LOCK_FILE);
+        log.info(`Cleaned stale lock: pid=${lock.pid}`);
+    }
+    catch { /* already gone */ }
+    return null;
+}
+/**
+ * Get the port from the last runtime lock, regardless of whether
+ * the process is still alive. Used for sticky port on restart.
+ * Returns 0 if no previous lock found.
+ */
+export function getLastPort() {
+    const lock = readLock();
+    return lock?.port ?? 0;
+}
+/**
+ * Discover running instances across multiple brain directories.
+ * Useful for finding all Core instances on this machine.
+ */
+export function discoverAll(brainDirs) {
+    const running = [];
+    for (const dir of brainDirs) {
+        const lockPath = join(dir, "runtime", "instance.json");
+        try {
+            if (!existsSync(lockPath))
+                continue;
+            const raw = readFileSync(lockPath, "utf-8");
+            const lock = JSON.parse(raw);
+            if (isProcessAlive(lock.pid)) {
+                running.push(lock);
+            }
+            else {
+                // Stale — clean up
+                try {
+                    unlinkSync(lockPath);
+                }
+                catch { /* ok */ }
+            }
+        }
+        catch {
+            // Skip unreadable
+        }
+    }
+    return running;
+}
+//# sourceMappingURL=runtime-lock.js.map

package/dist/runtime-lock.js.map

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

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwTH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAmiKD,iBAAe,KAAK,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,iBAAiB,EAAE,QAAQ,CAAA;CAAE,iBAihBxE;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqWH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AA2jMD,iBAAe,KAAK,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,iBAAiB,EAAE,QAAQ,CAAA;CAAE,iBAylBxE;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}