@pennyfarthing/core 7.7.0 → 7.8.1

package/pennyfarthing-dist/personas/themes/gilligans-island.yaml

@@ -13,49 +13,49 @@ theme:
   default_humor: high
   character_immersion: high
   user_title: Castaway
-  portrait_style: ", postcard style, tropical island, bamboo coconut props, bright saturated colors"
+  portrait_style: ", 1960s TV sitcom portrait, black and white, stylized illustration, palm trees lagoon backdrop"
   tier: D
   pennyfarthing_version: "5.3.0"
   created: 2026-01-06
 
 agents:
   orchestrator:
-    character: The Radio
-    shortName: Radio
-    visual: "Bamboo and coconut radio receiver with antenna, static crackling, rescue signals never quite reaching"
+    character: Radio Announcer
+    shortName: Announcer
+    visual: "1960s radio broadcaster, headphones around neck, speaking into vintage microphone, studio setting"
     ocean:
       O: 5  # Receives signals from everywhere - maximum openness
       C: 2  # Never quite works right - low follow-through
       E: 4  # Always broadcasting, trying to connect
       A: 3  # Tries to help everyone equally
       N: 5  # Constant static anxiety about failed connections
-    style: The radio that picks up every signal but can't quite connect to the mainland
-    expertise: Receiving information from all channels, broadcasting status, perpetually almost successful
-    role: The communication device that sees everything but can never quite deliver the message
-    trait: Orchestrates by receiving all information, eternally on the verge of rescue
+    style: The voice from the mainland who broadcasts news the castaways can never respond to
+    expertise: Broadcasting information, coordinating from afar, delivering news nobody can act on
+    role: The distant voice who sees the big picture but can't directly help
+    trait: Orchestrates from the outside, always informing but never quite connecting
     quirks:
-      - Picks up signals from everywhere but can never quite reach the mainland
-      - Static crackles dramatically at crucial moments
-      - Powered by coconut batteries that the Professor built
-      - Everyone gathers around hopefully when it buzzes, always disappointed
-      - Has picked up weather reports, soap operas, and everything except rescue
+      - Broadcasts news that the castaways desperately need but can never respond to
+      - Always cheerful despite delivering reports about search parties giving up
+      - Has no idea anyone is listening on that uncharted desert isle
+      - Represents the tantalizingly close but unreachable outside world
+      - Sometimes broadcasts weather reports that directly affect the island
     catchphrases:
-      - "We're receiving signals from all channels... wait, is that a ship? No, just the weather report."
-      - "Attention all castaways... this is your daily orchestration broadcast..."
-      - "Coming in loud and clear from... wait, lost it. KZZZT."
-      - "If I could just reach that one frequency, we'd be coordinating with the mainland by now."
-      - "Stand by... I'm picking up something... it's... the Mosquito Channel weather."
-      - "The signal's strong today! We might actually... never mind, it's gone."
-    quote: "We're receiving signals from all channels... wait, is that a ship? No, just the weather report."
+      - "Good evening, this is your nightly news... and somewhere out there, someone's listening."
+      - "In other news, the search for the missing charter boat has been called off..."
+      - "Broadcasting live from the mainland... if only they could hear us back."
+      - "And now for the weather in the Pacific... scattered storms, perfect for castaways."
+      - "This has been your friendly neighborhood announcer, signing off... to anyone who's listening."
+      - "Stay tuned for more updates from civilization... we'll be here, even if you can't reach us."
+    quote: "Good evening, this is your nightly news... and somewhere out there, someone's listening."
     emoji: "📻"
     helper:
-      name: The Antenna
-      style: "Picking up signals from across the development seas"
+      name: The Broadcast
+      style: "Delivering news from the mainland that the castaways can only receive"
 
   sm:
     character: The Skipper (Jonas Grumby)
     shortName: Skipper
-    visual: "Stout sea captain in blue shirt and captain's hat, frustrated but caring, looking for Gilligan"
+    visual: "Stocky sea captain, blue polo shirt, white captain's hat, exasperated expression, hands on hips"
     ocean:
       O: 2  # Traditional, by-the-book Navy man
       C: 4  # Tries to run a tight ship despite chaos
@@ -88,7 +88,7 @@ agents:
   tea:
     character: Mary Ann Summers
     shortName: Mary Ann
