refine workflow (#34)

* refine workflow

* workflow test

* modified:   tools/02_validate_module.sh

* modified:   tools/02_validate_module.sh

* modified:   tools/02_validate_module.sh

* removed old function

Author: Tearran

.github/workflows/00_github_staging-validate.yml

@@ -0,0 +1,44 @@
+name: 03 Staging Gate
+
+on:
+  pull_request:
+    paths:
+      - 'staging/**'
+      - 'tools/**'
+
+jobs:
+  gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Fail if staging folder is missing or empty
+        run: |
+          if [ ! -d staging ] || [ -z "$(ls -A staging)" ]; then
+          	echo "::error ::staging folder is missing or empty. Please add or update at least one module."
+          	exit 1
+          fi
+
+      - name: Staging compatibility check
+        run: bash tools/02_validate_module.sh
+
+      - name: Run all tools and report pass/fail
+        run: |
+          status=0
+          for tool in tools/[0-9][0-9]_*.sh; do
+            # Skip 02_validate_module.sh (already run)
+            if [[ "$(basename "$tool")" == "02_validate_module.sh" ]]; then
+              continue
+            fi
+            echo "=== Running: $tool ==="
+            bash "$tool"
+            result=$?
+            if [[ $result -eq 0 ]]; then
+              echo "::notice ::PASS: $tool"
+            else
+              echo "::error ::FAIL: $tool (exit code $result)"
+              status=1
+            fi
+            echo
+          done
+          exit $status

.github/workflows/03_github_staging-validate.yml

@@ -5,7 +5,7 @@ feature=submenu
 description=Displays an interactive submenu for module functions based on their help output.
 extend_desc=Parses the help message of a given module and presents an interactive menu via dialog, whiptail, or CLI prompt.
 documents=false
-options=
+options=<module_name help>
 parent=core
 group=interface
 contributor=@tearran
@@ -14,4 +14,4 @@ arch=arm64 armhf x86-64
 require_os=Armbian Debian Ubuntu
 require_kernel=5.15+
 port=false
-helpers=   # Will list _*_submenu() helpers when available
+helpers=_about_submenu

.github/workflows/03_github_assemble.yml.hold renamed to .github/workflows/05_github_assemble.yml.hold

@@ -14,4 +14,4 @@ arch=arm64 armhf x86-64
 require_os=Armbian Debian Ubuntu
 require_kernel=5.15+
 port=false
-helpers=   # Will list _*_yes_no_box() helpers when available
+helpers=_about_yes_no_box