@pennyfarthing/core 9.2.0 → 9.3.0

package/pennyfarthing-dist/scripts/core/handoff-marker.sh

@@ -1,112 +0,0 @@
-#!/bin/bash
-# Generate complete AGENT_COMMAND block with pre-rendered marker
-# Usage: handoff-marker.sh <next-agent> [--error <message>]
-#
-# Outputs a complete AGENT_COMMAND block that subagents can emit verbatim.
-# Handles IS_CYCLIST and USE_TIREPUMP detection automatically.
-#
-# Single source of truth for marker format - both agents and quick-actions.js
-# should reference this script's output format.
-
-set -euo pipefail
-
-NEXT_AGENT=""
-IS_ERROR=false
-ERROR_MSG=""
-
-# Parse args
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --error)
-      IS_ERROR=true
-      ERROR_MSG="${2:-Error occurred}"
-      shift 2
-      ;;
-    *)
-      if [[ -z "$NEXT_AGENT" ]]; then
-        NEXT_AGENT="$1"
-      fi
-      shift
-      ;;
-  esac
-done
-
-if [[ -z "$NEXT_AGENT" && "$IS_ERROR" != "true" ]]; then
-  echo "Usage: handoff-marker.sh <next-agent> [--error <message>]" >&2
-  echo "" >&2
-  echo "Examples:" >&2
-  echo "  handoff-marker.sh dev               # Normal handoff to dev" >&2
-  echo "  handoff-marker.sh tea               # Normal handoff to tea" >&2
-  echo "  handoff-marker.sh --error 'Tests failing'  # Error case" >&2
-  exit 1
-fi
-
-# Get environment from check-context.sh
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-eval "$("$SCRIPT_DIR/check-context.sh" 2>/dev/null)" || true
-
-# Default values if check-context.sh failed
-IS_CYCLIST="${IS_CYCLIST:-false}"
-USE_TIREPUMP="${USE_TIREPUMP:-false}"
-RELAY_MODE="${RELAY_MODE:-false}"
-
-# Generate marker based on environment
-if [[ "$IS_ERROR" == "true" ]]; then
-  # Error case - no marker
-  cat <<EOF
----
-AGENT_COMMAND:
-  marker: ""
-  fallback: "$ERROR_MSG"
-  error: true
----
-EOF
-elif [[ "$IS_CYCLIST" != "true" ]]; then
-  # Not in Cyclist - no marker, include context info
-  # Get context percentage for warning
-  CONTEXT_PCT="${CONTEXT_USABLE_PERCENT:-unknown}"
-  if [[ "$CONTEXT_PCT" != "unknown" ]] && [[ "$CONTEXT_PCT" -ge 60 ]] 2>/dev/null; then
-    CONTEXT_WARNING=" (context: ${CONTEXT_PCT}% - consider /clear before continuing)"
-  elif [[ "$CONTEXT_PCT" != "unknown" ]]; then
-    CONTEXT_WARNING=" (context: ${CONTEXT_PCT}%)"
-  else
-    CONTEXT_WARNING=""
-  fi
-  cat <<EOF
----
-AGENT_COMMAND:
-  marker: ""
-  fallback: "Run \`/${NEXT_AGENT}\` to continue${CONTEXT_WARNING}"
-  relay_mode: ${RELAY_MODE}
-  context_percent: ${CONTEXT_PCT}
----
-EOF
-elif [[ "$RELAY_MODE" != "true" ]]; then
-  # Cyclist + Relay OFF - emit question marker for manual handoff confirmation
-  cat <<EOF
----
-AGENT_COMMAND:
-  marker: "<!-- CYCLIST:QUESTION:yesno -->"
-  question: "Ready to hand off to /${NEXT_AGENT}?"
-  fallback: "Run \`/${NEXT_AGENT}\` to continue"
----
-EOF
-elif [[ "$USE_TIREPUMP" == "true" ]]; then
-  # Cyclist + Relay ON + high context - context clear marker
-  cat <<EOF
----
-AGENT_COMMAND:
-  marker: "<!-- CYCLIST:CONTEXT_CLEAR:/${NEXT_AGENT} -->"
-  fallback: "Run \`/${NEXT_AGENT}\` to continue"
----
-EOF
-else
-  # Cyclist + Relay ON + low context - handoff marker
-  cat <<EOF
----
-AGENT_COMMAND:
-  marker: "<!-- CYCLIST:HANDOFF:/${NEXT_AGENT} -->"
-  fallback: "Run \`/${NEXT_AGENT}\` to continue"
----
-EOF
-fi

