project-auto-wizard 0.13.3 → 0.14.0

package/payload/workflows/common/PROJECT-COMMON-RELEASE-PUBLISH.yaml

@@ -62,14 +62,14 @@ on:
 
 permissions:
   contents: write
-  # README-VERSION-UPDATE·배포 워크플로우를 workflow_dispatch로 깨운다
+  # Wake README-VERSION-UPDATE and the deploy workflows via workflow_dispatch
   actions: write
-  # 릴리스 PR을 누가 병합했는지 읽어 배포를 다시 깨울지 정한다
+  # Read who merged the release PR to decide whether deploys must be woken again
   pull-requests: read
   copilot-requests: write
 
 env:
-  # 스크립트 import가 .github/scripts/__pycache__를 만들어 봇 커밋에 섞이지 않게 한다
+  # Keep script imports from creating .github/scripts/__pycache__ so it never ends up in bot commits
   PYTHONDONTWRITEBYTECODE: "1"
 
 jobs:
@@ -103,6 +103,7 @@ jobs:
       - name: Release gate
         id: gate
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           MODE="${{ steps.mode.outputs.mode }}"
           EVENT="${{ github.event_name }}"
           HEAD_MSG=$(git log -1 --pretty=%B)
@@ -145,13 +146,13 @@ jobs:
           if [ "$FILE_VERSION" != "$LATEST_VERSION" ] && [ "$HIGHER" = "$FILE_VERSION" ]; then
             echo "::error::version.yml($FILE_VERSION) is ahead of the newest tag($LATEST_TAG) but no release was published — this version will never reach npm. Recover with: Actions → PROJECT-RELEASE-PUBLISH → Run workflow (workflow_dispatch bypasses this gate)."
             {
-              echo "### ⚠️ 릴리스 누락 감지"
+              echo "$(m wf_release.drift_heading)"
               echo ""
-              echo "- version.yml: \`$FILE_VERSION\`"
-              echo "- 최신 태그: \`$LATEST_TAG\`"
+              echo "$(m wf_release.drift_version_line version="$FILE_VERSION")"
+              echo "$(m wf_release.drift_tag_line tag="$LATEST_TAG")"
               echo ""
-              echo "릴리스 확정 없이 버전만 올라갔습니다. 이 버전은 npm에 배포되지 않습니다."
-              echo "복구: Actions → PROJECT-RELEASE-PUBLISH → Run workflow"
+              echo "$(m wf_release.drift_body)"
+              echo "$(m wf_release.drift_recover)"
             } >> "$GITHUB_STEP_SUMMARY"
             exit 1
           fi
@@ -230,8 +231,9 @@ jobs:
             DIFF_BASE="4b825dc642cb6eb9a060e54bf8d69288fbee4904" # git empty tree hash
           fi
           git log --pretty=%s "$LOG_RANGE" > commits.txt
-          # 본문 푸터 BREAKING CHANGE:는 제목 목록 뒤에 한 줄씩 덧붙인다 — 스크립트는 한 줄을
-          # 한 항목으로 읽으므로 본문 전체(%B)를 넣으면 설명 줄까지 변경 항목으로 잡힌다.
+          # Body-footer BREAKING CHANGE: lines are appended after the subject list, one per
+          # line. The script reads each line as one entry, so passing the whole body (%B)
+          # would turn description lines into change entries.
           git log --pretty=%b "$LOG_RANGE" | grep -E '^BREAKING[ -]CHANGE[[:space:]]*:' >> commits.txt || true
           git diff --stat "${DIFF_BASE}..HEAD" > _full_diff_stat.txt
           if [ "$(wc -l < _full_diff_stat.txt)" -gt 49 ]; then
@@ -281,9 +283,9 @@ jobs:
 
           rm -f pr_body.md summary.md commits.txt diff_stat.txt
 
-          # -A는 러너가 만든 임시 파일·캐시까지 사용자 레포에 커밋한다.
-          # 버전 파일은 이미 추적 중이라 -u로 충분하고, 첫 릴리스에 새로 생기는
-          # CHANGELOG만 따로 올린다 (.gitignore에 있으면 건너뛴다).
+          # -A would also commit runner temp files and caches into the user's repo.
+          # Version files are already tracked, so -u is enough; only a CHANGELOG
+          # created by the first release is added separately (skipped if ignored).
           git add -u
           git ls-files -z --others --exclude-standard -- CHANGELOG.json CHANGELOG.md | xargs -0 -r git add --
           if git diff --staged --quiet; then
