@pennyfarthing/core 11.1.1 → 11.2.1

package/pennyfarthing-dist/scripts/hooks/session-start.sh

@@ -1,33 +1,4 @@
 #!/usr/bin/env bash
-#
-# Session Start Hook - Shell wrapper for Python implementation
-#
-# Initializes environment for Claude Code session:
-# - Session directory setup and logging
-# - Checkpoint validation (cross-session drift)
-# - WheelHub auto-start
-# - OTEL auto-configuration
-#
-# Input (stdin): JSON with session_id, source, cwd, etc.
-# Output: Writes to CLAUDE_ENV_FILE
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
-source "$SCRIPT_DIR/../lib/find-root.sh"
-
-# Set PYTHONPATH for pennyfarthing_scripts
-PENNYFARTHING_SCRIPTS=""
-if [[ -d "$PROJECT_ROOT/pennyfarthing" ]]; then
-    # Dogfooding: framework inlined in orchestrator
-    PENNYFARTHING_SCRIPTS="$PROJECT_ROOT/pennyfarthing"
-elif [[ -d "$PROJECT_ROOT/node_modules/@pennyfarthing/core" ]]; then
-    # Normal install
-    PENNYFARTHING_SCRIPTS="$PROJECT_ROOT/node_modules/@pennyfarthing/core"
-fi
-
-if [[ -n "$PENNYFARTHING_SCRIPTS" ]]; then
-    export PYTHONPATH="$PENNYFARTHING_SCRIPTS:${PYTHONPATH:-}"
-fi
-
-python3 -m pennyfarthing_scripts.session_start_hook
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks session-start
+exec pf hooks session-start

package/pennyfarthing-dist/scripts/hooks/session-stop.sh

@@ -1,65 +1,4 @@
-#!/usr/bin/env zsh
-# Session stop hook: Save checkpoint for cross-session continuity
-# Called by Claude Code when a session ends
-#
-# Writes session state to checkpoint:
-#   - Active agent (from .session/agents/)
-#   - Current story (from .session/*-session.md)
-#   - Workflow phase (from session file)
-#   - Git SHA (current HEAD)
-#   - Session ID
-#
-# Next session can validate this against current git state.
-
-set -euo pipefail
-
-# Load shared functions
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-# Determine project root (directory containing .claude)
-PROJECT_ROOT="$SCRIPT_DIR"
-while [[ ! -d "$PROJECT_ROOT/.pennyfarthing" ]] && [[ "$PROJECT_ROOT" != "/" ]]; do
-    PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
-done
-
-source "$SCRIPT_DIR/../lib/checkpoint.sh"
-
-# Read input from stdin (contains session_id, source, etc.)
-input=$(cat)
-session_id=$(echo "$input" | jq -r '.session_id // "unknown"')
-
-# Get current agent for this session
-agent=""
-agent_file="$PROJECT_ROOT/.session/agents/$session_id"
-if [[ -f "$agent_file" ]]; then
-    agent=$(cat "$agent_file")
-fi
-
-# Find active story from session files
-story=""
-phase=""
-session_file=$(find "$PROJECT_ROOT/.session" -maxdepth 1 -name "*-session.md" -type f 2>/dev/null | head -1)
-if [[ -n "$session_file" && -f "$session_file" ]]; then
-    # Extract story ID from filename (e.g., 8-3-session.md -> 8-3)
-    story=$(basename "$session_file" | sed 's/-session\.md$//')
-
-    # Extract phase from session file (look for "Phase:" line)
-    phase=$(grep -i "^- Phase:" "$session_file" 2>/dev/null | head -1 | sed 's/.*Phase:[[:space:]]*//' | cut -d' ' -f1 || echo "")
-fi
-
-# Get current git SHA
-git_sha=""
-if command -v git &>/dev/null && git rev-parse --git-dir &>/dev/null; then
-    git_sha=$(git rev-parse --short HEAD 2>/dev/null || echo "")
-fi
-
-# Build checkpoint data (semicolon-separated key=value pairs)
-checkpoint_data="agent=${agent};story=${story};phase=${phase};sha=${git_sha};session=${session_id}"
-
-# Save checkpoint
-checkpoint_save "session_state" "$checkpoint_data"
-
-# Log session end
-echo "$(date -Iseconds) | Session end: $session_id (agent=$agent, story=$story)" >> "$PROJECT_ROOT/.session/session-log.txt"
-
-exit 0
+#!/usr/bin/env bash
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks session-stop
+exec pf hooks session-stop

package/pennyfarthing-dist/scripts/hooks/sprint-yaml-validation.sh

