Add html-validate check, fix privacy policy HTML

- Added `html-validate` as a website check (runs on built HTML after `website-build`)
- Configured `.htmlvalidate.json` to focus on structural validity, disabling noisy rules from framework-generated code
- Fixed `privacy-policy.astro`: unclosed `<ul>`, `<li>` nested inside `<li>`, and sections 3–12 incorrectly nested inside the first list
- Updated AGENTS.md and check runner CLAUDE.md

Author: vdavid

AGENTS.md

@@ -53,7 +53,7 @@ Run the smallest set of checks possible for efficiency while maintaining confide
   |cargo-audit|cargo-deny|cargo-udeps|jscpd-rust|cfg-gate|rust-tests|rust-tests-linux (slow)|license-server-prettier
   |license-server-eslint|license-server-typecheck|license-server-tests|gofmt|go-vet|staticcheck|ineffassign|misspell
   |gocyclo|nilaway|deadcode|go-tests|website-prettier|website-eslint|website-typecheck|website-build
-  |website-e2e|docker-build|pnpm-audit|file-length}` (can use multiple `--check` flags or even a comma-separated list)
+  |website-e2e|html-validate|docker-build|pnpm-audit|file-length}` (can use multiple `--check` flags or even a comma-separated list)
 - Run all: `./scripts/check.sh`. Runs all tests, linters, and formatters (with auto fixing) for all apps.
 - **E2E testing**: Docker E2E, Playwright smoke tests, VNC debugging, fixture system — see the colocated
   CLAUDE.md files in `apps/desktop/test/e2e-linux/` and `apps/desktop/test/e2e-macos/`

apps/website/.htmlvalidate.json

@@ -0,0 +1,12 @@
+{
+    "extends": ["html-validate:recommended"],
+    "rules": {
+        "no-inline-style": "off",
+        "hidden-focusable": "off",
+        "unique-landmark": "off",
+        "prefer-native-element": "off",
+        "no-trailing-whitespace": "off",
+        "tel-non-breaking": "off",
+        "no-raw-characters": "off"
+    }
+}

apps/website/package.json

@@ -39,6 +39,7 @@
         "eslint-plugin-astro": "^1.6.0",
         "eslint-plugin-prettier": "^5.5.5",
         "globals": "^17.4.0",
+        "html-validate": "^10.11.1",
         "prettier": "^3.8.1",
         "prettier-plugin-astro": "^0.14.1",
         "typescript": "^5.9.3",

apps/website/src/pages/privacy-policy.astro

@@ -158,7 +158,7 @@ tests, type checkers before tests.
 |-----|------|--------|
 | Desktop | Rust | rustfmt, clippy, cargo-audit, cargo-deny, cargo-udeps, jscpd, tests, tests-linux (slow) |
 | Desktop | Svelte | prettier, eslint, stylelint, css-unused, svelte-check, knip, type-drift, tests, smoke, e2e-linux-typecheck, e2e-linux (slow) |
-| Website | Astro | prettier, eslint, typecheck, build, e2e |
+| Website | Astro | prettier, eslint, typecheck, build, html-validate, e2e |
 | Website | Docker | docker-build |
 | License server | TS | prettier, eslint, typecheck, tests |
 | Scripts | Go | gofmt, go-vet, staticcheck, ineffassign, misspell, gocyclo, nilaway, deadcode, go-tests |

pnpm-lock.yaml

@@ -231,6 +231,15 @@ var AllChecks = []CheckDefinition{
 		DependsOn:   []string{"website-typecheck"},
 		Run:         RunWebsiteBuild,
 	},
+	{
+		ID:          "website-html-validate",
+		Nickname:    "html-validate",
+		DisplayName: "html-validate",
+		App:         AppWebsite,
+		Tech:        "🚀 Astro",
+		DependsOn:   []string{"website-build"},
+		Run:         RunWebsiteHTMLValidate,
+	},
 	{
 		ID:          "website-e2e",
 		DisplayName: "e2e",

scripts/check/CLAUDE.md

@@ -0,0 +1,26 @@
+package checks
+
+import (
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+)
+
+// RunWebsiteHTMLValidate runs html-validate on the built website HTML files.
+func RunWebsiteHTMLValidate(ctx *CheckContext) (CheckResult, error) {
+	websiteDir := filepath.Join(ctx.RootDir, "apps", "website")
+	distDir := filepath.Join(websiteDir, "dist")
+
+	if _, err := os.Stat(distDir); os.IsNotExist(err) {
+		return Skipped("dist/ not found (run website-build first)"), nil
+	}
+
+	cmd := exec.Command("pnpm", "exec", "html-validate", "dist/**/*.html")
+	cmd.Dir = websiteDir
+	output, err := RunCommand(cmd, true)
+	if err != nil {
+		return CheckResult{}, fmt.Errorf("HTML validation failed\n%s", indentOutput(output))
+	}
+	return Success("All HTML files valid"), nil
+}