ugit PSA integration (Fixes #186)

Adding On Demand Action and PSA file

.github/workflows/SendPSA.yml

@@ -0,0 +1,12 @@
+
+name: ugit-psa
+on: 
+  workflow_dispatch: 
+jobs: 
+  SendPSA: 
+    name: PSA
+    uses: StartAutomating/PSA@main
+    id: PSA
+env: 
+  AT_PROTOCOL_HANDLE: mrpowershell.bsky.social
+  AT_PROTOCOL_APP_PASSWORD: ${{ secrets.AT_PROTOCOL_APP_PASSWORD }}

ugit.psa.ps1

@@ -0,0 +1,62 @@
+# Any *.PSA.ps1 file will be run when PSA runs.
+
+# A good thing to do at the start of this file is to connect.
+
+Connect-BlueSky
+
+# If $env:AT_PROTOCOL_HANDLE or $env:AT_PROTOCOL_EMAIL is set, it will be treated as the username
+# If $env:AT_PROTOCOL_APP_PASSWORD is set, it will be treated as the App Password.
+# _Never_ use your actual BlueSky password
+
+# Once we're connected, we can do anything our app password allows.
+
+# However, you _might_ want to output some information first, so that you can see you're connected.
+
+Get-BskyActorProfile -Actor $env:AT_PROTOCOL_HANDLE -Cache | Out-Host
+
+# To ensure you're not going to send a skeet on every checkin, it's a good idea to ask what GitHub is up to
+
+# There will be a variable, $GitHubEvent, that contains information about the event.
+
+# A fairly common scenario is to perform an annoucement whenever a PR is merged.
+
+$isMergeToMain = 
+    ($gitHubEvent.head_commit.message -match "Merge Pull Request #(?<PRNumber>\d+)") -and 
+    $gitHubEvent.ref -in 'refs/heads/main', 'refs/heads/master'
+
+
+$importedModule = Import-Module .\ugit.psd1 -Global -PassThru
+$importedModule | Out-Host
+$moduleAndVersion = "$($importedModule.Name) $($importedModule.Version)"
+
+$isManuallyTriggered = $gitHubEvent.psobject.properties["input"]
+
+if ($isMergeToMain -or $isManuallyTriggered) {
+
+    $fullMessage = 
+        @(switch ($importedModule.Version) {
+            default {
+                "I've got to admit it's gitting better, gitting better all the time:",
+                "Somehow, someway, I keep coming up with funky git nearly every single day:",
+                "#git in the #PowerShell object pipeline!",
+                "Get your git together!",
+                "Put this git in your pipe and smoke it!",
+                "I promise you, git gets better",
+                "Git ahead of the game!" |
+                    Get-Random
+
+                "$moduleAndVersion"        
+
+                "https://github.com/StartAutomating/ugit"
+            }
+        }) -join ([Environment]::NewLine * 2)
+
+
+    Send-AtProto -Text $fullMessage -WebCard @{
+        Url = "https://github.com/StartAutomating/ugit"
+    } -LinkPattern @{
+        "ugit" = "https://github.com/StartAutomating/ugit"
+    }
+
+    return
+}