kusaw candidates

List a run's best-of-N candidates, including compare-only stages

Usage

Text

kusaw candidates <run> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--diff`		string		Print the candidate's diff against the fork point (c or label)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for candidates
`--json`		bool	false	Print JSON
`--scorecard`		bool	false	Print the attempt scorecard

Delete kept candidate refs for a run

Text

kusaw candidates dismiss <run> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for dismiss

Example:

Text

kusaw candidates dismiss demo

Replace the gathered winner while the run waits at a gate

Text

kusaw candidates pick <run> <candidate> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for pick
`--note`		string		Note stored with the pick

Example:

Text

kusaw candidates pick demo c2 --note "prefer the smaller diff"

Dismiss kept candidate refs on old runs

Text

kusaw candidates prune [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for prune
`--older-than`		string	30d	Dismiss refs on runs finished longer ago than this (for example 30d)

Example:

Text

kusaw candidates prune --older-than 30d

Code	Name	Description
0	ok	Success.
1	error	Runtime error.
2	usage	Usage or validation error.
3	rejected	Control request rejected; the error string is printed verbatim.
4	not picked up	Control request not picked up within the wait time while serve runs.

Text

kusaw candidates demo --json