@kood/claude-code 0.7.10 → 0.7.12

package/templates/.claude/hooks/ralph-stop-hook.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+
+# Ralph Loop Stop Hook
+# Prevents session exit when a ralph-loop is active
+# Feeds Claude's output back as input to continue the loop
+
+set -euo pipefail
+
+# Read hook input from stdin (advanced stop hook API)
+HOOK_INPUT=$(cat)
+
+# Check if ralph-loop is active
+RALPH_STATE_FILE=".claude/ralph-loop.local.md"
+
+if [[ ! -f "$RALPH_STATE_FILE" ]]; then
+  # No active loop - allow exit
+  exit 0
+fi
+
+# Parse markdown frontmatter (YAML between ---) and extract values
+FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$RALPH_STATE_FILE")
+ITERATION=$(echo "$FRONTMATTER" | grep '^iteration:' | sed 's/iteration: *//')
+MAX_ITERATIONS=$(echo "$FRONTMATTER" | grep '^max_iterations:' | sed 's/max_iterations: *//')
+# Extract completion_promise and strip surrounding quotes if present
+COMPLETION_PROMISE=$(echo "$FRONTMATTER" | grep '^completion_promise:' | sed 's/completion_promise: *//' | sed 's/^"\(.*\)"$/\1/')
+
+# Validate numeric fields before arithmetic operations
+if [[ ! "$ITERATION" =~ ^[0-9]+$ ]]; then
+  echo "Warning: Ralph loop state file corrupted (iteration: '$ITERATION')" >&2
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+if [[ ! "$MAX_ITERATIONS" =~ ^[0-9]+$ ]]; then
+  echo "Warning: Ralph loop state file corrupted (max_iterations: '$MAX_ITERATIONS')" >&2
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+# Check if max iterations reached
+if [[ $MAX_ITERATIONS -gt 0 ]] && [[ $ITERATION -ge $MAX_ITERATIONS ]]; then
+  echo "Ralph loop: Max iterations ($MAX_ITERATIONS) reached."
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+# Get transcript path from hook input
+TRANSCRIPT_PATH=$(echo "$HOOK_INPUT" | jq -r '.transcript_path')
+
+if [[ ! -f "$TRANSCRIPT_PATH" ]]; then
+  echo "Warning: Ralph loop transcript not found" >&2
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+# Read last assistant message from transcript (JSONL format)
+if ! grep -q '"role":"assistant"' "$TRANSCRIPT_PATH"; then
+  echo "Warning: No assistant messages in transcript" >&2
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+LAST_LINE=$(grep '"role":"assistant"' "$TRANSCRIPT_PATH" | tail -1)
+if [[ -z "$LAST_LINE" ]]; then
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+LAST_OUTPUT=$(echo "$LAST_LINE" | jq -r '
+  .message.content |
+  map(select(.type == "text")) |
+  map(.text) |
+  join("\n")
+' 2>&1)
+
+if [[ $? -ne 0 ]] || [[ -z "$LAST_OUTPUT" ]]; then
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+# Check for completion promise (only if set)
+if [[ "$COMPLETION_PROMISE" != "null" ]] && [[ -n "$COMPLETION_PROMISE" ]]; then
+  PROMISE_TEXT=$(echo "$LAST_OUTPUT" | perl -0777 -pe 's/.*?<promise>(.*?)<\/promise>.*/$1/s; s/^\s+|\s+$//g; s/\s+/ /g' 2>/dev/null || echo "")
+
+  if [[ -n "$PROMISE_TEXT" ]] && [[ "$PROMISE_TEXT" = "$COMPLETION_PROMISE" ]]; then
+    echo "Ralph loop: Detected <promise>$COMPLETION_PROMISE</promise>"
+    rm "$RALPH_STATE_FILE"
+    exit 0
+  fi
+fi
+
+# Not complete - continue loop with SAME PROMPT
+NEXT_ITERATION=$((ITERATION + 1))
+
+PROMPT_TEXT=$(awk '/^---$/{i++; next} i>=2' "$RALPH_STATE_FILE")
+
+if [[ -z "$PROMPT_TEXT" ]]; then
+  echo "Warning: Ralph loop state file has no prompt" >&2
+  rm "$RALPH_STATE_FILE"
+  exit 0
+fi
+
+# Update iteration (atomic write)
+TEMP_FILE="${RALPH_STATE_FILE}.tmp.$$"
+sed "s/^iteration: .*/iteration: $NEXT_ITERATION/" "$RALPH_STATE_FILE" > "$TEMP_FILE"
+mv "$TEMP_FILE" "$RALPH_STATE_FILE"
+
+# Build system message
+if [[ "$COMPLETION_PROMISE" != "null" ]] && [[ -n "$COMPLETION_PROMISE" ]]; then
+  SYSTEM_MSG="Ralph iteration $NEXT_ITERATION | To stop: output <promise>$COMPLETION_PROMISE</promise> (ONLY when TRUE)"
+else
+  SYSTEM_MSG="Ralph iteration $NEXT_ITERATION | No completion promise - loop runs until max iterations"
+fi
+
+jq -n \
+  --arg prompt "$PROMPT_TEXT" \
+  --arg msg "$SYSTEM_MSG" \
+  '{
+    "decision": "block",
+    "reason": $prompt,
+    "systemMessage": $msg
+  }'
+
+exit 0

