whiteducksoftware / whiteducksoftware/flock

[1.0] Explain why a subscription is waiting or did not trigger

Open
#448 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

Scheduling decisions often end in a continue without an operator-facing reason. Users cannot easily distinguish missing inputs, rejected predicates, capacity waits or component vetoes.

Scope

  • Expose a small diagnostic view of existing scheduler decisions for a selected artifact/subscription/run.
  • Report applicable reasons from the real decision path, including missing AND input and rejected predicates, without rebuilding matching logic.
  • Make the result usable through the API and dashboard and filter details by the reader's permissions.

Acceptance criteria

  • A waiting AND gate and rejected predicate are explainable without log searches or model calls.
  • Capacity waits and blocked decisions agree with the scheduler's actual state.
  • Unauthorized readers learn no protected artifact existence, values or counts from explanations.

Boundaries

No general workflow debugger, replay engine or second scheduler.

References

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

Start with src/flock/orchestrator/scheduler.py, src/flock/orchestrator/artifact_collector.py, and src/flock/core/subscription.py, tracing how waiting, rejected, capacity, and veto decisions are represented. Review dependencies #440 and #441 before defining the diagnostic view. Done means explanations work through the API and dashboard while respecting reader permissions and matching the scheduler's actual state.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, authorization, backend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.