Adopt boilerplate terminology in service automation

Use canonical boilerplate report fields and generated copy while retaining legacy service-manifest compatibility.

Author: wodbot

.github/workflows/service-update-report.yml

@@ -13,8 +13,8 @@ on:
         required: false
         default: ""
         type: string
-      build_template_mode:
-        description: Include report-only build-template checks
+      build_boilerplate_mode:
+        description: Include report-only build-boilerplate checks
         required: false
         default: report
         type: choice
@@ -229,7 +229,7 @@ jobs:
             --readme README.md \
             --owner wodby \
             --repo-filter "^${SERVICE_REPO}$" \
-            --build-template-mode "${{ inputs.build_template_mode || 'report' }}" \
+            --build-boilerplate-mode "${{ inputs.build_boilerplate_mode || 'report' }}" \
             --output-dir "$REPORT_DIR"
 
       - name: Determine Apply Scope
@@ -321,10 +321,10 @@ jobs:
               print("- Status: update candidate")
           elif details and details.get("dry_run_diffs"):
               print("- Status: manual review dry-run candidate")
-          elif details and details.get("build_template_review_items"):
-              print("- Status: build-template review candidate")
-          elif details and details.get("build_template_warnings"):
-              print("- Status: build-template warning")
+          elif details and details.get("build_boilerplate_review_items"):
+              print("- Status: build-boilerplate review candidate")
+          elif details and details.get("build_boilerplate_warnings"):
+              print("- Status: build-boilerplate warning")
           elif details and details.get("notifications"):
               print("- Status: manual review notification")
           elif details and (
@@ -372,20 +372,20 @@ jobs:
                   print("")
 
           if details and (
-              details.get("build_template_review_items")
-              or details.get("build_template_warnings")
+              details.get("build_boilerplate_review_items")
+              or details.get("build_boilerplate_warnings")
           ):
-              print("### Build Template Review")
-              print("These checks are report only. The workflow does not apply build template changes.")
+              print("### Build Boilerplate Review")
+              print("These checks are report only. The workflow does not apply build boilerplate changes.")
               print("")
-              if details.get("build_template_review_items"):
+              if details.get("build_boilerplate_review_items"):
                   print("#### Review Items")
-                  for message in details["build_template_review_items"]:
+                  for message in details["build_boilerplate_review_items"]:
                       print(f"- {message}")
                   print("")
-              if details.get("build_template_warnings"):
+              if details.get("build_boilerplate_warnings"):
                   print("#### Warnings")
-                  for message in details["build_template_warnings"]:
+                  for message in details["build_boilerplate_warnings"]:
                       print(f"- {message}")
                   print("")
           apply_result = (details or {}).get("apply_result") or {}
@@ -462,8 +462,8 @@ jobs:
               and details.get("comparable")
               and not report["updates"]
               and not details["warnings"]
-              and not details.get("build_template_review_items")
-              and not details.get("build_template_warnings")
+              and not details.get("build_boilerplate_review_items")
+              and not details.get("build_boilerplate_warnings")
               and repo not in report["missing_service_yml"]
           ):
               print("No update candidates were found.")
@@ -534,7 +534,7 @@ jobs:
             --readme README.md \
             --owner wodby \
             --repo-filter "^${SERVICE_REPO}$" \
-            --build-template-mode "${{ inputs.build_template_mode || 'report' }}" \
+            --build-boilerplate-mode "${{ inputs.build_boilerplate_mode || 'report' }}" \
             --output-dir "$REPORT_DIR"
 
       - name: Determine Apply Scope
@@ -626,10 +626,10 @@ jobs:
               print("- Status: update candidate")
           elif details and details.get("dry_run_diffs"):
               print("- Status: manual review dry-run candidate")
-          elif details and details.get("build_template_review_items"):
-              print("- Status: build-template review candidate")
-          elif details and details.get("build_template_warnings"):
-              print("- Status: build-template warning")
+          elif details and details.get("build_boilerplate_review_items"):
+              print("- Status: build-boilerplate review candidate")
+          elif details and details.get("build_boilerplate_warnings"):
+              print("- Status: build-boilerplate warning")
           elif details and details.get("notifications"):
               print("- Status: manual review notification")
           elif details and (
@@ -677,20 +677,20 @@ jobs:
                   print("")
 
           if details and (
-              details.get("build_template_review_items")
-              or details.get("build_template_warnings")
+              details.get("build_boilerplate_review_items")
+              or details.get("build_boilerplate_warnings")
           ):
-              print("### Build Template Review")
-              print("These checks are report only. The workflow does not apply build template changes.")
+              print("### Build Boilerplate Review")
+              print("These checks are report only. The workflow does not apply build boilerplate changes.")
               print("")
-              if details.get("build_template_review_items"):
+              if details.get("build_boilerplate_review_items"):
                   print("#### Review Items")
-                  for message in details["build_template_review_items"]:
+                  for message in details["build_boilerplate_review_items"]:
                       print(f"- {message}")
                   print("")
-              if details.get("build_template_warnings"):
+              if details.get("build_boilerplate_warnings"):
                   print("#### Warnings")
-                  for message in details["build_template_warnings"]:
+                  for message in details["build_boilerplate_warnings"]:
                       print(f"- {message}")
                   print("")
           apply_result = (details or {}).get("apply_result") or {}
@@ -767,8 +767,8 @@ jobs:
               and details.get("comparable")
               and not report["updates"]
               and not details["warnings"]
-              and not details.get("build_template_review_items")
-              and not details.get("build_template_warnings")
+              and not details.get("build_boilerplate_review_items")
+              and not details.get("build_boilerplate_warnings")
               and repo not in report["missing_service_yml"]
           ):
               print("No update candidates were found.")

