@pennyfarthing/core 7.4.0 → 7.4.1

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

@@ -0,0 +1,164 @@
+#!/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
+
+# 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 '{"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/skills/sprint/scripts/create-jira-epic.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# Create a Jira epic and its child stories from sprint YAML
+# Usage: .pennyfarthing/scripts/core/run.sh create-jira-epic.sh <epic-id> [--dry-run]
+
+set -euo pipefail
+
+EPIC_ID="${1:-}"
+DRY_RUN=false
+
+for arg in "$@"; do
+  case "$arg" in
+    --dry-run) DRY_RUN=true ;;
+  esac
+done
+
+if [[ -z "$EPIC_ID" ]]; then
+  echo "Usage: create-jira-epic.sh <epic-id> [--dry-run]"
+  exit 1
+fi
+
+# Find project root
+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"
+SCRIPTS_DIR="$PROJECT_ROOT/.pennyfarthing/scripts"
+JIRA_PROJECT="${JIRA_PROJECT_KEY:-MSSCI}"
+PROJECT_LABEL="${PROJECT_LABEL:-${PROJECT_NAME:-pennyfarthing}}"
+
+# Find epic (by id or jira key)
+EPIC_DATA=$(yq -o json ".epics[] | select(.id == \"$EPIC_ID\" or .jira == \"$EPIC_ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
+
+if [[ -z "$EPIC_DATA" || "$EPIC_DATA" == "null" ]]; then
+  echo "Error: Epic $EPIC_ID not found"
+  yq '.epics[].id' "$SPRINT_FILE" 2>/dev/null
+  exit 1
+fi
+
+EPIC_TITLE=$(echo "$EPIC_DATA" | yq -r '.title // "Unknown"' | sed 's/^Epic: //')
+EPIC_JIRA=$(echo "$EPIC_DATA" | yq -r '.jira // ""')
+
+echo ""
+echo "Epic: $EPIC_TITLE"
+echo "Dry run: $DRY_RUN"
+echo ""
+
+# Create epic if needed
+if [[ -n "$EPIC_JIRA" && "$EPIC_JIRA" != "null" ]]; then
+  echo "Epic already exists: $EPIC_JIRA"
+  JIRA_EPIC_KEY="$EPIC_JIRA"
+else
+  if [[ "$DRY_RUN" == "true" ]]; then
+    echo "[DRY RUN] Would create epic: $EPIC_TITLE"
+    JIRA_EPIC_KEY="MSSCI-XXXXX"
+  else
+    EPIC_DESCRIPTION=$(echo "$EPIC_DATA" | yq -r '.description // ""')
+    EPIC_OUTPUT=$(echo "" | jira issue create \
+      --project "$JIRA_PROJECT" \
+      --type Epic \
+      --summary "$EPIC_TITLE" \
+      --body "$EPIC_DESCRIPTION" \
+      --label "$PROJECT_LABEL" \
+      --no-input 2>&1) || {
+        echo "Error: $EPIC_OUTPUT"
+        exit 1
+      }
+
+    JIRA_EPIC_KEY=$(echo "$EPIC_OUTPUT" | grep -oE 'MSSCI-[0-9]+' | head -1)
+    echo "Created epic: $JIRA_EPIC_KEY"
+
+    yq eval -i "(.epics[] | select(.id == \"$EPIC_ID\")).jira = \"$JIRA_EPIC_KEY\"" "$SPRINT_FILE"
+  fi
+fi
+
+echo ""
+echo "Creating stories..."
+echo ""
+
+# Get story IDs that need Jira keys
+STORY_IDS=$(yq -r "(.epics[] | select(.jira == \"$JIRA_EPIC_KEY\" or .id == \"$EPIC_ID\")).stories[] | select(.jira == null or .jira == \"\") | .id" "$SPRINT_FILE" 2>/dev/null || echo "")
+
+if [[ -z "$STORY_IDS" ]]; then
+  echo "All stories already have Jira keys"
+else
+  for STORY_ID in $STORY_IDS; do
+    if [[ "$DRY_RUN" == "true" ]]; then
+      TITLE=$(yq -r "(.epics[] | select(.jira == \"$JIRA_EPIC_KEY\" or .id == \"$EPIC_ID\")).stories[] | select(.id == \"$STORY_ID\") | .title" "$SPRINT_FILE")
+      echo "[DRY RUN] Would create: $STORY_ID - $TITLE"
+    else
+      "$SCRIPTS_DIR/create-jira-story.sh" "$JIRA_EPIC_KEY" "$STORY_ID"
+    fi
+  done
+fi
+
+echo ""
+echo "Done. View epic: jira issue view $JIRA_EPIC_KEY"

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

@@ -0,0 +1,116 @@
+#!/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/.claude" ]] && [[ "$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/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}"