@pennyfarthing/core 11.2.0 → 11.2.2

package/pennyfarthing-dist/scripts/hooks/session-start.sh

@@ -1,33 +1,4 @@
 #!/usr/bin/env bash
-#
-# Session Start Hook - Shell wrapper for Python implementation
-#
-# Initializes environment for Claude Code session:
-# - Session directory setup and logging
-# - Checkpoint validation (cross-session drift)
-# - WheelHub auto-start
-# - OTEL auto-configuration
-#
-# Input (stdin): JSON with session_id, source, cwd, etc.
-# Output: Writes to CLAUDE_ENV_FILE
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
-source "$SCRIPT_DIR/../lib/find-root.sh"
-
-# Set PYTHONPATH for pennyfarthing_scripts
-PENNYFARTHING_SCRIPTS=""
-if [[ -d "$PROJECT_ROOT/pennyfarthing" ]]; then
-    # Dogfooding: framework inlined in orchestrator
-    PENNYFARTHING_SCRIPTS="$PROJECT_ROOT/pennyfarthing"
-elif [[ -d "$PROJECT_ROOT/node_modules/@pennyfarthing/core" ]]; then
-    # Normal install
-    PENNYFARTHING_SCRIPTS="$PROJECT_ROOT/node_modules/@pennyfarthing/core"
-fi
-
-if [[ -n "$PENNYFARTHING_SCRIPTS" ]]; then
-    export PYTHONPATH="$PENNYFARTHING_SCRIPTS:${PYTHONPATH:-}"
-fi
-
-python3 -m pennyfarthing_scripts.session_start_hook
+# Shim: delegates to Python CLI via uv run — no global pf install needed.
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf hooks session-start

package/pennyfarthing-dist/scripts/hooks/session-stop.sh

@@ -1,65 +1,4 @@
-#!/usr/bin/env zsh
-# Session stop hook: Save checkpoint for cross-session continuity
-# Called by Claude Code when a session ends
-#
-# Writes session state to checkpoint:
-#   - Active agent (from .session/agents/)
-#   - Current story (from .session/*-session.md)
-#   - Workflow phase (from session file)
-#   - Git SHA (current HEAD)
-#   - Session ID
-#
-# Next session can validate this against current git state.
-
-set -euo pipefail
-
-# Load shared functions
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-# Determine project root (directory containing .claude)
-PROJECT_ROOT="$SCRIPT_DIR"
-while [[ ! -d "$PROJECT_ROOT/.pennyfarthing" ]] && [[ "$PROJECT_ROOT" != "/" ]]; do
-    PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
-done
-
-source "$SCRIPT_DIR/../lib/checkpoint.sh"
-
-# Read input from stdin (contains session_id, source, etc.)
-input=$(cat)
-session_id=$(echo "$input" | jq -r '.session_id // "unknown"')
-
-# Get current agent for this session
-agent=""
-agent_file="$PROJECT_ROOT/.session/agents/$session_id"
-if [[ -f "$agent_file" ]]; then
-    agent=$(cat "$agent_file")
-fi
-
-# Find active story from session files
-story=""
-phase=""
-session_file=$(find "$PROJECT_ROOT/.session" -maxdepth 1 -name "*-session.md" -type f 2>/dev/null | head -1)
-if [[ -n "$session_file" && -f "$session_file" ]]; then
-    # Extract story ID from filename (e.g., 8-3-session.md -> 8-3)
-    story=$(basename "$session_file" | sed 's/-session\.md$//')
-
-    # Extract phase from session file (look for "Phase:" line)
-    phase=$(grep -i "^- Phase:" "$session_file" 2>/dev/null | head -1 | sed 's/.*Phase:[[:space:]]*//' | cut -d' ' -f1 || echo "")
-fi
-
-# Get current git SHA
-git_sha=""
-if command -v git &>/dev/null && git rev-parse --git-dir &>/dev/null; then
-    git_sha=$(git rev-parse --short HEAD 2>/dev/null || echo "")
-fi
-
-# Build checkpoint data (semicolon-separated key=value pairs)
-checkpoint_data="agent=${agent};story=${story};phase=${phase};sha=${git_sha};session=${session_id}"
-
-# Save checkpoint
-checkpoint_save "session_state" "$checkpoint_data"
-
-# Log session end
-echo "$(date -Iseconds) | Session end: $session_id (agent=$agent, story=$story)" >> "$PROJECT_ROOT/.session/session-log.txt"
-
-exit 0
+#!/usr/bin/env bash
+# Shim: delegates to Python CLI via uv run — no global pf install needed.
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf hooks session-stop