scripts/service_report_email.py

@@ -98,8 +98,8 @@ def event_counts(
         "release_blockers": sum(
             1 for item in items if (item.get("planned_release") or {}).get("status") == "blocked"
         ),
-        "build_template_review_items": sum(1 for item in items if item.get("build_template_review_items")),
-        "build_template_warnings": sum(1 for item in items if item.get("build_template_warnings")),
+        "build_boilerplate_review_items": sum(1 for item in items if item.get("build_boilerplate_review_items")),
+        "build_boilerplate_warnings": sum(1 for item in items if item.get("build_boilerplate_warnings")),
         "applied_updates": sum(
             1
             for item in items
@@ -211,22 +211,22 @@ def append_repo_dry_run_changes(lines: list[str], items: list[dict[str, Any]]) -
         lines.append("")
 
 
-def append_repo_build_template_review(lines: list[str], items: list[dict[str, Any]]) -> None:
+def append_repo_build_boilerplate_review(lines: list[str], items: list[dict[str, Any]]) -> None:
     selected = [
         (
             item,
-            item.get("build_template_review_items") or [],
-            item.get("build_template_warnings") or [],
+            item.get("build_boilerplate_review_items") or [],
+            item.get("build_boilerplate_warnings") or [],
         )
         for item in items
-        if item.get("build_template_review_items") or item.get("build_template_warnings")
+        if item.get("build_boilerplate_review_items") or item.get("build_boilerplate_warnings")
     ]
     if not selected:
         return
 
-    lines.append("Build Template Review")
+    lines.append("Build Boilerplate Review")
     lines.append("")
-    lines.append("These checks are report only. The workflow does not apply build template changes.")
+    lines.append("These checks are report only. The workflow does not apply build boilerplate changes.")
     lines.append("")
     for item, updates, warnings in selected:
         lines.append(f"{item['repo']}:")
@@ -306,7 +306,7 @@ def build_body(
 
     append_repo_planned_changes(lines, items)
     append_repo_dry_run_changes(lines, items)
-    append_repo_build_template_review(lines, items)
+    append_repo_build_boilerplate_review(lines, items)
     append_repo_apply_results(lines, items)
     append_repo_messages(lines, "Updates Without Local Manifest Diff", items, "updates_without_local_diff")
     append_grouped_notifications(lines, items)
@@ -536,24 +536,24 @@ def html_dry_run_changes(items: list[dict[str, Any]]) -> str:
     return "".join(blocks)
 
 
-def html_build_template_review(items: list[dict[str, Any]]) -> str:
+def html_build_boilerplate_review(items: list[dict[str, Any]]) -> str:
     selected = [
         (
             item,
-            item.get("build_template_review_items") or [],
-            item.get("build_template_warnings") or [],
+            item.get("build_boilerplate_review_items") or [],
+            item.get("build_boilerplate_warnings") or [],
         )
         for item in items
-        if item.get("build_template_review_items") or item.get("build_template_warnings")
+        if item.get("build_boilerplate_review_items") or item.get("build_boilerplate_warnings")
     ]
     if not selected:
         return ""
 
     blocks = [
         "<h2 style=\"margin:28px 0 12px 0;font-size:20px;color:#111827;\">"
-        "Build Template Review</h2>",
+        "Build Boilerplate Review</h2>",
         "<p style=\"margin:0 0 12px 0;color:#4b5563;\">"
-        "These checks are report only. The workflow does not apply build template changes.</p>",
+        "These checks are report only. The workflow does not apply build boilerplate changes.</p>",
     ]
     for item, updates, warnings in selected:
         blocks.append(
@@ -667,7 +667,7 @@ def build_html_body(
         )
     body.append(html_planned_changes(items))
     body.append(html_dry_run_changes(items))
-    body.append(html_build_template_review(items))
+    body.append(html_build_boilerplate_review(items))
     body.append(html_apply_results(items))
     body.append(html_repo_messages("Updates Without Local Manifest Diff", items, "updates_without_local_diff"))
     body.append(html_grouped_notifications(items))
@@ -683,7 +683,7 @@ def build_subject(counts: dict[str, int], workflow_result: str, sha: str) -> str
         f"[services] report {status}: "
         f"{counts['updates']} update repos, "
         f"{counts['dry_run_updates']} dry-run repos, "
-        f"{counts['build_template_review_items']} build-template repos, "
+        f"{counts['build_boilerplate_review_items']} build-boilerplate repos, "
         f"{counts['major_version_notifications']} major-version repos, "
         f"{counts['helm_major_version_notifications']} Helm-major repos ({short_sha})"
     )