feat: add support for returning posix path separator on windows (#2056 )

Co-authored-by: GitHub Action <action@github.com>
fix: add a fallback value for the max number for retries to fetch missing history (#2055 )
2024-04-18 15:03:38 -06:00 · 2024-04-18 19:12:36 +00:00 · 2024-04-18 13:02:55 -06:00 · 2024-04-18 12:52:38 -06:00 · 2024-04-18 12:45:07 -06:00 · 2024-04-17 16:40:08 +00:00
31 changed files with 14519 additions and 1392 deletions
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -208,6 +208,43 @@
        "test",
        "bug"
      ]
+    },
+    {
+      "login": "levenleven",
+      "name": "Aleksey Levenstein",
+      "avatar_url": "https://avatars.githubusercontent.com/u/6463364?v=4",
+      "profile": "https://github.com/levenleven",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "dan-hill2802",
+      "name": "Daniel Hill",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5046322?v=4",
+      "profile": "https://github.com/dan-hill2802",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "KeisukeYamashita",
+      "name": "KeisukeYamashita",
+      "avatar_url": "https://avatars.githubusercontent.com/u/23056537?v=4",
+      "profile": "https://keisukeyamashita.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "codesculpture",
+      "name": "Aravind",
+      "avatar_url": "https://avatars.githubusercontent.com/u/63452117?v=4",
+      "profile": "https://github.com/codesculpture",
+      "contributions": [
+        "code",
+        "bug"
+      ]
    }
  ],
  "contributorsPerLine": 7,
--- a/.github/workflows/codacy-analysis.yml
+++ b/.github/workflows/codacy-analysis.yml
@@ -24,11 +24,6 @@ permissions:

 jobs:
  codacy-security-scan:
-    # Cancel other workflows that are running for the same branch
-    # https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#concurrency
-    concurrency:
-      group: ${{ github.workflow }}-${{ github.ref }}
-      cancel-in-progress: true
    name: Codacy Security Scan
    runs-on: ubuntu-latest
    steps:
@@ -39,7 +34,7 @@ jobs:
      # Execute Codacy Analysis CLI and generate a SARIF output with the security issues identified during the analysis
      - name: Run Codacy Analysis CLI
        continue-on-error: true
-        uses: codacy/codacy-analysis-cli-action@v4.3.0
+        uses: codacy/codacy-analysis-cli-action@v4.4.0
        with:
          # Check https://github.com/codacy/codacy-analysis-cli#project-token to get your project token from your Codacy repository
          # You can also omit the token and run the tools that support default configurations
--- a/.github/workflows/greetings.yml
+++ b/.github/workflows/greetings.yml
@@ -0,0 +1,18 @@
+name: Greetings
+
+on: [pull_request_target, issues]
+
+permissions:
+  pull-requests: write
+  issues: write
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/first-interaction@v1
+        continue-on-error: true
+        with:
+          repo-token: ${{ secrets.PAT_TOKEN }}
+          issue-message: "Thanks for reporting this issue, don't forget to star this project if you haven't already to help us reach a wider audience."
+          pr-message: "Thanks for implementing a fix, could you ensure that the test covers your changes if applicable."
--- a/.github/workflows/issue-comment-job-example.yml
+++ b/.github/workflows/issue-comment-job-example.yml
@@ -1,4 +1,4 @@
-name: Issue Comment Test
+name: Issue Comment Job Example

 permissions:
   contents: read
--- a/.github/workflows/manual-triggered-job-example.yml
+++ b/.github/workflows/manual-triggered-job-example.yml
@@ -1,4 +1,4 @@
-name: Manual Test
+name: Manual Triggered Job Example

 permissions:
   contents: read
@@ -6,7 +6,6 @@ permissions:
 on:
  workflow_dispatch:

-
 jobs:
  test:
    name: Test changed-files
--- a/.github/workflows/matrix-example.yml
+++ b/.github/workflows/matrix-example.yml
@@ -1,4 +1,4 @@
-name: Matrix Test
+name: Matrix Example

 permissions:
   contents: read
@@ -24,8 +24,7 @@ jobs:
        id: changed-files
        uses: ./
        with:
-          json: true
-          escape_json: false
+          matrix: true
      - name: List all changed files
        run: echo '${{ steps.changed-files.outputs.all_changed_files }}'

--- a/.github/workflows/multi-job-example.yml
+++ b/.github/workflows/multi-job-example.yml
@@ -1,4 +1,4 @@
-name: Multi Job Test
+name: Multi Job Example

 permissions:
   contents: read
--- a/.github/workflows/sync-release-version.yml
+++ b/.github/workflows/sync-release-version.yml
@@ -37,7 +37,7 @@ jobs:
      - name: Run git-cliff
        uses: tj-actions/git-cliff@v1
      - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v5.0.2
+        uses: peter-evans/create-pull-request@v6.0.4
        with:
          base: "main"
          labels: "merge when passing"
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -2,7 +2,6 @@ name: CI

 permissions:
  contents: read
-  pull-requests: write

 on:
  push:
@@ -35,6 +34,9 @@ jobs:
    runs-on: ubuntu-latest
    outputs:
      files_changed: ${{ steps.changed_files.outputs.files_changed }}
+    permissions:
+      contents: read
+      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
@@ -43,7 +45,7 @@ jobs:
          repository: ${{ github.event.pull_request.head.repo.full_name }}

      - name: Use Node.js 20.x
-        uses: actions/setup-node@v4.0.1
+        uses: actions/setup-node@v4.0.2
        with:
          cache: 'yarn'
          node-version: '20.x'
@@ -58,7 +60,7 @@ jobs:
          yarn install

      - name: Run eslint on changed files
-        uses: tj-actions/eslint-changed-files@v22
+        uses: tj-actions/eslint-changed-files@v24
        if: github.event_name == 'pull_request'
        with:
          token: ${{ secrets.PAT_TOKEN }}
@@ -70,7 +72,7 @@ jobs:
          yarn all

      - name: Verify Changed files
-        uses: tj-actions/verify-changed-files@v17
+        uses: tj-actions/verify-changed-files@v19
        id: changed_files
        with:
          files: |
@@ -94,7 +96,7 @@ jobs:
          branch: ${{ github.head_ref }}

      - name: Upload build assets
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
        with:
          name: build-assets
          path: dist
@@ -111,6 +113,8 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    steps:
      - name: Checkout into dir1
        uses: actions/checkout@v4
@@ -121,7 +125,7 @@ jobs:
          path: dir1

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets
          path: dir1/dist
@@ -147,7 +151,7 @@ jobs:
          bash

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets
          path: dir2/dist
@@ -185,7 +189,8 @@ jobs:
    needs: build
    runs-on: ubuntu-latest
    if: github.event_name == 'push' && needs.build.outputs.files_changed != 'true'
-
+    permissions:
+      contents: read
    steps:
      - name: Checkout branch
        uses: actions/checkout@v4
@@ -194,7 +199,7 @@ jobs:
          fetch-depth: 0

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -243,6 +248,8 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read

    steps:
      - name: Checkout branch
@@ -252,7 +259,7 @@ jobs:
          fetch-depth: 0

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -285,6 +292,8 @@ jobs:
        github.event_name == 'push' || 
        github.event_name == 'pull_request'
      ) && needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read

    steps:
      - name: Checkout branch
@@ -294,7 +303,7 @@ jobs:
          fetch-depth: 0

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -315,6 +324,8 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read

    strategy:
      fail-fast: false
@@ -331,7 +342,7 @@ jobs:
          fetch-depth: ${{ matrix.fetch-depth }}

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -354,6 +365,8 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: github.event_name != 'push' && needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read

    steps:
      - name: Checkout branch
@@ -362,7 +375,7 @@ jobs:
          ref: ${{ github.event.pull_request.head.sha }}

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -381,6 +394,8 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: github.event_name != 'push' && needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    strategy:
      fail-fast: false
      max-parallel: 4
@@ -396,7 +411,7 @@ jobs:
          repository: ${{ github.event.pull_request.head.repo.full_name }}

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -415,13 +430,14 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
-
+    permissions:
+      contents: read
    steps:
      - name: Checkout branch
        uses: actions/checkout@v4

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -469,13 +485,14 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
-
+    permissions:
+      contents: read
    steps:
      - name: Checkout branch
        uses: actions/checkout@v4

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -535,7 +552,7 @@ jobs:
          path: dir1

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets
          path: dir1/dist
@@ -550,11 +567,83 @@ jobs:
        shell:
          bash

+  test-dir-names-nested-folder:
+    name: Test changed-files with dir-names in a nested folder
+    runs-on: ubuntu-latest
+    needs: build
+    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          submodules: true
+          fetch-depth: 0
+
+      - name: Download build assets
+        uses: actions/download-artifact@v4
+        with:
+          name: build-assets
+          path: dist
+
+      - name: Get changed files in the .github folder
+        id: changed-files
+        uses: ./
+        with:
+          path: .github
+          json: true
+          escape_json: false
+          dir_names: true
+          dir_names_exclude_current_dir: true
+
+      - name: Show output
+        run: |
+          echo "${{ toJSON(steps.changed-files.outputs) }}"
+        shell:
+          bash
+
+  test-non-existing-repository:
+    name: Test changed-files with non existing repository
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push' && needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout into dir1
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          submodules: true
+          fetch-depth: 0
+          path: dir1
+
+      - name: Download build assets
+        uses: actions/download-artifact@v4
+        with:
+          name: build-assets
+          path: dir1/dist
+
+      - name: Run changed-files with non existing repository
+        id: changed-files
+        continue-on-error: true
+        uses: ./dir1
+
+      - name: Verify failed
+        if: steps.changed-files.outcome != 'failure'
+        run: |
+          echo "Expected: (failure) got ${{ steps.changed-files.outcome }}"
+          exit 1
+
  test-submodules:
    name: Test changed-files with submodule
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read 
    strategy:
      fail-fast: false
      max-parallel: 4
@@ -570,7 +659,7 @@ jobs:
          fetch-depth: ${{ matrix.fetch-depth }}

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -593,11 +682,34 @@ jobs:
          echo "${{ toJSON(steps.changed-files.outputs) }}"
        shell:
          bash
+
+      - name: Run changed-files excluding submodule
+        id: changed-files-exclude-submodule
+        uses: ./
+        with:
+          base_sha: "85bd869"
+          sha: "adde7bb"
+          fetch_depth: 60000
+          exclude_submodules: true
+
+      - name: Verify no added files
+        if: steps.changed-files-exclude-submodule.outputs.added_files != ''
+        run: |
+          echo "Expected: ('') got ${{ steps.changed-files-exclude-submodule.outputs.added_files }}"
+          exit 1
+
+      - name: Show output
+        run: |
+          echo "${{ toJSON(steps.changed-files-exclude-submodule.outputs) }}"
+        shell:
+          bash
  test-yaml:
    name: Test changed-files with yaml
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    strategy:
      fail-fast: false
      max-parallel: 4
@@ -613,7 +725,7 @@ jobs:
          fetch-depth: ${{ matrix.fetch-depth }}

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -673,6 +785,8 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    strategy:
      fail-fast: false
      max-parallel: 4
@@ -688,7 +802,7 @@ jobs:
          fetch-depth: ${{ matrix.fetch-depth }}

      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -863,6 +977,8 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    steps:
      - name: Checkout branch
        uses: actions/checkout@v4
@@ -893,14 +1009,19 @@ jobs:
          bash
  test-dir-names-deleted-files-include-only-deleted-dirs-directory:
    name: Test dir names deleted files include only deleted dirs
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.platform }}
    needs: build
+    strategy:
+      matrix:
+        platform: [ubuntu-latest, macos-latest, windows-latest]
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    steps:
      - name: Checkout branch
        uses: actions/checkout@v4
        with:
-          ref: cd1e384723e4d1a184568182ac2b27c53ebf017f
+          ref: ${{ github.event.pull_request.head.sha }}
          repository: ${{ github.event.pull_request.head.repo.full_name }}
          submodules: true
          fetch-depth: 2
@@ -912,6 +1033,7 @@ jobs:
          sha: cd1e384723e4d1a184568182ac2b27c53ebf017f
          dir_names: true
          dir_names_deleted_files_include_only_deleted_dirs: true
+          fetch_depth: 60000
      - name: Show output
        run: |
          echo '${{ toJSON(steps.changed-files-dir-names-deleted-files-include-only-deleted-dirs-directory.outputs) }}'
@@ -931,12 +1053,43 @@ jobs:
          exit 1
        shell:
          bash