@@ -400,9 +402,10 @@ jobs:
       - name: Create GitHub Release
         if: steps.gate.outputs.proceed == 'true' && steps.version.outputs.release_exists != 'true'
         env:
-          # WORKFLOW_PAT으로 발행해야 release 이벤트가 후속 워크플로우(npm 배포 등)를 트리거한다.
-          # GITHUB_TOKEN이 만든 이벤트는 GitHub 정책상 다른 워크플로우를 깨우지 못한다.
-          # PAT이 없는 레포에서도 릴리스 자체는 계속 동작해야 하므로 기본 토큰으로 폴백한다.
+          # Publishing with WORKFLOW_PAT lets the release event trigger follow-up workflows
+          # (npm publish etc.). Events created by GITHUB_TOKEN never wake other workflows
+          # (GitHub policy). Repos without a PAT must still release, so fall back to the
+          # default token.
           GH_TOKEN: ${{ secrets.WORKFLOW_PAT || github.token }}
         run: |
           VERSION="${{ steps.version.outputs.version }}"
@@ -410,26 +413,31 @@ jobs:
           echo "GitHub Release v$VERSION published"
 
       - name: Trigger README-VERSION-UPDATE
-        # 봇 토큰(GITHUB_TOKEN)이 만든 push는 README 갱신 워크플로우를 깨우지 못한다 —
-        # PAT 없는 릴리스 PR 병합, 안전망·trunk-based의 [skip ci] 버전 커밋이 그렇다.
-        # 릴리스를 새로 발행했을 때 확정된 버전으로 한 번 직접 깨운다 (중복 실행돼도 변경 없으면 커밋 안 함).
+        # Pushes made with the bot token (GITHUB_TOKEN) never wake the README update
+        # workflow - that covers a release PR merged without a PAT and the [skip ci]
+        # version commits of the safety net and trunk-based releases.
+        # When a release is newly published, wake it once with the confirmed version
+        # (a duplicate run commits nothing if there is no change).
         if: steps.gate.outputs.proceed == 'true' && steps.version.outputs.release_exists != 'true'
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           if gh workflow run PROJECT-COMMON-README-VERSION-UPDATE.yaml --ref {{MAIN_BRANCH}}; then
-            echo "README-VERSION-UPDATE workflow_dispatch 트리거 요청 완료"
+            echo "$(m wf_release.readme_dispatch_ok)"
           else
-            echo "::notice::README-VERSION-UPDATE 워크플로우를 깨우지 못했습니다 (삭제했거나 비활성화됨) — README 버전 갱신을 건너뜁니다"
+            echo "::notice::$(m wf_release.readme_dispatch_skip)"
           fi
 
       - name: Trigger deploy workflows
-        # 봇 토큰(GITHUB_TOKEN)이 병합한 릴리스 PR의 push는 {{MAIN_BRANCH}}의 배포 워크플로우(on: push)를
-        # 깨우지 못한다 — PAT 없는 기본 설치에서 서버·스토어 배포가 한 번도 돌지 않는다.
-        # 그런 병합일 때만 배포 워크플로우를 workflow_dispatch로 직접 깨운다. PAT·사람이 병합했다면
-        # push 이벤트로 이미 실행됐으므로 다시 깨우지 않는다 (중복 배포 방지).
-        # 대상: 마법사가 설치한 워크플로우 중 push.branches에 {{MAIN_BRANCH}}가 있고 workflow_dispatch가
-        # 있는 것. 모노레포 paths 필터는 push와 같은 범위(병합 커밋의 변경 파일)로 평가한다.
+        # A release PR merged with the bot token (GITHUB_TOKEN) never wakes the
+        # {{MAIN_BRANCH}} deploy workflows (on: push) - on a default install without a PAT,
+        # server/store deploys would never run. Only for such merges, wake the deploy
+        # workflows directly via workflow_dispatch. A PAT or human merge already fired
+        # the push event, so they are not woken again (no double deploy).
+        # Targets: installed workflows that list {{MAIN_BRANCH}} in push.branches and
+        # have workflow_dispatch. Monorepo paths filters are evaluated against the same
+        # scope as the push (files changed by the merge commit).
         if: >-
           steps.gate.outputs.proceed == 'true' &&
           steps.version.outputs.release_exists != 'true' &&
@@ -441,33 +449,35 @@ jobs:
           RELEASE_VERSION: ${{ steps.version.outputs.version }}
           MAIN_BRANCH: "{{MAIN_BRANCH}}"
         run: |
