@pennyfarthing/core 6.6.0

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

@@ -0,0 +1,91 @@
+#!/bin/bash
+# install-git-hooks.sh - Install Pennyfarthing git hooks for dogfooding
+#
+# Usage: ./pennyfarthing-dist/scripts/install-git-hooks.sh
+#
+# For dogfooding only. Clients use `pennyfarthing init` which copies hooks
+# from node_modules. This script creates symlinks for development.
+
+set -euo pipefail
+
+# Find project root
+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 "Error: Not in a Pennyfarthing project" >&2
+        exit 1
+    fi
+}
+
+PROJECT_ROOT="$(find_project_root)"
+HOOKS_SOURCE="$PROJECT_ROOT/pennyfarthing-dist/scripts/hooks"
+HOOKS_DEST="$PROJECT_ROOT/.git/hooks"
+
+# Check we're in the pennyfarthing repo (dogfooding)
+if [[ ! -d "$PROJECT_ROOT/pennyfarthing-dist" ]]; then
+    echo "Error: This script is for dogfooding only (pennyfarthing repo)"
+    echo "       Clients 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 for dogfooding..."
+echo "  Source: pennyfarthing-dist/scripts/hooks/"
+echo "  Dest:   .git/hooks/"
+echo ""
+
+# 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"
+
+    if [[ ! -f "$source_path" ]]; then
+        echo "  SKIP $dest_name (source not found)"
+        continue
+    fi
+
+    # Create relative symlink
+    # From .git/hooks/ we need to go ../../pennyfarthing-dist/scripts/hooks/
+    relative_path="../../pennyfarthing-dist/scripts/hooks/$source_file"
+
+    if [[ -L "$dest_path" ]]; then
+        # Already a symlink - check if it points to our file
+        current_target=$(readlink "$dest_path")
+        if [[ "$current_target" == "$relative_path" ]]; then
+            echo "  OK   $dest_name (already installed)"
+            continue
+        fi
+        # Different symlink - remove and recreate
+        rm "$dest_path"
+    elif [[ -f "$dest_path" ]]; then
+        # Regular file - backup first
+        backup_path="${dest_path}.backup"
+        mv "$dest_path" "$backup_path"
+        echo "  BACK $dest_name -> ${dest_name}.backup"
+    fi
+
+    ln -sf "$relative_path" "$dest_path"
+    echo "  NEW  $dest_name -> $relative_path"
+done
+
+echo ""
+echo "Done. Verify with: ls -la .git/hooks/ | grep -v sample"