package/pennyfarthing-dist/scripts/core/phase-check-start.sh

@@ -1,90 +0,0 @@
-#!/bin/bash
-# Start an agent with phase check
-# If the current story's phase belongs to a different agent, emit handoff marker instead
-#
-# Usage: .pennyfarthing/scripts/core/phase-check-start.sh <agent>
-# Example: phase-check-start.sh dev
-
-set -euo pipefail
-
-AGENT="${1:-}"
-
-if [[ -z "$AGENT" ]]; then
-  echo "Usage: phase-check-start.sh <agent>" >&2
-  exit 1
-fi
-
-# Self-locate and set up PROJECT_ROOT
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
-source "$SCRIPT_DIR/../lib/find-root.sh"
-
-SCRIPTS_DIR="$SCRIPT_DIR/.."
-SESSION_DIR="$PROJECT_ROOT/.session"
-
-# Find active session file
-SESSION_FILE=$(find "$SESSION_DIR" -maxdepth 1 -name "*-session.md" 2>/dev/null | head -1)
-
-if [[ -z "$SESSION_FILE" || ! -f "$SESSION_FILE" ]]; then
-  # No session - just start the agent normally
-  exec "$SCRIPTS_DIR/core/agent-session.sh" start "$AGENT"
-fi
-
-# Extract workflow and phase from session (handles multiple formats)
-# Format 1: **Workflow:** value
-# Format 2: - **Workflow**: value
-WORKFLOW=$(grep -E "\*\*Workflow\*?\*?:" "$SESSION_FILE" 2>/dev/null | head -1 | sed 's/.*\*\*Workflow\*\*[:\*]* *//' | tr -d ' ' || echo "")
-PHASE=$(grep -E "\*\*Phase\*?\*?:" "$SESSION_FILE" 2>/dev/null | head -1 | sed 's/.*\*\*Phase\*\*[:\*]* *//' | tr -d ' ' || echo "")
-
-if [[ -z "$WORKFLOW" ]]; then
-  # Can't determine workflow - start normally
-  exec "$SCRIPTS_DIR/core/agent-session.sh" start "$AGENT"
-fi
-
-# If no Phase field, try to infer from status patterns
-if [[ -z "$PHASE" ]]; then
-  # Check for approval status (story is done, needs SM to close)
-  if grep -qE "\*\*Status\*\*:.*APPROVED" "$SESSION_FILE" 2>/dev/null; then
-    PHASE="approved"
-  # Check for review status
-  elif grep -qE "Reviewer Assessment|Review.*REJECTED\|Review.*APPROVED" "$SESSION_FILE" 2>/dev/null; then
-    PHASE="review"
-  # Check for green/implementation complete
-  elif grep -qE "Dev Assessment|\*\*Status\*\*:.*GREEN" "$SESSION_FILE" 2>/dev/null; then
-    # Has dev assessment - could be in review or approved
-    if grep -qE "Reviewer Assessment" "$SESSION_FILE" 2>/dev/null; then
-      PHASE="approved"  # Reviewer already assessed
-    else
-      PHASE="review"    # Needs reviewer
-    fi
-  # Check for red/test phase
-  elif grep -qE "TEA Assessment|\*\*Status\*\*:.*RED" "$SESSION_FILE" 2>/dev/null; then
-    PHASE="green"  # TEA done, Dev's turn
-  else
-    # Can't determine phase - start normally
-    exec "$SCRIPTS_DIR/core/agent-session.sh" start "$AGENT"
-  fi
-fi
-
-# Get the owner of this phase
-OWNER=$("$SCRIPTS_DIR/workflow/phase-owner.sh" "$WORKFLOW" "$PHASE" 2>/dev/null || echo "")
-
-if [[ -z "$OWNER" ]]; then
-  # Phase owner lookup failed - start normally
-  exec "$SCRIPTS_DIR/core/agent-session.sh" start "$AGENT"
-fi
-
-# Check if this agent owns the phase
-if [[ "$OWNER" == "$AGENT" ]]; then
-  # Correct agent - start normally
-  exec "$SCRIPTS_DIR/core/agent-session.sh" start "$AGENT"
-fi
-
-# Wrong agent! Output the handoff marker and info
-STORY_ID=$(basename "$SESSION_FILE" -session.md)
-
-echo "Phase check: Story $STORY_ID is in '$PHASE' phase (workflow: $WORKFLOW)"
-echo "Phase owner: $OWNER (you requested: $AGENT)"
-echo ""
-
-# Generate and output the handoff marker
-"$SCRIPTS_DIR/core/handoff-marker.sh" "$OWNER"

