@pennyfarthing/core 6.6.0

package/pennyfarthing-dist/scripts/utils/find-related-work.sh

@@ -0,0 +1,231 @@
+#!/usr/bin/env zsh
+# Find related archived work sessions for context
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Usage
+usage() {
+    cat <<EOF
+Usage: $0 [OPTIONS] <search-term>
+
+Find related archived work sessions for context.
+
+OPTIONS:
+    -e, --epic EPIC_NUM    Find all stories in this epic (e.g., 35)
+    -s, --story STORY_ID   Find specific story (e.g., 35-6)
+    -k, --keyword TERM     Search by keyword in archived sessions
+    -l, --list             List all archived sessions
+    --summaries-only       Show only context summaries, not full sessions
+    -h, --help             Show this help
+
+EXAMPLES:
+    # Find all work related to epic 35
+    $0 --epic 35
+
+    # Find specific story
+    $0 --story 35-6
+
+    # Search for keyword
+    $0 --keyword "topology editor"
+
+    # List all archived work
+    $0 --list
+
+    # Show only lightweight summaries
+    $0 --epic 35 --summaries-only
+EOF
+}
+
+# Parse arguments
+EPIC=""
+STORY=""
+KEYWORD=""
+LIST_ALL=false
+SUMMARIES_ONLY=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -e|--epic)
+            EPIC="$2"
+            shift 2
+            ;;
+        -s|--story)
+            STORY="$2"
+            shift 2
+            ;;
+        -k|--keyword)
+            KEYWORD="$2"
+            shift 2
+            ;;
+        -l|--list)
+            LIST_ALL=true
+            shift
+            ;;
+        --summaries-only)
+            SUMMARIES_ONLY=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        *)
+            echo "Unknown option: $1"
+            usage
+            exit 1
+            ;;
+    esac
+done
+
+# Directories
+ARCHIVE_DIR="$PROJECT_ROOT/sprint/archive"
+CONTEXT_DIR="$PROJECT_ROOT/sprint/context"
+
+# Ensure directories exist
+mkdir -p "$ARCHIVE_DIR" "$CONTEXT_DIR"
+
+# Colors for output
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# List all archived sessions
+if [ "$LIST_ALL" = true ]; then
+    echo -e "${BLUE}=== Archived Work Sessions ===${NC}"
+    echo ""
+
+    if [ "$SUMMARIES_ONLY" = true ]; then
+        # List summaries
+        if [ -d "$CONTEXT_DIR" ]; then
+            for file in "$CONTEXT_DIR"/*-summary.md; do
+                [ -e "$file" ] || continue
+                basename "$file"
+            done
+        else
+            echo "No context summaries found."
+        fi
+    else
+        # List full sessions
+        for file in "$ARCHIVE_DIR"/*.md; do
+            [ -e "$file" ] || continue
+            basename "$file"
+        done
+    fi
+    exit 0
+fi
+
+# Search by epic
+if [ -n "$EPIC" ]; then
+    echo -e "${BLUE}=== Stories in Epic $EPIC ===${NC}"
+    echo ""
+
+    if [ "$SUMMARIES_ONLY" = true ]; then
+        # Search summaries
+        SUMMARY_FILE="$CONTEXT_DIR/epic-$EPIC-summary.md"
+        if [ -f "$SUMMARY_FILE" ]; then
+            echo -e "${GREEN}Found epic summary:${NC} $SUMMARY_FILE"
+            echo ""
+            cat "$SUMMARY_FILE"
+        else
+            echo "No summary found for epic $EPIC"
+            echo "Searching full archive..."
+            grep -l "epic-$EPIC\|Epic $EPIC\|$EPIC-[0-9]" "$ARCHIVE_DIR"/*.md 2>/dev/null || echo "No archived work found for epic $EPIC"
+        fi
+    else
+        # Search full sessions
+        MATCHES=$(grep -l "epic-$EPIC\|Epic $EPIC\|$EPIC-[0-9]" "$ARCHIVE_DIR"/*.md 2>/dev/null || true)
+
+        if [ -n "$MATCHES" ]; then
+            echo "$MATCHES" | while read -r file; do
+                echo -e "${GREEN}Found:${NC} $(basename "$file")"
+                echo "  Path: $file"
+
+                # Extract story ID and title if present
+                STORY_LINE=$(grep -m 1 "Story.*$EPIC-[0-9]\|ID:.*$EPIC-[0-9]" "$file" || true)
+                if [ -n "$STORY_LINE" ]; then
+                    echo -e "  ${YELLOW}Story:${NC} $STORY_LINE"
+                fi
+                echo ""
+            done
+        else
+            echo "No archived work found for epic $EPIC"
+        fi
+    fi
+    exit 0
+fi
+
+# Search by story
+if [ -n "$STORY" ]; then
+    echo -e "${BLUE}=== Story $STORY ===${NC}"
+    echo ""
+
+    if [ "$SUMMARIES_ONLY" = true ]; then
+        # Check for story summary
+        STORY_SUMMARY="$CONTEXT_DIR/story-$STORY-summary.md"
+        if [ -f "$STORY_SUMMARY" ]; then
+            echo -e "${GREEN}Found story summary:${NC} $STORY_SUMMARY"
+            echo ""
+            cat "$STORY_SUMMARY"
+            exit 0
+        fi
+    fi
+
+    # Search full archive
+    MATCHES=$(grep -l "$STORY\|story.*$STORY" "$ARCHIVE_DIR"/*.md 2>/dev/null || true)
+
+    if [ -n "$MATCHES" ]; then
+        echo "$MATCHES" | while read -r file; do
+            echo -e "${GREEN}Found:${NC} $(basename "$file")"
+            echo "  Path: $file"
+            echo ""
+
+            # Show first few lines of context
+            echo -e "${YELLOW}Context preview:${NC}"
+            head -30 "$file" | grep -v "^#\|^-\|^$" | head -10
+            echo ""
+        done
+    else
+        echo "No archived work found for story $STORY"
+    fi
+    exit 0
+fi
+
+# Search by keyword
+if [ -n "$KEYWORD" ]; then
+    echo -e "${BLUE}=== Search: '$KEYWORD' ===${NC}"
+    echo ""
+
+    SEARCH_DIR="$ARCHIVE_DIR"
+    if [ "$SUMMARIES_ONLY" = true ]; then
+        SEARCH_DIR="$CONTEXT_DIR"
+    fi
+
+    MATCHES=$(grep -il "$KEYWORD" "$SEARCH_DIR"/*.md 2>/dev/null || true)
+
+    if [ -n "$MATCHES" ]; then
+        echo "$MATCHES" | while read -r file; do
+            echo -e "${GREEN}Found in:${NC} $(basename "$file")"
+            echo "  Path: $file"
+            echo ""
+
+            # Show matching lines with context
+            grep -i -C 2 "$KEYWORD" "$file" | head -20
+            echo ""
+            echo "---"
+            echo ""
+        done
+    else
+        echo "No matches found for '$KEYWORD'"
+    fi
+    exit 0
+fi
+
+# No search term provided
+echo "Error: Must provide search term"
+echo ""
+usage
+exit 1

package/pennyfarthing-dist/scripts/utils/find-root.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env zsh
+# Shared utility: Find project root by .claude/ marker
+# Source this file to get PROJECT_ROOT set correctly
+#
+# Usage: source "$(dirname "$0")/utils/find-root.sh"
+#    or: source "$SCRIPT_DIR/utils/find-root.sh"
+#
+# After sourcing, PROJECT_ROOT will be set to the project root directory.
+# Uses SCRIPT_DIR if available (preferred), falls back to PWD.
+
+# Skip if PROJECT_ROOT is already set (e.g., by run.sh or CLAUDE_PROJECT_DIR)
+if [ -z "${PROJECT_ROOT:-}" ]; then
+    # Prefer SCRIPT_DIR (stable, set by caller) over PWD (may not be in project)
+    if [ -n "${SCRIPT_DIR:-}" ]; then
+        _find_root_dir="$SCRIPT_DIR"
+    else
+        _find_root_dir="$PWD"
+    fi
+
+    while [[ ! -d "$_find_root_dir/.claude" ]] && [[ "$_find_root_dir" != "/" ]]; do
+        _find_root_dir="$(dirname "$_find_root_dir")"
+    done
+
+    if [[ -d "$_find_root_dir/.claude" ]]; then
+        PROJECT_ROOT="$_find_root_dir"
+    else
+        echo "Error: Could not find project root (no .claude/ directory found)" >&2
+        exit 1
+    fi
+    unset _find_root_dir
+fi
+
+export PROJECT_ROOT

package/pennyfarthing-dist/scripts/utils/generate-skill-docs.sh

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+#
+# generate-skill-docs.sh - Generate SKILLS.md from skill-registry.yaml
+#
+# Usage: generate-skill-docs.sh [options]
+#
+# Options:
+#   --registry <path>   Path to skill-registry.yaml
+#   --output <path>     Path to write output (default: docs/SKILLS.md)
+#   --dry-run           Print output instead of writing file
+#   --help, -h          Show this help
+#
+# Examples:
+#   generate-skill-docs.sh
+#   generate-skill-docs.sh --dry-run
+#   generate-skill-docs.sh --registry ./custom-registry.yaml
+
+set -euo pipefail
+
+# Find project root (directory containing .claude/)
+find_project_root() {
+  local dir="$PWD"
+  while [[ ! -d "$dir/.claude" ]] && [[ "$dir" != "/" ]]; do
+    dir="$(dirname "$dir")"
+  done
+  if [[ -d "$dir/.claude" ]]; then
+    echo "$dir"
+  else
+    echo ""
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root)"
+if [[ -z "$PROJECT_ROOT" ]]; then
+  echo "Error: Cannot find project root (no .claude directory found)" >&2
+  exit 1
+fi
+
+# Default paths
+REGISTRY_PATH="${PROJECT_ROOT}/pennyfarthing-dist/skills/skill-registry.yaml"
+OUTPUT_PATH="${PROJECT_ROOT}/docs/SKILLS.md"
+DRY_RUN=false
+
+# Parse arguments
+show_help() {
+  cat <<EOF
+Usage: generate-skill-docs.sh [options]
+
+Generate SKILLS.md documentation from skill-registry.yaml.
+
+Options:
+  --registry <path>   Path to skill-registry.yaml (default: pennyfarthing-dist/skills/skill-registry.yaml)
+  --output <path>     Path to write output (default: docs/SKILLS.md)
+  --dry-run           Print output instead of writing file
+  --help, -h          Show this help
+
+Examples:
+  generate-skill-docs.sh
+  generate-skill-docs.sh --dry-run
+  generate-skill-docs.sh --registry ./custom-registry.yaml --output ./SKILLS.md
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help|-h)
+      show_help
+      exit 0
+      ;;
+    --registry)
+      REGISTRY_PATH="$2"
+      shift 2
+      ;;
+    --output)
+      OUTPUT_PATH="$2"
+      shift 2
+      ;;
+    --dry-run)
+      DRY_RUN=true
+      shift
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      echo "Use --help for usage information" >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Check registry exists
+if [[ ! -f "$REGISTRY_PATH" ]]; then
+  echo "Error: Registry not found: $REGISTRY_PATH" >&2
+  exit 1
+fi
+
+# Build the TypeScript module if needed
+DIST_FILE="${PROJECT_ROOT}/packages/shared/dist/generate-skill-docs.js"
+if [[ ! -f "$DIST_FILE" ]]; then
+  echo "Building shared package..." >&2
+  (cd "${PROJECT_ROOT}/packages/shared" && npm run build) >&2
+fi
+
+# Run the generator
+if $DRY_RUN; then
+  node "$DIST_FILE" --registry "$REGISTRY_PATH" --dry-run
+else
+  # Ensure output directory exists
+  mkdir -p "$(dirname "$OUTPUT_PATH")"
+  node "$DIST_FILE" --registry "$REGISTRY_PATH" --output "$OUTPUT_PATH"
+fi

package/pennyfarthing-dist/scripts/utils/git-status-all.sh

@@ -0,0 +1,127 @@
+#!/usr/bin/env zsh
+# Show git status across all repos
+# Usage: ./scripts/git-status-all.sh [--brief]
+#
+# Shows: branch, status, unpushed commits for all repos
+# Reads repo configuration from .claude/project/repos.yaml
+
+set -e
+
+# Source environment (inline to avoid argument passing issues)
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+if [ -f "$SCRIPT_DIR/../.env" ]; then
+    set -a; source "$SCRIPT_DIR/../.env"; set +a
+fi
+
+# Fallback if PROJECT_ROOT not set
+PROJECT_ROOT="${PROJECT_ROOT:-$(cd "$SCRIPT_DIR/../.." && pwd)}"
+
+# Source repo utilities for dynamic repo configuration
+source "$SCRIPT_DIR/../repo-utils.sh"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+BRIEF=false
+if [ "${1:-}" = "--brief" ] || [ "${1:-}" = "-b" ]; then
+    BRIEF=true
+fi
+
+cd "$PROJECT_ROOT"
+
+show_repo_status() {
+    local repo_name=$1
+    local repo_dir=$2  # Note: can't use 'path' - it's a zsh special variable
+
+    if [ ! -d "$repo_dir/.git" ] && [ ! -d "$repo_dir" ]; then
+        return
+    fi
+
+    local branch=$(git -C "$repo_dir" branch --show-current 2>/dev/null || echo "detached")
+    local git_status=$(git -C "$repo_dir" status --short 2>/dev/null)
+    local git_status_count=$(echo "$git_status" | grep -c . 2>/dev/null); git_status_count=${git_status_count:-0}
+    local unpushed=$(git -C "$repo_dir" log origin/develop..HEAD --oneline 2>/dev/null | head -5)
+    local unpushed_count=$(git -C "$repo_dir" log origin/develop..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
+
+    if $BRIEF; then
+        # One-line format
+        local status_indicator=""
+        [ "$git_status_count" -gt 0 ] && status_indicator="${YELLOW}M${NC}" || status_indicator="${GREEN}✓${NC}"
+        local push_indicator=""
+        [ "$unpushed_count" -gt 0 ] && push_indicator=" ${BLUE}↑${unpushed_count}${NC}"
+        echo -e "$repo_name: $branch $status_indicator$push_indicator"
+    else
+        echo -e "${BLUE}=== $repo_name ===${NC}"
+        echo -e "Branch: ${GREEN}$branch${NC}"
+
+        if [ -n "$git_status" ]; then
+            echo -e "${YELLOW}Changes:${NC}"
+            echo "$git_status" | head -10 | sed 's/^/  /'
+            [ "$git_status_count" -gt 10 ] && echo "  ... and $((git_status_count - 10)) more"
+        else
+            echo -e "${GREEN}Clean${NC}"
+        fi
+
+        if [ "$unpushed_count" -gt 0 ]; then
+            echo -e "${BLUE}Unpushed ($unpushed_count):${NC}"
+            echo "$unpushed" | sed 's/^/  /'
+            [ "$unpushed_count" -gt 5 ] && echo "  ... and $((unpushed_count - 5)) more"
+        fi
+        echo ""
+    fi
+}
+
+if ! $BRIEF; then
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}  Git Status - All Repos${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+fi
+
+# Check each repo from configuration
+repo_count=$(get_repo_count)
+if [[ "$repo_count" -eq 0 ]]; then
+    # No repos configured, just show current directory
+    show_repo_status "Project" "$PROJECT_ROOT"
+else
+    for repo in $(get_repos); do
+        repo_path=$(get_repo_full_path "$repo")
+        show_repo_status "$repo" "$repo_path"
+    done
+fi
+
+if ! $BRIEF; then
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+    # Summary
+    total_changes=0
+    total_unpushed=0
+
+    if [[ "$repo_count" -eq 0 ]]; then
+        # No repos configured, just check current directory
+        count=$(git -C "$PROJECT_ROOT" status --short 2>/dev/null | wc -l | tr -d ' ')
+        total_changes=$((total_changes + count))
+        unpushed=$(git -C "$PROJECT_ROOT" log origin/develop..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
+        total_unpushed=$((total_unpushed + unpushed))
+    else
+        for repo in $(get_repos); do
+            repo_path=$(get_repo_full_path "$repo")
+            [ -d "$repo_path/.git" ] || [ -d "$repo_path" ] || continue
+            count=$(git -C "$repo_path" status --short 2>/dev/null | wc -l | tr -d ' ')
+            total_changes=$((total_changes + count))
+            unpushed=$(git -C "$repo_path" log origin/develop..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
+            total_unpushed=$((total_unpushed + unpushed))
+        done
+    fi
+
+    if [ "$total_changes" -eq 0 ] && [ "$total_unpushed" -eq 0 ]; then
+        echo -e "${GREEN}✅ All repos clean and pushed${NC}"
+    else
+        [ "$total_changes" -gt 0 ] && echo -e "${YELLOW}$total_changes uncommitted change(s)${NC}"
+        [ "$total_unpushed" -gt 0 ] && echo -e "${BLUE}$total_unpushed unpushed commit(s)${NC}"
+    fi
+fi