toonify-mcp 0.3.0 → 0.4.0

package/README.ru.md

@@ -0,0 +1,270 @@
+# 🎯 Toonify MCP
+
+**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
+
+MCP-сервер + плагин Claude Code, обеспечивающий автоматическую оптимизацию токенов для структурированных данных.
+Сокращает использование токенов Claude API на **30-65% в зависимости от структуры данных** благодаря прозрачному преобразованию в формат TOON, с типичной экономией **50-55%** для структурированных данных.
+
+## Что нового в v0.3.0
+
+✨ **Многоязычная оптимизация токенов!**
+- ✅ Точный подсчет токенов для 15+ языков (китайский, японский, корейский, испанский, арабский и др.)
+- ✅ Языково-зависимые множители токенов (2x для китайского, 2.5x для японского, 3x для арабского)
+- ✅ Поддержка смешанных языков с автоматическим определением
+- ✅ Улучшенная точность оптимизации на основе реальных тестов
+- ✅ Подтвержденные данными заявления об экономии токенов (диапазон 30-65%, обычно 50-55%)
+
+## Возможности
+
+- **Сокращение токенов на 30-65%** (обычно 50-55%) для данных JSON, CSV, YAML
+- **Многоязычная поддержка** - точный подсчет токенов для 15+ языков
+- **Полностью автоматический режим** - хук PostToolUse перехватывает результаты инструментов
+- **Нулевая конфигурация** - работает из коробки с разумными настройками по умолчанию
+- **Двойной режим** - работает как плагин (авто) или MCP-сервер (вручную)
+- **Встроенные метрики** - отслеживание экономии токенов локально
+- **Тихий откат** - никогда не нарушает ваш рабочий процесс
+
+## Установка
+
+### Вариант A: Плагин Claude Code (Рекомендуется) ⭐
+
+**Автоматическая оптимизация токенов без ручных вызовов:**
+
+```bash
+# 1. Установить глобально
+npm install -g toonify-mcp
+
+# 2. Добавить как плагин (автоматический режим)
+claude plugin add toonify-mcp
+
+# 3. Проверить установку
+claude plugin list
+# Должно показать: toonify-mcp ✓
+```
+
+**Вот и всё!** Хук PostToolUse теперь будет автоматически перехватывать и оптимизировать структурированные данные из инструментов Read, Grep и других файловых инструментов.
+
+### Вариант B: MCP-сервер (Ручной режим)
+
+**Для явного контроля или других MCP-клиентов:**
+
+```bash
+# 1. Установить глобально
+npm install -g toonify-mcp
+
+# 2. Зарегистрировать как MCP-сервер
+claude mcp add toonify -- toonify-mcp
+
+# 3. Проверить
+claude mcp list
+# Должно показать: toonify: toonify-mcp - ✓ Connected
+```
+
+Затем вызывайте инструменты явно:
+```bash
+claude mcp call toonify optimize_content '{"content": "..."}'
+claude mcp call toonify get_stats '{}'
+```
+
+## Как это работает
+
+### Режим плагина (Автоматический)
+
+```
+Пользователь: Прочитать большой JSON-файл
+  ↓
+Claude Code вызывает инструмент Read
+  ↓
+Хук PostToolUse перехватывает результат
+  ↓
+Хук определяет JSON, преобразует в TOON
+  ↓
+Оптимизированный контент отправляется в Claude API
+  ↓
+Достигается типичное сокращение токенов на 50-55% ✨
+```
+
+### Режим MCP-сервера (Ручной)
+
+```
+Пользователь: явно вызывает mcp__toonify__optimize_content
+  ↓
+Контент преобразуется в формат TOON
+  ↓
+Возвращается оптимизированный результат
+```
+
+## Конфигурация
+
+Создайте `~/.claude/toonify-config.json` (необязательно):
+
+```json
+{
+  "enabled": true,
+  "minTokensThreshold": 50,
+  "minSavingsThreshold": 30,
+  "skipToolPatterns": ["Bash", "Write", "Edit"]
+}
+```
+
+### Параметры
+
+- **enabled**: Включить/отключить автоматическую оптимизацию (по умолчанию: `true`)
+- **minTokensThreshold**: Минимальное количество токенов перед оптимизацией (по умолчанию: `50`)
+- **minSavingsThreshold**: Минимальный требуемый процент экономии (по умолчанию: `30%`)
+- **skipToolPatterns**: Инструменты, которые никогда не оптимизировать (по умолчанию: `["Bash", "Write", "Edit"]`)
+
+### Переменные окружения
+
+```bash
+export TOONIFY_ENABLED=true
+export TOONIFY_MIN_TOKENS=50
+export TOONIFY_MIN_SAVINGS=30
+export TOONIFY_SKIP_TOOLS="Bash,Write"
+export TOONIFY_SHOW_STATS=true  # Показывать статистику оптимизации в выводе
+```
+
+## Примеры
+
+### До оптимизации (142 токена)
+
+```json
+{
+  "products": [
+    {"id": 101, "name": "Laptop Pro", "price": 1299},
+    {"id": 102, "name": "Magic Mouse", "price": 79}
+  ]
+}
+```
+
+### После оптимизации (57 токенов, -60%)
+
+```
+[TOON-JSON]
+products[2]{id,name,price}:
+  101,Laptop Pro,1299
+  102,Magic Mouse,79
+```
+
+**Автоматически применяется в режиме плагина - ручные вызовы не нужны!**
+
+## Советы по использованию
+
+### Когда срабатывает автоматическая оптимизация?
+
+Хук PostToolUse автоматически оптимизирует, когда:
+- ✅ Контент является валидным JSON, CSV или YAML
+- ✅ Размер контента ≥ `minTokensThreshold` (по умолчанию: 50 токенов)
+- ✅ Предполагаемая экономия ≥ `minSavingsThreshold` (по умолчанию: 30%)
+- ✅ Инструмент НЕ входит в `skipToolPatterns` (например, не Bash/Write/Edit)
+
+### Просмотр статистики оптимизации
+
+```bash
+# В режиме плагина
+claude mcp call toonify get_stats '{}'
+
+# Или проверьте вывод Claude Code для статистики (если TOONIFY_SHOW_STATS=true)
+```
+
+## Устранение неполадок
+
+### Хук не срабатывает
+
+```bash
+# 1. Проверьте, что плагин установлен
+claude plugin list | grep toonify
+
+# 2. Проверьте конфигурацию
+cat ~/.claude/toonify-config.json
+
+# 3. Включите статистику для просмотра попыток оптимизации
+export TOONIFY_SHOW_STATS=true
+```
+
+### Оптимизация не применяется
+
+- Проверьте `minTokensThreshold` - контент может быть слишком мал
+- Проверьте `minSavingsThreshold` - экономия может быть < 30%
+- Проверьте `skipToolPatterns` - инструмент может быть в списке пропуска
+- Убедитесь, что контент является валидным JSON/CSV/YAML
+
+### Проблемы с производительностью
+
+- Уменьшите `minTokensThreshold` для более агрессивной оптимизации
+- Увеличьте `minSavingsThreshold` для пропуска незначительных оптимизаций
+- Добавьте больше инструментов в `skipToolPatterns` при необходимости
+
+## Сравнение: Плагин vs MCP-сервер
+
+| Функция | Режим плагина | Режим MCP-сервера |
+|---------|--------------|-------------------|
+| **Активация** | Автоматическая (PostToolUse) | Ручная (вызов инструмента) |
+| **Совместимость** | Только Claude Code | Любой MCP-клиент |
+| **Конфигурация** | Файл конфигурации плагина | Инструменты MCP |
+| **Производительность** | Нулевые накладные расходы | Накладные расходы на вызов |
+| **Сценарий использования** | Ежедневный рабочий процесс | Явный контроль |
+
+**Рекомендация**: Используйте режим плагина для автоматической оптимизации. Используйте режим MCP-сервера для явного контроля или других MCP-клиентов.
+
+## Удаление
+
+### Режим плагина
+```bash
+claude plugin remove toonify-mcp
+rm ~/.claude/toonify-config.json
+```
+
+### Режим MCP-сервера
+```bash
+claude mcp remove toonify
+```
+
+### Пакет
+```bash
+npm uninstall -g toonify-mcp
+```
+
+## Ссылки
+
+- **GitHub**: https://github.com/kevintseng/toonify-mcp
+- **Issues**: https://github.com/kevintseng/toonify-mcp/issues
+- **NPM**: https://www.npmjs.com/package/toonify-mcp
+- **MCP Docs**: https://code.claude.com/docs/mcp
+- **TOON Format**: https://github.com/toon-format/toon
+
+## Вклад в проект
+
+Вклады приветствуются! Пожалуйста, ознакомьтесь с [CONTRIBUTING.md](CONTRIBUTING.md) для получения рекомендаций.
+
+## Лицензия
+
+Лицензия MIT - см. [LICENSE](LICENSE)
+
+## Changelog
+
+### v0.3.0 (2025-12-26)
+- ✨ **Многоязычная оптимизация токенов** - точный подсчет для 15+ языков
+- ✨ Языково-зависимые множители токенов (2x китайский, 2.5x японский, 3x арабский и др.)
+- ✨ Определение и оптимизация смешанных языков
+- ✨ Комплексное тестирование с реальной статистикой
+- 📊 Подтвержденные данными заявления об экономии токенов (диапазон 30-65%, обычно 50-55%)
+- ✅ 75+ пройденных тестов, включая многоязычные граничные случаи
+- 📝 Многоязычные версии README
+
+### v0.2.0 (2025-12-25)
+- ✨ Добавлена поддержка плагина Claude Code с хуком PostToolUse
+- ✨ Автоматическая оптимизация токенов (ручные вызовы не нужны)
+- ✨ Система конфигурации плагина
+- ✨ Двойной режим: Плагин (авто) + MCP-сервер (вручную)
+- 📝 Комплексное обновление документации
+
+### v0.1.1 (2024-12-24)
+- 🐛 Исправления ошибок и улучшения
+- 📝 Обновления документации
+
+### v0.1.0 (2024-12-24)
+- 🎉 Первый релиз
+- ✨ Реализация MCP-сервера
+- ✨ Оптимизация формата TOON
+- ✨ Встроенное отслеживание метрик

