Skip to content

Add Linear project triggers - #84

Merged
boudra merged 23 commits into
mainfrom
reshape/linear-project-triggers
Aug 28, 2026
Merged

Add Linear project triggers#84
boudra merged 23 commits into
mainfrom
reshape/linear-project-triggers

Conversation

@boudra

@boudra boudra commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Paseo Hub can connect a Linear app and run workflows from signed Linear issue, assignment, and comment events. Workflows can reply into Linear while keeping repository authority explicit per step.

Goals

  • Connect Linear workspaces through app OAuth with rotating-token refresh.
  • Verify, deduplicate, persist, and route signed Linear webhooks.
  • Trigger workflows from comments, assignments, and issues entering an explicit project scope.
  • Filter by connection, project, state, labels, assignee, allowlisted actors, text, and parsed inputs.
  • Materialize bounded causal issue history only when execution context is built.
  • Expose Linear setup, connection health, activity summaries, and configuration contracts in the operator surfaces.
  • Keep repository access explicit; a Linear connection never grants GitHub authority.

Non-goals

  • Native Linear Agent Sessions. That lifecycle will be evaluated separately with real-install QA.
  • Automatic repository selection or implicit code-host authority.
  • Compatibility shims for pre-release Linear configuration shapes.

Why

The core Linear workflow has been exercised against a real workspace, including OAuth, genuine signed webhooks, trigger routing, app-authored replies, loop prevention, and adversarial signature cases. Native Agent Sessions were added later with a separate lifecycle and no real-install evidence, so this PR deliberately keeps the proven core integration and leaves that surface for a focused follow-up.

Attribution

This branch preserves Michael Wu's original commits and authorship from PR #59. The maintainer-owned rebase and scope reduction are layered on top; both contributors remain represented in the commit history.

Supersedes

Related work

Verification

  • npm run typecheck
  • npm run format
  • npm run lint
  • npm run build
  • 72 focused Linear provider, event, matching, webhook, reply, and runtime tests
  • Desktop Chromium Apps spec: 6 embedded-mode journeys passed; 16 PostgreSQL-backed journeys could not start because this environment has no container runtime
  • Earlier real-workspace verification: OAuth, signed webhook intake, routing, app-authored reply, loop prevention, and adversarial signature cases

Risk surface

Review OAuth rebind and rotating-token serialization, signed webhook freshness and replay deduplication, connection/project isolation, issue-scope edge detection, and the new database migration. The browser setup journey and responsive operator UI are the principal integration surfaces.

@boudra
boudra merged commit d83f2de into main Aug 28, 2026
9 checks passed
@boudra
boudra deleted the reshape/linear-project-triggers branch August 28, 2026 11:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants