CI: fix docs/soundness checks for the CLI help snippet

Author: ktoso

.github/scripts/validate_docs.sh

@@ -6,8 +6,8 @@ set -x
 swift run generate-config-docs --check
 
 ./scripts/generate-cli-help-snippets.sh
-if ! git diff --exit-code -- Snippets/SwiftJavaCLIHelp.sh; then
-  echo "::error::Snippets/SwiftJavaCLIHelp.sh is out of date with the swift-java CLI's --help output (likely a command's flags or abstract text changed). Run scripts/generate-cli-help-snippets.sh and commit the result."
+if ! git diff --exit-code -- Snippets/SwiftJavaCLIHelp.txt; then
+  echo "::error::Snippets/SwiftJavaCLIHelp.txt is out of date with the swift-java CLI's --help output (likely a command's flags or abstract text changed). Run scripts/generate-cli-help-snippets.sh and commit the result."
   exit 1
 fi
 

.github/workflows/pull_request.yml

@@ -38,6 +38,8 @@ jobs:
         jdk_vendor: ['corretto']
     steps:
       - uses: actions/checkout@v7
+      - name: Mark workspace as safe for git
+        run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
       - name: Prepare CI Environment
         uses: ./.github/actions/prepare_env
       - name: Cache .build

Snippets/SwiftJavaCLIHelp.sh Snippets/SwiftJavaCLIHelp.txtSnippets/SwiftJavaCLIHelp.sh renamed to Snippets/SwiftJavaCLIHelp.txt

@@ -14,7 +14,7 @@
 ##===----------------------------------------------------------------------===##
 ##
 ## Captures the live --help output of the swift-java CLI and writes it to
-## Snippets/SwiftJavaCLIHelp.sh, sliced per subcommand so the DocC pages can
+## Snippets/SwiftJavaCLIHelp.txt, sliced per subcommand so the DocC pages can
 ## embed the *actual* --help/USAGE text via @Snippet instead of a pasted copy
 ## that can drift out of sync with the tool.
 ##
@@ -25,7 +25,7 @@ set -eu
 
 cd "$(dirname "$0")/.."
 
-OUTPUT_FILE="Snippets/SwiftJavaCLIHelp.sh"
+OUTPUT_FILE="Snippets/SwiftJavaCLIHelp.txt"
 
 echo "Building swift-java..."
 swift build --product swift-java