@guardbee/guard-core 0.2.0 → 0.2.1

package/README.md

@@ -1,5 +1,7 @@
 # @guardbee/guard-core
 
+**🇬🇧 English** | [🇹🇷 Türkçe](TR.md) | [🇨🇳 中文](ZH.md)
+
 Shared detectors used by other GuardBee MCP packages. Not an MCP server on its own, just a library — you don't need to install this package directly.
 
 It exists so the same rule runs everywhere: a static scanner flagging a pattern and the runtime proxy blocking it use one implementation.
@@ -25,7 +27,7 @@ A regex alone masks any 11-digit number as a TC Kimlik No and any 16-digit numbe
 | VKN (tax number) | Gelir İdaresi check digit, and a `VKN` / `Vergi No` label before the number |
 | IBAN | ISO 7064 MOD97-10 |
 | Card number | Luhn |
-| Phone (TR) | Mobile (5xx), landline (2xx–4xx) or 850 code after the +90 / 0 prefix |
+| Phone (TR) | Mobile (5xx), landline (2xx–4xx) or 850 code; written with a +90 / 0 prefix or grouped with spaces/dashes, and not part of a URL or id |
 
 A match that fails its check (an order number, a tracking code) is left unchanged.
 

package/TR.md

@@ -0,0 +1,36 @@
+# @guardbee/guard-core
+
+[🇬🇧 English](README.md) | **🇹🇷 Türkçe** | [🇨🇳 中文](ZH.md)
+
+Diğer GuardBee MCP paketlerinin kullandığı ortak dedektörler. Kendi başına bir MCP server değil, sadece bir kütüphane — bu paketi doğrudan kurmanız gerekmez.
+
+Amacı, aynı kuralın her yerde çalışması: bir kalıbı raporlayan statik tarayıcı ile onu çalışma anında engelleyen proxy tek bir uygulamayı kullanır.
+
+## İçinde neler var
+
+| Export | Kullanan | Amaç |
+|---|---|---|
+| `maskPiiInText`, `maskPiiInValue`, `PII_PATTERNS` | security-proxy | Tool sonuçlarında TC Kimlik No, VKN, IBAN, kart, telefon, e-posta, sağlayıcı API key'leri, özel anahtarlar, bağlantı dizeleri ve JWT'leri maskeler; isteğe bağlı bir replacer eşleşmeleri token'a çevirir |
+| `SECRET_RULES` | secret-scanner, security-proxy | 38 secret kuralı (sağlayıcı anahtar ve token'ları, özel anahtarlar, bağlantı dizeleri, JWT). Tarayıcı hepsini raporlar; proxy `broad` işaretli olmayan 32'sini maskeler |
+| `isValidTcKimlik`, `isValidVkn`, `isValidIban`, `isValidLuhn`, `isValidTrPhone` | security-proxy, prompt-leak-scanner | Regex eşleşmesinden sonra doğrulama |
+| `INJECTION_RULES`, `findInjections` | prompt-injection-scanner, security-proxy | İngilizce ve Türkçe 27 injection kuralı, base64 çözme dahil; tarayıcı 17 kesin kuralı kullanır |
+| `scanForPromptInjection`, `scanToolResult` | security-proxy | Kesin bir high/critical kuralda engeller, geri kalan her şeyde uyarır |
+| `classifyTool`, `CAPABILITY_RULES` | toxic-flow-auditor, security-proxy | Bir tool'u untrusted-content / sensitive-data / exfiltration / destructive olarak etiketler (lethal trifecta) |
+
+## Checksum doğrulamalı maskeleme
+
+Tek başına regex, 11 haneli her sayıyı TC Kimlik No, 16 haneli her sayıyı kart numarası sanar. Artık her eşleşme maskelenmeden önce kontrol edilir:
+
+| Kalıp | Kontrol |
+|---|---|
+| TC Kimlik No | Resmi 10. ve 11. hane algoritması |
+| VKN (vergi kimlik no) | Gelir İdaresi kontrol hanesi ve sayıdan önce bir `VKN` / `Vergi No` etiketi |
+| IBAN | ISO 7064 MOD97-10 |
+| Kart numarası | Luhn |
+| Telefon (TR) | Cep (5xx), sabit hat (2xx–4xx) veya 850 kodu; +90 / 0 önekiyle ya da boşluk/tire ile gruplanmış yazılmış olmalı, bir URL'nin veya kimliğin parçası olmamalı |
+
+Kontrolden geçemeyen eşleşme (sipariş no, takip kodu) olduğu gibi bırakılır.
+
+## Kesin ve genel kurallar
+
+Injection ve secret kuralları, sıradan metinde de eşleşen kalıplar için bir `broad` bayrağı taşır: "act as", "developer mode", 40 karakterlik herhangi bir base64 dizisi, yayınlanabilir (publishable) bir Stripe anahtarı. Bulguyu bir kişiye gösteren statik tarayıcılar genel injection kurallarını atlar; çalışma anındaki proxy ise genel bir kurala dayanarak asla engelleme veya maskeleme yapmaz, çünkü oradaki yanlış bir eşleşme oturumu hassas veri tutuyor diye de işaretler ya da meşru bir çağrıyı durdurur.

package/ZH.md

@@ -0,0 +1,36 @@
+# @guardbee/guard-core
+
+[🇬🇧 English](README.md) | [🇹🇷 Türkçe](TR.md) | **🇨🇳 中文**
+
+其他 GuardBee MCP 包共用的检测规则库。它本身不是 MCP 服务器，只是一个库——你不需要直接安装这个包。
+
+它存在的目的是让同一条规则在所有地方运行：报告某个模式的静态扫描器，和在运行时拦截它的代理，使用的是同一份实现。
+
+## 包含内容
+
+| 导出 | 使用方 | 用途 |
+|---|---|---|
+| `maskPiiInText`、`maskPiiInValue`、`PII_PATTERNS` | security-proxy | 对工具结果中的土耳其身份证号（TC Kimlik No）、税号（VKN）、IBAN、银行卡、电话、电子邮件、服务商 API 密钥、私钥、数据库连接串和 JWT 进行脱敏；可选的 replacer 可以把匹配项转换为令牌 |
+| `SECRET_RULES` | secret-scanner、security-proxy | 38 条密钥规则（服务商密钥和令牌、私钥、数据库连接串、JWT）。扫描器会报告全部规则；代理只对未标记 `broad` 的 32 条进行脱敏 |
+| `isValidTcKimlik`、`isValidVkn`、`isValidIban`、`isValidLuhn`、`isValidTrPhone` | security-proxy、prompt-leak-scanner | 正则匹配之后的校验 |
+| `INJECTION_RULES`、`findInjections` | prompt-injection-scanner、security-proxy | 27 条英文和土耳其语注入规则，包含 base64 解码；扫描器使用其中 17 条精确规则 |
+| `scanForPromptInjection`、`scanToolResult` | security-proxy | 命中精确的 high/critical 规则时拦截，其余情况只警告 |
+| `classifyTool`、`CAPABILITY_RULES` | toxic-flow-auditor、security-proxy | 把工具标记为 untrusted-content / sensitive-data / exfiltration / destructive（lethal trifecta） |
+
+## 经校验和验证的脱敏
+
+单靠正则，会把任何 11 位数字当成 TC Kimlik No，把任何 16 位数字当成银行卡号。现在每个匹配在脱敏前都会先经过检查：
+
+| 模式 | 检查 |
+|---|---|
+| TC Kimlik No | 官方的第 10、11 位校验算法 |
+| VKN（税号） | 土耳其税务局（Gelir İdaresi）校验位，且数字前需有 `VKN` / `Vergi No` 标签 |
+| IBAN | ISO 7064 MOD97-10 |
+| 银行卡号 | Luhn |
+| 电话（土耳其） | 手机（5xx）、座机（2xx–4xx）或 850 号段；需带 +90 / 0 前缀，或用空格/短横线分组书写，且不能是 URL 或 ID 的一部分 |
+
+未通过检查的匹配（订单号、快递单号）保持原样。
+
+## 精确规则与通用规则
+
+注入规则和密钥规则都带有一个 `broad` 标记，用于那些在普通文本中也会匹配的模式："act as"、"developer mode"、任意 40 个字符的 base64 串、可公开的 Stripe publishable key。把结果展示给人看的静态扫描器会跳过通用注入规则；运行时代理则从不基于通用规则进行拦截或脱敏，因为在那里一次误匹配还会把会话标记为持有敏感数据，或拦下一次正常调用。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guardbee/guard-core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Shared detectors for GuardBee MCP packages — checksum-validated PII masking, prompt injection patterns, and lethal-trifecta tool classification",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,7 +19,9 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "TR.md",
+    "ZH.md"
   ],
   "keywords": [
     "mcp",