@pennyfarthing/core 11.1.1 → 11.2.1

package/pennyfarthing-dist/scripts/git/install-git-hooks.sh

@@ -1,144 +1,6 @@
-#!/bin/bash
-# install-git-hooks.sh - Install Pennyfarthing git hooks for framework development
-#
-# Usage: ./pennyfarthing-dist/scripts/install-git-hooks.sh
-#
-# For the pennyfarthing framework repo and orchestrator repos that inline it.
-# End-user projects use `pennyfarthing init` which copies hooks from node_modules.
-# This script creates .d/ directories with symlinks so hook changes in
-# pennyfarthing-dist/ take effect immediately.
-
-set -euo pipefail
-
-# Self-locate and set up PROJECT_ROOT
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
-source "$SCRIPT_DIR/../lib/find-root.sh"
-HOOKS_SOURCE="$PROJECT_ROOT/pennyfarthing-dist/scripts/hooks"
-HOOKS_DEST="$PROJECT_ROOT/.git/hooks"
-
-DISPATCHER_MARKER="pennyfarthing-dispatcher"
-PF_PREFIX="10"
-MIGRATED_PREFIX="50"
-
-# Check we're in a repo with pennyfarthing-dist (framework or orchestrator)
-if [[ ! -d "$PROJECT_ROOT/pennyfarthing-dist" ]]; then
-    echo "Error: This script requires pennyfarthing-dist/ at the project root"
-    echo "       (framework repo or orchestrator with inlined pennyfarthing/)"
-    echo "       End-user projects should use: pennyfarthing init"
-    exit 1
-fi
-
-# Check .git exists
-if [[ ! -d "$PROJECT_ROOT/.git" ]]; then
-    echo "Error: Not a git repository"
-    exit 1
-fi
-
-echo "Installing git hooks with .d/ dispatcher pattern..."
-echo "  Source: pennyfarthing-dist/scripts/hooks/"
-echo "  Dest:   .git/hooks/"
-echo ""
-
-# Shared dispatcher template — single source of truth
-DISPATCHER_TEMPLATE="$PROJECT_ROOT/pennyfarthing-dist/scripts/hooks/dispatcher-template.sh"
-
-if [[ ! -f "$DISPATCHER_TEMPLATE" ]]; then
-    echo "Error: dispatcher-template.sh not found at $DISPATCHER_TEMPLATE"
-    exit 1
-fi
-
-# Generate a dispatcher script for a given hook name
-generate_dispatcher() {
-    local hook_name="$1"
-    sed "s/__HOOK_NAME__/${hook_name}/g" "$DISPATCHER_TEMPLATE"
-}
-
-# Define hooks to install
-HOOKS=(
-    "pre-commit.sh:pre-commit"
-    "pre-push.sh:pre-push"
-    "post-merge.sh:post-merge"
-)
-
-for hook_pair in "${HOOKS[@]}"; do
-    source_file="${hook_pair%%:*}"
-    dest_name="${hook_pair##*:}"
-
-    source_path="$HOOKS_SOURCE/$source_file"
-    dest_path="$HOOKS_DEST/$dest_name"
-    d_dir="$HOOKS_DEST/${dest_name}.d"
-    pf_hook_name="${PF_PREFIX}-pennyfarthing-${dest_name}.sh"
-    pf_hook_path="${d_dir}/${pf_hook_name}"
-
-    if [[ ! -f "$source_path" ]]; then
-        echo "  SKIP $dest_name (source not found)"
-        continue
-    fi
-
-    # Create .d/ directory
-    mkdir -p "$d_dir"
-
-    # Handle existing hook at the dest path
-    if [[ -e "$dest_path" ]]; then
-        if [[ -f "$dest_path" ]] && grep -q "$DISPATCHER_MARKER" "$dest_path" 2>/dev/null; then
-            echo "  OK   $dest_name dispatcher (already installed)"
-        elif [[ -L "$dest_path" ]]; then
-            # Old-style symlink — migrate to .d/ pattern
-            rm "$dest_path"
-            generate_dispatcher "$dest_name" > "$dest_path"
-            chmod 755 "$dest_path"
-            echo "  UPD  $dest_name → dispatcher"
-        elif [[ -f "$dest_path" ]]; then
-            existing_content="$(cat "$dest_path")"
-            if echo "$existing_content" | grep -q "pennyfarthing"; then
-                # Old pennyfarthing single-file hook — replace with dispatcher
-                generate_dispatcher "$dest_name" > "$dest_path"
-                chmod 755 "$dest_path"
-                echo "  UPD  $dest_name → dispatcher (was single-file pf hook)"
-            else
-                # Non-pennyfarthing hook — migrate into .d/
-                migrated_name="${MIGRATED_PREFIX}-migrated-${dest_name}.sh"
-                migrated_path="${d_dir}/${migrated_name}"
-                if [[ ! -f "$migrated_path" ]]; then
-                    mv "$dest_path" "$migrated_path"
-                    chmod 755 "$migrated_path"
-                    echo "  MIG  $dest_name → ${dest_name}.d/${migrated_name}"
-                fi
-                generate_dispatcher "$dest_name" > "$dest_path"
-                chmod 755 "$dest_path"
-                echo "  NEW  $dest_name dispatcher"
-            fi
-        fi
-    else
-        # No existing hook — install fresh dispatcher
-        generate_dispatcher "$dest_name" > "$dest_path"
-        chmod 755 "$dest_path"
-        echo "  NEW  $dest_name dispatcher"
-    fi
-
-    # Symlink pennyfarthing hook into .d/ (framework dev — symlink for live edits)
-    # From .git/hooks/{hook}.d/ we need ../../.../pennyfarthing-dist/scripts/hooks/
-    relative_path="../../../pennyfarthing-dist/scripts/hooks/$source_file"
-
-    if [[ -L "$pf_hook_path" ]]; then
-        current_target=$(readlink "$pf_hook_path")
-        if [[ "$current_target" == "$relative_path" ]]; then
-            echo "  OK   ${dest_name}.d/${pf_hook_name} (already linked)"
-        else
-            rm "$pf_hook_path"
-            ln -sf "$relative_path" "$pf_hook_path"
-            echo "  UPD  ${dest_name}.d/${pf_hook_name} → $relative_path"
-        fi
-    elif [[ -f "$pf_hook_path" ]]; then
-        # Regular file — replace with symlink for dev
-        rm "$pf_hook_path"
-        ln -sf "$relative_path" "$pf_hook_path"
-        echo "  UPD  ${dest_name}.d/${pf_hook_name} → $relative_path (was copy)"
-    else
-        ln -sf "$relative_path" "$pf_hook_path"
-        echo "  NEW  ${dest_name}.d/${pf_hook_name} → $relative_path"
-    fi
-done
-
-echo ""
-echo "Done. Verify with: ls -la .git/hooks/*.d/"
+#!/usr/bin/env bash
+# DEPRECATED: Use `pf git install-hooks` instead.
+# This shim forwards to the Python CLI.
+set -e
+echo "DEPRECATED: install-git-hooks.sh — use 'pf git install-hooks' instead" >&2
+exec pf git install-hooks "$@"

