@pennyfarthing/core 10.0.2 → 10.0.5

package/pennyfarthing-dist/scripts/hooks/cyclist-pretooluse-hook.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+#
+# Cyclist PreToolUse Hook - Shell wrapper for Python implementation
+#
+# Routes tool approval requests through WheelHub when Cyclist is running.
+# Falls back to Claude Code's built-in permissions when Cyclist is not active.
+#
+# Input (stdin): JSON with tool_name, tool_input, session_id, etc.
+# Output (stdout): JSON decision (allow/deny/ask)
+#
+# Story: MSSCI-14320
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+source "$SCRIPT_DIR/../lib/find-root.sh"
+
+# Set PYTHONPATH for pennyfarthing_scripts
+PENNYFARTHING_SCRIPTS=""
+if [[ -d "$PROJECT_ROOT/pennyfarthing" ]]; then
+    # Dogfooding: framework inlined in orchestrator
+    PENNYFARTHING_SCRIPTS="$PROJECT_ROOT/pennyfarthing"
+elif [[ -d "$PROJECT_ROOT/node_modules/@pennyfarthing/core" ]]; then
+    # Normal install
+    PENNYFARTHING_SCRIPTS="$PROJECT_ROOT/node_modules/@pennyfarthing/core"
+fi
+
+if [[ -n "$PENNYFARTHING_SCRIPTS" ]]; then
+    export PYTHONPATH="$PENNYFARTHING_SCRIPTS:${PYTHONPATH:-}"
+fi
+
+python3 -m pennyfarthing_scripts.pretooluse_hook

package/pennyfarthing-dist/scripts/hooks/post-merge.sh

@@ -10,7 +10,7 @@
 #
 # Dependencies:
 #   - yq (for YAML manipulation)
-#   - sprint-common.sh (for shared sprint functions)
+#   (sprint-common.sh removed — all functions defined locally)
 
 set -uo pipefail
 
@@ -22,12 +22,7 @@ source "$(dirname "$REAL_SCRIPT")/../lib/find-root.sh"
 SESSION_DIR="$PROJECT_ROOT/.session"
 SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
 
-# Source sprint-common.sh for shared functions
-SPRINT_COMMON="$PROJECT_ROOT/.pennyfarthing/scripts/sprint/sprint-common.sh"
-if [[ -f "$SPRINT_COMMON" ]]; then
-    # shellcheck source=/dev/null
-    source "$SPRINT_COMMON"
-fi
+# Note: sprint-common.sh removed — all needed functions are defined locally below
 
 # extract_story_id BRANCH_NAME
 # Extract story ID from branch name pattern feat/X-Y-*

package/pennyfarthing-dist/scripts/hooks/sprint-yaml-validation.sh

@@ -15,7 +15,7 @@
 # Input: JSON via stdin with tool_name, tool_input
 # Output: JSON with additionalContext on validation failure
 #
-# See also: .pennyfarthing/scripts/validation/validate-sprint-yaml.sh
+# See also: pf sprint validate
 
 set -euo pipefail
 

package/pennyfarthing-dist/scripts/jira/create-jira-epic.sh

@@ -1,95 +1,16 @@
-#!/bin/bash
+#!/usr/bin/env zsh
 # Create a Jira epic and its child stories from sprint YAML
-# Usage: .pennyfarthing/scripts/jira/create-jira-epic.sh <epic-id> [--dry-run]
+# Usage: create-jira-epic.sh <epic-id> [--dry-run]
+#
+# Thin wrapper that delegates to Python CLI:
+#   python -m pennyfarthing_scripts.jira create epic <epic-id> [--dry-run]
 
-set -euo pipefail
+set -e
 
-EPIC_ID="${1:-}"
-DRY_RUN=false
+# Source common functions for Python discovery
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+source "${PARENT_DIR}/lib/common.sh"
 
-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
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-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/jira/create-jira-story.sh" "$JIRA_EPIC_KEY" "$STORY_ID"
-    fi
-  done
-fi
-
-echo ""
-echo "Done. View epic: jira issue view $JIRA_EPIC_KEY"
+# Delegate to Python CLI
+run_python_module jira create epic "$@"

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

