@pennyfarthing/core 11.2.0 → 11.2.1

package/pennyfarthing-dist/scripts/hooks/context-circuit-breaker.sh

@@ -1,95 +1,4 @@
-#!/usr/bin/env zsh
-# Context circuit breaker hook: Block tool execution at 85% context usage
-# Called by Claude Code before tool calls (PreToolUse)
-#
-# Input: JSON via stdin with tool_name, tool_input, session_id
-# Output: Exit 0 to allow, Exit 2 to block (stderr shown to Claude)
-#
-# This hook provides a hard stop when context is critically high,
-# unlike context-warning.sh which only warns.
-#
-# When triggered, automatically saves the active agent to a checkpoint
-# so /continue-session can restore it with FULL tier.
-
-# Read stdin to get session_id (required by hook protocol)
-INPUT=$(cat)
-
-# Script location for sibling script references
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-# Get context percentage from check-context.sh
-CONTEXT_SCRIPT="$SCRIPT_DIR/../check-context.sh"
-if [[ ! -x "$CONTEXT_SCRIPT" ]]; then
-    # graceful degradation: if check-context.sh not found, allow the tool
-    exit 0
-fi
-
-# Run check-context.sh and parse output
-eval "$("$CONTEXT_SCRIPT" 2>/dev/null)" 2>/dev/null
-
-# graceful degradation: if we can't get context, allow the tool
-if [[ -z "$CONTEXT_PERCENT" ]] || [[ "$CONTEXT_PERCENT" == "null" ]]; then
-    exit 0
-fi
-
-# Load critical threshold (default 80%)
-CRITICAL_THRESHOLD="${CRITICAL_THRESHOLD:-80}"
-
-# Check if at or above critical threshold
-if [[ "$CONTEXT_PERCENT" -ge "$CRITICAL_THRESHOLD" ]] 2>/dev/null; then
-    # Auto-save active agent to checkpoint before blocking
-    # This allows /continue-session to restore with FULL tier
-    source "$SCRIPT_DIR/../lib/checkpoint.sh" 2>/dev/null || true
-
-    # Get session_id from input JSON
-    SESSION_ID=""
-    if command -v jq &>/dev/null && [[ -n "$INPUT" ]]; then
-        SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
-    fi
-
-    # Look up active agent for this session
-    ACTIVE_AGENT=""
-    AGENT_FILE="${CLAUDE_PROJECT_DIR:-.}/.session/agents/${SESSION_ID}"
-    if [[ -n "$SESSION_ID" && -f "$AGENT_FILE" ]]; then
-        ACTIVE_AGENT=$(cat "$AGENT_FILE" 2>/dev/null)
-    fi
-
-    # Save agent checkpoint if we found one
-    if [[ -n "$ACTIVE_AGENT" ]]; then
-        checkpoint_save "circuit_breaker_agent" "$ACTIVE_AGENT" 2>/dev/null || true
-    fi
-
-    # Send error message to stderr (Claude will see this)
-    cat >&2 << EOF
-CONTEXT CIRCUIT BREAKER TRIGGERED
-
-Context usage: ${CONTEXT_PERCENT}% - CRITICAL (threshold: ${CRITICAL_THRESHOLD}%)
-
-Tool execution BLOCKED. You must stop and hand off.
-EOF
-
-    # Include agent info if available
-    if [[ -n "$ACTIVE_AGENT" ]]; then
-        cat >&2 << EOF
-
-Active agent saved: ${ACTIVE_AGENT}
-The agent will be restored with FULL context when you run /continue-session.
-EOF
-    fi
-
-    cat >&2 << EOF
-
-Required actions:
-1. Commit any pending changes
-2. Tell user to start fresh session with /continue-session
-
-DO NOT attempt further tool calls. This is a hard stop.
-
-To resume later: /continue-session
-EOF
-    # Exit 2 blocks the tool execution
-    exit 2
-fi
-
-# Below threshold: allow the tool
-exit 0
+#!/usr/bin/env bash
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks context-breaker
+exec pf hooks context-breaker

package/pennyfarthing-dist/scripts/hooks/context-warning.sh

