pulseed 0.3.0 → 0.4.1

package/dist/runtime/store/approval-store.js

@@ -0,0 +1,119 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { RuntimeJournal } from "./runtime-journal.js";
+import { ApprovalRecordSchema, ApprovalStateSchema, } from "./runtime-schemas.js";
+import { createRuntimeStorePaths, } from "./runtime-paths.js";
+export class ApprovalStore {
+    paths;
+    journal;
+    constructor(runtimeRootOrPaths) {
+        this.paths =
+            typeof runtimeRootOrPaths === "string"
+                ? createRuntimeStorePaths(runtimeRootOrPaths)
+                : runtimeRootOrPaths ?? createRuntimeStorePaths();
+        this.journal = new RuntimeJournal(this.paths);
+    }
+    async sleep(ms) {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    lockPath(approvalId) {
+        return path.join(this.paths.approvalsDir, "locks", `${approvalId}.lock`);
+    }
+    async withApprovalLock(approvalId, fn) {
+        const lockPath = this.lockPath(approvalId);
+        const staleAfterMs = 30_000;
+        for (;;) {
+            try {
+                await fsp.mkdir(path.dirname(lockPath), { recursive: true });
+                const handle = await fsp.open(lockPath, "wx");
+                await handle.writeFile(JSON.stringify({ pid: process.pid, acquired_at: Date.now() }));
+                try {
+                    return await fn();
+                }
+                finally {
+                    await handle.close();
+                    await fsp.unlink(lockPath).catch(() => undefined);
+                }
+            }
+            catch (err) {
+                if (err.code !== "EEXIST")
+                    throw err;
+                try {
+                    const stat = await fsp.stat(lockPath);
+                    if (Date.now() - stat.mtimeMs > staleAfterMs) {
+                        await fsp.unlink(lockPath);
+                        continue;
+                    }
+                }
+                catch (staleErr) {
+                    if (staleErr.code === "ENOENT")
+                        continue;
+                    throw staleErr;
+                }
+                await this.sleep(10);
+            }
+        }
+    }
+    async ensureReady() {
+        await this.journal.ensureReady();
+    }
+    async load(approvalId) {
+        return (await this.loadResolved(approvalId)) ?? (await this.loadPending(approvalId));
+    }
+    async loadPending(approvalId) {
+        return this.journal.load(this.paths.approvalPendingPath(approvalId), ApprovalRecordSchema);
+    }
+    async loadResolved(approvalId) {
+        return this.journal.load(this.paths.approvalResolvedPath(approvalId), ApprovalRecordSchema);
+    }
+    async listPending() {
+        const pending = await this.journal.list(this.paths.approvalsPendingDir, ApprovalRecordSchema);
+        const filtered = [];
+        for (const record of pending) {
+            const resolved = await this.loadResolved(record.approval_id);
+            if (resolved === null)
+                filtered.push(record);
+        }
+        return filtered;
+    }
+    async listResolved() {
+        return this.journal.list(this.paths.approvalsResolvedDir, ApprovalRecordSchema);
+    }
+    async savePending(record) {
+        const parsed = ApprovalRecordSchema.parse({ ...record, state: "pending" });
+        return this.withApprovalLock(parsed.approval_id, async () => {
+            const resolved = await this.loadResolved(parsed.approval_id);
+            if (resolved !== null)
+                return resolved;
+            await this.journal.save(this.paths.approvalPendingPath(parsed.approval_id), ApprovalRecordSchema, parsed);
+            return parsed;
+        });
+    }
+    async saveResolved(record) {
+        const parsed = ApprovalRecordSchema.parse({
+            ...record,
+            state: ApprovalStateSchema.parse(record.state),
+            resolved_at: record.resolved_at ?? Date.now(),
+        });
+        await this.journal.save(this.paths.approvalResolvedPath(parsed.approval_id), ApprovalRecordSchema, parsed);
+        return parsed;
+    }
+    async resolvePending(approvalId, update) {
+        return this.withApprovalLock(approvalId, async () => {
+            const current = await this.loadPending(approvalId);
+            if (current === null)
+                return this.loadResolved(approvalId);
+            const resolved = ApprovalRecordSchema.parse({
+                ...current,
+                ...update,
+                approval_id: current.approval_id,
+                state: ApprovalStateSchema.parse(update.state),
+                resolved_at: update.resolved_at ?? Date.now(),
+            });
+            await this.saveResolved(resolved);
+            await this.journal.remove(this.paths.approvalPendingPath(approvalId));
+            return resolved;
+        });
+    }
+}
+//# sourceMappingURL=approval-store.js.map

package/dist/runtime/store/approval-store.js.map

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

package/dist/runtime/store/health-store.d.ts

@@ -0,0 +1,16 @@
+import { type RuntimeComponentsHealth, type RuntimeDaemonHealth, type RuntimeHealthSnapshot } from "./runtime-schemas.js";
+import { type RuntimeStorePaths } from "./runtime-paths.js";
+export declare class RuntimeHealthStore {
+    private readonly paths;
+    private readonly journal;
+    constructor(runtimeRootOrPaths?: string | RuntimeStorePaths);
+    ensureReady(): Promise<void>;
+    loadDaemonHealth(): Promise<RuntimeDaemonHealth | null>;
+    saveDaemonHealth(health: RuntimeDaemonHealth): Promise<RuntimeDaemonHealth>;
+    loadComponentsHealth(): Promise<RuntimeComponentsHealth | null>;
+    saveComponentsHealth(health: RuntimeComponentsHealth): Promise<RuntimeComponentsHealth>;
+    loadSnapshot(): Promise<RuntimeHealthSnapshot | null>;
+    saveSnapshot(snapshot: RuntimeHealthSnapshot): Promise<RuntimeHealthSnapshot>;
+    summarizeStatus(components: Record<string, RuntimeHealthSnapshot["status"]>): RuntimeHealthSnapshot["status"];
+}
+//# sourceMappingURL=health-store.d.ts.map

package/dist/runtime/store/health-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/health-store.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAQrD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAIvD,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAM3E,oBAAoB,IAAI,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAI/D,oBAAoB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAMvF,YAAY,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAerD,YAAY,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiBnF,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC,GAAG,qBAAqB,CAAC,QAAQ,CAAC;CAG9G"}

package/dist/runtime/store/health-store.js

@@ -0,0 +1,68 @@
+import { RuntimeJournal } from "./runtime-journal.js";
+import { RuntimeComponentsHealthSchema, RuntimeDaemonHealthSchema, RuntimeHealthSnapshotSchema, summarizeRuntimeHealthStatus, } from "./runtime-schemas.js";
+import { createRuntimeStorePaths, } from "./runtime-paths.js";
+export class RuntimeHealthStore {
+    paths;
+    journal;
+    constructor(runtimeRootOrPaths) {
+        this.paths =
+            typeof runtimeRootOrPaths === "string"
+                ? createRuntimeStorePaths(runtimeRootOrPaths)
+                : runtimeRootOrPaths ?? createRuntimeStorePaths();
+        this.journal = new RuntimeJournal(this.paths);
+    }
+    async ensureReady() {
+        await this.journal.ensureReady();
+    }
+    async loadDaemonHealth() {
+        return this.journal.load(this.paths.daemonHealthPath, RuntimeDaemonHealthSchema);
+    }
+    async saveDaemonHealth(health) {
+        const parsed = RuntimeDaemonHealthSchema.parse(health);
+        await this.journal.save(this.paths.daemonHealthPath, RuntimeDaemonHealthSchema, parsed);
+        return parsed;
+    }
+    async loadComponentsHealth() {
+        return this.journal.load(this.paths.componentsHealthPath, RuntimeComponentsHealthSchema);
+    }
+    async saveComponentsHealth(health) {
+        const parsed = RuntimeComponentsHealthSchema.parse(health);
+        await this.journal.save(this.paths.componentsHealthPath, RuntimeComponentsHealthSchema, parsed);
+        return parsed;
+    }
+    async loadSnapshot() {
+        const [daemon, components] = await Promise.all([
+            this.loadDaemonHealth(),
+            this.loadComponentsHealth(),
+        ]);
+        if (daemon === null || components === null)
+            return null;
+        return RuntimeHealthSnapshotSchema.parse({
+            status: daemon.status,
+            leader: daemon.leader,
+            checked_at: Math.max(daemon.checked_at, components.checked_at),
+            components: components.components,
+            details: daemon.details,
+        });
+    }
+    async saveSnapshot(snapshot) {
+        const parsed = RuntimeHealthSnapshotSchema.parse(snapshot);
+        await Promise.all([
+            this.saveDaemonHealth({
+                status: parsed.status,
+                leader: parsed.leader,
+                checked_at: parsed.checked_at,
+                details: parsed.details,
+            }),
+            this.saveComponentsHealth({
+                checked_at: parsed.checked_at,
+                components: parsed.components,
+            }),
+        ]);
+        return parsed;
+    }
+    summarizeStatus(components) {
+        return summarizeRuntimeHealthStatus(components);
+    }
+}
+//# sourceMappingURL=health-store.js.map

package/dist/runtime/store/health-store.js.map

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

package/dist/runtime/store/index.d.ts

@@ -0,0 +1,10 @@
+export { createRuntimeStorePaths, ensureRuntimeStorePaths, resolveRuntimeRootPath, runtimeDateKey, } from "./runtime-paths.js";
+export type { RuntimeStorePaths } from "./runtime-paths.js";
+export { RuntimeJournal, ensureRuntimeDirectory, listRuntimeJson, loadRuntimeJson, moveRuntimeJson, removeRuntimeJson, saveRuntimeJson, } from "./runtime-journal.js";
+export { RuntimeEnvelopeKindSchema, RuntimeEnvelopePrioritySchema, RuntimeEnvelopeSchema, RuntimeQueueStateSchema, RuntimeQueueRecordSchema, GoalLeaseRecordSchema, ApprovalStateSchema, ApprovalRecordSchema, OutboxRecordSchema, RuntimeHealthStatusSchema, RuntimeDaemonHealthSchema, RuntimeComponentsHealthSchema, RuntimeHealthSnapshotSchema, summarizeRuntimeHealthStatus, } from "./runtime-schemas.js";
+export type { RuntimeEnvelope, RuntimeEnvelopeKind, RuntimeEnvelopePriority, RuntimeQueueState, RuntimeQueueRecord, GoalLeaseRecord, ApprovalState, ApprovalRecord, OutboxRecord, RuntimeHealthStatus, RuntimeDaemonHealth, RuntimeComponentsHealth, RuntimeHealthSnapshot, } from "./runtime-schemas.js";
+export { ApprovalStore } from "./approval-store.js";
+export type { ApprovalResolutionInput } from "./approval-store.js";
+export { OutboxStore } from "./outbox-store.js";
+export { RuntimeHealthStore } from "./health-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/runtime/store/index.js

@@ -0,0 +1,7 @@
+export { createRuntimeStorePaths, ensureRuntimeStorePaths, resolveRuntimeRootPath, runtimeDateKey, } from "./runtime-paths.js";
+export { RuntimeJournal, ensureRuntimeDirectory, listRuntimeJson, loadRuntimeJson, moveRuntimeJson, removeRuntimeJson, saveRuntimeJson, } from "./runtime-journal.js";
+export { RuntimeEnvelopeKindSchema, RuntimeEnvelopePrioritySchema, RuntimeEnvelopeSchema, RuntimeQueueStateSchema, RuntimeQueueRecordSchema, GoalLeaseRecordSchema, ApprovalStateSchema, ApprovalRecordSchema, OutboxRecordSchema, RuntimeHealthStatusSchema, RuntimeDaemonHealthSchema, RuntimeComponentsHealthSchema, RuntimeHealthSnapshotSchema, summarizeRuntimeHealthStatus, } from "./runtime-schemas.js";
+export { ApprovalStore } from "./approval-store.js";
+export { OutboxStore } from "./outbox-store.js";
+export { RuntimeHealthStore } from "./health-store.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAiB9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/runtime/store/outbox-store.d.ts

@@ -0,0 +1,16 @@
+import { type OutboxRecord } from "./runtime-schemas.js";
+import { type RuntimeStorePaths } from "./runtime-paths.js";
+export declare class OutboxStore {
+    private readonly paths;
+    private readonly journal;
+    constructor(runtimeRootOrPaths?: string | RuntimeStorePaths);
+    ensureReady(): Promise<void>;
+    load(seq: number): Promise<OutboxRecord | null>;
+    loadLatest(): Promise<OutboxRecord | null>;
+    list(afterSeq?: number): Promise<OutboxRecord[]>;
+    nextSeq(): Promise<number>;
+    save(record: OutboxRecord): Promise<OutboxRecord>;
+    private acquireAppendLock;
+    append(record: Omit<OutboxRecord, "seq">): Promise<OutboxRecord>;
+}
+//# sourceMappingURL=outbox-store.d.ts.map

package/dist/runtime/store/outbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/outbox-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAU5B,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAQrD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI/C,UAAU,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAK1C,IAAI,CAAC,QAAQ,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM3C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAK1B,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;YAMzC,iBAAiB;IAuCzB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CASvE"}

package/dist/runtime/store/outbox-store.js

@@ -0,0 +1,92 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { RuntimeJournal } from "./runtime-journal.js";
+import { OutboxRecordSchema } from "./runtime-schemas.js";
+import { createRuntimeStorePaths, } from "./runtime-paths.js";
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class OutboxStore {
+    paths;
+    journal;
+    constructor(runtimeRootOrPaths) {
+        this.paths =
+            typeof runtimeRootOrPaths === "string"
+                ? createRuntimeStorePaths(runtimeRootOrPaths)
+                : runtimeRootOrPaths ?? createRuntimeStorePaths();
+        this.journal = new RuntimeJournal(this.paths);
+    }
+    async ensureReady() {
+        await this.journal.ensureReady();
+    }
+    async load(seq) {
+        return this.journal.load(this.paths.outboxRecordPath(seq), OutboxRecordSchema);
+    }
+    async loadLatest() {
+        const records = await this.list();
+        return records.at(-1) ?? null;
+    }
+    async list(afterSeq = 0) {
+        const records = await this.journal.list(this.paths.outboxDir, OutboxRecordSchema);
+        if (afterSeq <= 0)
+            return records;
+        return records.filter((record) => record.seq > afterSeq);
+    }
+    async nextSeq() {
+        const latest = await this.loadLatest();
+        return latest === null ? 1 : latest.seq + 1;
+    }
+    async save(record) {
+        const parsed = OutboxRecordSchema.parse(record);
+        await this.journal.save(this.paths.outboxRecordPath(parsed.seq), OutboxRecordSchema, parsed);
+        return parsed;
+    }
+    async acquireAppendLock() {
+        const lockPath = path.join(this.paths.outboxDir, ".append.lock");
+        const staleAfterMs = 30_000;
+        for (;;) {
+            try {
+                await fs.mkdir(this.paths.outboxDir, { recursive: true });
+                const handle = await fs.open(lockPath, "wx");
+                await handle.writeFile(JSON.stringify({
+                    pid: process.pid,
+                    acquired_at: Date.now(),
+                }));
+                return {
+                    release: async () => {
+                        await handle.close();
+                        await fs.unlink(lockPath).catch(() => undefined);
+                    },
+                };
+            }
+            catch (err) {
+                if (err.code !== "EEXIST")
+                    throw err;
+                try {
+                    const stat = await fs.stat(lockPath);
+                    if (Date.now() - stat.mtimeMs > staleAfterMs) {
+                        await fs.unlink(lockPath);
+                        continue;
+                    }
+                }
+                catch (staleErr) {
+                    if (staleErr.code === "ENOENT")
+                        continue;
+                    throw staleErr;
+                }
+                await sleep(10);
+            }
+        }
+    }
+    async append(record) {
+        const lock = await this.acquireAppendLock();
+        try {
+            const seq = await this.nextSeq();
+            return await this.save({ ...record, seq });
+        }
+        finally {
+            await lock.release();
+        }
+    }
+}
+//# sourceMappingURL=outbox-store.js.map

package/dist/runtime/store/outbox-store.js.map

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

package/dist/runtime/store/runtime-journal.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeStorePaths } from "./runtime-paths.js";
+import type { z } from "zod";
+export declare function ensureRuntimeDirectory(dirPath: string): Promise<void>;
+export declare function loadRuntimeJson<T>(filePath: string, schema: z.ZodType<T>): Promise<T | null>;
+export declare function saveRuntimeJson<T>(filePath: string, schema: z.ZodType<T>, value: T): Promise<T>;
+export declare function removeRuntimeJson(filePath: string): Promise<void>;
+export declare function listRuntimeJson<T>(dirPath: string, schema: z.ZodType<T>): Promise<T[]>;
+export declare function moveRuntimeJson(sourcePath: string, targetPath: string): Promise<void>;
+export declare class RuntimeJournal {
+    private readonly paths;
+    constructor(paths: RuntimeStorePaths);
+    ensureReady(): Promise<void>;
+    load<T>(filePath: string, schema: z.ZodType<T>): Promise<T | null>;
+    save<T>(filePath: string, schema: z.ZodType<T>, value: T): Promise<T>;
+    list<T>(dirPath: string, schema: z.ZodType<T>): Promise<T[]>;
+    remove(filePath: string): Promise<void>;
+    move(sourcePath: string, targetPath: string): Promise<void>;
+}
+//# sourceMappingURL=runtime-journal.d.ts.map

