@pennyfarthing/core 7.0.2 → 7.4.1

package/pennyfarthing-dist/skills/sprint/scripts/promote-epic.sh

@@ -0,0 +1,164 @@
+#!/bin/bash
+# Promote an epic from planning.yaml to current-sprint.yaml
+# Usage: .pennyfarthing/scripts/core/run.sh sprint/promote-epic.sh <epic-id>
+#
+# Example: .pennyfarthing/scripts/core/run.sh sprint/promote-epic.sh epic-41
+
+set -euo pipefail
+
+EPIC_ID="${1:-}"
+
+if [[ -z "$EPIC_ID" ]]; then
+  echo "Usage: promote-epic.sh <epic-id>"
+  echo "Example: promote-epic.sh epic-41"
+  echo ""
+  echo "Moves an epic and its stories from planning.yaml to current-sprint.yaml"
+  exit 1
+fi
+
+# 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
+
+PLANNING_FILE="$PROJECT_ROOT/sprint/planning.yaml"
+SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
+
+if [[ ! -f "$PLANNING_FILE" ]]; then
+  echo "Error: Planning file not found at $PLANNING_FILE"
+  exit 1
+fi
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+if ! command -v yq &> /dev/null; then
+  echo "Error: yq is required but not installed"
+  echo "Install with: brew install yq"
+  exit 1
+fi
+
+# Find the epic in planning.yaml
+# Epics are nested under planning.initiatives[].epics[]
+EPIC_DATA=$(yq -o json ".planning.initiatives[].epics[] | select(.id == \"$EPIC_ID\")" "$PLANNING_FILE" 2>/dev/null || echo "")
+
+if [[ -z "$EPIC_DATA" || "$EPIC_DATA" == "null" ]]; then
+  echo "Error: Epic $EPIC_ID not found in $PLANNING_FILE"
+  echo ""
+  echo "Available epics:"
+  yq '.planning.initiatives[].epics[].id' "$PLANNING_FILE" 2>/dev/null || echo "  None found"
+  exit 1
+fi
+
+# Extract epic fields
+EPIC_TITLE=$(echo "$EPIC_DATA" | yq -r '.title // "Unknown"')
+EPIC_DESCRIPTION=$(echo "$EPIC_DATA" | yq -r '.description // ""')
+EPIC_POINTS=$(echo "$EPIC_DATA" | yq -r '.points // 0')
+EPIC_PRIORITY=$(echo "$EPIC_DATA" | yq -r '.priority // "P2"')
+EPIC_REPOS=$(echo "$EPIC_DATA" | yq -r '.repos // "pennyfarthing"')
+STORY_COUNT=$(echo "$EPIC_DATA" | yq '[.stories[]] | length')
+
+echo ""
+echo "Promoting epic to current sprint:"
+echo "  ID: $EPIC_ID"
+echo "  Title: $EPIC_TITLE"
+echo "  Points: $EPIC_POINTS"
+echo "  Priority: $EPIC_PRIORITY"
+echo "  Stories: $STORY_COUNT"
+echo ""
+
+# Generate the epic YAML block for current-sprint.yaml
+# The format must match existing epics in current-sprint.yaml
+EPIC_YAML=$(cat <<EOF
+  - id: $EPIC_ID
+    type: epic
+    title: "Epic: $EPIC_TITLE"
+    description: |
+$(echo "$EPIC_DESCRIPTION" | sed 's/^/      /')
+    priority: $EPIC_PRIORITY
+    status: backlog
+    repos: $EPIC_REPOS
+    stories:
+EOF
+)
+
+# Get stories and format them using a helper function
+format_story() {
+  local story_json="$1"
+  local id title desc points priority repos workflow
+
+  id=$(echo "$story_json" | yq -r '.id // ""')
+  title=$(echo "$story_json" | yq -r '.title // ""')
+  desc=$(echo "$story_json" | yq -r '.description // ""')
+  points=$(echo "$story_json" | yq -r '.points // 0')
+  priority=$(echo "$story_json" | yq -r '.priority // "P2"')
+  repos=$(echo "$story_json" | yq -r '.repos // "pennyfarthing"')
+  workflow=$(echo "$story_json" | yq -r '.workflow // "tdd"')
+
+  # Format description with proper indentation
+  local desc_formatted
+  desc_formatted=$(echo "$desc" | sed 's/^/          /')
+
+  # Build story YAML
+  echo "      - id: $id"
+  echo "        title: \"$title\""
+  echo "        description: |"
+  echo "$desc_formatted"
+  echo "        points: $points"
+  echo "        priority: $priority"
+  echo "        status: backlog"
+  echo "        repos: $repos"
+  echo "        workflow: $workflow"
+
+  # Handle acceptance_criteria - check if array exists and has items
+  local ac_count
+  ac_count=$(echo "$story_json" | yq -r '(.acceptance_criteria // []) | length')
+  if [[ "$ac_count" -gt 0 ]]; then
+    echo "        acceptance_criteria:"
+    echo "$story_json" | yq -r '(.acceptance_criteria // [])[] | "          - " + .'
+  else
+    echo "        acceptance_criteria: []"
+  fi
+}
+
+# Process each story
+STORIES_YAML=""
+story_count=$(echo "$EPIC_DATA" | yq -r '.stories | length')
+for i in $(seq 0 $((story_count - 1))); do
+  story_json=$(echo "$EPIC_DATA" | yq -o json ".stories[$i]")
+  if [[ -n "$STORIES_YAML" ]]; then
+    STORIES_YAML="$STORIES_YAML
+$(format_story "$story_json")"
+  else
+    STORIES_YAML=$(format_story "$story_json")
+  fi
+done
+
+# Combine epic and stories
+FULL_EPIC_YAML="$EPIC_YAML
+$STORIES_YAML"
+
+echo "Epic YAML to append:"
+echo "---"
+echo "$FULL_EPIC_YAML"
+echo "---"
+echo ""
+
+# Append to current-sprint.yaml epics section
+echo "$FULL_EPIC_YAML" >> "$SPRINT_FILE"
+
+echo "Appended epic to $SPRINT_FILE"
+echo ""
+echo "To remove from planning.yaml, manually edit or use:"
+echo "  yq eval -i 'del(.planning.initiatives[].epics[] | select(.id == \"$EPIC_ID\"))' $PLANNING_FILE"
+echo ""
+echo "Next steps:"
+echo "  1. Review the appended YAML in $SPRINT_FILE"
+echo "  2. Optionally create Jira epic: .pennyfarthing/scripts/core/run.sh create-jira-epic.sh $EPIC_ID"
+echo "  3. Remove from planning.yaml if desired"

package/pennyfarthing-dist/skills/sprint/scripts/sprint-info.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# Output sprint info as JSON for Cyclist sidebar
+# Usage: .pennyfarthing/scripts/core/run.sh sprint/sprint-info.sh
+#
+# Returns: {"remaining": N, "inProgress": N, "endDate": "YYYY-MM-DD"}
+
+set -euo pipefail
+
+# PROJECT_ROOT should be set by run.sh
+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"
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo '{"remaining": 0, "inProgress": 0, "endDate": null}'
+  exit 0
+fi
+
+# Extract end date
+END_DATE=$(yq -r '.sprint.end_date // ""' "$SPRINT_FILE")
+if [[ -z "$END_DATE" || "$END_DATE" == "null" ]]; then
+  END_DATE="null"
+else
+  END_DATE="\"$END_DATE\""
+fi
+
+# Calculate remaining points (backlog stories) - use awk for sum since yq add is problematic
+REMAINING=$(yq '.epics[].stories[] | select(.status == "backlog" or .status == null) | .points // 0' "$SPRINT_FILE" 2>/dev/null | awk '{sum+=$1} END {print sum+0}')
+
+# Calculate in-progress points
+IN_PROGRESS=$(yq '.epics[].stories[] | select(.status == "in_progress") | .points // 0' "$SPRINT_FILE" 2>/dev/null | awk '{sum+=$1} END {print sum+0}')
+
+echo "{\"remaining\": $REMAINING, \"inProgress\": $IN_PROGRESS, \"endDate\": $END_DATE}"

package/pennyfarthing-dist/skills/sprint/scripts/sprint-status.sh

