feat: add release management tools

[akhil-vamshi-konam]

Description

Adds MCP tools for Plane's releases domain.

Tools

• Releases — list, create, retrieve, update, delete
• Tags — list, create, retrieve, update, delete (version markers)
• Labels — list, create, update, delete, and attach/detach on a release
• Work items — list, and add/remove on a release
• Changelog - get, update

Organized as a plane_mcp/tools/releases/ package.

Type of Change

• Feature (non-breaking change which adds functionality)

References

Requires plane-sdk==0.2.20 (pinned in this PR).

Summary by CodeRabbit

• New Features
  • Added release tools for managing releases (create, view, update, delete) with pagination.
  • Added release tag, label, and release work item tools (including label/work-item assignment management).
  • Added release changelog tools to retrieve and update changelog content (supports HTML, plain text, and ProseMirror JSON).
• Documentation
  • Updated tooling documentation to reflect expanded release tool coverage.
• Tests
  • Expanded tool-availability integration tests and added changelog unit tests for content conversion/precedence.
• Chores
  • Updated the plane-sdk dependency version.

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds release CRUD, tag, label, linked work item, and changelog MCP tools, shared pagination and description handling, SDK 0.2.20 support, server registration, availability coverage, and updated tooling documentation.

Changes

Release tool surface

Layer / File(s)	Summary
Release CRUD and SDK support pyproject.toml, plane_mcp/tools/releases/_helpers.py, plane_mcp/tools/releases/base.py	Adds SDK support, shared pagination, typed release CRUD operations, and status validation.
Tags and labels plane_mcp/tools/releases/tags.py, plane_mcp/tools/releases/labels.py	Adds release tag CRUD, workspace label CRUD, release label listing, and label attachment or detachment.
Linked work items plane_mcp/tools/releases/work_items.py	Adds paginated linked work item listing and add/remove operations with validation and refreshed associations.
Release changelog operations plane_mcp/tools/releases/changelog.py, plane_mcp/tools/releases/_helpers.py, tests/test_release_changelog.py	Adds changelog retrieval and updates with HTML, plain-text, and ProseMirror description handling, plus focused tests.
Registration and availability coverage plane_mcp/tools/releases/__init__.py, plane_mcp/tools/__init__.py, tests/test_integration.py, CLAUDE.md	Registers release tool groups, expands expected tool names, and updates the documented tool count.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant MCPClient
  participant ReleaseTools
  participant PlaneSDK
  participant PlaneAPI
  MCPClient->>ReleaseTools: invoke release operation
  ReleaseTools->>PlaneSDK: build typed request and call releases API
  PlaneSDK->>PlaneAPI: send release request
  PlaneAPI-->>PlaneSDK: return release response
  PlaneSDK-->>ReleaseTools: return typed result
  ReleaseTools-->>MCPClient: return MCP tool result

Loading

Possibly related PRs

• makeplane/plane-mcp-server#148: Both modify central tool registration to wire additional MCP tool modules.
• makeplane/plane-mcp-server#177: Both add a domain-specific register_*_tools call in the central registration entrypoint.

Suggested reviewers: prashant-surya

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change: adding release management tools to the MCP server.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat-release-tools

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@tests/test_release_changelog.py`:
- Around line 31-40: Update the test helper _call to use FastMCP.Client with
StreamableHttpTransport against the configured live Plane instance instead of
constructing an in-process FastMCP server and monkeypatching
get_plane_client_context. Preserve the update_release_changelog invocation and
arguments while removing the offline mocked-client setup.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: be77522c-613c-4ef7-8135-830f945a96ef

📥 Commits

Reviewing files that changed from the base of the PR and between 7d8fe2a and ec59f22.

📒 Files selected for processing (5)

• plane_mcp/tools/releases/__init__.py
• plane_mcp/tools/releases/_helpers.py
• plane_mcp/tools/releases/changelog.py
• tests/test_integration.py
• tests/test_release_changelog.py

🚧 Files skipped from review as they are similar to previous changes (1)

• plane_mcp/tools/releases/init.py