linear

Linear API bindings for Hot: issues (full lifecycle through archive/delete), teams with workflow states and labels, comments, search, and webhook verification over Linear's GraphQL API — plus ::linear::api/graphql for everything else.

Setup

Context Variable	Description
`linear.api.key`	Personal API key (`lin_api_...`) or OAuth token (`lin_oauth_...`) — the right Authorization form is chosen automatically
`linear.webhook.secret`	For `::linear::webhooks/verify-request`

Usage

::issues ::linear::issues
::teams ::linear::teams

team ::teams/get-team-by-key("ENG")
issue ::issues/create-issue(team.id, "Rate limit the export endpoint", {priority: 2})
::issues/create-comment(issue.id, "Seen 429s from the reporting job since Tuesday.")

// Move it through the team's workflow
started first(filter(::teams/list-states(team.id).nodes, (s) { eq(s.type, "started") }))
::issues/update-issue(issue.id, {stateId: started.id})

todo ::issues/list-issues({filter: {state: {type: {eq: "unstarted"}}}, first: 20})
thread ::issues/list-comments(issue.id, {first: 50})
hits ::issues/search-issues("export timeout")

::issues/delete-issue(issue.id)   // to trash; archive-issue keeps it queryable

// Webhooks: HMAC check plus replay protection on the signed
// webhookTimestamp (60s tolerance by default)
is-valid ::linear::webhooks/verify-request(request)

// Raw GraphQL escape hatch
me ::linear::api/graphql("query { viewer { id name email } }")

GraphQL errors come back as an Err carrying {errors, data}; transport errors as {status, body}. List surfaces (list-issues, list-comments) take first/after and return pageInfo for cursoring.

License

Apache-2.0 - see LICENSE