@ebay-dt/bonfire-node 0.2.0-alpha.7 → 0.2.0-alpha.8

package/dist/lifecycle/deployment-worktree.js

@@ -0,0 +1,223 @@
+import { lstat, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, relative, sep } from "node:path";
+import { createGitRepository, GitRepositoryError, } from "../git-repository.js";
+const OWNERSHIP_MARKER = "bonfire deployment workspace\n";
+const SOURCE_SHA_PATTERN = /^[0-9a-f]{40,64}$/u;
+export class DeploymentWorktreeError extends Error {
+    kind;
+    cleanupFailed;
+    operationError;
+    cause;
+    constructor(kind, options = {}) {
+        super(`Deployment workspace operation failed: ${kind}`);
+        this.name = "DeploymentWorktreeError";
+        this.kind = kind;
+        this.cleanupFailed = options.cleanupFailed ?? false;
+        this.operationError = options.operationError;
+        this.cause = options.operationError;
+    }
+}
+function withCleanupFailure(error) {
+    if (error instanceof DeploymentWorktreeError) {
+        return new DeploymentWorktreeError(error.kind, {
+            cleanupFailed: true,
+            operationError: error.operationError ?? error,
+        });
+    }
+    return new DeploymentWorktreeError("cleanup-failure", {
+        cleanupFailed: true,
+        operationError: error,
+    });
+}
+function assertBranchName(value, option) {
+    if (value.length === 0 ||
+        value.startsWith("-") ||
+        value.includes("\0") ||
+        /\s/u.test(value) ||
+        value.includes("@{") ||
+        value.split(/[\\/]/u).some((segment) => segment === "..")) {
+        throw new TypeError(`Invalid ${option}`);
+    }
+}
+function assertSourceSha(sourceSha) {
+    if (!SOURCE_SHA_PATTERN.test(sourceSha)) {
+        throw new DeploymentWorktreeError("invalid-source");
+    }
+}
+function remotePrimaryRef(options) {
+    return `refs/remotes/${options.remote}/${options.primaryBranch}`;
+}
+function mapMergeError(error, phase) {
+    if (!(error instanceof GitRepositoryError))
+        return error;
+    if (error.kind === "conflict") {
+        return new DeploymentWorktreeError(`${phase}-conflict`);
+    }
+    if (phase === "publication") {
+        if (error.kind === "non-fast-forward") {
+            return new DeploymentWorktreeError("publication-rejected");
+        }
+        return new DeploymentWorktreeError("publication-failure");
+    }
+    return error;
+}
+async function createDeploymentWorktree(repository, options) {
+    assertBranchName(options.remote, "remote");
+    assertBranchName(options.primaryBranch, "primary branch");
+    assertSourceSha(options.sourceSha);
+    await repository.fetch(options.remote, options.primaryBranch);
+    const operationDirectory = await mkdtemp(join(tmpdir(), "bonfire-deployment-"));
+    const workspacePath = join(operationDirectory, "workspace");
+    const markerPath = join(operationDirectory, "OWNER");
+    let worktreeAdded = false;
+    try {
+        await writeFile(markerPath, OWNERSHIP_MARKER, { flag: "wx" });
+        await repository.raw([
+            "worktree",
+            "add",
+            "--detach",
+            workspacePath,
+            remotePrimaryRef(options),
+        ]);
+        worktreeAdded = true;
+        const workspaceRepository = createGitRepository({
+            repositoryRoot: workspacePath,
+            timeoutMs: options.timeoutMs,
+            commitIdentity: options.commitIdentity,
+        });
+        await workspaceRepository.raw(["cat-file", "-e", `${options.sourceSha}^{commit}`]);
+        return {
+            path: workspacePath,
+            repository: workspaceRepository,
+            async cleanup() {
+                try {
+                    const marker = await readFile(markerPath, "utf8");
+                    const stats = await lstat(workspacePath);
+                    if (marker !== OWNERSHIP_MARKER || stats.isSymbolicLink()) {
+                        throw new DeploymentWorktreeError("cleanup-failure");
+                    }
+                    await repository.raw(["worktree", "remove", "--force", workspacePath]);
+                    await rm(operationDirectory, { recursive: true, force: false });
+                }
+                catch (error) {
+                    if (error instanceof DeploymentWorktreeError)
+                        throw error;
+                    throw new DeploymentWorktreeError("cleanup-failure");
+                }
+            },
+        };
+    }
+    catch (error) {
+        if (worktreeAdded) {
+            await repository
+                .raw(["worktree", "remove", "--force", workspacePath])
+                .catch(() => undefined);
+        }
+        await rm(operationDirectory, { recursive: true, force: true }).catch(() => undefined);
+        throw error;
+    }
+}
+async function mergeSource(workspace, sourceSha, phase) {
+    try {
+        await workspace.repository.merge([
+            sourceSha,
+            "--no-ff",
+            "-m",
+            `merge: deploy ${sourceSha.slice(0, 12)}`,
+        ]);
+    }
+    catch (error) {
+        throw mapMergeError(error, phase);
+    }
+}
+async function withDeploymentWorktree(repository, options, operation) {
+    const workspace = await createDeploymentWorktree(repository, options);
+    let value;
+    try {
+        value = await operation(workspace);
+    }
+    catch (error) {
+        // Preserve the operation's failure while making cleanup attention
+        // observable to callers.
+        try {
+            await workspace.cleanup();
+        }
+        catch {
+            throw withCleanupFailure(error);
+        }
+        throw error;
+    }
+    try {
+        await workspace.cleanup();
+        return { value, cleanupFailed: false };
+    }
+    catch {
+        return { value, cleanupFailed: true };
+    }
+}
+export async function preflightDeploymentSource(repository, options) {
+    const result = await withDeploymentWorktree(repository, options, async (workspace) => {
+        await mergeSource(workspace, options.sourceSha, "preflight");
+    });
+    if (result.cleanupFailed) {
+        throw new DeploymentWorktreeError("cleanup-failure", {
+            cleanupFailed: true,
+        });
+    }
+}
+export async function publishDeploymentSource(repository, options, prepare) {
+    let cleanupFailed = false;
+    for (const attempt of [1, 2]) {
+        try {
+            const result = await withDeploymentWorktree(repository, options, async (workspace) => {
+                await mergeSource(workspace, options.sourceSha, "publication");
+                await prepare({ path: workspace.path, repository: workspace.repository });
+                try {
+                    await workspace.repository.raw([
+                        "push",
+                        options.remote,
+                        `HEAD:refs/heads/${options.primaryBranch}`,
+                    ]);
+                }
+                catch (error) {
+                    throw mapMergeError(error, "publication");
+                }
+            });
+            cleanupFailed ||= result.cleanupFailed;
+            return { attempts: attempt, cleanupFailed };
+        }
+        catch (error) {
+            cleanupFailed ||=
+                error instanceof DeploymentWorktreeError && error.cleanupFailed;
+            if (!(error instanceof DeploymentWorktreeError) ||
+                error.kind !== "publication-rejected" ||
+                attempt === 2) {
+                if (cleanupFailed) {
+                    if (error instanceof DeploymentWorktreeError) {
+                        if (!error.cleanupFailed) {
+                            throw new DeploymentWorktreeError(error.kind, {
+                                cleanupFailed: true,
+                                operationError: error.operationError ?? error,
+                            });
+                        }
+                    }
+                    else {
+                        throw new DeploymentWorktreeError("publication-failure", {
+                            cleanupFailed: true,
+                            operationError: error,
+                        });
+                    }
+                }
+                throw error;
+            }
+        }
+    }
+    throw new DeploymentWorktreeError("publication-rejected", {
+        cleanupFailed,
+    });
+}
+export function deploymentWorktreeRelativePath(repositoryRoot, workspacePath) {
+    return relative(repositoryRoot, workspacePath).split(sep).join("/");
+}
+//# sourceMappingURL=deployment-worktree.js.map

