@ebay-dt/bonfire-node 0.1.0 → 0.2.0-alpha.3

package/dist/lifecycle/repository-summary.js

@@ -0,0 +1,182 @@
+import { relative } from "node:path";
+import { getGitManagementCapabilities, parseRepositoryRelativePath, } from "@ebay-dt/bonfire-core";
+import { hasUnresolvedRepositoryOperation } from "./repository-synchronization.js";
+function normalizePath(value) {
+    return value.replaceAll("\\", "/").replace(/^\.\//u, "");
+}
+function pathPrefix(repositoryRoot, prototypeRoot) {
+    const value = normalizePath(relative(repositoryRoot, prototypeRoot));
+    return value === "." ? "" : value.replace(/\/+$/u, "");
+}
+function summaryKey(ref) {
+    return `${ref.login}/${ref.slug}`;
+}
+function contextForPath(value, prefix, summaries, identity) {
+    const path = normalizePath(value);
+    const rest = prefix === "" ? path : path.startsWith(`${prefix}/`) ? path.slice(prefix.length + 1) : null;
+    if (rest === null)
+        return { scope: "out-of-scope", prototype: undefined };
+    const segments = rest.split("/");
+    const login = segments[0];
+    const slug = segments[1];
+    if (login === undefined || slug === undefined) {
+        return { scope: "unknown", prototype: undefined };
+    }
+    const ref = { login, slug };
+    const summary = summaries.get(summaryKey(ref));
+    if (summary === undefined)
+        return { scope: "unknown", prototype: undefined };
+    return {
+        scope: login === identity.login ? "owned-prototype" : "other-prototype",
+        prototype: ref,
+    };
+}
+function safePath(value) {
+    try {
+        return parseRepositoryRelativePath(normalizePath(value));
+    }
+    catch {
+        return null;
+    }
+}
+function addChange(changes, path, status, context) {
+    const safe = safePath(path);
+    if (safe === null)
+        return;
+    const key = `${status}:${safe}`;
+    changes.set(key, {
+        path: safe,
+        status,
+        scope: context.scope,
+        ...(context.prototype === undefined ? {} : { prototype: context.prototype }),
+    });
+}
+function statusPaths(file) {
+    return [file.path, ...(file.from === undefined ? [] : [file.from])];
+}
+async function diffPaths(repository, range) {
+    const output = await repository.raw(["diff", "--name-only", "-z", range]);
+    return output.split("\0").filter((path) => path.length > 0);
+}
+async function refRelation(repository, left, right) {
+    const output = await repository.raw([
+        "rev-list",
+        "--left-right",
+        "--count",
+        `${left}...${right}`,
+    ]);
+    const values = output.trim().split(/\s+/u).map(Number);
+    if (values.length !== 2 ||
+        values.some((value) => !Number.isSafeInteger(value) || value < 0)) {
+        throw new Error("Malformed Git ref relation");
+    }
+    return { ahead: values[0], behind: values[1] };
+}
+function addDiffChanges(changes, paths, status, prefix, summaries, identity) {
+    for (const path of paths) {
+        addChange(changes, path, status, contextForPath(path, prefix, summaries, identity));
+    }
+}
+export async function getRepositorySummary(options) {
+    const summaries = new Map((await options.catalog.scan()).map((summary) => [
+        summaryKey(summary.ref),
+        summary,
+    ]));
+    const prefix = pathPrefix(options.repositoryRoot, options.prototypeRoot);
+    const changes = new Map();
+    const attention = new Set();
+    const status = await options.repository.status();
+    const currentBranch = await options.repository.currentBranch();
+    const unresolved = await hasUnresolvedRepositoryOperation(options.repository);
+    const detached = currentBranch === "HEAD" || currentBranch.length === 0;
+    const wrongBranch = !detached && currentBranch !== options.identity.login;
+    for (const file of status.files) {
+        const fileStatus = file.index.includes("U") || file.workingDirectory.includes("U")
+            ? "unresolved"
+            : "uncommitted";
+        for (const path of statusPaths(file)) {
+            addChange(changes, path, fileStatus, contextForPath(path, prefix, summaries, options.identity));
+        }
+    }
+    const dirtyWorktree = status.files.length > 0;
+    if (unresolved)
+        attention.add("unresolved-operation");
+    if (detached)
+        attention.add("detached-head");
+    if (wrongBranch)
+        attention.add("wrong-branch");
+    const remotes = await options.repository.remotes();
+    const hasRemote = remotes.some((remote) => remote.name === options.remote);
+    let fetchFailed = false;
+    if (options.refresh && options.mode === "managed" && hasRemote) {
+        try {
+            await options.repository.fetch(options.remote);
+        }
+        catch {
+            fetchFailed = true;
+            attention.add("fetch-failed");
+        }
+    }
+    const branches = await options.repository.branches();
+    const localIdentity = branches.all.includes(options.identity.login);
+    const remoteIdentity = `remotes/${options.remote}/${options.identity.login}`;
+    const remotePrimary = `remotes/${options.remote}/${options.primaryBranch}`;
+    const hasRemoteIdentity = hasRemote && branches.all.includes(remoteIdentity);
+    const hasRemotePrimary = hasRemote && branches.all.includes(remotePrimary);
+    let updateCheck = options.mode === "manual" ? "not-checked" : "unavailable";
+    if (options.mode === "managed") {
+        if (fetchFailed) {
+            updateCheck = "attention";
+        }
+        else if (!hasRemote) {
+            updateCheck = "unavailable";
+        }
+        else if (!hasRemotePrimary || !localIdentity) {
+            updateCheck = "attention";
+            attention.add("missing-primary");
+        }
+        else {
+            try {
+                const primaryRelation = await refRelation(options.repository, options.identity.login, remotePrimary);
+                updateCheck =
+                    primaryRelation.behind > 0 ? "updates-available" : "up-to-date";
+                if (primaryRelation.behind > 0) {
+                    if (dirtyWorktree)
+                        attention.add("dirty-worktree");
+                    addDiffChanges(changes, await diffPaths(options.repository, `${options.identity.login}..${remotePrimary}`), "updates-available", prefix, summaries, options.identity);
+                }
+            }
+            catch {
+                updateCheck = "attention";
+                attention.add("unknown");
+            }
+        }
+        if (hasRemoteIdentity && localIdentity) {
+            try {
+                const identityRelation = await refRelation(options.repository, options.identity.login, remoteIdentity);
+                if (identityRelation.ahead > 0) {
+                    addDiffChanges(changes, await diffPaths(options.repository, `${remoteIdentity}..${options.identity.login}`), "committed-unpushed", prefix, summaries, options.identity);
+                }
+            }
+            catch {
+                attention.add("unknown");
+            }
+        }
+    }
+    let readiness = "ready";
+    if (detached || wrongBranch || unresolved) {
+        readiness = "blocked";
+    }
+    else if (!status.clean) {
+        readiness = "attention";
+    }
+    return {
+        mode: options.mode,
+        readiness,
+        updateCheck,
+        changes: [...changes.values()].sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0),
+        attention: [...attention].sort(),
+        capabilities: getGitManagementCapabilities(options.mode),
+    };
+}
+//# sourceMappingURL=repository-summary.js.map

package/dist/lifecycle/repository-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-summary.js","sourceRoot":"","sources":["../../src/lifecycle/repository-summary.ts"],"names":[],"mappings":"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","sourcesContent":["import { relative } from \"node:path\";\nimport {\n  getGitManagementCapabilities,\n  parseRepositoryRelativePath,\n  type BonfireIdentity,\n  type GitMode,\n  type PrototypeRef,\n  type PrototypeSummary,\n  type RepositoryAttentionCode,\n  type RepositoryChange,\n  type RepositoryChangeScope,\n  type RepositoryChangeStatus,\n  type RepositorySummary,\n} from \"@ebay-dt/bonfire-core\";\nimport type { PrototypeCatalogLike } from \"../prototype-catalog.js\";\nimport {\n  type GitRepository,\n  type GitStatusFile,\n} from \"../git-repository.js\";\nimport { hasUnresolvedRepositoryOperation } from \"./repository-synchronization.js\";\n\nexport type RepositorySummaryOptions = {\n  repository: GitRepository;\n  catalog: PrototypeCatalogLike;\n  repositoryRoot: string;\n  prototypeRoot: string;\n  identity: BonfireIdentity;\n  mode: GitMode;\n  remote: string;\n  primaryBranch: string;\n  /** Fetch remote-tracking refs before comparing managed update state. */\n  refresh?: boolean;\n};\n\ntype SummaryPathContext = {\n  scope: RepositoryChangeScope;\n  prototype: PrototypeRef | undefined;\n};\n\nfunction normalizePath(value: string) {\n  return value.replaceAll(\"\\\\\", \"/\").replace(/^\\.\\//u, \"\");\n}\n\nfunction pathPrefix(repositoryRoot: string, prototypeRoot: string) {\n  const value = normalizePath(relative(repositoryRoot, prototypeRoot));\n  return value === \".\" ? \"\" : value.replace(/\\/+$/u, \"\");\n}\n\nfunction summaryKey(ref: PrototypeRef) {\n  return `${ref.login}/${ref.slug}`;\n}\n\nfunction contextForPath(\n  value: string,\n  prefix: string,\n  summaries: ReadonlyMap<string, PrototypeSummary>,\n  identity: BonfireIdentity,\n): SummaryPathContext {\n  const path = normalizePath(value);\n  const rest = prefix === \"\" ? path : path.startsWith(`${prefix}/`) ? path.slice(prefix.length + 1) : null;\n  if (rest === null) return { scope: \"out-of-scope\", prototype: undefined };\n\n  const segments = rest.split(\"/\");\n  const login = segments[0];\n  const slug = segments[1];\n  if (login === undefined || slug === undefined) {\n    return { scope: \"unknown\", prototype: undefined };\n  }\n\n  const ref = { login, slug } satisfies PrototypeRef;\n  const summary = summaries.get(summaryKey(ref));\n  if (summary === undefined) return { scope: \"unknown\", prototype: undefined };\n\n  return {\n    scope: login === identity.login ? \"owned-prototype\" : \"other-prototype\",\n    prototype: ref,\n  };\n}\n\nfunction safePath(value: string) {\n  try {\n    return parseRepositoryRelativePath(normalizePath(value));\n  } catch {\n    return null;\n  }\n}\n\nfunction addChange(\n  changes: Map<string, RepositoryChange>,\n  path: string,\n  status: RepositoryChangeStatus,\n  context: SummaryPathContext,\n) {\n  const safe = safePath(path);\n  if (safe === null) return;\n  const key = `${status}:${safe}`;\n  changes.set(key, {\n    path: safe,\n    status,\n    scope: context.scope,\n    ...(context.prototype === undefined ? {} : { prototype: context.prototype }),\n  });\n}\n\nfunction statusPaths(file: GitStatusFile) {\n  return [file.path, ...(file.from === undefined ? [] : [file.from])];\n}\n\nasync function diffPaths(repository: GitRepository, range: string) {\n  const output = await repository.raw([\"diff\", \"--name-only\", \"-z\", range]);\n  return output.split(\"\\0\").filter((path) => path.length > 0);\n}\n\nasync function refRelation(repository: GitRepository, left: string, right: string) {\n  const output = await repository.raw([\n    \"rev-list\",\n    \"--left-right\",\n    \"--count\",\n    `${left}...${right}`,\n  ]);\n  const values = output.trim().split(/\\s+/u).map(Number);\n  if (\n    values.length !== 2 ||\n    values.some((value) => !Number.isSafeInteger(value) || value < 0)\n  ) {\n    throw new Error(\"Malformed Git ref relation\");\n  }\n  return { ahead: values[0]!, behind: values[1]! };\n}\n\nfunction addDiffChanges(\n  changes: Map<string, RepositoryChange>,\n  paths: readonly string[],\n  status: RepositoryChangeStatus,\n  prefix: string,\n  summaries: ReadonlyMap<string, PrototypeSummary>,\n  identity: BonfireIdentity,\n) {\n  for (const path of paths) {\n    addChange(\n      changes,\n      path,\n      status,\n      contextForPath(path, prefix, summaries, identity),\n    );\n  }\n}\n\nexport async function getRepositorySummary(\n  options: RepositorySummaryOptions,\n): Promise<RepositorySummary> {\n  const summaries = new Map(\n    (await options.catalog.scan()).map((summary) => [\n      summaryKey(summary.ref),\n      summary,\n    ]),\n  );\n  const prefix = pathPrefix(options.repositoryRoot, options.prototypeRoot);\n  const changes = new Map<string, RepositoryChange>();\n  const attention = new Set<RepositoryAttentionCode>();\n  const status = await options.repository.status();\n  const currentBranch = await options.repository.currentBranch();\n  const unresolved = await hasUnresolvedRepositoryOperation(options.repository);\n  const detached = currentBranch === \"HEAD\" || currentBranch.length === 0;\n  const wrongBranch = !detached && currentBranch !== options.identity.login;\n\n  for (const file of status.files) {\n    const fileStatus =\n      file.index.includes(\"U\") || file.workingDirectory.includes(\"U\")\n        ? \"unresolved\"\n        : \"uncommitted\";\n    for (const path of statusPaths(file)) {\n      addChange(\n        changes,\n        path,\n        fileStatus,\n        contextForPath(path, prefix, summaries, options.identity),\n      );\n    }\n  }\n\n  const dirtyWorktree = status.files.length > 0;\n  if (unresolved) attention.add(\"unresolved-operation\");\n  if (detached) attention.add(\"detached-head\");\n  if (wrongBranch) attention.add(\"wrong-branch\");\n\n  const remotes = await options.repository.remotes();\n  const hasRemote = remotes.some((remote) => remote.name === options.remote);\n  let fetchFailed = false;\n  if (options.refresh && options.mode === \"managed\" && hasRemote) {\n    try {\n      await options.repository.fetch(options.remote);\n    } catch {\n      fetchFailed = true;\n      attention.add(\"fetch-failed\");\n    }\n  }\n  const branches = await options.repository.branches();\n  const localIdentity = branches.all.includes(options.identity.login);\n  const remoteIdentity = `remotes/${options.remote}/${options.identity.login}`;\n  const remotePrimary = `remotes/${options.remote}/${options.primaryBranch}`;\n  const hasRemoteIdentity = hasRemote && branches.all.includes(remoteIdentity);\n  const hasRemotePrimary = hasRemote && branches.all.includes(remotePrimary);\n  let updateCheck: RepositorySummary[\"updateCheck\"] =\n    options.mode === \"manual\" ? \"not-checked\" : \"unavailable\";\n\n  if (options.mode === \"managed\") {\n    if (fetchFailed) {\n      updateCheck = \"attention\";\n    } else if (!hasRemote) {\n      updateCheck = \"unavailable\";\n    } else if (!hasRemotePrimary || !localIdentity) {\n      updateCheck = \"attention\";\n      attention.add(\"missing-primary\");\n    } else {\n      try {\n        const primaryRelation = await refRelation(\n          options.repository,\n          options.identity.login,\n          remotePrimary,\n        );\n        updateCheck =\n          primaryRelation.behind > 0 ? \"updates-available\" : \"up-to-date\";\n        if (primaryRelation.behind > 0) {\n          if (dirtyWorktree) attention.add(\"dirty-worktree\");\n          addDiffChanges(\n            changes,\n            await diffPaths(\n              options.repository,\n              `${options.identity.login}..${remotePrimary}`,\n            ),\n            \"updates-available\",\n            prefix,\n            summaries,\n            options.identity,\n          );\n        }\n      } catch {\n        updateCheck = \"attention\";\n        attention.add(\"unknown\");\n      }\n    }\n\n    if (hasRemoteIdentity && localIdentity) {\n      try {\n        const identityRelation = await refRelation(\n          options.repository,\n          options.identity.login,\n          remoteIdentity,\n        );\n        if (identityRelation.ahead > 0) {\n          addDiffChanges(\n            changes,\n            await diffPaths(\n              options.repository,\n              `${remoteIdentity}..${options.identity.login}`,\n            ),\n            \"committed-unpushed\",\n            prefix,\n            summaries,\n            options.identity,\n          );\n        }\n      } catch {\n        attention.add(\"unknown\");\n      }\n    }\n  }\n\n  let readiness: RepositorySummary[\"readiness\"] = \"ready\";\n  if (detached || wrongBranch || unresolved) {\n    readiness = \"blocked\";\n  } else if (!status.clean) {\n    readiness = \"attention\";\n  }\n  return {\n    mode: options.mode,\n    readiness,\n    updateCheck,\n    changes: [...changes.values()].sort((left, right) =>\n      left.path < right.path ? -1 : left.path > right.path ? 1 : 0,\n    ),\n    attention: [...attention].sort(),\n    capabilities: getGitManagementCapabilities(options.mode),\n  };\n}\n"]}

