# Clone the repository
cd bodywave-jira

# Install dependencies with uv
uv pip install -e .

# Or with pip
pip install -e .

cp .env.example .env

JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_USER_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token

# Run verification script
python main.py --verify

from src.jira_client import JiraClient
from src.config import load_config

# Initialize client
config = load_config()
client = JiraClient(config)

# Create an issue
issue = client.create_issue(
    project_key="BCM",
    summary="Implement new feature",
    description="Detailed description here",
    issue_type="Task"
)
print(f"Created: {issue.key}")

# Search issues
issues = client.search_issues_jql("project = BCM AND status = 'In Progress'")
for issue in issues:
    print(f"{issue.key}: {issue.summary}")

# Update an issue
client.update_issue(issue.key, summary="Updated summary")

# Delete an issue
client.delete_issue(issue.key)

# Start the MCP server
python -m src.mcp_orchestrator

# Or with custom configuration
python -m src.mcp_orchestrator --config config/production.json

from src.agile_manager import AgileManager

agile = AgileManager(client)

# Get current PI information
current_pi = agile.get_current_pi()
print(f"Current PI: {current_pi.name}")

# Get sprints in current PI
sprints = agile.get_sprints_for_pi(current_pi)
for sprint in sprints:
    print(f"  {sprint.name}: {sprint.state}")

# Create a new sprint
new_sprint = agile.create_sprint(
    board_id=1,
    name="BCM-Sprint-PI2025Q1-4",
    start_date="2025-03-01",
    end_date="2025-03-14"
)

from src.automation import AutomationEngine, IssueAutomation

# Initialize engine
engine = AutomationEngine(client)
issue_auto = IssueAutomation(engine)

# Auto-transition on PR events
await issue_auto.on_pr_opened("MGMT-123", "https://github.com/...", "Add feature")
# Issue transitions to "In Review"

await issue_auto.on_pr_merged("MGMT-123", "https://github.com/...")
# Issue transitions to "Done"

from src.session_hooks import SessionHooks

hooks = SessionHooks(client)

# Start session with context
context = await hooks.on_session_start(
    session_id="session-123",
    project_key="MGMT",
    board_id=3
)
# Returns sprint info and work items

# Track issue focus
await hooks.on_issue_focus("MGMT-123")

# End session with summary
summary = await hooks.on_session_end()
# Returns time spent per issue

from src.github_integration import GitHubContext, find_all_tickets, link_pr_to_tickets

# Extract tickets from GitHub context
ctx = GitHubContext(
    repo="org/repo",
    branch="MGMT-123/add-feature",
    pr_title="MGMT-123: Add new feature",
    pr_url="https://github.com/org/repo/pull/1"
)
tickets = find_all_tickets(ctx)
# Returns [JiraLink(ticket_id="MGMT-123", source="branch")]

# Link PR to all referenced tickets
await link_pr_to_tickets(client, ctx)

bodywave-jira/
├── src/
│   ├── __init__.py           # Package initialization
│   ├── jira_client.py        # Jira REST API client
│   ├── mcp_orchestrator.py   # MCP server logic
│   ├── agile_manager.py      # PI/Sprint management
│   ├── automation.py         # Automation workflows
│   ├── github_integration.py # GitHub-Jira linking
│   ├── session_hooks.py      # Session lifecycle hooks
│   ├── scrum_calculator.py   # Sprint calculations
│   ├── models.py             # Data models
│   ├── config.py             # Configuration management
│   ├── auth.py               # Authentication providers
│   └── exceptions.py         # Custom exceptions
├── tests/
│   ├── __init__.py
│   ├── test_jira_client.py
│   ├── test_orchestrator.py
│   ├── test_automation.py
│   ├── test_github_integration.py
│   ├── test_session_hooks.py
│   └── conftest.py           # Pytest fixtures
├── config/
│   └── projects.json         # Project definitions
├── .claude/
│   └── commands/             # Slash command definitions
├── .github/
│   └── workflows/            # CI/CD pipelines
├── main.py                   # Entry point
├── pyproject.toml            # Project configuration
├── .env.example              # Environment template
├── CLAUDE.md                 # Engineering guidelines
└── README.md                 # This file

{
  "projects": [
    {
      "key": "BCM",
      "name": "BCM Cloud",
      "sprint_duration_weeks": 2,
      "sprints_per_pi": 6
    },
    {
      "key": "INFRA",
      "name": "Brainsway Infrastructure",
      "sprint_duration_weeks": 3,
      "sprints_per_pi": 4
    }
  ]
}

from src.auth import OAuth2Provider

# When ready to migrate:
auth_provider = OAuth2Provider(
    client_id="your-client-id",
    client_secret="your-client-secret",
    redirect_uri="http://localhost:8080/callback"
)
client = JiraClient(config, auth_provider=auth_provider)

# Run all tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=src --cov-report=html

# Run specific test file
pytest tests/test_jira_client.py -v

# Run integration tests (requires real Jira access)
pytest tests/ -v --integration