tools: add find-inactive-collaborators.js

The plan is to eventually call this script with a scheduled GitHub Action that could automatically open pull requests to move collaborators to emeritus status after (for example) a year of inactivity. Sample run: ``` $ node tools/find-inactive-collaborators.mjs '30 months ago' 864 authors have made commits since 30 months ago. 101 landers have landed commits since 30 months ago. 146 reviewers have approved landed commits since 30 months ago. 109 collaborators currently in the project. Inactive collaborators: Thomas Watson $ ``` PR-URL: #39262 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Tobias Nießen <[email protected]>

Author: Trott

tools/find-inactive-collaborators.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+// Identify inactive collaborators. "Inactive" is not quite right, as the things
+// this checks for are not the entirety of collaborator activities. Still, it is
+// a pretty good proxy. Feel free to suggest or implement further metrics.
+
+importcpfrom'node:child_process';
+importfsfrom'node:fs';
+importreadlinefrom'node:readline';
+
+constSINCE=process.argv[2]||'6 months ago';
+
+asyncfunctionrunGitCommand(cmd,mapFn){
+constchildProcess=cp.spawn('/bin/sh',['-c',cmd],{
+cwd: newURL('..',import.meta.url),
+encoding: 'utf8',
+stdio: ['inherit','pipe','inherit'],
+});
+constlines=readline.createInterface({
+input: childProcess.stdout,
+});
+consterrorHandler=newPromise(
+(_,reject)=>childProcess.on('error',reject)
+);
+constreturnedSet=newSet();
+awaitPromise.race([errorHandler,Promise.resolve()]);
+forawait(constlineoflines){
+awaitPromise.race([errorHandler,Promise.resolve()]);
+constval=mapFn(line);
+if(val){
+returnedSet.add(val);
+}
+}
+returnPromise.race([errorHandler,Promise.resolve(returnedSet)]);
+}
+
+// Get all commit authors during the time period.
+constauthors=awaitrunGitCommand(
+`git shortlog -n -s --since="${SINCE}"`,
+(line)=>line.trim().split('\t',2)[1]
+);
+
+// Get all commit landers during the time period.
+constlanders=awaitrunGitCommand(
+`git shortlog -n -s -c --since="${SINCE}"`,
+(line)=>line.trim().split('\t',2)[1]
+);
+
+// Get all approving reviewers of landed commits during the time period.
+constapprovingReviewers=awaitrunGitCommand(
+`git log --since="${SINCE}" | egrep "^ Reviewed-By: "`,
+(line)=>/^Reviewed-By:([^<]+)/.exec(line)[1].trim()
+);
+
+asyncfunctionretrieveCollaboratorsFromReadme(){
+constreadmeText=readline.createInterface({
+input: fs.createReadStream(newURL('../README.md',import.meta.url)),
+crlfDelay: Infinity,
+});
+constreturnedArray=[];
+letprocessingCollaborators=false;
+forawait(constlineofreadmeText){
+constisCollaborator=processingCollaborators&&line.length;
+if(line==='### Collaborators'){
+processingCollaborators=true;
+}
+if(line==='### Collaborator emeriti'){
+processingCollaborators=false;
+break;
+}
+if(line.startsWith('**')&&isCollaborator){
+returnedArray.push(line.split('**',2)[1].trim());
+}
+}
+returnreturnedArray;
+}
+
+// Get list of current collaborators from README.md.
+constcollaborators=awaitretrieveCollaboratorsFromReadme();
+
+console.log(`${authors.size.toLocaleString()} authors have made commits since ${SINCE}.`);
+console.log(`${landers.size.toLocaleString()} landers have landed commits since ${SINCE}.`);
+console.log(`${approvingReviewers.size.toLocaleString()} reviewers have approved landed commits since ${SINCE}.`);
+console.log(`${collaborators.length.toLocaleString()} collaborators currently in the project.`);
+
+constinactive=collaborators.filter((collaborator)=>
+!authors.has(collaborator)&&
+!landers.has(collaborator)&&
+!approvingReviewers.has(collaborator)
+);
+
+if(inactive.length){
+console.log('\nInactive collaborators:');
+console.log(inactive.join('\n'));
+}