soleprint/artery/veins/jira/README.md

Jira Vein

Jira connector for Pawprint Artery.

Authentication

Two ways to provide Jira credentials:

1. Web UI (Headers)

Enter credentials in the web form at https://artery.mcrn.ar

• Credentials sent as X-Jira-Email and X-Jira-Token headers
• Use for demos, testing, or when credentials change frequently

2. Local .env file (Fallback)

Create .env (not committed to git):

cp .env.example .env
# Edit .env with your credentials

The system tries headers first, then falls back to .env.

Getting a Jira API Token

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click "Create API token"
3. Copy the token (starts with ATATT3x)
4. Use in UI or add to .env

Endpoints

• GET /jira/health - Connection test
• GET /jira/mine - My assigned tickets
• GET /jira/ticket/{key} - Ticket details
• POST /jira/search - Raw JQL search

Add ?text=true for LLM-friendly output.