@pennyfarthing/core 7.6.1 → 7.8.0

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

@@ -211,16 +211,22 @@ case "$1" in
     echo "$2" > "$AGENT_FILE"
     echo "Session: $session_id -> $2"
 
-    # Output persona on start (unless character_voice is disabled)
-    if is_character_voice_enabled; then
-      output_persona "$2"
-    fi
-
-    # Auto-prime context after persona (reduces cold-start overhead)
-    # Pass agent name so prime can load agent-specific sidecar
+    # Context loading order (optimized for attention):
+    # 1. CLAUDE.md (system prompt - already loaded)
+    # 2. Agent definition + behavior guide (loaded by prime.sh FIRST)
+    # 3. Persona (output here, AFTER agent definition)
+    # 4. Session summary (loaded by prime.sh)
+    # 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"
     fi
+
+    # Output persona AFTER agent definition (character voice is supplementary)
+    if is_character_voice_enabled; then
+      output_persona "$2"
+    fi
     ;;
   stop)
     # Use provided session ID, fall back to SESSION_ID env var

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

@@ -204,9 +204,17 @@ if last_total is not None:
     # 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')
+
+    # 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:
+        print('HANDOFF_MODE=auto')
+    else:
         print('HANDOFF_MODE=ask')
 
     # TirePump: Use CONTEXT_CLEAR (clear + load next agent) when:

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,136 +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 (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)
+# 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'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
+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

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

@@ -143,6 +143,7 @@ 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"
@@ -151,8 +152,42 @@ case "$REPOS" in
         create_or_checkout_branch "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
         ;;
     all)
-        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
-        create_or_checkout_branch "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
+        # 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
 
@@ -222,5 +257,11 @@ done
 
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "✅ Done! All branches verified and ready."
-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

package/pennyfarthing-dist/scripts/git/git-status-all.sh

@@ -82,15 +82,26 @@ if ! $BRIEF; then
     echo ""
 fi
 
-# Check each repo from configuration
+# Check each repo from configuration (parallelized for performance)
 repo_count=$(get_repo_count)
 if [[ "$repo_count" -eq 0 ]]; then
     # No repos configured, just show current directory
     show_repo_status "Project" "$PROJECT_ROOT"
 else
+    # Create temp dir for parallel output capture
+    tmpdir=$(mktemp -d)
+    trap "rm -rf '$tmpdir'" EXIT
+
+    # Launch status checks in parallel
     for repo in $(get_repos); do
         repo_path=$(get_repo_full_path "$repo")
-        show_repo_status "$repo" "$repo_path"
+        (show_repo_status "$repo" "$repo_path" > "$tmpdir/$repo.out" 2>&1) &
+    done
+    wait
+
+    # Output results in order
+    for repo in $(get_repos); do
+        [ -f "$tmpdir/$repo.out" ] && cat "$tmpdir/$repo.out"
     done
 fi
 
