v12.19.0 proposal

.github/CODEOWNERS

@@ -5,72 +5,97 @@
 # 3. PRs touching any code with a codeowner must be signed off by at least one
 #    person on the code owner team.
 
-./.github/CODEOWNERS @nodejs/tsc
+# tsc & commcomm
+
+/.github/CODEOWNERS @nodejs/tsc
+/GOVERNANCE.md @nodejs/tsc
+/onboarding.md @nodejs/tsc
+/CODE_OF_CONDUCT.md @nodejs/tsc @nodejs/community-committee
+/CONTRIBUTING.md @nodejs/tsc @nodejs/community-committee
+/LICENSE @nodejs/tsc @nodejs/community-committee
+/doc/guides/contributing/code-of-conduct.md @nodejs/tsc @nodejs/community-committee
+# TODO(mmarchini): the bot doens't have a notion of precedence, that might
+# change when move the codeowners code to an Action, at which point we can
+# uncomment the line below
+# /doc/guides/contributing/*.md @nodejs/tsc
+/doc/guides/contributing/issues.md @nodejs/tsc
+/doc/guides/contributing/pull-requests.md @nodejs/tsc
+/doc/guides/collaborator-guide.md @nodejs/tsc
+/doc/guides/offboarding.md @nodejs/tsc
+/doc/guides/onboarding-extras.md @nodejs/tsc
 
 # net
 
