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	transports: [
16		{ type: 'rest', baseUrl: 'https://api.linear.app' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'linear-signature',
21				signingAlgorithm: 'hmac-sha256',
22			},
23		},
24		{ type: 'sdk', packageName: '@linear/sdk' },
25	],
26	preferredTransport: 'rest',
27	supportedAuthMethods: [
28		{ type: 'api-key' },
29		{
30			type: 'oauth2',
31			grantType: 'authorization_code',
32			authorizationUrl: 'https://linear.app/oauth/authorize',
33			tokenUrl: 'https://api.linear.app/oauth/token',
34			scopes: ['read', 'write', 'issues:create'],
35		},
36	],
37	capabilities: {
38		provides: [{ key: 'project-management.work-items', version: '1.0.0' }],
39	},
40	configSchema: {
41		schema: {
42			type: 'object',
43			required: ['teamId'],
44			properties: {
45				teamId: {
46					type: 'string',
47					description: 'Linear team ID that owns created issues.',
48				},
49				projectId: {
50					type: 'string',
51					description: 'Optional default project ID for new issues.',
52				},
53				stateId: {
54					type: 'string',
55					description: 'Optional default workflow state ID.',
56				},
57				assigneeId: {
58					type: 'string',
59					description: 'Optional default assignee ID.',
60				},
61				labelIds: {
62					type: 'array',
63					items: { type: 'string' },
64					description: 'Optional label IDs applied to each issue.',
65				},
66				tagLabelMap: {
67					type: 'object',
68					additionalProperties: { type: 'string' },
69					description:
70						'Optional mapping of tags to Linear label IDs (tag -> labelId).',
71				},
72			},
73		},
74		example: {
75			teamId: 'team_123',
76			projectId: 'proj_456',
77			labelIds: ['label_1', 'label_2'],
78		},
79	},
80	secretSchema: {
81		schema: {
82			type: 'object',
83			required: ['apiKey'],
84			properties: {
85				apiKey: {
86					type: 'string',
87					description: 'Linear API key (personal or service token).',
88				},
89			},
90		},
91		example: {
92			apiKey: 'lin_api_key',
93		},
94	},
95	healthCheck: {
96		method: 'custom',
97		timeoutMs: 4000,
98	},
99	docsUrl: 'https://developers.linear.app',
100	constraints: {},
101	byokSetup: {
102		setupInstructions:
103			'Create a Linear API key with issue:write permission and store it as a secret.',
104		keyRotationSupported: true,
105		quotaTrackingSupported: false,
106	},
107});