docs: add kb_add to all i18n README files

docs/readme/README.de.md

@@ -51,12 +51,14 @@ wikiloop-kb/
 
 ## Wie Agenten WikiLoop nutzen
 
-Agenten interagieren mit WikiLoop über zwei MCP-Tools:
+Agenten interagieren mit WikiLoop über drei MCP-Tools:
 
 **`kb_search(query, limit?)`** — Suche mit einem Schlüsselwort oder einer Phrase. Gibt bis zu 5 Source-Notes und 3 Concept/Comparison/Decision-Seiten pro Aufruf zurück. Jedes Ergebnis enthält ein `related`-Feld mit verknüpften Dokumenten zur Navigation. Verwenden Sie mehrere Suchen mit verschiedenen Schlüsselwörtern, um ein Thema aus mehreren Blickwinkeln abzudecken.
 
 **`kb_page(ids, full?)`** — Vollständigen Inhalt einer oder mehrerer Seiten per ID abrufen (aus `kb_search`-Ergebnissen). Übergeben Sie bis zu 5 IDs um mehrere Dokumente gleichzeitig zu scannen, oder `full=true` mit einer einzelnen ID für vollständigen ungekürzten Text.
 
+**`kb_add(filename, content, source_url?)`** — Ein Textdokument zur Wissensdatenbank hinzufügen. Schreibt den Inhalt nach `raw/<filename>` und löst inkrementelle Indizierung aus. Die Destillation läuft asynchron im Hintergrund. Verwenden Sie das Präfix `converted/` für von Agenten extrahierte PDF/Word/Excel/EPUB-Inhalte.
+
 Empfohlener Agenten-Workflow:
 
 ```text
@@ -232,7 +234,7 @@ Alle Befehle akzeptieren ein globales `--kb <path>`-Flag (Standard: `$WIKILOOP_K
 
 WikiLoop stellt KB-Tools über das MCP-Protokoll bereit.
 
-**Verfügbare Tools:** `kb_search`, `kb_page`
+**Verfügbare Tools:** `kb_search`, `kb_page`, `kb_add`
 
 Admin-Operationen (`status`, `reindex`, `lint`) sind über die Web-UI oder CLI verfügbar (`wikiloop status`, `wikiloop index`, `wikiloop lint`).
 

docs/readme/README.es.md

@@ -51,12 +51,14 @@ wikiloop-kb/
 
 ## Cómo usan los agentes WikiLoop
 
-Los agentes interactúan con WikiLoop a través de dos herramientas MCP:
+Los agentes interactúan con WikiLoop a través de tres herramientas MCP:
 
 **`kb_search(query, limit?)`** — Buscar con una palabra clave o frase. Devuelve hasta 5 source-notes y 3 páginas concept/comparison/decision por llamada. Cada resultado incluye un campo `related` con documentos relacionados para navegación. Use múltiples búsquedas con diferentes palabras clave para cubrir un tema desde múltiples ángulos.
 
 **`kb_page(ids, full?)`** — Recupera el contenido completo de una o más páginas por ID (de los resultados de `kb_search`). Pase hasta 5 IDs para escanear varios documentos a la vez, o `full=true` con un solo ID para obtener el texto completo sin truncar.
 
+**`kb_add(filename, content, source_url?)`** — Añade un documento de texto a la base de conocimiento. Escribe el contenido en `raw/<filename>` y desencadena la indexación incremental. La destilación se ejecuta de forma asíncrona en segundo plano. Use el prefijo `converted/` para contenido extraído por agentes de PDF/Word/Excel/EPUB.
+
 Flujo de trabajo recomendado del agente:
 
 ```text
@@ -232,7 +234,7 @@ Todos los comandos aceptan un flag global `--kb <path>` (por defecto `$WIKILOOP_
 
 WikiLoop expone herramientas KB a través del protocolo MCP.
 
-**Herramientas disponibles:** `kb_search`, `kb_page`
+**Herramientas disponibles:** `kb_search`, `kb_page`, `kb_add`
 
 Las operaciones de administración (`status`, `reindex`, `lint`) están disponibles vía la interfaz Web o CLI (`wikiloop status`, `wikiloop index`, `wikiloop lint`).
 

docs/readme/README.fr.md

@@ -51,12 +51,14 @@ wikiloop-kb/
 
 ## Comment les agents utilisent WikiLoop
 
