Skip to content

feat(server): add Linear workflow state operations - #308

Merged
siisee11 merged 1 commit into
mainfrom
codex/linear-workflow-state-api
Jul 13, 2026
Merged

siisee11 merged 1 commit into
mainfrom
codex/linear-workflow-state-api

Conversation

@siisee11

Copy link
Copy Markdown
Contributor

One-Line Summary

Linear source connections can discover team workflow states and move existing issues between them.

User-Facing Changes

  • Adds list_workflow_states for read and read-write Linear connections; callers provide teamId and receive the team's workflow state IDs and metadata.
  • Adds update_issue for read-write Linear connections; callers provide issueId and stateId to change an issue's workflow state.
  • Keeps update_issue unavailable to mention-only and read-only connections.

Why This Changed

The Linear adapter exposed issue state data and allowed a state during issue creation, but it had no operation to discover a team's available states or update an existing issue. Agents therefore could not complete a normal issue status transition through the audited Source API.

How It Changed

  • Adds strict Zod inputs for workflow-state lookup and issue-state updates.
  • Maps list_workflow_states to Linear's team.states GraphQL query.
  • Maps update_issue to Linear's issueUpdate mutation with IssueUpdateInput.stateId.
  • Bumps the Linear descriptor version to linear.v2 and adds CLI examples and access-mode notes.
  • Adds happy-path and invalid-input coverage for both operations.

Extra Context / Decisions (Optional)

update_issue is intentionally limited to workflow-state changes in this PR. Other IssueUpdateInput fields can be added later with explicit validation and policy review.

Verification

  • bun run format
  • bunx oxlint --type-aware --type-check packages/server/src/source-api/adapters/linear.ts packages/server/src/source-api/adapters/linear.test.ts
  • bun run typecheck from packages/server
  • bun run test from packages/server — 49 test files and 186 tests passed, including workflow-state lookup, issue-state update, and required-input rejection coverage in linear.test.ts.

Video / Screenshot (Optional)

  • N/A

@siisee11
siisee11 enabled auto-merge (squash) July 13, 2026 21:17
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
onequery-landing 4d31354 Commit Preview URL

Branch Preview URL
Jul 13 2026, 09:20 PM

@siisee11
siisee11 merged commit 2336b6f into main Jul 13, 2026
9 checks passed
@siisee11
siisee11 deleted the codex/linear-workflow-state-api branch July 13, 2026 21: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.

1 participant