project-auto-wizard 0.14.0 → 0.15.0

package/payload/scripts/version_manager.py

@@ -117,7 +117,7 @@ def _version_yml_path():
 
 def require_version_yml():
     if not _version_yml_path().is_file():
-        log("ERROR: version.yml not found")
+        log(t("version_manager.err_yml_missing"))
         sys.exit(1)
 
 
@@ -238,7 +238,7 @@ def get_version_code():
     require_version_yml()
     code = read_scalar_key("version_code", None)
     if code is None or code == "" or code == "null":
-        log("WARNING: version_code field missing, adding default value 1")
+        log(t("version_manager.warn_code_missing"))
         text = read_text()
         if re.search(r'^version:', text, re.MULTILINE):
             new_text = re.sub(
@@ -260,7 +260,7 @@ def set_version_code(new_code):
     if current not in (None, "", "null"):
         try:
             if int(new_code) < int(current):
-                log(f"WARNING: version_code {new_code} is lower than current {current} — writing anyway (regression?)")
+                log(t("version_manager.warn_code_regress", new_code=new_code, current=current))
         except ValueError:
             pass
     text = read_text()
@@ -318,7 +318,7 @@ def get_higher_version(v1, v2):
 def update_version_yml(new_version):
     if not write_scalar_key("version", new_version):
         # Without the key nothing was written yet the call looked successful, so the same version came out every time.
-        log("WARNING: version field missing in version.yml, adding it")
+        log(t("version_manager.warn_version_missing"))
         text = read_text()
         line = f'version: "{new_version}"\n'
         if re.search(r'^version_code:', text, re.MULTILINE):
@@ -327,7 +327,7 @@ def update_version_yml(new_version):
             new_text = text.rstrip("\n") + "\n" + line
         write_text(new_text)
     if read_scalar_key("version") != new_version:
-        raise VersionSyncError(f"failed to write version {new_version} to version.yml")
+        raise VersionSyncError(t("version_manager.err_write_failed", version=new_version))
     today = datetime.date.today().isoformat()
     user = os.environ.get("GITHUB_ACTOR", "")
     if not user:
@@ -411,16 +411,16 @@ def sync_maven(path_dir, new_version):
     text = read_file(root_pom)
     old_version = _pom_text(text, ["version"])
     if old_version is None:
-        log(f"WARNING: spring: {root_pom} has no project <version> (inherited from parent?) — skipping")
+        log(t("version_manager.warn_spring_no_version", pom=root_pom))
         return True
     if "${" in old_version:
         # CI-friendly versions such as ${revision} are managed in a property, so leave them alone.
-        log(f"WARNING: spring: {root_pom} <version> is a property ({old_version}) — skipping")
+        log(t("version_manager.warn_spring_property", pom=root_pom, version=old_version))
         return True
     new_full = _keep_snapshot(old_version, new_version)
     new_text, _ = _pom_replace(text, ["version"], new_full)
     write_file(root_pom, new_text)
-    log(f"updated: {root_pom}")
+    log(t("version_manager.updated", path=root_pom))
 
     root_artifact = _pom_text(text, ["artifactId"])
     for child in sorted(Path(path_dir).glob("*/pom.xml")):
@@ -433,7 +433,7 @@ def sync_maven(path_dir, new_version):
         if _pom_text(ctext, ["version"]) == old_version:
             ctext, _ = _pom_replace(ctext, ["version"], new_full)
         write_file(child, ctext)
-        log(f"updated: {child}")
+        log(t("version_manager.updated", path=child))
     return True
 
 
@@ -509,7 +509,7 @@ def sync_spring(path_dir, new_version):
     has_pom = sync_maven(path_dir, new_version)
     if not candidates:
         if not has_pom:
-            log(f"WARNING: spring: no build.gradle(.kts) or pom.xml found under {path_dir} — skipping")
+            log(t("version_manager.warn_spring_no_files", dir=path_dir))
         return
     for gradle_file in candidates:
         text = read_file(gradle_file)
@@ -522,10 +522,10 @@ def sync_spring(path_dir, new_version):
             replaced = f"{m.group(1)}{m.group(2)}{_keep_snapshot(m.group(3), new_version)}{m.group(2)}"
             new_text = new_text[:m.start()] + replaced + new_text[m.end():]
         if not matches:
-            log(f"WARNING: spring: no `version = '...'` line in {gradle_file} — skipping")
+            log(t("version_manager.warn_spring_no_gradle_line", file=gradle_file))
             continue
         write_file(gradle_file, new_text)
-        log(f"updated: {gradle_file}")
+        log(t("version_manager.updated", path=gradle_file))
 
 
 def _pubspec_build_number(path_dir):
@@ -548,7 +548,7 @@ def get_reconciled_version_code():
         if n is not None
     ]
     if pubspec_codes and max(pubspec_codes) > code:
