@pennyfarthing/core 7.6.0 → 7.7.0

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

@@ -1,159 +1,19 @@
-#!/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]
+#!/usr/bin/env zsh
+# 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)
+#   --workflow <name>                  Workflow override
 #   --priority P0|P1|P2|P3             Priority (default: P2)
-#   --repos <name>                     Repos affected
-#   --jira                             Also show Jira create command
+#
+# Thin wrapper that delegates to Python CLI:
+#   python -m pennyfarthing_scripts.story create <epic-id> "<title>" <points> [options]
 
-set -euo pipefail
+set -e
 
-# Defaults
-TYPE="feature"
-WORKFLOW=""
-PRIORITY="P2"
-REPOS=""
-CREATE_JIRA=false
+# Source common functions for Python discovery
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+source "${PARENT_DIR}/lib/common.sh"
 
-# 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
+# Delegate to Python CLI
+run_python_module story create "$@"

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

@@ -1,198 +1,18 @@
-#!/usr/bin/env bash
-# size-story.sh - Display story sizing guidelines
+#!/usr/bin/env zsh
+# Display story sizing guidelines
 # Usage: size-story.sh [points]
 #   No args: Show all sizing guidelines
 #   points:  Show specific guidance for that point value
+#
+# Thin wrapper that delegates to Python CLI:
+#   python -m pennyfarthing_scripts.story size [points]
 
-set -euo pipefail
+set -e
 
-POINTS="${1:-}"
+# Source common functions for Python discovery
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+source "${PARENT_DIR}/lib/common.sh"
 
-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
+# Delegate to Python CLI
+run_python_module story size "$@"

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

@@ -1,162 +1,18 @@
-#!/usr/bin/env bash
-# story-template.sh - Show story templates by type
+#!/usr/bin/env zsh
+# Show story templates by type
 # Usage: story-template.sh [bug|feature|refactor|chore]
 #   No args: Show all templates
 #   type:    Show specific template
+#
+# Thin wrapper that delegates to Python CLI:
+#   python -m pennyfarthing_scripts.story template [type]
 
-set -euo pipefail
+set -e
 
-TYPE="${1:-}"
+# Source common functions for Python discovery
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+source "${PARENT_DIR}/lib/common.sh"
 
-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
+# Delegate to Python CLI
+run_python_module story template "$@"