update jira client

Author: jon23d

JIRA_SETUP.md

@@ -89,7 +89,7 @@ No cloud ID resolution, no OAuth token exchange, no session state.
 
 | Variable | Required | Description |
 |---|---|---|
-| `JIRA_EMAIL` | Yes | Your Atlassian account email |
+| `JIRA_EMAIL` | Yes | Your Atlassian account email. Also used as your identity — issues are auto-assigned to this account when transitioning to In Progress, and `jira-assign-issue` accepts `"me"` to assign to this address. |
 | `JIRA_API_TOKEN` | Yes | API token from id.atlassian.com/manage-api-tokens |
 | `JIRA_BASE_URL` | No | Overrides `agent-config.json` base_url at runtime |
 | `JIRA_PROJECT_KEY` | No | Overrides `agent-config.json` project_key at runtime |

tools/jira-assign-issue.ts

@@ -1,31 +1,44 @@
 import { tool } from "@opencode-ai/plugin"
-import { getJiraClient } from "./lib/jira-client"
+import { getJiraClient, resolveAccountIdByEmail } from "./lib/jira-client"
 
 export default tool({
   description:
-    "Assign a Jira issue to a user by their accountId. Use jira-search-users to find the accountId for a user by display name or email. Pass empty string to unassign. Requires Jira credentials — see JIRA_SETUP.md.",
+    "Assign a Jira issue to a user. Pass 'me' to assign to yourself (uses JIRA_EMAIL), a Jira accountId to assign to someone else, or empty string to unassign. Use jira-search-users to find accountIds by name or email. Requires Jira credentials — see JIRA_SETUP.md.",
   args: {
     issue_key: tool.schema.string().describe("Issue key, e.g. 'PROJ-123'"),
     account_id: tool.schema
       .string()
       .describe(
-        "The Jira accountId of the user to assign. Use jira-search-users to find this. Pass empty string to unassign."
+        "Pass 'me' to assign to yourself, a Jira accountId to assign to a specific user, or empty string to unassign."
       ),
   },
   async execute(args) {
     const result = getJiraClient()
     if ("error" in result) return result.error
-    const { client } = result
+    const { client, currentUserEmail } = result
 
     try {
+      let accountId: string | null = args.account_id || null
+
+      // Resolve "me" to the current user's accountId
+      if (args.account_id === "me") {
+        if (!currentUserEmail) {
+          return "Cannot resolve 'me' — JIRA_EMAIL is not set."
+        }
+        accountId = await resolveAccountIdByEmail(client, currentUserEmail)
+        if (!accountId) {
+          return `Could not find a Jira account for ${currentUserEmail}. Check that this email matches a Jira user.`
+        }
+      }
+
       await client.issues.assignIssue({
         issueIdOrKey: args.issue_key,
-        accountId: args.account_id || null,
+        accountId,
       })
 
-      return args.account_id
-        ? `${args.issue_key} assigned to accountId ${args.account_id}`
-        : `${args.issue_key} unassigned`
+      if (!accountId) return `${args.issue_key} unassigned`
+      if (args.account_id === "me") return `${args.issue_key} assigned to you (${currentUserEmail})`
+      return `${args.issue_key} assigned to accountId ${accountId}`
     } catch (error: unknown) {
       const e = error as { status?: number; message?: string }
       return `Failed to assign ${args.issue_key}: ${e.status ?? ""} ${e.message ?? String(error)}`

tools/jira-transition-issue.ts

@@ -1,9 +1,9 @@
 import { tool } from "@opencode-ai/plugin"
-import { getJiraClient } from "./lib/jira-client"
+import { getJiraClient, resolveAccountIdByEmail } from "./lib/jira-client"
 
 export default tool({
   description:
-    "Change the status of a Jira issue by applying a workflow transition. Omit transition_name to list all available transitions for the issue first. Requires Jira credentials — see JIRA_SETUP.md.",
+    "Change the status of a Jira issue by applying a workflow transition. When transitioning to 'In Progress', automatically assigns the issue to the current user (JIRA_EMAIL). Omit transition_name to list all available transitions. Requires Jira credentials — see JIRA_SETUP.md.",
   args: {
     issue_key: tool.schema.string().describe("Issue key, e.g. 'PROJ-123'"),
     transition_name: tool.schema
@@ -16,7 +16,7 @@ export default tool({
   async execute(args) {
     const result = getJiraClient()
     if ("error" in result) return result.error
-    const { client } = result
+    const { client, currentUserEmail } = result
 
     try {
       // Fetch available transitions
@@ -45,7 +45,19 @@ export default tool({
         transition: { id: match.id },
       })
 
-      return `${args.issue_key} transitioned to "${args.transition_name}"`
+      const notes: string[] = [`${args.issue_key} transitioned to "${args.transition_name}"`]
+
+      // Auto-assign to current user when moving to In Progress
+      const isInProgress = args.transition_name.toLowerCase() === "in progress"
+      if (isInProgress && currentUserEmail) {
+        const accountId = await resolveAccountIdByEmail(client, currentUserEmail)
+        if (accountId) {
+          await client.issues.assignIssue({ issueIdOrKey: args.issue_key, accountId })
+          notes.push(`Assigned to ${currentUserEmail}`)
+        }
+      }
+
+      return notes.join("\n")
     } catch (error: unknown) {
       const e = error as { status?: number; message?: string }
       return `Failed to transition ${args.issue_key}: ${e.status ?? ""} ${e.message ?? String(error)}`

tools/lib/jira-client.ts

@@ -12,13 +12,15 @@ function readJiraConfig(): { base_url?: string; project_key?: string } {
 }
 
 export function getJiraClient():
-  | { client: Version3Client; projectKey: string; host: string }
+  | { client: Version3Client; projectKey: string; host: string; currentUserEmail: string | null }
   | { error: string } {
   const jiraConfig = readJiraConfig()
   const host = (process.env.JIRA_BASE_URL ?? jiraConfig.base_url ?? "").replace(/\/$/, "")
   const projectKey = process.env.JIRA_PROJECT_KEY ?? jiraConfig.project_key ?? ""
   const email = process.env.JIRA_EMAIL
   const apiToken = process.env.JIRA_API_TOKEN
+  // The auth email is the current user
+  const currentUserEmail = process.env.JIRA_EMAIL ?? null
 
   if (!host) {
     return {
@@ -39,7 +41,26 @@ export function getJiraClient():
     authentication: { basic: { email, apiToken } },
   })
 
-  return { client, projectKey, host }
+  return { client, projectKey, host, currentUserEmail }
+}
+
+/**
+ * Resolve the accountId for a given email by searching Jira users.
+ * Returns null if not found.
+ */
+export async function resolveAccountIdByEmail(
+  client: Version3Client,
+  email: string
+): Promise<string | null> {
+  try {
+    const users = await client.userSearch.findUsers({ query: email, maxResults: 5 })
+    const match = users.find(
+      (u) => u.emailAddress?.toLowerCase() === email.toLowerCase()
+    ) ?? users[0]
+    return match?.accountId ?? null
+  } catch {
+    return null
+  }
 }
 
 /** Convert plain text to Atlassian Document Format (ADF) for Jira API v3 */