Linear (community wrapper)

Descrizione

Wrapper enterprise high-level per il modulo integration_linear_create_issue (Linear GraphQL API createIssue mutation) che unifica il pattern community_* del dataset AI scaffold FlowForge per creare issue Linear. Linear è la piattaforma di project management built nell'industry per startup tech moderne che vogliono velocità e UX cura (cresciuta a 10k+ paying customer dal 2020, popolarissima tra YC company e dev team distribuiti), alternativa moderna a Jira/Asana con keyboard-first UX, cycle-based planning, auto-archive completate, integration nativa GitHub/Slack/Figma. Crea issue completi via GraphQL API ufficiale Linear con tutti i campi principali del project management standard: team key (identificatore univoco del team destinatario, es. "ENG" per engineering, "DSGN" per design, "SUP" per support — Linear richiede team scope obbligatorio), title (oneline summary chiaro e concreto < 100 char), description markdown rich (Linear supporta GFM markdown completo + Linear-specific extensions tipo /collapse per collapsible sections, @user mention con autocomplete, link a altri issue con sintassi LIN-123), priority (1-4: urgent/high/medium/low — UI Linear lo mostra con icone color-coded per quick triage del team), assignee by email (l'API Linear richiede assignee_id UUID, questo wrapper risolve automaticamente l'email del responsabile al user_id corretto via team membership lookup — pattern friendly per non-tecnici che conoscono email ma non UUID), labels (array di label names come "bug", "feature_request", "documentation", "p0_critical" — il nodo risolve gli ID label dal name string contro la knowledge base del team), state (backlog/todo/in_progress/done — il default è il workflow_state default del team configurato in Settings Linear). Auth via Personal API Key (formato lin_api_xxxxxxxx generato dall'admin in Settings → API → Personal API Keys) o OAuth2 per integration multi-user — stored nel vault integration FlowForge accessibile via integrationLabel. Rate limit: Linear non documenta hard limit ma il nodo usa 10 RPS sustained con backoff exponential su errori. Use case: creare bug Linear automatically da error tracker (webhook Sentry/Bugsnag/Datadog parsa l'evento di errore e crea issue ENG-XXX con stack trace in description + priority urgent se affecting > 100 users); opening ticket support automatic da agent_email_triage_b2b_sales che classifica una email cliente come "support_request" → crea issue SUP-XXX con full body email + customer email come metadata per il customer success team; backlog auto-generato da customer feedback form (typeform/trigger_form) dove la categoria del feedback ("feature_request", "bug_report", "ui_complaint") mappa a team Linear diverso; handoff workflow → engineering con assignee email-resolved del lead engineer del team corrispondente al modulo affected, evitando ping manuale.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

• ok
• issueId
• identifier
• url
• title
• state
• warnings

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-community_linear-1",
  "defId": "community_linear",
  "label": "Linear (community wrapper)",
  "config": {
    "teamKey": "ENG",
    "title": "<title>",
    "priority": 0
  }
}

🔗 Nodi correlati nella stessa categoria