Function commitWith

packages/computer/src/git/commit.ts:79–126

(opts: CommitWithDeps)

}

export async function commitWith(opts: CommitWithDeps): Promise<CommitResult> {
  const dir = opts.dir ?? "/";
  if (!opts.message || opts.message.trim().length === 0) {
    throw new GitError("EMSG", "commit message is required");
  }

  // Read the local config identity once; it sits between env and
  // the GitClient default in precedence. A missing key resolves
  // to undefined, so the fallback chain skips it cleanly.
  const configName = await readConfigString(opts, dir, "user.name");
  const configEmail = await readConfigString(opts, dir, "user.email");
  const configIdent =
    configName && configEmail ? { name: configName, email: configEmail } : undefined;

  const author = resolveIdent(
    opts.author,
    opts.env?.GIT_AUTHOR_NAME,
    opts.env?.GIT_AUTHOR_EMAIL,
    configIdent,
    opts.defaultIdentity,
  );
  if (!author) throw new MissingIdentityError();
  const committer =
    resolveIdent(
      opts.committer,
      opts.env?.GIT_COMMITTER_NAME ?? opts.env?.GIT_AUTHOR_NAME,
      opts.env?.GIT_COMMITTER_EMAIL ?? opts.env?.GIT_AUTHOR_EMAIL,
      configIdent,
      opts.defaultIdentity,
    ) ?? author;

  let oid: string;
  try {
    oid = await opts.git.commit({
      fs: opts.fs,
      dir,
      message: opts.message,
      author,
      committer,
      amend: opts.amend,
      cache: opts.cache,
    });
  } catch (cause) {
    if (isNotARepositoryCause(cause)) throw new NotARepositoryError(dir, { cause });
    throw new GitError("ECOMMITFAIL", `git commit failed: ${errorMessage(cause)}`, { cause });
  }
  return { oid };
}

function resolveIdent(
  explicit: { name: string; email: string } | undefined,