@pennyfarthing/core 7.0.1 → 7.4.0

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

@@ -1,231 +0,0 @@
-#!/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

@@ -1,33 +0,0 @@
-#!/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

@@ -1,110 +0,0 @@
-#!/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

@@ -1,127 +0,0 @@
-#!/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