@kal-elsam/kairo-runtime 0.5.0 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kal-elsam/kairo-runtime",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Kairo Runtime — local agent operating system for Codex, Cursor, Claude, Gemini, Copilot, Engram, and Graphify.",
   "type": "module",
   "homepage": "https://github.com/Kal-elSam/harness#readme",

package/src/global/runtime/run-cancel-signal.js

@@ -1,6 +1,7 @@
 import { existsSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readFile } from "node:fs/promises";
 import { runPaths } from "../paths.js";
+import { writeAtomicJson } from "./write-atomic-json.js";
 
 function cancelSignalPath(homeDir, runId) {
   return `${runPaths(homeDir, runId).runDir}/cancel.signal.json`;
@@ -9,7 +10,7 @@ function cancelSignalPath(homeDir, runId) {
 export async function writeCancelSignal(homeDir, runId, payload) {
   const { runDir } = runPaths(homeDir, runId);
   await mkdir(runDir, { recursive: true });
-  await writeFile(cancelSignalPath(homeDir, runId), `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+  await writeAtomicJson(cancelSignalPath(homeDir, runId), payload);
 }
 
 export async function readCancelSignal(homeDir, runId) {

package/src/global/runtime/run-store.js

@@ -1,8 +1,9 @@
 import { existsSync } from "node:fs";
-import { appendFile, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { appendFile, mkdir, readdir, readFile } from "node:fs/promises";
 import { harnessHomePaths, runPaths } from "../paths.js";
 import { RUN_STATES, isActiveRunState } from "./run-types.js";
 import { createRunEvent } from "./run-events.js";
+import { writeAtomicJson } from "./write-atomic-json.js";
 
 const writeLocks = new Map();
 
@@ -13,7 +14,7 @@ export function getRunsDir(homeDir) {
 export async function createRunRecord(homeDir, metadata) {
   const { runDir, statePath } = runPaths(homeDir, metadata.runId);
   await mkdir(runDir, { recursive: true });
-  await writeFile(statePath, `${JSON.stringify(metadata, null, 2)}\n`, "utf8");
+  await writeAtomicJson(statePath, metadata);
   return metadata;
 }
 
@@ -34,7 +35,7 @@ export async function writeRunState(homeDir, metadata) {
   const next = previous.then(async () => {
     const { statePath, runDir } = runPaths(homeDir, metadata.runId);
     await mkdir(runDir, { recursive: true });
-    await writeFile(statePath, `${JSON.stringify(metadata, null, 2)}\n`, "utf8");
+    await writeAtomicJson(statePath, metadata);
     return metadata;
   });
   writeLocks.set(key, next.catch(() => {}));

package/src/global/runtime/run-supervisor-lock.js

@@ -1,6 +1,7 @@
 import { existsSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readFile } from "node:fs/promises";
 import { runPaths } from "../paths.js";
+import { writeAtomicJson } from "./write-atomic-json.js";
 
 function lockPath(homeDir, runId) {
   return `${runPaths(homeDir, runId).runDir}/supervisor.lock.json`;
@@ -9,7 +10,7 @@ function lockPath(homeDir, runId) {
 export async function writeSupervisorLock(homeDir, runId, lock) {
   const { runDir } = runPaths(homeDir, runId);
   await mkdir(runDir, { recursive: true });
-  await writeFile(lockPath(homeDir, runId), `${JSON.stringify(lock, null, 2)}\n`, "utf8");
+  await writeAtomicJson(lockPath(homeDir, runId), lock);
 }
 
 export async function readSupervisorLock(homeDir, runId) {

package/src/global/runtime/write-atomic-json.js

@@ -0,0 +1,51 @@
+import { open as fsOpen, rename as fsRename, unlink as fsUnlink } from "node:fs/promises";
+import { constants } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { randomBytes } from "node:crypto";
+
+function defaultTempPath(targetPath) {
+  const id = randomBytes(8).toString("hex");
+  return join(
+    dirname(targetPath),
+    `.${basename(targetPath)}.${process.pid}.${id}.tmp`
+  );
+}
+
+/**
+ * Atomically replace targetPath with pretty-printed JSON.
+ * Creates a unique temp in the same directory (O_EXCL), writes + fsync,
+ * renames over the destination, and deletes the temp on any failure.
+ */
+export async function writeAtomicJson(targetPath, value, deps = {}) {
+  const open = deps.open ?? fsOpen;
+  const rename = deps.rename ?? fsRename;
+  const unlink = deps.unlink ?? fsUnlink;
+  const createTempPath = deps.createTempPath ?? defaultTempPath;
+
+  const payload = `${JSON.stringify(value, null, 2)}\n`;
+  const tempPath = createTempPath(targetPath);
+  let handle;
+
+  try {
+    handle = await open(tempPath, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, 0o644);
+    await handle.writeFile(payload, "utf8");
+    await handle.sync();
+    await handle.close();
+    handle = undefined;
+    await rename(tempPath, targetPath);
+  } catch (error) {
+    if (handle) {
+      try {
+        await handle.close();
+      } catch {
+        // Best-effort close before temp cleanup.
+      }
+    }
+    try {
+      await unlink(tempPath);
+    } catch {
+      // Temp may not exist yet or already renamed.
+    }
+    throw error;
+  }
+}