chore: Add ReScript enforcement + conversion required (RSR policy)

This repo needs full TS/JS → ReScript conversion.
See TS_CONVERSION_NEEDED.md for details.

Author: Jonathan D.A. Jewell

.claude/CLAUDE.md

@@ -1,28 +1,25 @@
 # Project Instructions
 
-## ⚠️ CONVERSION NEEDED: npm → Deno
+## ⚠️ CONVERSION REQUIRED: TypeScript/JavaScript → ReScript
 
-This repo currently uses npm but needs to be converted to Deno.
+This repository needs FULL conversion from TS/JS to ReScript.
 
-### DO NOT:
-- Run `npm install`
-- Add new npm dependencies
-- Create package-lock.json
-
-### INSTEAD:
-- Use `deno task` for scripts
-- Use npm: specifiers for dependencies (e.g., `import X from "npm:package"`)
-- Create deno.json instead of package.json
+### Policy (RSR)
+- **REQUIRED**: ReScript for all code
+- **FORBIDDEN**: TypeScript (.ts, .tsx)
+- **FORBIDDEN**: JavaScript (.js, .jsx) except generated .res.js
+- **EXCEPTION**: WASM for performance-critical computation
 
-### Conversion Steps:
-1. Analyze package.json dependencies
-2. Create deno.json with equivalent imports/tasks
-3. Update source files to use Deno imports
-4. Remove package.json and package-lock.json
-5. Test with `deno check` and `deno test`
+### When modifying this codebase:
+1. DO NOT add new TS/JS files
+2. When touching existing TS/JS, convert to ReScript
+3. Create `.res` file with equivalent logic
+4. Delete the original TS/JS file
+5. Run `rescript build` to generate JS
 
-## Package Manager Policy (RSR)
+### DO NOT:
+- Add new TypeScript files
+- Write raw JavaScript
+- Use tsc or TypeScript compiler
 
-- **REQUIRED**: Deno for JavaScript/TypeScript
-- **FORBIDDEN**: npm, npx, node_modules (after conversion)
-- **FALLBACK**: Bun only if Deno is impossible
+See TS_CONVERSION_NEEDED.md for full migration guide.

.github/workflows/ts-blocker.yml

@@ -0,0 +1,19 @@
+name: TypeScript/JavaScript Blocker
+on: [push, pull_request]
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Block new TypeScript/JavaScript
+        run: |
+          NEW_TS=$(git diff --name-only --diff-filter=A HEAD~1 2>/dev/null | grep -E '\.(ts|tsx)$' | grep -v '\.gen\.' || true)
+          NEW_JS=$(git diff --name-only --diff-filter=A HEAD~1 2>/dev/null | grep -E '\.(js|jsx)$' | grep -v '\.res\.js$' | grep -v '\.gen\.' | grep -v 'node_modules' || true)
+          
+          if [ -n "$NEW_TS" ] || [ -n "$NEW_JS" ]; then
+            echo "❌ New TS/JS files detected. Use ReScript instead."
+            [ -n "$NEW_TS" ] && echo "$NEW_TS"
+            [ -n "$NEW_JS" ] && echo "$NEW_JS"
+            exit 1
+          fi
+          echo "✅ ReScript policy enforced"

TS_CONVERSION_NEEDED.md

@@ -0,0 +1,23 @@
+# TypeScript/JavaScript → ReScript Conversion Required
+
+This repository is **entirely TS/JS** and needs full conversion to ReScript.
+
+## Conversion Steps
+1. Install ReScript: Add to deno.json or use npm: specifier
+2. Create `rescript.json` configuration
+3. For EACH file:
+   - Create `.res` equivalent
+   - Migrate types (ReScript has excellent type inference)
+   - Update module imports
+   - Test with `rescript build`
+4. Delete all `.ts`/`.tsx`/`.js`/`.jsx` files
+5. Remove TypeScript dependencies
+
+## Policy
+- No NEW TypeScript/JavaScript allowed (CI enforced)
+- Existing code must be migrated to ReScript
+- Generated `.res.js` files are the output
+
+## Resources
+- https://rescript-lang.org/docs/manual/latest/introduction
+- https://rescript-lang.org/docs/manual/latest/migrate-from-typescript