Implement validation workflow

Author: Ethan-Arrowood

.github/BRANCH_PROTECTION_SETUP.md

@@ -0,0 +1,35 @@
+# Branch Protection Setup Guide
+
+To enforce the lint and format checks before PRs can be merged, follow these steps:
+
+## 1. Go to Branch Protection Settings
+
+1. Navigate to your repository on GitHub
+2. Go to Settings → Branches
+3. Click "Add rule" or edit the existing rule for `main`
+
+## 2. Configure Protection Rules
+
+Set these options:
+
+- ✅ **Require a pull request before merging**
+- ✅ **Require status checks to pass before merging**
+  - Search for and add: `Lint and Format Check`
+- ✅ **Require branches to be up to date before merging**
+- ✅ **Do not allow bypassing the above settings**
+
+## 3. Optional Additional Settings
+
+- ✅ **Dismiss stale PR approvals when new commits are pushed**
+- ✅ **Require review from CODEOWNERS**
+
+## Notes
+
+- The lint/format workflow only runs on PRs, not on pushes to main
+- Your existing deploy workflow will continue to run independently
+- PRs will be blocked from merging if formatting or TypeScript issues are found
+- Contributors can fix issues by running `npm run format` and `npm run typecheck`
+
+## Testing
+
+Create a test PR with formatting issues to verify the workflow blocks merging as expected.

.github/workflows/validate.yaml

@@ -0,0 +1,39 @@
+name: Validate
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+# Concurrency configuration to cancel previous runs on new commits
+concurrency:
+  group: validate-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    name: ${{ matrix.check }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        check:
+          - TypeScript Check
+          - Lint Check
+          - Format Check
+        include:
+          - check: TypeScript Check
+            command: typecheck
+          - check: Lint Check
+            command: lint
+          - check: Format Check
+            command: format:check
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: 'package-lock.json'
+      - name: Install dependencies
+        run: npm ci
+      - name: Run ${{ matrix.check }}
+        run: npm run ${{ matrix.command }}

package.json

@@ -14,7 +14,10 @@
 		"clear": "npm run prebuild -- clean && docusaurus clear",
 		"serve": "docusaurus serve",
 		"typecheck": "tsc",
-		"format": "prettier --write ."
+		"format": "prettier .",
+		"format:check": "npm run format -- --check",
+		"format:write": "npm run format -- --write",
+		"lint": "echo 0;"
 	},
 	"dependencies": {
 		"@docusaurus/core": "^3.8.1",
@@ -50,7 +53,7 @@
 		]
 	},
 	"engines": {
-		"node": ">=22.0"
+		"node": ">=22"
 	},
 	"prettier": "@harperdb/code-guidelines/prettier"
 }