@pennyfarthing/core 7.4.0 → 7.4.1

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

@@ -0,0 +1,241 @@
+#!/usr/bin/env zsh
+# Sprint metrics calculator
+# Usage: ./sprint-metrics.sh [--json]
+#
+# Displays sprint statistics from sprint/current-sprint.yaml:
+# - Points burned vs remaining
+# - Story completion rates
+# - Days remaining in sprint
+# - Percentage complete
+
+set -e
+
+# Find project root
+find_project_root() {
+    local dir="$PWD"
+    while [[ ! -d "$dir/.claude" ]] && [[ "$dir" != "/" ]]; do
+        dir="$(dirname "$dir")"
+    done
+    if [[ -d "$dir/.claude" ]]; then
+        echo "$dir"
+    else
+        echo "$PWD"
+    fi
+}
+
+PROJECT_ROOT="${PROJECT_ROOT:-$(find_project_root)}"
+SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+MAGENTA='\033[0;35m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# Check for JSON output mode
+JSON_MODE=false
+for arg in "$@"; do
+    case $arg in
+        --json)
+            JSON_MODE=true
+            ;;
+        -h|--help)
+            cat << 'EOF'
+Sprint Metrics - Display current sprint statistics
+
+Usage: ./sprint-metrics.sh [--json]
+
+Options:
+  --json    Output in JSON format (for automation)
+  -h        Show this help
+
+Output includes:
+  - Sprint number and goal
+  - Points: completed, in progress, remaining
+  - Stories: done, in progress, backlog counts
+  - Days elapsed and remaining
+  - Percentage complete
+  - Velocity tracking
+
+EOF
+            exit 0
+            ;;
+    esac
+done
+
+# Verify sprint file exists
+if [[ ! -f "$SPRINT_FILE" ]]; then
+    echo -e "${RED}❌ Sprint file not found: $SPRINT_FILE${NC}"
+    exit 1
+fi
+
+# Parse sprint metadata
+SPRINT_NUMBER=$(grep -E "^  number:" "$SPRINT_FILE" | head -1 | awk '{print $2}')
+SPRINT_GOAL=$(grep -E "^  goal:" "$SPRINT_FILE" | head -1 | sed 's/.*goal: *"//' | sed 's/"$//')
+START_DATE=$(grep -E "^  start_date:" "$SPRINT_FILE" | head -1 | awk '{print $2}')
+END_DATE=$(grep -E "^  end_date:" "$SPRINT_FILE" | head -1 | awk '{print $2}')
+
+# Parse summary section
+TOTAL_POINTS=$(grep -E "^  total_points:" "$SPRINT_FILE" | awk '{print $2}')
+COMPLETED_POINTS=$(grep -E "^  completed_points:" "$SPRINT_FILE" | awk '{print $2}')
+IN_PROGRESS_POINTS=$(grep -E "^  in_progress_points:" "$SPRINT_FILE" | awk '{print $2}')
+BACKLOG_POINTS=$(grep -E "^  backlog_points:" "$SPRINT_FILE" | awk '{print $2}')
+VELOCITY_TARGET=$(grep -E "^  velocity_target:" "$SPRINT_FILE" | awk '{print $2}')
+
+# Count stories by status
+DONE_STORIES=$(grep -E "^\s+status: done" "$SPRINT_FILE" | wc -l | tr -d ' ')
+IN_PROGRESS_STORIES=$(grep -E "^\s+status: in.progress" "$SPRINT_FILE" | wc -l | tr -d ' ')
+BACKLOG_STORIES=$(grep -E "^\s+status: backlog" "$SPRINT_FILE" | wc -l | tr -d ' ')
+TOTAL_STORIES=$((DONE_STORIES + IN_PROGRESS_STORIES + BACKLOG_STORIES))
+
+# Calculate dates
+TODAY=$(date +%Y-%m-%d)
+START_EPOCH=$(date -j -f "%Y-%m-%d" "$START_DATE" +%s 2>/dev/null || date -d "$START_DATE" +%s 2>/dev/null)
+END_EPOCH=$(date -j -f "%Y-%m-%d" "$END_DATE" +%s 2>/dev/null || date -d "$END_DATE" +%s 2>/dev/null)
+TODAY_EPOCH=$(date +%s)
+
+TOTAL_DAYS=$(( (END_EPOCH - START_EPOCH) / 86400 ))
+DAYS_ELAPSED=$(( (TODAY_EPOCH - START_EPOCH) / 86400 ))
+DAYS_REMAINING=$(( (END_EPOCH - TODAY_EPOCH) / 86400 ))
+
+# Ensure non-negative
+[[ $DAYS_ELAPSED -lt 0 ]] && DAYS_ELAPSED=0
+[[ $DAYS_REMAINING -lt 0 ]] && DAYS_REMAINING=0
+
+# Calculate percentages
+if [[ $TOTAL_POINTS -gt 0 ]]; then
+    PERCENT_COMPLETE=$(( (COMPLETED_POINTS * 100) / TOTAL_POINTS ))
+else
+    PERCENT_COMPLETE=0
+fi
+
+if [[ $TOTAL_DAYS -gt 0 ]]; then
+    PERCENT_TIME=$(( (DAYS_ELAPSED * 100) / TOTAL_DAYS ))
+else
+    PERCENT_TIME=0
+fi
+
+# Calculate velocity tracking
+EXPECTED_POINTS=0
+if [[ $TOTAL_DAYS -gt 0 ]]; then
+    EXPECTED_POINTS=$(( (VELOCITY_TARGET * DAYS_ELAPSED) / TOTAL_DAYS ))
+fi
+
+# JSON output mode
+if [[ "$JSON_MODE" == "true" ]]; then
+    cat << EOF
+{
+  "sprint": $SPRINT_NUMBER,
+  "dates": {
+    "start": "$START_DATE",
+    "end": "$END_DATE",
+    "today": "$TODAY"
+  },
+  "points": {
+    "total": $TOTAL_POINTS,
+    "completed": $COMPLETED_POINTS,
+    "in_progress": $IN_PROGRESS_POINTS,
+    "backlog": $BACKLOG_POINTS,
+    "velocity_target": $VELOCITY_TARGET
+  },
+  "stories": {
+    "total": $TOTAL_STORIES,
+    "done": $DONE_STORIES,
+    "in_progress": $IN_PROGRESS_STORIES,
+    "backlog": $BACKLOG_STORIES
+  },
+  "progress": {
+    "percent_complete": $PERCENT_COMPLETE,
+    "percent_time": $PERCENT_TIME,
+    "days_elapsed": $DAYS_ELAPSED,
+    "days_remaining": $DAYS_REMAINING,
+    "total_days": $TOTAL_DAYS
+  },
+  "velocity": {
+    "expected_points": $EXPECTED_POINTS,
+    "actual_points": $COMPLETED_POINTS,
+    "on_track": $([ $COMPLETED_POINTS -ge $EXPECTED_POINTS ] && echo "true" || echo "false")
+  }
+}
+EOF
+    exit 0
+fi
+
+# Human-readable output
+echo ""
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${BLUE}  Sprint $SPRINT_NUMBER Metrics${NC}"
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+echo ""
+echo -e "${BOLD}📋 Goal:${NC} $SPRINT_GOAL"
+
+echo ""
+echo -e "${BOLD}📅 Timeline${NC}"
+echo -e "   Start:     ${CYAN}$START_DATE${NC}"
+echo -e "   End:       ${CYAN}$END_DATE${NC}"
+echo -e "   Today:     ${CYAN}$TODAY${NC} (Day $DAYS_ELAPSED of $TOTAL_DAYS)"
+if [[ $DAYS_REMAINING -gt 0 ]]; then
+    echo -e "   Remaining: ${GREEN}$DAYS_REMAINING days${NC}"
+else
+    echo -e "   Remaining: ${RED}Sprint ended${NC}"
+fi
+
+echo ""
+echo -e "${BOLD}📊 Points${NC}"
+printf "   Completed:   ${GREEN}%3d${NC} pts\n" "$COMPLETED_POINTS"
+printf "   In Progress: ${YELLOW}%3d${NC} pts\n" "$IN_PROGRESS_POINTS"
+printf "   Backlog:     ${CYAN}%3d${NC} pts\n" "$BACKLOG_POINTS"
+echo -e "   ─────────────────"
+printf "   Total:       ${BOLD}%3d${NC} pts\n" "$TOTAL_POINTS"
+
+echo ""
+echo -e "${BOLD}📈 Stories${NC}"
+printf "   Done:        ${GREEN}%3d${NC}\n" "$DONE_STORIES"
+printf "   In Progress: ${YELLOW}%3d${NC}\n" "$IN_PROGRESS_STORIES"
+printf "   Backlog:     ${CYAN}%3d${NC}\n" "$BACKLOG_STORIES"
+echo -e "   ─────────────────"
+printf "   Total:       ${BOLD}%3d${NC}\n" "$TOTAL_STORIES"
+
+echo ""
+echo -e "${BOLD}🎯 Progress${NC}"
+
+# Progress bar for points
+BAR_WIDTH=20
+FILLED=$(( (PERCENT_COMPLETE * BAR_WIDTH) / 100 ))
+EMPTY=$((BAR_WIDTH - FILLED))
+BAR=""
+for ((i=0; i<FILLED; i++)); do BAR+="█"; done
+for ((i=0; i<EMPTY; i++)); do BAR+="░"; done
+
+echo -e "   Points:   [${GREEN}${BAR}${NC}] ${PERCENT_COMPLETE}%"
+
+# Progress bar for time
+TIME_FILLED=$(( (PERCENT_TIME * BAR_WIDTH) / 100 ))
+TIME_EMPTY=$((BAR_WIDTH - TIME_FILLED))
+TIME_BAR=""
+for ((i=0; i<TIME_FILLED; i++)); do TIME_BAR+="█"; done
+for ((i=0; i<TIME_EMPTY; i++)); do TIME_BAR+="░"; done
+
+echo -e "   Time:     [${CYAN}${TIME_BAR}${NC}] ${PERCENT_TIME}%"
+
+echo ""
+echo -e "${BOLD}🏃 Velocity${NC}"
+echo -e "   Target:   ${CYAN}$VELOCITY_TARGET${NC} pts/sprint"
+echo -e "   Expected: ${CYAN}$EXPECTED_POINTS${NC} pts by now"
+echo -e "   Actual:   ${GREEN}$COMPLETED_POINTS${NC} pts completed"
+
+if [[ $COMPLETED_POINTS -ge $EXPECTED_POINTS ]]; then
+    echo -e "   Status:   ${GREEN}✅ On track${NC}"
+elif [[ $COMPLETED_POINTS -ge $((EXPECTED_POINTS - 2)) ]]; then
+    echo -e "   Status:   ${YELLOW}⚠️  Slightly behind${NC}"
+else
+    echo -e "   Status:   ${RED}❌ Behind schedule${NC}"
+fi
+
+echo ""
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"

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

