from typing import Any

from ..utils.jira import update_issue


async def jira_update_issue(
    issue_key: str,
    summary: str | None = None,
    description: str | None = None,
    priority: str | None = None,
    labels: list[str] | None = None,
) -> dict[str, Any]:
    """Update an existing Jira issue.

    Args:
        issue_key: The Jira issue key to update (e.g. PROJ-123).
        summary: Optional new summary/title.
        description: Optional new markdown-formatted description.
        priority: Optional priority name (e.g. "High").
        labels: Optional list of label strings (replaces existing labels).

    Returns:
        Dictionary with 'success' (bool) and 'issue' (key, url), or 'error'.
    """
    return await update_issue(
        issue_key,
        summary=summary,
        description=description,
        priority=priority,
        labels=labels,
    )