@pennyfarthing/core 7.9.0 → 7.9.2

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

@@ -1,151 +0,0 @@
-#!/bin/bash
-# Display future work initiatives and epics from future.yaml
-# Usage: .pennyfarthing/scripts/core/run.sh 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
-
-# PROJECT_ROOT should be set by run.sh, but find it if not
-if [[ -z "${PROJECT_ROOT:-}" ]]; then
-  d="$PWD"
-  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-
-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,116 +0,0 @@
-#!/bin/bash
-# Initialize a new sprint from template
-# Usage: .pennyfarthing/scripts/core/run.sh sprint/new-sprint.sh <sprint-yyww> <jira-id> <start-date> <end-date> "<goal>"
-#
-# Example: .pennyfarthing/scripts/core/run.sh 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
-
-# PROJECT_ROOT should be set by run.sh, but find it if not
-if [[ -z "${PROJECT_ROOT:-}" ]]; then
-  d="$PWD"
-  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-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,164 +0,0 @@
-#!/bin/bash
-# Promote an epic from future.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 future.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/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-
-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
-
-# 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 future.yaml, manually edit or use:"
-echo "  yq eval -i 'del(.future.initiatives[].epics[] | select(.id == \"$EPIC_ID\"))' $FUTURE_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 jira/create-jira-epic.sh $EPIC_ID"
-echo "  3. Remove from future.yaml if desired"