c8volt ops purge orphan-process-instances

Purpose

Orphan child process instances are hard to delete safely by hand. c8volt ops purge orphan-process-instances discovers children whose parents are missing, freezes their keys, then runs the shared process-instance delete preview or execution.

In Action

Use When

• orphan child process instances should be found and removed
• deletion must stay limited to the frozen orphan set
• a cleanup report is needed for operators or agents

Basic Usage

c8volt ops purge orphan-process-instances --dry-run

Generated reference: ops purge orphan-process-instances.

Best Variants

c8volt ops purge orphan-process-instances --state completed --limit 25 --dry-run
c8volt ops purge orphan-process-instances --state completed --limit 25 --report-file orphan-purge.md

Built From Lower-Level Commands

c8volt get process-instance --orphan-children-only --keys-only
c8volt delete process-instance -

Generated references: get process-instance, delete process-instance.

Output And Safety

--dry-run reports orphan candidates and the delete plan without mutation. Real execution deletes only after confirmation unless automation controls are used. Process-instance delete safety, waiting, report format, worker controls, and fail-fast behavior follow the underlying delete workflow.