Ralph Loop: Status

Display the current state of the Ralph Wiggum autonomous improvement loop.

Execution

# Use /usr/bin/env bash for macOS zsh compatibility (see ADR: shell-command-portability-zsh)
/usr/bin/env bash << 'RALPH_STATUS_SCRIPT'
PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
SETTINGS="$HOME/.claude/settings.json"
MARKER="ralph/hooks/"

# Helper function for time calculation (fallback if bc not available)
calc_hours() {
    local secs="$1"
    if command -v bc &>/dev/null; then
        echo "scale=2; $secs / 3600" | bc
    else
        # Fallback: integer division with awk
        awk "BEGIN {printf \"%.2f\", $secs / 3600}"
    fi
}

echo "=== Ralph Loop Status ==="
echo ""

# Check hook registration in settings.json
HOOKS_REGISTERED=false
if command -v jq &>/dev/null && [[ -f "$SETTINGS" ]]; then
    HOOK_COUNT=$(jq '[.hooks | to_entries[] | .value[] | .hooks[] | select(.command | contains("'"$MARKER"'"))] | length' "$SETTINGS" 2>/dev/null || echo "0")
    if [[ "$HOOK_COUNT" -gt 0 ]]; then
        HOOKS_REGISTERED=true
    fi
fi

# Check if loop is enabled (marker file)
LOOP_ENABLED=false
if [[ -f "$PROJECT_DIR/.claude/loop-enabled" ]]; then
    LOOP_ENABLED=true
fi

# Determine overall status
if [[ "$HOOKS_REGISTERED" == "true" ]] && [[ "$LOOP_ENABLED" == "true" ]]; then
    echo "Status: ACTIVE"
    echo "Hooks are registered and loop enabled"
elif [[ "$HOOKS_REGISTERED" == "true" ]] && [[ "$LOOP_ENABLED" == "false" ]]; then
    echo "Status: READY (not started)"
    echo "Run /ralph:start to begin loop"
elif [[ "$HOOKS_REGISTERED" == "false" ]] && [[ "$LOOP_ENABLED" == "true" ]]; then
    echo "Status: ENABLED (hooks not installed)"
    echo "Run /ralph:hooks install, then restart Claude Code"
elif [[ "$HOOKS_REGISTERED" == "false" ]] && [[ "$LOOP_ENABLED" == "false" ]]; then
    echo "Status: INACTIVE"
    echo "Run /ralph:hooks install first"
fi
echo ""

# Show component status
echo "Components:"
if [[ "$HOOKS_REGISTERED" == "true" ]]; then
    echo "  [x] Hooks registered in settings.json ($HOOK_COUNT entries)"
else
    echo "  [ ] Hooks NOT registered - run /ralph:hooks install"
fi

if [[ "$LOOP_ENABLED" == "true" ]]; then
    echo "  [x] Loop enabled (marker file exists)"
else
    echo "  [ ] Loop not enabled - run /ralph:start"
fi

# Check for kill switch
if [[ -f "$PROJECT_DIR/.claude/STOP_LOOP" ]]; then
    echo "  [!] Kill Switch: TRIGGERED"
fi

echo ""

# Show config if exists
if [[ -f "$PROJECT_DIR/.claude/loop-config.json" ]]; then
    echo "=== Configuration ==="
    cat "$PROJECT_DIR/.claude/loop-config.json" | python3 -m json.tool 2>/dev/null || cat "$PROJECT_DIR/.claude/loop-config.json"
    echo ""
fi

# Show guidance (encouraged/forbidden) from ralph-config.json
if [[ -f "$PROJECT_DIR/.claude/ralph-config.json" ]]; then
    GUIDANCE=$(jq -r '.guidance // empty' "$PROJECT_DIR/.claude/ralph-config.json" 2>/dev/null)
    if [[ -n "$GUIDANCE" && "$GUIDANCE" != "null" ]]; then
        echo "=== Current Guidance ==="

        # Show encouraged items
        ENCOURAGED=$(jq -r '.guidance.encouraged // []' "$PROJECT_DIR/.claude/ralph-config.json" 2>/dev/null)
        ENCOURAGED_COUNT=$(echo "$ENCOURAGED" | jq 'length' 2>/dev/null || echo "0")
        if [[ "$ENCOURAGED_COUNT" -gt 0 ]]; then
            echo ""
            echo "ENCOURAGED ($ENCOURAGED_COUNT items):"
            echo "$ENCOURAGED" | jq -r '.[] | "  ✓ " + .' 2>/dev/null
        else
            echo "ENCOURAGED: (none)"
        fi

        # Show forbidden items
        FORBIDDEN=$(jq -r '.guidance.forbidden // []' "$PROJECT_DIR/.claude/ralph-config.json" 2>/dev/null)
        FORBIDDEN_COUNT=$(echo "$FORBIDDEN" | jq 'length' 2>/dev/null || echo "0")
        if [[ "$FORBIDDEN_COUNT" -gt 0 ]]; then
            echo ""
            echo "FORBIDDEN ($FORBIDDEN_COUNT items):"
            echo "$FORBIDDEN" | jq -r '.[] | "  ✗ " + .' 2>/dev/null
        else
            echo "FORBIDDEN: (none)"
        fi
        echo ""
        echo "Modify with: /ralph:encourage <item> or /ralph:forbid <item>"
        echo ""
    fi
