@kood/claude-code 0.7.10 → 0.7.11

package/templates/.claude/commands/git-merge.md

@@ -0,0 +1,67 @@
+---
+description: 타겟 브랜치에 소스 브랜치를 merge 후 push
+argument-hint: <target-branch> <source-branch>
+---
+
+# Git Merge Command
+
+> 타겟 브랜치에 소스 브랜치를 merge하고 push.
+
+---
+
+<scripts>
+
+## 사용 가능한 스크립트
+
+| 스크립트 | 용도 |
+|----------|------|
+| `.claude/scripts/git/git-merge.sh <target> <source>` | checkout → merge → push → 원래 브랜치 복귀 |
+
+</scripts>
+
+---
+
+<workflow>
+
+## 워크플로우
+
+```bash
+# 인자에서 타겟/소스 브랜치 추출 후 실행
+.claude/scripts/git/git-merge.sh <target-branch> <source-branch>
+```
+
+**스크립트 동작:**
+1. Working directory clean 확인
+2. `git fetch origin`
+3. 타겟 브랜치 checkout + pull
+4. 소스 브랜치 merge (`--no-edit`)
+5. 타겟 브랜치 push
+6. 원래 브랜치로 복귀
+
+</workflow>
+
+---
+
+<examples>
+
+```bash
+# deploy/prod에 dev 머지
+.claude/scripts/git/git-merge.sh deploy/prod dev
+
+# main에 feature/auth 머지
+.claude/scripts/git/git-merge.sh main feature/auth
+```
+
+</examples>
+
+---
+
+<error_handling>
+
+| 상황 | 대응 |
+|------|------|
+| **Working directory dirty** | 커밋 또는 stash 후 재시도 안내 |
+| **Merge conflict** | 수동 해결 안내 (타겟 브랜치에 머물러 있음) |
+| **브랜치 미존재** | 에러 출력 후 종료 |
+
+</error_handling>

package/templates/.claude/commands/ralph-loop.md

@@ -0,0 +1,18 @@
+---
+description: "Start Ralph Loop in current session"
+argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]"
+allowed-tools: ["Bash(.claude/scripts/setup-ralph-loop.sh:*)"]
+hide-from-slash-command-tool: "true"
+---
+
+# Ralph Loop Command
+
+Execute the setup script to initialize the Ralph loop:
+
+```!
+".claude/scripts/setup-ralph-loop.sh" $ARGUMENTS
+```
+
+Please work on the task. When you try to exit, the Ralph loop will feed the SAME PROMPT back to you for the next iteration. You'll see your previous work in files and git history, allowing you to iterate and improve.
+
+CRITICAL RULE: If a completion promise is set, you may ONLY output it when the statement is completely and unequivocally TRUE. Do not output false promises to escape the loop, even if you think you're stuck or should exit for other reasons. The loop is designed to continue until genuine completion.

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/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