| 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>.
