@pennyfarthing/core 7.5.0 → 7.6.1

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

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

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

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

package/pennyfarthing-dist/scripts/story/size-story.sh

@@ -0,0 +1,198 @@
+#!/usr/bin/env bash
+# size-story.sh - Display story sizing guidelines
+# Usage: size-story.sh [points]
+#   No args: Show all sizing guidelines
+#   points:  Show specific guidance for that point value
+
+set -euo pipefail
+
+POINTS="${1:-}"
+
+print_all() {
+    cat << 'EOF'
+# Story Sizing Guidelines
+
+| Points | Scale | Complexity | Testing |
+|--------|-------|------------|---------|
+| 1-2 | Trivial | Single file, config | Minimal/none |
+| 3 | Small | Few files, single component | Some tests |
+| 5 | Medium | Multiple files, cross-layer | Comprehensive |
+| 8 | Large | Significant scope, cross-repo | Extensive |
+| 13+ | Epic | **SPLIT THIS** | N/A |
+
+## 1-2 Points (Trivial)
+- Single file change
+- Config update
+- Simple bug fix
+- Minimal or no new tests needed
+
+## 3 Points (Small)
+- Few files changed
+- Single component/handler
+- Straightforward implementation
+- Some tests needed
+
+## 5 Points (Medium)
+- Multiple files across layers
+- New feature component
+- API + UI changes
+- Comprehensive tests
+
+## 8 Points (Large)
+- Significant feature
+- Multiple components
+- Database changes possible
+- Cross-repo coordination
+
+## 13+ Points (Epic-level)
+- **SPLIT THIS STORY**
+- Too complex for single story
+- Multiple unknowns
+- Break into 3-5 smaller stories
+EOF
+}
+
+print_specific() {
+    local pts="$1"
+    case "$pts" in
+        1|2)
+            cat << 'EOF'
+## 1-2 Points (Trivial)
+
+**Characteristics:**
+- Single file change
+- Config update
+- Simple bug fix
+- Minimal or no new tests needed
+
+**Examples:**
+- Fix typo in documentation
+- Update environment variable
+- Add missing import
+- Simple CSS adjustment
+
+**YAML:**
+```yaml
+- id: PROJ-XXXXX
+  title: "Fix typo in README"
+  points: 1
+  workflow: trivial
+```
+EOF
+            ;;
+        3)
+            cat << 'EOF'
+## 3 Points (Small)
+
+**Characteristics:**
+- Few files changed
+- Single component/handler
+- Straightforward implementation
+- Some tests needed
+
+**Examples:**
+- Add validation to existing endpoint
+- Fix bug with tests
+- Add new utility function
+
+**YAML:**
+```yaml
+- id: PROJ-XXXXX
+  title: "Add input validation"
+  points: 3
+  workflow: tdd
+```
+EOF
+            ;;
+        5)
+            cat << 'EOF'
+## 5 Points (Medium)
+
+**Characteristics:**
+- Multiple files across layers
+- New feature component
+- API + UI changes
+- Comprehensive tests
+
+**Examples:**
+- New admin page
+- New API endpoint with tests
+- Refactor with behavioral tests
+
+**YAML:**
+```yaml
+- id: PROJ-XXXXX
+  title: "Add settings page"
+  points: 5
+  workflow: tdd
+```
+EOF
+            ;;
+        8)
+            cat << 'EOF'
+## 8 Points (Large)
+
+**Characteristics:**
+- Significant feature
+- Multiple components
+- Database changes possible
+- Cross-repo coordination
+
+**Examples:**
+- New integration
+- Major refactor
+- New subsystem
+
+**YAML:**
+```yaml
+- id: PROJ-XXXXX
+  title: "Add notification system"
+  points: 8
+  workflow: tdd
+```
+
+**Consider:** Can this be split into 2-3 smaller stories?
+EOF
+            ;;
+        13|21|*)
+            if [[ "$pts" -ge 13 ]]; then
+                cat << 'EOF'
+## 13+ Points - TOO LARGE
+
+**This story should be SPLIT.**
+
+Stories over 8 points have:
+- Multiple unknowns
+- High risk of scope creep
+- Difficult to estimate accurately
+- Hard to review in one PR
+
+**Action:** Break into 3-5 smaller stories:
+1. Identify distinct deliverables
+2. Create a story per deliverable
+3. Size each story 3-5 points
+4. Link stories to parent epic
+
+**Example split:**
+```
+Epic: User Dashboard (13 pts total)
+├── Story 1: Dashboard layout (3 pts)
+├── Story 2: User stats API (5 pts)
+├── Story 3: Activity feed (3 pts)
+└── Story 4: Export feature (2 pts)
+```
+EOF
+            else
+                echo "Unknown point value: $pts"
+                echo "Valid values: 1, 2, 3, 5, 8, 13+"
+                exit 1
+            fi
+            ;;
+    esac
+}
+
+if [[ -z "$POINTS" ]]; then
+    print_all
+else
+    print_specific "$POINTS"
+fi