@@ -0,0 +1,134 @@
+#!/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
+
+# Load shared sprint functions
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/sprint-common.sh"
+
+# 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=$(get_sprint_file)
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+check_yq || exit 1
+
+# Extract sprint metadata using shared function pattern
+SPRINT_NUM=$(get_sprint_metadata "number")
+SPRINT_NAME="TO Sprint $SPRINT_NUM"
+SPRINT_GOAL=$(get_sprint_metadata "goal")
+START_DATE=$(get_sprint_metadata "start_date")
+END_DATE=$(get_sprint_metadata "end_date")
+STATUS=$(get_sprint_metadata "status")
+
+echo "# Sprint Status"
+echo ""
+echo "**Sprint:** $SPRINT_NAME"
+echo "**Goal:** $SPRINT_GOAL"
+echo "**Dates:** $START_DATE to $END_DATE"
+echo "**Status:** $STATUS"
+echo ""
+
+# Get counts using shared functions
+STORY_COUNTS=$(get_story_counts)
+BACKLOG=$(echo "$STORY_COUNTS" | grep -o 'backlog:[0-9]*' | cut -d: -f2)
+IN_PROGRESS=$(echo "$STORY_COUNTS" | grep -o 'in_progress:[0-9]*' | cut -d: -f2)
+TOTAL_STORIES=$((BACKLOG + IN_PROGRESS))
+
+POINT_COUNTS=$(get_point_counts)
+BACKLOG_POINTS=$(echo "$POINT_COUNTS" | grep -o 'backlog:[0-9]*' | cut -d: -f2)
+IN_PROGRESS_POINTS=$(echo "$POINT_COUNTS" | grep -o 'in_progress:[0-9]*' | cut -d: -f2)
+TOTAL_POINTS=$(echo "$POINT_COUNTS" | grep -o 'total:[0-9]*' | cut -d: -f2)
+
+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/scripts/story/README.md

