@elie-laloum/outpost 4.0.0 → 4.2.0

package/dist/infrastructure/conversations.d.ts

@@ -1,3 +1,4 @@
+import { transportConversations } from "./transport-conversations.ts";
 import type { ConversationFormat } from "./conversations.types.ts";
 import { captureConversation } from "./conversations/capture.ts";
 import { locateConversation } from "./conversations/locate.ts";
@@ -13,6 +14,7 @@ export { projectKey } from "./conversations/paths.ts";
 export { relocateTranscript } from "./conversations/relocate.ts";
 export { restoreConversation } from "./conversations/restore.ts";
 export declare const conversations: {
+    transported: typeof transportConversations;
     native: typeof nativeConversations;
     locate: typeof locateConversation;
     capture: typeof captureConversation;

package/dist/infrastructure/conversations.js

@@ -1,3 +1,4 @@
+import { transportConversations } from "./transport-conversations.js";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { captureConversation } from "./conversations/capture.js";
@@ -14,6 +15,7 @@ export { projectKey } from "./conversations/paths.js";
 export { relocateTranscript } from "./conversations/relocate.js";
 export { restoreConversation } from "./conversations/restore.js";
 export const conversations = {
+    transported: transportConversations,
     native: nativeConversations,
     locate: locateConversation,
     capture: captureConversation,

package/dist/infrastructure/conversations.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/infrastructure/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAMjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,kBAAkB;IAC3B,UAAU;IACV,UAAU,CAAC,EAAU,EAAE,UAAkB,EAAE,IAAI,GAAG,OAAO,EAAE;QACzD,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,IAAI,CACT,IAAI,EACJ,SAAS,EACT,UAAU,EACV,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAC/B,GAAG,EAAE,QAAQ,CACd,CAAC;IACJ,CAAC;IACD,SAAS,CACP,MAA0B,EAC1B,UAAkB,EAClB,IAAI,GAAG,OAAO,EAAE;QAEhB,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,WAAW,EAAE,UAAU;CACxB,CAAC","sourcesContent":["import { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\nimport type { ConversationFormat } from \"./conversations.types.ts\";\nimport { captureConversation } from \"./conversations/capture.ts\";\nimport { conversationLayout } from \"./conversations/layout.ts\";\nimport { locateConversation } from \"./conversations/locate.ts\";\nimport { nativeConversations } from \"./conversations/native-store.ts\";\nimport { projectKey, remotePath, validId } from \"./conversations/paths.ts\";\nimport { relocateTranscript } from \"./conversations/relocate.ts\";\nimport { restoreConversation } from \"./conversations/restore.ts\";\n\nexport type {\n  ConversationFormat,\n  ConversationLocation,\n} from \"./conversations.types.ts\";\nexport { captureConversation } from \"./conversations/capture.ts\";\nexport { locateConversation } from \"./conversations/locate.ts\";\nexport { nativeConversations } from \"./conversations/native-store.ts\";\nexport { projectKey } from \"./conversations/paths.ts\";\nexport { relocateTranscript } from \"./conversations/relocate.ts\";\nexport { restoreConversation } from \"./conversations/restore.ts\";\n\nexport const conversations = {\n  native: nativeConversations,\n  locate: locateConversation,\n  capture: captureConversation,\n  restore: restoreConversation,\n  rewrite: relocateTranscript,\n  projectKey,\n  claudePath(id: string, repository: string, home = homedir()): string {\n    validId(id);\n    return join(\n      home,\n      \".claude\",\n      \"projects\",\n      projectKey(resolve(repository)),\n      `${id}.jsonl`,\n    );\n  },\n  directory(\n    format: ConversationFormat,\n    repository: string,\n    home = homedir(),\n  ): string {\n    return conversationLayout(format).directory(repository, home);\n  },\n  destination: remotePath,\n};\n"]}
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/infrastructure/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAMjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,WAAW,EAAE,sBAAsB;IACnC,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,kBAAkB;IAC3B,UAAU;IACV,UAAU,CAAC,EAAU,EAAE,UAAkB,EAAE,IAAI,GAAG,OAAO,EAAE;QACzD,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,IAAI,CACT,IAAI,EACJ,SAAS,EACT,UAAU,EACV,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAC/B,GAAG,EAAE,QAAQ,CACd,CAAC;IACJ,CAAC;IACD,SAAS,CACP,MAA0B,EAC1B,UAAkB,EAClB,IAAI,GAAG,OAAO,EAAE;QAEhB,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,WAAW,EAAE,UAAU;CACxB,CAAC","sourcesContent":["import { transportConversations } from \"./transport-conversations.ts\";\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\nimport type { ConversationFormat } from \"./conversations.types.ts\";\nimport { captureConversation } from \"./conversations/capture.ts\";\nimport { conversationLayout } from \"./conversations/layout.ts\";\nimport { locateConversation } from \"./conversations/locate.ts\";\nimport { nativeConversations } from \"./conversations/native-store.ts\";\nimport { projectKey, remotePath, validId } from \"./conversations/paths.ts\";\nimport { relocateTranscript } from \"./conversations/relocate.ts\";\nimport { restoreConversation } from \"./conversations/restore.ts\";\n\nexport type {\n  ConversationFormat,\n  ConversationLocation,\n} from \"./conversations.types.ts\";\nexport { captureConversation } from \"./conversations/capture.ts\";\nexport { locateConversation } from \"./conversations/locate.ts\";\nexport { nativeConversations } from \"./conversations/native-store.ts\";\nexport { projectKey } from \"./conversations/paths.ts\";\nexport { relocateTranscript } from \"./conversations/relocate.ts\";\nexport { restoreConversation } from \"./conversations/restore.ts\";\n\nexport const conversations = {\n  transported: transportConversations,\n  native: nativeConversations,\n  locate: locateConversation,\n  capture: captureConversation,\n  restore: restoreConversation,\n  rewrite: relocateTranscript,\n  projectKey,\n  claudePath(id: string, repository: string, home = homedir()): string {\n    validId(id);\n    return join(\n      home,\n      \".claude\",\n      \"projects\",\n      projectKey(resolve(repository)),\n      `${id}.jsonl`,\n    );\n  },\n  directory(\n    format: ConversationFormat,\n    repository: string,\n    home = homedir(),\n  ): string {\n    return conversationLayout(format).directory(repository, home);\n  },\n  destination: remotePath,\n};\n"]}