@@ -108,14 +119,28 @@ if ! $BRIEF; then
         unpushed=$(git -C "$PROJECT_ROOT" log origin/develop..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
         total_unpushed=$((total_unpushed + unpushed))
     else
+        # Parallelize summary collection
+        summary_tmp=$(mktemp -d)
         for repo in $(get_repos); do
             repo_path=$(get_repo_full_path "$repo")
-            [ -d "$repo_path/.git" ] || [ -d "$repo_path" ] || continue
-            count=$(git -C "$repo_path" status --short 2>/dev/null | wc -l | tr -d ' ')
-            total_changes=$((total_changes + count))
-            unpushed=$(git -C "$repo_path" log origin/develop..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
-            total_unpushed=$((total_unpushed + unpushed))
+            (
+                [ -d "$repo_path/.git" ] || [ -d "$repo_path" ] || exit 0
+                count=$(git -C "$repo_path" status --short 2>/dev/null | wc -l | tr -d ' ')
+                unpushed=$(git -C "$repo_path" log origin/develop..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
+                echo "$count $unpushed" > "$summary_tmp/$repo.count"
+            ) &
+        done
+        wait
+
+        # Aggregate results
+        for repo in $(get_repos); do
+            if [ -f "$summary_tmp/$repo.count" ]; then
+                read count unpushed < "$summary_tmp/$repo.count"
+                total_changes=$((total_changes + count))
+                total_unpushed=$((total_unpushed + unpushed))
+            fi
         done
+        rm -rf "$summary_tmp"
     fi
 
     if [ "$total_changes" -eq 0 ] && [ "$total_unpushed" -eq 0 ]; then

package/pennyfarthing-dist/scripts/hooks/bell-mode-hook.sh

@@ -8,7 +8,7 @@
 # Claude's next API call.
 #
 # Configuration files:
-#   .pennyfarthing/bell-mode.json - { "enabled": true/false }
+#   .pennyfarthing/config.local.yaml - workflow.bell_mode: true/false
 #   .pennyfarthing/bell-queue.json - [{ "text": "...", "images": [...] }, ...]
 #
 # Output format (when injecting):
@@ -35,15 +35,17 @@ if [[ ! -d "$PROJECT_ROOT/.pennyfarthing" ]]; then
   exit 0
 fi
 
-BELL_MODE_CONFIG="$PROJECT_ROOT/.pennyfarthing/bell-mode.json"
+CONFIG_LOCAL_YAML="$PROJECT_ROOT/.pennyfarthing/config.local.yaml"
 BELL_QUEUE_FILE="$PROJECT_ROOT/.pennyfarthing/bell-queue.json"
 
-# Check if bell mode is enabled
-if [[ ! -f "$BELL_MODE_CONFIG" ]]; then
+# Check if bell mode is enabled in config.local.yaml
+if [[ ! -f "$CONFIG_LOCAL_YAML" ]]; then
   exit 0
 fi
 
-ENABLED=$(cat "$BELL_MODE_CONFIG" 2>/dev/null | grep -o '"enabled"[[:space:]]*:[[:space:]]*true' || true)
+# Parse YAML to check workflow.bell_mode - look for "bell_mode: true"
+# This handles both "bell_mode: true" and "  bell_mode: true" (indented under workflow)
+ENABLED=$(grep -E '^\s*bell_mode:\s*true' "$CONFIG_LOCAL_YAML" 2>/dev/null || true)
 if [[ -z "$ENABLED" ]]; then
   exit 0
 fi
@@ -67,6 +69,13 @@ if [[ -z "$FIRST_MESSAGE_TEXT" ]]; then
   exit 0
 fi
 
+# Get Cyclist port (if running)
+CYCLIST_PORT=""
+PORT_FILE="$PROJECT_ROOT/.cyclist-port"
+if [[ -f "$PORT_FILE" ]]; then
+  CYCLIST_PORT=$(cat "$PORT_FILE" 2>/dev/null)
+fi
+
 # Output the hook response JSON
 cat << EOF
 {
@@ -77,11 +86,21 @@ cat << EOF
 }
 EOF
 
-# Remove the first message from the queue (for next invocation)
-# Use jq if available, otherwise leave queue management to the TypeScript side
-# Run in background and ignore errors to avoid blocking hook response
-if command -v jq &> /dev/null; then
-  (jq 'if length > 0 then .[1:] else [] end' "$BELL_QUEUE_FILE" > "$BELL_QUEUE_FILE.tmp" 2>/dev/null && mv "$BELL_QUEUE_FILE.tmp" "$BELL_QUEUE_FILE") &
-fi
+# Remove the first message from the queue and notify Cyclist
+# Run in background to avoid blocking hook response
+(
+  # Dequeue using jq if available
+  if command -v jq &> /dev/null; then
+    jq 'if length > 0 then .[1:] else [] end' "$BELL_QUEUE_FILE" > "$BELL_QUEUE_FILE.tmp" 2>/dev/null && mv "$BELL_QUEUE_FILE.tmp" "$BELL_QUEUE_FILE"
+  fi
+
+  # Notify Cyclist browser to dequeue and display the message
+  if [[ -n "$CYCLIST_PORT" ]] && [[ "$CYCLIST_PORT" =~ ^[0-9]+$ ]]; then
+    curl -s -X POST "http://localhost:$CYCLIST_PORT/api/bell-consumed" \
+      -H "Content-Type: application/json" \
+      -d "{\"text\": \"$FIRST_MESSAGE_TEXT\"}" \
+      >/dev/null 2>&1 || true
+  fi
+) &
 
 exit 0