@pennyfarthing/core 11.1.0 → 11.2.0

package/pennyfarthing-dist/scripts/workflow/resume-workflow.sh

@@ -1,157 +1,5 @@
 #!/bin/bash
-# Resume a stepped workflow from last completed step
-# Usage: .pennyfarthing/scripts/workflow/resume-workflow.sh [name]
-#
-# If no name provided, detects from active session
-
-set -euo pipefail
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
-SESSION_DIR="$PROJECT_ROOT/.session"
-
-if ! command -v yq &> /dev/null; then
-  echo "Error: yq is required but not installed"
-  echo "Install with: brew install yq"
-  exit 1
-fi
-
-WORKFLOW_NAME="${1:-}"
-
-# If no name, try to detect from session
-if [[ -z "$WORKFLOW_NAME" ]]; then
-  # Look for workflow session files
-  SESSION_FILE=$(find "$SESSION_DIR" -maxdepth 1 -name "*-workflow-session.md" 2>/dev/null | head -1)
-
-  if [[ -z "$SESSION_FILE" ]]; then
-    echo "# Resume Stepped Workflow"
-    echo ""
-    echo "No active workflow session found."
-    echo ""
-    echo "Use \`/workflow start <name>\` to begin a new workflow."
-    exit 1
-  fi
-
-  # Extract workflow name from session
-  WORKFLOW_NAME=$(grep -E "^\*\*Workflow:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/\*\*Workflow:\*\* //' | tr -d ' ')
-
-  if [[ -z "$WORKFLOW_NAME" ]]; then
-    # Try extracting from filename
-    WORKFLOW_NAME=$(basename "$SESSION_FILE" | sed 's/-workflow-session.md//')
-  fi
-else
-  SESSION_FILE="$SESSION_DIR/${WORKFLOW_NAME}-workflow-session.md"
-fi
-
-if [[ ! -f "$SESSION_FILE" ]]; then
-  echo "Error: No session found for workflow '$WORKFLOW_NAME'"
-  echo ""
-  echo "Use \`/workflow start $WORKFLOW_NAME\` to begin."
-  exit 1
-fi
-
-# Find workflow file
-WORKFLOW_FILE=""
-if [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml" ]]; then
-  WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
-elif [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml" ]]; then
-  WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml"
-else
-  echo "Error: Workflow definition '$WORKFLOW_NAME' not found"
-  exit 1
-fi
-
-WORKFLOW_DIR=$(dirname "$WORKFLOW_FILE")
-
-# Parse session state
-CURRENT_STEP=$(grep -E "^\- \*\*Current Step:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "1")
-MODE=$(grep -E "^\- \*\*Mode:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "create")
-STATUS=$(grep -E "^\- \*\*Status:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "in_progress")
-STEPS_COMPLETED=$(grep -E "^\- \*\*Steps Completed:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "[]")
-
-# Check if workflow is complete
-if [[ "$STATUS" == "completed" ]]; then
-  echo "# Workflow Complete: $WORKFLOW_NAME"
-  echo ""
-  echo "This workflow has already been completed."
-  echo ""
-  echo "To start a new session, delete the session file:"
-  echo "\`\`\`bash"
-  echo "rm \"$SESSION_FILE\""
-  echo "\`\`\`"
-  echo ""
-  echo "Then run \`/workflow start $WORKFLOW_NAME\`"
-  exit 0
-fi
-
-# Resolve steps path based on mode
-MODE_PATH=$(yq eval ".workflow.modes.$MODE // \"\"" "$WORKFLOW_FILE")
-if [[ -n "$MODE_PATH" && "$MODE_PATH" != "null" ]]; then
-  STEPS_PATH="$MODE_PATH"
-else
-  STEPS_PATH=$(yq eval '.workflow.steps.path' "$WORKFLOW_FILE")
-fi
-
-# Resolve relative path
-if [[ "$STEPS_PATH" == ./* ]]; then
-  STEPS_PATH="$WORKFLOW_DIR/${STEPS_PATH#./}"
-elif [[ "$STEPS_PATH" != /* ]]; then
-  STEPS_PATH="$PROJECT_ROOT/$STEPS_PATH"
-fi
-
-# Count steps
-STEP_COUNT=$(find "$STEPS_PATH" -maxdepth 1 -name "step-0*.md" -o -name "step-1*.md" 2>/dev/null | wc -l | tr -d ' ')
-
-# Find the current step file
-# Handle various naming: step-01.md, step-01-name.md, step-1-name.md
-PADDED_STEP=$(printf "%02d" "$CURRENT_STEP")
-STEP_FILE=$(find "$STEPS_PATH" -maxdepth 1 \( -name "step-${PADDED_STEP}*.md" -o -name "step-${CURRENT_STEP}-*.md" \) 2>/dev/null | sort | head -1)
-
-if [[ -z "$STEP_FILE" ]]; then
-  echo "Error: Could not find step $CURRENT_STEP file in $STEPS_PATH"
-  exit 1
-fi
-
-# Update last updated timestamp
-NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-sed -i '' "s/^\- \*\*Last Updated:\*\*.*/- **Last Updated:** $NOW/" "$SESSION_FILE" 2>/dev/null || true
-
-# Calculate completion percentage
-COMPLETED_COUNT=$(echo "$STEPS_COMPLETED" | tr -cd ',' | wc -c | tr -d ' ')
-if [[ "$STEPS_COMPLETED" != "[]" ]]; then
-  COMPLETED_COUNT=$((COMPLETED_COUNT + 1))
-fi
-if [[ "$STEP_COUNT" -gt 0 ]]; then
-  COMPLETION_PCT=$((COMPLETED_COUNT * 100 / STEP_COUNT))
-else
-  COMPLETION_PCT=0
-fi
-
-# Output resume info
-echo "# Resuming Workflow: $WORKFLOW_NAME"
-echo ""
-echo "**Mode:** $MODE"
-echo "**Progress:** Step $CURRENT_STEP of $STEP_COUNT ($COMPLETION_PCT% complete)"
-echo "**Steps Completed:** $STEPS_COMPLETED"
-echo "**Session:** $SESSION_FILE"
-echo ""
-echo "---"
-echo ""
-echo "## Step $CURRENT_STEP of $STEP_COUNT"
-echo ""
-
-# Output step content (strip frontmatter if present)
-if head -1 "$STEP_FILE" | grep -q "^---$"; then
-  awk '/^---$/{if(++c==2){p=1;next}}p' "$STEP_FILE"
-else
-  cat "$STEP_FILE"
-fi
-
-echo ""
-echo "---"
-echo ""
-echo "**Controls:**"
-echo "- \`C\` - Continue to next step"
-echo "- \`/workflow status\` - Check progress"
+# DEPRECATED: Use `pf workflow resume` instead.
+# This shim forwards to the Python CLI for backward compatibility.
+echo "Warning: resume-workflow.sh is deprecated. Use: pf workflow resume $*" >&2
+exec pf workflow resume "$@"

package/pennyfarthing-dist/scripts/workflow/show-workflow.sh

@@ -1,132 +1,5 @@
 #!/bin/bash
-# Show workflow details
-# Usage: .pennyfarthing/scripts/workflow/show-workflow.sh [name]
-#    or: Invoked with PROJECT_ROOT already set
-#
-# If no name provided, shows current session's workflow
-# If name provided, shows that workflow's details
-
-set -euo pipefail
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
-SESSION_DIR="$PROJECT_ROOT/.session"
-
-if ! command -v yq &> /dev/null; then
-  echo "Error: yq is required but not installed"
-  echo "Install with: brew install yq"
-  exit 1
-fi
-
-# Get workflow name from argument or session
-WORKFLOW_NAME="${1:-}"
-
-if [[ -z "$WORKFLOW_NAME" ]]; then
-  # Try to get from current session (exclude archive directory)
-  SESSION_FILE=$(find "$SESSION_DIR" -maxdepth 1 -name "*-session.md" 2>/dev/null | head -1)
-  if [[ -n "$SESSION_FILE" ]]; then
-    # Extract workflow from session file (look for **Workflow:** line)
-    WORKFLOW_NAME=$(grep -E "^\*\*Workflow:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' | tr -d ' ' || echo "")
-    if [[ -z "$WORKFLOW_NAME" ]]; then
-      # Try alternate format (Workflow: value in tracking section)
-      WORKFLOW_NAME=$(grep -E "^Workflow:" "$SESSION_FILE" 2>/dev/null | head -1 | cut -d: -f2 | tr -d ' ' || echo "")
-    fi
-  fi
-
-  if [[ -z "$WORKFLOW_NAME" ]]; then
-    echo "# Current Workflow"
-    echo ""
-    echo "No active session found. Showing default workflow (tdd)."
-    echo ""
-    WORKFLOW_NAME="tdd"
-  else
-    echo "# Current Session Workflow: $WORKFLOW_NAME"
-    echo ""
-  fi
-else
-  echo "# Workflow: $WORKFLOW_NAME"
-  echo ""
-fi
-
-WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
-
-if [[ ! -f "$WORKFLOW_FILE" ]]; then
-  echo "Error: Workflow '$WORKFLOW_NAME' not found"
-  echo ""
-  echo "Available workflows:"
-  for f in "$WORKFLOWS_DIR"/*.yaml; do
-    [[ -f "$f" ]] || continue
-    basename "$f" .yaml
-  done
-  exit 1
-fi
-
-# Extract workflow details
-DESC=$(yq eval '.workflow.description' "$WORKFLOW_FILE")
-VERSION=$(yq eval '.workflow.version' "$WORKFLOW_FILE")
-
-echo "**Description:** $DESC"
-echo "**Version:** $VERSION"
-echo ""
-
-# Show phases as a flow diagram
-echo "## Phase Flow"
-echo ""
-echo -n "\`\`\`"
-echo ""
-
-# Build phase flow string
-PHASES=""
-yq eval '.workflow.phases[].name' "$WORKFLOW_FILE" | while read -r phase; do
-  if [[ -n "$PHASES" ]]; then
-    echo -n " -> "
-  fi
-  echo -n "$phase"
-  PHASES="$phase"
-done
-echo ""
-echo "\`\`\`"
-echo ""
-
-# Show phases table
-echo "## Phases"
-echo ""
-echo "| Phase | Agent | Gate |"
-echo "|-------|-------|------|"
-
-yq eval '.workflow.phases[] | .name + "|" + .agent + "|" + (.gate.type // "none")' "$WORKFLOW_FILE" | while IFS='|' read -r phase agent gate; do
-  echo "| $phase | $agent | $gate |"
-done
-
-echo ""
-
-# Show triggers
-echo "## Triggers"
-echo ""
-
-TYPES=$(yq eval '.workflow.triggers.types // []' "$WORKFLOW_FILE")
-if [[ "$TYPES" != "[]" && "$TYPES" != "null" ]]; then
-  echo "**Types:** $(yq eval '.workflow.triggers.types | join(", ")' "$WORKFLOW_FILE")"
-fi
-
-POINTS_MIN=$(yq eval '.workflow.triggers.points.min // ""' "$WORKFLOW_FILE")
-POINTS_MAX=$(yq eval '.workflow.triggers.points.max // ""' "$WORKFLOW_FILE")
-
-if [[ -n "$POINTS_MIN" && "$POINTS_MIN" != "null" ]]; then
-  echo "**Points Min:** $POINTS_MIN"
-fi
-if [[ -n "$POINTS_MAX" && "$POINTS_MAX" != "null" ]]; then
-  echo "**Points Max:** $POINTS_MAX"
-fi
-
-IS_DEFAULT=$(yq eval '.workflow.triggers.default // false' "$WORKFLOW_FILE")
-if [[ "$IS_DEFAULT" == "true" ]]; then
-  echo "**Default:** yes (used when no other workflow matches)"
-fi
-
-TAGS=$(yq eval '.workflow.triggers.tags // []' "$WORKFLOW_FILE")
-if [[ "$TAGS" != "[]" && "$TAGS" != "null" ]]; then
-  echo "**Tags:** $(yq eval '.workflow.triggers.tags | join(", ")' "$WORKFLOW_FILE")"
-fi
+# DEPRECATED: Use `pf workflow show` instead.
+# This shim forwards to the Python CLI for backward compatibility.
+echo "Warning: show-workflow.sh is deprecated. Use: pf workflow show $*" >&2
+exec pf workflow show "$@"

package/pennyfarthing-dist/scripts/workflow/start-workflow.sh

@@ -1,250 +1,5 @@
 #!/bin/bash
-# Start a stepped workflow
-# Usage: .pennyfarthing/scripts/workflow/start-workflow.sh <name> [--mode create|validate|edit]
-#
-# Creates a new workflow session and loads step 1.
-# For tri-modal workflows, --mode selects the step path (default: create)
-
-set -euo pipefail
-
-# Find project root
-source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
-
-WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
-SESSION_DIR="$PROJECT_ROOT/.session"
-
-if ! command -v yq &> /dev/null; then
-  echo "Error: yq is required but not installed"
-  echo "Install with: brew install yq"
-  exit 1
-fi
-
-# Parse arguments
-WORKFLOW_NAME=""
-MODE=""
-ARGS=("$@")
-
-i=0
-while [[ $i -lt ${#ARGS[@]} ]]; do
-  arg="${ARGS[$i]}"
-  case "$arg" in
-    --mode=*)
-      MODE="${arg#--mode=}"
-      ;;
-    --mode|-m)
-      if [[ $((i+1)) -lt ${#ARGS[@]} ]]; then
-        ((i++))
-        MODE="${ARGS[$i]}"
-      else
-        echo "Error: --mode requires a value (create, validate, or edit)"
-        exit 1
-      fi
-      ;;
-    -*)
-      echo "Error: Unknown option: $arg"
-      echo "Usage: start-workflow.sh <name> [--mode create|validate|edit]"
-      exit 1
-      ;;
-    *)
-      if [[ -z "$WORKFLOW_NAME" ]]; then
-        WORKFLOW_NAME="$arg"
-      else
-        echo "Error: Unexpected argument: $arg"
-        exit 1
-      fi
-      ;;
-  esac
-  ((i++))
-done
-
-if [[ -z "$WORKFLOW_NAME" ]]; then
-  echo "# Start Stepped Workflow"
-  echo ""
-  echo "Usage: /workflow start <name> [--mode create|validate|edit]"
-  echo ""
-  echo "**Available stepped workflows:**"
-  echo ""
-  for f in "$WORKFLOWS_DIR"/*.yaml "$WORKFLOWS_DIR"/*/workflow.yaml; do
-    [[ -f "$f" ]] || continue
-    workflow_type=$(yq eval '.workflow.type // "phased"' "$f")
-    if [[ "$workflow_type" == "stepped" ]]; then
-      name=$(yq eval '.workflow.name' "$f")
-      desc=$(yq eval '.workflow.description' "$f" | head -1 | cut -c1-60)
-      echo "- **$name** - $desc"
-    fi
-  done
-  exit 1
-fi
-
-# Find workflow file (support both flat and directory structure)
-WORKFLOW_FILE=""
-if [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml" ]]; then
-  WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
-elif [[ -f "$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml" ]]; then
-  WORKFLOW_FILE="$WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml"
-else
-  echo "Error: Workflow '$WORKFLOW_NAME' not found"
-  echo ""
-  echo "Looked in:"
-  echo "  $WORKFLOWS_DIR/${WORKFLOW_NAME}.yaml"
-  echo "  $WORKFLOWS_DIR/${WORKFLOW_NAME}/workflow.yaml"
-  exit 1
-fi
-
-WORKFLOW_DIR=$(dirname "$WORKFLOW_FILE")
-
-# Validate it's a stepped workflow
-WORKFLOW_TYPE=$(yq eval '.workflow.type // "phased"' "$WORKFLOW_FILE")
-if [[ "$WORKFLOW_TYPE" != "stepped" ]]; then
-  echo "Error: '$WORKFLOW_NAME' is a phased workflow, not stepped"
-  echo "Use TDD workflow commands (/sm, /tea, /dev, /reviewer) for phased workflows"
-  exit 1
-fi
-
-# Validate mode if provided
-if [[ -n "$MODE" ]]; then
-  case "$MODE" in
-    create|validate|edit)
-      ;;
-    *)
-      echo "Error: Invalid mode '$MODE'. Must be one of: create, validate, edit"
-      exit 1
-      ;;
-  esac
-fi
-
-# Get workflow info
-WORKFLOW_DESC=$(yq eval '.workflow.description' "$WORKFLOW_FILE")
-WORKFLOW_AGENT=$(yq eval '.workflow.agent // "pm"' "$WORKFLOW_FILE")
-
-# Resolve steps path based on mode
-if [[ -n "$MODE" ]]; then
-  MODE_PATH=$(yq eval ".workflow.modes.$MODE // \"\"" "$WORKFLOW_FILE")
-  if [[ -z "$MODE_PATH" || "$MODE_PATH" == "null" ]]; then
-    AVAILABLE_MODES=$(yq eval '.workflow.modes | keys | .[]' "$WORKFLOW_FILE" 2>/dev/null | grep -v default | tr '\n' ', ' | sed 's/,$//')
-    echo "Error: Mode '$MODE' not available for workflow '$WORKFLOW_NAME'"
-    echo "Available modes: $AVAILABLE_MODES"
-    exit 1
-  fi
-  STEPS_PATH="$MODE_PATH"
-else
-  # Use default mode or steps.path
-  DEFAULT_MODE=$(yq eval '.workflow.modes.default // ""' "$WORKFLOW_FILE")
-  if [[ -n "$DEFAULT_MODE" && "$DEFAULT_MODE" != "null" ]]; then
-    MODE_PATH=$(yq eval ".workflow.modes.$DEFAULT_MODE // \"\"" "$WORKFLOW_FILE")
-    if [[ -n "$MODE_PATH" && "$MODE_PATH" != "null" ]]; then
-      STEPS_PATH="$MODE_PATH"
-      MODE="$DEFAULT_MODE"
-    fi
-  fi
-
-  if [[ -z "${STEPS_PATH:-}" ]]; then
-    STEPS_PATH=$(yq eval '.workflow.steps.path' "$WORKFLOW_FILE")
-    MODE="${MODE:-create}"
-  fi
-fi
-
-# Resolve relative path
-if [[ "$STEPS_PATH" == ./* ]]; then
-  STEPS_PATH="$WORKFLOW_DIR/${STEPS_PATH#./}"
-elif [[ "$STEPS_PATH" != /* ]]; then
-  STEPS_PATH="$PROJECT_ROOT/$STEPS_PATH"
-fi
-
-# Count steps
-STEPS_PATTERN=$(yq eval '.workflow.steps.pattern // "step-*.md"' "$WORKFLOW_FILE")
-STEP_COUNT=$(find "$STEPS_PATH" -maxdepth 1 -name "step-0*.md" -o -name "step-1*.md" 2>/dev/null | wc -l | tr -d ' ')
-
-if [[ "$STEP_COUNT" -eq 0 ]]; then
-  echo "Error: No step files found in $STEPS_PATH"
-  exit 1
-fi
-
-# Create session directory
-mkdir -p "$SESSION_DIR"
-
-# Generate session filename
-SESSION_FILE="$SESSION_DIR/${WORKFLOW_NAME}-workflow-session.md"
-
-# Check for existing session
-if [[ -f "$SESSION_FILE" ]]; then
-  echo "**Warning:** Existing session found"
-  echo ""
-  echo "Session: $SESSION_FILE"
-  echo ""
-  echo "Options:"
-  echo "1. Use \`/workflow resume $WORKFLOW_NAME\` to continue"
-  echo "2. Delete the session file to start fresh"
-  echo ""
-  echo "To start fresh, run:"
-  echo "\`\`\`bash"
-  echo "rm \"$SESSION_FILE\""
-  echo "\`\`\`"
-  exit 0
-fi
-
-# Create initial session file
-NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-cat > "$SESSION_FILE" << EOF
-# Workflow Session: $WORKFLOW_NAME
-
-**Workflow:** $WORKFLOW_NAME
-**Type:** stepped
-**Agent:** $WORKFLOW_AGENT
-**Started:** $NOW
-
-## Workflow State
-- **Workflow Name:** $WORKFLOW_NAME
-- **Type:** stepped
-- **Mode:** $MODE
-- **Started:** $NOW
-- **Last Updated:** $NOW
-- **Current Step:** 1
-- **Steps Completed:** []
-- **Status:** in_progress
-- **Notes:** Session created via /workflow start
-
-## Progress
-- Total Steps: $STEP_COUNT
-- Completion: 0%
-
----
-
-EOF
-
-# Find step 1 file (handle various naming patterns)
-STEP_FILE=$(find "$STEPS_PATH" -maxdepth 1 \( -name "step-01*.md" -o -name "step-1-*.md" \) 2>/dev/null | sort | head -1)
-
-if [[ -z "$STEP_FILE" ]]; then
-  echo "Error: Could not find step 1 file in $STEPS_PATH"
-  exit 1
-fi
-
-# Output workflow start info
-echo "# Starting Workflow: $WORKFLOW_NAME"
-echo ""
-echo "**Description:** $WORKFLOW_DESC"
-echo "**Mode:** $MODE"
-echo "**Steps:** $STEP_COUNT"
-echo "**Agent:** $WORKFLOW_AGENT"
-echo "**Session:** $SESSION_FILE"
-echo ""
-echo "---"
-echo ""
-echo "## Step 1 of $STEP_COUNT"
-echo ""
-
-# Output step content (strip frontmatter if present)
-if head -1 "$STEP_FILE" | grep -q "^---$"; then
-  awk '/^---$/{if(++c==2){p=1;next}}p' "$STEP_FILE"
-else
-  cat "$STEP_FILE"
-fi
-
-echo ""
-echo "---"
-echo ""
-echo "**Controls:**"
-echo "- \`C\` - Continue to next step"
-echo "- \`/workflow status\` - Check progress"
-echo "- \`/workflow resume\` - Resume after break"
+# DEPRECATED: Use `pf workflow start` instead.
+# This shim forwards to the Python CLI for backward compatibility.
+echo "Warning: start-workflow.sh is deprecated. Use: pf workflow start $*" >&2
+exec pf workflow start "$@"