Feature/stage tool

[floatingIce91]

Add Valid Stage Transition Tool

https://app.devrev.ai/devrev/works/ISS-187541

Overview

Added mcp_devrev_valid_stage_transition tool to retrieve available stage transitions for DevRev work items and parts.

Features

• Multi-type Support: Works with issues (ISS-), tickets (TKT-), and enhancements (ENH-)
• Workflow Validation: Returns only valid stage transitions from current stage
• Complete Transition Data: Provides both stage names and internal IDs
• Support Subtypes: Works with custom types

Usage

# Get valid transitions for an issue
valid_transitions = mcp_devrev_valid_stage_transition(type="issue", id="ISS-12345")

Benefits

• Prevents invalid stage transition attempts
• Enables workflow automation with valid transition data
• Provides clear visibility into available next steps

Returns

List of valid transitions with:

• Target stage name (e.g., "completed", "in_review")
• Target stage ID for API operations

This tool enhances DevRev workflow management by ensuring users only attempt valid stage transitions.

[shivam-gupta-devrev]

Let's do some extensive testing here before merging.

[floatingIce91]

Yeah I will do it before merging