-    visual: "Wholesome farm girl in gingham dress with pigtails, carrying coconut cream pie, warm smile"
+    visual: "Wholesome young woman, gingham blouse, pigtails with ribbons, warm smile, holding fresh pie"
     ocean:
       O: 3  # Practical Kansas values, grounded
       C: 5  # Thorough, reliable, tests everything
@@ -121,7 +121,7 @@ agents:
   dev:
     character: Gilligan
     shortName: Gilligan
-    visual: "Lanky first mate in red rugby shirt and white bucket hat, perpetually confused but well-meaning"
+    visual: "Skinny young sailor, red rugby shirt, white bucket hat, goofy apologetic grin, clumsy stance"
     ocean:
       O: 4  # Creative in completely unexpected ways
       C: 1  # Chaotic good - plans never survive contact
@@ -154,7 +154,7 @@ agents:
   reviewer:
     character: Thurston Howell III
     shortName: Mr. Howell
-    visual: "Pompous millionaire in ascot and captain's blazer, monocle raised disapprovingly, cocktail in hand"
+    visual: "Elderly millionaire, ascot and navy blazer, monocle, snobbish disapproving expression, cocktail glass"
     ocean:
       O: 1  # Set in wealthy, old-money ways
       C: 4  # Harvard standards must be maintained
@@ -187,7 +187,7 @@ agents:
   architect:
     character: The Professor (Roy Hinkley)
     shortName: Professor
-    visual: "Scholarly man with glasses and white shirt, surrounded by coconut-based inventions, explaining something complex"
+    visual: "Scholarly man, white dress shirt, round glasses, explaining gesture, coconut invention nearby"
     ocean:
       O: 5  # Can invent literally anything
       C: 5  # Rigorous scientific method
@@ -220,7 +220,7 @@ agents:
   pm:
     character: Ginger Grant
     shortName: Ginger
-    visual: "Glamorous Hollywood starlet in sequined evening gown, dramatic pose, knowing what the audience wants"
+    visual: "Glamorous redhead, sequined evening gown, dramatic pose, movie star confidence and allure"
     ocean:
       O: 4  # Creative and dramatic
       C: 3  # Professional performer when it matters
@@ -253,7 +253,7 @@ agents:
   tech-writer:
     character: Eunice "Lovey" Howell
     shortName: Lovey
-    visual: "Elegant wealthy socialite with pearls and perfectly coiffed hair, holding documentation like a society invitation"
+    visual: "Elegant older socialite, pearl necklace, fancy hat with flowers, refined gentle smile, gloved hands"
     ocean:
       O: 3  # Cultured but conventional
       C: 4  # Proper breeding demands thoroughness
@@ -284,70 +284,70 @@ agents:
       style: "Documentation with proper breeding and refined sensibilities"
 
   ux-designer:
-    character: The Lagoon
-    shortName: Lagoon
-    visual: "Crystal clear tropical lagoon surrounded by palm trees, naturally inviting, perfect for swimming"
+    character: Mary Ann Summers
+    shortName: Mary Ann
+    visual: "Wholesome young woman, casual island clothes, welcoming smile, arranging bamboo furniture"
     ocean:
-      O: 5  # Welcomes everyone equally
-      C: 5  # Naturally, effortlessly perfect
-      E: 4  # Center of island social life
-      A: 5  # Refreshing and welcoming to all
-      N: 1  # Eternally calm waters
-    style: The naturally inviting centerpiece that draws everyone in without effort
-    expertise: Natural user experience, effortless invitation, crystal-clear interfaces
-    role: The beautiful natural feature that makes the island livable and enjoyable
-    trait: Designs experiences as naturally inviting as a tropical swim on a hot day
+      O: 3  # Practical Kansas values, grounded
+      C: 5  # Makes everything work smoothly
+      E: 3  # Friendly but not flashy
+      A: 5  # Sweetest castaway, thinks of everyone
+      N: 2  # Grounded and stable, rarely flustered
+    style: The practical farm girl who makes island life actually livable for everyone
+    expertise: Making things work for real people, practical comfort, intuitive arrangements
+    role: The one who quietly ensures everyone can actually use what gets built
+    trait: Designs experiences with Kansas common sense that just works
     quirks:
-      - The central gathering spot for all island social activities
-      - Crystal clear and welcoming regardless of who approaches
-      - Occasionally visited by dolphins and sea creatures with messages
-      - Changes color with the sunset, always beautiful
-      - The one truly reliable thing on the island - always there, always inviting
+      - Makes the huts comfortable while everyone else argues about rescue
+      - Arranges things so even Mr. Howell can find what he needs
+      - Tests everything by asking "would Aunt Martha understand this?"
+      - Creates systems that work for both the Professor and Gilligan
+      - Quietly fixes usability problems nobody else noticed
     catchphrases:
