jira-sync

# jira-sync

Seamlessly connect your Anvil development workflow to Jira. Create tickets from conversations, update story status as you work, auto-link git commits to issues, pull ticket context into your Anvil session, and keep your project board in sync with your actual work — without breaking your flow.

## What It Does

jira-sync provides deep bidirectional integration with Jira Cloud and Jira Data Center:

- **Ticket creation**: Create Stories, Tasks, Bugs, and Epics from Anvil conversations with auto-populated fields
- **Status transitions**: Move tickets through workflow states (To Do → In Progress → In Review → Done) from Anvil
- **Commit auto-linking**: Detect ticket IDs in branch names and commit messages, auto-post dev panel links
- **Context pulling**: Load a ticket's description, acceptance criteria, and comments into Anvil context
- **Time logging**: Log work time against tickets from Anvil session duration
- **Sprint management**: Move tickets between sprints, check sprint capacity, view active sprint board
- **Comment posting**: Post code snippets, test results, and session notes as formatted Jira comments
- **Field sync**: Update custom fields, story points, priority, components, and fix versions

## Installation

```bash
anvil plugin install jira-sync
```

## Setup

1. Generate a Jira API token at https://id.atlassian.com/manage-profile/security/api-tokens
2. Configure the plugin:

```
/jira configure --host https://yourorg.atlassian.net --email [email protected] --token ATATT3xXX...
```

## Usage

### Pull Ticket Context into Session
```
/jira load ENG-1234
```

### Create a Bug Ticket
```
/jira create bug --title "Login fails with SSO on Safari" --project ENG --priority high
```

### Move Ticket to In Progress
```
/jira transition ENG-1234 "In Progress"
```

### Log Work
```
/jira log ENG-1234 --time 2h30m --comment "Implemented JWT refresh token rotation"
```

### Post Comment with Code Snippet
```
/jira comment ENG-1234 --file ./fix-summary.md
```

### Auto-link Current Branch
```
/jira link-branch
```

## Configuration Options

| Option | Description | Default |
|--------|-------------|---------|
| `--host` | Jira instance URL | env: JIRA_HOST |
| `--email` | Atlassian account email | env: JIRA_EMAIL |
| `--token` | Jira API token | env: JIRA_TOKEN |
| `--project` | Default project key | auto-detect |
| `--auto-link` | Auto-link commits on git push | true |

## Requirements

- Jira Cloud or Jira Data Center 8.x+
- Atlassian API token (not password)
- Project permissions: Browse Projects, Create Issues, Edit Issues, Transition Issues