Skip to content

feat: add jira issue management components#4784

Merged
forestileao merged 18 commits into
superplanehq:mainfrom
WashingtonKK:feat/jira-issues
May 18, 2026
Merged

feat: add jira issue management components#4784
forestileao merged 18 commits into
superplanehq:mainfrom
WashingtonKK:feat/jira-issues

Conversation

@WashingtonKK
Copy link
Copy Markdown
Collaborator

@WashingtonKK WashingtonKK commented May 14, 2026

Closes: #4755

What changed

This extends the Jira integration by adding the following issue management components:

  • jira.updateIssue
  • jira.deleteIssue
  • jira.getIssue

Why

SuperPlane should support issue management in full. We already have issue creation but we do not support the full management cycle.

Notes

- Introduced new components: On Issue trigger, Delete Issue, Get Issue, and Update Issue.
- Enhanced documentation for Jira integration, detailing use cases, configuration, and example data for each component.
- Implemented OAuth authentication for Jira API interactions, replacing previous email and API token method.
- Added tests for new components to ensure functionality and error handling.

This update significantly expands the capabilities of the Jira integration, allowing for comprehensive issue management within workflows.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
@superplanehq-integration
Copy link
Copy Markdown

👋 Commands for maintainers:

  • /sp start - Start an ephemeral machine (takes ~30s)
  • /sp stop - Stop a running machine (auto-executed on pr close)

Comment thread web_src/src/pages/workflowv2/mappers/jira/index.ts
Comment thread web_src/src/pages/workflowv2/mappers/jira/utils.ts Outdated
Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Comment thread web_src/src/pages/workflowv2/mappers/jira/utils.ts
…ndling

- Updated the Jira documentation to simplify the content and improve clarity, removing unnecessary sections and consolidating instructions.
- Enhanced the metadata handling in the create, update, and delete issue mappers by introducing utility functions for project and issue key metadata.
- Improved the configuration details for creating issues, including optional status management.

This refactor aims to provide a clearer user experience and better maintainability of the codebase.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Comment thread web_src/src/pages/workflowv2/mappers/jira/get_issue.ts
- Integrated new utility functions `addIssueKeyMetadata` and `addProjectMetadata` to streamline the addition of project and issue key metadata in the Jira issue mapper.
- Removed redundant code for metadata handling, improving code clarity and maintainability.

This update aims to simplify the metadata management process within the Jira integration.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
- Introduced an optional `assignee` field in the `CreateIssueSpec` and `CreateIssueFields` structures to allow assignment of issues to specific users.
- Updated the `requireProject` function to accept an HTTP context for improved project retrieval.
- Enhanced the issue creation and update processes to handle the new assignee field, including corresponding tests to validate functionality.
- Adjusted configuration and documentation to reflect the addition of the assignee field.

This update aims to improve user experience by enabling direct assignment of issues during creation and updates.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
- Introduced a new `getIssueUrl` utility function to generate the issue URL based on the issue key and self link.
- Updated the `createIssueMapper`, `getIssueMapper`, and `updateIssueMapper` to include the new "Issue URL" field in their execution details.
- Enhanced corresponding test cases to validate the inclusion of the issue URL in the output details.

This update improves the visibility of issue links directly within the application, enhancing user navigation and experience.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Comment thread pkg/integrations/jira/get_issue.go
- Introduced an optional `expand` field in the `GetIssueSpec` structure to allow users to specify additional fields to retrieve from Jira.
- Updated the documentation for the Get Issue component to include the new expand field and its usage.
- Enhanced the execution logic to utilize the expand parameter when fetching issue details.

This update improves the flexibility of the Get Issue component by enabling users to retrieve more detailed information as needed.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Comment thread pkg/integrations/jira/create_issue.go
Comment thread pkg/integrations/jira/get_issue.go
- Simplified the documentation for the Issue Key across multiple components (Create, Get, Update, Delete) by removing references to expressions resolving to the key.
- Changed the type of the Issue Key field in the Delete Issue component from `FieldTypeExpression` to `FieldTypeString` for clarity.
- Enhanced the execution logic in the Create Issue component to improve readability.

This update aims to provide clearer documentation and improve the handling of issue keys within the Jira integration.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Comment thread pkg/integrations/jira/update_issue.go
Comment thread pkg/integrations/jira/list_resources.go
- Added a new test case to verify behavior when the HTTP context is missing in the ListResources function for priorities, ensuring it returns an empty resource list without errors.
- Updated the listPriorities function to return an empty list when the HTTP context is nil, improving robustness against missing context.

This enhancement ensures that the integration gracefully handles scenarios where the HTTP context is not provided, improving overall stability.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Comment thread pkg/integrations/jira/list_resources.go
… functions

- Added checks for nil HTTP context in the listIssueTypes, listIssueStatuses, and listAssignees functions to ensure they return an empty resource list without errors when the context is missing.
- This enhancement improves the robustness of the Jira integration by gracefully handling scenarios where the HTTP context is not provided.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Comment thread pkg/integrations/jira/create_issue.go
- Updated the example output JSON for creating a Jira issue to include detailed fields such as summary, status, priority, issue type, project information, assignee, reporter, labels, and timestamps.
- This enhancement provides a more comprehensive representation of the expected output, improving clarity for users implementing the Jira integration.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
Copy link
Copy Markdown
Contributor

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 24bad51. Configure here.

Comment thread pkg/integrations/jira/create_issue.go Outdated
…ields

- Enhanced the example output JSON for Jira issue creation to include detailed fields such as assignee, created date, issue type, labels, priority, project information, reporter, status, summary, and updated date.
- This update provides a more comprehensive representation of the expected output, improving clarity for users implementing the Jira integration.

Signed-off-by: WashingtonKK <washingtonkigan@gmail.com>
@forestileao forestileao merged commit 240c62e into superplanehq:main May 18, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Jira] Add issue management components

3 participants