pulseed 0.6.6 → 0.7.0

package/dist/base/utils/execFileNoThrow.js

@@ -1,130 +0,0 @@
-// ─── execFileNoThrow ───
-//
-// Thin wrapper around Node's execFile that never throws.
-// Returns { stdout, stderr, exitCode } on success/failure,
-// and { stdout: "", stderr: <message>, exitCode: null } on spawn errors.
-import { execFile, spawn } from "node:child_process";
-import { signalProcessGroup } from "./process-pid.js";
-const DEFAULT_TIMEOUT_MS = 10_000;
-const MAX_TIMEOUT_MS = 2_147_483_647;
-/**
- * Run a command with execFile and return its result without throwing.
- * On any error (spawn failure, timeout, non-zero exit), the error is
- * captured in the returned object rather than thrown.
- */
-export async function execFileNoThrow(cmd, args, options = {}) {
-    const { timeoutMs = DEFAULT_TIMEOUT_MS, cwd, env, signal, killProcessGroup = false } = options;
-    const timeoutError = validateTimeoutMs(timeoutMs);
-    if (timeoutError) {
-        return { stdout: "", stderr: timeoutError, exitCode: null };
-    }
-    if (killProcessGroup) {
-        return spawnNoThrow(cmd, args, { timeoutMs, cwd, env, signal });
-    }
-    return new Promise((resolve) => {
-        execFile(cmd, args, {
-            timeout: timeoutMs,
-            cwd,
-            env,
-            signal,
-            maxBuffer: 1024 * 1024, // 1 MB
-        }, (error, stdout, stderr) => {
-            if (error) {
-                // error.code is the exit code for non-zero exits; null for spawn errors
-                const exitCode = typeof error.code === "number"
-                    ? error.code
-                    : null;
-                resolve({ stdout: stdout ?? "", stderr: stderr ?? error.message, exitCode });
-                return;
-            }
-            resolve({ stdout, stderr, exitCode: 0 });
-        });
-    });
-}
-function validateTimeoutMs(timeoutMs) {
-    if (typeof timeoutMs === "number" &&
-        Number.isSafeInteger(timeoutMs) &&
-        timeoutMs >= 1 &&
-        timeoutMs <= MAX_TIMEOUT_MS) {
-        return null;
-    }
-    return `Invalid timeoutMs: expected a safe integer from 1 to ${MAX_TIMEOUT_MS} milliseconds`;
-}
-function spawnNoThrow(cmd, args, options) {
-    const detached = process.platform !== "win32";
-    return new Promise((resolve) => {
-        let forceKillTimer;
-        let stdout = "";
-        let stderr = "";
-        let settled = false;
-        const child = spawn(cmd, args, {
-            cwd: options.cwd,
-            env: options.env,
-            detached,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        const groupTimeoutTimer = setTimeout(abortChild, options.timeoutMs);
-        groupTimeoutTimer.unref?.();
-        const cleanup = () => {
-            options.signal?.removeEventListener("abort", abortChild);
-            clearTimeout(groupTimeoutTimer);
-            if (forceKillTimer)
-                clearTimeout(forceKillTimer);
-        };
-        const finish = (result) => {
-            if (settled)
-                return;
-            settled = true;
-            cleanup();
-            resolve(result);
-        };
-        child.stdout?.setEncoding("utf8");
-        child.stderr?.setEncoding("utf8");
-        child.stdout?.on("data", (chunk) => {
-            stdout += chunk;
-            if (stdout.length > 1024 * 1024)
-                stdout = stdout.slice(0, 1024 * 1024);
-        });
-        child.stderr?.on("data", (chunk) => {
-            stderr += chunk;
-            if (stderr.length > 1024 * 1024)
-                stderr = stderr.slice(0, 1024 * 1024);
-        });
-        child.on("error", (error) => {
-            finish({ stdout, stderr: stderr || error.message, exitCode: null });
-        });
-        child.on("close", (code, signalName) => {
-            finish({
-                stdout,
-                stderr: stderr || (signalName ? `Process terminated by ${signalName}` : ""),
-                exitCode: code,
-            });
-        });
-        const killChild = (killSignal) => {
-            if (detached && child.pid) {
-                try {
-                    const groupSignal = signalProcessGroup(child.pid, killSignal);
-                    if (groupSignal.status === "sent") {
-                        return;
-                    }
-                }
-                catch {
-                    // Fall back to the immediate child below.
-                }
-            }
-            child.kill(killSignal);
-        };
-        function abortChild() {
-            killChild("SIGTERM");
-            forceKillTimer = setTimeout(() => killChild("SIGKILL"), 1_000);
-            forceKillTimer.unref?.();
-        }
-        if (options.signal?.aborted) {
-            abortChild();
-        }
-        else {
-            options.signal?.addEventListener("abort", abortChild, { once: true });
-        }
-    });
-}
-//# sourceMappingURL=execFileNoThrow.js.map

package/dist/base/utils/execFileNoThrow.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execFileNoThrow.js","sourceRoot":"","sources":["../../../src/base/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,EAAE;AACF,yDAAyD;AACzD,2DAA2D;AAC3D,yEAAyE;AAEzE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,cAAc,GAAG,aAAa,CAAC;AAqBrC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,IAAc,EACd,UAA2B,EAAE;IAE7B,MAAM,EAAE,SAAS,GAAG,kBAAkB,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC/F,MAAM,YAAY,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;QAC7C,QAAQ,CACN,GAAG,EACH,IAAI,EACJ;YACE,OAAO,EAAE,SAAS;YAClB,GAAG;YACH,GAAG;YACH,MAAM;YACN,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO;SAChC,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,wEAAwE;gBACxE,MAAM,QAAQ,GACZ,OAAQ,KAAmD,CAAC,IAAI,KAAK,QAAQ;oBAC3E,CAAC,CAAE,KAAmD,CAAC,IAAK;oBAC5D,CAAC,CAAC,IAAI,CAAC;gBACX,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YACD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAkB;IAC3C,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAC/B,SAAS,IAAI,CAAC;QACd,SAAS,IAAI,cAAc,EAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,wDAAwD,cAAc,eAAe,CAAC;AAC/F,CAAC;AAED,SAAS,YAAY,CACnB,GAAW,EACX,IAAc,EACd,OAAuG;IAEvG,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAE9C,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;QAC7C,IAAI,cAAyD,CAAC;QAC9D,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,KAAK,CACjB,GAAG,EACH,IAAI,EACJ;YACE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ;YACR,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CACF,CAAC;QACF,MAAM,iBAAiB,GAAG,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACpE,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACzD,YAAY,CAAC,iBAAiB,CAAC,CAAC;YAChC,IAAI,cAAc;gBAAE,YAAY,CAAC,cAAc,CAAC,CAAC;QACnD,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,MAAsB,EAAQ,EAAE;YAC9C,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI;gBAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI;gBAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;YACrC,MAAM,CAAC;gBACL,MAAM;gBACN,MAAM,EAAE,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,CAAC,UAA0B,EAAQ,EAAE;YACrD,IAAI,QAAQ,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;oBAC9D,IAAI,WAAW,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;wBAClC,OAAO;oBACT,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,0CAA0C;gBAC5C,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,SAAS,UAAU;YACjB,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;YAC/D,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5B,UAAU,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/base/utils/json-io.d.ts

@@ -1,57 +0,0 @@
-import type { z } from "zod";
-interface WriteJsonFileAtomicOptions {
-    mode?: number;
-    directoryMode?: number;
-}
-interface JsonFileMutationLockOptions {
-    timeoutMs?: number;
-    retryDelayMs?: number;
-}
-export interface ReadTextFileWithinLimitOptions {
-    maxBytes: number;
-    chunkBytes?: number;
-    encoding?: BufferEncoding;
-}
-export declare class TextFileSizeLimitError extends Error {
-    readonly filePath: string;
-    readonly maxBytes: number;
-    readonly code = "ERR_PULSEED_TEXT_FILE_SIZE_LIMIT";
-    constructor(filePath: string, maxBytes: number);
-}
-export declare function isTextFileSizeLimitError(err: unknown): err is TextFileSizeLimitError;
-/**
- * Write data to a JSON file atomically (write to a unique .tmp, then rename).
- * Creates parent directories as needed.
- */
-export declare function writeJsonFileAtomic(filePath: string, data: unknown, options?: WriteJsonFileAtomicOptions): Promise<void>;
-export declare function withJsonFileMutationLock<T>(filePath: string, operation: () => Promise<T>, options?: JsonFileMutationLockOptions): Promise<T>;
-/**
- * Read a UTF-8 text file from a single opened descriptor while enforcing a byte cap.
- * The implementation reads at most maxBytes + 1 bytes, so callers can reject
- * oversized JSON before loading or parsing the whole file.
- */
-export declare function readTextFileWithinLimit(filePath: string, options: ReadTextFileWithinLimitOptions): Promise<string>;
-export declare function readTextFileWithinLimitSync(filePath: string, options: ReadTextFileWithinLimitOptions): string;
-/**
- * Read and parse a JSON file asynchronously.
- * Returns null on ENOENT or invalid JSON (does not throw).
- */
-export declare function readJsonFileOrNull<T = unknown>(filePath: string): Promise<T | null>;
-/**
- * Read, parse, and validate a JSON file against a Zod schema.
- * Returns null on ENOENT, invalid JSON, or schema validation failure (does not throw).
- */
-export declare function readJsonFileWithSchema<T>(filePath: string, schema: z.ZodType<T>): Promise<T | null>;
-/**
- * Read and parse a JSON file asynchronously.
- * Throws if the file does not exist or contains invalid JSON.
- * @deprecated Prefer readJsonFileOrNull
- */
-export declare function readJsonFile<T>(filePath: string): Promise<T>;
-/**
- * Write data to a JSON file asynchronously with 2-space indent.
- * @deprecated Prefer writeJsonFileAtomic
- */
-export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
-export {};
-//# sourceMappingURL=json-io.d.ts.map

package/dist/base/utils/json-io.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-io.d.ts","sourceRoot":"","sources":["../../../src/base/utils/json-io.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,UAAU,0BAA0B;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,2BAA2B;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAI7C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAJ3B,QAAQ,CAAC,IAAI,sCAAsC;gBAGxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAK5B;AAID,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,sBAAsB,CAEpF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,CAAC,CAAC,CA4BZ;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,8BAA8B,GACtC,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAezF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKnB;AAKD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGlE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF"}

package/dist/base/utils/json-io.js

@@ -1,226 +0,0 @@
-// ─── JSON IO Utilities ───
-//
-// Shared helpers for reading and writing JSON files.
-// Async versions (writeJsonFileAtomic, readJsonFileOrNull, readJsonFileWithSchema)
-// are preferred over the legacy sync-style async functions below.
-import * as fsp from "node:fs/promises";
-import * as fs from "node:fs";
-import { randomUUID } from "node:crypto";
-import { dirname } from "node:path";
-export class TextFileSizeLimitError extends Error {
-    filePath;
-    maxBytes;
-    code = "ERR_PULSEED_TEXT_FILE_SIZE_LIMIT";
-    constructor(filePath, maxBytes) {
-        super(`Refused to read ${filePath} because it exceeds ${maxBytes} bytes`);
-        this.filePath = filePath;
-        this.maxBytes = maxBytes;
-        this.name = "TextFileSizeLimitError";
-    }
-}
-const DEFAULT_BOUNDED_TEXT_READ_CHUNK_BYTES = 64 * 1024;
-export function isTextFileSizeLimitError(err) {
-    return err instanceof TextFileSizeLimitError;
-}
-/**
- * Write data to a JSON file atomically (write to a unique .tmp, then rename).
- * Creates parent directories as needed.
- */
-export async function writeJsonFileAtomic(filePath, data, options = {}) {
-    const parentDir = dirname(filePath);
-    await fsp.mkdir(parentDir, { recursive: true, mode: options.directoryMode });
-    if (options.directoryMode !== undefined) {
-        await fsp.chmod(parentDir, options.directoryMode).catch(() => undefined);
-    }
-    const tmpPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
-    try {
-        await fsp.writeFile(tmpPath, JSON.stringify(data, null, 2), {
-            encoding: "utf-8",
-            mode: options.mode,
-        });
-        if (options.mode !== undefined) {
-            await fsp.chmod(tmpPath, options.mode).catch(() => undefined);
-        }
-        await fsp.rename(tmpPath, filePath);
-        if (options.mode !== undefined) {
-            await fsp.chmod(filePath, options.mode).catch(() => undefined);
-        }
-    }
-    catch (err) {
-        try {
-            await fsp.unlink(tmpPath);
-        }
-        catch {
-            // Ignore cleanup errors
-        }
-        throw err;
-    }
-}
-export async function withJsonFileMutationLock(filePath, operation, options = {}) {
-    const timeoutMs = options.timeoutMs ?? 30_000;
-    const retryDelayMs = options.retryDelayMs ?? 10;
-    const lockPath = `${filePath}.lock`;
-    const startedAt = Date.now();
-    await fsp.mkdir(dirname(filePath), { recursive: true });
-    let lockHandle;
-    while (!lockHandle) {
-        try {
-            lockHandle = await fsp.open(lockPath, "wx");
-        }
-        catch (err) {
-            if (err.code !== "EEXIST")
-                throw err;
-            if (Date.now() - startedAt >= timeoutMs) {
-                throw new Error(`Timed out waiting for JSON mutation lock: ${lockPath}`);
-            }
-            await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
-        }
-    }
-    try {
-        return await operation();
-    }
-    finally {
-        await lockHandle.close();
-        await fsp.unlink(lockPath).catch((err) => {
-            if (err.code !== "ENOENT")
-                throw err;
-        });
-    }
-}
-/**
- * Read a UTF-8 text file from a single opened descriptor while enforcing a byte cap.
- * The implementation reads at most maxBytes + 1 bytes, so callers can reject
- * oversized JSON before loading or parsing the whole file.
- */
-export async function readTextFileWithinLimit(filePath, options) {
-    const normalized = normalizeBoundedTextReadOptions(options);
-    const handle = await fsp.open(filePath, "r");
-    try {
-        const { chunks, totalBytes } = await readChunksWithinLimit(async (buffer, length) => {
-            const { bytesRead } = await handle.read(buffer, 0, length, null);
-            return bytesRead;
-        }, filePath, normalized.maxBytes, normalized.chunkBytes);
-        return Buffer.concat(chunks, totalBytes).toString(normalized.encoding);
-    }
-    finally {
-        await handle.close();
-    }
-}
-export function readTextFileWithinLimitSync(filePath, options) {
-    const normalized = normalizeBoundedTextReadOptions(options);
-    const fd = fs.openSync(filePath, "r");
-    try {
-        const { chunks, totalBytes } = readChunksWithinLimitSync((buffer, length) => fs.readSync(fd, buffer, 0, length, null), filePath, normalized.maxBytes, normalized.chunkBytes);
-        return Buffer.concat(chunks, totalBytes).toString(normalized.encoding);
-    }
-    finally {
-        fs.closeSync(fd);
-    }
-}
-/**
- * Read and parse a JSON file asynchronously.
- * Returns null on ENOENT or invalid JSON (does not throw).
- */
-export async function readJsonFileOrNull(filePath) {
-    let content;
-    try {
-        content = await fsp.readFile(filePath, "utf-8");
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return null;
-        throw err;
-    }
-    try {
-        return JSON.parse(content);
-    }
-    catch (err) {
-        if (err instanceof SyntaxError)
-            return null;
-        throw err;
-    }
-}
-/**
- * Read, parse, and validate a JSON file against a Zod schema.
- * Returns null on ENOENT, invalid JSON, or schema validation failure (does not throw).
- */
-export async function readJsonFileWithSchema(filePath, schema) {
-    const raw = await readJsonFileOrNull(filePath);
-    if (raw === null)
-        return null;
-    const result = schema.safeParse(raw);
-    return result.success ? result.data : null;
-}
-// ─── Legacy helpers (async, kept for backward compatibility) ───
-// Prefer the atomic/null-safe versions above for new code.
-/**
- * Read and parse a JSON file asynchronously.
- * Throws if the file does not exist or contains invalid JSON.
- * @deprecated Prefer readJsonFileOrNull
- */
-export async function readJsonFile(filePath) {
-    const content = await fsp.readFile(filePath, "utf-8");
-    return JSON.parse(content);
-}
-/**
- * Write data to a JSON file asynchronously with 2-space indent.
- * @deprecated Prefer writeJsonFileAtomic
- */
-export async function writeJsonFile(filePath, data) {
-    await fsp.writeFile(filePath, JSON.stringify(data, null, 2), "utf-8");
-}
-function normalizeBoundedTextReadOptions(options) {
-    if (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 0 || options.maxBytes >= Number.MAX_SAFE_INTEGER) {
-        throw new RangeError("maxBytes must be a nonnegative safe integer below Number.MAX_SAFE_INTEGER");
-    }
-    const chunkBytes = options.chunkBytes ?? DEFAULT_BOUNDED_TEXT_READ_CHUNK_BYTES;
-    if (!Number.isSafeInteger(chunkBytes) || chunkBytes <= 0) {
-        throw new RangeError("chunkBytes must be a positive safe integer");
-    }
-    return {
-        maxBytes: options.maxBytes,
-        chunkBytes,
-        encoding: options.encoding ?? "utf-8",
-    };
-}
-async function readChunksWithinLimit(read, filePath, maxBytes, chunkBytes) {
-    const chunks = [];
-    const buffer = Buffer.allocUnsafe(Math.min(chunkBytes, maxBytes + 1));
-    let totalBytes = 0;
-    while (true) {
-        const remainingBytes = maxBytes + 1 - totalBytes;
-        if (remainingBytes <= 0) {
-            throw new TextFileSizeLimitError(filePath, maxBytes);
-        }
-        const bytesRead = await read(buffer, Math.min(buffer.byteLength, remainingBytes));
-        if (bytesRead === 0)
-            break;
-        totalBytes += bytesRead;
-        if (totalBytes > maxBytes) {
-            throw new TextFileSizeLimitError(filePath, maxBytes);
-        }
-        chunks.push(Buffer.from(buffer.subarray(0, bytesRead)));
-    }
-    return { chunks, totalBytes };
-}
-function readChunksWithinLimitSync(read, filePath, maxBytes, chunkBytes) {
-    const chunks = [];
-    const buffer = Buffer.allocUnsafe(Math.min(chunkBytes, maxBytes + 1));
-    let totalBytes = 0;
-    while (true) {
-        const remainingBytes = maxBytes + 1 - totalBytes;
-        if (remainingBytes <= 0) {
-            throw new TextFileSizeLimitError(filePath, maxBytes);
-        }
-        const bytesRead = read(buffer, Math.min(buffer.byteLength, remainingBytes));
-        if (bytesRead === 0)
-            break;
-        totalBytes += bytesRead;
-        if (totalBytes > maxBytes) {
-            throw new TextFileSizeLimitError(filePath, maxBytes);
-        }
-        chunks.push(Buffer.from(buffer.subarray(0, bytesRead)));
-    }
-    return { chunks, totalBytes };
-}
-//# sourceMappingURL=json-io.js.map

package/dist/base/utils/json-io.js.map

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

package/dist/base/utils/package-metadata.d.ts

@@ -1,10 +0,0 @@
-export interface PackageMetadata {
-    name: string;
-    description: string;
-    scripts: Record<string, string>;
-    dependencies: Record<string, string>;
-}
-export declare function createEmptyPackageMetadata(): PackageMetadata;
-export declare function parsePackageMetadata(raw: string): PackageMetadata | null;
-export declare function formatNodePackageMetadataContext(metadata: PackageMetadata): string;
-//# sourceMappingURL=package-metadata.d.ts.map

package/dist/base/utils/package-metadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-metadata.d.ts","sourceRoot":"","sources":["../../../src/base/utils/package-metadata.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,wBAAgB,0BAA0B,IAAI,eAAe,CAE5D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAqBxE;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAMlF"}

package/dist/base/utils/package-metadata.js

@@ -1,40 +0,0 @@
-import { z } from "zod";
-const PackageStringRecordSchema = z.record(z.string(), z.string());
-const PackageManifestShapeSchema = z.object({
-    name: z.unknown().optional(),
-    description: z.unknown().optional(),
-    scripts: z.unknown().optional(),
-    dependencies: z.unknown().optional(),
-}).passthrough();
-export function createEmptyPackageMetadata() {
-    return { name: "", description: "", scripts: {}, dependencies: {} };
-}
-export function parsePackageMetadata(raw) {
-    let decoded;
-    try {
-        decoded = JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-    const manifest = PackageManifestShapeSchema.safeParse(decoded);
-    if (!manifest.success) {
-        return null;
-    }
-    const scripts = PackageStringRecordSchema.safeParse(manifest.data.scripts);
-    const dependencies = PackageStringRecordSchema.safeParse(manifest.data.dependencies);
-    return {
-        name: typeof manifest.data.name === "string" ? manifest.data.name : "",
-        description: typeof manifest.data.description === "string" ? manifest.data.description : "",
-        scripts: scripts.success ? scripts.data : {},
-        dependencies: dependencies.success ? dependencies.data : {},
-    };
-}
-export function formatNodePackageMetadataContext(metadata) {
-    const scripts = Object.keys(metadata.scripts).join(", ");
-    const prefix = metadata.name ? `Node.js project '${metadata.name}'` : "Node.js project";
-    const description = metadata.description ? `. ${metadata.description}` : "";
-    const scriptsPart = scripts ? `. Scripts: ${scripts}` : "";
-    return `${prefix}${description}${scriptsPart}`;
-}
-//# sourceMappingURL=package-metadata.js.map

package/dist/base/utils/package-metadata.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-metadata.js","sourceRoot":"","sources":["../../../src/base/utils/package-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACnE,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC,WAAW,EAAE,CAAC;AASjB,MAAM,UAAU,0BAA0B;IACxC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,yBAAyB,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,yBAAyB,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrF,OAAO;QACL,IAAI,EAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QACtE,WAAW,EAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;QAC3F,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC5C,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,QAAyB;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACxF,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC;AACjD,CAAC"}

package/dist/base/utils/paths.d.ts

@@ -1,26 +0,0 @@
-/**
- * Returns the PulSeed base directory.
- * Defaults to ~/.pulseed; can be overridden via PULSEED_HOME env var.
- */
-export declare function getPulseedDirPath(): string;
-/**
- * Returns the default PulSeed-managed mutable workspace root.
- * PULSEED_WORKSPACE_ROOT overrides the default ~/PulSeedWorkspaces location.
- */
-export declare function getDefaultPulseedWorkspaceRootPath(): string;
-export declare function getGoalsDir(base?: string): string;
-export declare function getEventsDir(base?: string): string;
-export declare function getStateDir(base?: string): string;
-export declare function getControlDatabasePath(base?: string): string;
-export declare function getArchiveDir(base?: string): string;
-export declare function getPluginsDir(base?: string): string;
-export declare function getPromotedPluginsDir(base?: string): string;
-export declare function getGatewayDir(base?: string): string;
-export declare function getGatewayChannelsDir(base?: string): string;
-export declare function getGatewayChannelDir(channelName: string, base?: string): string;
-export declare function getSkillsDir(base?: string): string;
-export declare function getLogsDir(base?: string): string;
-export declare function getDatasourcesDir(base?: string): string;
-export declare function getScheduleDir(base?: string): string;
-export declare function getReportsDir(base?: string): string;
-//# sourceMappingURL=paths.d.ts.map

package/dist/base/utils/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/base/utils/paths.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/base/utils/paths.js

@@ -1,66 +0,0 @@
-// ─── PulSeed Path Utilities ───
-//
-// Centralizes ~/.pulseed path construction.
-// PULSEED_HOME env var overrides the default ~/.pulseed location.
-import * as os from "node:os";
-import * as path from "node:path";
-/**
- * Returns the PulSeed base directory.
- * Defaults to ~/.pulseed; can be overridden via PULSEED_HOME env var.
- */
-export function getPulseedDirPath() {
-    return process.env["PULSEED_HOME"] ?? path.join(os.homedir(), ".pulseed");
-}
-/**
- * Returns the default PulSeed-managed mutable workspace root.
- * PULSEED_WORKSPACE_ROOT overrides the default ~/PulSeedWorkspaces location.
- */
-export function getDefaultPulseedWorkspaceRootPath() {
-    return process.env["PULSEED_WORKSPACE_ROOT"] ?? path.join(os.homedir(), "PulSeedWorkspaces");
-}
-export function getGoalsDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "goals");
-}
-export function getEventsDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "events");
-}
-export function getStateDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "state");
-}
-export function getControlDatabasePath(base) {
-    return path.join(getStateDir(base), "pulseed-control.sqlite");
-}
-export function getArchiveDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "archive");
-}
-export function getPluginsDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "plugins");
-}
-export function getPromotedPluginsDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "plugins-promoted-to-core");
-}
-export function getGatewayDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "gateway");
-}
-export function getGatewayChannelsDir(base) {
-    return path.join(getGatewayDir(base), "channels");
-}
-export function getGatewayChannelDir(channelName, base) {
-    return path.join(getGatewayChannelsDir(base), channelName);
-}
-export function getSkillsDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "skills");
-}
-export function getLogsDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "logs");
-}
-export function getDatasourcesDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "datasources");
-}
-export function getScheduleDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "schedule");
-}
-export function getReportsDir(base) {
-    return path.join(base ?? getPulseedDirPath(), "reports");
-}
-//# sourceMappingURL=paths.js.map

package/dist/base/utils/paths.js.map

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

package/dist/base/utils/process-pid.d.ts

@@ -1,15 +0,0 @@
-export declare function isProcessPidValue(value: unknown): value is number;
-export declare function parseProcessPid(raw: string): number | null;
-export type ProcessSignalResult = {
-    status: "sent";
-    pid: number;
-} | {
-    status: "unsafe_pid";
-} | {
-    status: "missing_process";
-    pid: number;
-};
-export type ProcessSignal = NodeJS.Signals | 0;
-export declare function signalProcessPid(pid: unknown, signal: ProcessSignal): ProcessSignalResult;
-export declare function signalProcessGroup(pid: unknown, signal: NodeJS.Signals): ProcessSignalResult;
-//# sourceMappingURL=process-pid.d.ts.map

package/dist/base/utils/process-pid.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"process-pid.d.ts","sourceRoot":"","sources":["../../../src/base/utils/process-pid.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEjE;AAMD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1D;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;AAE/C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,mBAAmB,CAMzF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,mBAAmB,CAM5F"}