package/README.vi.md

@@ -1,6 +1,6 @@
 # 🎯 Toonify MCP
 
-**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
+**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
 
 Máy chủ MCP + Plugin Claude Code cung cấp tối ưu hóa token tự động cho dữ liệu có cấu trúc.
 Giảm 30-65% việc sử dụng token của Claude API **tùy thuộc vào cấu trúc dữ liệu** thông qua chuyển đổi định dạng TOON minh bạch, với mức tiết kiệm điển hình **50-55%** cho dữ liệu có cấu trúc.

package/README.zh-CN.md

@@ -1,6 +1,6 @@
 # 🎯 Toonify MCP
 
-**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
+**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
 
 MCP 服务器 + Claude Code 插件，提供结构化数据的自动 token 优化。
 通过透明的 TOON 格式转换，**根据数据结构减少 30-65% 的 Claude API token 使用量**，结构化数据的典型节省率为 **50-55%**。

package/README.zh-TW.md

@@ -1,6 +1,6 @@
 # 🎯 Toonify MCP
 
-**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
+**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
 
 MCP 伺服器 + Claude Code 外掛程式，提供結構化數據的自動 token 優化。
 透過透明的 TOON 格式轉換，**根據數據結構減少 30-65% 的 Claude API token 使用量**，結構化數據的典型節省率為 **50-55%**。

