Triage Workflows

After a failed CI gate, use CLI commands to identify what failed, inspect context, apply fixes, and verify outcomes.

1) Find problematic issues

certyn issues list \
  --project my-project \
  --activity attention \
  --severity critical \
  --status open

Get one issue:

certyn issues get --project my-project <issue-id>

2) Inspect related executions

certyn executions for-issue --project my-project <issue-id>
certyn executions get --project my-project <execution-id>
certyn executions notes --project my-project <execution-id>
certyn executions artifacts --project my-project <execution-id>
certyn executions testcases --project my-project <execution-id>

3) Inspect test quality

certyn tests overview --project my-project
certyn tests report --project my-project <testcase-id>
certyn tests flakiness --project my-project <testcase-id>
certyn tests flaky --project my-project --threshold 0.20

4) Apply issue / test updates

certyn issues update --project my-project <issue-id> --type bug --severity major --label checkout
certyn issues attach --project my-project <issue-id> --kind screenshot --file ./evidence.png
certyn issues verify --project my-project <issue-id> --decision passed --summary "Verified on staging"
certyn issues link-test --project my-project <issue-id> --testcase <testcase-id> --priority major

certyn tests update --project my-project <testcase-id> --needs-review
certyn tests tags set --project my-project <testcase-id> --tag smoke --tag checkout

5) Re-run and control execution

certyn issues retest --project my-project <issue-id>
certyn executions retry --project my-project <execution-id>
certyn executions stop --project my-project <execution-id>

executions retry/stop requires API keys with platform:manage scope.

Older docs may show tickets or testcases. The current command groups are issues and tests.

JSON mode

Use --json to integrate triage outputs into automation:

certyn issues list --project my-project --activity attention --json
certyn executions get --project my-project <execution-id> --json
certyn tests report --project my-project <testcase-id> --json