1export const linearIntegrationSpec = defineIntegration({
2  meta: {
3    key: 'project-management.linear',
4    version: '1.0.0',
5    category: 'project-management',
6    title: 'Linear',
7    description:
8      'Linear integration for issue tracking and project management workflows.',
9    domain: 'productivity',
10    owners: ['@platform.integrations'],
11    tags: ['project-management', 'linear'],
12    stability: StabilityEnum.Beta,
13  },
14  supportedModes: ['managed', 'byok'],
15  capabilities: {
16    provides: [{ key: 'project-management.work-items', version: '1.0.0' }],
17  },
18  configSchema: {
19    schema: {
20      type: 'object',
21      required: ['teamId'],
22      properties: {
23        teamId: {
24          type: 'string',
25          description: 'Linear team ID that owns created issues.',
26        },
27        projectId: {
28          type: 'string',
29          description: 'Optional default project ID for new issues.',
30        },
31        stateId: {
32          type: 'string',
33          description: 'Optional default workflow state ID.',
34        },
35        assigneeId: {
36          type: 'string',
37          description: 'Optional default assignee ID.',
38        },
39        labelIds: {
40          type: 'array',
41          items: { type: 'string' },
42          description: 'Optional label IDs applied to each issue.',
43        },
44        tagLabelMap: {
45          type: 'object',
46          additionalProperties: { type: 'string' },
47          description:
48            'Optional mapping of tags to Linear label IDs (tag -> labelId).',
49        },
50      },
51    },
52    example: {
53      teamId: 'team_123',
54      projectId: 'proj_456',
55      labelIds: ['label_1', 'label_2'],
56    },
57  },
58  secretSchema: {
59    schema: {
60      type: 'object',
61      required: ['apiKey'],
62      properties: {
63        apiKey: {
64          type: 'string',
65          description: 'Linear API key (personal or service token).',
66        },
67      },
68    },
69    example: {
70      apiKey: 'lin_api_key',
71    },
72  },
73  healthCheck: {
74    method: 'custom',
75    timeoutMs: 4000,
76  },
77  docsUrl: 'https://developers.linear.app',
78  constraints: {},
79  byokSetup: {
80    setupInstructions:
81      'Create a Linear API key with issue:write permission and store it as a secret.',
82  },
83});