package/dist/lifecycle/repository-synchronization.d.ts

@@ -0,0 +1,35 @@
+import { type GitRepository } from "../git-repository.js";
+export type SynchronizationDeferredReason = "dirty-worktree" | "fetch-failed" | "merge-conflict";
+export type SynchronizationUnsafeReason = "detached-head" | "unresolved-operation" | "missing-primary" | "identity-divergence" | "failed-abort" | "merge-failed" | "push-failed";
+type SynchronizationBase = {
+    branch: string | null;
+    changed: boolean;
+    pushed: boolean;
+    affectedPaths: readonly string[];
+};
+export type RepositorySynchronizationResult = (SynchronizationBase & {
+    status: "synchronized";
+}) | (SynchronizationBase & {
+    status: "deferred";
+    reason: SynchronizationDeferredReason;
+}) | (SynchronizationBase & {
+    status: "unsafe";
+    reason: SynchronizationUnsafeReason;
+});
+export type SynchronizeIdentityBranchOptions = {
+    identityBranch: string;
+    primaryBranch: string;
+    remote: string;
+};
+export declare function hasUnresolvedRepositoryOperation(repository: GitRepository): Promise<boolean>;
+export declare function assertIdentityBranchReady(repository: GitRepository, identityBranch: string): Promise<void>;
+/**
+ * Synchronize an identity branch from primary without checking out local
+ * primary. Remote-tracking refs are the source of truth whenever a configured
+ * remote is available. The result distinguishes non-blocking attention from
+ * unsafe repository state so callers can keep authentication/read-only flows
+ * available.
+ */
+export declare function synchronizeIdentityBranch(repository: GitRepository, options: SynchronizeIdentityBranchOptions): Promise<RepositorySynchronizationResult>;
+export {};
+//# sourceMappingURL=repository-synchronization.d.ts.map

