Function createIssueForUpgradeOrgRepo

pkg/cli/upgrade_org.go:323–357

createIssueForUpgradeOrgRepo opens a GitHub issue in the target repository to notify maintainers that agentic workflow upgrades are available. Any previously-open issues carrying the gh-aw-upgrade XML marker are closed first so that only the most recent notification remains.

(ctx context.Context, repo string, verbose bool)

// previously-open issues carrying the gh-aw-upgrade XML marker are closed first
// so that only the most recent notification remains.
func createIssueForUpgradeOrgRepo(ctx context.Context, repo string, verbose bool) error {
	title := "[aw] Upgrade available"

	releaseTag, releaseURL := getGhawReleaseInfo()
	xmlMarker := buildOrgXMLMarker(ghawUpgradeMarkerPrefix, releaseTag)

	// Close stale upgrade issues before creating the new one.
	closeExistingOrgIssuesByMarker(ctx, repo, ghawUpgradeMarkerPrefix, verbose)

	var releaseSection string
	if releaseURL != "" {
		releaseSection = fmt.Sprintf("\n[View gh-aw release %s](%s)\n", releaseTag, releaseURL)
	}

	body := "Agentic workflow files detected in this repository may have upgrades available.\n\n" +
		"Run `gh aw upgrade` to apply the latest codemods, update GitHub Actions versions, and recompile all workflows.\n\n" +
		"Review the upgrade output and any generated changes before committing to ensure there are no unexpected modifications.\n" +
		releaseSection + "\n" +
		"### How to execute\n\n" +
		"- **Assign to agent**: Assign this issue to Copilot to automatically apply the upgrade\n" +
		"- **Via @copilot comment**: Add a comment `@copilot upgrade agentic workflows` on this issue\n" +
		"- **Via CLI**: Run `gh aw upgrade` in your local checkout\n\n" +
		xmlMarker + "\n"

	if verbose {
		fmt.Fprintln(os.Stderr, console.FormatVerboseMessage("Creating upgrade issue in "+repo+"..."))
	}

	if err := createOrgIssue(ctx, repo, title, body, agenticWorkflowsLabel); err != nil {
		return fmt.Errorf("failed to create issue in %s: %w", repo, err)
	}

	fmt.Fprintln(os.Stderr, console.FormatSuccessMessage("Created issue in "+repo))
	return nil
}