@@ -1,78 +1,4 @@
-#!/bin/bash
-#
-# Sprint YAML Validation Hook (PostToolUse)
-#
-# Validates sprint YAML files after Edit/Write operations to ensure
-# compatibility with the yaml npm package used by Cyclist's SprintPanel.
-#
-# The yaml npm package follows YAML 1.2 strictly and rejects:
-# - Single-quoted strings with blank lines
-# - Invalid multiline string formats
-#
-# When validation fails, returns additionalContext with an error message
-# prompting the agent to fix the YAML format.
-#
-# Input: JSON via stdin with tool_name, tool_input
-# Output: JSON with additionalContext on validation failure
-#
-# See also: pf sprint validate
-
-set -euo pipefail
-
-# Read hook input from stdin
-INPUT=$(cat)
-
-# Extract tool name and file path from input
-TOOL_NAME=$(echo "$INPUT" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"tool_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' || echo "")
-FILE_PATH=$(echo "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' || echo "")
-
-# Only process Edit and Write operations on sprint YAML files
-if [[ "$TOOL_NAME" != "Edit" && "$TOOL_NAME" != "Write" ]]; then
-  exit 0
-fi
-
-# Check if it's a sprint YAML file
-if [[ ! "$FILE_PATH" =~ sprint/.*\.(yaml|yml)$ ]]; then
-  exit 0
-fi
-
-# Check if the file exists
-if [[ ! -f "$FILE_PATH" ]]; then
-  exit 0
-fi
-
-# Validate using Node.js yaml package (same parser Cyclist uses)
-VALIDATION_ERROR=$(node --input-type=module -e "
-import { parse } from 'yaml';
-import { readFileSync } from 'fs';
-
-try {
-  const content = readFileSync('$FILE_PATH', 'utf-8');
-  parse(content);
-  process.exit(0);
-} catch (e) {
-  console.error(e.message);
-  process.exit(1);
-}
-" 2>&1) && VALID=true || VALID=false
-
-if [[ "$VALID" == "true" ]]; then
-  # Valid YAML - exit silently
-  exit 0
-fi
-
-# Validation failed - return error context to agent
-# Escape special characters for JSON
-ESCAPED_ERROR=$(echo "$VALIDATION_ERROR" | sed 's/\\/\\\\/g' | sed 's/"/\\"/g' | tr '\n' ' ')
-ESCAPED_PATH=$(echo "$FILE_PATH" | sed 's/\\/\\\\/g' | sed 's/"/\\"/g')
-
-cat << EOF
-{
-  "hookSpecificOutput": {
-    "hookEventName": "PostToolUse",
-    "additionalContext": "⚠️ SPRINT YAML VALIDATION FAILED\n\nFile: $ESCAPED_PATH\nError: $ESCAPED_ERROR\n\nThe sprint YAML file has invalid syntax that will break the Cyclist SprintPanel.\n\nCommon fix: Single-quoted strings cannot contain blank lines in YAML 1.2.\nUse literal block scalars (|) for multiline strings instead.\n\nTo auto-fix, run: yq eval -o=json '$ESCAPED_PATH' > /tmp/sprint.json && yq eval -P /tmp/sprint.json > '$ESCAPED_PATH'"
-  }
-}
-EOF
-
-exit 0
+#!/usr/bin/env bash
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks sprint-yaml
+exec pf hooks sprint-yaml

package/pennyfarthing-dist/scripts/hooks/welcome-hook.sh

@@ -1,94 +1,5 @@
 #!/usr/bin/env bash
-# Welcome Hook: Display a friendly welcome message on session start
-#
-# For CLI: Displays ASCII art of a penny-farthing bicycle
-# For Cyclist: Sends WebSocket message to display logo and welcome
-#
-# Called by Claude Code SessionStart hook
-
-set -euo pipefail
-
-# Read and discard stdin (required by hook protocol)
-cat > /dev/null
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$SCRIPT_DIR/../../.." && pwd)}"
-
-# Once-per-session guard: only show welcome on first invocation
-# Use session ID from environment or generate a unique one
-SESSION_ID="${CLAUDE_SESSION_ID:-$$}"
-WELCOME_LOCK="$PROJECT_ROOT/.session/.welcome-shown-$SESSION_ID"
-
-# Ensure .session directory exists
-mkdir -p "$PROJECT_ROOT/.session"
-
-# Check if welcome was already shown for this session
-if [[ -f "$WELCOME_LOCK" ]]; then
-    exit 0
-fi
-
-# Mark welcome as shown for this session
-touch "$WELCOME_LOCK"
-
-# Check if running in Cyclist (port file exists)
-PORT_FILE="$PROJECT_ROOT/.cyclist-port"
-IN_CYCLIST=false
-if [[ -f "$PORT_FILE" ]]; then
-    CYCLIST_PORT=$(cat "$PORT_FILE" 2>/dev/null)
-    if [[ "$CYCLIST_PORT" =~ ^[0-9]+$ ]]; then
-        IN_CYCLIST=true
-    fi
-fi
-
-# Get project name from package.json or directory name
-PROJECT_NAME=""
-if [[ -f "$PROJECT_ROOT/package.json" ]]; then
-    PROJECT_NAME=$(jq -r '.name // empty' "$PROJECT_ROOT/package.json" 2>/dev/null || echo "")
-fi
-if [[ -z "$PROJECT_NAME" ]]; then
-    PROJECT_NAME=$(basename "$PROJECT_ROOT")
-fi
-
-# Get current theme from config
-THEME=""
-if [[ -f "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" ]]; then
-    THEME=$(grep -E '^theme:' "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" 2>/dev/null | sed 's/theme:[[:space:]]*//' | tr -d '"' || echo "")
-fi
-
-if [[ "$IN_CYCLIST" == "true" ]]; then
-    # Send welcome message via WebSocket API for Cyclist to display
-    # Cyclist will show the pennyfarthing logo image and welcome text
-    curl -s -X POST "http://localhost:$CYCLIST_PORT/api/welcome" \
-        -H "Content-Type: application/json" \
-        -d "{\"project\": \"$PROJECT_NAME\", \"theme\": \"$THEME\"}" \
-        >/dev/null 2>&1 || true
-else
-    # CLI mode: Display ASCII art welcome
-    cat << 'EOF'
-
-       ___
-      /   \
-     |     |     Welcome to
-     |     |    ╔═══════════════════════════════════╗
-      \___/     ║   ╔═╗╔═╗╔╗╔╔╗╔╦═╗╔═╗╔═╗╔═╗╦╔═╗   ║
-        ║       ║   ╠═╝║╣ ║║║║║║ ╠╣ ╠═╣╠╦╝ ║ ╠═╣   ║
-        ║       ║   ╩  ╚═╝╝╚╝╝╚╝╩  ╩ ╩╩╚═ ╩ ╩ ╩   ║
-      ╔═╩═╗     ╚═══════════════════════════════════╝
-     /     \
-    │   O   │   Agent-powered development with style
-     \     /
-      ╚═══╝
-
-EOF
-
-    # Add project-specific info
-    if [[ -n "$PROJECT_NAME" ]]; then
-        echo "    Project: $PROJECT_NAME"
-    fi
-    if [[ -n "$THEME" ]]; then
-        echo "    Theme:   $THEME"
-    fi
-    echo ""
-fi
-
-exit 0
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Welcome is now part of session-start.
+# Use: pf hooks session-start
+exec pf hooks session-start

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

@@ -9,7 +9,7 @@ Uncategorized utilities and one-off scripts.
 | `deploy.sh` | Deployment script |
 | `doctor-dogfood.sh` | Health check for framework/orchestrator development setup |
 | `run-ci.sh` | Run CI locally |
-| `statusline.sh` | Status line configuration |
+| `pf hooks statusline` | Status line configuration |
 | `uninstall.sh` | Uninstall Pennyfarthing from project |
 | `backlog.sh` | Backlog operations |
 | `repo-utils.sh` | Multi-repo utilities |

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
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks statusline
+exec pf hooks statusline

package/pennyfarthing-dist/scripts/portraits/generate-tandem-portraits.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env zsh
+#
+# generate-tandem-portraits.sh — Generate per-theme tandem cyclist branding images
+#
+# Processes cyclist_tandem.png source into medium (200x200) and large (300x300)
+# versions for each theme's portrait directory.
+#
+# Usage: ./generate-tandem-portraits.sh [--source PATH] [--portraits-dir PATH]
+
+set -euo pipefail
+
+SCRIPT_DIR="${0:A:h}"
+# Source image lives alongside portraits in pennyfarthing-dist
+DIST_DIR="${SCRIPT_DIR}/../.."
+SOURCE_IMAGE="${DIST_DIR}/personas/portraits/cyclist-tandem-source.png"
+PORTRAITS_DIR=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --source) SOURCE_IMAGE="$2"; shift 2 ;;
+    --portraits-dir) PORTRAITS_DIR="$2"; shift 2 ;;
+    *) echo "Unknown option: $1"; exit 1 ;;
+  esac
+done
+
+# Auto-detect portraits directory if not provided
+if [[ -z "$PORTRAITS_DIR" ]]; then
+  PORTRAITS_DIR="${DIST_DIR}/personas/portraits"
+fi
+
+# Resolve to absolute path
+PORTRAITS_DIR="${PORTRAITS_DIR:A}"
+
+if [[ ! -f "$SOURCE_IMAGE" ]]; then
+  echo "Error: Source image not found: $SOURCE_IMAGE"
+  exit 1
+fi
+
+if [[ ! -d "$PORTRAITS_DIR" ]]; then
+  echo "Error: Portraits directory not found: $PORTRAITS_DIR"
+  exit 1
+fi
+
+# Verify ImageMagick is available
+if ! command -v magick &>/dev/null; then
+  echo "Error: ImageMagick (magick) not found in PATH"
+  exit 1
+fi
+
+echo "Source: $SOURCE_IMAGE"
+echo "Portraits: $PORTRAITS_DIR"
+echo ""
+
+generated=0
+skipped=0
+
+for theme_dir in "$PORTRAITS_DIR"/*/; do
+  theme_name="$(basename "$theme_dir")"
+
+  for size_name size_px in medium 200 large 300; do
+    size_dir="${theme_dir}${size_name}"
+    output="${size_dir}/cyclist-tandem.png"
+
+    # Create size directory if it doesn't exist
+    mkdir -p "$size_dir"
+
+    # Generate resized tandem portrait
+    magick "$SOURCE_IMAGE" -resize "${size_px}x${size_px}" -strip "$output"
+    generated=$((generated + 1))
+  done
+done
+
+echo ""
+echo "Generated: $generated tandem portraits"
+echo "Done."