✨ Add basic git action support

Author: bitwizeshift

git/add/action.yaml

@@ -0,0 +1,27 @@
+name: Adds content to the git stage
+description: |
+  A composite action for adding content to the git stage.
+
+inputs:
+  path:
+    required: false
+    default: "."
+    description: "The path or paths to the content to add"
+outputs:
+  staged:
+    value: ${{ steps.add.outputs.staged }}
+    description: "`true` if any output was staged; `false` otherwise"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Add
+      id: add
+      shell: bash
+      run: |
+        git add ${{ inputs.path }}
+        if ! git diff --cached --exit-code 2>&1 1>/dev/null; then
+          echo "staged=true" >> "${GITHUB_OUTPUT}"
+        else
+          echo "staged=false" >> "${GITHUB_OUTPUT}"
+        fi

git/commit/action.yaml

@@ -0,0 +1,49 @@
+name: Create a git commit
+description: |
+  A composite action for committing the current staged content.
+
+inputs:
+  title:
+    required: true
+    description: "The title of the commit message"
+  body:
+    required: false
+    default: ""
+    description: "The body of the commit message"
+  user-name:
+    required: false
+    default: "Octocat"
+    description: "The default user to commit as"
+  user-email:
+    required: false
+    default: "[email protected]"
+    description: "The email of the user to commit as"
+outputs:
+  sha1:
+    value: ${{ steps.commit.outputs.sha1 }}
+    description: The SHA1 of the newly created commit
+  sha1-short:
+    value: ${{ steps.update.outputs.comment-url }}
+    description: The short/succinct SHA1 of the newly created commit
+
+runs:
+  using: "composite"
+  steps:
+    - name: Commit
+      id: commit
+      shell: bash
+      env:
+        # Note: using an env variable here since we can use the Github pre-processor
+        # expansion, which can allow embedded backticks without triggering shell
+        # substitution.
+        COMMIT_MESSAGE: |
+          ${{ inputs.title }}
+
+          ${{ inputs.body }}
+      run: |
+        git config --global user.email "${{ inputs.user-email }}"
+        git config --global user.name "${{ inputs.user-name }}"
+        git commit -m '${{ env.COMMIT_MESSAGE }}'
+
+        echo "sha1=$(git rev-parse HEAD)" >> "${GITHUB_OUTPUT}"
+        echo "sha1-short=$(git rev-parse --short HEAD)" >> "${GITHUB_OUTPUT}"

git/push/action.yaml

@@ -0,0 +1,33 @@
+name: Push a git branch
+description: |
+  A composite action for pushing a git branch.
+
+  This requires `contents: write` permissions in order to work correctly.
+
+inputs:
+  branch:
+    required: true
+    description: "The name of the branch to push"
+  target-commitish:
+    required: false
+    default: HEAD
+    description: "The commit to push as the new branch"
+  force:
+    required: false
+    default: "false"
+    description: "Whether to force-push this branch"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Push
+      shell: bash
+      run: |
+        force=""
+        if [${{ inputs.force }} = "true"]; then
+          force="--force"
+        fi
+
+        git push                                                               \
+          origin ${{ inputs.target-commitish }}:${{ inputs.branch }}           \
+          ${force}