package/dist/infrastructure/inspection-file.js

@@ -1,7 +1,7 @@
-import { lstat, open, realpath } from "node:fs/promises";
-import { resolve } from "node:path";
+import { lstat, open } from "node:fs/promises";
 import { positive } from "../domain/errors.js";
 import { inspectionFileFlags } from "./inspection-file.constants.js";
+import { isDirectInspectionPath } from "./inspection-path.js";
 function unchanged(before, after) {
     return (before.dev === after.dev &&
         before.ino === after.ino &&
@@ -12,7 +12,7 @@ function unchanged(before, after) {
 export async function readInspectionFile(path, maxBytes) {
     positive(maxBytes, "maxBytes");
     const before = await lstat(path);
-    if (!before.isFile() || (await realpath(path)) !== resolve(path))
+    if (!before.isFile() || !(await isDirectInspectionPath(path)))
         throw new Error("Inspection path changed");
     if (before.size > maxBytes)
         throw new Error("Inspection file is too large");

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

@@ -1 +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"]}
+{"version":3,"file":"inspection-file.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,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,CAAC,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC3D,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 } from \"node:fs/promises\";\nimport type { Stats } from \"node:fs\";\nimport { positive } from \"../domain/errors.ts\";\nimport { inspectionFileFlags } from \"./inspection-file.constants.ts\";\nimport { isDirectInspectionPath } from \"./inspection-path.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 isDirectInspectionPath(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.js

@@ -1,9 +1,10 @@
 import { createHash } from "node:crypto";
-import { lstat, open, readlink, realpath } from "node:fs/promises";
-import { dirname, resolve } from "node:path";
+import { lstat, open, readlink } from "node:fs/promises";
+import { dirname } from "node:path";
 import { OutpostError } from "../domain/errors.js";
 import { inspectionFileFlags } from "./inspection-file.constants.js";
 import { inspectionHashChunkBytes } from "./inspection-hash.constants.js";
+import { isDirectInspectionPath } from "./inspection-path.js";
 function unchanged(before, after) {
     return (before.dev === after.dev &&
         before.ino === after.ino &&
@@ -13,7 +14,7 @@ function unchanged(before, after) {
 }
 export async function hashInspectionEntry(path, maxBytes = Number.MAX_SAFE_INTEGER) {
     const before = await lstat(path);
-    if ((await realpath(dirname(path))) !== resolve(dirname(path)))
+    if (!(await isDirectInspectionPath(dirname(path))))
         throw new Error("Hash path traverses a symlink");
     const hash = createHash("sha256");
     if (before.isSymbolicLink()) {

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

@@ -1 +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"]}
+{"version":3,"file":"inspection-hash.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,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,mBAAmB,CACvC,IAAY,EACZ,QAAQ,GAAG,MAAM,CAAC,gBAAgB;IAElC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,MAAM,GAAG,QAAQ;YAC1B,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,8BAA8B,EAAE;gBAClE,MAAM,EAAE,gBAAgB;aACzB,CAAC,CAAC;QACL,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC1C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC3E,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ;QACxB,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,8BAA8B,EAAE;YAClE,MAAM,EAAE,gBAAgB;SACzB,CAAC,CAAC;IACL,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,qBAAqB,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACtD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAC5B,MAAM,EACN,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,EAC5C,KAAK,CACN,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAChE,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,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,qBAAqB,CAAC,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7D,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { lstat, open, readlink } from \"node:fs/promises\";\nimport { dirname } 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 { isDirectInspectionPath } from \"./inspection-path.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 isDirectInspectionPath(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-path.d.ts

@@ -0,0 +1 @@
+export declare function isDirectInspectionPath(path: string): Promise<boolean>;

package/dist/infrastructure/inspection-path.js

@@ -0,0 +1,18 @@
+import { lstat, realpath } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+export async function isDirectInspectionPath(path) {
+    let current = resolve(path);
+    if ((await realpath(current)) === current)
+        return true;
+    if (process.platform !== "win32")
+        return false;
+    while (true) {
+        if ((await lstat(current)).isSymbolicLink())
+            return false;
+        const parent = dirname(current);
+        if (parent === current)
+            return true;
+        current = parent;
+    }
+}
+//# sourceMappingURL=inspection-path.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-path.js","sourceRoot":"","sources":["../../src/infrastructure/inspection-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC","sourcesContent":["import { lstat, realpath } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\n\nexport async function isDirectInspectionPath(path: string): Promise<boolean> {\n  let current = resolve(path);\n  if ((await realpath(current)) === current) return true;\n  if (process.platform !== \"win32\") return false;\n  while (true) {\n    if ((await lstat(current)).isSymbolicLink()) return false;\n    const parent = dirname(current);\n    if (parent === current) return true;\n    current = parent;\n  }\n}\n"]}

package/dist/infrastructure/journal.js

@@ -1,3 +1,4 @@
+import { transportJournal } from "./transport-journal.js";
 import { lock } from "./git/lock.js";
 import { markJournalClosed } from "./journal-retention.js";
 import { randomUUID } from "node:crypto";
@@ -5,6 +6,11 @@ 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) {
+    if (logging && logging !== "stdout" && logging.transporter) {
+        if (logging.file !== undefined)
+            throw new Error("Provide a journal file or transporter, not both");
+        return transportJournal(logging.transporter, logging.verbose ?? false, label);
+    }
     const file = logging && logging !== "stdout"
         ? resolve(repository, logging.file ??
             join(".outpost", "logs", `${label ? label.replace(/[^A-Za-z0-9_-]/g, "-").slice(0, 64) + "-" : ""}${new Date().toISOString().replaceAll(":", "-")}-${randomUUID()}.jsonl`))

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 { 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"]}
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/infrastructure/journal.ts"],"names":[],"mappings":"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","sourcesContent":["import { transportJournal } from \"./transport-journal.ts\";\nimport { 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  if (logging && logging !== \"stdout\" && logging.transporter) {\n    if (logging.file !== undefined)\n      throw new Error(\"Provide a journal file or transporter, not both\");\n    return transportJournal(\n      logging.transporter,\n      logging.verbose ?? false,\n      label,\n    );\n  }\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/journal.types.d.ts

@@ -1,10 +1,13 @@
+import type { Transport, TransportReference } from "../domain/transport.types.ts";
 import type { AgentEvent } from "../domain/agent.types.ts";
 export type Logging = false | "stdout" | {
     readonly file?: string;
+    readonly transporter?: Transport;
     readonly verbose?: boolean;
 };
 export type Journal = {
     file?: string;
+    reference?: TransportReference;
     record(event: AgentEvent): void;
     close(): Promise<void>;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"journal.types.js","sourceRoot":"","sources":["../../src/infrastructure/journal.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentEvent } from \"../domain/agent.types.ts\";\n\nexport type Logging =\n  false | \"stdout\" | { readonly file?: string; readonly verbose?: boolean };\n\nexport type Journal = {\n  file?: string;\n  record(event: AgentEvent): void;\n  close(): Promise<void>;\n};\n"]}
+{"version":3,"file":"journal.types.js","sourceRoot":"","sources":["../../src/infrastructure/journal.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Transport,\n  TransportReference,\n} from \"../domain/transport.types.ts\";\nimport type { AgentEvent } from \"../domain/agent.types.ts\";\n\nexport type Logging =\n  | false\n  | \"stdout\"\n  | {\n      readonly file?: string;\n      readonly transporter?: Transport;\n      readonly verbose?: boolean;\n    };\n\nexport type Journal = {\n  file?: string;\n  reference?: TransportReference;\n  record(event: AgentEvent): void;\n  close(): Promise<void>;\n};\n"]}

package/dist/infrastructure/local-transport.d.ts

@@ -0,0 +1,3 @@
+import type { Transport } from "../domain/transport.types.ts";
+import type { LocalTransportOptions } from "./local-transport.types.ts";
+export declare function localTransport(options: LocalTransportOptions): Transport;

package/dist/infrastructure/local-transport.js

@@ -0,0 +1,146 @@
+import { mkdir, lstat, open, rename, rm, readdir } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { setTimeout } from "node:timers/promises";
+import { TransportConflict, transportKey, transportCondition, } from "../domain/transport.js";
+import { lock } from "./git/lock.js";
+import { OutpostError } from "../domain/errors.js";
+import { readInspectionFile } from "./inspection-file.js";
+import { decodeObject, encodeObject, readLimit } from "./transport-envelope.js";
+import { transportDefaults } from "./transport.constants.js";
+async function privateDirectory(path) {
+    const parent = dirname(path);
+    if (parent !== path) {
+        await privateDirectory(parent);
+        await mkdir(path, { recursive: true, mode: 0o700 });
+    }
+    if (!(await lstat(path)).isDirectory())
+        throw new Error("Transport directories must not be symlinks");
+}
+export function localTransport(options) {
+    const root = resolve(options.directory), objects = join(root, "objects");
+    const path = (key) => join(objects, `${transportKey(key)}.object`);
+    const read = async (key, options = {}) => {
+        options.signal?.throwIfAborted();
+        const limit = readLimit(options.maxBytes);
+        try {
+            const target = path(key);
+            const info = await lstat(target);
+            const data = await readInspectionFile(target, Math.min(info.size, limit + transportDefaults.headerBytes) || 1);
+            options.signal?.throwIfAborted();
+            return decodeObject(data, key, limit);
+        }
+        catch (error) {
+            if (error &&
+                typeof error === "object" &&
+                "code" in error &&
+                error.code === "ENOENT")
+                return undefined;
+            throw error;
+        }
+    };
+    async function mutate(key, options, action) {
+        transportKey(key);
+        transportCondition(options.ifRevision);
+        await privateDirectory(root);
+        const signal = AbortSignal.any([
+            AbortSignal.timeout(transportDefaults.lockMs),
+            ...(options.signal ? [options.signal] : []),
+        ]);
+        let release;
+        while (!release) {
+            signal.throwIfAborted();
+            try {
+                release = await lock(root, key);
+            }
+            catch (error) {
+                if (!(error instanceof OutpostError) || error.code !== "conflict")
+                    throw error;
+                await setTimeout(transportDefaults.retryMs, undefined, { signal });
+            }
+        }
+        try {
+            if ((await read(key))?.revision !== (options.ifRevision ?? undefined))
+                throw new TransportConflict(key);
+            options.signal?.throwIfAborted();
+            return await action();
+        }
+        finally {
+            await release();
+        }
+    }
+    return {
+        name: "local",
+        read,
+        write(key, input, options) {
+            const bytes = Buffer.from(input);
+            return mutate(key, options, async () => {
+                const target = path(key);
+                await privateDirectory(dirname(target));
+                const { entry, data } = encodeObject(key, bytes);
+                const temporary = `${target}.${randomUUID()}.tmp`;
+                try {
+                    const file = await open(temporary, "wx", 0o600);
+                    try {
+                        await file.writeFile(data, { signal: options.signal });
+                        await file.sync();
+                    }
+                    finally {
+                        await file.close();
+                    }
+                    options.signal?.throwIfAborted();
+                    await rename(temporary, target);
+                    if (process.platform !== "win32") {
+                        const parent = await open(dirname(target), "r");
+                        try {
+                            await parent.sync();
+                        }
+                        finally {
+                            await parent.close();
+                        }
+                    }
+                    return entry;
+                }
+                finally {
+                    await rm(temporary, { force: true });
+                }
+            });
+        },
+        remove(key, options) {
+            if (options.ifRevision === null)
+                return Promise.reject(new Error("Transport removal requires an existing revision"));
+            return mutate(key, options, () => rm(path(key), { force: true }));
+        },
+        async *list(prefix = "", options = {}) {
+            if (prefix)
+                transportKey(prefix.replace(/\/$/, ""));
+            async function* scan(directory, base) {
+                const entries = await readdir(directory, { withFileTypes: true }).catch((error) => {
+                    if (error.code === "ENOENT")
+                        return [];
+                    throw error;
+                });
+                for (const entry of entries) {
+                    options.signal?.throwIfAborted();
+                    const name = `${base}${entry.name}`;
+                    if (entry.isDirectory())
+                        yield* scan(join(directory, entry.name), `${name}/`);
+                    if (entry.isFile() && name.endsWith(".object"))
+                        yield name.slice(0, -7);
+                    if (entry.isSymbolicLink())
+                        throw new Error("Transport objects must not be symlinks");
+                }
+            }
+            for await (const key of scan(objects, "")) {
+                if (!key.startsWith(prefix))
+                    continue;
+                const object = await read(key, options.signal ? { signal: options.signal } : {});
+                if (object) {
+                    const { bytes: _bytes, ...entry } = object;
+                    yield entry;
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=local-transport.js.map

package/dist/infrastructure/local-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transport.js","sourceRoot":"","sources":["../../src/infrastructure/local-transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, lstat, open, rename, rm, readdir } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { setTimeout } from \"node:timers/promises\";\nimport {\n  TransportConflict,\n  transportKey,\n  transportCondition,\n} from \"../domain/transport.ts\";\nimport type {\n  Transport,\n  TransportWriteOptions,\n} from \"../domain/transport.types.ts\";\nimport type { LocalTransportOptions } from \"./local-transport.types.ts\";\nimport { lock } from \"./git/lock.ts\";\nimport { OutpostError } from \"../domain/errors.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport { decodeObject, encodeObject, readLimit } from \"./transport-envelope.ts\";\nimport { transportDefaults } from \"./transport.constants.ts\";\n\nasync function privateDirectory(path: string): Promise<void> {\n  const parent = dirname(path);\n  if (parent !== path) {\n    await privateDirectory(parent);\n    await mkdir(path, { recursive: true, mode: 0o700 });\n  }\n  if (!(await lstat(path)).isDirectory())\n    throw new Error(\"Transport directories must not be symlinks\");\n}\n\nexport function localTransport(options: LocalTransportOptions): Transport {\n  const root = resolve(options.directory),\n    objects = join(root, \"objects\");\n  const path = (key: string) => join(objects, `${transportKey(key)}.object`);\n  const read: Transport[\"read\"] = async (key, options = {}) => {\n    options.signal?.throwIfAborted();\n    const limit = readLimit(options.maxBytes);\n    try {\n      const target = path(key);\n      const info = await lstat(target);\n      const data = await readInspectionFile(\n        target,\n        Math.min(info.size, limit + transportDefaults.headerBytes) || 1,\n      );\n      options.signal?.throwIfAborted();\n      return decodeObject(data, key, limit);\n    } catch (error) {\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      )\n        return undefined;\n      throw error;\n    }\n  };\n  async function mutate<T>(\n    key: string,\n    options: TransportWriteOptions,\n    action: () => Promise<T>,\n  ): Promise<T> {\n    transportKey(key);\n    transportCondition(options.ifRevision);\n    await privateDirectory(root);\n    const signal = AbortSignal.any([\n      AbortSignal.timeout(transportDefaults.lockMs),\n      ...(options.signal ? [options.signal] : []),\n    ]);\n    let release: (() => Promise<void>) | undefined;\n    while (!release) {\n      signal.throwIfAborted();\n      try {\n        release = await lock(root, key);\n      } catch (error) {\n        if (!(error instanceof OutpostError) || error.code !== \"conflict\")\n          throw error;\n        await setTimeout(transportDefaults.retryMs, undefined, { signal });\n      }\n    }\n    try {\n      if ((await read(key))?.revision !== (options.ifRevision ?? undefined))\n        throw new TransportConflict(key);\n      options.signal?.throwIfAborted();\n      return await action();\n    } finally {\n      await release();\n    }\n  }\n  return {\n    name: \"local\",\n    read,\n    write(key, input, options) {\n      const bytes = Buffer.from(input);\n      return mutate(key, options, async () => {\n        const target = path(key);\n        await privateDirectory(dirname(target));\n        const { entry, data } = encodeObject(key, bytes);\n        const temporary = `${target}.${randomUUID()}.tmp`;\n        try {\n          const file = await open(temporary, \"wx\", 0o600);\n          try {\n            await file.writeFile(data, { signal: options.signal });\n            await file.sync();\n          } finally {\n            await file.close();\n          }\n          options.signal?.throwIfAborted();\n          await rename(temporary, target);\n          if (process.platform !== \"win32\") {\n            const parent = await open(dirname(target), \"r\");\n            try {\n              await parent.sync();\n            } finally {\n              await parent.close();\n            }\n          }\n          return entry;\n        } finally {\n          await rm(temporary, { force: true });\n        }\n      });\n    },\n    remove(key, options) {\n      if (options.ifRevision === null)\n        return Promise.reject(\n          new Error(\"Transport removal requires an existing revision\"),\n        );\n      return mutate(key, options, () => rm(path(key), { force: true }));\n    },\n    async *list(prefix = \"\", options = {}) {\n      if (prefix) transportKey(prefix.replace(/\\/$/, \"\"));\n      async function* scan(\n        directory: string,\n        base: string,\n      ): AsyncIterable<string> {\n        const entries = await readdir(directory, { withFileTypes: true }).catch(\n          (error) => {\n            if (error.code === \"ENOENT\") return [];\n            throw error;\n          },\n        );\n        for (const entry of entries) {\n          options.signal?.throwIfAborted();\n          const name = `${base}${entry.name}`;\n          if (entry.isDirectory())\n            yield* scan(join(directory, entry.name), `${name}/`);\n          if (entry.isFile() && name.endsWith(\".object\"))\n            yield name.slice(0, -7);\n          if (entry.isSymbolicLink())\n            throw new Error(\"Transport objects must not be symlinks\");\n        }\n      }\n      for await (const key of scan(objects, \"\")) {\n        if (!key.startsWith(prefix)) continue;\n        const object = await read(\n          key,\n          options.signal ? { signal: options.signal } : {},\n        );\n        if (object) {\n          const { bytes: _bytes, ...entry } = object;\n          yield entry;\n        }\n      }\n    },\n  };\n}\n"]}

package/dist/infrastructure/local-transport.types.d.ts

@@ -0,0 +1,3 @@
+export interface LocalTransportOptions {
+    readonly directory: string;
+}

package/dist/infrastructure/local-transport.types.js

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

package/dist/infrastructure/local-transport.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transport.types.js","sourceRoot":"","sources":["../../src/infrastructure/local-transport.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface LocalTransportOptions {\n  readonly directory: string;\n}\n"]}

package/dist/infrastructure/resource-activity-inspection.d.ts

@@ -1,2 +1,3 @@
-import type { ResourceInspection } from "./resource-activity.types.ts";
+import type { ResourceActivityRecord, ResourceInspection } from "./resource-activity.types.ts";
+export declare function resourceRecord(value: unknown): ResourceActivityRecord;
 export declare function inspectResourceActivity(repository: string, maxEntries?: number): Promise<ResourceInspection>;

package/dist/infrastructure/resource-activity-inspection.js

@@ -54,7 +54,7 @@ function identity(value) {
         started: value.started,
     };
 }
-function record(value) {
+export function resourceRecord(value) {
     object(value);
     invariant(value.version === 1, "Unknown activity version");
     text(value.id);
@@ -114,7 +114,7 @@ export async function inspectResourceActivity(repository, maxEntries = defaults.
                 break;
             }
             try {
-                const value = record(JSON.parse((await readInspectionFile(file, defaults.maxRecordBytes)).toString("utf8")));
+                const value = resourceRecord(JSON.parse((await readInspectionFile(file, defaults.maxRecordBytes)).toString("utf8")));
                 invariant(entry.name === `${value.id}.json`, "Activity identity mismatch");
                 entries.push({
                     path: file,

package/dist/infrastructure/resource-activity-inspection.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-activity-inspection.js","sourceRoot":"","sources":["../../src/infrastructure/resource-activity-inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstat, opendir, realpath } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { invariant, positive } from \"../domain/errors.ts\";\nimport { observeOwnership } from \"./git/process-identity.ts\";\nimport type { LocalProcessIdentity } from \"./git/process-identity.types.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport {\n  resourceActivityDefaults as defaults,\n  resourceOperationKinds,\n  resourcePhases,\n} from \"./resource-activity.constants.ts\";\nimport type {\n  ResourceActivityRecord,\n  ResourceInspection,\n  ResourceInspectionEntry,\n  ResourceOperation,\n  ResourceOperationResult,\n} from \"./resource-activity.types.ts\";\nimport type { StorageIssue } from \"./storage-inventory.types.ts\";\n\nfunction object(value: unknown): asserts value is Record<string, unknown> {\n  invariant(\n    !!value && typeof value === \"object\" && !Array.isArray(value),\n    \"Invalid activity object\",\n  );\n}\nfunction text(value: unknown): asserts value is string {\n  invariant(\n    typeof value === \"string\" &&\n      value.length > 0 &&\n      value.length <= defaults.maxText,\n    \"Invalid activity text\",\n  );\n}\nfunction date(value: unknown): asserts value is string {\n  text(value);\n  invariant(Number.isFinite(Date.parse(value)), \"Invalid activity time\");\n}\nfunction operation(value: unknown): ResourceOperation {\n  object(value);\n  invariant(\n    typeof value.count === \"number\" &&\n      Number.isSafeInteger(value.count) &&\n      value.count > 0,\n    \"Invalid activity count\",\n  );\n  date(value.startedAt);\n  const kind = resourceOperationKinds.find((kind) => kind === value.kind);\n  invariant(kind, \"Invalid activity operation\");\n  return { count: value.count, startedAt: value.startedAt, kind };\n}\nfunction result(value: unknown): ResourceOperationResult {\n  const base = operation(value);\n  object(value);\n  text(value.id);\n  date(value.finishedAt);\n  invariant(\n    value.outcome === \"completed\" || value.outcome === \"failed\",\n    \"Invalid activity outcome\",\n  );\n  return {\n    ...base,\n    id: value.id,\n    finishedAt: value.finishedAt,\n    outcome: value.outcome,\n  };\n}\nfunction identity(value: unknown): LocalProcessIdentity | undefined {\n  if (value === undefined) return undefined;\n  object(value);\n  text(value.host);\n  text(value.boot);\n  text(value.namespace);\n  text(value.started);\n  return {\n    host: value.host,\n    boot: value.boot,\n    namespace: value.namespace,\n    started: value.started,\n  };\n}\nfunction record(value: unknown): ResourceActivityRecord {\n  object(value);\n  invariant(value.version === 1, \"Unknown activity version\");\n  text(value.id);\n  text(value.provider);\n  text(value.workspace);\n  date(value.createdAt);\n  date(value.updatedAt);\n  invariant(\n    typeof value.pid === \"number\" &&\n      Number.isSafeInteger(value.pid) &&\n      value.pid > 0 &&\n      value.pid <= 2_147_483_647,\n    \"Invalid activity owner\",\n  );\n  invariant(\n    value.placement === \"host\" ||\n      value.placement === \"mounted\" ||\n      value.placement === \"remote\",\n    \"Invalid activity placement\",\n  );\n  const phase = resourcePhases.find((phase) => phase === value.phase);\n  invariant(phase, \"Invalid activity phase\");\n  invariant(\n    Array.isArray(value.operations) &&\n      value.operations.length <= resourceOperationKinds.length,\n    \"Invalid activity operations\",\n  );\n  const owner = identity(value.identity);\n  return {\n    version: 1,\n    id: value.id,\n    pid: value.pid,\n    ...(owner ? { identity: owner } : {}),\n    provider: value.provider,\n    placement: value.placement,\n    workspace: value.workspace,\n    createdAt: value.createdAt,\n    updatedAt: value.updatedAt,\n    phase,\n    operations: value.operations.map(operation),\n    ...(value.lastOperation === undefined\n      ? {}\n      : { lastOperation: result(value.lastOperation) }),\n    ...(value.lastFailure === undefined\n      ? {}\n      : { lastFailure: result(value.lastFailure) }),\n  };\n}\n\nexport async function inspectResourceActivity(\n  repository: string,\n  maxEntries: number = defaults.maxRecords,\n): Promise<ResourceInspection> {\n  positive(maxEntries, \"maxEntries\");\n  const entries: ResourceInspectionEntry[] = [];\n  const issues: StorageIssue[] = [];\n  let path = repository;\n  try {\n    for (const part of [\".outpost\", \"locks\", defaults.directory]) {\n      path = join(path, part);\n      const info = await lstat(path);\n      invariant(\n        info.isDirectory() &&\n          !info.isSymbolicLink() &&\n          (await realpath(path)) === path,\n        \"Unsafe activity directory\",\n      );\n    }\n    for await (const entry of await opendir(path)) {\n      const file = join(path, entry.name);\n      if (entries.length >= Math.min(maxEntries, defaults.maxRecords)) {\n        issues.push({ path, code: \"RESOURCE_ENTRY_LIMIT\" });\n        break;\n      }\n      try {\n        const value = record(\n          JSON.parse(\n            (await readInspectionFile(file, defaults.maxRecordBytes)).toString(\n              \"utf8\",\n            ),\n          ),\n        );\n        invariant(\n          entry.name === `${value.id}.json`,\n          \"Activity identity mismatch\",\n        );\n        entries.push({\n          path: file,\n          record: value,\n          ownership: await observeOwnership(value.pid, value.identity),\n        });\n      } catch {\n        entries.push({\n          path: file,\n          ownership: {\n            status: \"unknown\",\n            reason: \"RESOURCE_RECORD_UNREADABLE\",\n          },\n        });\n        issues.push({ path: file, code: \"RESOURCE_RECORD_UNREADABLE\" });\n      }\n    }\n  } catch (cause) {\n    if (!(\n      cause &&\n      typeof cause === \"object\" &&\n      \"code\" in cause &&\n      cause.code === \"ENOENT\"\n    ))\n      issues.push({ path, code: \"RESOURCE_DIRECTORY_UNAVAILABLE\" });\n  }\n  entries.sort((left, right) => left.path.localeCompare(right.path));\n  return {\n    scope: \"recorded-sandboxes\",\n    complete: issues.length === 0,\n    entries,\n    issues,\n  };\n}\n"]}
+{"version":3,"file":"resource-activity-inspection.js","sourceRoot":"","sources":["../../src/infrastructure/resource-activity-inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstat, opendir, realpath } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { invariant, positive } from \"../domain/errors.ts\";\nimport { observeOwnership } from \"./git/process-identity.ts\";\nimport type { LocalProcessIdentity } from \"./git/process-identity.types.ts\";\nimport { readInspectionFile } from \"./inspection-file.ts\";\nimport {\n  resourceActivityDefaults as defaults,\n  resourceOperationKinds,\n  resourcePhases,\n} from \"./resource-activity.constants.ts\";\nimport type {\n  ResourceActivityRecord,\n  ResourceInspection,\n  ResourceInspectionEntry,\n  ResourceOperation,\n  ResourceOperationResult,\n} from \"./resource-activity.types.ts\";\nimport type { StorageIssue } from \"./storage-inventory.types.ts\";\n\nfunction object(value: unknown): asserts value is Record<string, unknown> {\n  invariant(\n    !!value && typeof value === \"object\" && !Array.isArray(value),\n    \"Invalid activity object\",\n  );\n}\nfunction text(value: unknown): asserts value is string {\n  invariant(\n    typeof value === \"string\" &&\n      value.length > 0 &&\n      value.length <= defaults.maxText,\n    \"Invalid activity text\",\n  );\n}\nfunction date(value: unknown): asserts value is string {\n  text(value);\n  invariant(Number.isFinite(Date.parse(value)), \"Invalid activity time\");\n}\nfunction operation(value: unknown): ResourceOperation {\n  object(value);\n  invariant(\n    typeof value.count === \"number\" &&\n      Number.isSafeInteger(value.count) &&\n      value.count > 0,\n    \"Invalid activity count\",\n  );\n  date(value.startedAt);\n  const kind = resourceOperationKinds.find((kind) => kind === value.kind);\n  invariant(kind, \"Invalid activity operation\");\n  return { count: value.count, startedAt: value.startedAt, kind };\n}\nfunction result(value: unknown): ResourceOperationResult {\n  const base = operation(value);\n  object(value);\n  text(value.id);\n  date(value.finishedAt);\n  invariant(\n    value.outcome === \"completed\" || value.outcome === \"failed\",\n    \"Invalid activity outcome\",\n  );\n  return {\n    ...base,\n    id: value.id,\n    finishedAt: value.finishedAt,\n    outcome: value.outcome,\n  };\n}\nfunction identity(value: unknown): LocalProcessIdentity | undefined {\n  if (value === undefined) return undefined;\n  object(value);\n  text(value.host);\n  text(value.boot);\n  text(value.namespace);\n  text(value.started);\n  return {\n    host: value.host,\n    boot: value.boot,\n    namespace: value.namespace,\n    started: value.started,\n  };\n}\nexport function resourceRecord(value: unknown): ResourceActivityRecord {\n  object(value);\n  invariant(value.version === 1, \"Unknown activity version\");\n  text(value.id);\n  text(value.provider);\n  text(value.workspace);\n  date(value.createdAt);\n  date(value.updatedAt);\n  invariant(\n    typeof value.pid === \"number\" &&\n      Number.isSafeInteger(value.pid) &&\n      value.pid > 0 &&\n      value.pid <= 2_147_483_647,\n    \"Invalid activity owner\",\n  );\n  invariant(\n    value.placement === \"host\" ||\n      value.placement === \"mounted\" ||\n      value.placement === \"remote\",\n    \"Invalid activity placement\",\n  );\n  const phase = resourcePhases.find((phase) => phase === value.phase);\n  invariant(phase, \"Invalid activity phase\");\n  invariant(\n    Array.isArray(value.operations) &&\n      value.operations.length <= resourceOperationKinds.length,\n    \"Invalid activity operations\",\n  );\n  const owner = identity(value.identity);\n  return {\n    version: 1,\n    id: value.id,\n    pid: value.pid,\n    ...(owner ? { identity: owner } : {}),\n    provider: value.provider,\n    placement: value.placement,\n    workspace: value.workspace,\n    createdAt: value.createdAt,\n    updatedAt: value.updatedAt,\n    phase,\n    operations: value.operations.map(operation),\n    ...(value.lastOperation === undefined\n      ? {}\n      : { lastOperation: result(value.lastOperation) }),\n    ...(value.lastFailure === undefined\n      ? {}\n      : { lastFailure: result(value.lastFailure) }),\n  };\n}\n\nexport async function inspectResourceActivity(\n  repository: string,\n  maxEntries: number = defaults.maxRecords,\n): Promise<ResourceInspection> {\n  positive(maxEntries, \"maxEntries\");\n  const entries: ResourceInspectionEntry[] = [];\n  const issues: StorageIssue[] = [];\n  let path = repository;\n  try {\n    for (const part of [\".outpost\", \"locks\", defaults.directory]) {\n      path = join(path, part);\n      const info = await lstat(path);\n      invariant(\n        info.isDirectory() &&\n          !info.isSymbolicLink() &&\n          (await realpath(path)) === path,\n        \"Unsafe activity directory\",\n      );\n    }\n    for await (const entry of await opendir(path)) {\n      const file = join(path, entry.name);\n      if (entries.length >= Math.min(maxEntries, defaults.maxRecords)) {\n        issues.push({ path, code: \"RESOURCE_ENTRY_LIMIT\" });\n        break;\n      }\n      try {\n        const value = resourceRecord(\n          JSON.parse(\n            (await readInspectionFile(file, defaults.maxRecordBytes)).toString(\n              \"utf8\",\n            ),\n          ),\n        );\n        invariant(\n          entry.name === `${value.id}.json`,\n          \"Activity identity mismatch\",\n        );\n        entries.push({\n          path: file,\n          record: value,\n          ownership: await observeOwnership(value.pid, value.identity),\n        });\n      } catch {\n        entries.push({\n          path: file,\n          ownership: {\n            status: \"unknown\",\n            reason: \"RESOURCE_RECORD_UNREADABLE\",\n          },\n        });\n        issues.push({ path: file, code: \"RESOURCE_RECORD_UNREADABLE\" });\n      }\n    }\n  } catch (cause) {\n    if (!(\n      cause &&\n      typeof cause === \"object\" &&\n      \"code\" in cause &&\n      cause.code === \"ENOENT\"\n    ))\n      issues.push({ path, code: \"RESOURCE_DIRECTORY_UNAVAILABLE\" });\n  }\n  entries.sort((left, right) => left.path.localeCompare(right.path));\n  return {\n    scope: \"recorded-sandboxes\",\n    complete: issues.length === 0,\n    entries,\n    issues,\n  };\n}\n"]}

package/dist/infrastructure/resource-activity.js

@@ -1,3 +1,5 @@
+import { TransportConflict } from "../domain/transport.js";
+import { jsonBytes } from "./transport-json.js";
 import { randomUUID } from "node:crypto";
 import { mkdir, open, realpath, rename, rm, opendir } from "node:fs/promises";
 import { join } from "node:path";
@@ -18,9 +20,11 @@ async function activityDirectory(repository) {
 export async function registerResourceActivity(options) {
     for (const text of [options.workspace, options.provider])
         invariant(text.length > 0 && text.length <= defaults.maxText, "Resource activity metadata exceeds its size limit");
-    const directory = await activityDirectory(options.repository);
+    const remote = options.transporter;
+    const directory = remote ? "" : await activityDirectory(options.repository);
+    let revision;
     const id = randomUUID();
-    const path = join(directory, `${id}.json`);
+    const path = remote ? `resources/${id}.json` : join(directory, `${id}.json`);
     const createdAt = new Date().toISOString();
     const identity = await localProcessIdentity();
     let record = {
@@ -36,18 +40,25 @@ export async function registerResourceActivity(options) {
         phase: "allocating",
         operations: [],
     };
-    const unlock = await lockStorageMutation(options.repository);
+    const unlock = remote
+        ? async () => { }
+        : await lockStorageMutation(options.repository);
     try {
-        let count = 0;
-        for await (const _entry of await opendir(directory))
-            invariant(++count < defaults.maxRecords, "Too many resource activity records; inspect retained ownership before continuing");
-        const file = await open(path, "wx", 0o600);
-        try {
-            await file.writeFile(JSON.stringify(record));
-            await file.sync();
+        if (remote) {
+            revision = (await remote.write(path, jsonBytes(record), { ifRevision: null })).revision;
         }
-        finally {
-            await file.close();
+        if (!remote) {
+            let count = 0;
+            for await (const _entry of await opendir(directory))
+                invariant(++count < defaults.maxRecords, "Too many resource activity records; inspect retained ownership before continuing");
+            const file = await open(path, "wx", 0o600);
+            try {
+                await file.writeFile(JSON.stringify(record));
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
         }
     }
     finally {
@@ -61,7 +72,13 @@ export async function registerResourceActivity(options) {
         return next;
     }
     async function verify() {
-        invariant((await realpath(directory)) === directory, "Resource activity directory changed");
+        invariant(!removed, "Resource activity is closed");
+        if (remote) {
+            if ((await remote.read(path))?.revision !== revision)
+                throw new TransportConflict(path);
+            return;
+        }
+        invariant(remote || (await realpath(directory)) === directory, "Resource activity directory changed");
         invariant(!removed, "Resource activity is closed");
         const current = (await readInspectionFile(path, defaults.maxRecordBytes)).toString("utf8");
         invariant(current === JSON.stringify(record), "Resource activity identity changed; refusing mutation");
@@ -72,6 +89,12 @@ export async function registerResourceActivity(options) {
             const value = { ...next(), updatedAt: new Date().toISOString() };
             const data = JSON.stringify(value);
             invariant(Buffer.byteLength(data) <= defaults.maxRecordBytes, "Resource activity record exceeds its size limit");
+            if (remote) {
+                invariant(revision, "Resource revision unavailable");
+                revision = (await remote.write(path, jsonBytes(value), { ifRevision: revision })).revision;
+                record = value;
+                return;
+            }
             const temporary = `${path}.${randomUUID()}.tmp`;
             const file = await open(temporary, "wx", 0o600);
             try {
@@ -150,7 +173,12 @@ export async function registerResourceActivity(options) {
             invariant(record.operations.length === 0, "Resource operations remain unsettled; activity record retained");
             try {
                 await verify();
-                await rm(path);
+                if (remote) {
+                    invariant(revision, "Resource revision unavailable");
+                    await remote.remove(path, { ifRevision: revision });
+                }
+                else
+                    await rm(path);
             }
             catch (cause) {
                 if (!(cause &&