c8volt ops purge process-instances-with-incidents

Purpose

Incident cleanup often begins with incident filters, not process-instance keys. c8volt ops purge process-instances-with-incidents discovers matching incidents, freezes the affected process-instance keys, then runs deterministic family-scope delete planning.

In Action

Use When

• incident filters should define the purge candidate set
• deletion must still use normal process-instance family safety
• an operator or agent needs a stable report of selected incidents and deleted instances

Basic Usage

c8volt ops purge process-instances-with-incidents --state active --error-type io_mapping_error --dry-run

Generated reference: ops purge process-instances-with-incidents.

Best Variants

c8volt ops purge process-instances-with-incidents --inc-key <incident-key> --dry-run
c8volt ops purge process-instances-with-incidents --state active --error-type io_mapping_error --limit 5 --force --report-file incident-purge.md

Built From Lower-Level Commands

c8volt get incident --state active --error-type io_mapping_error --pi-keys-only
c8volt delete process-instance -

Generated references: get incident, delete process-instance.

Output And Safety

--dry-run reports the discovered incidents, frozen process-instance keys, and delete plan without mutation. Real execution requires confirmation unless automation controls are used. Incident matching is discovery only; deletion still follows the same process-instance family rules as delete process-instance.