package/templates/.claude/hooks/session-env-setup.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# Session Environment Setup Hook
+# Sets CLAUDE_SCRIPTS_ROOT based on where the command/skill is located
+# - User scope (~/.claude/): CLAUDE_SCRIPTS_ROOT=~/.claude/scripts
+# - Project scope (.claude/): CLAUDE_SCRIPTS_ROOT=.claude/scripts
+
+set -euo pipefail
+
+# Only run for SessionStart events
+# The hook receives JSON input via stdin, but for SessionStart we just need to set env vars
+
+# Determine the scripts root based on installation scope
+# Check if user-level .claude exists and has scripts
+USER_SCRIPTS_DIR="$HOME/.claude/scripts"
+PROJECT_SCRIPTS_DIR=".claude/scripts"
+
+# Priority: Project scope first (if exists), then User scope
+if [[ -d "$PROJECT_SCRIPTS_DIR" ]]; then
+  SCRIPTS_ROOT="$PROJECT_SCRIPTS_DIR"
+elif [[ -d "$USER_SCRIPTS_DIR" ]]; then
+  SCRIPTS_ROOT="$USER_SCRIPTS_DIR"
+else
+  # Fallback to project scope (default)
+  SCRIPTS_ROOT="$PROJECT_SCRIPTS_DIR"
+fi
+
+# Write to CLAUDE_ENV_FILE (session-wide environment)
+if [[ -n "${CLAUDE_ENV_FILE:-}" ]]; then
+  echo "CLAUDE_SCRIPTS_ROOT=$SCRIPTS_ROOT" >> "$CLAUDE_ENV_FILE"
+fi
+
+exit 0

package/templates/.claude/scripts/agent-teams/check-availability.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # Agent Teams 사용 가능 여부 확인
-# Usage: .claude/scripts/agent-teams/check-availability.sh
+# Usage: ${CLAUDE_SCRIPTS_ROOT}/agent-teams/check-availability.sh
 
 set -e
 

package/templates/.claude/scripts/agent-teams/setup-tmux.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # Agent Teams용 tmux 환경 세팅
-# Usage: .claude/scripts/agent-teams/setup-tmux.sh
+# Usage: ${CLAUDE_SCRIPTS_ROOT}/agent-teams/setup-tmux.sh
 
 set -e
 

