@elie-laloum/outpost 2.0.0 → 3.0.0

package/dist/infrastructure/inspection-file.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-file.constants.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-file.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,mBAAmB,GAC9B,SAAS,CAAC,QAAQ;IAClB,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3B,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC","sourcesContent":["import { constants } from \"node:fs\";\n\nexport const inspectionFileFlags =\n  constants.O_RDONLY |\n  (constants.O_NOFOLLOW ?? 0) |\n  (constants.O_NONBLOCK ?? 0);\n"]}

package/dist/infrastructure/inspection-file.d.ts

@@ -0,0 +1 @@
+export declare function readInspectionFile(path: string, maxBytes: number): Promise<Buffer>;

package/dist/infrastructure/inspection-file.js

@@ -0,0 +1,43 @@
+import { lstat, open, realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+import { positive } from "../domain/errors.js";
+import { inspectionFileFlags } from "./inspection-file.constants.js";
+function unchanged(before, after) {
+    return (before.dev === after.dev &&
+        before.ino === after.ino &&
+        before.size === after.size &&
+        before.mtimeMs === after.mtimeMs &&
+        before.ctimeMs === after.ctimeMs);
+}
+export async function readInspectionFile(path, maxBytes) {
+    positive(maxBytes, "maxBytes");
+    const before = await lstat(path);
+    if (!before.isFile() || (await realpath(path)) !== resolve(path))
+        throw new Error("Inspection path changed");
+    if (before.size > maxBytes)
+        throw new Error("Inspection file is too large");
+    const file = await open(path, inspectionFileFlags);
+    try {
+        const opened = await file.stat();
+        if (!opened.isFile() || !unchanged(before, opened))
+            throw new Error("Inspection file changed");
+        const buffer = Buffer.alloc(maxBytes + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            const { bytesRead } = await file.read(buffer, length, buffer.length - length, length);
+            if (!bytesRead)
+                break;
+            length += bytesRead;
+        }
+        if (length > maxBytes)
+            throw new Error("Inspection file is too large");
+        if (!unchanged(opened, await file.stat()) ||
+            !unchanged(opened, await lstat(path)))
+            throw new Error("Inspection file changed");
+        return buffer.subarray(0, length);
+    }
+    finally {
+        await file.close();
+    }
+}
+//# sourceMappingURL=inspection-file.js.map

package/dist/infrastructure/inspection-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-file.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,SAAS,SAAS,CAAC,MAAa,EAAE,KAAY;IAC5C,OAAO,CACL,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG;QACxB,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG;QACxB,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QAC1B,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;QAChC,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,QAAgB;IAEhB,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CACnC,MAAM,EACN,MAAM,EACN,MAAM,CAAC,MAAM,GAAG,MAAM,EACtB,MAAM,CACP,CAAC;YACF,IAAI,CAAC,SAAS;gBAAE,MAAM;YACtB,MAAM,IAAI,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,MAAM,GAAG,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACvE,IACE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YAErC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["import { lstat, open, realpath } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { Stats } from \"node:fs\";\nimport { positive } from \"../domain/errors.ts\";\nimport { inspectionFileFlags } from \"./inspection-file.constants.ts\";\n\nfunction unchanged(before: Stats, after: Stats): boolean {\n  return (\n    before.dev === after.dev &&\n    before.ino === after.ino &&\n    before.size === after.size &&\n    before.mtimeMs === after.mtimeMs &&\n    before.ctimeMs === after.ctimeMs\n  );\n}\n\nexport async function readInspectionFile(\n  path: string,\n  maxBytes: number,\n): Promise<Buffer> {\n  positive(maxBytes, \"maxBytes\");\n  const before = await lstat(path);\n  if (!before.isFile() || (await realpath(path)) !== resolve(path))\n    throw new Error(\"Inspection path changed\");\n  if (before.size > maxBytes) throw new Error(\"Inspection file is too large\");\n  const file = await open(path, inspectionFileFlags);\n  try {\n    const opened = await file.stat();\n    if (!opened.isFile() || !unchanged(before, opened))\n      throw new Error(\"Inspection file changed\");\n    const buffer = Buffer.alloc(maxBytes + 1);\n    let length = 0;\n    while (length < buffer.length) {\n      const { bytesRead } = await file.read(\n        buffer,\n        length,\n        buffer.length - length,\n        length,\n      );\n      if (!bytesRead) break;\n      length += bytesRead;\n    }\n    if (length > maxBytes) throw new Error(\"Inspection file is too large\");\n    if (\n      !unchanged(opened, await file.stat()) ||\n      !unchanged(opened, await lstat(path))\n    )\n      throw new Error(\"Inspection file changed\");\n    return buffer.subarray(0, length);\n  } finally {\n    await file.close();\n  }\n}\n"]}

package/dist/infrastructure/inspection-hash.constants.d.ts

@@ -0,0 +1 @@
+export declare const inspectionHashChunkBytes = 65536;

package/dist/infrastructure/inspection-hash.constants.js

@@ -0,0 +1,2 @@
+export const inspectionHashChunkBytes = 65_536;
+//# sourceMappingURL=inspection-hash.constants.js.map

package/dist/infrastructure/inspection-hash.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-hash.constants.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-hash.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC","sourcesContent":["export const inspectionHashChunkBytes = 65_536;\n"]}