package/dist/lifecycle/deployment-worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-worktree.js","sourceRoot":"","sources":["../../src/lifecycle/deployment-worktree.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstat, mkdtemp, readFile, rm, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join, relative, sep } from \"node:path\";\nimport {\n  createGitRepository,\n  GitRepositoryError,\n  type GitCommitIdentity,\n  type GitRepository,\n} from \"../git-repository.js\";\n\nconst OWNERSHIP_MARKER = \"bonfire deployment workspace\\n\";\nconst SOURCE_SHA_PATTERN = /^[0-9a-f]{40,64}$/u;\n\nexport type DeploymentWorktreeOptions = {\n  remote: string;\n  primaryBranch: string;\n  sourceSha: string;\n  timeoutMs?: number;\n  commitIdentity?: GitCommitIdentity;\n};\n\nexport type DeploymentWorktreeErrorKind =\n  | \"invalid-source\"\n  | \"preflight-conflict\"\n  | \"publication-conflict\"\n  | \"publication-rejected\"\n  | \"publication-failure\"\n  | \"cleanup-failure\";\n\nexport class DeploymentWorktreeError extends Error {\n  readonly kind: DeploymentWorktreeErrorKind;\n  readonly cleanupFailed: boolean;\n  readonly operationError: unknown;\n  readonly cause: unknown;\n\n  constructor(\n    kind: DeploymentWorktreeErrorKind,\n    options: { cleanupFailed?: boolean; operationError?: unknown } = {},\n  ) {\n    super(`Deployment workspace operation failed: ${kind}`);\n    this.name = \"DeploymentWorktreeError\";\n    this.kind = kind;\n    this.cleanupFailed = options.cleanupFailed ?? false;\n    this.operationError = options.operationError;\n    this.cause = options.operationError;\n  }\n}\n\nfunction withCleanupFailure(error: unknown): DeploymentWorktreeError {\n  if (error instanceof DeploymentWorktreeError) {\n    return new DeploymentWorktreeError(error.kind, {\n      cleanupFailed: true,\n      operationError: error.operationError ?? error,\n    });\n  }\n  return new DeploymentWorktreeError(\"cleanup-failure\", {\n    cleanupFailed: true,\n    operationError: error,\n  });\n}\n\ntype DeploymentWorktree = {\n  path: string;\n  repository: GitRepository;\n  cleanup(): Promise<void>;\n};\n\ntype DeploymentWorkspaceOperation<Value> = (\n  workspace: DeploymentWorktree,\n) => Promise<Value>;\n\nfunction assertBranchName(value: string, option: string) {\n  if (\n    value.length === 0 ||\n    value.startsWith(\"-\") ||\n    value.includes(\"\\0\") ||\n    /\\s/u.test(value) ||\n    value.includes(\"@{\") ||\n    value.split(/[\\\\/]/u).some((segment) => segment === \"..\")\n  ) {\n    throw new TypeError(`Invalid ${option}`);\n  }\n}\n\nfunction assertSourceSha(sourceSha: string) {\n  if (!SOURCE_SHA_PATTERN.test(sourceSha)) {\n    throw new DeploymentWorktreeError(\"invalid-source\");\n  }\n}\n\nfunction remotePrimaryRef(options: DeploymentWorktreeOptions) {\n  return `refs/remotes/${options.remote}/${options.primaryBranch}`;\n}\n\nfunction mapMergeError(\n  error: unknown,\n  phase: \"preflight\" | \"publication\",\n): unknown {\n  if (!(error instanceof GitRepositoryError)) return error;\n  if (error.kind === \"conflict\") {\n    return new DeploymentWorktreeError(`${phase}-conflict`);\n  }\n  if (phase === \"publication\") {\n    if (error.kind === \"non-fast-forward\") {\n      return new DeploymentWorktreeError(\"publication-rejected\");\n    }\n    return new DeploymentWorktreeError(\"publication-failure\");\n  }\n  return error;\n}\n\nasync function createDeploymentWorktree(\n  repository: GitRepository,\n  options: DeploymentWorktreeOptions,\n): Promise<DeploymentWorktree> {\n  assertBranchName(options.remote, \"remote\");\n  assertBranchName(options.primaryBranch, \"primary branch\");\n  assertSourceSha(options.sourceSha);\n\n  await repository.fetch(options.remote, options.primaryBranch);\n  const operationDirectory = await mkdtemp(\n    join(tmpdir(), \"bonfire-deployment-\"),\n  );\n  const workspacePath = join(operationDirectory, \"workspace\");\n  const markerPath = join(operationDirectory, \"OWNER\");\n\n  let worktreeAdded = false;\n  try {\n    await writeFile(markerPath, OWNERSHIP_MARKER, { flag: \"wx\" });\n    await repository.raw([\n      \"worktree\",\n      \"add\",\n      \"--detach\",\n      workspacePath,\n      remotePrimaryRef(options),\n    ]);\n    worktreeAdded = true;\n\n    const workspaceRepository = createGitRepository({\n      repositoryRoot: workspacePath,\n      timeoutMs: options.timeoutMs,\n      commitIdentity: options.commitIdentity,\n    });\n\n    await workspaceRepository.raw([\"cat-file\", \"-e\", `${options.sourceSha}^{commit}`]);\n\n    return {\n      path: workspacePath,\n      repository: workspaceRepository,\n      async cleanup() {\n        try {\n          const marker = await readFile(markerPath, \"utf8\");\n          const stats = await lstat(workspacePath);\n          if (marker !== OWNERSHIP_MARKER || stats.isSymbolicLink()) {\n            throw new DeploymentWorktreeError(\"cleanup-failure\");\n          }\n          await repository.raw([\"worktree\", \"remove\", \"--force\", workspacePath]);\n          await rm(operationDirectory, { recursive: true, force: false });\n        } catch (error) {\n          if (error instanceof DeploymentWorktreeError) throw error;\n          throw new DeploymentWorktreeError(\"cleanup-failure\");\n        }\n      },\n    };\n  } catch (error) {\n    if (worktreeAdded) {\n      await repository\n        .raw([\"worktree\", \"remove\", \"--force\", workspacePath])\n        .catch(() => undefined);\n    }\n    await rm(operationDirectory, { recursive: true, force: true }).catch(\n      () => undefined,\n    );\n    throw error;\n  }\n}\n\nasync function mergeSource(\n  workspace: DeploymentWorktree,\n  sourceSha: string,\n  phase: \"preflight\" | \"publication\",\n) {\n  try {\n    await workspace.repository.merge([\n      sourceSha,\n      \"--no-ff\",\n      \"-m\",\n      `merge: deploy ${sourceSha.slice(0, 12)}`,\n    ]);\n  } catch (error) {\n    throw mapMergeError(error, phase);\n  }\n}\n\nasync function withDeploymentWorktree<Value>(\n  repository: GitRepository,\n  options: DeploymentWorktreeOptions,\n  operation: DeploymentWorkspaceOperation<Value>,\n): Promise<{ value: Value; cleanupFailed: boolean }> {\n  const workspace = await createDeploymentWorktree(repository, options);\n  let value: Value;\n  try {\n    value = await operation(workspace);\n  } catch (error) {\n    // Preserve the operation's failure while making cleanup attention\n    // observable to callers.\n    try {\n      await workspace.cleanup();\n    } catch {\n      throw withCleanupFailure(error);\n    }\n    throw error;\n  }\n\n  try {\n    await workspace.cleanup();\n    return { value, cleanupFailed: false };\n  } catch {\n    return { value, cleanupFailed: true };\n  }\n}\n\nexport async function preflightDeploymentSource(\n  repository: GitRepository,\n  options: DeploymentWorktreeOptions,\n): Promise<void> {\n  const result = await withDeploymentWorktree(\n    repository,\n    options,\n    async (workspace) => {\n      await mergeSource(workspace, options.sourceSha, \"preflight\");\n    },\n  );\n  if (result.cleanupFailed) {\n    throw new DeploymentWorktreeError(\"cleanup-failure\", {\n      cleanupFailed: true,\n    });\n  }\n}\n\nexport type DeploymentPublicationResult = {\n  attempts: 1 | 2;\n  cleanupFailed: boolean;\n};\n\nexport async function publishDeploymentSource(\n  repository: GitRepository,\n  options: DeploymentWorktreeOptions,\n  prepare: (workspace: {\n    path: string;\n    repository: GitRepository;\n  }) => Promise<void>,\n): Promise<DeploymentPublicationResult> {\n  let cleanupFailed = false;\n  for (const attempt of [1, 2] as const) {\n    try {\n      const result = await withDeploymentWorktree(\n        repository,\n        options,\n        async (workspace) => {\n          await mergeSource(workspace, options.sourceSha, \"publication\");\n          await prepare({ path: workspace.path, repository: workspace.repository });\n          try {\n            await workspace.repository.raw([\n              \"push\",\n              options.remote,\n              `HEAD:refs/heads/${options.primaryBranch}`,\n            ]);\n          } catch (error) {\n            throw mapMergeError(error, \"publication\");\n          }\n        },\n      );\n      cleanupFailed ||= result.cleanupFailed;\n      return { attempts: attempt, cleanupFailed };\n    } catch (error) {\n      cleanupFailed ||=\n        error instanceof DeploymentWorktreeError && error.cleanupFailed;\n      if (\n        !(error instanceof DeploymentWorktreeError) ||\n        error.kind !== \"publication-rejected\" ||\n        attempt === 2\n      ) {\n        if (cleanupFailed) {\n          if (error instanceof DeploymentWorktreeError) {\n            if (!error.cleanupFailed) {\n              throw new DeploymentWorktreeError(error.kind, {\n                cleanupFailed: true,\n                operationError: error.operationError ?? error,\n              });\n            }\n          } else {\n            throw new DeploymentWorktreeError(\"publication-failure\", {\n              cleanupFailed: true,\n              operationError: error,\n            });\n          }\n        }\n        throw error;\n      }\n    }\n  }\n\n  throw new DeploymentWorktreeError(\"publication-rejected\", {\n    cleanupFailed,\n  });\n}\n\nexport function deploymentWorktreeRelativePath(\n  repositoryRoot: string,\n  workspacePath: string,\n) {\n  return relative(repositoryRoot, workspacePath).split(sep).join(\"/\");\n}\n"]}

package/dist/lifecycle/local-prototype-lifecycle.d.ts

