@pennyfarthing/core 11.2.0 → 11.2.2

package/pennyfarthing-dist/scripts/misc/statusline.sh

@@ -1,301 +1,4 @@
-#!/usr/bin/env zsh
-# Claude Code statusline - fixed-width segments
-# Format: [ROLE] Theme | repo | branch | model [progress] pct%
-
-input=$(cat)
-
-# Validate JSON
-if ! echo "$input" | jq -e . >/dev/null 2>&1; then
-    echo "⚠ invalid input"
-    exit 0
-fi
-
-# Extract fields - use cwd for display only, PROJECT_ROOT for file lookups
-cwd=$(echo "$input" | jq -r '.workspace.current_dir // empty' 2>/dev/null)
-dir_name=$(basename "$cwd" 2>/dev/null || echo "?")
-PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$cwd}"
-session_id=$(echo "$input" | jq -r '.session_id // empty' 2>/dev/null)
-
-# Model name - clean up
-model=$(echo "$input" | jq -r '
-  if .model | type == "object" then .model.id // .model.name // "claude"
-  elif .model | type == "string" then .model
-  else "claude"
-  end
-' 2>/dev/null)
-[ -z "$model" ] || [ "$model" = "null" ] && model="claude"
-model=$(echo "$model" | sed 's/claude-//' | sed 's/-[0-9]*$//' | cut -c1-10)
-
-# Git branch
-branch=""
-branch_dirty=""
-if git -C "$cwd" rev-parse --git-dir > /dev/null 2>&1; then
-    branch=$(git -C "$cwd" branch --show-current 2>/dev/null)
-    [ -z "$branch" ] && branch=$(git -C "$cwd" rev-parse --short HEAD 2>/dev/null)
-
-    # Check if dirty using diff-index (doesn't lock the index like status does)
-    # This avoids "index.lock: File exists" errors when multiple Claude sessions
-    # run concurrent statusline updates during git operations
-    if ! git -C "$cwd" diff-index --quiet HEAD -- 2>/dev/null || \
-       [ -n "$(git -C "$cwd" ls-files --others --exclude-standard 2>/dev/null | head -1)" ]; then
-        branch_dirty="*"
-    fi
-fi
-
-# Context percentage
-pct="--"
-usage=$(echo "$input" | jq '.context_window.current_usage // empty' 2>/dev/null)
-if [ -n "$usage" ] && [ "$usage" != "null" ]; then
-    current=$(echo "$usage" | jq '.input_tokens + .cache_creation_input_tokens + .cache_read_input_tokens' 2>/dev/null)
-    size=$(echo "$input" | jq '.context_window.context_window_size // 0' 2>/dev/null)
-    if [ -n "$current" ] && [ "$current" != "null" ] && [ -n "$size" ] && [ "$size" != "null" ] && [ "$size" -gt 0 ] 2>/dev/null; then
-        pct=$((current * 100 / size))
-    fi
-fi
-
-# Agent abbreviation map
-get_agent_abbrev() {
-    case "$1" in
-        pm)          echo "PM" ;;
-        sm)          echo "SM" ;;
-        dev)         echo "DEV" ;;
-        tea)         echo "TEA" ;;
-        reviewer)    echo "REV" ;;
-        architect)   echo "ARC" ;;
-        devops)      echo "OPS" ;;
-        ux-designer) echo "UX" ;;
-        tech-writer) echo "DOC" ;;
-        orchestrator) echo "ORC" ;;
-        ba)          echo "BA" ;;
-        *)           echo "???" ;;
-    esac
-}
-
-# Agent and theme from session
-agent_name=""
-agent_abbrev=""
-theme_display=""
-
-# Try session_id match first, then fall back to most recent agent file
-if [ -n "$session_id" ] && [ -f "$PROJECT_ROOT/.session/agents/${session_id}" ]; then
-    # Exact session match (ideal case)
-    agent_name=$(cat "$PROJECT_ROOT/.session/agents/${session_id}")
-    agent_abbrev=$(get_agent_abbrev "$agent_name")
-elif [ -d "$PROJECT_ROOT/.session/agents" ]; then
-    # Fallback: use most recently modified agent file
-    # This handles the session_id mismatch between hooks
-    latest_file=$(ls -t "$PROJECT_ROOT/.session/agents/" 2>/dev/null | head -1)
-    if [ -n "$latest_file" ] && [ -f "$PROJECT_ROOT/.session/agents/$latest_file" ]; then
-        agent_name=$(cat "$PROJECT_ROOT/.session/agents/$latest_file")
-        agent_abbrev=$(get_agent_abbrev "$agent_name")
-    fi
-fi
-
-# Get character name from theme file (single source of truth)
-# Priority: .pennyfarthing/config.local.yaml > .pennyfarthing/persona-config.yaml
-config_file=""
-if [ -f "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" ]; then
-    config_file="$PROJECT_ROOT/.pennyfarthing/config.local.yaml"
-elif [ -f "$PROJECT_ROOT/.pennyfarthing/persona-config.yaml" ]; then
-    config_file="$PROJECT_ROOT/.pennyfarthing/persona-config.yaml"
-fi
-
-character_display=""
-if [ -n "$config_file" ] && [ -n "$agent_name" ]; then
-    # Get theme name from config
-    theme=$(yq '.theme' "$config_file" 2>/dev/null)
-
-    if [ -n "$theme" ] && [ "$theme" != "null" ]; then
-        # Read character directly from theme file (matches agent-session.sh behavior)
-        theme_file="$PROJECT_ROOT/.pennyfarthing/personas/themes/${theme}.yaml"
-        if [ -f "$theme_file" ]; then
-            full_name=$(yq ".agents.${agent_name}.character" "$theme_file" 2>/dev/null)
-
-            if [ -n "$full_name" ] && [ "$full_name" != "null" ]; then
-                # Smart character name extraction:
-                # 1. Remove parenthetical content: "Breq (Justice of Toren)" → "Breq"
-                # 2. Strip common titles: "Captain Kirk" → "Kirk"
-                # 3. If single word remains, use it; otherwise take last word
-                clean_name=$(echo "$full_name" | sed 's/ *([^)]*)//g' | xargs)
-                clean_name=$(echo "$clean_name" | sed -E 's/^(Captain|Lieutenant|Dr\.|Doc|Mr\.|Mrs\.|Ms\.|Admiral|Commander|Chief|Ensign|Translator|Agent|Colonel|Major|Sergeant|Professor|Lord|Lady|Sir|The) +//i')
-                word_count=$(echo "$clean_name" | wc -w | tr -d ' ')
-                if [ "$word_count" -eq 1 ]; then
-                    character_display="$clean_name"
-                else
-                    character_display=$(echo "$clean_name" | awk '{print $NF}')
-                fi
-            fi
-        fi
-
-        # Fallback to theme name if no character found
-        if [ -z "$character_display" ]; then
-            character_display="$(echo "${theme:0:1}" | tr '[:lower:]' '[:upper:]')${theme:1}"
-        fi
-    fi
-fi
-theme_display="$character_display"
-
-# Tandem indicator: detect active backseat agent from observation files
-# Files: .session/{storyId}-tandem-{partner}.md (created by backseat spawn, cleaned on finish)
-tandem_partner=""
-tandem_partner_display=""
-if [ -d "$PROJECT_ROOT/.session" ]; then
-    tandem_file=$(find "$PROJECT_ROOT/.session" -maxdepth 1 -name "*-tandem-*.md" -print 2>/dev/null | head -1)
-    if [ -n "$tandem_file" ]; then
-        # Extract partner name from filename: {storyId}-tandem-{partner}.md
-        tandem_partner=$(basename "$tandem_file" | sed -n 's/.*-tandem-\([a-zA-Z_-]*\)\.md$/\1/p')
-        if [ -n "$tandem_partner" ] && [ -n "$theme_file" ] && [ -f "$theme_file" ]; then
-            # Look up partner's character name from theme
-            partner_full=$(yq ".agents.${tandem_partner}.character" "$theme_file" 2>/dev/null)
-            if [ -n "$partner_full" ] && [ "$partner_full" != "null" ]; then
-                partner_clean=$(echo "$partner_full" | sed 's/ *([^)]*)//g' | xargs)
-                partner_clean=$(echo "$partner_clean" | sed -E 's/^(Captain|Lieutenant|Dr\.|Doc|Mr\.|Mrs\.|Ms\.|Admiral|Commander|Chief|Ensign|Translator|Agent|Colonel|Major|Sergeant|Professor|Lord|Lady|Sir|The) +//i')
-                partner_wc=$(echo "$partner_clean" | wc -w | tr -d ' ')
-                if [ "$partner_wc" -eq 1 ]; then
-                    tandem_partner_display="$partner_clean"
-                else
-                    tandem_partner_display=$(echo "$partner_clean" | awk '{print $NF}')
-                fi
-            fi
-            # Fallback to agent abbreviation if no theme character
-            if [ -z "$tandem_partner_display" ]; then
-                tandem_partner_display=$(get_agent_abbrev "$tandem_partner")
-            fi
-        elif [ -n "$tandem_partner" ]; then
-            # No theme file — use abbreviation
-            tandem_partner_display=$(get_agent_abbrev "$tandem_partner")
-        fi
-    fi
-fi
-
-# ANSI colors
-RESET=$'\033[0m'
-DIM=$'\033[2m'
-BOLD=$'\033[1m'
-REVERSE=$'\033[7m'
-FG_CYAN=$'\033[36m'
-FG_GREEN=$'\033[32m'
-FG_YELLOW=$'\033[33m'
-FG_RED=$'\033[31m'
-FG_MAGENTA=$'\033[35m'
-FG_BLUE=$'\033[34m'
-FG_WHITE=$'\033[97m'
-FG_GRAY=$'\033[38;5;245m'
-FG_ORANGE=$'\033[38;5;208m'
-FG_PINK=$'\033[38;5;213m'
-FG_TEAL=$'\033[38;5;43m'
-FG_PURPLE=$'\033[38;5;141m'
-FG_LIME=$'\033[38;5;154m'
-
-# Agent color map
-get_agent_color() {
-    case "$1" in
-        pm)         echo "${FG_PURPLE}${BOLD}" ;;   # Purple - strategic
-        sm)         echo "${FG_BLUE}${BOLD}" ;;     # Blue - coordination
-        dev)        echo "${FG_GREEN}${BOLD}" ;;    # Green - building
-        tea)        echo "${FG_TEAL}${BOLD}" ;;     # Teal - testing
-        reviewer)   echo "${FG_RED}${BOLD}" ;;      # Red - critical eye
-        architect)  echo "${FG_ORANGE}${BOLD}" ;;   # Orange - design
-        devops)     echo "${FG_CYAN}${BOLD}" ;;     # Cyan - infrastructure
-        ux-designer) echo "${FG_PINK}${BOLD}" ;;    # Pink - design
-        tech-writer) echo "${FG_WHITE}${BOLD}" ;;   # White - documentation
-        orchestrator) echo "${FG_MAGENTA}${BOLD}" ;;# Magenta - coordination
-        ba)         echo "${FG_LIME}${BOLD}" ;;     # Lime - discovery
-        *)          echo "${FG_MAGENTA}${BOLD}" ;;  # Default
-    esac
-}
-
-# Build progress bar (10 segments)
-bar_width=10
-if [ "$pct" != "--" ]; then
-    filled=$((pct * bar_width / 100))
-    [ "$filled" -gt "$bar_width" ] && filled=$bar_width
-    [ "$filled" -lt 0 ] && filled=0
-
-    # Color based on level
-    if [ "$pct" -gt 95 ]; then
-        bar_color="${FG_RED}${BOLD}"
-    elif [ "$pct" -gt 85 ]; then
-        bar_color="${FG_RED}"
-    elif [ "$pct" -gt 70 ]; then
-        bar_color="${FG_YELLOW}"
-    else
-        bar_color="${FG_GREEN}"
-    fi
-
-    # Build bar: filled portion with ▓, empty with ░
-    bar_filled=""
-    bar_empty=""
-    for ((i=0; i<filled; i++)); do bar_filled+="▓"; done
-    for ((i=filled; i<bar_width; i++)); do bar_empty+="░"; done
-
-    progress_bar="${bar_color}${bar_filled}${RESET}${DIM}${bar_empty}${RESET}"
-    pct_display="${bar_color}${pct}%${RESET}"
-else
-    progress_bar="${DIM}░░░░░░░░░░${RESET}"
-    pct_display="${FG_GRAY}--%${RESET}"
-fi
-
-# Branch color (yellow if dirty, green if clean)
-if [ -n "$branch_dirty" ]; then
-    branch_color="${FG_YELLOW}"
-else
-    branch_color="${FG_GREEN}"
-fi
-
-# Fixed-width formatting using printf
-# Agent+Theme: ~20 chars, Repo: 14 chars, Branch: 12 chars, Model: 10 chars
-repo_fmt=$(printf "%-14s" "$dir_name")
-branch_fmt=$(printf "%-12s" "${branch}${branch_dirty}")
-model_fmt=$(printf "%-10s" "$model")
-
-# Build tandem suffix: "+ Partner" when backseat agent is active
-tandem_suffix=""
-tandem_suffix_len=0
-if [ -n "$tandem_partner_display" ]; then
-    partner_color=$(get_agent_color "$tandem_partner")
-    tandem_suffix=" ${DIM}+${RESET} ${partner_color}${tandem_partner_display}${RESET}"
-    tandem_suffix_len=$((3 + ${#tandem_partner_display}))  # " + " + name
-fi
-
-# Build agent display: [ROLE] Theme (+ Partner) (role in reverse text with color)
-if [ -n "$agent_abbrev" ]; then
-    agent_color=$(get_agent_color "$agent_name")
-    # Role in reverse text with color, then theme
-    if [ -n "$theme_display" ]; then
-        agent_section="${agent_color}${REVERSE} ${agent_abbrev} ${RESET} ${DIM}${theme_display}${RESET}${tandem_suffix}"
-        # Pad to ~20 chars visual width (abbrev ~3 + spaces ~2 + theme ~10 + tandem = ~15+, pad to 20)
-        pad_len=$((18 - ${#agent_abbrev} - ${#theme_display} - tandem_suffix_len))
-        [ "$pad_len" -lt 0 ] && pad_len=0
-        padding=$(printf "%${pad_len}s" "")
-        agent_section="${agent_section}${padding}"
-    else
-        agent_section="${agent_color}${REVERSE} ${agent_abbrev} ${RESET}${tandem_suffix}"
-        pad_len=$((17 - ${#agent_abbrev} - tandem_suffix_len))
-        [ "$pad_len" -lt 0 ] && pad_len=0
-        padding=$(printf "%${pad_len}s" "")
-        agent_section="${agent_section}${padding}"
-    fi
-else
-    # No agent - just show theme if available
-    if [ -n "$theme_display" ]; then
-        agent_section="${DIM}${theme_display}${RESET}${tandem_suffix}"
-        pad_len=$((20 - ${#theme_display} - tandem_suffix_len))
-        [ "$pad_len" -lt 0 ] && pad_len=0
-        padding=$(printf "%${pad_len}s" "")
-        agent_section="${agent_section}${padding}"
-    else
-        agent_section=$(printf "%-20s" "")
-    fi
-fi
-
-# Build output: [ROLE] Theme | repo | branch | model [progress] pct%
-echo -n "${agent_section}"
-echo -n "${DIM}│${RESET} "
-echo -n "${FG_CYAN}${repo_fmt}${RESET}"
-echo -n "${DIM}│${RESET} "
-echo -n "${branch_color}${branch_fmt}${RESET}"
-echo -n "${DIM}│${RESET} "
-echo -n "${FG_GRAY}${model_fmt}${RESET}"
-echo -n "${progress_bar} "
-echo -n "${pct_display}"
+#!/usr/bin/env bash
+# Shim: delegates to Python CLI via uv run — no global pf install needed.
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf hooks statusline

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

@@ -1,35 +1,35 @@
 # Sprint Scripts
 
-Sprint management is handled by the Python CLI: `pf sprint [COMMAND]`.
+Sprint management is handled by the Python CLI: `pf.sh sprint [COMMAND]`.
 
 ## Commands
 
 | Command | Purpose |
 |---------|---------|
-| `pf sprint status` | Show current sprint status and metrics |
-| `pf sprint backlog` | List available stories grouped by epic |
-| `pf sprint info` | Sprint info as JSON (for Cyclist sidebar) |
-| `pf sprint metrics` | Sprint velocity and progress metrics |
-| `pf sprint check <id>` | Check story/epic availability (JSON) |
-| `pf sprint future` | Show future initiatives and epics |
-| `pf sprint new` | Initialize a new sprint |
-| `pf sprint validate <file>` | Validate sprint YAML structure |
-| `pf sprint archive <id>` | Archive a completed story |
-| `pf sprint work <id>` | Start work on a story |
-| `pf sprint story field <id> <field>` | Get a story field value |
-| `pf sprint epic field <id> <field>` | Get an epic field value |
-| `pf sprint epic promote <id>` | Move epic from future to current sprint |
-| `pf sprint epic show <id>` | Show epic details |
-| `pf sprint epic cancel <id>` | Cancel an epic |
-| `pf sprint epic archive` | Archive completed epics |
+| `pf.sh sprint status` | Show current sprint status and metrics |
+| `pf.sh sprint backlog` | List available stories grouped by epic |
+| `pf.sh sprint info` | Sprint info as JSON (for Cyclist sidebar) |
+| `pf.sh sprint metrics` | Sprint velocity and progress metrics |
+| `pf.sh sprint check <id>` | Check story/epic availability (JSON) |
+| `pf.sh sprint future` | Show future initiatives and epics |
+| `pf.sh sprint new` | Initialize a new sprint |
+| `pf.sh sprint validate <file>` | Validate sprint YAML structure |
+| `pf.sh sprint archive <id>` | Archive a completed story |
+| `pf.sh sprint work <id>` | Start work on a story |
+| `pf.sh sprint story field <id> <field>` | Get a story field value |
+| `pf.sh sprint epic field <id> <field>` | Get an epic field value |
+| `pf.sh sprint epic promote <id>` | Move epic from future to current sprint |
+| `pf.sh sprint epic show <id>` | Show epic details |
+| `pf.sh sprint epic cancel <id>` | Cancel an epic |
+| `pf.sh sprint epic archive` | Archive completed epics |
 
 ## Usage
 
 ```bash
-pf sprint status
-pf sprint backlog
-pf sprint future epic-55
-pf sprint epic promote epic-41
+pf.sh sprint status
+pf.sh sprint backlog
+pf.sh sprint future epic-55
+pf.sh sprint epic promote epic-41
 ```
 
 ## Ownership

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

@@ -6,7 +6,7 @@ Scripts for workflow mechanics, phase transitions, and quality gates.
 
 | Script | Purpose |
 |--------|---------|
-| `finish-story.sh` | **DEPRECATED** — forwards to `pf sprint story finish` |
+| `finish-story.sh` | **DEPRECATED** — forwards to `pf.sh sprint story finish` |
 | `fix-session-phase.sh` | Repair session file phase state |
 | `check.sh` | Quality gates runner (lint, type check, tests) |
 | `list-workflows.sh` | List available workflows |
@@ -18,7 +18,7 @@ Scripts for workflow mechanics, phase transitions, and quality gates.
 ## Usage
 
 ```bash
-pf sprint story finish MSSCI-12345
+pf.sh sprint story finish MSSCI-12345
 .pennyfarthing/scripts/workflow/start-workflow.sh prd --mode create
 ```
 

package/pennyfarthing-dist/scripts/workflow/finish-story.sh

@@ -1,20 +1,6 @@
 #!/bin/bash
 # DEPRECATED: Use `pf sprint story finish` instead.
-#
-# This shell script had a bug where yq paths targeted .epics[].stories[]
-# but the sprint YAML uses sharded epic files with .stories[] at root.
-# The Python implementation (pennyfarthing_scripts.sprint.story_finish)
-# correctly handles sharded YAML via read_sprint/write_sprint.
-#
-# Usage: finish-story.sh <story-id> [--dry-run]
-
 set -euo pipefail
-
 echo "DEPRECATED: finish-story.sh is deprecated. Forwarding to 'pf sprint story finish'." >&2
-
-ARGS=()
-for arg in "$@"; do
-  ARGS+=("$arg")
-done
-
-exec pf sprint story finish "${ARGS[@]}"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf sprint story finish "$@"

package/pennyfarthing-dist/scripts/workflow/fix-session-phase.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow fix-phase` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: fix-session-phase.sh is deprecated. Use: pf workflow fix-phase $*" >&2
-exec pf workflow fix-phase "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow fix-phase "$@"

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

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow type` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: get-workflow-type.sh is deprecated. Use: pf workflow type $*" >&2
-exec pf workflow type "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow type "$@"

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

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow list` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: list-workflows.sh is deprecated. Use: pf workflow list" >&2
-exec pf workflow list "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow list "$@"

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

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow phase-check` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: phase-owner.sh is deprecated. Use: pf workflow phase-check $*" >&2
-exec pf workflow phase-check "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow phase-check "$@"

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

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # 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 "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow resume "$@"

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

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # 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 "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow show "$@"

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

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # 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 "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow start "$@"

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

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow status` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: workflow-status.sh is deprecated. Use: pf workflow status $*" >&2
-exec pf workflow status "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow status "$@"

package/pennyfarthing-dist/skills/pf-bc/examples.md

@@ -4,80 +4,80 @@
 
 ```bash
 # Focus on Sprint panel
-pf bc sprint
+pf.sh bc sprint
 
 # Focus on Diffs panel
-pf bc diffs
+pf.sh bc diffs
 
 # Focus on Acceptance Criteria
-pf bc ac
+pf.sh bc ac
 
 # Focus on Git panel
-pf bc git
+pf.sh bc git
 
 # Preview without changing
-pf bc sprint --dry-run
+pf.sh bc sprint --dry-run
 ```
 
 ## Clearing Focus
 
 ```bash
 # Remove focus setting
-pf bc reset
+pf.sh bc reset
 
 # Preview
-pf bc reset --dry-run
+pf.sh bc reset --dry-run
 ```
 
 ## Named Layouts
 
 ```bash
 # Save current layout as "normal"
-pf bc save normal
+pf.sh bc save normal
 
 # Save current layout as "review"
-pf bc save review
+pf.sh bc save review
 
 # Save current layout as "debug"
-pf bc save debug
+pf.sh bc save debug
 
 # List all saved layouts
-pf bc list
+pf.sh bc list
 
 # Switch to review layout
-pf bc load review
+pf.sh bc load review
 
 # Switch back to normal
-pf bc load normal
+pf.sh bc load normal
 
 # Delete a specific layout
-pf bc clear review
+pf.sh bc clear review
 
 # Delete all layouts
-pf bc clear-all
+pf.sh bc clear-all
 ```
 
 ## Common Workflows
 
 ### During code review
 ```bash
-pf bc save normal          # Save current layout first
-pf bc diffs                # Focus on diffs
+pf.sh bc save normal          # Save current layout first
+pf.sh bc diffs                # Focus on diffs
 # ... do review ...
-pf bc load normal          # Restore normal layout
+pf.sh bc load normal          # Restore normal layout
 ```
 
 ### Debugging session
 ```bash
-pf bc save normal
-pf bc debug                # Focus debug panel
+pf.sh bc save normal
+pf.sh bc debug                # Focus debug panel
 # ... debug ...
-pf bc reset                # Clear focus
+pf.sh bc reset                # Clear focus
 ```
 
 ### Sprint planning
 ```bash
-pf bc sprint               # Focus sprint panel
+pf.sh bc sprint               # Focus sprint panel
 # ... review backlog ...
-pf bc reset
+pf.sh bc reset
 ```

package/pennyfarthing-dist/skills/pf-bc/skill.md

@@ -16,28 +16,28 @@ Set or clear the focused panel in Cyclist/BikeRack. Save and restore named layou
 
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/bc sprint` | `pf bc sprint [--dry-run]` | Focus Sprint panel |
-| `/bc git` | `pf bc git [--dry-run]` | Focus Git panel |
-| `/bc diffs` | `pf bc diffs [--dry-run]` | Focus Diffs panel |
-| `/bc todo` | `pf bc todo [--dry-run]` | Focus Todo panel |
-| `/bc workflow` | `pf bc workflow [--dry-run]` | Focus Workflow panel |
-| `/bc background` | `pf bc background [--dry-run]` | Focus Background panel |
-| `/bc audit-log` | `pf bc audit-log [--dry-run]` | Focus Audit Log panel |
-| `/bc changed` | `pf bc changed [--dry-run]` | Focus Changed panel |
-| `/bc ac` | `pf bc ac [--dry-run]` | Focus Acceptance Criteria panel |
-| `/bc debug` | `pf bc debug [--dry-run]` | Focus Debug panel |
-| `/bc settings` | `pf bc settings [--dry-run]` | Focus Settings panel |
-| `/bc reset` | `pf bc reset [--dry-run]` | Clear focus setting |
+| `/bc sprint` | `pf.sh bc sprint [--dry-run]` | Focus Sprint panel |
+| `/bc git` | `pf.sh bc git [--dry-run]` | Focus Git panel |
+| `/bc diffs` | `pf.sh bc diffs [--dry-run]` | Focus Diffs panel |
+| `/bc todo` | `pf.sh bc todo [--dry-run]` | Focus Todo panel |
+| `/bc workflow` | `pf.sh bc workflow [--dry-run]` | Focus Workflow panel |
+| `/bc background` | `pf.sh bc background [--dry-run]` | Focus Background panel |
+| `/bc audit-log` | `pf.sh bc audit-log [--dry-run]` | Focus Audit Log panel |
+| `/bc changed` | `pf.sh bc changed [--dry-run]` | Focus Changed panel |
+| `/bc ac` | `pf.sh bc ac [--dry-run]` | Focus Acceptance Criteria panel |
+| `/bc debug` | `pf.sh bc debug [--dry-run]` | Focus Debug panel |
+| `/bc settings` | `pf.sh bc settings [--dry-run]` | Focus Settings panel |
+| `/bc reset` | `pf.sh bc reset [--dry-run]` | Clear focus setting |
 
 ### Named Layouts
 
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/bc save <name>` | `pf bc save <name> [--dry-run]` | Save current layout from running server |
-| `/bc load <name>` | `pf bc load <name> [--dry-run]` | Load a saved layout |
-| `/bc list` | `pf bc list` | List all saved layouts |
-| `/bc clear <name>` | `pf bc clear <name> [--dry-run]` | Delete a saved layout |
-| `/bc clear-all` | `pf bc clear-all [--dry-run]` | Delete all saved layouts |
+| `/bc save <name>` | `pf.sh bc save <name> [--dry-run]` | Save current layout from running server |
+| `/bc load <name>` | `pf.sh bc load <name> [--dry-run]` | Load a saved layout |
+| `/bc list` | `pf.sh bc list` | List all saved layouts |
+| `/bc clear <name>` | `pf.sh bc clear <name> [--dry-run]` | Delete a saved layout |
+| `/bc clear-all` | `pf.sh bc clear-all [--dry-run]` | Delete all saved layouts |
 
 ### Notes