package/pennyfarthing-dist/scripts/hooks/sprint-yaml-validation.sh

@@ -1,78 +1,4 @@
-#!/bin/bash
-#
-# Sprint YAML Validation Hook (PostToolUse)
-#
-# Validates sprint YAML files after Edit/Write operations to ensure
-# compatibility with the yaml npm package used by Cyclist's SprintPanel.
-#
-# The yaml npm package follows YAML 1.2 strictly and rejects:
-# - Single-quoted strings with blank lines
-# - Invalid multiline string formats
-#
-# When validation fails, returns additionalContext with an error message
-# prompting the agent to fix the YAML format.
-#
-# Input: JSON via stdin with tool_name, tool_input
-# Output: JSON with additionalContext on validation failure
-#
-# See also: pf sprint validate
-
-set -euo pipefail
-
-# Read hook input from stdin
-INPUT=$(cat)
-
-# Extract tool name and file path from input
-TOOL_NAME=$(echo "$INPUT" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"tool_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' || echo "")
-FILE_PATH=$(echo "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' || echo "")
-
-# Only process Edit and Write operations on sprint YAML files
-if [[ "$TOOL_NAME" != "Edit" && "$TOOL_NAME" != "Write" ]]; then
-  exit 0
-fi
-
-# Check if it's a sprint YAML file
-if [[ ! "$FILE_PATH" =~ sprint/.*\.(yaml|yml)$ ]]; then
-  exit 0
-fi
-
-# Check if the file exists
-if [[ ! -f "$FILE_PATH" ]]; then
-  exit 0
-fi
-
-# Validate using Node.js yaml package (same parser Cyclist uses)
-VALIDATION_ERROR=$(node --input-type=module -e "
-import { parse } from 'yaml';
-import { readFileSync } from 'fs';
-
-try {
-  const content = readFileSync('$FILE_PATH', 'utf-8');
-  parse(content);
-  process.exit(0);
-} catch (e) {
-  console.error(e.message);
-  process.exit(1);
-}
-" 2>&1) && VALID=true || VALID=false
-
-if [[ "$VALID" == "true" ]]; then
-  # Valid YAML - exit silently
-  exit 0
-fi
-
-# Validation failed - return error context to agent
-# Escape special characters for JSON
-ESCAPED_ERROR=$(echo "$VALIDATION_ERROR" | sed 's/\\/\\\\/g' | sed 's/"/\\"/g' | tr '\n' ' ')
-ESCAPED_PATH=$(echo "$FILE_PATH" | sed 's/\\/\\\\/g' | sed 's/"/\\"/g')
-
-cat << EOF
-{
-  "hookSpecificOutput": {
-    "hookEventName": "PostToolUse",
-    "additionalContext": "⚠️ SPRINT YAML VALIDATION FAILED\n\nFile: $ESCAPED_PATH\nError: $ESCAPED_ERROR\n\nThe sprint YAML file has invalid syntax that will break the Cyclist SprintPanel.\n\nCommon fix: Single-quoted strings cannot contain blank lines in YAML 1.2.\nUse literal block scalars (|) for multiline strings instead.\n\nTo auto-fix, run: yq eval -o=json '$ESCAPED_PATH' > /tmp/sprint.json && yq eval -P /tmp/sprint.json > '$ESCAPED_PATH'"
-  }
-}
-EOF
-
-exit 0
+#!/usr/bin/env bash
+# Shim: delegates to Python CLI via uv run — no global pf install needed.
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf hooks sprint-yaml

package/pennyfarthing-dist/scripts/hooks/welcome-hook.sh

@@ -1,94 +1,4 @@
 #!/usr/bin/env bash
-# Welcome Hook: Display a friendly welcome message on session start
-#
-# For CLI: Displays ASCII art of a penny-farthing bicycle
-# For Cyclist: Sends WebSocket message to display logo and welcome
-#
-# Called by Claude Code SessionStart hook
-
-set -euo pipefail
-
-# Read and discard stdin (required by hook protocol)
-cat > /dev/null
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$SCRIPT_DIR/../../.." && pwd)}"
-
-# Once-per-session guard: only show welcome on first invocation
-# Use session ID from environment or generate a unique one
-SESSION_ID="${CLAUDE_SESSION_ID:-$$}"
-WELCOME_LOCK="$PROJECT_ROOT/.session/.welcome-shown-$SESSION_ID"
-
-# Ensure .session directory exists
-mkdir -p "$PROJECT_ROOT/.session"
-
-# Check if welcome was already shown for this session
-if [[ -f "$WELCOME_LOCK" ]]; then
-    exit 0
-fi
-
-# Mark welcome as shown for this session
-touch "$WELCOME_LOCK"
-
-# Check if running in Cyclist (port file exists)
-PORT_FILE="$PROJECT_ROOT/.wheelhub-port"
-IN_CYCLIST=false
-if [[ -f "$PORT_FILE" ]]; then
-    CYCLIST_PORT=$(cat "$PORT_FILE" 2>/dev/null)
-    if [[ "$CYCLIST_PORT" =~ ^[0-9]+$ ]]; then
-        IN_CYCLIST=true
-    fi
-fi
-
-# Get project name from package.json or directory name
-PROJECT_NAME=""
-if [[ -f "$PROJECT_ROOT/package.json" ]]; then
-    PROJECT_NAME=$(jq -r '.name // empty' "$PROJECT_ROOT/package.json" 2>/dev/null || echo "")
-fi
-if [[ -z "$PROJECT_NAME" ]]; then
-    PROJECT_NAME=$(basename "$PROJECT_ROOT")
-fi
-
-# Get current theme from config
-THEME=""
-if [[ -f "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" ]]; then
-    THEME=$(grep -E '^theme:' "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" 2>/dev/null | sed 's/theme:[[:space:]]*//' | tr -d '"' || echo "")
-fi
-
-if [[ "$IN_CYCLIST" == "true" ]]; then
-    # Send welcome message via WebSocket API for Cyclist to display
-    # Cyclist will show the pennyfarthing logo image and welcome text
-    curl -s -X POST "http://localhost:$CYCLIST_PORT/api/welcome" \
-        -H "Content-Type: application/json" \
-        -d "{\"project\": \"$PROJECT_NAME\", \"theme\": \"$THEME\"}" \
-        >/dev/null 2>&1 || true
-else
-    # CLI mode: Display ASCII art welcome
-    cat << 'EOF'
-
-       ___
-      /   \
-     |     |     Welcome to
-     |     |    ╔═══════════════════════════════════╗
-      \___/     ║   ╔═╗╔═╗╔╗╔╔╗╔╦═╗╔═╗╔═╗╔═╗╦╔═╗   ║
-        ║       ║   ╠═╝║╣ ║║║║║║ ╠╣ ╠═╣╠╦╝ ║ ╠═╣   ║
-        ║       ║   ╩  ╚═╝╝╚╝╝╚╝╩  ╩ ╩╩╚═ ╩ ╩ ╩   ║
-      ╔═╩═╗     ╚═══════════════════════════════════╝
-     /     \
-    │   O   │   Agent-powered development with style
-     \     /
-      ╚═══╝
-
-EOF
-
-    # Add project-specific info
-    if [[ -n "$PROJECT_NAME" ]]; then
-        echo "    Project: $PROJECT_NAME"
-    fi
-    if [[ -n "$THEME" ]]; then
-        echo "    Theme:   $THEME"
-    fi
-    echo ""
-fi
-
-exit 0
+# Shim: delegates to Python CLI via uv run — no global pf install needed.
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf hooks session-start

package/pennyfarthing-dist/scripts/lib/env.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# Resolve CLAUDE_PROJECT_DIR in any context (hooks, Bash tool, subshells).
+#
+# Claude Code sets CLAUDE_PROJECT_DIR for hook execution but NOT for the
+# Bash tool environment.  This script fills the gap by walking up from PWD
+# to find .pennyfarthing/, mirroring find-root.sh's fallback strategy.
+#
+# Usage:
+#   source .pennyfarthing/scripts/lib/env.sh   # relative (Bash tool)
+#   source "$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/lib/env.sh"  # hooks (already set)
+#
+# After sourcing, CLAUDE_PROJECT_DIR is exported and safe to use.
+
+if [[ -z "${CLAUDE_PROJECT_DIR:-}" ]]; then
+  _d="$PWD"
+  while [[ ! -d "$_d/.pennyfarthing" ]] && [[ "$_d" != "/" ]]; do
+    _d="$(dirname "$_d")"
+  done
+  if [[ -d "$_d/.pennyfarthing" ]]; then
+    # Guard against nested .pennyfarthing (e.g., inlined child repo).
+    # If the found dir sits inside a parent that also has .pennyfarthing/,
+    # prefer the parent (outermost project root).
+    _parent="$(dirname "$_d")"
+    while [[ "$_parent" != "/" ]]; do
+      if [[ -d "$_parent/.pennyfarthing" ]]; then
+        _d="$_parent"
+      fi
+      _parent="$(dirname "$_parent")"
+    done
+    unset _parent
+    export CLAUDE_PROJECT_DIR="$_d"
+  fi
+  unset _d
+fi

package/pennyfarthing-dist/scripts/lib/run-pf.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Shared utility: Run the `pf` CLI via uv run — no global install needed.
+#
+# Resolution order for pyproject.toml:
+# 1. Dogfooding: $PROJECT_ROOT/pennyfarthing/pyproject.toml (inlined repo)
+# 2. Consumer:   $PROJECT_ROOT/pyproject.toml (project declares dependency)
+#
+# Usage from hook shims:
+#   source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+#   exec_pf hooks session-start
+
+# Resolve PROJECT_ROOT if not already set
+_lib_dir="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd -P)"
+source "$_lib_dir/find-root.sh"
+
+# Find the pyproject.toml that provides pennyfarthing-scripts
+_pf_project=""
+if [[ -f "$PROJECT_ROOT/pennyfarthing/pyproject.toml" ]]; then
+    # Dogfooding: inlined framework repo
+    _pf_project="$PROJECT_ROOT/pennyfarthing"
+elif [[ -f "$PROJECT_ROOT/pyproject.toml" ]]; then
+    # Consumer: project-level pyproject.toml with pennyfarthing-scripts dep
+    _pf_project="$PROJECT_ROOT"
+fi
+
+if [[ -z "$_pf_project" ]]; then
+    echo "Error: No pyproject.toml found for pennyfarthing-scripts" >&2
+    echo "Expected: $PROJECT_ROOT/pennyfarthing/pyproject.toml (dogfooding)" >&2
+    echo "      or: $PROJECT_ROOT/pyproject.toml (consumer)" >&2
+    exit 1
+fi
+
+run_pf() {
+    uv run --project "$_pf_project" pf "$@"
+}
+
+exec_pf() {
+    exec uv run --project "$_pf_project" pf "$@"
+}

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

@@ -9,7 +9,7 @@ Uncategorized utilities and one-off scripts.
 | `deploy.sh` | Deployment script |
 | `doctor-dogfood.sh` | Health check for framework/orchestrator development setup |
 | `run-ci.sh` | Run CI locally |
-| `statusline.sh` | Status line configuration |
+| `pf.sh hooks statusline` | Status line configuration |
 | `uninstall.sh` | Uninstall Pennyfarthing from project |
 | `backlog.sh` | Backlog operations |
 | `repo-utils.sh` | Multi-repo utilities |