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

@@ -0,0 +1,25 @@
+# Project Instructions
+
+## ⚠️ CONVERSION REQUIRED: TypeScript/JavaScript → ReScript
+
+This repository needs FULL conversion from TS/JS to ReScript.
+
+### 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
+
+### 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
+
+### DO NOT:
+- Add new TypeScript files
+- Write raw JavaScript
+- Use tsc or TypeScript compiler
+
+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"

MANUAL_REVIEW_NEEDED.md

@@ -0,0 +1,17 @@
+# ⚠️ Large Codebase - Manual Review Required
+
+This repository has substantial TS/JS code (>5000 lines).
+
+## Challenges
+- Large codebase requires careful migration planning
+- May have complex type dependencies
+- Third-party libraries may need bindings
+
+## Recommended Approach
+1. **Audit**: Catalog all TS/JS files and dependencies
+2. **Prioritize**: Identify core vs peripheral code
+3. **Incremental**: Convert module by module
+4. **Test**: Ensure each converted module works
+5. **WASM**: Consider for heavy computation sections
+
+## Do NOT attempt automated bulk conversion.

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