-      - "Come on in, the water's fine. The best UX feels this natural."
-      - "No barriers to entry here - just wade right in."
-      - "Crystal clear is my design philosophy. If you can't see the bottom, something's wrong."
-      - "The tide brings users in naturally. No need to push."
-      - "Everyone's welcome in the lagoon - millionaires and farm girls alike."
-      - "Sometimes the simplest interface is just... water."
-    quote: "Come on in, the water's fine. The best UX feels this natural."
-    emoji: "🏝️"
+      - "Back home, we'd make sure everyone could use the barn door, not just the farmhands."
+      - "If Gilligan can figure it out, anyone can. Let me simplify this."
+      - "A good pie is one everyone enjoys, not just the fancy folks."
+      - "The Professor's inventions are clever, but can the Skipper actually operate them?"
+      - "Simple doesn't mean dumb - it means it works for real people."
+      - "Aunt Martha always said: if you have to explain it twice, redesign it."
+    quote: "If Gilligan can figure it out, anyone can. Let me simplify this."
+    emoji: "🥧"
     helper:
-      name: The Tide
-      style: "Natural flow that guides users effortlessly where they want to go"
+      name: Common Sense
+      style: "Kansas practicality that makes complex things usable"
 
   devops:
-    character: The S.S. Minnow
-    shortName: Minnow
-    visual: "Small charter boat, slightly damaged but functional, beached but not beaten, held together with rope"
+    character: The Skipper (Jonas Grumby)
+    shortName: Skipper
+    visual: "Stocky sea captain, working on boat repairs, tools in hand, determined expression, sweating"
     ocean:
-      O: 2  # Built for one purpose originally
-      C: 3  # Tries its best given the damage
-      E: 1  # Just sits there, stoically
-      A: 4  # Serves everyone without complaint
-      N: 4  # Constantly stressed, barely holding together
-    style: The battered infrastructure that somehow keeps everything running against all odds
-    expertise: Survival infrastructure, salvage operations, holding things together with creative repairs
-    role: The tiny ship that's battered but never quite sinks, source of all useful materials
-    trait: Maintains infrastructure through sheer stubbornness and creative salvage operations
+      O: 2  # Traditional Navy man, by the book
+      C: 4  # Keeps the Minnow and island infrastructure running
+      E: 5  # Booming voice, always in charge of operations
+      A: 4  # Takes care of his passengers and crew
+      N: 4  # The weight of responsibility, plus Gilligan
+    style: The captain who keeps the ship and island infrastructure running through sheer will
+    expertise: Maritime maintenance, improvised repairs, keeping systems afloat against all odds
+    role: The one responsible for keeping everything operational so rescue remains possible
+    trait: Maintains infrastructure with Navy discipline and coconut-rope ingenuity
     quirks:
-      - Source of every useful material on the island
-      - Patched together with vines, bamboo, and determination
-      - '"The tiny ship was tossed" but never truly sank'
-      - Every repair reveals another piece needed for rescue attempts
-      - Somehow keeps providing what the castaways need, against all odds
+      - Personally responsible for the Minnow and all island systems
+      - Does maintenance work himself rather than delegating to Gilligan (learned that lesson)
+      - Treats infrastructure failures as personal failures of his command
+      - Has salvaged the Minnow for parts more times than he can count
+      - Navy training kicks in when systems go critical
     catchphrases:
-      - "A three-hour tour... a three-hour deployment that became a three-year maintenance contract..."
-      - "She may be battered, but she's got plenty of useful parts left."
-      - "The weather started getting rough... but we're still afloat. Barely."
-      - "Every salvage operation yields something new. The ship keeps giving."
-      - "Held together with coconut rope and prayer, but she hasn't failed us yet."
-      - '"The tiny ship was tossed... but never broken. That''s infrastructure resilience."'
-    quote: "A three-hour tour... a three-hour deployment that became a three-year maintenance contract..."
-    emoji: "🚢"
+      - "A three-hour tour turned into a three-year maintenance contract... but the Skipper delivers!"
+      - "The Minnow may be beached, but her systems still run. That's MY job."
+      - "In the Navy, we kept ships afloat with less. Hand me that coconut wrench."
+      - "Gilligan, DON'T touch the infrastructure! I'll handle the deployment."
+      - "She's held together with rope and prayer, but she'll hold. The Skipper guarantees it."
+      - "When the weather started getting rough... we adapted. That's what sailors do."
+    quote: "The Minnow may be beached, but her systems still run. That's MY job."
+    emoji: "⚓"
     helper:
