@pennyfarthing/core 10.0.1 → 10.0.2

package/pennyfarthing-dist/scripts/workflow/get-workflow-type.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+"""
+get-workflow-type.py - Determine if a workflow is phased or stepped
+
+Usage: python get-workflow-type.py <workflow-name>
+
+Returns: "phased" or "stepped" (stdout)
+Exit 1 if workflow not found
+"""
+
+import sys
+from pathlib import Path
+
+try:
+    import yaml
+except ImportError:
+    print("Error: PyYAML required. Install with: pip install pyyaml", file=sys.stderr)
+    sys.exit(1)
+
+
+def find_project_root() -> Path:
+    """Find project root by looking for .pennyfarthing directory."""
+    current = Path.cwd()
+    while current != current.parent:
+        if (current / ".pennyfarthing").is_dir():
+            return current
+        current = current.parent
+    return Path.cwd()
+
+
+def get_workflow_type(workflow_name: str) -> str:
+    """Get workflow type from YAML definition."""
+    project_root = find_project_root()
+    workflows_dir = project_root / ".pennyfarthing" / "workflows"
+    workflow_file = workflows_dir / f"{workflow_name}.yaml"
+
+    if not workflow_file.exists():
+        print(f"Error: Workflow '{workflow_name}' not found", file=sys.stderr)
+        sys.exit(1)
+
+    with open(workflow_file) as f:
+        data = yaml.safe_load(f)
+
+    # Extract type, default to "phased" if not specified
+    workflow_type = data.get("workflow", {}).get("type", "phased")
+    return workflow_type
+
+
+def main() -> int:
+    if len(sys.argv) != 2:
+        print("Usage: get-workflow-type.py <workflow-name>", file=sys.stderr)
+        return 1
+
+    workflow_name = sys.argv[1]
+    workflow_type = get_workflow_type(workflow_name)
+    print(workflow_type)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/pennyfarthing-dist/scripts/workflow/get-workflow-type.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# get-workflow-type.sh - Determine if a workflow is phased or stepped
+#
+# Usage: .pennyfarthing/scripts/workflow/get-workflow-type.sh <workflow-name>
+#
+# Returns: "phased" or "stepped"
+# Exit 1 if workflow not found
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+exec python3 "$SCRIPT_DIR/get-workflow-type.py" "$@"

