claude-code-achievements 1.0.0

package/data/i18n/ko.json

@@ -0,0 +1,94 @@
+{
+  "ui": {
+    "title": "CLAUDE CODE ACHIEVEMENTS",
+    "unlocked": "업적 달성!",
+    "locked": "잠김",
+    "progress": "진행 상황",
+    "rarity": "희귀도",
+    "tip": "팁",
+    "hint": "힌트"
+  },
+  "categories": {
+    "basics": { "name": "시작하기", "description": "Claude Code 첫걸음" },
+    "workflow": { "name": "워크플로우", "description": "개발 워크플로우 마스터" },
+    "tools": { "name": "파워 툴", "description": "고급 기능 활용" },
+    "mastery": { "name": "마스터리", "description": "전문가 수준" }
+  },
+  "achievements": {
+    "first_edit": {
+      "name": "첫 터치",
+      "description": "Claude와 함께 파일 편집하기",
+      "tip": "구체적으로 말하세요: '버그 고쳐줘' 대신 'login.js 42번 줄의 TypeError 수정해줘'"
+    },
+    "first_write": {
+      "name": "창조자",
+      "description": "새 파일 생성하기",
+      "tip": "Claude는 설명만으로 전체 파일을 만들 수 있어요. '로그인 폼 React 컴포넌트 만들어줘'"
+    },
+    "claude_md_creator": {
+      "name": "프로젝트 큐레이터",
+      "description": "CLAUDE.md로 프로젝트 컨텍스트 설정",
+      "tip": "CLAUDE.md는 프로젝트 이해를 돕습니다. 기술 스택, 코딩 스타일, 주요 파일, 자주 쓰는 명령어를 포함하세요."
+    },
+    "plan_mode_user": {
+      "name": "전략적 사고가",
+      "description": "복잡한 작업에 Plan 모드 사용",
+      "tip": "Shift+Tab 두 번으로 Plan 모드 진입. 아키텍처 결정이나 다단계 작업에 좋아요."
+    },
+    "git_commit": {
+      "name": "버전 관리자",
+      "description": "Claude와 함께 커밋하기",
+      "tip": "Claude가 커밋 메시지를 작성하게 하세요! conventional commits 형식으로 작성합니다."
+    },
+    "git_push": {
+      "name": "배포하기!",
+      "description": "원격 저장소에 푸시",
+      "tip": "푸시 전에 항상 변경 사항을 검토하세요. Claude에게 요약을 요청하세요."
+    },
+    "run_tests": {
+      "name": "품질 수호자",
+      "description": "Claude와 함께 테스트 실행",
+      "tip": "'테스트 실행하고 실패하면 고쳐줘'. 이게 바이브코딩 검증 루프입니다!"
+    },
+    "multi_agent": {
+      "name": "위임의 달인",
+      "description": "Task 도구로 서브 에이전트 생성",
+      "tip": "Task 도구는 복잡한 작업을 위한 전문 에이전트를 만듭니다."
+    },
+    "first_mcp": {
+      "name": "MCP 개척자",
+      "description": "MCP 도구 사용하기",
+      "tip": "MCP는 Claude 능력을 확장합니다. DB, API, 커스텀 도구에 연결하세요."
+    },
+    "web_searcher": {
+      "name": "웹 탐험가",
+      "description": "웹 검색하기",
+      "tip": "Claude가 최신 문서, 솔루션, API를 검색할 수 있어요."
+    },
+    "skill_invoker": {
+      "name": "스킬 마스터",
+      "description": "슬래시 명령 스킬 사용",
+      "tip": "/commit, /pr, /init 해보세요. ~/.claude/commands/에서 커스텀도 가능!"
+    },
+    "notebook_editor": {
+      "name": "데이터 과학자",
+      "description": "Jupyter 노트북 편집",
+      "tip": "Claude는 노트북을 이해해요! 데이터 분석, 시각화, ML 실험을 요청하세요."
+    },
+    "config_modifier": {
+      "name": "커스터마이저",
+      "description": "Claude Code 설정 수정",
+      "tip": "/config 또는 ~/.claude/settings.json을 편집하세요."
+    },
+    "hooks_user": {
+      "name": "자동화 아키텍트",
+      "description": "Claude Code 훅 설정",
+      "tip": "훅은 이벤트에 스크립트를 실행해요. 린팅, 테스트, 커스텀 워크플로우에 활용!"
+    },
+    "ralph_starter": {
+      "name": "루프 마스터",
+      "description": "자율 코딩 루프 시작",
+      "tip": "Ralph Loop는 목표 달성까지 Claude가 자율적으로 작업합니다."
+    }
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,28 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/track-achievement.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/track-stop.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/track-achievement.sh

@@ -0,0 +1,178 @@
+#!/bin/bash
+# track-achievement.sh - Main achievement tracking logic for PostToolUse hook
+# Receives JSON via stdin with tool_name, tool_input, and permission_mode
+
+set -e
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$0")")}"
+STATE_DIR="${HOME}/.claude/achievements"
+STATE_FILE="${STATE_DIR}/state.json"
+ACHIEVEMENTS_FILE="${PLUGIN_ROOT}/data/achievements.json"
+
+# Initialize state file if it doesn't exist
+init_state() {
+    mkdir -p "${STATE_DIR}"
+    if [[ ! -f "${STATE_FILE}" ]]; then
+        cat > "${STATE_FILE}" << 'EOF'
+{
+  "settings": { "language": "en", "notifications": true, "notification_style": "system" },
+  "achievements": {},
+  "counters": { "ralph_iterations": 0 },
+  "session": { "files_read_set": [] }
+}
+EOF
+    fi
+}
+
+# Read input from stdin
+read_input() {
+    INPUT=$(cat)
+    TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+    TOOL_INPUT=$(echo "$INPUT" | jq -r '.tool_input // {}')
+    PERMISSION_MODE=$(echo "$INPUT" | jq -r '.permission_mode // "default"')
+}
+
+# Check if achievement is already unlocked
+is_unlocked() {
+    local achievement_id="$1"
+    jq -e ".achievements[\"${achievement_id}\"].unlocked == true" "${STATE_FILE}" > /dev/null 2>&1
+}
+
+# Unlock an achievement
+unlock_achievement() {
+    local achievement_id="$1"
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local temp_file=$(mktemp)
+    jq ".achievements[\"${achievement_id}\"] = {\"unlocked\": true, \"unlockedAt\": \"${timestamp}\"}" "${STATE_FILE}" > "${temp_file}"
+    mv "${temp_file}" "${STATE_FILE}"
+    "${PLUGIN_ROOT}/scripts/show-notification.sh" "${achievement_id}"
+}
+
+# Check and unlock achievements based on tool use
+check_achievements() {
+    # Plan mode achievement
+    if [[ "${PERMISSION_MODE}" == "plan" ]]; then
+        if ! is_unlocked "plan_mode_user"; then
+            unlock_achievement "plan_mode_user"
+        fi
+    fi
+
+    case "${TOOL_NAME}" in
+        Write)
+            # first_write
+            if ! is_unlocked "first_write"; then
+                unlock_achievement "first_write"
+            fi
+
+            FILE_PATH=$(echo "$TOOL_INPUT" | jq -r '.file_path // empty')
+
+            # claude_md_creator
+            if [[ "${FILE_PATH}" =~ CLAUDE\.md$ ]]; then
+                if ! is_unlocked "claude_md_creator"; then
+                    unlock_achievement "claude_md_creator"
+                fi
+            fi
+
+            # config_modifier
+            if [[ "${FILE_PATH}" =~ \.claude/settings.*\.json$ ]]; then
+                if ! is_unlocked "config_modifier"; then
+                    unlock_achievement "config_modifier"
+                fi
+            fi
+
+            # hooks_user (hooks in settings or hooks.json)
+            if [[ "${FILE_PATH}" =~ hooks\.json$ ]] || [[ "${FILE_PATH}" =~ \.claude/settings.*\.json$ ]]; then
+                # Check if file contains hooks configuration
+                if [[ -f "${FILE_PATH}" ]]; then
+                    if grep -q '"hooks"' "${FILE_PATH}" 2>/dev/null || grep -q '"PostToolUse"' "${FILE_PATH}" 2>/dev/null; then
+                        if ! is_unlocked "hooks_user"; then
+                            unlock_achievement "hooks_user"
+                        fi
+                    fi
+                fi
+            fi
+            ;;
+
+        Edit)
+            # first_edit
+            if ! is_unlocked "first_edit"; then
+                unlock_achievement "first_edit"
+            fi
+            ;;
+
+        Bash)
+            COMMAND=$(echo "$TOOL_INPUT" | jq -r '.command // empty')
+
+            # git_commit (git add/commit)
+            if [[ "${COMMAND}" =~ git[[:space:]]+(add|commit) ]]; then
+                if ! is_unlocked "git_commit"; then
+                    unlock_achievement "git_commit"
+                fi
+            fi
+
+            # git_push
+            if [[ "${COMMAND}" =~ git[[:space:]]+push ]]; then
+                if ! is_unlocked "git_push"; then
+                    unlock_achievement "git_push"
+                fi
+            fi
+
+            # run_tests
+            if [[ "${COMMAND}" =~ (npm|yarn|pnpm)[[:space:]]+(test|vitest|jest) ]] || \
+               [[ "${COMMAND}" =~ pytest ]] || \
+               [[ "${COMMAND}" =~ go[[:space:]]+test ]] || \
+               [[ "${COMMAND}" =~ cargo[[:space:]]+test ]] || \
+               [[ "${COMMAND}" =~ bun[[:space:]]+test ]]; then
+                if ! is_unlocked "run_tests"; then
+                    unlock_achievement "run_tests"
+                fi
+            fi
+            ;;
+
+        Task)
+            if ! is_unlocked "multi_agent"; then
+                unlock_achievement "multi_agent"
+            fi
+            ;;
+
+        Skill)
+            if ! is_unlocked "skill_invoker"; then
+                unlock_achievement "skill_invoker"
+            fi
+
+            # ralph_starter
+            SKILL_NAME=$(echo "$TOOL_INPUT" | jq -r '.skill // empty')
+            if [[ "${SKILL_NAME}" =~ ralph-loop|ralph ]]; then
+                if ! is_unlocked "ralph_starter"; then
+                    unlock_achievement "ralph_starter"
+                fi
+            fi
+            ;;
+
+        WebSearch)
+            if ! is_unlocked "web_searcher"; then
+                unlock_achievement "web_searcher"
+            fi
+            ;;
+
+        NotebookEdit)
+            if ! is_unlocked "notebook_editor"; then
+                unlock_achievement "notebook_editor"
+            fi
+            ;;
+
+        mcp__*)
+            # Any MCP tool
+            if ! is_unlocked "first_mcp"; then
+                unlock_achievement "first_mcp"
+            fi
+            ;;
+    esac
+}
+
+# Main
+init_state
+read_input
+check_achievements
+
+exit 0

