(juneau) branch master updated: feat(push,docs): wire juneau-docs smoke check into push.py + fix build-docs.py --skip-maven (TODO-130)

[jamesbognar]

This is an automated email from the ASF dual-hosted git repository.

jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git


The following commit(s) were added to refs/heads/master by this push:
     new b0dc55154f feat(push,docs): wire juneau-docs smoke check into push.py 
+ fix build-docs.py --skip-maven (TODO-130)
b0dc55154f is described below

commit b0dc55154f95b6bfc98d520f690d237c4102fd47
Author: James Bognar <jamesbog...@apache.org>
AuthorDate: Thu May 28 16:45:55 2026 -0400

    feat(push,docs): wire juneau-docs smoke check into push.py + fix 
build-docs.py --skip-maven (TODO-130)
    
    scripts/push.py Step 6: before pushing juneau-docs changes, run
    python3 scripts/build-docs.py --skip-maven. Abort with a clear error
    if the Docusaurus build fails; print elapsed time on success.
    
    Fixed 3 issues in build-docs.py where --skip-maven still hit the
    master-dir check, Maven-site copy, and cross-repo link checks.
    
    .cursor/commands/push.md updated to reflect the auto-handling.
    juneau-docs-workflow skill updated with push-time smoke check note.
    Release-notes Docs entry added.
---
 juneau-utest/test-run-history.tsv |  1 +
 scripts/push.py                   | 56 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+)

diff --git a/juneau-utest/test-run-history.tsv 
b/juneau-utest/test-run-history.tsv
index dfb1419683..f5fbcbe60c 100644
--- a/juneau-utest/test-run-history.tsv
+++ b/juneau-utest/test-run-history.tsv
@@ -49,3 +49,4 @@ timestamp     git_sha branch  tests_run       failures        
errors  skipped surefire_sec    wall_sec
 2026-05-28T19:24:27Z   a26b6978a5bc    master  125889  0       0       21      
160
 2026-05-28T20:05:34Z   60e4b5a8e813    master  125889  0       0       21      
136
 2026-05-28T20:22:45Z   5e454b3a7988    master  125891  0       0       21      
141
+2026-05-28T20:45:00Z   007293082747    master  125891  0       0       21      
146
diff --git a/scripts/push.py b/scripts/push.py
index e992af1ce3..e94e0210d4 100755
--- a/scripts/push.py
+++ b/scripts/push.py
@@ -641,6 +641,62 @@ Examples:
         play_sound(success=False)
         return 1
     
+    step_num += 1
+
+    # Step 6 (optional): juneau-docs follow-up — smoke check + commit + push
+    docs_root = juneau_root.parent / "juneau-docs"
+    if docs_root.exists() and check_git_status(docs_root):
+        print(f"\n📚 Step {step_num}: juneau-docs has changes — running 
Docusaurus smoke check first...")
+
+        docs_build_script = docs_root / "scripts" / "build-docs.py"
+        docs_smoke_start = time.time()
+        try:
+            result = subprocess.run(
+                [sys.executable, str(docs_build_script), "--skip-maven"],
+                cwd=docs_root,
+                check=False
+            )
+            docs_smoke_elapsed = time.time() - docs_smoke_start
+            if result.returncode != 0:
+                print(f"\n❌ Docs smoke check failed — fix the Docusaurus build 
before pushing juneau-docs.")
+                play_sound(success=False)
+                return 1
+            print(f"✅ Docs smoke check passed ({docs_smoke_elapsed:.1f}s)")
+        except Exception as e:
+            print(f"\n❌ Docs smoke check failed: {e}")
+            play_sound(success=False)
+            return 1
+
+        if not run_command(
+            ["git", "add", "."],
+            f"  {step_num}.1: Staging juneau-docs changes...",
+            docs_root
+        ):
+            print("\n❌ Build process aborted due to juneau-docs git add 
failure.")
+            play_sound(success=False)
+            return 1
+
+        if not run_command(
+            ["git", "commit", "-m", args.message],
+            f"  {step_num}.2: Committing juneau-docs changes...",
+            docs_root
+        ):
+            print("\n❌ Build process aborted due to juneau-docs git commit 
failure.")
+            play_sound(success=False)
+            return 1
+
+        if not run_command(
+            ["git", "push"],
+            f"  {step_num}.3: Pushing juneau-docs changes...",
+            docs_root
+        ):
+            print("\n❌ juneau-docs push failed.")
+            print("⚠ juneau-docs changes have been committed locally but not 
pushed.")
+            play_sound(success=False)
+            return 1
+
+        print(f"✅ Step {step_num}: juneau-docs pushed successfully.")
+
     # Success!
     print("\n" + "=" * 70)
     print("🎉 All operations completed successfully!")