bathys 0.6.1__tar.gz → 0.6.2__tar.gz

{bathys-0.6.1 → bathys-0.6.2}/.remember/logs/memory-2026-09-08.log

@@ -134,3 +134,32 @@
 11:14:09 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
 11:14:20 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
 11:14:21 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:39:12 [hook] session-start: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:39:12 [hook] session-start: capture-gap check skipped — no session_id on stdin
+12:42:38 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:42:38 [hook] WARNING: no session dir for this project: /var/home/abyss/.distrobox/ubuntu/home/.claude/projects/-var-home-abyss-LABs-MCP-deepreserch (slug of /var/home/abyss/LABs/MCP/deepreserch). Memory cannot save until it matches a directory under /var/home/abyss/.distrobox/ubuntu/home/.claude/projects/
+12:42:44 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:42:49 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:42:49 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:42:56 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:05 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:06 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:16 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:16 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:16 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:19 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:23 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:41 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:45 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:55 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:56 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:56 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:43:56 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:44:29 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:45:15 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:45:19 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:45:29 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:45:35 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:45:40 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:45:43 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember
+12:45:47 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/.remember

bathys-0.6.2/.remember/tmp/no-transcript-notice

@@ -0,0 +1 @@
+1788860558

{bathys-0.6.1 → bathys-0.6.2}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 Формат: Keep a Changelog; версии — semver. Дата — дата выпуска версии.
 
+## [0.6.2] — 2026-09-08
+
+Публикационная волна: PyPI + NPM + кастомные интеграции.
+
+### Добавлено
+
+- **Каталог `integrations/`** — кастомные интеграции с конвенцией (README-установщик-assets): `hermes/` (установщик `install.py`: создаёт `~/.hermes/config.yaml` с `mcp_servers.bathys`, ставит субагента; идемпотентен, бэкап; ловит и чинит артефакт старой установки), `pi/` (дроп-ин `assets/bathys-rules.md` для `AGENTS.md` — у Pi нет MCP-конфига), `zcode/` (комплект: конфиг + субагент + скиллы + дроп-ин).
+- **NPM-обёртка `bathys-mcp`** (`npm/bathys-mcp/`): тонкий установщик для Node-first пользователей — postinstall ставит Python-пакет (`pip install bathys`), CLI делегирует `bathys install|doctor|--help` и запускает stdio-сервер; проверена на node v20 (install --dry-run, print-config, doctor — зелёные). Публикуется на NPM как `bathys-mcp`.
+- **Живые интеграции на машине мейнтейнера**: Hermes — `config.yaml` + субагент установлены идемпотентно.
+
+### Изменено
+
+- **Метаданные пакета** (PyPI-витрина): `description` переведён на канон продукта («Unified local deep-research search service…», вместо обёрточной формулировки про SearXNG/Crawl4AI); добавлены `keywords` (mcp, deep-research, local-first…), `classifiers`, секция `[project.urls]` (Homepage/Repository/Changelog/Documentation).
+
 ## [0.6.1] — 2026-09-08
 
 Расширение автодетекта `bathys install` на базовый набор харнессов (форматы подтверждены первоисточниками каждого клиента).

bathys-0.6.1/README.md → bathys-0.6.2/PKG-INFO

@@ -1,3 +1,29 @@
+Metadata-Version: 2.5
+Name: bathys
+Version: 0.6.2
+Summary: Unified local deep-research search service for AI agents — one pipeline (search → extraction → query distillation → cache), zero cloud quotas. MCP stdio server with native harness integration (bathys install).
+Project-URL: Homepage, https://github.com/Korrnals/bathys
+Project-URL: Repository, https://github.com/Korrnals/bathys
+Project-URL: Changelog, https://github.com/Korrnals/bathys/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/Korrnals/bathys/tree/main/docs
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,crawl4ai,deep-research,distillation,llm,local-first,mcp,search,searxng,web-search
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: crawl4ai>=0.6.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2,>=1.2.0
+Description-Content-Type: text/markdown
+
 <p align="center"><img src="docs/assets/banner.svg" alt="Bathys" width="720"></p>
 
 # Bathys
