Add single-command test run script and update documentation

Author: SableRaf

AGENTS.md

@@ -39,6 +39,8 @@ node --test .github/scripts/plus-code.test.mjs
 node --test .github/scripts/data-json.test.mjs
 ```
 
+Need to run the tests end-to-end? `./scripts/run-tests.sh` executes the helper, intake, and plus-code suites, builds the Astro site via `npm --prefix pcd-website run build`, and then runs `data-json.test.mjs` in sequence. Run this script from the repo root after installing dependencies so you get the full battery of checks in one shot.
+
 No install needed — `open-location-code` is already available at `pcd-website/node_modules/`.
 
 ### Testing protocol

TEST.md

@@ -74,6 +74,12 @@ These tests cover the shared pure functions extracted into `event-issue-helpers.
 
 ---
 
+## Single-command test run
+
+Run `./scripts/run-tests.sh` from the repo root after installing dependencies (`pcd-website` already has `node_modules/` from `npm install`). The script executes the helper, intake, and plus-code suites, then builds the Astro site (`npm run build` inside `pcd-website/`) before running `data-json.test.mjs`. Use this single command whenever you want to verify the full test battery end to end.
+
+---
+
 ## Plus Code functions
 
 **File:** `.github/scripts/plus-code.test.mjs`

pcd-website/package.json

@@ -6,7 +6,8 @@
     "dev": "astro dev",
     "build": "astro build",
     "preview": "astro preview",
-    "astro": "astro"
+    "astro": "astro",
+    "test": "../scripts/run-tests.sh"
   },
   "dependencies": {
     "@astrojs/vue": "^5.1.4",

scripts/run-tests.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Run from repo root to keep relative paths consistent.
+root_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$root_dir"
+
+tests=(
+  ".github/scripts/event-issue-helpers.test.mjs"
+  ".github/scripts/process-new-event-issue.test.mjs"
+  ".github/scripts/process-edit-event-issue.test.mjs"
+  ".github/scripts/plus-code.test.mjs"
+)
+
+for test in "${tests[@]}"; do
+  printf '\n=== %s ===\n' "$test"
+  node --test "$test"
+done
+
+printf '\n=== Build data.json dependencies ===\n'
+npm --prefix "${root_dir}/pcd-website" run build
+
+printf '\n=== .github/scripts/data-json.test.mjs ===\n'
+node --test ".github/scripts/data-json.test.mjs"