clone-from-github

Name

jira:clone-from-github

Synopsis

/jira:clone-from-github <issue-number> [issue-number...] [options]

Description

The jira:clone-from-github command clones one or more GitHub issues to Jira, preserving the original issue content and establishing a link between the GitHub and Jira issues. This command is useful for:

• Migrating GitHub issues to Jira for project tracking
• Creating Jira tickets that track upstream GitHub issues
• Maintaining synchronization between GitHub and Jira workflows
• Bulk importing GitHub issues into Jira projects

The command uses the gh2jira utility to perform the cloning operation. Use /jira:setup-gh2jira to install and configure gh2jira if you haven't already.

Implementation

📋 Phase 1: Validate Prerequisites and Locate Installation

Check that the gh2jira utility is available and configured:

1. Locate gh2jira binary and installation directory:

   # Find the gh2jira binary
   GH2JIRA_BIN=$(which gh2jira 2>/dev/null)
   
   if [ -z "$GH2JIRA_BIN" ]; then
     echo "gh2jira not found. Run /jira:setup-gh2jira to install."
     exit 1
   fi
   
   # If it's a symlink, resolve it to find the actual installation
   if [ -L "$GH2JIRA_BIN" ]; then
     GH2JIRA_BIN=$(readlink "$GH2JIRA_BIN")
   fi
   
   # Get the directory containing the gh2jira binary
   GH2JIRA_DIR=$(dirname "$GH2JIRA_BIN")
   
   echo "Found gh2jira at: $GH2JIRA_DIR"
   

2. Verify configuration files exist in installation directory:

   cd "$GH2JIRA_DIR" || exit 1
   
   # Check for tokenstore.yaml
   if [ ! -f "tokenstore.yaml" ]; then
     echo "tokenstore.yaml not found in $GH2JIRA_DIR"
     echo "Run /jira:setup-gh2jira to configure authentication."
     exit 1
   fi
   
   # Check for profiles.yaml (optional)
   if [ -f "profiles.yaml" ]; then
     echo "Found profiles.yaml"
   fi
   

3. Verify tokens are configured:

   • Check that tokenstore.yaml contains actual tokens (not placeholder values)
   • GitHub token should not contain "YOUR_GITHUB_TOKEN"
   • Jira token should not contain "YOUR_JIRA_API_TOKEN"