package/dist/runtime/store/runtime-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-journal.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/runtime-journal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,wBAAsB,eAAe,CAAC,CAAC,EACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKnB;AAED,wBAAsB,eAAe,CAAC,CAAC,EACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,EAAE,CAAC,CAgBd;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3F;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAE/C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIlE,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI5D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlE"}

package/dist/runtime/store/runtime-journal.js

@@ -0,0 +1,77 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { readJsonFileOrNull, writeJsonFileAtomic } from "../../base/utils/json-io.js";
+import { ensureRuntimeStorePaths } from "./runtime-paths.js";
+export async function ensureRuntimeDirectory(dirPath) {
+    await fsp.mkdir(dirPath, { recursive: true });
+}
+export async function loadRuntimeJson(filePath, schema) {
+    const raw = await readJsonFileOrNull(filePath);
+    if (raw === null)
+        return null;
+    const parsed = schema.safeParse(raw);
+    return parsed.success ? parsed.data : null;
+}
+export async function saveRuntimeJson(filePath, schema, value) {
+    const parsed = schema.parse(value);
+    await writeJsonFileAtomic(filePath, parsed);
+    return parsed;
+}
+export async function removeRuntimeJson(filePath) {
+    try {
+        await fsp.unlink(filePath);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return;
+        throw err;
+    }
+}
+export async function listRuntimeJson(dirPath, schema) {
+    let entries;
+    try {
+        entries = await fsp.readdir(dirPath);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const files = entries.filter((entry) => entry.endsWith(".json")).sort();
+    const records = [];
+    for (const fileName of files) {
+        const record = await loadRuntimeJson(path.join(dirPath, fileName), schema);
+        if (record !== null)
+            records.push(record);
+    }
+    return records;
+}
+export async function moveRuntimeJson(sourcePath, targetPath) {
+    await fsp.mkdir(path.dirname(targetPath), { recursive: true });
+    await fsp.rename(sourcePath, targetPath);
+}
+export class RuntimeJournal {
+    paths;
+    constructor(paths) {
+        this.paths = paths;
+    }
+    async ensureReady() {
+        await ensureRuntimeStorePaths(this.paths);
+    }
+    async load(filePath, schema) {
+        return loadRuntimeJson(filePath, schema);
+    }
+    async save(filePath, schema, value) {
+        return saveRuntimeJson(filePath, schema, value);
+    }
+    async list(dirPath, schema) {
+        return listRuntimeJson(dirPath, schema);
+    }
+    async remove(filePath) {
+        await removeRuntimeJson(filePath);
+    }
+    async move(sourcePath, targetPath) {
+        await moveRuntimeJson(sourcePath, targetPath);
+    }
+}
+//# sourceMappingURL=runtime-journal.js.map

package/dist/runtime/store/runtime-journal.js.map

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

package/dist/runtime/store/runtime-paths.d.ts

@@ -0,0 +1,35 @@
+export interface RuntimeStorePaths {
+    rootDir: string;
+    leaderDir: string;
+    leaderPath: string;
+    inboxDir: string;
+    claimsDir: string;
+    completedDir: string;
+    completedByIdempotencyDir: string;
+    completedByMessageDir: string;
+    approvalsDir: string;
+    approvalsPendingDir: string;
+    approvalsResolvedDir: string;
+    outboxDir: string;
+    leasesDir: string;
+    goalLeasesDir: string;
+    dlqDir: string;
+    healthDir: string;
+    daemonHealthPath: string;
+    componentsHealthPath: string;
+    inboxBucketDir(dateKey: string): string;
+    inboxRecordPath(dateKey: string, messageId: string): string;
+    approvalPendingPath(approvalId: string): string;
+    approvalResolvedPath(approvalId: string): string;
+    outboxRecordPath(seq: number): string;
+    goalLeasePath(goalId: string): string;
+    completedByIdempotencyPath(idempotencyKey: string): string;
+    completedByMessagePath(messageId: string): string;
+    dlqPath(dateKey: string): string;
+}
+export declare function encodeRuntimePathSegment(value: string): string;
+export declare function resolveRuntimeRootPath(runtimeRoot?: string): string;
+export declare function runtimeDateKey(timestamp?: number | Date): string;
+export declare function createRuntimeStorePaths(runtimeRoot?: string): RuntimeStorePaths;
+export declare function ensureRuntimeStorePaths(paths: RuntimeStorePaths): Promise<void>;
+//# sourceMappingURL=runtime-paths.d.ts.map

package/dist/runtime/store/runtime-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-paths.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/runtime-paths.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAChD,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3D,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAClD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAUD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAOD,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,cAAc,CAAC,SAAS,GAAE,MAAM,GAAG,IAAiB,GAAG,MAAM,CAG5E;AAED,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAgE/E;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrF"}

package/dist/runtime/store/runtime-paths.js

@@ -0,0 +1,108 @@
+import { createHash } from "node:crypto";
+import * as path from "node:path";
+import * as fsp from "node:fs/promises";
+import { getPulseedDirPath } from "../../base/utils/paths.js";
+function recordFileName(recordId) {
+    return `${recordId}.json`;
+}
+function outboxFileName(seq) {
+    return `${String(seq).padStart(12, "0")}.json`;
+}
+export function encodeRuntimePathSegment(value) {
+    return encodeURIComponent(value);
+}
+function hashedRecordFileName(value) {
+    const digest = createHash("sha256").update(value).digest("hex");
+    return `${digest}.json`;
+}
+export function resolveRuntimeRootPath(runtimeRoot) {
+    return runtimeRoot ? path.resolve(runtimeRoot) : path.join(getPulseedDirPath(), "runtime");
+}
+export function runtimeDateKey(timestamp = Date.now()) {
+    const date = timestamp instanceof Date ? timestamp : new Date(timestamp);
+    return date.toISOString().slice(0, 10);
+}
+export function createRuntimeStorePaths(runtimeRoot) {
+    const rootDir = resolveRuntimeRootPath(runtimeRoot);
+    const leaderDir = path.join(rootDir, "leader");
+    const inboxDir = path.join(rootDir, "inbox");
+    const claimsDir = path.join(rootDir, "claims");
+    const completedDir = path.join(rootDir, "completed");
+    const completedByIdempotencyDir = path.join(completedDir, "by-idempotency");
+    const completedByMessageDir = path.join(completedDir, "by-message");
+    const approvalsDir = path.join(rootDir, "approvals");
+    const approvalsPendingDir = path.join(approvalsDir, "pending");
+    const approvalsResolvedDir = path.join(approvalsDir, "resolved");
+    const outboxDir = path.join(rootDir, "outbox");
+    const leasesDir = path.join(rootDir, "leases");
+    const goalLeasesDir = path.join(leasesDir, "goal");
+    const dlqDir = path.join(rootDir, "dlq");
+    const healthDir = path.join(rootDir, "health");
+    return {
+        rootDir,
+        leaderDir,
+        leaderPath: path.join(leaderDir, "leader.json"),
+        inboxDir,
+        claimsDir,
+        completedDir,
+        completedByIdempotencyDir,
+        completedByMessageDir,
+        approvalsDir,
+        approvalsPendingDir,
+        approvalsResolvedDir,
+        outboxDir,
+        leasesDir,
+        goalLeasesDir,
+        dlqDir,
+        healthDir,
+        daemonHealthPath: path.join(healthDir, "daemon.json"),
+        componentsHealthPath: path.join(healthDir, "components.json"),
+        inboxBucketDir(dateKey) {
+            return path.join(inboxDir, dateKey);
+        },
+        inboxRecordPath(dateKey, messageId) {
+            return path.join(inboxDir, dateKey, recordFileName(messageId));
+        },
+        approvalPendingPath(approvalId) {
+            return path.join(approvalsPendingDir, recordFileName(approvalId));
+        },
+        approvalResolvedPath(approvalId) {
+            return path.join(approvalsResolvedDir, recordFileName(approvalId));
+        },
+        outboxRecordPath(seq) {
+            return path.join(outboxDir, outboxFileName(seq));
+        },
+        goalLeasePath(goalId) {
+            return path.join(goalLeasesDir, `${encodeRuntimePathSegment(goalId)}.json`);
+        },
+        completedByIdempotencyPath(idempotencyKey) {
+            return path.join(completedByIdempotencyDir, hashedRecordFileName(idempotencyKey));
+        },
+        completedByMessagePath(messageId) {
+            return path.join(completedByMessageDir, recordFileName(messageId));
+        },
+        dlqPath(dateKey) {
+            return path.join(dlqDir, `${dateKey}.jsonl`);
+        },
+    };
+}
+export async function ensureRuntimeStorePaths(paths) {
+    await Promise.all([
+        paths.rootDir,
+        paths.leaderDir,
+        paths.inboxDir,
+        paths.claimsDir,
+        paths.completedDir,
+        paths.completedByIdempotencyDir,
+        paths.completedByMessageDir,
+        paths.approvalsDir,
+        paths.approvalsPendingDir,
+        paths.approvalsResolvedDir,
+        paths.outboxDir,
+        paths.leasesDir,
+        paths.goalLeasesDir,
+        paths.dlqDir,
+        paths.healthDir,
+    ].map((dir) => fsp.mkdir(dir, { recursive: true })));
+}
+//# sourceMappingURL=runtime-paths.js.map