# Linear connector

> Linear provider behavior lives in the pure-Harn harn-linear-connector package. Harn core keeps the shared trigger envelope, inbox/dedupe path, metrics, HMAC helpers, and...

Website: https://harnlang.com/connectors/linear.html

This page documents Harn, which is pre-1.0. Language, standard library, and CLI APIs may change. If the intended version is unclear, clarify before using this page.

---

Linear provider behavior lives in the pure-Harn
[`harn-linear-connector`](https://github.com/burin-labs/harn-linear-connector)
package. Harn core keeps the shared trigger envelope, inbox/dedupe path,
metrics, HMAC helpers, and provider schema metadata; the connector package owns
Linear-specific webhook verification, replay-window policy, payload
normalization, outbound GraphQL calls, fixtures, and release cadence.

## Install

```sh
harn add github.com/burin-labs/harn-linear-connector@v0.1.0
harn package verify . --provider linear
```

Wire the package through the provider manifest entry:

```toml
[[providers]]
id = "linear"
connector = { harn = "harn-linear-connector" }

[[triggers]]
id = "linear-issues"
kind = "webhook"
provider = "linear"
match = { path = "/hooks/linear", events = ["issue.update", "comment.create"] }
handler = "handlers::on_linear"
secrets = { signing_secret = "linear/webhook-secret" }
```

## Runtime contract

The package normalizes Linear webhook deliveries such as `Issue`, `Comment`,
`IssueLabel`, `Project`, `Cycle`, `Customer`, and `CustomerRequest`, including
issue update diffs where available. Outbound GraphQL support is exposed by the
package through connector contract v1 exports.

## Verification

```sh
harn connector check .
harn package verify . --provider linear
```

For local development against this repository's CLI:

```sh
cargo run --quiet --bin harn -- package verify /path/to/harn-linear-connector --provider linear
```

---

## Read next

- [GitHub app connector](https://harnlang.com/connectors/github.md)
- [Notion connector](https://harnlang.com/connectors/notion.md)