@pennyfarthing/core 7.5.0 → 7.6.1

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

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

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

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

@@ -0,0 +1,135 @@
+#!/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/.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 "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+# Extract sprint name to determine archive file
+SPRINT_NAME=$(grep -E "^\s+name:" "$SPRINT_FILE" | head -1 | sed 's/.*"TO Sprint \([0-9]*\)".*/\1/')
+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

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