@kood/claude-code 0.6.5 → 0.6.7

package/templates/.claude/scripts/deploy/build-run.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# build-run.sh - Package manager 감지 후 build 실행
+# Usage: ./build-run.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PM_DIR="$SCRIPT_DIR/../pm"
+
+# Package manager 감지
+PM=$("$PM_DIR/pm-detect.sh")
+
+echo "=== Building with $PM ==="
+
+# Build 실행
+case "$PM" in
+  bun)
+    bun run build
+    ;;
+  pnpm)
+    pnpm run build
+    ;;
+  yarn)
+    yarn build
+    ;;
+  npm)
+    npm run build
+    ;;
+  *)
+    echo "Error: Unknown package manager: $PM" >&2
+    exit 1
+    ;;
+esac
+
+echo ""
+echo "✓ Build completed successfully"

package/templates/.claude/scripts/deploy/deploy-check.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# deploy-check.sh - 배포 전 전체 검증 (tsc + eslint + build)
+# Usage: ./deploy-check.sh
+# 검사 실패 시 조기 종료
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LINT_DIR="$SCRIPT_DIR/../lint"
+
+echo "=========================================="
+echo "  Pre-Deploy Verification"
+echo "=========================================="
+
+# 스크립트 존재 검증
+if [ ! -x "$LINT_DIR/lint-check.sh" ]; then
+  echo "Error: lint-check.sh not found or not executable" >&2
+  exit 1
+fi
+if [ ! -x "$SCRIPT_DIR/build-run.sh" ]; then
+  echo "Error: build-run.sh not found or not executable" >&2
+  exit 1
+fi
+
+# Step 1: Lint 검사 (tsc + eslint 병렬)
+echo ""
+echo "[1/2] Running lint checks..."
+"$LINT_DIR/lint-check.sh"
+
+# Step 2: Build
+echo ""
+echo "[2/2] Running build..."
+"$SCRIPT_DIR/build-run.sh"
+
+echo ""
+echo "=========================================="
+echo "  ✓ All checks passed - Ready to deploy"
+echo "=========================================="

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

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# git-all.sh - 모든 변경사항 add + commit + push (단순 케이스)
+# Usage: ./git-all.sh "커밋 메시지"
+# WARNING: git add -A 사용 - 민감 파일(.env 등) 포함 주의
+
+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 [ -z "$1" ]; then
+  echo "Usage: $0 \"commit message\""
+  exit 1
+fi
+
+COMMIT_MSG="$1"
+
+# 빈 메시지 체크
+if [ -z "$(echo "$COMMIT_MSG" | xargs)" ]; then
+  echo "Error: Commit message cannot be empty" >&2
+  exit 1
+fi
+
+# 변경사항 확인
+if [ -n "$(git status --porcelain)" ]; then
+  # 민감 파일 검증
+  SENSITIVE=$(git status --porcelain | grep -E '^\?\?.*\.(env|pem|key|secret|credentials)' || true)
+  if [ -n "$SENSITIVE" ]; then
+    echo "ERROR: Sensitive files detected:" >&2
+    echo "$SENSITIVE" >&2
+    echo "" >&2
+    echo "Please use git-commit.sh with specific files instead" >&2
+    exit 1
+  fi
+
+  echo "=== Adding all changes ==="
+  git add -A
+
+  echo "=== Committing ==="
+  git commit -m "$COMMIT_MSG"
+
+  echo "=== Pushing ==="
+  BRANCH=$(git branch --show-current)
+  if ! git rev-parse --abbrev-ref "@{upstream}" >/dev/null 2>&1; then
+    git push -u origin "$BRANCH"
+  else
+    git push
+  fi
+
+  echo "Done: All changes committed and pushed"
+else
+  echo "No changes to commit"
+  exit 0
+fi