package/dist/lifecycle/repository-synchronization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-synchronization.d.ts","sourceRoot":"","sources":["../../src/lifecycle/repository-synchronization.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,6BAA6B,GACrC,gBAAgB,GAChB,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,MAAM,2BAA2B,GACnC,eAAe,GACf,sBAAsB,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,cAAc,GACd,aAAa,CAAC;AAElB,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACvC,CAAC,mBAAmB,GAAG;IACrB,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC,GACF,CAAC,mBAAmB,GAAG;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,6BAA6B,CAAC;CACvC,CAAC,GACF,CAAC,mBAAmB,GAAG;IACrB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC,CAAC;AAEP,MAAM,MAAM,gCAAgC,GAAG;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAgDF,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,aAAa,oBAO1B;AAkFD,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,aAAa,EACzB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,+BAA+B,CAAC,CAgL1C","sourcesContent":["import { lstat } from \"node:fs/promises\";\nimport { isAbsolute, resolve } from \"node:path\";\nimport {\n  GitRepositoryError,\n  type GitRepository,\n} from \"../git-repository.js\";\n\nexport type SynchronizationDeferredReason =\n  | \"dirty-worktree\"\n  | \"fetch-failed\"\n  | \"merge-conflict\";\n\nexport type SynchronizationUnsafeReason =\n  | \"detached-head\"\n  | \"unresolved-operation\"\n  | \"missing-primary\"\n  | \"identity-divergence\"\n  | \"failed-abort\"\n  | \"merge-failed\"\n  | \"push-failed\";\n\ntype SynchronizationBase = {\n  branch: string | null;\n  changed: boolean;\n  pushed: boolean;\n  affectedPaths: readonly string[];\n};\n\nexport type RepositorySynchronizationResult =\n  | (SynchronizationBase & {\n      status: \"synchronized\";\n    })\n  | (SynchronizationBase & {\n      status: \"deferred\";\n      reason: SynchronizationDeferredReason;\n    })\n  | (SynchronizationBase & {\n      status: \"unsafe\";\n      reason: SynchronizationUnsafeReason;\n    });\n\nexport type SynchronizeIdentityBranchOptions = {\n  identityBranch: string;\n  primaryBranch: string;\n  remote: string;\n};\n\nconst OPERATION_MARKERS = [\n  \"MERGE_HEAD\",\n  \"CHERRY_PICK_HEAD\",\n  \"REVERT_HEAD\",\n  \"rebase-merge\",\n  \"rebase-apply\",\n] as const;\n\nfunction assertBranch(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 GitRepositoryError(\"invalid-configuration\", option);\n  }\n}\n\nfunction remoteRef(remote: string, branch: string) {\n  return `remotes/${remote}/${branch}`;\n}\n\nfunction branchRef(branch: string) {\n  return `refs/heads/${branch}`;\n}\n\nasync function markerExists(repository: GitRepository, marker: string) {\n  const markerPath = (await repository.raw([\"rev-parse\", \"--git-path\", marker])).trim();\n  if (markerPath.length === 0) return false;\n  const absolutePath = isAbsolute(markerPath)\n    ? markerPath\n    : resolve(repository.repositoryRoot, markerPath);\n  try {\n    await lstat(absolutePath);\n    return true;\n  } catch (error) {\n    if (error && typeof error === \"object\" && \"code\" in error && error.code === \"ENOENT\") {\n      return false;\n    }\n    throw error;\n  }\n}\n\nexport async function hasUnresolvedRepositoryOperation(\n  repository: GitRepository,\n) {\n  for (const marker of OPERATION_MARKERS) {\n    if (await markerExists(repository, marker)) return true;\n  }\n  const status = await repository.status();\n  return hasUnmergedFiles(status.files);\n}\n\nfunction hasUnmergedFiles(files: readonly { index: string; workingDirectory: string }[]) {\n  return files.some(\n    (file) => file.index.includes(\"U\") || file.workingDirectory.includes(\"U\"),\n  );\n}\n\nasync function refCommit(repository: GitRepository, ref: string) {\n  const value = await repository.raw([\"rev-parse\", \"--verify\", `${ref}^{commit}`]);\n  const commit = value.trim();\n  if (!/^[0-9a-f]{40}$/iu.test(commit)) {\n    throw new GitRepositoryError(\"malformed-output\", \"ref-commit\");\n  }\n  return commit;\n}\n\nasync function compareRefs(\n  repository: GitRepository,\n  left: string,\n  right: string,\n) {\n  const output = await repository.raw([\n    \"rev-list\",\n    \"--left-right\",\n    \"--count\",\n    `${left}...${right}`,\n  ]);\n  const values = output.trim().split(/\\s+/u).map(Number);\n  if (\n    values.length !== 2 ||\n    values.some((value) => !Number.isSafeInteger(value) || value < 0)\n  ) {\n    throw new GitRepositoryError(\"malformed-output\", \"ref-relation\");\n  }\n  return { ahead: values[0]!, behind: values[1]! };\n}\n\nasync function safelyAdvanceLocalPrimary(\n  repository: GitRepository,\n  primaryBranch: string,\n  primaryRemoteRef: string,\n  localPrimaryCommit: string,\n) {\n  await repository.raw([\n    \"update-ref\",\n    branchRef(primaryBranch),\n    primaryRemoteRef,\n    localPrimaryCommit,\n  ]);\n}\n\nfunction deferred(\n  branch: string | null,\n  reason: SynchronizationDeferredReason,\n  affectedPaths: readonly string[] = [],\n): RepositorySynchronizationResult {\n  return {\n    status: \"deferred\",\n    branch,\n    changed: false,\n    pushed: false,\n    affectedPaths,\n    reason,\n  };\n}\n\nfunction unsafe(\n  branch: string | null,\n  reason: SynchronizationUnsafeReason,\n  options: Partial<SynchronizationBase> = {},\n): RepositorySynchronizationResult {\n  return {\n    status: \"unsafe\",\n    branch,\n    changed: options.changed ?? false,\n    pushed: options.pushed ?? false,\n    affectedPaths: options.affectedPaths ?? [],\n    reason,\n  };\n}\n\nexport async function assertIdentityBranchReady(\n  repository: GitRepository,\n  identityBranch: string,\n): Promise<void> {\n  assertBranch(identityBranch, \"identity-branch\");\n  const currentBranch = await repository.currentBranch();\n  if (currentBranch === \"HEAD\" || currentBranch.length === 0) {\n    throw new GitRepositoryError(\"conflict\", \"current-branch\");\n  }\n  if (currentBranch !== identityBranch) {\n    throw new GitRepositoryError(\"conflict\", \"identity-branch\");\n  }\n  if (await hasUnresolvedRepositoryOperation(repository)) {\n    throw new GitRepositoryError(\"conflict\", \"unresolved-operation\");\n  }\n  const status = await repository.status();\n  if (hasUnmergedFiles(status.files)) {\n    throw new GitRepositoryError(\"conflict\", \"unresolved-operation\");\n  }\n}\n\n/**\n * Synchronize an identity branch from primary without checking out local\n * primary. Remote-tracking refs are the source of truth whenever a configured\n * remote is available. The result distinguishes non-blocking attention from\n * unsafe repository state so callers can keep authentication/read-only flows\n * available.\n */\nexport async function synchronizeIdentityBranch(\n  repository: GitRepository,\n  options: SynchronizeIdentityBranchOptions,\n): Promise<RepositorySynchronizationResult> {\n  assertBranch(options.identityBranch, \"identity-branch\");\n  assertBranch(options.primaryBranch, \"primary-branch\");\n  assertBranch(options.remote, \"remote\");\n\n  if (options.identityBranch === options.primaryBranch) {\n    throw new GitRepositoryError(\"invalid-configuration\", \"identity-primary-branch\");\n  }\n\n  const currentBranch = await repository.currentBranch();\n  if (currentBranch === \"HEAD\" || currentBranch.length === 0) {\n    return unsafe(null, \"detached-head\");\n  }\n\n  if (await hasUnresolvedRepositoryOperation(repository)) {\n    return unsafe(currentBranch, \"unresolved-operation\");\n  }\n\n  const status = await repository.status();\n  if (hasUnmergedFiles(status.files)) {\n    return unsafe(currentBranch, \"unresolved-operation\", {\n      affectedPaths: status.files.map((file) => file.path),\n    });\n  }\n  if (!status.clean) {\n    return deferred(\n      currentBranch,\n      \"dirty-worktree\",\n      status.files.map((file) => file.path),\n    );\n  }\n\n  const configuredRemote = (await repository.remotes()).some(\n    (remote) => remote.name === options.remote,\n  );\n  if (configuredRemote) {\n    try {\n      await repository.fetch(options.remote);\n    } catch (error) {\n      if (\n        error instanceof GitRepositoryError &&\n        error.kind === \"invalid-configuration\"\n      ) {\n        throw error;\n      }\n      return deferred(currentBranch, \"fetch-failed\");\n    }\n  }\n\n  const branches = await repository.branches();\n  const localPrimary = branches.all.includes(options.primaryBranch);\n  const primaryRemote = remoteRef(options.remote, options.primaryBranch);\n  const remotePrimary = configuredRemote && branches.all.includes(primaryRemote);\n  if (configuredRemote ? !remotePrimary : !localPrimary) {\n    return unsafe(currentBranch, \"missing-primary\");\n  }\n\n  const localIdentity = branches.all.includes(options.identityBranch);\n  const identityRemote = remoteRef(options.remote, options.identityBranch);\n  const remoteIdentity =\n    configuredRemote && branches.all.includes(identityRemote);\n\n  if (localIdentity && remoteIdentity) {\n    const relation = await compareRefs(\n      repository,\n      options.identityBranch,\n      identityRemote,\n    );\n    if (relation.ahead > 0 && relation.behind > 0) {\n      return unsafe(currentBranch, \"identity-divergence\");\n    }\n  }\n\n  let primaryAdvance:\n    | { localCommit: string; remoteRef: string }\n    | undefined;\n  if (localPrimary && remotePrimary) {\n    const relation = await compareRefs(\n      repository,\n      options.primaryBranch,\n      primaryRemote,\n    );\n    if (relation.ahead === 0 && relation.behind > 0) {\n      primaryAdvance = {\n        localCommit: await refCommit(repository, options.primaryBranch),\n        remoteRef: primaryRemote,\n      };\n    }\n  }\n\n  const sourceRef = remotePrimary ? primaryRemote : options.primaryBranch;\n  if (!localIdentity) {\n    if (remoteIdentity) {\n      await repository.checkout([\n        \"-b\",\n        options.identityBranch,\n        \"--track\",\n        `${options.remote}/${options.identityBranch}`,\n      ]);\n    } else {\n      await repository.checkout([\"-b\", options.identityBranch, sourceRef]);\n    }\n  } else if (currentBranch !== options.identityBranch) {\n    await repository.checkout([options.identityBranch]);\n  }\n\n  if (primaryAdvance && currentBranch !== options.primaryBranch) {\n    await safelyAdvanceLocalPrimary(\n      repository,\n      options.primaryBranch,\n      primaryAdvance.remoteRef,\n      primaryAdvance.localCommit,\n    );\n  }\n\n  if (localIdentity && remoteIdentity) {\n    const relation = await compareRefs(\n      repository,\n      options.identityBranch,\n      identityRemote,\n    );\n    if (relation.ahead === 0 && relation.behind > 0) {\n      await repository.merge([identityRemote, \"--ff-only\"]);\n    }\n  }\n\n  const beforeMerge = await refCommit(repository, options.identityBranch);\n  try {\n    await repository.merge([sourceRef, \"--no-edit\"]);\n  } catch (error) {\n    if (!(error instanceof GitRepositoryError) || error.kind !== \"conflict\") {\n      return unsafe(options.identityBranch, \"merge-failed\");\n    }\n    let affectedPaths: readonly string[] = [];\n    try {\n      affectedPaths = (await repository.status()).files.map((file) => file.path);\n    } catch {\n      // Preserve the conflict classification even if status cannot be read.\n    }\n    try {\n      await repository.raw([\"merge\", \"--abort\"]);\n    } catch {\n      return unsafe(options.identityBranch, \"failed-abort\", {\n        affectedPaths,\n      });\n    }\n    return deferred(options.identityBranch, \"merge-conflict\", affectedPaths);\n  }\n\n  const afterMerge = await refCommit(repository, options.identityBranch);\n  const changed = beforeMerge !== afterMerge;\n  if (!changed || !configuredRemote) {\n    return {\n      status: \"synchronized\",\n      branch: options.identityBranch,\n      changed,\n      pushed: false,\n      affectedPaths: [],\n    };\n  }\n\n  try {\n    await repository.push(options.remote, options.identityBranch, [\n      \"--set-upstream\",\n    ]);\n  } catch {\n    return unsafe(options.identityBranch, \"push-failed\", { changed });\n  }\n\n  return {\n    status: \"synchronized\",\n    branch: options.identityBranch,\n    changed: true,\n    pushed: true,\n    affectedPaths: [],\n  };\n}\n"]}