-          # 이 버전의 릴리스 PR 병합 커밋 — 안전망 bump·수동 재발행처럼 병합이 아닌 릴리스는
-          # 사람의 push가 이미 배포를 깨웠으므로 건너뛴다.
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
+          # Merge commit of this version's release PR - releases that are not merges
+          # (safety-net bump, manual republish) were already deployed by a human push,
+          # so they are skipped.
           MERGE_LINE=$(git log --first-parent --pretty='%H %s' -n 100 | grep -m1 -F " chore(release): v${RELEASE_VERSION} (PR #" || true)
           if [ -z "$MERGE_LINE" ]; then
-            echo "v${RELEASE_VERSION}은 릴리스 PR 병합으로 들어온 릴리스가 아닙니다 — 배포는 push 이벤트가 맡습니다"
+            echo "$(m wf_release.not_merge_release version="$RELEASE_VERSION")"
             exit 0
           fi
           MERGE_SHA=${MERGE_LINE%% *}
           PR_NUMBER=$(printf '%s\n' "$MERGE_LINE" | sed -n 's/.*(PR #\([0-9][0-9]*\)).*/\1/p')
 
-          # 병합 주체로 push 이벤트가 떴는지 판정한다. 조회에 실패하면 PAT 등록 여부로 대신 판단한다.
+          # Decide from the merger whether a push event fired. If the lookup fails, fall back to whether a PAT is registered.
           MERGED_BY=""
           if [ -n "$PR_NUMBER" ]; then
             MERGED_BY=$(gh api "repos/${GITHUB_REPOSITORY}/pulls/${PR_NUMBER}" --jq '.merged_by.login // ""' 2>/dev/null || true)
           fi
           case "$MERGED_BY" in
-            # GITHUB_TOKEN 병합자는 정확히 이 로그인이다 — 접두사만 같은 다른 계정은 사람 병합으로 본다
-            "github-actions[bot]") echo "PR #${PR_NUMBER}을 봇 토큰이 병합했습니다 — push 이벤트가 배포를 깨우지 못했습니다" ;;
+            # A GITHUB_TOKEN merger is exactly this login - another account sharing only the prefix counts as a human merge
+            "github-actions[bot]") echo "$(m wf_release.bot_merged pr="$PR_NUMBER")" ;;
             "")
               if [ "$HAS_WORKFLOW_PAT" = "true" ]; then
-                echo "병합 주체를 확인하지 못했고 WORKFLOW_PAT이 있습니다 — push 이벤트가 배포를 실행했다고 보고 건너뜁니다"
+                echo "$(m wf_release.merger_unknown_pat)"
                 exit 0
               fi
-              echo "병합 주체를 확인하지 못했고 WORKFLOW_PAT이 없습니다 — 봇 토큰 병합으로 봅니다"
+              echo "$(m wf_release.merger_unknown_nopat)"
               ;;
             *)
-              echo "PR #${PR_NUMBER}을 ${MERGED_BY}이(가) 병합했습니다 — push 이벤트가 배포를 이미 실행했으므로 건너뜁니다"
+              echo "$(m wf_release.human_merged pr="$PR_NUMBER" user="$MERGED_BY")"
               exit 0
               ;;
           esac
@@ -476,7 +486,7 @@ jobs:
           git diff --name-only "${MERGE_SHA}^1" "$MERGE_SHA" > "$CHANGED_FILES" || rm -f "$CHANGED_FILES"
           export CHANGED_FILES
 
-          # 명령 치환 안의 heredoc은 따옴표 해석이 어긋나므로 파일로 먼저 쓴다
+          # A heredoc inside a command substitution misparses quotes, so write it to a file first
           FIND_DEPLOY="${RUNNER_TEMP:-/tmp}/find_deploy_workflows.py"
           cat > "$FIND_DEPLOY" <<'PY'
           import os, re
@@ -488,7 +498,7 @@ jobs:
               with open(os.environ["CHANGED_FILES"], encoding="utf-8") as f:
                   CHANGED = [l.strip() for l in f if l.strip()]
 
-          # YAML 라이브러리 없이 on 블록만 읽는다 — 러너 파이썬에 PyYAML이 있다고 가정하지 않는다.
+          # Read only the on block without a YAML library - do not assume the runner's Python has PyYAML.
           def strip_comment(s):
               q = None
               for i, c in enumerate(s):
@@ -504,7 +514,7 @@ jobs:
               v = v.strip()
               return v[1:-1] if len(v) >= 2 and v[0] == v[-1] and v[0] in "\"'" else v
 