package/pennyfarthing-dist/scripts/git/worktree-manager.sh

@@ -1,497 +1,6 @@
-#!/usr/bin/env zsh
-# Worktree management utilities for parallel development work
-# Usage: worktree-manager.sh {create|remove|list|status|ports|cd} [args]
-#
-# Configuration (choose one):
-#   1. repos.yaml: Define repos in .pennyfarthing/repos.yaml (recommended)
-#   2. Legacy env vars: Set API_REPO and UI_REPO in .claude/project/hooks/setup-env.sh
-
+#!/usr/bin/env bash
+# DEPRECATED: Use `pf git worktree` instead.
+# This shim forwards to the Python CLI.
 set -e
-
-# Self-locate: derive paths from this script's position
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd -P)"
-
-# Load environment
-if [ -f "$PROJECT_ROOT/.env" ]; then
-    set -a; source "$PROJECT_ROOT/.env"; set +a
-fi
-
-# Source project hooks if available
-if [ -f "$PROJECT_ROOT/.claude/project/hooks/setup-env.sh" ]; then
-    source "$PROJECT_ROOT/.claude/project/hooks/setup-env.sh"
-fi
-
-# Source repo utilities (handles repos.yaml or legacy env vars)
-REPO_UTILS_LAZY=1  # Don't auto-load, we'll do it after validation
-source "$SCRIPT_DIR/../misc/repo-utils.sh"
-
-WORKTREE_ROOT="${WORKTREE_ROOT:-$PROJECT_ROOT/worktrees}"
-WORKTREE_PORT_OFFSET="${WORKTREE_PORT_OFFSET:-100}"
-
-# ============================================================================
-# Services Configuration
-# ============================================================================
-
-# Load services configuration from pennyfarthing-settings.yaml
-# Sets: _SERVICES_JSON, _PORT_OFFSET
-# Returns 1 if no services configured
-load_services_config() {
-    local config_file="${PROJECT_ROOT}/.claude/project/pennyfarthing-settings.yaml"
-
-    if [[ ! -f "$config_file" ]]; then
-        _SERVICES_JSON=""
-        _PORT_OFFSET=$WORKTREE_PORT_OFFSET
-        return 1
-    fi
-
-    # Parse services config using yq (preferred) or Python fallback
-    local config
-    if command -v yq &>/dev/null; then
-        # Check if services section exists
-        local has_services
-        has_services=$(yq '.services.definitions' "$config_file" 2>/dev/null)
-        if [[ -z "$has_services" || "$has_services" == "null" ]]; then
-            _SERVICES_JSON=""
-            _PORT_OFFSET=$WORKTREE_PORT_OFFSET
-            return 1
-        fi
-
-        local port_offset
-        port_offset=$(yq '.services.port_offset // 100' "$config_file" 2>/dev/null)
-        local definitions_json
-        definitions_json=$(yq -o=json '.services.definitions' "$config_file" 2>/dev/null)
-
-        _PORT_OFFSET=$port_offset
-        _SERVICES_JSON="$definitions_json"
-        return 0
-    elif command -v python3 &>/dev/null; then
-        config=$(python3 -c "
-import yaml
-import json
-import sys
-
-try:
-    with open('$config_file', 'r') as f:
-        settings = yaml.safe_load(f)
-
-    if not settings or 'services' not in settings or 'definitions' not in settings['services']:
-        sys.exit(1)
-
-    svc = settings['services']
-    port_offset = svc.get('port_offset', ${WORKTREE_PORT_OFFSET})
-    definitions = svc['definitions']
-
-    # Ensure env_var is set for each service
-    for d in definitions:
-        if 'env_var' not in d:
-            d['env_var'] = d['name'].upper().replace(' ', '_').replace('-', '_') + '_PORT'
-
-    print(f'_PORT_OFFSET={port_offset}')
-    print(f\"_SERVICES_JSON='{json.dumps(definitions)}'\")
-except Exception:
-    sys.exit(1)
-" 2>/dev/null)
-
-        if [[ $? -eq 0 && -n "$config" ]]; then
-            eval "$config"
-            return 0
-        fi
-    fi
-
-    _SERVICES_JSON=""
-    _PORT_OFFSET=$WORKTREE_PORT_OFFSET
-    return 1
-}
-
-# Load and validate repo configuration
-load_repos_config
-
-if [ "$(get_repo_count)" -eq 0 ]; then
-    echo "❌ Error: No repositories configured"
-    echo ""
-    echo "Option 1: Create .pennyfarthing/repos.yaml (recommended for multi-repo projects)"
-    echo "Option 2: Set API_REPO and UI_REPO in .claude/project/hooks/setup-env.sh"
-    exit 1
-fi
-
-# Ensure worktree root exists
-mkdir -p "$WORKTREE_ROOT"
-
-show_help() {
-    cat << EOF
-Worktree Manager - Parallel Development Tool
-
-Usage: worktree-manager.sh <command> [options]
-
-Commands:
-  create <name> <branch> [repos]   Create worktree(s) for parallel work
-  remove <name>                    Remove worktree and clean up
-  list                             List all active worktrees
-  status                           Show detailed worktree status
-  ports <name>                     Get port configuration for worktree
-  cd <name>                        Print path to worktree (use with: cd \$(./scripts/worktree-manager.sh cd <name>))
-  config                           Show current repo configuration
-
-Examples:
-  # Create worktree for all repos
-  ./scripts/worktree-manager.sh create 5-1a feat/5-1a-file-upload
-
-  # Create worktree for specific repo type
-  ./scripts/worktree-manager.sh create bug-123 fix/bug-123-validation api
-
-  # Create worktree for specific repos (comma-separated)
-  ./scripts/worktree-manager.sh create feat-x feat/x-feature adapter-a,adapter-b
-
-  # Get ports for running dev servers
-  eval \$(./scripts/worktree-manager.sh ports 5-1a)
-  echo "API: \$API_PORT, UI: \$UI_PORT"
-
-  # Remove worktree after merge
-  ./scripts/worktree-manager.sh remove 5-1a
-
-  # Show repo configuration
-  ./scripts/worktree-manager.sh config
-
-Repos Filter (third argument):
-  all           - All configured repos (default)
-  api           - Only repos of type 'api'
-  ui            - Only repos of type 'ui'
-  adapter       - Only repos of type 'adapter'
-  service       - Only repos of type 'service'
-  repo1,repo2   - Comma-separated list of specific repo names
-
-Configuration:
-  Option 1 (recommended): Create .pennyfarthing/repos.yaml
-  Option 2 (legacy): Set API_REPO and UI_REPO environment variables
-
-Session Files:
-  Session files are named after story IDs: .session/{story-id}-session.md
-  Example: .session/5-1a-session.md (with worktree field inside)
-  Session files are managed by SM agent, not worktree-manager.
-
-Environment Variables:
-  PROJECT_ROOT - Project root directory
-  WORKTREE_ROOT - Where worktrees are created (default: \$PROJECT_ROOT/worktrees)
-  WORKTREE_PORT_OFFSET - Port offset between worktrees (default: 100)
-
-EOF
-}
-
-create_worktree() {
-    local WT_NAME="$1"
-    local BRANCH="$2"
-    local REPOS_FILTER="${3:-all}"  # all, api, ui, adapter, service, or comma-separated names
-
-    if [ -z "$WT_NAME" ] || [ -z "$BRANCH" ]; then
-        echo "❌ Usage: worktree-manager.sh create <name> <branch> [repos-filter]"
-        echo "   repos-filter: all, api, ui, adapter, service, or comma-separated names"
-        exit 1
-    fi
-
-    local WT_PATH="$WORKTREE_ROOT/$WT_NAME"
-
-    # Check if worktree already exists
-    if [ -d "$WT_PATH" ]; then
-        echo "❌ Worktree '$WT_NAME' already exists at $WT_PATH"
-        exit 1
-    fi
-
-    mkdir -p "$WT_PATH"
-
-    echo "🔧 Creating worktree: $WT_NAME"
-    echo "   Branch: $BRANCH"
-    echo "   Path: $WT_PATH"
-    echo "   Repos: $REPOS_FILTER"
-    echo ""
-
-    # Get repos to create worktrees for (handle legacy 'both' as 'all')
-    local repos_filter="$REPOS_FILTER"
-    [ "$repos_filter" = "both" ] && repos_filter="all"
-
-    local repos_to_create
-    repos_to_create=$(filter_repos "$repos_filter")
-
-    local created_repos=()
-
-    while IFS= read -r repo; do
-        [ -z "$repo" ] && continue
-
-        local repo_path
-        repo_path=$(get_repo_path "$repo")
-        local full_path="$PROJECT_ROOT/$repo_path"
-        local repo_type
-        repo_type=$(get_repo_type "$repo")
-
-        if [ -d "$full_path" ]; then
-            echo "📦 Creating worktree for $repo ($repo_type)..."
-            cd "$full_path"
-
-            # Check if branch exists locally, remotely, or needs to be created
-            if git show-ref --verify --quiet "refs/heads/$BRANCH" 2>/dev/null; then
-                git worktree add "$WT_PATH/$repo" "$BRANCH"
-            elif git show-ref --verify --quiet "refs/remotes/origin/$BRANCH" 2>/dev/null; then
-                git worktree add "$WT_PATH/$repo" "$BRANCH"
-            else
-                # Create new branch from develop (or main if develop doesn't exist)
-                local base_branch="develop"
-                if ! git show-ref --verify --quiet "refs/heads/develop" 2>/dev/null; then
-                    base_branch="main"
-                fi
-                git worktree add -b "$BRANCH" "$WT_PATH/$repo" "$base_branch"
-            fi
-            echo "   ✅ $repo worktree created"
-            created_repos+=("$repo")
-        else
-            echo "   ⚠️  Repo not found: $full_path"
-        fi
-    done <<< "$repos_to_create"
-
-    echo ""
-    echo "✅ Worktree '$WT_NAME' created successfully!"
-    echo ""
-    echo "📝 Session file: Use /sm to create .session/{story-id}-session.md"
-    echo ""
-    echo "Next steps:"
-    for repo in "${created_repos[@]}"; do
-        echo "  cd $WT_PATH/$repo"
-    done
-    echo ""
-    echo "Start dev servers with custom ports:"
-    echo "  eval \$(./scripts/worktree-manager.sh ports $WT_NAME)"
-}
-
-remove_worktree() {
-    local WT_NAME="$1"
-
-    if [ -z "$WT_NAME" ]; then
-        echo "❌ Usage: worktree-manager.sh remove <name>"
-        exit 1
-    fi
-
-    local WT_PATH="$WORKTREE_ROOT/$WT_NAME"
-
-    if [ ! -d "$WT_PATH" ]; then
-        echo "❌ Worktree '$WT_NAME' not found at $WT_PATH"
-        exit 1
-    fi
-
-    echo "🗑️  Removing worktree: $WT_NAME"
-
-    # Remove worktrees for all configured repos
-    for repo in $(get_repos); do
-        local repo_path
-        repo_path=$(get_repo_path "$repo")
-
-        if [ -d "$WT_PATH/$repo" ]; then
-            echo "   Removing $repo worktree..."
-            cd "$PROJECT_ROOT/$repo_path"
-            git worktree remove "$WT_PATH/$repo" --force 2>/dev/null || true
-        fi
-    done
-
-    # Clean up directory
-    rm -rf "$WT_PATH"
-
-    # Note: Session files are managed by SM agent
-    # Use /sm to finish work and archive the session file
-    echo ""
-    echo "   Note: Session file (if any) should be archived via /sm finish"
-
-    # Prune worktree references for all repos
-    for repo in $(get_repos); do
-        local repo_path
-        repo_path=$(get_repo_path "$repo")
-        if [ -d "$PROJECT_ROOT/$repo_path" ]; then
-            cd "$PROJECT_ROOT/$repo_path" && git worktree prune 2>/dev/null || true
-        fi
-    done
-
-    echo ""
-    echo "✅ Worktree '$WT_NAME' removed successfully!"
-}
-
-list_worktrees() {
-    echo "=== Active Worktrees ==="
-    echo ""
-
-    for repo in $(get_repos); do
-        local repo_path
-        repo_path=$(get_repo_path "$repo")
-        local repo_type
-        repo_type=$(get_repo_type "$repo")
-
-        if [ -d "$PROJECT_ROOT/$repo_path" ]; then
-            echo "📦 $repo ($repo_type):"
-            cd "$PROJECT_ROOT/$repo_path" && git worktree list
-            echo ""
-        fi
-    done
-
-    echo "📁 Worktree Directory:"
-    if [ -d "$WORKTREE_ROOT" ] && [ "$(ls -A "$WORKTREE_ROOT" 2>/dev/null)" ]; then
-        ls -la "$WORKTREE_ROOT"
-    else
-        echo "   (empty)"
-    fi
-}
-
-show_status() {
-    echo "=== Worktree Status ==="
-    echo ""
-
-    if [ ! -d "$WORKTREE_ROOT" ] || [ -z "$(ls -A "$WORKTREE_ROOT" 2>/dev/null)" ]; then
-        echo "No active worktrees."
-        echo ""
-        echo "Create one with:"
-        echo "  ./scripts/worktree-manager.sh create <name> <branch>"
-        return
-    fi
-
-    for wt in "$WORKTREE_ROOT"/*/; do
-        if [ -d "$wt" ]; then
-            local WT_NAME=$(basename "$wt")
-            echo "📁 $WT_NAME"
-            echo "   Path: $wt"
-
-            # Show status for each configured repo
-            for repo in $(get_repos); do
-                if [ -d "$wt/$repo" ]; then
-                    local repo_type
-                    repo_type=$(get_repo_type "$repo")
-                    local branch=$(cd "$wt/$repo" && git branch --show-current 2>/dev/null || echo "unknown")
-                    local status_count=$(cd "$wt/$repo" && git status --short 2>/dev/null | wc -l | tr -d ' ')
-                    echo "   $repo ($repo_type): $branch ($status_count uncommitted)"
-                fi
-            done
-
-            # Check for session files that reference this worktree
-            local found_session=""
-            for sf in "$PROJECT_ROOT"/.session/*-session.md; do
-                if [ -f "$sf" ] && grep -q "worktree: $WT_NAME" "$sf" 2>/dev/null; then
-                    found_session=$(basename "$sf")
-                    break
-                fi
-            done
-            if [ -n "$found_session" ]; then
-                echo "   Session: ✅ .session/$found_session"
-            else
-                echo "   Session: ❌ (no session file references this worktree)"
-            fi
-
-            # Show ports (from services config)
-            local WT_INDEX=$(ls -1 "$WORKTREE_ROOT" 2>/dev/null | grep -n "^$WT_NAME$" | cut -d: -f1)
-            WT_INDEX=${WT_INDEX:-1}
-            if load_services_config; then
-                local OFFSET=$((_PORT_OFFSET * WT_INDEX))
-                local ports_display
-                ports_display=$(python3 -c "
-import json
-services = $_SERVICES_JSON
-offset = $OFFSET
-parts = []
-for svc in services:
-    name = svc['name']
-    port = svc['base_port'] + offset
-    parts.append(f'{name}={port}')
-print(', '.join(parts))
-" 2>/dev/null)
-                echo "   Ports: $ports_display"
-            else
-                echo "   Ports: (no services configured)"
-            fi
-            echo ""
-        fi
-    done
-}
-
-get_ports() {
-    local WT_NAME="$1"
-
-    if [ -z "$WT_NAME" ]; then
-        echo "# Usage: worktree-manager.sh ports <name>" >&2
-        echo "# Outputs shell variables for service ports" >&2
-        exit 1
-    fi
-
-    # Load services configuration
-    if ! load_services_config; then
-        echo "# No services configured in .claude/project/pennyfarthing-settings.yaml" >&2
-        echo "# Add a 'services' section with 'definitions' array" >&2
-        exit 1
-    fi
-
-    # Calculate port offset based on worktree index
-    local WT_INDEX=$(ls -1 "$WORKTREE_ROOT" 2>/dev/null | grep -n "^$WT_NAME$" | cut -d: -f1)
-    WT_INDEX=${WT_INDEX:-1}
-    local OFFSET=$((_PORT_OFFSET * WT_INDEX))
-
-    # Output worktree info
-    echo "export WORKTREE_PATH=$WORKTREE_ROOT/$WT_NAME"
-    echo "export WORKTREE_INDEX=$WT_INDEX"
-    echo "export WORKTREE_PORT_OFFSET=$OFFSET"
-
-    # Generate exports for each configured service
-    python3 -c "
-import json
-
-services = $_SERVICES_JSON
-offset = $OFFSET
-
-for svc in services:
-    env_var = svc.get('env_var', svc['name'].upper().replace(' ', '_').replace('-', '_') + '_PORT')
-    port = svc['base_port'] + offset
-    print(f'export {env_var}={port}')
-" 2>/dev/null
-}
-
-get_path() {
-    local WT_NAME="$1"
-
-    if [ -z "$WT_NAME" ]; then
-        echo "❌ Usage: worktree-manager.sh cd <name>"
-        exit 1
-    fi
-
-    local WT_PATH="$WORKTREE_ROOT/$WT_NAME"
-
-    if [ ! -d "$WT_PATH" ]; then
-        echo "❌ Worktree '$WT_NAME' not found" >&2
-        exit 1
-    fi
-
-    echo "$WT_PATH"
-}
-
-# Main command dispatch
-case "${1:-help}" in
-    create)
-        create_worktree "$2" "$3" "$4"
-        ;;
-    remove|rm|delete)
-        remove_worktree "$2"
-        ;;
-    list|ls)
-        list_worktrees
-        ;;
-    status|st)
-        show_status
-        ;;
-    ports)
-        get_ports "$2"
-        ;;
-    cd|path)
-        get_path "$2"
-        ;;
-    config)
-        show_config
-        ;;
-    help|--help|-h)
-        show_help
-        ;;
-    *)
-        echo "❌ Unknown command: $1"
-        echo ""
-        show_help
-        exit 1
-        ;;
-esac
+echo "DEPRECATED: worktree-manager.sh — use 'pf git worktree' instead" >&2
+exec pf git worktree "$@"

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

@@ -6,22 +6,22 @@ Git hooks and Claude Code hooks.
 
 | Script | Purpose |
 |--------|---------|
-| `context-circuit-breaker.sh` | Claude hook: halt at context limit |
-| `context-warning.sh` | Claude hook: warn on high context |
+| `pf hooks context-breaker` | Claude hook: halt at context limit |
+| `pf hooks context-warning` | Claude hook: warn on high context |
 | `otel-auto-config.sh` | Claude hook: configure OTEL |
 | `post-merge.sh` | Git hook: post-merge actions |
 | `pre-commit.sh` | Git hook: branch protection, agent validation, sprint YAML validation |
-| `pre-edit-check.sh` | Claude hook: validate before edit |
+| `pf hooks pre-edit-check` | Claude hook: validate before edit |
 | `pre-push.sh` | Git hook: pre-push validation |
-| `session-start.sh` | Claude hook: session start |
-| `session-stop.sh` | Claude hook: session stop |
+| `pf hooks session-start` | Claude hook: session start |
+| `pf hooks session-stop` | Claude hook: session stop |
 
 ## Installation
 
 Git hooks are installed via:
 
 ```bash
-.pennyfarthing/scripts/git/install-git-hooks.sh
+pf git install-hooks
 ```
 
 Claude hooks are configured in `.claude/settings.json`.