-# ./deps/cares @nodejs/net
-# ./doc/api/dns.md @nodejs/net
-# ./doc/api/dgram.md @nodejs/net
-# ./doc/api/net.md @nodejs/net
-# ./lib/dgram.js @nodejs/net
-# ./lib/dns.js @nodejs/net
-# ./lib/net.js @nodejs/net @nodejs/quic
-# ./lib/internal/dgram.js @nodejs/net
-# ./lib/internal/dns/* @nodejs/net
-# ./lib/internal/net.js @nodejs/net
-# ./lib/internal/socket_list.js @nodejs/net
-# ./lib/internal/js_stream_socket.js @nodejs/net
-# ./src/cares_wrap.h @nodejs/net
-# ./src/connect_wrap.* @nodejs/net
-# ./src/connection_wrap.* @nodejs/net
-# ./src/node_sockaddr* @nodejs/net
-# ./src/tcp_wrap.* @nodejs/net
-# ./src/udp_wrap.* @nodejs/net
+/deps/cares @nodejs/net
+/doc/api/dns.md @nodejs/net
+/doc/api/dgram.md @nodejs/net
+/doc/api/net.md @nodejs/net
+/lib/dgram.js @nodejs/net
+/lib/dns.js @nodejs/net
+/lib/net.js @nodejs/net @nodejs/quic
+/lib/internal/dgram.js @nodejs/net
+/lib/internal/dns/* @nodejs/net
+/lib/internal/net.js @nodejs/net
+/lib/internal/socket_list.js @nodejs/net
+/lib/internal/js_stream_socket.js @nodejs/net
+/src/cares_wrap.h @nodejs/net
+/src/connect_wrap.* @nodejs/net
+/src/connection_wrap.* @nodejs/net
+/src/node_sockaddr* @nodejs/net
+/src/tcp_wrap.* @nodejs/net
+/src/udp_wrap.* @nodejs/net
 
 # tls/crypto
 
-# ./lib/internal/crypto/* @nodejs/crypto
-# ./lib/internal/tls.js @nodejs/crypto @nodejs/net
-# ./lib/crypto.js @nodejs/crypto
-# ./lib/tls.js @nodejs/crypto @nodejs/net
-# ./src/node_crypto* @nodejs/crypto
-# ./src/node_crypto_common* @nodejs/crypto @nodejs/quic
+/lib/internal/crypto/* @nodejs/crypto
+/lib/internal/tls.js @nodejs/crypto @nodejs/net
+/lib/crypto.js @nodejs/crypto
+/lib/tls.js @nodejs/crypto @nodejs/net
+/src/node_crypto* @nodejs/crypto
+/src/node_crypto_common* @nodejs/crypto @nodejs/quic
 
 # http
 
-# ./deps/llhttp/* @nodejs/http @nodejs/net
-# ./doc/api/http.md @nodejs/http @nodejs/net
-# ./doc/api/http2.md @nodejs/http @nodejs/net
-# ./lib/_http_* @nodejs/http @nodejs/net
-# ./lib/http.js @nodejs/http @nodejs/net
-# ./lib/https.js @nodejs/crypto @nodejs/net @nodejs/http
-# ./src/node_http_common* @nodejs/http @nodejs/http2 @nodejs/quic @nodejs/net
-# ./src/node_http_parser.cc @nodejs/http @nodejs/net
+/deps/llhttp/* @nodejs/http @nodejs/net
+/doc/api/http.md @nodejs/http @nodejs/net
+/doc/api/http2.md @nodejs/http @nodejs/net
+/lib/_http_* @nodejs/http @nodejs/net
+/lib/http.js @nodejs/http @nodejs/net
+/lib/https.js @nodejs/crypto @nodejs/net @nodejs/http
+/src/node_http_common* @nodejs/http @nodejs/http2 @nodejs/quic @nodejs/net
+/src/node_http_parser.cc @nodejs/http @nodejs/net
 
 # http2
 
-# ./deps/nghttp2/* @nodejs/http2 @nodejs/net
-# ./doc/api/http2.md @nodejs/http2 @nodejs/net
-# ./lib/http2.js @nodejs/http2 @nodejs/net
-# ./lib/internal/http2/* @nodejs/http2 @nodejs/net
-# ./src/node_http2* @nodejs/http2 @nodejs/net
-# ./src/node_mem* @nodejs/http2
+/deps/nghttp2/* @nodejs/http2 @nodejs/net
+/doc/api/http2.md @nodejs/http2 @nodejs/net
+/lib/http2.js @nodejs/http2 @nodejs/net
+/lib/internal/http2/* @nodejs/http2 @nodejs/net
+/src/node_http2* @nodejs/http2 @nodejs/net
+/src/node_mem* @nodejs/http2
+
+# modules
 
-# quic
+/doc/api/modules.md @nodejs/modules
+/doc/api/esm.md @nodejs/modules
+/doc/api/module.md @nodejs/modules
+/doc/api/packages.md @nodejs/modules
+/lib/module.js @nodejs/modules
+/lib/internal/modules/* @nodejs/modules
+/lib/internal/bootstrap/loaders.js @nodejs/modules
+/src/module_wrap* @nodejs/modules @nodejs/vm
 
-./deps/ngtcp2/* @nodejs/quic
-./deps/nghttp3/* @nodejs/quic
-./doc/api/quic.md @nodejs/quic
-./lib/internal/quic/* @nodejs/quic
-./src/node_bob* @nodejs/quic
-./src/quic/* @nodejs/quic
+# N-API
 
-# modules
+/src/node_api* @nodejs/n-api
+/src/js_native_api* @nodejs/n-api
+/doc/guides/adding-new-napi-api.md @nodejs/n-api
+/doc/api/n-api.md @nodejs/n-api
 
-# ./doc/api/modules.md @nodejs/modules
-# ./doc/api/esm.md @nodejs/modules
-# ./lib/module.js @nodejs/modules
-# ./lib/internal/modules/* @nodejs/modules
-# ./lib/internal/bootstrap/loaders.js @nodejs/modules
-# ./src/module_wrap* @nodejs/modules @nodejs/vm
+# WASI
+/deps/uvwasi/ @nodejs/wasi
+/doc/api/wasi.md @nodejs/wasi
+/lib/wasi.js @nodejs/wasi
+/src/node_wasi* @nodejs/wasi
+/test/wasi/ @nodejs/wasi
+/test/fixtures/wasi/ @nodejs/wasi

.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md

@@ -7,48 +7,71 @@ labels: doc
 
 # 📗 API Reference Docs Problem
 
-<!------------------------------------------------------------------------------
+<!--
+
 Thank you for wanting to make nodejs.org better!
 
-This template is for issues with the Node.js API reference docs.
+This template is for issues with the Node.js API
+reference documentation.
 
-For more general support, please open an issue in
-our help repo at “https://github.com/nodejs/help”.
+For problems with nodejs.org beyond the API
+reference documentation, please open an issue
+using the issue tracker for our site repository.
 
-For the issue title, enter a one-line summary after “doc: ”.
-The “✍️” signifies a request for input. If unsure, do the best you can.
+  https://github.com/nodejs/nodejs.org
 
-If you found a problem with nodejs.org beyond the API reference docs, please
-open an issue in our website repo at “https://github.com/nodejs/nodejs.org”.
-------------------------------------------------------------------------------->
+For more general support, please open an issue
+using the issue tracker for our help repository.
+
+  https://github.com/nodejs/help
+
+---
+
+For the issue title, please enter a one-line
+summary after “doc: ” (preferably 50 characters
+or less and no more than 72).
+
+The “✍️” are placeholders signifying requests for
+input. Replace them with your responses.
+
+If you are unsure of something, do your best.
 
-<!--
-Version: output of “node -v”
-Platform: output of “uname -a” (UNIX), or version and 32 or 64-bit (Windows)
-Subsystem: if known, please specify affected core module name
 -->
 
+<!-- The output of “node --version”. -->
+
 - **Version**: ✍️
+
+<!-- The output of “uname -a” (UNIX) or version
+and 32-bit or 64-bit (Windows). -->
+
 - **Platform**: ✍️
+
+<!-- The name of affected core module. -->
+
 - **Subsystem**: ✍️
 
 ## Location
 
 _Section of the site where the content exists_
 
 Affected URL(s):
+
 - https://nodejs.org/api/✍️
 
-## Problem description
+## Description
 
-_Concise explanation of what you found to be problematic_
+_Concise explanation of the problem_
 
-<!-- If applicable, include any screenshots that may help solve the problem. -->
+<!-- If applicable, include any screenshots that
+may help solve the problem. -->
 
 ✍️
 
 ---
 
-<!-- Use “[x]” to check the box below if interested in contributing. -->
+<!-- Use “[x]” to check the box below if you are
+interested in contributing. -->
 
-- [ ] I would like to work on this issue and submit a pull request.
+- [ ] I would like to work on this issue and
+      submit a pull request.

.github/SUPPORT.md

@@ -15,6 +15,7 @@ If you didn't find an answer in the resources above, try these unofficial
 resources:
 
 * [Questions tagged 'node.js' on Stack Overflow](https://stackoverflow.com/questions/tagged/node.js)
+* [#nodejs](https://openjs-foundation.slack.com/archives/CK9Q4MB53) channel on the OpenJS Foundation Slack ([join here](https://slack-invite.openjsf.org/))
 * [#node.js channel on chat.freenode.net](https://webchat.freenode.net?channels=node.js&uio=d4)
 * [Node.js Slack Community](https://node-js.slack.com/)
   * To register: [nodeslackers.com](https://www.nodeslackers.com/)

.github/workflows/auto-start-ci.yml

@@ -0,0 +1,63 @@
+---
+name: Auto Start CI
+
+on:
+  schedule:
+    # Runs every five minutes (fastest the scheduler can run). Five minutes is
+    # optimistic, it can take longer to run.
+    # To understand why `schedule` is used instead of other events, refer to
+    # ./doc/guides/commit-queue.md
+    - cron: "*/5 * * * *"
+
+jobs:
+  startCI:
+    if: github.repository == 'nodejs/node'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@master
+
+      # Install dependencies
+      - name: Install jq
+        run: sudo apt-get install jq -y
+      - name: Install Node.js
+        uses: actions/setup-node@v2-beta
+        with:
+          node-version: '12'
+      - name: Install node-core-utils
+        run: npm install -g node-core-utils
+
+      - name: Set variables
+        run: |
+          echo "::set-env name=REPOSITORY::$(echo ${{ github.repository }} | cut -d/ -f2)"
+          echo "::set-env name=OWNER::${{ github.repository_owner }}"
+
+      # Get Pull Requests
+      - name: Get Pull Requests
+        uses: octokit/graphql-action@v2.x
+        id: get_prs_for_ci
+        with:
+          query: |
+            query prs($owner:String!, $repo:String!) {
+              repository(owner:$owner, name:$repo) {
+                pullRequests(labels: ["request-ci"], states: OPEN, last: 100) {
+                  nodes {
+                    number
+                  }
+                }
+              }
+            }
+          owner: ${{ env.OWNER }}
+          repo: ${{ env.REPOSITORY }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup node-core-utils
+        run: |
+          ncu-config set username ${{ secrets.JENKINS_USER }}
+          ncu-config set token none
+          ncu-config set jenkins_token ${{ secrets.JENKINS_TOKEN }}
+          ncu-config set owner ${{ env.OWNER }}
+          ncu-config set repo ${{ env.REPOSITORY }}
+
+      - name: Start CI
+        run: ./tools/actions/start-ci.sh ${{ secrets.GITHUB_TOKEN }} ${{ env.OWNER }} ${{ env.REPOSITORY }} $(echo '${{ steps.get_prs_for_ci.outputs.data }}' | jq '.repository.pullRequests.nodes | map(.number) | .[]')

.github/workflows/close-stalled.yml

@@ -0,0 +1,25 @@
+name: Close stalled issues and PRs
+on:
+  schedule:
+  - cron: "0 0 * * *"
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/stale@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        days-before-close: 30
+        stale-pr-label: stalled
+        stale-issue-label: stalled
+        close-issue-message: Closing this because it has stalled. Feel free to reopen if this issue is still relevant, or to ping the collaborator who labelled it stalled if you have any questions.
+        close-pr-message: Closing this because it has stalled. Feel free to reopen if this PR is still relevant, or to ping the collaborator who labelled it stalled if you have any questions.
+        # used to filter issues to check whether or not should be closed, avoids hitting maximum operations allowed if needing to paginate through all open issues
+        only-labels: stalled
+        # max requests it will send per run to the GitHub API before it deliberately exits to avoid hitting API rate limits
+        operations-per-run: 500
+        # deactivates automatic removal of stalled label if issue gets any activity
+        remove-stale-when-updated: false
+        # deactivates automatic stale labelling as we prefer to do that manually
+        days-before-stale: -1

.github/workflows/comment-stalled.yml

@@ -0,0 +1,20 @@
+name: Comment on issues and PRs when labelled stalled
+on:
+  issues:
+    types: [labeled]
+  pull_request_target:
+    types: [labeled]
+
+jobs:
+  staleComment:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Post comment
+        if: github.event.label.name == 'stalled'
+        env:
+            COMMENTS_URL: ${{ github.event.issue.comments_url || github.event.pull_request.comments_url }}
+        run: |
+          curl -X POST $COMMENTS_URL \
+          -H "Content-Type: application/json" \
+          -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+          --data '{ "body": "This issue/PR was marked as stalled, it will be automatically closed in 30 days. If it should remain open, please leave a comment explaining why it should remain open." }'