@@ -1,91 +1,16 @@
-#!/bin/bash
+#!/usr/bin/env zsh
 # Create a single Jira story from sprint YAML
-# Usage: create-jira-story.sh <epic-jira-key> <story-id>
+# Usage: create-jira-story.sh <epic-jira-key> <story-id> [--dry-run]
 #
-# Example: create-jira-story.sh MSSCI-12077 MSSCI-12066
+# Thin wrapper that delegates to Python CLI:
+#   python -m pennyfarthing_scripts.jira create story <epic-jira-key> <story-id> [--dry-run]
 
-set -euo pipefail
+set -e
 
-EPIC_JIRA_KEY="${1:-}"
-STORY_ID="${2:-}"
+# Source common functions for Python discovery
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+source "${PARENT_DIR}/lib/common.sh"
 
-if [[ -z "$EPIC_JIRA_KEY" || -z "$STORY_ID" ]]; then
-  echo "Usage: create-jira-story.sh <epic-jira-key> <story-id>"
-  exit 1
-fi
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-JIRA_PROJECT="${JIRA_PROJECT_KEY:-MSSCI}"
-PROJECT_LABEL="${PROJECT_LABEL:-${PROJECT_NAME:-pennyfarthing}}"
-SPRINT_JIRA_ID=$(yq '.sprint.jira_sprint_id' "$SPRINT_FILE" 2>/dev/null || echo "")
-
-# Get story data
-STORY_DATA=$(yq -o json "(.epics[] | select(.jira == \"$EPIC_JIRA_KEY\")).stories[] | select(.id == \"$STORY_ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
-
-if [[ -z "$STORY_DATA" || "$STORY_DATA" == "null" ]]; then
-  echo "Error: Story $STORY_ID not found under epic $EPIC_JIRA_KEY"
-  exit 1
-fi
-
-STORY_TITLE=$(echo "$STORY_DATA" | yq -r '.title // "Untitled"')
-STORY_DESCRIPTION=$(echo "$STORY_DATA" | yq -r '.description // ""')
-STORY_POINTS=$(echo "$STORY_DATA" | yq -r '.points // 0')
-STORY_PRIORITY=$(echo "$STORY_DATA" | yq -r '.priority // "P2"')
-STORY_JIRA=$(echo "$STORY_DATA" | yq -r '.jira // ""')
-
-# Check if already has Jira key
-if [[ -n "$STORY_JIRA" && "$STORY_JIRA" != "null" ]]; then
-  echo "SKIP: $STORY_ID already has Jira key: $STORY_JIRA"
-  exit 0
-fi
-
-# Map priority
-case "$STORY_PRIORITY" in
-  P0) JIRA_PRIORITY="Highest" ;;
-  P1) JIRA_PRIORITY="High" ;;
-  P2) JIRA_PRIORITY="Medium" ;;
-  P3) JIRA_PRIORITY="Low" ;;
-  *) JIRA_PRIORITY="Medium" ;;
-esac
-
-# Create story
-STORY_OUTPUT=$(echo "" | jira issue create \
-  --project "$JIRA_PROJECT" \
-  --type Story \
-  --summary "$STORY_TITLE" \
-  --body "$STORY_DESCRIPTION" \
-  --parent "$EPIC_JIRA_KEY" \
-  --priority "$JIRA_PRIORITY" \
-  --label "$PROJECT_LABEL" \
-  --no-input 2>&1) || {
-    echo "Error creating story: $STORY_OUTPUT"
-    exit 1
-  }
-
-STORY_JIRA_KEY=$(echo "$STORY_OUTPUT" | grep -oE 'MSSCI-[0-9]+' | head -1)
-
-if [[ -z "$STORY_JIRA_KEY" ]]; then
-  echo "Error: Could not extract Jira key from output"
-  exit 1
-fi
-
-echo "Created: $STORY_JIRA_KEY ($STORY_TITLE)"
-
-# Update story points
-if [[ "$STORY_POINTS" -gt 0 ]]; then
-  jira issue edit "$STORY_JIRA_KEY" --custom "customfield_10031=$STORY_POINTS" --no-input 2>/dev/null || true
-fi
-
-# Add to sprint
-if [[ -n "$SPRINT_JIRA_ID" && "$SPRINT_JIRA_ID" != "null" ]]; then
-  jira sprint add "$SPRINT_JIRA_ID" "$STORY_JIRA_KEY" 2>/dev/null || true
-fi
-
-# Update sprint YAML
-yq eval -i "((.epics[] | select(.jira == \"$EPIC_JIRA_KEY\")).stories[] | select(.id == \"$STORY_ID\")).id = \"$STORY_JIRA_KEY\"" "$SPRINT_FILE"
-yq eval -i "((.epics[] | select(.jira == \"$EPIC_JIRA_KEY\")).stories[] | select(.id == \"$STORY_JIRA_KEY\")).jira = \"$STORY_JIRA_KEY\"" "$SPRINT_FILE"
-
-echo "Updated sprint YAML"
+# Delegate to Python CLI
+run_python_module jira create story "$@"