package/dist/optimizer/caching/cache-types.d.ts

@@ -33,4 +33,38 @@ export interface CacheStrategy {
     shouldCache: (content: string, tokens: number) => boolean;
     formatCacheStructure: (content: CachedContent) => any;
 }
+/**
+ * LRU Cache Configuration
+ */
+export interface LRUCacheConfig {
+    enabled: boolean;
+    maxSize: number;
+    ttl: number;
+    persistent: boolean;
+    persistPath?: string;
+}
+/**
+ * LRU Cache Entry
+ */
+export interface LRUCacheEntry<T> {
+    key: string;
+    value: T;
+    timestamp: number;
+    lastAccessed: number;
+    accessCount: number;
+    expiresAt: number;
+}
+/**
+ * LRU Cache Statistics
+ */
+export interface LRUCacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    expirations: number;
+    currentSize: number;
+    maxSize: number;
+    hitRate: number;
+    averageAccessCount: number;
+}
 //# sourceMappingURL=cache-types.d.ts.map

package/dist/optimizer/caching/cache-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-types.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/cache-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,oBAAoB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,GAAG,CAAC;CACvD"}
+{"version":3,"file":"cache-types.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/cache-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,oBAAoB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,GAAG,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/optimizer/caching/index.d.ts

@@ -4,4 +4,6 @@
 export * from './cache-types.js';
 export * from './cache-strategies.js';
 export { CacheOptimizer } from './cache-optimizer.js';
+export { LRUCache } from './lru-cache.js';
+export { PersistentCache } from './persistent-cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/optimizer/caching/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/optimizer/caching/index.js

@@ -4,4 +4,6 @@
 export * from './cache-types.js';
 export * from './cache-strategies.js';
 export { CacheOptimizer } from './cache-optimizer.js';
+export { LRUCache } from './lru-cache.js';
+export { PersistentCache } from './persistent-cache.js';
 //# sourceMappingURL=index.js.map

package/dist/optimizer/caching/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/optimizer/caching/lru-cache.d.ts

@@ -0,0 +1,70 @@
+/**
+ * LRU Cache with TTL (Time-to-Live) support
+ * Features:
+ * - Least Recently Used eviction strategy
+ * - TTL-based expiration
+ * - Optional disk persistence
+ */
+import type { LRUCacheConfig, LRUCacheStats } from './cache-types.js';
+export declare class LRUCache<T = any> {
+    private cache;
+    private config;
+    private stats;
+    private persistentCache?;
+    private totalAccessCount;
+    constructor(config?: Partial<LRUCacheConfig>);
+    /**
+     * Generate cache key from content using SHA-256
+     */
+    static generateKey(content: string): string;
+    /**
+     * Get value from cache
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set value in cache
+     */
+    set(key: string, value: T): void;
+    /**
+     * Check if entry has expired
+     */
+    private isExpired;
+    /**
+     * Evict least recently used entry
+     * Since Map maintains insertion order, the first entry is the least recently used
+     */
+    private evictLRU;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Clean up expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): LRUCacheStats;
+    /**
+     * Update hit rate and average access count (O(1) complexity)
+     */
+    private updateStats;
+    /**
+     * Load cache from disk
+     */
+    private loadFromDisk;
+    /**
+     * Force save all entries to disk and wait for completion
+     */
+    saveToDisk(): Promise<void>;
+    /**
+     * Get cache size
+     */
+    size(): number;
+    /**
+     * Check if key exists (without updating access time)
+     */
+    has(key: string): boolean;
+}
+//# sourceMappingURL=lru-cache.d.ts.map