package/dist/infrastructure/inspection-hash.d.ts

@@ -0,0 +1,2 @@
+import type { InspectionHash } from "./inspection-hash.types.ts";
+export declare function hashInspectionEntry(path: string, maxBytes?: number): Promise<InspectionHash>;

package/dist/infrastructure/inspection-hash.js

@@ -0,0 +1,62 @@
+import { createHash } from "node:crypto";
+import { lstat, open, readlink, realpath } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { OutpostError } from "../domain/errors.js";
+import { inspectionFileFlags } from "./inspection-file.constants.js";
+import { inspectionHashChunkBytes } from "./inspection-hash.constants.js";
+function unchanged(before, after) {
+    return (before.dev === after.dev &&
+        before.ino === after.ino &&
+        before.size === after.size &&
+        before.mtimeMs === after.mtimeMs &&
+        before.ctimeMs === after.ctimeMs);
+}
+export async function hashInspectionEntry(path, maxBytes = Number.MAX_SAFE_INTEGER) {
+    const before = await lstat(path);
+    if ((await realpath(dirname(path))) !== resolve(dirname(path)))
+        throw new Error("Hash path traverses a symlink");
+    const hash = createHash("sha256");
+    if (before.isSymbolicLink()) {
+        const target = await readlink(path, { encoding: "buffer" });
+        if (target.length > maxBytes)
+            throw new OutpostError("workspace", "Checksum byte limit exceeded", {
+                reason: "CHECKSUM_LIMIT",
+            });
+        if (!unchanged(before, await lstat(path)))
+            throw new Error("Hash source changed");
+        return {
+            kind: "symlink",
+            bytes: target.length,
+            sha256: hash.update(target).digest("hex"),
+        };
+    }
+    if (!before.isFile())
+        throw new Error("Hash source is not a regular file");
+    if (before.size > maxBytes)
+        throw new OutpostError("workspace", "Checksum byte limit exceeded", {
+            reason: "CHECKSUM_LIMIT",
+        });
+    const file = await open(path, inspectionFileFlags);
+    try {
+        const opened = await file.stat();
+        if (!opened.isFile() || !unchanged(before, opened))
+            throw new Error("Hash source changed");
+        const buffer = Buffer.alloc(inspectionHashChunkBytes);
+        let bytes = 0;
+        while (bytes < opened.size) {
+            const result = await file.read(buffer, 0, Math.min(buffer.length, opened.size - bytes), bytes);
+            if (!result.bytesRead)
+                throw new Error("Hash source truncated");
+            bytes += result.bytesRead;
+            hash.update(buffer.subarray(0, result.bytesRead));
+        }
+        if (!unchanged(opened, await file.stat()) ||
+            !unchanged(opened, await lstat(path)))
+            throw new Error("Hash source changed");
+        return { kind: "file", bytes, sha256: hash.digest("hex") };
+    }
+    finally {
+        await file.close();
+    }
+}
+//# sourceMappingURL=inspection-hash.js.map

package/dist/infrastructure/inspection-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-hash.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-hash.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { lstat, open, readlink, realpath } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport type { Stats } from \"node:fs\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { inspectionFileFlags } from \"./inspection-file.constants.ts\";\nimport { inspectionHashChunkBytes } from \"./inspection-hash.constants.ts\";\nimport type { InspectionHash } from \"./inspection-hash.types.ts\";\n\nfunction unchanged(before: Stats, after: Stats): boolean {\n  return (\n    before.dev === after.dev &&\n    before.ino === after.ino &&\n    before.size === after.size &&\n    before.mtimeMs === after.mtimeMs &&\n    before.ctimeMs === after.ctimeMs\n  );\n}\n\nexport async function hashInspectionEntry(\n  path: string,\n  maxBytes = Number.MAX_SAFE_INTEGER,\n): Promise<InspectionHash> {\n  const before = await lstat(path);\n  if ((await realpath(dirname(path))) !== resolve(dirname(path)))\n    throw new Error(\"Hash path traverses a symlink\");\n  const hash = createHash(\"sha256\");\n  if (before.isSymbolicLink()) {\n    const target = await readlink(path, { encoding: \"buffer\" });\n    if (target.length > maxBytes)\n      throw new OutpostError(\"workspace\", \"Checksum byte limit exceeded\", {\n        reason: \"CHECKSUM_LIMIT\",\n      });\n    if (!unchanged(before, await lstat(path)))\n      throw new Error(\"Hash source changed\");\n    return {\n      kind: \"symlink\",\n      bytes: target.length,\n      sha256: hash.update(target).digest(\"hex\"),\n    };\n  }\n  if (!before.isFile()) throw new Error(\"Hash source is not a regular file\");\n  if (before.size > maxBytes)\n    throw new OutpostError(\"workspace\", \"Checksum byte limit exceeded\", {\n      reason: \"CHECKSUM_LIMIT\",\n    });\n  const file = await open(path, inspectionFileFlags);\n  try {\n    const opened = await file.stat();\n    if (!opened.isFile() || !unchanged(before, opened))\n      throw new Error(\"Hash source changed\");\n    const buffer = Buffer.alloc(inspectionHashChunkBytes);\n    let bytes = 0;\n    while (bytes < opened.size) {\n      const result = await file.read(\n        buffer,\n        0,\n        Math.min(buffer.length, opened.size - bytes),\n        bytes,\n      );\n      if (!result.bytesRead) throw new Error(\"Hash source truncated\");\n      bytes += result.bytesRead;\n      hash.update(buffer.subarray(0, result.bytesRead));\n    }\n    if (\n      !unchanged(opened, await file.stat()) ||\n      !unchanged(opened, await lstat(path))\n    )\n      throw new Error(\"Hash source changed\");\n    return { kind: \"file\", bytes, sha256: hash.digest(\"hex\") };\n  } finally {\n    await file.close();\n  }\n}\n"]}

