project-auto-wizard 0.14.0 → 0.15.0

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

@@ -86,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')
@@ -130,28 +132,28 @@ 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 "$(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)
@@ -172,14 +174,14 @@ 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)
 
@@ -190,16 +192,16 @@ jobs:
               # at the very top of the file
               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
 
@@ -211,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
 
@@ -224,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
 
@@ -237,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 }}"
 
@@ -272,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
@@ -292,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

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

@@ -94,11 +94,12 @@ jobs:
       - name: Detect branch mode
         id: mode
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           # scoped to the metadata: -> template: -> branches: chain so an
           # unrelated top-level "mode:" key can never hijack the value
           MODE=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?branches:.*?mode:\s*\"?([A-Za-z-]+)", t, re.S); print(m.group(1) if m else "pr-flow")' 2>/dev/null || echo "pr-flow")
           echo "mode=$MODE" >> $GITHUB_OUTPUT
-          echo "branch mode: $MODE"
+          echo "$(m wf_release.branch_mode mode="$MODE")"
 
       - name: Release gate
         id: gate
@@ -123,11 +124,11 @@ jobs:
 
           echo "proceed=$PROCEED" >> $GITHUB_OUTPUT
           if [ "$PROCEED" = "true" ]; then
-            echo "release gate open (mode=$MODE, event=$EVENT)"
+            echo "$(m wf_release.gate_open mode="$MODE" event="$EVENT")"
             exit 0
           fi
 
-          echo "not a release-confirm push in pr-flow mode — skipping"
+          echo "$(m wf_release.gate_closed)"
 
           # Drift guard: skipping is normal, but a version.yml that
           # has run ahead of the newest tag is not — it means the version was
@@ -138,13 +139,13 @@ jobs:
           LATEST_VERSION="${LATEST_TAG#v}"
 
           if [ -z "$FILE_VERSION" ] || [ -z "$LATEST_VERSION" ]; then
-            echo "drift guard skipped (no version.yml version or no tag yet)"
+            echo "$(m wf_release.drift_skipped)"
             exit 0
           fi
 
           HIGHER=$(printf '%s\n%s\n' "$FILE_VERSION" "$LATEST_VERSION" | sort -V | tail -n 1)
           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 "::error::$(m wf_release.drift_error file_version="$FILE_VERSION" latest_tag="$LATEST_TAG")"
             {
               echo "$(m wf_release.drift_heading)"
               echo ""
@@ -157,7 +158,7 @@ jobs:
             exit 1
           fi
 
-          echo "drift guard ok (version.yml=$FILE_VERSION, latest tag=$LATEST_TAG)"
+          echo "$(m wf_release.drift_ok file_version="$FILE_VERSION" latest_tag="$LATEST_TAG")"
 
       - name: Read semver_auto option from version.yml
         id: semver_options
@@ -166,11 +167,12 @@ jobs:
           steps.mode.outputs.mode == 'trunk-based' &&
           github.event_name == 'push'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           # scoped to the metadata: -> template: -> options: chain so an
           # unrelated "semver_auto:" key can never hijack the value
           SEMVER_AUTO=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?semver_auto:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
           echo "semver_auto=$SEMVER_AUTO" >> $GITHUB_OUTPUT
-          echo "semver_auto option: $SEMVER_AUTO"
+          echo "$(m wf_common.semver_auto_option semver_auto="$SEMVER_AUTO")"
 
       - name: Read copilot_ai option from version.yml
         id: copilot_options
@@ -179,11 +181,12 @@ jobs:
           steps.mode.outputs.mode == 'trunk-based' &&
           github.event_name == 'push'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           # scoped to the metadata: -> template: -> options: chain so an
           # unrelated "copilot_ai:" key can never hijack the value
           COPILOT_AI=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?copilot_ai:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
           echo "copilot_ai=$COPILOT_AI" >> $GITHUB_OUTPUT
-          echo "copilot_ai option: $COPILOT_AI"
+          echo "$(m wf_common.copilot_ai_option copilot_ai="$COPILOT_AI")"
 
       - name: Install Copilot CLI
         if: >-
@@ -206,13 +209,14 @@ jobs:
           GITHUB_TOKEN: ${{ github.token }}
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           # Idempotency: on a re-run of a failed job the checked-out HEAD may
           # already be this workflow's own docs commit — never bump twice.
           # Jump straight to the common tail (tag + release for the current
           # version).
           HEAD_MSG=$(git log -1 --pretty=%s)
           if printf '%s\n' "$HEAD_MSG" | grep -q "^chore(version): release v.* docs \[skip ci\]"; then
-            echo "HEAD is already this workflow's release docs commit — skipping re-increment (idempotent re-run)"
+            echo "$(m wf_release.head_is_docs_commit)"
             exit 0
           fi
 
@@ -222,11 +226,11 @@ jobs:
           # release (no previous tag to diff against).
           LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
           if [ -n "$LAST_TAG" ]; then
-            echo "collecting commits since $LAST_TAG"
+            echo "$(m wf_release.collect_since last_tag="$LAST_TAG")"
             LOG_RANGE="${LAST_TAG}..HEAD"
             DIFF_BASE="$LAST_TAG"
           else
-            echo "no previous tag — collecting the full history"
+            echo "$(m wf_release.collect_all)"
             LOG_RANGE="HEAD"
             DIFF_BASE="4b825dc642cb6eb9a060e54bf8d69288fbee4904" # git empty tree hash
           fi
@@ -248,15 +252,15 @@ jobs:
           else
             BUMP="patch"
           fi
-          echo "bump level: $BUMP"
+          echo "$(m wf_common.bump_level bump="$BUMP")"
 
           NEW_VERSION=$(python3 .github/scripts/version_manager.py increment --bump "$BUMP" | tail -n 1)
           if [ -z "$NEW_VERSION" ]; then
-            echo "version bump failed"
+            echo "$(m wf_common.version_bump_failed)"
             exit 1
           fi
           python3 .github/scripts/version_manager.py sync
-          echo "release version: $NEW_VERSION ($BUMP)"
+          echo "$(m wf_release.release_version new_version="$NEW_VERSION" bump="$BUMP")"
 
           python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
@@ -289,7 +293,7 @@ jobs:
           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
-            echo "no changes to commit"
+            echo "$(m wf_common.no_changes)"
           else
             git commit -m "chore(version): release v${NEW_VERSION} docs [skip ci]"
 
@@ -300,18 +304,18 @@ 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 "release docs pushed"
+                echo "$(m wf_release.docs_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
@@ -319,7 +323,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
@@ -330,9 +334,10 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
           if [ -z "$VERSION" ]; then
-            echo "failed to read version"
+            echo "$(m wf_release.read_version_failed)"
             exit 1
           fi
           echo "version=$VERSION" >> $GITHUB_OUTPUT
@@ -344,32 +349,34 @@ jobs:
           # "release created" can be re-run and still publish the release.
           if git rev-parse "v$VERSION" >/dev/null 2>&1; then
             echo "tag_exists=true" >> $GITHUB_OUTPUT
-            echo "tag v$VERSION already exists — skipping tag push"
+            echo "$(m wf_release.tag_exists version="$VERSION")"
           else
             echo "tag_exists=false" >> $GITHUB_OUTPUT
           fi
 
           if gh release view "v$VERSION" >/dev/null 2>&1; then
             echo "release_exists=true" >> $GITHUB_OUTPUT
-            echo "release v$VERSION already exists — nothing to publish"
+            echo "$(m wf_release.release_exists version="$VERSION")"
           else
             echo "release_exists=false" >> $GITHUB_OUTPUT
-            echo "publishing release v$VERSION"
+            echo "$(m wf_release.publishing version="$VERSION")"
           fi
 
       - name: Create and push tag
         if: steps.gate.outputs.proceed == 'true' && steps.version.outputs.tag_exists != 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           VERSION="${{ steps.version.outputs.version }}"
           git tag "v$VERSION"
           git push origin "v$VERSION"
-          echo "tag v$VERSION pushed"
+          echo "$(m wf_release.tag_pushed version="$VERSION")"
 
       - name: Build release notes (changelog export + GitHub generate-notes)
         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 "$@"; }
           VERSION="${{ steps.version.outputs.version }}"
 
           # AI/changelog notes for this version
@@ -397,7 +404,7 @@ jobs:
             echo "Release v$VERSION" > notes.md
           fi
 
-          echo "release notes assembled ($(wc -c < notes.md) bytes)"
+          echo "$(m wf_release.notes_assembled n="$(wc -c < notes.md)")"
 
       - name: Create GitHub Release
         if: steps.gate.outputs.proceed == 'true' && steps.version.outputs.release_exists != 'true'
