Skip to content

Add Jira context source #174

@luca-martial

Description

@luca-martial

Scope

Build a jira context-source adapter that ingests Jira issues from a configured project — filtered by labels so the wiki doesn't fill up with every ticket — and writes them as Markdown.

Where to start

  • Adapter directory: packages/context/src/ingest/adapters/jira/
  • Model on packages/context/src/ingest/adapters/notion/
  • Use the Jira Cloud REST API (/rest/api/3/) with JQL search
  • Auth via Atlassian API token
  • Configuration requires a project key and a label allowlist (e.g. kb, decision, policy)
  • Wire the new driver value in packages/context/src/project/driver-schemas.ts
  • Add docs in docs-site/content/docs/integrations/context-sources.mdx

Acceptance criteria

  • New adapter under adapters/jira/ with tests
  • Reads issues matching the configured project and labels
  • Output writes Markdown under wiki/global/, including summary, description, and key
  • Authentication uses Atlassian API token via env: or file: reference
  • Errors clearly if no labels are configured (no accidental full-project dumps)
  • Integration docs added with a connection-config example

Reward

Merging this PR earns the hoodie tier (tier-3). See CONTRIBUTING.md.

Comment on this issue to claim it before starting work.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:connectorspackages/connector-* and packages/cli/src/context/ingest/adapters/*help wantedExtra attention is neededreward:tier-3Hoodie tier — major or repeat contributor

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions