refactor: migrate validation scripts to Vitest test suite

Migrated validation scripts from standalone ESM modules to Vitest test framework for better maintainability and integration. This aligns validation checks with modern testing practices and enables running validations as part of the standard test pipeline.

Changes:
- Migrated all validation scripts to Vitest test suite under tests/validate/
- Updated npm scripts: validate:manifests → test:validate, validate:urls → test:urls
- Added vitest.config.ts with Node environment configuration
- Updated CI workflows to use new test commands and Node.js 22
- Updated pre-commit hook to run test:validate
- Updated documentation to reflect new test-based approach
- Removed legacy scripts/validate/ directory
- Updated @types/node from v20 to v22 for compatibility
- Added vitest as dev dependency

This change improves code organization, enables better test reporting, and unifies validation with the project's testing infrastructure.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: ericyangpan

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
@@ -40,7 +40,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
@@ -49,8 +49,8 @@ jobs:
       - name: Run TypeScript type check
         run: npx tsc --noEmit
 
-  validate-manifests:
-    name: Validate Manifests
+  tests-validate:
+    name: Tests (Validate)
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
@@ -59,17 +59,17 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Validate manifest schemas
-        run: npm run validate:manifests
+      - name: Run validation tests
+        run: npm run test:validate
 
-  validate-urls:
-    name: Validate URLs
+  tests-urls:
+    name: Tests (URLs)
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
@@ -78,14 +78,14 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
       - name: Validate URLs in manifests
-        run: npm run validate:urls
+        run: npm run test:urls
         continue-on-error: true # URLs may be temporarily unavailable
 
   spell-check:
@@ -98,7 +98,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
@@ -117,7 +117,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
@@ -140,7 +140,7 @@ jobs:
   ci-success:
     name: CI Success
     runs-on: ubuntu-latest
-    needs: [lint, type-check, validate-manifests, validate-urls, spell-check, build]
+    needs: [lint, type-check, tests-validate, tests-urls, spell-check, build]
     if: always()
     steps:
       - name: Check all jobs

.github/workflows/deploy-preview.yml

@@ -22,14 +22,14 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Validate manifests
-        run: npm run validate:manifests
+      - name: Run validation tests
+        run: npm run test:validate
 
       - name: Generate manifests and metadata
         run: |

.github/workflows/deploy-production.yml

@@ -22,14 +22,14 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Validate manifests
-        run: npm run validate:manifests
+      - name: Run validation tests
+        run: npm run test:validate
 
       - name: Generate manifests and metadata
         run: |

.github/workflows/scheduled-checks.yml

@@ -25,15 +25,15 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
       - name: Validate URLs
         id: validate
-        run: npm run validate:urls
+        run: npm run test:urls
         continue-on-error: true
 
       - name: Create issue if URLs are broken
@@ -88,7 +88,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies

.husky/pre-commit

@@ -1,2 +1,3 @@
 npx lint-staged
 npm run check
+npm run test:validate

CONTRIBUTING.md

@@ -87,8 +87,8 @@ cd aicodingstack.io
 # Install dependencies
 npm install
 
-# Validate existing manifests
-npm run validate:manifests
+# Run validation tests
+npm run test:validate
 
 # Generate manifests and metadata
 npm run generate:manifests
@@ -104,8 +104,8 @@ Visit `http://localhost:3000` to see the site.
 
 - `npm run dev` - Start development server
 - `npm run build` - Build for production
-- `npm run validate:manifests` - Validate all manifest JSON files
-- `npm run validate:urls` - Check URL accessibility
+- `npm run test:validate` - Run repository validation tests (schemas, translations, alignment, etc.)
+- `npm run test:urls` - Check URL accessibility (networked; CI-oriented)
 - `npm run lint` - Run ESLint
 - `npm run spell` - Run spell checker
 - `npm test` - Run tests (if available)
@@ -188,11 +188,11 @@ Create a file in `manifests/models/your-model.json`:
 Before submitting, validate your manifest:
 
 ```bash
-# Validate all manifests
-npm run validate:manifests
+# Run validation tests
+npm run test:validate
 
-# Validate URLs
-npm run validate:urls
+# Validate URLs (networked)
+npm run test:urls
 ```
 
 ### Best Practices
@@ -256,9 +256,8 @@ chore(deps): update Next.js to 15.1.0
 2. ✅ **Make your changes** following the guidelines
 3. ✅ **Validate locally**:
    ```bash
-   npm run validate:manifests
-   npm run validate:urls
-   npm run lint
+   npm run test:validate
+   npm run test:urls
    npm run spell
    npm run build
    ```

docs/SCHEMA-ARCHITECTURE.md

@@ -368,6 +368,6 @@ All schemas use JSON Schema Draft 2020-12 with strict mode:
 - Format and pattern validation for URLs
 - Enum validation for controlled vocabularies
 
-**Validation Command**: `npm run validate:manifests`
+**Validation Command**: `npm run test:validate`
 
 **Current Status**: ✅ All 9 manifest files validated successfully

docs/SCHEMA-REFACTORING-SUMMARY.md

@@ -155,5 +155,5 @@ All manifest files now pass validation:
 1. **Consistent Naming**: Always use descriptive field names that reflect the specific use case
 2. **Schema Composition**: Prefer composition over duplication - create reusable schema fragments
 3. **Documentation**: Keep this summary updated when making future schema changes
-4. **Validation**: Always run `npm run validate:manifests` before committing schema changes
+4. **Validation**: Always run `npm run test:validate` before committing schema changes