@pennyfarthing/core 7.9.0 → 7.9.2

package/pennyfarthing-dist/scripts/misc/uninstall.sh

@@ -1,270 +0,0 @@
-#!/usr/bin/env zsh
-# Uninstall pennyfarthing from a project
-# Usage: uninstall.sh [--force] [--all] [project-root]
-#
-# Options:
-#   --force    Skip confirmation prompts
-#   --all      Also remove project-specific files (.claude/project/, sprint/, .session/)
-#   --help     Show this help message
-
-set -e
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Parse arguments
-FORCE=false
-REMOVE_ALL=false
-PROJECT_ROOT=""
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --force|-f)
-            FORCE=true
-            shift
-            ;;
-        --all|-a)
-            REMOVE_ALL=true
-            shift
-            ;;
-        --help|-h)
-            echo "Usage: uninstall.sh [--force] [--all] [project-root]"
-            echo ""
-            echo "Remove pennyfarthing from a project for clean reinstall."
-            echo ""
-            echo "Options:"
-            echo "  --force, -f    Skip confirmation prompts"
-            echo "  --all, -a      Also remove project-specific files:"
-            echo "                   - .claude/project/ (agent sidecars, custom docs)"
-            echo "                   - .claude/persona-config.yaml"
-            echo "                   - .session/ (session files)"
-            echo "                   - sprint/current-sprint.yaml"
-            echo "  --help, -h     Show this help message"
-            echo ""
-            echo "By default, only managed files are removed:"
-            echo "  - .claude/core/"
-            echo "  - .claude/skills/"
-            echo "  - .pennyfarthing/personas/"
-            echo "  - .claude/manifest.json"
-            echo "  - .claude/settings.local.json"
-            echo "  - scripts/hooks/"
-            echo "  - scripts/utils/"
-            echo ""
-            echo "ALWAYS preserved (even with --all):"
-            echo "  - sprint/archive/  (completed work history)"
-            echo "  - sprint/context/  (story summaries)"
-            exit 0
-            ;;
-        *)
-            PROJECT_ROOT="$1"
-            shift
-            ;;
-    esac
-done
-
-# Determine project root
-if [ -z "$PROJECT_ROOT" ]; then
-    PROJECT_ROOT="$(pwd)"
-fi
-
-# Verify this looks like a pennyfarthing installation
-if [ ! -f "$PROJECT_ROOT/.claude/manifest.json" ]; then
-    echo -e "${RED}Error: No pennyfarthing installation found at $PROJECT_ROOT${NC}"
-    echo "  (missing .claude/manifest.json)"
-    exit 1
-fi
-
-echo -e "${BLUE}Pennyfarthing Uninstall${NC}"
-echo "Project: $PROJECT_ROOT"
-echo ""
-
-# Read manifest for version info
-VERSION=$(cat "$PROJECT_ROOT/.claude/manifest.json" 2>/dev/null | grep '"version"' | cut -d'"' -f4 || echo "unknown")
-echo -e "Installed version: ${YELLOW}$VERSION${NC}"
-echo ""
-
-# Define what to remove
-MANAGED_PATHS=(
-    ".claude/core"
-    ".claude/skills"
-    ".claude/personas"
-    ".claude/pennyfarthing"
-    ".claude/manifest.json"
-    ".claude/settings.local.json"
-    ".claude/statusline.sh"
-    "scripts/core"
-    "scripts/hooks"
-    "scripts/lib"
-    "scripts/misc"
-    "scripts/run.sh"
-)
-
-# Project paths that can be removed with --all (but preserve archives)
-PROJECT_PATHS=(
-    ".claude/project"
-    ".claude/persona-config.yaml"
-    ".session"
-)
-
-# Paths that are ALWAYS preserved (archived work, history)
-PRESERVED_PATHS=(
-    "sprint/archive"
-    "sprint/context"
-)
-
-# Show what will be removed
-echo -e "${YELLOW}Files to remove (managed):${NC}"
-for path in "${MANAGED_PATHS[@]}"; do
-    full_path="$PROJECT_ROOT/$path"
-    if [ -e "$full_path" ]; then
-        if [ -d "$full_path" ]; then
-            count=$(find "$full_path" -type f 2>/dev/null | wc -l | tr -d ' ')
-            echo "  $path/ ($count files)"
-        else
-            echo "  $path"
-        fi
-    fi
-done
-
-if [ "$REMOVE_ALL" = true ]; then
-    echo ""
-    echo -e "${YELLOW}Files to remove (project-specific):${NC}"
-    for path in "${PROJECT_PATHS[@]}"; do
-        full_path="$PROJECT_ROOT/$path"
-        if [ -e "$full_path" ]; then
-            if [ -d "$full_path" ]; then
-                count=$(find "$full_path" -type f 2>/dev/null | wc -l | tr -d ' ')
-                echo "  $path/ ($count files)"
-            else
-                echo "  $path"
-            fi
-        fi
-    done
-    # Show sprint YAML will be removed but archives preserved
-    if [ -f "$PROJECT_ROOT/sprint/current-sprint.yaml" ]; then
-        echo "  sprint/current-sprint.yaml"
-    fi
-else
-    echo ""
-    echo -e "${GREEN}Files preserved (project-specific):${NC}"
-    for path in "${PROJECT_PATHS[@]}"; do
-        full_path="$PROJECT_ROOT/$path"
-        if [ -e "$full_path" ]; then
-            echo "  $path"
-        fi
-    done
-    if [ -d "$PROJECT_ROOT/sprint" ]; then
-        echo "  sprint/"
-    fi
-    echo ""
-    echo "  Use --all to also remove project-specific files"
-fi
-
-# Always show preserved paths
-echo ""
-echo -e "${GREEN}Files ALWAYS preserved (archived work):${NC}"
-for path in "${PRESERVED_PATHS[@]}"; do
-    full_path="$PROJECT_ROOT/$path"
-    if [ -e "$full_path" ]; then
-        if [ -d "$full_path" ]; then
-            count=$(find "$full_path" -type f 2>/dev/null | wc -l | tr -d ' ')
-            echo "  $path/ ($count files)"
-        else
-            echo "  $path"
-        fi
-    fi
-done
-
-echo ""
-
-# Confirm unless --force
-if [ "$FORCE" != true ]; then
-    read -p "Proceed with uninstall? [y/N] " -n 1 -r
-    echo
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        echo "Aborted."
-        exit 0
-    fi
-fi
-
-echo ""
-echo -e "${BLUE}Removing files...${NC}"
-
-# Remove managed paths
-for path in "${MANAGED_PATHS[@]}"; do
-    full_path="$PROJECT_ROOT/$path"
-    if [ -e "$full_path" ]; then
-        rm -rf "$full_path"
-        echo -e "  ${RED}✗${NC} $path"
-    fi
-done
-
-# Remove project paths if --all (but preserve archives)
-if [ "$REMOVE_ALL" = true ]; then
-    for path in "${PROJECT_PATHS[@]}"; do
-        full_path="$PROJECT_ROOT/$path"
-        if [ -e "$full_path" ]; then
-            rm -rf "$full_path"
-            echo -e "  ${RED}✗${NC} $path"
-        fi
-    done
-
-    # Remove sprint YAML but preserve archive and context
-    if [ -f "$PROJECT_ROOT/sprint/current-sprint.yaml" ]; then
-        rm -f "$PROJECT_ROOT/sprint/current-sprint.yaml"
-        echo -e "  ${RED}✗${NC} sprint/current-sprint.yaml"
-    fi
-    if [ -f "$PROJECT_ROOT/sprint/.gitkeep" ]; then
-        rm -f "$PROJECT_ROOT/sprint/.gitkeep"
-    fi
-
-    echo ""
-    echo -e "${GREEN}Preserved:${NC}"
-    for path in "${PRESERVED_PATHS[@]}"; do
-        full_path="$PROJECT_ROOT/$path"
-        if [ -e "$full_path" ]; then
-            echo -e "  ${GREEN}✓${NC} $path"
-        fi
-    done
-fi
-
-# Clean up empty directories
-if [ -d "$PROJECT_ROOT/.claude" ]; then
-    # Remove .claude if empty or only has empty subdirs
-    find "$PROJECT_ROOT/.claude" -type d -empty -delete 2>/dev/null || true
-
-    # Check if .claude is now empty
-    if [ -d "$PROJECT_ROOT/.claude" ] && [ -z "$(ls -A "$PROJECT_ROOT/.claude")" ]; then
-        rmdir "$PROJECT_ROOT/.claude"
-        echo -e "  ${RED}✗${NC} .claude/ (empty)"
-    fi
-fi
-
-if [ -d "$PROJECT_ROOT/scripts" ]; then
-    # Remove scripts if empty
-    find "$PROJECT_ROOT/scripts" -type d -empty -delete 2>/dev/null || true
-
-    if [ -d "$PROJECT_ROOT/scripts" ] && [ -z "$(ls -A "$PROJECT_ROOT/scripts")" ]; then
-        rmdir "$PROJECT_ROOT/scripts"
-        echo -e "  ${RED}✗${NC} scripts/ (empty)"
-    fi
-fi
-
-# Remove symlinks in .claude/ if they exist
-for link in agents subagents commands guides; do
-    link_path="$PROJECT_ROOT/.claude/$link"
-    if [ -L "$link_path" ]; then
-        rm "$link_path"
-        echo -e "  ${RED}✗${NC} .claude/$link (symlink)"
-    fi
-done
-
-echo ""
-echo -e "${GREEN}Pennyfarthing uninstalled successfully.${NC}"
-echo ""
-echo "To reinstall:"
-echo "  pennyfarthing init"

