@mcptoolshop/ai-loadout 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.0.3 — 2026-03-06
+
+- Brand logo URL (mcp-tool-shop-org/brand)
+- Code coverage via c8 + Codecov badge
+- Translations re-done via polyglot-mcp (TranslateGemma 12B)
+- SHIP_GATE.md and SCORECARD.md (shipcheck audit: 100% pass)
+- dependabot.yml (monthly, grouped)
+- .gitignore: site/.astro/, site/dist/, .polyglot-cache.json
+
+## 1.0.2 — 2026-03-06
+
+- Shipcheck gates added (SHIP_GATE.md, SCORECARD.md)
+- dependabot.yml
+
 ## 1.0.1 — 2026-03-06
 
 - Add `hint` field to `ValidationIssue` (Tier 1 error shape compliance)

package/README.es.md

@@ -0,0 +1,198 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-loadout/readme.png" width="400" alt="ai-loadout">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ai-loadout/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-loadout/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://codecov.io/gh/mcp-tool-shop-org/ai-loadout"><img src="https://codecov.io/gh/mcp-tool-shop-org/ai-loadout/graph/badge.svg" alt="Coverage"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/ai-loadout"><img src="https://img.shields.io/npm/v/@mcptoolshop/ai-loadout" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/ai-loadout/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+Enrutador de conocimiento contextual para agentes de IA.
+
+`ai-loadout` es el formato de la tabla de distribución y el motor de coincidencia que permite a los agentes de IA cargar el conocimiento adecuado para la tarea en cuestión. En lugar de incluir todo en el contexto, se mantiene un índice pequeño y se cargan los datos según sea necesario.
+
+Piénselo como la configuración de un juego: se equipa al agente con exactamente el conocimiento que necesita antes de cada misión.
+
+## Instalación
+
+```bash
+npm install @mcptoolshop/ai-loadout
+```
+
+## Conceptos básicos
+
+### La tabla de distribución
+
+Un `LoadoutIndex` es un índice estructurado de datos de conocimiento:
+
+```json
+{
+  "version": "1.0.0",
+  "generated": "2026-03-06T12:00:00Z",
+  "entries": [
+    {
+      "id": "github-actions",
+      "path": ".rules/github-actions.md",
+      "keywords": ["ci", "workflow", "runner"],
+      "patterns": ["ci_pipeline"],
+      "priority": "domain",
+      "summary": "CI triggers, path gating, runner cost control",
+      "triggers": { "task": true, "plan": true, "edit": false },
+      "tokens_est": 680,
+      "lines": 56
+    }
+  ],
+  "budget": {
+    "always_loaded_est": 320,
+    "on_demand_total_est": 8100,
+    "avg_task_load_est": 520,
+    "avg_task_load_observed": null
+  }
+}
+```
+
+### Niveles de prioridad
+
+| Nivel | Comportamiento | Ejemplo |
+|------|----------|---------|
+| `core` | Cargado siempre | "nunca omitir pruebas para que la integración continua sea exitosa" |
+| `domain` | Cargado cuando las palabras clave de la tarea coinciden | Reglas de integración continua al editar flujos de trabajo |
+| `manual` | Nunca se carga automáticamente, solo búsqueda explícita | Aspectos técnicos de la plataforma que pueden ser difíciles de entender |
+
+### Metadatos del archivo de datos
+
+Cada archivo de datos contiene sus propios metadatos de enrutamiento:
+
+```markdown
+---
+id: github-actions
+keywords: [ci, workflow, runner, dependabot]
+patterns: [ci_pipeline]
+priority: domain
+triggers:
+  task: true
+  plan: true
+  edit: false
+---
+
+# GitHub Actions Rules
+CI minutes are finite...
+```
+
+El metadato es la fuente de la verdad. El índice se deriva de él.
+
+## API
+
+### `matchLoadout(tarea, índice)`
+
+Compara una descripción de la tarea con un índice de configuración. Devuelve las entradas que deben cargarse, clasificadas por la fuerza de la coincidencia.
+
+```typescript
+import { matchLoadout } from "@mcptoolshop/ai-loadout";
+
+const results = matchLoadout("fix the CI workflow", index);
+// [{ entry: { id: "github-actions", ... }, score: 0.67, matchedKeywords: ["ci", "workflow"] }]
+```
+
+- Las entradas principales siempre se incluyen (puntuación 1.0)
+- Las entradas manuales nunca se incluyen automáticamente
+- Las entradas de dominio se puntúan según la superposición de palabras clave + bonificación de patrones
+- Los resultados se ordenan por puntuación descendente
+
+### `lookupEntry(id, índice)`
+
+Busca una entrada específica por ID. Para entradas manuales o acceso explícito.
+
+```typescript
+import { lookupEntry } from "@mcptoolshop/ai-loadout";
+
+const entry = lookupEntry("github-actions", index);
+```
+
+### `parseFrontmatter(contenido)`
+
+Analiza el metadato en formato YAML de un archivo de datos.
+
+```typescript
+import { parseFrontmatter } from "@mcptoolshop/ai-loadout";
+
+const { frontmatter, body } = parseFrontmatter(fileContent);
+if (frontmatter) {
+  console.log(frontmatter.id, frontmatter.keywords);
+}
+```
+
+### `serializeFrontmatter(fm)`
+
+Serializa un objeto `Frontmatter` de nuevo a una cadena.
+
+### `validateIndex(índice)`
+
+Valida la integridad estructural de un `LoadoutIndex`. Devuelve un array de problemas.
+
+```typescript
+import { validateIndex } from "@mcptoolshop/ai-loadout";
+
+const issues = validateIndex(index);
+const errors = issues.filter(i => i.severity === "error");
+if (errors.length > 0) {
+  console.error("Index has errors:", errors);
+}
+```
+
+Comprobaciones: campos obligatorios, IDs únicos, formato kebab-case, límites del resumen, presencia de palabras clave para entradas de dominio, prioridades válidas, presupuestos no negativos.
+
+### `estimateTokens(texto)`
+
+Estima el número de tokens a partir de un texto. Utiliza la heurística de chars/4.
+
+```typescript
+import { estimateTokens } from "@mcptoolshop/ai-loadout";
+
+const tokens = estimateTokens(fileContent); // ~250
+```
+
+## Tipos
+
+```typescript
+import type {
+  LoadoutEntry,
+  LoadoutIndex,
+  Frontmatter,
+  MatchResult,
+  ValidationIssue,
+  Priority,       // "core" | "domain" | "manual"
+  Triggers,       // { task, plan, edit }
+  Budget,
+} from "@mcptoolshop/ai-loadout";
+```
+
+## Consumidores
+
+- **[@mcptoolshop/claude-rules](https://github.com/mcp-tool-shop-org/claude-rules)** — Optimizador de CLAUDE.md para Claude Code. Utiliza ai-loadout para la tabla de distribución y la coincidencia.
+
+## Seguridad
+
+Este paquete es una biblioteca de datos pura. No accede al sistema de archivos, realiza solicitudes de red ni recopila datos de telemetría. Toda la entrada/salida es responsabilidad del consumidor.
+
+### Modelo de amenazas
+
+| Amenaza | Mitigación |
+|--------|------------|
+| Metadato de entrada con formato incorrecto | `parseFrontmatter()` devuelve `null` en caso de entrada no válida; no se generan excepciones ni se utiliza `eval` |
+| Contaminación de prototipos | El analizador personalizado utiliza literales de objetos simples, no `JSON.parse` de estructuras anidadas no confiables. |
+| Índice con datos incorrectos | `validateIndex()` detecta problemas estructurales antes de que se propaguen. |
+| Ataque de denegación de servicio con expresiones regulares | No se utilizan expresiones regulares proporcionadas por el usuario; los patrones se comparan como búsquedas de cadenas simples. |
+
+Consulte [SECURITY.md](SECURITY.md) para obtener la política de seguridad completa.
+
+---
+
+Creado por [MCP Tool Shop](https://mcp-tool-shop.github.io/)

package/README.fr.md

@@ -0,0 +1,198 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.md">English</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-loadout/readme.png" width="400" alt="ai-loadout">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ai-loadout/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-loadout/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://codecov.io/gh/mcp-tool-shop-org/ai-loadout"><img src="https://codecov.io/gh/mcp-tool-shop-org/ai-loadout/graph/badge.svg" alt="Coverage"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/ai-loadout"><img src="https://img.shields.io/npm/v/@mcptoolshop/ai-loadout" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/ai-loadout/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+Routeur de connaissances contextuel pour les agents d'IA.
+
+`ai-loadout` est le format de table de répartition et le moteur de correspondance qui permet aux agents d'IA de charger les connaissances appropriées pour la tâche en cours. Au lieu de tout inclure dans le contexte, vous conservez un index minimal et chargez les données à la demande.
+
+Considérez cela comme une configuration de jeu : vous équipez l'agent des connaissances dont il a strictement besoin avant chaque mission.
+
+## Installation
+
+```bash
+npm install @mcptoolshop/ai-loadout
+```
+
+## Concepts clés
+
+### La table de répartition
+
+Un `LoadoutIndex` est un index structuré des données de connaissances :
+
+```json
+{
+  "version": "1.0.0",
+  "generated": "2026-03-06T12:00:00Z",
+  "entries": [
+    {
+      "id": "github-actions",
+      "path": ".rules/github-actions.md",
+      "keywords": ["ci", "workflow", "runner"],
+      "patterns": ["ci_pipeline"],
+      "priority": "domain",
+      "summary": "CI triggers, path gating, runner cost control",
+      "triggers": { "task": true, "plan": true, "edit": false },
+      "tokens_est": 680,
+      "lines": 56
+    }
+  ],
+  "budget": {
+    "always_loaded_est": 320,
+    "on_demand_total_est": 8100,
+    "avg_task_load_est": 520,
+    "avg_task_load_observed": null
+  }
+}
+```
+
+### Niveaux de priorité
+
+| Niveau | Comportement | Exemple |
+|------|----------|---------|
+| `core` | Toujours chargé | "Ne jamais ignorer les tests pour que l'intégration continue soit réussie" |
+| `domain` | Chargé lorsque les mots-clés de la tâche correspondent | Règles d'intégration continue lors de la modification des flux de travail |
+| `manual` | Jamais chargé automatiquement, recherche explicite uniquement | Détails spécifiques à certaines plateformes |
+
+### Métadonnées du fichier de données
+
+Chaque fichier de données contient ses propres métadonnées de routage :
+
+```markdown
+---
+id: github-actions
+keywords: [ci, workflow, runner, dependabot]
+patterns: [ci_pipeline]
+priority: domain
+triggers:
+  task: true
+  plan: true
+  edit: false
+---
+
+# GitHub Actions Rules
+CI minutes are finite...
+```
+
+Les métadonnées sont la source de vérité. L'index est dérivé de celles-ci.
+
+## API
+
+### `matchLoadout(tâche, index)`
+
+Fait correspondre une description de tâche à un index de configuration. Renvoie les entrées qui doivent être chargées, classées par force de correspondance.
+
+```typescript
+import { matchLoadout } from "@mcptoolshop/ai-loadout";
+
+const results = matchLoadout("fix the CI workflow", index);
+// [{ entry: { id: "github-actions", ... }, score: 0.67, matchedKeywords: ["ci", "workflow"] }]
+```
+
+- Les entrées principales sont toujours incluses (score de 1,0)
+- Les entrées manuelles ne sont jamais incluses automatiquement
+- Les entrées spécifiques à un domaine sont notées en fonction du chevauchement des mots-clés et d'un bonus de motif
+- Les résultats sont triés par score décroissant
+
+### `lookupEntry(id, index)`
+
+Recherche une entrée spécifique par ID. Pour les entrées manuelles ou l'accès explicite.
+
+```typescript
+import { lookupEntry } from "@mcptoolshop/ai-loadout";
+
+const entry = lookupEntry("github-actions", index);
+```
+
+### `parseFrontmatter(contenu)`
+
+Analyse les métadonnées au format YAML d'un fichier de données.
+
+```typescript
+import { parseFrontmatter } from "@mcptoolshop/ai-loadout";
+
+const { frontmatter, body } = parseFrontmatter(fileContent);
+if (frontmatter) {
+  console.log(frontmatter.id, frontmatter.keywords);
+}
+```
+
+### `serializeFrontmatter(fm)`
+
+Série les métadonnées d'un objet `Frontmatter` en une chaîne de caractères.
+
+### `validateIndex(index)`
+
+Valide l'intégrité structurelle d'un `LoadoutIndex`. Renvoie un tableau de problèmes.
+
+```typescript
+import { validateIndex } from "@mcptoolshop/ai-loadout";
+
+const issues = validateIndex(index);
+const errors = issues.filter(i => i.severity === "error");
+if (errors.length > 0) {
+  console.error("Index has errors:", errors);
+}
+```
+
+Vérifications : champs obligatoires, ID uniques, format kebab-case, limites du résumé, présence de mots-clés pour les entrées de domaine, priorités valides, budgets non négatifs.
+
+### `estimateTokens(texte)`
+
+Estime le nombre de jetons à partir d'un texte. Utilise l'heuristique chars/4.
+
+```typescript
+import { estimateTokens } from "@mcptoolshop/ai-loadout";
+
+const tokens = estimateTokens(fileContent); // ~250
+```
+
+## Types
+
+```typescript
+import type {
+  LoadoutEntry,
+  LoadoutIndex,
+  Frontmatter,
+  MatchResult,
+  ValidationIssue,
+  Priority,       // "core" | "domain" | "manual"
+  Triggers,       // { task, plan, edit }
+  Budget,
+} from "@mcptoolshop/ai-loadout";
+```
+
+## Consommateurs
+
+- **[@mcptoolshop/claude-rules](https://github.com/mcp-tool-shop-org/claude-rules)** — Optimiseur CLAUDE.md pour Claude Code. Utilise ai-loadout pour la table de répartition et la correspondance.
+
+## Sécurité
+
+Ce paquet est une bibliothèque de données pure. Il n'accède pas au système de fichiers, ne fait pas de requêtes réseau ni ne collecte de données télémétriques. Toutes les opérations d'entrée/sortie sont de la responsabilité du consommateur.
+
+### Modèle de menace
+
+| Menace | Atténuation |
+|--------|------------|
+| Métadonnées corrompues | `parseFrontmatter()` renvoie `null` en cas d'entrée invalide, sans exceptions ni évaluation de code. |
+| Pollution de prototype | L'analyseur personnalisé utilise des littéraux d'objets simples, sans `JSON.parse` de structures imbriquées non fiables. |
+| Index avec des données incorrectes | `validateIndex()` détecte les problèmes structurels avant qu'ils ne se propagent. |
+| Attaque par regex DoS | Aucune expression régulière fournie par l'utilisateur, les motifs sont correspondés comme des recherches de chaînes simples. |
+
+Consultez [SECURITY.md](SECURITY.md) pour la politique de sécurité complète.
+
+---
+
+Développé par [MCP Tool Shop](https://mcp-tool-shop.github.io/)

package/README.hi.md

@@ -0,0 +1,198 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.md">English</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-loadout/readme.png" width="400" alt="ai-loadout">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ai-loadout/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-loadout/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://codecov.io/gh/mcp-tool-shop-org/ai-loadout"><img src="https://codecov.io/gh/mcp-tool-shop-org/ai-loadout/graph/badge.svg" alt="Coverage"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/ai-loadout"><img src="https://img.shields.io/npm/v/@mcptoolshop/ai-loadout" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/ai-loadout/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+संदर्भ-जागरूक ज्ञान राउटर जो एआई एजेंटों के लिए है।
+
+`ai-loadout` एक डिस्पैच टेबल फॉर्मेट और मिलान इंजन है जो एआई एजेंटों को उस कार्य के लिए सही ज्ञान लोड करने की अनुमति देता है। संदर्भ में सब कुछ डालने के बजाय, आप एक छोटा इंडेक्स रखते हैं और आवश्यकतानुसार डेटा लोड करते हैं।
+
+इसे एक गेम लोडआउट की तरह सोचें - आप एजेंट को प्रत्येक मिशन से पहले आवश्यक ज्ञान से लैस करते हैं।
+
+## इंस्टॉल करें
+
+```bash
+npm install @mcptoolshop/ai-loadout
+```
+
+## मुख्य अवधारणाएं
+
+### डिस्पैच टेबल
+
+`LoadoutIndex` ज्ञान डेटा के एक संरचित इंडेक्स है:
+
+```json
+{
+  "version": "1.0.0",
+  "generated": "2026-03-06T12:00:00Z",
+  "entries": [
+    {
+      "id": "github-actions",
+      "path": ".rules/github-actions.md",
+      "keywords": ["ci", "workflow", "runner"],
+      "patterns": ["ci_pipeline"],
+      "priority": "domain",
+      "summary": "CI triggers, path gating, runner cost control",
+      "triggers": { "task": true, "plan": true, "edit": false },
+      "tokens_est": 680,
+      "lines": 56
+    }
+  ],
+  "budget": {
+    "always_loaded_est": 320,
+    "on_demand_total_est": 8100,
+    "avg_task_load_est": 520,
+    "avg_task_load_observed": null
+  }
+}
+```
+
+### प्राथमिकता स्तर
+
+| स्तर | व्यवहार | उदाहरण |
+|------|----------|---------|
+| `core` | हमेशा लोड किया जाता है | "CI को हरा करने के लिए कभी भी परीक्षणों को छोड़ें नहीं" |
+| `domain` | जब कार्य कीवर्ड मेल खाते हैं तो लोड किया जाता है | वर्कफ़्लो संपादित करते समय CI नियम |
+| `manual` | कभी भी स्वचालित रूप से लोड नहीं किया जाता है, केवल स्पष्ट खोज | अस्पष्ट प्लेटफ़ॉर्म संबंधी समस्याएं |
+
+### डेटा का प्रारंभिक भाग
+
+प्रत्येक डेटा फ़ाइल में अपना रूटिंग मेटाडेटा होता है:
+
+```markdown
+---
+id: github-actions
+keywords: [ci, workflow, runner, dependabot]
+patterns: [ci_pipeline]
+priority: domain
+triggers:
+  task: true
+  plan: true
+  edit: false
+---
+
+# GitHub Actions Rules
+CI minutes are finite...
+```
+
+प्रारंभिक भाग सत्य का स्रोत है। इंडेक्स इससे प्राप्त होता है।
+
+## एपीआई
+
+### `matchLoadout(task, index)`
+
+एक कार्य विवरण को लोडआउट इंडेक्स के खिलाफ मिलाएं। उन प्रविष्टियों को लौटाता है जिन्हें लोड किया जाना चाहिए, जो मिलान की शक्ति के आधार पर क्रमबद्ध हैं।
+
+```typescript
+import { matchLoadout } from "@mcptoolshop/ai-loadout";
+
+const results = matchLoadout("fix the CI workflow", index);
+// [{ entry: { id: "github-actions", ... }, score: 0.67, matchedKeywords: ["ci", "workflow"] }]
+```
+
+- मुख्य प्रविष्टियाँ हमेशा शामिल होती हैं (स्कोर 1.0)
+- मैन्युअल प्रविष्टियाँ कभी भी स्वचालित रूप से शामिल नहीं होती हैं
+- डोमेन प्रविष्टियों को कीवर्ड ओवरलैप + पैटर्न बोनस से स्कोर किया जाता है
+- परिणाम स्कोर के अवरोही क्रम में क्रमबद्ध होते हैं
+
+### `lookupEntry(id, index)`
+
+आईडी द्वारा एक विशिष्ट प्रविष्टि खोजें। मैन्युअल प्रविष्टियों या स्पष्ट पहुंच के लिए।
+
+```typescript
+import { lookupEntry } from "@mcptoolshop/ai-loadout";
+
+const entry = lookupEntry("github-actions", index);
+```
+
+### `parseFrontmatter(content)`
+
+एक डेटा फ़ाइल से YAML-जैसे प्रारंभिक भाग को पार्स करें।
+
+```typescript
+import { parseFrontmatter } from "@mcptoolshop/ai-loadout";
+
+const { frontmatter, body } = parseFrontmatter(fileContent);
+if (frontmatter) {
+  console.log(frontmatter.id, frontmatter.keywords);
+}
+```
+
+### `serializeFrontmatter(fm)`
+
+एक `Frontmatter` ऑब्जेक्ट को वापस एक स्ट्रिंग में क्रमबद्ध करें।
+
+### `validateIndex(index)`
+
+एक `LoadoutIndex` की संरचनात्मक अखंडता को मान्य करें। मुद्दों का एक सरणी लौटाता है।
+
+```typescript
+import { validateIndex } from "@mcptoolshop/ai-loadout";
+
+const issues = validateIndex(index);
+const errors = issues.filter(i => i.severity === "error");
+if (errors.length > 0) {
+  console.error("Index has errors:", errors);
+}
+```
+
+जांच: आवश्यक फ़ील्ड, अद्वितीय आईडी, केबाब-केस प्रारूप, सारांश सीमाएं, डोमेन प्रविष्टियों के लिए कीवर्ड की उपस्थिति, मान्य प्राथमिकताएं, गैर-नकारात्मक बजट।
+
+### `estimateTokens(text)`
+
+पाठ से टोकन की संख्या का अनुमान लगाएं। chars/4 अनुमान का उपयोग करता है।
+
+```typescript
+import { estimateTokens } from "@mcptoolshop/ai-loadout";
+
+const tokens = estimateTokens(fileContent); // ~250
+```
+
+## प्रकार
+
+```typescript
+import type {
+  LoadoutEntry,
+  LoadoutIndex,
+  Frontmatter,
+  MatchResult,
+  ValidationIssue,
+  Priority,       // "core" | "domain" | "manual"
+  Triggers,       // { task, plan, edit }
+  Budget,
+} from "@mcptoolshop/ai-loadout";
+```
+
+## उपभोक्ता
+
+- **[@mcptoolshop/claude-rules](https://github.com/mcp-tool-shop-org/claude-rules)** — क्लाउड कोड के लिए CLAUDE.md ऑप्टिमाइज़र। डिस्पैच टेबल और मिलान के लिए ai-loadout का उपयोग करता है।
+
+## सुरक्षा
+
+यह पैकेज एक शुद्ध डेटा लाइब्रेरी है। यह फ़ाइल सिस्टम तक नहीं पहुंचता है, नेटवर्क अनुरोध नहीं करता है, या टेलीमेट्री एकत्र नहीं करता है। सभी इनपुट/आउटपुट उपभोक्ता की जिम्मेदारी है।
+
+### खतरे का मॉडल
+
+| खतरा | शमन |
+|--------|------------|
+| खराब प्रारूप वाला प्रारंभिक भाग इनपुट | `parseFrontmatter()` अमान्य इनपुट पर `null` लौटाता है - कोई अपवाद नहीं, कोई eval नहीं |
+| प्रोटोकॉल प्रदूषण | हाथ से बनाया गया पार्सर केवल साधारण ऑब्जेक्ट लिटरल का उपयोग करता है, अविश्वसनीय नेस्टेड संरचनाओं का `JSON.parse` नहीं करता है |
+| खराब डेटा वाला इंडेक्स | `validateIndex()` संरचनात्मक मुद्दों को फैलने से पहले पकड़ लेता है |
+| रेगेक्स DoS | कोई उपयोगकर्ता-प्रदत्त रेगेक्स नहीं - पैटर्न को साधारण स्ट्रिंग लुकअप के रूप में मिलान किया जाता है |
+
+पूर्ण सुरक्षा नीति के लिए [SECURITY.md](SECURITY.md) देखें।
+
+---
+
+[MCP Tool Shop](https://mcp-tool-shop.github.io/) द्वारा बनाया गया