package/dist/lifecycle/repository-synchronization.js

@@ -0,0 +1,270 @@
+import { lstat } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+import { GitRepositoryError, } from "../git-repository.js";
+const OPERATION_MARKERS = [
+    "MERGE_HEAD",
+    "CHERRY_PICK_HEAD",
+    "REVERT_HEAD",
+    "rebase-merge",
+    "rebase-apply",
+];
+function assertBranch(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 GitRepositoryError("invalid-configuration", option);
+    }
+}
+function remoteRef(remote, branch) {
+    return `remotes/${remote}/${branch}`;
+}
+function branchRef(branch) {
+    return `refs/heads/${branch}`;
+}
+async function markerExists(repository, marker) {
+    const markerPath = (await repository.raw(["rev-parse", "--git-path", marker])).trim();
+    if (markerPath.length === 0)
+        return false;
+    const absolutePath = isAbsolute(markerPath)
+        ? markerPath
+        : resolve(repository.repositoryRoot, markerPath);
+    try {
+        await lstat(absolutePath);
+        return true;
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function hasUnresolvedRepositoryOperation(repository) {
+    for (const marker of OPERATION_MARKERS) {
+        if (await markerExists(repository, marker))
+            return true;
+    }
+    const status = await repository.status();
+    return hasUnmergedFiles(status.files);
+}
+function hasUnmergedFiles(files) {
+    return files.some((file) => file.index.includes("U") || file.workingDirectory.includes("U"));
+}
+async function refCommit(repository, ref) {
+    const value = await repository.raw(["rev-parse", "--verify", `${ref}^{commit}`]);
+    const commit = value.trim();
+    if (!/^[0-9a-f]{40}$/iu.test(commit)) {
+        throw new GitRepositoryError("malformed-output", "ref-commit");
+    }
+    return commit;
+}
+async function compareRefs(repository, left, right) {
+    const output = await repository.raw([
+        "rev-list",
+        "--left-right",
+        "--count",
+        `${left}...${right}`,
+    ]);
+    const values = output.trim().split(/\s+/u).map(Number);
+    if (values.length !== 2 ||
+        values.some((value) => !Number.isSafeInteger(value) || value < 0)) {
+        throw new GitRepositoryError("malformed-output", "ref-relation");
+    }
+    return { ahead: values[0], behind: values[1] };
+}
+async function safelyAdvanceLocalPrimary(repository, primaryBranch, primaryRemoteRef, localPrimaryCommit) {
+    await repository.raw([
+        "update-ref",
+        branchRef(primaryBranch),
+        primaryRemoteRef,
+        localPrimaryCommit,
+    ]);
+}
+function deferred(branch, reason, affectedPaths = []) {
+    return {
+        status: "deferred",
+        branch,
+        changed: false,
+        pushed: false,
+        affectedPaths,
+        reason,
+    };
+}
+function unsafe(branch, reason, options = {}) {
+    return {
+        status: "unsafe",
+        branch,
+        changed: options.changed ?? false,
+        pushed: options.pushed ?? false,
+        affectedPaths: options.affectedPaths ?? [],
+        reason,
+    };
+}
+export async function assertIdentityBranchReady(repository, identityBranch) {
+    assertBranch(identityBranch, "identity-branch");
+    const currentBranch = await repository.currentBranch();
+    if (currentBranch === "HEAD" || currentBranch.length === 0) {
+        throw new GitRepositoryError("conflict", "current-branch");
+    }
+    if (currentBranch !== identityBranch) {
+        throw new GitRepositoryError("conflict", "identity-branch");
+    }
+    if (await hasUnresolvedRepositoryOperation(repository)) {
+        throw new GitRepositoryError("conflict", "unresolved-operation");
+    }
+    const status = await repository.status();
+    if (hasUnmergedFiles(status.files)) {
+        throw new GitRepositoryError("conflict", "unresolved-operation");
+    }
+}
+/**
+ * Synchronize an identity branch from primary without checking out local
+ * primary. Remote-tracking refs are the source of truth whenever a configured
+ * remote is available. The result distinguishes non-blocking attention from
+ * unsafe repository state so callers can keep authentication/read-only flows
+ * available.
+ */
+export async function synchronizeIdentityBranch(repository, options) {
+    assertBranch(options.identityBranch, "identity-branch");
+    assertBranch(options.primaryBranch, "primary-branch");
+    assertBranch(options.remote, "remote");
+    if (options.identityBranch === options.primaryBranch) {
+        throw new GitRepositoryError("invalid-configuration", "identity-primary-branch");
+    }
+    const currentBranch = await repository.currentBranch();
+    if (currentBranch === "HEAD" || currentBranch.length === 0) {
+        return unsafe(null, "detached-head");
+    }
+    if (await hasUnresolvedRepositoryOperation(repository)) {
+        return unsafe(currentBranch, "unresolved-operation");
+    }
+    const status = await repository.status();
+    if (hasUnmergedFiles(status.files)) {
+        return unsafe(currentBranch, "unresolved-operation", {
+            affectedPaths: status.files.map((file) => file.path),
+        });
+    }
+    if (!status.clean) {
+        return deferred(currentBranch, "dirty-worktree", status.files.map((file) => file.path));
+    }
+    const configuredRemote = (await repository.remotes()).some((remote) => remote.name === options.remote);
+    if (configuredRemote) {
+        try {
+            await repository.fetch(options.remote);
+        }
+        catch (error) {
+            if (error instanceof GitRepositoryError &&
+                error.kind === "invalid-configuration") {
+                throw error;
+            }
+            return deferred(currentBranch, "fetch-failed");
+        }
+    }
+    const branches = await repository.branches();
+    const localPrimary = branches.all.includes(options.primaryBranch);
+    const primaryRemote = remoteRef(options.remote, options.primaryBranch);
+    const remotePrimary = configuredRemote && branches.all.includes(primaryRemote);
+    if (configuredRemote ? !remotePrimary : !localPrimary) {
+        return unsafe(currentBranch, "missing-primary");
+    }
+    const localIdentity = branches.all.includes(options.identityBranch);
+    const identityRemote = remoteRef(options.remote, options.identityBranch);
+    const remoteIdentity = configuredRemote && branches.all.includes(identityRemote);
+    if (localIdentity && remoteIdentity) {
+        const relation = await compareRefs(repository, options.identityBranch, identityRemote);
+        if (relation.ahead > 0 && relation.behind > 0) {
+            return unsafe(currentBranch, "identity-divergence");
+        }
+    }
+    let primaryAdvance;
+    if (localPrimary && remotePrimary) {
+        const relation = await compareRefs(repository, options.primaryBranch, primaryRemote);
+        if (relation.ahead === 0 && relation.behind > 0) {
+            primaryAdvance = {
+                localCommit: await refCommit(repository, options.primaryBranch),
+                remoteRef: primaryRemote,
+            };
+        }
+    }
+    const sourceRef = remotePrimary ? primaryRemote : options.primaryBranch;
+    if (!localIdentity) {
+        if (remoteIdentity) {
+            await repository.checkout([
+                "-b",
+                options.identityBranch,
+                "--track",
+                `${options.remote}/${options.identityBranch}`,
+            ]);
+        }
+        else {
+            await repository.checkout(["-b", options.identityBranch, sourceRef]);
+        }
+    }
+    else if (currentBranch !== options.identityBranch) {
+        await repository.checkout([options.identityBranch]);
+    }
+    if (primaryAdvance && currentBranch !== options.primaryBranch) {
+        await safelyAdvanceLocalPrimary(repository, options.primaryBranch, primaryAdvance.remoteRef, primaryAdvance.localCommit);
+    }
+    if (localIdentity && remoteIdentity) {
+        const relation = await compareRefs(repository, options.identityBranch, identityRemote);
+        if (relation.ahead === 0 && relation.behind > 0) {
+            await repository.merge([identityRemote, "--ff-only"]);
+        }
+    }
+    const beforeMerge = await refCommit(repository, options.identityBranch);
+    try {
+        await repository.merge([sourceRef, "--no-edit"]);
+    }
+    catch (error) {
+        if (!(error instanceof GitRepositoryError) || error.kind !== "conflict") {
+            return unsafe(options.identityBranch, "merge-failed");
+        }
+        let affectedPaths = [];
+        try {
+            affectedPaths = (await repository.status()).files.map((file) => file.path);
+        }
+        catch {
+            // Preserve the conflict classification even if status cannot be read.
+        }
+        try {
+            await repository.raw(["merge", "--abort"]);
+        }
+        catch {
+            return unsafe(options.identityBranch, "failed-abort", {
+                affectedPaths,
+            });
+        }
+        return deferred(options.identityBranch, "merge-conflict", affectedPaths);
+    }
+    const afterMerge = await refCommit(repository, options.identityBranch);
+    const changed = beforeMerge !== afterMerge;
+    if (!changed || !configuredRemote) {
+        return {
+            status: "synchronized",
+            branch: options.identityBranch,
+            changed,
+            pushed: false,
+            affectedPaths: [],
+        };
+    }
+    try {
+        await repository.push(options.remote, options.identityBranch, [
+            "--set-upstream",
+        ]);
+    }
+    catch {
+        return unsafe(options.identityBranch, "push-failed", { changed });
+    }
+    return {
+        status: "synchronized",
+        branch: options.identityBranch,
+        changed: true,
+        pushed: true,
+        affectedPaths: [],
+    };
+}
+//# sourceMappingURL=repository-synchronization.js.map

package/dist/lifecycle/repository-synchronization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-synchronization.js","sourceRoot":"","sources":["../../src/lifecycle/repository-synchronization.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstat } from \"node:fs/promises\";\nimport { isAbsolute, resolve } from \"node:path\";\nimport {\n  GitRepositoryError,\n  type GitRepository,\n} from \"../git-repository.js\";\n\nexport type SynchronizationDeferredReason =\n  | \"dirty-worktree\"\n  | \"fetch-failed\"\n  | \"merge-conflict\";\n\nexport type SynchronizationUnsafeReason =\n  | \"detached-head\"\n  | \"unresolved-operation\"\n  | \"missing-primary\"\n  | \"identity-divergence\"\n  | \"failed-abort\"\n  | \"merge-failed\"\n  | \"push-failed\";\n\ntype SynchronizationBase = {\n  branch: string | null;\n  changed: boolean;\n  pushed: boolean;\n  affectedPaths: readonly string[];\n};\n\nexport type RepositorySynchronizationResult =\n  | (SynchronizationBase & {\n      status: \"synchronized\";\n    })\n  | (SynchronizationBase & {\n      status: \"deferred\";\n      reason: SynchronizationDeferredReason;\n    })\n  | (SynchronizationBase & {\n      status: \"unsafe\";\n      reason: SynchronizationUnsafeReason;\n    });\n\nexport type SynchronizeIdentityBranchOptions = {\n  identityBranch: string;\n  primaryBranch: string;\n  remote: string;\n};\n\nconst OPERATION_MARKERS = [\n  \"MERGE_HEAD\",\n  \"CHERRY_PICK_HEAD\",\n  \"REVERT_HEAD\",\n  \"rebase-merge\",\n  \"rebase-apply\",\n] as const;\n\nfunction assertBranch(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 GitRepositoryError(\"invalid-configuration\", option);\n  }\n}\n\nfunction remoteRef(remote: string, branch: string) {\n  return `remotes/${remote}/${branch}`;\n}\n\nfunction branchRef(branch: string) {\n  return `refs/heads/${branch}`;\n}\n\nasync function markerExists(repository: GitRepository, marker: string) {\n  const markerPath = (await repository.raw([\"rev-parse\", \"--git-path\", marker])).trim();\n  if (markerPath.length === 0) return false;\n  const absolutePath = isAbsolute(markerPath)\n    ? markerPath\n    : resolve(repository.repositoryRoot, markerPath);\n  try {\n    await lstat(absolutePath);\n    return true;\n  } catch (error) {\n    if (error && typeof error === \"object\" && \"code\" in error && error.code === \"ENOENT\") {\n      return false;\n    }\n    throw error;\n  }\n}\n\nexport async function hasUnresolvedRepositoryOperation(\n  repository: GitRepository,\n) {\n  for (const marker of OPERATION_MARKERS) {\n    if (await markerExists(repository, marker)) return true;\n  }\n  const status = await repository.status();\n  return hasUnmergedFiles(status.files);\n}\n\nfunction hasUnmergedFiles(files: readonly { index: string; workingDirectory: string }[]) {\n  return files.some(\n    (file) => file.index.includes(\"U\") || file.workingDirectory.includes(\"U\"),\n  );\n}\n\nasync function refCommit(repository: GitRepository, ref: string) {\n  const value = await repository.raw([\"rev-parse\", \"--verify\", `${ref}^{commit}`]);\n  const commit = value.trim();\n  if (!/^[0-9a-f]{40}$/iu.test(commit)) {\n    throw new GitRepositoryError(\"malformed-output\", \"ref-commit\");\n  }\n  return commit;\n}\n\nasync function compareRefs(\n  repository: GitRepository,\n  left: string,\n  right: string,\n) {\n  const output = await repository.raw([\n    \"rev-list\",\n    \"--left-right\",\n    \"--count\",\n    `${left}...${right}`,\n  ]);\n  const values = output.trim().split(/\\s+/u).map(Number);\n  if (\n    values.length !== 2 ||\n    values.some((value) => !Number.isSafeInteger(value) || value < 0)\n  ) {\n    throw new GitRepositoryError(\"malformed-output\", \"ref-relation\");\n  }\n  return { ahead: values[0]!, behind: values[1]! };\n}\n\nasync function safelyAdvanceLocalPrimary(\n  repository: GitRepository,\n  primaryBranch: string,\n  primaryRemoteRef: string,\n  localPrimaryCommit: string,\n) {\n  await repository.raw([\n    \"update-ref\",\n    branchRef(primaryBranch),\n    primaryRemoteRef,\n    localPrimaryCommit,\n  ]);\n}\n\nfunction deferred(\n  branch: string | null,\n  reason: SynchronizationDeferredReason,\n  affectedPaths: readonly string[] = [],\n): RepositorySynchronizationResult {\n  return {\n    status: \"deferred\",\n    branch,\n    changed: false,\n    pushed: false,\n    affectedPaths,\n    reason,\n  };\n}\n\nfunction unsafe(\n  branch: string | null,\n  reason: SynchronizationUnsafeReason,\n  options: Partial<SynchronizationBase> = {},\n): RepositorySynchronizationResult {\n  return {\n    status: \"unsafe\",\n    branch,\n    changed: options.changed ?? false,\n    pushed: options.pushed ?? false,\n    affectedPaths: options.affectedPaths ?? [],\n    reason,\n  };\n}\n\nexport async function assertIdentityBranchReady(\n  repository: GitRepository,\n  identityBranch: string,\n): Promise<void> {\n  assertBranch(identityBranch, \"identity-branch\");\n  const currentBranch = await repository.currentBranch();\n  if (currentBranch === \"HEAD\" || currentBranch.length === 0) {\n    throw new GitRepositoryError(\"conflict\", \"current-branch\");\n  }\n  if (currentBranch !== identityBranch) {\n    throw new GitRepositoryError(\"conflict\", \"identity-branch\");\n  }\n  if (await hasUnresolvedRepositoryOperation(repository)) {\n    throw new GitRepositoryError(\"conflict\", \"unresolved-operation\");\n  }\n  const status = await repository.status();\n  if (hasUnmergedFiles(status.files)) {\n    throw new GitRepositoryError(\"conflict\", \"unresolved-operation\");\n  }\n}\n\n/**\n * Synchronize an identity branch from primary without checking out local\n * primary. Remote-tracking refs are the source of truth whenever a configured\n * remote is available. The result distinguishes non-blocking attention from\n * unsafe repository state so callers can keep authentication/read-only flows\n * available.\n */\nexport async function synchronizeIdentityBranch(\n  repository: GitRepository,\n  options: SynchronizeIdentityBranchOptions,\n): Promise<RepositorySynchronizationResult> {\n  assertBranch(options.identityBranch, \"identity-branch\");\n  assertBranch(options.primaryBranch, \"primary-branch\");\n  assertBranch(options.remote, \"remote\");\n\n  if (options.identityBranch === options.primaryBranch) {\n    throw new GitRepositoryError(\"invalid-configuration\", \"identity-primary-branch\");\n  }\n\n  const currentBranch = await repository.currentBranch();\n  if (currentBranch === \"HEAD\" || currentBranch.length === 0) {\n    return unsafe(null, \"detached-head\");\n  }\n\n  if (await hasUnresolvedRepositoryOperation(repository)) {\n    return unsafe(currentBranch, \"unresolved-operation\");\n  }\n\n  const status = await repository.status();\n  if (hasUnmergedFiles(status.files)) {\n    return unsafe(currentBranch, \"unresolved-operation\", {\n      affectedPaths: status.files.map((file) => file.path),\n    });\n  }\n  if (!status.clean) {\n    return deferred(\n      currentBranch,\n      \"dirty-worktree\",\n      status.files.map((file) => file.path),\n    );\n  }\n\n  const configuredRemote = (await repository.remotes()).some(\n    (remote) => remote.name === options.remote,\n  );\n  if (configuredRemote) {\n    try {\n      await repository.fetch(options.remote);\n    } catch (error) {\n      if (\n        error instanceof GitRepositoryError &&\n        error.kind === \"invalid-configuration\"\n      ) {\n        throw error;\n      }\n      return deferred(currentBranch, \"fetch-failed\");\n    }\n  }\n\n  const branches = await repository.branches();\n  const localPrimary = branches.all.includes(options.primaryBranch);\n  const primaryRemote = remoteRef(options.remote, options.primaryBranch);\n  const remotePrimary = configuredRemote && branches.all.includes(primaryRemote);\n  if (configuredRemote ? !remotePrimary : !localPrimary) {\n    return unsafe(currentBranch, \"missing-primary\");\n  }\n\n  const localIdentity = branches.all.includes(options.identityBranch);\n  const identityRemote = remoteRef(options.remote, options.identityBranch);\n  const remoteIdentity =\n    configuredRemote && branches.all.includes(identityRemote);\n\n  if (localIdentity && remoteIdentity) {\n    const relation = await compareRefs(\n      repository,\n      options.identityBranch,\n      identityRemote,\n    );\n    if (relation.ahead > 0 && relation.behind > 0) {\n      return unsafe(currentBranch, \"identity-divergence\");\n    }\n  }\n\n  let primaryAdvance:\n    | { localCommit: string; remoteRef: string }\n    | undefined;\n  if (localPrimary && remotePrimary) {\n    const relation = await compareRefs(\n      repository,\n      options.primaryBranch,\n      primaryRemote,\n    );\n    if (relation.ahead === 0 && relation.behind > 0) {\n      primaryAdvance = {\n        localCommit: await refCommit(repository, options.primaryBranch),\n        remoteRef: primaryRemote,\n      };\n    }\n  }\n\n  const sourceRef = remotePrimary ? primaryRemote : options.primaryBranch;\n  if (!localIdentity) {\n    if (remoteIdentity) {\n      await repository.checkout([\n        \"-b\",\n        options.identityBranch,\n        \"--track\",\n        `${options.remote}/${options.identityBranch}`,\n      ]);\n    } else {\n      await repository.checkout([\"-b\", options.identityBranch, sourceRef]);\n    }\n  } else if (currentBranch !== options.identityBranch) {\n    await repository.checkout([options.identityBranch]);\n  }\n\n  if (primaryAdvance && currentBranch !== options.primaryBranch) {\n    await safelyAdvanceLocalPrimary(\n      repository,\n      options.primaryBranch,\n      primaryAdvance.remoteRef,\n      primaryAdvance.localCommit,\n    );\n  }\n\n  if (localIdentity && remoteIdentity) {\n    const relation = await compareRefs(\n      repository,\n      options.identityBranch,\n      identityRemote,\n    );\n    if (relation.ahead === 0 && relation.behind > 0) {\n      await repository.merge([identityRemote, \"--ff-only\"]);\n    }\n  }\n\n  const beforeMerge = await refCommit(repository, options.identityBranch);\n  try {\n    await repository.merge([sourceRef, \"--no-edit\"]);\n  } catch (error) {\n    if (!(error instanceof GitRepositoryError) || error.kind !== \"conflict\") {\n      return unsafe(options.identityBranch, \"merge-failed\");\n    }\n    let affectedPaths: readonly string[] = [];\n    try {\n      affectedPaths = (await repository.status()).files.map((file) => file.path);\n    } catch {\n      // Preserve the conflict classification even if status cannot be read.\n    }\n    try {\n      await repository.raw([\"merge\", \"--abort\"]);\n    } catch {\n      return unsafe(options.identityBranch, \"failed-abort\", {\n        affectedPaths,\n      });\n    }\n    return deferred(options.identityBranch, \"merge-conflict\", affectedPaths);\n  }\n\n  const afterMerge = await refCommit(repository, options.identityBranch);\n  const changed = beforeMerge !== afterMerge;\n  if (!changed || !configuredRemote) {\n    return {\n      status: \"synchronized\",\n      branch: options.identityBranch,\n      changed,\n      pushed: false,\n      affectedPaths: [],\n    };\n  }\n\n  try {\n    await repository.push(options.remote, options.identityBranch, [\n      \"--set-upstream\",\n    ]);\n  } catch {\n    return unsafe(options.identityBranch, \"push-failed\", { changed });\n  }\n\n  return {\n    status: \"synchronized\",\n    branch: options.identityBranch,\n    changed: true,\n    pushed: true,\n    affectedPaths: [],\n  };\n}\n"]}

