@pennyfarthing/core 7.0.2 → 7.4.1

package/pennyfarthing-dist/scripts/{uninstall.sh → misc/uninstall.sh}

@@ -96,12 +96,11 @@ MANAGED_PATHS=(
     ".claude/manifest.json"
     ".claude/settings.local.json"
     ".claude/statusline.sh"
+    "scripts/core"
     "scripts/hooks"
-    "scripts/utils"
-    "scripts/agent-session.sh"
-    "scripts/check-context.sh"
-    "scripts/repo-utils.sh"
-    "scripts/worktree-manager.sh"
+    "scripts/lib"
+    "scripts/misc"
+    "scripts/run.sh"
 )
 
 # Project paths that can be removed with --all (but preserve archives)

package/pennyfarthing-dist/scripts/{utils → misc}/validate-subagent-frontmatter.sh

@@ -34,11 +34,11 @@ REQUIRED_FIELDS=("name" "description" "tools" "model")
 # Expected subagent files (8 total - consolidated in Story 31-11/31-12)
 EXPECTED_SUBAGENTS=(
     "workflow-status-check.md"
-    "generic-sm-setup.md"
-    "generic-sm-finish.md"
+    "sm-setup.md"
+    "sm-finish.md"
     "sm-file-summary.md"
     "sm-handoff.md"
-    "generic-handoff.md"
+    "handoff.md"
     "reviewer-preflight.md"
     "testing-runner.md"
 )

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"

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