package/pennyfarthing-dist/scripts/misc/validate-subagent-frontmatter.sh

@@ -1,160 +0,0 @@
-#!/usr/bin/env zsh
-# validate-subagent-frontmatter.sh
-# Validates that subagent files use official YAML frontmatter format
-#
-# Expected format:
-#   ---
-#   name: subagent-name
-#   description: What it does
-#   tools: Bash, Read, Glob, Grep
-#   model: haiku
-#   ---
-#   [system prompt content]
-#
-# Exit codes:
-#   0 = All subagents valid
-#   1 = One or more subagents invalid
-
-set -euo pipefail
-
-# Find project root
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-SUBAGENTS_DIR="$PROJECT_ROOT/agents"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[0;33m'
-NC='\033[0m' # No Color
-
-# Required fields in frontmatter
-REQUIRED_FIELDS=("name" "description" "tools" "model")
-
-# Expected subagent files (8 total - consolidated in Story 31-11/31-12)
-EXPECTED_SUBAGENTS=(
-    "workflow-status-check.md"
-    "sm-setup.md"
-    "sm-finish.md"
-    "sm-file-summary.md"
-    "sm-handoff.md"
-    "handoff.md"
-    "reviewer-preflight.md"
-    "testing-runner.md"
-)
-
-# Counters
-valid_count=0
-invalid_count=0
-missing_count=0
-
-echo "Validating subagent YAML frontmatter format..."
-echo "Directory: $SUBAGENTS_DIR"
-echo ""
-
-validate_file() {
-    local file="$1"
-    local filename=$(basename "$file")
-    local errors=()
-
-    # Check file exists
-    if [[ ! -f "$file" ]]; then
-        echo -e "${RED}✗ MISSING:${NC} $filename"
-        ((missing_count++))
-        return 1
-    fi
-
-    # Check for opening ---
-    local first_line=$(head -1 "$file")
-    if [[ "$first_line" != "---" ]]; then
-        errors+=("Missing opening '---' delimiter (found: '$first_line')")
-    fi
-
-    # Extract frontmatter (between first and second ---)
-    local frontmatter=""
-    local in_frontmatter=false
-    local line_num=0
-    local frontmatter_end=0
-
-    while IFS= read -r line; do
-        ((line_num++))
-        if [[ $line_num -eq 1 ]]; then
-            if [[ "$line" == "---" ]]; then
-                in_frontmatter=true
-            fi
-            continue
-        fi
-
-        if [[ "$in_frontmatter" == true ]]; then
-            if [[ "$line" == "---" ]]; then
-                frontmatter_end=$line_num
-                break
-            fi
-            frontmatter+="$line"$'\n'
-        fi
-    done < "$file"
-
-    if [[ $frontmatter_end -eq 0 ]]; then
-        errors+=("Missing closing '---' delimiter")
-    fi
-
-    # Check required fields
-    for field in "${REQUIRED_FIELDS[@]}"; do
-        if ! echo "$frontmatter" | grep -q "^${field}:"; then
-            errors+=("Missing required field: $field")
-        fi
-    done
-
-    # Validate name matches filename (without .md)
-    local expected_name="${filename%.md}"
-    if echo "$frontmatter" | grep -q "^name:"; then
-        local actual_name=$(echo "$frontmatter" | grep "^name:" | sed 's/^name:[[:space:]]*//' | tr -d '"' | tr -d "'")
-        if [[ "$actual_name" != "$expected_name" ]]; then
-            errors+=("Name mismatch: expected '$expected_name', found '$actual_name'")
-        fi
-    fi
-
-    # Validate model is haiku
-    if echo "$frontmatter" | grep -q "^model:"; then
-        local model=$(echo "$frontmatter" | grep "^model:" | sed 's/^model:[[:space:]]*//' | tr -d '"' | tr -d "'")
-        if [[ "$model" != "haiku" ]]; then
-            errors+=("Model should be 'haiku', found '$model'")
-        fi
-    fi
-
-    # Report results
-    if [[ ${#errors[@]} -eq 0 ]]; then
-        echo -e "${GREEN}✓ VALID:${NC} $filename"
-        ((valid_count++))
-        return 0
-    else
-        echo -e "${RED}✗ INVALID:${NC} $filename"
-        for error in "${errors[@]}"; do
-            echo -e "  ${YELLOW}→${NC} $error"
-        done
-        ((invalid_count++))
-        return 1
-    fi
-}
-
-# Validate each expected subagent
-for subagent in "${EXPECTED_SUBAGENTS[@]}"; do
-    validate_file "$SUBAGENTS_DIR/$subagent" || true
-done
-
-echo ""
-echo "====================================="
-echo "Validation Summary"
-echo "====================================="
-echo -e "Valid:   ${GREEN}$valid_count${NC} / ${#EXPECTED_SUBAGENTS[@]}"
-echo -e "Invalid: ${RED}$invalid_count${NC}"
-echo -e "Missing: ${RED}$missing_count${NC}"
-echo ""
-
-if [[ $invalid_count -eq 0 && $missing_count -eq 0 ]]; then
-    echo -e "${GREEN}All subagents have valid YAML frontmatter!${NC}"
-    exit 0
-else
-    echo -e "${RED}Some subagents need migration to YAML frontmatter format.${NC}"
-    exit 1
-fi

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

@@ -1,29 +0,0 @@
-# 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 |
-
-## Usage
-
-```bash
-.pennyfarthing/scripts/core/run.sh sprint/sprint-status.sh
-.pennyfarthing/scripts/core/run.sh sprint/available-stories.sh
-```
-
-## Ownership
-
-- **Primary users:** SM agent, `/sprint` skill
-- **Maintained by:** Core Pennyfarthing team

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

@@ -1,139 +0,0 @@
-#!/bin/bash
-# Archive a completed story from current-sprint.yaml to the sprint archive
-# Usage: .pennyfarthing/scripts/core/run.sh sprint/archive-story.sh <story-id> [pr-number] [--apply]
-#
-# Example: .pennyfarthing/scripts/core/run.sh sprint/archive-story.sh MSSCI-11945 368
-#          .pennyfarthing/scripts/core/run.sh sprint/archive-story.sh MSSCI-11945 368 --apply
-#
-# Options:
-#   --apply    Also remove story from current-sprint.yaml (atomic operation)
-
-set -euo pipefail
-
-STORY_ID="${1:-}"
-PR_NUMBER=""
-APPLY_FLAG=false
-
-# Parse positional and flag arguments
-shift || true
-for arg in "$@"; do
-  case $arg in
-    --apply)
-      APPLY_FLAG=true
-      ;;
-    *)
-      # If not a flag, it's the PR number
-      if [[ -z "$PR_NUMBER" ]]; then
-        PR_NUMBER="$arg"
-      fi
-      ;;
-  esac
-done
-
-if [[ -z "$STORY_ID" ]]; then
-  echo "Usage: archive-story.sh <story-id> [pr-number] [--apply]"
-  echo "Example: archive-story.sh MSSCI-11945 368"
-  echo "         archive-story.sh MSSCI-11945 368 --apply"
-  echo ""
-  echo "Options:"
-  echo "  --apply    Also remove story from 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/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo "Error: Sprint file not found at $SPRINT_FILE"
-  exit 1
-fi
-
-# Extract sprint name to determine archive file
-# Try jira_sprint_name first (newer format), then fall back to name (older format)
-SPRINT_NAME=$(grep -E "^\s+jira_sprint_name:" "$SPRINT_FILE" | head -1 | sed 's/.*TO Sprint \([0-9]*\).*/\1/')
-if [[ -z "$SPRINT_NAME" ]]; then
-  SPRINT_NAME=$(grep -E "^\s+name:" "$SPRINT_FILE" | head -1 | sed 's/.*"TO Sprint \([0-9]*\)".*/\1/')
-fi
-if [[ -z "$SPRINT_NAME" ]]; then
-  echo "Error: Could not extract sprint name from $SPRINT_FILE"
-  exit 1
-fi
-
-ARCHIVE_FILE="$PROJECT_ROOT/sprint/archive/sprint-${SPRINT_NAME}-completed.yaml"
-
-# Check if archive file exists
-if [[ ! -f "$ARCHIVE_FILE" ]]; then
-  echo "Error: Archive file not found at $ARCHIVE_FILE"
-  echo "Create it first with new-sprint.sh or manually"
-  exit 1
-fi
-
-# Use yq to extract story data
-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 story in current sprint
-STORY_DATA=$(yq eval ".epics[].stories[] | select(.id == \"$STORY_ID\")" "$SPRINT_FILE")
-
-if [[ -z "$STORY_DATA" ]]; then
-  echo "Error: Story $STORY_ID not found in $SPRINT_FILE"
-  exit 1
-fi
-
-# Extract story fields
-TITLE=$(echo "$STORY_DATA" | yq eval '.title' -)
-POINTS=$(echo "$STORY_DATA" | yq eval '.points' -)
-EPIC_ID=$(yq eval ".epics[] | select(.stories[].id == \"$STORY_ID\") | .id" "$SPRINT_FILE" | head -1)
-
-# Get today's date
-COMPLETED_DATE=$(date +%Y-%m-%d)
-
-# Build the archive entry
-echo ""
-echo "Archiving story:"
-echo "  ID: $STORY_ID"
-echo "  Title: $TITLE"
-echo "  Points: $POINTS"
-echo "  Epic: $EPIC_ID"
-echo "  Completed: $COMPLETED_DATE"
-[[ -n "$PR_NUMBER" ]] && echo "  PR: $PR_NUMBER"
-echo ""
-
-# Append to archive file
-{
-  echo "  - id: $STORY_ID"
-  echo "    epic: $EPIC_ID"
-  echo "    title: \"$TITLE\""
-  echo "    points: $POINTS"
-  echo "    completed: $COMPLETED_DATE"
-  [[ -n "$PR_NUMBER" ]] && echo "    pr: $PR_NUMBER"
-} >> "$ARCHIVE_FILE"
-
-echo "Added to $ARCHIVE_FILE"
-
-# Remove from current sprint (if --apply)
-if $APPLY_FLAG; then
-  echo ""
-  echo "Removing story from current sprint..."
-  yq eval -i "del(.epics[].stories[] | select(.id == \"$STORY_ID\"))" "$SPRINT_FILE"
-  echo "✓ Story removed from $SPRINT_FILE"
-  echo ""
-  echo "If the epic has no more stories, you may want to remove the empty epic section."
-else
-  echo ""
-  echo "To also remove from $SPRINT_FILE, re-run with --apply:"
-  echo "  .pennyfarthing/scripts/core/run.sh sprint/archive-story.sh $STORY_ID ${PR_NUMBER:-<pr>} --apply"
-  echo ""
-  echo "Or manually: yq eval -i 'del(.epics[].stories[] | select(.id == \"$STORY_ID\"))' $SPRINT_FILE"
-fi

package/pennyfarthing-dist/scripts/sprint/available-stories.sh

@@ -1,97 +0,0 @@
-#!/bin/bash
-# Display available stories grouped by epic with Jira context
-# Usage: .pennyfarthing/scripts/core/run.sh sprint/available-stories.sh
-#
-# Shows backlog stories with epic context, points, and workflow
-
-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/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-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
-
-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
-
-# Extract sprint info
-SPRINT_NAME=$(yq '.sprint.name' "$SPRINT_FILE")
-echo "# Available Stories - $SPRINT_NAME"
-echo ""
-
-# Get all epic IDs from the sprint file
-EPIC_IDS=$(yq '.epics[].id' "$SPRINT_FILE" | tr '\n' ' ')
-
-# Batch fetch epic details from Jira
-echo "Fetching epic details from Jira..."
-echo ""
-
-# Process each epic
-for EPIC_ID in $EPIC_IDS; do
-  # Get epic title from sprint YAML (faster than Jira for display)
-  EPIC_TITLE=$(yq ".epics[] | select(.id == \"$EPIC_ID\") | .title" "$SPRINT_FILE")
-
-  # Get stories for this epic that are available (backlog or ready)
-  STORY_COUNT=$(yq ".epics[] | select(.id == \"$EPIC_ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\") | .id" "$SPRINT_FILE" 2>/dev/null | wc -l | tr -d ' ')
-
-  if [[ "$STORY_COUNT" -eq 0 ]]; then
-    continue
-  fi
-
-  # Fetch epic description from Jira for context (if it's a valid Jira key)
-  # Jira uses Atlassian Document Format - extract text content from paragraphs
-  EPIC_DESCRIPTION=""
-  if [[ "$EPIC_ID" =~ ^MSSCI-[0-9]+$ ]]; then
-    EPIC_DESCRIPTION=$(jira issue view "$EPIC_ID" --raw 2>/dev/null | \
-      jq -r '.fields.description.content[]? | select(.type == "paragraph") | .content[]? | select(.type == "text") | .text' 2>/dev/null | \
-      head -3 | tr '\n' ' ' | cut -c1-200)
-  fi
-
-  echo "## $EPIC_TITLE"
-  if [[ -n "$EPIC_DESCRIPTION" ]]; then
-    echo "*$EPIC_DESCRIPTION*"
-  fi
-  echo ""
-  echo "| ID | Title | Pts | Pri | Status | Workflow |"
-  echo "|----|-------|-----|-----|--------|----------|"
-
-  # Get available stories for this epic (backlog or ready)
-  yq -o=json ".epics[] | select(.id == \"$EPIC_ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\")" "$SPRINT_FILE" 2>/dev/null | \
-    jq -r '[.id, .title, (.points | tostring), (.priority // "P2"), (.status // "backlog"), (.workflow // "tdd")] | @tsv' | \
-    while IFS=$'\t' read -r story_id story_title story_points story_priority story_status story_workflow; do
-      # Truncate title if too long
-      if [[ ${#story_title} -gt 40 ]]; then
-        story_title="${story_title:0:37}..."
-      fi
-      echo "| $story_id | $story_title | $story_points | $story_priority | $story_status | $story_workflow |"
-    done
-
-  echo ""
-done
-
-# Summary
-TOTAL_BACKLOG=$(yq '[.epics[].stories[] | select(.status == "backlog" or .status == "ready")] | length' "$SPRINT_FILE")
-TOTAL_POINTS=$(yq '.epics[].stories[] | select(.status == "backlog" or .status == "ready") | .points' "$SPRINT_FILE" | paste -sd+ - | bc 2>/dev/null || echo "0")
-
-echo "---"
-echo "**Total available:** $TOTAL_BACKLOG stories, $TOTAL_POINTS points"