feat: create GitHub autolink (#79)

Author: lemeurherve

create-github-autolink.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+set -e -o pipefail
+
+# Run this over repository to add GitHub autolink: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources
+
+: "${JIRA_MIGRATION_JIRA_PROJECT_NAME:? Missing Jira project name (e.g., JENKINS)}"
+: "${JIRA_MIGRATION_REDIRECTION_SERVICE? Missing URL of the redirection service (e.g., https://issue-redirect.jenkins.io)}"
+: "${JIRA_MIGRATION_CREATE_GITHUB_AUTOLINK:=false}"
+
+OWNER=${1:-timja-org}
+REPO=${2:-jenkins-gh-issues-poc-11-04}
+
+# Check for required commands
+if ! command -v gh >/dev/null 2>&1; then
+    echo "Error: 'gh' is required but not installed on this system." >&2
+    echo "Install it first. On macOS: brew install gh" >&2
+    exit 1
+fi
+
+github_repo="${OWNER}/${REPO}"
+
+if [[ "${JIRA_MIGRATION_CREATE_GITHUB_AUTOLINK}" == "true" ]]; then
+  gh repo autolink create "${JIRA_MIGRATION_JIRA_PROJECT_NAME}-" "${JIRA_MIGRATION_REDIRECTION_SERVICE}/${JIRA_MIGRATION_JIRA_PROJECT_NAME}-<num>" --numeric --repo "${github_repo}"
+else
+  echo "JIRA_MIGRATION_CREATE_GITHUB_AUTOLINK set to 'false', no GitHub autolink created."
+fi

orchestrate-migration.sh

@@ -57,6 +57,7 @@ REQUIRED_VARS=(
   "JIRA_MIGRATION_JIRA_TOKEN"
   "JIRA_MIGRATION_GITHUB_NAME"
   "JIRA_MIGRATION_GITHUB_ACCESS_TOKEN"
+  "JIRA_MIGRATION_CREATE_GITHUB_AUTOLINK"
 )
 
 for var in "${REQUIRED_VARS[@]}"; do
@@ -170,13 +171,13 @@ process_component() {
 
   # Step 1: Fetch issues from Jira
   log ""
-  log "Step 1/9: Fetching issues from Jira..."
+  log "Step 1/10: Fetching issues from Jira..."
   python3 ./fetch_issues.py
   validate_file "jira_output/result-0.xml" "Jira issues XML"
 
   # Step 2: Concatenate XML results
   log ""
-  log "Step 2/9: Concatenating XML results..."
+  log "Step 2/10: Concatenating XML results..."
   ./concatenate-xml-results.sh
   validate_file "jira_output/combined.xml" "Combined XML"
 
@@ -186,43 +187,48 @@ process_component() {
 
   # Step 3: Retrieve watchers and remote links
   log ""
-  log "Step 3/9: Retrieving watchers and remote links..."
+  log "Step 3/10: Retrieving watchers and remote links..."
   ./retrieve-watchers-and-remotelinks.sh
   validate_file "combined-remotelinks.txt" "Remote links"
 
   # Step 4: Enable GitHub Issues on repository
   log ""
-  log "Step 4/9: Enabling GitHub Issues on repository..."
+  log "Step 4/10: Enabling GitHub Issues on repository..."
   gh api -X PATCH "repos/$github_owner/$github_repo" --field has_issues=true || true
   log "✓ GitHub Issues enabled (or already enabled)"
 
   # Step 5: Import issues to GitHub
   log ""
-  log "Step 5/9: Importing issues to GitHub..."
+  log "Step 5/10: Importing issues to GitHub..."
   python3 -u ./main.py
   validate_file "jira-keys-to-github-id_${JIRA_MIGRATION_CURRENT_DATETIME}.txt" "Jira-to-GitHub mapping"
 
   # Step 6: Post-process epics
   log ""
-  log "Step 6/9: Post-processing epic relationships..."
+  log "Step 6/10: Post-processing epic relationships..."
   ./post_process_epics.sh "$github_owner" "$github_repo"
 
   # Step 7: Post-process issue types
   log ""
-  log "Step 7/9: Post-processing issue types..."
+  log "Step 7/10: Post-processing issue types..."
   ./post_process_issues.sh "$github_owner" "$github_repo"
 
   # Step 8: Add comments to Jira issues
   log ""
-  log "Step 8/9: Adding migration comments to Jira..."
+  log "Step 8/10: Adding migration comments to Jira..."
   export JIRA_GITHUB_MAPPING_FILE="jira-keys-to-github-id_${JIRA_MIGRATION_CURRENT_DATETIME}.txt"
   ./jira-commenter.sh
 
   # Step 9: Archive Jira component
   log ""
-  log "Step 9/9: Archiving Jira component..."
+  log "Step 9/10: Archiving Jira component..."
   ./jira-archive-component.sh "$component"
 
+  # Step 10: Create GitHub autolink
+  log ""
+  log "Step 10/10: Creating GitHub autolink..."
+  ./create-github-autolink.sh "$github_owner" "$github_repo"
+
   # Archive outputs
   log ""
   archive_component_outputs "$component"