+      - name: Run changed-files with dir_names and dir_names_deleted_files_include_only_deleted_dirs with the test directory deleted returns posix path separator
+        id: changed-files-dir-names-deleted-files-include-only-deleted-dirs-directory-posix-path-separator
+        uses: ./
+        with:
+          base_sha: a52f8621d26d5d9f54b80f74bda2d9eedff94693
+          sha: cd1e384723e4d1a184568182ac2b27c53ebf017f
+          dir_names: true
+          dir_names_deleted_files_include_only_deleted_dirs: true
+          use_posix_path_separator: true
+          fetch_depth: 60000
+      - name: Show output
+        run: |
+          echo '${{ toJSON(steps.changed-files-dir-names-deleted-files-include-only-deleted-dirs-directory-posix-path-separator.outputs) }}'
+        shell:
+          bash
+      - name: Check deleted_files output on non windows platform
+        if: steps.changed-files-dir-names-deleted-files-include-only-deleted-dirs-directory-posix-path-separator.outputs.deleted_files != 'test/test3' && runner.os != 'Windows'
+        run: |
+          echo "Invalid output: Expected (test/test3) got (${{ steps.changed-files-dir-names-deleted-files-include-only-deleted-dirs-directory-posix-path-separator.outputs.deleted_files }})"
+          exit 1
+        shell:
+          bash
+      - name: Check deleted_files output on windows platform
+        if: "!contains(steps.changed-files-dir-names-deleted-files-include-only-deleted-dirs-directory-posix-path-separator.outputs.deleted_files, 'test/test3') && runner.os == 'Windows'"
+        run: |
+          echo "Invalid output: Expected (test/test3) got (${{ steps.changed-files-dir-names-deleted-files-include-only-deleted-dirs-directory-posix-path-separator.outputs.deleted_files }})"
+          exit 1
+        shell:
+          bash

  test-since-last-remote-commit:
    name: Test changed-files since last remote commit
    runs-on: ubuntu-latest
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    strategy:
      fail-fast: false
      max-parallel: 4
@@ -953,7 +1106,7 @@ jobs:
          fetch-depth: ${{ matrix.fetch-depth }}
  
      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets

@@ -987,6 +1140,8 @@ jobs:
    runs-on: ${{ matrix.platform }}
    needs: build
    if: needs.build.outputs.files_changed != 'true'
+    permissions:
+      contents: read
    strategy:
      fail-fast: false
      max-parallel: 4
@@ -1002,7 +1157,7 @@ jobs:
          repository: ${{ github.event.pull_request.head.repo.full_name }}
          fetch-depth: ${{ matrix.fetch-depth }}
      - name: Download build assets
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
        with:
          name: build-assets
      - name: Dump GitHub context
@@ -1017,7 +1172,7 @@ jobs:
          echo '${{ toJSON(steps.changed-files.outputs) }}'
        shell:
          bash
-      - name: Run changed-files with dir name
+      - name: Run changed-files with dir name pattern
        id: changed-files-dir-name
        uses: ./
        with:
--- a/.github/workflows/update-readme.yml
+++ b/.github/workflows/update-readme.yml
@@ -27,7 +27,7 @@ jobs:
        uses: tj-actions/remark@v3

      - name: Verify Changed files
-        uses: tj-actions/verify-changed-files@v17
+        uses: tj-actions/verify-changed-files@v19
        id: verify_changed_files
        with:
          files: |
@@ -41,7 +41,7 @@ jobs:

      - name: Create Pull Request
        if: failure()
-        uses: peter-evans/create-pull-request@v5
+        uses: peter-evans/create-pull-request@v6
        with:
          base: "main"
          labels: "merge when passing"
