Merge pull request #1982 from gitgitgadget/add-the-action

This PR is part 3 of addressing #609, and it is stacked on top of #1980 and #1981 (and therefore contains also the commits of those PRs), therefore I will leave this in draft mode until those PRs are merged.

The grand idea is to bundle the `CIHelper` class together with all its direct and transitive dependencies into one big, honking `dist/index.js`, and then add a set of really minimal GitHub Actions that call into `CIHelper`. The Actions are added in sub-directories so that they can be called in GitHub workflows via e.g. `- uses: gitgitgadget/gitgitgadget/update-prs@1`.

The component used for bundling `CIHelper` is [`@vercel/ncc` ](https://www.npmjs.com/package/@vercel/ncc). To support acting as a GitHub Action, [`@actions/core`](https://www.npmjs.com/package/@actions/core) is installed.

To allow for really minimal GitHub Actions, the `CIHelper` class is augmented accordingly to re-implement more logic that is currently either in `misc-helper.ts` or in the (non-public 😞) Azure Pipelines definitions.

The naming convention for specifying the necessary tokens as GitHub Actions inputs is:
- `upstream-repo-token`: This is to comment on PRs in `git/git`
- `pr-repo-token`: This is to comment on PRs in `gitgitgadget/git` (as well as to be able to push to that repository)
- `test-repo-token`: This is to comment on PRs in `dscho/git` (used exclusively for testing)

To clarify, here is a diagram:

```mermaid
graph TD
    user["user (contributor)"]
    upstream-repo["upstream-repo (authoritative project repo)"]
    pr-repo["pr-repo (GitGitGadget-enabled GitHub repo)"]
    GitGitGadget["GitGitGadget"]
    mailing-list["mailing-list"]

    user -->|"opens PR"| pr-repo
    user -->|"opens PR (if GitHub App installed)"| upstream-repo

    upstream-repo -->|"GitGitGadget syncs branches to"| pr-repo

    pr-repo -->|"slash commands"| GitGitGadget
    upstream-repo -->|"slash commands (if App installed)"| GitGitGadget

    GitGitGadget -->|"sends patch series"| mailing-list
```

Author: dscho

.gitignore

@@ -2,6 +2,7 @@
 /.env
 /.test-dir/
 /build/
+/dist/**/*.d.ts
 /node_modules/
 /npm-debug.log
 /junit.xml

.vscode/settings.json

@@ -96,6 +96,9 @@
         "CIsmtphost",
         "CIsmtppass",
         "CIsmtpopts",
+        "GITGIT_(|DIR|GIT_REMOTE|MAIL_REMOTE|MAIL_EPOCH)",
+        "mailrepo",
+        "parsePRURLInput",
         "users\\.noreply\\.github\\.com",
     ],
     "cSpell.language": "en-US",

handle-new-mails/action.yml

@@ -0,0 +1,19 @@
+name: 'Handle new mails'
+description: 'Processes new mails on the Git mailing list'
+author: 'Johannes Schindelin'
+inputs:
+  pr-repo-token:
+    description: 'The access token to work on the repository that holds PRs and state'
+    required: true
+  upstream-repo-token:
+    description: 'The access token to work on PRs in the upstream repository'
+    required: true
+  test-repo-token:
+    description: 'The access token to work on PRs in the test repository'
+    required: true
+runs:
+  using: 'node20'
+  main: './index.js'
+branding:
+  icon: 'git-commit'
+  color: 'orange'

handle-new-mails/index.js

@@ -0,0 +1,12 @@
+async function run() {
+  const { CIHelper } = await import("../dist/index.js")
+
+  const ci = new CIHelper()
+
+  await ci.setupGitHubAction({
+    needsMailingListMirror: true,
+  })
+  await ci.handleNewMails()
+}
+
+run()

handle-pr-comment/action.yml

@@ -0,0 +1,34 @@
+name: 'Handle PR Comment'
+description: 'Handles slash commands such as /submit and /preview'
+author: 'Johannes Schindelin'
+inputs:
+  pr-repo-token:
+    description: 'The access token to work on the repository that holds PRs and state'
+    required: true
+  upstream-repo-token:
+    description: 'The access token to work on PRs in the upstream repository'
+    required: true
+  test-repo-token:
+    description: 'The access token to work on PRs in the test repository'
+    required: true
+  smtp-host:
+    description: 'The SMTP host to use for sending emails'
+    required: true
+  smtp-user:
+    description: 'The SMTP user when sending emails'
+    required: true
+  smtp-opts:
+    description: 'Extra SMTP options in JSON format'
+    required: false
+  smtp-pass:
+    description: 'The SMTP password to use for sending emails'
+    required: true
+  pr-comment-url:
+    description: 'The URL of the PR comment to add a reaction to'
+    required: true
+runs:
+  using: 'node20'
+  main: './index.js'
+branding:
+  icon: 'git-commit'
+  color: 'orange'

handle-pr-comment/index.js

@@ -0,0 +1,11 @@
+async function run() {
+  const { CIHelper } = await import("../dist/index.js")
+
+  const ci = new CIHelper()
+  const { owner, commentId } = ci.parsePRCommentURLInput()
+
+  await ci.setupGitHubAction()
+  await ci.handleComment(owner, commentId)
+}
+
+run()

handle-pr-push/action.yml

@@ -0,0 +1,22 @@
+name: 'Handle PR Pushes'
+description: 'Handles when a PR was pushed'
+author: 'Johannes Schindelin'
+inputs:
+  pr-repo-token:
+    description: 'The access token to work on the repository that holds PRs and state'
+    required: true
+  upstream-repo-token:
+    description: 'The access token to work on PRs in the upstream repository'
+    required: true
+  test-repo-token:
+    description: 'The access token to work on PRs in the test repository'
+    required: true
+  pr-url:
+    description: 'The URL of the PR that was pushed'
+    required: true
+runs:
+  using: 'node20'
+  main: './index.js'
+branding:
+  icon: 'git-commit'
+  color: 'orange'

handle-pr-push/index.js

@@ -0,0 +1,11 @@
+async function run() {
+  const { CIHelper } = await import("../dist/index.js")
+
+  const ci = new CIHelper()
+  const { owner, prNumber } = ci.parsePRURLInput()
+
+  await ci.setupGitHubAction()
+  await ci.handlePush(owner, prNumber)
+}
+
+run()