@@ -0,0 +1,164 @@
+#!/bin/bash
+# Check if a story or epic exists and is available for work
+# Usage: check-story.sh <id|next>
+#
+# Arguments:
+#   <story-id>  - Check specific story availability
+#   <epic-id>   - Get first available story in epic
+#   next        - Get highest-priority available story across all epics
+#
+# Returns JSON with story/epic details and availability
+
+set -euo pipefail
+
+ID="${1:-}"
+
+if [[ -z "$ID" ]]; then
+  echo '{"type": "error", "message": "No ID provided"}'
+  exit 1
+fi
+
+# PROJECT_ROOT should be set by run.sh
+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 '{"type": "error", "message": "Sprint file not found"}'
+  exit 1
+fi
+
+# Handle "next" argument - find highest priority available story
+if [[ "$ID" == "next" ]]; then
+  # Get all available stories (backlog or ready), sort by priority, take first
+  NEXT_STORY=$(yq -o json "[.epics[].stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | sort_by(.priority) | .[0]" "$SPRINT_FILE" 2>/dev/null || echo "null")
+
+  if [[ "$NEXT_STORY" != "null" && -n "$NEXT_STORY" ]]; then
+    STORY_ID=$(echo "$NEXT_STORY" | yq -r '.id')
+    STORY_TITLE=$(echo "$NEXT_STORY" | yq -r '.title')
+    STORY_POINTS=$(echo "$NEXT_STORY" | yq -r '.points // 0')
+    STORY_PRIORITY=$(echo "$NEXT_STORY" | yq -r '.priority // "P2"')
+    STORY_WORKFLOW=$(echo "$NEXT_STORY" | yq -r '.workflow // "tdd"')
+    STORY_REPOS=$(echo "$NEXT_STORY" | yq -r '.repos // "pennyfarthing"')
+    STORY_AC=$(echo "$NEXT_STORY" | yq -o json '.acceptance_criteria // []')
+    EPIC_ID=$(yq -r ".epics[] | select(.stories[].id == \"$STORY_ID\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
+
+    cat <<EOF
+{
+  "type": "next",
+  "story": {
+    "id": "$STORY_ID",
+    "title": "$STORY_TITLE",
+    "points": $STORY_POINTS,
+    "priority": "$STORY_PRIORITY",
+    "workflow": "$STORY_WORKFLOW",
+    "repos": "$STORY_REPOS",
+    "epic_id": "$EPIC_ID",
+    "acceptance_criteria": $STORY_AC
+  }
+}
+EOF
+  else
+    echo '{"type": "next", "story": null, "message": "No available stories in backlog"}'
+  fi
+  exit 0
+fi
+
+# Check if it's an epic
+EPIC_DATA=$(yq -o json ".epics[] | select(.id == \"$ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
+
+if [[ -n "$EPIC_DATA" && "$EPIC_DATA" != "null" ]]; then
+  # It's an epic - get first available story by priority
+  FIRST_STORY=$(yq -o json "[.epics[] | select(.id == \"$ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | sort_by(.priority) | .[0]" "$SPRINT_FILE" 2>/dev/null || echo "null")
+
+  EPIC_TITLE=$(echo "$EPIC_DATA" | yq -r '.title // "Unknown"')
+  STORY_COUNT=$(yq "[.epics[] | select(.id == \"$ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | length" "$SPRINT_FILE" 2>/dev/null || echo "0")
+
+  if [[ "$FIRST_STORY" != "null" && -n "$FIRST_STORY" ]]; then
+    STORY_ID=$(echo "$FIRST_STORY" | yq -r '.id')
+    STORY_TITLE=$(echo "$FIRST_STORY" | yq -r '.title')
+    STORY_POINTS=$(echo "$FIRST_STORY" | yq -r '.points // 0')
+    STORY_WORKFLOW=$(echo "$FIRST_STORY" | yq -r '.workflow // "tdd"')
+    STORY_REPOS=$(echo "$FIRST_STORY" | yq -r '.repos // "pennyfarthing"')
+    STORY_AC=$(echo "$FIRST_STORY" | yq -o json '.acceptance_criteria // []')
+
+    cat <<EOF
+{
+  "type": "epic",
+  "id": "$ID",
+  "title": "$EPIC_TITLE",
+  "available_stories": $STORY_COUNT,
+  "first_story": {
+    "id": "$STORY_ID",
+    "title": "$STORY_TITLE",
+    "points": $STORY_POINTS,
+    "workflow": "$STORY_WORKFLOW",
+    "repos": "$STORY_REPOS",
+    "acceptance_criteria": $STORY_AC
+  }
+}
+EOF
+  else
+    cat <<EOF
+{
+  "type": "epic",
+  "id": "$ID",
+  "title": "$EPIC_TITLE",
+  "available_stories": 0,
+  "first_story": null,
+  "message": "No available stories in this epic"
+}
+EOF
+  fi
+  exit 0
+fi
+
+# Check if it's a story
+STORY_DATA=$(yq -o json ".epics[].stories[] | select(.id == \"$ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
+
+if [[ -n "$STORY_DATA" && "$STORY_DATA" != "null" ]]; then
+  STATUS=$(echo "$STORY_DATA" | yq -r '.status // "backlog"')
+  ASSIGNED=$(echo "$STORY_DATA" | yq -r '.assigned_to // ""')
+  TITLE=$(echo "$STORY_DATA" | yq -r '.title // "Unknown"')
+  POINTS=$(echo "$STORY_DATA" | yq -r '.points // 0')
+  WORKFLOW=$(echo "$STORY_DATA" | yq -r '.workflow // "tdd"')
+  EPIC_ID=$(yq -r ".epics[] | select(.stories[].id == \"$ID\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
+  REPOS=$(echo "$STORY_DATA" | yq -r '.repos // "pennyfarthing"')
+
+  # Story is available if status is backlog/ready and not assigned
+  if [[ ("$STATUS" == "backlog" || "$STATUS" == "ready") && -z "$ASSIGNED" ]]; then
+    AVAILABLE="true"
+  else
+    AVAILABLE="false"
+  fi
+
+  # Get acceptance criteria as JSON array
+  AC=$(echo "$STORY_DATA" | yq -o json '.acceptance_criteria // []')
+
+  cat <<EOF
+{
+  "type": "story",
+  "id": "$ID",
+  "title": "$TITLE",
+  "points": $POINTS,
+  "workflow": "$WORKFLOW",
+  "status": "$STATUS",
+  "assigned_to": "$ASSIGNED",
+  "epic_id": "$EPIC_ID",
+  "repos": "$REPOS",
+  "available": $AVAILABLE,
+  "acceptance_criteria": $AC
+}
+EOF
+  exit 0
+fi
+
+# Not found
+echo '{"type": "not_found", "id": "'"$ID"'", "message": "Story or epic not found in current sprint"}'
+exit 0

package/pennyfarthing-dist/scripts/sprint/get-epic-field.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# Get a field value from an epic in sprint YAML
+# Usage: .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh <epic-id> <field>
+#
+# Examples:
+#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh epic-35 jira
+#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh epic-35 title
+#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh 35 jira  # Also works without 'epic-' prefix
+#
+# Common fields: jira, title, description, status
+# Returns the field value or "null" if not found
+
+set -euo pipefail
+
+EPIC_ID="${1:-}"
+FIELD="${2:-}"
+
+if [[ -z "$EPIC_ID" || -z "$FIELD" ]]; then
+  echo "Usage: get-epic-field.sh <epic-id> <field>"
+  echo ""
+  echo "Examples:"
+  echo "  get-epic-field.sh epic-35 jira     # Returns: MSSCI-11234"
+  echo "  get-epic-field.sh epic-35 title    # Returns: Epic title"
+  echo "  get-epic-field.sh 35 jira          # Also works without 'epic-' prefix"
+  echo ""
+  echo "Common fields: jira, title, description, status"
+  exit 1
+fi
+
+# Normalize epic ID - add 'epic-' prefix if not present
+if [[ ! "$EPIC_ID" =~ ^epic- ]]; then
+  EPIC_ID="epic-$EPIC_ID"
+fi
+
+# PROJECT_ROOT should be set by run.sh
+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 "null"
+  exit 1
+fi
+
+# Extract field value using yq
+VALUE=$(yq eval ".epics[] | select(.id == \"$EPIC_ID\") | .$FIELD // \"null\"" "$SPRINT_FILE" 2>/dev/null | head -1)
+
+if [[ -z "$VALUE" ]]; then
+  echo "null"
+else
+  echo "$VALUE"
+fi

package/pennyfarthing-dist/scripts/sprint/get-story-field.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# Get a field value from a story in sprint YAML
+# Usage: .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh <story-id> <field>
+#
+# Examples:
+#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 workflow
+#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 jira
+#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 status
+#
+# Common fields: workflow, status, jira, points, title, repos, priority
+# Returns the field value or "null" if not found
+
+set -euo pipefail
+
+STORY_ID="${1:-}"
+FIELD="${2:-}"
+
+if [[ -z "$STORY_ID" || -z "$FIELD" ]]; then
+  echo "Usage: get-story-field.sh <story-id> <field>"
+  echo ""
+  echo "Examples:"
+  echo "  get-story-field.sh 35-2 workflow    # Returns: tdd"
+  echo "  get-story-field.sh 35-2 jira        # Returns: MSSCI-12345"
+  echo "  get-story-field.sh 35-2 status      # Returns: in_progress"
+  echo ""
+  echo "Common fields: workflow, status, jira, points, title, repos, priority"
+  exit 1
+fi
+
+# PROJECT_ROOT should be set by run.sh
+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 "null"
+  exit 1
+fi
+
+# Extract field value using yq
+# Handle default values for common fields
+case "$FIELD" in
+  workflow)
+    DEFAULT="tdd"
+    ;;
+  status)
+    DEFAULT="backlog"
+    ;;
+  repos)
+    DEFAULT="pennyfarthing"
+    ;;
+  *)
+    DEFAULT="null"
+    ;;
+esac
+
+VALUE=$(yq eval ".epics[].stories[] | select(.id == \"$STORY_ID\") | .$FIELD // \"$DEFAULT\"" "$SPRINT_FILE" 2>/dev/null | head -1)
+
+if [[ -z "$VALUE" ]]; then
+  echo "null"
+else
+  echo "$VALUE"
+fi