@@ -0,0 +1,23 @@
+# Story Scripts
+
+Scripts for story creation and management.
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `create-story.sh` | Create a new story in sprint YAML |
+| `size-story.sh` | Estimate story points |
+| `story-template.sh` | Generate story template |
+
+## Usage
+
+```bash
+.pennyfarthing/scripts/core/run.sh story/create-story.sh
+.pennyfarthing/scripts/core/run.sh story/size-story.sh
+```
+
+## Ownership
+
+- **Primary users:** SM agent, `/story` skill
+- **Maintained by:** Core Pennyfarthing team

package/pennyfarthing-dist/scripts/story/create-story.sh

@@ -0,0 +1,159 @@
+#!/usr/bin/env bash
+# create-story.sh - Generate a story YAML block for adding to sprint
+# Usage: create-story.sh <epic-id> <title> <points> [options]
+#   --type bug|feature|refactor|chore  Story type (default: feature)
+#   --workflow <name>                  Workflow override (auto-determined if not set)
+#   --priority P0|P1|P2|P3             Priority (default: P2)
+#   --repos <name>                     Repos affected
+#   --jira                             Also show Jira create command
+
+set -euo pipefail
+
+# Defaults
+TYPE="feature"
+WORKFLOW=""
+PRIORITY="P2"
+REPOS=""
+CREATE_JIRA=false
+
+# Parse args
+EPIC_ID=""
+TITLE=""
+POINTS=""
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --type)
+            TYPE="$2"
+            shift 2
+            ;;
+        --workflow)
+            WORKFLOW="$2"
+            shift 2
+            ;;
+        --priority)
+            PRIORITY="$2"
+            shift 2
+            ;;
+        --repos)
+            REPOS="$2"
+            shift 2
+            ;;
+        --jira)
+            CREATE_JIRA=true
+            shift
+            ;;
+        *)
+            if [[ -z "$EPIC_ID" ]]; then
+                EPIC_ID="$1"
+            elif [[ -z "$TITLE" ]]; then
+                TITLE="$1"
+            elif [[ -z "$POINTS" ]]; then
+                POINTS="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Validate required args
+if [[ -z "$EPIC_ID" ]] || [[ -z "$TITLE" ]] || [[ -z "$POINTS" ]]; then
+    cat << 'EOF'
+Usage: create-story.sh <epic-id> "<title>" <points> [options]
+
+Arguments:
+  epic-id    Parent epic (e.g., PROJ-1234)
+  title      Story title (quoted)
+  points     Story points (1, 2, 3, 5, 8)
+
+Options:
+  --type bug|feature|refactor|chore  Story type (default: feature)
+  --workflow <name>                  Override auto-workflow
+  --priority P0|P1|P2|P3             Priority (default: P2)
+  --repos <name>                     Affected repos
+  --jira                             Also show Jira create command
+
+Examples:
+  create-story.sh PROJ-1234 "Add error handling" 3
+  create-story.sh PROJ-1234 "Fix typo" 1 --type chore
+  create-story.sh PROJ-1234 "New feature" 5 --jira
+EOF
+    exit 1
+fi
+
+# Auto-determine workflow if not set
+if [[ -z "$WORKFLOW" ]]; then
+    case "$POINTS" in
+        1|2)
+            if [[ "$TYPE" == "chore" ]] || [[ "$TYPE" == "bug" ]]; then
+                WORKFLOW="trivial"
+            else
+                WORKFLOW="tdd"
+            fi
+            ;;
+        *)
+            WORKFLOW="tdd"
+            ;;
+    esac
+fi
+
+# Generate story ID placeholder
+STORY_ID="PROJ-XXXXX"
+
+# Output YAML block
+echo "# Add this to sprint/current-sprint.yaml under epic $EPIC_ID:"
+echo ""
+echo "      - id: $STORY_ID"
+echo "        title: \"$TITLE\""
+echo "        points: $POINTS"
+echo "        priority: $PRIORITY"
+echo "        status: backlog"
+if [[ -n "$REPOS" ]]; then
+    echo "        repos: $REPOS"
+fi
+echo "        workflow: $WORKFLOW"
+
+# Add type-specific fields
+case "$TYPE" in
+    bug)
+        cat << 'EOF'
+        acceptance_criteria:
+          - Bug no longer occurs
+          - Regression test added
+          - Related code audited for same issue
+EOF
+        ;;
+    feature)
+        cat << 'EOF'
+        acceptance_criteria:
+          - Feature works as specified
+          - Tests cover happy path and edge cases
+          - Error handling implemented
+EOF
+        ;;
+    refactor)
+        cat << 'EOF'
+        acceptance_criteria:
+          - All existing tests pass
+          - No behavior changes
+          - Code follows new pattern
+EOF
+        ;;
+    chore)
+        cat << 'EOF'
+        acceptance_criteria:
+          - Task completed
+          - No regressions introduced
+EOF
+        ;;
+esac
+
+echo ""
+echo "---"
+echo "Type: $TYPE | Workflow: $WORKFLOW | Points: $POINTS"
+
+if [[ "$CREATE_JIRA" == "true" ]]; then
+    echo ""
+    echo "To create in Jira:"
+    echo "  jira issue create -t Story -s \"$TITLE\" -P <PROJECT> --parent $EPIC_ID --custom story-points=$POINTS"
+fi