package/dist/infrastructure/inspection-hash.types.d.ts

@@ -0,0 +1,5 @@
+export interface InspectionHash {
+    readonly kind: "file" | "symlink";
+    readonly bytes: number;
+    readonly sha256: string;
+}

package/dist/infrastructure/inspection-hash.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inspection-hash.types.js.map

package/dist/infrastructure/inspection-hash.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-hash.types.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-hash.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface InspectionHash {\n  readonly kind: \"file\" | \"symlink\";\n  readonly bytes: number;\n  readonly sha256: string;\n}\n"]}

package/dist/infrastructure/journal-retention.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const journalRetentionLimits: {
+    readonly maxMarkerBytes: 4096;
+    readonly maxLogBytes: 1073741824;
+};

package/dist/infrastructure/journal-retention.constants.js

@@ -0,0 +1,5 @@
+export const journalRetentionLimits = {
+    maxMarkerBytes: 4096,
+    maxLogBytes: 1_073_741_824,
+};
+//# sourceMappingURL=journal-retention.constants.js.map

package/dist/infrastructure/journal-retention.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-retention.constants.js","sourceRoot":"","sources":["../../src/infrastructure/journal-retention.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,aAAa;CAClB,CAAC","sourcesContent":["export const journalRetentionLimits = {\n  maxMarkerBytes: 4096,\n  maxLogBytes: 1_073_741_824,\n} as const;\n"]}

package/dist/infrastructure/journal-retention.d.ts

@@ -0,0 +1,2 @@
+export declare function markJournalClosed(file: string): Promise<void>;
+export declare function closedJournal(file: string): Promise<boolean>;

package/dist/infrastructure/journal-retention.js