package/pennyfarthing-dist/scripts/story/story-template.sh

@@ -0,0 +1,162 @@
+#!/usr/bin/env bash
+# story-template.sh - Show story templates by type
+# Usage: story-template.sh [bug|feature|refactor|chore]
+#   No args: Show all templates
+#   type:    Show specific template
+
+set -euo pipefail
+
+TYPE="${1:-}"
+
+print_bug() {
+    cat << 'EOF'
+## Bug Fix Story Template
+
+```yaml
+- id: PROJ-XXXXX
+  title: "[Component] Bug description"
+  description: |
+    **Symptom:** What user sees
+    **Error:** Error message or behavior
+    **Affected:** Pages/endpoints impacted
+  points: 2-3
+  priority: P1
+  status: backlog
+  workflow: tdd
+  acceptance_criteria:
+    - Bug no longer occurs under [conditions]
+    - Regression test added covering the bug
+    - Related code audited for same issue
+```
+
+**Sizing hints:**
+- Simple fix with clear cause: 2 pts
+- Investigation needed: 3 pts
+- Multiple components affected: 5 pts
+EOF
+}
+
+print_feature() {
+    cat << 'EOF'
+## Feature Story Template
+
+```yaml
+- id: PROJ-XXXXX
+  title: "[Action verb] [what] for [who/where]"
+  description: |
+    User can [action] to [benefit].
+    [Additional context if needed]
+  points: 3-8
+  priority: P2
+  status: backlog
+  workflow: tdd
+  acceptance_criteria:
+    - Feature works as specified
+    - UI matches design (if applicable)
+    - API documented (if applicable)
+    - Tests cover happy path and edge cases
+    - Error handling implemented
+```
+
+**Sizing hints:**
+- Single component: 3 pts
+- API + UI: 5 pts
+- Cross-repo/complex: 8 pts
+EOF
+}
+
+print_refactor() {
+    cat << 'EOF'
+## Refactor Story Template
+
+```yaml
+- id: PROJ-XXXXX
+  title: "Refactor [component] to [improvement]"
+  description: |
+    Current: [what exists now]
+    Target: [what it should become]
+    Why: [reason for change]
+  points: 3-5
+  priority: P2
+  status: backlog
+  workflow: tdd
+  acceptance_criteria:
+    - All existing tests pass
+    - No behavior changes (unless explicitly scoped)
+    - Code follows new pattern
+    - Documentation updated
+```
+
+**Sizing hints:**
+- Extract/rename: 2-3 pts
+- Restructure module: 5 pts
+- Architecture change: 8 pts (consider splitting)
+EOF
+}
+
+print_chore() {
+    cat << 'EOF'
+## Chore Story Template
+
+```yaml
+- id: PROJ-XXXXX
+  title: "[Action] [what]"
+  description: |
+    [What needs to be done and why]
+  points: 1-2
+  priority: P2
+  status: backlog
+  workflow: trivial
+  acceptance_criteria:
+    - Task completed
+    - No regressions introduced
+```
+
+**Examples:**
+- Update dependencies
+- Fix typo in docs
+- Remove dead code
+- Update config values
+
+**Note:** Chores typically use a lightweight workflow.
+EOF
+}
+
+print_all() {
+    cat << 'EOF'
+# Story Templates
+
+Use these templates when adding stories to sprint YAML.
+
+EOF
+    print_bug
+    echo ""
+    print_feature
+    echo ""
+    print_refactor
+    echo ""
+    print_chore
+}
+
+case "$TYPE" in
+    bug)
+        print_bug
+        ;;
+    feature)
+        print_feature
+        ;;
+    refactor)
+        print_refactor
+        ;;
+    chore)
+        print_chore
+        ;;
+    "")
+        print_all
+        ;;
+    *)
+        echo "Unknown type: $TYPE"
+        echo "Valid types: bug, feature, refactor, chore"
+        exit 1
+        ;;
+esac

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

@@ -0,0 +1,23 @@
+# Test Scripts
+
+Scripts for test infrastructure and benchmarking.
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `test-setup.sh` | Set up test environment |
+| `test-cache.sh` | Manage test result caching |
+| `ground-truth-judge.py` | Python judge for ground truth evaluation |
+| `swebench-judge.py` | SWE-bench style evaluation |
+
+## Usage
+
+```bash
+.pennyfarthing/scripts/core/run.sh test/test-setup.sh
+```
+
+## Ownership
+
+- **Primary users:** TEA agent, testing-runner subagent
+- **Maintained by:** Core Pennyfarthing team