build: add ESLint to script/lint and containerize linting (closes #152)

script/lint

@@ -1,13 +1,51 @@
 #!/bin/sh
-# script/lint: run the linter.
+# script/lint: run the linter (eslint, then prettier --check).
+#
+# Linting is containerized. ESLint results depend on the ESLint version, and
+# the pinned one is the one in the image; a host's own install must not be
+# able to decide whether this repo is green. From a host this therefore builds
+# the Dockerfile's `lint` stage, which runs this same script inside the image.
+#
+# AUTISTMASK_LINT_NATIVE is set only in that image (see the Dockerfile) and is
+# what stops the recursion, so `make check` inside the CI build lints in place
+# instead of trying to reach a docker daemon it does not have.
 set -eu
 
 ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
 
 main() {
     cd "$ROOT"
-    echo "Linting..."
-    yarn run lint 2>&1
+
+    case "${AUTISTMASK_LINT_NATIVE:-}" in
+    1)
+        echo "Linting..."
+        yarn run lint 2>&1
+        return 0
+        ;;
+    "") ;;
+    *)
+        # Set but not recognized: say so rather than silently taking the
+        # docker path, which would look like the variable had no effect.
+        echo "lint: AUTISTMASK_LINT_NATIVE is set to" \
+            "'${AUTISTMASK_LINT_NATIVE}'; the only recognized value is 1" >&2
+        exit 1
+        ;;
+    esac
+
+    if ! command -v docker >/dev/null 2>&1; then
+        echo "lint: docker is required; linting does not run on the host" >&2
+        exit 1
+    fi
+
+    echo "Linting in the pinned container..."
+    # --progress=plain: the default progress renderer collapses the lint
+    # output on success, and a lint run whose output cannot be seen is not
+    # evidence that it ran.
+    #
+    # --output=type=cacheonly: the exit status is the whole result; exporting
+    # an image afterwards costs about ten times the lint itself.
+    docker build --progress=plain --target lint \
+        --output=type=cacheonly . 2>&1
 }
 
 main "$@"

script/test

@@ -1,19 +1,49 @@
 #!/bin/sh
 # script/test: run the test suite.
+#
+# The timeout bounds a hung suite; it is not a performance budget. On a
+# developer host the suite finishes in about 8s and REPO_POLICIES' 30s cap is
+# the bound. Inside the image the same suite also pays a cold jest cache and
+# shares the runner with the rest of the build, which is not what that budget
+# describes, so the Dockerfile raises the bound through
+# AUTISTMASK_TEST_TIMEOUT. A cap a healthy suite can trip on a cold cache
+# produces a red that means nothing, and teaches "just run it again".
 set -eu
 
 ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
+TIMEOUT="${AUTISTMASK_TEST_TIMEOUT:-30}"
 
 main() {
     cd "$ROOT"
-    echo "Running tests..."
-    timeout 30 yarn run test 2>&1 || {
-        echo "--- Rerunning with --verbose for details ---"
-        timeout 30 yarn run test:verbose 2>&1 || true
-        # Always fail: the first run already proved the tests are broken, so a
-        # flaky pass on the rerun must not turn the build green.
+    echo "Running tests (timeout ${TIMEOUT}s)..."
+
+    status=0
+    timeout "$TIMEOUT" yarn run test 2>&1 || status=$?
+    [ "$status" -eq 0 ] && return 0
+
+    # 124 is timeout(1) killing the suite. Say so: a kill is not a failed
+    # assertion, and the verbose rerun would only spend the same wall clock
+    # to be killed again.
+    if [ "$status" -eq 124 ]; then
+        echo "tests: TIMED OUT after ${TIMEOUT}s (no assertion failed)" >&2
+        echo "tests: raise AUTISTMASK_TEST_TIMEOUT if the suite is healthy" >&2
         exit 1
-    }
+    fi
+
+    # 125 is timeout(1) itself failing, which here means AUTISTMASK_TEST_TIMEOUT
+    # is not a duration it accepts. The suite never ran, so it neither timed out
+    # nor failed, and the verbose rerun would only reprint the same complaint.
+    if [ "$status" -eq 125 ]; then
+        echo "tests: DID NOT RUN: timeout(1) rejected AUTISTMASK_TEST_TIMEOUT=\"${TIMEOUT}\"" >&2
+        echo "tests: set it to a duration such as 30 or 180 (see timeout(1))" >&2
+        exit 1
+    fi
+
+    echo "--- Rerunning with --verbose for details ---"
+    timeout "$TIMEOUT" yarn run test:verbose 2>&1 || true
+    # Always fail: the first run already proved the tests are broken, so a
+    # flaky pass on the rerun must not turn the build green.
+    exit 1
 }
 
 main "$@"

script/test-e2e

@@ -5,8 +5,9 @@
 #
 # Deliberately NOT called by script/check or script/test: REPO_POLICIES.md
 # caps make test at 20 seconds and a browser suite does not fit. Run it
-# yourself before touching popup views; it is the only check that can see
-# a used-but-not-imported identifier blow up at runtime.
+# yourself before touching popup views. ESLint's no-undef now catches a
+# used-but-not-imported identifier in make check, but only this suite sees
+# what a view actually does when it runs.
 # .gitea/workflows/e2e.yml also runs it on every push, in a job separate
 # from check so that cap and the local fast path both stay intact.
 #