-          # GitHub 필터 문법: ** 는 / 포함 전부, * 와 ? 는 / 를 넘지 않는다. ! 는 뒤 패턴이 앞을 뒤집는다.
+          # GitHub filter syntax: ** matches everything including /, * and ? never cross /. A later ! pattern reverses an earlier match.
           def glob_re(p):
               out, i = "", 0
               while i < len(p):
@@ -576,7 +586,7 @@ jobs:
 
           root = ".github/workflows"
           for name in sorted(os.listdir(root)) if os.path.isdir(root) else []:
-              # 공통 워크플로우(릴리스·README·안전망)는 배포가 아니고, 필요한 것은 각자 따로 깨운다
+              # Common workflows (release, README, safety net) are not deploys; each is woken separately where needed
               if name.startswith("PROJECT-COMMON-") or not re.search(r"\.ya?ml$", name):
                   continue
               if is_target(os.path.join(root, name)):
@@ -585,18 +595,18 @@ jobs:
           TARGETS=$(python3 "$FIND_DEPLOY")
 
           if [ -z "$TARGETS" ]; then
-            echo "{{MAIN_BRANCH}} push로 도는 배포 워크플로우가 없습니다 — 건너뜁니다"
+            echo "$(m wf_release.no_targets branch="$MAIN_BRANCH")"
             exit 0
           fi
 
           FAILED=0
           for WF in $TARGETS; do
-            # 입력 없이 실행하면 workflow_dispatch 입력 기본값(설치 때 고른 배포 모드 등)을 쓴다
+            # Running without inputs uses the workflow_dispatch input defaults (e.g. the deploy mode chosen at install time)
             if gh workflow run "$WF" --ref {{MAIN_BRANCH}}; then
-              echo "$WF workflow_dispatch 트리거 요청 완료"
+              echo "$(m wf_release.deploy_trigger_ok wf="$WF")"
             else
               FAILED=1
-              echo "::warning::$WF 배포 워크플로우를 깨우지 못했습니다 — Actions 탭에서 Run workflow로 직접 실행하세요"
+              echo "::warning::$(m wf_release.deploy_trigger_warn wf="$WF")"
             fi
           done
           exit "$FAILED"

package/payload/workflows/common/PROJECT-COMMON-VERSION-CONTROL.yaml

@@ -47,7 +47,7 @@ permissions:
   actions: write
 
 env:
-  # 스크립트 import가 .github/scripts/__pycache__를 만들어 봇 커밋에 섞이지 않게 한다
+  # Keep script imports from creating .github/scripts/__pycache__ so it never ends up in bot commits
   PYTHONDONTWRITEBYTECODE: "1"
 
 jobs:
@@ -139,9 +139,11 @@ jobs:
           fi
 
       - name: Update CHANGELOG for the safety-net release
-        # 안전망 릴리스도 실제로 들어간 커밋으로 CHANGELOG 항목을 만든다. 항목이 없으면
-        # RELEASE-PUBLISH가 고정 문구로 릴리스 노트를 채우고 변경 내역이 어디에도 남지 않는다.
-        # 요약 엔진: 사용자 API(설정된 경우) -> 규칙 기반 (Copilot은 릴리스 PR·trunk 경로에서만 쓴다)
+        # Build the CHANGELOG entry from the commits that actually landed, even for a
+        # safety-net release. Without an entry RELEASE-PUBLISH fills the notes with fixed
+        # text and the change history is recorded nowhere.
+        # Summary engine: user API (if configured) -> rule-based (Copilot is used only on
+        # the release-PR and trunk paths)
         if: steps.release_guard.outputs.skip != 'true'
         env:
           AI_API_KEY: ${{ secrets.AI_API_KEY }}
@@ -150,12 +152,13 @@ jobs:
         run: |
           NEW_VERSION="${{ steps.version.outputs.new_version }}"
 
-          # 마지막 릴리스 태그 이후 {{MAIN_BRANCH}}에 직접 들어온 커밋 (태그가 없으면 전체 이력)
+          # Commits pushed straight to {{MAIN_BRANCH}} since the last release tag (full history if there is no tag)
           LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
           LOG_RANGE="${LAST_TAG:+${LAST_TAG}..}HEAD"
           git log --pretty=%s "$LOG_RANGE" > commits.txt
-          # 본문 푸터 BREAKING CHANGE:는 제목 목록 뒤에 한 줄씩 덧붙인다 — 스크립트는 한 줄을
-          # 한 항목으로 읽으므로 본문 전체(%B)를 넣으면 설명 줄까지 변경 항목으로 잡힌다.
+          # Body-footer BREAKING CHANGE: lines are appended after the subject list, one per
+          # line. The script reads each line as one entry, so passing the whole body (%B)
+          # would turn description lines into change entries.
           git log --pretty=%b "$LOG_RANGE" | grep -E '^BREAKING[ -]CHANGE[[:space:]]*:' >> commits.txt || true
           echo "commits since ${LAST_TAG:-the beginning}: $(wc -l < commits.txt)"
 
