Automatic Linear x Github PR integration

[arboleya]

Problem

When integrating with Linear, PRs now must keep track of two things:

• GitHub Issues
• Linear Issues

One would expect Linear to follow this automatically, but it doesn't.

Then, we end up with Github Issues vs. Linear Issues, which is not only noisy but also cumbersome to do manually.

Desires

• Have this working automatically out of the box
• Keep the Linear magic words out of the PR description

Solution

Implement workflow automation that will:

• Find all GH issues the PR is closing
• Find their related Linear issue IDs
• Modify the PR description, adding Linear magic words as comments (invisible!)

<!-- Closes to TS-1, TS-2, TS-N -->
<!-- Part of to TS-5, TS-7, N -->

Premisses:

• GitHub issues must be informed one per line (predictable parsing)
• Linear Comments can contain multiple issues per line (it doesn't matter)

Docs:

• Github Keywords
• Linear Magic Words & Linear API

Github Action

The final solution must be a GitHub action that all other repos can reuse; it can go here:

• https://github.com/FuelLabs/github-actions

[arboleya]

Thanks to @nedsalk for the ideas and discussions around this. ❤️

[arboleya]

@FuelLabs/sdk-ts While we get there, I enabled this:

• https://linear.app/docs/github#enable-autolink

Which turns mentions to TS-NNN strings into clickable links:

[nedsalk]

Closing to test out integration with linear - will reopen immediately.