@pennyfarthing/core 6.6.0

package/pennyfarthing-dist/scripts/utils/jira-lib.sh

@@ -0,0 +1,463 @@
+#!/usr/bin/env zsh
+# Jira CLI Library Functions
+# Shared functions for interacting with Jira using jira
+# Source this file: source "${SCRIPT_DIR}/jira-lib.sh"
+
+# Source common utilities (for dry_run_check, escape_for_jql, get_issue_json, etc.)
+_JIRA_LIB_DIR="$(cd "$(dirname "${0:-$BASH_SOURCE[0]}")" && pwd)"
+source "${_JIRA_LIB_DIR}/common.sh"
+
+#############################################
+# Dependency Checks
+#############################################
+
+check_jira_cli() {
+    local missing=()
+
+    # Standard deps from common
+    check_dependencies 2>/dev/null || true
+
+    # Check for jira
+    if ! command -v jira &> /dev/null; then
+        missing+=("jira")
+        error "✗ jira not found"
+        echo "  Install with: brew install ankitpokhrel/jira/jira"
+        echo "  Then run: jira init"
+    else
+        success "✓ jira installed"
+    fi
+
+    # Check for JIRA_API_TOKEN
+    if [ -z "$JIRA_API_TOKEN" ]; then
+        missing+=("JIRA_API_TOKEN")
+        error "✗ JIRA_API_TOKEN not set"
+        echo "  Create token at: https://id.atlassian.com/manage-profile/security/api-tokens"
+        echo "  Then: export JIRA_API_TOKEN='your-token'"
+    else
+        success "✓ JIRA_API_TOKEN set"
+    fi
+
+    # Check jira config
+    if [ -f "$HOME/.config/.jira/.config.yml" ]; then
+        success "✓ jira configured"
+    elif command -v jira &> /dev/null; then
+        missing+=("jira-config")
+        error "✗ jira not configured"
+        echo "  Run: jira init"
+    fi
+
+    if [ ${#missing[@]} -gt 0 ]; then
+        echo ""
+        error "Missing: ${missing[*]}"
+        exit 1
+    fi
+    echo ""
+}
+
+#############################################
+# Search Functions
+#############################################
+
+search_existing_epic() {
+    local summary="$1"
+
+    if dry_run_check "search for epic"; then
+        echo ""
+        return
+    fi
+
+    # Search for epic by exact summary match
+    local escaped_summary=$(escape_for_jql "$summary")
+    jira issue list --jql "project=${JIRA_PROJECT} AND type=Epic AND summary~'${escaped_summary}'" --plain 2>/dev/null | \
+        grep -E "^Epic.*${JIRA_PROJECT}-[0-9]+" | \
+        grep -oE "${JIRA_PROJECT}-[0-9]+" | \
+        head -1
+}
+
+search_existing_story() {
+    local summary="$1"
+    local parent_key="$2"
+
+    if dry_run_check "search for story"; then
+        echo ""
+        return
+    fi
+
+    # Search for story by exact summary match under the same epic
+    local escaped_summary=$(escape_for_jql "$summary")
+    local jql="project=${JIRA_PROJECT} AND type=Story AND summary~'${escaped_summary}'"
+
+    # If parent epic provided, also filter by parent
+    if [ -n "$parent_key" ]; then
+        jql="${jql} AND parent=${parent_key}"
+    fi
+
+    jira issue list --jql "$jql" --plain 2>/dev/null | \
+        grep -E "${JIRA_PROJECT}-[0-9]+" | \
+        grep -oE "${JIRA_PROJECT}-[0-9]+" | \
+        head -1
+}
+
+#############################################
+# Create Functions
+#############################################
+
+create_epic() {
+    local summary="$1"
+    local description="$2"
+
+    # Use PROJECT_LABEL if set, otherwise fall back to PROJECT_NAME
+    local label="${PROJECT_LABEL:-${PROJECT_NAME:-}}"
+
+    if dry_run_check "create epic: $summary"; then
+        echo "DRYRUN-EPIC-001"
+        return
+    fi
+
+    local args=(
+        --project "$JIRA_PROJECT"
+        --type Epic
+        --summary "$summary"
+        --body "$description"
+        --no-input
+    )
+
+    # Only add label if we have one
+    [ -n "$label" ] && args+=(--label "$label")
+
+    jira issue create "${args[@]}" 2>&1 | grep -oE "${JIRA_PROJECT}-[0-9]+" | head -1
+}
+
+create_story() {
+    local summary="$1"
+    local description="$2"
+    local priority="$3"
+    local points="$4"
+    local parent="$5"
+
+    # Use PROJECT_LABEL if set, otherwise fall back to PROJECT_NAME
+    local label="${PROJECT_LABEL:-${PROJECT_NAME:-}}"
+
+    if dry_run_check "create story: $summary"; then
+        echo "DRYRUN-STORY-001"
+        return
+    fi
+
+    local args=(
+        --project "$JIRA_PROJECT"
+        --type Story
+        --summary "$summary"
+        --body "$description"
+        --priority "$priority"
+        --no-input
+    )
+
+    # Only add label if we have one
+    [ -n "$label" ] && args+=(--label "$label")
+    [ -n "$parent" ] && args+=(--parent "$parent")
+
+    jira issue create "${args[@]}" 2>&1 | grep -oE "${JIRA_PROJECT}-[0-9]+" | head -1
+}
+
+#############################################
+# Update Functions
+#############################################
+
+update_issue() {
+    local key="$1"
+    local summary="$2"
+    local description="$3"
+
+    if dry_run_check "update: $key"; then
+        return 0
+    fi
+
+    # Fetch current issue as JSON
+    local current_json=$(get_issue_json "$key")
+    if [ -z "$current_json" ] || [ "$current_json" = "{}" ]; then
+        warn "  Could not fetch current issue, updating anyway"
+        jira issue edit "$key" --summary "$summary" --body "$description" --no-input 2>&1
+        return 0
+    fi
+
+    # Extract current summary and description from JSON
+    local current_summary=$(get_jira_field "$current_json" '.fields.summary' '')
+    local current_desc=$(get_jira_field "$current_json" '.fields.description' '')
+
+    # Compare both summary and description
+    if [ "$current_summary" = "$summary" ] && [ "$current_desc" = "$description" ]; then
+        # No changes needed
+        return 1
+    fi
+
+    # Update needed
+    jira issue edit "$key" --summary "$summary" --body "$description" --no-input 2>&1
+    return 0
+}
+
+move_issue() {
+    local key="$1"
+    local status="$2"
+
+    if dry_run_check "move $key to: $status"; then
+        return 0
+    fi
+
+    # Fetch current status from JSON
+    local current_json=$(get_issue_json "$key")
+    if [ -n "$current_json" ] && [ "$current_json" != "{}" ]; then
+        local current_status=$(get_jira_field "$current_json" '.fields.status.name' '')
+        # Case-insensitive comparison
+        if [ "$(echo "$current_status" | tr '[:upper:]' '[:lower:]')" = "$(echo "$status" | tr '[:upper:]' '[:lower:]')" ]; then
+            return 1
+        fi
+    fi
+
+    # Transition needed
+    jira issue move "$key" "$status" --project "$JIRA_PROJECT" 2>&1 || true
+    return 0
+}
+
+assign_issue() {
+    local key="$1"
+    local assignee="$2"
+
+    if dry_run_check "assign $key to: $assignee"; then
+        return 0
+    fi
+
+    if [ -z "$assignee" ] || [ "$assignee" = "null" ] || [ -z "$key" ]; then
+        return 0
+    fi
+
+    # Check current assignee from JSON
+    local current_json=$(get_issue_json "$key")
+    if [ -n "$current_json" ] && [ "$current_json" != "{}" ]; then
+        local current_email=$(get_jira_field "$current_json" '.fields.assignee.emailAddress' '')
+        local current_name=$(get_jira_field "$current_json" '.fields.assignee.displayName' '')
+
+        # Check if already assigned to this user (compare email or name)
+        if [ "$current_email" = "$assignee" ] || echo "$current_name" | grep -qi "$assignee"; then
+            # Already assigned to this user
+            return 1
+        fi
+    fi
+
+    # Assign the issue - jira accepts email or display name
+    # Note: --project flag is required even though key contains project prefix
+    local result=$(jira issue assign --project "$JIRA_PROJECT" "$key" "$assignee" 2>&1)
+    local exit_code=$?
+
+    if [ $exit_code -eq 0 ]; then
+        return 0
+    else
+        # Check if it's a "user not found" error vs other error
+        if echo "$result" | grep -q "400 Bad Request"; then
+            warn "  ⚠️  User not found in Jira: $assignee"
+        else
+            warn "  ⚠️  Could not assign: $result"
+        fi
+        return 1
+    fi
+}
+
+#############################################
+# Story Points Functions
+#############################################
+
+# Get story points from a Jira issue
+# Usage: get_story_points <issue_key>
+# Returns: points value or "null" if not set
+get_story_points() {
+    local key="$1"
+    local issue_json="${2:-}"  # Optional - pass cached JSON to avoid extra API call
+
+    if [ -z "$issue_json" ]; then
+        issue_json=$(jira issue view "$key" --raw 2>/dev/null)
+    fi
+
+    if [ -z "$issue_json" ]; then
+        echo "null"
+        return
+    fi
+
+    # Story points custom field for 1898andco Jira
+    # customfield_10031 = "Story Points" (1898andco instance)
+    local points=$(echo "$issue_json" | jq -r '.fields.customfield_10031 // "null"')
+    echo "$points"
+}
+
+# Sync story points from Conductor to Jira
+# Usage: sync_story_points <issue_key> <conductor_points> [jira_points]
+# Returns: 0 if synced, 1 if already correct, 2 if failed
+sync_story_points() {
+    local key="$1"
+    local conductor_points="$2"
+    local jira_points="${3:-}"
+
+    if dry_run_check "sync story points for $key: ${conductor_points}"; then
+        return 0
+    fi
+
+    # Skip if no points defined in Conductor
+    if [ -z "$conductor_points" ] || [ "$conductor_points" = "null" ]; then
+        warn "  ⚠️  No story points defined in Conductor"
+        return 1
+    fi
+
+    # Get current Jira points if not provided
+    if [ -z "$jira_points" ]; then
+        jira_points=$(get_story_points "$key")
+    fi
+
+    # Compare as integers (Jira might return float like "5.0")
+    local jira_points_int=$(echo "$jira_points" | cut -d'.' -f1)
+    if [ "$jira_points_int" = "$conductor_points" ]; then
+        return 1  # Already correct
+    fi
+
+    # Story points field for 1898andco Jira instance
+    # customfield_10031 = "Story Points"
+    # Note: jira CLI --custom doesn't work reliably, use REST API directly
+    local jira_user="keith.avery@1898andco.io"
+    local api_url="${JIRA_URL}/rest/api/3/issue/${key}"
+
+    local http_code
+    http_code=$(curl -s -o /dev/null -w "%{http_code}" -X PUT \
+        -u "${jira_user}:${JIRA_API_TOKEN}" \
+        -H "Content-Type: application/json" \
+        -d "{\"fields\": {\"customfield_10031\": ${conductor_points}}}" \
+        "${api_url}" 2>&1)
+
+    if [ "$http_code" = "204" ] || [ "$http_code" = "200" ]; then
+        return 0
+    else
+        warn "  ⚠️  Could not sync story points (HTTP $http_code)"
+        return 2
+    fi
+}
+
+#############################################
+# Status Mapping
+#############################################
+
+# map_status_to_jira CONDUCTOR_STATUS
+# Map Conductor status to Jira status name
+# Returns: Jira status string
+map_status_to_jira() {
+    local conductor_status="$1"
+
+    case "$conductor_status" in
+        backlog|todo)
+            echo "To Do"
+            ;;
+        in-progress|in_progress|active)
+            echo "In Progress"
+            ;;
+        review|in-review|in_review)
+            echo "In Review"
+            ;;
+        done|completed|closed)
+            echo "Done"
+            ;;
+        blocked)
+            echo "Blocked"
+            ;;
+        *)
+            # Default to To Do for unknown statuses
+            echo "To Do"
+            ;;
+    esac
+}
+
+# map_jira_to_status JIRA_STATUS
+# Map Jira status to Conductor status name
+# Returns: Conductor status string
+map_jira_to_status() {
+    local jira_status="$1"
+
+    case "$jira_status" in
+        "To Do"|"Open"|"Backlog")
+            echo "backlog"
+            ;;
+        "In Progress"|"Active")
+            echo "in-progress"
+            ;;
+        "In Review"|"Review")
+            echo "review"
+            ;;
+        "Done"|"Closed"|"Resolved")
+            echo "done"
+            ;;
+        "Blocked")
+            echo "blocked"
+            ;;
+        *)
+            # Default to backlog for unknown statuses
+            echo "backlog"
+            ;;
+    esac
+}
+
+#############################################
+# Helper Functions
+#############################################
+
+get_pr_author() {
+    local pr_url="$1"
+
+    if [ -z "$pr_url" ] || [ "$pr_url" = "null" ]; then
+        echo ""
+        return
+    fi
+
+    # Extract org/repo/number from URL
+    # Example: https://github.com/1898andCo/conductor-ui/pull/42
+    if [[ "$pr_url" =~ github\.com/([^/]+)/([^/]+)/pull/([0-9]+) ]]; then
+        local org="${BASH_REMATCH[1]}"
+        local repo="${BASH_REMATCH[2]}"
+        local pr_number="${BASH_REMATCH[3]}"
+
+        # Use gh CLI to get PR author
+        local author=$(gh pr view "$pr_number" --repo "${org}/${repo}" --json author --jq '.author.login' 2>/dev/null)
+        echo "$author"
+    fi
+}
+
+map_github_to_jira() {
+    local github_user="$1"
+
+    if [ -z "$github_user" ]; then
+        echo ""
+        return
+    fi
+
+    # GitHub username to Jira email/accountId mapping
+    # Add mappings as needed
+    case "$github_user" in
+        "slabgorb")
+            # Keith Avery's Jira account
+            echo "keith.avery@1898andco.io"
+            ;;
+        "arcaven")
+            # Michael Pursifull's Jira account
+            echo "michael.pursifull@1898andco.io"
+            ;;
+        "RoseSecurity")
+            # Michael Rosenfeld's Jira account
+            echo "michael.rosenfeld@1898andco.io"
+            ;;
+        "Zious11")
+            # Jared Richards' Jira account
+            echo "jared.richards@1898andco.io"
+            ;;
+        "drbothen")
+            # Joshua Magady's Jira account
+            echo "joshua.magady@1898andco.io"
+            ;;
+        *)
+            # Default: assume GitHub username matches Jira email prefix
+            echo "${github_user}@1898andco.io"
+            ;;
+    esac
+}