package/templates/.claude/scripts/git/git-clean-check.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# git-clean-check.sh - Working directory clean 여부 확인
+# Usage: ./git-clean-check.sh [--quiet]
+# Exit 0: clean, Exit 1: dirty
+
+set -uo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+QUIET=false
+if [ "${1:-}" = "--quiet" ]; then
+  QUIET=true
+fi
+
+if [ -n "$(git status --porcelain)" ]; then
+  if [ "$QUIET" = false ]; then
+    echo "Working directory is DIRTY"
+    echo ""
+    git status --short
+  fi
+  exit 1
+else
+  if [ "$QUIET" = false ]; then
+    echo "Working directory is CLEAN"
+  fi
+  exit 0
+fi

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

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# git-commit.sh - 커밋 실행
+# Usage: ./git-commit.sh "커밋 메시지" [files...]
+# files 미지정 시 staged files만 커밋
+
+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 [ -z "$1" ]; then
+  echo "Usage: $0 \"commit message\" [files...]"
+  echo "  files: 커밋할 파일들 (미지정 시 staged files만)"
+  exit 1
+fi
+
+COMMIT_MSG="$1"
+
+# 빈 메시지 체크
+if [ -z "$(echo "$COMMIT_MSG" | xargs)" ]; then
+  echo "Error: Commit message cannot be empty" >&2
+  exit 1
+fi
+
+shift
+FILES_PROVIDED=$#
+
+# 파일 지정된 경우 add
+if [ $FILES_PROVIDED -gt 0 ]; then
+  git add "$@"
+fi
+
+# staged 파일 확인
+if git diff --cached --quiet; then
+  if [ $FILES_PROVIDED -eq 0 ]; then
+    echo "Error: No staged changes to commit"
+    echo "Tip: Stage files with 'git add' or pass files as arguments"
+  else
+    echo "Error: No changes in specified files"
+    echo "Tip: Check if files exist and have modifications"
+  fi
+  exit 1
+fi
+
+# 커밋
+git commit -m "$COMMIT_MSG"
+
+echo "Committed successfully"

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

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# git-info.sh - Git 상태 및 diff 요약 출력
+# 에이전트가 분석할 정보를 빠르게 수집
+
+set -euo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+echo "=== Git Status ==="
+if [ -n "$(git status --porcelain)" ]; then
+  git status --short
+else
+  echo "(clean)"
+fi
+
+echo ""
+echo "=== Changed Files ==="
+git diff --stat
+
+echo ""
+echo "=== Staged Files ==="
+git diff --cached --stat
+
+echo ""
+echo "=== Recent Commits (5) ==="
+git log --oneline -5
+
+echo ""
+echo "=== Current Branch ==="
+git branch --show-current

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

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# git-push.sh - 안전한 푸시 (상태 확인 후)
+# Usage: ./git-push.sh [--force]
+
+set -euo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+# 현재 브랜치
+BRANCH=$(git branch --show-current)
+
+if [ -z "$BRANCH" ]; then
+  echo "Error: Not on any branch (detached HEAD)"
+  exit 1
+fi
+
+# Force push 처리
+USE_FORCE=false
+if [ "${1:-}" = "--force" ]; then
+  # main/master 보호
+  if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
+    echo "ERROR: Cannot force push to $BRANCH"
+    echo "This operation is too dangerous on protected branches"
+    exit 1
+  fi
+  USE_FORCE=true
+  echo "Warning: Force push enabled (with lease) to $BRANCH"
+fi
+
+# upstream 확인 및 push
+if ! git rev-parse --abbrev-ref "@{upstream}" >/dev/null 2>&1; then
+  echo "Setting upstream for branch: $BRANCH"
+  if [ "$USE_FORCE" = true ]; then
+    git push -u origin "$BRANCH" --force-with-lease
+  else
+    git push -u origin "$BRANCH"
+  fi
+else
+  if [ "$USE_FORCE" = true ]; then
+    git push --force-with-lease
+  else
+    git push
+  fi
+fi
+
+echo "Pushed to origin/$BRANCH"