@@ -0,0 +1,51 @@
+import { journalRetentionLimits } from "./journal-retention.constants.js";
+import { lstat, writeFile } from "node:fs/promises";
+import { hashInspectionEntry } from "./inspection-hash.js";
+import { readInspectionFile } from "./inspection-file.js";
+export async function markJournalClosed(file) {
+    const info = await lstat(file);
+    const fingerprint = await hashInspectionEntry(file);
+    await writeFile(`${file}.closed.json`, JSON.stringify({
+        version: 1,
+        closedAt: new Date().toISOString(),
+        dev: info.dev,
+        ino: info.ino,
+        mtimeMs: info.mtimeMs,
+        ctimeMs: info.ctimeMs,
+        ...fingerprint,
+    }), { flag: "wx", mode: 0o600 });
+}
+export async function closedJournal(file) {
+    try {
+        const record = JSON.parse((await readInspectionFile(`${file}.closed.json`, journalRetentionLimits.maxMarkerBytes)).toString("utf8"));
+        if (!record ||
+            typeof record !== "object" ||
+            !("version" in record) ||
+            record.version !== 1 ||
+            !("closedAt" in record) ||
+            typeof record.closedAt !== "string" ||
+            !Number.isFinite(Date.parse(record.closedAt)) ||
+            !("kind" in record) ||
+            record.kind !== "file" ||
+            !("bytes" in record) ||
+            typeof record.bytes !== "number" ||
+            !Number.isSafeInteger(record.bytes) ||
+            record.bytes < 0 ||
+            !("sha256" in record) ||
+            typeof record.sha256 !== "string" ||
+            !/^[a-f0-9]{64}$/.test(record.sha256))
+            return false;
+        const info = await lstat(file);
+        for (const key of ["dev", "ino", "mtimeMs", "ctimeMs"])
+            if (Object.getOwnPropertyDescriptor(record, key)?.value !== info[key])
+                return false;
+        const current = await hashInspectionEntry(file, journalRetentionLimits.maxLogBytes);
+        return (current.kind === "file" &&
+            current.bytes === record.bytes &&
+            current.sha256 === record.sha256);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=journal-retention.js.map

package/dist/infrastructure/journal-retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-retention.js","sourceRoot":"","sources":["../../src/infrastructure/journal-retention.ts"],"names":[],"mappings":"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","sourcesContent":["import { journalRetentionLimits } from \"./journal-retention.constants.ts\";\nimport { lstat, writeFile } from \"node:fs/promises\";\nimport { hashInspectionEntry } from \"./inspection-hash.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\n\nexport async function markJournalClosed(file: string): Promise<void> {\n  const info = await lstat(file);\n  const fingerprint = await hashInspectionEntry(file);\n  await writeFile(\n    `${file}.closed.json`,\n    JSON.stringify({\n      version: 1,\n      closedAt: new Date().toISOString(),\n      dev: info.dev,\n      ino: info.ino,\n      mtimeMs: info.mtimeMs,\n      ctimeMs: info.ctimeMs,\n      ...fingerprint,\n    }),\n    { flag: \"wx\", mode: 0o600 },\n  );\n}\n\nexport async function closedJournal(file: string): Promise<boolean> {\n  try {\n    const record: unknown = JSON.parse(\n      (\n        await readInspectionFile(\n          `${file}.closed.json`,\n          journalRetentionLimits.maxMarkerBytes,\n        )\n      ).toString(\"utf8\"),\n    );\n    if (\n      !record ||\n      typeof record !== \"object\" ||\n      !(\"version\" in record) ||\n      record.version !== 1 ||\n      !(\"closedAt\" in record) ||\n      typeof record.closedAt !== \"string\" ||\n      !Number.isFinite(Date.parse(record.closedAt)) ||\n      !(\"kind\" in record) ||\n      record.kind !== \"file\" ||\n      !(\"bytes\" in record) ||\n      typeof record.bytes !== \"number\" ||\n      !Number.isSafeInteger(record.bytes) ||\n      record.bytes < 0 ||\n      !(\"sha256\" in record) ||\n      typeof record.sha256 !== \"string\" ||\n      !/^[a-f0-9]{64}$/.test(record.sha256)\n    )\n      return false;\n    const info = await lstat(file);\n    for (const key of [\"dev\", \"ino\", \"mtimeMs\", \"ctimeMs\"] as const)\n      if (Object.getOwnPropertyDescriptor(record, key)?.value !== info[key])\n        return false;\n    const current = await hashInspectionEntry(\n      file,\n      journalRetentionLimits.maxLogBytes,\n    );\n    return (\n      current.kind === \"file\" &&\n      current.bytes === record.bytes &&\n      current.sha256 === record.sha256\n    );\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/infrastructure/journal.js

@@ -1,5 +1,7 @@
+import { lock } from "./git/lock.js";
+import { markJournalClosed } from "./journal-retention.js";
 import { randomUUID } from "node:crypto";
-import { mkdir, open } from "node:fs/promises";
+import { mkdir, open, rm } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { reporter } from "./reporter.js";
 export async function journal(repository, logging = {}, label) {
@@ -9,20 +11,32 @@ export async function journal(repository, logging = {}, label) {
         : undefined;
     let handle, pending = Promise.resolve();
     let failure;
+    let release;
+    let closing;
+    const managed = !!logging && logging !== "stdout" && logging.file === undefined;
     const display = reporter({ ...(label ? { label } : {}) });
     if (file) {
         await mkdir(dirname(file), { recursive: true });
-        handle = await open(file, "a", 0o600);
-        await handle.write(JSON.stringify({
-            kind: "dispatch-start",
-            at: new Date().toISOString(),
-            label,
-        }) + "\n");
+        release = await lock(repository, `journal:${file}`);
+        try {
+            await rm(`${file}.closed.json`, { force: true });
+            handle = await open(file, managed ? "wx" : "a", 0o600);
+            await handle.write(JSON.stringify({
+                kind: "dispatch-start",
+                at: new Date().toISOString(),
+                label,
+            }) + "\n");
+        }
+        catch (error) {
+            await handle?.close();
+            await release();
+            throw error;
+        }
     }
     return {
         ...(file ? { file } : {}),
         record(event) {
-            if (!logging)
+            if (!logging || closing)
                 return;
             if (event.kind === "raw" && logging !== "stdout" && !logging.verbose)
                 return;
@@ -42,11 +56,21 @@ export async function journal(repository, logging = {}, label) {
                     failure = error;
                 });
         },
-        async close() {
-            await pending;
-            await handle?.close();
-            if (failure)
-                throw failure;
+        close() {
+            closing ??= (async () => {
+                try {
+                    await pending;
+                    await handle?.close();
+                    if (failure)
+                        throw failure;
+                    if (file && managed)
+                        await markJournalClosed(file);
+                }
+                finally {
+                    await release?.();
+                }
+            })();
+            return closing;
         },
     };
 }

package/dist/infrastructure/journal.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/infrastructure/journal.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { FileHandle } from \"node:fs/promises\";\nimport { mkdir, open } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { Journal, Logging } from \"./journal.types.ts\";\nimport { reporter } from \"./reporter.ts\";\n\nexport type { Logging } from \"./journal.types.ts\";\n\nexport async function journal(\n  repository: string,\n  logging: Logging = {},\n  label?: string,\n): Promise<Journal> {\n  const file =\n    logging && logging !== \"stdout\"\n      ? resolve(\n          repository,\n          logging.file ??\n            join(\n              \".outpost\",\n              \"logs\",\n              `${label ? label.replace(/[^A-Za-z0-9_-]/g, \"-\").slice(0, 64) + \"-\" : \"\"}${new Date().toISOString().replaceAll(\":\", \"-\")}-${randomUUID()}.jsonl`,\n            ),\n        )\n      : undefined;\n  let handle: FileHandle | undefined,\n    pending = Promise.resolve();\n  let failure: unknown;\n  const display = reporter({ ...(label ? { label } : {}) });\n  if (file) {\n    await mkdir(dirname(file), { recursive: true });\n    handle = await open(file, \"a\", 0o600);\n    await handle.write(\n      JSON.stringify({\n        kind: \"dispatch-start\",\n        at: new Date().toISOString(),\n        label,\n      }) + \"\\n\",\n    );\n  }\n  return {\n    ...(file ? { file } : {}),\n    record(event) {\n      if (!logging) return;\n      if (event.kind === \"raw\" && logging !== \"stdout\" && !logging.verbose)\n        return;\n      const line =\n        JSON.stringify({\n          at: new Date().toISOString(),\n          ...(label ? { label } : {}),\n          ...event,\n        }) + \"\\n\";\n      if (logging === \"stdout\") display(event);\n      else\n        pending = pending\n          .then(async () => {\n            await handle?.write(line);\n          })\n          .catch((error) => {\n            failure = error;\n          });\n    },\n    async close() {\n      await pending;\n      await handle?.close();\n      if (failure) throw failure;\n    },\n  };\n}\n"]}
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/infrastructure/journal.ts"],"names":[],"mappings":"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","sourcesContent":["import { lock } from \"./git/lock.ts\";\nimport { markJournalClosed } from \"./journal-retention.ts\";\nimport { randomUUID } from \"node:crypto\";\nimport type { FileHandle } from \"node:fs/promises\";\nimport { mkdir, open, rm } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { Journal, Logging } from \"./journal.types.ts\";\nimport { reporter } from \"./reporter.ts\";\n\nexport type { Logging } from \"./journal.types.ts\";\n\nexport async function journal(\n  repository: string,\n  logging: Logging = {},\n  label?: string,\n): Promise<Journal> {\n  const file =\n    logging && logging !== \"stdout\"\n      ? resolve(\n          repository,\n          logging.file ??\n            join(\n              \".outpost\",\n              \"logs\",\n              `${label ? label.replace(/[^A-Za-z0-9_-]/g, \"-\").slice(0, 64) + \"-\" : \"\"}${new Date().toISOString().replaceAll(\":\", \"-\")}-${randomUUID()}.jsonl`,\n            ),\n        )\n      : undefined;\n  let handle: FileHandle | undefined,\n    pending = Promise.resolve();\n  let failure: unknown;\n  let release: (() => Promise<void>) | undefined;\n  let closing: Promise<void> | undefined;\n  const managed =\n    !!logging && logging !== \"stdout\" && logging.file === undefined;\n  const display = reporter({ ...(label ? { label } : {}) });\n  if (file) {\n    await mkdir(dirname(file), { recursive: true });\n    release = await lock(repository, `journal:${file}`);\n    try {\n      await rm(`${file}.closed.json`, { force: true });\n      handle = await open(file, managed ? \"wx\" : \"a\", 0o600);\n      await handle.write(\n        JSON.stringify({\n          kind: \"dispatch-start\",\n          at: new Date().toISOString(),\n          label,\n        }) + \"\\n\",\n      );\n    } catch (error) {\n      await handle?.close();\n      await release();\n      throw error;\n    }\n  }\n  return {\n    ...(file ? { file } : {}),\n    record(event) {\n      if (!logging || closing) return;\n      if (event.kind === \"raw\" && logging !== \"stdout\" && !logging.verbose)\n        return;\n      const line =\n        JSON.stringify({\n          at: new Date().toISOString(),\n          ...(label ? { label } : {}),\n          ...event,\n        }) + \"\\n\";\n      if (logging === \"stdout\") display(event);\n      else\n        pending = pending\n          .then(async () => {\n            await handle?.write(line);\n          })\n          .catch((error) => {\n            failure = error;\n          });\n    },\n    close() {\n      closing ??= (async () => {\n        try {\n          await pending;\n          await handle?.close();\n          if (failure) throw failure;\n          if (file && managed) await markJournalClosed(file);\n        } finally {\n          await release?.();\n        }\n      })();\n      return closing;\n    },\n  };\n}\n"]}

