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

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

diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index e3025dd5..3fdfd269 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -125,3 +125,13 @@ Both are FOSS with independent governance (no Big Tech).
 - No hardcoded secrets
 - 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 |
+|---|---|---|---|
+| `avow-protocol/telegram-bot/avow-telegram-bot/**/*.ts` | 4 | Telegram bot — Telegraf / node-telegram-bot-api are the canonical TS-native libraries for the Bot API; no AffineScript binding planned. | AffineScript Telegram-bot bindings (no scheduled issue). |
+
+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.