Scaled-Tech-Consulting/Gitea-Tools
2
0
Fork 0
Code Issues 73 Pull Requests 9 Actions Packages Projects Releases Wiki Activity

Add MCP menu/dashboard view for live queue, leases, blockers, and next safe action #605

New Issue
Open
opened 2026-07-09 16:07:23 -05:00 by jcwalker3 · 1 comment
jcwalker3 commented 2026-07-09 16:07:23 -05:00
Owner
Copy Link
Copy Source

Context

Part of the LLM coordination failure series (sessions stepping on each other). This is a focused implementation issue, not an umbrella.

Related siblings: #600 (allocator), #601 (leases), #602 (terminal path), #603 (lifecycle labels), #604 (anti-stomp preflight).

Problem

The system needs a clear operational view so humans and LLMs can see what is safe to work on without reconstructing state from comments.

Required behavior

Add an MCP menu/dashboard command showing:

  • open PR queue
  • open issue queue
  • active leases by role
  • terminal review lock state
  • blocked items and reasons
  • stale/expired leases
  • merge-ready PRs
  • review-ready PRs
  • discussion issues
  • controller-needed items
  • next safe action

Acceptance criteria

  1. Dashboard shows enough state to prevent duplicate work.
  2. Dashboard output is machine-readable and human-readable.
  3. It includes exact prompts for next safe author/reviewer/merger/controller action.
  4. It never suggests blocked work as safe.
  5. Tests cover current PR #593/#592/#587-style terminal-blocked queue.

