chore: add tests, update docs and actions (#299)

* docs: update documentation

* feat: validate-inputs has it's own pyproject

* security: mask DOCKERHUB_PASSWORD

* chore: add tokens, checkout, recrete docs, integration tests

* fix: add `statuses: write` permission to pr-lint

stale/action.yml

@@ -15,7 +15,7 @@ inputs:
   token:
     description: 'GitHub token for authentication'
     required: false
-    default: ${{ github.token }}
+    default: ''
   days-before-stale:
     description: 'Number of days of inactivity before an issue is marked as stale'
     required: false
@@ -36,12 +36,17 @@ outputs:
 runs:
   using: composite
   steps:
+    - name: Checkout Repository
+      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      with:
+        token: ${{ inputs.token || github.token }}
+
     - name: Validate Inputs
       id: validate
       uses: ./validate-inputs
       with:
         action: 'stale'
-        token: ${{ inputs.token }}
+        token: ${{ inputs.token || github.token }}
         days-before-stale: ${{ inputs.days-before-stale }}
         days-before-close: ${{ inputs.days-before-close }}
 
@@ -49,7 +54,7 @@ runs:
       id: stale
       uses: actions/stale@5f858e3efba33a5ca4407a664cc011ad407f2008 # v10.1.0
       with:
-        repo-token: ${{ inputs.token }}
+        repo-token: ${{ inputs.token || github.token }}
         days-before-stale: ${{ inputs.days-before-stale }}
         days-before-close: ${{ inputs.days-before-close }}
         remove-stale-when-updated: true