package/templates/.claude/scripts/lint/lint-check.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# lint-check.sh - tsc + eslint 병렬 실행
+# Usage: ./lint-check.sh
+# 두 검사를 병렬로 실행하고 결과를 수집
+
+set -uo pipefail
+
+# 임시 파일
+TSC_OUT=$(mktemp)
+ESLINT_OUT=$(mktemp)
+TSC_EXIT=0
+ESLINT_EXIT=0
+
+# Cleanup (ERR, INT, TERM도 처리)
+trap "rm -f $TSC_OUT $ESLINT_OUT" EXIT ERR INT TERM
+
+echo "=== Running TypeScript + ESLint in parallel ==="
+
+# 병렬 실행
+(npx tsc --noEmit > "$TSC_OUT" 2>&1) &
+TSC_PID=$!
+
+(npx eslint . > "$ESLINT_OUT" 2>&1) &
+ESLINT_PID=$!
+
+# 대기
+wait $TSC_PID || TSC_EXIT=$?
+wait $ESLINT_PID || ESLINT_EXIT=$?
+
+# 결과 출력
+echo ""
+echo "=== TypeScript Results ==="
+if [ $TSC_EXIT -eq 0 ]; then
+  echo "✓ No type errors"
+else
+  cat "$TSC_OUT"
+fi
+
+echo ""
+echo "=== ESLint Results ==="
+if [ $ESLINT_EXIT -eq 0 ]; then
+  echo "✓ No lint errors"
+else
+  cat "$ESLINT_OUT"
+fi
+
+echo ""
+echo "=== Summary ==="
+if [ $TSC_EXIT -eq 0 ] && [ $ESLINT_EXIT -eq 0 ]; then
+  echo "✓ All checks passed"
+  exit 0
+else
+  [ $TSC_EXIT -ne 0 ] && echo "✗ TypeScript: FAILED"
+  [ $ESLINT_EXIT -ne 0 ] && echo "✗ ESLint: FAILED"
+  exit 1
+fi

package/templates/.claude/scripts/lint/lint-file.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# lint-file.sh - 특정 파일/디렉토리만 검사
+# Usage: ./lint-file.sh <file|directory> [file2...]
+# Example: ./lint-file.sh src/utils/api.ts
+#          ./lint-file.sh src/components/
+
+set -uo pipefail
+
+if [ $# -eq 0 ]; then
+  echo "Usage: $0 <file|directory> [file2...]"
+  echo "Example: $0 src/utils/api.ts"
+  exit 1
+fi
+
+TSC_EXIT=0
+ESLINT_EXIT=0
+
+echo "=== Checking: $@ ==="
+
+# TypeScript 검사 (전체 프로젝트 - tsc는 개별 파일 검사 미지원)
+echo ""
+echo "=== TypeScript ==="
+echo "(Note: tsc checks entire project)"
+npx tsc --noEmit || TSC_EXIT=$?
+
+# ESLint 검사
+echo ""
+echo "=== ESLint ==="
+npx eslint "$@" || ESLINT_EXIT=$?
+
+# 결과
+echo ""
+echo "=== Summary ==="
+if [ $TSC_EXIT -eq 0 ] && [ $ESLINT_EXIT -eq 0 ]; then
+  echo "✓ All checks passed"
+  exit 0
+else
+  [ $TSC_EXIT -ne 0 ] && echo "✗ TypeScript: FAILED"
+  [ $ESLINT_EXIT -ne 0 ] && echo "✗ ESLint: FAILED"
+  exit 1
+fi

package/templates/.claude/scripts/pm/pm-detect.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# pm-detect.sh - Package manager 자동 감지
+# Usage: ./pm-detect.sh
+# Output: npm | yarn | pnpm | bun
+# Exit 1 if no lock file found
+
+set -euo pipefail
+
+# Lock 파일 기반 감지
+if [ -f "bun.lockb" ]; then
+  echo "bun"
+elif [ -f "pnpm-lock.yaml" ]; then
+  echo "pnpm"
+elif [ -f "yarn.lock" ]; then
+  echo "yarn"
+elif [ -f "package-lock.json" ]; then
+  echo "npm"
+elif [ -f "package.json" ]; then
+  # Lock 파일 없으면 기본 npm
+  echo "Warning: No lock file found, defaulting to npm" >&2
+  echo "npm"
+else
+  echo "Error: No package.json found" >&2
+  exit 1
+fi

package/templates/.claude/scripts/pm/pm-run.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# pm-run.sh - 감지된 package manager로 스크립트 실행
+# Usage: ./pm-run.sh <script> [args...]
+# Example: ./pm-run.sh build
+#          ./pm-run.sh test --watch
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+if [ $# -eq 0 ] || [ -z "${1:-}" ]; then
+  echo "Usage: $0 <script> [args...]"
+  echo "Example: $0 build"
+  exit 1
+fi
+
+SCRIPT="$1"
+shift
+
+# Package manager 감지
+PM=$("$SCRIPT_DIR/pm-detect.sh")
+
+# 실행
+case "$PM" in
+  bun)
+    bun run "$SCRIPT" "$@"
+    ;;
+  pnpm)
+    pnpm run "$SCRIPT" "$@"
+    ;;
+  yarn)
+    yarn "$SCRIPT" "$@"
+    ;;
+  npm)
+    npm run "$SCRIPT" "$@"
+    ;;
+  *)
+    echo "Error: Unknown package manager: $PM" >&2
+    exit 1
+    ;;
+esac

