infra-kit 0.1.78 → 0.1.80

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "infra-kit",
   "type": "module",
-  "version": "0.1.78",
+  "version": "0.1.80",
   "description": "infra-kit",
   "main": "dist/cli.js",
   "module": "dist/cli.js",
@@ -35,7 +35,6 @@
     "@inquirer/select": "^5.1.2",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "commander": "^14.0.3",
-    "dotenv": "^17.3.1",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
     "yaml": "^2.8.2",

package/src/commands/env-status/env-status.ts

@@ -21,7 +21,7 @@ import type { ToolsExecutionResult } from 'src/types'
 export const envStatus = async (): Promise<ToolsExecutionResult> => {
   await validateDopplerCliAndAuth()
 
-  logger.info('Environment Session Status:\n')
+  logger.info('Environment session status:')
 
   // Check session-loaded vars — getSessionCacheDir() throws if INFRA_KIT_SESSION is unset
   const cacheDir = getSessionCacheDir()
@@ -31,6 +31,7 @@ export const envStatus = async (): Promise<ToolsExecutionResult> => {
 
   let sessionLoadedCount = 0
   let sessionTotalCount = 0
+
   const sessionConfig = process.env[INFRA_KIT_ENV_CONFIG_VAR] ?? null
   const sessionProject = process.env[INFRA_KIT_ENV_PROJECT_VAR] ?? null
   const sessionLoadedAt = process.env[INFRA_KIT_ENV_LOADED_AT_VAR] ?? null
@@ -45,13 +46,14 @@ export const envStatus = async (): Promise<ToolsExecutionResult> => {
       }).length
     }
 
+    const loadedAtDisplay = sessionLoadedAt?.replace(/\.\d{3}Z$/, '') ?? null
+
     logger.info(
-      `  Session: ${sessionLoadedCount} of ${sessionTotalCount} vars loaded (project: ${sessionProject}, config: ${sessionConfig}, loaded at: ${sessionLoadedAt})`,
+      `  ${sessionConfig}: ${sessionLoadedCount} of ${sessionTotalCount} vars loaded (project: ${sessionProject}, loadedAt: ${loadedAtDisplay}, session: ${sessionId})\n`,
     )
   } else {
-    logger.info('  Session: no env loaded')
+    logger.info(`  Session ${sessionId}: no env loaded\n`)
   }
-  logger.info(`  Session ID: ${sessionId}`)
 
   const structuredContent = {
     sessionId,
@@ -82,7 +84,7 @@ export const envStatusMcpTool = {
     sessionId: z.string().describe('Current terminal session ID'),
     sessionLoadedCount: z.number().describe('Number of cached vars active in the current session'),
     sessionTotalCount: z.number().describe('Total number of cached var names'),
-    sessionConfig: z.string().nullable().describe('Doppler config name of the loaded session'),
+    sessionConfig: z.string().nullable().describe('Doppler config name of the loaded session (environment name)'),
     sessionProject: z.string().nullable().describe('Doppler project name of the loaded session'),
     sessionLoadedAt: z.string().nullable().describe('ISO 8601 timestamp of when the env was loaded'),
   },

package/src/commands/gh-merge-dev/gh-merge-dev.ts

@@ -5,9 +5,10 @@ import process from 'node:process'
 import { z } from 'zod'
 import { $ } from 'zx'
 
-import { getReleasePRs } from 'src/integrations/gh'
+import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { commandEcho } from 'src/lib/command-echo'
 import { logger } from 'src/lib/logger'
+import { detectReleaseType, formatBranchChoices, getJiraDescriptions } from 'src/lib/release-utils'
 import type { RequiredConfirmedOptionArg, ToolsExecutionResult } from 'src/types'
 
 interface GhMergeDevArgs extends RequiredConfirmedOptionArg {
@@ -22,7 +23,15 @@ export const ghMergeDev = async (args: GhMergeDevArgs): Promise<ToolsExecutionRe
 
   commandEcho.start('merge-dev')
 
-  const releasePRsList = await getReleasePRs()
+  // Only merge dev into regular releases (not hotfixes, which target main)
+  const allPRs = await getReleasePRsWithInfo()
+  const releasePRsList = allPRs
+    .filter((pr) => {
+      return detectReleaseType(pr.title) === 'regular'
+    })
+    .map((pr) => {
+      return pr.branch
+    })
 
   if (releasePRsList.length === 0) {
     logger.info('ℹ️ No open release branches found')
@@ -47,15 +56,12 @@ export const ghMergeDev = async (args: GhMergeDevArgs): Promise<ToolsExecutionRe
   } else {
     commandEcho.setInteractive()
 
+    const descriptions = await getJiraDescriptions()
+
     selectedReleaseBranches = await checkbox({
       required: true,
       message: '🌿 Select release branches',
-      choices: releasePRsList.map((pr) => {
-        return {
-          name: pr.replace('release/v', ''),
-          value: pr,
-        }
-      }),
+      choices: formatBranchChoices({ branches: releasePRsList, descriptions }),
     })
   }
 
@@ -65,7 +71,12 @@ export const ghMergeDev = async (args: GhMergeDevArgs): Promise<ToolsExecutionRe
   if (allSelected) {
     commandEcho.addOption('--all', true)
   } else {
-    commandEcho.addOption('--branches', selectedReleaseBranches)
+    commandEcho.addOption(
+      '--versions',
+      selectedReleaseBranches.map((branch) => {
+        return branch.replace('release/v', '')
+      }),
+    )
   }
 
   // Validate input

package/src/commands/gh-release-deliver/gh-release-deliver.ts

@@ -4,10 +4,12 @@ import process from 'node:process'
 import { z } from 'zod'
 import { $ } from 'zx'
 
-import { getReleasePRs } from 'src/integrations/gh'
+import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { deliverJiraRelease, loadJiraConfigOptional } from 'src/integrations/jira'
 import { commandEcho } from 'src/lib/command-echo'
 import { logger } from 'src/lib/logger'
+import { detectReleaseType, formatBranchChoices, getJiraDescriptions } from 'src/lib/release-utils'
+import type { ReleaseType } from 'src/lib/release-utils'
 import type { RequiredConfirmedOptionArg, ToolsExecutionResult } from 'src/types'
 
 interface GhReleaseDeliverArgs extends RequiredConfirmedOptionArg {
@@ -22,7 +24,17 @@ export const ghReleaseDeliver = async (args: GhReleaseDeliverArgs): Promise<Tool
 
   commandEcho.start('release-deliver')
 
-  const releasePRsList = await getReleasePRs()
+  const releasePRsInfo = await getReleasePRsWithInfo()
+
+  const branches = releasePRsInfo.map((pr) => {
+    return pr.branch
+  })
+
+  const releaseTypes = new Map<string, ReleaseType>(
+    releasePRsInfo.map((pr) => {
+      return [pr.branch, detectReleaseType(pr.title)]
+    }),
+  )
 
   let selectedReleaseBranch = '' // "release/v1.8.0"
 
@@ -31,14 +43,11 @@ export const ghReleaseDeliver = async (args: GhReleaseDeliverArgs): Promise<Tool
   } else {
     commandEcho.setInteractive()
 
+    const descriptions = await getJiraDescriptions()
+
     selectedReleaseBranch = await select({
       message: '🌿 Select release branch',
-      choices: releasePRsList.map((pr) => {
-        return {
-          name: pr.replace('release/v', ''),
-          value: pr,
-        }
-      }),
+      choices: formatBranchChoices({ branches, descriptions, types: releaseTypes }),
     })
   }
 
@@ -47,11 +56,17 @@ export const ghReleaseDeliver = async (args: GhReleaseDeliverArgs): Promise<Tool
   commandEcho.addOption('--version', selectedVersion)
 
   // Check if release branch exists in the list
-  if (!releasePRsList.includes(selectedReleaseBranch)) {
+  const prInfo = releasePRsInfo.find((pr) => {
+    return pr.branch === selectedReleaseBranch
+  })
+
+  if (!prInfo) {
     logger.error(`❌ Release branch ${selectedReleaseBranch} not found in open PRs. Exiting...`)
     process.exit(1)
   }
 
+  const releaseType: ReleaseType = detectReleaseType(prInfo.title)
+
   const answer = confirmedCommand
     ? true
     : await confirm({
@@ -73,18 +88,33 @@ export const ghReleaseDeliver = async (args: GhReleaseDeliverArgs): Promise<Tool
   try {
     $.quiet = true
 
-    await $`gh pr merge ${selectedReleaseBranch} --squash --admin --delete-branch` // TODO: add --body (AI for generate message)
-    await $`gh pr create --base main --head dev --title "Release v${selectedReleaseBranch.replace('release/v', '')} (RC)" --body ""`
-    await $`gh pr merge dev --squash --admin`
+    if (releaseType === 'hotfix') {
+      // Hotfix: merge directly into main, deploy, sync back to dev
+      await $`gh pr merge ${selectedReleaseBranch} --squash --admin --delete-branch`
 
-    $.quiet = false
+      $.quiet = false
 
-    await $`gh workflow run deploy-all.yml --ref main -f environment=prod`
+      await $`gh workflow run deploy-all.yml --ref main -f environment=prod`
 
-    $.quiet = true
+      $.quiet = true
 
-    // Merge main into dev
-    await $`git switch main && git pull && git switch dev && git pull && git merge main --no-edit && git push`
+      // Sync main into dev
+      await $`git switch main && git pull && git switch dev && git pull && git merge main --no-edit && git push`
+    } else {
+      // Regular: merge into dev, create RC PR to main, merge to main, deploy, sync
+      await $`gh pr merge ${selectedReleaseBranch} --squash --admin --delete-branch`
+      await $`gh pr create --base main --head dev --title "Release v${selectedVersion} (RC)" --body ""`
+      await $`gh pr merge dev --squash --admin`
+
+      $.quiet = false
+
+      await $`gh workflow run deploy-all.yml --ref main -f environment=prod`
+
+      $.quiet = true
+
+      // Sync main into dev
+      await $`git switch main && git pull && git switch dev && git pull && git merge main --no-edit && git push`
+    }
 
     $.quiet = false
 
@@ -96,16 +126,6 @@ export const ghReleaseDeliver = async (args: GhReleaseDeliverArgs): Promise<Tool
         const versionName = selectedReleaseBranch.replace('release/', '')
 
         await deliverJiraRelease({ versionName }, jiraConfig)
-        // const result = await deliverJiraRelease({ versionName }, jiraConfig)
-
-        // logger.info(
-        //   {
-        //     // versionId: result.version.id,
-        //     versionName: result.version.name,
-        //     // releaseDate: result.version.releaseDate,
-        //   },
-        //   'Successfully delivered Jira release',
-        // )
       } catch (error) {
         logger.error({ error }, 'Failed to deliver Jira release (non-blocking)')
       }
@@ -120,6 +140,7 @@ export const ghReleaseDeliver = async (args: GhReleaseDeliverArgs): Promise<Tool
     const structuredContent = {
       releaseBranch: selectedReleaseBranch,
       version: selectedReleaseBranch.replace('release/v', ''),
+      type: releaseType,
       success: true,
     }
 
@@ -148,6 +169,7 @@ export const ghReleaseDeliverMcpTool = {
   outputSchema: {
     releaseBranch: z.string().describe('The release branch that was delivered'),
     version: z.string().describe('The version that was delivered'),
+    type: z.enum(['regular', 'hotfix']).describe('Release type'),
     success: z.boolean().describe('Whether the delivery was successful'),
   },
   handler: ghReleaseDeliver,

package/src/commands/gh-release-deploy-all/gh-release-deploy-all.ts

@@ -3,10 +3,12 @@ import process from 'node:process'
 import { z } from 'zod'
 import { $ } from 'zx'
 
-import { getReleasePRs } from 'src/integrations/gh'
+import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { commandEcho } from 'src/lib/command-echo'
 import { ENVs } from 'src/lib/constants'
 import { logger } from 'src/lib/logger'
+import { detectReleaseType, formatBranchChoices, getJiraDescriptions } from 'src/lib/release-utils'
+import type { ReleaseType } from 'src/lib/release-utils'
 import type { ToolsExecutionResult } from 'src/types'
 
 interface GhReleaseDeployAllArgs {
@@ -25,11 +27,19 @@ export const ghReleaseDeployAll = async (args: GhReleaseDeployAllArgs): Promise<
 
   // TODO: add validation for semver version for version variable
 
-  const releasePRsList: string[] = ['dev'] // ["release/v1.8.0", "release/v1.9.0"]
+  const releasePRsInfo = await getReleasePRsWithInfo()
 
-  const releasePRs = await getReleasePRs()
+  const branches = releasePRsInfo.map((pr) => {
+    return pr.branch
+  })
 
-  releasePRsList.push(...releasePRs)
+  const releaseTypes = new Map<string, ReleaseType>(
+    releasePRsInfo.map((pr) => {
+      return [pr.branch, detectReleaseType(pr.title)]
+    }),
+  )
+
+  const releasePRsList: string[] = ['dev', ...branches]
 
   let selectedReleaseBranch = '' // "release/v1.8.0"
 
@@ -38,14 +48,11 @@ export const ghReleaseDeployAll = async (args: GhReleaseDeployAllArgs): Promise<
   } else {
     commandEcho.setInteractive()
 
+    const descriptions = await getJiraDescriptions()
+
     selectedReleaseBranch = await select({
       message: '🌿 Select release branch',
-      choices: releasePRsList.map((pr) => {
-        return {
-          name: pr.replace('release/v', ''),
-          value: pr,
-        }
-      }),
+      choices: [{ name: 'dev', value: 'dev' }, ...formatBranchChoices({ branches, descriptions, types: releaseTypes })],
     })
   }
 

package/src/commands/gh-release-deploy-selected/gh-release-deploy-selected.ts

@@ -7,11 +7,13 @@ import yaml from 'yaml'
 import { z } from 'zod'
 import { $ } from 'zx'
 
-import { getReleasePRs } from 'src/integrations/gh'
+import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { commandEcho } from 'src/lib/command-echo'
 import { ENVs } from 'src/lib/constants'
 import { getProjectRoot } from 'src/lib/git-utils'
 import { logger } from 'src/lib/logger'
+import { detectReleaseType, formatBranchChoices, getJiraDescriptions } from 'src/lib/release-utils'
+import type { ReleaseType } from 'src/lib/release-utils'
 import type { ToolsExecutionResult } from 'src/types'
 
 interface GhReleaseDeploySelectedArgs {
@@ -30,11 +32,19 @@ export const ghReleaseDeploySelected = async (args: GhReleaseDeploySelectedArgs)
 
   commandEcho.start('release-deploy-selected')
 
-  const releasePRsList: string[] = ['dev']
+  const releasePRsInfo = await getReleasePRsWithInfo()
 
-  const releasePRs = await getReleasePRs()
+  const branches = releasePRsInfo.map((pr) => {
+    return pr.branch
+  })
+
+  const releaseTypes = new Map<string, ReleaseType>(
+    releasePRsInfo.map((pr) => {
+      return [pr.branch, detectReleaseType(pr.title)]
+    }),
+  )
 
-  releasePRsList.push(...releasePRs)
+  const releasePRsList: string[] = ['dev', ...branches]
 
   let selectedReleaseBranch = ''
 
@@ -43,14 +53,11 @@ export const ghReleaseDeploySelected = async (args: GhReleaseDeploySelectedArgs)
   } else {
     commandEcho.setInteractive()
 
+    const descriptions = await getJiraDescriptions()
+
     selectedReleaseBranch = await select({
       message: '🌿 Select release branch',
-      choices: releasePRsList.map((pr) => {
-        return {
-          name: pr.replace('release/v', ''),
-          value: pr,
-        }
-      }),
+      choices: [{ name: 'dev', value: 'dev' }, ...formatBranchChoices({ branches, descriptions, types: releaseTypes })],
     })
   }
 

package/src/commands/gh-release-deploy-service/gh-release-deploy-service.ts

@@ -6,11 +6,13 @@ import yaml from 'yaml'
 import { z } from 'zod'
 import { $ } from 'zx'
 
-import { getReleasePRs } from 'src/integrations/gh'
+import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { commandEcho } from 'src/lib/command-echo'
 import { ENVs } from 'src/lib/constants'
 import { getProjectRoot } from 'src/lib/git-utils'
 import { logger } from 'src/lib/logger'
+import { detectReleaseType, formatBranchChoices, getJiraDescriptions } from 'src/lib/release-utils'
+import type { ReleaseType } from 'src/lib/release-utils'
 import type { ToolsExecutionResult } from 'src/types'
 
 interface GhReleaseDeployServiceArgs {
@@ -30,11 +32,19 @@ export const ghReleaseDeployService = async (args: GhReleaseDeployServiceArgs):
 
   // TODO: add validation for semver version for version variable
 
-  const releasePRsList: string[] = ['dev'] // ["release/v1.8.0", "release/v1.9.0"]
+  const releasePRsInfo = await getReleasePRsWithInfo()
 
-  const releasePRs = await getReleasePRs()
+  const branches = releasePRsInfo.map((pr) => {
+    return pr.branch
+  })
 
-  releasePRsList.push(...releasePRs)
+  const releaseTypes = new Map<string, ReleaseType>(
+    releasePRsInfo.map((pr) => {
+      return [pr.branch, detectReleaseType(pr.title)]
+    }),
+  )
+
+  const releasePRsList: string[] = ['dev', ...branches]
 
   let selectedReleaseBranch = '' // "release/v1.8.0"
 
@@ -43,14 +53,11 @@ export const ghReleaseDeployService = async (args: GhReleaseDeployServiceArgs):
   } else {
     commandEcho.setInteractive()
 
+    const descriptions = await getJiraDescriptions()
+
     selectedReleaseBranch = await select({
       message: '🌿 Select release branch',
-      choices: releasePRsList.map((pr) => {
-        return {
-          name: pr.replace('release/v', ''),
-          value: pr,
-        }
-      }),
+      choices: [{ name: 'dev', value: 'dev' }, ...formatBranchChoices({ branches, descriptions, types: releaseTypes })],
     })
   }
 

package/src/commands/gh-release-list/gh-release-list.ts

@@ -1,25 +1,54 @@
 import { z } from 'zod'
 
-import { getReleasePRs } from 'src/integrations/gh'
+import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { logger } from 'src/lib/logger'
+import { detectReleaseType, formatVersionLabel, getJiraDescriptions } from 'src/lib/release-utils'
 import type { ToolsExecutionResult } from 'src/types'
 
 /**
  * List all open release branches
  */
 export const ghReleaseList = async (): Promise<ToolsExecutionResult> => {
-  const releasePRs = await getReleasePRs()
+  const releasePRs = await getReleasePRsWithInfo()
 
-  const releasePRsList = releasePRs.map((pr) => {
-    return pr.replace('release/', '')
+  const releases = releasePRs.map((pr) => {
+    return {
+      version: pr.branch.replace('release/', ''),
+      type: detectReleaseType(pr.title),
+    }
+  })
+
+  const jiraDescriptions = await getJiraDescriptions()
+
+  const maxVersionLength = Math.max(
+    ...releases.map((r) => {
+      return r.version.length
+    }),
+  )
+
+  const formattedLines = releases.map((release) => {
+    const label = formatVersionLabel(release.version, release.type, maxVersionLength)
+    const description = jiraDescriptions.get(release.version)
+
+    if (description) {
+      return `${label}  ${description}`
+    }
+
+    return label
   })
 
   logger.info('All release branches: \n')
-  logger.info(`\n${releasePRsList.join('\n')}`)
+  logger.info(`\n${formattedLines.join('\n')}\n`)
 
   const structuredContent = {
-    releases: releasePRsList,
-    count: releasePRsList.length,
+    releases: releases.map((release) => {
+      return {
+        version: release.version,
+        type: release.type,
+        description: jiraDescriptions.get(release.version) || null,
+      }
+    }),
+    count: releases.length,
   }
 
   return {
@@ -39,7 +68,15 @@ export const ghReleaseListMcpTool = {
   description: 'List all open release branches',
   inputSchema: {},
   outputSchema: {
-    releases: z.array(z.string()).describe('List of all release branches'),
+    releases: z
+      .array(
+        z.object({
+          version: z.string().describe('Release version'),
+          type: z.enum(['regular', 'hotfix']).describe('Release type'),
+          description: z.string().nullable().describe('Jira version description'),
+        }),
+      )
+      .describe('List of all release branches'),
     count: z.number().describe('Number of release branches'),
   },
   handler: ghReleaseList,

package/src/commands/release-create/release-create.ts

@@ -1,4 +1,5 @@
 import confirm from '@inquirer/confirm'
+import select from '@inquirer/select'
 import process from 'node:process'
 import { z } from 'zod'
 import { $, question } from 'zx'
@@ -7,11 +8,13 @@ import { loadJiraConfig } from 'src/integrations/jira'
 import { commandEcho } from 'src/lib/command-echo'
 import { logger } from 'src/lib/logger'
 import { createSingleRelease, prepareGitForRelease } from 'src/lib/release-utils'
+import type { ReleaseType } from 'src/lib/release-utils'
 import type { RequiredConfirmedOptionArg, ToolsExecutionResult } from 'src/types'
 
 interface ReleaseCreateArgs extends RequiredConfirmedOptionArg {
   version?: string
   description?: string
+  type?: ReleaseType
   checkout?: boolean
 }
 
@@ -20,12 +23,19 @@ interface ReleaseCreateArgs extends RequiredConfirmedOptionArg {
  * Includes Jira version creation and GitHub release branch creation
  */
 export const releaseCreate = async (args: ReleaseCreateArgs): Promise<ToolsExecutionResult> => {
-  const { version: inputVersion, description: inputDescription, confirmedCommand, checkout: inputCheckout } = args
+  const {
+    version: inputVersion,
+    description: inputDescription,
+    type: inputType,
+    confirmedCommand,
+    checkout: inputCheckout,
+  } = args
 
   commandEcho.start('release-create')
 
   let version = inputVersion
   let description = inputDescription
+  let type: ReleaseType = inputType || 'regular'
   let checkout = inputCheckout
 
   // Load Jira config - it is now mandatory
@@ -46,6 +56,21 @@ export const releaseCreate = async (args: ReleaseCreateArgs): Promise<ToolsExecu
 
   commandEcho.addOption('--version', trimmedVersion)
 
+  if (!inputType) {
+    commandEcho.setInteractive()
+
+    type = await select<ReleaseType>({
+      message: 'Select release type:',
+      choices: [
+        { name: 'regular', value: 'regular' },
+        { name: 'hotfix', value: 'hotfix' },
+      ],
+      default: 'regular',
+    })
+  }
+
+  commandEcho.addOption('--type', type)
+
   if (description === undefined) {
     commandEcho.setInteractive()
     description = await question('Enter description (optional, press Enter to skip): ')
@@ -77,10 +102,10 @@ export const releaseCreate = async (args: ReleaseCreateArgs): Promise<ToolsExecu
   // Track --yes flag if confirmation was interactive (user confirmed)
   commandEcho.addOption('--yes', true)
 
-  await prepareGitForRelease()
+  await prepareGitForRelease(type)
 
   // Create the release
-  const release = await createSingleRelease(trimmedVersion, jiraConfig, description)
+  const release = await createSingleRelease({ version: trimmedVersion, jiraConfig, description, type })
 
   logger.info(`✅ Successfully created release: v${trimmedVersion}`)
   logger.info(`🔗  GitHub PR: ${release.prUrl}`)
@@ -114,6 +139,7 @@ export const releaseCreate = async (args: ReleaseCreateArgs): Promise<ToolsExecu
 
   const structuredContent = {
     version: trimmedVersion,
+    type,
     branchName: release.branchName,
     prUrl: release.prUrl,
     jiraVersionUrl: release.jiraVersionUrl,
@@ -138,10 +164,16 @@ export const releaseCreateMcpTool = {
   inputSchema: {
     version: z.string().describe('Version to create (e.g., "1.2.5")'),
     description: z.string().optional().describe('Optional description for the Jira version'),
+    type: z
+      .enum(['regular', 'hotfix'])
+      .optional()
+      .default('regular')
+      .describe('Release type: "regular" or "hotfix" (default: "regular")'),
     checkout: z.boolean().optional().default(true).describe('Checkout to the created branch (default: true)'),
   },
   outputSchema: {
     version: z.string().describe('Version number'),
+    type: z.enum(['regular', 'hotfix']).describe('Release type'),
     branchName: z.string().describe('Release branch name'),
     prUrl: z.string().describe('GitHub PR URL'),
     jiraVersionUrl: z.string().describe('Jira version URL'),