docs-util: fix release scripts (#6353)

- Fix GitHub action to run on push and check if the commit message is "chore: Release". Only then are TSDocs generated and a PR is opened.
- Add an option to pass to the `run:release` method of the docblock generator a release tag. This is helpful in cases when the GitHub action fails for any reason.
- Add scripts that checks the message of a commit.

docs-util/packages/scripts/check-release-commit.ts

@@ -0,0 +1,38 @@
+import { Octokit } from "@octokit/core"
+import * as core from "@actions/core"
+
+const commitSha = process.argv.length >= 3 ? process.argv[2] : null
+
+const octokit = new Octokit({
+  auth: process.env.GH_TOKEN,
+})
+
+async function checkReleaseCommit() {
+  if (!commitSha) {
+    throw new Error("Commit SHA is required.")
+  }
+
+  // retrieve commit by the SHA
+  const { data: commit } = await octokit.request(
+    "GET /repos/{owner}/{repo}/commits/{ref}",
+    {
+      owner: process.env.GIT_OWNER || "",
+      repo: process.env.GIT_REPO || "",
+      ref: commitSha,
+      headers: {
+        "X-GitHub-Api-Version": "2022-11-28",
+      },
+    }
+  )
+
+  if (!commit) {
+    throw new Error("Commit doesn't exist.")
+  }
+
+  core.setOutput(
+    "is_release_commit",
+    commit.commit.message === "chore: Release"
+  )
+}
+
+void checkReleaseCommit()