C8 Ops Use-Case Discussions
The c8volt use-case board is the GitHub discussion space where C8 Ops CLI workflows are shaped before, during, and after implementation.
Implemented operational workflows now live in the C8 Ops CLI playbooks. This page remains the idea board for accepted, upcoming, and superseded workflow concepts.
Discussion Links
Mitigate stuck jobs status: accepted
Accepted workflow for mitigating silent, unclaimed Camunda jobs by discovering a frozen candidate set, previewing the plan, and failing confirmed jobs with retries set to 0 and an operator diagnostic message. The workflow is intended for misconfiguration cases such as a service task using a job type that no worker will claim; implementation is tracked in #232.
Repair commands status: implemented
High-level repair workflows for operator-safe remediation. The implemented c8volt ops repair incident and c8volt ops repair process-instance flows freeze repair targets, optionally update process-instance variables once per scope, apply related-job retry/timeout repair where applicable, resolve incidents, confirm clearance unless --no-wait is set, and write a final report that shows what was selected, attempted, skipped, and changed.
Orphan cleanup status: implemented
Automated cleanup for orphan child process instances. The implemented c8volt ops purge orphan-process-instances flow selects candidates with orphan-child discovery, freezes those keys, then reuses existing process-instance delete planning for root traversal, affected-scope validation, dry-run reporting, --auto-confirm, and --automation.
Retention policy status: implemented
Home-grown retention cleanup for completed process instances older than a configured number of days. The implemented c8volt ops execute retention-policy flow derives the end-date boundary, discovers candidate process instances, skips candidates whose roots are not final, and deletes final-root scopes through the existing process-instance delete service.
Smoke test status: implemented
Operational smoke test for proving a c8volt-to-Camunda environment is usable end to end. The implemented c8volt ops execute smoke-test flow checks topology where available, deploys the version-matched embedded multiple-subprocess fixture, starts one or more instances, walks each created family, and cleans up unless --no-cleanup is set.
Purge all selected process definitions status: implemented
Process-definition cleanup for selected versions. The implemented c8volt ops purge all-process-definitions flow discovers candidate process definitions with get pd-style filters, previews process-instance impact, blocks active-instance impact unless --force is supplied, and deletes selected definitions through the existing process-definition deletion service.
Purge process instances selected by incidents status: implemented
Incident-driven cleanup for process-instance families. The implemented c8volt ops purge process-instances-with-incidents flow discovers candidate incidents, freezes candidate process-instance keys, deduplicates them, builds the shared process-instance delete plan, and deletes resolved roots after confirmation.
Status guide
status: idea Early concept, open for exploration.
status: shaping Being refined before implementation.
status: accepted Agreed direction, ready for issue/spec work.
status: superseded Replaced by newer discussion or issue.
status: implemented Delivered in the codebase.