jira-bug

allowed-tools	Bash(curl *), Bash(git *), Glob, Grep, Read
argument-hint	[commit hash or description]
description	Create a Jira bug ticket in the LPD project through the REST API. Use when the user asks to create or file a Jira bug or LPD ticket.
name	jira-bug

Create a Jira Bug in LPD

Create a bug ticket in the LPD Jira project through the REST API, authenticating with credentials from the ${JIRA_API_USER} and ${JIRA_API_TOKEN} environment variables.

Input

When ${ARGUMENTS} is a commit hash, inspect the commit with git show to understand the fix and infer the bug it addresses. When ${ARGUMENTS} is a free-form description, use it directly.

Gather Information

Request any missing details from the user:

• Summary — short title describing the bug.
• Steps to Reproduce — clear, minimal steps.
• Expected Behavior — what should have happened.
• Actual Behavior — what happened instead.

Required Fields

The LPD project requires the following fields. Apply these defaults unless the user specifies otherwise:

• Affects Version: Master (ID: 16660).
• Component: Select from the list below, or infer from the code area. Common components include:
  • Content Publishing > Resource Importer (ID: 15805)
  • Data Integration > Export/Import (ID: 16131)
  • Headless Batch Engine API (ID: 16022)
• Cross Cutting Properties (customfield_10979): None (ID: 14468).

When no listed component matches, search by keyword:

curl \
	--silent \
	--url "https://liferay.atlassian.net/rest/api/3/project/LPD/components" \
	--user "${JIRA_API_USER}:${JIRA_API_TOKEN}" \
	| python3 -c "import json, sys; [print(f'{c[\"id\"]:>6} {c[\"name\"]}') for c in json.load(sys.stdin) if 'SEARCH_TERM' in c['name'].lower()]"

Create the Ticket

Submit the issue through Jira REST API v3:

curl \
	--data '<JSON payload>' \
	--header "Content-Type: application/json" \
	--request POST \
	--silent \
	--url "https://liferay.atlassian.net/rest/api/3/issue" \
	--user "${JIRA_API_USER}:${JIRA_API_TOKEN}"

Author the description in Atlassian Document Format (ADF) with the following sections, in order: Description, Steps to Reproduce, Expected Behavior, Actual Behavior. Append a Fix section when a commit is referenced.

Output

Return the ticket key and the browse URL: https://liferay.atlassian.net/browse/<KEY>.