@@ -1,65 +1,4 @@
-#!/usr/bin/env zsh
-# Context warning hook: Warn agent when context usage is high
-# Called by Claude Code before tool calls (PreToolUse)
-#
-# Input: JSON via stdin with tool_name, tool_input
-# Output: Warning message to stdout if context > 60%
-# Always exits 0 (warning only, never blocks)
-
-# Read and discard stdin (required by hook protocol)
-cat > /dev/null
-
-# Script location for sibling script references
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-# Get context percentage from check-context.sh
-CONTEXT_SCRIPT="$SCRIPT_DIR/../check-context.sh"
-if [[ ! -x "$CONTEXT_SCRIPT" ]]; then
-    exit 0  # Can't check, allow silently
-fi
-
-# Run check-context.sh and parse output
-eval "$("$CONTEXT_SCRIPT" 2>/dev/null)" 2>/dev/null
-
-# Check if we got a valid percentage
-if [[ -z "$CONTEXT_PERCENT" ]] || [[ "$CONTEXT_PERCENT" == "null" ]]; then
-    exit 0  # Can't determine, allow silently
-fi
-
-# Load thresholds from settings (defaults match check-context.sh)
-WARNING_THRESHOLD="${WARNING_THRESHOLD:-60}"
-CRITICAL_THRESHOLD="${CRITICAL_THRESHOLD:-85}"
-
-# Output warning if above threshold
-if [[ "$CONTEXT_PERCENT" -ge "$CRITICAL_THRESHOLD" ]] 2>/dev/null; then
-    cat << EOF
-
----
-CONTEXT WARNING: ${CONTEXT_PERCENT}% (CRITICAL)
-
-Context usage is critically high. Recommended actions:
-1. Complete current task immediately
-2. Commit any pending changes
-3. Hand off to next agent or ask user to start fresh session
-
-Do NOT start new subtasks. Wrap up and hand off.
----
-
-EOF
-elif [[ "$CONTEXT_PERCENT" -ge "$WARNING_THRESHOLD" ]] 2>/dev/null; then
-    cat << EOF
-
----
-CONTEXT WARNING: ${CONTEXT_PERCENT}%
-
-Context usage is high. Consider:
-- Wrapping up current task soon
-- Preparing for handoff to next agent
-- Avoiding large file reads or complex operations
----
-
-EOF
-fi
-
-# Always allow the tool (we're warning, not blocking)
-exit 0
+#!/usr/bin/env bash
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks context-warning
+exec pf hooks context-warning

package/pennyfarthing-dist/scripts/hooks/cyclist-pretooluse-hook.sh

@@ -1,32 +1,4 @@
 #!/usr/bin/env bash
-#
-# Cyclist PreToolUse Hook - Shell wrapper for Python implementation
-#
-# Routes tool approval requests through WheelHub when Cyclist is running.
-# Falls back to Claude Code's built-in permissions when Cyclist is not active.
-#
-# Input (stdin): JSON with tool_name, tool_input, session_id, etc.
-# Output (stdout): JSON decision (allow/deny/ask)
-#
-# Story: MSSCI-14320
-
-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.pretooluse_hook
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks cyclist-pretooluse
+exec pf hooks cyclist-pretooluse

package/pennyfarthing-dist/scripts/hooks/pre-commit.sh

@@ -3,7 +3,7 @@
 #
 # Checks:
 # 1. Prevents direct commits to protected branches (main, develop)
-#    Exception: sprint/ folder commits allowed on develop
+#    Exception: sprint/ folder commits allowed on protected branches
 # 2. Validates agent files when pennyfarthing-dist/agents/*.md is modified
 # 3. Validates file references when pennyfarthing-dist/ files are modified (warn only)
 # 4. Validates sprint YAML files when sprint/*.yaml is modified
@@ -34,40 +34,34 @@ BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
 PROTECTED_BRANCHES="^(main|develop)$"
 
 if [[ $BRANCH =~ $PROTECTED_BRANCHES ]]; then
-    # Special case: Allow sprint/ folder commits on develop branch
-    if [[ $BRANCH == "develop" ]]; then
-        STAGED_FILES=$(git diff --cached --name-only)
-        NON_SPRINT_FILES=$(echo "$STAGED_FILES" | grep -v "^sprint/")
-
-        # If all staged files are in sprint/, allow the commit
-        if [ -z "$NON_SPRINT_FILES" ] && [ -n "$STAGED_FILES" ]; then
-            # Continue to agent validation check
-            :
-        else
-            echo ""
-            echo "COMMIT BLOCKED"
-            echo ""
-            echo "You are trying to commit directly to: $BRANCH"
-            echo "This violates the git workflow rules."
-            echo ""
-            echo "Protected branches: main, develop"
-            echo ""
-            echo "What to do:"
-            echo "1. Create a feature branch:"
-            echo "   git checkout -b <type>/<epic-story>-<description>"
-            echo ""
-            echo "2. Example:"
-            echo "   git checkout -b feat/8-2-add-authentication"
-            echo ""
-            echo "3. Then commit your changes on the feature branch"
-            echo ""
-            echo "Exception: Sprint tracking files (sprint/*) can be committed to develop"
-            echo ""
-            exit 1
-        fi
+    # Special case: Allow sprint/ folder commits on protected branches
+    # (orchestrator uses trunk-based on main; pennyfarthing uses gitflow on develop)
+    STAGED_FILES=$(git diff --cached --name-only)
+    NON_SPRINT_FILES=$(echo "$STAGED_FILES" | grep -v "^sprint/")
+
+    # If all staged files are in sprint/, allow the commit
+    if [ -z "$NON_SPRINT_FILES" ] && [ -n "$STAGED_FILES" ]; then
+        # Continue to agent validation check
+        :
     else
         echo ""
