whiteducksoftware / whiteducksoftware/flock

⏯️ [FEATURE] [1.0] Workflow Lifecycle Controls

Open
#294 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Python
Stars
120
Forks
14
Avg merge
19h 32m
Merged PRs (30d)
8

Description

Is your feature request related to a problem?

Once a workflow is running there is no official way to pause, resume, or cancel it via REST. Operators need to intervene when downstream systems detect problems or when long-running cascades should be aborted. Manual intervention (e.g., restarting the service) is risky and imprecise.

Describe the solution you want to see
  • Provide lifecycle endpoints (e.g., POST /api/v1/workflows/{correlation_id}/cancel, /pause, /resume) that manipulate pending tasks for a given correlation ID.
  • Surface status transitions and reasons (cancelled by user, paused for approval, auto-resumed) in the status endpoint and traces.
  • Respect visibility/auth constraints so only authorized roles can control workflows.
  • Ensure cancellation propagates cleanly: running agents are interrupted where possible, pending tasks are dropped, and affected artifacts are marked accordingly.
Describe alternatives you have considered

Today operators rely on ad-hoc flags or manual data edits, which are error-prone and lack audit trails.

Additional context

Target for 1.0 so it launches alongside advanced auth (#280) and persistence enhancements. Lifecycle control should integrate with human-in-the-loop and approval flows to give a full operational story.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names no files, tests, or entry points; begin by locating the existing REST workflow and status endpoints, task persistence, and trace handling. Review the authentication work in #280 and the human-in-the-loop and approval paths. Done requires an agreed lifecycle design covering authorization, status and audit details, cancellation propagation, and affected artifacts.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, authentication, backend-api-design, distributed-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.