package/dist/infrastructure/opentelemetry.constants.d.ts

@@ -0,0 +1,10 @@
+export declare const telemetryNames: {
+    readonly workflows: "outpost.workflow.executions";
+    readonly tasks: "outpost.task.executions";
+    readonly attempts: "outpost.task.attempts";
+    readonly retries: "outpost.task.retries";
+    readonly usage: "outpost.agent.tokens";
+    readonly workflowDuration: "outpost.workflow.duration";
+    readonly taskDuration: "outpost.task.duration";
+    readonly attemptDuration: "outpost.task.attempt.duration";
+};

package/dist/infrastructure/opentelemetry.constants.js

@@ -0,0 +1,11 @@
+export const telemetryNames = {
+    workflows: "outpost.workflow.executions",
+    tasks: "outpost.task.executions",
+    attempts: "outpost.task.attempts",
+    retries: "outpost.task.retries",
+    usage: "outpost.agent.tokens",
+    workflowDuration: "outpost.workflow.duration",
+    taskDuration: "outpost.task.duration",
+    attemptDuration: "outpost.task.attempt.duration",
+};
+//# sourceMappingURL=opentelemetry.constants.js.map

package/dist/infrastructure/opentelemetry.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.constants.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,6BAA6B;IACxC,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,uBAAuB;IACjC,OAAO,EAAE,sBAAsB;IAC/B,KAAK,EAAE,sBAAsB;IAC7B,gBAAgB,EAAE,2BAA2B;IAC7C,YAAY,EAAE,uBAAuB;IACrC,eAAe,EAAE,+BAA+B;CACxC,CAAC","sourcesContent":["export const telemetryNames = {\n  workflows: \"outpost.workflow.executions\",\n  tasks: \"outpost.task.executions\",\n  attempts: \"outpost.task.attempts\",\n  retries: \"outpost.task.retries\",\n  usage: \"outpost.agent.tokens\",\n  workflowDuration: \"outpost.workflow.duration\",\n  taskDuration: \"outpost.task.duration\",\n  attemptDuration: \"outpost.task.attempt.duration\",\n} as const;\n"]}

