@pennyfarthing/core 7.4.1 → 7.5.0

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

@@ -1,164 +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
-
-# 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/scripts/sprint/get-epic-field.sh

@@ -1,58 +0,0 @@
-#!/bin/bash
-# Get a field value from an epic in sprint YAML
-# Usage: .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh <epic-id> <field>
-#
-# Examples:
-#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh epic-35 jira
-#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh epic-35 title
-#   .pennyfarthing/scripts/core/run.sh 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
-
-# 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 "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,69 +0,0 @@
-#!/bin/bash
-# Get a field value from a story in sprint YAML
-# Usage: .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh <story-id> <field>
-#
-# Examples:
-#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 workflow
-#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 jira
-#   .pennyfarthing/scripts/core/run.sh 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
-
-# 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 "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,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/.claude" ]] && [[ "$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/.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"