@pennyfarthing/core 6.6.0

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

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+/**
+ * jira-sync.mjs - Sync Conductor 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 Conductor status
+ *   --points       Sync story points from Conductor 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: Conductor=${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/utils/jira-claim-story.sh

@@ -0,0 +1,162 @@
+#!/usr/bin/env zsh
+# Check and claim a story in Jira for multi-developer coordination
+# Usage: ./scripts/jira-claim-story.sh <story_key_or_jira_key> [--claim]
+#
+# This script uses the `jira` CLI tool (https://github.com/ankitpokhrel/jira)
+#
+# Parameters:
+#   <story_key_or_jira_key>  Either:
+#                             - Story key format: 35-7-feedback-rule-delete-404
+#                             - Jira issue key format: MSSCI-10991
+#
+# Actions:
+#   (default)   Check if story is assigned and show status
+#   --claim     Assign story to current user and move to "In Progress"
+#
+# Exit codes:
+#   0 - Story is available (unassigned) or successfully claimed
+#   1 - Story is assigned to someone else
+#   2 - Story not found or not synced to Jira
+#   3 - Error (jira CLI not installed, etc.)
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/sprint-common.sh"
+source "${SCRIPT_DIR}/jira-lib.sh"
+
+# Check dependencies (using jira-lib's robust check)
+check_jira_cli
+
+# Check arguments
+if [ -z "$1" ]; then
+    error "Error: Story key or Jira issue key required"
+    echo "Usage: $0 <story_key_or_jira_key> [--claim]"
+    echo ""
+    echo "Examples:"
+    echo "  $0 35-7-feedback-rule-delete-404              # Using story key"
+    echo "  $0 35-7-feedback-rule-delete-404 --claim      # Claim using story key"
+    echo "  $0 MSSCI-10991                                # Using Jira issue key"
+    echo "  $0 MSSCI-10991 --claim                        # Claim using Jira key"
+    exit 3
+fi
+
+INPUT_KEY="$1"
+CLAIM_MODE=false
+[ "$2" = "--claim" ] && CLAIM_MODE=true
+
+# Detect input format: Jira key (MSSCI-12345) vs Story key (35-7-name)
+if [[ "$INPUT_KEY" =~ ^${JIRA_PROJECT}-[0-9]+$ ]]; then
+    # Input is Jira issue key format (e.g., MSSCI-10991)
+    JIRA_ISSUE_KEY="$INPUT_KEY"
+    info "🔍 Using Jira issue key: ${JIRA_ISSUE_KEY}"
+
+    # Skip story file lookup - we'll work directly with Jira
+    STORY_KEY=""
+
+else
+    # Input is story key format (e.g., 35-7-feedback-rule-delete-404)
+    STORY_KEY="$INPUT_KEY"
+
+    # Extract epic number from story key
+    EPIC_NUM=$(echo "$STORY_KEY" | cut -d'-' -f1)
+
+    info "🔍 Checking story ${STORY_KEY} in Jira..."
+
+    # Find the story
+    STORY_FILE=$(find_story_file "$STORY_KEY")
+    if [ -z "$STORY_FILE" ]; then
+        error "Error: Story ${STORY_KEY} not found in sprint files"
+        exit 2
+    fi
+
+    # Get Jira link
+    STORY_JIRA_LINK=$(get_story_field "$STORY_KEY" "jira")
+    if [ "$STORY_JIRA_LINK" = "null" ] || [ -z "$STORY_JIRA_LINK" ]; then
+        warn "⚠️  Story ${STORY_KEY} not synced to Jira yet"
+        echo ""
+        echo "Proceeding without Jira sync. Story will be synced later."
+        echo "To sync now, run: ./scripts/sync-epic-to-jira.sh ${EPIC_NUM}"
+        exit 0
+    fi
+
+    JIRA_ISSUE_KEY=$(extract_jira_key "$STORY_JIRA_LINK")
+    success "✅ Found Jira issue: ${JIRA_ISSUE_KEY}"
+fi
+
+# Get current user
+CURRENT_USER=$(jira me 2>/dev/null || echo "")
+if [ -z "$CURRENT_USER" ]; then
+    error "Error: Could not get current Jira user. Run 'jira init' to configure."
+    exit 3
+fi
+
+info "👤 Current user: ${CURRENT_USER}"
+
+# Get issue details (using --raw for JSON parsing)
+info "📋 Fetching issue details..."
+ISSUE_JSON=$(jira issue view "$JIRA_ISSUE_KEY" --raw 2>/dev/null || echo "{}")
+
+if [ "$ISSUE_JSON" = "{}" ]; then
+    error "Error: Could not fetch issue ${JIRA_ISSUE_KEY}"
+    exit 3
+fi
+
+# Parse assignee
+ASSIGNEE=$(echo "$ISSUE_JSON" | jq -r '.fields.assignee.displayName // "Unassigned"')
+ASSIGNEE_EMAIL=$(echo "$ISSUE_JSON" | jq -r '.fields.assignee.emailAddress // ""')
+STATUS=$(echo "$ISSUE_JSON" | jq -r '.fields.status.name // "Unknown"')
+SUMMARY=$(echo "$ISSUE_JSON" | jq -r '.fields.summary // "No summary"')
+
+echo ""
+echo "📋 Issue: ${JIRA_ISSUE_KEY}"
+echo "   Summary: ${SUMMARY}"
+echo "   Status: ${STATUS}"
+echo "   Assignee: ${ASSIGNEE}"
+
+# Check assignment status
+if [ "$ASSIGNEE" = "Unassigned" ]; then
+    success "✅ Story is UNASSIGNED - available to claim"
+    
+    if [ "$CLAIM_MODE" = true ]; then
+        info "🎯 Claiming story..."
+        
+        # Assign to self
+        if jira issue assign "$JIRA_ISSUE_KEY" "$(jira me)" --project "$JIRA_PROJECT" 2>/dev/null; then
+            success "✅ Assigned to you"
+        else
+            error "Failed to assign issue"
+            exit 3
+        fi
+
+        # Move to In Progress (if not already)
+        if [ "$STATUS" != "In Progress" ]; then
+            info "📊 Moving to 'In Progress'..."
+            if jira issue move "$JIRA_ISSUE_KEY" "In Progress" --project "$JIRA_PROJECT" 2>/dev/null; then
+                success "✅ Moved to In Progress"
+            else
+                warn "⚠️  Could not transition to In Progress (may already be there or transition not available)"
+            fi
+        fi
+        
+        echo ""
+        success "🎉 Story ${JIRA_ISSUE_KEY} claimed successfully!"
+    else
+        echo ""
+        info "To claim this story, run:"
+        echo "  $0 $STORY_KEY --claim"
+    fi
+    exit 0
+    
+elif [ "$ASSIGNEE_EMAIL" = "$CURRENT_USER" ] || [ "$ASSIGNEE" = "$(jira me 2>/dev/null)" ]; then
+    success "✅ Story is assigned to YOU - proceed with work"
+    exit 0
+    
+else
+    warn "⚠️  Story is assigned to: ${ASSIGNEE}"
+    echo ""
+    echo "This story is already being worked on by someone else."
+    echo "Please choose a different story or coordinate with ${ASSIGNEE}."
+    exit 1
+fi