package/dist/infrastructure/opentelemetry.d.ts

@@ -0,0 +1,3 @@
+import type { OpenTelemetryObserver, OpenTelemetryOptions } from "./opentelemetry.types.ts";
+export type { OpenTelemetryObserver, OpenTelemetryOptions, } from "./opentelemetry.types.ts";
+export declare function openTelemetry(options: OpenTelemetryOptions): OpenTelemetryObserver;

package/dist/infrastructure/opentelemetry.js

@@ -0,0 +1,131 @@
+import { context, trace, SpanStatusCode } from "@opentelemetry/api";
+import { usageDimensions } from "../domain/workflow/budget.constants.js";
+import { telemetryNames } from "./opentelemetry.constants.js";
+export function openTelemetry(options) {
+    function safe(action) {
+        try {
+            return action();
+        }
+        catch (error) {
+            try {
+                options.onError?.(error);
+            }
+            catch { }
+        }
+    }
+    const counters = {
+        workflows: safe(() => options.meter.createCounter(telemetryNames.workflows)),
+        tasks: safe(() => options.meter.createCounter(telemetryNames.tasks)),
+        attempts: safe(() => options.meter.createCounter(telemetryNames.attempts)),
+        retries: safe(() => options.meter.createCounter(telemetryNames.retries)),
+        usage: safe(() => options.meter.createCounter(telemetryNames.usage, { unit: "{token}" })),
+    };
+    const durations = {
+        workflow: safe(() => options.meter.createHistogram(telemetryNames.workflowDuration, {
+            unit: "s",
+        })),
+        task: safe(() => options.meter.createHistogram(telemetryNames.taskDuration, { unit: "s" })),
+        attempt: safe(() => options.meter.createHistogram(telemetryNames.attemptDuration, {
+            unit: "s",
+        })),
+    };
+    const executions = new Map();
+    let closed = false;
+    function start(name, parent, at) {
+        const span = safe(() => options.tracer.startSpan(name, { startTime: at }, parent));
+        return {
+            span,
+            context: span ? trace.setSpan(parent, span) : parent,
+            started: at,
+        };
+    }
+    function finish(operation, status, at, duration) {
+        if (!operation)
+            return;
+        const attributes = { "outpost.status": status };
+        safe(() => operation.span?.setAttributes(attributes));
+        if (status !== "skipped")
+            safe(() => operation.span?.setStatus({
+                code: status === "done" ? SpanStatusCode.OK : SpanStatusCode.ERROR,
+            }));
+        safe(() => operation.span?.end(at));
+        safe(() => duration?.record(Math.max(0, at - operation.started) / 1000, attributes));
+    }
+    function complete(execution, status, at) {
+        for (const attempt of execution.attempts.values())
+            finish(attempt, status, at, durations.attempt);
+        for (const task of execution.tasks.values())
+            finish(task, status, at, durations.task);
+        finish(execution.workflow, status, at, durations.workflow);
+        safe(() => counters.workflows?.add(1, { "outpost.status": status }));
+    }
+    return {
+        observe(event) {
+            if (closed)
+                return;
+            const at = Date.parse(event.timestamp);
+            if (!Number.isFinite(at))
+                return;
+            if (event.type === "start") {
+                if (executions.has(event.executionId))
+                    return;
+                executions.set(event.executionId, {
+                    workflow: start("outpost.workflow", context.active(), at),
+                    tasks: new Map(),
+                    attempts: new Map(),
+                });
+                return;
+            }
+            const execution = executions.get(event.executionId);
+            if (!execution)
+                return;
+            if (event.type === "finish") {
+                executions.delete(event.executionId);
+                complete(execution, event.status ?? "done", at);
+                return;
+            }
+            if (event.type === "usage") {
+                for (const dimension of usageDimensions) {
+                    const value = event.usage?.[dimension];
+                    if (value !== undefined && Number.isFinite(value) && value > 0)
+                        safe(() => counters.usage?.add(value, { "outpost.token.type": dimension }));
+                }
+                return;
+            }
+            if (event.key === undefined)
+                return;
+            if (event.type === "attempt") {
+                execution.attempts.set(event.key, start("outpost.task.attempt", execution.tasks.get(event.key)?.context ??
+                    execution.workflow.context, at));
+                safe(() => counters.attempts?.add(1));
+                return;
+            }
+            if (event.type === "retry") {
+                finish(execution.attempts.get(event.key), "failed", at, durations.attempt);
+                execution.attempts.delete(event.key);
+                safe(() => counters.retries?.add(1));
+                return;
+            }
+            if (event.type === "task" && event.status === "active") {
+                execution.tasks.set(event.key, start("outpost.task", execution.workflow.context, at));
+                return;
+            }
+            if (event.type === "task" && event.status) {
+                finish(execution.attempts.get(event.key), event.status, at, durations.attempt);
+                finish(execution.tasks.get(event.key), event.status, at, durations.task);
+                execution.attempts.delete(event.key);
+                execution.tasks.delete(event.key);
+                safe(() => counters.tasks?.add(1, { "outpost.status": event.status }));
+            }
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            for (const execution of executions.values())
+                complete(execution, "cancelled", Date.now());
+            executions.clear();
+        },
+    };
+}
+//# sourceMappingURL=opentelemetry.js.map