--- a/.github/workflows/workflow-run-example.yml
+++ b/.github/workflows/workflow-run-example.yml
@@ -0,0 +1,41 @@
+name: Workflow Run Example
+on:
+  workflow_run:
+    workflows: [Matrix Example]
+    types: [completed]
+
+permissions:
+  contents: read
+
+jobs:
+  on-success:
+    runs-on: ubuntu-latest
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Get changed files
+        id: changed-files
+        uses: ./
+
+      - name: Echo list of changed files on success
+        run: |
+          echo "Changed files on success:"
+          echo "${{ steps.changed-files.outputs.all_changed_files }}"
+
+  on-failure:
+    runs-on: ubuntu-latest
+    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Get changed files
+        id: changed-files
+        uses: ./
+
+      - name: Echo list of changed files on failure
+        run: |
+          echo "Changed files on failure:"
+          echo "${{ steps.changed-files.outputs.all_changed_files }}"
--- a/.github/workflows/workflow-run-test.yml
+++ b/.github/workflows/workflow-run-test.yml
@@ -1,20 +0,0 @@
-name: Workflow Run Example
-on:
-  workflow_run:
-    workflows: [Matrix Test]
-    types: [completed]
-
-permissions:
-  contents: read
-
-jobs:
-  on-success:
-    runs-on: ubuntu-latest
-    if: ${{ github.event.workflow_run.conclusion == 'success' }}
-    steps:
-      - run: echo 'The triggering workflow passed'
-  on-failure:
-    runs-on: ubuntu-latest
-    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
-    steps:
-      - run: echo 'The triggering workflow failed'
--- a/HISTORY.md
+++ b/HISTORY.md
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 [![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?style=for-the-badge\&logo=ubuntu\&logoColor=white)](https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)
 [![Mac OS](https://img.shields.io/badge/mac%20os-000000?style=for-the-badge\&logo=macos\&logoColor=F0F0F0)](https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)
 [![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge\&logo=windows\&logoColor=white)](https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)
-[![Public workflows that use this action.](https://img.shields.io/endpoint?style=for-the-badge\&url=https%3A%2F%2Fused-by.vercel.app%2Fapi%2Fgithub-actions%2Fused-by%3Faction%3Dtj-actions%2Fchanged-files%26badge%3Dtrue)](https://github.com/search?o=desc\&q=tj-actions+changed-files+language%3AYAML\&s=\&type=Code)
+[![Public workflows that use this action.](https://img.shields.io/endpoint?style=for-the-badge\&url=https%3A%2F%2Fused-by.vercel.app%2Fapi%2Fgithub-actions%2Fused-by%3Faction%3Dtj-actions%2Fchanged-files%26package_id%3DUGFja2FnZS0yOTQyNTU4MDk5%26badge%3Dtrue)](https://github.com/search?o=desc\&q=tj-actions+changed-files+language%3AYAML\&s=\&type=Code)

 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/4fe2f49c3ab144b0bbe4effc85a061a0)](https://app.codacy.com/gh/tj-actions/changed-files/dashboard?utm_source=gh\&utm_medium=referral\&utm_content=\&utm_campaign=Badge_grade)
 [![CI](https://github.com/tj-actions/changed-files/actions/workflows/test.yml/badge.svg)](https://github.com/tj-actions/changed-files/actions/workflows/test.yml)
@@ -9,17 +9,17 @@

 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->

-[![All Contributors](https://img.shields.io/badge/all_contributors-22-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-26-orange.svg?style=flat-square)](#contributors-)

 <!-- ALL-CONTRIBUTORS-BADGE:END -->

 ## changed-files

-Effortlessly track all changed files and directories relative to a target branch, preceding commit or the last remote commit returning **relative paths** from the project root using this GitHub action.
+Effortlessly track all changed files and directories relative to a target branch, the current branch (preceding commit or the last remote commit), multiple branches, or custom commits returning **relative paths** from the project root using this GitHub action.

 > \[!NOTE]
 >
-> *   This action solely identifies files that have changed within the context of events such as `pull_request*`, `push`, and more. However, it doesn't detect pending uncommitted changes created during the workflow execution.
+> *   This action solely identifies files that have changed for events such as [`pull_request*`, `push`, `merge_group`, `release`, and many more](#other-supported-events-electron). However, it doesn't detect pending uncommitted changes created during the workflow execution.
 >
 >     See: https://github.com/tj-actions/verify-changed-files instead

@@ -28,7 +28,7 @@ Effortlessly track all changed files and directories relative to a target branch
 *   [Features 🚀](#features-)
 *   [Usage 💻](#usage-)
    *   [On `pull_request` 🔀](#on-pull_request-)
-        *   [Using local .git history 📁](#using-local-git-history-)
+        *   [Using local .git directory 📁](#using-local-git-directory-)
        *   [Using Github's API :octocat:](#using-githubs-api-octocat)
    *   [On `push` ⬆️](#on-push-️)
    *   [Other supported events :electron:](#other-supported-events-electron)
@@ -54,7 +54,7 @@ Effortlessly track all changed files and directories relative to a target branch
 *   Scales to handle large/mono repositories.
 *   Supports Git submodules.
 *   Supports [merge queues](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-a-merge-queue) for pull requests.
-*   Generates escaped [JSON output for running matrix jobs](https://github.com/tj-actions/changed-files/blob/main/.github/workflows/matrix-test.yml) based on changed files.
+*   Generates escaped [JSON output for running matrix jobs](https://github.com/tj-actions/changed-files/blob/main/.github/workflows/matrix-example.yml) based on changed files.
 *   Lists changed directories.
    *   Limits matching changed directories to a specified maximum depth.
    *   Optionally excludes the current directory.
@@ -97,7 +97,7 @@ Visit the [discussions for more information](https://github.com/tj-actions/chang

 Detect changes to all files in a Pull request relative to the target branch or since the last pushed commit.

-#### Using local .git history 📁
+#### Using local .git directory 📁

 ```yaml
 name: CI
@@ -116,13 +116,13 @@ jobs:
    name: Test changed-files
    steps:
      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0  # OR "2" -> To retrieve the preceding commit.

+      # -----------------------------------------------------------------------------------------------------------
      # Example 1
+      # -----------------------------------------------------------------------------------------------------------
      - name: Get changed files
        id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
        # To compare changes between the current commit and the last pushed remote commit set `since_last_remote_commit: true`. e.g
        # with:
        #   since_last_remote_commit: true 
@@ -131,14 +131,16 @@ jobs:
        env:
          ALL_CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
        run: |
-          for file in "$ALL_CHANGED_FILES"; do
+          for file in ${ALL_CHANGED_FILES}; do
            echo "$file was changed"
          done

+      # -----------------------------------------------------------------------------------------------------------
      # Example 2
+      # -----------------------------------------------------------------------------------------------------------
      - name: Get all changed markdown files
        id: changed-markdown-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
        with:
          # Avoid using single or double quotes for multiline patterns
          files: |
@@ -149,14 +151,16 @@ jobs:
        env:
          ALL_CHANGED_FILES: ${{ steps.changed-markdown-files.outputs.all_changed_files }}
        run: |
-          for file in "$ALL_CHANGED_FILES"; do
+          for file in ${ALL_CHANGED_FILES}; do
            echo "$file was changed"
          done

+      # -----------------------------------------------------------------------------------------------------------
      # Example 3
+      # -----------------------------------------------------------------------------------------------------------
      - name: Get all test, doc and src files that have changed
        id: changed-files-yaml
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
        with:
          files_yaml: |
            doc:
@@ -186,10 +190,12 @@ jobs:
          echo "One or more doc file(s) has changed."
          echo "List all the files that have changed: $DOC_ALL_CHANGED_FILES"

-      # Example 3
+      # -----------------------------------------------------------------------------------------------------------
+      # Example 4
+      # -----------------------------------------------------------------------------------------------------------
      - name: Get changed files in the docs folder
        id: changed-files-specific
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
        with:
          files: docs/*.{js,html}  # Alternatively using: `docs/**`
          files_ignore: docs/static.js
@@ -221,7 +227,7 @@ jobs:
    # NOTE:
    # - This is limited to pull_request* events and would raise an error for other events.
    # - A maximum of 3000 files can be returned.
-    # - For more flexibility and no limitations see "Using local .git history" above.
+    # - For more flexibility and no limitations see "Using local .git directory" above.

    runs-on: ubuntu-latest  # windows-latest || macos-latest
    name: Test changed-files
@@ -231,13 +237,13 @@ jobs:
    steps:
      - name: Get changed files
        id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44

      - name: List all changed files
        env:
          ALL_CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
        run: |
-          for file in "$ALL_CHANGED_FILES"; do
+          for file in ${ALL_CHANGED_FILES}; do
            echo "$file was changed"
          done
 ```
@@ -274,14 +280,14 @@ jobs:

      - name: Get changed files
        id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
      # NOTE: `since_last_remote_commit: true` is implied by default and falls back to the previous local commit.

      - name: List all changed files
        env:
          ALL_CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
        run: |
-          for file in "$ALL_CHANGED_FILES"; do
+          for file in ${ALL_CHANGED_FILES}; do
            echo "$file was changed"
          done
      ...
@@ -292,6 +298,7 @@ jobs:
 *   [schedule](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#schedule)
 *   [release](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#release)
 *   [workflow\_dispatch](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#workflow_dispatch)
+*   [workflow\_run](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#workflow_run)
 *   [merge\_group](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#merge_group)
 *   [issue\_comment](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#issue_comment)
 *   ...and many more
@@ -312,14 +319,15 @@ Support this project with a :star:
 >
 > *   When using `files_yaml*` inputs:
 >     *   All keys must start with a letter or `_` and contain only alphanumeric characters, `-`, or `_`.
->         For example, `test` or `test_key` or `tesT-key` are all valid.
+>
+>         For example, `test` or `test_key` or `test-key` or `_test_key` are all valid choices.

 ## Inputs ⚙️

 <!-- AUTO-DOC-INPUT:START - Do not remove or modify this section -->

 ```yaml
- uses: tj-actions/changed-files@v41
+- uses: tj-actions/changed-files@v44
  id: changed-files
  with:
    # Github API URL.
@@ -381,6 +389,11 @@ Support this project with a :star:
    # Default: "true"
    escape_json: ''

+    # Exclude changes to submodules.
+    # Type: boolean
+    # Default: "false"
+    exclude_submodules: ''
+
    # Fail when the initial diff fails.
    # Type: boolean
    # Default: "false"
@@ -402,6 +415,11 @@ Support this project with a :star:
    # Default: "50"
    fetch_depth: ''

+    # Maximum number of retries to fetch missing history.
+    # Type: string
+    # Default: "10"
+    fetch_missing_history_max_retries: ''
+
    # File and directory patterns used to detect changes (Defaults to the entire repo if unset). 
    # NOTE: Multiline file/directory patterns should not include quotes. 
    # Type: string
@@ -478,11 +496,18 @@ Support this project with a :star:

    # Output list of changed files in a JSON formatted 
    # string which can be used for matrix jobs. Example: 
-    # https://github.com/tj-actions/changed-files/blob/main/.github/workflows/matrix-test.yml 
+    # https://github.com/tj-actions/changed-files/blob/main/.github/workflows/matrix-example.yml 
    # Type: boolean
    # Default: "false"
    json: ''

+    # Output changed files in a format that can be 
+    # used for matrix jobs. Alias for setting inputs `json` 
+    # to `true` and `escape_json` to `false`. 
+    # Type: boolean
+    # Default: "false"
+    matrix: ''
+
    # Apply the negation patterns first. NOTE: This affects how 
    # changed files are matched. 
    # Type: boolean
@@ -583,10 +608,10 @@ Support this project with a :star:
    # Default: "false"
    since_last_remote_commit: ''

-    # Skip the initial fetch to improve performance for shallow 
-    # repositories. NOTE: This could lead to errors with missing 
-    # history and the intended use is limited to when 
-    # you've fetched the history necessary to perform the diff. 
+    # Skip initially fetching additional history to improve performance for 
+    # shallow repositories. NOTE: This could lead to errors with 
+    # missing history. It's intended to be used when you've 
+    # fetched all necessary history to perform the diff. 
    # Type: boolean
    # Default: "false"
    skip_initial_fetch: ''
@@ -647,33 +672,33 @@ Support this project with a :star:
 |------------------------------------------------------------------------------------------------------------------------------------------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 |                                      <a name="output_added_files"></a>[added\_files](#output_added_files)                                       | string |                                                                                                                                       Returns only files that are <br>Added (A).                                                                                                                                        |
 |                             <a name="output_added_files_count"></a>[added\_files\_count](#output_added_files_count)                              | string |                                                                                                                                           Returns the number of `added_files`                                                                                                                                           |
-|          <a name="output_all_changed_and_modified_files"></a>[all\_changed\_and\_modified\_files](#output_all_changed_and_modified_files)          | string |                                                                                                                     Returns all changed and modified <br>files i.e. *a combination of (ACMRDTUX)*                                                                                                                       |
+|          <a name="output_all_changed_and_modified_files"></a>[all\_changed\_and\_modified\_files](#output_all_changed_and_modified_files)          | string |                                                                                                                    Returns all changed and modified <br>files i.e. a combination of <br>(ACMRDTUX)                                                                                                                      |
 | <a name="output_all_changed_and_modified_files_count"></a>[all\_changed\_and\_modified\_files\_count](#output_all_changed_and_modified_files_count) | string |                                                                                                                                 Returns the number of `all_changed_and_modified_files`                                                                                                                                  |
-|                             <a name="output_all_changed_files"></a>[all\_changed\_files](#output_all_changed_files)                              | string |                                                                                                       Returns all changed files i.e. <br>*a combination of all added, copied, modified and renamed files (ACMR)*                                                                                                        |
+|                             <a name="output_all_changed_files"></a>[all\_changed\_files](#output_all_changed_files)                              | string |                                                                                                    Returns all changed files i.e. <br>a combination of all added, <br>copied, modified and renamed files <br>(ACMR)                                                                                                     |
 |                    <a name="output_all_changed_files_count"></a>[all\_changed\_files\_count](#output_all_changed_files_count)                     | string |                                                                                                                                        Returns the number of `all_changed_files`                                                                                                                                        |
-|                            <a name="output_all_modified_files"></a>[all\_modified\_files](#output_all_modified_files)                            | string |                                                                                                 Returns all changed files i.e. <br>*a combination of all added, copied, modified, renamed and deleted files (ACMRD)*.                                                                                                   |
+|                            <a name="output_all_modified_files"></a>[all\_modified\_files](#output_all_modified_files)                            | string |                                                                                              Returns all changed files i.e. <br>a combination of all added, <br>copied, modified, renamed and deleted <br>files (ACMRD).                                                                                                |
 |                   <a name="output_all_modified_files_count"></a>[all\_modified\_files\_count](#output_all_modified_files_count)                   | string |                                                                                                                                       Returns the number of `all_modified_files`                                                                                                                                        |
 |                 <a name="output_all_old_new_renamed_files"></a>[all\_old\_new\_renamed\_files](#output_all_old_new_renamed_files)                  | string | Returns only files that are <br>Renamed and lists their old <br>and new names. **NOTE:** This <br>requires setting `include_all_old_new_renamed_files` to `true`. <br>Also, keep in mind that <br>this output is global and <br>wouldn't be nested in outputs <br>generated when the `*_yaml_*` input <br>is used. (R)  |
 |        <a name="output_all_old_new_renamed_files_count"></a>[all\_old\_new\_renamed\_files\_count](#output_all_old_new_renamed_files_count)         | string |                                                                                                                                    Returns the number of `all_old_new_renamed_files`                                                                                                                                    |
-|                                      <a name="output_any_changed"></a>[any\_changed](#output_any_changed)                                       | string |                                                     Returns `true` when any of <br>the filenames provided using the <br>`files*` or `files_ignore*` inputs has changed. i.e. <br>*includes a combination of all added, copied, modified and renamed files (ACMR)*.                                                      |
-|                                      <a name="output_any_deleted"></a>[any\_deleted](#output_any_deleted)                                       | string |                                                                                            Returns `true` when any of <br>the filenames provided using the <br>`files*` or `files_ignore*` inputs has been deleted. <br>(D)                                                                                             |
-|                                     <a name="output_any_modified"></a>[any\_modified](#output_any_modified)                                     | string |                                            Returns `true` when any of <br>the filenames provided using the <br>`files*` or `files_ignore*` inputs has been modified. <br>i.e. *includes a combination of all added, copied, modified, renamed, and deleted files (ACMRD)*.                                              |
-|                                     <a name="output_changed_keys"></a>[changed\_keys](#output_changed_keys)                                     | string |                                                                     Returns all changed YAML keys <br>when the `files_yaml` input is <br>used. i.e. *key that contains any path that has either been added, copied, modified, and renamed (ACMR)*                                                                       |
+|                                      <a name="output_any_changed"></a>[any\_changed](#output_any_changed)                                       | string |                      Returns `true` when any of <br>the filenames provided using the <br>`files*` or `files_ignore*` inputs have changed. This <br>defaults to `true` when no <br>patterns are specified. i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*.                        |
+|                                      <a name="output_any_deleted"></a>[any\_deleted](#output_any_deleted)                                       | string |                                                             Returns `true` when any of <br>the filenames provided using the <br>`files*` or `files_ignore*` inputs have been deleted. <br>This defaults to `true` when <br>no patterns are specified. (D)                                                               |
+|                                     <a name="output_any_modified"></a>[any\_modified](#output_any_modified)                                     | string |            Returns `true` when any of <br>the filenames provided using the <br>`files*` or `files_ignore*` inputs have been modified. <br>This defaults to `true` when <br>no patterns are specified. i.e. <br>*includes a combination of all added, copied, modified, renamed, and deleted files (ACMRD)*.             |
+|                                     <a name="output_changed_keys"></a>[changed\_keys](#output_changed_keys)                                     | string |                                                                Returns all changed YAML keys <br>when the `files_yaml` input is <br>used. i.e. key that contains <br>any path that has either <br>been added, copied, modified, and <br>renamed (ACMR)                                                                  |
 |                                     <a name="output_copied_files"></a>[copied\_files](#output_copied_files)                                     | string |                                                                                                                                      Returns only files that are <br>Copied (C).                                                                                                                                        |
 |                            <a name="output_copied_files_count"></a>[copied\_files\_count](#output_copied_files_count)                            | string |                                                                                                                                          Returns the number of `copied_files`                                                                                                                                           |
 |                                   <a name="output_deleted_files"></a>[deleted\_files](#output_deleted_files)                                    | string |                                                                                                                                      Returns only files that are <br>Deleted (D).                                                                                                                                       |
 |                          <a name="output_deleted_files_count"></a>[deleted\_files\_count](#output_deleted_files_count)                           | string |                                                                                                                                          Returns the number of `deleted_files`                                                                                                                                          |
 |                                  <a name="output_modified_files"></a>[modified\_files](#output_modified_files)                                  | string |                                                                                                                                     Returns only files that are <br>Modified (M).                                                                                                                                       |
 |                         <a name="output_modified_files_count"></a>[modified\_files\_count](#output_modified_files_count)                         | string |                                                                                                                                         Returns the number of `modified_files`                                                                                                                                          |
-|                                   <a name="output_modified_keys"></a>[modified\_keys](#output_modified_keys)                                    | string |                                                                    Returns all modified YAML keys <br>when the `files_yaml` input is <br>used. i.e. *key that contains any path that has either been added, copied, modified, and deleted (ACMRD)*                                                                      |
-|                                     <a name="output_only_changed"></a>[only\_changed](#output_only_changed)                                     | string |                                                            Returns `true` when only files <br>provided using the `files*` or `files_ignore*` inputs <br>has changed. i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*.                                                             |
-|                                     <a name="output_only_deleted"></a>[only\_deleted](#output_only_deleted)                                     | string |                                                                                                   Returns `true` when only files <br>provided using the `files*` or `files_ignore*` inputs <br>has been deleted. (D)                                                                                                    |
-|                                   <a name="output_only_modified"></a>[only\_modified](#output_only_modified)                                    | string |                                                                                                Returns `true` when only files <br>provided using the `files*` or `files_ignore*` inputs <br>has been modified. (ACMRD).                                                                                                 |
-|                          <a name="output_other_changed_files"></a>[other\_changed\_files](#output_other_changed_files)                           | string |                                                                              Returns all other changed files <br>not listed in the files <br>input i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*.                                                                               |
+|                                   <a name="output_modified_keys"></a>[modified\_keys](#output_modified_keys)                                    | string |                                                               Returns all modified YAML keys <br>when the `files_yaml` input is <br>used. i.e. key that contains <br>any path that has either <br>been added, copied, modified, and <br>deleted (ACMRD)                                                                 |
+|                                     <a name="output_only_changed"></a>[only\_changed](#output_only_changed)                                     | string |                                                           Returns `true` when only files <br>provided using the `files*` or `files_ignore*` inputs <br>have changed. i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*.                                                             |
+|                                     <a name="output_only_deleted"></a>[only\_deleted](#output_only_deleted)                                     | string |                                                                                                  Returns `true` when only files <br>provided using the `files*` or `files_ignore*` inputs <br>have been deleted. (D)                                                                                                    |
+|                                   <a name="output_only_modified"></a>[only\_modified](#output_only_modified)                                    | string |                                                                                               Returns `true` when only files <br>provided using the `files*` or `files_ignore*` inputs <br>have been modified. (ACMRD).                                                                                                 |
+|                          <a name="output_other_changed_files"></a>[other\_changed\_files](#output_other_changed_files)                           | string |                                                                           Returns all other changed files <br>not listed in the files <br>input i.e. includes a combination <br>of all added, copied, modified <br>and renamed files (ACMR).                                                                            |
 |                 <a name="output_other_changed_files_count"></a>[other\_changed\_files\_count](#output_other_changed_files_count)                  | string |                                                                                                                                       Returns the number of `other_changed_files`                                                                                                                                       |
-|                          <a name="output_other_deleted_files"></a>[other\_deleted\_files](#output_other_deleted_files)                           | string |                                                                                                  Returns all other deleted files <br>not listed in the files <br>input i.e. *a  combination of all deleted files (D)*                                                                                                   |
+|                          <a name="output_other_deleted_files"></a>[other\_deleted\_files](#output_other_deleted_files)                           | string |                                                                                                 Returns all other deleted files <br>not listed in the files <br>input i.e. a combination of <br>all deleted files (D)                                                                                                   |
 |                 <a name="output_other_deleted_files_count"></a>[other\_deleted\_files\_count](#output_other_deleted_files_count)                  | string |                                                                                                                                       Returns the number of `other_deleted_files`                                                                                                                                       |
-|                         <a name="output_other_modified_files"></a>[other\_modified\_files](#output_other_modified_files)                         | string |                                                                                 Returns all other modified files <br>not listed in the files <br>input i.e. *a combination of all added, copied, modified, and deleted files (ACMRD)*                                                                                   |
+|                         <a name="output_other_modified_files"></a>[other\_modified\_files](#output_other_modified_files)                         | string |                                                                              Returns all other modified files <br>not listed in the files <br>input i.e. a combination of <br>all added, copied, modified, and <br>deleted files (ACMRD)                                                                                |
 |                <a name="output_other_modified_files_count"></a>[other\_modified\_files\_count](#output_other_modified_files_count)                | string |                                                                                                                                      Returns the number of `other_modified_files`                                                                                                                                       |
 |                                   <a name="output_renamed_files"></a>[renamed\_files](#output_renamed_files)                                    | string |                                                                                                                                      Returns only files that are <br>Renamed (R).                                                                                                                                       |
 |                          <a name="output_renamed_files_count"></a>[renamed\_files\_count](#output_renamed_files_count)                           | string |                                                                                                                                          Returns the number of `renamed_files`                                                                                                                                          |
@@ -707,7 +732,7 @@ The format of the version string is as follows:
 ...
    - name: Get changed files
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
 ...
 ```

@@ -720,7 +745,7 @@ The format of the version string is as follows:
 ...
    - name: Get changed files
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        safe_output: false # set to false because we are using an environment variable to store the output and avoid command injection.

@@ -728,7 +753,7 @@ The format of the version string is as follows:
      env:
        ADDED_FILES: ${{ steps.changed-files.outputs.added_files }}
      run: |
-        for file in "$ADDED_FILES"; do
+        for file in ${ADDED_FILES}; do
          echo "$file was added"
        done
 ...
@@ -743,7 +768,7 @@ The format of the version string is as follows:
 ...
    - name: Get all changed files and use a comma separator in the output
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        separator: ","
 ...
@@ -760,13 +785,13 @@ See [inputs](#inputs) for more information.
 ...
    - name: Get changed files
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44

    - name: List all added files
      env:
        ADDED_FILES: ${{ steps.changed-files.outputs.added_files }}
      run: |
-        for file in "$ADDED_FILES"; do
+        for file in ${ADDED_FILES}; do
          echo "$file was added"
        done
 ...
@@ -783,7 +808,7 @@ See [outputs](#outputs) for a list of all available outputs.
 ...
    - name: Get changed files
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44

    - name: Run a step if my-file.txt was modified
      if: contains(steps.changed-files.outputs.modified_files, 'my-file.txt')
@@ -804,7 +829,7 @@ See [outputs](#outputs) for a list of all available outputs.

   - name: Get changed files and write the outputs to a Txt file
     id: changed-files-write-output-files-txt
-     uses: tj-actions/changed-files@v41
+     uses: tj-actions/changed-files@v44
     with:
       write_output_files: true

@@ -823,7 +848,7 @@ See [outputs](#outputs) for a list of all available outputs.
 ...
   - name: Get changed files and write the outputs to a JSON file
     id: changed-files-write-output-files-json
-     uses: tj-actions/changed-files@v41
+     uses: tj-actions/changed-files@v44
     with:
       json: true
       write_output_files: true
@@ -843,7 +868,7 @@ See [outputs](#outputs) for a list of all available outputs.
 ...
    - name: Get changed files
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        files: |
          my-file.txt
@@ -866,7 +891,7 @@ See [inputs](#inputs) for more information.
 ...
    - name: Get changed files
      id: changed-files-specific
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        files: |
          my-file.txt
@@ -891,7 +916,7 @@ See [inputs](#inputs) for more information.
      env:
        DELETED_FILES: ${{ steps.changed-files-specific.outputs.deleted_files }}
      run: |
-        for file in "$DELETED_FILES"; do
+        for file in ${DELETED_FILES}; do
          echo "$file was deleted"
        done

@@ -900,7 +925,7 @@ See [inputs](#inputs) for more information.
      env:
        DELETED_FILES: ${{ steps.changed-files-specific.outputs.deleted_files }}
      run: |
-        for file in "$DELETED_FILES"; do
+        for file in ${DELETED_FILES}; do
          echo "$file was deleted"
        done
 ...
@@ -917,7 +942,7 @@ See [outputs](#outputs) for a list of all available outputs.
 ...
    - name: Get changed files using a source file or list of file(s) to populate to files input.
      id: changed-files-specific-source-file
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        files_from_source_file: test/changed-files-list.txt
 ...
@@ -934,7 +959,7 @@ See [inputs](#inputs) for more information.
 ...
    - name: Get changed files using a source file or list of file(s) to populate to files input and optionally specify more files.
      id: changed-files-specific-source-file-and-specify-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        files_from_source_file: |
          test/changed-files-list.txt
@@ -955,7 +980,7 @@ See [inputs](#inputs) for more information.
 ...
    - name: Get changed files using a different SHA
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        sha: ${{ github.event.pull_request.head.sha }}
 ...
@@ -972,7 +997,7 @@ See [inputs](#inputs) for more information.
 ...
    - name: Get changed files using a different base SHA
      id: changed-files
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        base_sha: ${{ github.event.pull_request.base.sha }}
 ...
@@ -1004,13 +1029,18 @@ jobs:

      - name: Get changed files
        id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
+
+      - name: List changed files
+        env:
+          ALL_CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
+        run: |
+          echo "List all the files that have changed: $ALL_CHANGED_FILES"

      - name: Get changed files in the .github folder
        id: changed-files-specific
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
        with:
-          base_sha: ${{ steps.get-base-sha.outputs.base_sha }}
          files: .github/**

      - name: Run step if any file(s) in the .github folder change
@@ -1040,16 +1070,15 @@ See [inputs](#inputs) for more information.

    - name: Run changed-files with defaults in dir1
      id: changed-files-for-dir1
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        path: dir1

    - name: List all added files in dir1
      env:
-        ADDED_FILES: |-
-          ${{ steps.changed-files-for-dir1.outputs.added_files }}
+        ADDED_FILES: ${{ steps.changed-files-for-dir1.outputs.added_files }}
      run: |
-        for file in "$ADDED_FILES"; do
+        for file in ${ADDED_FILES}; do
          echo "$file was added"
        done
 ...
@@ -1066,13 +1095,13 @@ See [inputs](#inputs) for more information.
 ...
    - name: Run changed-files with quotepath disabled
      id: changed-files-quotepath
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        quotepath: "false"

    - name: Run changed-files with quotepath disabled for a specified list of file(s)
      id: changed-files-quotepath-specific
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        files: test/test-è.txt
        quotepath: "false"
@@ -1105,7 +1134,7 @@ See [inputs](#inputs) for more information.

      - name: Run changed-files with the commit of the last successful test workflow run
        id: changed-files-base-sha-push
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
        with:
          base_sha: ${{ steps.last_successful_commit_push.outputs.base }}
 ...
@@ -1132,7 +1161,7 @@ See [inputs](#inputs) for more information.

      - name: Run changed-files with the commit of the last successful test workflow run on the main branch
        id: changed-files-base-sha-pull-request
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v44
        with:
          base_sha: ${{ steps.last_successful_commit_pull_request.outputs.base }}
 ...
@@ -1158,7 +1187,7 @@ See [inputs](#inputs) for more information.
 ...
    - name: Run changed-files with dir_names
      id: changed-files-dir-names
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        dir_names: "true"
 ...
@@ -1175,7 +1204,7 @@ See [inputs](#inputs) for more information.
 ...
    - name: Run changed-files with JSON output
      id: changed-files-json
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        json: "true"
 ...
@@ -1192,13 +1221,13 @@ See [inputs](#inputs) for more information.
 ...
    - name: Get changed-files since 2022-08-19
      id: changed-files-since
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        since: "2022-08-19"

    - name: Get changed-files until 2022-08-20
      id: changed-files-until
-      uses: tj-actions/changed-files@v41
+      uses: tj-actions/changed-files@v44
      with:
        until: "2022-08-20"
 ...
@@ -1218,7 +1247,7 @@ See [inputs](#inputs) for more information.

 *   [coder/code-server: uses tj-actions/changed-files to automate detecting changes and run steps based on the outcome](https://github.com/coder/code-server/blob/c32a31d802f679846876b8ad9aacff6cf7b5361d/.github/workflows/build.yaml#L48)

-*   [tldr-pages/tldr: uses tj-actions/changed-files to automate detecting spelling errors](https://github.com/tldr-pages/tldr/blob/main/.github/workflows/codespell.yml#L14)
+*   [tldr-pages/tldr: uses tj-actions/changed-files to automate detecting spelling errors](https://github.com/tldr-pages/tldr/blob/c1b714c55cb0048037b79a681a10d7f3ddb0164c/.github/workflows/codespell.yml#L18-L26)

 *   [nodejs/docker-node: uses tj-actions/changed-files to generate matrix jobs based on changes detected](https://github.com/nodejs/docker-node/blob/3c4fa6daf06a4786d202f2f610351837806a0380/.github/workflows/build-test.yml#L29)

@@ -1226,10 +1255,14 @@ See [inputs](#inputs) for more information.

 *   [aws-doc-sdk-examples: uses tj-actions/changed-files to automate testing](https://github.com/awsdocs/aws-doc-sdk-examples/blob/2393723ef6b0cad9502f4852f5c72f7be58ca89d/.github/workflows/javascript.yml#L22)

-*   [nhost: uses tj-actions/changed-files to automate testing based on changes detected](https://github.com/nhost/nhost/blob/main/.github/workflows/ci.yaml#L44-L48)
+*   [nhost: uses tj-actions/changed-files to automate testing based on changes detected](https://github.com/nhost/nhost/blob/71a8ce444618a8ac4d660518172fba4883c4014b/.github/workflows/ci.yaml#L44-L48)

 *   [qmk\_firmware uses tj-actions/changed-files to run linters](https://github.com/qmk/qmk_firmware/blob/7a737235ffd49c32d2c5561e8fe53fd96baa7f96/.github/workflows/lint.yml#L30)

+*   [argo-cd uses tj-actions/changed-files to detect changed frontend or backend files](https://github.com/argoproj/argo-cd/blob/5bc1850aa1d26301043be9f2fb825d88c80c111c/.github/workflows/ci-build.yaml#L33)
+
+*   [argo-workflows uses tj-actions/changed-files to run specific jobs based on changes detected](https://github.com/argoproj/argo-workflows/blob/baef4856ff2603c76dbe277c825eaa3f9788fc91/.github/workflows/ci-build.yaml#L34)
+
 And many more...

 ### Scalability Example 📈
@@ -1283,7 +1316,7 @@ Report bugs at https://github.com/tj-actions/changed-files/issues.
 If you are reporting a bug, please include:

 *   Your operating system name and version.
-*   Any details about your workflow that might be helpful in troubleshooting. (**NOTE**: Ensure that you include full log outputs with debugging enabled)
+*   All essential details about your workflow that might be helpful in troubleshooting. (**NOTE**: Ensure that you include full log outputs with debugging enabled)
 *   Detailed steps to reproduce the bug.

 ## Contributors ✨
@@ -1327,6 +1360,10 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/rodrigorfk"><img src="https://avatars.githubusercontent.com/u/1995033?v=4?s=100" width="100px;" alt="Rodrigo Fior Kuntzer"/><br /><sub><b>Rodrigo Fior Kuntzer</b></sub></a><br /><a href="https://github.com/tj-actions/changed-files/commits?author=rodrigorfk" title="Code">💻</a> <a href="https://github.com/tj-actions/changed-files/commits?author=rodrigorfk" title="Tests">⚠️</a> <a href="https://github.com/tj-actions/changed-files/issues?q=author%3Arodrigorfk" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/levenleven"><img src="https://avatars.githubusercontent.com/u/6463364?v=4?s=100" width="100px;" alt="Aleksey Levenstein"/><br /><sub><b>Aleksey Levenstein</b></sub></a><br /><a href="https://github.com/tj-actions/changed-files/commits?author=levenleven" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/dan-hill2802"><img src="https://avatars.githubusercontent.com/u/5046322?v=4?s=100" width="100px;" alt="Daniel Hill"/><br /><sub><b>Daniel Hill</b></sub></a><br /><a href="https://github.com/tj-actions/changed-files/commits?author=dan-hill2802" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://keisukeyamashita.com"><img src="https://avatars.githubusercontent.com/u/23056537?v=4?s=100" width="100px;" alt="KeisukeYamashita"/><br /><sub><b>KeisukeYamashita</b></sub></a><br /><a href="https://github.com/tj-actions/changed-files/commits?author=KeisukeYamashita" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/codesculpture"><img src="https://avatars.githubusercontent.com/u/63452117?v=4?s=100" width="100px;" alt="Aravind"/><br /><sub><b>Aravind</b></sub></a><br /><a href="https://github.com/tj-actions/changed-files/commits?author=codesculpture" title="Code">💻</a> <a href="https://github.com/tj-actions/changed-files/issues?q=author%3Acodesculpture" title="Bug reports">🐛</a></td>
    </tr>
  </tbody>
 </table>
--- a/action.yml
+++ b/action.yml
@@ -127,7 +127,7 @@ inputs:
    required: false
    default: "false"
  json:
-    description: "Output list of changed files in a JSON formatted string which can be used for matrix jobs. Example: https://github.com/tj-actions/changed-files/blob/main/.github/workflows/matrix-test.yml"
+    description: "Output list of changed files in a JSON formatted string which can be used for matrix jobs. Example: https://github.com/tj-actions/changed-files/blob/main/.github/workflows/matrix-example.yml"
    required: false
    default: "false"
  escape_json:
@@ -144,8 +144,8 @@ inputs:
    default: "50"
  skip_initial_fetch:
    description: |
-      Skip the initial fetch to improve performance for shallow repositories. 
-      NOTE: This could lead to errors with missing history and the intended use is limited to when you've fetched the history necessary to perform the diff.
+      Skip initially fetching additional history to improve performance for shallow repositories.
+      NOTE: This could lead to errors with missing history. It's intended to be used when you've fetched all necessary history to perform the diff.
    required: false
    default: "false"
  fetch_additional_submodule_history:
@@ -219,6 +219,22 @@ inputs:
    description: "Apply the negation patterns first. NOTE: This affects how changed files are matched."
    required: false
    default: "false"
+  matrix:
+    description: "Output changed files in a format that can be used for matrix jobs. Alias for setting inputs `json` to `true` and `escape_json` to `false`."
+    required: false
+    default: "false"
+  exclude_submodules:
+    description: "Exclude changes to submodules."
+    required: false
+    default: "false"
+  fetch_missing_history_max_retries:
+    description: "Maximum number of retries to fetch missing history."
+    required: false
+    default: "10"
+  use_posix_path_separator:
+    description: "Use POSIX path separator `/` for output filenames."
+    required: false
+    default: "false"

 outputs:
  added_files:
@@ -258,45 +274,45 @@ outputs:
  unknown_files_count:
    description: "Returns the number of `unknown_files`"
  all_changed_and_modified_files:
-    description: "Returns all changed and modified files i.e. *a combination of (ACMRDTUX)*"
+    description: "Returns all changed and modified files i.e. a combination of (ACMRDTUX)"
  all_changed_and_modified_files_count:
    description: "Returns the number of `all_changed_and_modified_files`"
  all_changed_files:
-    description: "Returns all changed files i.e. *a combination of all added, copied, modified and renamed files (ACMR)*"
+    description: "Returns all changed files i.e. a combination of all added, copied, modified and renamed files (ACMR)"
  all_changed_files_count:
    description: "Returns the number of `all_changed_files`"
  any_changed:
-    description: "Returns `true` when any of the filenames provided using the `files*` or `files_ignore*` inputs has changed. i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*."
+    description: "Returns `true` when any of the filenames provided using the `files*` or `files_ignore*` inputs have changed. This defaults to `true` when no patterns are specified. i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*."
  only_changed:
-    description: "Returns `true` when only files provided using the `files*` or `files_ignore*` inputs has changed. i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*."
+    description: "Returns `true` when only files provided using the `files*` or `files_ignore*` inputs have changed. i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*."
  other_changed_files:
-    description: "Returns all other changed files not listed in the files input i.e. *includes a combination of all added, copied, modified and renamed files (ACMR)*."
+    description: "Returns all other changed files not listed in the files input i.e. includes a combination of all added, copied, modified and renamed files (ACMR)."
  other_changed_files_count:
    description: "Returns the number of `other_changed_files`"
  all_modified_files:
-    description: "Returns all changed files i.e. *a combination of all added, copied, modified, renamed and deleted files (ACMRD)*."
+    description: "Returns all changed files i.e. a combination of all added, copied, modified, renamed and deleted files (ACMRD)."
  all_modified_files_count:
    description: "Returns the number of `all_modified_files`"
  any_modified:
-    description: "Returns `true` when any of the filenames provided using the `files*` or `files_ignore*` inputs has been modified. i.e. *includes a combination of all added, copied, modified, renamed, and deleted files (ACMRD)*."
+    description: "Returns `true` when any of the filenames provided using the `files*` or `files_ignore*` inputs have been modified. This defaults to `true` when no patterns are specified. i.e. *includes a combination of all added, copied, modified, renamed, and deleted files (ACMRD)*."
  only_modified:
-    description: "Returns `true` when only files provided using the `files*` or `files_ignore*` inputs has been modified. (ACMRD)."
+    description: "Returns `true` when only files provided using the `files*` or `files_ignore*` inputs have been modified. (ACMRD)."
  other_modified_files:
-    description: "Returns all other modified files not listed in the files input i.e. *a combination of all added, copied, modified, and deleted files (ACMRD)*"
+    description: "Returns all other modified files not listed in the files input i.e. a combination of all added, copied, modified, and deleted files (ACMRD)"
  other_modified_files_count:
    description: "Returns the number of `other_modified_files`"
  any_deleted:
-    description: "Returns `true` when any of the filenames provided using the `files*` or `files_ignore*` inputs has been deleted. (D)"
+    description: "Returns `true` when any of the filenames provided using the `files*` or `files_ignore*` inputs have been deleted. This defaults to `true` when no patterns are specified. (D)"
  only_deleted:
-    description: "Returns `true` when only files provided using the `files*` or `files_ignore*` inputs has been deleted. (D)"
+    description: "Returns `true` when only files provided using the `files*` or `files_ignore*` inputs have been deleted. (D)"
  other_deleted_files:
-    description: "Returns all other deleted files not listed in the files input i.e. *a  combination of all deleted files (D)*"
+    description: "Returns all other deleted files not listed in the files input i.e. a combination of all deleted files (D)"
  other_deleted_files_count:
    description: "Returns the number of `other_deleted_files`"
  modified_keys:
-    description: "Returns all modified YAML keys when the `files_yaml` input is used. i.e. *key that contains any path that has either been added, copied, modified, and deleted (ACMRD)*"
+    description: "Returns all modified YAML keys when the `files_yaml` input is used. i.e. key that contains any path that has either been added, copied, modified, and deleted (ACMRD)"
  changed_keys:
-    description: "Returns all changed YAML keys when the `files_yaml` input is used. i.e. *key that contains any path that has either been added, copied, modified, and renamed (ACMR)*"
+    description: "Returns all changed YAML keys when the `files_yaml` input is used. i.e. key that contains any path that has either been added, copied, modified, and renamed (ACMR)"

 runs:
  using: 'node20'
--- a/dist/index.js
+++ b/dist/index.js
--- a/dist/index.js.map
+++ b/dist/index.js.map
--- a/dist/licenses.txt
+++ b/dist/licenses.txt
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@tj-actions/changed-files",
-  "version": "41.1.2",
+  "version": "44.2.0",
  "description": "Github action to retrieve all (added, copied, modified, deleted, renamed, type changed, unmerged, unknown) files and directories.",
  "main": "lib/main.js",
  "publishConfig": {
@@ -14,6 +14,7 @@
    "lint:fix": "eslint --fix src/*.ts src/**/*.ts",
    "package": "ncc build lib/main.js --source-map --license licenses.txt",
    "test": "jest --coverage",
+    "update-snapshot": "jest -u",
    "all": "yarn build && yarn format && yarn lint && yarn package && yarn test"
  },
  "repository": {
@@ -36,6 +37,7 @@
    "@actions/exec": "^1.1.1",
    "@actions/github": "^6.0.0",
    "@octokit/rest": "^20.0.1",
+    "@stdlib/utils-convert-path": "^0.2.1",
    "lodash": "^4.17.21",
    "micromatch": "^4.0.5",
    "yaml": "^2.3.1"
@@ -46,14 +48,14 @@
    "@types/micromatch": "^4.0.2",
    "@types/node": "^20.3.2",
    "@types/uuid": "^9.0.2",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
    "@vercel/ncc": "^0.38.0",
    "eslint": "^8.43.0",
-    "eslint-plugin-github": "^4.8.0",
-    "eslint-plugin-jest": "^27.2.2",
-    "eslint-plugin-prettier": "^5.0.0-alpha.2",
    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-github": "^4.8.0",
+    "eslint-plugin-jest": "^28.0.0",
+    "eslint-plugin-prettier": "^5.0.0-alpha.2",
    "jest": "^29.5.0",
    "prettier": "^3.0.0",
    "ts-jest": "^29.1.0",
--- a/src/tests/snapshots/inputs.test.ts.snap
+++ b/src/tests/snapshots/inputs.test.ts.snap
@@ -0,0 +1,361 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`getInputs should correctly parse boolean inputs 1`] = `
+{
+  "apiUrl": "",
+  "baseSha": "",
+  "diffRelative": "false",
+  "dirNames": "false",
+  "dirNamesDeletedFilesIncludeOnlyDeletedDirs": "false",
+  "dirNamesExcludeCurrentDir": "false",
+  "dirNamesIncludeFiles": "",
+  "dirNamesIncludeFilesSeparator": "",
+  "escapeJson": false,
+  "excludeSubmodules": "false",
+  "failOnInitialDiffError": "false",
+  "failOnSubmoduleDiffError": "false",
+  "fetchAdditionalSubmoduleHistory": "false",
+  "fetchMissingHistoryMaxRetries": 10,
+  "files": "",
+  "filesFromSourceFile": "",
+  "filesFromSourceFileSeparator": "",
+  "filesIgnore": "",
+  "filesIgnoreFromSourceFile": "",
+  "filesIgnoreFromSourceFileSeparator": "",
+  "filesIgnoreSeparator": "",
+  "filesIgnoreYaml": "",
+  "filesIgnoreYamlFromSourceFile": "",
+  "filesIgnoreYamlFromSourceFileSeparator": "",
+  "filesSeparator": "",
+  "filesYaml": "",
+  "filesYamlFromSourceFile": "",
+  "filesYamlFromSourceFileSeparator": "",
+  "includeAllOldNewRenamedFiles": "false",
+  "json": true,
+  "negationPatternsFirst": "false",
+  "oldNewFilesSeparator": " ",
+  "oldNewSeparator": ",",
+  "outputDir": "",
+  "outputRenamedFilesAsDeletedAndAdded": "false",
+  "path": ".",
+  "quotepath": "false",
+  "recoverDeletedFiles": "false",
+  "recoverDeletedFilesToDestination": "",
+  "recoverFiles": "",
+  "recoverFilesIgnore": "",
+  "recoverFilesIgnoreSeparator": "
+",
+  "recoverFilesSeparator": "
+",
+  "safeOutput": "false",
+  "separator": "",
+  "sha": "",
+  "since": "",
+  "sinceLastRemoteCommit": "false",
+  "skipInitialFetch": "true",
+  "token": "",
+  "until": "",
+  "usePosixPathSeparator": "false",
+  "useRestApi": "false",
+  "writeOutputFiles": "false",
+}
+`;
+
+exports[`getInputs should correctly parse numeric inputs 1`] = `
+{
+  "apiUrl": "",
+  "baseSha": "",
+  "diffRelative": true,
+  "dirNames": false,
+  "dirNamesDeletedFilesIncludeOnlyDeletedDirs": false,
+  "dirNamesExcludeCurrentDir": false,
+  "dirNamesIncludeFiles": "",
+  "dirNamesIncludeFilesSeparator": "",
+  "dirNamesMaxDepth": 2,
+  "escapeJson": false,
+  "excludeSubmodules": false,
+  "failOnInitialDiffError": false,
+  "failOnSubmoduleDiffError": false,
+  "fetchAdditionalSubmoduleHistory": false,
+  "fetchDepth": 5,
+  "files": "",
+  "filesFromSourceFile": "",
+  "filesFromSourceFileSeparator": "",
+  "filesIgnore": "",
+  "filesIgnoreFromSourceFile": "",
+  "filesIgnoreFromSourceFileSeparator": "",
+  "filesIgnoreSeparator": "",
+  "filesIgnoreYaml": "",
+  "filesIgnoreYamlFromSourceFile": "",
+  "filesIgnoreYamlFromSourceFileSeparator": "",
+  "filesSeparator": "",
+  "filesYaml": "",
+  "filesYamlFromSourceFile": "",
+  "filesYamlFromSourceFileSeparator": "",
+  "includeAllOldNewRenamedFiles": false,
+  "json": false,
+  "negationPatternsFirst": false,
+  "oldNewFilesSeparator": "",
+  "oldNewSeparator": "",
+  "outputDir": "",
+  "outputRenamedFilesAsDeletedAndAdded": false,
+  "path": "",
+  "quotepath": true,
+  "recoverDeletedFiles": false,
+  "recoverDeletedFilesToDestination": "",
+  "recoverFiles": "",
+  "recoverFilesIgnore": "",
+  "recoverFilesIgnoreSeparator": "",
+  "recoverFilesSeparator": "",
+  "safeOutput": false,
+  "separator": "",
+  "sha": "",
+  "since": "",
+  "sinceLastRemoteCommit": false,
+  "skipInitialFetch": false,
+  "token": "",
+  "until": "",
+  "usePosixPathSeparator": false,
+  "useRestApi": false,
+  "writeOutputFiles": false,
+}
+`;
+
+exports[`getInputs should correctly parse string inputs 1`] = `
+{
+  "apiUrl": "https://api.github.com",
+  "baseSha": "",
+  "diffRelative": true,
+  "dirNames": false,
+  "dirNamesDeletedFilesIncludeOnlyDeletedDirs": false,
+  "dirNamesExcludeCurrentDir": false,
+  "dirNamesIncludeFiles": "",
+  "dirNamesIncludeFilesSeparator": "",
+  "escapeJson": false,
+  "excludeSubmodules": false,
+  "failOnInitialDiffError": false,
+  "failOnSubmoduleDiffError": false,
+  "fetchAdditionalSubmoduleHistory": false,
+  "files": "",
+  "filesFromSourceFile": "",
+  "filesFromSourceFileSeparator": "",
+  "filesIgnore": "",
+  "filesIgnoreFromSourceFile": "",
+  "filesIgnoreFromSourceFileSeparator": "",
+  "filesIgnoreSeparator": "",
+  "filesIgnoreYaml": "",
+  "filesIgnoreYamlFromSourceFile": "",
+  "filesIgnoreYamlFromSourceFileSeparator": "",
+  "filesSeparator": "",
+  "filesYaml": "",
+  "filesYamlFromSourceFile": "",
+  "filesYamlFromSourceFileSeparator": "",
+  "includeAllOldNewRenamedFiles": false,
+  "json": false,
+  "negationPatternsFirst": false,
+  "oldNewFilesSeparator": "",
+  "oldNewSeparator": "",
+  "outputDir": "",
+  "outputRenamedFilesAsDeletedAndAdded": false,
+  "path": "",
+  "quotepath": true,
+  "recoverDeletedFiles": false,
+  "recoverDeletedFilesToDestination": "",
+  "recoverFiles": "",
+  "recoverFilesIgnore": "",
+  "recoverFilesIgnoreSeparator": "",
+  "recoverFilesSeparator": "",
+  "safeOutput": false,
+  "separator": "",
+  "sha": "",
+  "since": "",
+  "sinceLastRemoteCommit": false,
+  "skipInitialFetch": false,
+  "token": "token",
+  "until": "",
+  "usePosixPathSeparator": false,
+  "useRestApi": false,
+  "writeOutputFiles": false,
+}
+`;
+
+exports[`getInputs should handle invalid numeric inputs correctly 1`] = `
+{
+  "apiUrl": "",
+  "baseSha": "",
+  "diffRelative": true,
+  "dirNames": false,
+  "dirNamesDeletedFilesIncludeOnlyDeletedDirs": false,
+  "dirNamesExcludeCurrentDir": false,
+  "dirNamesIncludeFiles": "",
+  "dirNamesIncludeFilesSeparator": "",
+  "dirNamesMaxDepth": 2,
+  "escapeJson": false,
+  "excludeSubmodules": false,
+  "failOnInitialDiffError": false,
+  "failOnSubmoduleDiffError": false,
+  "fetchAdditionalSubmoduleHistory": false,
+  "fetchDepth": NaN,
+  "files": "",
+  "filesFromSourceFile": "",
+  "filesFromSourceFileSeparator": "",
+  "filesIgnore": "",
+  "filesIgnoreFromSourceFile": "",
+  "filesIgnoreFromSourceFileSeparator": "",
+  "filesIgnoreSeparator": "",
+  "filesIgnoreYaml": "",
+  "filesIgnoreYamlFromSourceFile": "",
+  "filesIgnoreYamlFromSourceFileSeparator": "",
+  "filesSeparator": "",
+  "filesYaml": "",
+  "filesYamlFromSourceFile": "",
+  "filesYamlFromSourceFileSeparator": "",
+  "includeAllOldNewRenamedFiles": false,
+  "json": false,
+  "negationPatternsFirst": false,
+  "oldNewFilesSeparator": "",
+  "oldNewSeparator": "",
+  "outputDir": "",
+  "outputRenamedFilesAsDeletedAndAdded": false,
+  "path": "",
+  "quotepath": true,
+  "recoverDeletedFiles": false,
+  "recoverDeletedFilesToDestination": "",
+  "recoverFiles": "",
+  "recoverFilesIgnore": "",
+  "recoverFilesIgnoreSeparator": "",
+  "recoverFilesSeparator": "",
+  "safeOutput": false,
+  "separator": "",
+  "sha": "",
+  "since": "",
+  "sinceLastRemoteCommit": false,
+  "skipInitialFetch": false,
+  "token": "",
+  "until": "",
+  "usePosixPathSeparator": false,
+  "useRestApi": false,
+  "writeOutputFiles": false,
+}
+`;
+
+exports[`getInputs should handle negative numeric inputs correctly 1`] = `
+{
+  "apiUrl": "",
+  "baseSha": "",
+  "diffRelative": true,
+  "dirNames": false,
+  "dirNamesDeletedFilesIncludeOnlyDeletedDirs": false,
+  "dirNamesExcludeCurrentDir": false,
+  "dirNamesIncludeFiles": "",
+  "dirNamesIncludeFilesSeparator": "",
+  "dirNamesMaxDepth": -2,
+  "escapeJson": false,
+  "excludeSubmodules": false,
+  "failOnInitialDiffError": false,
+  "failOnSubmoduleDiffError": false,
+  "fetchAdditionalSubmoduleHistory": false,
+  "fetchDepth": 2,
+  "files": "",
+  "filesFromSourceFile": "",
+  "filesFromSourceFileSeparator": "",
+  "filesIgnore": "",
+  "filesIgnoreFromSourceFile": "",
+  "filesIgnoreFromSourceFileSeparator": "",
+  "filesIgnoreSeparator": "",
+  "filesIgnoreYaml": "",
+  "filesIgnoreYamlFromSourceFile": "",
+  "filesIgnoreYamlFromSourceFileSeparator": "",
+  "filesSeparator": "",
+  "filesYaml": "",
+  "filesYamlFromSourceFile": "",
+  "filesYamlFromSourceFileSeparator": "",
+  "includeAllOldNewRenamedFiles": false,
+  "json": false,
+  "negationPatternsFirst": false,
+  "oldNewFilesSeparator": "",
+  "oldNewSeparator": "",
+  "outputDir": "",
+  "outputRenamedFilesAsDeletedAndAdded": false,
+  "path": "",
+  "quotepath": true,
+  "recoverDeletedFiles": false,
+  "recoverDeletedFilesToDestination": "",
+  "recoverFiles": "",
+  "recoverFilesIgnore": "",
+  "recoverFilesIgnoreSeparator": "",
+  "recoverFilesSeparator": "",
+  "safeOutput": false,
+  "separator": "",
+  "sha": "",
+  "since": "",
+  "sinceLastRemoteCommit": false,
+  "skipInitialFetch": false,
+  "token": "",
+  "until": "",
+  "usePosixPathSeparator": false,
+  "useRestApi": false,
+  "writeOutputFiles": false,
+}
+`;
+
+exports[`getInputs should return default values when no inputs are provided 1`] = `
+{
+  "apiUrl": "",
+  "baseSha": "",
+  "diffRelative": true,
+  "dirNames": false,
+  "dirNamesDeletedFilesIncludeOnlyDeletedDirs": false,
+  "dirNamesExcludeCurrentDir": false,
+  "dirNamesIncludeFiles": "",
+  "dirNamesIncludeFilesSeparator": "",
+  "escapeJson": false,
+  "excludeSubmodules": false,
+  "failOnInitialDiffError": false,
+  "failOnSubmoduleDiffError": false,
+  "fetchAdditionalSubmoduleHistory": false,
+  "fetchMissingHistoryMaxRetries": 10,
+  "files": "",
+  "filesFromSourceFile": "",
+  "filesFromSourceFileSeparator": "",
+  "filesIgnore": "",
+  "filesIgnoreFromSourceFile": "",
+  "filesIgnoreFromSourceFileSeparator": "",
+  "filesIgnoreSeparator": "",
+  "filesIgnoreYaml": "",
+  "filesIgnoreYamlFromSourceFile": "",
+  "filesIgnoreYamlFromSourceFileSeparator": "",
+  "filesSeparator": "",
+  "filesYaml": "",
+  "filesYamlFromSourceFile": "",
+  "filesYamlFromSourceFileSeparator": "",
+  "includeAllOldNewRenamedFiles": false,
+  "json": false,
+  "negationPatternsFirst": false,
+  "oldNewFilesSeparator": " ",
+  "oldNewSeparator": ",",
+  "outputDir": "",
+  "outputRenamedFilesAsDeletedAndAdded": false,
+  "path": ".",
+  "quotepath": true,
+  "recoverDeletedFiles": false,
+  "recoverDeletedFilesToDestination": "",
+  "recoverFiles": "",
+  "recoverFilesIgnore": "",
+  "recoverFilesIgnoreSeparator": "
+",
+  "recoverFilesSeparator": "
+",
+  "safeOutput": false,
+  "separator": "",
+  "sha": "",
+  "since": "",
+  "sinceLastRemoteCommit": false,
+  "skipInitialFetch": false,
+  "token": "",
+  "until": "",
+  "usePosixPathSeparator": false,
+  "useRestApi": false,
+  "writeOutputFiles": false,
+}
+`;
--- a/src/tests/inputs.test.ts
+++ b/src/tests/inputs.test.ts
@@ -0,0 +1,153 @@
+import * as core from '@actions/core'
+import {getInputs, Inputs} from '../inputs'
+import {DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS} from '../constant'
+
+jest.mock('@actions/core')
+
+describe('getInputs', () => {
+  afterEach(() => {
+    jest.clearAllMocks()
+  })
+
+  test('should return default values when no inputs are provided', () => {
+    ;(core.getInput as jest.Mock).mockImplementation(name => {
+      const camelCaseName = name.replace(/_([a-z])/g, (g: string[]) => {
+        return g[1].toUpperCase()
+      }) as keyof Inputs
+
+      return (DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS[camelCaseName] ||
+        '') as string
+    })
+    ;(core.getBooleanInput as jest.Mock).mockImplementation(name => {
+      const camelCaseName = name.replace(/_([a-z])/g, (g: string[]) => {
+        return g[1].toUpperCase()
+      }) as keyof Inputs
+
+      return (DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS[camelCaseName] ||
+        false) as boolean
+    })
+    expect(getInputs()).toMatchSnapshot()
+  })
+
+  test('should correctly parse boolean inputs', () => {
+    ;(core.getInput as jest.Mock).mockImplementation(name => {
+      const camelCaseName = name.replace(/_([a-z])/g, (g: string[]) => {
+        return g[1].toUpperCase()
+      }) as keyof Inputs
+
+      return (DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS[camelCaseName] ||
+        '') as string
+    })
+    ;(core.getBooleanInput as jest.Mock).mockImplementation(name => {
+      switch (name) {
+        case 'matrix':
+          return 'true'
+        case 'skip_initial_fetch':
+          return 'true'
+        default:
+          return 'false'
+      }
+    })
+    expect(getInputs()).toMatchSnapshot()
+  })
+
+  test('should handle matrix alias correctly', () => {
+    ;(core.getBooleanInput as jest.Mock).mockImplementation(name => {
+      return name === 'matrix' ? 'true' : 'false'
+    })
+
+    const inputs = getInputs()
+    expect(inputs).toHaveProperty('json', true)
+    expect(inputs).toHaveProperty('escapeJson', false)
+  })
+
+  test('should correctly parse string inputs', () => {
+    ;(core.getInput as jest.Mock).mockImplementation(name => {
+      switch (name) {
+        case 'token':
+          return 'token'
+        case 'api_url':
+          return 'https://api.github.com'
+        default:
+          return ''
+      }
+    })
+    ;(core.getBooleanInput as jest.Mock).mockImplementation(name => {
+      const camelCaseName = name.replace(/_([a-z])/g, (g: string[]) => {
+        return g[1].toUpperCase()
+      }) as keyof Inputs
+
+      return (DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS[camelCaseName] ||
+        false) as boolean
+    })
+    expect(getInputs()).toMatchSnapshot()
+  })
+
+  test('should correctly parse numeric inputs', () => {
+    ;(core.getInput as jest.Mock).mockImplementation(name => {
+      switch (name) {
+        case 'fetch_depth':
+          return '5'
+        case 'dir_names_max_depth':
+          return '2'
+        default:
+          return ''
+      }
+    })
+    ;(core.getBooleanInput as jest.Mock).mockImplementation(name => {
+      const camelCaseName = name.replace(/_([a-z])/g, (g: string[]) => {
+        return g[1].toUpperCase()
+      }) as keyof Inputs
+
+      return (DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS[camelCaseName] ||
+        false) as boolean
+    })
+    expect(getInputs()).toMatchSnapshot()
+  })
+
+  test('should handle invalid numeric inputs correctly', () => {
+    ;(core.getInput as jest.Mock).mockImplementation(name => {
+      // TODO: Add validation for invalid numbers which should result in an error instead of NaN
+      switch (name) {
+        case 'fetch_depth':
+          return 'invalid'
+        case 'dir_names_max_depth':
+          return '2'
+        default:
+          return ''
+      }
+    })
+    ;(core.getBooleanInput as jest.Mock).mockImplementation(name => {
+      const camelCaseName = name.replace(/_([a-z])/g, (g: string[]) => {
+        return g[1].toUpperCase()
+      }) as keyof Inputs
+
+      return (DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS[camelCaseName] ||
+        false) as boolean
+    })
+    expect(getInputs()).toMatchSnapshot()
+  })
+
+  test('should handle negative numeric inputs correctly', () => {
+    ;(core.getInput as jest.Mock).mockImplementation(name => {
+      // TODO: Add validation for negative numbers which should result in an error
+      switch (name) {
+        case 'fetch_depth':
+          return '-5'
+        case 'dir_names_max_depth':
+          return '-2'
+        default:
+          return ''
+      }
+    })
+    ;(core.getBooleanInput as jest.Mock).mockImplementation(name => {
+      const camelCaseName = name.replace(/_([a-z])/g, (g: string[]) => {
+        return g[1].toUpperCase()
+      }) as keyof Inputs
+
+      return (DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS[camelCaseName] ||
+        false) as boolean
+    })
+    expect(getInputs()).toMatchSnapshot()
+  })
+})
--- a/src/tests/utils.test.ts
+++ b/src/tests/utils.test.ts
@@ -635,7 +635,10 @@ describe('utils test', () => {
        failOnInitialDiffError: false,
        failOnSubmoduleDiffError: false,
        negationPatternsFirst: false,
-        useRestApi: false
+        useRestApi: false,
+        excludeSubmodules: false,
+        fetchMissingHistoryMaxRetries: 10,
+        usePosixPathSeparator: false
      }

      const coreWarningSpy = jest.spyOn(core, 'warning')
--- a/src/changedFiles.ts
+++ b/src/changedFiles.ts
@@ -2,6 +2,7 @@ import * as core from '@actions/core'
 import * as github from '@actions/github'
 import type {RestEndpointMethodTypes} from '@octokit/rest'
 import flatten from 'lodash/flatten'
+import convertPath from '@stdlib/utils-convert-path'
 import mm from 'micromatch'
 import * as path from 'path'
 import {setOutputsAndGetModifiedAndChangedFilesStatus} from './changedFilesOutput'
@@ -121,13 +122,13 @@ export const processChangedFiles = async ({
 export const getRenamedFiles = async ({
  inputs,
  workingDirectory,
-  hasSubmodule,
+  diffSubmodule,
  diffResult,
  submodulePaths
 }: {
  inputs: Inputs
  workingDirectory: string
-  hasSubmodule: boolean
+  diffSubmodule: boolean
  diffResult: DiffResult
  submodulePaths: string[]
 }): Promise<{paths: string; count: string}> => {
@@ -139,7 +140,7 @@ export const getRenamedFiles = async ({
    oldNewSeparator: inputs.oldNewSeparator
  })

-  if (hasSubmodule) {
+  if (diffSubmodule) {
    for (const submodulePath of submodulePaths) {
      const submoduleShaResult = await gitSubmoduleDiffSHA({
        cwd: workingDirectory,
@@ -217,7 +218,7 @@ export type ChangedFiles = {

 export const getAllDiffFiles = async ({
  workingDirectory,
-  hasSubmodule,
+  diffSubmodule,
  diffResult,
  submodulePaths,
  outputRenamedFilesAsDeletedAndAdded,
@@ -226,7 +227,7 @@ export const getAllDiffFiles = async ({
  failOnSubmoduleDiffError
 }: {
  workingDirectory: string
-  hasSubmodule: boolean
+  diffSubmodule: boolean
  diffResult: DiffResult
  submodulePaths: string[]
  outputRenamedFilesAsDeletedAndAdded: boolean
@@ -243,7 +244,7 @@ export const getAllDiffFiles = async ({
    failOnInitialDiffError
  })

-  if (hasSubmodule) {
+  if (diffSubmodule) {
    for (const submodulePath of submodulePaths) {
      const submoduleShaResult = await gitSubmoduleDiffSHA({
        cwd: workingDirectory,
@@ -355,7 +356,11 @@ function* getChangeTypeFilesGenerator({
      filePaths,
      dirNamesIncludeFilePatterns
    })) {
-      yield filePath
+      if (isWindows() && inputs.usePosixPathSeparator) {
+        yield convertPath(filePath, 'mixed')
+      } else {
+        yield filePath
+      }
    }
  }
 }
@@ -402,7 +407,11 @@ function* getAllChangeTypeFilesGenerator({
    filePaths,
    dirNamesIncludeFilePatterns
  })) {
-    yield filePath
+    if (isWindows() && inputs.usePosixPathSeparator) {
+      yield convertPath(filePath, 'mixed')
+    } else {
+      yield filePath
+    }
  }
 }

--- a/src/changedFilesOutput.ts
+++ b/src/changedFilesOutput.ts
@@ -247,7 +247,7 @@ export const setOutputsAndGetModifiedAndChangedFilesStatus = async ({

  await setOutput({
    key: getOutputKey('any_changed', outputPrefix),
-    value: allChangedFiles.paths.length > 0 && filePatterns.length > 0,
+    value: allChangedFiles.paths.length > 0,
    writeOutputFiles: inputs.writeOutputFiles,
    outputDir: inputs.outputDir,
    json: inputs.json
@@ -336,7 +336,7 @@ export const setOutputsAndGetModifiedAndChangedFilesStatus = async ({

  await setOutput({
    key: getOutputKey('any_modified', outputPrefix),
-    value: allModifiedFiles.paths.length > 0 && filePatterns.length > 0,
+    value: allModifiedFiles.paths.length > 0,
    writeOutputFiles: inputs.writeOutputFiles,
    outputDir: inputs.outputDir,
    json: inputs.json
@@ -442,7 +442,7 @@ export const setOutputsAndGetModifiedAndChangedFilesStatus = async ({

  await setOutput({
    key: getOutputKey('any_deleted', outputPrefix),
-    value: deletedFiles.paths.length > 0 && filePatterns.length > 0,
+    value: deletedFiles.paths.length > 0,
    writeOutputFiles: inputs.writeOutputFiles,
    outputDir: inputs.outputDir,
    json: inputs.json
@@ -496,7 +496,7 @@ export const setOutputsAndGetModifiedAndChangedFilesStatus = async ({
  })

  return {
-    anyModified: allModifiedFiles.paths.length > 0 && filePatterns.length > 0,
-    anyChanged: allChangedFiles.paths.length > 0 && filePatterns.length > 0
+    anyModified: allModifiedFiles.paths.length > 0,
+    anyChanged: allChangedFiles.paths.length > 0
  }
 }
--- a/src/commitSha.ts
+++ b/src/commitSha.ts
@@ -86,15 +86,27 @@ export interface DiffResult {
  initialCommit?: boolean
 }

-export const getSHAForNonPullRequestEvent = async (
-  inputs: Inputs,
-  env: Env,
-  workingDirectory: string,
-  isShallow: boolean,
-  hasSubmodule: boolean,
-  gitFetchExtraArgs: string[],
+interface SHAForNonPullRequestEvent {
+  inputs: Inputs
+  env: Env
+  workingDirectory: string
+  isShallow: boolean
+  diffSubmodule: boolean
+  gitFetchExtraArgs: string[]
  isTag: boolean
-): Promise<DiffResult> => {
+  remoteName: string
+}
+
+export const getSHAForNonPullRequestEvent = async ({
+  inputs,
+  env,
+  workingDirectory,
+  isShallow,
+  diffSubmodule,
+  gitFetchExtraArgs,
+  isTag,
+  remoteName
+}: SHAForNonPullRequestEvent): Promise<DiffResult> => {
  let targetBranch = env.GITHUB_REF_NAME
  let currentBranch = targetBranch
  let initialCommit = false
@@ -122,8 +134,8 @@ export const getSHAForNonPullRequestEvent = async (
            '-u',
            '--progress',
            `--deepen=${inputs.fetchDepth}`,
-            'origin',
-            `+refs/heads/${sourceBranch}:refs/remotes/origin/${sourceBranch}`
+            remoteName,
+            `+refs/heads/${sourceBranch}:refs/remotes/${remoteName}/${sourceBranch}`
          ]
        })
      } else {
@@ -134,13 +146,13 @@ export const getSHAForNonPullRequestEvent = async (
            '-u',
            '--progress',
            `--deepen=${inputs.fetchDepth}`,
-            'origin',
-            `+refs/heads/${targetBranch}:refs/remotes/origin/${targetBranch}`
+            remoteName,
+            `+refs/heads/${targetBranch}:refs/remotes/${remoteName}/${targetBranch}`
          ]
        })
      }

-      if (hasSubmodule) {
+      if (diffSubmodule) {
        await gitFetchSubmodules({
          cwd: workingDirectory,
          args: [
@@ -152,7 +164,7 @@ export const getSHAForNonPullRequestEvent = async (
        })
      }
    } else {
-      if (hasSubmodule && inputs.fetchAdditionalSubmoduleHistory) {
+      if (diffSubmodule && inputs.fetchAdditionalSubmoduleHistory) {
        await gitFetchSubmodules({
          cwd: workingDirectory,
          args: [
@@ -307,14 +319,23 @@ export const getSHAForNonPullRequestEvent = async (
  }
 }

-export const getSHAForPullRequestEvent = async (
-  inputs: Inputs,
-  env: Env,
-  workingDirectory: string,
-  isShallow: boolean,
-  hasSubmodule: boolean,
+interface SHAForPullRequestEvent {
+  inputs: Inputs
+  workingDirectory: string
+  isShallow: boolean
+  diffSubmodule: boolean
  gitFetchExtraArgs: string[]
-): Promise<DiffResult> => {
+  remoteName: string
+}
+
+export const getSHAForPullRequestEvent = async ({
+  inputs,
+  workingDirectory,
+  isShallow,
+  diffSubmodule,
+  gitFetchExtraArgs,
+  remoteName
+}: SHAForPullRequestEvent): Promise<DiffResult> => {
  let targetBranch = github.context.payload.pull_request?.base?.ref
  const currentBranch = github.context.payload.pull_request?.head?.ref
  if (inputs.sinceLastRemoteCommit) {
@@ -330,7 +351,7 @@ export const getSHAForPullRequestEvent = async (
          ...gitFetchExtraArgs,
          '-u',
          '--progress',
-          'origin',
+          remoteName,
          `pull/${github.context.payload.pull_request?.number}/head:${currentBranch}`
        ]
      })
@@ -343,8 +364,8 @@ export const getSHAForPullRequestEvent = async (
            '-u',
            '--progress',
            `--deepen=${inputs.fetchDepth}`,
-            'origin',
-            `+refs/heads/${currentBranch}*:refs/remotes/origin/${currentBranch}*`
+            remoteName,
+            `+refs/heads/${currentBranch}*:refs/remotes/${remoteName}/${currentBranch}*`
          ]
        })
      }
@@ -364,12 +385,12 @@ export const getSHAForPullRequestEvent = async (
            '-u',
            '--progress',
            `--deepen=${inputs.fetchDepth}`,
-            'origin',
-            `+refs/heads/${targetBranch}:refs/remotes/origin/${targetBranch}`
+            remoteName,
+            `+refs/heads/${targetBranch}:refs/remotes/${remoteName}/${targetBranch}`
          ]
        })

-        if (hasSubmodule) {
+        if (diffSubmodule) {
          await gitFetchSubmodules({
            cwd: workingDirectory,
            args: [
@@ -382,7 +403,7 @@ export const getSHAForPullRequestEvent = async (
        }
      }
    } else {
-      if (hasSubmodule && inputs.fetchAdditionalSubmoduleHistory) {
+      if (diffSubmodule && inputs.fetchAdditionalSubmoduleHistory) {
        await gitFetchSubmodules({
          cwd: workingDirectory,
          args: [
@@ -427,10 +448,7 @@ export const getSHAForPullRequestEvent = async (
    }
  }

-  if (
-    !github.context.payload.pull_request?.base?.ref ||
-    github.context.payload.head?.repo?.fork === 'true'
-  ) {
+  if (!github.context.payload.pull_request?.base?.ref) {
    diff = '..'
  }

@@ -487,17 +505,14 @@ export const getSHAForPullRequestEvent = async (
        }
      }
    } else {
-      if (github.context.payload.action === 'closed') {
-        previousSha = github.context.payload.pull_request?.base?.sha
-      } else {
+      previousSha = github.context.payload.pull_request?.base?.sha
+
+      if (!previousSha) {
        previousSha = await getRemoteBranchHeadSha({
          cwd: workingDirectory,
+          remoteName,
          branch: targetBranch
        })
-
-        if (!previousSha) {
-          previousSha = github.context.payload.pull_request?.base?.sha
-        }
      }

      if (isShallow) {
@@ -513,7 +528,11 @@ export const getSHAForPullRequestEvent = async (
            'Merge base is not in the local history, fetching remote target branch...'
          )

-          for (let i = 1; i <= 10; i++) {
+          for (
+            let i = 1;
+            i <= (inputs.fetchMissingHistoryMaxRetries || 10);
+            i++
+          ) {
            await gitFetch({
              cwd: workingDirectory,
              args: [
@@ -521,8 +540,8 @@ export const getSHAForPullRequestEvent = async (
                '-u',
                '--progress',
                `--deepen=${inputs.fetchDepth}`,
-                'origin',
-                `+refs/heads/${targetBranch}:refs/remotes/origin/${targetBranch}`
+                remoteName,
+                `+refs/heads/${targetBranch}:refs/remotes/${remoteName}/${targetBranch}`
              ]
            })

--- a/src/constant.ts
+++ b/src/constant.ts
@@ -20,5 +20,8 @@ export const DEFAULT_VALUES_OF_UNSUPPORTED_API_INPUTS: Partial<Inputs> = {
  oldNewFilesSeparator: ' ',
  skipInitialFetch: false,
  fetchAdditionalSubmoduleHistory: false,
-  dirNamesDeletedFilesIncludeOnlyDeletedDirs: false
+  dirNamesDeletedFilesIncludeOnlyDeletedDirs: false,
+  excludeSubmodules: false,
+  fetchMissingHistoryMaxRetries: 10,
+  usePosixPathSeparator: false
 }
--- a/src/env.ts
+++ b/src/env.ts
@@ -5,8 +5,9 @@ export type Env = {
  GITHUB_REF: string
  GITHUB_WORKSPACE: string
 }
+
 export const getEnv = async (): Promise<Env> => {
-  core.debug(`Process Env: ${JSON.stringify(process.env, null, 2)}`)
+  core.debug(`Env: ${JSON.stringify(process.env, null, 2)}`)

  return {
    GITHUB_REF_NAME: process.env.GITHUB_REF_NAME || '',
--- a/src/inputs.ts
+++ b/src/inputs.ts
@@ -54,6 +54,9 @@ export type Inputs = {
  failOnSubmoduleDiffError: boolean
  negationPatternsFirst: boolean
  useRestApi: boolean
+  excludeSubmodules: boolean
+  fetchMissingHistoryMaxRetries?: number
+  usePosixPathSeparator: boolean
 }

 export const getInputs = (): Inputs => {
@@ -154,8 +157,15 @@ export const getInputs = (): Inputs => {
      trimWhitespace: false
    }
  )
-  const json = core.getBooleanInput('json', {required: false})
-  const escapeJson = core.getBooleanInput('escape_json', {required: false})
+  let json = core.getBooleanInput('json', {required: false})
+  let escapeJson = core.getBooleanInput('escape_json', {required: false})
+  const matrix = core.getBooleanInput('matrix', {required: false})
+
+  if (matrix) {
+    json = true
+    escapeJson = false
+  }
+
  const safeOutput = core.getBooleanInput('safe_output', {required: false})
  const fetchDepth = core.getInput('fetch_depth', {required: false})
  const sinceLastRemoteCommit = core.getBooleanInput(
@@ -233,6 +243,22 @@ export const getInputs = (): Inputs => {
    required: false
  })

+  const excludeSubmodules = core.getBooleanInput('exclude_submodules', {
+    required: false
+  })
+
+  const fetchMissingHistoryMaxRetries = core.getInput(
+    'fetch_missing_history_max_retries',
+    {required: false}
+  )
+
+  const usePosixPathSeparator = core.getBooleanInput(
+    'use_posix_path_separator',
+    {
+      required: false
+    }
+  )
+
  const inputs: Inputs = {
    files,
    filesSeparator,
@@ -272,6 +298,8 @@ export const getInputs = (): Inputs => {
    skipInitialFetch,
    fetchAdditionalSubmoduleHistory,
    dirNamesDeletedFilesIncludeOnlyDeletedDirs,
+    excludeSubmodules,
+    usePosixPathSeparator,
    // End Not Supported via REST API
    dirNames,
    dirNamesExcludeCurrentDir,
@@ -290,6 +318,7 @@ export const getInputs = (): Inputs => {
  }

  if (fetchDepth) {
+    // Fallback to at least 2 if the fetch_depth is less than 2
    inputs.fetchDepth = Math.max(parseInt(fetchDepth, 10), 2)
  }

@@ -297,5 +326,13 @@ export const getInputs = (): Inputs => {
    inputs.dirNamesMaxDepth = parseInt(dirNamesMaxDepth, 10)
  }

+  if (fetchMissingHistoryMaxRetries) {
+    // Fallback to at least 1 if the fetch_missing_history_max_retries is less than 1
+    inputs.fetchMissingHistoryMaxRetries = Math.max(
+      parseInt(fetchMissingHistoryMaxRetries, 10),
+      1
+    )
+  }
+
  return inputs
 }
--- a/src/main.ts
+++ b/src/main.ts
@@ -64,14 +64,26 @@ const getChangedFilesFromLocalGitHistory = async ({
  }

  const isShallow = await isRepoShallow({cwd: workingDirectory})
-  const hasSubmodule = await submoduleExists({cwd: workingDirectory})
-  let gitFetchExtraArgs = ['--no-tags', '--prune', '--recurse-submodules']
+  let diffSubmodule = false
+  let gitFetchExtraArgs = ['--no-tags', '--prune']
+
+  if (inputs.excludeSubmodules) {
+    core.info('Excluding submodules from the diff')
+  } else {
+    diffSubmodule = await submoduleExists({cwd: workingDirectory})
+  }
+
+  if (diffSubmodule) {
+    gitFetchExtraArgs.push('--recurse-submodules')
+  }
+
  const isTag = env.GITHUB_REF?.startsWith('refs/tags/')
+  const remoteName = 'origin'
  const outputRenamedFilesAsDeletedAndAdded =
    inputs.outputRenamedFilesAsDeletedAndAdded
  let submodulePaths: string[] = []

-  if (hasSubmodule) {
+  if (diffSubmodule) {
    submodulePaths = await getSubmodulePath({cwd: workingDirectory})
  }

@@ -83,29 +95,30 @@ const getChangedFilesFromLocalGitHistory = async ({

  if (!github.context.payload.pull_request?.base?.ref) {
    core.info(`Running on a ${github.context.eventName || 'push'} event...`)
-    diffResult = await getSHAForNonPullRequestEvent(
+    diffResult = await getSHAForNonPullRequestEvent({
      inputs,
      env,
      workingDirectory,
      isShallow,
-      hasSubmodule,
+      diffSubmodule,
      gitFetchExtraArgs,
-      isTag
-    )
+      isTag,
+      remoteName
+    })
  } else {
    core.info(
      `Running on a ${github.context.eventName || 'pull_request'} (${
        github.context.payload.action
      }) event...`
    )
-    diffResult = await getSHAForPullRequestEvent(
+    diffResult = await getSHAForPullRequestEvent({
      inputs,
-      env,
      workingDirectory,
      isShallow,
-      hasSubmodule,
-      gitFetchExtraArgs
-    )
+      diffSubmodule,
+      gitFetchExtraArgs,
+      remoteName
+    })
  }

  if (diffResult.initialCommit) {
@@ -120,7 +133,7 @@ const getChangedFilesFromLocalGitHistory = async ({

  const allDiffFiles = await getAllDiffFiles({
    workingDirectory,
-    hasSubmodule,
+    diffSubmodule,
    diffResult,
    submodulePaths,
    outputRenamedFilesAsDeletedAndAdded,
@@ -146,7 +159,7 @@ const getChangedFilesFromLocalGitHistory = async ({
      deletedFiles: allDiffFiles[ChangeTypeEnum.Deleted],
      recoverPatterns,
      diffResult,
-      hasSubmodule,
+      diffSubmodule,
      submodulePaths
    })
  }
@@ -164,7 +177,7 @@ const getChangedFilesFromLocalGitHistory = async ({
    const allOldNewRenamedFiles = await getRenamedFiles({
      inputs,
      workingDirectory,
-      hasSubmodule,
+      diffSubmodule,
      diffResult,
      submodulePaths
    })
@@ -264,9 +277,8 @@ export async function run(): Promise<void> {
    })
  } else {
    if (!hasGitDirectory) {
-      core.info(`Running on a ${github.context.eventName} event...`)
      throw new Error(
-        `Can't find local .git in ${workingDirectory} directory. Please run actions/checkout before this action (Make sure the 'path' input is correct). If you intend to use Github's REST API note that only pull_request* events are supported.`
+        `Unable to locate the git repository in the given path: ${workingDirectory}.\n Please run actions/checkout before this action (Make sure the 'path' input is correct).\n If you intend to use Github's REST API note that only pull_request* events are supported. Current event is "${github.context.eventName}".`
      )
    }

--- a/src/utils.ts
+++ b/src/utils.ts
@@ -32,11 +32,13 @@ export const normalizeSeparators = (p: string): string => {

    // Remove redundant slashes
    const isUnc = /^\\\\+[^\\]/.test(p) // e.g. \\hello
-    return (isUnc ? '\\' : '') + p.replace(/\\\\+/g, '\\') // preserve leading \\ for UNC
+    p = (isUnc ? '\\' : '') + p.replace(/\\\\+/g, '\\') // preserve leading \\ for UNC
+  } else {
+    // Remove redundant slashes on Linux/macOS
+    p = p.replace(/\/\/+/g, '/')
  }

-  // Remove redundant slashes
-  return p.replace(/\/\/+/g, '/')
+  return p
 }

 /**
@@ -685,14 +687,16 @@ export const isInsideWorkTree = async ({

 export const getRemoteBranchHeadSha = async ({
  cwd,
-  branch
+  branch,
+  remoteName
 }: {
  cwd: string
  branch: string
+  remoteName: string
 }): Promise<string> => {
  const {stdout} = await exec.getExecOutput(
    'git',
-    ['rev-parse', `origin/${branch}`],
+    ['rev-parse', `${remoteName}/${branch}`],
    {
      cwd,
      silent: !core.isDebug()
@@ -902,7 +906,7 @@ export const canDiffCommits = async ({
  } else {
    const {exitCode, stderr} = await exec.getExecOutput(
      'git',
-      ['diff', '--quiet', sha1, sha2],
+      ['diff', '--no-patch', sha1, sha2],
      {
        cwd,
        ignoreReturnCode: true,
@@ -1411,7 +1415,7 @@ export const recoverDeletedFiles = async ({
  deletedFiles,
  recoverPatterns,
  diffResult,
-  hasSubmodule,
+  diffSubmodule,
  submodulePaths
 }: {
  inputs: Inputs
@@ -1419,7 +1423,7 @@ export const recoverDeletedFiles = async ({
  deletedFiles: string[]
  recoverPatterns: string[]
  diffResult: DiffResult
-  hasSubmodule: boolean
+  diffSubmodule: boolean
  submodulePaths: string[]
 }): Promise<void> => {
  let recoverableDeletedFiles = deletedFiles
@@ -1449,7 +1453,7 @@ export const recoverDeletedFiles = async ({

    const submodulePath = submodulePaths.find(p => deletedFile.startsWith(p))

-    if (hasSubmodule && submodulePath) {
+    if (diffSubmodule && submodulePath) {
      const submoduleShaResult = await gitSubmoduleDiffSHA({
        cwd: workingDirectory,
        parentSha1: diffResult.previousSha,
--- a/yarn.lock
+++ b/yarn.lock