forge-update

/forge-update - Claude Forge 자체 업데이트

---

플래그

플래그	설명
--check-only	업데이트 확인만, 실제 pull하지 않음
--force	로컬 변경사항이 있어도 stash 후 강제 진행
(없음)	업데이트 확인 + pull + 후처리

---

1단계: 메타파일 로드

FORGE_META="$HOME/.claude/.forge-meta.json"

메타파일이 있으면:

REPO_PATH=$(jq -r '.repo_path' "$FORGE_META")
INSTALL_MODE=$(jq -r '.install_mode' "$FORGE_META")
CURRENT_VERSION=$(jq -r '.version' "$FORGE_META")
CURRENT_COMMIT=$(jq -r '.git_commit' "$FORGE_META")

메타파일이 없으면 (이전 버전 설치):

# symlink에서 저장소 경로 추론
REPO_PATH=$(cd -P "$(readlink "$HOME/.claude/agents")" 2>/dev/null && cd .. && pwd)

추론도 실패하면 에러:

Claude Forge 저장소를 찾을 수 없습니다.
다시 clone 후 install.sh를 실행하세요:
  git clone https://github.com/sangrokjung/claude-forge.git
  cd claude-forge && ./install.sh

---

2단계: 저장소 검증 (CRITICAL - 보안)

repo_path를 신뢰하기 전에 반드시 검증한다.

# 1. 경로 정규화 (심링크 해제)
REPO_PATH=$(cd "$REPO_PATH" 2>/dev/null && pwd -P)

# 2. .git 디렉토리 존재 확인
ls -d "$REPO_PATH/.git"

# 3. claude-forge 저장소인지 특징 파일로 검증
ls "$REPO_PATH/.claude-plugin/plugin.json"

# 4. remote URL이 claude-forge인지 확인
REMOTE_URL=$(cd "$REPO_PATH" && git remote get-url origin 2>/dev/null)
echo "$REMOTE_URL" | grep -q 'claude-forge'

검증 실패 시:

저장소 경로가 유효하지 않거나 claude-forge 저장소가 아닙니다: {REPO_PATH}
다시 clone 후 install.sh를 실행하세요.

---

3단계: 로컬 변경사항 체크

cd "$REPO_PATH"
git status --porcelain

변경사항이 있으면:

• --force 없음: 경고 메시지 출력 + 중단

  로컬 변경사항이 있습니다:
    {변경 파일 목록}
  --force 플래그로 stash 후 진행하거나, 수동으로 정리해주세요.
  

• --force 있음: git stash 실행 후 진행

---

4단계: 원격 fetch + 기본 브랜치 감지

git fetch origin

실패 시 (네트워크 오류):

원격 저장소에 연결할 수 없습니다.
네트워크 연결을 확인하세요.

기본 브랜치 동적 감지:

DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||')
if [ -z "$DEFAULT_BRANCH" ]; then
    DEFAULT_BRANCH="main"
fi

---

5단계: 버전 비교

LOCAL_HEAD=$(git rev-parse HEAD)
REMOTE_HEAD=$(git rev-parse "origin/$DEFAULT_BRANCH")