@@ -7,21 +33,35 @@
 Сонар находит координаты, батискаф ныряет за полными текстами, дистиллятор поднимает на палубу только то, что отвечает на вопрос.
 
 ![python](https://img.shields.io/badge/python-3.10%2B-blue)
-![version](https://img.shields.io/badge/version-0.6.1-9cf)
+![version](https://img.shields.io/badge/version-0.6.2-9cf)
 ![mcp](https://img.shields.io/badge/MCP-stdio%20server-6f42c1)
 ![license](https://img.shields.io/badge/license-MIT-green)
 
 ## ⚡ Quick start
 
-Нужны Python ≥ 3.10 и `git`. В каталоге проекта:
+**Из PyPI** (основной путь — Python ≥ 3.10):
+
+```bash
+pip install bathys                        # сервер + команды bathys/bathys-doctor
+python -m playwright install chromium     # браузер для извлечения
+bathys install                            # автоподключение к найденным харнессам
+bathys-doctor                             # диагностика стека одним запуском
+```
+
+**Из npm** (для Node-first окружений — обёртка ставит Python-пакет сама):
+
+```bash
+npm install -g bathys-mcp
+bathys-mcp install
+```
+
+**Из исходников** (разработка):
 
 ```bash
 git clone https://github.com/Korrnals/bathys.git && cd bathys
-python3.12 -m venv .venv
-.venv/bin/pip install -e .
-.venv/bin/python -m playwright install chromium   # браузер для извлечения
-.venv/bin/python -m unittest discover -s tests    # 72 теста без сети, ~0.1 c
-.venv/bin/bathys-doctor                           # диагностика стека одним запуском
+python3.12 -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m playwright install chromium
+.venv/bin/python -m unittest discover -s tests    # юнит-тесты без сети, ~0.1 c
 ```
 
 В минимальном контейнерном образе без `ensurepip` venv собирается через `get-pip.py` — ветка в [docs/getting-started/install.md](docs/getting-started/install.md). SearXNG поднимать руками не нужно: при первом поиске сервер сам пробует внешний инстанс, затем docker/podman, затем нативный режим ([docs/getting-started/configure.md](docs/getting-started/configure.md)).
@@ -34,7 +74,7 @@ python3.12 -m venv .venv
 .venv/bin/bathys install            # сначала --dry-run, чтобы увидеть план
 ```
 
-Детектируются zcode, Claude Code, Claude Desktop, Cursor; повторный запуск ничего не меняет — запись идемпотентна. Поддерживаются `--print-config` (готовые блоки для ручной вставки) и `--searxng-home <путь>`.
+Детектируются zcode, Claude Code, Claude Desktop, Cursor, VS Code-семейство (Cline / Roo Code / Kilo Code), Gemini CLI, Windsurf, Zed, opencode, goose, Hermes; форматы каждого — свои (JSON-схемы и YAML-контуры goose/hermes), запись идемпотентна. Для Pi (badlogic pi-mono), у которого нет MCP-конфига, — дроп-ин в `AGENTS.md`. Поддерживаются `--print-config` (готовые блоки для ручной вставки) и `--searxng-home <путь>`; кастомные интеграции — в каталоге [integrations/](integrations/).
 
 **Вручную.** Bathys — stdio MCP-сервер, конфиг везде один и тот же блок `mcpServers`; от харнесса зависит только файл, в который его кладут. `command` — абсолютный путь к вашему клону (`~` внутри JSON не раскрывается); `BATHYS_SEARXNG_HOME` опциональна.
 
@@ -122,11 +162,11 @@ docs/
 └── meta/             # стайлгайд · глоссарий
 ```
 
-Вне `docs/`: [agents/](agents/) (субагент `bathys-researcher`, дроп-ин для харнессов) · [tests/](tests/) (72 юнит-теста без сети) · [scripts/](scripts/) (smoke, stdio_check, метрики) · [CHANGELOG.md](CHANGELOG.md).
+Вне `docs/`: [agents/](agents/) (субагент `bathys-researcher`, скиллы, дроп-ин для харнессов) · [integrations/](integrations/) (кастомные интеграции: hermes, pi, zcode) · [tests/](tests/) (юнит-тесты без сети) · [scripts/](scripts/) (smoke, stdio_check, метрики) · [npm/bathys-mcp/](npm/bathys-mcp/) (NPM-обёртка) · [CHANGELOG.md](CHANGELOG.md).
 
 ## 📍 Статус
 
-**0.6.1.** Выпускная история: v0.2 «Качество выдачи» (ретраи, здоровье движков), v0.3 «Паритет с Tavily» (`read_urls`, JSON-режим), v0.4 «Эксплуатация» (robots-этика, метрики, `bathys-doctor`), v0.5 «Identity & Harness» (репозиционирование, промпты, субагент), v0.6 «Native Install» (`bathys install`) — итоги в [CHANGELOG.md](CHANGELOG.md).
+**0.6.2.** Выпускная история: v0.2 «Качество выдачи» (ретраи, здоровье движков), v0.3 «Паритет с Tavily» (`read_urls`, JSON-режим), v0.4 «Эксплуатация» (robots-этика, метрики, `bathys-doctor`), v0.5 «Identity & Harness» (репозиционирование, промпты, субагент), v0.6 «Native Install» (`bathys install`) — итоги в [CHANGELOG.md](CHANGELOG.md).
 
 Репозиторий: `github.com/Korrnals/bathys`. До 1.0 остаются публикация пакета `bathys` на PyPI (имя свободно, публикация планируется к 1.0) и первый прогон Docker-образа; CI с matrix 3.10–3.12 уже в репозитории.
 

bathys-0.6.1/PKG-INFO → bathys-0.6.2/README.md

@@ -1,15 +1,3 @@
-Metadata-Version: 2.5
-Name: bathys
-Version: 0.6.1
-Summary: Deep-research MCP server: SearXNG metasearch + Crawl4AI extraction, distilled to LLM-lean output
-License: MIT
-License-File: LICENSE
-Requires-Python: >=3.10
-Requires-Dist: crawl4ai>=0.6.0
-Requires-Dist: httpx>=0.27
-Requires-Dist: mcp<2,>=1.2.0
-Description-Content-Type: text/markdown
-
 <p align="center"><img src="docs/assets/banner.svg" alt="Bathys" width="720"></p>
 
 # Bathys
@@ -19,21 +7,35 @@ Description-Content-Type: text/markdown
 Сонар находит координаты, батискаф ныряет за полными текстами, дистиллятор поднимает на палубу только то, что отвечает на вопрос.
 
 ![python](https://img.shields.io/badge/python-3.10%2B-blue)
-![version](https://img.shields.io/badge/version-0.6.1-9cf)
+![version](https://img.shields.io/badge/version-0.6.2-9cf)
 ![mcp](https://img.shields.io/badge/MCP-stdio%20server-6f42c1)
 ![license](https://img.shields.io/badge/license-MIT-green)
 
 ## ⚡ Quick start
 
-Нужны Python ≥ 3.10 и `git`. В каталоге проекта:
+**Из PyPI** (основной путь — Python ≥ 3.10):
+
+```bash
+pip install bathys                        # сервер + команды bathys/bathys-doctor
+python -m playwright install chromium     # браузер для извлечения
+bathys install                            # автоподключение к найденным харнессам
+bathys-doctor                             # диагностика стека одним запуском
+```
+
+**Из npm** (для Node-first окружений — обёртка ставит Python-пакет сама):
+
+```bash
+npm install -g bathys-mcp
+bathys-mcp install
+```
+
+**Из исходников** (разработка):
 
 ```bash
 git clone https://github.com/Korrnals/bathys.git && cd bathys
-python3.12 -m venv .venv
-.venv/bin/pip install -e .
-.venv/bin/python -m playwright install chromium   # браузер для извлечения
-.venv/bin/python -m unittest discover -s tests    # 72 теста без сети, ~0.1 c
-.venv/bin/bathys-doctor                           # диагностика стека одним запуском
+python3.12 -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m playwright install chromium
+.venv/bin/python -m unittest discover -s tests    # юнит-тесты без сети, ~0.1 c
 ```
 
 В минимальном контейнерном образе без `ensurepip` venv собирается через `get-pip.py` — ветка в [docs/getting-started/install.md](docs/getting-started/install.md). SearXNG поднимать руками не нужно: при первом поиске сервер сам пробует внешний инстанс, затем docker/podman, затем нативный режим ([docs/getting-started/configure.md](docs/getting-started/configure.md)).
@@ -46,7 +48,7 @@ python3.12 -m venv .venv
 .venv/bin/bathys install            # сначала --dry-run, чтобы увидеть план
 ```
 
-Детектируются zcode, Claude Code, Claude Desktop, Cursor; повторный запуск ничего не меняет — запись идемпотентна. Поддерживаются `--print-config` (готовые блоки для ручной вставки) и `--searxng-home <путь>`.
+Детектируются zcode, Claude Code, Claude Desktop, Cursor, VS Code-семейство (Cline / Roo Code / Kilo Code), Gemini CLI, Windsurf, Zed, opencode, goose, Hermes; форматы каждого — свои (JSON-схемы и YAML-контуры goose/hermes), запись идемпотентна. Для Pi (badlogic pi-mono), у которого нет MCP-конфига, — дроп-ин в `AGENTS.md`. Поддерживаются `--print-config` (готовые блоки для ручной вставки) и `--searxng-home <путь>`; кастомные интеграции — в каталоге [integrations/](integrations/).
 
 **Вручную.** Bathys — stdio MCP-сервер, конфиг везде один и тот же блок `mcpServers`; от харнесса зависит только файл, в который его кладут. `command` — абсолютный путь к вашему клону (`~` внутри JSON не раскрывается); `BATHYS_SEARXNG_HOME` опциональна.
 
@@ -134,11 +136,11 @@ docs/
 └── meta/             # стайлгайд · глоссарий
 ```
 
-Вне `docs/`: [agents/](agents/) (субагент `bathys-researcher`, дроп-ин для харнессов) · [tests/](tests/) (72 юнит-теста без сети) · [scripts/](scripts/) (smoke, stdio_check, метрики) · [CHANGELOG.md](CHANGELOG.md).
+Вне `docs/`: [agents/](agents/) (субагент `bathys-researcher`, скиллы, дроп-ин для харнессов) · [integrations/](integrations/) (кастомные интеграции: hermes, pi, zcode) · [tests/](tests/) (юнит-тесты без сети) · [scripts/](scripts/) (smoke, stdio_check, метрики) · [npm/bathys-mcp/](npm/bathys-mcp/) (NPM-обёртка) · [CHANGELOG.md](CHANGELOG.md).
 
 ## 📍 Статус
 
-**0.6.1.** Выпускная история: v0.2 «Качество выдачи» (ретраи, здоровье движков), v0.3 «Паритет с Tavily» (`read_urls`, JSON-режим), v0.4 «Эксплуатация» (robots-этика, метрики, `bathys-doctor`), v0.5 «Identity & Harness» (репозиционирование, промпты, субагент), v0.6 «Native Install» (`bathys install`) — итоги в [CHANGELOG.md](CHANGELOG.md).
+**0.6.2.** Выпускная история: v0.2 «Качество выдачи» (ретраи, здоровье движков), v0.3 «Паритет с Tavily» (`read_urls`, JSON-режим), v0.4 «Эксплуатация» (robots-этика, метрики, `bathys-doctor`), v0.5 «Identity & Harness» (репозиционирование, промпты, субагент), v0.6 «Native Install» (`bathys install`) — итоги в [CHANGELOG.md](CHANGELOG.md).
 
 Репозиторий: `github.com/Korrnals/bathys`. До 1.0 остаются публикация пакета `bathys` на PyPI (имя свободно, публикация планируется к 1.0) и первый прогон Docker-образа; CI с matrix 3.10–3.12 уже в репозитории.
 

bathys-0.6.2/integrations/README.md

@@ -0,0 +1,33 @@
+# integrations/ — кастомные интеграции Bathys
+
+Здесь живут интеграции для харнессов, которым мало стандартной записи MCP-сервера:
+скрипты, оболочки, готовые конфиги и дроп-ины. Стандартный автопат (`bathys
+install`) покрывает 14 клиентов из их собственных конфигов; этот каталог —
+для кастомной механики.
+
+## Конвенция
+
+Каждая интеграция — подкаталог `integrations/<harness>/`:
+
+```
+integrations/<harness>/
+├── README.md        # что это, когда нужно, установка по шагам
+├── install.*         # установщик (если интеграция больше ручной вставки)
+└── assets/           # конфиги, скрипты, промпты, расширения
+```
+
+Правила:
+
+- интеграция не тянет зависимостей сверх самого Bathys (только stdlib);
+- установщик идемпотентен и делает бэкап перед записью — как `bathys install`;
+- каждый README фиксирует формат конфига по первоисточнику (ссылка на доки
+  харнесса) и дату проверки;
+- сюда попадают только кастомные пути; обычные конфиги правит `bathys install`.
+
+## Содержимое
+
+| Интеграция | Что даёт |
+|---|---|
+| [`hermes/`](hermes/) | установщик для Hermes Agent: `mcp_servers` в `~/.hermes/config.yaml` + субагент в `~/.hermes/agents/`; обходит случай, когда у Hermes нет конфига вообще (создаёт по канону его доков) |
+| [`pi/`](pi/) | дроп-ин для Pi (badlogic pi-mono): у Pi нет MCP-конфига — интеграция это правила для `AGENTS.md` проекта + скилл-каталог Bathys |
+| [`zcode/`](zcode/) | комплект для zcode: MCP-конфиг, субагент `bathys-researcher`, скиллы и ссылка на дроп-ин — всё, что ставится копированием |

bathys-0.6.2/integrations/hermes/README.md

@@ -0,0 +1,37 @@
+# Bathys × Hermes Agent
+
+[Hermes Agent](https://github.com/NousResearch/hermes-agent) читает MCP из
+`~/.hermes/config.yaml` под ключом `mcp_servers` (snake_case; формат
+подтверждён [доками Hermes](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp),
+проверено 2026-09-08). Стандартный `bathys install` уже пишет этот файл, если
+он существует. Эта интеграция добавляет остальное:
+
+- **создаёт** `~/.hermes/config.yaml`, если его ещё нет (Hermes после первого
+  запуска имеет), — по канону его доков;
+- ставит **субагента** `bathys-researcher` в `~/.hermes/agents/`.
+
+## Установка
+
+```bash
+python integrations/hermes/install.py            # что изменится — вначале план
+python integrations/hermes/install.py --apply   # записать (бэкап создастся сам)
+```
+
+Скрипту нужен только Python ≥3.10 (stdlib); он не импортирует bathys и
+работает с любой установки (`pip install bathys` или из клона). Идемпотентен:
+повторный запуск ничего не меняет.
+
+## Что именно пишется
+
+`~/.hermes/config.yaml`:
+
+```yaml
+mcp_servers:
+  bathys:
+    command: "<путь к bathys>"
+    args: []
+    env: {}
+```
+
+`~/.hermes/agents/bathys-researcher.md` — профиль субагента глубокого ресёрча
+(копия `agents/bathys-researcher.md` из корня репозитория).

bathys-0.6.2/integrations/hermes/install.py

@@ -0,0 +1,149 @@
+#!/usr/bin/env python3
+"""Bathys integration installer for Hermes Agent.
+
+Creates ~/.hermes/config.yaml (mcp_servers.bathys) when absent and installs
+the researcher subagent into ~/.hermes/agents/. Idempotent; backs up any
+existing config before writing. Stdlib-only, works from any Bathys install.
+
+Usage:
+  python integrations/hermes/install.py            # plan only
+  python integrations/hermes/install.py --apply   # write changes
+"""
+
+from __future__ import annotations
+
+import argparse
+import datetime
+import re
+import shutil
+import sys
+from pathlib import Path
+
+HOME = Path.home()
+CONFIG = HOME / ".hermes" / "config.yaml"
+AGENTS = HOME / ".hermes" / "agents"
+
+
+def _bathys_command() -> str:
+    launcher = Path(sys.executable).parent / "bathys"
+    if launcher.is_file():
+        return str(launcher)
+    here = Path(__file__).resolve()
+    for base in (here.parents[2], here.parents[3]):
+        cand = base / ".venv" / "bin" / "bathys"
+        if cand.is_file():
+            return str(cand)
+    return "bathys"
+
+
+ENTRY = """mcp_servers:
+  bathys:
+    command: "{cmd}"
+    args: []
+    env: {{}}
+"""
+
+
+def _entry_block(cmd: str) -> str:
+    return ENTRY.format(cmd=cmd)
+
+
+def _has_bathys(text: str) -> bool:
+    return re.search(r"^  bathys:", text, re.M) is not None
+
+
+def _set_bathys(text: str, cmd: str) -> str:
+    block = _entry_block(cmd).rstrip("\n").splitlines()
+    lines = text.splitlines()
+    # replace existing entry if present
+    for i, ln in enumerate(lines):
+        if re.match(r"^  bathys:\s*$", ln):
+            j = i + 1
+            while j < len(lines) and (not lines[j].strip() or lines[j].startswith("    ")):
+                j += 1
+            lines[i:j] = block[1:]
+            return "\n".join(lines) + "\n"
+    # root mcp_servers present? insert at its end
+    for i, ln in enumerate(lines):
+        if re.match(r"^mcp_servers:\s*$", ln):
+            j = i + 1
+            while j < len(lines) and (not lines[j].strip() or lines[j].startswith("  ")):
+                j += 1
+            lines[j:j] = block[1:]
+            return "\n".join(lines) + "\n"
+    # append a fresh root
+    sep = [""] if lines else []
+    return "\n".join(lines + sep + block) + "\n"
+
+
+def _agent_src() -> Path | None:
+    here = Path(__file__).resolve()
+    for base in (here.parents[2], here.parents[3]):
+        cand = base / "agents" / "bathys-researcher.md"
+        if cand.is_file():
+            return cand
+    # site-packages layout (pip install): bathys/agents/ inside the package
+    for parent in here.parents:
+        cand = parent / "bathys" / "agents" / "bathys-researcher.md"
+        if cand.is_file():
+            return cand
+    return None
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description=__doc__)
+    ap.add_argument("--apply", action="store_true", help="write changes (default: plan)")
+    args = ap.parse_args()
+
+    cmd = _bathys_command()
+    changes: list[str] = []
+
+    if CONFIG.is_file():
+        text = CONFIG.read_text(encoding="utf-8")
+        if _has_bathys(text) and f'command: "{cmd}"' in text:
+            print(f"[=] {CONFIG}: bathys уже актуален")
+        else:
+            changes.append(f"обновить {CONFIG} (бэкап создастся)")
+    else:
+        changes.append(f"создать {CONFIG} (mcp_servers.bathys)")
+
+    src = _agent_src()
+    dst = AGENTS / "bathys-researcher.md" if src else None
+    if src and dst:
+        if dst.is_file() and dst.read_text(encoding="utf-8") == src.read_text(encoding="utf-8"):
+            print("[=] субагент уже актуален")
+        else:
+            changes.append(f"субагент {src.name} -> {dst}")
+
+    if not changes:
+        print("Готово: изменений нет.")
+        return 0
+    print("План изменений:")
+    for c in changes:
+        print("  -", c)
+    if not args.apply:
+        print("Запустите с --apply, чтобы записать.")
+        return 0
+
+    if not args.apply:
+        return 0
+    if CONFIG.is_file():
+        stamp = datetime.datetime.now().strftime("%Y%m%d-%H%M%S")
+        shutil.copy2(CONFIG, CONFIG.with_name(f"{CONFIG.name}.bathys-backup-{stamp}"))
+        CONFIG.write_text(_set_bathys(CONFIG.read_text(encoding="utf-8"), cmd), encoding="utf-8")
+    else:
+        CONFIG.parent.mkdir(parents=True, exist_ok=True)
+        CONFIG.write_text(_entry_block(cmd), encoding="utf-8")
+    print(f"[OK] конфиг: {CONFIG}")
+    if src and dst:
+        if dst.is_dir():
+            shutil.rmtree(dst)  # recover from the pre-0.6.2 dir-instead-of-file bug
+        dst.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(src, dst)
+        print(f"[OK] субагент: {dst}")
+    print("Перезапустите Hermes, чтобы он подхватил mcp_servers.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

bathys-0.6.2/integrations/pi/README.md

@@ -0,0 +1,42 @@
+# Bathys × Pi (badlogic pi-mono)
+
+У Pi **нет MCP-конфигурационного файла** — интеграции в нём делаются
+TypeScript-расширениями (проверено по исходникам [pi-mono](https://github.com/badlogic/pi-mono),
+2026-09-08: ни `mcpServers`, ни modelcontextprotocol-зависимостей в кодовой
+базе). Поэтому интеграция Bathys в Pi — это **агентные тексты**, а не конфиг:
+
+1. **Правила для `AGENTS.md` проекта** — Pi читает его как файл инструкций
+   агента; блок ниже приучает агента Pi работать в интернете только через
+   Bathys.
+2. **Скилл-каталог** — копия профилей Bathys, которые Pi-агент подхватывает
+   как документы-инструкции.
+
+## Установка (в каталог проекта, где работает Pi)
+
+```bash
+cp integrations/pi/assets/bathys-rules.md ./AGENTS.md.appendix   # или вставьте блок в AGENTS.md
+mkdir -p .pi/skills && cp -r agents/skills/* .pi/skills/
+```
+
+Правильнее — открыть `AGENTS.md` проекта и добавить блок из
+[`assets/bathys-rules.md`](assets/bathys-rules.md) целиком (он самодостаточен).
+
+## Блок для AGENTS.md (суть)
+
+- Вся работа в интернете — через инструменты MCP-сервера `bathys`
+  (`deep_research` / `web_search` / `read_url` / `read_urls`), если он
+  подключён в вашей среде.
+- Выбор инструмента по задаче: ресёрч-вопрос → `deep_research`; ссылки →
+  `web_search`; известный URL → `read_url`; 2–10 URL → `read_urls`.
+- Верификация фактов — два независимых источника; каждый нетривиальный факт —
+  с URL.
+- Сигналы ответов (`cache HIT`/`MISS`, `robots-refused`, `(not fetched — …)`)
+  трактуются по семантике Bathys.
+
+## Почему не установщик
+
+MCP-сервер Bathys подключается к Pi **средой**, где Pi запущен (например,
+через обёртку, которая стартует MCP-сервер), а не конфигом самого Pi. Если
+ваша среда запускает Pi внутри харнесса с MCP (zcode, opencode и т.п.) —
+используйте `bathys install` для этого харнесса; для чистого Pi достаточно
+правил `AGENTS.md` выше.

bathys-0.6.2/integrations/pi/assets/bathys-rules.md

@@ -0,0 +1,35 @@
+<!-- Bathys: вставьте этот блок в AGENTS.md проекта, где работает Pi.
+     Блок самодостаточен: после него агент Pi не работает в интернете мимо
+     инструментов Bathys (если MCP-сервер подключён в среде запуска). -->
+
+## Веб-доступ: всегда через Bathys (локальный поисковый сервис, MCP)
+
+Вся работа в интернете — поиск, чтение страниц, исследования — идёт через
+инструменты MCP-сервера Bathys, когда он подключён в среде запуска. Сторонние
+web-инструменты не использовать: у Bathys свои дистилляция под запрос,
+токен-бюджеты, кэш и метрики.
+
+Выбор инструмента:
+
+- Исследовательский вопрос («что/как/почему/сравни») → `deep_research(query)` —
+  ищет, читает топ-источники и возвращает дистиллят под запрос одним вызовом.
+- Нужен только пул ссылок → `web_search(query)`.
+- Один известный URL → `read_url(url, query=…)`; 2–10 URL →
+  `read_urls(urls, query=…)` (общий бюджет, битая страница стоит строку).
+- Свежесть: `time_range` = day|week|month|year; протухший кэш (`cache HIT` с
+  устаревшими данными) — один `refresh=true` на главный источник.
+
+Правила работы:
+
+1. Формулируй `query` как вопрос: дистиллятор отбирает пассажи по смыслу.
+   Максимум 3 итерации без сдвига — смени угол (термины из найденного, язык).
+2. Ключевой факт — два независимых источника (разные домены); конфликт
+   источников фиксируй явно с обеими URL.
+3. Каждый нетривиальный факт в ответе сопровождай URL из секций Bathys.
+4. Сигналы: `(not fetched — …)` — источник не прочитан, используй остальные;
+   `robots-refused` — сайт запретил чтение, уважай; `No results … tried N
+   engine sets` — смени формулировку. Футер `[bathys: …]` — статистика,
+   не для цитирования.
+
+Готовые стратегии (MCP-промпты Bathys): `bathys_deep_research`,
+`bathys_source_audit`, `bathys_fresh_scan` — бери как стартовый шаблон плана.

bathys-0.6.2/integrations/zcode/README.md

@@ -0,0 +1,32 @@
+# Bathys × zcode — комплект установки
+
+zcode покрывается стандартным `bathys install` (автодетект
+`~/.zcode/cli/config.json` → `mcp.servers`). Этот комплект — для ручной
+установки всех.agent-активов разом и для случаев, когда ставят из клона.
+
+## Установка
+
+```bash
+bathys install                    # конфиг MCP (авто; бэкап создаётся сам)
+cp agents/bathys-researcher.md ~/.zcode/agents/          # субагент
+cp -r agents/skills/* ~/.zcode/skills/ 2>/dev/null || true # скиллы (если каталог скиллов используется)
+```
+
+## Что ставится
+
+| Артефакт | Куда | Зачем |
+|---|---|---|
+| MCP-сервер `bathys` | `~/.zcode/cli/config.json` → `mcp.servers` | 4 инструмента + 3 промпта + annotations (видны харнессу на рукопожатии) |
+| Субагент `bathys-researcher` | `~/.zcode/agents/` | профиль глубокого ресёрча; делегируй ему исследования целиком |
+| Скиллы `bathys-deep-dive`, `bathys-source-audit` | каталог скиллов харнесса | процедуры глубокого исследования и аудита источников |
+| Дроп-ин (опционально) | `~/.zcode/AGENTS.md` или проектный `AGENTS.md` | если instructions MCP не показываются — блок из `agents/HARNESS-DROPIN.md` |
+
+## Проверка
+
+```bash
+bathys-doctor          # конфиг + бэкенд + кэш + браузерный стек
+bathys install --dry-run   # конфиг виден и актуален
+```
+
+После установки перезапустите zcode; сервер поднимется при первом вызове
+вместе с бэкендом (external → docker → native).

bathys-0.6.2/npm/bathys-mcp/.remember/.gitignore

@@ -0,0 +1 @@
+*

bathys-0.6.2/npm/bathys-mcp/.remember/logs/memory-2026-09-08.log

@@ -0,0 +1,11 @@
+12:44:02 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:44:02 [hook] WARNING: no session dir for this project: /var/home/abyss/.distrobox/ubuntu/home/.claude/projects/-var-home-abyss-LABs-MCP-deepreserch-npm-bathys-mcp (slug of /var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp). Memory cannot save until it matches a directory under /var/home/abyss/.distrobox/ubuntu/home/.claude/projects/
+12:44:05 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:44:09 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:44:09 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:44:12 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:44:15 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:44:21 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:44:57 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:45:02 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember
+12:45:09 [hook] post-tool: PROJECT_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp PIPELINE_DIR=/var/home/abyss/.distrobox/ubuntu/home/.zcode/cli/plugins/cache/claude-plugins-official/remember/0.20.0 PYTHON=python3 REMEMBER_DIR=/var/home/abyss/LABs/MCP/deepreserch/npm/bathys-mcp/.remember

bathys-0.6.2/npm/bathys-mcp/.remember/tmp/no-transcript-notice

@@ -0,0 +1 @@
+1788860642