Skip to content

docs(jira-importer): add OAuth background agent guidance#14

Merged
shannonwho merged 2 commits intomainfrom
feature/jira-custom-field-importer-clean
May 6, 2026
Merged

docs(jira-importer): add OAuth background agent guidance#14
shannonwho merged 2 commits intomainfrom
feature/jira-custom-field-importer-clean

Conversation

@shannonwho
Copy link
Copy Markdown
Collaborator

Summary

  • Adds a new Running as a background agent (OAuth) section to the Jira custom field importer README
  • Explains when to prefer an OAuth token over a personal API key (scheduled runs, CI/CD, clean audit trail)
  • Covers how to obtain a token via Settings → OAuth applications and how to configure it as a drop-in replacement

Test plan

  • README renders correctly on GitHub
  • OAuth token path (lin_oauth_...) works as a drop-in for linear.apiKey in config or via LINEAR_API_KEY env var

🤖 Generated with Claude Code

Shannon Hu and others added 2 commits May 4, 2026 22:10
… fix

On top of the initial tool (merged via #11), this adds:

- Streaming pagination and batch JQL lookups (~100x fewer Jira API calls)
- Checkpoint/resume for large workspaces (saves progress after every page)
- Upsert behavior: updates description section if Jira value changed
- Activity comment on each updated Linear issue linking back to Jira
- Linear-side scope filters: states, labels, projectName
- Jira-side scope filter: filterJql ANDed into every batch query
- Fix: switch batch search to POST /rest/api/3/search/jql (old endpoint returns 410)
- Fix: add 410 to non-retryable status codes
- Docs: README with performance table, checkpoint/resume, and scope filter examples

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@shannonwho shannonwho merged commit 23f8cf4 into main May 6, 2026
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