@pennyfarthing/core 9.2.0 → 9.3.0

package/pennyfarthing-dist/skills/workflow/scripts/workflow-status.sh

@@ -1,167 +0,0 @@
-#!/bin/bash
-# Show current stepped workflow progress
-# Usage: .pennyfarthing/scripts/workflow/workflow-status.sh [name]
-#
-# If no name provided, shows status of active workflow session
-
-set -euo pipefail
-
-# PROJECT_ROOT should be set by find-root.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
-
-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
-  SESSION_FILE=$(find "$SESSION_DIR" -maxdepth 1 -name "*-workflow-session.md" 2>/dev/null | head -1)
-
-  if [[ -z "$SESSION_FILE" ]]; then
-    echo "# Workflow Status"
-    echo ""
-    echo "No active workflow session found."
-    echo ""
-    echo "Use \`/workflow start <name>\` to begin a new workflow."
-    exit 0
-  fi
-
-  WORKFLOW_NAME=$(grep -E "^\*\*Workflow:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/\*\*Workflow:\*\* //' | tr -d ' ')
-
-  if [[ -z "$WORKFLOW_NAME" ]]; then
-    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 "# Workflow Status: $WORKFLOW_NAME"
-  echo ""
-  echo "No session found for workflow '$WORKFLOW_NAME'"
-  echo ""
-  echo "Use \`/workflow start $WORKFLOW_NAME\` to begin."
-  exit 0
-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"
-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")
-STARTED=$(grep -E "^\- \*\*Started:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "-")
-LAST_UPDATED=$(grep -E "^\- \*\*Last Updated:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "-")
-STEPS_COMPLETED=$(grep -E "^\- \*\*Steps Completed:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "[]")
-NOTES=$(grep -E "^\- \*\*Notes:\*\*" "$SESSION_FILE" 2>/dev/null | sed 's/.*\*\* //' || echo "-")
-
-# Get total steps from workflow
-if [[ -n "$WORKFLOW_FILE" && -f "$WORKFLOW_FILE" ]]; then
-  # 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
-
-  STEP_COUNT=$(find "$STEPS_PATH" -maxdepth 1 -name "step-0*.md" -o -name "step-1*.md" 2>/dev/null | wc -l | tr -d ' ')
-  WORKFLOW_DESC=$(yq eval '.workflow.description' "$WORKFLOW_FILE" | head -1)
-else
-  STEP_COUNT="?"
-  WORKFLOW_DESC="-"
-fi
-
-# Calculate completion percentage
-COMPLETED_COUNT=$(echo "$STEPS_COMPLETED" | tr -cd ',' | wc -c | tr -d ' ')
-if [[ "$STEPS_COMPLETED" != "[]" && -n "$STEPS_COMPLETED" ]]; then
-  COMPLETED_COUNT=$((COMPLETED_COUNT + 1))
-fi
-
-if [[ "$STEP_COUNT" != "?" && "$STEP_COUNT" -gt 0 ]]; then
-  COMPLETION_PCT=$((COMPLETED_COUNT * 100 / STEP_COUNT))
-else
-  COMPLETION_PCT=0
-fi
-
-# Build progress bar
-BAR_WIDTH=20
-if [[ "$STEP_COUNT" != "?" && "$STEP_COUNT" -gt 0 ]]; then
-  FILLED=$((COMPLETION_PCT * BAR_WIDTH / 100))
-  EMPTY=$((BAR_WIDTH - FILLED))
-  PROGRESS_BAR=$(printf '%*s' "$FILLED" '' | tr ' ' '#')$(printf '%*s' "$EMPTY" '' | tr ' ' '-')
-else
-  PROGRESS_BAR=$(printf '%*s' "$BAR_WIDTH" '' | tr ' ' '?')
-fi
-
-# Status indicator
-case "$STATUS" in
-  completed)
-    STATUS_ICON="[COMPLETE]"
-    ;;
-  paused)
-    STATUS_ICON="[PAUSED]"
-    ;;
-  *)
-    STATUS_ICON="[IN PROGRESS]"
-    ;;
-esac
-
-# Output status
-echo "# Workflow Status: $WORKFLOW_NAME"
-echo ""
-echo "**Description:** $WORKFLOW_DESC"
-echo ""
-echo "## Progress"
-echo ""
-echo "\`\`\`"
-echo "[$PROGRESS_BAR] $COMPLETION_PCT%"
-echo "\`\`\`"
-echo ""
-echo "| Field | Value |"
-echo "|-------|-------|"
-echo "| Status | $STATUS_ICON |"
-echo "| Mode | $MODE |"
-echo "| Current Step | $CURRENT_STEP of $STEP_COUNT |"
-echo "| Completed | $COMPLETED_COUNT steps |"
-echo "| Steps Done | $STEPS_COMPLETED |"
-echo "| Started | $STARTED |"
-echo "| Last Updated | $LAST_UPDATED |"
-if [[ "$NOTES" != "-" ]]; then
-  echo "| Notes | $NOTES |"
-fi
-echo ""
-echo "**Session:** $SESSION_FILE"
-echo ""
-
-if [[ "$STATUS" != "completed" ]]; then
-  echo "**Next:** Use \`/workflow resume\` to continue from step $CURRENT_STEP"
-fi

package/pennyfarthing-dist/skills/workflow/skill.md

@@ -1,345 +0,0 @@
----
-name: workflow
-description: |
-  List available workflows, show current workflow details, and switch workflows mid-session. Use when checking available workflow types (TDD, trivial, agent-docs), viewing current workflow phase, switching to a different workflow pattern, or managing BikeLane stepped workflows.
-args: "[list|show [name]|set <name>|start <name> [--mode <mode>]|resume [name]|status]"
----
-
-# /workflow - Workflow Management
-
-<run>
-.pennyfarthing/scripts/workflow/list-workflows.sh
-</run>
-
-<output>
-Table of workflows with type indicators, steps/phases count, available modes, default status, and descriptions.
-</output>
-
-Pennyfarthing uses YAML-defined workflows to control agent sequences. The default TDD workflow (SM → TEA → Dev → Reviewer) can be customized or replaced with alternative flows. BikeLane stepped workflows provide progressive disclosure for planning and decision-making processes.
-
-## Commands
-
-### `/workflow` or `/workflow list`
-
-List all available workflows with type indicators.
-
-**Run:**
-```bash
-.pennyfarthing/scripts/workflow/list-workflows.sh
-```
-
-**Output:** Table of workflows with:
-- **Type**: `phased` (agent-driven) or `stepped` (progressive disclosure)
-- **Steps/Phases**: Number of steps or phases in the workflow
-- **Modes**: Available tri-modal options (create/validate/edit) if applicable
-- **Default**: Whether this is the default workflow
-- **Description**: Brief workflow description
-
----
-
-### `/workflow show [name]`
-
-Show workflow details. If no name provided, shows current session's workflow.
-
-**Run:**
-```bash
-.pennyfarthing/scripts/workflow/show-workflow.sh [name]
-```
-
-**Arguments:**
-| Arg | Required | Description |
-|-----|----------|-------------|
-| `name` | No | Workflow name (e.g., `tdd`, `trivial`). If omitted, shows current session's workflow. |
-
-**Examples:**
-```bash
-.pennyfarthing/scripts/workflow/show-workflow.sh          # Current session workflow
-.pennyfarthing/scripts/workflow/show-workflow.sh tdd      # Show TDD workflow
-.pennyfarthing/scripts/workflow/show-workflow.sh trivial  # Show trivial workflow
-```
-
-**Output:** Workflow description, phase flow diagram, phases table, and trigger conditions.
-
----
-
-### `/workflow set <name>`
-
-Switch to a different workflow mid-session.
-
-**Warning:** Only do this when story requirements have fundamentally changed. Switching resets phase tracking.
-
-**Steps:**
-1. Verify workflow exists:
-   ```bash
-   .pennyfarthing/scripts/workflow/show-workflow.sh <name>
-   ```
-
-2. Update the session file's workflow field:
-   - Edit `.session/{story-id}-session.md`
-   - Change `**Workflow:**` line to new workflow name
-
-3. Continue with the new workflow's agent sequence
-
----
-
-## BikeLane Stepped Workflow Commands
-
-BikeLane workflows use `type: stepped` and execute one step at a time with user gates.
-
-### `/workflow start <name> [--mode <mode>]`
-
-Start a stepped workflow. Creates a new session and begins at step 1.
-
-**Run:**
-```bash
-.pennyfarthing/scripts/workflow/start-workflow.sh <name> [--mode <mode>]
-```
-
-**Arguments:**
-| Arg | Required | Description |
-|-----|----------|-------------|
-| `name` | Yes | Workflow name (e.g., `architecture`) |
-| `--mode` | No | Execution mode: `create` (default), `validate`, or `edit` |
-
-**Examples:**
-```bash
-/workflow start architecture              # Start in default (create) mode
-/workflow start architecture --mode validate  # Start in validate mode
-```
-
----
-
-### `/workflow resume [name]`
-
-Resume an interrupted stepped workflow from the last completed step.
-
-**Run:**
-```bash
-.pennyfarthing/scripts/workflow/resume-workflow.sh [name]
-```
-
-**Arguments:**
-| Arg | Required | Description |
-|-----|----------|-------------|
-| `name` | No | Workflow to resume. If omitted, detects from active session. |
-
-**Examples:**
-```bash
-/workflow resume                  # Resume active workflow
-/workflow resume architecture     # Resume specific workflow
-```
-
----
-
-### `/workflow status`
-
-Show current stepped workflow progress.
-
-**Run:**
-```bash
-.pennyfarthing/scripts/workflow/workflow-status.sh
-```
-
-**Output:**
-- Current workflow name and type
-- Current step number and name
-- Steps completed
-- Mode (create/validate/edit)
-- Progress percentage
-
----
-
-## Built-in Workflows
-
-### TDD (default for 3+ point features)
-
-```
-setup → red → green → review → finish
-SM → TEA → Dev → Reviewer → SM
-```
-
-- Full test-driven development cycle
-- TEA writes failing tests first
-- Dev implements to make tests pass
-- **Triggers:** `types: [feature, enhancement]`, `points.min: 3`
-
-### Trivial (for 1-2 point fixes)
-
-```
-setup → impl → review → finish
-SM → Dev → Reviewer → SM
-```
-
-- Skips TEA phase for quick fixes
-- Dev ensures existing tests still pass
-- **Triggers:** `types: [chore, fix, refactor]`, `points.max: 2`
-
-### Agent-Docs (for process documentation)
-
-```
-setup → analyze → impl → review → finish
-SM → Orchestrator → Orchestrator → Tech Writer → SM
-```
-
-- For agent file updates and process improvements
-- Tech Writer reviews for documentation quality
-- **Triggers:** `types: [docs, refactor, infrastructure]`, `labels: [agent-file]`
-
-### BDD (behavior-driven development)
-
-```
-setup → design → red → green → review → finish
-SM → UX-Designer → TEA → Dev → Reviewer → SM
-```
-
-- Adds UX design phase before testing
-- For UI components and user-facing features
-- **Triggers:** `types: [ui, ux, behavior]`, `tags: [bdd, ux-first]`
-
-### Architecture (stepped workflow)
-
-```
-initialize → context → patterns → components → interfaces → risks → document
-     1    →    2    →    3     →     4      →     5      →   6   →    7
-                [gate]              [gate]                  [gate]
-```
-
-- Progressive disclosure stepped workflow
-- 7 steps with gates at context, components, and risks
-- **Type:** `stepped` (BikeLane)
-- **Triggers:** `types: [architecture, design, adr]`, `tags: [architecture, stepped]`
-
----
-
-## Workflow Routing Priority
-
-When multiple workflows match a story:
-
-1. **Explicit tag:** `workflow: docs` on story overrides everything
-2. **Trigger tags:** Story tags match workflow's `triggers.tags`
-3. **Type match:** Story type matches workflow's `triggers.types`
-4. **Points match:** Story points within `triggers.points` range
-5. **Default:** Workflow with `default: true` (tdd)
-
----
-
-## File Locations
-
-| Location | Purpose |
-|----------|---------|
-| `pennyfarthing-dist/workflows/` | Built-in workflow definitions |
-| `.session/{story-id}-session.md` | Current story's workflow assignment |
-
----
-
-## Quick Reference
-
-| Command | Script/Action |
-|---------|---------------|
-| `/workflow` | `list-workflows.sh` |
-| `/workflow list` | `list-workflows.sh` |
-| `/workflow show` | `show-workflow.sh` (current session) |
-| `/workflow show tdd` | `show-workflow.sh tdd` |
-| `/workflow set trivial` | Manual edit of session file |
-| `/workflow start architecture` | `start-workflow.sh architecture` |
-| `/workflow start architecture --mode validate` | `start-workflow.sh architecture --mode validate` |
-| `/workflow resume` | `resume-workflow.sh` |
-| `/workflow status` | `workflow-status.sh` |
-| `/workflow fix-phase 56-1 review` | `fix-session-phase.sh 56-1 review` |
-
----
-
-## Session Phase Repair
-
-### `/workflow fix-phase <story-id> <target-phase> [--dry-run]`
-
-Fix session file when handoffs didn't update phase tracking properly. This corrects the `**Phase:**` field and adds missing handoff history rows.
-
-**When to use:**
-- SM detects wrong phase after handoff
-- `workflow-status-check` shows stale state
-- Phase History table is incomplete
-
-**Run:**
-```bash
-.pennyfarthing/scripts/workflow/fix-session-phase.sh <story-id> <target-phase> [--dry-run]
-```
-
-**Arguments:**
-| Arg | Required | Description |
-|-----|----------|-------------|
-| `story-id` | Yes | Story ID (e.g., `56-1` or `MSSCI-12190`) |
-| `target-phase` | Yes | Target phase to set (e.g., `review`, `approved`, `finish`) |
-
-**Options:**
-| Option | Description |
-|--------|-------------|
-| `--dry-run` | Show what would be done without executing |
-
-**Examples:**
-```bash
-# Preview what would change
-.pennyfarthing/scripts/workflow/fix-session-phase.sh 56-1 review --dry-run
-
-# Fix phase to review (after Dev completed)
-.pennyfarthing/scripts/workflow/fix-session-phase.sh 56-1 review
-
-# Fix phase to approved (after Reviewer approved)
-.pennyfarthing/scripts/workflow/fix-session-phase.sh 56-1 approved
-
-# Using Jira key
-.pennyfarthing/scripts/workflow/fix-session-phase.sh MSSCI-12190 approved
-```
-
-**Valid phases by workflow:**
-| Workflow | Phase Sequence |
-|----------|----------------|
-| `tdd` | setup → red → green → review → approved → finish |
-| `trivial` | setup → impl → review → approved → finish |
-
-**What it updates:**
-1. `**Phase:**` field to target phase
-2. `**Phase Started:**` to current timestamp
-3. Handoff History table with missing transitions
-
----
-
-## Creating Custom Workflows
-
-See `pennyfarthing-dist/guides/workflow-schema.md` for the full YAML schema.
-
-Example documentation workflow:
-
-```yaml
-workflow:
-  name: docs
-  description: Documentation updates
-  version: "1.0.0"
-
-  phases:
-    - name: setup
-      agent: sm
-    - name: write
-      agent: tech-writer
-      output: [documentation]
-    - name: review
-      agent: reviewer
-      gate:
-        type: approval
-    - name: finish
-      agent: sm
-
-  triggers:
-    types: [docs]
-    tags: [documentation]
-```
-
----
-
-## BikeLane Documentation
-
-For comprehensive documentation on creating stepped workflows, see:
-
-- **[docs/BIKELANE.md](../../docs/BIKELANE.md)** - Full BikeLane user guide
-- **[docs/adr/0005-bmad-workflow-import.md](../../docs/adr/0005-bmad-workflow-import.md)** - Technical ADR
-- **[pennyfarthing-dist/workflows/architecture.yaml](../workflows/architecture.yaml)** - Example implementation