package/pennyfarthing-dist/scripts/prime.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env zsh
+# prime.sh - Load essential project context at agent activation
+# Usage: prime.sh [--minimal] [--full] [--quiet] [--agent <name>]
+#
+# Loads context in priority order:
+# 1. CLAUDE.md (project + user)
+# 2. Sprint summary (current-sprint.yaml key fields)
+# 3. Active session (.session/*-session.md)
+# 4. Agent sidecar (if --agent provided)
+# 5. Shared context (project info - all agents)
+# 6. Shared agent behavior (protocols - all agents)
+# 7. Tactical guide (for sm, tea, dev, reviewer)
+# 8. Domain docs (--full only)
+
+set -euo pipefail
+
+# Find project root
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/utils/find-root.sh"
+
+# Defaults
+QUIET=false
+MINIMAL=false
+FULL=false
+AGENT_NAME=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --quiet) QUIET=true; shift ;;
+        --minimal) MINIMAL=true; shift ;;
+        --full) FULL=true; shift ;;
+        --agent) AGENT_NAME="$2"; shift 2 ;;
+        -h|--help)
+            echo "Usage: prime.sh [--minimal] [--full] [--quiet] [--agent <name>]"
+            echo "  --minimal      Load only CLAUDE.md files (fastest)"
+            echo "  --full         Include domain docs from .claude/project/"
+            echo "  --quiet        Suppress section headers"
+            echo "  --agent <name> Load agent's sidecar patterns"
+            exit 0
+            ;;
+        *) shift ;;
+    esac
+done
+
+# Helper to print headers (respects --quiet)
+print_header() {
+    if [[ "$QUIET" != "true" ]]; then
+        echo ""
+        echo "# $1"
+    fi
+}
+
+# 1. Project CLAUDE.md (always loaded first)
+if [[ -f "$PROJECT_ROOT/CLAUDE.md" ]]; then
+    print_header "CLAUDE.md"
+    cat "$PROJECT_ROOT/CLAUDE.md"
+fi
+
+# 2. User CLAUDE.md (if exists)
+if [[ -f "$HOME/.claude/CLAUDE.md" ]]; then
+    print_header "~/.claude/CLAUDE.md"
+    cat "$HOME/.claude/CLAUDE.md"
+fi
+
+# Stop here for minimal mode
+if [[ "$MINIMAL" == "true" ]]; then
+    exit 0
+fi
+
+# 3. Sprint summary (extract key info only, not full notes)
+if [[ -f "$PROJECT_ROOT/sprint/current-sprint.yaml" ]]; then
+    print_header "Sprint Context"
+
+    # Extract sprint number and goal
+    sprint_num=$(yq '.sprint.number // ""' "$PROJECT_ROOT/sprint/current-sprint.yaml" 2>/dev/null)
+    sprint_goal=$(yq '.sprint.goal // ""' "$PROJECT_ROOT/sprint/current-sprint.yaml" 2>/dev/null)
+    if [[ -n "$sprint_num" && "$sprint_num" != "null" ]]; then
+        echo "Sprint ${sprint_num}: ${sprint_goal}"
+    fi
+
+    # Extract progress
+    completed=$(yq '.summary.completed_points // 0' "$PROJECT_ROOT/sprint/current-sprint.yaml" 2>/dev/null)
+    total=$(yq '.summary.total_points // 0' "$PROJECT_ROOT/sprint/current-sprint.yaml" 2>/dev/null)
+    if [[ -n "$completed" && -n "$total" ]]; then
+        echo "Progress: ${completed}/${total} points"
+    fi
+fi
+
+# 4. Active session (if exists) - first 50 lines only
+SESSION_FILE=""
+if [[ -d "$PROJECT_ROOT/.session" ]]; then
+    # Find a session file (typically only one active at a time)
+    SESSION_FILE=$(find "$PROJECT_ROOT/.session" -maxdepth 1 -name "*-session.md" -type f 2>/dev/null | head -1)
+fi
+
+if [[ -n "$SESSION_FILE" && -f "$SESSION_FILE" ]]; then
+    print_header "Active Session: $(basename "$SESSION_FILE")"
+    head -50 "$SESSION_FILE"
+
+    # Indicate if truncated
+    total_lines=$(wc -l < "$SESSION_FILE" | tr -d ' ')
+    if [[ "$total_lines" -gt 50 ]]; then
+        echo ""
+        echo "... (truncated, ${total_lines} total lines)"
+    fi
+fi
+
+# 5. Agent sidecar (if --agent provided)
+if [[ -n "$AGENT_NAME" ]]; then
+    SIDECAR_DIR="$PROJECT_ROOT/.pennyfarthing/sidecars/${AGENT_NAME}"
+    if [[ -d "$SIDECAR_DIR" ]]; then
+        for pattern_file in "$SIDECAR_DIR"/*.md; do
+            if [[ -f "$pattern_file" ]]; then
+                print_header "Agent Sidecar: $(basename "$pattern_file")"
+                cat "$pattern_file"
+            fi
+        done
+    fi
+fi
+
+# 6. Shared context (project info - all agents get this)
+if [[ -n "$AGENT_NAME" ]]; then
+    SHARED_CONTEXT="$PROJECT_ROOT/.pennyfarthing/guides/shared-context.md"
+    if [[ -f "$SHARED_CONTEXT" ]]; then
+        print_header "Shared Context"
+        cat "$SHARED_CONTEXT"
+    fi
+fi
+
+# 7. Shared agent behavior (protocols - all agents get this)
+if [[ -n "$AGENT_NAME" ]]; then
+    SHARED_GUIDE="$PROJECT_ROOT/.pennyfarthing/guides/shared-agent-behavior.md"
+    if [[ -f "$SHARED_GUIDE" ]]; then
+        print_header "Shared Agent Behavior"
+        cat "$SHARED_GUIDE"
+    fi
+fi
+
+# 8. Tactical guide (for tactical agents: sm, tea, dev, reviewer)
+if [[ -n "$AGENT_NAME" ]]; then
+    case "$AGENT_NAME" in
+        sm|tea|dev|reviewer)
+            TACTICAL_GUIDE="$PROJECT_ROOT/.pennyfarthing/guides/tactical-agent-behavior.md"
+            if [[ -f "$TACTICAL_GUIDE" ]]; then
+                print_header "Tactical Agent Behavior"
+                cat "$TACTICAL_GUIDE"
+            fi
+            ;;
+    esac
+fi
+
+# 9. Domain docs (--full only)
+if [[ "$FULL" == "true" ]]; then
+    for doc in "$PROJECT_ROOT/.claude/project"/CLAUDE-*.md; do
+        if [[ -f "$doc" ]]; then
+            print_header "$(basename "$doc")"
+            cat "$doc"
+        fi
+    done
+fi

package/pennyfarthing-dist/scripts/release.sh

@@ -0,0 +1,198 @@
+#!/usr/bin/env zsh
+# Pennyfarthing Release Script
+# Merges develop to main and pushes both branches
+#
+# Usage: ./scripts/release.sh [OPTIONS]
+#
+# Options:
+#   --bump <type>   Bump version before release (major|minor|patch)
+#   --dry-run       Show what would happen without executing
+#   --help          Show this help message
+#
+# Examples:
+#   ./scripts/release.sh                    # Just merge and push
+#   ./scripts/release.sh --bump patch       # Bump patch version, then release
+#   ./scripts/release.sh --bump minor       # Bump minor version, then release
+#   ./scripts/release.sh --dry-run          # Preview what would happen
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Use exported PROJECT_ROOT from run.sh, or detect it
+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
+        PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+    fi
+fi
+
+cd "$PROJECT_ROOT"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+DRY_RUN=false
+BUMP_TYPE=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --bump)
+            BUMP_TYPE="$2"
+            if [[ ! "$BUMP_TYPE" =~ ^(major|minor|patch)$ ]]; then
+                echo -e "${RED}[ERROR]${NC} Invalid bump type: $BUMP_TYPE"
+                echo "Valid types: major, minor, patch"
+                exit 1
+            fi
+            shift 2
+            ;;
+        --help|-h)
+            head -20 "$0" | tail -18
+            exit 0
+            ;;
+        *)
+            echo -e "${RED}[ERROR]${NC} Unknown option: $1"
+            echo "Use --help for usage information"
+            exit 1
+            ;;
+    esac
+done
+
+# Helper functions
+info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+error() { echo -e "${RED}[ERROR]${NC} $1"; exit 1; }
+
+run() {
+    if $DRY_RUN; then
+        echo -e "${YELLOW}[DRY-RUN]${NC} $*"
+    else
+        "$@"
+    fi
+}
+
+if $DRY_RUN; then
+    echo -e "${YELLOW}DRY RUN MODE - No changes will be made${NC}"
+    echo ""
+fi
+
+# If bump requested, delegate to deploy.sh (which handles everything)
+if [[ -n "$BUMP_TYPE" ]]; then
+    info "Version bump requested: $BUMP_TYPE"
+
+    # Run deploy.sh which handles version bump + full release
+    if $DRY_RUN; then
+        exec "$SCRIPT_DIR/deploy.sh" --dry-run "$BUMP_TYPE"
+    else
+        exec "$SCRIPT_DIR/deploy.sh" "$BUMP_TYPE"
+    fi
+fi
+
+# No version bump - just merge and push
+info "=== Release (no version bump) ==="
+echo ""
+
+# Pre-flight checks
+info "Running pre-flight checks..."
+
+# Check we're in a git repo
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+    error "Not in a git repository"
+fi
+
+# Check for uncommitted changes
+if ! git diff-index --quiet HEAD -- 2>/dev/null; then
+    error "Uncommitted changes detected. Commit or stash before releasing."
+fi
+
+# Get current branch
+CURRENT_BRANCH=$(git branch --show-current)
+info "Current branch: $CURRENT_BRANCH"
+
+# Determine main branch name
+if git show-ref --verify --quiet refs/heads/main; then
+    MAIN_BRANCH="main"
+elif git show-ref --verify --quiet refs/heads/master; then
+    MAIN_BRANCH="master"
+else
+    error "No main or master branch found"
+fi
+info "Main branch: $MAIN_BRANCH"
+
+# Check develop exists
+if ! git show-ref --verify --quiet refs/heads/develop; then
+    error "No develop branch found"
+fi
+
+# Get version
+VERSION=$(cat VERSION 2>/dev/null || echo "unknown")
+info "Current version: $VERSION"
+
+# Show what will be merged
+COMMITS_TO_MERGE=$(git log --oneline "$MAIN_BRANCH"..develop 2>/dev/null | wc -l | tr -d ' ')
+if [[ "$COMMITS_TO_MERGE" == "0" ]]; then
+    info "No new commits to merge. Branches are already in sync."
+    exit 0
+fi
+info "Commits to merge: $COMMITS_TO_MERGE"
+
+echo ""
+info "=== Starting Release Process ==="
+echo ""
+
+# Step 1: Ensure we're on develop and it's up to date
+info "Step 1: Updating develop branch..."
+run git checkout develop
+run git pull origin develop 2>/dev/null || true
+
+# Step 2: Switch to main and update
+info "Step 2: Updating $MAIN_BRANCH branch..."
+run git checkout "$MAIN_BRANCH"
+run git pull origin "$MAIN_BRANCH" 2>/dev/null || true
+
+# Step 3: Merge develop into main
+info "Step 3: Merging develop into $MAIN_BRANCH..."
+if $DRY_RUN; then
+    echo -e "${YELLOW}[DRY-RUN]${NC} git merge develop --no-edit"
+else
+    git merge develop --no-edit
+fi
+
+# Step 4: Push main
+info "Step 4: Pushing $MAIN_BRANCH to origin..."
+run git push origin "$MAIN_BRANCH"
+
+# Step 5: Switch back to develop and push
+info "Step 5: Pushing develop to origin..."
+run git checkout develop
+run git push origin develop
+
+# Step 6: Push tags (in case any were created manually)
+info "Step 6: Pushing tags..."
+run git push origin --tags
+
+echo ""
+info "=== Release Complete ==="
+echo ""
+info "Version $VERSION released!"
+info "  - develop and $MAIN_BRANCH are in sync"
+info "  - All changes pushed to origin"
+
+# Return to original branch if different
+if [[ "$CURRENT_BRANCH" != "develop" && "$CURRENT_BRANCH" != "$MAIN_BRANCH" ]]; then
+    info "Returning to original branch: $CURRENT_BRANCH"
+    run git checkout "$CURRENT_BRANCH"
+fi