@@ -183,9 +186,9 @@ jobs:
           git config --local user.email "action@github.com"
           git config --local user.name "GitHub Action"
 
-          # -A는 러너가 만든 임시 파일·캐시까지 사용자 레포에 커밋한다.
-          # 버전 파일은 이미 추적 중이라 -u로 충분하고, 새로 생기는 CHANGELOG만
-          # 따로 올린다 (.gitignore에 있으면 건너뛴다).
+          # -A would also commit runner temp files and caches into the user's repo.
+          # Version files are already tracked, so -u is enough; only a newly created
+          # CHANGELOG is added separately (skipped if it is in .gitignore).
           git add -u
           git ls-files -z --others --exclude-standard -- CHANGELOG.json CHANGELOG.md | xargs -0 -r git add --
 
@@ -233,21 +236,25 @@ jobs:
             fi
           fi
 
-      - name: Trigger RELEASE-PUBLISH (safety-net bump 발행)
+      - name: Trigger RELEASE-PUBLISH (publish the safety-net bump)
         if: steps.release_guard.outputs.skip != 'true' && steps.commit_push.outputs.pushed == 'true'
         continue-on-error: true
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           gh workflow run PROJECT-COMMON-RELEASE-PUBLISH.yaml --ref {{MAIN_BRANCH}}
-          echo "RELEASE-PUBLISH workflow_dispatch 트리거 요청 완료 (WORKFLOW_PAT 없이도 동작, 이슈 #61 드리프트 자동 복구)"
+          echo "$(m wf_version.release_publish_triggered)"
 
       - name: Back-merge the safety-net bump into {{DEVELOP_BRANCH}}
-        # 안전망 bump는 {{MAIN_BRANCH}}에만 올라간다. {{DEVELOP_BRANCH}}가 이를 모르면 다음 릴리스 PR에서
-        # 양쪽이 같은 버전 줄을 고쳐 충돌하므로 곧바로 {{DEVELOP_BRANCH}}에도 병합해 둔다.
-        # 실패(충돌·브랜치 보호)해도 안전망 릴리스는 이미 끝났으므로 경고만 남긴다.
+        # The safety-net bump lands only on {{MAIN_BRANCH}}. If {{DEVELOP_BRANCH}} does not know
+        # about it, both sides edit the same version line and conflict in the next release
+        # PR, so merge it into {{DEVELOP_BRANCH}} right away.
+        # On failure (conflict, branch protection) the safety-net release is already done,
+        # so only a warning is left.
         if: steps.release_guard.outputs.skip != 'true' && steps.commit_push.outputs.pushed == 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           DEVELOP_BRANCH="{{DEVELOP_BRANCH}}"
           NEW_VERSION="${{ steps.version.outputs.new_version }}"
           MANUAL="git checkout $DEVELOP_BRANCH && git pull && git merge origin/{{MAIN_BRANCH}} && git push"
@@ -266,7 +273,7 @@ jobs:
             fi
             if ! git merge --no-edit -m "chore(version): merge v${NEW_VERSION} safety-net bump into ${DEVELOP_BRANCH} [skip ci]" "origin/{{MAIN_BRANCH}}"; then
               git merge --abort 2>/dev/null || true
-              echo "::warning::{{MAIN_BRANCH}}을 ${DEVELOP_BRANCH}에 자동 병합하지 못했습니다 (충돌). 다음 릴리스 PR 전에 직접 병합하세요: $MANUAL"
+              echo "::warning::$(m wf_version.backmerge_conflict prod="{{MAIN_BRANCH}}" dev="$DEVELOP_BRANCH" manual="$MANUAL")"
               exit 0
             fi
             if git push origin "HEAD:$DEVELOP_BRANCH"; then
@@ -276,7 +283,7 @@ jobs:
             echo "push attempt $ATTEMPT failed — retrying"
             sleep 5
           done
-          echo "::warning::${DEVELOP_BRANCH}에 push하지 못했습니다 (브랜치 보호 등). 다음 릴리스 PR 전에 직접 병합하세요: $MANUAL"
+          echo "::warning::$(m wf_version.backmerge_push_failed dev="$DEVELOP_BRANCH" manual="$MANUAL")"
 
       - name: Summary
         if: always()