feat(mcp): expose pad_project ready + stale actions (TASK-2019)#878
Merged
Conversation
Add read-only `ready` and `stale` actions to the pad_project MCP tool, mirroring the existing CLI `pad project ready` / `pad project stale`. `ready` returns the actionable backlog (query-oriented counterpart to `next`); `stale` lists items needing attention. Both HTTP dispatchers already existed; this wires them onto the catalog surface. `pad project reconcile` stays CLI-only (shells out to `gh` for live PR state — a local-git dependency MCP agents lack). Bumps ToolSurfaceVersion 0.12 -> 0.13 across version.go, instructions.md, README, CLAUDE.md; adds readOnlyActions entries, drift-guard test entries, and a SKILL.md routing line. TASK-2019 Claude-Session: https://claude.ai/code/session_019knGmnHcx5rrgWXQ8V8DZS
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Exposes the agent-oriented
pad project ready/pad project staleCLI commands on the MCPpad_projecttool as read-only actions. Both commands already existed on the CLI and both HTTP dispatchers (dispatch_http_project.go) already existed — this PR just wires them onto the catalog surface.ready— actionable backlog (query-oriented counterpart tonext, reuses the dashboard's suggested-next logic)stale— items needing attention (stalled, blocked, overdue, out of the active workflow)pad project reconcileis deliberately NOT exposed: it shells out toghto compare stored PR metadata against live GitHub state — a local-git dependency an MCP agent lacks. It's already documented as intentionally CLI-only in the dispatch unsupported-command map, alongside thegithubcommands with the same locality argument, so no new task was needed.Version bump
ToolSurfaceVersion0.12 → 0.13 (pure addition of two read-only actions; backwards-compatible for v0.12 consumers). Updated in lockstep:version.gochangelog,instructions.mdheading + pad_project bullet, README catalog table +tool_surface_version, CLAUDE.md MCP section, and the drift-guard / cmdhelp tests.Gates
golangci-lint run— 0 issuesgo test ./...— passgo test ./internal/mcp/...(drift guard) — passgo build ./cmd/pad— okhttps://claude.ai/code/session_019knGmnHcx5rrgWXQ8V8DZS