@@ -408,9 +415,10 @@ jobs:
           # default token.
           GH_TOKEN: ${{ secrets.WORKFLOW_PAT || github.token }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           VERSION="${{ steps.version.outputs.version }}"
           gh release create "v$VERSION" --title "v$VERSION" --notes-file notes.md
-          echo "GitHub Release v$VERSION published"
+          echo "$(m wf_release.published version="$VERSION")"
 
       - name: Trigger README-VERSION-UPDATE
         # Pushes made with the bot token (GITHUB_TOKEN) never wake the README update

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

@@ -66,20 +66,21 @@ jobs:
       - name: Release merge / mode guard
         id: release_guard
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           SKIP="false"
 
           # trunk-based mode: RELEASE-PUBLISH owns versioning — skip safety net
           MODE=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"^\s*mode:\s*\"?([A-Za-z-]+)", t, re.M); print(m.group(1) if m else "pr-flow")' 2>/dev/null || echo "pr-flow")
           if [ "$MODE" = "trunk-based" ]; then
             SKIP="true"
-            echo "trunk-based mode detected — RELEASE-PUBLISH owns version bumping, skipping"
+            echo "$(m wf_version.trunk_skip)"
           fi
 
           # release-confirm pattern: the merge commit of a release PR
           HEAD_MSG=$(git log -1 --pretty=%B)
           if echo "$HEAD_MSG" | grep -q "chore(release):"; then
             SKIP="true"
-            echo "release-confirm commit detected (chore(release):) — skipping safety-net bump"
+            echo "$(m wf_version.confirm_skip)"
           fi
 
           # release merge detection: the release push includes a version.yml change
@@ -91,51 +92,54 @@ jobs:
           fi
           if git diff --name-only $RANGE 2>/dev/null | grep -qx "version.yml"; then
             SKIP="true"
-            echo "release merge detected (push contains a version.yml change) — skipping safety-net bump"
+            echo "$(m wf_version.release_merge_skip)"
           fi
 
           echo "skip=$SKIP" >> $GITHUB_OUTPUT
           if [ "$SKIP" = "false" ]; then
-            echo "direct push to {{MAIN_BRANCH}} detected — running safety-net version bump"
+            echo "$(m wf_version.direct_push main_branch="{{MAIN_BRANCH}}")"
           fi
 
       - name: Read current version
         id: current_version
         if: steps.release_guard.outputs.skip != 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           CURRENT_VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
           if [ -z "$CURRENT_VERSION" ]; then
-            echo "failed to read current version"
+            echo "$(m wf_version.read_current_failed)"
             exit 1
           fi
           echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-          echo "current version: $CURRENT_VERSION"
+          echo "$(m wf_version.current_version current_version="$CURRENT_VERSION")"
 
       - name: Bump patch version and sync
         id: version
         if: steps.release_guard.outputs.skip != 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           NEW_VERSION=$(python3 .github/scripts/version_manager.py increment | tail -n 1)
           if [ -z "$NEW_VERSION" ]; then
-            echo "version bump failed"
+            echo "$(m wf_common.version_bump_failed)"
             exit 1
           fi
           python3 .github/scripts/version_manager.py sync
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
-          echo "new version: $NEW_VERSION"
+          echo "$(m wf_version.new_version new_version="$NEW_VERSION")"
 
       - name: Read project types
         id: project_info
         if: steps.release_guard.outputs.skip != 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           if [ -f "version.yml" ]; then
             PROJECT_TYPES=$(grep "^project_types:" version.yml 2>/dev/null | sed -E 's/.*\[([^]]*)\].*/\1/' | tr -d '" ')
             PROJECT_TYPES=${PROJECT_TYPES:-unknown}
             echo "project_types=$PROJECT_TYPES" >> $GITHUB_OUTPUT
-            echo "project types: $PROJECT_TYPES"
+            echo "$(m wf_version.project_types project_types="$PROJECT_TYPES")"
           else
             echo "project_types=unknown" >> $GITHUB_OUTPUT
-            echo "version.yml not found"
+            echo "$(m wf_version.yml_not_found)"
           fi
 
       - name: Update CHANGELOG for the safety-net release
