CI: sync artifact version checks with source metadata

Author: dknauss

.github/scripts/validate-artifacts.py

@@ -59,6 +59,18 @@ def ensure_exists(path: Path, label: str) -> None:
     print(f"OK   [{label}] exists ({path.stat().st_size} bytes)")
 
 
+
+
+def read_markdown_version(path: Path) -> str:
+    text = path.read_text(encoding="utf-8")
+    match = re.search(r'(?m)^version:\s*["\']?([^"\'\n]+)["\']?\s*$', text)
+    if not match:
+        raise ValidationError(f"Markdown frontmatter version not found: {path}")
+    version = normalize_text(match.group(1))
+    if not version:
+        raise ValidationError(f"Markdown frontmatter version is empty: {path}")
+    return version
+
 def extract_pdf_text(path: Path) -> str:
     try:
         result = subprocess.run(
@@ -78,10 +90,10 @@ def extract_pdf_text(path: Path) -> str:
     return result.stdout
 
 
-def validate_pdf(path: Path) -> None:
+def validate_pdf(path: Path, expected_version: str) -> None:
     ensure_exists(path, "PDF")
     text = extract_pdf_text(path)
-    assert_contains(text, (FULL_TITLE, SHORT_TITLE, "Version 3.1", *CANONICAL_TOKENS), "PDF")
+    assert_contains(text, (FULL_TITLE, SHORT_TITLE, f"Version {expected_version}", *CANONICAL_TOKENS), "PDF")
     print("OK   [PDF] canonical text markers found")
     return text
 
@@ -179,9 +191,11 @@ def parse_args() -> argparse.Namespace:
 def main() -> int:
     args = parse_args()
     try:
+        markdown_path = Path(args.markdown)
+        expected_version = read_markdown_version(markdown_path)
         texts = {
-            "Markdown": validate_markdown(Path(args.markdown)),
-            "PDF": validate_pdf(Path(args.pdf)),
+            "Markdown": validate_markdown(markdown_path),
+            "PDF": validate_pdf(Path(args.pdf), expected_version),
             "EPUB": validate_epub(Path(args.epub)),
             "DOCX": validate_docx(Path(args.docx)),
         }

CHANGELOG.md

@@ -12,6 +12,7 @@ All notable changes to the WordPress Operations Runbook template.
 - Added Learn WordPress's [Writing in the WordPress voice](https://learn.wordpress.org/course/writing-in-the-wordpress-voice/) as the recommended WordPress-specific voice and accessibility reference when runbook material is adapted into user-facing or cross-team communications.
 
 ### Changed
+- Made the generated-artifact validator read the expected version string from the Markdown frontmatter instead of hardcoding `Version 3.1`, preventing future publish-flow failures after routine version bumps.
 - Updated Section 1.4 of the canonical runbook so the in-document version history matches the actual template release history (`3.1`, `3.0.1`, `3.0`, `2.0`) instead of stale placeholder entries.
 - Separated Playwright PDF visual validation from the artifact publish path so `generate-docs.yml` can publish after artifact checks while the dedicated visual workflow handles layout regression checks on workflow, packaging, and Pandoc changes.
 - Aligned more of the operational procedures with the current runbook-skill safety rules by normalizing the cache-plugin annotation string, correcting the remaining singular `--field` WP-CLI examples to explicit `--fields=... --format=csv` pipelines, and adding approval/warning markers around additional side-effect commands (`wp db query` migrations, cache flushes, imports, option updates, transient deletion, and `wp eval-file` test mail).