Implementation notes

  • Prefer extending existing MCP menu surface (mcp-menu, discoverability docs) rather than a second parallel UI.
  • Dashboard is read-only; assignment still goes through the allocator (#600).
  • Never present blocked/terminal-locked items as safe next work.
## Context Part of the LLM coordination failure series (sessions stepping on each other). This is a focused implementation issue, not an umbrella. Related siblings: #600 (allocator), #601 (leases), #602 (terminal path), #603 (lifecycle labels), #604 (anti-stomp preflight). ## Problem The system needs a clear operational view so humans and LLMs can see what is safe to work on without reconstructing state from comments. ## Required behavior Add an MCP menu/dashboard command showing: * open PR queue * open issue queue * active leases by role * terminal review lock state * blocked items and reasons * stale/expired leases * merge-ready PRs * review-ready PRs * discussion issues * controller-needed items * next safe action ## Acceptance criteria 1. Dashboard shows enough state to prevent duplicate work. 2. Dashboard output is machine-readable and human-readable. 3. It includes exact prompts for next safe author/reviewer/merger/controller action. 4. It never suggests blocked work as safe. 5. Tests cover current PR #593/#592/#587-style terminal-blocked queue. ## Implementation notes * Prefer extending existing MCP menu surface (`mcp-menu`, discoverability docs) rather than a second parallel UI. * Dashboard is read-only; assignment still goes through the allocator (#600). * Never present blocked/terminal-locked items as safe next work.
jcwalker3 commented 2026-07-09 16:09:49 -05:00
Author
Owner
Copy Link
Copy Source

Canonical Issue State

STATE: ready for independent implementation
WHO_IS_NEXT: author
NEXT_ACTION: claim this issue and add MCP menu/dashboard for live queue, leases, blockers, and next safe action
NEXT_PROMPT:

Implement #605 on Scaled-Tech-Consulting/Gitea-Tools: MCP menu/dashboard showing open PR/issue queues, active leases, terminal lock state, blockers, stale leases, merge/review-ready items, discussion issues, controller-needed items, and exact next safe prompts. Never mark blocked work as safe. Cover #593/#592/#587-style terminal-blocked queue tests.

WHAT_HAPPENED: Filed as focused coordination issue #605. Series siblings: #600 allocator, #601 leases, #602 terminal-lock early check, #603 lifecycle labels, #604 anti-stomp preflight.
WHY: Operators and LLMs reconstruct queue safety from comments instead of a durable operational view.
RELATED_PRS: none yet
BLOCKERS: none
VALIDATION: issue created with type:feature status:ready and labels workflow-hardening,dashboard,mcp-menu,queue
LAST_UPDATED_BY: jcwalker3 (prgs-author)

## Canonical Issue State STATE: ready for independent implementation WHO_IS_NEXT: author NEXT_ACTION: claim this issue and add MCP menu/dashboard for live queue, leases, blockers, and next safe action NEXT_PROMPT: ```text Implement #605 on Scaled-Tech-Consulting/Gitea-Tools: MCP menu/dashboard showing open PR/issue queues, active leases, terminal lock state, blockers, stale leases, merge/review-ready items, discussion issues, controller-needed items, and exact next safe prompts. Never mark blocked work as safe. Cover #593/#592/#587-style terminal-blocked queue tests. ``` WHAT_HAPPENED: Filed as focused coordination issue #605. Series siblings: #600 allocator, #601 leases, #602 terminal-lock early check, #603 lifecycle labels, #604 anti-stomp preflight. WHY: Operators and LLMs reconstruct queue safety from comments instead of a durable operational view. RELATED_PRS: none yet BLOCKERS: none VALIDATION: issue created with type:feature status:ready and labels workflow-hardening,dashboard,mcp-menu,queue LAST_UPDATED_BY: jcwalker3 (prgs-author)
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
allocator
Controller-owned work allocator
 anti-stomp
Prevent concurrent LLM session stomping
 architecture
Architecture / structural design
 bug
chore
codex
OpenAI Codex client / workflow session surface
 concurrency
Concurrent session safety
 contamination
Workflow or session contamination incident
 control-plane
MCP control-plane coordination and allocation authority
 dashboard
MCP operational dashboard/queue view
 database
Internal coordination storage (SQLite/Postgres)
 design
Design / investigation, no implementation
 documentation
Docs / runbooks
 enhancement
New feature or improvement
 gitea
Gitea MCP workflow
 glitchtip
GlitchTip integration
 important
incident
Operational or process incident requiring durable audit trail
 incident-bridge
Sentry-to-Gitea incident bridging
 integration
Integration testing
 jenkins
Jenkins integration
 labels
Label taxonomy management
 leases
Lease adopt/release/expire lifecycle
 mcp
MCP server / tooling
 mcp-health
MCP namespace and runtime health
 mcp-menu
MCP menu surface
 multi-project
Work spanning multiple monitoring projects or Gitea repos
 mutating
Mutating action; requires gating
 nice-to-have
observability
Observability, metrics, traces, error reporting
 portability
Cross-platform / portability
 preflight
Shared preflight gates before mutation
 protected-branch
Protected branch / stable-branch policy concern
 queue
Work queue visibility and allocation
 read-only
Read-only, no mutation
 reconnect
MCP client reconnect/reload recovery path
 recovery
Recovery paths for stale/foreign leases
 refactor
Code refactor / restructure
 release
Release / versioning
 reliability
Reliability / failure handling
 resumable-review
Persist and resume prepared review verdicts across sessions
 reviewer
Reviewer workflow tooling
 roadmap
Roadmap / umbrella issue
 safety
Safety rails and fail-closed mutation guards
 security
Security / trust boundary
 self-hosted
Self-hosted infrastructure integration
 sentry
Sentry error monitoring integration
 stale-runtime
Stale backend daemon / runtime-vs-master parity failures
 status:blocked
Issue is blocked
 status:in-progress
Issue is being worked on
 status:pr-open
Issue has an open pull request
 status:ready
Issue is ready for work
 terminal-lock
Terminal review lock (#332) path
 testing
Tests / test coverage
 tracker
Issue tracker hygiene / meta
 type:bug
Bug or defect
 type:feature
Feature or enhancement
 type:feature
Feature or enhancement
 type:guardrail
Safety gate or guardrail
 visibility
Workflow state visibility for LLMs/operators
 workflow
Cross-tool workflow
 workflow-hardening
LLM workflow coordination hardening
 workflow-hardening
LLM workflow coordination hardening
No labels dashboard mcp-menu queue status:ready type:feature workflow-hardening
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
jcwalker3 sysadmin
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Scaled-Tech-Consulting/Gitea-Tools#605