package/dist/infrastructure/opentelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, trace, SpanStatusCode } from \"@opentelemetry/api\";\nimport type { Context, Histogram } from \"@opentelemetry/api\";\nimport type { WorkflowEvent } from \"../domain/workflow.types.ts\";\nimport { usageDimensions } from \"../domain/workflow/budget.constants.ts\";\nimport { telemetryNames } from \"./opentelemetry.constants.ts\";\nimport type {\n  OpenTelemetryObserver,\n  OpenTelemetryOptions,\n  TelemetryExecution,\n  TelemetryOperation,\n} from \"./opentelemetry.types.ts\";\n\nexport type {\n  OpenTelemetryObserver,\n  OpenTelemetryOptions,\n} from \"./opentelemetry.types.ts\";\n\nexport function openTelemetry(\n  options: OpenTelemetryOptions,\n): OpenTelemetryObserver {\n  function safe<T>(action: () => T): T | undefined {\n    try {\n      return action();\n    } catch (error) {\n      try {\n        options.onError?.(error);\n      } catch {}\n    }\n  }\n  const counters = {\n    workflows: safe(() =>\n      options.meter.createCounter(telemetryNames.workflows),\n    ),\n    tasks: safe(() => options.meter.createCounter(telemetryNames.tasks)),\n    attempts: safe(() => options.meter.createCounter(telemetryNames.attempts)),\n    retries: safe(() => options.meter.createCounter(telemetryNames.retries)),\n    usage: safe(() =>\n      options.meter.createCounter(telemetryNames.usage, { unit: \"{token}\" }),\n    ),\n  };\n  const durations = {\n    workflow: safe(() =>\n      options.meter.createHistogram(telemetryNames.workflowDuration, {\n        unit: \"s\",\n      }),\n    ),\n    task: safe(() =>\n      options.meter.createHistogram(telemetryNames.taskDuration, { unit: \"s\" }),\n    ),\n    attempt: safe(() =>\n      options.meter.createHistogram(telemetryNames.attemptDuration, {\n        unit: \"s\",\n      }),\n    ),\n  };\n  const executions = new Map<string, TelemetryExecution>();\n  let closed = false;\n  function start(\n    name: string,\n    parent: Context,\n    at: number,\n  ): TelemetryOperation {\n    const span = safe(() =>\n      options.tracer.startSpan(name, { startTime: at }, parent),\n    );\n    return {\n      span,\n      context: span ? trace.setSpan(parent, span) : parent,\n      started: at,\n    };\n  }\n  function finish(\n    operation: TelemetryOperation | undefined,\n    status: string,\n    at: number,\n    duration: Histogram | undefined,\n  ): void {\n    if (!operation) return;\n    const attributes = { \"outpost.status\": status };\n    safe(() => operation.span?.setAttributes(attributes));\n    if (status !== \"skipped\")\n      safe(() =>\n        operation.span?.setStatus({\n          code: status === \"done\" ? SpanStatusCode.OK : SpanStatusCode.ERROR,\n        }),\n      );\n    safe(() => operation.span?.end(at));\n    safe(() =>\n      duration?.record(Math.max(0, at - operation.started) / 1000, attributes),\n    );\n  }\n  function complete(\n    execution: TelemetryExecution,\n    status: string,\n    at: number,\n  ): void {\n    for (const attempt of execution.attempts.values())\n      finish(attempt, status, at, durations.attempt);\n    for (const task of execution.tasks.values())\n      finish(task, status, at, durations.task);\n    finish(execution.workflow, status, at, durations.workflow);\n    safe(() => counters.workflows?.add(1, { \"outpost.status\": status }));\n  }\n  return {\n    observe(event: WorkflowEvent) {\n      if (closed) return;\n      const at = Date.parse(event.timestamp);\n      if (!Number.isFinite(at)) return;\n      if (event.type === \"start\") {\n        if (executions.has(event.executionId)) return;\n        executions.set(event.executionId, {\n          workflow: start(\"outpost.workflow\", context.active(), at),\n          tasks: new Map(),\n          attempts: new Map(),\n        });\n        return;\n      }\n      const execution = executions.get(event.executionId);\n      if (!execution) return;\n      if (event.type === \"finish\") {\n        executions.delete(event.executionId);\n        complete(execution, event.status ?? \"done\", at);\n        return;\n      }\n      if (event.type === \"usage\") {\n        for (const dimension of usageDimensions) {\n          const value = event.usage?.[dimension];\n          if (value !== undefined && Number.isFinite(value) && value > 0)\n            safe(() =>\n              counters.usage?.add(value, { \"outpost.token.type\": dimension }),\n            );\n        }\n        return;\n      }\n      if (event.key === undefined) return;\n      if (event.type === \"attempt\") {\n        execution.attempts.set(\n          event.key,\n          start(\n            \"outpost.task.attempt\",\n            execution.tasks.get(event.key)?.context ??\n              execution.workflow.context,\n            at,\n          ),\n        );\n        safe(() => counters.attempts?.add(1));\n        return;\n      }\n      if (event.type === \"retry\") {\n        finish(\n          execution.attempts.get(event.key),\n          \"failed\",\n          at,\n          durations.attempt,\n        );\n        execution.attempts.delete(event.key);\n        safe(() => counters.retries?.add(1));\n        return;\n      }\n      if (event.type === \"task\" && event.status === \"active\") {\n        execution.tasks.set(\n          event.key,\n          start(\"outpost.task\", execution.workflow.context, at),\n        );\n        return;\n      }\n      if (event.type === \"task\" && event.status) {\n        finish(\n          execution.attempts.get(event.key),\n          event.status,\n          at,\n          durations.attempt,\n        );\n        finish(\n          execution.tasks.get(event.key),\n          event.status,\n          at,\n          durations.task,\n        );\n        execution.attempts.delete(event.key);\n        execution.tasks.delete(event.key);\n        safe(() => counters.tasks?.add(1, { \"outpost.status\": event.status }));\n      }\n    },\n    close() {\n      if (closed) return;\n      closed = true;\n      for (const execution of executions.values())\n        complete(execution, \"cancelled\", Date.now());\n      executions.clear();\n    },\n  };\n}\n"]}

