zapret2-mcp 0.3.5 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # Changelog
 
+## [0.6.0](https://github.com/rcd27/zapret2-mcp/compare/v0.5.2...v0.6.0) (2026-03-28)
+
+
+### ⚠ BREAKING CHANGES
+
+* **contract:** пересмотрен подход к составлению статей
+
+### Features
+
+* **contract:** пересмотрен подход к составлению статей ([30ae044](https://github.com/rcd27/zapret2-mcp/commit/30ae0446f70a826f72c03f1294faec0bb795af63))
+* **knowledge:** возможности с MTProto ([b5c4cb1](https://github.com/rcd27/zapret2-mcp/commit/b5c4cb190bdebef89719d4432be54165c3d44d50))
+
+
+### Bug Fixes
+
+* **ci-cd:** trusted publishing ([d782a13](https://github.com/rcd27/zapret2-mcp/commit/d782a13e9624c43a02f2e7f65e0469d6c0b02a7a))
+* **ci-cd:** выпелен environment из релиза ([a165212](https://github.com/rcd27/zapret2-mcp/commit/a165212d70bcb52fd140f89d413273ff8463281c))
+* **knowledge:** шапка для статей ([fba333c](https://github.com/rcd27/zapret2-mcp/commit/fba333c14dcf53a80d7b3077c5b5263263a298a7))
+
+## [0.5.2](https://github.com/rcd27/zapret2-mcp/compare/v0.5.1...v0.5.2) (2026-03-28)
+
+
+### Features
+
+* **knowledge:** добавлены доки про ТСПУ ([23f6b12](https://github.com/rcd27/zapret2-mcp/commit/23f6b12cd560f70ad529e0d4bfe150cfe8b0033b))
+* **knowledge:** конфликты на OpenWRT ([20df465](https://github.com/rcd27/zapret2-mcp/commit/20df4651cbc310bb57ba5528a826d12d676a21c6))
+* **knowledge:** миграции стратегий V1 -> V2 ([b9da20f](https://github.com/rcd27/zapret2-mcp/commit/b9da20f8da675da536555d9efa6bd5122032f03c))
+* **knowledge:** проблемы с QUICK ([b41ed68](https://github.com/rcd27/zapret2-mcp/commit/b41ed68db85fa1700502e172f5bc7b5e2440f1fc))
+* **knowledge:** статья про смарт-тв ([a04cb01](https://github.com/rcd27/zapret2-mcp/commit/a04cb01b5f92dba14e7da3b69674b41bc5f7c67e))
+
+## [0.5.1](https://github.com/rcd27/zapret2-mcp/compare/v0.5.0...v0.5.1) (2026-03-28)
+
+
+### Bug Fixes
+
+* **docs:** исправлен полностью устаревший README.md ([8f94e86](https://github.com/rcd27/zapret2-mcp/commit/8f94e86531802db7b9a05225ebe4b1d88a05b072))
+
+## [0.5.0](https://github.com/rcd27/zapret2-mcp/compare/v0.4.0...v0.5.0) (2026-03-28)
+
+
+### ⚠ BREAKING CHANGES
+
+* **pivot:** CI/CD для автоматического версионирования и деплоя в NPM
+* **pivot:** переход в парадигму knowledge-base
+
+### Features
+
+* add removeZapret2 tool with unit tests ([b75a26e](https://github.com/rcd27/zapret2-mcp/commit/b75a26e6c2e97205764c4b729acf5362b6b6c8b6))
+* add runDpiDetector tool for DPI blocking diagnosis ([76a24c7](https://github.com/rcd27/zapret2-mcp/commit/76a24c77510790ad7adadbd08ea4ca4a911e3fea))
+* **pivot:** CI/CD для автоматического версионирования и деплоя в NPM ([326bf6c](https://github.com/rcd27/zapret2-mcp/commit/326bf6c97c616ada5278e6ae14c220a378126c15))
+* **pivot:** переход в парадигму knowledge-base ([1d53b78](https://github.com/rcd27/zapret2-mcp/commit/1d53b7842f781f0075e2682d1e97148619de986b))
+* **prompts:** add strategy-knowledge prompt ([ef01999](https://github.com/rcd27/zapret2-mcp/commit/ef0199970504599163a3730f597c1bb203facb9a))
+* **verifyBypass:** add interface param, routeTo/wanInterface fields, fix bypassConfirmed logic ([4f44a18](https://github.com/rcd27/zapret2-mcp/commit/4f44a18666026ea5aaa3e4c35bad51c20d587993))
+* zapret2-mcp v0.3.0 ([9ee87f9](https://github.com/rcd27/zapret2-mcp/commit/9ee87f99338f7c028dd80b661029bf01a2d44d06))
+
+
+### Bug Fixes
+
+* critical workflow bugs from user-story testing (v0.3.1) ([a370abc](https://github.com/rcd27/zapret2-mcp/commit/a370abc22c7365efc9f908b29e4ad8c52383ad33))
+* installZapret clone permissions and runBlockcheck stdin format ([ba09230](https://github.com/rcd27/zapret2-mcp/commit/ba09230a7d2f539f8ae3802987b203a26cf952c7))
+* **local:** sudo for `local` installation ([7e75130](https://github.com/rcd27/zapret2-mcp/commit/7e7513049fc520623346d0b33cbdd5db3e8e204d))
+* resolve 10 bugs found during full-cycle reinstall testing (v0.3.3) ([f891829](https://github.com/rcd27/zapret2-mcp/commit/f891829b36c4a4d2cdcbfdb966dd25cbae1df77f))
+
+## [0.3.6] - 2026-03-04
+
+### Added
+- **`runDpiDetector` tool** — запуск Docker-образа `dpi-detector` для диагностики типов DPI-блокировок (TLS SNI, TCP throttling, UDP/QUIC). Тяжёлая операция (~3 мин), полный лог сохраняется в resources. Используется перед `runBlockcheck` для понимания характера блокировки.
+- **Unit-тесты `runDpiDetector`** — 8 тестов: docker flags, log URI, defaults, валидация параметров, пустой вывод, partial output на ошибке, fallback на LocalExecutor из Docker-режима, обработка exec failure.
+- **Новый тип логов `dpi-detector`** — сохранение в `~/.zapret2-mcp/logs/dpi-detector/`, доступ через `zapret2://logs/dpi-detector/{timestamp}`.
+- **Workflow #5 DPI diagnosis** — `runDpiDetector → analyze → runBlockcheck → updateConfig → restartService → verifyBypass`.
+
+### Changed
+- **Промпт `troubleshoot`** — добавлен опциональный шаг 6: запуск `runDpiDetector` для диагностики типов блокировок.
+- **Промпт `overview`** — обновлён: 15 tools, добавлен `runDpiDetector` в секцию инструментов и workflow #5.
+
 ## [0.3.5] - 2026-02-19
 
 ### Added

package/README.md

@@ -1,238 +1,91 @@
 # zapret2-mcp
 
-MCP-сервер для управления [zapret2](https://github.com/bol-van/zapret2) — инструментом обработки сетевых пакетов. Позволяет AI-агентам автоматизировать установку, настройку и диагностику zapret2 через [Model Context Protocol](https://modelcontextprotocol.io/).
+Knowledge MCP-сервер для [zapret2](https://github.com/bol-van/zapret2) и [blockcheckw](https://github.com/rcd27/blockcheckw). Подключи к AI-агенту — он получит экспертные знания по обходу DPI-блокировок и сможет настроить всё сам.
 
-## Поддерживаемые платформы
+## Зачем
 
-| Платформа | Статус | Транспорт |
-|---|---|---|
-| OpenWrt (роутер) | Полная поддержка | `ssh` |
-| Linux (десктоп/сервер) | Полная поддержка | `local` |
-| Docker (разработка/тестирование) | Полная поддержка | `docker` |
-| macOS | Не поддерживается | — |
-| Windows (нативно) | Не поддерживается | — |
-| Windows (WSL2) | Работает через `local` | `local` |
+AI-агент (Claude, Cursor, etc.) умеет выполнять команды в терминале. Но он **не знает** как работает zapret2, какие стратегии бывают, как их подбирать и что делать если не работает. Этот MCP-сервер даёт агенту эти знания.
 
-zapret2 поддерживает Windows нативно через [zapret-win-bundle](https://github.com/bol-van/zapret-win-bundle), но архитектура (WinDivert, `.cmd`-скрипты, другие пути) полностью отличается от Linux. Наш MCP-сервер работает только с Linux/OpenWrt-окружениями. Подробнее: [docs/windows-support.md](docs/windows-support.md).
+**Сервер не выполняет команды** — он отдаёт документацию и экспертизу. Агент читает и действует сам.
 
-## Установка
+## Что внутри
 
-```bash
-npm install -g zapret2-mcp
-```
+**14 статей** в базе знаний:
 
-Или запуск без установки:
+- Стратегии DPI bypass: split2, disorder2, fake, fooling, QUIC, оркестрация
+- Справочник параметров nfqws2 и конфига zapret2
+- Команды [blockcheckw](https://github.com/rcd27/blockcheckw) для параллельного сканирования стратегий
+- Пошаговые workflow-ы установки и диагностики
+- Типичные проблемы и решения
 
-```bash
-npx zapret2-mcp
-```
-
-## Настройка MCP-клиента
-
-### Claude Desktop
-
-Добавить в `~/.claude/claude_desktop_config.json`:
+## Установка
 
-```json
-{
-  "mcpServers": {
-    "zapret2": {
-      "command": "npx",
-      "args": ["zapret2-mcp"],
-      "env": {
-        "ZAPRET2_MODE": "ssh",
-        "ZAPRET2_SSH_HOST": "192.168.1.1"
-      }
-    }
-  }
-}
+```bash
+npm install -g zapret2-mcp
 ```
 
-### Claude Code
+## Подключение
 
-Добавить в `.mcp.json` в корне проекта или в `~/.claude/mcp.json` глобально:
+### Claude Desktop / Claude Code
 
 ```json
 {
   "mcpServers": {
     "zapret2": {
       "command": "npx",
-      "args": ["zapret2-mcp"],
-      "env": {
-        "ZAPRET2_MODE": "ssh",
-        "ZAPRET2_SSH_HOST": "192.168.1.1"
-      }
-    }
-  }
-}
-```
-
-### Cursor
-
-Добавить в настройки MCP:
-
-```json
-{
-  "zapret2": {
-    "command": "npx",
-    "args": ["zapret2-mcp"],
-    "env": {
-      "ZAPRET2_MODE": "docker"
+      "args": ["zapret2-mcp"]
     }
   }
 }
 ```
 
-## Режимы транспорта
-
-Сервер выполняет команды на целевой машине через один из трёх транспортов.
-
-### `ssh` — удалённый роутер (продакшн)
-
-Подключение по SSH к OpenWrt-роутеру. Основной режим для реального использования.
-
-```json
-{ "ZAPRET2_MODE": "ssh", "ZAPRET2_SSH_HOST": "192.168.1.1" }
-```
-
-### `local` — локальная машина
+Никаких переменных окружения не нужно — сервер только отдаёт знания.
 
-Выполнение команд через `bash -c` на той же машине, где запущен MCP-сервер. Для Linux-десктопов и WSL2.
-
-```json
-{ "ZAPRET2_MODE": "local" }
-```
-
-### `docker` — контейнер (по умолчанию)
-
-Выполнение через `docker exec` в контейнере с OpenWrt. Для разработки и тестирования.
-
-```json
-{ "ZAPRET2_MODE": "docker" }
-```
+## MCP API
 
-### Переменные окружения
-
-| Переменная | По умолчанию | Описание |
-|---|---|---|
-| `ZAPRET2_MODE` | `docker` | Транспорт: `local`, `docker`, `ssh` |
-| `ZAPRET2_CONTAINER_NAME` | `zapret2-openwrt` | Имя контейнера (режим docker) |
-| `ZAPRET2_SSH_HOST` | — (обязательно для ssh) | SSH-хост |
-| `ZAPRET2_SSH_USER` | `root` | SSH-пользователь |
-| `ZAPRET2_SSH_KEY` | — (опционально) | Путь к SSH-ключу |
-| `ZAPRET2_SSH_PORT` | `22` | SSH-порт |
-
-## Tools (13)
-
-### Определение системы
-
-| Tool | Описание |
-|---|---|
-| `detectSystem` | Определение окружения: ОС, архитектура, init-система, WAN-интерфейс, DNS, NFQUEUE, контейнер |
-
-### Управление сервисом
-
-| Tool | Описание |
-|---|---|
-| `getStatus` | Статус сервиса: запущен ли, PID, количество nftables-правил, флаг enabled |
-| `startService` | Запуск zapret2 (логи сохраняются в resources) |
-| `stopService` | Остановка zapret2 (логи сохраняются в resources) |
-| `restartService` | Перезапуск zapret2 (логи сохраняются в resources) |
-
-### Конфигурация
+### Tool
 
 | Tool | Описание |
 |---|---|
-| `getConfig` | Чтение конфига zapret2 (целиком или по ключу) |
-| `updateConfig` | Обновление параметра конфига (key=value, снапшот сохраняется в resources) |
-| `configureDns` | Настройка DNS-резолвера (resolv.conf или systemd-resolved) |
+| `query-zapret-knowledge` | Поиск по базе знаний. Параметры: `topic` (строка), `tokens` (лимит, опционально) |
 
-### Установка и диагностика
-
-| Tool | Описание |
-|---|---|
-| `checkPrerequisites` | Проверка окружения: инструменты, ОС, init-система, NFQUEUE, сеть |
-| `installZapret` | Полная установка: клонирование, скачивание бинарников, базовый конфиг |
-| `runBlockcheck` | Запуск blockcheck2.sh для поиска рабочих сетевых стратегий (~5 мин, лог в resources) |
-| `verifyBypass` | Проверка сетевой связности: DNS, HTTP, статус nfqws2 |
-
-### Интеграция с десктопом
-
-| Tool | Описание |
-|---|---|
-| `createSystemdService` | Создание systemd unit для автозапуска zapret2 на Linux-десктопе |
-
-## Prompts (5)
+```
+query-zapret-knowledge({ topic: "split2 strategy" })
+query-zapret-knowledge({ topic: "blockcheckw scan", tokens: 2000 })
+query-zapret-knowledge({ topic: "troubleshooting dns" })
+```
 
-MCP-промпты — пошаговые инструкции для типичных сценариев:
+### Prompts
 
 | Prompt | Описание |
 |---|---|
-| `setup-zapret` | Установка с нуля (универсальная) |
-| `setup-desktop` | Установка на Linux-десктоп с systemd, DNS и автозапуском |
-| `find-bypass-strategy` | Поиск рабочей сетевой стратегии через blockcheck |
+| `setup-zapret` | Пошаговая установка zapret2 |
+| `find-bypass-strategy` | Поиск рабочей стратегии через blockcheckw |
 | `troubleshoot` | Диагностика проблем |
-| `overview` | Справочник по всем tools, resources и workflows |
-
-## MCP Resources
+| `strategy-knowledge` | Полный справочник стратегий DPI bypass |
 
-Tools сохраняют вывод в файлы для персистентной истории. Агент может возвращаться к предыдущим результатам и сравнивать прогоны.
+## Пример использования
 
-- **URI:** `zapret2://logs/{type}/{timestamp}`
-- **Типы логов:** `blockcheck`, `service`, `config`
-- **Хранение:** `~/.zapret2-mcp/logs/`
+> "Настрой zapret2 на моём роутере, найди рабочую стратегию для youtube.com"
 
-## Сценарии использования
-
-### Роутер (OpenWrt по SSH)
-
-```
-detectSystem → checkPrerequisites → installZapret → updateConfig(NFQWS2_ENABLE=1)
-→ startService → verifyBypass
-```
-
-### Linux-десктоп
-
-```
-detectSystem → checkPrerequisites → installZapret → configureDns
-→ createSystemdService → updateConfig(NFQWS2_ENABLE=1) → startService → verifyBypass
-```
-
-### Поиск сетевой стратегии
-
-```
-stopService → runBlockcheck(domain) → прочитать лог resource
-→ updateConfig(NFQWS2_OPT=...) → restartService → verifyBypass(domain)
-```
-
-### Диагностика
-
-```
-detectSystem → getStatus → getConfig → checkPrerequisites → verifyBypass(domain)
-→ анализ результатов
-```
+Агент:
+1. Вызывает `query-zapret-knowledge({ topic: "setup installation" })` — получает инструкции
+2. Выполняет команды установки в терминале
+3. Вызывает `query-zapret-knowledge({ topic: "blockcheckw scan" })` — узнаёт как искать стратегии
+4. Запускает `blockcheckw scan -d youtube.com`
+5. Вызывает `query-zapret-knowledge({ topic: "strategy selection criteria" })` — понимает как выбрать лучшую
+6. Применяет стратегию в конфиг, запускает сервис
 
 ## Разработка
 
 ```bash
-git clone https://github.com/your-org/zapret2-mcp.git
+git clone --recurse-submodules https://github.com/rcd27/zapret2-mcp.git
 cd zapret2-mcp
 npm install
-npm run build      # TypeScript → build/
-npm run dev        # MCP Inspector
-npm test           # Unit-тесты (vitest)
-npm run test:integration  # Интеграционные тесты (требуется Docker)
+npm run build
+npm test
 ```
 
-### Docker-окружение для разработки
-
-```bash
-cd docker
-docker compose build && docker compose up -d
-```
-
-Контейнер `zapret2-openwrt`: OpenWrt SNAPSHOT, `privileged: true`, `network_mode: host`.
-
 ## Лицензия
 
 MIT

package/build/index.js

@@ -1,74 +1,70 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createExecutor } from "./executor/index.js";
-import { initExecutor } from "./executorInstance.js";
-import { getStatusTool } from "./tools/getStatus.js";
-import { startServiceTool } from "./tools/startService.js";
-import { stopServiceTool } from "./tools/stopService.js";
-import { restartServiceTool } from "./tools/restartService.js";
-import { getConfigTool } from "./tools/getConfig.js";
-import { updateConfigTool } from "./tools/updateConfig.js";
-import { runBlockcheckTool } from "./tools/runBlockcheck.js";
-import { checkPrerequisitesTool } from "./tools/checkPrerequisites.js";
-import { installZapretTool } from "./tools/installZapret.js";
-import { verifyBypassTool } from "./tools/verifyBypass.js";
-import { detectSystemTool } from "./tools/detectSystem.js";
-import { configureDnsTool } from "./tools/configureDns.js";
-import { createSystemdServiceTool } from "./tools/createSystemdService.js";
-import { removeZapretTool } from "./tools/removeZapret.js";
-import { registerResources } from "./resources.js";
+import { z } from "zod";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { KnowledgeIndex } from "./indexer.js";
 import { registerPrompts } from "./prompts.js";
-import { setOnLogSaved } from "./logStore.js";
-const executor = createExecutor();
-initExecutor(executor);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const knowledgeDir = resolve(__dirname, "..", "knowledge");
+const index = new KnowledgeIndex(knowledgeDir);
 const server = new McpServer({
     name: "zapret2-mcp",
-    version: "0.2.0",
+    version: "0.4.0",
 }, {
-    instructions: `zapret2-mcp provides tools to install, configure, and diagnose zapret2 — a network packet processing tool for OpenWrt routers and Linux desktops.
+    instructions: `zapret2-mcp is a knowledge server for zapret2 (DPI bypass tool by bol-van) and blockcheckw (fast strategy scanner by rcd27).
 
-Key workflows:
-1. Fresh install (router): checkPrerequisites → installZapret → updateConfig(NFQWS2_ENABLE=1) → startService → verifyBypass
-2. Fresh install (desktop): detectSystem → checkPrerequisites → installZapret → configureDns → createSystemdService → updateConfig(NFQWS2_ENABLE=1) → startService → verifyBypass
-3. Find bypass strategy: stopService → runBlockcheck(domain) → read log resource → updateConfig(NFQWS2_OPT=...) → restartService → verifyBypass(domain)
-4. Troubleshoot: detectSystem → getStatus → getConfig → checkPrerequisites → verifyBypass(domain) → analyze
+It provides contextual documentation and expert knowledge about:
+- DPI bypass strategies (split2, disorder2, fake, fooling, etc.)
+- zapret2 configuration and service management
+- blockcheckw commands for parallel strategy discovery
+- Installation workflows for Linux desktops, servers, and OpenWrt routers
+- Troubleshooting common issues
 
-Always start with detectSystem to determine the target environment (OS, init system, WAN interface).
-Use configureDns to set up a reliable DNS resolver.
-Use createSystemdService on systemd-based Linux desktops for service autostart.
+Use the query-zapret-knowledge tool to search the knowledge base.
+Use getPrompt for guided workflows: setup-zapret, find-bypass-strategy, troubleshoot, strategy-knowledge.
 
-Service management (start/stop/restart) saves logs to resources. updateConfig saves a config snapshot before changes.
-runBlockcheck is a heavy operation (~5 min) that saves full output to resources for later analysis.
-Use listResources to browse historical logs at zapret2://logs/{type}/{timestamp}.
-Use getPrompt for step-by-step guidance: setup-zapret, setup-desktop, find-bypass-strategy, troubleshoot, overview.`,
+This server does NOT execute commands — it provides knowledge and guidance. The consuming agent executes commands directly.`,
+});
+server.tool("query-zapret-knowledge", "Search zapret2 and blockcheckw knowledge base by topic. Returns relevant documentation, strategy guides, configuration references, and troubleshooting information.", {
+    topic: z.string().describe("What to search for (e.g. 'split2 strategy', 'blockcheckw scan', 'troubleshooting dns', 'config nfqws2_opt')"),
+    tokens: z.number().optional().describe("Maximum approximate token count for the response (default: no limit)"),
+}, async (args) => {
+    const results = index.query(args.topic, args.tokens);
+    if (results.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No results found for "${args.topic}". Try broader keywords like: strategies, config, blockcheckw, troubleshooting, setup, platforms.`,
+                },
+            ],
+        };
+    }
+    const sections = results.map((entry) => {
+        const versionInfo = [
+            entry.zapret2Version && `zapret2: ${entry.zapret2Version}`,
+            entry.blockcheckwVersion && `blockcheckw: ${entry.blockcheckwVersion}`,
+        ]
+            .filter(Boolean)
+            .join(", ");
+        return `## ${entry.title}${versionInfo ? `\n_Version: ${versionInfo}_` : ""}\n\n${entry.content}`;
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: sections.join("\n\n---\n\n"),
+            },
+        ],
+    };
 });
-const tools = [
-    getStatusTool,
-    startServiceTool,
-    stopServiceTool,
-    restartServiceTool,
-    getConfigTool,
-    updateConfigTool,
-    runBlockcheckTool,
-    checkPrerequisitesTool,
-    installZapretTool,
-    verifyBypassTool,
-    detectSystemTool,
-    configureDnsTool,
-    createSystemdServiceTool,
-    removeZapretTool,
-];
-for (const tool of tools) {
-    server.tool(tool.name, tool.description, tool.schema.shape, tool.handler);
-}
-registerResources(server);
 registerPrompts(server);
-setOnLogSaved(() => server.sendResourceListChanged());
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error(`zapret2-mcp server started (executor: ${executor.label})`);
+    console.error(`zapret2-mcp knowledge server started (${index.all().length} knowledge entries indexed)`);
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;AAClC,YAAY,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;;;;;;;;;;;;;;;oHAekG;CACjH,CACF,CAAC;AAEF,MAAM,KAAK,GAAG;IACZ,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,kBAAkB;IAClB,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,sBAAsB;IACtB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,wBAAwB;IACxB,gBAAgB;CACjB,CAAC;AAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;IACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC;AAEtD,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yCAAyC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/indexer.d.ts

@@ -0,0 +1,25 @@
+export interface KnowledgeEntry {
+    /** Relative path from knowledge root */
+    path: string;
+    /** Title from frontmatter */
+    title: string;
+    /** Tags from frontmatter */
+    tags: string[];
+    /** Full markdown content (without frontmatter) */
+    content: string;
+    /** zapret2 version from frontmatter */
+    zapret2Version?: string;
+    /** blockcheckw version from frontmatter */
+    blockcheckwVersion?: string;
+}
+export declare class KnowledgeIndex {
+    private knowledgeDir;
+    private entries;
+    constructor(knowledgeDir: string);
+    rebuild(): void;
+    /** Keyword-based search. Returns entries ranked by relevance. */
+    query(topic: string, maxTokens?: number): KnowledgeEntry[];
+    /** Get all entries (for listing) */
+    all(): KnowledgeEntry[];
+    private tokenize;
+}

package/build/indexer.js

@@ -0,0 +1,114 @@
+import { readFileSync, readdirSync, statSync } from "fs";
+import { join, relative } from "path";
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match)
+        return { meta: {}, content: raw };
+    const meta = {};
+    for (const line of match[1].split("\n")) {
+        const idx = line.indexOf(":");
+        if (idx > 0) {
+            meta[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+        }
+    }
+    return { meta, content: match[2] };
+}
+function collectMarkdownFiles(dir) {
+    const files = [];
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        const stat = statSync(full);
+        if (stat.isDirectory()) {
+            files.push(...collectMarkdownFiles(full));
+        }
+        else if (entry.endsWith(".md")) {
+            files.push(full);
+        }
+    }
+    return files;
+}
+export class KnowledgeIndex {
+    knowledgeDir;
+    entries = [];
+    constructor(knowledgeDir) {
+        this.knowledgeDir = knowledgeDir;
+        this.rebuild();
+    }
+    rebuild() {
+        this.entries = [];
+        const files = collectMarkdownFiles(this.knowledgeDir);
+        for (const file of files) {
+            const raw = readFileSync(file, "utf-8");
+            const { meta, content } = parseFrontmatter(raw);
+            this.entries.push({
+                path: relative(this.knowledgeDir, file),
+                title: meta.title ?? file,
+                tags: (meta.tags ?? "").split(",").map((t) => t.trim()).filter(Boolean),
+                content: content.trim(),
+                zapret2Version: meta["zapret2-version"],
+                blockcheckwVersion: meta["blockcheckw-version"],
+            });
+        }
+    }
+    /** Keyword-based search. Returns entries ranked by relevance. */
+    query(topic, maxTokens) {
+        const keywords = this.tokenize(topic);
+        if (keywords.length === 0)
+            return this.entries;
+        const scored = [];
+        for (const entry of this.entries) {
+            let score = 0;
+            for (const keyword of keywords) {
+                const kw = keyword.toLowerCase();
+                // Title match (highest weight)
+                if (entry.title.toLowerCase().includes(kw))
+                    score += 10;
+                // Tag exact match (high weight)
+                if (entry.tags.some((t) => t.toLowerCase() === kw))
+                    score += 8;
+                // Tag partial match
+                if (entry.tags.some((t) => t.toLowerCase().includes(kw)))
+                    score += 4;
+                // Content match (count occurrences, capped)
+                const contentLower = entry.content.toLowerCase();
+                let idx = 0;
+                let count = 0;
+                while ((idx = contentLower.indexOf(kw, idx)) !== -1) {
+                    count++;
+                    idx += kw.length;
+                }
+                score += Math.min(count, 5) * 2;
+            }
+            if (score > 0) {
+                scored.push({ entry, score });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        if (!maxTokens)
+            return scored.map((s) => s.entry);
+        // Approximate token limit (1 token ≈ 4 chars)
+        const charLimit = maxTokens * 4;
+        let totalChars = 0;
+        const result = [];
+        for (const { entry } of scored) {
+            const entryChars = entry.title.length + entry.content.length + 50;
+            if (totalChars + entryChars > charLimit && result.length > 0)
+                break;
+            result.push(entry);
+            totalChars += entryChars;
+        }
+        return result;
+    }
+    /** Get all entries (for listing) */
+    all() {
+        return this.entries;
+    }
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\p{L}\p{N}\s_-]/gu, " ")
+            .split(/\s+/)
+            .filter((w) => w.length >= 2);
+    }
+}
+//# sourceMappingURL=indexer.js.map