watch: слежение за файлами (WatchService + debounce + реконсиляция)

2026-10-02 01:35:20 +03:00
parent 8b78309c56
commit f1d497d336
5 changed files with 399 additions and 0 deletions
@@ -0,0 +1,68 @@
+Проект: /root/WORK/memo (Kotlin/JVM). Заказ по MCP-серверу.
+
+Создать:
+  memo-mcp/build.gradle.kts   (kotlin("jvm") + application + зависимости на :memo-core и kotlinx-serialization-json)
+  memo-mcp/src/main/kotlin/memo/mcp/McpServer.kt
+  memo-mcp/src/test/kotlin/memo/mcp/McpProtocolTest.kt
+
+## Зависимости модуля memo-mcp
+
+  plugins { kotlin("jvm") application; kotlin("plugin.serialization") version "2.4.10" }
+  application { mainClass.set("memo.mcp.McpServerKt") }
+  dependencies {
+      implementation(project(":memo-core"))
+      implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
+  }
+
+## McpServer.kt — протокол
+
+fun main(args: Array<String>) — читает stdin построчно, отвечает в stdout ОДНОЙ строкой JSON-RPC 2.0 на запрос.
+НИЧЕГО кроме JSON-RPC в stdout не печатать (диагностика — только в stderr).
+Поддерживаемые методы:
+- `initialize` → result: {"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"memo","version":"0.1.0"}}
+- `notifications/initialized` → уведомление, ответ не отправлять
+- `tools/list` → result: {"tools":[ ... ]} с тремя инструментами:
+  * memo_search: {"path":string,"query":string,"k":integer(по умолч. 8),"mode":string("hybrid"|"lex"|"vec")}
+    обязательные: path, query
+  * memo_status: {"path":string} — обязательный: path
+  * memo_reindex: {"path":string} — обязательный: path
+- `tools/call` с params {"name":..., "arguments":{...}} →
+  result: {"content":[{"type":"text","text":"<строка>"}],"isError":<bool>}
+  Ошибка (нет обязательного аргумента, неизвестный инструмент, исключение) → result с "isError":true
+  и текстом ошибки, а НЕ JSON-RPC error.
+- неизвестный метод → {"jsonrpc":"2.0","id":<id>,"error":{"code":-32601,"message":"Method not found"}}
+
+Реализацию инструментов вынести в функции, тестируемые без процесса:
+  fun toolSearch(path: String, query: String, k: Int, mode: SearchMode): String
+  fun toolStatus(path: String): String
+  fun toolReindex(path: String): String
+  fun handleRequest(line: String): String?   // null для уведомлений
+
+Поведение:
+- Модель: MEMO_MODEL_DIR, иначе /root/WORK/memo/models/siglip2. Пути к БД — как в CLI
+  (<коллекция>/.memo/index.db); определение коллекций: каталог с *.md на глубине до 2.
+- toolSearch: поиск через Searcher с refresh-хуком (переиндексация перед поиском).
+  Текст ответа — человекочитаемый список: `<path>:<line>  <heading>\n<text>\n` для каждого хита.
+  Пустой результат → строка "ничего не найдено".
+- toolStatus: по коллекции — `файлов <N>, чанков <M>, индекс <ISO-дата>`.
+- toolReindex: полная переиндексация: удалить каталог `<коллекция>/.memo` и создать заново, затем
+  indexTree. Вернуть `переиндексировано файлов: <N>`.
+- memo_reindex через tools/call должен РАБОТАТЬ (не isError).
+- Неизвестный инструмент → isError true с текстом "unknown tool: <name>".
+
+## McpProtocolTest.kt — ровно 5 тестов, имена ровно такие
+
+1. `initializeHandshake` — handleRequest(строка JSON с initialize) → ответ содержит "2024-11-05" и "memo".
+2. `toolsListHasThreeTools` — ответ на tools/list содержит имена memo_search, memo_status, memo_reindex.
+3. `unknownMethodReturns32601` — ответ содержит "-32601".
+4. `searchWithoutPathIsError` — tools/call memo_search с пустыми arguments → в ответе "isError":true.
+5. `notificationProducesNoResponse` — handleRequest("{\"jsonrpc\":\"2.0\",\"method\":\"notifications/initialized\"}") == null.
+
+После: ./gradlew :memo-mcp:test --rerun-tasks — зелёные; ./gradlew :memo-mcp:installDist — собирается;
+бинарь: memo-mcp/build/install/memo-mcp/bin/memo-mcp
+Коммит: git add -A && git commit -m "mcp: сервер memo_search/memo_status/memo_reindex"
+
+СТРОГИЕ ЗАПРЕТЫ:
+- Не выводить план текстом; сразу создавай файлы.
+- Не трогать memo-core, memo-cli, memo-watch.
+- Ничего не печатать в stdout, кроме строк JSON-RPC.