@pennyfarthing/core 7.4.0 → 7.4.1

package/pennyfarthing-dist/scripts/misc/skill-usage-report.sh

@@ -0,0 +1,193 @@
+#!/usr/bin/env zsh
+# Generate skill usage reports from .session/skill-usage.log
+# Usage: skill-usage-report.sh [--weekly|--all] [--output FILE]
+#
+# Reads JSON Lines from .session/skill-usage.log and generates:
+#   - Invocation counts per skill
+#   - Most/least used skills
+#   - Unused skills (in registry but never invoked)
+#   - Weekly breakdown (optional)
+#
+# Environment:
+#   PROJECT_ROOT - Set by run.sh bootstrap (required)
+
+set -uo pipefail
+
+# --- Configuration ---
+SCRIPT_DIR="${0:A:h}"
+source "${SCRIPT_DIR}/common.sh" 2>/dev/null || true
+
+# --- Argument parsing ---
+REPORT_TYPE="all"
+OUTPUT_FILE=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --weekly)
+            REPORT_TYPE="weekly"
+            shift
+            ;;
+        --all)
+            REPORT_TYPE="all"
+            shift
+            ;;
+        --output)
+            OUTPUT_FILE="$2"
+            shift 2
+            ;;
+        -h|--help)
+            echo "Usage: skill-usage-report.sh [--weekly|--all] [--output FILE]"
+            echo ""
+            echo "Options:"
+            echo "  --weekly    Show only last 7 days of usage"
+            echo "  --all       Show all-time usage (default)"
+            echo "  --output    Write report to FILE instead of stdout"
+            exit 0
+            ;;
+        *)
+            echo "Unknown option: $1" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# --- Find project root ---
+if [[ -z "${PROJECT_ROOT:-}" ]]; then
+    dir="$PWD"
+    while [[ ! -d "$dir/.claude" ]] && [[ "$dir" != "/" ]]; do
+        dir="$(dirname "$dir")"
+    done
+    if [[ -d "$dir/.claude" ]]; then
+        PROJECT_ROOT="$dir"
+    else
+        echo "Error: Could not find project root" >&2
+        exit 1
+    fi
+fi
+
+SESSION_DIR="$PROJECT_ROOT/.session"
+LOG_FILE="$SESSION_DIR/skill-usage.log"
+REGISTRY_FILE="$PROJECT_ROOT/pennyfarthing-dist/skills/skill-registry.yaml"
+
+# --- Helper functions ---
+generate_report() {
+    local cutoff_date=""
+    local title=""
+
+    if [[ "$REPORT_TYPE" == "weekly" ]]; then
+        # Get date 7 days ago in ISO format
+        if [[ "$(uname)" == "Darwin" ]]; then
+            cutoff_date=$(date -v-7d -u +"%Y-%m-%dT%H:%M:%SZ")
+        else
+            cutoff_date=$(date -d '7 days ago' -u +"%Y-%m-%dT%H:%M:%SZ")
+        fi
+        title="Skill Usage Report (Last 7 Days)"
+    else
+        title="Skill Usage Report (All Time)"
+    fi
+
+    echo "# $title"
+    echo ""
+    echo "Generated: $(date -u +"%Y-%m-%d %H:%M UTC")"
+    echo ""
+
+    # Check if log file exists
+    if [[ ! -f "$LOG_FILE" ]]; then
+        echo "## No Usage Data"
+        echo ""
+        echo "No skill usage has been logged yet."
+        echo "Log file: \`$LOG_FILE\`"
+        return 0
+    fi
+
+    # Filter entries if weekly
+    local entries
+    if [[ -n "$cutoff_date" ]]; then
+        entries=$(jq -c "select(.ts >= \"$cutoff_date\")" "$LOG_FILE" 2>/dev/null || echo "")
+    else
+        entries=$(cat "$LOG_FILE")
+    fi
+
+    if [[ -z "$entries" ]]; then
+        echo "## No Usage Data"
+        echo ""
+        echo "No skill invocations found for the selected period."
+        return 0
+    fi
+
+    # Count invocations per skill
+    echo "## Usage by Skill"
+    echo ""
+    echo "| Skill | Invocations |"
+    echo "|-------|-------------|"
+
+    echo "$entries" | jq -r '.skill' | sort | uniq -c | sort -rn | while read count skill; do
+        echo "| $skill | $count |"
+    done
+
+    echo ""
+
+    # Usage by agent
+    echo "## Usage by Agent"
+    echo ""
+    echo "| Agent | Invocations |"
+    echo "|-------|-------------|"
+
+    echo "$entries" | jq -r '.agent' | sort | uniq -c | sort -rn | while read count agent; do
+        echo "| $agent | $count |"
+    done
+
+    echo ""
+
+    # Total stats
+    local total_count=$(echo "$entries" | wc -l | tr -d ' ')
+    local unique_skills=$(echo "$entries" | jq -r '.skill' | sort -u | wc -l | tr -d ' ')
+
+    echo "## Summary"
+    echo ""
+    echo "- **Total invocations:** $total_count"
+    echo "- **Unique skills used:** $unique_skills"
+
+    # Find unused skills
+    if [[ -f "$REGISTRY_FILE" ]]; then
+        echo ""
+        echo "## Unused Skills"
+        echo ""
+
+        # Get all skills from registry
+        local registry_skills=$(yq -r '.skills | keys | .[]' "$REGISTRY_FILE" 2>/dev/null || echo "")
+
+        # Get used skills
+        local used_skills=$(echo "$entries" | jq -r '.skill' | sort -u)
+
+        # Find unused
+        local unused=""
+        for skill in ${(f)registry_skills}; do
+            if ! echo "$used_skills" | grep -q "^${skill}$" 2>/dev/null; then
+                unused="$unused$skill\n"
+            fi
+        done
+
+        if [[ -n "$unused" ]]; then
+            echo "The following skills are in the registry but have not been invoked:"
+            echo ""
+            echo "$unused" | while read skill; do
+                [[ -n "$skill" ]] && echo "- \`$skill\`"
+            done
+        else
+            echo "All registered skills have been used!"
+        fi
+    fi
+
+    return 0
+}
+
+# --- Main ---
+if [[ -n "$OUTPUT_FILE" ]]; then
+    generate_report > "$OUTPUT_FILE"
+    echo "Report written to: $OUTPUT_FILE"
+else
+    generate_report
+fi
+
+exit 0

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