package/pennyfarthing-dist/scripts/jira/jira-reconcile.sh

@@ -1,260 +1,16 @@
-#!/bin/bash
+#!/usr/bin/env zsh
 # Jira vs YAML Reconciliation Report
-# Usage: .pennyfarthing/scripts/jira/jira-reconcile.sh [--fix]
+# Usage: jira-reconcile.sh [--fix]
 #
-# Compares sprint YAML against Jira to find:
-# - Status mismatches
-# - Missing Jira keys
-# - Orphan issues (in Jira but not YAML)
-# - Sprint membership discrepancies
-#
-# Options:
-#   --fix    Apply recommended fixes automatically (where safe)
-
-set -euo pipefail
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-FIX_MODE="${1:-}"
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-# Check dependencies
-if ! command -v yq &> /dev/null; then
-  echo "Error: yq is required but not installed"
-  echo "Install with: brew install yq"
-  exit 1
-fi
-
-if ! command -v jira &> /dev/null; then
-  echo "Error: jira CLI is required but not installed"
-  echo "Install with: brew install ankitpokhrel/jira/jira"
-  exit 1
-fi
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo "Error: Sprint file not found at $SPRINT_FILE"
-  exit 1
-fi
-
-# Get sprint info
-SPRINT_NAME=$(yq eval '.sprint.name' "$SPRINT_FILE")
-SPRINT_ID=$(yq eval '.sprint.jira_sprint_id' "$SPRINT_FILE")
-
-echo "# Jira vs YAML Reconciliation Report"
-echo ""
-echo "**Sprint:** $SPRINT_NAME (Jira Sprint ID: $SPRINT_ID)"
-echo "**Generated:** $(date '+%Y-%m-%d %H:%M')"
-echo ""
-
-# Track issues
-STATUS_MISMATCHES=()
-MISSING_JIRA=()
-ORPHAN_ISSUES=()
-NOT_IN_SPRINT=()
-
-echo "## Checking YAML Stories Against Jira..."
-echo ""
-
-# Extract all stories from YAML and check against Jira
-while IFS=$'\t' read -r yaml_id jira_key yaml_status title; do
-  # Skip if no jira key
-  if [[ "$jira_key" == "null" ]] || [[ -z "$jira_key" ]]; then
-    MISSING_JIRA+=("$yaml_id|$title|$yaml_status")
-    continue
-  fi
-
-  # Get Jira status - use sed to remove the key prefix
-  jira_status=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns key,status --no-headers 2>/dev/null | sed "s/^$jira_key[[:space:]]*//" | xargs || echo "NOT_FOUND")
-
-  if [[ "$jira_status" == "NOT_FOUND" ]] || [[ -z "$jira_status" ]]; then
-    echo -e "${RED}[!]${NC} $jira_key not found in Jira"
-    continue
-  fi
-
-  # Normalize statuses for comparison
-  jira_norm=$(echo "$jira_status" | tr '[:upper:]' '[:lower:]' | tr ' ' '_')
-
-  # Check for mismatches
-  mismatch=false
-  case "$yaml_status" in
-    done)
-      [[ "$jira_norm" != "done" ]] && mismatch=true
-      ;;
-    ready|backlog)
-      [[ "$jira_norm" != "to_do" ]] && mismatch=true
-      ;;
-    in_progress)
-      [[ "$jira_norm" != "in_progress" ]] && mismatch=true
-      ;;
-  esac
-
-  if [[ "$mismatch" == "true" ]]; then
-    STATUS_MISMATCHES+=("$jira_key|$yaml_status|$jira_status")
-  fi
-done < <(yq -r '.epics[].stories[]? | [.id, .jira, .status, .title] | @tsv' "$SPRINT_FILE" 2>/dev/null)
-
-echo ""
-echo "## Checking Jira Sprint Against YAML..."
-echo ""
-
-# Get all issues in the Jira sprint and check if they're in YAML
-# Skip canceled issues - they're not relevant
-while read -r jira_key; do
-  # Check if in YAML (by id or jira field)
-  in_yaml=$(yq -r ".epics[].stories[]? | select(.id == \"$jira_key\" or .jira == \"$jira_key\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-  if [[ -z "$in_yaml" ]]; then
-    # Get more info about the orphan
-    status=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns key,status --no-headers 2>/dev/null | sed "s/^$jira_key[[:space:]]*//" | xargs || echo "Unknown")
-
-    # Skip canceled issues
-    if [[ "$status" == "Canceled" ]]; then
-      continue
-    fi
-
-    summary=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns key,summary --no-headers 2>/dev/null | sed "s/^$jira_key[[:space:]]*//" | xargs || echo "Unknown")
-    ORPHAN_ISSUES+=("$jira_key|$status|$summary")
-  fi
-done < <(jira issue list --jql "project=MSSCI AND labels=pennyfarthing AND sprint=$SPRINT_ID AND status != Canceled" --plain --columns key --no-headers 2>/dev/null)
-
-echo ""
-echo "## Checking for Issues Not in Sprint..."
-echo ""
-
-# Get done issues not in sprint
-while read -r jira_key; do
-  # Check if it should be in current sprint (exists in YAML)
-  in_yaml=$(yq -r ".epics[].stories[]? | select(.id == \"$jira_key\" or .jira == \"$jira_key\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-  if [[ -n "$in_yaml" ]]; then
-    summary=$(jira issue list --jql "project=MSSCI AND key=$jira_key" --plain --columns summary --no-headers 2>/dev/null | xargs || echo "Unknown")
-    NOT_IN_SPRINT+=("$jira_key|$summary")
-  fi
-done < <(jira issue list --jql "project=MSSCI AND labels=pennyfarthing AND sprint is EMPTY AND status != Canceled" --plain --columns key --no-headers 2>/dev/null)
-
-# Output Report
-echo ""
-echo "---"
-echo ""
-echo "# Summary"
-echo ""
-
-# Status Mismatches
-echo "## Status Mismatches (${#STATUS_MISMATCHES[@]})"
-echo ""
-if [[ ${#STATUS_MISMATCHES[@]} -eq 0 ]]; then
-  echo -e "${GREEN}No status mismatches found.${NC}"
-else
-  echo "| Jira Key | YAML Status | Jira Status | Action |"
-  echo "|----------|-------------|-------------|--------|"
-  for item in "${STATUS_MISMATCHES[@]}"; do
-    IFS='|' read -r key yaml jira <<< "$item"
-    echo "| $key | $yaml | $jira | Update YAML or Jira |"
-  done
-fi
-echo ""
-
-# Missing Jira Keys
-echo "## YAML Stories Missing Jira Key (${#MISSING_JIRA[@]})"
-echo ""
-if [[ ${#MISSING_JIRA[@]} -eq 0 ]]; then
-  echo -e "${GREEN}All YAML stories have Jira keys.${NC}"
-else
-  echo "| YAML ID | Title | Status | Action |"
-  echo "|---------|-------|--------|--------|"
-  for item in "${MISSING_JIRA[@]}"; do
-    IFS='|' read -r id title status <<< "$item"
-    echo "| $id | ${title:0:40} | $status | Create Jira issue |"
-  done
-fi
-echo ""
-
-# Orphan Issues
-echo "## Jira Issues Not in YAML (${#ORPHAN_ISSUES[@]})"
-echo ""
-if [[ ${#ORPHAN_ISSUES[@]} -eq 0 ]]; then
-  echo -e "${GREEN}All sprint issues are tracked in YAML.${NC}"
-else
-  echo "| Jira Key | Status | Summary | Action |"
-  echo "|----------|--------|---------|--------|"
-  for item in "${ORPHAN_ISSUES[@]}"; do
-    IFS='|' read -r key status summary <<< "$item"
-    if [[ "$status" == "Done" ]]; then
-      echo "| $key | $status | ${summary:0:40} | Info: Completed (not in current YAML) |"
-    else
-      echo "| $key | $status | ${summary:0:40} | Add to YAML or remove from sprint |"
-    fi
-  done
-  echo ""
-  echo "*Note: Done issues not in YAML are historical - they count toward sprint velocity but aren't actively tracked.*"
-fi
-echo ""
-
-# Not in Sprint
-echo "## YAML Stories Not in Jira Sprint (${#NOT_IN_SPRINT[@]})"
-echo ""
-if [[ ${#NOT_IN_SPRINT[@]} -eq 0 ]]; then
-  echo -e "${GREEN}All YAML stories are in Jira sprint.${NC}"
-else
-  echo "| Jira Key | Summary | Action |"
-  echo "|----------|---------|--------|"
-  for item in "${NOT_IN_SPRINT[@]}"; do
-    IFS='|' read -r key summary <<< "$item"
-    echo "| $key | ${summary:0:50} | Add to sprint $SPRINT_ID |"
-  done
-fi
-echo ""
-
-# Epic check
-echo "## Epic Sync Check"
-echo ""
-echo "| YAML Epic ID | Jira Field | Status |"
-echo "|--------------|------------|--------|"
-while IFS=$'\t' read -r epic_id jira_key title; do
-  if [[ "$jira_key" == "null" ]] || [[ -z "$jira_key" ]]; then
-    echo -e "| $epic_id | ${RED}MISSING${NC} | $title |"
-  else
-    echo "| $epic_id | $jira_key | $title |"
-  fi
-done < <(yq -r '.epics[] | [.id, .jira, .title] | @tsv' "$SPRINT_FILE" 2>/dev/null)
-echo ""
-
-# Total counts
-total_issues=$((${#STATUS_MISMATCHES[@]} + ${#MISSING_JIRA[@]} + ${#ORPHAN_ISSUES[@]} + ${#NOT_IN_SPRINT[@]}))
-
-echo "---"
-echo ""
-if [[ $total_issues -eq 0 ]]; then
-  echo -e "${GREEN}Sync Status: CLEAN${NC} - No discrepancies found!"
-else
-  echo -e "${YELLOW}Sync Status: $total_issues issue(s) found${NC}"
-  echo ""
-  echo "Run with --fix to apply automatic fixes where possible."
-fi
+# Thin wrapper that delegates to Python CLI:
+#   python -m pennyfarthing_scripts.jira reconcile [--fix]
 
-# Fix mode
-if [[ "$FIX_MODE" == "--fix" ]]; then
-  echo ""
-  echo "## Applying Fixes..."
-  echo ""
+set -e
 
-  # Add stories to sprint
-  for item in "${NOT_IN_SPRINT[@]}"; do
-    IFS='|' read -r key summary <<< "$item"
-    echo "Adding $key to sprint $SPRINT_ID..."
-    jira sprint add "$SPRINT_ID" "$key" 2>/dev/null && echo "  Done" || echo "  Failed"
-  done
+# Source common functions for Python discovery
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+source "${PARENT_DIR}/lib/common.sh"
 
-  echo ""
-  echo "Fix mode completed. Manual review still needed for:"
-  echo "- Status mismatches (requires decision on which source is correct)"
-  echo "- Missing Jira keys (requires creating new issues)"
-  echo "- Orphan issues (requires adding to YAML or removing from sprint)"
-fi
+# Delegate to Python CLI
+run_python_module jira reconcile "$@"

package/pennyfarthing-dist/scripts/misc/repo-utils.sh

@@ -4,7 +4,7 @@
 #
 # Usage: source scripts/repo-utils.sh
 #
-# If .claude/project/repos.yaml exists, uses that configuration.
+# If .pennyfarthing/repos.yaml exists, uses that configuration.
 # Otherwise, falls back to legacy $API_REPO/$UI_REPO environment variables.
 #
 # Core Functions:
@@ -28,7 +28,7 @@ set -euo pipefail
 
 # Determine PROJECT_ROOT if not set
 PROJECT_ROOT="${PROJECT_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
-REPOS_CONFIG="${PROJECT_ROOT}/.claude/project/pennyfarthing-settings.yaml"
+REPOS_CONFIG="${PROJECT_ROOT}/.pennyfarthing/repos.yaml"
 
 # Cache for parsed config (associative arrays)
 declare -A _REPO_PATHS 2>/dev/null || true
@@ -136,7 +136,7 @@ import json
 import sys
 import os
 
-config_path = os.environ.get('REPOS_CONFIG', '.claude/project/repos.yaml')
+config_path = os.environ.get('REPOS_CONFIG', '.pennyfarthing/repos.yaml')
 try:
     with open(config_path) as f:
         config = yaml.safe_load(f)

package/pennyfarthing-dist/scripts/sprint/README.md

@@ -1,29 +1,44 @@
 # Sprint Scripts
 
-Scripts for sprint YAML operations and sprint management.
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `sprint-status.sh` | Show current sprint status and metrics |
-| `sprint-info.sh` | Display sprint information |
-| `available-stories.sh` | List available stories in backlog |
-| `archive-story.sh` | Archive completed story to sprint archive |
-| `check-story.sh` | Check story details and readiness |
-| `new-sprint.sh` | Create a new sprint |
-| `promote-epic.sh` | Move epic from planning to current sprint |
-| `sprint-common.sh` | Shared sprint utilities (library) |
-| `sprint-metrics.sh` | Calculate sprint metrics |
+Sprint management is handled by the Python CLI: `pf sprint [COMMAND]`.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `pf sprint status` | Show current sprint status and metrics |
+| `pf sprint backlog` | List available stories grouped by epic |
+| `pf sprint info` | Sprint info as JSON (for Cyclist sidebar) |
+| `pf sprint metrics` | Sprint velocity and progress metrics |
+| `pf sprint check <id>` | Check story/epic availability (JSON) |
+| `pf sprint future` | Show future initiatives and epics |
+| `pf sprint new` | Initialize a new sprint |
+| `pf sprint validate <file>` | Validate sprint YAML structure |
+| `pf sprint archive <id>` | Archive a completed story |
+| `pf sprint work <id>` | Start work on a story |
+| `pf sprint story field <id> <field>` | Get a story field value |
+| `pf sprint epic field <id> <field>` | Get an epic field value |
+| `pf sprint epic promote <id>` | Move epic from future to current sprint |
+| `pf sprint epic show <id>` | Show epic details |
+| `pf sprint epic cancel <id>` | Cancel an epic |
+| `pf sprint epic archive` | Archive completed epics |
 
 ## Usage
 
 ```bash
-.pennyfarthing/scripts/sprint/sprint-status.sh
-.pennyfarthing/scripts/sprint/available-stories.sh
+pf sprint status
+pf sprint backlog
+pf sprint future epic-55
+pf sprint epic promote epic-41
 ```
 
 ## Ownership
 
 - **Primary users:** SM agent, `/sprint` skill
 - **Maintained by:** Core Pennyfarthing team
+
+## Migration Note
+
+All bash scripts previously in this directory have been migrated to Python CLI
+commands in `pennyfarthing_scripts/sprint/cli.py`. See PR #716 and the follow-up
+deprecation commit for details.

package/pennyfarthing-dist/scripts/story/README.md

@@ -19,5 +19,5 @@ Scripts for story creation and management.
 
 ## Ownership
 
-- **Primary users:** SM agent, `/story` skill
+- **Primary users:** SM agent, `/sprint story` commands
 - **Maintained by:** Core Pennyfarthing team

package/pennyfarthing-dist/scripts/test/test-setup.sh

@@ -4,7 +4,7 @@
 #
 # Usage: source scripts/test/test-setup.sh
 #
-# Configuration is read from .claude/project/repos.yaml
+# Configuration is read from .pennyfarthing/repos.yaml
 # See repos.yaml for schema documentation
 #
 # Functions: