Dry-run and validation for mutating operations
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 461
- Forks
- 277
- Avg merge
- 16h 48m
- Merged PRs (30d)
- 95
Description
Summary
Agents should be able to preview the effect of mutating operations before executing them. A --dry-run flag on all mutating commands enables agents to validate actions and present them to users for confirmation.
Proposal
- Add
--dry-runflag to all mutating operations (create,delete,start) - Perform local validation before Kubernetes API calls
- Return would-be changes in structured JSON format
- Enable agents to preview actions before execution
Acceptance Criteria
-
--dry-runflag available on all mutating commands - Dry-run performs local validation and reports errors
- Output shows what would happen in structured JSON (when
--output jsonis used) - No actual Kubernetes API mutations occur during dry-run
Context
Part of #2849 — making tkn agent-friendly.
Note: Kubernetes already supports server-side dry-run (--dry-run=server). This may leverage that mechanism where applicable, but should also cover tkn-specific validation (e.g., parameter completeness for tkn pipeline start).
/kind feature
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the implementations and tests for the create, delete, and start commands, then trace how they validate inputs and call the Kubernetes API. Define the shared dry-run behavior and verify that local validation, structured JSON output, and zero mutating API calls meet the acceptance criteria.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go, kubernetes
- Domain
- cli, devops
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100