@@ -150,6 +154,7 @@ jobs:
           AI_API_BASE_URL: ${{ vars.AI_API_BASE_URL }}
           AI_MODEL: ${{ vars.AI_MODEL }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           NEW_VERSION="${{ steps.version.outputs.new_version }}"
 
           # Commits pushed straight to {{MAIN_BRANCH}} since the last release tag (full history if there is no tag)
@@ -160,7 +165,7 @@ jobs:
           # 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)"
+          echo "$(m wf_version.commits_since last_tag="${LAST_TAG:-the beginning}" n="$(wc -l < commits.txt)")"
 
           python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
@@ -183,6 +188,7 @@ jobs:
         id: commit_push
         if: steps.release_guard.outputs.skip != 'true'
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           git config --local user.email "action@github.com"
           git config --local user.name "GitHub Action"
 
@@ -193,7 +199,7 @@ jobs:
           git ls-files -z --others --exclude-standard -- CHANGELOG.json CHANGELOG.md | xargs -0 -r git add --
 
           if git diff --staged --quiet; then
-            echo "no changes to commit (already in sync)"
+            echo "$(m wf_version.no_changes_synced)"
             echo "pushed=false" >> "$GITHUB_OUTPUT"
           else
             NEW_VERSION="${{ steps.version.outputs.new_version }}"
@@ -207,18 +213,18 @@ 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 "version bump commit pushed"
+                  echo "$(m wf_version.bump_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
@@ -226,12 +232,12 @@ 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
               echo "pushed=true" >> "$GITHUB_OUTPUT"
             else
-              echo "commit failed"
+              echo "$(m wf_version.commit_failed)"
               exit 1
             fi
           fi
@@ -260,7 +266,7 @@ jobs:
           MANUAL="git checkout $DEVELOP_BRANCH && git pull && git merge origin/{{MAIN_BRANCH}} && git push"
 
           if ! git ls-remote --exit-code --heads origin "$DEVELOP_BRANCH" >/dev/null 2>&1; then
-            echo "branch $DEVELOP_BRANCH not found — nothing to back-merge"
+            echo "$(m wf_version.no_develop develop_branch="$DEVELOP_BRANCH")"
             exit 0
           fi
 
@@ -268,7 +274,7 @@ jobs:
             git fetch -q origin "$DEVELOP_BRANCH" {{MAIN_BRANCH}}
             git checkout -q -B safety-net-back-merge "origin/$DEVELOP_BRANCH"
             if git merge-base --is-ancestor "origin/{{MAIN_BRANCH}}" HEAD; then
-              echo "$DEVELOP_BRANCH already contains {{MAIN_BRANCH}}"
+              echo "$(m wf_version.already_contains develop_branch="$DEVELOP_BRANCH" main_branch="{{MAIN_BRANCH}}")"
               exit 0
             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
@@ -277,10 +283,10 @@ jobs:
               exit 0
             fi
             if git push origin "HEAD:$DEVELOP_BRANCH"; then
-              echo "safety-net bump v$NEW_VERSION merged into $DEVELOP_BRANCH"
+              echo "$(m wf_version.backmerged new_version="$NEW_VERSION" develop_branch="$DEVELOP_BRANCH")"
               exit 0
             fi
-            echo "push attempt $ATTEMPT failed — retrying"
+            echo "$(m wf_version.push_retry attempt="$ATTEMPT")"
             sleep 5
           done
           echo "::warning::$(m wf_version.backmerge_push_failed dev="$DEVELOP_BRANCH" manual="$MANUAL")"
@@ -288,8 +294,9 @@ jobs:
       - name: Summary
         if: always()
         run: |
-          echo "version-control workflow finished"
-          echo "  skipped (release merge / trunk-based): ${{ steps.release_guard.outputs.skip }}"
-          echo "  previous version: ${{ steps.current_version.outputs.current_version }}"
-          echo "  new version: ${{ steps.version.outputs.new_version }}"
-          echo "  branch: ${{ github.ref_name }}"
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
+          echo "$(m wf_version.finished)"
+          echo "$(m wf_version.sum_skipped skip="${{ steps.release_guard.outputs.skip }}")"
+          echo "$(m wf_version.sum_previous current_version="${{ steps.current_version.outputs.current_version }}")"
+          echo "$(m wf_version.sum_new new_version="${{ steps.version.outputs.new_version }}")"
+          echo "$(m wf_version.sum_branch ref_name="${{ github.ref_name }}")"