project-auto-wizard 0.13.3 → 0.15.0

package/payload/workflows/common/PROJECT-COMMON-ISSUE-HELPER.yaml

@@ -1,15 +1,16 @@
 # project-auto-wizard:managed-workflow
 # PROJECT-COMMON-ISSUE-HELPER.yaml
-# 이슈 생성/제목 수정 시 브랜치명·커밋 메시지를 댓글로 안내
+# Suggest a branch name and commit message as a comment when an issue is created or retitled
 #
-# 이슈가 열리거나(opened) 제목이 수정되면(edited + 제목 변경),
-# 정규화된 브랜치명과 커밋 메시지를 이슈 댓글로 생성/갱신한다.
-# ISSUE_HELPER_CREATE_BRANCH=true로 바꾸면 브랜치도 함께 생성한다
-# (기본값은 false — 이슈를 열 때마다 브랜치가 자동 생성되는 것을
-# 막기 위해 옵트인으로 전환됨).
+# When an issue is opened, or its title is edited (edited + title changed),
+# the normalized branch name and commit message are posted (or updated) as an
+# issue comment.
+# Set ISSUE_HELPER_CREATE_BRANCH=true to also create the branch
+# (default is false - opt-in, so a branch is not created automatically
+# every time an issue is opened).
 #
-# 로직 본체는 .github/scripts/issue_helper.py (Chuseok22/github-issue-helper의
-# Python 재작성, 동일 작성자).
+# The logic lives in .github/scripts/issue_helper.py (a Python rewrite of
+# Chuseok22/github-issue-helper, same author).
 
 name: PROJECT-ISSUE-HELPER
 
@@ -17,30 +18,31 @@ on:
   issues:
     types: [opened, edited]
 
-# contents는 항상 write로 고정한다. ISSUE_HELPER_CREATE_BRANCH="true"일 때
-# git/refs API로 브랜치를 생성하려면 write가 필요한데, 이 값은 @wizard ask로
-# 설치 후에도 사용자가 직접 켤 수 있어(마법사 재실행 없이) 그 시점에 맞춰
-# permissions를 조건부로 올릴 방법이 없다.
+# contents is always fixed to write. Creating a branch through the git/refs API
+# when ISSUE_HELPER_CREATE_BRANCH="true" needs write, and users can switch that
+# value on themselves after install (via the wizard ask marker, without re-running the
+# wizard), so there is no way to raise permissions conditionally at that point.
 permissions:
   issues: write
   contents: write
 
 jobs:
   issue-helper:
-    name: 브랜치명 & 커밋 메시지 안내
+    name: Branch name & commit message guide
     if: github.event.action == 'opened' || (github.event.action == 'edited' && github.event.changes.title)
     runs-on: ubuntu-latest
     env:
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       ISSUE_HELPER_BRANCH_PREFIX: ""
       ISSUE_HELPER_MAX_BRANCH_LENGTH: "100"
-      ISSUE_HELPER_COMMIT_TEMPLATE: "${issueTitle} : feat : {변경 사항에 대한 설명} ${issueUrl}"
+      # Optional override of the commit message template (the default follows the workflow language):
+      # ISSUE_HELPER_COMMIT_TEMPLATE: "${issueTitle} : feat : {description of the change} ${issueUrl}"
       ISSUE_HELPER_CREATE_BRANCH: "false" # @wizard ask:false
       ISSUE_HELPER_BASE_BRANCH: "{{MAIN_BRANCH}}"
     steps:
       - name: Checkout repository
         uses: actions/checkout@v7
 
-      - name: 브랜치명 & 커밋 메시지 생성
+      - name: Generate branch name & commit message
         id: issue-helper
         run: python3 .github/scripts/issue_helper.py run

package/payload/workflows/common/PROJECT-COMMON-README-VERSION-UPDATE.yaml

@@ -12,13 +12,12 @@
 # 4. Commits and pushes the change ([skip ci])
 #
 # Supported version line formats (case-insensitive, flexible spacing):
