WIP ✨ Added Delete API and implemented a unified interface across all commands and plugin options

[camilamacedo86]

Add comprehensive delete functionality to remove APIs and webhooks from projects. Users can now clean up scaffolded resources with automatic code removal, proper validation, and complete state restoration.

What's New

Users can now delete scaffolded APIs and webhooks from their projects:

# Delete APIs
kubebuilder delete api --group crew --version v1 --kind Captain

# Delete webhooks (all types or specific types)
kubebuilder delete webhook --group crew --version v1 --kind Captain
kubebuilder delete webhook --group crew --version v1 --kind Captain --defaulting

# Delete optional plugin features
kubebuilder delete --plugins=helm/v2-alpha
kubebuilder delete --plugins=grafana/v1-alpha
kubebuilder delete --plugins=autoupdate/v1-alpha

Key Features

Automatic Code Removal

Delete commands automatically remove marker-inserted code from cmd/main.go and test files:

• Removes API/webhook imports
• Removes AddToScheme calls
• Removes controller/webhook setup blocks
• Updates PROJECT file

Graceful Error Handling

If automatic removal fails:

• Shows clear warnings (doesn't fail the operation)
• Provides manual cleanup instructions
• References code fragment constants for easy lookup

Closes

#907

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: camilamacedo86

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [camilamacedo86]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[Copilot]

Pull request overview

Copilot reviewed 51 out of 52 changed files in this pull request and generated 5 comments.

[Copilot]

Pull request overview

Copilot reviewed 54 out of 55 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 54 out of 55 changed files in this pull request and generated 3 comments.

[Copilot]

Commenting out the patches: header can leave existing patch list items (e.g., the default - path: manager_metrics_patch.yaml) at the top level, which makes config/default/kustomization.yaml invalid YAML. Instead of commenting out the section header, remove/comment only the webhook-specific patch entries (e.g., manager_webhook_patch.yaml) and keep the patches: key intact when other patches remain.

Suggested change

	// Comment out patches section header (best effort)
	if err := util.CommentCode(kustomizeFilePath, "patches:", "#"); err != nil {
	log.Warn("Unable to comment out 'patches:' section",
	"file", kustomizeFilePath, "error", err)
	}
	// Comment out manager webhook patch
	// Keep the patches: section header intact so any non-webhook patches remain valid YAML.
	// Comment out only the webhook-specific patch entry.

[Copilot]

In delete mode, outputDir := p.outputDir will almost always be the flag default ("dist"), so the deletion path won't honor a previously configured non-default output dir stored in the plugin config (e.g. chart generated under --output-dir=charts). This can leave the real chart directory behind when users run kubebuilder delete --plugins=helm/v2-alpha. Consider deriving the delete target from the decoded plugin config first (with fallback to the flag only when explicitly set), so deletion removes the same output dir that was created.

[Copilot]

getInfoFromFlags now has delete-specific behavior (detecting delete via positional args and appending user --plugins to the PROJECT layout plugin chain). There are unit tests for getInfoFromFlags, but none appear to cover this delete-path merge/dedup logic; adding coverage would help prevent regressions (e.g., ensuring kubebuilder delete api --plugins=deploy-image/v1-alpha retains layout plugins while adding deploy-image).

Suggested change

	// Extract the command name from positional args (after flags are parsed).
	isDeleteCommand := c.isDeleteCommand(fs.Args())
	// Prefer parsed positional args, but fall back to the original process args
	// because subcommand names like "delete" may not be present in fs.Args()
	// after Cobra/pflag parsing.
	isDeleteCommand := c.isDeleteCommand(fs.Args())
	if !isDeleteCommand && len(os.Args) > 1 {
	isDeleteCommand = c.isDeleteCommand(os.Args[1:])
	}

[k8s-ci-robot]

@camilamacedo86: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
pull-kubebuilder-test	3b8de56	link	true	/test pull-kubebuilder-test

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.