fix(ralph-wiggum): fix stop hook exit code and add CLAUDE.md

- Fix get_session_id() to always return 0 (was failing with set -euo pipefail)
- Add CLAUDE.md with commands, hooks, key files, and testing instructions
- Bump version to 1.1.1

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: duyetbot <duyetbot@users.noreply.github.com>

Author: duyet

ralph-wiggum/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-wiggum",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Self-referential development loop for Claude Code with session isolation. Run iterative tasks with automatic progress detection and safety controls.",
   "author": {
     "name": "duyet",

ralph-wiggum/CLAUDE.md

@@ -0,0 +1,56 @@
+# Ralph Wiggum Plugin
+
+Self-referential development loop for Claude Code with session isolation.
+
+## Commands
+
+- `/ralph-loop` - Start iterative loop with a prompt
+- `/status` - Show current loop status
+- `/cancel-ralph` - Cancel active loop
+- `/help` - Usage documentation
+
+## Hooks
+
+Two hooks in `hooks/hooks.json`:
+
+| Hook | File | Purpose |
+|------|------|---------|
+| SessionStart | `session-start-hook.sh` | Initialize session ID for state isolation |
+| Stop | `stop-hook.sh` | Intercept exit, feed prompt back for next iteration |
+
+## Key Files
+
+```
+lib/
+├── utils.sh              # Session isolation utilities (get_session_id, get_state_file_path)
+├── circuit_breaker.sh    # Safety circuit breaker for error detection
+├── response_analyzer.sh  # Smart exit detection based on response patterns
+├── api_limit_handler.sh  # Rate limit detection and handling
+└── task_manager.sh       # Task tracking across iterations
+```
+
+## State Files
+
+State stored in `.claude/ralph-session.local/` with session ID suffix:
+- `ralph-loop.{session_id}.md` - Loop state (iteration, prompt, settings)
+- `ralph-circuit.{session_id}.json` - Circuit breaker state
+- `ralph-analysis.{session_id}.json` - Response analysis data
+
+## Testing Hooks
+
+Test stop hook manually:
+```bash
+cd ralph-wiggum
+echo '{"session_id": "test", "transcript_path": "/tmp/test.json"}' | ./hooks/stop-hook.sh
+```
+
+Test with set -euo pipefail (catches exit code issues):
+```bash
+bash -euo pipefail -c 'source lib/utils.sh && get_session_id'
+```
+
+## Common Issues
+
+1. **Hook exits with code 1**: Check that all functions in `lib/utils.sh` return 0 explicitly
+2. **Session state persists**: State files use session ID suffix for isolation
+3. **Circuit breaker trips**: Check `.claude/ralph-session.local/ralph-circuit.*.json`

ralph-wiggum/lib/utils.sh

@@ -4,7 +4,10 @@
 # Provides session-specific state management to prevent cross-session interference
 
 # Set CLAUDE_PLUGIN_ROOT with fallback to script location
-CLAUDE_PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+# Use ${VAR-default} (without colon) to avoid unbound variable error with set -u
+if [[ -z "${CLAUDE_PLUGIN_ROOT:-}" ]]; then
+  CLAUDE_PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+fi
 
 CLAUDE_ENV_FILE="${CLAUDE_ENV_FILE:-${CLAUDE_PLUGIN_ROOT}/.env}"
 RALPH_SESSION_DIR=".claude/ralph-session.local"
@@ -17,9 +20,14 @@ get_session_id() {
   fi
 
   if [[ -f "$CLAUDE_ENV_FILE" ]]; then
-    grep -q "^CLAUDE_SESSION_ID=" "$CLAUDE_ENV_FILE" && \
-      source "$CLAUDE_ENV_FILE" && echo "$CLAUDE_SESSION_ID"
+    if grep -q "^CLAUDE_SESSION_ID=" "$CLAUDE_ENV_FILE"; then
+      source "$CLAUDE_ENV_FILE"
+      echo "${CLAUDE_SESSION_ID:-}"
+    fi
   fi
+
+  # Always return 0 even when no session found (caller handles empty string)
+  return 0
 }
 
 # Get state directory (always .claude/ralph-session in project directory)