-Les agents interagissent avec WikiLoop via deux outils MCP :
+Les agents interagissent avec WikiLoop via trois outils MCP :
 
 **`kb_search(query, limit?)`** — Recherche avec un mot-clé ou une phrase. Retourne jusqu'à 5 source-notes et 3 pages concept/comparison/decision par appel. Chaque résultat inclut un champ `related` listant les documents liés pour la navigation. Utilisez plusieurs recherches avec différents mots-clés pour couvrir un sujet sous plusieurs angles.
 
 **`kb_page(ids, full?)`** — Récupère le contenu complet d'une ou plusieurs pages par ID (depuis les résultats `kb_search`). Passez jusqu'à 5 IDs pour parcourir plusieurs documents à la fois, ou `full=true` avec un seul ID pour obtenir le texte complet non tronqué.
 
+**`kb_add(filename, content, source_url?)`** — Ajoute un document texte à la base de connaissances. Écrit le contenu dans `raw/<filename>` et déclenche l'indexation incrémentale. La distillation s'exécute de manière asynchrone en arrière-plan. Utilisez le préfixe `converted/` pour le contenu extrait par des agents depuis des fichiers PDF/Word/Excel/EPUB.
+
 Workflow agent recommandé :
 
 ```text
@@ -232,7 +234,7 @@ Toutes les commandes acceptent un flag global `--kb <path>` (par défaut `$WIKIL
 
 WikiLoop expose les outils KB via le protocole MCP.
 
-**Outils disponibles :** `kb_search`, `kb_page`
+**Outils disponibles :** `kb_search`, `kb_page`, `kb_add`
 
 Les opérations d'administration (`status`, `reindex`, `lint`) sont disponibles via l'interface Web ou CLI (`wikiloop status`, `wikiloop index`, `wikiloop lint`).
 

docs/readme/README.ko.md

@@ -51,12 +51,14 @@ wikiloop-kb/
 
 ## 에이전트가 WikiLoop를 사용하는 방법
 
-에이전트는 두 가지 MCP 도구를 통해 WikiLoop와 상호작용합니다:
+에이전트는 세 가지 MCP 도구를 통해 WikiLoop와 상호작용합니다:
 
 **`kb_search(query, limit?)`** — 키워드나 문구로 검색합니다. 호출당 최대 5개의 source-note와 3개의 concept/comparison/decision 페이지를 반환합니다. 각 결과에는 탐색을 위한 관련 문서 목록이 담긴 `related` 필드가 포함됩니다. 여러 다른 키워드로 여러 번 검색하여 주제를 다양한 각도에서 다룹니다.
 
 **`kb_page(ids, full?)`** — ID(kb_search 결과에서)로 하나 이상의 페이지 전체 내용을 가져옵니다. 최대 5개의 ID를 전달하여 여러 문서를 한 번에 스캔하거나, 단일 ID와 `full=true`를 사용하여 완전한 전체 텍스트를 가져옵니다.
 
+**`kb_add(filename, content, source_url?)`** — 지식 베이스에 텍스트 문서를 추가합니다. 콘텐츠를 `raw/<filename>`에 쓰고 증분 인덱싱을 트리거합니다. 증류는 백그라운드에서 비동기적으로 실행됩니다. 에이전트가 PDF/Word/Excel/EPUB에서 추출한 콘텐츠에는 `converted/` 접두사를 사용하세요.
+
 권장 에이전트 워크플로우:
 
 ```text
@@ -232,7 +234,7 @@ wikiloop lint           # wiki 페이지 상태 점검
 
 WikiLoop는 MCP 프로토콜을 통해 KB 도구를 노출합니다.
 
-**사용 가능한 도구:** `kb_search`, `kb_page`
+**사용 가능한 도구:** `kb_search`, `kb_page`, `kb_add`
 
 관리 작업 (`status`, `reindex`, `lint`)은 Web UI 또는 CLI를 통해 사용 가능합니다 (`wikiloop status`, `wikiloop index`, `wikiloop lint`).
 

docs/readme/README.ru.md

@@ -51,12 +51,14 @@ wikiloop-kb/
 
 ## Как агенты используют WikiLoop
 
-Агенты взаимодействуют с WikiLoop через два MCP-инструмента:
+Агенты взаимодействуют с WikiLoop через три MCP-инструмента:
 
 **`kb_search(query, limit?)`** — Поиск по ключевому слову или фразе. Возвращает до 5 source-notes и 3 страниц concept/comparison/decision за вызов. Каждый результат содержит поле `related` со списком связанных документов для навигации. Используйте несколько поисков с разными ключевыми словами для охвата темы с разных сторон.
 
 **`kb_page(ids, full?)`** — Получение полного содержимого одной или нескольких страниц по ID (из результатов `kb_search`). Передавайте до 5 ID для просмотра нескольких документов сразу, или `full=true` с одним ID для получения полного неусечённого текста.
 
+**`kb_add(filename, content, source_url?)`** — Добавляет текстовый документ в базу знаний. Записывает содержимое в `raw/<filename>` и запускает инкрементальную индексацию. Дистилляция выполняется асинхронно в фоновом режиме. Используйте префикс `converted/` для контента, извлечённого агентами из PDF/Word/Excel/EPUB.
+
 Рекомендуемый рабочий процесс агента:
 
 ```text
