@intentic/constants 1.370.0 → 1.371.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/constants",
-  "version": "1.370.0",
+  "version": "1.371.0",
   "description": "Shared constants for the intentic packages, ports, paths, and image references the daemon, CLIs and desktop app all agree on",
   "license": "MIT",
   "type": "module",

package/src/dev-previews.d.mts

@@ -31,6 +31,7 @@ export const TOUCH_EVERY_MS: number;
 export function previewsDir(env?: Readonly<Record<string, string | undefined>>): string;
 export function recordName(conversation: string, label: string): string;
 export function recordPath(dir: string, conversation: string, label: string): string;
+export function openPreviewLog(dir: string, conversation: string, label: string): { readonly path: string; readonly fd: number };
 export function hostLabel(conversation: string): string;
 export function startTicksOf(pid: number, procRoot?: string): string | undefined;
 export function ownerOf(pid: number, procRoot?: string): string | undefined;

package/src/dev-previews.mjs

@@ -10,7 +10,7 @@
 // alive, must have started at the clock tick the record says (a reused pid fails that), and must carry the
 // conversation stamp (INTENTIC_TURN_OWNER) the record claims. A record written from another pid namespace (an agent
 // domain has its own) names a pid this reader cannot see, so it is neither trusted nor removed here.
-import { chmodSync, mkdirSync, readdirSync, readFileSync, readlinkSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { chmodSync, mkdirSync, mkdtempSync, openSync, readdirSync, readFileSync, readlinkSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { createServer } from "node:net";
 import { join } from "node:path";
 
@@ -45,13 +45,27 @@ export const recordPath = (dir, conversation, label) => join(dir, `${recordName(
 const stopPath = (dir, conversation, label) => join(dir, `${recordName(conversation, label)}${STOP_SUFFIX}`);
 const endedPath = (dir, conversation, label) => join(dir, `${recordName(conversation, label)}${ENDED_SUFFIX}`);
 
+// A restart replaces the old directory entry, then creates exclusively: a pre-planted symlink or hard link never
+// opens its target for truncation. A concurrent creator makes the open fail instead of following its entry.
+export const openPreviewLog = (dir, conversation, label) => {
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${recordName(conversation, label)}.log`);
+    rmSync(path, { force: true });
+    return { path, fd: openSync(path, "wx") };
+};
+
 // A conversation id as one DNS label, for its preview's hostname: `<label>.demo.localhost`.
-export const hostLabel = (conversation) =>
-    conversation
+export const hostLabel = (conversation) => {
+    const label = conversation
         .toLowerCase()
         .replaceAll(/[^a-z0-9-]+/gu, "-")
-        .replaceAll(/^-+|-+$/gu, "")
-        .slice(0, 63) || "preview";
+        .replace(/^-+/u, "");
+    let end = label.length;
+    while (label.charAt(end - 1) === "-") {
+        end -= 1;
+    }
+    return label.slice(0, Math.min(end, 63)) || "preview";
+};
 
 // Field 22 of /proc/<pid>/stat, the process's start time in clock ticks since boot. The command name (field 2) can
 // hold spaces and parentheses, so fields are counted after its closing parenthesis.
@@ -135,9 +149,14 @@ export const recordIsLive = (record, procRoot = "/proc") =>
 
 // Written whole and renamed into place, so a reader never sees half a file.
 const writeWhole = (path, text) => {
-    const temporary = `${path}.${String(process.pid)}.tmp`;
-    writeFileSync(temporary, text);
-    renameSync(temporary, path);
+    const staging = mkdtempSync(`${path}.`);
+    try {
+        const temporary = join(staging, "record");
+        writeFileSync(temporary, text, { flag: "wx" });
+        renameSync(temporary, path);
+    } finally {
+        rmSync(staging, { recursive: true, force: true });
+    }
 };
 
 // A dead record's stop note becomes its ended note: why it stopped, kept for the next start or listing to say.