@pennyfarthing/core 7.0.2 → 7.4.1

package/pennyfarthing-dist/scripts/{check-context.sh → core/check-context.sh}

@@ -39,7 +39,7 @@ DEFAULT_WARNING_THRESHOLD=60
 DEFAULT_CRITICAL_THRESHOLD=85
 DEFAULT_MAX_TOKENS=200000
 
-# Load thresholds from .pennyfarthing/config.local.yaml (preferred) or settings.local.json (fallback)
+# Load thresholds and permission_mode from .pennyfarthing/config.local.yaml (preferred) or settings.local.json (fallback)
 PENNYFARTHING_CONFIG="${CLAUDE_PROJECT_DIR:-$PROJECT_DIR}/.pennyfarthing/config.local.yaml"
 SETTINGS_FILE="${CLAUDE_PROJECT_DIR:-$PROJECT_DIR}/.claude/settings.local.json"
 CONFIG=$(python3 -c "
@@ -50,18 +50,23 @@ imminent_threshold = $DEFAULT_IMMINENT_THRESHOLD
 warning_threshold = $DEFAULT_WARNING_THRESHOLD
 critical_threshold = $DEFAULT_CRITICAL_THRESHOLD
 max_tokens = $DEFAULT_MAX_TOKENS
+permission_mode = 'manual'  # Default to manual
 
 # First try .pennyfarthing/config.local.yaml (preferred location)
 try:
     import yaml
     with open('$PENNYFARTHING_CONFIG', 'r') as f:
         config = yaml.safe_load(f)
-        if config and 'context_budget' in config:
-            cb = config['context_budget']
-            imminent_threshold = cb.get('imminent_threshold', imminent_threshold)
-            warning_threshold = cb.get('warning_threshold', warning_threshold)
-            critical_threshold = cb.get('critical_threshold', critical_threshold)
-            max_tokens = cb.get('max_tokens', max_tokens)
+        if config:
+            if 'context_budget' in config:
+                cb = config['context_budget']
+                imminent_threshold = cb.get('imminent_threshold', imminent_threshold)
+                warning_threshold = cb.get('warning_threshold', warning_threshold)
+                critical_threshold = cb.get('critical_threshold', critical_threshold)
+                max_tokens = cb.get('max_tokens', max_tokens)
+            # Read permission_mode from workflow section
+            if 'workflow' in config and 'permission_mode' in config['workflow']:
+                permission_mode = config['workflow']['permission_mode']
 except:
     # Fallback to settings.local.json (legacy location)
     try:
@@ -73,6 +78,8 @@ except:
                 warning_threshold = cb.get('warning_threshold', warning_threshold)
                 critical_threshold = cb.get('critical_threshold', critical_threshold)
                 max_tokens = cb.get('max_tokens', max_tokens)
+            if 'workflow' in settings and 'permission_mode' in settings['workflow']:
+                permission_mode = settings['workflow']['permission_mode']
     except:
         pass
 
@@ -80,6 +87,7 @@ print(f'IMMINENT_THRESHOLD={imminent_threshold}')
 print(f'WARNING_THRESHOLD={warning_threshold}')
 print(f'CRITICAL_THRESHOLD={critical_threshold}')
 print(f'MAX_TOKENS={max_tokens}')
+print(f'PERMISSION_MODE={permission_mode}')
 " 2>/dev/null)
 
 # Apply config or use defaults
@@ -116,19 +124,26 @@ else
     fi
 fi
 
-# Parse last message for usage data
+# Parse transcript for baseline (first turn) and current (last turn) usage data
+# Baseline = system prompt overhead, cached per session
+# Usable = current - baseline (what the user's conversation has consumed)
 RESULT=$(python3 -c "
 import sys
 import json
 
 warning_threshold = $WARNING_THRESHOLD
 max_tokens = $MAX_TOKENS
+permission_mode = '$PERMISSION_MODE'
+tirepump_threshold = 60  # Threshold for TirePump auto-handoff
 
 with open('$TRANSCRIPT', 'r') as f:
     lines = f.readlines()
 
-# Find last line with usage data
-for line in reversed(lines):
+# Find first and last lines with usage data
+first_total = None
+last_total = None
+
+for line in lines:
     try:
         data = json.loads(line.strip())
         if 'message' in data and 'usage' in data['message']:
@@ -136,50 +151,91 @@ for line in reversed(lines):
             input_t = usage.get('input_tokens', 0)
             cache_read = usage.get('cache_read_input_tokens', 0)
             cache_create = usage.get('cache_creation_input_tokens', 0)
-
             total = cache_read + cache_create + input_t
-            pct = (total / max_tokens) * 100
-
-            print(f'CONTEXT_TOKENS={total}')
-            print(f'CONTEXT_PERCENT={pct:.0f}')
-            # Use configurable warning threshold
-            if pct > warning_threshold:
-                print('CONTEXT_STATUS=HIGH')
-                print('HANDOFF_MODE=auto')
-            else:
-                print('CONTEXT_STATUS=OK')
-                print('HANDOFF_MODE=ask')
-            break
+
+            if first_total is None:
+                first_total = total
+            last_total = total
     except:
         continue
+
+if last_total is not None:
+    # Baseline is first turn's total (system prompt + tools + CLAUDE.md etc)
+    baseline = first_total if first_total is not None else 0
+
+    # Usable tokens = what user's conversation has consumed
+    usable_tokens = last_total - baseline
+
+    # Available capacity = max minus baseline overhead
+    available_capacity = max_tokens - baseline
+
+    # Usable percent = conversation usage as % of available capacity
+    usable_pct = (usable_tokens / available_capacity * 100) if available_capacity > 0 else 0
+
+    # Total percent (for backwards compatibility)
+    total_pct = (last_total / max_tokens) * 100
+
+    # Output all values
+    print(f'CONTEXT_TOKENS={last_total}')
+    print(f'CONTEXT_PERCENT={total_pct:.0f}')
+    print(f'CONTEXT_BASELINE={baseline}')
+    print(f'CONTEXT_USABLE_TOKENS={usable_tokens}')
+    print(f'CONTEXT_USABLE_PERCENT={usable_pct:.0f}')
+    print(f'CONTEXT_AVAILABLE={available_capacity}')
+    print(f'PERMISSION_MODE={permission_mode}')
+
+    # Use usable percent for status decisions (more accurate for user)
+    if usable_pct > warning_threshold:
+        print('CONTEXT_STATUS=HIGH')
+        print('HANDOFF_MODE=auto')
+    else:
+        print('CONTEXT_STATUS=OK')
+        print('HANDOFF_MODE=ask')
+
+    # TirePump: Use CONTEXT_CLEAR (clear + load next agent) when:
+    # 1. permission_mode is 'turbo' (auto-handoff enabled)
+    # 2. context > 60% (tirepump_threshold)
+    # This enables continuous autonomous runs without manual intervention
+    use_tirepump = permission_mode == 'turbo' and usable_pct > tirepump_threshold
+    print(f'USE_TIREPUMP={str(use_tirepump).lower()}')
+
+    # Cyclist detection: Check if CYCLIST env var is set to '1'
+    # Markers should only be emitted when running inside Cyclist
+    import os
+    is_cyclist = os.environ.get('CYCLIST', '') == '1'
+    print(f'IS_CYCLIST={str(is_cyclist).lower()}')
 " 2>/dev/null)
 
 if [ "$HUMAN_MODE" = "true" ]; then
     eval "$RESULT"
-    if [ "$CONTEXT_STATUS" = "HIGH" ]; then
-        echo "⚠️  Context: ${CONTEXT_PERCENT}% (${CONTEXT_TOKENS} tokens) - AUTO-HANDOFF"
+    if [ "$USE_TIREPUMP" = "true" ]; then
+        echo "🔄 Context: ${CONTEXT_USABLE_PERCENT}% used (${CONTEXT_USABLE_TOKENS} of ${CONTEXT_AVAILABLE} available) - TIREPUMP (clear + next agent)"
+    elif [ "$CONTEXT_STATUS" = "HIGH" ]; then
+        echo "⚠️  Context: ${CONTEXT_USABLE_PERCENT}% used (${CONTEXT_USABLE_TOKENS} of ${CONTEXT_AVAILABLE} available) - AUTO-HANDOFF"
     else
-        echo "✅ Context: ${CONTEXT_PERCENT}% (${CONTEXT_TOKENS} tokens) - OK to continue"
+        echo "✅ Context: ${CONTEXT_USABLE_PERCENT}% used (${CONTEXT_USABLE_TOKENS} of ${CONTEXT_AVAILABLE} available)"
     fi
-
-    # Output warning messages at configurable thresholds
-    if [ -n "$CONTEXT_PERCENT" ]; then
-        if [ "$CONTEXT_PERCENT" -ge "$CRITICAL_THRESHOLD" ] 2>/dev/null; then
-            echo "CONTEXT_WARNING: Critical (${CONTEXT_PERCENT}%) - checkpoint and handoff recommended"
-        elif [ "$CONTEXT_PERCENT" -ge "$WARNING_THRESHOLD" ] 2>/dev/null; then
-            echo "CONTEXT_WARNING: High (${CONTEXT_PERCENT}%) - consider handoff soon"
+    echo "   Overhead: ${CONTEXT_BASELINE} tokens (system prompt + tools)"
+    echo "   Mode: ${PERMISSION_MODE}"
+
+    # Output warning messages at configurable thresholds (use usable percent)
+    if [ -n "$CONTEXT_USABLE_PERCENT" ]; then
+        if [ "$CONTEXT_USABLE_PERCENT" -ge "$CRITICAL_THRESHOLD" ] 2>/dev/null; then
+            echo "CONTEXT_WARNING: Critical (${CONTEXT_USABLE_PERCENT}%) - checkpoint and handoff recommended"
+        elif [ "$CONTEXT_USABLE_PERCENT" -ge "$WARNING_THRESHOLD" ] 2>/dev/null; then
+            echo "CONTEXT_WARNING: High (${CONTEXT_USABLE_PERCENT}%) - consider handoff soon"
         fi
     fi
 else
     echo "$RESULT"
 
-    # Also output warnings in non-human mode for scripting
+    # Also output warnings in non-human mode for scripting (use usable percent)
     eval "$RESULT" 2>/dev/null || true
-    if [ -n "$CONTEXT_PERCENT" ]; then
-        if [ "$CONTEXT_PERCENT" -ge "$CRITICAL_THRESHOLD" ] 2>/dev/null; then
+    if [ -n "$CONTEXT_USABLE_PERCENT" ]; then
+        if [ "$CONTEXT_USABLE_PERCENT" -ge "$CRITICAL_THRESHOLD" ] 2>/dev/null; then
             echo "CONTEXT_WARNING=Critical"
             echo "CONTEXT_RECOMMENDATION=checkpoint and handoff recommended"
-        elif [ "$CONTEXT_PERCENT" -ge "$WARNING_THRESHOLD" ] 2>/dev/null; then
+        elif [ "$CONTEXT_USABLE_PERCENT" -ge "$WARNING_THRESHOLD" ] 2>/dev/null; then
             echo "CONTEXT_WARNING=High"
             echo "CONTEXT_RECOMMENDATION=consider handoff soon"
         fi

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

@@ -0,0 +1,90 @@
+#!/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}"
+
+# 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
+  cat <<EOF
+---
+AGENT_COMMAND:
+  marker: ""
+  fallback: "Run \`/${NEXT_AGENT}\` to continue"
+---
+EOF
+elif [[ "$USE_TIREPUMP" == "true" ]]; then
+  # Cyclist + TirePump - context clear marker
+  cat <<EOF
+---
+AGENT_COMMAND:
+  marker: "<!-- CYCLIST:CONTEXT_CLEAR:/${NEXT_AGENT} -->"
+  fallback: "Run \`/${NEXT_AGENT}\` to continue"
+---
+EOF
+else
+  # Cyclist, no TirePump - handoff marker
+  cat <<EOF
+---
+AGENT_COMMAND:
+  marker: "<!-- CYCLIST:HANDOFF:/${NEXT_AGENT} -->"
+  fallback: "Run \`/${NEXT_AGENT}\` to continue"
+---
+EOF
+fi

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

@@ -0,0 +1,136 @@
+#!/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 (CLAUDE.md skipped - already in system prompt):
+# 1. Sprint summary (current-sprint.yaml key fields)
+# 2. Active session (.session/*-session.md)
+# 3. Agent sidecar (if --agent provided)
+# 4. Agent behavior guide (combined protocols for all agents)
+# 5. Domain docs (--full only)
+
+set -euo pipefail
+
+# Load shared functions
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/../sprint/sprint-common.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      Skip all context (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
+}
+
+# CLAUDE.md is already loaded by Claude Code system prompt - skip it
+
+# Stop here for minimal mode
+if [[ "$MINIMAL" == "true" ]]; then
+    exit 0
+fi
+
+# 1. Sprint summary (uses shared functions from sprint-common.sh)
+if [[ -f "$(get_sprint_file)" ]]; then
+    print_header "Sprint Context"
+
+    # Use shared functions for consistent output
+    summary=$(get_sprint_summary)
+    if [[ -n "$summary" ]]; then
+        echo "$summary"
+    fi
+
+    progress=$(get_sprint_progress)
+    if [[ -n "$progress" ]]; then
+        echo "$progress"
+    fi
+fi
+
+# 2. Active session (if exists) - extract header metadata + current assessment
+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")"
+
+    # Extract header (everything before first ## heading)
+    # This includes: title, metadata fields (Phase, Workflow, Repos, Branch, etc.)
+    awk '/^## / {exit} {print}' "$SESSION_FILE"
+
+    # Find the most recent assessment section (workflow-agnostic)
+    # Assessment sections are named: "## {Agent} Assessment" (TEA, Dev, Reviewer, SM, etc.)
+    # Show the LAST one in the file as it represents current state
+    last_assessment=$(grep -n '^## .*Assessment' "$SESSION_FILE" | tail -1 | cut -d: -f1)
+
+    if [[ -n "$last_assessment" ]]; then
+        echo ""
+        echo "---"
+        # Extract from that line to next ## or EOF
+        awk -v start="$last_assessment" '
+            NR >= start {
+                if (NR > start && /^## /) exit
+                print
+            }
+        ' "$SESSION_FILE"
+    fi
+fi
+
+# 3. 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
+
+# 4. Agent behavior guide (combined protocols for all agents)
+if [[ -n "$AGENT_NAME" ]]; then
+    BEHAVIOR_GUIDE="$PROJECT_ROOT/.pennyfarthing/guides/agent-behavior.md"
+    if [[ -f "$BEHAVIOR_GUIDE" ]]; then
+        print_header "Agent Behavior Guide"
+        cat "$BEHAVIOR_GUIDE"
+    fi
+fi
+
+# 5. 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/core/run.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env zsh
+# Bootstrap script - finds PROJECT_ROOT and runs the requested script
+# Usage: ./scripts/run.sh <category/script-name> [args...]
+#
+# Scripts are organized in categorical subdirectories:
+#   core/     - Essential scripts (agent-session.sh, check-context.sh)
+#   workflow/ - Workflow mechanics (finish-story.sh, check.sh)
+#   sprint/   - Sprint operations (sprint-status.sh, archive-story.sh)
+#   story/    - Story operations (create-story.sh, size-story.sh)
+#   jira/     - Jira integration (jira-claim-story.sh, jira-reconcile.sh)
+#   git/      - Git operations (create-feature-branches.sh, release.sh)
+#   theme/    - Theme operations (list-themes.sh)
+#   test/     - Test infrastructure (test-setup.sh)
+#   lib/      - Shared libraries (common.sh, logging.sh)
+#   misc/     - Uncategorized utilities
+#   hooks/    - Git and Claude hooks
+#
+# Full paths are REQUIRED to avoid ambiguity:
+#   ./scripts/run.sh core/agent-session.sh start sm
+#   ./scripts/run.sh jira/jira-claim-story.sh MSSCI-12345
+#
+# This solves the absolute path problem by:
+# 1. Finding PROJECT_ROOT by looking for the .claude/ directory
+# 2. Exporting PROJECT_ROOT for the script to use
+# 3. Running the script with full absolute paths
+
+set -euo pipefail
+
+# Find PROJECT_ROOT by looking for .claude/ marker
+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: Could not find project root (no .claude/ directory found)" >&2
+        exit 1
+    fi
+}
+
+PROJECT_ROOT="$(find_project_root)"
+export PROJECT_ROOT
+
+# Get the script to run
+if [[ $# -lt 1 ]]; then
+    echo "Usage: ./scripts/run.sh <category/script-name> [args...]" >&2
+    echo "Example: ./scripts/run.sh core/agent-session.sh start sm" >&2
+    echo "Example: ./scripts/run.sh jira/jira-claim-story.sh MSSCI-12345" >&2
+    exit 1
+fi
+
+SCRIPT_NAME="$1"
+shift
+
+# Single source of truth: .pennyfarthing/scripts
+SCRIPTS_DIR="$PROJECT_ROOT/.pennyfarthing/scripts"
+if [[ ! -d "$SCRIPTS_DIR" ]]; then
+    echo "Error: Scripts directory not found: $SCRIPTS_DIR" >&2
+    exit 1
+fi
+
+# Full path required - script must include category
+SCRIPT_PATH="$SCRIPTS_DIR/$SCRIPT_NAME"
+
+if [[ -f "$SCRIPT_PATH" ]]; then
+    exec "$SCRIPT_PATH" "$@"
+else
+    echo "Error: Script not found: $SCRIPT_NAME" >&2
+    echo "Full path required. Available categories:" >&2
+    echo "  core/, workflow/, sprint/, story/, jira/, git/, theme/, test/, lib/, misc/, hooks/, cyclist/" >&2
+    echo "Example: run.sh core/agent-session.sh start sm" >&2
+    exit 1
+fi

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

@@ -0,0 +1,21 @@
+#!/bin/bash
+# Check if running inside Cyclist visual terminal
+# Usage: .pennyfarthing/scripts/core/run.sh 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

@@ -0,0 +1,25 @@
+# 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/core/run.sh git/create-feature-branches.sh feat/my-feature
+.pennyfarthing/scripts/core/run.sh git/release.sh
+```
+
+## Ownership
+
+- **Primary users:** SM agent, DevOps agent
+- **Maintained by:** Core Pennyfarthing team

package/pennyfarthing-dist/scripts/{utils → git}/create-feature-branches.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env zsh
-# Create or checkout feature branches in conductor repos
+# Create or checkout feature branches in Pennyfarthing repos
 # Idempotent, worktree-aware, branches from develop
 
 set -e
@@ -11,10 +11,6 @@ elif [ -f ../.env ]; then
     set -a; source ../.env; set +a
 fi
 
-# Find project root
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/find-root.sh"
-
 show_help() {
     cat << EOF
 Create Feature Branches - Idempotent branch creation/checkout
@@ -27,18 +23,18 @@ Arguments:
                  Options: api, ui, all
 
 Repo Options:
-  api     - conductor-api only
-  ui      - conductor-ui only
+  api     - Pennyfarthing-api only
+  ui      - Pennyfarthing-ui only
   all     - both repos (default)
 
 Examples:
   # All repos (default)
   ./create-feature-branches.sh feat/cross-repo-feature
 
-  # Conductor UI only
+  # Pennyfarthing UI only
   ./create-feature-branches.sh feat/11-2-ui-component ui
 
-  # Conductor API only
+  # Pennyfarthing API only
   ./create-feature-branches.sh fix/validation-bug api
 
 Behavior:
@@ -64,8 +60,8 @@ if [[ ! "$REPOS" =~ ^(api|ui|all)$ ]]; then
     echo "   Got: $REPOS"
     echo ""
     echo "Options:"
-    echo "  api     - conductor-api only"
-    echo "  ui      - conductor-ui only"
+    echo "  api     - Pennyfarthing-api only"
+    echo "  ui      - Pennyfarthing-ui only"
     echo "  all     - both repos (default)"
     exit 1
 fi
@@ -149,14 +145,14 @@ echo "   Repos: $REPOS"
 # Process repos based on selection
 case "$REPOS" in
     api)
-        create_or_checkout_branch "$REPO_BASE/conductor-api" "conductor-api"
+        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
         ;;
     ui)
-        create_or_checkout_branch "$REPO_BASE/conductor-ui" "conductor-ui"
+        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
         ;;
     all)
-        create_or_checkout_branch "$REPO_BASE/conductor-api" "conductor-api"
-        create_or_checkout_branch "$REPO_BASE/conductor-ui" "conductor-ui"
+        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
+        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
         ;;
 esac
 

package/pennyfarthing-dist/scripts/{utils → git}/git-status-all.sh

@@ -17,7 +17,7 @@ fi
 PROJECT_ROOT="${PROJECT_ROOT:-$(cd "$SCRIPT_DIR/../.." && pwd)}"
 
 # Source repo utilities for dynamic repo configuration
-source "$SCRIPT_DIR/../repo-utils.sh"
+source "$SCRIPT_DIR/../misc/repo-utils.sh"
 
 # Colors
 GREEN='\033[0;32m'

package/pennyfarthing-dist/scripts/{worktree-manager.sh → git/worktree-manager.sh}

@@ -8,10 +8,6 @@
 
 set -e
 
-# Find project root
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/utils/find-root.sh"
-
 # Load environment
 if [ -f "$PROJECT_ROOT/.env" ]; then
     set -a; source "$PROJECT_ROOT/.env"; set +a