-# - ## 최신 버전 : v1.0.0 (2025-08-15)
-# - ## 최신버전 : v1.0.0 (2025-08-15)
+# - ## <Korean "latest version", with or without a space> : v1.0.0 (2025-08-15)
 # - ## Current Version : v1.0.0 (2025-08-15)
 # - ## Recent Version : v1.0.0 (2025-08-15)
 # - ## Latest Version : v1.0.0
 # - ## Version : v1.0.0
-# - ## 버전 : v1.0.0
+# - ## <Korean "version"> : v1.0.0
 #
 # The marker comment <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
 # is added automatically above the version line.
@@ -51,7 +50,7 @@ name: README VERSION UPDATE
 env:
   # Whether to show the date next to the version (true/false)
   SHOW_DATE: true
-  # 스크립트 import가 .github/scripts/__pycache__를 만들어 봇 커밋에 섞이지 않게 한다
+  # Keep script imports from creating .github/scripts/__pycache__ so it never ends up in bot commits
   PYTHONDONTWRITEBYTECODE: "1"
 
 concurrency:
@@ -87,22 +86,24 @@ jobs:
       - name: Check README.md exists
         id: precheck
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           if [ -f README.md ]; then
             echo "readme_exists=true" >> $GITHUB_OUTPUT
           else
             echo "readme_exists=false" >> $GITHUB_OUTPUT
-            echo "README.md not found — nothing to update, skipping"
+            echo "$(m wf_readme.not_found)"
           fi
 
       - name: Read latest version via version_manager.py
         id: version_info
         if: steps.precheck.outputs.readme_exists == 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           LATEST_VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
           # Guard: an empty version must never reach the README rewrite —
           # it would commit a corrupted "v (date)" line.
           if [ -z "$LATEST_VERSION" ]; then
-            echo "failed to read the current version"
+            echo "$(m wf_readme.read_version_failed)"
             exit 1
           fi
           RELEASE_DATE=$(date '+%Y-%m-%d')
@@ -113,10 +114,16 @@ jobs:
       - name: Update version line in README.md
         if: steps.precheck.outputs.readme_exists == 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           LATEST_VERSION="${{ steps.version_info.outputs.latest_version }}"
           RELEASE_DATE="${{ steps.version_info.outputs.release_date }}"
           SHOW_DATE="${{ env.SHOW_DATE }}"
 
+          # Hangul in the Korean heading patterns below is written as UTF-8 byte escapes so
+          # this file stays ASCII-only; they match the same README headings byte for byte.
+          KO_LATEST=$'\354\265\234\354\213\240'   # Korean "latest"
+          KO_VERSION=$'\353\262\204\354\240\204'  # Korean "version"
+
           # Error message helper
           print_error_message() {
             local error_type="$1"
@@ -125,38 +132,38 @@ jobs:
             local version_text="$4"
 
             echo ""
-            echo "README.md version update failed"
-            echo "  error type: $error_type"
-            echo "  current version line: $version_line"
-            echo "  extracted header: $header_part"
-            echo "  new version text: $version_text"
+            echo "$(m wf_readme.update_failed)"
+            echo "$(m wf_readme.err_type error_type="$error_type")"
+            echo "$(m wf_readme.err_current_line version_line="$version_line")"
+            echo "$(m wf_readme.err_header header_part="$header_part")"
+            echo "$(m wf_readme.err_new_text version_text="$version_text")"
             echo ""
-            echo "Make sure the README version line matches one of:"
-            echo "  ## 최신 버전 : v1.0.0 (2025-08-15)"
+            echo "$(m wf_readme.hint_formats)"
+            echo "  $(m wf_readme.hint_first_example)"
             echo "  ## Current Version : v1.0.0"
             echo "  ## Version : v1.0.0"
-            echo "Notes:"
-            echo "  - no markdown bold (**) characters"
-            echo "  - no regex special characters (*, [, ], ^, $)"
-            echo "  - the version must come right after the colon (:)"
+            echo "$(m wf_readme.hint_notes)"
+            echo "$(m wf_readme.hint_no_bold)"
+            echo "$(m wf_readme.hint_no_regex)"
+            echo "$(m wf_readme.hint_after_colon)"
           }
 
           if [ "$SHOW_DATE" = "true" ]; then
             VERSION_TEXT="v${LATEST_VERSION} (${RELEASE_DATE})"
-            echo "version text with date: $VERSION_TEXT"
+            echo "$(m wf_readme.text_with_date version_text="$VERSION_TEXT")"
           else
             VERSION_TEXT="v${LATEST_VERSION}"
-            echo "version text: $VERSION_TEXT"
+            echo "$(m wf_readme.text version_text="$VERSION_TEXT")"
           fi
 
           # Patterns for recognized version lines (case-insensitive, flexible spacing)
           VERSION_PATTERNS=(
-            "^##[[:space:]]*최신[[:space:]]*버전[[:space:]]*:"
-            "^##[[:space:]]*최신버전[[:space:]]*:"
+            "^##[[:space:]]*${KO_LATEST}[[:space:]]*${KO_VERSION}[[:space:]]*:"
+            "^##[[:space:]]*${KO_LATEST}${KO_VERSION}[[:space:]]*:"
             "^##[[:space:]]*[Cc]urrent[[:space:]]*[Vv]ersion[[:space:]]*:"
             "^##[[:space:]]*[Rr]ecent[[:space:]]*[Vv]ersion[[:space:]]*:"
             "^##[[:space:]]*[Vv]ersion[[:space:]]*:"
-            "^##[[:space:]]*버전[[:space:]]*:"
+            "^##[[:space:]]*${KO_VERSION}[[:space:]]*:"
             "^##[[:space:]]*[Ll]atest[[:space:]]*[Vv]ersion[[:space:]]*:"
           )
 
@@ -167,32 +174,34 @@ jobs:
             if grep -qi "$pattern" README.md; then
               VERSION_LINE=$(grep -i "$pattern" README.md | head -n 1)
               PATTERN_FOUND="$pattern"
-              echo "version line found: $VERSION_LINE"
+              echo "$(m wf_readme.line_found version_line="$VERSION_LINE")"
               break
             fi
           done
 
           # No version line yet — insert a default one
           if [ -z "$VERSION_LINE" ]; then
-            echo "no version line found — inserting a new one"
+            echo "$(m wf_readme.line_inserting)"
+            # Heading wording follows the configured language; an existing line keeps its own wording
+            DEFAULT_HEADING=$(m wf_readme.default_heading)
 
             if grep -q "^# " README.md; then
               # right after the first title
-              sed -i '/^# /a\\n<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## Latest Version : '"$VERSION_TEXT" README.md
+              sed -i '/^# /a\\n<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## '"$DEFAULT_HEADING"' : '"$VERSION_TEXT" README.md
             else
               # at the very top of the file
-              sed -i '1i\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## Latest Version : '"$VERSION_TEXT"'\n' README.md
+              sed -i '1i\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## '"$DEFAULT_HEADING"' : '"$VERSION_TEXT"'\n' README.md
             fi
-            echo "default version line inserted: $VERSION_TEXT"
+            echo "$(m wf_readme.line_inserted version_text="$VERSION_TEXT")"
           else
             # Update the existing version line
 
             # Validate the line format
             if [[ "$VERSION_LINE" =~ \*\* ]]; then
               echo ""
-              echo "warning: the version line contains markdown bold (**) characters"
-              echo "  current line: $VERSION_LINE"
-              echo "  this may break the version update"
+              echo "$(m wf_readme.warn_bold)"
+              echo "$(m wf_readme.warn_current_line version_line="$VERSION_LINE")"
+              echo "$(m wf_readme.warn_may_break)"
               echo ""
             fi
 
@@ -204,12 +213,12 @@ jobs:
               PREV_LINE=$(sed -n "${PREV_LINE_NUMBER}p" README.md)
               if [[ "$PREV_LINE" != *"AUTO-VERSION-SECTION"* ]]; then
                 sed -i "${PREV_LINE_NUMBER}a\\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->" README.md
-                echo "auto-update marker comment added"
+                echo "$(m wf_readme.marker_added)"
                 LINE_NUMBER=$((LINE_NUMBER + 1))
               fi
             else
               sed -i '1i\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->' README.md
-              echo "auto-update marker comment added"
+              echo "$(m wf_readme.marker_added)"
               LINE_NUMBER=$((LINE_NUMBER + 1))
             fi
 
@@ -217,7 +226,7 @@ jobs:
             HEADER_PART=$(printf '%s\n' "$VERSION_LINE" | sed 's/\(.*:\).*/\1 /')
 
             if [ -z "$HEADER_PART" ] || [[ "$HEADER_PART" == "$VERSION_LINE" ]]; then
-              print_error_message "header extraction failed - no colon (:) found" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
+              print_error_message "$(m wf_readme.err_no_colon)" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
               exit 1
             fi
 
@@ -230,29 +239,30 @@ jobs:
             ESCAPED_LINE=$(printf '%s' "$NEW_LINE" | sed 's/[&\\|]/\\&/g')
 
             if ! sed -i "${LINE_NUMBER}s|.*|${ESCAPED_LINE}|" README.md 2>/tmp/sed_error.log; then
-              SED_ERROR=$(cat /tmp/sed_error.log 2>/dev/null || echo "unknown sed error")
-              print_error_message "sed command failed - $SED_ERROR" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
+              SED_ERROR=$(cat /tmp/sed_error.log 2>/dev/null || m wf_readme.err_sed_unknown)
+              print_error_message "$(m wf_readme.err_sed error="$SED_ERROR")" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
               exit 1
             fi
 
             # Verify the replacement
             UPDATED_LINE=$(sed -n "${LINE_NUMBER}p" README.md)
             if [[ "$UPDATED_LINE" != *"$VERSION_TEXT"* ]]; then
-              print_error_message "version replacement verification failed" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
-              echo "  updated line: $UPDATED_LINE"
+              print_error_message "$(m wf_readme.err_verify)" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
+              echo "$(m wf_readme.updated_line_detail updated_line="$UPDATED_LINE")"
               exit 1
             fi
 
-            echo "version line updated: $VERSION_TEXT"
+            echo "$(m wf_readme.line_updated version_text="$VERSION_TEXT")"
           fi
 
       - name: Commit and push changes
         if: steps.precheck.outputs.readme_exists == 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           git add README.md
 
           if git diff --staged --quiet; then
-            echo "no changes in README.md"
+            echo "$(m wf_readme.no_changes)"
           else
             VERSION="${{ steps.version_info.outputs.latest_version }}"
 
@@ -265,19 +275,19 @@ jobs:
 
             while [ $RETRY_COUNT -lt $MAX_RETRIES ]; do
               RETRY_COUNT=$((RETRY_COUNT + 1))
-              echo "push attempt $RETRY_COUNT/$MAX_RETRIES..."
+              echo "$(m wf_common.push_attempt retry_count="$RETRY_COUNT" max_retries="$MAX_RETRIES")"
 
               if git push origin HEAD:{{MAIN_BRANCH}}; then
                 PUSH_SUCCESS=true
-                echo "README.md version update pushed"
+                echo "$(m wf_readme.pushed)"
                 break
               else
-                echo "push failed, syncing with remote..."
+                echo "$(m wf_common.push_failed_syncing)"
 
                 if git pull --rebase origin {{MAIN_BRANCH}}; then
-                  echo "rebase ok, retrying push..."
+                  echo "$(m wf_common.rebase_ok)"
                 else
-                  echo "rebase failed, manual conflict resolution required"
+                  echo "$(m wf_common.rebase_failed)"
                   git rebase --abort 2>/dev/null || true
                   exit 1
                 fi
@@ -285,7 +295,7 @@ jobs:
             done
 
             if [ "$PUSH_SUCCESS" = false ]; then
-              echo "push failed after $MAX_RETRIES attempts"
+              echo "$(m wf_common.push_gave_up max_retries="$MAX_RETRIES")"
               exit 1
             fi
           fi