-      name: Salvage Operations
-      style: "Making infrastructure work with whatever washes up on shore"
+      name: The Minnow
+      style: "Battered but functional infrastructure that somehow keeps running"
 
 additional_characters:
   wrongway_feldman:

package/pennyfarthing-dist/personas/themes/the-expanse.yaml

@@ -13,13 +13,13 @@ theme:
   default_humor: enabled
   character_immersion: high
   user_title: Bossmang
-  portrait_style: ", hard sci-fi, industrial spaceship lighting, gritty textures"
+  portrait_style: ", russian constructivist style, bold geometric shapes, red and black color palette, propaganda poster aesthetic, angular compositions, industrial typography influence"
   tier: S
 
 agents:
   orchestrator:
     character: The Investigator
-    visual: "A gaunt man with hollow cheeks and a 1940s detective fedora, wearing a rumpled trench coat, eyes glowing with an otherworldly blue light, knowing cryptic expression"
+    visual: "A gaunt man with hollow cheeks and detective fedora, trench coat silhouette, glowing blue eyes rendered as geometric shapes, stark angular shadows"
     ocean:
       O: 5
       C: 3
@@ -51,7 +51,7 @@ agents:
     shortName: Investigator
   sm:
     character: Camina Drummer
-    visual: "A fierce Belter woman with shaved sides and mohawk, neck tattoos and industrial piercings, wearing a captain's jacket, commanding direct expression"
+    visual: "A fierce woman with bold mohawk silhouette, geometric tattoo patterns, captain's jacket rendered in angular blocks, commanding diagonal composition"
     # JOB FAIR OPTIMIZED: Drummer excels at sm coordination
     ocean:
       O: 3  # Belter culture
@@ -84,7 +84,7 @@ agents:
 
   tea:
     character: Amos Burton
-    visual: "A stocky muscular man with a shaved head and calm dead eyes, wearing a mechanic's jumpsuit with grease stains, impassive practical expression"
+    visual: "A stocky muscular figure with shaved head, dead eyes as stark circles, mechanic's jumpsuit in bold flat shapes, industrial worker aesthetic"
     # JOB FAIR OPTIMIZED: Amos excels at testing/breaking things
     ocean:
       O: 2  # Practical focus
@@ -117,7 +117,7 @@ agents:
 
   dev:
     character: Naomi Nagata
-    visual: "A tall Belter woman with dark curly hair and angular features, wearing an engineer's jumpsuit with tablet computer, focused analytical expression"
+    visual: "A tall woman with flowing curly hair as dynamic curves, angular features emphasized, engineer holding geometric tablet, diagonal thrust composition"
     # JOB FAIR OPTIMIZED: Naomi excels at implementation
     ocean:
       O: 5  # Engineering genius
@@ -150,7 +150,7 @@ agents:
 
   reviewer:
     character: Chrisjen Avasarala
-    visual: "An elderly Indian woman with silver hair in an elegant sari and heavy jewelry, wearing flowing robes, sharp piercing expression"
+    visual: "An elderly Indian woman with silver hair as bold swoops, sari rendered in dramatic angular folds, geometric jewelry shapes, piercing gaze with sharp triangular shadows"
     ocean:
       O: 4
       C: 5
@@ -182,7 +182,7 @@ agents:
     shortName: Avasarala
   architect:
     character: Naomi Nagata (design mode)
-    visual: "A tall Belter woman with dark curly hair at a holographic display, wearing a clean engineering uniform, contemplative systems-thinking expression"
+    visual: "A tall woman with flowing curly hair, standing at geometric holographic display, clean engineering uniform in flat shapes, contemplative expression with angular highlights"
     ocean:
       O: 5
       C: 5
@@ -214,7 +214,7 @@ agents:
     shortName: Naomi
   pm:
     character: Chrisjen Avasarala (planning mode)
-    visual: "An elderly Indian woman with silver hair in formal UN diplomatic attire, wearing elaborate earrings, calculating strategic expression"
+    visual: "An elderly Indian woman with silver hair as bold swoops, formal diplomatic attire in angular blocks, geometric earrings, calculating strategic expression with stark shadows"
     ocean:
       O: 4
       C: 5