package/pennyfarthing-dist/scripts/core/prime.sh

@@ -1,30 +0,0 @@
-#!/usr/bin/env bash
-# prime.sh - Load essential project context at agent activation
-# Usage: prime.sh [--minimal] [--full] [--quiet] [--agent <name>]
-#
-# Thin wrapper around python -m pennyfarthing_scripts.prime
-
-# Find the package root (where pennyfarthing_scripts lives)
-# Works for both npm installs (node_modules/@pennyfarthing/core) and local dev
-# Use pwd -P to resolve symlinks in the path (handles symlinked parent dirs)
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
-PACKAGE_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd -P)"
-
-# Fallback: if pennyfarthing_scripts not found at expected location,
-# look in node_modules (handles edge cases like stale copies)
-if [[ ! -d "$PACKAGE_ROOT/pennyfarthing_scripts" ]]; then
-    # Find project root by looking for .pennyfarthing marker
-    PROJECT_ROOT="$PWD"
-    while [[ ! -d "$PROJECT_ROOT/.pennyfarthing" ]] && [[ "$PROJECT_ROOT" != "/" ]]; do
-        PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
-    done
-    # Try node_modules location
-    if [[ -d "$PROJECT_ROOT/node_modules/@pennyfarthing/core/pennyfarthing_scripts" ]]; then
-        PACKAGE_ROOT="$PROJECT_ROOT/node_modules/@pennyfarthing/core"
-    fi
-fi
-
-# Set PYTHONPATH so Python can find pennyfarthing_scripts
-export PYTHONPATH="${PACKAGE_ROOT}:${PYTHONPATH:-}"
-
-exec python3 -m pennyfarthing_scripts.prime "$@"

package/pennyfarthing-dist/scripts/cyclist/is-cyclist.sh

@@ -1,21 +0,0 @@
-#!/bin/bash
-# Check if running inside Cyclist visual terminal
-# Usage: .pennyfarthing/scripts/cyclist/is-cyclist.sh
-#
-# Exit codes:
-#   0 - Running in Cyclist
-#   1 - Not running in Cyclist
-#
-# Output (JSON):
-#   {"cyclist": true/false}
-
-set -euo pipefail
-
-# Check the CYCLIST environment variable (set by ClaudeService.ensureProcess)
-if [[ "${CYCLIST:-}" == "1" ]]; then
-  echo '{"cyclist": true}'
-  exit 0
-else
-  echo '{"cyclist": false}'
-  exit 1
-fi

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

@@ -1,25 +0,0 @@
-# Git Scripts
-
-Scripts for Git operations, branching, and release management.
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `create-feature-branches.sh` | Create feature branches in repos |
-| `git-status-all.sh` | Show git status across all repos |
-| `worktree-manager.sh` | Manage git worktrees for parallel work |
-| `install-git-hooks.sh` | Install git hooks in project |
-| `release.sh` | Release workflow (merge develop to main) |
-
-## Usage
-
-```bash
-.pennyfarthing/scripts/git/create-feature-branches.sh feat/my-feature
-.pennyfarthing/scripts/git/release.sh
-```
-
-## Ownership
-
-- **Primary users:** SM agent, DevOps agent
-- **Maintained by:** Core Pennyfarthing team

package/pennyfarthing-dist/scripts/git/create-feature-branches.sh