-        echo "COMMIT BLOCKED - Cannot commit directly to $BRANCH"
+        echo "COMMIT BLOCKED"
+        echo ""
+        echo "You are trying to commit directly to: $BRANCH"
+        echo "This violates the git workflow rules."
+        echo ""
+        echo "Protected branches: main, develop"
+        echo ""
+        echo "What to do:"
+        echo "1. Create a feature branch:"
+        echo "   git checkout -b <type>/<epic-story>-<description>"
+        echo ""
+        echo "2. Example:"
+        echo "   git checkout -b feat/8-2-add-authentication"
+        echo ""
+        echo "3. Then commit your changes on the feature branch"
+        echo ""
+        echo "Exception: Sprint tracking files (sprint/*) can be committed directly"
         echo ""
         exit 1
     fi

package/pennyfarthing-dist/scripts/hooks/pre-edit-check.sh

@@ -1,71 +1,4 @@
-#!/usr/bin/env zsh
-# Pre-edit hook: Verify edits don't touch protected files
-# Called by Claude Code before Edit/Write tool calls
-#
-# Input: JSON via stdin with tool_name, tool_input
-# Output: Exit 0 to allow, Exit 2 to block (stderr shown to Claude)
-
-set -euo pipefail
-
-# Read input from stdin
-input=$(cat)
-
-# Extract file path from tool input
-file_path=$(echo "$input" | jq -r '.tool_input.file_path // .tool_input.path // ""')
-
-# Protected patterns (files that should never be edited automatically)
-protected_patterns=(
-    "*.env"
-    "*.pem"
-    "*.key"
-    "*credentials*"
-    "*secrets*"
-    ".git/*"
-    "node_modules/*"
-    "vendor/*"
-)
-
-# Pennyfarthing managed files protection
-# These are managed by `pennyfarthing update`, don't edit directly
-# EXCEPTION: If we ARE in the pennyfarthing library itself, allow edits
-is_pennyfarthing_lib=false
-if [[ -d "${CLAUDE_PROJECT_DIR:-$PWD}/pennyfarthing-dist" ]]; then
-    is_pennyfarthing_lib=true
-fi
-
-if [[ "$file_path" == *".claude/pennyfarthing/"* ]] && [[ "$is_pennyfarthing_lib" == "false" ]]; then
-    echo "BLOCKED: Cannot edit managed pennyfarthing files." >&2
-    echo "File: $file_path" >&2
-    echo "" >&2
-    echo "These files are managed by pennyfarthing and will be overwritten on update." >&2
-    echo "Instead:" >&2
-    echo "  - Put project-specific customizations in .claude/project/" >&2
-    echo "  - For framework changes, edit the pennyfarthing repo and run 'pennyfarthing update'" >&2
-    exit 2
-fi
-
-# Check if file matches any protected pattern
-for pattern in "${protected_patterns[@]}"; do
-    if [[ "$file_path" == $pattern ]]; then
-        echo "BLOCKED: Cannot edit protected file matching pattern: $pattern" >&2
-        echo "File: $file_path" >&2
-        exit 2
-    fi
-done
-
-# Additional check: warn on certain file types but allow
-warn_patterns=(
-    "*.md"
-    "*.json"
-)
-
-# For warnings, just log to stderr but allow (exit 0)
-for pattern in "${warn_patterns[@]}"; do
-    if [[ "$file_path" == $pattern ]]; then
-        # Could log warnings here if needed
-        :
-    fi
-done
-
-# Allow the edit
-exit 0
+#!/usr/bin/env bash
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks pre-edit-check
+exec pf hooks pre-edit-check

package/pennyfarthing-dist/scripts/hooks/question-reflector-check.sh

@@ -1,20 +1,4 @@
 #!/usr/bin/env bash
-#
-# Question Reflector Enforcement Hook (Stop hook / PreToolUse hook)
-#
-# Thin wrapper that delegates to question_reflector_check.py for the actual logic.
-# This allows the hook to be written in Python for easier testing and maintenance.
-#
-# Input (stdin): JSON with transcript_path, stop_hook_active, etc.
-# Output (stdout): JSON decision to allow or block
-#
-# Story: MSSCI-12393
-#
-
-set -euo pipefail
-
-# Get the directory where this script lives
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Delegate to Python implementation
-exec python3 "$SCRIPT_DIR/question_reflector_check.py"
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks reflector-check
+exec pf hooks reflector-check

package/pennyfarthing-dist/scripts/hooks/schema-validation.sh

@@ -1,30 +1,4 @@
-#!/usr/bin/env zsh
-# Schema Validation Hook
-# Validates XML schema for session, skill, and workflow step files on Write operations
-# Called by Claude Code PreToolUse hook
-#
-# Input: JSON via stdin with tool_name, tool_input
-# Output: JSON with decision (allow/deny)
-
-set -euo pipefail
-
-# Find script directory (zsh compatible)
-SCRIPT_DIR="${0:A:h}"
-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
-
-# Run Python validation hook
-python3 -m pennyfarthing_scripts.schema_validation_hook
+#!/usr/bin/env bash
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks schema-validation
+exec pf hooks schema-validation

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
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks session-start
+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
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks session-stop
+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
+# DEPRECATED: This script is a shim. Logic has moved to Python.
+# Use: pf hooks sprint-yaml
+exec pf hooks sprint-yaml