1export const jiraIntegrationSpec = defineIntegration({
2  meta: {
3    key: 'project-management.jira',
4    version: '1.0.0',
5    category: 'project-management',
6    title: 'Jira Cloud',
7    description: 'Jira Cloud integration for creating and tracking work items.',
8    domain: 'productivity',
9    owners: ['@platform.integrations'],
10    tags: ['project-management', 'jira'],
11    stability: StabilityEnum.Beta,
12  },
13  supportedModes: ['managed', 'byok'],
14  capabilities: {
15    provides: [{ key: 'project-management.work-items', version: '1.0.0' }],
16  },
17  configSchema: {
18    schema: {
19      type: 'object',
20      required: ['siteUrl'],
21      properties: {
22        siteUrl: {
23          type: 'string',
24          description:
25            'Jira Cloud site URL (e.g., https://acme.atlassian.net).',
26        },
27        projectKey: {
28          type: 'string',
29          description: 'Default Jira project key for new issues.',
30        },
31        issueType: {
32          type: 'string',
33          description: 'Default Jira issue type (e.g., Task, Story).',
34        },
35        defaultLabels: {
36          type: 'array',
37          items: { type: 'string' },
38          description: 'Labels applied to each issue by default.',
39        },
40        issueTypeMap: {
41          type: 'object',
42          additionalProperties: { type: 'string' },
43          description:
44            'Optional mapping from work item types to Jira issue types.',
45        },
46      },
47    },
48    example: {
49      siteUrl: 'https://acme.atlassian.net',
50      projectKey: 'PM',
51      issueType: 'Task',
52    },
53  },
54  secretSchema: {
55    schema: {
56      type: 'object',
57      required: ['email', 'apiToken'],
58      properties: {
59        email: {
60          type: 'string',
61          description: 'Jira account email used for API token auth.',
62        },
63        apiToken: {
64          type: 'string',
65          description: 'Jira Cloud API token for the account.',
66        },
67      },
68    },
69    example: {
70      email: 'user@acme.com',
71      apiToken: 'jira_api_token',
72    },
73  },
74  healthCheck: {
75    method: 'custom',
76    timeoutMs: 4000,
77  },
78  docsUrl: 'https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/',
79  constraints: {},
80  byokSetup: {
81    setupInstructions:
82      'Create a Jira API token and store it with the associated account email.',
83  },
84});