@@ -232,7 +234,7 @@ wikiloop lint           # проверка wiki-страниц
 
 WikiLoop предоставляет инструменты базы знаний через протокол MCP.
 
-**Доступные инструменты:** `kb_search`, `kb_page`
+**Доступные инструменты:** `kb_search`, `kb_page`, `kb_add`
 
 Административные операции (`status`, `reindex`, `lint`) доступны через Web UI или CLI (`wikiloop status`, `wikiloop index`, `wikiloop lint`).
 

docs/readme/README.zh-CN.md

@@ -51,12 +51,14 @@ wikiloop-kb/
 
 ## Agent 如何使用 WikiLoop
 
-Agent 通过两个 MCP 工具与 WikiLoop 交互：
+Agent 通过三个 MCP 工具与 WikiLoop 交互：
 
 **`kb_search(query, limit?)`** — 用关键词或自然语言搜索。每次返回最多 5 篇 source-note 和 3 篇 concept/comparison/decision 页面。每条结果包含 `related` 字段，列出关联文档供继续导航。用不同关键词多次搜索，从多个角度覆盖话题。
 
 **`kb_page(ids, full?)`** — 按 ID（来自 `kb_search` 结果）获取一篇或多篇页面的完整内容。一次最多传 5 个 ID，或对单篇使用 `full=true` 获取不截断的全文。
 
+**`kb_add(filename, content, source_url?)`** — 向知识库添加文本文档。将内容写入 `raw/<filename>` 并触发增量索引。提炼在后台异步运行。Agent 提取的 PDF/Word/Excel/EPUB 内容使用 `converted/` 前缀。
+
 推荐的 Agent 工作流：
 
 ```text
@@ -232,7 +234,7 @@ wikiloop lint           # 健康检查 wiki 页面
 
 WikiLoop 通过 MCP 协议对外暴露 KB 工具。
 
-**可用 tools：** `kb_search`、`kb_page`
+**可用 tools：** `kb_search`、`kb_page`、`kb_add`
 
 管理操作（状态、重建索引、健康检查）通过 Web UI 或 CLI 执行：`wikiloop status`、`wikiloop index`、`wikiloop lint`。
 

docs/readme/README.zh-TW.md

@@ -51,12 +51,14 @@ wikiloop-kb/
 
 ## Agent 如何使用 WikiLoop
 
-Agent 透過兩個 MCP 工具與 WikiLoop 互動：
+Agent 透過三個 MCP 工具與 WikiLoop 互動：
 
 **`kb_search(query, limit?)`** — 用關鍵詞或自然語言搜尋。每次返回最多 5 篇 source-note 和 3 篇 concept/comparison/decision 頁面。每條結果包含 `related` 欄位，列出關聯文件供繼續導覽。用不同關鍵詞多次搜尋，從多個角度涵蓋話題。
 
 **`kb_page(ids, full?)`** — 按 ID（來自 `kb_search` 結果）獲取一篇或多篇頁面的完整內容。一次最多傳 5 個 ID，或對單篇使用 `full=true` 獲取不截斷的全文。
 
+**`kb_add(filename, content, source_url?)`** — 向知識庫新增文字文件。將內容寫入 `raw/<filename>` 並觸發增量索引。提煉在後台非同步執行。Agent 提取的 PDF/Word/Excel/EPUB 內容使用 `converted/` 前綴。
+
 推薦的 Agent 工作流程：
 
 ```text
@@ -232,7 +234,7 @@ wikiloop lint           # 健康檢查 wiki 頁面
 
 WikiLoop 透過 MCP 協議對外暴露 KB 工具。
 
-**可用 tools：** `kb_search`、`kb_page`
+**可用 tools：** `kb_search`、`kb_page`、`kb_add`
 
 管理操作（狀態、重建索引、健康檢查）透過 Web UI 或 CLI 執行：`wikiloop status`、`wikiloop index`、`wikiloop lint`。