package/hooks/track-stop.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# track-stop.sh - Track Stop hook for ralph-loop iterations
+# Called when a conversation ends or is interrupted
+
+set -e
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$0")")}"
+STATE_DIR="${HOME}/.claude/achievements"
+STATE_FILE="${STATE_DIR}/state.json"
+
+# Check if state file exists
+if [[ ! -f "${STATE_FILE}" ]]; then
+    exit 0
+fi
+
+# Read input from stdin
+INPUT=$(cat)
+STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false')
+
+# Increment ralph iterations if ralph-loop is active
+# This is detected by checking if the session has ralph_loop_active flag
+RALPH_ACTIVE=$(jq -r '.session.ralph_loop_active // false' "${STATE_FILE}")
+
+if [[ "${RALPH_ACTIVE}" == "true" ]]; then
+    # Increment counter
+    temp_file=$(mktemp)
+    jq '.counters.ralph_iterations = (.counters.ralph_iterations // 0) + 1' "${STATE_FILE}" > "${temp_file}"
+    mv "${temp_file}" "${STATE_FILE}"
+
+    # Check if threshold reached
+    RALPH_COUNT=$(jq -r '.counters.ralph_iterations' "${STATE_FILE}")
+    if [[ "${RALPH_COUNT}" -ge 100 ]]; then
+        # Check if already unlocked
+        if ! jq -e '.achievements["ralph_master"].unlocked == true' "${STATE_FILE}" > /dev/null 2>&1; then
+            "${PLUGIN_ROOT}/scripts/show-notification.sh" "ralph_master"
+            temp_file=$(mktemp)
+            timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+            jq ".achievements[\"ralph_master\"] = {\"unlocked\": true, \"unlockedAt\": \"${timestamp}\"}" "${STATE_FILE}" > "${temp_file}"
+            mv "${temp_file}" "${STATE_FILE}"
+        fi
+    fi
+fi
+
+exit 0

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "claude-code-achievements",
+  "version": "1.0.0",
+  "description": "Steam-style achievement system for Claude Code - gamify your coding journey!",
+  "author": "subinium",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/subinium/claude-code-achievements.git"
+  },
+  "homepage": "https://github.com/subinium/claude-code-achievements#readme",
+  "bugs": {
+    "url": "https://github.com/subinium/claude-code-achievements/issues"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "achievements",
+    "gamification",
+    "vibecoding",
+    "plugin",
+    "cli"
+  ],
+  "bin": {
+    "claude-code-achievements": "bin/install.js"
+  },
+  "files": [
+    ".claude-plugin",
+    "commands/",
+    "hooks/",
+    "scripts/",
+    "data/",
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/scripts/init-state.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# init-state.sh - Initialize or reset the achievements state file
+# Usage: init-state.sh [--reset]
+
+set -e
+
+STATE_DIR="${HOME}/.claude/achievements"
+STATE_FILE="${STATE_DIR}/state.json"
+
+# Check for reset flag
+if [[ "$1" == "--reset" ]]; then
+    rm -f "${STATE_FILE}"
+    echo "State file reset."
+fi
+
+# Create directory if needed
+mkdir -p "${STATE_DIR}"
+
+# Create initial state if doesn't exist
+if [[ ! -f "${STATE_FILE}" ]]; then
+    cat > "${STATE_FILE}" << 'EOF'
+{
+  "settings": {
+    "language": "en",
+    "notifications": true
+  },
+  "achievements": {},
+  "counters": {
+    "ralph_iterations": 0,
+    "files_read": 0,
+    "edits_made": 0
+  },
+  "session": {
+    "files_read_set": [],
+    "ralph_loop_active": false
+  }
+}
+EOF
+    echo "State file initialized at: ${STATE_FILE}"
+else
+    echo "State file already exists at: ${STATE_FILE}"
+fi
+
+exit 0

package/scripts/show-achievements.sh

@@ -0,0 +1,152 @@
+#!/bin/bash
+# show-achievements.sh - Display achievements in a clean TUI-style view
+
+set -e
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$0")")}"
+STATE_FILE="${HOME}/.claude/achievements/state.json"
+ACHIEVEMENTS_FILE="${PLUGIN_ROOT}/data/achievements.json"
+
+# Initialize state if needed
+if [[ ! -f "${STATE_FILE}" ]]; then
+    mkdir -p "$(dirname "${STATE_FILE}")"
+    cat > "${STATE_FILE}" << 'EOF'
+{
+  "settings": { "language": "en", "notifications": true, "notification_style": "system" },
+  "achievements": {},
+  "counters": { "ralph_iterations": 0 },
+  "session": { "files_read_set": [] }
+}
+EOF
+fi
+
+# Get user's language preference
+LANG=$(jq -r '.settings.language // "en"' "${STATE_FILE}")
+I18N_FILE="${PLUGIN_ROOT}/data/i18n/${LANG}.json"
+
+# Function to get localized text
+get_localized() {
+    local key="$1"
+    local fallback="$2"
+    local result=""
+    if [[ -f "${I18N_FILE}" ]]; then
+        result=$(jq -r "${key} // empty" "${I18N_FILE}" 2>/dev/null)
+    fi
+    if [[ -z "${result}" || "${result}" == "null" ]]; then
+        echo "${fallback}"
+    else
+        echo "${result}"
+    fi
+}
+
+get_achievement_name() {
+    local id="$1"
+    get_localized ".achievements[\"${id}\"].name" "$(jq -r ".achievements[\"${id}\"].name" "${ACHIEVEMENTS_FILE}")"
+}
+
+get_achievement_desc() {
+    local id="$1"
+    get_localized ".achievements[\"${id}\"].description" "$(jq -r ".achievements[\"${id}\"].description" "${ACHIEVEMENTS_FILE}")"
+}
+
+# Get rarity emoji
+get_rarity_emoji() {
+    case "$1" in
+        common) echo "⬜" ;;
+        uncommon) echo "🟩" ;;
+        rare) echo "🟦" ;;
+        epic) echo "🟪" ;;
+        legendary) echo "🟨" ;;
+        *) echo "⬜" ;;
+    esac
+}
+
+# Calculate stats
+print_header() {
+    local total=$(jq '.achievements | length' "${ACHIEVEMENTS_FILE}")
+    local unlocked=$(jq '.achievements | to_entries | map(select(.value.unlocked == true)) | length' "${STATE_FILE}")
+    local percent=0
+    [[ ${total} -gt 0 ]] && percent=$((unlocked * 100 / total))
+
+    echo ""
+    echo "🎮 CLAUDE CODE ACHIEVEMENTS"
+    echo "┌────────────────────────────────────────────────────────┐"
+    echo "│"
+
+    # Progress bar
+    local filled=$((percent / 5))
+    local empty=$((20 - filled))
+    printf "│   "
+    for ((i=0; i<filled; i++)); do printf "█"; done
+    for ((i=0; i<empty; i++)); do printf "░"; done
+    printf "  %d/%d unlocked (%d%%)\n" "${unlocked}" "${total}" "${percent}"
+    echo "│"
+}
+
+# Show achievements for a category
+show_category() {
+    local category="$1"
+    local category_name=$(jq -r ".categories[\"${category}\"].name // \"${category}\"" "${ACHIEVEMENTS_FILE}")
+    local localized_name=$(get_localized ".categories[\"${category}\"].name" "${category_name}")
+
+    echo "├── ${localized_name} ─────────────────────────────────────"
+    echo "│"
+
+    # Get achievements in this category
+    local ids=$(jq -r ".achievements | to_entries | map(select(.value.category == \"${category}\")) | .[].key" "${ACHIEVEMENTS_FILE}")
+
+    for id in ${ids}; do
+        local icon=$(jq -r ".achievements[\"${id}\"].icon // \"🏆\"" "${ACHIEVEMENTS_FILE}")
+        local rarity=$(jq -r ".achievements[\"${id}\"].rarity // \"common\"" "${ACHIEVEMENTS_FILE}")
+        local rarity_emoji=$(get_rarity_emoji "${rarity}")
+        local name=$(get_achievement_name "${id}")
+        local desc=$(get_achievement_desc "${id}")
+
+        local unlocked="false"
+        if jq -e ".achievements[\"${id}\"].unlocked == true" "${STATE_FILE}" > /dev/null 2>&1; then
+            unlocked="true"
+        fi
+
+        if [[ "${unlocked}" == "true" ]]; then
+            echo "│   ✅ ${icon} ${name} ${rarity_emoji}"
+        else
+            echo "│   ⬛ ${icon} ${name} ${rarity_emoji}"
+            echo "│        ↳ ${desc}"
+        fi
+    done
+    echo "│"
+}
+
+# Show rarity legend
+show_legend() {
+    echo "├────────────────────────────────────────────────────────┤"
+    echo "│  ⬜ Common  🟩 Uncommon  🟦 Rare  🟪 Epic  🟨 Legendary"
+    echo "└────────────────────────────────────────────────────────┘"
+    echo ""
+}
+
+# Main
+ARG="${1:-all}"
+
+print_header
+
+case "${ARG}" in
+    stats)
+        show_legend
+        ;;
+    all)
+        for category in $(jq -r '.categories | to_entries | sort_by(.value.order) | .[].key' "${ACHIEVEMENTS_FILE}"); do
+            show_category "${category}"
+        done
+        show_legend
+        ;;
+    *)
+        if jq -e ".categories[\"${ARG}\"]" "${ACHIEVEMENTS_FILE}" > /dev/null 2>&1; then
+            show_category "${ARG}"
+            show_legend
+        else
+            echo "Unknown: ${ARG}"
+            echo "Available: basics, workflow, tools, mastery"
+        fi
+        ;;
+esac