@@ -17,6 +17,7 @@ export type PrototypeLifecycle = {
     save: LifecycleMethod<PrototypeCommandInput, SavePrototypeValue>;
     discard: LifecycleMethod<PrototypeCommandInput, DiscardPrototypeValue>;
     deploy: LifecycleMethod<PrototypeCommandInput, DeploymentValue>;
+    retryPublish?: LifecycleMethod<PrototypeCommandInput, DeploymentValue>;
 };
 export type LocalPrototypeLifecycleOptions = {
     repositoryRoot: string;
@@ -47,6 +48,7 @@ export declare class LocalPrototypeLifecycle implements PrototypeLifecycle {
     getRepositorySummary(identity: BonfireIdentity): Promise<LifecycleResult<RepositorySummary>>;
     checkRepositorySummary(identity: BonfireIdentity): Promise<LifecycleResult<RepositorySummary>>;
     deploy(identity: BonfireIdentity, input: PrototypeCommandInput): Promise<LifecycleResult<DeploymentValue>>;
+    retryPublish(identity: BonfireIdentity, input: PrototypeCommandInput): Promise<LifecycleResult<DeploymentValue>>;
     save(identity: BonfireIdentity, input: PrototypeCommandInput): Promise<LifecycleResult<SavePrototypeValue>>;
     discard(identity: BonfireIdentity, input: PrototypeCommandInput): Promise<LifecycleResult<DiscardPrototypeValue>>;
     duplicate(identity: BonfireIdentity, input: DuplicatePrototypeInput): Promise<LifecycleResult<DuplicatePrototypeValue>>;

package/dist/lifecycle/local-prototype-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-prototype-lifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle/local-prototype-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open, rename, rm, writeFile } from \"node:fs/promises\";\nimport { randomUUID } from \"node:crypto\";\nimport { join, relative, sep } from \"node:path\";\nimport {\n  definePrototypeRef,\n  getPrototypeUrl,\n  LifecycleInputError,\n  lifecycleFailure,\n  lifecycleSuccess,\n  parseCreatePrototypeInput,\n  parseDuplicatePrototypeInput,\n  parseEditPrototypeInput,\n  parseBonfireIdentity,\n  parsePrototypeCommandInput,\n  parsePrototypeMetadata,\n  slugifyPrototypeTitle,\n  PrototypeRefError,\n  type BranchPreparationValue,\n  type CreatePrototypeInput,\n  type CreatePrototypeValue,\n  type DeletePrototypeValue,\n  type DeploymentValue,\n  type DeploymentWarningCode,\n  type DirtyObservationValue,\n  type DiscardPrototypeValue,\n  type DuplicatePrototypeInput,\n  type DuplicatePrototypeValue,\n  type EditPrototypeInput,\n  type EditPrototypeValue,\n  parseGitModeSetting,\n  type GitMode,\n  type LifecycleErrorCode,\n  type LifecycleResult,\n  type BonfireIdentity,\n  type PrototypeCommandInput,\n  type SavePrototypeValue,\n  type RepositorySummary,\n  type ThemeRegistry,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n  commitPath,\n  discardPath,\n  GitRepositoryError,\n  pushBranch,\n  type GitRepository,\n} from \"../git-repository.js\";\nimport { duplicatePrototype, PrototypeDuplicateError } from \"../duplicate.js\";\nimport {\n  PrototypeCatalog,\n  type PrototypeCatalogLike,\n} from \"../prototype-catalog.js\";\nimport { PrototypeScaffoldError, scaffoldPrototype } from \"../scaffold.js\";\nimport {\n  createPrototypeLifecycleRuntime,\n  type PrototypeLifecycleRuntimeContext,\n} from \"./runtime-context.js\";\nimport type {\n  PreparePrototypeFiles,\n  PreparePrototypeFilesRequest,\n} from \"../prepare-prototype-files.js\";\nimport {\n  cleanupOwnedDestination,\n  validateOwnedDestination,\n  type OwnedDestinationReceipt,\n} from \"../internal/owned-destination.js\";\nimport {\n  RepositoryBusyError,\n  withRepositoryOperation,\n} from \"./operation-gate.js\";\nimport {\n  DeploymentProviderError,\n  type DeploymentProvider,\n} from \"../deployment-provider.js\";\nimport {\n  assertIdentityBranchReady,\n  synchronizeIdentityBranch,\n} from \"./repository-synchronization.js\";\nimport { getRepositorySummary } from \"./repository-summary.js\";\n\ntype LifecycleMethod<Input, Value> = (\n  identity: BonfireIdentity,\n  input: Input,\n) => Promise<LifecycleResult<Value>>;\n\nexport type PrototypeLifecycle = {\n  /** Declares whether this lifecycle enforces the selected Git mode. */\n  readonly gitMode?: GitMode;\n  prepareBranch(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<BranchPreparationValue>>;\n  create: LifecycleMethod<CreatePrototypeInput, CreatePrototypeValue>;\n  duplicate: LifecycleMethod<DuplicatePrototypeInput, DuplicatePrototypeValue>;\n  edit: LifecycleMethod<EditPrototypeInput, EditPrototypeValue>;\n  delete: LifecycleMethod<PrototypeCommandInput, DeletePrototypeValue>;\n  getDirtyState: LifecycleMethod<PrototypeCommandInput, DirtyObservationValue>;\n  getRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>>;\n  checkRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>>;\n  save: LifecycleMethod<PrototypeCommandInput, SavePrototypeValue>;\n  discard: LifecycleMethod<PrototypeCommandInput, DiscardPrototypeValue>;\n  deploy: LifecycleMethod<PrototypeCommandInput, DeploymentValue>;\n};\n\nexport type LocalPrototypeLifecycleOptions = {\n  repositoryRoot: string;\n  prototypeRoot?: string;\n  remote?: string;\n  primaryBranch?: string;\n  automaticBranchSwitch?: \"enabled\" | \"disabled\";\n  gitMode?: GitMode;\n  commitIdentity?: {\n    name: string;\n    email: string;\n  };\n  catalog?: PrototypeCatalogLike;\n  preparePrototypeFiles?: PreparePrototypeFiles;\n  deploymentProvider?: DeploymentProvider;\n  applicationId?: string;\n  themeRegistry?: ThemeRegistry;\n};\n\ntype InternalLocalPrototypeLifecycleOptions = LocalPrototypeLifecycleOptions & {\n  runtime?: PrototypeLifecycleRuntimeContext;\n};\n\nfunction repositoryRelativePath(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  const absolutePath = join(runtime.prototypeRoot, ref.login, ref.slug);\n  return relative(runtime.repositoryRoot, absolutePath).split(sep).join(\"/\");\n}\n\nfunction destinationRef(identity: BonfireIdentity, title: string) {\n  const slug = slugifyPrototypeTitle(title);\n  if (slug === null)\n    throw new PrototypeRefError(\"title\", \"must produce a slug\");\n  return definePrototypeRef({ login: identity.login, slug });\n}\n\nclass PrototypeNotFoundError extends Error {}\nclass PrototypeOwnershipError extends Error {}\nclass PrototypeMetadataFileError extends Error {}\nclass DeploymentUnavailableError extends Error {}\n\nfunction metadataPath(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  return join(runtime.prototypeRoot, ref.login, ref.slug, \"metadata.json\");\n}\n\nasync function assertPrototypeDirectory(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  const paths = [\n    runtime.prototypeRoot,\n    join(runtime.prototypeRoot, ref.login),\n    join(runtime.prototypeRoot, ref.login, ref.slug),\n  ];\n\n  try {\n    for (const path of paths) {\n      const stats = await lstat(path);\n      if (stats.isSymbolicLink() || !stats.isDirectory()) {\n        throw new PrototypeMetadataFileError();\n      }\n    }\n  } catch (error) {\n    if (error instanceof PrototypeMetadataFileError) throw error;\n    throw new PrototypeMetadataFileError();\n  }\n}\n\nasync function readMetadataDocument(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n  themeRegistry?: ThemeRegistry,\n) {\n  const path = metadataPath(runtime, ref);\n  try {\n    const file = await open(\n      path,\n      constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0),\n    );\n    try {\n      const source = await file.readFile(\"utf8\");\n      const document: unknown = JSON.parse(source);\n      parsePrototypeMetadata(document, { themeRegistry });\n      if (\n        typeof document !== \"object\" ||\n        document === null ||\n        Array.isArray(document)\n      ) {\n        throw new PrototypeMetadataFileError();\n      }\n      return { ...(document as Record<string, unknown>) };\n    } finally {\n      await file.close();\n    }\n  } catch (error) {\n    if (error instanceof PrototypeMetadataFileError) throw error;\n    throw new PrototypeMetadataFileError();\n  }\n}\n\nasync function removePrototypeDirectory(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  await assertPrototypeDirectory(runtime, ref);\n  try {\n    await rm(join(runtime.prototypeRoot, ref.login, ref.slug), {\n      force: false,\n      recursive: true,\n    });\n  } catch {\n    throw new PrototypeMetadataFileError();\n  }\n}\n\nasync function writeMetadataDocument(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n  document: Record<string, unknown>,\n) {\n  const path = metadataPath(runtime, ref);\n  const temporaryPath = `${path}.${randomUUID()}.tmp`;\n\n  try {\n    const stats = await lstat(path);\n    if (stats.isSymbolicLink() || !stats.isFile()) {\n      throw new PrototypeMetadataFileError();\n    }\n    await writeFile(temporaryPath, `${JSON.stringify(document, null, 2)}\\n`, {\n      encoding: \"utf8\",\n      flag: \"wx\",\n    });\n    await rename(temporaryPath, path);\n  } catch (error) {\n    if (error instanceof PrototypeMetadataFileError) throw error;\n    throw new PrototypeMetadataFileError();\n  } finally {\n    await rm(temporaryPath, { force: true }).catch(() => undefined);\n  }\n}\n\nasync function mergeIdentityBranchToPrimary(\n  repository: GitRepository,\n  options: {\n    branch: string;\n    primaryBranch: string;\n    remote: string;\n  },\n) {\n  if (options.branch === options.primaryBranch) return;\n\n  const hasRemote = (await repository.remotes()).some(\n    (remote) => remote.name === options.remote,\n  );\n  if (!hasRemote) return;\n\n  await repository.checkout([options.primaryBranch]);\n  try {\n    await repository.merge([\n      options.branch,\n      \"--no-ff\",\n      \"-m\",\n      `merge: ${options.branch}`,\n    ]);\n    await repository.push(options.remote, options.primaryBranch);\n  } finally {\n    await repository.checkout([options.branch]);\n  }\n}\n\nfunction mapError(error: unknown): LifecycleErrorCode {\n  if (error instanceof PrototypeNotFoundError) return \"not-found\";\n  if (error instanceof PrototypeOwnershipError) return \"forbidden\";\n  if (error instanceof PrototypeMetadataFileError) return \"filesystem-failure\";\n  if (error instanceof RepositoryBusyError) return \"repository-busy\";\n  if (\n    error instanceof PrototypeRefError ||\n    error instanceof LifecycleInputError\n  ) {\n    return \"invalid-input\";\n  }\n  if (error instanceof GitRepositoryError) {\n    if (error.kind === \"timeout\") return \"timeout\";\n    if (error.kind === \"conflict\") return \"working-tree-conflict\";\n    if (error.kind === \"invalid-configuration\") return \"unexpected-failure\";\n    return \"git-failure\";\n  }\n  if (error instanceof PrototypeScaffoldError) {\n    if (error.kind === \"collision\") return \"already-exists\";\n    if (error.kind === \"invalid-input\") return \"invalid-input\";\n    return \"filesystem-failure\";\n  }\n  if (error instanceof PrototypeDuplicateError) {\n    if (error.kind === \"source-not-found\") return \"not-found\";\n    if (error.kind === \"collision\") return \"already-exists\";\n    if (error.kind === \"invalid-source\") return \"invalid-input\";\n    return \"filesystem-failure\";\n  }\n  if (error instanceof DeploymentUnavailableError) {\n    return \"deployment-unavailable\";\n  }\n  if (error instanceof DeploymentProviderError) {\n    return error.kind === \"timeout\" ? \"timeout\" : \"deployment-failure\";\n  }\n  return \"unexpected-failure\";\n}\n\nfunction resultFrom<Value>(\n  operation: () => Promise<Value>,\n): Promise<LifecycleResult<Value>> {\n  return operation()\n    .then(lifecycleSuccess)\n    .catch((error: unknown) => lifecycleFailure(mapError(error)));\n}\n\nexport class LocalPrototypeLifecycle implements PrototypeLifecycle {\n  readonly #runtime: PrototypeLifecycleRuntimeContext;\n  readonly gitMode: GitMode;\n  readonly #catalog: PrototypeCatalogLike;\n  readonly #repository: GitRepository;\n  readonly #preparePrototypeFiles: PreparePrototypeFiles;\n  readonly #deploymentProvider?: DeploymentProvider;\n  readonly #applicationId?: string;\n  readonly #themeRegistry?: ThemeRegistry;\n  #restartRequired = false;\n\n  constructor(options: LocalPrototypeLifecycleOptions) {\n    const internalOptions = options as InternalLocalPrototypeLifecycleOptions;\n    const runtime =\n      internalOptions.runtime ?? createPrototypeLifecycleRuntime(internalOptions);\n    this.#runtime = {\n      ...runtime,\n      gitMode: parseGitModeSetting(runtime.gitMode),\n    };\n    this.gitMode = this.#runtime.gitMode;\n    this.#themeRegistry = options.themeRegistry;\n    this.#catalog =\n      internalOptions.catalog ??\n      new PrototypeCatalog({\n        ...this.#runtime,\n        themeRegistry: this.#themeRegistry,\n      });\n    this.#repository = this.#runtime.gitRepository;\n    this.#preparePrototypeFiles =\n      internalOptions.preparePrototypeFiles ?? (() => undefined);\n    this.#deploymentProvider = internalOptions.deploymentProvider;\n    this.#applicationId = internalOptions.applicationId;\n    if (\n      this.#deploymentProvider &&\n      (typeof this.#applicationId !== \"string\" ||\n        this.#applicationId.length === 0)\n    ) {\n      throw new TypeError(\n        \"applicationId must be provided when deploymentProvider is configured\",\n      );\n    }\n  }\n\n  async #verifiedIdentity(identity: BonfireIdentity) {\n    return parseBonfireIdentity(identity);\n  }\n\n  async #currentBranch() {\n    const branch = await this.#repository.currentBranch();\n    if (branch === \"HEAD\" || branch.length === 0) {\n      throw new GitRepositoryError(\"conflict\", \"current-branch\");\n    }\n    return branch;\n  }\n\n  async #ownedPrototype(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ) {\n    const verifiedIdentity = await this.#verifiedIdentity(identity);\n    const normalizedInput = parsePrototypeCommandInput(input);\n    if (normalizedInput.ref.login !== verifiedIdentity.login) {\n      throw new PrototypeOwnershipError();\n    }\n    const summary = await this.#catalog.getSummary(normalizedInput.ref);\n    if (!summary) {\n      throw new PrototypeNotFoundError();\n    }\n\n    return {\n      ref: normalizedInput.ref,\n      path: repositoryRelativePath(this.#runtime, normalizedInput.ref),\n      summary,\n    };\n  }\n\n  async #prepareMutationBranch(login: string) {\n    await assertIdentityBranchReady(this.#repository, login);\n    return login;\n  }\n\n  async #prepareDestination(\n    receipt: OwnedDestinationReceipt,\n    expectedFiles: readonly string[],\n    request: PreparePrototypeFilesRequest,\n  ) {\n    try {\n      const frozenRequest = Object.freeze({\n        ...request,\n        ref: Object.freeze({ ...request.ref }),\n        identity: Object.freeze({ ...request.identity }),\n        ...(request.operation === \"duplicate\"\n          ? { source: Object.freeze({ ...request.source }) }\n          : {}),\n      }) as PreparePrototypeFilesRequest;\n      await this.#preparePrototypeFiles(frozenRequest);\n      await validateOwnedDestination(\n        receipt,\n        expectedFiles,\n        request.ref,\n        this.#themeRegistry,\n      );\n    } catch {\n      try {\n        await cleanupOwnedDestination(receipt);\n      } catch {\n        // The failure remains a finite filesystem failure without retrying cleanup.\n      }\n      throw new PrototypeScaffoldError(\"filesystem\");\n    }\n  }\n\n  async prepareBranch(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<BranchPreparationValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          if (\n            this.#runtime.gitMode === \"manual\" ||\n            this.#runtime.automaticBranchSwitch === \"disabled\"\n          ) {\n            await this.#currentBranch();\n            return { status: \"disabled\" } satisfies BranchPreparationValue;\n          }\n\n          const synchronization = await synchronizeIdentityBranch(\n            this.#repository,\n            {\n              identityBranch: verifiedIdentity.login,\n              primaryBranch: this.#runtime.primaryBranch,\n              remote: this.#runtime.remote,\n              managedPaths: this.#runtime.managedRepositoryPaths,\n            },\n          );\n          if (synchronization.status !== \"synchronized\") {\n            return {\n              status: synchronization.status,\n              reason: synchronization.reason,\n              ...(synchronization.affectedPaths.length > 0\n                ? { affectedPaths: synchronization.affectedPaths }\n                : {}),\n            } satisfies BranchPreparationValue;\n          }\n          if (\n            synchronization.affectedPaths.some((path) =>\n              this.#runtime.managedRepositoryPaths.includes(path),\n            )\n          ) {\n            this.#restartRequired = true;\n          }\n          return {\n            status: \"ready\",\n            ...(synchronization.affectedPaths.length > 0\n              ? { affectedPaths: synchronization.affectedPaths }\n              : {}),\n          } satisfies BranchPreparationValue;\n        },\n      );\n    });\n  }\n\n  async create(\n    identity: BonfireIdentity,\n    input: CreatePrototypeInput,\n  ): Promise<LifecycleResult<CreatePrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parseCreatePrototypeInput(\n        input,\n        this.#themeRegistry,\n      );\n      const ref = destinationRef(verifiedIdentity, normalizedInput.title);\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          if (await this.#catalog.getSummary(ref)) {\n            throw new PrototypeScaffoldError(\"collision\");\n          }\n\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          const prepared = await scaffoldPrototype({\n            paths: this.#runtime,\n            ref,\n            title: normalizedInput.title,\n            description: normalizedInput.description,\n            authorName: verifiedIdentity.name,\n            theme: normalizedInput.theme,\n            themeRegistry: this.#themeRegistry,\n          });\n          await this.#prepareDestination(\n            prepared.receipt,\n            prepared.expectedFiles,\n            {\n              operation: \"create\",\n              repositoryRoot: this.#runtime.repositoryRoot,\n              prototypeRoot: this.#runtime.prototypeRoot,\n              prototypePath: prepared.destination,\n              ref,\n              identity: verifiedIdentity,\n              title: normalizedInput.title,\n              description: normalizedInput.description,\n            },\n          );\n          if (branch === undefined) {\n            return {\n              ref,\n              url: getPrototypeUrl(ref),\n              remoteStatus: \"manual\",\n            } satisfies CreatePrototypeValue;\n          }\n\n          await commitPath(\n            this.#repository,\n            repositoryRelativePath(this.#runtime, ref),\n            `init: ${ref.slug}`,\n          );\n          const push = await pushBranch(\n            this.#repository,\n            this.#runtime.remote,\n            branch,\n          );\n\n          return {\n            ref,\n            url: getPrototypeUrl(ref),\n            remoteStatus: push.remoteStatus,\n          } satisfies CreatePrototypeValue;\n        },\n      );\n    });\n  }\n\n  async edit(\n    identity: BonfireIdentity,\n    input: EditPrototypeInput,\n  ): Promise<LifecycleResult<EditPrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parseEditPrototypeInput(\n        input,\n        this.#themeRegistry,\n      );\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          const { ref, path } = await this.#ownedPrototype(verifiedIdentity, {\n            ref: normalizedInput.ref,\n          });\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          await assertPrototypeDirectory(this.#runtime, ref);\n          const document = await readMetadataDocument(\n            this.#runtime,\n            ref,\n            this.#themeRegistry,\n          );\n          const metadata = parsePrototypeMetadata(document, {\n            themeRegistry: this.#themeRegistry,\n          });\n          if (metadata.authorLogin !== ref.login) {\n            throw new PrototypeNotFoundError();\n          }\n\n          await writeMetadataDocument(this.#runtime, ref, {\n            ...document,\n            title: normalizedInput.title,\n            description: normalizedInput.description,\n            updatedAt: new Date().toISOString(),\n            ...(normalizedInput.theme === undefined\n              ? {}\n              : { theme: normalizedInput.theme }),\n          });\n          if (branch !== undefined) {\n            await commitPath(this.#repository, path, `edit: ${ref.slug}`);\n            await pushBranch(this.#repository, this.#runtime.remote, branch);\n          }\n\n          return { edited: true, ref } satisfies EditPrototypeValue;\n        },\n      );\n    });\n  }\n\n  async delete(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DeletePrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parsePrototypeCommandInput(input);\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          const { ref, path } = await this.#ownedPrototype(\n            verifiedIdentity,\n            normalizedInput,\n          );\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          await removePrototypeDirectory(this.#runtime, ref);\n          if (branch !== undefined) {\n            await commitPath(this.#repository, path, `delete: ${ref.slug}`);\n            await pushBranch(this.#repository, this.#runtime.remote, branch);\n          }\n\n          return { deleted: true, ref } satisfies DeletePrototypeValue;\n        },\n      );\n    });\n  }\n\n  async getDirtyState(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DirtyObservationValue>> {\n    return resultFrom(async () => {\n      const { path, summary } = await this.#ownedPrototype(identity, input);\n      const status = await this.#repository.status([path]);\n      return {\n        status: status.files.length > 0 ? \"dirty\" : \"clean\",\n        ...(summary.previewUrl !== undefined\n          ? { previewUrl: summary.previewUrl }\n          : {}),\n      } satisfies DirtyObservationValue;\n    });\n  }\n\n  async getRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      return getRepositorySummary({\n        repository: this.#repository,\n        catalog: this.#catalog,\n        repositoryRoot: this.#runtime.repositoryRoot,\n        prototypeRoot: this.#runtime.prototypeRoot,\n        identity: verifiedIdentity,\n        mode: this.#runtime.gitMode,\n        remote: this.#runtime.remote,\n        primaryBranch: this.#runtime.primaryBranch,\n        restartRequired: this.#restartRequired,\n      });\n    });\n  }\n\n  async checkRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      return getRepositorySummary({\n        repository: this.#repository,\n        catalog: this.#catalog,\n        repositoryRoot: this.#runtime.repositoryRoot,\n        prototypeRoot: this.#runtime.prototypeRoot,\n        identity: verifiedIdentity,\n        mode: this.#runtime.gitMode,\n        remote: this.#runtime.remote,\n        primaryBranch: this.#runtime.primaryBranch,\n        restartRequired: this.#restartRequired,\n        refresh: true,\n      });\n    });\n  }\n\n  async deploy(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DeploymentValue>> {\n    if (this.#runtime.gitMode === \"manual\") {\n      return lifecycleFailure(\"forbidden\");\n    }\n\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parsePrototypeCommandInput(input);\n      if (!this.#deploymentProvider) {\n        throw new DeploymentUnavailableError();\n      }\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          const { ref, path } = await this.#ownedPrototype(\n            verifiedIdentity,\n            normalizedInput,\n          );\n          const branch = await this.#prepareMutationBranch(\n            verifiedIdentity.login,\n          );\n          await assertPrototypeDirectory(this.#runtime, ref);\n          const document = await readMetadataDocument(\n            this.#runtime,\n            ref,\n            this.#themeRegistry,\n          );\n          const metadata = parsePrototypeMetadata(document, {\n            themeRegistry: this.#themeRegistry,\n          });\n          if (metadata.authorLogin !== ref.login) {\n            throw new PrototypeNotFoundError();\n          }\n          await commitPath(this.#repository, path, `deploy: ${ref.slug}`);\n          await pushBranch(this.#repository, this.#runtime.remote, branch);\n\n          const deployment = await this.#deploymentProvider!.deploy({\n            applicationId: this.#applicationId!,\n            login: verifiedIdentity.login,\n          });\n          const previewUrl = new URL(\n            getPrototypeUrl(ref).slice(1),\n            `${deployment.url.replace(/\\/+$/, \"\")}/`,\n          ).toString();\n\n          let warning: DeploymentWarningCode | undefined;\n          try {\n            await writeMetadataDocument(this.#runtime, ref, {\n              ...document,\n              previewUrl,\n              updatedAt: new Date().toISOString(),\n            });\n            await commitPath(\n              this.#repository,\n              path,\n              `deploy: ${ref.slug} (metadata)`,\n            );\n            await pushBranch(this.#repository, this.#runtime.remote, branch);\n          } catch {\n            warning = \"metadata-persistence-failed\";\n          }\n\n          if (warning === undefined) {\n            try {\n              await mergeIdentityBranchToPrimary(this.#repository, {\n                branch,\n                primaryBranch: this.#runtime.primaryBranch,\n                remote: this.#runtime.remote,\n              });\n            } catch {\n              warning = \"primary-merge-failed\";\n            }\n          }\n\n          return {\n            deployed: true,\n            ref,\n            previewUrl,\n            deploymentId: deployment.deploymentId,\n            readyState: deployment.readyState,\n            warning,\n          } satisfies DeploymentValue;\n        },\n      );\n    });\n  }\n\n  async save(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<SavePrototypeValue>> {\n    if (this.#runtime.gitMode === \"manual\") {\n      return lifecycleFailure(\"forbidden\");\n    }\n\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const { ref, path } = await this.#ownedPrototype(\n        verifiedIdentity,\n        input,\n      );\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          await this.#prepareMutationBranch(verifiedIdentity.login);\n          await commitPath(this.#repository, path, `save: ${ref.slug}`);\n          await pushBranch(\n            this.#repository,\n            this.#runtime.remote,\n            verifiedIdentity.login,\n          );\n          return { saved: true } satisfies SavePrototypeValue;\n        },\n      );\n    });\n  }\n\n  async discard(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DiscardPrototypeValue>> {\n    if (this.#runtime.gitMode === \"manual\") {\n      return lifecycleFailure(\"forbidden\");\n    }\n\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const { path } = await this.#ownedPrototype(\n        verifiedIdentity,\n        input,\n      );\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          await discardPath(this.#repository, path);\n          return { discarded: true } satisfies DiscardPrototypeValue;\n        },\n      );\n    });\n  }\n\n  async duplicate(\n    identity: BonfireIdentity,\n    input: DuplicatePrototypeInput,\n  ): Promise<LifecycleResult<DuplicatePrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parseDuplicatePrototypeInput(input);\n      if (!(await this.#catalog.getSummary(normalizedInput.source))) {\n        throw new PrototypeDuplicateError(\"source-not-found\");\n      }\n      const ref = destinationRef(verifiedIdentity, normalizedInput.title);\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          if (await this.#catalog.getSummary(ref)) {\n            throw new PrototypeDuplicateError(\"collision\");\n          }\n\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          const prepared = await duplicatePrototype({\n            paths: this.#runtime,\n            source: normalizedInput.source,\n            destination: ref,\n            title: normalizedInput.title,\n            description: normalizedInput.description,\n            authorName: verifiedIdentity.name,\n            themeRegistry: this.#themeRegistry,\n          });\n          await this.#prepareDestination(\n            prepared.receipt,\n            prepared.expectedFiles,\n            {\n              operation: \"duplicate\",\n              repositoryRoot: this.#runtime.repositoryRoot,\n              prototypeRoot: this.#runtime.prototypeRoot,\n              prototypePath: prepared.destination,\n              ref,\n              source: normalizedInput.source,\n              identity: verifiedIdentity,\n              title: normalizedInput.title,\n              description: normalizedInput.description,\n            },\n          );\n          if (branch === undefined) {\n            return {\n              ref,\n              url: getPrototypeUrl(ref),\n              remoteStatus: \"manual\",\n            } satisfies DuplicatePrototypeValue;\n          }\n\n          await commitPath(\n            this.#repository,\n            repositoryRelativePath(this.#runtime, ref),\n            `init: ${ref.slug}`,\n          );\n          const push = await pushBranch(\n            this.#repository,\n            this.#runtime.remote,\n            branch,\n          );\n\n          return {\n            ref,\n            url: getPrototypeUrl(ref),\n            remoteStatus: push.remoteStatus,\n          } satisfies DuplicatePrototypeValue;\n        },\n      );\n    });\n  }\n}\n"]}
+{"version":3,"file":"local-prototype-lifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle/local-prototype-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open, rename, rm, writeFile } from \"node:fs/promises\";\nimport { randomUUID } from \"node:crypto\";\nimport { join, relative, sep } from \"node:path\";\nimport {\n  definePrototypeRef,\n  getPrototypeUrl,\n  LifecycleInputError,\n  lifecycleFailure,\n  lifecycleSuccess,\n  parseCreatePrototypeInput,\n  parseDuplicatePrototypeInput,\n  parseEditPrototypeInput,\n  parseBonfireIdentity,\n  parsePrototypeCommandInput,\n  parsePrototypeMetadata,\n  slugifyPrototypeTitle,\n  PrototypeRefError,\n  type BranchPreparationValue,\n  type CreatePrototypeInput,\n  type CreatePrototypeValue,\n  type DeletePrototypeValue,\n  type DeploymentValue,\n  type DeploymentWarningCode,\n  type DirtyObservationValue,\n  type DiscardPrototypeValue,\n  type DuplicatePrototypeInput,\n  type DuplicatePrototypeValue,\n  type EditPrototypeInput,\n  type EditPrototypeValue,\n  parseGitModeSetting,\n  type GitMode,\n  type LifecycleErrorCode,\n  type LifecycleResult,\n  type BonfireIdentity,\n  type PrototypeCommandInput,\n  type SavePrototypeValue,\n  type RepositorySummary,\n  type ThemeRegistry,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n  commitPath,\n  discardPath,\n  GitRepositoryError,\n  pushBranch,\n  pushCommitToBranch,\n  type GitRepository,\n} from \"../git-repository.js\";\nimport { duplicatePrototype, PrototypeDuplicateError } from \"../duplicate.js\";\nimport {\n  PrototypeCatalog,\n  type PrototypeCatalogLike,\n} from \"../prototype-catalog.js\";\nimport { PrototypeScaffoldError, scaffoldPrototype } from \"../scaffold.js\";\nimport {\n  createPrototypeLifecycleRuntime,\n  type PrototypeLifecycleRuntimeContext,\n} from \"./runtime-context.js\";\nimport type {\n  PreparePrototypeFiles,\n  PreparePrototypeFilesRequest,\n} from \"../prepare-prototype-files.js\";\nimport {\n  cleanupOwnedDestination,\n  validateOwnedDestination,\n  type OwnedDestinationReceipt,\n} from \"../internal/owned-destination.js\";\nimport {\n  RepositoryBusyError,\n  withRepositoryOperation,\n} from \"./operation-gate.js\";\nimport {\n  DeploymentProviderError,\n  type DeploymentProvider,\n} from \"../deployment-provider.js\";\nimport {\n  assertIdentityBranchReady,\n  synchronizeIdentityBranch,\n} from \"./repository-synchronization.js\";\nimport { getRepositorySummary } from \"./repository-summary.js\";\nimport {\n  DeploymentWorktreeError,\n  preflightDeploymentSource,\n  publishDeploymentSource,\n} from \"./deployment-worktree.js\";\n\ntype LifecycleMethod<Input, Value> = (\n  identity: BonfireIdentity,\n  input: Input,\n) => Promise<LifecycleResult<Value>>;\n\nexport type PrototypeLifecycle = {\n  /** Declares whether this lifecycle enforces the selected Git mode. */\n  readonly gitMode?: GitMode;\n  prepareBranch(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<BranchPreparationValue>>;\n  create: LifecycleMethod<CreatePrototypeInput, CreatePrototypeValue>;\n  duplicate: LifecycleMethod<DuplicatePrototypeInput, DuplicatePrototypeValue>;\n  edit: LifecycleMethod<EditPrototypeInput, EditPrototypeValue>;\n  delete: LifecycleMethod<PrototypeCommandInput, DeletePrototypeValue>;\n  getDirtyState: LifecycleMethod<PrototypeCommandInput, DirtyObservationValue>;\n  getRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>>;\n  checkRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>>;\n  save: LifecycleMethod<PrototypeCommandInput, SavePrototypeValue>;\n  discard: LifecycleMethod<PrototypeCommandInput, DiscardPrototypeValue>;\n  deploy: LifecycleMethod<PrototypeCommandInput, DeploymentValue>;\n  retryPublish?: LifecycleMethod<PrototypeCommandInput, DeploymentValue>;\n};\n\nexport type LocalPrototypeLifecycleOptions = {\n  repositoryRoot: string;\n  prototypeRoot?: string;\n  remote?: string;\n  primaryBranch?: string;\n  automaticBranchSwitch?: \"enabled\" | \"disabled\";\n  gitMode?: GitMode;\n  commitIdentity?: {\n    name: string;\n    email: string;\n  };\n  catalog?: PrototypeCatalogLike;\n  preparePrototypeFiles?: PreparePrototypeFiles;\n  deploymentProvider?: DeploymentProvider;\n  applicationId?: string;\n  themeRegistry?: ThemeRegistry;\n};\n\ntype InternalLocalPrototypeLifecycleOptions = LocalPrototypeLifecycleOptions & {\n  runtime?: PrototypeLifecycleRuntimeContext;\n};\n\nfunction repositoryRelativePath(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  const absolutePath = join(runtime.prototypeRoot, ref.login, ref.slug);\n  return relative(runtime.repositoryRoot, absolutePath).split(sep).join(\"/\");\n}\n\nfunction destinationRef(identity: BonfireIdentity, title: string) {\n  const slug = slugifyPrototypeTitle(title);\n  if (slug === null)\n    throw new PrototypeRefError(\"title\", \"must produce a slug\");\n  return definePrototypeRef({ login: identity.login, slug });\n}\n\nclass PrototypeNotFoundError extends Error {}\nclass PrototypeOwnershipError extends Error {}\nclass PrototypeMetadataFileError extends Error {}\nclass DeploymentUnavailableError extends Error {}\nclass DeploymentSourcePushError extends Error {}\nclass DeploymentNotAcceptedError extends Error {}\n\ntype PendingPublication = {\n  identity: BonfireIdentity;\n  input: PrototypeCommandInput;\n  ref: { login: string; slug: string };\n  path: string;\n  previewUrl: string;\n  deploymentId: string;\n  sourceSha: string;\n  readyState: DeploymentValue[\"readyState\"];\n  synchronizationWarning: DeploymentWarningCode | undefined;\n};\n\nfunction metadataPath(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  return join(runtime.prototypeRoot, ref.login, ref.slug, \"metadata.json\");\n}\n\nasync function assertPrototypeDirectory(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  const paths = [\n    runtime.prototypeRoot,\n    join(runtime.prototypeRoot, ref.login),\n    join(runtime.prototypeRoot, ref.login, ref.slug),\n  ];\n\n  try {\n    for (const path of paths) {\n      const stats = await lstat(path);\n      if (stats.isSymbolicLink() || !stats.isDirectory()) {\n        throw new PrototypeMetadataFileError();\n      }\n    }\n  } catch (error) {\n    if (error instanceof PrototypeMetadataFileError) throw error;\n    throw new PrototypeMetadataFileError();\n  }\n}\n\nasync function readMetadataDocument(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n  themeRegistry?: ThemeRegistry,\n) {\n  const path = metadataPath(runtime, ref);\n  try {\n    const file = await open(\n      path,\n      constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0),\n    );\n    try {\n      const source = await file.readFile(\"utf8\");\n      const document: unknown = JSON.parse(source);\n      parsePrototypeMetadata(document, { themeRegistry });\n      if (\n        typeof document !== \"object\" ||\n        document === null ||\n        Array.isArray(document)\n      ) {\n        throw new PrototypeMetadataFileError();\n      }\n      return { ...(document as Record<string, unknown>) };\n    } finally {\n      await file.close();\n    }\n  } catch (error) {\n    if (error instanceof PrototypeMetadataFileError) throw error;\n    throw new PrototypeMetadataFileError();\n  }\n}\n\nasync function removePrototypeDirectory(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n) {\n  await assertPrototypeDirectory(runtime, ref);\n  try {\n    await rm(join(runtime.prototypeRoot, ref.login, ref.slug), {\n      force: false,\n      recursive: true,\n    });\n  } catch {\n    throw new PrototypeMetadataFileError();\n  }\n}\n\nasync function writeMetadataDocument(\n  runtime: PrototypeLifecycleRuntimeContext,\n  ref: { login: string; slug: string },\n  document: Record<string, unknown>,\n) {\n  const path = metadataPath(runtime, ref);\n  const temporaryPath = `${path}.${randomUUID()}.tmp`;\n\n  try {\n    const stats = await lstat(path);\n    if (stats.isSymbolicLink() || !stats.isFile()) {\n      throw new PrototypeMetadataFileError();\n    }\n    await writeFile(temporaryPath, `${JSON.stringify(document, null, 2)}\\n`, {\n      encoding: \"utf8\",\n      flag: \"wx\",\n    });\n    await rename(temporaryPath, path);\n  } catch (error) {\n    if (error instanceof PrototypeMetadataFileError) throw error;\n    throw new PrototypeMetadataFileError();\n  } finally {\n    await rm(temporaryPath, { force: true }).catch(() => undefined);\n  }\n}\n\nfunction mapError(error: unknown): LifecycleErrorCode {\n  if (error instanceof PrototypeNotFoundError) return \"not-found\";\n  if (error instanceof PrototypeOwnershipError) return \"forbidden\";\n  if (error instanceof PrototypeMetadataFileError) return \"filesystem-failure\";\n  if (error instanceof RepositoryBusyError) return \"repository-busy\";\n  if (\n    error instanceof PrototypeRefError ||\n    error instanceof LifecycleInputError\n  ) {\n    return \"invalid-input\";\n  }\n  if (error instanceof GitRepositoryError) {\n    if (error.kind === \"timeout\") return \"timeout\";\n    if (error.kind === \"conflict\") return \"working-tree-conflict\";\n    if (error.kind === \"invalid-configuration\") return \"unexpected-failure\";\n    return \"git-failure\";\n  }\n  if (error instanceof PrototypeScaffoldError) {\n    if (error.kind === \"collision\") return \"already-exists\";\n    if (error.kind === \"invalid-input\") return \"invalid-input\";\n    return \"filesystem-failure\";\n  }\n  if (error instanceof PrototypeDuplicateError) {\n    if (error.kind === \"source-not-found\") return \"not-found\";\n    if (error.kind === \"collision\") return \"already-exists\";\n    if (error.kind === \"invalid-source\") return \"invalid-input\";\n    return \"filesystem-failure\";\n  }\n  if (error instanceof DeploymentUnavailableError) {\n    return \"deployment-unavailable\";\n  }\n  if (\n    error instanceof DeploymentSourcePushError ||\n    error instanceof DeploymentNotAcceptedError ||\n    error instanceof DeploymentWorktreeError\n  ) {\n    return \"deployment-failure\";\n  }\n  if (error instanceof DeploymentProviderError) {\n    return error.kind === \"timeout\" ? \"timeout\" : \"deployment-failure\";\n  }\n  return \"unexpected-failure\";\n}\n\nfunction resultFrom<Value>(\n  operation: () => Promise<Value>,\n): Promise<LifecycleResult<Value>> {\n  return operation()\n    .then(lifecycleSuccess)\n    .catch((error: unknown) => lifecycleFailure(mapError(error)));\n}\n\nexport class LocalPrototypeLifecycle implements PrototypeLifecycle {\n  readonly #runtime: PrototypeLifecycleRuntimeContext;\n  readonly gitMode: GitMode;\n  readonly #catalog: PrototypeCatalogLike;\n  readonly #repository: GitRepository;\n  readonly #preparePrototypeFiles: PreparePrototypeFiles;\n  readonly #deploymentProvider?: DeploymentProvider;\n  readonly #applicationId?: string;\n  readonly #themeRegistry?: ThemeRegistry;\n  #restartRequired = false;\n  #pendingPublication?: PendingPublication;\n\n  constructor(options: LocalPrototypeLifecycleOptions) {\n    const internalOptions = options as InternalLocalPrototypeLifecycleOptions;\n    const runtime =\n      internalOptions.runtime ?? createPrototypeLifecycleRuntime(internalOptions);\n    this.#runtime = {\n      ...runtime,\n      gitMode: parseGitModeSetting(runtime.gitMode),\n    };\n    this.gitMode = this.#runtime.gitMode;\n    this.#themeRegistry = options.themeRegistry;\n    this.#catalog =\n      internalOptions.catalog ??\n      new PrototypeCatalog({\n        ...this.#runtime,\n        themeRegistry: this.#themeRegistry,\n      });\n    this.#repository = this.#runtime.gitRepository;\n    this.#preparePrototypeFiles =\n      internalOptions.preparePrototypeFiles ?? (() => undefined);\n    this.#deploymentProvider = internalOptions.deploymentProvider;\n    this.#applicationId = internalOptions.applicationId;\n    if (\n      this.#deploymentProvider &&\n      (typeof this.#applicationId !== \"string\" ||\n        this.#applicationId.length === 0)\n    ) {\n      throw new TypeError(\n        \"applicationId must be provided when deploymentProvider is configured\",\n      );\n    }\n  }\n\n  async #verifiedIdentity(identity: BonfireIdentity) {\n    return parseBonfireIdentity(identity);\n  }\n\n  async #currentBranch() {\n    const branch = await this.#repository.currentBranch();\n    if (branch === \"HEAD\" || branch.length === 0) {\n      throw new GitRepositoryError(\"conflict\", \"current-branch\");\n    }\n    return branch;\n  }\n\n  async #ownedPrototype(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ) {\n    const verifiedIdentity = await this.#verifiedIdentity(identity);\n    const normalizedInput = parsePrototypeCommandInput(input);\n    if (normalizedInput.ref.login !== verifiedIdentity.login) {\n      throw new PrototypeOwnershipError();\n    }\n    const summary = await this.#catalog.getSummary(normalizedInput.ref);\n    if (!summary) {\n      throw new PrototypeNotFoundError();\n    }\n\n    return {\n      ref: normalizedInput.ref,\n      path: repositoryRelativePath(this.#runtime, normalizedInput.ref),\n      summary,\n    };\n  }\n\n  async #prepareMutationBranch(login: string) {\n    await assertIdentityBranchReady(this.#repository, login);\n    return login;\n  }\n\n  async #prepareDestination(\n    receipt: OwnedDestinationReceipt,\n    expectedFiles: readonly string[],\n    request: PreparePrototypeFilesRequest,\n  ) {\n    try {\n      const frozenRequest = Object.freeze({\n        ...request,\n        ref: Object.freeze({ ...request.ref }),\n        identity: Object.freeze({ ...request.identity }),\n        ...(request.operation === \"duplicate\"\n          ? { source: Object.freeze({ ...request.source }) }\n          : {}),\n      }) as PreparePrototypeFilesRequest;\n      await this.#preparePrototypeFiles(frozenRequest);\n      await validateOwnedDestination(\n        receipt,\n        expectedFiles,\n        request.ref,\n        this.#themeRegistry,\n      );\n    } catch {\n      try {\n        await cleanupOwnedDestination(receipt);\n      } catch {\n        // The failure remains a finite filesystem failure without retrying cleanup.\n      }\n      throw new PrototypeScaffoldError(\"filesystem\");\n    }\n  }\n\n  async prepareBranch(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<BranchPreparationValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          if (\n            this.#runtime.gitMode === \"manual\" ||\n            this.#runtime.automaticBranchSwitch === \"disabled\"\n          ) {\n            await this.#currentBranch();\n            return { status: \"disabled\" } satisfies BranchPreparationValue;\n          }\n\n          const synchronization = await synchronizeIdentityBranch(\n            this.#repository,\n            {\n              identityBranch: verifiedIdentity.login,\n              primaryBranch: this.#runtime.primaryBranch,\n              remote: this.#runtime.remote,\n              managedPaths: this.#runtime.managedRepositoryPaths,\n            },\n          );\n          if (synchronization.status !== \"synchronized\") {\n            return {\n              status: synchronization.status,\n              reason: synchronization.reason,\n              ...(synchronization.affectedPaths.length > 0\n                ? { affectedPaths: synchronization.affectedPaths }\n                : {}),\n            } satisfies BranchPreparationValue;\n          }\n          if (\n            synchronization.affectedPaths.some((path) =>\n              this.#runtime.managedRepositoryPaths.includes(path),\n            )\n          ) {\n            this.#restartRequired = true;\n          }\n          return {\n            status: \"ready\",\n            ...(synchronization.affectedPaths.length > 0\n              ? { affectedPaths: synchronization.affectedPaths }\n              : {}),\n          } satisfies BranchPreparationValue;\n        },\n      );\n    });\n  }\n\n  async create(\n    identity: BonfireIdentity,\n    input: CreatePrototypeInput,\n  ): Promise<LifecycleResult<CreatePrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parseCreatePrototypeInput(\n        input,\n        this.#themeRegistry,\n      );\n      const ref = destinationRef(verifiedIdentity, normalizedInput.title);\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          if (await this.#catalog.getSummary(ref)) {\n            throw new PrototypeScaffoldError(\"collision\");\n          }\n\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          const prepared = await scaffoldPrototype({\n            paths: this.#runtime,\n            ref,\n            title: normalizedInput.title,\n            description: normalizedInput.description,\n            authorName: verifiedIdentity.name,\n            theme: normalizedInput.theme,\n            themeRegistry: this.#themeRegistry,\n          });\n          await this.#prepareDestination(\n            prepared.receipt,\n            prepared.expectedFiles,\n            {\n              operation: \"create\",\n              repositoryRoot: this.#runtime.repositoryRoot,\n              prototypeRoot: this.#runtime.prototypeRoot,\n              prototypePath: prepared.destination,\n              ref,\n              identity: verifiedIdentity,\n              title: normalizedInput.title,\n              description: normalizedInput.description,\n            },\n          );\n          if (branch === undefined) {\n            return {\n              ref,\n              url: getPrototypeUrl(ref),\n              remoteStatus: \"manual\",\n            } satisfies CreatePrototypeValue;\n          }\n\n          await commitPath(\n            this.#repository,\n            repositoryRelativePath(this.#runtime, ref),\n            `init: ${ref.slug}`,\n          );\n          const push = await pushBranch(\n            this.#repository,\n            this.#runtime.remote,\n            branch,\n          );\n\n          return {\n            ref,\n            url: getPrototypeUrl(ref),\n            remoteStatus: push.remoteStatus,\n          } satisfies CreatePrototypeValue;\n        },\n      );\n    });\n  }\n\n  async edit(\n    identity: BonfireIdentity,\n    input: EditPrototypeInput,\n  ): Promise<LifecycleResult<EditPrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parseEditPrototypeInput(\n        input,\n        this.#themeRegistry,\n      );\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          const { ref, path } = await this.#ownedPrototype(verifiedIdentity, {\n            ref: normalizedInput.ref,\n          });\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          await assertPrototypeDirectory(this.#runtime, ref);\n          const document = await readMetadataDocument(\n            this.#runtime,\n            ref,\n            this.#themeRegistry,\n          );\n          const metadata = parsePrototypeMetadata(document, {\n            themeRegistry: this.#themeRegistry,\n          });\n          if (metadata.authorLogin !== ref.login) {\n            throw new PrototypeNotFoundError();\n          }\n\n          await writeMetadataDocument(this.#runtime, ref, {\n            ...document,\n            title: normalizedInput.title,\n            description: normalizedInput.description,\n            updatedAt: new Date().toISOString(),\n            ...(normalizedInput.theme === undefined\n              ? {}\n              : { theme: normalizedInput.theme }),\n          });\n          if (branch !== undefined) {\n            await commitPath(this.#repository, path, `edit: ${ref.slug}`);\n            await pushBranch(this.#repository, this.#runtime.remote, branch);\n          }\n\n          return { edited: true, ref } satisfies EditPrototypeValue;\n        },\n      );\n    });\n  }\n\n  async delete(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DeletePrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parsePrototypeCommandInput(input);\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          const { ref, path } = await this.#ownedPrototype(\n            verifiedIdentity,\n            normalizedInput,\n          );\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          await removePrototypeDirectory(this.#runtime, ref);\n          if (branch !== undefined) {\n            await commitPath(this.#repository, path, `delete: ${ref.slug}`);\n            await pushBranch(this.#repository, this.#runtime.remote, branch);\n          }\n\n          return { deleted: true, ref } satisfies DeletePrototypeValue;\n        },\n      );\n    });\n  }\n\n  async getDirtyState(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DirtyObservationValue>> {\n    return resultFrom(async () => {\n      const { path, summary } = await this.#ownedPrototype(identity, input);\n      const status = await this.#repository.status([path]);\n      return {\n        status: status.files.length > 0 ? \"dirty\" : \"clean\",\n        ...(summary.previewUrl !== undefined\n          ? { previewUrl: summary.previewUrl }\n          : {}),\n      } satisfies DirtyObservationValue;\n    });\n  }\n\n  async getRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      return getRepositorySummary({\n        repository: this.#repository,\n        catalog: this.#catalog,\n        repositoryRoot: this.#runtime.repositoryRoot,\n        prototypeRoot: this.#runtime.prototypeRoot,\n        identity: verifiedIdentity,\n        mode: this.#runtime.gitMode,\n        remote: this.#runtime.remote,\n        primaryBranch: this.#runtime.primaryBranch,\n        restartRequired: this.#restartRequired,\n      });\n    });\n  }\n\n  async checkRepositorySummary(\n    identity: BonfireIdentity,\n  ): Promise<LifecycleResult<RepositorySummary>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      return getRepositorySummary({\n        repository: this.#repository,\n        catalog: this.#catalog,\n        repositoryRoot: this.#runtime.repositoryRoot,\n        prototypeRoot: this.#runtime.prototypeRoot,\n        identity: verifiedIdentity,\n        mode: this.#runtime.gitMode,\n        remote: this.#runtime.remote,\n        primaryBranch: this.#runtime.primaryBranch,\n        restartRequired: this.#restartRequired,\n        refresh: true,\n      });\n    });\n  }\n\n  async #headCommit() {\n    const commit = (await this.#repository.raw([\"rev-parse\", \"HEAD\"])).trim();\n    if (!/^[0-9a-f]{40,64}$/iu.test(commit)) {\n      throw new GitRepositoryError(\"malformed-output\", \"head-commit\");\n    }\n    return commit.toLowerCase();\n  }\n\n  async #prepareDeploymentBranch(login: string) {\n    if (this.#runtime.automaticBranchSwitch === \"disabled\") {\n      await assertIdentityBranchReady(this.#repository, login);\n      return \"updates-not-synchronized\" as const;\n    }\n\n    const synchronization = await synchronizeIdentityBranch(this.#repository, {\n      identityBranch: login,\n      primaryBranch: this.#runtime.primaryBranch,\n      remote: this.#runtime.remote,\n      managedPaths: this.#runtime.managedRepositoryPaths,\n    });\n    if (synchronization.status === \"unsafe\") {\n      throw new GitRepositoryError(\"conflict\", \"deployment-preparation\");\n    }\n    await assertIdentityBranchReady(this.#repository, login);\n    return synchronization.status === \"deferred\"\n      ? (\"updates-not-synchronized\" as const)\n      : undefined;\n  }\n\n  #workspaceRuntime(\n    workspacePath: string,\n    workspaceRepository: GitRepository,\n  ): PrototypeLifecycleRuntimeContext {\n    return {\n      ...this.#runtime,\n      repositoryRoot: workspacePath,\n      repositoryRealPath: workspacePath,\n      prototypeRoot: join(\n        workspacePath,\n        relative(this.#runtime.repositoryRoot, this.#runtime.prototypeRoot),\n      ),\n      gitRepository: workspaceRepository,\n    };\n  }\n\n  async #publishDeploymentMetadata(pending: PendingPublication) {\n    return publishDeploymentSource(\n      this.#repository,\n      {\n        remote: this.#runtime.remote,\n        primaryBranch: this.#runtime.primaryBranch,\n        sourceSha: pending.sourceSha,\n        commitIdentity: this.#runtime.commitIdentity,\n      },\n      async ({ path, repository }) => {\n        const workspaceRuntime = this.#workspaceRuntime(path, repository);\n        const mergedDocument = await readMetadataDocument(\n          workspaceRuntime,\n          pending.ref,\n          this.#themeRegistry,\n        );\n        await writeMetadataDocument(workspaceRuntime, pending.ref, {\n          ...mergedDocument,\n          previewUrl: pending.previewUrl,\n          updatedAt: new Date().toISOString(),\n        });\n        await commitPath(\n          repository,\n          pending.path,\n          `deploy: ${pending.ref.slug} (metadata)`,\n        );\n      },\n    );\n  }\n\n  async #deploymentValue(\n    pending: PendingPublication,\n    publicationWarnings: readonly DeploymentWarningCode[] = [],\n  ): Promise<DeploymentValue> {\n    const warnings = [\n      ...(pending.synchronizationWarning === undefined\n        ? []\n        : [pending.synchronizationWarning]),\n      ...publicationWarnings,\n    ];\n    return {\n      deployed: true,\n      ref: pending.ref,\n      previewUrl: pending.previewUrl,\n      deploymentId: pending.deploymentId,\n      sourceSha: pending.sourceSha,\n      readyState: pending.readyState,\n      warning: publicationWarnings[0] ?? pending.synchronizationWarning,\n      ...(warnings.length === 0 ? {} : { warnings }),\n    };\n  }\n\n  async deploy(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DeploymentValue>> {\n    if (this.#runtime.gitMode === \"manual\") {\n      return lifecycleFailure(\"forbidden\");\n    }\n\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parsePrototypeCommandInput(input);\n      if (!this.#deploymentProvider) {\n        throw new DeploymentUnavailableError();\n      }\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          const { ref, path } = await this.#ownedPrototype(\n            verifiedIdentity,\n            normalizedInput,\n          );\n          const synchronizationWarning = await this.#prepareDeploymentBranch(\n            verifiedIdentity.login,\n          );\n          await assertPrototypeDirectory(this.#runtime, ref);\n          const document = await readMetadataDocument(\n            this.#runtime,\n            ref,\n            this.#themeRegistry,\n          );\n          const metadata = parsePrototypeMetadata(document, {\n            themeRegistry: this.#themeRegistry,\n          });\n          if (metadata.authorLogin !== ref.login) {\n            throw new PrototypeNotFoundError();\n          }\n\n          await commitPath(this.#repository, path, `deploy: ${ref.slug}`);\n          const sourceSha = await this.#headCommit();\n          const sourcePush = await pushCommitToBranch(\n            this.#repository,\n            this.#runtime.remote,\n            sourceSha,\n            verifiedIdentity.login,\n          );\n          if (sourcePush.remoteStatus !== \"pushed\") {\n            throw new DeploymentSourcePushError();\n          }\n\n          await preflightDeploymentSource(this.#repository, {\n            remote: this.#runtime.remote,\n            primaryBranch: this.#runtime.primaryBranch,\n            sourceSha,\n            commitIdentity: this.#runtime.commitIdentity,\n          });\n\n          const deployment = await this.#deploymentProvider!.deploy({\n            applicationId: this.#applicationId!,\n            login: verifiedIdentity.login,\n          });\n          if (\n            deployment.commitSha.toLowerCase() !== sourceSha ||\n            ![\"READY\", \"QUEUED\", \"INITIALIZING\", \"BUILDING\"].includes(\n              deployment.readyState,\n            )\n          ) {\n            throw new DeploymentNotAcceptedError();\n          }\n          const previewUrl = new URL(\n            getPrototypeUrl(ref).slice(1),\n            `${deployment.url.replace(/\\/+$/, \"\")}/`,\n          ).toString();\n          const pending: PendingPublication = {\n            identity: verifiedIdentity,\n            input: normalizedInput,\n            ref,\n            path,\n            previewUrl,\n            deploymentId: deployment.deploymentId,\n            sourceSha,\n            readyState: deployment.readyState,\n            synchronizationWarning,\n          };\n\n          try {\n            const publication = await this.#publishDeploymentMetadata(pending);\n            this.#pendingPublication = undefined;\n            return this.#deploymentValue(\n              pending,\n              publication.cleanupFailed\n                ? [\"publication-cleanup-failed\"]\n                : [],\n            );\n          } catch (error) {\n            // Keep the accepted deployment retryable for every publication\n            // failure, including metadata preparation failures.\n            this.#pendingPublication = pending;\n            return this.#deploymentValue(pending, [\n              error instanceof DeploymentWorktreeError &&\n              error.kind !== \"cleanup-failure\"\n                ? \"primary-merge-failed\"\n                : \"metadata-persistence-failed\",\n              ...(error instanceof DeploymentWorktreeError && error.cleanupFailed\n                ? [\"publication-cleanup-failed\" as const]\n                : []),\n            ]);\n          }\n        },\n      );\n    });\n  }\n\n  async retryPublish(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DeploymentValue>> {\n    if (this.#runtime.gitMode === \"manual\") {\n      return lifecycleFailure(\"forbidden\");\n    }\n\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parsePrototypeCommandInput(input);\n      const pending = this.#pendingPublication;\n      if (\n        pending === undefined ||\n        pending.identity.login !== verifiedIdentity.login ||\n        pending.ref.login !== normalizedInput.ref.login ||\n        pending.ref.slug !== normalizedInput.ref.slug\n      ) {\n        throw new DeploymentUnavailableError();\n      }\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          await assertIdentityBranchReady(this.#repository, verifiedIdentity.login);\n          const publication = await this.#publishDeploymentMetadata(pending);\n          this.#pendingPublication = undefined;\n          return this.#deploymentValue(\n            pending,\n            publication.cleanupFailed ? [\"publication-cleanup-failed\"] : [],\n          );\n        },\n      );\n    });\n  }\n\n  async save(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<SavePrototypeValue>> {\n    if (this.#runtime.gitMode === \"manual\") {\n      return lifecycleFailure(\"forbidden\");\n    }\n\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const { ref, path } = await this.#ownedPrototype(\n        verifiedIdentity,\n        input,\n      );\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          await this.#prepareMutationBranch(verifiedIdentity.login);\n          await commitPath(this.#repository, path, `save: ${ref.slug}`);\n          await pushBranch(\n            this.#repository,\n            this.#runtime.remote,\n            verifiedIdentity.login,\n          );\n          return { saved: true } satisfies SavePrototypeValue;\n        },\n      );\n    });\n  }\n\n  async discard(\n    identity: BonfireIdentity,\n    input: PrototypeCommandInput,\n  ): Promise<LifecycleResult<DiscardPrototypeValue>> {\n    if (this.#runtime.gitMode === \"manual\") {\n      return lifecycleFailure(\"forbidden\");\n    }\n\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const { path } = await this.#ownedPrototype(\n        verifiedIdentity,\n        input,\n      );\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          await discardPath(this.#repository, path);\n          return { discarded: true } satisfies DiscardPrototypeValue;\n        },\n      );\n    });\n  }\n\n  async duplicate(\n    identity: BonfireIdentity,\n    input: DuplicatePrototypeInput,\n  ): Promise<LifecycleResult<DuplicatePrototypeValue>> {\n    return resultFrom(async () => {\n      const verifiedIdentity = await this.#verifiedIdentity(identity);\n      const normalizedInput = parseDuplicatePrototypeInput(input);\n      if (!(await this.#catalog.getSummary(normalizedInput.source))) {\n        throw new PrototypeDuplicateError(\"source-not-found\");\n      }\n      const ref = destinationRef(verifiedIdentity, normalizedInput.title);\n\n      return withRepositoryOperation(\n        this.#runtime.repositoryRealPath,\n        async () => {\n          if (await this.#catalog.getSummary(ref)) {\n            throw new PrototypeDuplicateError(\"collision\");\n          }\n\n          const branch =\n            this.#runtime.gitMode === \"managed\"\n              ? await this.#prepareMutationBranch(verifiedIdentity.login)\n              : undefined;\n          const prepared = await duplicatePrototype({\n            paths: this.#runtime,\n            source: normalizedInput.source,\n            destination: ref,\n            title: normalizedInput.title,\n            description: normalizedInput.description,\n            authorName: verifiedIdentity.name,\n            themeRegistry: this.#themeRegistry,\n          });\n          await this.#prepareDestination(\n            prepared.receipt,\n            prepared.expectedFiles,\n            {\n              operation: \"duplicate\",\n              repositoryRoot: this.#runtime.repositoryRoot,\n              prototypeRoot: this.#runtime.prototypeRoot,\n              prototypePath: prepared.destination,\n              ref,\n              source: normalizedInput.source,\n              identity: verifiedIdentity,\n              title: normalizedInput.title,\n              description: normalizedInput.description,\n            },\n          );\n          if (branch === undefined) {\n            return {\n              ref,\n              url: getPrototypeUrl(ref),\n              remoteStatus: \"manual\",\n            } satisfies DuplicatePrototypeValue;\n          }\n\n          await commitPath(\n            this.#repository,\n            repositoryRelativePath(this.#runtime, ref),\n            `init: ${ref.slug}`,\n          );\n          const push = await pushBranch(\n            this.#repository,\n            this.#runtime.remote,\n            branch,\n          );\n\n          return {\n            ref,\n            url: getPrototypeUrl(ref),\n            remoteStatus: push.remoteStatus,\n          } satisfies DuplicatePrototypeValue;\n        },\n      );\n    });\n  }\n}\n"]}