ci: add Biome + Vitest + git-hook quality gates

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+ push:
+ branches: [main]
+ pull_request:
+
+permissions:
+ contents: read
+ packages: read
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 22
+ # Installs @mind-studio/* from GitHub Packages via the committed .npmrc.
+ # GITHUB_TOKEN can read public packages in the same MIND-Studio org; if a
+ # cross-repo read is ever refused, set a NODE_AUTH_TOKEN secret to an org
+ # PAT with read:packages.
+ - run: npm ci
+ env:
+ NODE_AUTH_TOKEN: ${{ secrets.NODE_AUTH_TOKEN || secrets.GITHUB_TOKEN }}
+ # Lint + format gate (Biome). Fails on errors; warnings are the
+ # documented legacy baseline tracked in biome.json.
+ - run: npx biome ci .
+ - run: npx tsc --noEmit
+ - run: npm run test
+ - run: npm run build
+ env:
+ NODE_AUTH_TOKEN: ${{ secrets.NODE_AUTH_TOKEN || secrets.GITHUB_TOKEN }}

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

.husky/pre-push

@@ -0,0 +1,6 @@
+# Fast confidence gate before code leaves this machine — mirrors CI's
+# correctness checks. The slow `next build` is left to CI.
+# Bypass in a pinch with `git push --no-verify`.
+npm run lint || exit 1
+npm run typecheck || exit 1
+npm run test || exit 1

biome.json

@@ -0,0 +1,42 @@
+{
+ "$schema": "https://biomejs.dev/schemas/2.5.0/schema.json",
+ "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
+ "files": {
+ "ignoreUnknown": true,
+ "includes": [
+ "**",
+ "!**/public",
+ "!**/scripts",
+ "!**/next-env.d.ts",
+ "!**/package-lock.json",
+ "!**/*.css"
+ ]
+ },
+ "formatter": { "enabled": true, "indentStyle": "space", "indentWidth": 2, "lineWidth": 100 },
+ "linter": {
+ "enabled": true,
+ "domains": { "next": "recommended", "react": "recommended" },
+ "rules": {
+ "recommended": true,
+ "correctness": { "useExhaustiveDependencies": "warn" },
+ "security": { "noDangerouslySetInnerHtml": "warn" },
+ "suspicious": {
+ "noImplicitAnyLet": "warn",
+ "useIterableCallbackReturn": "warn",
+ "noArrayIndexKey": "warn",
+ "noCommentText": "warn",
+ "noControlCharactersInRegex": "warn",
+ "noAssignInExpressions": "warn"
+ },
+ "a11y": {
+ "useButtonType": "warn",
+ "noLabelWithoutControl": "warn",
+ "noStaticElementInteractions": "warn",
+ "noSvgWithoutTitle": "warn",
+ "noAutofocus": "warn"
+ }
+ }
+ },
+ "javascript": { "formatter": { "quoteStyle": "double" } },
+ "assist": { "enabled": true, "actions": { "source": { "organizeImports": "on" } } }
+}

infra/css/config.json

@@ -10,7 +10,7 @@
  " - PodResourcesGenerator.templateFolder -> seed NEW pods from the Mind pod template (Welcome README)",
  "All filePaths point at locations populated by the docker-compose bind mount (./infra/css -> /css-host)."
  ],
- "import": ["css:config/file.json"],
+ "import": ["css:config/file.json"],
  "@graph": [
  {
  "@type": "Override",