Add --delete-propagation-policy and --delete-timeout flags to kpt live destroy

[aravindtga]

Description

• Add --delete-propagation-policy and --delete-timeout flags to kpt live destroy, bringing it to parity with kpt live apply which already has --prune-propagation-policy and --prune-timeout.
• The underlying cli-utils DestroyerOptions has supported DeletePropagationPolicy and DeleteTimeout since Refactor destroyer to use tasks kubernetes-sigs/cli-utils#366, but kpt was not exposing them as CLI flags.
  • --delete-propagation-policy: Controls how dependents are handled during deletion (Background, Foreground, Orphan). Default: Background.
  • --delete-timeout: How long to wait for resources to be fully deleted. Default: 0 (wait indefinitely).

Fixes #1461

Type of Change

• Bug fix
• Tests
• Documentation

Checklist

• Code follows project style guidelines
• Self-reviewed changes
• Tests added/updated
• Documentation added/updated
• All tests and gating checks pass

AI Disclosure

• I have used AI in the creation of this PR.

If so, please describe how:

• Kiro to investigate the issue, verify upstream support in cli-utils, generate unit tests and generate PR message.

[netlify]

✅ Deploy Preview for kptdocs ready!

Name	Link
🔨 Latest commit	72bb6fd
🔍 Latest deploy log	https://app.netlify.com/projects/kptdocs/deploys/6a6b0cd566d91d00087872e4
😎 Deploy Preview	https://deploy-preview-4665--kptdocs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Copilot]

🟡 Not ready to approve

The current invalid-value error path for --delete-propagation-policy returns a confusing message referencing “prune propagation policy,” which should be corrected to match the destroy flag.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

This review doesn't count toward merge requirements. Sign up for the private preview to control whether Copilot approvals count.

Pull request overview

This PR exposes cli-utils destroy deletion controls through kpt live destroy, adding user-facing flags for deletion propagation policy and deletion timeout, and updates docs/tests accordingly to match the new CLI surface.

Changes:

• Add --delete-propagation-policy and --delete-timeout flags to kpt live destroy and wire them into apply.DestroyerOptions.
• Update generated/live docs and reference docs to document the new flags.
• Extend destroy command unit tests to cover flag validation and parsing for the new flags.

File summaries

File	Description
internal/docs/generated/livedocs/docs.go	Adds generated help text entries for the new destroy flags.
documentation/content/en/reference/cli/live/destroy/_index.md	Updates CLI reference docs to include the new destroy flags.
commands/live/destroy/cmddestroy.go	Introduces new CLI flags, parses them, and passes values into destroy options.
commands/live/destroy/cmddestroy_test.go	Adds/updates tests to validate new flag parsing and invalid-value handling.

Review details

• Files reviewed: 3/4 changed files
• Comments generated: 1
• Review effort level: Low

We're testing this review assessment. Please use 👍 or 👎 to tell us if it's correct.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud