@pennyfarthing/core 10.0.3 → 10.0.5

package/pennyfarthing-dist/scripts/sprint/check-story.sh

@@ -1,158 +0,0 @@
-#!/bin/bash
-# Check if a story or epic exists and is available for work
-# Usage: check-story.sh <id|next>
-#
-# Arguments:
-#   <story-id>  - Check specific story availability
-#   <epic-id>   - Get first available story in epic
-#   next        - Get highest-priority available story across all epics
-#
-# Returns JSON with story/epic details and availability
-
-set -euo pipefail
-
-ID="${1:-}"
-
-if [[ -z "$ID" ]]; then
-  echo '{"type": "error", "message": "No ID provided"}'
-  exit 1
-fi
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo '{"type": "error", "message": "Sprint file not found"}'
-  exit 1
-fi
-
-# Handle "next" argument - find highest priority available story
-if [[ "$ID" == "next" ]]; then
-  # Get all available stories (backlog or ready), sort by priority, take first
-  NEXT_STORY=$(yq -o json "[.epics[].stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | sort_by(.priority) | .[0]" "$SPRINT_FILE" 2>/dev/null || echo "null")
-
-  if [[ "$NEXT_STORY" != "null" && -n "$NEXT_STORY" ]]; then
-    STORY_ID=$(echo "$NEXT_STORY" | yq -r '.id')
-    STORY_TITLE=$(echo "$NEXT_STORY" | yq -r '.title')
-    STORY_POINTS=$(echo "$NEXT_STORY" | yq -r '.points // 0')
-    STORY_PRIORITY=$(echo "$NEXT_STORY" | yq -r '.priority // "P2"')
-    STORY_WORKFLOW=$(echo "$NEXT_STORY" | yq -r '.workflow // "tdd"')
-    STORY_REPOS=$(echo "$NEXT_STORY" | yq -r '.repos // "pennyfarthing"')
-    STORY_AC=$(echo "$NEXT_STORY" | yq -o json '.acceptance_criteria // []')
-    EPIC_ID=$(yq -r ".epics[] | select(.stories[].id == \"$STORY_ID\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-    cat <<EOF
-{
-  "type": "next",
-  "story": {
-    "id": "$STORY_ID",
-    "title": "$STORY_TITLE",
-    "points": $STORY_POINTS,
-    "priority": "$STORY_PRIORITY",
-    "workflow": "$STORY_WORKFLOW",
-    "repos": "$STORY_REPOS",
-    "epic_id": "$EPIC_ID",
-    "acceptance_criteria": $STORY_AC
-  }
-}
-EOF
-  else
-    echo '{"type": "next", "story": null, "message": "No available stories in backlog"}'
-  fi
-  exit 0
-fi
-
-# Check if it's an epic
-EPIC_DATA=$(yq -o json ".epics[] | select(.id == \"$ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
-
-if [[ -n "$EPIC_DATA" && "$EPIC_DATA" != "null" ]]; then
-  # It's an epic - get first available story by priority
-  FIRST_STORY=$(yq -o json "[.epics[] | select(.id == \"$ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | sort_by(.priority) | .[0]" "$SPRINT_FILE" 2>/dev/null || echo "null")
-
-  EPIC_TITLE=$(echo "$EPIC_DATA" | yq -r '.title // "Unknown"')
-  STORY_COUNT=$(yq "[.epics[] | select(.id == \"$ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | length" "$SPRINT_FILE" 2>/dev/null || echo "0")
-
-  if [[ "$FIRST_STORY" != "null" && -n "$FIRST_STORY" ]]; then
-    STORY_ID=$(echo "$FIRST_STORY" | yq -r '.id')
-    STORY_TITLE=$(echo "$FIRST_STORY" | yq -r '.title')
-    STORY_POINTS=$(echo "$FIRST_STORY" | yq -r '.points // 0')
-    STORY_WORKFLOW=$(echo "$FIRST_STORY" | yq -r '.workflow // "tdd"')
-    STORY_REPOS=$(echo "$FIRST_STORY" | yq -r '.repos // "pennyfarthing"')
-    STORY_AC=$(echo "$FIRST_STORY" | yq -o json '.acceptance_criteria // []')
-
-    cat <<EOF
-{
-  "type": "epic",
-  "id": "$ID",
-  "title": "$EPIC_TITLE",
-  "available_stories": $STORY_COUNT,
-  "first_story": {
-    "id": "$STORY_ID",
-    "title": "$STORY_TITLE",
-    "points": $STORY_POINTS,
-    "workflow": "$STORY_WORKFLOW",
-    "repos": "$STORY_REPOS",
-    "acceptance_criteria": $STORY_AC
-  }
-}
-EOF
-  else
-    cat <<EOF
-{
-  "type": "epic",
-  "id": "$ID",
-  "title": "$EPIC_TITLE",
-  "available_stories": 0,
-  "first_story": null,
-  "message": "No available stories in this epic"
-}
-EOF
-  fi
-  exit 0
-fi
-
-# Check if it's a story
-STORY_DATA=$(yq -o json ".epics[].stories[] | select(.id == \"$ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
-
-if [[ -n "$STORY_DATA" && "$STORY_DATA" != "null" ]]; then
-  STATUS=$(echo "$STORY_DATA" | yq -r '.status // "backlog"')
-  ASSIGNED=$(echo "$STORY_DATA" | yq -r '.assigned_to // ""')
-  TITLE=$(echo "$STORY_DATA" | yq -r '.title // "Unknown"')
-  POINTS=$(echo "$STORY_DATA" | yq -r '.points // 0')
-  WORKFLOW=$(echo "$STORY_DATA" | yq -r '.workflow // "tdd"')
-  EPIC_ID=$(yq -r ".epics[] | select(.stories[].id == \"$ID\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
-  REPOS=$(echo "$STORY_DATA" | yq -r '.repos // "pennyfarthing"')
-
-  # Story is available if status is backlog/ready and not assigned
-  if [[ ("$STATUS" == "backlog" || "$STATUS" == "ready") && -z "$ASSIGNED" ]]; then
-    AVAILABLE="true"
-  else
-    AVAILABLE="false"
-  fi
-
-  # Get acceptance criteria as JSON array
-  AC=$(echo "$STORY_DATA" | yq -o json '.acceptance_criteria // []')
-
-  cat <<EOF
-{
-  "type": "story",
-  "id": "$ID",
-  "title": "$TITLE",
-  "points": $POINTS,
-  "workflow": "$WORKFLOW",
-  "status": "$STATUS",
-  "assigned_to": "$ASSIGNED",
-  "epic_id": "$EPIC_ID",
-  "repos": "$REPOS",
-  "available": $AVAILABLE,
-  "acceptance_criteria": $AC
-}
-EOF
-  exit 0
-fi
-
-# Not found
-echo '{"type": "not_found", "id": "'"$ID"'", "message": "Story or epic not found in current sprint"}'
-exit 0

package/pennyfarthing-dist/scripts/sprint/get-epic-field.sh

@@ -1,52 +0,0 @@
-#!/bin/bash
-# Get a field value from an epic in sprint YAML
-# Usage: .pennyfarthing/scripts/sprint/get-epic-field.sh <epic-id> <field>
-#
-# Examples:
-#   .pennyfarthing/scripts/sprint/get-epic-field.sh epic-35 jira
-#   .pennyfarthing/scripts/sprint/get-epic-field.sh epic-35 title
-#   .pennyfarthing/scripts/sprint/get-epic-field.sh 35 jira  # Also works without 'epic-' prefix
-#
-# Common fields: jira, title, description, status
-# Returns the field value or "null" if not found
-
-set -euo pipefail
-
-EPIC_ID="${1:-}"
-FIELD="${2:-}"
-
-if [[ -z "$EPIC_ID" || -z "$FIELD" ]]; then
-  echo "Usage: get-epic-field.sh <epic-id> <field>"
-  echo ""
-  echo "Examples:"
-  echo "  get-epic-field.sh epic-35 jira     # Returns: MSSCI-11234"
-  echo "  get-epic-field.sh epic-35 title    # Returns: Epic title"
-  echo "  get-epic-field.sh 35 jira          # Also works without 'epic-' prefix"
-  echo ""
-  echo "Common fields: jira, title, description, status"
-  exit 1
-fi
-
-# Normalize epic ID - add 'epic-' prefix if not present
-if [[ ! "$EPIC_ID" =~ ^epic- ]]; then
-  EPIC_ID="epic-$EPIC_ID"
-fi
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo "null"
-  exit 1
-fi
-
-# Extract field value using yq
-VALUE=$(yq eval ".epics[] | select(.id == \"$EPIC_ID\") | .$FIELD // \"null\"" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-if [[ -z "$VALUE" ]]; then
-  echo "null"
-else
-  echo "$VALUE"
-fi

package/pennyfarthing-dist/scripts/sprint/get-story-field.sh

@@ -1,63 +0,0 @@
-#!/bin/bash
-# Get a field value from a story in sprint YAML
-# Usage: .pennyfarthing/scripts/sprint/get-story-field.sh <story-id> <field>
-#
-# Examples:
-#   .pennyfarthing/scripts/sprint/get-story-field.sh 35-2 workflow
-#   .pennyfarthing/scripts/sprint/get-story-field.sh 35-2 jira
-#   .pennyfarthing/scripts/sprint/get-story-field.sh 35-2 status
-#
-# Common fields: workflow, status, jira, points, title, repos, priority
-# Returns the field value or "null" if not found
-
-set -euo pipefail
-
-STORY_ID="${1:-}"
-FIELD="${2:-}"
-
-if [[ -z "$STORY_ID" || -z "$FIELD" ]]; then
-  echo "Usage: get-story-field.sh <story-id> <field>"
-  echo ""
-  echo "Examples:"
-  echo "  get-story-field.sh 35-2 workflow    # Returns: tdd"
-  echo "  get-story-field.sh 35-2 jira        # Returns: MSSCI-12345"
-  echo "  get-story-field.sh 35-2 status      # Returns: in_progress"
-  echo ""
-  echo "Common fields: workflow, status, jira, points, title, repos, priority"
-  exit 1
-fi
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo "null"
-  exit 1
-fi
-
-# Extract field value using yq
-# Handle default values for common fields
-case "$FIELD" in
-  workflow)
-    DEFAULT="tdd"
-    ;;
-  status)
-    DEFAULT="backlog"
-    ;;
-  repos)
-    DEFAULT="pennyfarthing"
-    ;;
-  *)
-    DEFAULT="null"
-    ;;
-esac
-
-VALUE=$(yq eval ".epics[].stories[] | select(.id == \"$STORY_ID\") | .$FIELD // \"$DEFAULT\"" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-if [[ -z "$VALUE" ]]; then
-  echo "null"
-else
-  echo "$VALUE"
-fi

package/pennyfarthing-dist/scripts/sprint/list-future.sh

@@ -1,145 +0,0 @@
-#!/bin/bash
-# Display future work initiatives and epics from future.yaml
-# Usage: .pennyfarthing/scripts/sprint/list-future.sh [--epic EPIC_ID]
-#
-# Shows initiatives with their epics, points, status, and blockers
-# Use --epic to show detailed stories for a specific epic
-
-set -euo pipefail
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-FUTURE_FILE="$PROJECT_ROOT/sprint/future.yaml"
-
-if [[ ! -f "$FUTURE_FILE" ]]; then
-  echo "Error: Future file not found at $FUTURE_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
-
-# Parse arguments
-EPIC_DETAIL=""
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --epic)
-      EPIC_DETAIL="$2"
-      shift 2
-      ;;
-    *)
-      echo "Unknown argument: $1"
-      exit 1
-      ;;
-  esac
-done
-
-# If specific epic requested, show detailed view
-if [[ -n "$EPIC_DETAIL" ]]; then
-  echo "# Epic Details: $EPIC_DETAIL"
-  echo ""
-
-  # Find the epic
-  EPIC_DATA=$(yq -o=json ".future.initiatives[].epics[] | select(.id == \"$EPIC_DETAIL\")" "$FUTURE_FILE" 2>/dev/null)
-
-  if [[ -z "$EPIC_DATA" ]]; then
-    echo "Error: Epic $EPIC_DETAIL not found in future.yaml"
-    exit 1
-  fi
-
-  EPIC_TITLE=$(echo "$EPIC_DATA" | jq -r '.title')
-  EPIC_DESC=$(echo "$EPIC_DATA" | jq -r '.description // "No description"' | head -5)
-  EPIC_POINTS=$(echo "$EPIC_DATA" | jq -r '.points')
-  EPIC_PRIORITY=$(echo "$EPIC_DATA" | jq -r '.priority // "P2"')
-  EPIC_STATUS=$(echo "$EPIC_DATA" | jq -r '.status // "planning"')
-
-  echo "**Title:** $EPIC_TITLE"
-  echo "**Points:** $EPIC_POINTS | **Priority:** $EPIC_PRIORITY | **Status:** $EPIC_STATUS"
-  echo ""
-  echo "**Description:**"
-  echo "$EPIC_DESC"
-  echo ""
-  echo "## Stories"
-  echo ""
-  echo "| ID | Title | Pts | Pri | Status |"
-  echo "|----|-------|-----|-----|--------|"
-
-  echo "$EPIC_DATA" | jq -r '.stories[]? | [.id, .title, (.points | tostring), (.priority // "P1"), (.status // "planning")] | @tsv' | \
-    while IFS=$'\t' read -r story_id story_title story_points story_priority story_status; do
-      # Truncate title if too long
-      if [[ ${#story_title} -gt 45 ]]; then
-        story_title="${story_title:0:42}..."
-      fi
-      echo "| $story_id | $story_title | $story_points | $story_priority | $story_status |"
-    done
-
-  echo ""
-  echo "---"
-  echo "To promote this epic: \`/sprint promote $EPIC_DETAIL\`"
-  exit 0
-fi
-
-# Default: show initiative summary
-echo "# Future Work - Available for Promotion"
-echo ""
-
-# Get initiatives
-INITIATIVE_COUNT=$(yq '.future.initiatives | length' "$FUTURE_FILE")
-
-for ((i=0; i<INITIATIVE_COUNT; i++)); do
-  INIT_NAME=$(yq ".future.initiatives[$i].name" "$FUTURE_FILE")
-  INIT_STATUS=$(yq ".future.initiatives[$i].status // \"planning\"" "$FUTURE_FILE")
-  INIT_BLOCKED=$(yq ".future.initiatives[$i].blocked_by // \"\"" "$FUTURE_FILE")
-  INIT_POINTS=$(yq ".future.initiatives[$i].total_points // 0" "$FUTURE_FILE")
-
-  # Status indicator
-  if [[ "$INIT_STATUS" == "ready" ]]; then
-    STATUS_ICON="[READY]"
-  elif [[ -n "$INIT_BLOCKED" && "$INIT_BLOCKED" != "null" ]]; then
-    STATUS_ICON="[BLOCKED]"
-  else
-    STATUS_ICON="[$INIT_STATUS]"
-  fi
-
-  echo "## $INIT_NAME $STATUS_ICON"
-  echo "**Total:** $INIT_POINTS points"
-
-  if [[ -n "$INIT_BLOCKED" && "$INIT_BLOCKED" != "null" ]]; then
-    echo "**Blocked:** $INIT_BLOCKED"
-  fi
-  echo ""
-
-  echo "| Epic | Title | Pts | Pri | Status |"
-  echo "|------|-------|-----|-----|--------|"
-
-  # Get epics for this initiative
-  yq -o=json ".future.initiatives[$i].epics[]" "$FUTURE_FILE" 2>/dev/null | \
-    jq -r '[.id, .title, (.points | tostring), (.priority // "P2"), (.status // "planning")] | @tsv' | \
-    while IFS=$'\t' read -r epic_id epic_title epic_points epic_priority epic_status; do
-      # Truncate title if too long
-      if [[ ${#epic_title} -gt 40 ]]; then
-        epic_title="${epic_title:0:37}..."
-      fi
-      echo "| $epic_id | $epic_title | $epic_points | $epic_priority | $epic_status |"
-    done
-
-  echo ""
-done
-
-# Summary
-TOTAL_EPICS=$(yq '[.future.initiatives[].epics[]] | length' "$FUTURE_FILE")
-TOTAL_POINTS=$(yq '.future.initiatives[].epics[].points' "$FUTURE_FILE" | paste -sd+ - | bc 2>/dev/null || echo "0")
-READY_COUNT=$(yq '[.future.initiatives[] | select(.status == "ready") | .epics[]] | length' "$FUTURE_FILE")
-
-echo "---"
-echo "**Summary:** $TOTAL_EPICS epics, $TOTAL_POINTS points total"
-if [[ "$READY_COUNT" -gt 0 ]]; then
-  echo "**Ready to promote:** $READY_COUNT epics"
-fi
-echo ""
-echo "To see epic details: \`/sprint future --epic epic-55\`"
-echo "To promote an epic: \`/sprint promote epic-55\`"

package/pennyfarthing-dist/scripts/sprint/new-sprint.sh

@@ -1,110 +0,0 @@
-#!/bin/bash
-# Initialize a new sprint from template
-# Usage: .pennyfarthing/scripts/sprint/new-sprint.sh <sprint-yyww> <jira-id> <start-date> <end-date> "<goal>"
-#
-# Example: .pennyfarthing/scripts/sprint/new-sprint.sh 2605 277 2026-02-03 2026-02-16 "Polish and stabilization"
-
-set -euo pipefail
-
-SPRINT_YYWW="${1:-}"
-JIRA_ID="${2:-}"
-START_DATE="${3:-}"
-END_DATE="${4:-}"
-GOAL="${5:-}"
-
-if [[ -z "$SPRINT_YYWW" || -z "$JIRA_ID" || -z "$START_DATE" || -z "$END_DATE" || -z "$GOAL" ]]; then
-  echo "Usage: new-sprint.sh <sprint-yyww> <jira-id> <start-date> <end-date> \"<goal>\""
-  echo ""
-  echo "Arguments:"
-  echo "  sprint-yyww  Sprint identifier in YYWW format (e.g., 2605 for 2026 week 5)"
-  echo "  jira-id      Jira sprint ID number (e.g., 277)"
-  echo "  start-date   Sprint start date YYYY-MM-DD"
-  echo "  end-date     Sprint end date YYYY-MM-DD"
-  echo "  goal         Sprint goal (quoted string)"
-  echo ""
-  echo "Example:"
-  echo "  new-sprint.sh 2605 277 2026-02-03 2026-02-16 \"Polish and stabilization\""
-  exit 1
-fi
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-TEMPLATE_FILE="$PROJECT_ROOT/sprint/sprint-template.yaml"
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-ARCHIVE_FILE="$PROJECT_ROOT/sprint/archive/sprint-${SPRINT_YYWW}-completed.yaml"
-
-# Check template exists
-if [[ ! -f "$TEMPLATE_FILE" ]]; then
-  echo "Error: Template file not found at $TEMPLATE_FILE"
-  exit 1
-fi
-
-# Warn if current sprint file exists and is active
-if [[ -f "$SPRINT_FILE" ]]; then
-  if ! command -v yq &> /dev/null; then
-    echo "Warning: yq not installed, cannot check current sprint status"
-  else
-    CURRENT_STATUS=$(yq eval '.sprint.status' "$SPRINT_FILE")
-    if [[ "$CURRENT_STATUS" == "active" ]]; then
-      echo "Warning: Current sprint is still active!"
-      echo "Current sprint file will be overwritten."
-      echo ""
-      read -p "Continue? [y/N] " -n 1 -r
-      echo
-      if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        echo "Aborted."
-        exit 1
-      fi
-    fi
-  fi
-fi
-
-# Create new sprint file
-cat > "$SPRINT_FILE" << EOF
-sprint:
-  name: "TO Sprint $SPRINT_YYWW"
-  jira_sprint_id: $JIRA_ID
-  jira_sprint_name: "TO Sprint $SPRINT_YYWW"
-  goal: $GOAL
-  start_date: $START_DATE
-  end_date: $END_DATE
-  status: active
-
-# Completed stories archived to: sprint/archive/sprint-${SPRINT_YYWW}-completed.yaml
-
-epics:
-  # Add epics and stories here
-  # See sprint/sprint-template.yaml for format reference
-EOF
-
-echo "Created $SPRINT_FILE"
-
-# Create archive file
-cat > "$ARCHIVE_FILE" << EOF
-# Sprint TO Sprint $SPRINT_YYWW - Completed Stories
-# Jira Sprint ID: $JIRA_ID
-# Archived: $(date +%Y-%m-%d)
-
-sprint:
-  name: "TO Sprint $SPRINT_YYWW"
-  jira_sprint_id: $JIRA_ID
-  jira_sprint_name: "TO Sprint $SPRINT_YYWW"
-  goal: $GOAL
-
-completed:
-  # Completed stories will be appended here by archive-story.sh
-EOF
-
-echo "Created $ARCHIVE_FILE"
-
-echo ""
-echo "New sprint initialized:"
-echo "  Name: TO Sprint $SPRINT_YYWW"
-echo "  Jira ID: $JIRA_ID"
-echo "  Dates: $START_DATE to $END_DATE"
-echo "  Goal: $GOAL"
-echo ""
-echo "Next steps:"
-echo "  1. Add epics and stories to $SPRINT_FILE"
-echo "  2. Use sprint-status.sh to check progress"
-echo "  3. Use archive-story.sh to move completed stories"

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

@@ -1,148 +0,0 @@
-#!/bin/bash
-# Promote an epic from future.yaml to current-sprint.yaml
-# Usage: .pennyfarthing/scripts/sprint/promote-epic.sh <epic-id>
-#
-# Example: .pennyfarthing/scripts/sprint/promote-epic.sh epic-41
-#
-# Features:
-# - Detects ID collisions and assigns new ID if needed
-# - Uses yq for proper YAML array insertion
-# - Automatically removes from future.yaml after successful promotion
-
-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 future.yaml to current-sprint.yaml"
-  exit 1
-fi
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-FUTURE_FILE="$PROJECT_ROOT/sprint/future.yaml"
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$FUTURE_FILE" ]]; then
-  echo "Error: Future file not found at $FUTURE_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 future.yaml
-# Epics are nested under future.initiatives[].epics[]
-EPIC_DATA=$(yq -o json ".future.initiatives[].epics[] | select(.id == \"$EPIC_ID\")" "$FUTURE_FILE" 2>/dev/null || echo "")
-
-if [[ -z "$EPIC_DATA" || "$EPIC_DATA" == "null" ]]; then
-  echo "Error: Epic $EPIC_ID not found in $FUTURE_FILE"
-  echo ""
-  echo "Available epics:"
-  yq '.future.initiatives[].epics[].id' "$FUTURE_FILE" 2>/dev/null || echo "  None found"
-  exit 1
-fi
-
-# Check for ID collision in current-sprint.yaml
-EXISTING_ID=$(yq ".epics[] | select(.id == \"$EPIC_ID\") | .id" "$SPRINT_FILE" 2>/dev/null || echo "")
-
-NEW_EPIC_ID="$EPIC_ID"
-if [[ -n "$EXISTING_ID" && "$EXISTING_ID" != "null" ]]; then
-  echo "Warning: Epic ID $EPIC_ID already exists in current sprint."
-
-  # Find the highest epic-N ID and increment
-  MAX_EPIC_NUM=$(yq '.epics[].id' "$SPRINT_FILE" 2>/dev/null | grep -oE 'epic-[0-9]+' | sed 's/epic-//' | sort -n | tail -1 || echo "0")
-  if [[ -z "$MAX_EPIC_NUM" ]]; then
-    MAX_EPIC_NUM=0
-  fi
-  NEW_EPIC_NUM=$((MAX_EPIC_NUM + 1))
-  NEW_EPIC_ID="epic-$NEW_EPIC_NUM"
-
-  echo "Assigning new ID: $NEW_EPIC_ID"
-  echo ""
-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 "  Original ID: $EPIC_ID"
-if [[ "$NEW_EPIC_ID" != "$EPIC_ID" ]]; then
-  echo "  New ID: $NEW_EPIC_ID"
-fi
-echo "  Title: $EPIC_TITLE"
-echo "  Points: $EPIC_POINTS"
-echo "  Priority: $EPIC_PRIORITY"
-echo "  Stories: $STORY_COUNT"
-echo ""
-
-# Build the new epic object as JSON, then use yq to append it properly
-# This ensures valid YAML structure
-
-# Extract old epic ID prefix for updating story IDs (e.g., "64" from "epic-64")
-OLD_ID_NUM=$(echo "$EPIC_ID" | sed 's/epic-//')
-NEW_ID_NUM=$(echo "$NEW_EPIC_ID" | sed 's/epic-//')
-
-# Create a temp file for the new epic
-TEMP_EPIC=$(mktemp)
-trap "rm -f $TEMP_EPIC" EXIT
-
-# Transform the epic data: update IDs, add required fields, format for current-sprint.yaml
-# Note: Using -o yaml for Go yq (not -y which is Python yq)
-echo "$EPIC_DATA" | yq -o yaml "
-  .id = \"$NEW_EPIC_ID\" |
-  .type = \"epic\" |
-  .title = \"Epic: \" + .title |
-  .status = \"backlog\" |
-  .stories = [.stories[] |
-    .id = ((.id | tostring) | sub(\"^${OLD_ID_NUM}-\"; \"${NEW_ID_NUM}-\")) |
-    .status = \"backlog\" |
-    .repos = (.repos // \"pennyfarthing\") |
-    .workflow = (.workflow // \"tdd\") |
-    .priority = (.priority // \"P2\") |
-    .acceptance_criteria = (.acceptance_criteria // [])
-  ]
-" > "$TEMP_EPIC"
-
-echo "Epic to add:"
-echo "---"
-cat "$TEMP_EPIC"
-echo "---"
-echo ""
-
-# Use yq to properly append the epic to the epics array
-yq eval -i ".epics += [$(cat "$TEMP_EPIC" | yq -o json)]" "$SPRINT_FILE"
-
-echo "Successfully added epic to $SPRINT_FILE"
-
-# Remove from future.yaml
-echo ""
-echo "Removing from future.yaml..."
-yq eval -i "del(.future.initiatives[].epics[] | select(.id == \"$EPIC_ID\"))" "$FUTURE_FILE"
-echo "Removed $EPIC_ID from future.yaml"
-
-echo ""
-echo "Promotion complete!"
-echo ""
-echo "Next steps:"
-echo "  1. Review the epic in $SPRINT_FILE"
-echo "  2. Create Jira epic: .pennyfarthing/scripts/jira/create-jira-epic.sh $NEW_EPIC_ID"
-echo "  3. Start work: /sprint work ${NEW_ID_NUM}-1"