cache-apt-pkgs-action/scripts/dev/hotfix_pr.mts

#!/usr/bin/env -S node --experimental-strip-types

import process from "node:process";
import { defineCommand } from "@robingenz/zli";
import { z } from "zod";
import {
  createCliConfig,
  ROOT_DIR,
  confirmPrompt,
  fail,
  logInfo,
  logSuccess,
  runCli,
  runMain,
  run,
  runCaptureOutput,
  tryRun,
} from "../devopslib.mts";

type BranchName = string;

function branchExistsOnOrigin(branch: BranchName): boolean {
  return tryRun(
    "git",
    ["ls-remote", "--exit-code", "--heads", "origin", branch],
    { cwd: ROOT_DIR },
  ).ok;
}

function createOrCheckoutBranch(
  issueId: string,
  checkoutBranch: BranchName,
  baseBranch: BranchName,
): void {
  if (branchExistsOnOrigin(checkoutBranch)) {
    logInfo(
      `Branch ${checkoutBranch} exists. Checking out and merging ${baseBranch}...`,
    );
    run("git", ["checkout", checkoutBranch], { cwd: ROOT_DIR });
    run("git", ["pull", "origin", checkoutBranch], { cwd: ROOT_DIR });
    run("git", ["merge", baseBranch], { cwd: ROOT_DIR });
  } else {
    logInfo(`Creating hotfix branch for issue ${issueId}...`);
    run("git", ["checkout", baseBranch], { cwd: ROOT_DIR });
    run("git", ["checkout", "-b", checkoutBranch], { cwd: ROOT_DIR });
    run("git", ["merge", baseBranch], { cwd: ROOT_DIR });
  }
}

function commitIfNeeded(message: string): void {
  run("git", ["add", "."], { cwd: ROOT_DIR });
  const commit = tryRun("git", ["commit", "-m", message], { cwd: ROOT_DIR });
  if (commit.ok) {
    return;
  }

  const combined = `${commit.stdout}\n${commit.stderr}`;
  if (/nothing to commit|no changes added to commit/i.test(combined)) {
    logSuccess("No local changes to commit.");
    return;
  }

  process.stderr.write(commit.stderr);
  process.exit(commit.status ?? 1);
}

function pushChanges(
  issueId: string,
  fixType: string,
  syncBranch: BranchName,
  syncBase: BranchName,
): void {
  const message = `${fixType}: resolve critical production issue in #${issueId}`;
  commitIfNeeded(message);

  const prUrl = runCaptureOutput(
    "gh",
    [
      "pr",
      "list",
      "--head",
      syncBranch,
      "--base",
      syncBase,
      "--state",
      "open",
      "--json",
      "url",
      "--jq",
      ".[0].url",
    ],
    { cwd: ROOT_DIR },
  );

  if (prUrl) {
    logSuccess(`PR already exists: ${prUrl}`);
  } else {
    logInfo("No PR found. Creating new PR...");
    run(
      "gh",
      [
        "pr",
        "create",
        "--head",
        syncBranch,
        "--base",
        syncBase,
        "--title",
        message,
      ],
      { cwd: ROOT_DIR },
    );
  }

  logInfo(`Pushing changes from ${syncBase} to ${syncBranch}...`);
  run("git", ["push", "origin", syncBranch], { cwd: ROOT_DIR });
}

const hotfixCommand = defineCommand({
  description: "Create or update hotfix and sync branches for an issue",
  args: z.tuple([
    z.string().describe("Issue ID"),
    z.string().describe("Target branch"),
  ]),
  action: async (_options, args) => {
    const [issueId, base] = args;

    if (!/^\d+$/.test(issueId)) {
      fail("Issue ID must be an integer.");
    }

    const branchSuffix = `issue-${issueId}`;
    const hotfixBranch = `hotfix/${branchSuffix}`;

    createOrCheckoutBranch(issueId, hotfixBranch, base);

    await confirmPrompt(
      "Edit files and confirm to continue. This can always be rerun to pickup where you left off. Continue?",
    );

    pushChanges(issueId, "fix", hotfixBranch, base);

    const syncBranch = `sync/staging-${branchSuffix}`;
    createOrCheckoutBranch(issueId, syncBranch, hotfixBranch);
    pushChanges(issueId, "sync", syncBranch, "staging");
  },
});

const cliConfig = createCliConfig({
  importMetaUrl: import.meta.url,
  description: "Create or update hotfix and sync branches for an issue",
  commands: {
    run: hotfixCommand,
  },
  defaultCommand: hotfixCommand,
});

async function main(): Promise<void> {
  await runCli(cliConfig);
}

await runMain(main);