package/dist/lifecycle/runtime-context.d.ts

@@ -1,4 +1,4 @@
-import type { AutomaticBranchSwitchMode } from "@ebay-dt/bonfire-core";
+import { type AutomaticBranchSwitchMode, type GitMode } from "@ebay-dt/bonfire-core";
 import { type PrototypeCatalogOptions, type ResolvedPrototypeCatalogPaths } from "../prototype-paths.js";
 import { type GitCommitIdentity, type GitRepository } from "../git-repository.js";
 export type PrototypeLifecycleRuntimeOptions = PrototypeCatalogOptions & {
@@ -6,6 +6,7 @@ export type PrototypeLifecycleRuntimeOptions = PrototypeCatalogOptions & {
     primaryBranch?: string;
     commitIdentity?: GitCommitIdentity;
     automaticBranchSwitch?: AutomaticBranchSwitchMode;
+    gitMode?: GitMode;
     gitRepository?: GitRepository;
 };
 export type PrototypeLifecycleRuntimeContext = ResolvedPrototypeCatalogPaths & {
@@ -13,6 +14,7 @@ export type PrototypeLifecycleRuntimeContext = ResolvedPrototypeCatalogPaths & {
     remote: string;
     primaryBranch: string;
     automaticBranchSwitch: AutomaticBranchSwitchMode;
+    gitMode: GitMode;
     commitIdentity: Readonly<GitCommitIdentity>;
     gitRepository: GitRepository;
 };

package/dist/lifecycle/runtime-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/lifecycle/runtime-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EACnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,MAAM,gCAAgC,GAAG,uBAAuB,GAAG;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,qBAAqB,CAAC,EAAE,yBAAyB,CAAC;IAClD,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,6BAA6B,GAAG;IAC7E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,yBAAyB,CAAC;IACjD,cAAc,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC5C,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AASF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,gCAAgC,CA4BlC","sourcesContent":["import { realpathSync } from \"node:fs\";\nimport type { AutomaticBranchSwitchMode } from \"@ebay-dt/bonfire-core\";\nimport {\n  resolvePrototypeCatalogPaths,\n  type PrototypeCatalogOptions,\n  type ResolvedPrototypeCatalogPaths,\n} from \"../prototype-paths.js\";\nimport {\n  createGitRepository,\n  type GitCommitIdentity,\n  type GitRepository,\n} from \"../git-repository.js\";\n\nconst DEFAULT_REMOTE = \"origin\";\nconst DEFAULT_PRIMARY_BRANCH = \"main\";\nconst DEFAULT_COMMIT_IDENTITY: GitCommitIdentity = {\n  name: \"Bonfire\",\n  email: \"bonfire@localhost\",\n};\n\nexport type PrototypeLifecycleRuntimeOptions = PrototypeCatalogOptions & {\n  remote?: string;\n  primaryBranch?: string;\n  commitIdentity?: GitCommitIdentity;\n  automaticBranchSwitch?: AutomaticBranchSwitchMode;\n  gitRepository?: GitRepository;\n};\n\nexport type PrototypeLifecycleRuntimeContext = ResolvedPrototypeCatalogPaths & {\n  repositoryRealPath: string;\n  remote: string;\n  primaryBranch: string;\n  automaticBranchSwitch: AutomaticBranchSwitchMode;\n  commitIdentity: Readonly<GitCommitIdentity>;\n  gitRepository: GitRepository;\n};\n\nfunction requireNonEmptyOption(value: string | undefined, option: string) {\n  if (value !== undefined && value.length === 0) {\n    throw new TypeError(`${option} must be a nonempty string`);\n  }\n  return value;\n}\n\nexport function createPrototypeLifecycleRuntime(\n  options: PrototypeLifecycleRuntimeOptions,\n): PrototypeLifecycleRuntimeContext {\n  const paths = resolvePrototypeCatalogPaths(options);\n  const repositoryRealPath = realpathSync(paths.repositoryRoot);\n  const remote =\n    requireNonEmptyOption(options.remote, \"remote\") ?? DEFAULT_REMOTE;\n  const primaryBranch =\n    requireNonEmptyOption(options.primaryBranch, \"primaryBranch\") ??\n    DEFAULT_PRIMARY_BRANCH;\n  const automaticBranchSwitch = options.automaticBranchSwitch ?? \"enabled\";\n  const commitIdentity = Object.freeze({\n    ...DEFAULT_COMMIT_IDENTITY,\n    ...options.commitIdentity,\n  });\n\n  return {\n    ...paths,\n    repositoryRealPath,\n    remote,\n    primaryBranch,\n    automaticBranchSwitch,\n    commitIdentity,\n    gitRepository:\n      options.gitRepository ??\n      createGitRepository({\n        repositoryRoot: paths.repositoryRoot,\n        commitIdentity,\n      }),\n  };\n}\n"]}
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/lifecycle/runtime-context.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EACnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,MAAM,gCAAgC,GAAG,uBAAuB,GAAG;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,qBAAqB,CAAC,EAAE,yBAAyB,CAAC;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,6BAA6B,GAAG;IAC7E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,yBAAyB,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC5C,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AASF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,gCAAgC,CA8BlC","sourcesContent":["import { realpathSync } from \"node:fs\";\nimport {\n  parseGitModeSetting,\n  type AutomaticBranchSwitchMode,\n  type GitMode,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n  resolvePrototypeCatalogPaths,\n  type PrototypeCatalogOptions,\n  type ResolvedPrototypeCatalogPaths,\n} from \"../prototype-paths.js\";\nimport {\n  createGitRepository,\n  type GitCommitIdentity,\n  type GitRepository,\n} from \"../git-repository.js\";\n\nconst DEFAULT_REMOTE = \"origin\";\nconst DEFAULT_PRIMARY_BRANCH = \"main\";\nconst DEFAULT_COMMIT_IDENTITY: GitCommitIdentity = {\n  name: \"Bonfire\",\n  email: \"bonfire@localhost\",\n};\n\nexport type PrototypeLifecycleRuntimeOptions = PrototypeCatalogOptions & {\n  remote?: string;\n  primaryBranch?: string;\n  commitIdentity?: GitCommitIdentity;\n  automaticBranchSwitch?: AutomaticBranchSwitchMode;\n  gitMode?: GitMode;\n  gitRepository?: GitRepository;\n};\n\nexport type PrototypeLifecycleRuntimeContext = ResolvedPrototypeCatalogPaths & {\n  repositoryRealPath: string;\n  remote: string;\n  primaryBranch: string;\n  automaticBranchSwitch: AutomaticBranchSwitchMode;\n  gitMode: GitMode;\n  commitIdentity: Readonly<GitCommitIdentity>;\n  gitRepository: GitRepository;\n};\n\nfunction requireNonEmptyOption(value: string | undefined, option: string) {\n  if (value !== undefined && value.length === 0) {\n    throw new TypeError(`${option} must be a nonempty string`);\n  }\n  return value;\n}\n\nexport function createPrototypeLifecycleRuntime(\n  options: PrototypeLifecycleRuntimeOptions,\n): PrototypeLifecycleRuntimeContext {\n  const paths = resolvePrototypeCatalogPaths(options);\n  const repositoryRealPath = realpathSync(paths.repositoryRoot);\n  const remote =\n    requireNonEmptyOption(options.remote, \"remote\") ?? DEFAULT_REMOTE;\n  const primaryBranch =\n    requireNonEmptyOption(options.primaryBranch, \"primaryBranch\") ??\n    DEFAULT_PRIMARY_BRANCH;\n  const automaticBranchSwitch = options.automaticBranchSwitch ?? \"enabled\";\n  const gitMode = parseGitModeSetting(options.gitMode);\n  const commitIdentity = Object.freeze({\n    ...DEFAULT_COMMIT_IDENTITY,\n    ...options.commitIdentity,\n  });\n\n  return {\n    ...paths,\n    repositoryRealPath,\n    remote,\n    primaryBranch,\n    automaticBranchSwitch,\n    gitMode,\n    commitIdentity,\n    gitRepository:\n      options.gitRepository ??\n      createGitRepository({\n        repositoryRoot: paths.repositoryRoot,\n        commitIdentity,\n      }),\n  };\n}\n"]}