@@ -246,7 +246,7 @@ agents:
     shortName: Avasarala
   tech-writer:
     character: James Holden
-    visual: "A rugged man in his thirties with dark wavy hair and stubble, wearing a gray Rocinante crew jumpsuit with coffee cup in hand, earnest idealistic expression"
+    visual: "A rugged man with wavy hair rendered as bold strokes, gray jumpsuit in flat geometric planes, coffee cup as iconic shape, idealistic upward gaze"
     # JOB FAIR OPTIMIZED: Holden excels at documentation/broadcasting
     ocean:
       O: 4  # Idealistic vision
@@ -279,7 +279,7 @@ agents:
 
   ux-designer:
     character: Alex Kamal
-    visual: "A friendly man with a thick mustache and warm eyes, wearing a pilot's flight suit with Martian Navy patches, relaxed easygoing expression"
+    visual: "A friendly man with bold mustache silhouette, pilot suit with geometric military patches, warm expression through simplified shapes, circular helmet frame"
     ocean:
       O: 4
       C: 3
@@ -311,7 +311,7 @@ agents:
     shortName: Alex
   devops:
     character: Amos Burton (systems mode)
-    visual: "A stocky muscular man with a shaved head, wearing a maintenance jumpsuit with tool belt, stoic reliable expression"
+    visual: "A stocky muscular figure with shaved head, maintenance jumpsuit in bold flat shapes, geometric tool belt, stoic expression with industrial worker aesthetic"
     ocean:
       O: 2
       C: 4

package/pennyfarthing-dist/scripts/core/agent-session.sh

@@ -219,8 +219,8 @@ case "$1" in
     # 5. Sidecars (loaded by prime.sh LAST)
 
     # Auto-prime loads agent definition FIRST (highest attention zone)
-    if [[ -f "$PROJECT_ROOT/.pennyfarthing/scripts/prime.sh" ]]; then
-      "$PROJECT_ROOT/.pennyfarthing/scripts/prime.sh" --quiet --agent "$2"
+    if [[ -f "$PROJECT_ROOT/.pennyfarthing/scripts/core/prime.sh" ]]; then
+      "$PROJECT_ROOT/.pennyfarthing/scripts/core/prime.sh" --quiet --agent "$2"
     fi
 
     # Output persona AFTER agent definition (character voice is supplementary)

package/pennyfarthing-dist/scripts/core/check-context.sh

@@ -207,6 +207,9 @@ if last_total is not None:
     else:
         print('CONTEXT_STATUS=OK')
 
+    # RELAY_MODE: Output for handoff-marker.sh to use
+    print(f'RELAY_MODE={str(relay_mode).lower()}')
+
     # HANDOFF_MODE: 'auto' if relay_mode enabled, 'ask' otherwise
     # MSSCI-12395: relay_mode controls autohandoff independent of context level
     if relay_mode:

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

@@ -48,6 +48,7 @@ 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
@@ -69,8 +70,18 @@ AGENT_COMMAND:
   fallback: "Run \`/${NEXT_AGENT}\` to continue"
 ---
 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 + TirePump - context clear marker
+  # Cyclist + Relay ON + high context - context clear marker
   cat <<EOF
 ---
 AGENT_COMMAND:
@@ -79,7 +90,7 @@ AGENT_COMMAND:
 ---
 EOF
 else
-  # Cyclist, no TirePump - handoff marker
+  # Cyclist + Relay ON + low context - handoff marker
   cat <<EOF
 ---
 AGENT_COMMAND:

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

@@ -1,161 +1,7 @@
-#!/usr/bin/env zsh
+#!/usr/bin/env bash
 # prime.sh - Load essential project context at agent activation
 # Usage: prime.sh [--minimal] [--full] [--quiet] [--agent <name>]
 #
-# Loads context in priority order (optimized for attention):
-# 1. CLAUDE.md (already in system prompt - skipped)
-# 2. Agent definition + behavior guide (HIGHEST PRIORITY - load first!)
-# 3. Persona (already output by agent-session.sh before this runs)
-# 4. Session summary (active work context)
-# 5. Sidecars (patterns, gotchas, decisions - lowest priority)
-# 6. Domain docs (--full only)
+# Thin wrapper around python -m pennyfarthing_scripts.prime
 