package/dist/optimizer/caching/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/lru-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAiB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGrF,qBAAa,QAAQ,CAAC,CAAC,GAAG,GAAG;IAC3B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAqB;IAC7C,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IA6BhD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAsC/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IA8BhC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAqBhB;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,OAAO,IAAI,MAAM;IAqBjB;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAO1B"}

package/dist/optimizer/caching/lru-cache.js

@@ -0,0 +1,230 @@
+/**
+ * LRU Cache with TTL (Time-to-Live) support
+ * Features:
+ * - Least Recently Used eviction strategy
+ * - TTL-based expiration
+ * - Optional disk persistence
+ */
+import crypto from 'crypto';
+import { PersistentCache } from './persistent-cache.js';
+export class LRUCache {
+    cache;
+    config;
+    stats;
+    persistentCache;
+    totalAccessCount = 0; // Running total for O(1) average calculation
+    constructor(config = {}) {
+        this.config = {
+            enabled: true,
+            maxSize: 500,
+            ttl: 3600000, // 1 hour in milliseconds
+            persistent: false,
+            persistPath: '~/.toonify-mcp/cache/optimization-cache.json',
+            ...config
+        };
+        this.cache = new Map();
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+            expirations: 0,
+            currentSize: 0,
+            maxSize: this.config.maxSize,
+            hitRate: 0,
+            averageAccessCount: 0
+        };
+        // Initialize persistent cache if enabled
+        if (this.config.persistent && this.config.persistPath) {
+            this.persistentCache = new PersistentCache(this.config.persistPath);
+            this.loadFromDisk();
+        }
+    }
+    /**
+     * Generate cache key from content using SHA-256
+     */
+    static generateKey(content) {
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Get value from cache
+     */
+    get(key) {
+        if (!this.config.enabled) {
+            return undefined;
+        }
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            this.updateStats();
+            return undefined;
+        }
+        // Check if expired
+        if (this.isExpired(entry)) {
+            this.totalAccessCount -= entry.accessCount; // Update running total
+            this.cache.delete(key);
+            this.stats.expirations++;
+            this.stats.misses++;
+            this.updateStats();
+            return undefined;
+        }
+        // Update access metadata (LRU)
+        entry.lastAccessed = Date.now();
+        entry.accessCount++;
+        this.totalAccessCount++; // Update running total
+        // Delete and re-insert to move to end (most recently used in Map)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        this.stats.hits++;
+        this.updateStats();
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value) {
+        if (!this.config.enabled) {
+            return;
+        }
+        const now = Date.now();
+        // Check if we need to evict (LRU)
+        if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {
+            this.evictLRU();
+        }
+        const entry = {
+            key,
+            value,
+            timestamp: now,
+            lastAccessed: now,
+            accessCount: 0,
+            expiresAt: now + this.config.ttl
+        };
+        this.cache.set(key, entry);
+        this.stats.currentSize = this.cache.size;
+        // Persist to disk if enabled
+        if (this.persistentCache) {
+            this.persistentCache.save(key, entry);
+        }
+    }
+    /**
+     * Check if entry has expired
+     */
+    isExpired(entry) {
+        return Date.now() > entry.expiresAt;
+    }
+    /**
+     * Evict least recently used entry
+     * Since Map maintains insertion order, the first entry is the least recently used
+     */
+    evictLRU() {
+        // Get first entry (least recently used)
+        const firstKey = this.cache.keys().next().value;
+        if (firstKey) {
+            const entry = this.cache.get(firstKey);
+            if (entry) {
+                this.totalAccessCount -= entry.accessCount; // Update running total
+            }
+            this.cache.delete(firstKey);
+            this.stats.evictions++;
+            this.stats.currentSize = this.cache.size;
+            // Remove from disk
+            if (this.persistentCache) {
+                this.persistentCache.delete(firstKey);
+            }
+        }
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+        this.stats.currentSize = 0;
+        this.totalAccessCount = 0; // Reset running total
+        if (this.persistentCache) {
+            this.persistentCache.clear();
+        }
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        let removed = 0;
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.totalAccessCount -= entry.accessCount; // Update running total
+                this.cache.delete(key);
+                this.stats.expirations++;
+                removed++;
+                if (this.persistentCache) {
+                    this.persistentCache.delete(key);
+                }
+            }
+        }
+        this.stats.currentSize = this.cache.size;
+        return removed;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Update hit rate and average access count (O(1) complexity)
+     */
+    updateStats() {
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+        // Calculate average access count using running total (O(1))
+        this.stats.averageAccessCount = this.cache.size > 0 ? this.totalAccessCount / this.cache.size : 0;
+    }
+    /**
+     * Load cache from disk
+     */
+    loadFromDisk() {
+        if (!this.persistentCache) {
+            return;
+        }
+        const entries = this.persistentCache.loadAll();
+        const now = Date.now();
+        for (const entry of entries) {
+            // Skip expired entries
+            if (now > entry.expiresAt) {
+                this.stats.expirations++;
+                continue;
+            }
+            this.cache.set(entry.key, entry);
+            this.totalAccessCount += entry.accessCount; // Initialize running total from disk
+        }
+        this.stats.currentSize = this.cache.size;
+    }
+    /**
+     * Force save all entries to disk and wait for completion
+     */
+    async saveToDisk() {
+        if (!this.persistentCache) {
+            return;
+        }
+        // Flush all pending writes and save current state
+        await this.persistentCache.flush();
+        await this.persistentCache.saveAll(Array.from(this.cache.values()));
+        await this.persistentCache.flush(); // Ensure final save completes
+    }
+    /**
+     * Get cache size
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Check if key exists (without updating access time)
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        return !this.isExpired(entry);
+    }
+}
+//# sourceMappingURL=lru-cache.js.map