@@ -1,267 +0,0 @@
-#!/usr/bin/env zsh
-# Create or checkout feature branches in Pennyfarthing repos
-# Idempotent, worktree-aware, branches from develop
-
-set -e
-
-# Load environment
-if [ -f .env ]; then
-    set -a; source .env; set +a
-elif [ -f ../.env ]; then
-    set -a; source ../.env; set +a
-fi
-
-show_help() {
-    cat << EOF
-Create Feature Branches - Idempotent branch creation/checkout
-
-Usage: ./create-feature-branches.sh <branch-name> [repos]
-
-Arguments:
-  branch-name    Branch name (e.g., feat/11-2-file-preview)
-  repos          Which repos to branch (default: all)
-                 Options: api, ui, all
-
-Repo Options:
-  api     - Pennyfarthing-api only
-  ui      - Pennyfarthing-ui only
-  all     - both repos (default)
-
-Examples:
-  # All repos (default)
-  ./create-feature-branches.sh feat/cross-repo-feature
-
-  # Pennyfarthing UI only
-  ./create-feature-branches.sh feat/11-2-ui-component ui
-
-  # Pennyfarthing API only
-  ./create-feature-branches.sh fix/validation-bug api
-
-Behavior:
-  - Idempotent: Checks out existing branches or creates new ones
-  - Worktree-aware: Detects main checkout vs worktree
-  - Always branches from develop
-  - Fetches latest develop before branching
-
-EOF
-}
-
-if [ -z "$1" ] || [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
-    show_help
-    exit 0
-fi
-
-BRANCH_NAME="$1"
-REPOS="${2:-all}"
-
-# Validate repos parameter
-if [[ ! "$REPOS" =~ ^(api|ui|all)$ ]]; then
-    echo "❌ Error: repos must be one of: api, ui, all"
-    echo "   Got: $REPOS"
-    echo ""
-    echo "Options:"
-    echo "  api     - Pennyfarthing-api only"
-    echo "  ui      - Pennyfarthing-ui only"
-    echo "  all     - both repos (default)"
-    exit 1
-fi
-
-# Detect if we're in a worktree
-CURRENT_DIR=$(pwd)
-if [[ "$CURRENT_DIR" == *"/worktrees/"* ]]; then
-    # Extract worktree name from path
-    WORKTREE_NAME=$(echo "$CURRENT_DIR" | sed -E 's|.*/worktrees/([^/]+).*|\1|')
-    REPO_BASE="$PROJECT_ROOT/worktrees/$WORKTREE_NAME"
-    echo "📂 Detected worktree: $WORKTREE_NAME"
-else
-    REPO_BASE="$PROJECT_ROOT"
-    echo "📂 Using main checkout"
-fi
-
-# Array to track processed repos for verification
-declare -a PROCESSED_REPOS
-
-# Function to create or checkout branch in a repo
-create_or_checkout_branch() {
-    local repo_path=$1
-    local repo_name=$2
-
-    if [ ! -d "$repo_path" ]; then
-        echo "⚠️  Skipping $repo_name: directory not found at $repo_path"
-        return
-    fi
-
-    cd "$repo_path"
-
-    echo ""
-    echo "🔧 Processing $repo_name..."
-
-    # Fetch latest from remote
-    echo "   Fetching from origin..."
-    git fetch origin --quiet
-
-    # Check if branch exists locally
-    if git show-ref --verify --quiet "refs/heads/$BRANCH_NAME"; then
-        echo "   ✅ Branch exists locally, checking out: $BRANCH_NAME"
-        git checkout "$BRANCH_NAME"
-    # Check if branch exists on remote
-    elif git show-ref --verify --quiet "refs/remotes/origin/$BRANCH_NAME"; then
-        echo "   ✅ Branch exists on remote, checking out and tracking: $BRANCH_NAME"
-        git checkout -b "$BRANCH_NAME" "origin/$BRANCH_NAME"
-    else
-        # Branch doesn't exist, create from develop
-        echo "   🌿 Creating new branch from develop: $BRANCH_NAME"
-
-        # Make sure we have latest develop
-        git fetch origin develop:develop --quiet 2>/dev/null || true
-
-        # Checkout develop first
-        if git show-ref --verify --quiet "refs/heads/develop"; then
-            git checkout develop --quiet
-            git pull origin develop --quiet
-        else
-            echo "   ⚠️  Local develop doesn't exist, fetching from remote"
-            git fetch origin develop:develop --quiet
-            git checkout develop --quiet
-        fi
-
-        # Create new branch
-        git checkout -b "$BRANCH_NAME"
-        echo "   ✅ Created: $BRANCH_NAME"
-    fi
-
-    # Show current status
-    CURRENT_BRANCH=$(git branch --show-current)
-    echo "   📍 Now on: $CURRENT_BRANCH"
-
-    # Track this repo for verification
-    PROCESSED_REPOS+=("$repo_path:$repo_name")
-}
-
-echo "🌿 Creating/checking out feature branches..."
-echo "   Branch: $BRANCH_NAME"
-echo "   Repos: $REPOS"
-
-# Process repos based on selection
-# When processing multiple repos, run in parallel for faster network I/O
-case "$REPOS" in
-    api)
-        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
-        ;;
-    ui)
-        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
-        ;;
-    all)
-        # Parallel execution for both repos
-        tmpdir=$(mktemp -d)
-        trap "rm -rf '$tmpdir'" EXIT
-        HAD_ERRORS=false
-
-        # Run both in parallel, capturing output
-        # Write to separate files to avoid race condition on shared file
-        (
-            create_or_checkout_branch "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
-            echo "$REPO_BASE/Pennyfarthing-api:Pennyfarthing-api" > "$tmpdir/api.processed"
-        ) > "$tmpdir/api.out" 2>&1 &
-        pid_api=$!
-
-        (
-            create_or_checkout_branch "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
-            echo "$REPO_BASE/Pennyfarthing-ui:Pennyfarthing-ui" > "$tmpdir/ui.processed"
-        ) > "$tmpdir/ui.out" 2>&1 &
-        pid_ui=$!
-
-        # Wait for both and capture exit codes
-        wait $pid_api; rc_api=$?
-        wait $pid_ui; rc_ui=$?
-
-        # Show output in order
-        [ -f "$tmpdir/api.out" ] && cat "$tmpdir/api.out"
-        [ -f "$tmpdir/ui.out" ] && cat "$tmpdir/ui.out"
-
-        # Rebuild PROCESSED_REPOS from separate files (avoids race condition)
-        [ -f "$tmpdir/api.processed" ] && PROCESSED_REPOS+=("$(cat "$tmpdir/api.processed")")
-        [ -f "$tmpdir/ui.processed" ] && PROCESSED_REPOS+=("$(cat "$tmpdir/ui.processed")")
-
-        # Check for failures
-        if [ $rc_api -ne 0 ] || [ $rc_ui -ne 0 ]; then
-            echo "⚠️  Some repos had errors"
-            HAD_ERRORS=true
-        fi
-        ;;
-esac
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🔍 Verification Summary"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-# Verify each processed repo
-for repo_info in "${PROCESSED_REPOS[@]}"; do
-    repo_path="${repo_info%%:*}"
-    repo_name="${repo_info##*:}"
-
-    if [ -d "$repo_path" ]; then
-        cd "$repo_path"
-
-        echo ""
-        echo "📦 $repo_name"
-        echo "   Path: $repo_path"
-
-        # Current branch
-        CURRENT_BRANCH=$(git branch --show-current)
-        echo "   Branch: $CURRENT_BRANCH"
-
-        # Check if branch matches expected
-        if [ "$CURRENT_BRANCH" = "$BRANCH_NAME" ]; then
-            echo "   ✅ Branch matches: $BRANCH_NAME"
-        else
-            echo "   ⚠️  Branch mismatch! Expected: $BRANCH_NAME, Got: $CURRENT_BRANCH"
-        fi
-
-        # Latest commit
-        COMMIT_INFO=$(git log -1 --format="%h - %s" 2>/dev/null)
-        echo "   Commit: $COMMIT_INFO"
-
-        # Check remote tracking
-        UPSTREAM=$(git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>/dev/null || echo "none")
-        if [ "$UPSTREAM" != "none" ]; then
-            echo "   Remote: $UPSTREAM"
-
-            # Check if up to date with remote
-            git fetch origin "$CURRENT_BRANCH" --quiet 2>/dev/null || true
-            LOCAL=$(git rev-parse @ 2>/dev/null)
-            REMOTE=$(git rev-parse @{u} 2>/dev/null || echo "none")
-
-            if [ "$LOCAL" = "$REMOTE" ]; then
-                echo "   Status: ✅ Up to date with remote"
-            elif [ "$REMOTE" = "none" ]; then
-                echo "   Status: ⚠️  No remote branch yet (push needed)"
-            else
-                BEHIND=$(git rev-list --count HEAD..@{u} 2>/dev/null || echo "0")
-                AHEAD=$(git rev-list --count @{u}..HEAD 2>/dev/null || echo "0")
-                if [ "$AHEAD" -gt 0 ] && [ "$BEHIND" -gt 0 ]; then
-                    echo "   Status: ⚠️  Diverged ($AHEAD ahead, $BEHIND behind)"
-                elif [ "$AHEAD" -gt 0 ]; then
-                    echo "   Status: ⬆️  $AHEAD commit(s) ahead of remote"
-                elif [ "$BEHIND" -gt 0 ]; then
-                    echo "   Status: ⬇️  $BEHIND commit(s) behind remote"
-                fi
-            fi
-        else
-            echo "   Remote: none (local branch only)"
-            echo "   Status: ⚠️  Not tracking remote (push with -u needed)"
-        fi
-    fi
-done
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-if [ "$HAD_ERRORS" = true ]; then
-    echo "⚠️  Done with errors. Check output above."
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    exit 1
-else
-    echo "✅ Done! All branches verified and ready."
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-fi