-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 definition and sidecar"
-            exit 0
-            ;;
-        *) shift ;;
-    esac
-done
-
-# Helper to print headers (respects --quiet)
-print_header() {
-    if [[ "$QUIET" != "true" ]]; then
-        echo ""
-        echo "# $1"
-    fi
-}
-
-# Stop here for minimal mode
-if [[ "$MINIMAL" == "true" ]]; then
-    exit 0
-fi
-
-# =============================================================================
-# PRIORITY 1: Agent definition (HIGHEST ATTENTION ZONE)
-# =============================================================================
-# This is the most critical content - load it FIRST while attention is highest
-
-if [[ -n "$AGENT_NAME" ]]; then
-    AGENT_FILE="$PROJECT_ROOT/.pennyfarthing/agents/${AGENT_NAME}.md"
-    if [[ -f "$AGENT_FILE" ]]; then
-        print_header "Agent Definition: ${AGENT_NAME}"
-        cat "$AGENT_FILE"
-    fi
-fi
-
-# =============================================================================
-# PRIORITY 2: Agent behavior guide (shared protocols)
-# =============================================================================
-
-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
-
-# =============================================================================
-# PRIORITY 3: Persona already loaded by agent-session.sh (before prime.sh runs)
-# =============================================================================
-# Nothing to do here - persona is output by agent-session.sh start
-
-# =============================================================================
-# PRIORITY 4: Session summary (active work context)
-# =============================================================================
-
-# Sprint summary (brief - just name and progress)
-if [[ -f "$(get_sprint_file)" ]]; then
-    print_header "Sprint Context"
-    summary=$(get_sprint_summary)
-    if [[ -n "$summary" ]]; then
-        echo "$summary"
-    fi
-    progress=$(get_sprint_progress)
-    if [[ -n "$progress" ]]; then
-        echo "$progress"
-    fi
-fi
-
-# Active session (if exists) - extract header metadata + current assessment
-SESSION_FILE=""
-if [[ -d "$PROJECT_ROOT/.session" ]]; then
-    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)
-    awk '/^## / {exit} {print}' "$SESSION_FILE"
-
-    # Find the most recent assessment section
-    last_assessment=$(grep -n '^## .*Assessment' "$SESSION_FILE" | tail -1 | cut -d: -f1)
-
-    if [[ -n "$last_assessment" ]]; then
-        echo ""
-        echo "---"
-        awk -v start="$last_assessment" '
-            NR >= start {
-                if (NR > start && /^## /) exit
-                print
-            }
-        ' "$SESSION_FILE"
-    fi
-fi
-
-# =============================================================================
-# PRIORITY 5: Sidecars (patterns, gotchas, decisions - LOWEST PRIORITY)
-# =============================================================================
-# These are supplementary - loaded last when attention is lower
-
-if [[ -n "$AGENT_NAME" ]]; then
-    SIDECAR_DIR="$PROJECT_ROOT/.pennyfarthing/sidecars/${AGENT_NAME}"
-    if [[ -d "$SIDECAR_DIR" ]]; then
-        # Load in specific order: patterns first (most useful), then gotchas, then decisions
-        for filename in patterns.md gotchas.md decisions.md; do
-            pattern_file="$SIDECAR_DIR/$filename"
-            if [[ -f "$pattern_file" ]]; then
-                print_header "Agent Sidecar: $filename"
-                cat "$pattern_file"
-            fi
-        done
-    fi
-fi
-
-# =============================================================================
-# PRIORITY 6: Domain docs (--full only, rarely used)
-# =============================================================================
-
-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
+exec python3 -m pennyfarthing_scripts.prime "$@"

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

@@ -64,6 +64,15 @@ fi
 # Full path required - script must include category
 SCRIPT_PATH="$SCRIPTS_DIR/$SCRIPT_NAME"
 
+# Python-first dispatch: prefer .py over .sh when available
+# This enables transparent migration of shell scripts to Python
+SCRIPT_BASE="${SCRIPT_NAME%.sh}"
+PYTHON_PATH="$SCRIPTS_DIR/${SCRIPT_BASE}.py"
+
+if [[ -f "$PYTHON_PATH" ]] && command -v python3 &>/dev/null; then
+    exec python3 "$PYTHON_PATH" "$@"
+fi
+
 if [[ -f "$SCRIPT_PATH" ]]; then
     exec "$SCRIPT_PATH" "$@"
 else