package/templates/.claude/scripts/version/version-bump.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# version-bump.sh - 버전 계산
+# Usage: ./version-bump.sh <current_version> <bump_type>
+# bump_type: +1 (patch), +minor, +major, or direct version (x.x.x)
+# Example: ./version-bump.sh 1.2.3 +1      → 1.2.4
+#          ./version-bump.sh 1.2.3 +minor  → 1.3.0
+#          ./version-bump.sh 1.2.3 +major  → 2.0.0
+#          ./version-bump.sh 1.2.3 2.0.0   → 2.0.0
+
+set -euo pipefail
+
+if [ $# -lt 2 ]; then
+  echo "Usage: $0 <current_version> <bump_type>"
+  echo "bump_type: +1, +minor, +major, or x.x.x"
+  exit 1
+fi
+
+CURRENT="$1"
+BUMP="$2"
+
+# 버전 형식 먼저 검증
+if ! [[ "$CURRENT" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "Error: Invalid version format: $CURRENT" >&2
+  echo "Expected: x.x.x (e.g., 1.2.3)" >&2
+  exit 1
+fi
+
+# 버전 파싱
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+
+# 새 버전 계산
+case "$BUMP" in
+  +1|+patch)
+    NEW_VERSION="$MAJOR.$MINOR.$((PATCH + 1))"
+    ;;
+  +minor)
+    NEW_VERSION="$MAJOR.$((MINOR + 1)).0"
+    ;;
+  +major)
+    NEW_VERSION="$((MAJOR + 1)).0.0"
+    ;;
+  *)
+    # 직접 버전 지정 검증
+    if [[ "$BUMP" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+      NEW_VERSION="$BUMP"
+    else
+      echo "Error: Invalid bump type: $BUMP"
+      echo "Use: +1, +minor, +major, or x.x.x"
+      exit 1
+    fi
+    ;;
+esac
+
+echo "$NEW_VERSION"

package/templates/.claude/scripts/version/version-find.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# version-find.sh - 버전 파일 탐색
+# Usage: ./version-find.sh
+# package.json과 .version() 코드 파일을 병렬로 탐색
+
+set -uo pipefail
+
+echo "=== Searching version files ==="
+
+# 임시 파일
+PKG_OUT=$(mktemp)
+CODE_OUT=$(mktemp)
+
+trap "rm -f $PKG_OUT $CODE_OUT" EXIT ERR INT TERM
+
+# 병렬 탐색 (fd 우선, 없으면 find)
+if command -v fd &>/dev/null; then
+  fd -t f 'package.json' -E node_modules > "$PKG_OUT" 2>&1 &
+else
+  find . -name 'package.json' -not -path '*/node_modules/*' > "$PKG_OUT" 2>&1 &
+fi
+PID1=$!
+
+(rg "\.version\(['\"]" --type ts --type js -l 2>/dev/null || true) > "$CODE_OUT" &
+PID2=$!
+
+wait $PID1
+wait $PID2
+
+# 결과 출력
+echo ""
+echo "=== package.json files ==="
+if [ -s "$PKG_OUT" ]; then
+  cat "$PKG_OUT"
+else
+  echo "(none found)"
+fi
+
+echo ""
+echo "=== Code files with .version() ==="
+if [ -s "$CODE_OUT" ]; then
+  cat "$CODE_OUT"
+else
+  echo "(none found)"
+fi
+
+echo ""
+echo "=== All version files ==="
+cat "$PKG_OUT" "$CODE_OUT" | sort -u

package/templates/.claude/skills/docs-fetch/SKILL.md

@@ -74,8 +74,9 @@ ARGUMENT 있음 → 다음 단계 진행
 | **2** | GitHub MCP + gh CLI | README, docs/, CHANGELOG 직접 접근 |
 | **3** | Firecrawl `/map`→`/crawl` + SearXNG 검색 | 문서 일괄 수집 + breaking changes 보충 (동시 실행) |
 | **4** | Context7 MCP | 라이브러리 문서 즉시 조회, 업데이트 지연 가능성 있음 |
-| **5** | WebFetch | 개별 페이지 직접 읽기 |
-| **6** | WebSearch | 최후 보충 검색 |
+| **5** | Jina Reader | `WebFetch('https://r.jina.ai/{URL}')` JS 렌더링 클린 MD (WebFetch 실패 시) |
+| **6** | WebFetch | 개별 페이지 직접 읽기 |
+| **7** | WebSearch | 최후 보충 검색 |
 
 **Smart Tier Fallback 및 MCP 통합 전략**: @../../instructions/sourcing/reliable-search.md 참조
 
@@ -174,7 +175,7 @@ Task(subagent_type="researcher", model="haiku",
 | Tier | 경로 | 실행 |
 |------|------|------|
 | **1 (MCP)** | Firecrawl + SearXNG | `firecrawl_map` → `firecrawl_crawl` (최대 50p) + `searxng_search` 병렬 |
-| **2 (내장)** | WebFetch | llms.txt 링크 우선, 없으면 GitHub docs/ + 공식 문서 10-15p (5개씩 병렬) |
+| **2 (내장)** | Jina Reader + WebFetch | llms.txt 링크 우선, SPA 문서는 `r.jina.ai` 경유, 없으면 GitHub docs/ + 공식 문서 10-15p (5개씩 병렬) |
 
 ### 공통: Breaking Changes 추출
 
@@ -386,7 +387,7 @@ researcher(검색) ──┘
 | **Context7** | `resolve-library-id`, `get-library-docs` | 라이브러리 문서 즉시 조회 (업데이트 지연 가능) |
 | **GitHub** | `get_file_contents`, `get_latest_release` | README, docs/, CHANGELOG |
 
-**MCP 미설치** → WebFetch (페이지별) + WebSearch (내장) + `gh api` (CLI) 폴백
+**MCP 미설치** → Jina Reader (`r.jina.ai`) → WebFetch (페이지별) → WebSearch (내장) → `gh api` (CLI) 폴백
 
 </mcp_integration>