package/dist/infrastructure/opentelemetry.types.d.ts

@@ -0,0 +1,21 @@
+import type { Context, Meter, Span, Tracer } from "@opentelemetry/api";
+import type { WorkflowEvent } from "../domain/workflow.types.ts";
+export interface OpenTelemetryOptions {
+    readonly tracer: Tracer;
+    readonly meter: Meter;
+    readonly onError?: (error: unknown) => void;
+}
+export interface OpenTelemetryObserver {
+    observe(event: WorkflowEvent): void;
+    close(): void;
+}
+export interface TelemetryOperation {
+    readonly span: Span | undefined;
+    readonly context: Context;
+    readonly started: number;
+}
+export interface TelemetryExecution {
+    readonly workflow: TelemetryOperation;
+    readonly tasks: Map<string, TelemetryOperation>;
+    readonly attempts: Map<string, TelemetryOperation>;
+}

package/dist/infrastructure/opentelemetry.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=opentelemetry.types.js.map

package/dist/infrastructure/opentelemetry.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.types.js","sourceRoot":"","sources":["../../src/infrastructure/opentelemetry.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Context, Meter, Span, Tracer } from \"@opentelemetry/api\";\nimport type { WorkflowEvent } from \"../domain/workflow.types.ts\";\n\nexport interface OpenTelemetryOptions {\n  readonly tracer: Tracer;\n  readonly meter: Meter;\n  readonly onError?: (error: unknown) => void;\n}\n\nexport interface OpenTelemetryObserver {\n  observe(event: WorkflowEvent): void;\n  close(): void;\n}\n\nexport interface TelemetryOperation {\n  readonly span: Span | undefined;\n  readonly context: Context;\n  readonly started: number;\n}\n\nexport interface TelemetryExecution {\n  readonly workflow: TelemetryOperation;\n  readonly tasks: Map<string, TelemetryOperation>;\n  readonly attempts: Map<string, TelemetryOperation>;\n}\n"]}

package/dist/infrastructure/storage-inventory.constants.d.ts

@@ -0,0 +1,6 @@
+import type { StorageCategoryName } from "./storage-inventory.types.ts";
+export declare const storageCategories: readonly StorageCategoryName[];
+export declare const storageInventoryDefaults: Readonly<{
+    maxEntries: 100000;
+    maxDepth: 64;
+}>;

package/dist/infrastructure/storage-inventory.constants.js

@@ -0,0 +1,11 @@
+export const storageCategories = [
+    "recovery",
+    "logs",
+    "locks",
+    "workspaces",
+];
+export const storageInventoryDefaults = Object.freeze({
+    maxEntries: 100_000,
+    maxDepth: 64,
+});
+//# sourceMappingURL=storage-inventory.constants.js.map

package/dist/infrastructure/storage-inventory.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-inventory.constants.js","sourceRoot":"","sources":["../../src/infrastructure/storage-inventory.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,UAAU;IACV,MAAM;IACN,OAAO;IACP,YAAY;CACb,CAAC;AACF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,UAAU,EAAE,OAAO;IACnB,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC","sourcesContent":["import type { StorageCategoryName } from \"./storage-inventory.types.ts\";\n\nexport const storageCategories: readonly StorageCategoryName[] = [\n  \"recovery\",\n  \"logs\",\n  \"locks\",\n  \"workspaces\",\n];\nexport const storageInventoryDefaults = Object.freeze({\n  maxEntries: 100_000,\n  maxDepth: 64,\n});\n"]}

package/dist/infrastructure/storage-inventory.d.ts

@@ -0,0 +1,2 @@
+import type { StorageInventory } from "./storage-inventory.types.ts";
+export declare function storageInventory(root: string, maxEntries?: number): Promise<StorageInventory>;