-        log(f"pubspec.yaml build number {max(pubspec_codes)} is ahead of version_code {code} — adopting it")
+        log(t("version_manager.pubspec_ahead", build=max(pubspec_codes), code=code))
         code = max(pubspec_codes)
         set_version_code(code)
     return code
@@ -557,7 +557,7 @@ def get_reconciled_version_code():
 def sync_flutter(path_dir, new_version, version_code):
     target = Path(path_dir) / "pubspec.yaml"
     if not target.is_file():
-        log(f"WARNING: flutter: {target} not found — skipping")
+        log(t("version_manager.warn_flutter_missing", target=target))
         return
     text = read_file(target)
     full_version = f"{new_version}+{version_code}"
@@ -567,7 +567,7 @@ def sync_flutter(path_dir, new_version, version_code):
     else:
         new_text = text.rstrip("\n") + f"\nversion: {full_version}\n"
     write_file(target, new_text)
-    log(f"updated: {target}")
+    log(t("version_manager.updated", path=target))
 
 
 def _json_indent(text):
@@ -582,20 +582,20 @@ def _json_indent(text):
 
 def sync_json_version(target, new_version, key_path):
     if not target.is_file():
-        log(f"WARNING: {target} not found — skipping")
+        log(t("version_manager.warn_target_missing", target=target))
         return
     raw = read_file(target)
     try:
         data = json.loads(raw)
     except json.JSONDecodeError as e:
         # Skipping and reporting success would silently leave the tag/version.yml and the package version out of step.
-        raise VersionSyncError(f"{target} is not valid JSON ({e}) — cannot write version")
+        raise VersionSyncError(t("version_manager.err_not_json", target=target, error=e))
     node = data
     for k in key_path[:-1]:
         node = node.setdefault(k, {})
     node[key_path[-1]] = new_version
     write_file(target, json.dumps(data, indent=_json_indent(raw), ensure_ascii=False) + "\n")
-    log(f"updated: {target}")
+    log(t("version_manager.updated", path=target))
 
 
 _TOML_HEADER_RE = re.compile(r'^[ \t]*\[+[ \t]*([^\]\n]+?)[ \t]*\]+[ \t]*(?:#.*)?$', re.MULTILINE)
@@ -641,12 +641,12 @@ def sync_python(path_dir, new_version):
     spans = _python_version_spans(path_dir)
     if not spans:
         # Setups that keep the version out of the file (e.g. dynamic = ["version"]) have nowhere to write it.
-        log(f"WARNING: python: no version in pyproject.toml [project]/[tool.poetry] or setup.py under {path_dir} — skipping")
+        log(t("version_manager.warn_python_no_version", dir=path_dir))
         return
     for target, (start, end) in spans:
         text = read_file(target)
         write_file(target, text[:start] + new_version + text[end:])
-        log(f"updated: {target}")
+        log(t("version_manager.updated", path=target))
 
 
 _PLIST_VERSION_RE = re.compile(r'(<key>CFBundleShortVersionString</key>\s*<string>)([^<]*)(</string>)')
@@ -673,33 +673,33 @@ def sync_react_native(path_dir, new_version):
                 continue
             # A build-variable reference such as $(MARKETING_VERSION) is owned by the Xcode settings, so do not overwrite it.
             if m.group(2).strip().startswith("$("):
-                log(f"skipped: {plist_file} — CFBundleShortVersionString references a build variable")
+                log(t("version_manager.skipped_plist", file=plist_file))
                 continue
             new_text = _PLIST_VERSION_RE.sub(lambda mm: mm.group(1) + new_version + mm.group(3), text)
             write_file(plist_file, new_text)
