build: move scripts to sub-folders for respective workflows

.github/workflows/check_commit_metadata.yml

@@ -72,4 +72,4 @@ jobs:
           COMMIT_METADATA: ${{ steps.extract-metadata.outputs.metadata }}
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_commit_metadata" $PR_NUMBER $COMMIT_METADATA
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_commit_metadata/run" $PR_NUMBER $COMMIT_METADATA

.github/workflows/check_contributing_guidelines_acceptance.yml

@@ -84,4 +84,4 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
           PR_NUMBER: ${{ github.event.pull_request.number || inputs.pull_request_number }}
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_contributing_guidelines_acceptance" $PR_NUMBER
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_contributing_guidelines_acceptance/run" $PR_NUMBER

.github/workflows/check_duplicate_prs.yml

@@ -76,5 +76,5 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
           DEBUG: ${{ inputs.debug || 'false' }}
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_duplicate_prs"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_duplicate_prs/run"
         timeout-minutes: 15

.github/workflows/check_licenses.yml

@@ -114,7 +114,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" "${{ env.BUILD_TASK }}" "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" "${{ env.BUILD_TASK }}" "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/check_tracking_issue_closure.yml

@@ -67,7 +67,7 @@ jobs:
       # Run the script to check PRs for tracking issue closure:
       - name: 'Check PRs for tracking issue closure'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_tracking_issue_closure" 1
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/check_tracking_issue_closure/run" 1
         env:
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
           DEBUG: ${{ inputs.debug || 'false' }}

.github/workflows/create_address_commit_comment_issues.yml

@@ -66,5 +66,5 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/create_address_commit_comments_issues" 14
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/create_address_commit_comments_issues/run" 14
         timeout-minutes: 15

.github/workflows/first_time_greeting.yml

@@ -69,4 +69,4 @@ jobs:
           ISSUE_NUMBER: ${{ github.event.issue.number || github.event.pull_request.number }}
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/first_time_greeting" $ISSUE_NUMBER
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/first_time_greeting/run" $ISSUE_NUMBER

.github/workflows/generate_pr_commit_message.yml

@@ -67,7 +67,7 @@ jobs:
         id: commit_message
         shell: bash {0} # Omit -e to avoid triggering a failure if the script returns a non-zero exit code
         run: |
-          COMMIT_MESSAGE=$($GITHUB_WORKSPACE/.github/workflows/scripts/generate_pr_commit_message $PR_NUMBER)
+          COMMIT_MESSAGE=$($GITHUB_WORKSPACE/.github/workflows/scripts/generate_pr_commit_message/run $PR_NUMBER)
           EXIT_CODE=$?
 
           echo "commit_message<<EOF" >> $GITHUB_OUTPUT

.github/workflows/label_good_first_prs.yml

@@ -68,7 +68,7 @@ jobs:
         env:
           PR_NUMBER: ${{ github.event.pull_request.number }}
         run: |
-          bool=$(. "$GITHUB_WORKSPACE/.github/workflows/scripts/references_good_first_issue" $PR_NUMBER)
+          bool=$(. "$GITHUB_WORKSPACE/.github/workflows/scripts/label_good_first_prs/references_good_first_issue" $PR_NUMBER)
           echo "good-first-pr=$bool" >> $GITHUB_OUTPUT
 
       # Add "Good First PR" label if PR references a "Good First Issue"

.github/workflows/lint_autofix.yml

@@ -138,20 +138,20 @@ jobs:
         id: fix-lint-errors
         run: |
           files="${{ steps.changed-files.outputs.files }}"
-          FIX=1 . "$GITHUB_WORKSPACE/.github/workflows/scripts/lint_javascript_files" "$files" || true
+          FIX=1 . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/lint_javascript_files" "$files" || true
 
       # Add missing trailing newlines:
       - name: 'Add missing trailing newlines'
         id: add-trailing-newlines
         run: |
           files="${{ steps.changed-files.outputs.files }}"
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/add_trailing_newlines" "$files"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/lint_autofix/add_trailing_newlines" "$files"
 
       # Remove related packages from README.md files:
       - name: 'Remove related packages from README.md files'
         run: |
           files="${{ steps.changed-files.outputs.files }}"
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/remove_related_packages" "$files"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/lint_autofix/remove_related_packages" "$files"
 
       # Disable Git hooks:
       - name: 'Disable Git hooks'

.github/workflows/lint_changed_files.yml

@@ -169,7 +169,7 @@ jobs:
       - name: 'Lint package.json files'
         if: success() || failure()
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/lint_package_json_files" "${{ steps.changed-files.outputs.files }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/lint_package_json_files" "${{ steps.changed-files.outputs.files }}"
 
       # Lint REPL help files...
       - name: 'Lint REPL help files'

.github/workflows/lint_random_files.yml

@@ -238,7 +238,7 @@ jobs:
           -   Reference this issue in the "Related Issues" section of the PR body as "resolves #<ISSUE_NUMBER>".
           EOF
 
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/create_sub_issue" \
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/create_sub_issue" \
             'Fix EditorConfig lint errors' \
             "$BODY_FILE" \
             "5156" \
@@ -312,7 +312,7 @@ jobs:
 
           # Run the lint script:
           if [ -n "${files}" ]; then
-            "$GITHUB_WORKSPACE/.github/workflows/scripts/lint_javascript_files_error_log" ${files}
+            "$GITHUB_WORKSPACE/.github/workflows/scripts/common/lint_javascript_files_error_log" ${files}
           else
             echo "No JavaScript files to lint."
           fi
@@ -347,7 +347,7 @@ jobs:
             -   Reference this issue in the "Related Issues" section of the PR body as "resolves #<ISSUE_NUMBER>".
           EOF
 
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/create_sub_issue" \
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/create_sub_issue" \
             'Fix JavaScript lint errors' \
             "$BODY_FILE" \
             "5377" \
@@ -493,7 +493,7 @@ jobs:
           -   Reference this issue in the "Related Issues" section of the PR body as "resolves #<ISSUE_NUMBER>".
           EOF
 
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/create_sub_issue" \
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/create_sub_issue" \
             'Fix C lint errors' \
             "$BODY_FILE" \
             "3235"  # Number of C lint error tracking issue
@@ -546,7 +546,7 @@ jobs:
           -   Reference this issue in the "Related Issues" section of the PR body as "resolves #<ISSUE_NUMBER>".
           EOF
 
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/create_sub_issue" \
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/create_sub_issue" \
             'Fix TypeScript declarations lint errors' \
             "$BODY_FILE" \
             "9110" \

.github/workflows/linux_benchmark.yml

@@ -223,7 +223,7 @@ jobs:
       # Perform install sequence:
       - name: 'Perform install sequence'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
         timeout-minutes: 30
 
       # View the log file if the previous step fails:
@@ -237,7 +237,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/linux_examples.yml

@@ -223,7 +223,7 @@ jobs:
       # Perform install sequence:
       - name: 'Perform install sequence'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
         timeout-minutes: 30
 
       # View the log file if the previous step fails:
@@ -237,7 +237,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/linux_test.yml

@@ -222,7 +222,7 @@ jobs:
       # Perform install sequence:
       - name: 'Perform install sequence'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
         timeout-minutes: 30
 
       # View the log file if the previous step fails:
@@ -236,7 +236,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/linux_test_cov.yml

@@ -223,7 +223,7 @@ jobs:
       # Perform install sequence:
       - name: 'Perform install sequence'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
         timeout-minutes: 30
 
       # View the log file if the previous step fails:
@@ -237,7 +237,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/linux_test_install.yml

@@ -260,7 +260,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/test_install" "${{ matrix.PACKAGE_MANAGER }}" "${{ env.INSTALL_DIR }}" "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/test_install" "${{ matrix.PACKAGE_MANAGER }}" "${{ env.INSTALL_DIR }}" "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/macos_benchmark.yml

@@ -209,7 +209,7 @@ jobs:
       # Perform install sequence:
       - name: 'Perform install sequence'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
         timeout-minutes: 30
 
       # View the log file if the previous step fails:
@@ -223,7 +223,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/macos_test.yml

@@ -208,7 +208,7 @@ jobs:
       # Perform install sequence:
       - name: 'Perform install sequence'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
         timeout-minutes: 30
 
       # View the log file if the previous step fails:
@@ -222,7 +222,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/macos_test_cov.yml

@@ -209,7 +209,7 @@ jobs:
       # Perform install sequence:
       - name: 'Perform install sequence'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" install "${{ env.LOG_FILE_INSTALL }}"
         timeout-minutes: 30
 
       # View the log file if the previous step fails:
@@ -223,7 +223,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/macos_test_npm_install.yml

@@ -219,7 +219,7 @@ jobs:
       # Run the build task:
       - name: 'Run build task'
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/common/task_runner" ${{ matrix.BUILD_TASK }} "${{ env.LOG_FILE_BUILD_TASK }}"
         timeout-minutes: 360
 
       # View the log file if the previous step fails:

.github/workflows/markdown_links.yml

@@ -168,7 +168,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
         run: |
-          "$GITHUB_WORKSPACE/.github/workflows/scripts/create_broken_link_issues" \
+          "$GITHUB_WORKSPACE/.github/workflows/scripts/markdown_links/create_broken_link_issues" \
             '${{ steps.results.outputs.failures }}' \
             "9112"
         timeout-minutes: 30

.github/workflows/merge_ready_prs.yml

@@ -63,7 +63,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
         run: |
           if [ "${{ inputs.dry-run }}" == "true" ]; then
-            . "$GITHUB_WORKSPACE/.github/workflows/scripts/merge_ready_prs" --dry-run
+            . "$GITHUB_WORKSPACE/.github/workflows/scripts/merge_ready_prs/merge_ready_prs" --dry-run
           else
-            . "$GITHUB_WORKSPACE/.github/workflows/scripts/merge_ready_prs"
+            . "$GITHUB_WORKSPACE/.github/workflows/scripts/merge_ready_prs/merge_ready_prs"
           fi

.github/workflows/pr_commands_comment.yml

@@ -94,5 +94,5 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_GITHUB_TOKEN || secrets.STDLIB_BOT_PAT_REPO_WRITE }}
           DEBUG: ${{ inputs.debug || 'false' }}
         run: |
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/package_commands_comment" "$PR_NUMBER"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/pr_commands_comment/package_commands_comment" "$PR_NUMBER"
         timeout-minutes: 30

