(alpha update): Add command to generate AI info

Author: camilamacedo86

pkg/cli/alpha/internal/update/update.go

@@ -77,6 +77,8 @@ type Update struct {
 	// CLI (`gh`) to be installed and authenticated in the local environment.
 	OpenGhIssue bool
 
+	UseGhModels string
+
 	// GitConfig holds per-invocation Git settings applied to every `git` command via
 	// `git -c key=value`.
 	//
@@ -271,6 +273,49 @@ func (opts *Update) Update() error {
 	return nil
 }
 
+// isGeneratedKB returns true for Kubebuilder-generated artifacts.
+func isGeneratedKB(path string) bool {
+	return strings.Contains(path, "/zz_generated.") ||
+		strings.HasPrefix(path, "config/crd/bases/") ||
+		strings.HasSuffix(path, "/bindata.go")
+}
+
+// listConflictFiles finds files that contain conflict markers and
+// returns them split into SOURCE vs GENERATED.
+func listConflictFiles() (src []string, gen []string) {
+	out, _ := exec.Command("sh", "-c", `git grep -nE '^(<<<<<<< |>>>>>>> |=======$)' || true`).Output()
+	seen := map[string]bool{}
+	lines := strings.Split(string(out), "\n")
+	for _, ln := range lines {
+		if ln == "" {
+			continue
+		}
+		// path:line:rest...
+		parts := strings.SplitN(ln, ":", 2)
+		if len(parts) == 0 {
+			continue
+		}
+		path := strings.TrimSpace(parts[0])
+		if path == "" || seen[path] {
+			continue
+		}
+		seen[path] = true
+		if isGeneratedKB(path) {
+			gen = append(gen, path)
+		} else {
+			src = append(src, path)
+		}
+	}
+	return
+}
+
+func bulletList(items []string) string {
+	if len(items) == 0 {
+		return "<none>"
+	}
+	return "- " + strings.Join(items, "\n- ")
+}
+
 func (opts *Update) openGitHubIssue(hasConflicts bool) error {
 	log.Info("Creating GitHub Issue to track the need to update the project")
 	out := opts.getOutputBranchName()
@@ -314,6 +359,56 @@ func (opts *Update) openGitHubIssue(hasConflicts bool) error {
 		)
 	}
 
+	if hasConflicts && len(opts.UseGhModels) > 0 {
+		srcFiles, genFiles := listConflictFiles()
+		releaseURL := fmt.Sprintf("https://github.com/kubernetes-sigs/kubebuilder/releases/tag/%s", opts.ToVersion)
+
+		var ctx strings.Builder
+		ctx.WriteString("PROJECT: Created with Kubebuilder\n")
+		fmt.Fprintf(&ctx, "Upgrade: from %s to %s\n", opts.FromVersion, opts.ToVersion)
+		fmt.Fprintf(&ctx, "Release notes: %s\n\n", releaseURL)
+		ctx.WriteString(`RULES (concise):
+- [GENERATED] api/**/zz_generated.*.go → this one you solve by running: make generate
+- [GENERATED] config/crd/bases/*.yaml → fix types in api/*_types.go, then run: make manifests
+- After regeneration run: make fmt vet lint-fix
+- [SOURCE] (api/*_types.go, controllers/*, webhooks/*): keep local fields/markers; adopt new scaffold markers/tags; fix imports/API changes.
+- Never hand-edit generated files; resolve in sources then regenerate.
+OUTPUT: Short bullet list of recommendations grouped by file, then the final command sequence.
+` + "\n")
+
+		fmt.Fprintf(&ctx, "\nConflicted [SOURCE] files:\n%s\n", bulletList(srcFiles))
+		fmt.Fprintf(&ctx, "\nConflicted [GENERATED] files:\n%s\n", bulletList(genFiles))
+
+		prompt := `You are a senior Go/K8s engineer which is upgrading a project build with Kubebulder. Using the stdin context (Kubebuilder rules, versions, conflicted files):
+- For each [GENERATED] file: say "this one you solve by running make generate" (zz_generated) or "fix types then make manifests" (CRDs).
+- For [SOURCE]: give 1–3 specific keep/edit/remove steps.
+- End with: make manifests generate fmt vet lint-fix (and suggest make install if CRDs/webhooks changed).
+- Add: "To know more about this change see the release notes: <link>". Keep it concise.
+- Use a friendly, professional tone. 
+- Output in markdown format
+- Do not mention the number of files, only list them.
+- Do not add info that is not helpful and keep it short
+- For go mod changes, suggested the upper versions and recommend: "run go mod tidy"`
+
+		// 3) Call the model with stdin context
+		var summary string
+		modelCmd := exec.Command("gh", "models", "run", "openai/gpt-4o", prompt)
+		modelCmd.Stdin = strings.NewReader(ctx.String())
+		modelOut, err := modelCmd.CombinedOutput()
+		if err != nil {
+			log.Warn("gh models run failed", "error", err, "output", string(modelOut))
+		} else {
+			summary = strings.TrimSpace(string(modelOut))
+		}
+
+		// 4) Append AI summary to the issue body
+		if len(summary) > 0 {
+			body += "\n\n## TL'DR: (AI-generate) Conflicts Resolution:\n\n" + summary + "\n"
+		} else {
+			log.Warn("gh models run failed", "output", string(modelOut))
+		}
+	}
+
 	issueCmd := exec.Command("gh", "issue", "create",
 		"--title", title,
 		"--body", body,

pkg/cli/alpha/internal/update/validate.go

@@ -57,9 +57,23 @@ func (opts *Update) Validate() error {
 		}
 	}
 
+	if len(opts.UseGhModels) > 0 && !isGhModelsExtensionInstalled() {
+		return fmt.Errorf("gh-models extension is not installed. To install the extension, run: " +
+			"gh extension install https://github.com/github/gh-models")
+	}
+
 	return nil
 }
 
+// isGhModelsExtensionInstalled checks if the gh-models extension is installed
+func isGhModelsExtensionInstalled() bool {
+	cmd := exec.Command("gh", "extension", "list")
+	if _, err := cmd.Output(); err != nil {
+		return false
+	}
+	return true
+}
+
 // validateGitRepo verifies if the current directory is a valid Git repository and checks for uncommitted changes.
 func (opts *Update) validateGitRepo() error {
 	log.Info("Checking if is a git repository")

pkg/cli/alpha/update.go

@@ -145,6 +145,8 @@ Defaults:
 		"Push the output branch to the remote repository after the update.")
 	updateCmd.Flags().BoolVar(&opts.OpenGhIssue, "open-gh-issue", false,
 		"Create a GitHub issue with a pre-filled checklist and compare link after the update completes (requires `gh`).")
+	updateCmd.Flags().BoolVar(&opts.UseGhModels, "--use-gh-models", false,
+		"Create a GitHub issue with a pre-filled checklist and compare link after the update completes (requires `gh`).")
 	updateCmd.Flags().StringArrayVar(
 		&gitCfg,
 		"git-config",