TOOLS-3911 Add a CODEOWNERS file (#811)

This also adds linting to make sure that we never add files without an owner. But right now all files are owned by the @mongodb/tar-osap team.

Author: autarch

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @mongodb/tar-osap

buildscript/sa.go

@@ -28,13 +28,14 @@ const (
 
 	// This is the latest version to support a YAML config file. Updating to
 	// the new config file syntax did not seem trivial.
-	eslintVersion       = "8.57.0"
-	golangCILintVersion = "1.64.5"
-	golinesVersion      = "0.12.2"
-	gosecVersion        = "2.20.0"
-	preciousVersion     = "0.7.3"
-	ubiVersion          = "0.4.2"
-	prettierVersion     = "3.4.2"
+	eslintVersion           = "8.57.0"
+	gitHubCodeownersVersion = "0.2.1"
+	golangCILintVersion     = "1.64.5"
+	golinesVersion          = "0.12.2"
+	gosecVersion            = "2.20.0"
+	preciousVersion         = "0.7.3"
+	ubiVersion              = "0.4.2"
+	prettierVersion         = "3.4.2"
 )
 
 func SAInstallDevTools(ctx *task.Context) error {
@@ -268,33 +269,44 @@ func installBinaryTool(
 // execution wipes the entire `node_modules` directory, so we only end up with one tool (the last
 // one) installed.
 func installJSTools(ctx *task.Context) error {
-	eslint, err := eslintPath()
+	eslint, err := npmPath("eslint")
 	if err != nil {
 		return err
 	}
 
-	exists, err := executableExistsWithVersion(ctx, eslint, eslintVersion)
+	prettier, err := npmPath("prettier")
 	if err != nil {
 		return err
 	}
-	if !exists {
-		return runNPMInstall(ctx)
+
+	for _, tool := range [][]string{
+		{eslint, eslintVersion},
+		{prettier, prettierVersion},
+	} {
+		exists, err := executableExistsWithVersion(ctx, tool[0], tool[1])
+		if err != nil {
+			return err
+		}
+		if !exists {
+			return runNPMInstall(ctx)
+		}
 	}
 
-	prettier, err := prettierPath()
+	gitHubCodeowners, err := npmPath("github-codeowners")
 	if err != nil {
 		return err
 	}
 
-	exists, err = executableExistsWithVersion(ctx, prettier, prettierVersion)
+	// This program doesn't have any way to print its version. :(
+	exists, err := fileExists(gitHubCodeowners)
 	if err != nil {
 		return err
 	}
-	if exists {
-		return nil
+	if !exists {
+		return runNPMInstall(ctx)
 	}
 
-	return runNPMInstall(ctx)
+	return nil
 }
 
 func runNPMInstall(ctx *task.Context) error {
@@ -304,22 +316,13 @@ func runNPMInstall(ctx *task.Context) error {
 	)
 }
 
-func eslintPath() (string, error) {
-	root, err := repoRoot()
-	if err != nil {
-		return "", err
-	}
-
-	return filepath.Join(root, "node_modules", ".bin", "eslint"), nil
-}
-
-func prettierPath() (string, error) {
+func npmPath(exe string) (string, error) {
 	root, err := repoRoot()
 	if err != nil {
 		return "", err
 	}
 
-	return filepath.Join(root, "node_modules", ".bin", "prettier"), nil
+	return filepath.Join(root, "node_modules", ".bin", exe), nil
 }
 
 func SAPreciousLint(ctx *task.Context) error {

etc/github-codeowners-wrapper.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+set -o errexit
+set -o pipefail
+
+STATUS=0
+
+OUTPUT=$(./node_modules/.bin/github-codeowners audit --unloved --only-git)
+
+if [ -n "$OUTPUT" ]; then
+    echo "The repo contains unowned files. Please update the '.github/CODEOWNERS' file to include these files:"
+    echo ""
+    echo "$OUTPUT"
+    echo ""
+    STATUS=1
+fi
+
+OUTPUT=$(./node_modules/.bin/github-codeowners validate 2>&1)
+if [ -n "$OUTPUT" ]; then
+    echo "The '.github/CODEOWNERS' file is not valid:"
+    echo ""
+    echo "$OUTPUT"
+    echo ""
+    STATUS=1
+fi
+
+exit $STATUS

package-lock.json

@@ -1,6 +1,7 @@
 {
   "devDependencies": {
     "eslint": "8.57.0",
+    "github-codeowners": "0.2.1",
     "prettier": "3.4.2"
   }
 }

package.json

@@ -123,3 +123,15 @@ cmd = "$PRECIOUS_ROOT/node_modules/.bin/eslint"
 tidy-flags = "--fix"
 ok-exit-codes = [0]
 lint-failure-exit-codes = [1]
+
+[commands.github-codeowners]
+type = "lint"
+invoke = "once"
+path-args = "none"
+# We need to run this whenever new files are added to make sure they have an owner, so it's easiest
+# to just apply this linter to all files.
+include = "**/*"
+cmd = [ "$PRECIOUS_ROOT/etc/github-codeowners-wrapper.sh" ]
+ok_exit_codes = 0
+lint_failure_exit_codes = 1
+labels = [ "default", "fast-tidy" ]