package/pennyfarthing-dist/scripts/workflow/list-workflows.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+# List all available workflows with type indicators
+# Usage: .pennyfarthing/scripts/workflow/list-workflows.sh
+#    or: Invoked with PROJECT_ROOT already set
+#
+# MSSCI-12083: Added type, steps, and modes columns
+
+set -euo pipefail
+
+# Find project root
+source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
+
+WORKFLOWS_DIR="$PROJECT_ROOT/.pennyfarthing/workflows"
+
+if [[ ! -d "$WORKFLOWS_DIR" ]]; then
+  echo "Error: Workflows directory not found at $WORKFLOWS_DIR"
+  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
+
+echo "# Available Workflows"
+echo ""
+echo "| Workflow | Type | Default | Steps/Phases | Modes | Description |"
+echo "|----------|------|---------|--------------|-------|-------------|"
+
+# Find all workflow YAML files: top-level *.yaml and subdirectory workflow.yaml files
+workflow_files=()
+while IFS= read -r -d '' f; do
+  workflow_files+=("$f")
+done < <(find -L "$WORKFLOWS_DIR" -maxdepth 1 -name "*.yaml" -print0 2>/dev/null)
+while IFS= read -r -d '' f; do
+  workflow_files+=("$f")
+done < <(find -L "$WORKFLOWS_DIR" -mindepth 2 -name "workflow.yaml" -print0 2>/dev/null)
+
+# Exit early if no workflows found
+if [[ ${#workflow_files[@]} -eq 0 ]]; then
+  echo "No workflows found in $WORKFLOWS_DIR"
+  exit 0
+fi
+
+# Sort by workflow name for consistent output
+IFS=$'\n' sorted_files=($(printf '%s\n' "${workflow_files[@]}" | sort))
+unset IFS
+
+for f in "${sorted_files[@]}"; do
+  [[ -f "$f" ]] || continue
+
+  name=$(yq eval '.workflow.name' "$f")
+  desc=$(yq eval '.workflow.description' "$f" | head -1)
+  is_default=$(yq eval '.workflow.triggers.default // false' "$f")
+
+  # Detect workflow type (stepped, phased, or procedural)
+  # Stepped workflows have .workflow.type == "stepped" or .workflow.steps
+  # Procedural workflows have .workflow.type == "procedural" (BMAD reference workflows)
+  workflow_type=$(yq eval '.workflow.type // "phased"' "$f")
+  has_steps=$(yq eval '.workflow.steps != null' "$f")
+
+  if [[ "$has_steps" == "true" ]] || [[ "$workflow_type" == "stepped" ]]; then
+    type_col="stepped"
+    # Count step files if steps.path is defined
+    steps_path=$(yq eval '.workflow.steps.path // ""' "$f")
+    steps_pattern=$(yq eval '.workflow.steps.pattern // "step-*.md"' "$f")
+    # Resolve steps_path relative to the workflow file's directory
+    workflow_dir=$(dirname "$f")
+    if [[ -n "$steps_path" ]]; then
+      # Handle relative paths (./steps/ or steps/)
+      if [[ "$steps_path" == ./* ]]; then
+        resolved_path="$workflow_dir/${steps_path#./}"
+      elif [[ "$steps_path" != /* ]]; then
+        resolved_path="$workflow_dir/$steps_path"
+      else
+        resolved_path="$steps_path"
+      fi
+      if [[ -d "$resolved_path" ]]; then
+        step_count=$(find "$resolved_path" -maxdepth 1 -name "step-*.md" 2>/dev/null | wc -l | tr -d ' ')
+        steps_col="${step_count} steps"
+      else
+        steps_col="-"
+      fi
+    else
+      steps_col="-"
+    fi
+  elif [[ "$workflow_type" == "procedural" ]]; then
+    type_col="procedural"
+    # Procedural workflows use instructions.md instead of phases/steps
+    steps_col="instructions"
+  else
+    type_col="phased"
+    # Count phases for phased workflows
+    phase_count=$(yq eval '.workflow.phases | length' "$f")
+    steps_col="${phase_count} phases"
+  fi
+
+  # Default column
+  if [[ "$is_default" == "true" ]]; then
+    default_col="yes"
+  else
+    default_col="no"
+  fi
+
+  # Modes column (for tri-modal workflows)
+  modes=$(yq eval '.workflow.modes.available // []' "$f")
+  if [[ "$modes" != "[]" ]] && [[ "$modes" != "null" ]]; then
+    # Format as comma-separated list
+    modes_col=$(yq eval '.workflow.modes.available | join(",")' "$f")
+  else
+    modes_col="-"
+  fi
+
+  echo "| $name | $type_col | $default_col | $steps_col | $modes_col | $desc |"
+done
+
+echo ""
+echo "**Legend:**"
+echo "- **phased**: Agent-driven workflow (SM → TEA → Dev → Reviewer)"
+echo "- **stepped**: Step-by-step guided workflow with progressive disclosure"
+echo "- **procedural**: BMAD reference workflow with instructions file"
+echo ""
+echo "Use \`/workflow show <name>\` for workflow details."

package/pennyfarthing-dist/scripts/workflow/phase-owner.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# Get the agent that owns a phase in a workflow
+# Usage: phase-owner.sh <workflow> <phase>
+# Returns: agent name (e.g., "dev", "tea", "reviewer", "sm")
+
+set -euo pipefail
+
+WORKFLOW="${1:-}"
+PHASE="${2:-}"
+
+if [[ -z "$WORKFLOW" || -z "$PHASE" ]]; then
+  echo "Usage: phase-owner.sh <workflow> <phase>" >&2
+  exit 1
+fi
+
+# Find project root
+source "$(dirname "${BASH_SOURCE[0]}")/../lib/find-root.sh"
+
+WORKFLOW_FILE="$PROJECT_ROOT/.pennyfarthing/workflows/${WORKFLOW}.yaml"
+
+if [[ ! -f "$WORKFLOW_FILE" ]]; then
+  echo "Error: Workflow '$WORKFLOW' not found" >&2
+  exit 1
+fi
+
+# Query the agent for this phase
+AGENT=$(yq eval ".workflow.phases[] | select(.name == \"$PHASE\") | .agent" "$WORKFLOW_FILE" 2>/dev/null)
+
+if [[ -z "$AGENT" || "$AGENT" == "null" ]]; then
+  echo "Error: Phase '$PHASE' not found in workflow '$WORKFLOW'" >&2
+  exit 1
+fi
+
+echo "$AGENT"

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

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

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

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