@@ -0,0 +1,147 @@
+#!/bin/bash
+# Display current sprint status
+# Usage: .pennyfarthing/scripts/core/run.sh sprint/sprint-status.sh [filter]
+#    or: Invoked with PROJECT_ROOT already set
+#
+# Filters:
+#   (none)       - Show all stories
+#   todo         - Show only backlog stories
+#   in-progress  - Show only in_progress stories
+#   done         - Show only done/cancelled stories
+
+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
+
+# Parse filter argument
+FILTER="${1:-}"
+case "$FILTER" in
+  todo|backlog)
+    STATUS_FILTER="backlog"
+    FILTER_LABEL="Todo"
+    ;;
+  in-progress|wip)
+    STATUS_FILTER="in_progress"
+    FILTER_LABEL="In Progress"
+    ;;
+  done|completed)
+    STATUS_FILTER="done"
+    FILTER_LABEL="Done"
+    ;;
+  cancelled|canceled)
+    STATUS_FILTER="cancelled"
+    FILTER_LABEL="Cancelled"
+    ;;
+  "")
+    STATUS_FILTER=""
+    FILTER_LABEL=""
+    ;;
+  *)
+    echo "Error: Unknown filter '$FILTER'"
+    echo "Valid filters: todo, in-progress, done, cancelled"
+    exit 1
+    ;;
+esac
+
+SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+if ! command -v yq &> /dev/null; then
+  echo "Error: yq is required but not installed"
+  echo "Install with: brew install yq"
+  exit 1
+fi
+
+# Extract sprint metadata
+SPRINT_NAME=$(yq eval '.sprint.name' "$SPRINT_FILE")
+SPRINT_GOAL=$(yq eval '.sprint.goal' "$SPRINT_FILE")
+START_DATE=$(yq eval '.sprint.start_date' "$SPRINT_FILE")
+END_DATE=$(yq eval '.sprint.end_date' "$SPRINT_FILE")
+STATUS=$(yq eval '.sprint.status' "$SPRINT_FILE")
+
+echo "# Sprint Status"
+echo ""
+echo "**Sprint:** $SPRINT_NAME"
+echo "**Goal:** $SPRINT_GOAL"
+echo "**Dates:** $START_DATE to $END_DATE"
+echo "**Status:** $STATUS"
+echo ""
+
+# Count stories by status
+TOTAL_STORIES=$(yq eval '[.epics[].stories[]] | length' "$SPRINT_FILE")
+BACKLOG=$(yq eval '[.epics[].stories[] | select(.status == "backlog")] | length' "$SPRINT_FILE")
+IN_PROGRESS=$(yq eval '[.epics[].stories[] | select(.status == "in_progress")] | length' "$SPRINT_FILE")
+
+# Sum points using paste+bc (yq add not available in all versions)
+sum_points() {
+  local result
+  result=$(echo "$1" | paste -sd+ - | bc 2>/dev/null)
+  echo "${result:-0}"
+}
+
+TOTAL_POINTS=$(sum_points "$(yq '.epics[].stories[].points' "$SPRINT_FILE")")
+BACKLOG_POINTS=$(sum_points "$(yq '.epics[].stories[] | select(.status == "backlog") | .points' "$SPRINT_FILE")")
+IN_PROGRESS_POINTS=$(sum_points "$(yq '.epics[].stories[] | select(.status == "in_progress") | .points' "$SPRINT_FILE")")
+
+echo "## Summary"
+echo ""
+echo "| Status | Stories | Points |"
+echo "|--------|---------|--------|"
+echo "| Backlog | $BACKLOG | $BACKLOG_POINTS |"
+echo "| In Progress | $IN_PROGRESS | $IN_PROGRESS_POINTS |"
+echo "| **Total Remaining** | **$TOTAL_STORIES** | **$TOTAL_POINTS** |"
+echo ""
+
+# List stories by epic (grouped - epic name appears once)
+if [[ -n "$FILTER_LABEL" ]]; then
+  echo "## Stories by Epic (${FILTER_LABEL} only)"
+else
+  echo "## Stories by Epic"
+fi
+echo ""
+
+# Process each epic, output header once then all its stories
+# Apply status filter if specified
+if [[ -n "$STATUS_FILTER" ]]; then
+  yq eval -o=json '.epics[]' "$SPRINT_FILE" 2>/dev/null | jq -r --arg status "$STATUS_FILTER" '
+    .title as $title |
+    [.stories[] | select(.status == $status)] |
+    if length > 0 then
+      "### " + $title + "\n" +
+      (map("- [" + .status + "] " + .id + ": " + .title + " (" + (.points | tostring) + " pts)") | join("\n")) + "\n"
+    else
+      empty
+    end
+  ' 2>/dev/null || echo "No stories found"
+else
+  yq eval -o=json '.epics[]' "$SPRINT_FILE" 2>/dev/null | jq -r '
+    "### " + .title + "\n" +
+    (.stories | map("- [" + .status + "] " + .id + ": " + .title + " (" + (.points | tostring) + " pts)") | join("\n")) + "\n"
+  ' 2>/dev/null || echo "No stories found"
+fi
+
+# Check archive for completed count
+SPRINT_NUM=$(echo "$SPRINT_NAME" | sed 's/TO Sprint //')
+ARCHIVE_FILE="$PROJECT_ROOT/sprint/archive/sprint-${SPRINT_NUM}-completed.yaml"
+
+if [[ -f "$ARCHIVE_FILE" ]]; then
+  COMPLETED_COUNT=$(yq '.completed | length' "$ARCHIVE_FILE" 2>/dev/null || echo "0")
+  COMPLETED_POINTS=$(sum_points "$(yq '.completed[].points' "$ARCHIVE_FILE" 2>/dev/null)")
+  echo ""
+  echo "## Completed This Sprint"
+  echo ""
+  echo "**Stories:** $COMPLETED_COUNT | **Points:** $COMPLETED_POINTS"
+  echo ""
+  echo "See: sprint/archive/sprint-${SPRINT_NUM}-completed.yaml"
+fi

