@pennyfarthing/core 7.4.1 → 7.5.0

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

@@ -1,241 +0,0 @@
-#!/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

@@ -1,134 +0,0 @@
-#!/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

@@ -1,23 +0,0 @@
-# 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

@@ -1,159 +0,0 @@
-#!/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