from typing import Any

from ..utils.jira import comment_on_issue


async def jira_comment(comment_body: str, issue_key: str) -> dict[str, Any]:
    """Post a comment to a Jira issue.

    Use this tool to communicate progress and completion to stakeholders on Jira.

    **When to use:**
    - After opening/updating a draft PR, post a comment on the Jira issue to let
      stakeholders know the task is complete and include the PR link. For example:
      "I've completed the implementation and opened a PR: <pr_url>"
    - When answering a question or sharing an update (no code changes needed).

    Args:
        comment_body: Markdown-formatted comment text to post to the Jira issue.
        issue_key: The Jira issue key to post the comment to (e.g. PROJ-123).

    Returns:
        Dictionary with 'success' (bool) key.
    """
    success = await comment_on_issue(issue_key, comment_body)
    return {"success": success}