package/pennyfarthing-dist/skills/sprint/scripts/sync-epic-jira.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# Sync an epic and its stories to Jira
+# Usage: .pennyfarthing/scripts/core/run.sh sync-epic-jira.sh <epic-id> [--dry-run] [--transition] [--points] [--all]
+#
+# Example: .pennyfarthing/scripts/core/run.sh sync-epic-jira.sh MSSCI-11952
+# Example: .pennyfarthing/scripts/core/run.sh sync-epic-jira.sh MSSCI-11952 --all
+#
+# This script syncs status and story points from sprint YAML to Jira.
+# It wraps the existing jira-sync.mjs for better integration with /sprint skill.
+
+set -euo pipefail
+
+EPIC_ID="${1:-}"
+
+if [[ -z "$EPIC_ID" ]]; then
+  echo "Usage: sync-epic-jira.sh <epic-id> [options]"
+  echo ""
+  echo "Syncs an epic and its stories from sprint YAML to Jira."
+  echo ""
+  echo "Options:"
+  echo "  --dry-run      Show what would be done without making changes"
+  echo "  --transition   Transition Jira issues to match sprint YAML status"
+  echo "  --points       Sync story points from sprint YAML to Jira"
+  echo "  --all          Equivalent to --transition --points"
+  echo ""
+  echo "Examples:"
+  echo "  sync-epic-jira.sh MSSCI-11952              # Show sync status"
+  echo "  sync-epic-jira.sh MSSCI-11952 --dry-run    # Preview changes"
+  echo "  sync-epic-jira.sh MSSCI-11952 --all        # Sync status and points"
+  exit 1
+fi
+
+# 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"
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+if ! command -v yq &> /dev/null; then
+  echo "Error: yq is required but not installed"
+  echo "Install with: brew install yq"
+  exit 1
+fi
+
+# Check if epic exists in sprint YAML
+EPIC_EXISTS=$(yq ".epics[] | select(.id == \"$EPIC_ID\") | .id" "$SPRINT_FILE" 2>/dev/null || echo "")
+
+if [[ -z "$EPIC_EXISTS" ]]; then
+  echo "Error: Epic $EPIC_ID not found in $SPRINT_FILE"
+  echo ""
+  echo "Available epics:"
+  yq '.epics[].id' "$SPRINT_FILE" 2>/dev/null || echo "  None found"
+  exit 1
+fi
+
+# Extract epic number for jira-sync.mjs compatibility
+# jira-sync.mjs expects epic number (e.g., 35) not full ID
+# But it also accepts Jira keys directly
+# Let's check if this is a Jira key (MSSCI-XXXXX) or local ID
+
+# Pass through to jira-sync.mjs with remaining arguments
+JIRA_SYNC_SCRIPT="$PROJECT_ROOT/.pennyfarthing/scripts/utils/jira/jira-sync.mjs"
+
+if [[ ! -f "$JIRA_SYNC_SCRIPT" ]]; then
+  # Try alternate location
+  JIRA_SYNC_SCRIPT="$PROJECT_ROOT/pennyfarthing-dist/scripts/utils/jira/jira-sync.mjs"
+fi
+
+if [[ ! -f "$JIRA_SYNC_SCRIPT" ]]; then
+  echo "Error: jira-sync.mjs not found"
+  exit 1
+fi
+
+# Build arguments for jira-sync.mjs
+shift  # Remove epic-id from arguments
+SYNC_ARGS=("$EPIC_ID")
+
+# Handle --all flag
+for arg in "$@"; do
+  case "$arg" in
+    --all)
+      SYNC_ARGS+=("--transition" "--points")
+      ;;
+    *)
+      SYNC_ARGS+=("$arg")
+      ;;
+  esac
+done
+
+echo "Syncing epic $EPIC_ID to Jira..."
+echo ""
+
+# Run jira-sync.mjs
+exec node "$JIRA_SYNC_SCRIPT" "${SYNC_ARGS[@]}"