.github/workflows/run_affected_benchmarks.yml

@@ -150,5 +150,5 @@ jobs:
           else
             directories="${{ steps.changed-directories.outputs.directories }}"
           fi
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_affected_benchmarks" "$directories"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_affected_benchmarks/run" "$directories"
         timeout-minutes: 60

.github/workflows/run_affected_tests.yml

@@ -182,5 +182,5 @@ jobs:
           else
             directories="${{ steps.changed-directories.outputs.directories }}"
           fi
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_affected_tests" "$directories"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_affected_tests/run" "$directories"
         timeout-minutes: 30

.github/workflows/run_tests_coverage.yml

@@ -176,7 +176,7 @@ jobs:
             directories="${{ steps.changed-directories.outputs.directories }}"
           fi
 
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_tests_coverage" "$directories"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_tests_coverage/run" "$directories"
         timeout-minutes: 30
 
       # Create final coverage report:

.github/workflows/run_tests_coverage_pr.yml

@@ -151,7 +151,7 @@ jobs:
           COVERAGE_BASE_URL: 'https://coverage.stdlib.io/pr-${{ github.event.pull_request.number }}'
         run: |
           directories="${{ steps.changed-directories.outputs.directories }}"
-          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_tests_coverage" "$directories"
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_tests_coverage/run" "$directories"
         timeout-minutes: 30
 
       # Create final coverage report:

.github/workflows/scripts/check_commit_metadata → .github/workflows/scripts/check_commit_metadata/run

@@ -18,8 +18,6 @@
 
 # Script to check commit metadata for missing YAML blocks or dependencies.
 #
-# Usage: check_commit_metadata <pr_number> <commit_metadata> [--dry-run]
-#
 # Arguments:
 #
 #   pr_number        Pull request number.

.github/workflows/scripts/check_contributing_guidelines_acceptance → .github/workflows/scripts/check_contributing_guidelines_acceptance/run

@@ -18,11 +18,9 @@
 
 # Script to check if a pull request contains the checked contributing guidelines acknowledgment checkbox.
 #
-# Usage: check_contributing_guidelines PR_NUMBER
-#
 # Arguments:
 #
-#   PR_NUMBER    Pull request number.
+#   pr_number    Pull request number.
 #
 # Environment variables:
 #

.github/workflows/scripts/check_duplicate_prs → .github/workflows/scripts/check_duplicate_prs/run

@@ -18,8 +18,6 @@
 
 # Script to identify potentially duplicate pull requests based on the issues they resolve.
 #
-# Usage: check_duplicate_prs
-#
 # Environment variables:
 #
 #   GITHUB_TOKEN   GitHub token for authentication.

.github/workflows/scripts/check_tracking_issue_closure → .github/workflows/scripts/check_tracking_issue_closure/run

@@ -18,8 +18,6 @@
 
 # Script to check PRs for auto-closing language referencing tracking issues.
 #
-# Usage: check_tracking_issue_closure <days>
-#
 # Arguments:
 #
 #   days        Number of days to look back for PRs.

.github/workflows/scripts/create_address_commit_comments_issues → .github/workflows/scripts/create_address_commit_comments_issues/run

@@ -18,8 +18,6 @@
 
 # Script to create issues for commit comments tagging @stdlib-bot.
 #
-# Usage: create_issues_address_commit_comments <days>
-#
 # Arguments:
 #
 #   days        Number of days to look back for commits.