package/templates/.claude/scripts/git/git-merge.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# git-merge.sh - 타겟 브랜치에 소스 브랜치를 merge 후 push
+# Usage: ./git-merge.sh <target-branch> <source-branch>
+# Example: ./git-merge.sh deploy/prod dev
+
+set -euo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+if [ $# -lt 2 ]; then
+  echo "Usage: $0 <target-branch> <source-branch>"
+  echo "Example: $0 deploy/prod dev"
+  exit 1
+fi
+
+TARGET="$1"
+SOURCE="$2"
+ORIGINAL_BRANCH=$(git branch --show-current)
+
+# Working directory clean 확인
+if [ -n "$(git status --porcelain)" ]; then
+  echo "Error: Working directory is not clean. Commit or stash changes first."
+  exit 1
+fi
+
+# 소스 브랜치 존재 확인
+if ! git rev-parse --verify "$SOURCE" >/dev/null 2>&1; then
+  echo "Error: Source branch '$SOURCE' does not exist"
+  exit 1
+fi
+
+# 타겟 브랜치 존재 확인
+if ! git rev-parse --verify "$TARGET" >/dev/null 2>&1; then
+  echo "Error: Target branch '$TARGET' does not exist"
+  exit 1
+fi
+
+echo "=== Merging '$SOURCE' into '$TARGET' ==="
+
+# remote 최신화
+echo "--- Fetching origin ---"
+git fetch origin
+
+# 타겟 브랜치로 전환
+echo "--- Checkout '$TARGET' ---"
+git checkout "$TARGET"
+
+# 타겟 브랜치 최신화
+echo "--- Pulling latest '$TARGET' ---"
+git pull origin "$TARGET" --ff-only || git pull origin "$TARGET"
+
+# 머지 실행
+echo "--- Merging '$SOURCE' into '$TARGET' ---"
+if ! git merge "$SOURCE" --no-edit; then
+  echo "Error: Merge conflict detected. Resolve manually."
+  echo "You are now on '$TARGET' branch."
+  exit 1
+fi
+
+# 푸시
+echo "--- Pushing '$TARGET' ---"
+git push origin "$TARGET"
+
+# 원래 브랜치로 복귀
+echo "--- Returning to '$ORIGINAL_BRANCH' ---"
+git checkout "$ORIGINAL_BRANCH"
+
+echo ""
+echo "Done: Merged '$SOURCE' into '$TARGET' and pushed."

package/templates/.claude/scripts/setup-ralph-loop.sh

@@ -0,0 +1,161 @@
+#!/bin/bash
+
+# Ralph Loop Setup Script
+# Creates state file + ensures Stop hook is registered in User settings
+
+set -euo pipefail
+
+# --- Hook auto-registration (User settings only, never Project) ---
+ensure_stop_hook() {
+  local USER_SETTINGS="$HOME/.claude/settings.json"
+  local HOOK_CMD=".claude/hooks/ralph-stop-hook.sh"
+
+  # Create ~/.claude/ if needed
+  mkdir -p "$HOME/.claude"
+
+  # If no settings file, create with hook
+  if [[ ! -f "$USER_SETTINGS" ]]; then
+    cat > "$USER_SETTINGS" <<'HOOKEOF'
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/ralph-stop-hook.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+HOOKEOF
+    echo "Created $USER_SETTINGS with Ralph stop hook"
+    return
+  fi
+
+  # Check if ralph hook already registered (any path containing 'ralph')
+  if jq -e '.hooks.Stop // [] | .. | .command? // empty | test("ralph")' "$USER_SETTINGS" >/dev/null 2>&1; then
+    return  # Already registered
+  fi
+
+  # Add hook to existing settings (preserve all existing values)
+  local TEMP_FILE="${USER_SETTINGS}.tmp.$$"
+
+  # If Stop array exists, append to it; otherwise create it
+  if jq -e '.hooks.Stop' "$USER_SETTINGS" >/dev/null 2>&1; then
+    jq --arg cmd "$HOOK_CMD" '.hooks.Stop += [{"hooks": [{"type": "command", "command": $cmd}]}]' "$USER_SETTINGS" > "$TEMP_FILE"
+  elif jq -e '.hooks' "$USER_SETTINGS" >/dev/null 2>&1; then
+    jq --arg cmd "$HOOK_CMD" '.hooks.Stop = [{"hooks": [{"type": "command", "command": $cmd}]}]' "$USER_SETTINGS" > "$TEMP_FILE"
+  else
+    jq --arg cmd "$HOOK_CMD" '.hooks = {"Stop": [{"hooks": [{"type": "command", "command": $cmd}]}]}' "$USER_SETTINGS" > "$TEMP_FILE"
+  fi
+
+  mv "$TEMP_FILE" "$USER_SETTINGS"
+  echo "Registered Ralph stop hook in $USER_SETTINGS"
+}
+
+ensure_stop_hook
+
+# --- Argument parsing ---
+PROMPT_PARTS=()
+MAX_ITERATIONS=0
+COMPLETION_PROMISE="null"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    -h|--help)
+      cat << 'HELP_EOF'
+Ralph Loop - Interactive self-referential development loop
+
+USAGE:
+  /ralph-loop [PROMPT...] [OPTIONS]
+
+OPTIONS:
+  --max-iterations <n>           Maximum iterations (default: unlimited)
+  --completion-promise '<text>'  Promise phrase (USE QUOTES for multi-word)
+  -h, --help                     Show this help
+
+EXAMPLES:
+  /ralph-loop Build a todo API --completion-promise 'DONE' --max-iterations 20
+  /ralph-loop --max-iterations 10 Fix the auth bug
+  /ralph-loop Refactor cache layer  (runs forever)
+
+STOPPING:
+  Only by reaching --max-iterations or detecting --completion-promise
+
+MONITORING:
+  grep '^iteration:' .claude/ralph-loop.local.md
+HELP_EOF
+      exit 0
+      ;;
+    --max-iterations)
+      if [[ -z "${2:-}" ]] || ! [[ "$2" =~ ^[0-9]+$ ]]; then
+        echo "Error: --max-iterations requires a positive integer" >&2
+        exit 1
+      fi
+      MAX_ITERATIONS="$2"
+      shift 2
+      ;;
+    --completion-promise)
+      if [[ -z "${2:-}" ]]; then
+        echo "Error: --completion-promise requires a text argument" >&2
+        exit 1
+      fi
+      COMPLETION_PROMISE="$2"
+      shift 2
+      ;;
+    *)
+      PROMPT_PARTS+=("$1")
+      shift
+      ;;
+  esac
+done
+
+PROMPT="${PROMPT_PARTS[*]}"
+
+if [[ -z "$PROMPT" ]]; then
+  echo "Error: No prompt provided" >&2
+  echo "Usage: /ralph-loop <PROMPT> [--max-iterations N] [--completion-promise TEXT]" >&2
+  exit 1
+fi
+
+# --- Create state file ---
+mkdir -p .claude
+
+if [[ -n "$COMPLETION_PROMISE" ]] && [[ "$COMPLETION_PROMISE" != "null" ]]; then
+  COMPLETION_PROMISE_YAML="\"$COMPLETION_PROMISE\""
+else
+  COMPLETION_PROMISE_YAML="null"
+fi
+
+cat > .claude/ralph-loop.local.md <<EOF
+---
+active: true
+iteration: 1
+max_iterations: $MAX_ITERATIONS
+completion_promise: $COMPLETION_PROMISE_YAML
+started_at: "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+---
+
+$PROMPT
+EOF
+
+cat <<EOF
+Ralph loop activated!
+
+Iteration: 1
+Max iterations: $(if [[ $MAX_ITERATIONS -gt 0 ]]; then echo $MAX_ITERATIONS; else echo "unlimited"; fi)
+Completion promise: $(if [[ "$COMPLETION_PROMISE" != "null" ]]; then echo "$COMPLETION_PROMISE"; else echo "none (runs forever)"; fi)
+
+The stop hook blocks exit and re-feeds the same prompt each iteration.
+
+EOF
+
+echo "$PROMPT"
+
+if [[ "$COMPLETION_PROMISE" != "null" ]]; then
+  echo ""
+  echo "To complete: output <promise>$COMPLETION_PROMISE</promise> (ONLY when TRUE)"
+fi