Function main

actions/setup/js/create_pull_request.cjs:612–2583

* Main handler factory for create_pull_request * Returns a message handler function that processes individual create_pull_request messages * @type {HandlerFactoryFunction}

(config = {})

 * @type {HandlerFactoryFunction}
 */
async function main(config = {}) {
  // Extract configuration
  const rawBranchPrefix = config.branch_prefix || "";
  const normalizedBranchPrefix = normalizeBranchName(rawBranchPrefix);
  if (rawBranchPrefix && normalizedBranchPrefix !== rawBranchPrefix) {
    const branchPrefixWarning = [
      `Branch prefix "${rawBranchPrefix}" contains characters that are invalid in a git ref.`,
      `Using normalized prefix: "${normalizedBranchPrefix}".`,
      "Update branch-prefix in the workflow configuration to avoid this warning.",
    ].join(" ");
    core.warning(branchPrefixWarning);
  }
  const branchPrefix = normalizedBranchPrefix;
  const titlePrefix = config.title_prefix || "";
  const envLabels = parseStringListConfig(config.labels);
  const configFallbackLabels = parseStringListConfig(config.fallback_labels);
  const configReviewers = parseStringListConfig(config.reviewers);
  const configTeamReviewers = parseStringListConfig(config.team_reviewers);
  const rawAssignees = parseStringListConfig(config.assignees);
  const hasCopilotInAssignees = rawAssignees.some(a => a.toLowerCase() === "copilot");
  const configAssignees = sanitizeFallbackAssignees(rawAssignees);
  const draftDefault = parseBoolTemplatable(config.draft, true);
  const ifNoChanges = config.if_no_changes || "warn";
  const allowEmpty = parseBoolTemplatable(config.allow_empty, false);
  const autoMerge = parseBoolTemplatable(config.auto_merge, false);
  const preserveBranchName = config.preserve_branch_name === true;
  const recreateRef = config.recreate_ref === true;
  const signedCommits = config.signed_commits !== false;
  const expiresHours = config.expires ? parseInt(String(config.expires), 10) : 0;
  const maxCount = config.max || 1; // PRs are typically limited to 1
  const maxSizeKb = parsePositiveInteger(config.max_patch_size) ?? 4096;
  const maxFiles = parsePositiveInteger(config.max_patch_files) ?? MAX_FILES;
  const { defaultTargetRepo, allowedRepos } = resolveTargetRepoConfig(config);
  const allowedBaseBranches = parseAllowedBaseBranches(config.allowed_base_branches);
  const githubClient = await createAuthenticatedGitHubClient(config);
  let allowedMentionAliases = [];
  if (Array.isArray(config.allowedMentionAliases)) {
    allowedMentionAliases = config.allowedMentionAliases;
  } else if (config.mentions != null) {
    allowedMentionAliases = await resolveAllowedMentionsFromPayload(context, githubClient, core, config.mentions);
  }

  // Check if copilot assignment is enabled for fallback issues
  const assignCopilot = process.env.GH_AW_ASSIGN_COPILOT === "true";

  // Lazily-initialised client for copilot assignment (only allocated when needed).
  // Uses GH_AW_ASSIGN_TO_AGENT_TOKEN (agent token preference chain) when available,
  // otherwise falls back to the step-level github object.
  /** @type {Object|null} */
  let copilotClient = null;

  /**
   * Assigns copilot to a fallback issue using agent helpers, if copilot was requested
   * in the assignees config and the GH_AW_ASSIGN_COPILOT env var is set.
   * A no-op when either condition is false. The copilotClient is initialised lazily
   * on the first call and reused for subsequent issues.
   * @param {string} owner - Repository owner
   * @param {string} repo - Repository name