fi

# Show session state if exists (ralph-state.json is canonical, loop-state.json is legacy)
if [[ -f "$PROJECT_DIR/.claude/ralph-state.json" ]]; then
    echo "=== Session State ==="
    cat "$PROJECT_DIR/.claude/ralph-state.json" | python3 -m json.tool 2>/dev/null || cat "$PROJECT_DIR/.claude/ralph-state.json"
    echo ""
fi

# Show time tracking (v7.9.0: dual time tracking)
echo "=== Time Tracking ==="
# Runtime: from session state (accumulated_runtime_seconds)
STATE_DIR="$HOME/.claude/automation/loop-orchestrator/state/sessions"
if [[ -d "$STATE_DIR" ]]; then
    # Find the most recent session state file for this project
    SESSION_STATE=$(find "$STATE_DIR" -name "*.json" -exec grep -l "\"accumulated_runtime_seconds\"" {} \; 2>/dev/null | head -1)
    if [[ -n "$SESSION_STATE" ]] && [[ -f "$SESSION_STATE" ]]; then
        RUNTIME_SECS=$(jq -r '.accumulated_runtime_seconds // 0' "$SESSION_STATE")
        if [[ "$RUNTIME_SECS" != "null" ]] && [[ "$RUNTIME_SECS" != "0" ]]; then
            RUNTIME_HOURS=$(calc_hours "$RUNTIME_SECS")
            echo "Runtime (CLI active): ${RUNTIME_HOURS}h"
        else
            echo "Runtime (CLI active): 0.00h (session just started)"
        fi
    else
        echo "Runtime (CLI active): N/A (no session state)"
    fi
else
    echo "Runtime (CLI active): N/A (state directory not found)"
fi

# Wall-clock: from loop-start-timestamp
if [[ -f "$PROJECT_DIR/.claude/loop-start-timestamp" ]]; then
    START_TS=$(cat "$PROJECT_DIR/.claude/loop-start-timestamp")
    NOW_TS=$(date +%s)
    WALL_SECS=$((NOW_TS - START_TS))
    WALL_HOURS=$(calc_hours "$WALL_SECS")
    echo "Wall-clock (since start): ${WALL_HOURS}h"
else
    echo "Wall-clock (since start): N/A (loop not started)"
fi
echo ""
echo "Note: Runtime = actual CLI working time (pauses excluded)"
echo "      Wall-clock = calendar time since /ralph:start"
echo ""

# Show last stop reason if exists
STOP_CACHE="$HOME/.claude/ralph-stop-reason.json"
if [[ -f "$STOP_CACHE" ]]; then
    echo "=== Last Stop Reason ==="
    LAST_STOP=$(jq -r '.reason // "Unknown"' "$STOP_CACHE")
    STOP_TIME=$(jq -r '.timestamp // "Unknown"' "$STOP_CACHE")
    STOP_TYPE=$(jq -r '.type // "normal"' "$STOP_CACHE")
    STOP_SESSION=$(jq -r '.session_id // "Unknown"' "$STOP_CACHE")

    if [[ "$STOP_TYPE" == "hard" ]]; then
        echo "Type: HARD STOP"
    else
        echo "Type: Normal"
    fi
    echo "Reason: $LAST_STOP"
    echo "Time: $STOP_TIME"
    echo "Session: ${STOP_SESSION:0:8}..."
    echo ""
fi

# Reminder about restart
if [[ "$HOOKS_REGISTERED" == "true" ]]; then
    echo "Note: If you just installed hooks, restart Claude Code for them to take effect."
fi
RALPH_STATUS_SCRIPT

Run the bash script above to show status.