@pennyfarthing/core 7.4.0 → 7.4.1

package/pennyfarthing-dist/scripts/jira/jira-reconcile.sh

@@ -0,0 +1,266 @@
+#!/bin/bash
+# Jira vs YAML Reconciliation Report
+# Usage: .pennyfarthing/scripts/core/run.sh jira/jira-reconcile.sh [--fix]
+#
+# Compares sprint YAML against Jira to find:
+# - Status mismatches
+# - Missing Jira keys
+# - Orphan issues (in Jira but not YAML)
+# - Sprint membership discrepancies
+#
+# Options:
+#   --fix    Apply recommended fixes automatically (where safe)
+
+set -euo pipefail
+
+# PROJECT_ROOT should be set by run.sh, but find it if not
+if [[ -z "${PROJECT_ROOT:-}" ]]; then
+  d="$PWD"
+  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+    d="$(dirname "$d")"
+  done
+  PROJECT_ROOT="$d"
+fi
+
+SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
+FIX_MODE="${1:-}"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check dependencies
+if ! command -v yq &> /dev/null; then
+  echo "Error: yq is required but not installed"
+  echo "Install with: brew install yq"
+  exit 1
+fi
+
+if ! command -v jira &> /dev/null; then
+  echo "Error: jira CLI is required but not installed"
+  echo "Install with: brew install ankitpokhrel/jira/jira"
+  exit 1
+fi
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+# Get sprint info
+SPRINT_NAME=$(yq eval '.sprint.name' "$SPRINT_FILE")
+SPRINT_ID=$(yq eval '.sprint.jira_sprint_id' "$SPRINT_FILE")
+
+echo "# Jira vs YAML Reconciliation Report"
+echo ""
+echo "**Sprint:** $SPRINT_NAME (Jira Sprint ID: $SPRINT_ID)"
+echo "**Generated:** $(date '+%Y-%m-%d %H:%M')"
+echo ""
+
+# Track issues
+STATUS_MISMATCHES=()
+MISSING_JIRA=()
+ORPHAN_ISSUES=()
+NOT_IN_SPRINT=()
+
+echo "## Checking YAML Stories Against Jira..."
+echo ""
+
+# Extract all stories from YAML and check against Jira
+while IFS=$'\t' read -r yaml_id jira_key yaml_status title; do
+  # Skip if no jira key
+  if [[ "$jira_key" == "null" ]] || [[ -z "$jira_key" ]]; then
+    MISSING_JIRA+=("$yaml_id|$title|$yaml_status")
+    continue
+  fi
+
+  # Get Jira status - use sed to remove the key prefix
+  jira_status=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns key,status --no-headers 2>/dev/null | sed "s/^$jira_key[[:space:]]*//" | xargs || echo "NOT_FOUND")
+
+  if [[ "$jira_status" == "NOT_FOUND" ]] || [[ -z "$jira_status" ]]; then
+    echo -e "${RED}[!]${NC} $jira_key not found in Jira"
+    continue
+  fi
+
+  # Normalize statuses for comparison
+  jira_norm=$(echo "$jira_status" | tr '[:upper:]' '[:lower:]' | tr ' ' '_')
+
+  # Check for mismatches
+  mismatch=false
+  case "$yaml_status" in
+    done)
+      [[ "$jira_norm" != "done" ]] && mismatch=true
+      ;;
+    ready|backlog)
+      [[ "$jira_norm" != "to_do" ]] && mismatch=true
+      ;;
+    in_progress)
+      [[ "$jira_norm" != "in_progress" ]] && mismatch=true
+      ;;
+  esac
+
+  if [[ "$mismatch" == "true" ]]; then
+    STATUS_MISMATCHES+=("$jira_key|$yaml_status|$jira_status")
+  fi
+done < <(yq -r '.epics[].stories[]? | [.id, .jira, .status, .title] | @tsv' "$SPRINT_FILE" 2>/dev/null)
+
+echo ""
+echo "## Checking Jira Sprint Against YAML..."
+echo ""
+
+# Get all issues in the Jira sprint and check if they're in YAML
+# Skip canceled issues - they're not relevant
+while read -r jira_key; do
+  # Check if in YAML (by id or jira field)
+  in_yaml=$(yq -r ".epics[].stories[]? | select(.id == \"$jira_key\" or .jira == \"$jira_key\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
+
+  if [[ -z "$in_yaml" ]]; then
+    # Get more info about the orphan
+    status=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns key,status --no-headers 2>/dev/null | sed "s/^$jira_key[[:space:]]*//" | xargs || echo "Unknown")
+
+    # Skip canceled issues
+    if [[ "$status" == "Canceled" ]]; then
+      continue
+    fi
+
+    summary=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns key,summary --no-headers 2>/dev/null | sed "s/^$jira_key[[:space:]]*//" | xargs || echo "Unknown")
+    ORPHAN_ISSUES+=("$jira_key|$status|$summary")
+  fi
+done < <(jira issue list --jql "project=MSSCI AND labels=pennyfarthing AND sprint=$SPRINT_ID AND status != Canceled" --plain --columns key --no-headers 2>/dev/null)
+
+echo ""
+echo "## Checking for Issues Not in Sprint..."
+echo ""
+
+# Get done issues not in sprint
+while read -r jira_key; do
+  # Check if it should be in current sprint (exists in YAML)
+  in_yaml=$(yq -r ".epics[].stories[]? | select(.id == \"$jira_key\" or .jira == \"$jira_key\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
+
+  if [[ -n "$in_yaml" ]]; then
+    summary=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns summary --no-headers 2>/dev/null | xargs || echo "Unknown")
+    NOT_IN_SPRINT+=("$jira_key|$summary")
+  fi
+done < <(jira issue list --jql "project=MSSCI AND labels=pennyfarthing AND sprint is EMPTY AND status != Canceled" --plain --columns key --no-headers 2>/dev/null)
+
+# Output Report
+echo ""
+echo "---"
+echo ""
+echo "# Summary"
+echo ""
+
+# Status Mismatches
+echo "## Status Mismatches (${#STATUS_MISMATCHES[@]})"
+echo ""
+if [[ ${#STATUS_MISMATCHES[@]} -eq 0 ]]; then
+  echo -e "${GREEN}No status mismatches found.${NC}"
+else
+  echo "| Jira Key | YAML Status | Jira Status | Action |"
+  echo "|----------|-------------|-------------|--------|"
+  for item in "${STATUS_MISMATCHES[@]}"; do
+    IFS='|' read -r key yaml jira <<< "$item"
+    echo "| $key | $yaml | $jira | Update YAML or Jira |"
+  done
+fi
+echo ""
+
+# Missing Jira Keys
+echo "## YAML Stories Missing Jira Key (${#MISSING_JIRA[@]})"
+echo ""
+if [[ ${#MISSING_JIRA[@]} -eq 0 ]]; then
+  echo -e "${GREEN}All YAML stories have Jira keys.${NC}"
+else
+  echo "| YAML ID | Title | Status | Action |"
+  echo "|---------|-------|--------|--------|"
+  for item in "${MISSING_JIRA[@]}"; do
+    IFS='|' read -r id title status <<< "$item"
+    echo "| $id | ${title:0:40} | $status | Create Jira issue |"
+  done
+fi
+echo ""
+
+# Orphan Issues
+echo "## Jira Issues Not in YAML (${#ORPHAN_ISSUES[@]})"
+echo ""
+if [[ ${#ORPHAN_ISSUES[@]} -eq 0 ]]; then
+  echo -e "${GREEN}All sprint issues are tracked in YAML.${NC}"
+else
+  echo "| Jira Key | Status | Summary | Action |"
+  echo "|----------|--------|---------|--------|"
+  for item in "${ORPHAN_ISSUES[@]}"; do
+    IFS='|' read -r key status summary <<< "$item"
+    if [[ "$status" == "Done" ]]; then
+      echo "| $key | $status | ${summary:0:40} | Info: Completed (not in current YAML) |"
+    else
+      echo "| $key | $status | ${summary:0:40} | Add to YAML or remove from sprint |"
+    fi
+  done
+  echo ""
+  echo "*Note: Done issues not in YAML are historical - they count toward sprint velocity but aren't actively tracked.*"
+fi
+echo ""
+
+# Not in Sprint
+echo "## YAML Stories Not in Jira Sprint (${#NOT_IN_SPRINT[@]})"
+echo ""
+if [[ ${#NOT_IN_SPRINT[@]} -eq 0 ]]; then
+  echo -e "${GREEN}All YAML stories are in Jira sprint.${NC}"
+else
+  echo "| Jira Key | Summary | Action |"
+  echo "|----------|---------|--------|"
+  for item in "${NOT_IN_SPRINT[@]}"; do
+    IFS='|' read -r key summary <<< "$item"
+    echo "| $key | ${summary:0:50} | Add to sprint $SPRINT_ID |"
+  done
+fi
+echo ""
+
+# Epic check
+echo "## Epic Sync Check"
+echo ""
+echo "| YAML Epic ID | Jira Field | Status |"
+echo "|--------------|------------|--------|"
+while IFS=$'\t' read -r epic_id jira_key title; do
+  if [[ "$jira_key" == "null" ]] || [[ -z "$jira_key" ]]; then
+    echo -e "| $epic_id | ${RED}MISSING${NC} | $title |"
+  else
+    echo "| $epic_id | $jira_key | $title |"
+  fi
+done < <(yq -r '.epics[] | [.id, .jira, .title] | @tsv' "$SPRINT_FILE" 2>/dev/null)
+echo ""
+
+# Total counts
+total_issues=$((${#STATUS_MISMATCHES[@]} + ${#MISSING_JIRA[@]} + ${#ORPHAN_ISSUES[@]} + ${#NOT_IN_SPRINT[@]}))
+
+echo "---"
+echo ""
+if [[ $total_issues -eq 0 ]]; then
+  echo -e "${GREEN}Sync Status: CLEAN${NC} - No discrepancies found!"
+else
+  echo -e "${YELLOW}Sync Status: $total_issues issue(s) found${NC}"
+  echo ""
+  echo "Run with --fix to apply automatic fixes where possible."
+fi
+
+# Fix mode
+if [[ "$FIX_MODE" == "--fix" ]]; then
+  echo ""
+  echo "## Applying Fixes..."
+  echo ""
+
+  # Add stories to sprint
+  for item in "${NOT_IN_SPRINT[@]}"; do
+    IFS='|' read -r key summary <<< "$item"
+    echo "Adding $key to sprint $SPRINT_ID..."
+    jira sprint add "$SPRINT_ID" "$key" 2>/dev/null && echo "  Done" || echo "  Failed"
+  done
+
+  echo ""
+  echo "Fix mode completed. Manual review still needed for:"
+  echo "- Status mismatches (requires decision on which source is correct)"
+  echo "- Missing Jira keys (requires creating new issues)"
+  echo "- Orphan issues (requires adding to YAML or removing from sprint)"
+fi

package/pennyfarthing-dist/scripts/jira/jira-sync-story.mjs

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+/**
+ * jira-sync-story.mjs - Sync a single story to Jira
+ *
+ * Usage: node jira-sync-story.mjs <story_key> [--transition] [--points] [--comment "message"]
+ *
+ * Options:
+ *   --transition   Transition story to match Pennyfarthing status
+ *   --points       Sync story points from Pennyfarthing to Jira
+ *   --comment      Add a comment to the story
+ */
+
+import {
+  checkDependencies,
+  findProjectRoot,
+  loadSprintFile,
+  findEpic,
+  findStory,
+  extractJiraKey,
+  mapStatusToJira,
+  getIssueJson,
+  getJiraField,
+  moveIssue,
+  getStoryPoints,
+  syncStoryPoints,
+  addComment,
+  parseArgs,
+  success,
+  info,
+  warn,
+  error,
+  JIRA_URL
+} from './jira-lib.mjs';
+
+// Parse arguments
+const args = parseArgs(process.argv, {
+  'transition': { type: 'boolean' },
+  'points': { type: 'boolean' },
+  'comment': { type: 'string' }
+});
+
+const storyKey = args._positional[0];
+const doTransition = args.transition || false;
+const doSyncPoints = args.points || false;
+const commentText = args.comment || null;
+
+// Show usage if no story key provided
+if (!storyKey) {
+  error('Story key required');
+  console.log(`
+Usage: jira-sync-story.mjs <story_key> [--transition] [--points] [--comment "message"]
+
+Examples:
+  jira-sync-story.mjs 24-1                      # Show story status
+  jira-sync-story.mjs 24-1 --transition         # Sync status to Jira
+  jira-sync-story.mjs 24-1 --points             # Sync story points
+  jira-sync-story.mjs 24-1 --transition --points
+  jira-sync-story.mjs 24-1 --comment "Started development"
+`);
+  process.exit(2);
+}
+
+// Check dependencies (quiet mode - we'll show story info instead)
+if (!checkDependencies({ quiet: false })) {
+  process.exit(2);
+}
+
+// Find project root and load sprint data
+let projectRoot;
+let sprintData;
+
+try {
+  projectRoot = findProjectRoot();
+  sprintData = loadSprintFile(projectRoot);
+} catch (err) {
+  error(err.message);
+  process.exit(1);
+}
+
+// Extract epic number from story key (e.g., "24-1" -> "24")
+const epicNum = storyKey.split('-')[0];
+
+// Find epic and story
+const epic = findEpic(sprintData, epicNum);
+if (!epic) {
+  error(`Epic ${epicNum} not found in sprint file`);
+  process.exit(1);
+}
+
+const story = findStory(epic, storyKey);
+if (!story) {
+  error(`Story ${storyKey} not found in epic ${epicNum}`);
+  process.exit(1);
+}
+
+// Get story details from Pennyfarthing
+const PennyfarthingStatus = story.status || 'backlog';
+const storyJira = story.jira;
+const storyBranch = story.branch;
+const storyPr = story.pr;
+const storyPoints = story.points;
+
+// Check if synced to Jira
+if (!storyJira || storyJira === 'null') {
+  warn(`Story ${storyKey} not synced to Jira yet`);
+  console.log('');
+  console.log('To create this story in Jira, use:');
+  console.log(`  jira issue create -tStory -s"Story ${storyKey}" -yHigh`);
+  process.exit(1);
+}
+
+const jiraKey = extractJiraKey(storyJira);
+
+info(`Story: ${storyKey}`);
+info(`Jira: ${jiraKey}`);
+console.log('');
+
+// Fetch current Jira state
+const issueJson = getIssueJson(jiraKey);
+if (!issueJson) {
+  error(`Could not fetch issue ${jiraKey}`);
+  process.exit(2);
+}
+
+const jiraStatus = getJiraField(issueJson, 'fields.status.name', 'Unknown');
+const jiraAssignee = getJiraField(issueJson, 'fields.assignee.displayName', 'Unassigned');
+const jiraSummary = getJiraField(issueJson, 'fields.summary', 'No summary');
+const jiraPoints = getStoryPoints(jiraKey, issueJson);
+
+// Display current state
+console.log(`   Summary: ${jiraSummary}`);
+console.log(`   Jira Status: ${jiraStatus}`);
+console.log(`   Assignee: ${jiraAssignee}`);
+console.log(`   Pennyfarthing Status: ${PennyfarthingStatus}`);
+if (storyPoints) console.log(`   Pennyfarthing Points: ${storyPoints}`);
+if (jiraPoints) console.log(`   Jira Points: ${jiraPoints}`);
+if (storyBranch) console.log(`   Branch: ${storyBranch}`);
+if (storyPr) console.log(`   PR: ${storyPr}`);
+console.log('');
+
+// Map Pennyfarthing status to target Jira status
+const targetJiraStatus = mapStatusToJira(PennyfarthingStatus);
+
+// Transition if requested
+if (doTransition) {
+  if (jiraStatus === targetJiraStatus) {
+    success(`Already at correct status: ${jiraStatus}`);
+  } else {
+    info(`Transitioning: ${jiraStatus} -> ${targetJiraStatus}`);
+    const result = moveIssue(jiraKey, targetJiraStatus);
+    if (result.success) {
+      success(`Transitioned to ${targetJiraStatus}`);
+    } else {
+      warn('Could not transition (status may not be available from current state)');
+    }
+  }
+}
+
+// Sync story points if requested
+if (doSyncPoints) {
+  info(`Syncing story points: ${jiraPoints || 'unset'} -> ${storyPoints || 'unset'}`);
+  const result = await syncStoryPoints(jiraKey, storyPoints, { currentJiraPoints: jiraPoints });
+  if (result.success) {
+    if (result.alreadySynced) {
+      success(`Story points already synced: ${storyPoints}`);
+    } else {
+      success(`Story points synced: ${storyPoints}`);
+    }
+  } else {
+    warn(`Could not sync story points: ${result.reason}`);
+  }
+}
+
+// Add comment if provided
+if (commentText) {
+  info('Adding comment...');
+  const result = addComment(jiraKey, commentText);
+  if (result.success) {
+    success('Comment added');
+  } else {
+    warn('Could not add comment');
+  }
+}
+
+// Auto-comment for transitions (if no manual comment provided)
+if (doTransition && !commentText) {
+  let autoComment = null;
+
+  if (PennyfarthingStatus === 'in-progress' && storyBranch) {
+    autoComment = `**Development Started**\n\nBranch: \`${storyBranch}\`\n\nSynced from Pennyfarthing`;
+  } else if (PennyfarthingStatus === 'review' && storyPr) {
+    autoComment = `**Ready for Review**\n\nPR: ${storyPr}\n\nSynced from Pennyfarthing`;
+  } else if (PennyfarthingStatus === 'done') {
+    const today = new Date().toISOString().split('T')[0];
+    autoComment = `**Completed**\n\nSynced from Pennyfarthing on ${today}`;
+  }
+
+  if (autoComment) {
+    info('Adding sync comment...');
+    const result = addComment(jiraKey, autoComment);
+    if (result.success) {
+      success('Sync comment added');
+    }
+  }
+}
+
+console.log('');
+success(`${JIRA_URL}/browse/${jiraKey}`);

package/pennyfarthing-dist/scripts/jira/jira-sync-story.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env zsh
+# Thin wrapper for jira-sync-story.mjs
+# Usage: ./scripts/jira-sync-story.sh <story_key> [--transition] [--points] [--comment "message"]
+#
+# Delegates to Node script for cleaner, more maintainable implementation.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+exec node "${SCRIPT_DIR}/jira/jira-sync-story.mjs" "$@"

package/pennyfarthing-dist/scripts/jira/jira-sync.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+/**
+ * jira-sync.mjs - Sync Pennyfarthing Epic to Jira
+ *
+ * Usage: node jira-sync.mjs <epic_number> [--dry-run] [--transition] [--points]
+ *
+ * Options:
+ *   --dry-run      Show what would be done without making changes
+ *   --transition   Transition Jira issues to match Pennyfarthing status
+ *   --points       Sync story points from Pennyfarthing to Jira
+ */
+
+import {
+  checkDependencies,
+  findProjectRoot,
+  loadSprintFile,
+  findEpic,
+  extractJiraKey,
+  mapStatusToJira,
+  getIssueJson,
+  getJiraField,
+  moveIssue,
+  getStoryPoints,
+  syncStoryPoints,
+  parseArgs,
+  success,
+  info,
+  warn,
+  error,
+  JIRA_URL
+} from './jira-lib.mjs';
+
+// Parse arguments
+const args = parseArgs(process.argv, {
+  'dry-run': { type: 'boolean' },
+  'transition': { type: 'boolean' },
+  'points': { type: 'boolean' },
+  'with-comments': { type: 'boolean' } // Deprecated, ignored
+});
+
+const epicNum = args._positional[0];
+const dryRun = args['dry-run'] || false;
+const doTransition = args.transition || false;
+const syncPoints = args.points || false;
+
+// Show usage if no epic provided
+if (!epicNum) {
+  error('Epic number required');
+  console.log(`
+Usage: jira-sync.mjs <epic_number> [--dry-run] [--transition] [--points]
+
+Examples:
+  jira-sync.mjs 35                     # Show sync status for epic 35
+  jira-sync.mjs 35 --dry-run           # Show what would be done
+  jira-sync.mjs 35 --transition        # Sync status to Jira
+  jira-sync.mjs 35 --transition --points  # Sync status and story points
+`);
+  process.exit(2);
+}
+
+// Check dependencies
+if (!checkDependencies()) {
+  process.exit(2);
+}
+
+// Find project root and load sprint data
+let projectRoot;
+let sprintData;
+
+try {
+  projectRoot = findProjectRoot();
+  sprintData = loadSprintFile(projectRoot);
+} catch (err) {
+  error(err.message);
+  process.exit(1);
+}
+
+// Find epic
+const epic = findEpic(sprintData, epicNum);
+if (!epic) {
+  error(`Epic ${epicNum} not found in sprint file`);
+  process.exit(1);
+}
+
+// Display header
+console.log('');
+info('==========================================');
+info(`Epic ${epicNum}: ${epic.title}`);
+if (epic.jira) info(`Jira: ${epic.jira}`);
+info('==========================================');
+console.log('');
+
+if (dryRun) {
+  warn('[DRY-RUN MODE] No changes will be made');
+  console.log('');
+}
+
+// Get stories
+const stories = epic.stories || [];
+if (stories.length === 0) {
+  warn(`No stories found in epic ${epicNum}`);
+  process.exit(0);
+}
+
+info(`Found ${stories.length} stories to process`);
+console.log('');
+
+// Process each story
+let synced = 0;
+let skipped = 0;
+let errors = 0;
+
+for (const story of stories) {
+  const storyKey = story.id;
+  const storyTitle = story.title || 'Untitled';
+  const storyStatus = story.status || 'backlog';
+  const storyJira = story.jira;
+  const storyPoints = story.points;
+
+  console.log('---');
+  info(`Story ${storyKey}: ${storyTitle}`);
+  console.log(`  Status: ${storyStatus}`);
+
+  // Check if synced to Jira
+  if (!storyJira || storyJira === 'null') {
+    warn('  Not synced to Jira - skipping');
+    skipped++;
+    continue;
+  }
+
+  // Extract Jira key
+  const jiraKey = extractJiraKey(storyJira);
+  console.log(`  Jira: ${jiraKey}`);
+
+  if (dryRun) {
+    const actions = [];
+    if (doTransition) actions.push('transition');
+    if (syncPoints) actions.push('sync points');
+    warn(`  [DRY-RUN] Would sync: ${actions.length > 0 ? actions.join(', ') : 'view only'}`);
+    synced++;
+    continue;
+  }
+
+  // Fetch current Jira state
+  const issueJson = getIssueJson(jiraKey);
+  if (!issueJson) {
+    warn(`  Could not fetch Jira issue ${jiraKey}`);
+    errors++;
+    continue;
+  }
+
+  const jiraStatus = getJiraField(issueJson, 'fields.status.name', 'Unknown');
+  const jiraPoints = getStoryPoints(jiraKey, issueJson);
+  const targetStatus = mapStatusToJira(storyStatus);
+
+  console.log(`  Jira Status: ${jiraStatus} (target: ${targetStatus})`);
+  if (storyPoints) console.log(`  Points: Pennyfarthing=${storyPoints}, Jira=${jiraPoints || 'unset'}`);
+
+  // Transition if requested
+  if (doTransition) {
+    if (jiraStatus === targetStatus) {
+      success(`  Already at correct status: ${jiraStatus}`);
+    } else {
+      info(`  Transitioning: ${jiraStatus} -> ${targetStatus}`);
+      const result = moveIssue(jiraKey, targetStatus);
+      if (result.success) {
+        success(`  Transitioned to ${targetStatus}`);
+      } else {
+        warn(`  Could not transition (may not be available from current state)`);
+      }
+    }
+  }
+
+  // Sync points if requested
+  if (syncPoints && storyPoints) {
+    info(`  Syncing story points: ${jiraPoints || 'unset'} -> ${storyPoints}`);
+    const result = await syncStoryPoints(jiraKey, storyPoints, { currentJiraPoints: jiraPoints });
+    if (result.success) {
+      if (result.alreadySynced) {
+        success(`  Story points already synced: ${storyPoints}`);
+      } else {
+        success(`  Story points synced: ${storyPoints}`);
+      }
+    } else {
+      warn(`  Could not sync story points: ${result.reason}`);
+    }
+  }
+
+  synced++;
+}
+
+// Summary
+console.log('');
+console.log('==========================================');
+success(`Summary: ${synced} synced, ${skipped} skipped, ${errors} errors`);
+console.log('==========================================');
+
+process.exit(errors > 0 ? 1 : 0);

package/pennyfarthing-dist/scripts/jira/jira-sync.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env zsh
+# Thin wrapper for jira-sync.mjs
+# Usage: ./scripts/jira-sync.sh <epic_number> [--dry-run] [--transition] [--points]
+#
+# Delegates to Node script for cleaner, more maintainable implementation.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+exec node "${SCRIPT_DIR}/jira/jira-sync.mjs" "$@"