whiteducksoftware / whiteducksoftware/flock
[1.0] Explain why a subscription is waiting or did not trigger
Nobody has claimed this yet.
- 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
- Implementation dependencies: #440, #441.
- src/flock/orchestrator/scheduler.py
- src/flock/orchestrator/artifact_collector.py
- src/flock/core/subscription.py
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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