-            log(f"updated: {plist_file}")
+            log(t("version_manager.updated", path=plist_file))
             found_plist = True
     else:
-        log(f"WARNING: react-native: {ios_dir} not found — skipping")
+        log(t("version_manager.warn_rn_ios_missing", dir=ios_dir))
 
     gradle_file = Path(path_dir) / "android" / "app" / "build.gradle"
     if gradle_file.is_file():
         text = read_file(gradle_file)
         new_text = re.sub(r'versionName\s+"[^"]*"', f'versionName "{new_version}"', text)
         write_file(gradle_file, new_text)
-        log(f"updated: {gradle_file}")
+        log(t("version_manager.updated", path=gradle_file))
     else:
-        log(f"WARNING: react-native: {gradle_file} not found — skipping")
+        log(t("version_manager.warn_rn_gradle_missing", file=gradle_file))
 
     if not found_plist and not gradle_file.is_file():
-        log(f"WARNING: react-native: no target files found under {path_dir}")
+        log(t("version_manager.warn_rn_no_targets", dir=path_dir))
 
 
 def sync_for_type(project_type, new_version, version_code_getter):
     path_dir = get_type_path(project_type)
     handler = TYPE_HANDLERS.get(project_type)
     if handler is None:
-        log(f"WARNING: unknown project type: {project_type} — skipping")
+        log(t("version_manager.warn_unknown_type", type=project_type))
         return
     handler.sync(path_dir, new_version, version_code_getter)
 
@@ -709,17 +709,17 @@ def sync_all_project_files(new_version):
     if not types:
         # No silent fallback: an unreadable project_types used to degrade to
         # "basic" and skip every sync without a word.
-        raise SystemExit("ERROR: version.yml has no readable project_types — cannot sync project files")
+        raise SystemExit(t("version_manager.err_no_types_sync"))
     errors = []
-    for t in types:
+    for ptype in types:
         # Keep syncing the other types when one fails; collect failures and report them via the exit code at the end.
         try:
-            sync_for_type(t, new_version, get_reconciled_version_code)
+            sync_for_type(ptype, new_version, get_reconciled_version_code)
         except VersionSyncError as e:
-            log(f"ERROR: {t}: {e}")
-            errors.append(t)
+            log(t("version_manager.err_type", type=ptype, error=e))
+            errors.append(ptype)
     if errors:
-        raise VersionSyncError(f"project file sync failed for: {', '.join(errors)}")
+        raise VersionSyncError(t("version_manager.err_sync_failed", types=", ".join(errors)))
 
 
 README_VERSION_LINE_RE = re.compile(
@@ -749,7 +749,7 @@ def update_readme_version(new_version, path="README.md"):
             return False
         lines[i + 1] = new_line
         write_file(p, "\n".join(lines))
-        log(f"README.md version line -> v{new_version}")
+        log(t("version_manager.readme_updated", version=new_version))
         return True
     return False
 
@@ -880,7 +880,7 @@ def get_project_file_version(project_type):
         if handler is not None:
             version = handler.read(path_dir)
     except Exception as e:
-        log(f"WARNING: failed reading project file for {project_type}: {e}")
+        log(t("version_manager.warn_read_failed", type=project_type, error=e))
         version = None
 
     if not version:
@@ -892,32 +892,32 @@ def sync_versions():
     yml_version = get_current_version()
     types = get_project_types_csv()
     if not types:
-        raise SystemExit("ERROR: version.yml has no readable project_types — cannot sync versions")
+        raise SystemExit(t("version_manager.err_no_types_check"))
     primary_type = types[0]
     project_version = get_project_file_version(primary_type)
 
-    log("Version sync check")
-    log(f"  version.yml: {yml_version}")
-    log(f"  project file: {project_version}")
+    log(t("version_manager.sync_check"))
+    log(t("version_manager.sync_yml_version", version=yml_version))
+    log(t("version_manager.sync_project_version", version=project_version))
 
     if yml_version != project_version:
         if validate_version(yml_version) and validate_version(project_version):
             higher = get_higher_version(yml_version, project_version)
-            log(f"Version mismatch detected, syncing to higher version: {higher}")
+            log(t("version_manager.sync_mismatch", version=higher))
             if higher != yml_version:
                 update_version_yml(higher)
             if higher != project_version:
                 sync_all_project_files(higher)
             return higher
         else:
-            log("WARNING: version format invalid, cannot sync")
+            log(t("version_manager.warn_format_invalid"))
             return yml_version
     else:
         types = get_project_types_csv()
         if types:
-            log(f"Multi-type — reconciling all type files to version.yml version: {yml_version}")
+            log(t("version_manager.sync_multi", version=yml_version))
             sync_all_project_files(yml_version)
-        log(f"Version already in sync: {yml_version}")
+        log(t("version_manager.sync_ok", version=yml_version))
         return yml_version
 
 
@@ -952,7 +952,7 @@ def cmd_increment(args):
     require_version_yml()
     current_version = sync_versions()
     if not validate_version(current_version):
-        log(f"ERROR: invalid version format: {current_version}")
+        log(t("version_manager.err_invalid_version", version=current_version))
         return 1
     bump = getattr(args, "bump", None) or "patch"
     new_version = increment_version(current_version, bump)
@@ -968,7 +968,7 @@ def cmd_set(args):
     require_version_yml()
     new_version = args.version
     if not validate_version(new_version):
-        log(f"ERROR: invalid version format: {new_version} (must be x.y.z)")
+        log(t("version_manager.err_invalid_version_xyz", version=new_version))
         return 1
     update_all_versions(new_version)
     print(new_version)
@@ -1017,7 +1017,7 @@ def main(argv=None):
     try:
         return handler(args)
     except VersionSyncError as e:
-        log(f"ERROR: {e}")
+        log(t("version_manager.err_generic", error=e))
         return 1
 
 

package/payload/workflows/common/PROJECT-COMMON-AI-PR-SUMMARY.yaml

@@ -53,11 +53,12 @@ jobs:
       - name: Read copilot_ai option from version.yml
         id: copilot_options
         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: steps.copilot_options.outputs.copilot_ai == 'true'
@@ -74,6 +75,7 @@ jobs:
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
           GH_TOKEN: ${{ github.token }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           PR_NUMBER=${{ github.event.pull_request.number }}
 
           git fetch origin {{MAIN_BRANCH}}
@@ -105,7 +107,7 @@ jobs:
           fi
           VERSION=$(python3 -c 'import sys; sys.path.insert(0, ".github/scripts"); from version_manager import increment_version; print(increment_version(sys.argv[1], sys.argv[2]))' "$CURRENT_VERSION" "${BUMP:-patch}" 2>/dev/null || echo "")
           VERSION=${VERSION:-Unreleased}
-          echo "expected next version: $VERSION (current: ${CURRENT_VERSION:-none}, mode: $MODE, bump: ${BUMP:-patch})"
+          echo "$(m wf_aisum.expected_version version="$VERSION" current_version="${CURRENT_VERSION:-none}" mode="$MODE" bump="${BUMP:-patch}")"
 
           SUMMARY_RESULT=$(python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
@@ -136,10 +138,10 @@ jobs:
             --jq ".[] | select(.user.login == \"github-actions[bot]\" and (.body | startswith(\"$MARKER\"))) | .id" 2>/dev/null | tail -n 1 || true)
           if [ -n "$COMMENT_ID" ]; then
             gh api -X PATCH "repos/${{ github.repository }}/issues/comments/${COMMENT_ID}" --input comment_payload.json > /dev/null \
-              || echo "comment update failed — continuing (this workflow never blocks the PR)"
+              || echo "$(m wf_aisum.comment_update_failed)"
           else
             gh api -X POST "repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" --input comment_payload.json > /dev/null \
-              || echo "comment post failed — continuing (this workflow never blocks the PR)"
+              || echo "$(m wf_aisum.comment_post_failed)"
           fi
 
       - name: Link related issue via branch name

package/payload/workflows/common/PROJECT-COMMON-AUTO-CHANGELOG-CONTROL.yaml

@@ -85,16 +85,27 @@ jobs:
       github.event.pull_request.head.ref == '{{DEVELOP_BRANCH}}'
     runs-on: ubuntu-latest
     permissions:
+      contents: read
       pull-requests: read
     outputs:
       open: ${{ steps.state.outputs.open }}
     steps:
+      # Only the message catalog and language setting are needed for the log wording
+      - name: Checkout message catalog
+        uses: actions/checkout@v7
+        with:
+          sparse-checkout: |
+            .github/scripts/messages.py
+            version.yml
+          sparse-checkout-cone-mode: false
+
       - name: Read the current PR state
         id: state
         env:
           GH_TOKEN: ${{ github.token }}
           GH_REPO: ${{ github.repository }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           PR_NUMBER=${{ github.event.pull_request.number }}
           # A push to {{DEVELOP_BRANCH}} mid-pipeline queues a run that later reprocesses the
           # already-merged PR - an empty summary comment, duplicate CHANGELOG entries and a
@@ -104,10 +115,10 @@ jobs:
           STATE=$(gh pr view "$PR_NUMBER" --json state -q .state 2>/dev/null || echo "UNKNOWN")
           if [ "$STATE" = "MERGED" ] || [ "$STATE" = "CLOSED" ]; then
             echo "open=false" >> "$GITHUB_OUTPUT"
-            echo "::notice::PR #$PR_NUMBER is already $STATE — skipping the release pipeline"
+            echo "::notice::$(m wf_changelog.pr_not_open pr_number="$PR_NUMBER" state="$STATE")"
           else
             echo "open=true" >> "$GITHUB_OUTPUT"
-            echo "PR #$PR_NUMBER state: $STATE"
+            echo "$(m wf_changelog.pr_state pr_number="$PR_NUMBER" state="$STATE")"
           fi
 
   changelog-and-merge:
@@ -131,18 +142,20 @@ jobs:
       - name: Read semver_auto option from version.yml
         id: semver_options
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           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
         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: steps.copilot_options.outputs.copilot_ai == 'true'
@@ -152,6 +165,7 @@ jobs:
       - name: Collect commits since last release
         id: collect
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           git fetch origin {{MAIN_BRANCH}}
           git log --pretty=%s "origin/{{MAIN_BRANCH}}..HEAD" > commits.txt
           # Body-footer BREAKING CHANGE: lines are appended after the subject list, one per
@@ -165,7 +179,7 @@ jobs:
             cp _full_diff_stat.txt diff_stat.txt
           fi
           rm -f _full_diff_stat.txt
-          echo "commits to summarize: $(wc -l < commits.txt)"
+          echo "$(m wf_changelog.commits_to_summarize n="$(wc -l < commits.txt)")"
 
       - name: Collect issues merged into {{DEVELOP_BRANCH}}
         continue-on-error: true
@@ -211,6 +225,7 @@ jobs:
           GITHUB_TOKEN: ${{ github.token }}
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           # Idempotency: never raise a version this PR already confirmed (not yet published).
           # Looking only at the HEAD commit message lets the guard slip when more commits
           # pile on top of the confirm commit (extra {{DEVELOP_BRANCH}} pushes, a
@@ -227,7 +242,7 @@ jobs:
           else
             BUMP="patch"
           fi
-          echo "bump level: $BUMP"
+          echo "$(m wf_common.bump_level bump="$BUMP")"
 
           if [ -n "$MAIN_VERSION" ] && [ -n "$HEAD_VERSION" ] && version_gt "$HEAD_VERSION" "$MAIN_VERSION" && ! is_tagged "$HEAD_VERSION"; then
             # Already-confirmed version - recompute from the {{MAIN_BRANCH}} version and raise it
@@ -237,22 +252,22 @@ jobs:
             TARGET=$(python3 -c 'import sys; sys.path.insert(0, ".github/scripts"); from version_manager import increment_version; print(increment_version(sys.argv[1], sys.argv[2]))' "$MAIN_VERSION" "$BUMP")
             if version_gt "$TARGET" "$HEAD_VERSION"; then
               NEW_VERSION=$(python3 .github/scripts/version_manager.py set "$TARGET" | tail -n 1)
-              echo "confirmed version raised: $HEAD_VERSION -> $NEW_VERSION ($BUMP from {{MAIN_BRANCH}} $MAIN_VERSION)"
+              echo "$(m wf_changelog.version_raised head_version="$HEAD_VERSION" new_version="$NEW_VERSION" bump="$BUMP" main_branch="{{MAIN_BRANCH}}" main_version="$MAIN_VERSION")"
             else
               NEW_VERSION="$HEAD_VERSION"
-              echo "version already confirmed and not yet released — reusing $NEW_VERSION ({{MAIN_BRANCH}} is $MAIN_VERSION)"
+              echo "$(m wf_changelog.version_reuse_unreleased new_version="$NEW_VERSION" main_branch="{{MAIN_BRANCH}}" main_version="$MAIN_VERSION")"
             fi
           elif [ -z "$MAIN_VERSION" ] && printf '%s\n' "$HEAD_MSG" | grep -q "^chore(version): confirm v.* \[skip ci\]"; then
             # Re-run of a first release where {{MAIN_BRANCH}} has no version.yml yet
             NEW_VERSION="$HEAD_VERSION"
-            echo "version already confirmed by a previous run — reusing $NEW_VERSION (no re-increment)"
+            echo "$(m wf_changelog.version_reuse_previous new_version="$NEW_VERSION")"
           else
             NEW_VERSION=$(python3 .github/scripts/version_manager.py increment --bump "$BUMP" | tail -n 1)
             python3 .github/scripts/version_manager.py sync
-            echo "release version confirmed: $NEW_VERSION ($BUMP)"
+            echo "$(m wf_changelog.version_confirmed new_version="$NEW_VERSION" bump="$BUMP")"
           fi
           if [ -z "$NEW_VERSION" ]; then
-            echo "version bump failed"
+            echo "$(m wf_common.version_bump_failed)"
             exit 1
           fi
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
@@ -269,6 +284,7 @@ jobs:
           GITHUB_TOKEN: ${{ github.token }}
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
 
           SUMMARY_RESULT=$(python3 .github/scripts/changelog_manager.py ai-summary \
@@ -281,7 +297,7 @@ jobs:
           # On fallback, append the reason (the script also emits it as ::warning::) to the engine line so the cause is visible without opening the job log
           FALLBACK_REASON=$(python3 -c 'import html,json,sys; print(html.escape((json.loads(sys.argv[1]).get("fallback_reason") or "")[:200]))' "$SUMMARY_RESULT" 2>/dev/null || echo "")
           ENGINE_LINE="$ENGINE${FALLBACK_REASON:+ ($FALLBACK_REASON)}"
-          echo "summary engine: $ENGINE_LINE"
+          echo "$(m wf_changelog.summary_engine engine_line="$ENGINE_LINE")"
           echo "engine: $ENGINE_LINE" >> "$GITHUB_STEP_SUMMARY"
           echo "engine=$ENGINE" >> $GITHUB_OUTPUT
           echo "fallback_reason=$FALLBACK_REASON" >> $GITHUB_OUTPUT
@@ -296,6 +312,7 @@ jobs:
           FALLBACK_REASON: ${{ steps.summary.outputs.fallback_reason }}
           GH_TOKEN: ${{ github.token }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           PR_NUMBER=${{ github.event.pull_request.number }}
           # Find this bot's earlier summary comment by its marker and replace it so re-runs and re-syncs do not pile up comments
           MARKER="<!-- project-auto-wizard:pr-summary -->"
@@ -315,12 +332,12 @@ jobs:
             --jq ".[] | select(.user.login == \"github-actions[bot]\" and (.body | startswith(\"$MARKER\"))) | .id" 2>/dev/null | tail -n 1 || true)
           if [ -n "$COMMENT_ID" ]; then
             gh api -X PATCH "repos/${{ github.repository }}/issues/comments/${COMMENT_ID}" --input comment_payload.json > /dev/null \
-              && echo "summary comment updated (#${COMMENT_ID})" \
-              || echo "comment update failed — continuing (this workflow never blocks the release)"
+              && echo "$(m wf_changelog.comment_updated comment_id="${COMMENT_ID}")" \
+              || echo "$(m wf_changelog.comment_update_failed)"
           else
             gh api -X POST "repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" --input comment_payload.json > /dev/null \
-              && echo "summary comment posted" \
-              || echo "comment post failed — continuing (this workflow never blocks the release)"
+              && echo "$(m wf_changelog.comment_posted)" \
+              || echo "$(m wf_changelog.comment_post_failed)"
           fi
 
           rm -f comment_body.md comment_payload.json
@@ -345,6 +362,7 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
           HEAD_BRANCH="${{ github.event.pull_request.head.ref }}"
           VERSION="${{ steps.bump.outputs.new_version }}"
 
@@ -356,7 +374,7 @@ jobs:
           # {{DEVELOP_BRANCH}} after the merge).
           PR_STATE=$(gh pr view "${{ github.event.pull_request.number }}" --json state -q .state 2>/dev/null || echo "UNKNOWN")
           if [ "$PR_STATE" = "MERGED" ] || [ "$PR_STATE" = "CLOSED" ]; then
-            echo "::notice::PR is already $PR_STATE — not pushing release docs"
+            echo "::notice::$(m wf_changelog.pr_closed_skip_docs pr_state="$PR_STATE")"
             exit 0
           fi
 
@@ -367,7 +385,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"
+            echo "$(m wf_common.no_changes)"
           else
             git commit -m "chore(version): confirm v${VERSION} and update release docs [skip ci]"
 
@@ -378,18 +396,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:$HEAD_BRANCH; then
                 PUSH_SUCCESS=true
-                echo "release docs pushed to $HEAD_BRANCH"
+                echo "$(m wf_changelog.docs_pushed head_branch="$HEAD_BRANCH")"
                 break
               else
-                echo "push failed, syncing with remote..."
+                echo "$(m wf_common.push_failed_syncing)"
                 if git pull --rebase origin $HEAD_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
@@ -397,7 +415,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
@@ -424,18 +442,18 @@ jobs:
           MAX_ATTEMPTS=4
           for ATTEMPT in $(seq 1 $MAX_ATTEMPTS); do
             if [ "$(gh pr view "$PR_NUMBER" --json state -q .state 2>/dev/null)" = "MERGED" ]; then
-              echo "PR #$PR_NUMBER is already merged"
+              echo "$(m wf_changelog.pr_already_merged pr_number="$PR_NUMBER")"
               MERGED=true
               break
             fi
             if gh pr merge "$PR_NUMBER" --auto --merge --subject "$SUBJECT" 2> "$ERR_FILE"; then
-              echo "automerge enabled: $SUBJECT"
+              echo "$(m wf_changelog.automerge_enabled subject="$SUBJECT")"
               MERGED=true
               break
             fi
             cat "$ERR_FILE" >&2
             if gh pr merge "$PR_NUMBER" --merge --subject "$SUBJECT" 2> "$ERR_FILE"; then
-              echo "automerge unavailable — merged directly: $SUBJECT"
+              echo "$(m wf_changelog.automerge_unavailable subject="$SUBJECT")"
               MERGED=true
               break
             fi
@@ -451,7 +469,7 @@ jobs:
                 && echo "head branch updated from base" || true
             fi
             WAIT=$((ATTEMPT * 10))
-            echo "merge attempt $ATTEMPT/$MAX_ATTEMPTS failed — retrying in ${WAIT}s"
+            echo "$(m wf_changelog.merge_retry attempt="$ATTEMPT" max_attempts="$MAX_ATTEMPTS" wait="${WAIT}")"
             sleep "$WAIT"
           done
 
@@ -465,7 +483,7 @@ jobs:
             elif [ "$ALLOW_MERGE_COMMIT" = "false" ]; then
               echo "::error::$(m wf_changelog.merge_commit_disabled)"
             else
-              echo "::error::PR merge failed after $MAX_ATTEMPTS attempts (allow_merge_commit=$ALLOW_MERGE_COMMIT) — check branch protection rules, required checks, and token permissions"
+              echo "::error::$(m wf_changelog.merge_gave_up max_attempts="$MAX_ATTEMPTS" allow_merge_commit="$ALLOW_MERGE_COMMIT")"
             fi
             exit 1
           fi