@@ -0,0 +1,259 @@
+#!/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 "?")
+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" ;;
+        *)           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 for current agent
+config_file=""
+if [ -f "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" ]; then
+    config_file="$PROJECT_ROOT/.pennyfarthing/config.local.yaml"
+elif [ -f "$PROJECT_ROOT/.claude/persona-config.yaml" ]; then
+    config_file="$PROJECT_ROOT/.claude/persona-config.yaml"
+fi
+
+character_display=""
+if [ -n "$config_file" ]; then
+    theme=$(yq '.theme' "$config_file" 2>/dev/null)
+    if [ -n "$theme" ] && [ "$theme" != "null" ] && [ -n "$agent_name" ]; then
+        # Find theme file (same resolution as agent-session.sh)
+        theme_file=""
+        if [ -f "$PROJECT_ROOT/.claude/pennyfarthing/themes/${theme}.yaml" ]; then
+            theme_file="$PROJECT_ROOT/.claude/pennyfarthing/themes/${theme}.yaml"
+        elif [ -f "$PROJECT_ROOT/.pennyfarthing/personas/themes/${theme}.yaml" ]; then
+            theme_file="$PROJECT_ROOT/.pennyfarthing/personas/themes/${theme}.yaml"
+        elif [ -f "$PROJECT_ROOT/personas/themes/${theme}.yaml" ]; then
+            theme_file="$PROJECT_ROOT/personas/themes/${theme}.yaml"
+        fi
+
+        if [ -n "$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
+    fi
+    # Fallback to theme name if no character found
+    if [ -z "$character_display" ] && [ -n "$theme" ] && [ "$theme" != "null" ]; then
+        character_display="$(echo "${theme:0:1}" | tr '[:lower:]' '[:upper:]')${theme:1}"
+    fi
+fi
+theme_display="$character_display"
+
+# 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
+        *)          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 agent display: [ROLE] Theme (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}"
+        # Pad to ~20 chars visual width (abbrev ~3 + spaces ~2 + theme ~10 = ~15, pad to 20)
+        pad_len=$((18 - ${#agent_abbrev} - ${#theme_display}))
+        [ "$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}"
+        pad_len=$((17 - ${#agent_abbrev}))
+        [ "$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}"
+        pad_len=$((20 - ${#theme_display}))
+        [ "$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}"