From 21c00ce45c7b1282ed1914fc682234c534f1c1d7 Mon Sep 17 00:00:00 2001
From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com>
Date: Sun, 3 May 2026 23:19:59 +0100
Subject: [PATCH] docs(claude): add TypeScript Exemptions table (rationale +
 unblock condition)

---
 .claude/CLAUDE.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index c9d7b96..bef1937 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -81,3 +81,12 @@ Both are FOSS with independent governance (no Big Tech).
 - SHA-pinned dependencies
 - SPDX license headers on all files
 
+### TypeScript Exemptions (Approved)
+
+The hyperpolymath "no new TypeScript" policy has the following approved exemptions in this repo. These are *not* policy violations — they are documented carve-outs.
+
+| Path | Files | Rationale | Unblock condition |
+|---|---|---|---|
+| `tools/**/*.ts` | 13 | tools/ subdirectory: monitoring-api (Express), stale scanner (Node CLI), github-action (Octokit). Each tool depends on a Node-native library that does not yet have an AffineScript binding. | AffineScript Node-target codegen (affinescript#35) + per-tool bindings (Octokit, Express, ArangoDB driver). |
+
+Adding to this list requires explicit user approval and an unblock condition. New TypeScript files outside this list are blocked by the RSR antipattern check.