Naar de hoofdinhoud

Linear

Linear is een gehoste issuetracker, bereikbaar als https://linear.app/<your-workspace>/issue/<KEY>-<NUMBER>. Issuesleutels hebben de vorm <TEAM>-<NUMBER> (bijv. ENG-123, MKT-456).

Forgejo-kant: externe issuetracker

Repository-instellingen → Onderdelen → Issues → Gebruik externe issue tracker.

VeldWaarde
External issue tracker URLhttps://linear.app/<your-workspace>/issue/{user}-{index}
External issue tracker URL formathttps://linear.app/<your-workspace>/issue/{user}-{index}
External issue tracker number formatRegexp
External issue tracker number format regexp([A-Z][A-Z]+)-([0-9]+)

{user} vangt de teamsleutel (bijv. ENG), {index} het issuenummer. De reguliere expressie is bewust ruim wat betreft de lengte van de teamsleutel (≥2 tekens), omdat je in Linear elk willekeurig voorvoegsel in hoofdletters kunt kiezen.

Vervang <your-workspace> door de slug van je Linear-workspace (zichtbaar in de adresbalk op elke issuepagina in Linear).

Aanbevolen formaat voor commitberichten

feat(checkout): trial-card dedup

ENG-892

De GitHub- en GitLab-integraties van Linear ondersteunen magic words zoals fixes ENG-892 om een issue bij een merge automatisch te sluiten; die woorden starten automatisering aan de kant van Linear. fremforge is geen eigen integratiepartner van Linear, dus voor het gedrag van magic words is een webhook met automatisering aan klantzijde nodig (volgende sectie).

Trackerkant: automatisering via webhooks (optioneel)

De inkomende webhook van Linear werkt op workspaceniveau, niet per issue:

  1. Linear → Settings → API → Webhooks → New webhook.
  2. URL: een HTTP-endpoint dat je zelf beheert, dat de webhookpayload van Forgejo verwerkt en de GraphQL API van Linear aanroept om de commit of PR als opmerking toe te voegen en (optioneel) de status van het issue te wijzigen. Linear levert hiervoor recepten voor Zapier en n8n; voor klanten voor wie soevereiniteit gevoelig ligt, doet een Cloudflare Worker of je eigen FaaS-functie van 30 regels het rechtstreeks.
  3. In fremforge: Repository-instellingen → Webhooks → Webhook toevoegen → Forgejo → richt hem op het relay-endpoint hierboven. Vink Push en Pull Request aan.

Een relay ertussen is nodig, omdat Linear de webhookvorm van Forgejo niet rechtstreeks begrijpt. Heb je een Linear-beheerder die het magic-words-endpoint wil inrichten, dan levert fremforge de events; de relay koppelt alleen de veldnamen van de payload.

Gevolgen voor subverwerkers

Het control plane van Linear is AWS US-east-1 (per 2026-05-19 is er geen EU-regio; Linear heeft zich ondanks verzoeken van klanten nooit aan EU-dataresidentie verbonden). Als je fremforge aan Linear koppelt:

  • Stromen commitmetadata en het e-mailadres van de auteur naar Linear → AWS US-east-1.
  • Neem je Linear Orbit, Inc. op als subverwerker in je DPA en je register van subverwerkers.
  • De voorwaarden van Linear bevatten de standaardcontractbepalingen (SCC’s) voor doorgifte van de EU naar de VS, maar de gegevens VERLATEN de EU wel.

Gebruik voor soevereiniteitsgevoelige workloads liever Jira DC of Plane.

Wat dit niet doet

  • Geen eigen ondersteuning voor magic words (fixes ENG-892); dat is een functie van de eigen GitHub- en GitLab-integratie van Linear en geen onderdeel van de externe issuetracker. Wel haalbaar via de hierboven beschreven relayroute.
  • Geen aanmaak van issues via GraphQL vanuit fremforge (commits maken niet automatisch Linear-issues aan, ook niet als het genoemde ID niet bestaat).
  • De begrippen “Cycle”, “Project” en “Roadmap” van Linear passen niet op Forgejo; de integratie blijft op het niveau van issuelinks.
Azure BoardsTrello