package/pennyfarthing-dist/scripts/utils/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/utils/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" "$@"

package/pennyfarthing-dist/scripts/utils/log-skill-usage.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env zsh
+# Log skill invocations to .session/skill-usage.log
+# Usage: log-skill-usage.sh <skill-name> [agent-name] [session-id]
+#
+# Creates JSON Lines entries in .session/skill-usage.log:
+#   {"ts":"2026-01-11T10:30:45Z","skill":"testing","agent":"dev","session":"abc123"}
+#
+# Environment:
+#   PROJECT_ROOT - Set by run.sh bootstrap (required)
+
+set -euo pipefail
+
+# --- Configuration ---
+SCRIPT_DIR="${0:A:h}"
+source "${SCRIPT_DIR}/common.sh" 2>/dev/null || true
+
+# --- Argument parsing ---
+SKILL_NAME="${1:-}"
+AGENT_NAME="${2:-unknown}"
+SESSION_ID="${3:-}"
+
+if [[ -z "$SKILL_NAME" ]]; then
+    echo "Usage: log-skill-usage.sh <skill-name> [agent-name] [session-id]" >&2
+    exit 1
+fi
+
+# --- Find project root ---
+if [[ -z "${PROJECT_ROOT:-}" ]]; then
+    # Fallback: find project root ourselves
+    dir="$PWD"
+    while [[ ! -d "$dir/.claude" ]] && [[ "$dir" != "/" ]]; do
+        dir="$(dirname "$dir")"
+    done
+    if [[ -d "$dir/.claude" ]]; then
+        PROJECT_ROOT="$dir"
+    else
+        echo "Error: Could not find project root" >&2
+        exit 1
+    fi
+fi
+
+# --- Ensure session directory exists ---
+SESSION_DIR="$PROJECT_ROOT/.session"
+mkdir -p "$SESSION_DIR"
+
+LOG_FILE="$SESSION_DIR/skill-usage.log"
+
+# --- Build JSON entry ---
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Auto-detect session ID from active agent sessions if not provided
+if [[ -z "$SESSION_ID" ]]; then
+    if [[ -d "$SESSION_DIR/agents" ]]; then
+        # Use the most recent session file
+        SESSION_FILE=$(ls -t "$SESSION_DIR/agents/" 2>/dev/null | head -1)
+        if [[ -n "$SESSION_FILE" ]]; then
+            SESSION_ID="${SESSION_FILE}"
+        fi
+    fi
+fi
+
+# Use jq for proper JSON escaping
+JSON_ENTRY=$(jq -nc \
+    --arg ts "$TIMESTAMP" \
+    --arg skill "$SKILL_NAME" \
+    --arg agent "$AGENT_NAME" \
+    --arg session "${SESSION_ID:-none}" \
+    '{ts: $ts, skill: $skill, agent: $agent, session: $session}')
+
+# --- Append to log ---
+echo "$JSON_ENTRY" >> "$LOG_FILE"
+
+# Silent success (don't interfere with skill output)
+exit 0