[2026-09-15] eagle: family/how-to/home-automation.md personal/tech/deepseek-language-drift.md personal/tech/hermes-fork-vs-upstream.md personal/tech/hermes-git-repo.md personal/tech/tirith-trust.md

personal/tech/hermes-fork-vs-upstream.md

@@ -87,7 +87,168 @@ Zulip — **полностью наша разработка**:
 десктоп/TUI-фронт. Наши правки в `gateway/run.py` (13 коммитов) и
 `gateway/stream_consumer.py` (9) — ровно в эпицентре этого рефакторинга.
 
-## Наши 32 коммита
+## Масштаб по коду (не «перетаскивание папок»)
+
+Апстрим — это не реорганизация, а **+322 новых модуля**. Считать так:
+
+| Область | У нас | У апстрима | Нового |
+|---------|-------|-----------|--------|
+| `agent/` | 88 файлов | 229 | **+144** |
+| `tools/` | 86 файлов | 262 | **+178** |
+| `hermes_state*` | 1 монолит | 25 модулей | разбит |
+| `apps/` | — | 2674 файла | desktop-приложение |
+| `evals/` | — | 203 файла | eval-фреймворк |
+| `contributors/` | — | 1176 | данные контрибьюторов |
+| `plugin-catalog/` | — | 27 | каталог плагинов |
+
+Команда для повторной проверки:
+```bash
+cd ~/.hermes/hermes-agent
+comm -13 <(git ls-tree --name-only main:agent/ | sort) \
+         <(git ls-tree --name-only upstream/main:agent/ | sort) | wc -l
+```
+
+## Что реально нового в апстриме (по функциональности)
+
+**1. Desktop-приложение (`apps/desktop`, 2674 файла)** — крупнейшая подсистема
+(773 коммита в скоупе `desktop`). Нативный GUI. Внутри — `bootstrap-installer`,
+`shared`. Это фронт на TypeScript/Ink.
+
+**2. Bot Mode** (`website/docs/user-guide/bot-mode.md`) — **прямо про наш кейс.**
+Профили превращаются в roster именованных **ботов**: у каждого своя роль, модель,
+память, скиллы, аватар. Боты ходят в групповые чаты и **пишут друг другу**.
+Ключевое: «A Bot **is** a Hermes profile» — никакого нового примитива, всё видно
+из CLI (`hermes -p <bot> chat`), роутины в `hermes cron list`.
+Есть «forever-chat» на бота: `/new` внутри перехватывается в `/compact`.
+Секции (папки) для группировки, скрытие ботов, фильтр «Active now».
+
+**Сопоставление с нашим:** у нас Eagle + Whale + Balda роутятся через самодельный
+`plugins/whale-thread-guard` (файл `thread_ownership.json`). У апстрима это
+**нативная фича с UI**. ⚠️ Открытый вопрос для Alex — не выбрасывается ли наш
+роутинг в пользу нативного (см. «Ключевой вопрос» ниже).
+
+**3. Автономные циклы — три механизма:**
+- `/goal` — стоящая цель через turns; lightweight judge-модель после каждого turn
+  проверяет достижение, агент сам кормит continuation prompt до успеха. Их версия
+  Ralph loop (вдохновлено Codex CLI 0.128.0).
+- `/loop` — перезапуск промпта по таймеру **внутри сессии**; каждый wakeup — это
+  реальный turn. Их версия Claude Code `/loop` (алиас `/proactive`).
+- `/heartbeat` — один промпт на сессию, срабатывает когда сессия idle.
+Разница: `/goal` judge-driven («работай пока не достигнешь»), `/loop` timer-driven
+(«делай это каждые N минут»).
+
+**4. Encrypted credential vault** (`agent/vault_store.py`) — зашифрованное
+(Fernet) локальное хранилище для browser autofill. Profile-scoped, **model-blind**:
+модель видит только opaque handles + метаданные (kind, label, origin), значения
+резолвятся server-side и не попадают в tool results / логи / session DB.
+Три вида: `login`, `payment`, `address`. Ключ и файл 0600 в `<HERMES_HOME>/vault/`.
+Портировано из Merit-Systems/OpenInstinct (MIT).
+
+**5. Turn-цикл разобран на 29 модулей** — `turn_facade`, `turn_preflight`,
+`turn_preflight_gate`, `turn_recovery`, `turn_overflow`, `turn_truncation`,
+`turn_tool_round`, `turn_finalizer`, `turn_liveness`, `turn_retry_state` и др.
+`run_conversation` из монолита стал конвейером.
+
+**6. MCP переписан — 20 модулей:** `mcp_tool_discovery`, `mcp_oauth_provider`,
+`mcp_death_supervisor`, `mcp_tool_sampling`, `mcp_tool_schema`, `mcp_schema_cache`,
+`mcp_tool_health`, `mcp_tool_scope`, `mcp_oauth_device` и др.
+
+**7. Браузер — 16 модулей** `browser_tool_*`: CDP, cloud, lightpanda fallback,
+snapshot, vision, origin, session, lifecycle, install, real_profile,
+supervisor_dialogs/frames, eval_policy, vault_tool.
+
+**8. `native/fts5_cjk`** — C-расширение SQLite FTS5 для **китайского/японского/
+корейского** токенизации полнотекстового поиска. Нативная сборка
+(`build.sh` + `vendor/sqlite3.h`). Прямо относится к багу китайского вывода —
+см. [[deepseek-language-drift]].
+
+**9. Skills Hub — 8 модулей:** `skills_hub_github`, `skills_hub_official`,
+`skills_hub_clawhub`, `skills_hub_skillssh`, `skills_hub_search`, `skills_hub_install`,
+`skills_hub_sources`, `skills_hub_models`. Плюс `skill_linter`, `skill_ledger`,
+`skill_manager_batch`, `skill_manager_guards`.
+
+**10. Прочее новое:** `pets` (питомцы в UI), `skins`, `personality`,
+`mixture-of-agents` (`moa_loop.py`, `moa_trace.py`), `honcho` (memory-провайдер),
+`code_kernel` + `code_kernel_remote` (Python-кирнел), `deliverable-mode` (файлы
+как нативные вложения в мессенджерах), `credential-pools`, `provider-routing`,
+`subscription-proxy`, `tool-gateway`, `tool-search`, `kanban-multi-gateway`,
+`relay` (NeMo Relay runtimes, 54 коммита), `lsp`, `heartbeat`, `goals`, `loops`,
+`curator`, `skills`, `context-references`, `document-extraction`, `batch-processing`,
+`computer-use`, `codex-app-server-runtime`, `plugin-catalog`, `extending-the-dashboard`.
+
+**Новые top-level каталоги:** `apps/`, `native/`, `evals/`, `contributors/`,
+`plugin-catalog/`, `providers/`, `locales/`, `web/`, `website/i18n`.
+
+## Ответ: есть ли замена Zulip?
+
+**Нет.** Проверено по существу — по модели общения, а не по имени платформы.
+
+| Платформа | Треды | Self-hosted | Stream+topic |
+|-----------|-------|-------------|--------------|
+| `matrix` | ✅ threads | ✅ | ❌ room-based |
+| `mattermost` | ✅ thread-mode replies | ✅ | ❌ channel-based |
+| `slack` | ✅ threads | ❌ SaaS | ❌ |
+| `teams` | ✅ | ❌ SaaS | ❌ |
+| `google_chat` | ❌ | ❌ SaaS | ❌ |
+| `irc` | ❌ | ✅ | ❌ flat |
+| `simplex` | ❌ groups | ✅ p2p | ❌ |
+| `a2a` | — | ✅ | — (agent-to-agent, не чат) |
+
+Проверка на stream+topic: `git grep -li 'stream.*topic' upstream/main -- plugins/platforms/`
+→ только `dingtalk` и `telegram`, и там это не топик-модель.
+
+**Ключевое различие:** Zulip — единственная известная чат-платформа с нативной
+моделью «поток → топик», где топик = **адресуемая сущность** с собственным именем.
+Matrix и Mattermost дают треды как *свойство сообщения* (reply-thread), а не как
+*адресуемую сущность*. У нас `stream::topic` — это **ключ роутинга**
+(`thread_ownership.json`: `"stream::topic": "eagle"|"whale"`), на их модели такой
+ключ не построить.
+
+**Вывод:** миграция на matrix/mattermost = потеря топик-роутинга между ботами.
+`whale-thread-guard` на их модели не переносится.
+
+Подробности платформ: `plugins/platforms/<name>/plugin.yaml` — там `description`,
+`requires_env`, `optional_env` с описаниями (`MATTERMOST_REPLY_MODE: 'thread'|'off'`,
+`MATRIX_HOMESERVER`, mention-gating и т.д.).
+
+## Ответ: сделаны ли custom prompts как у нас?
+
+**Нет, аналога не существует.** Проверено:
+```bash
+git grep -l 'prompt_overrides' upstream/main   # пусто
+git grep -l '_load_prompt_block' upstream/main # пусто
+```
+
+В апстриме **все** блоки промпта — **захардкоженные константы** в
+`agent/prompt_builder.py`: `MEMORY_GUIDANCE`, `USER_PROFILE_GUIDANCE`,
+`SESSION_SEARCH_GUIDANCE`, `SKILLS_GUIDANCE`, `KANBAN_GUIDANCE`,
+`TOOL_USE_ENFORCEMENT_GUIDANCE`, `TASK_COMPLETION_GUIDANCE`,
+`PARALLEL_TOOL_CALL_GUIDANCE`, `OPENAI_MODEL_EXECUTION_GUIDANCE`,
+`GOOGLE_MODEL_OPERATIONAL_GUIDANCE`, `HERMES_AGENT_HELP_GUIDANCE` (+ вариант
+`_NO_SKILLS`), `DEFAULT_AGENT_IDENTITY`, `PLATFORM_HINTS` (по платформе).
+
+`build_system_prompt_parts()` в апстриме просто делает `stable_parts.append(CONST)`
+— точки подмены из файла нет.
+
+**Что у апстрима ЕСТЬ для кастомизации:**
+- `SOUL.md` — идентичность агента (есть и у нас, грузится через `load_soul_md()`)
+- context-файлы из CWD (`AGENTS.md`, `HERMES.md`) — `_find_hermes_md()`,
+  `_scan_context_content()`, `_strip_yaml_frontmatter()`
+- `system_message` из конфига
+
+**Чего НЕТ:** подмены отдельных блоков промпта файлами. То есть наш
+`_load_prompt_block()` + `agent.prompt_overrides` — **уникальная фича форка**
+(коммит `207a1de16`). См. [[hermes-agent-improvements]].
+
+**Практический смысл различия:** у нас правка промпта = редактирование `.md`
+в `hermes-whale/review/` без касания Python. У них = правка Python-константы в
+`prompt_builder.py`, который апстрим постоянно переписывает (131 коммит).
+
+**`agent/thread_scoped_output.py`** — существует в апстриме. У нас thread-scoped
+память сделана с нуля (`972004546f`). Стоит сравнить перед вариантом B: возможно,
+у апстрима есть готовое решение лучше. Не проверено детально.
+
+## НАШИ 32 КОММИТА
 
 Сгруппированы по темам:
 
@@ -178,6 +339,27 @@ Dry-run `git merge-tree` → **16 конфликтных файлов, 160 ко
 
 Это можно брать точечно (cherry-pick), не таща весь долг.
 
+### Что уточнилось 2026-09-15 (второй проход)
+
+Alex задал три прямых вопроса, ответы получены (детали — в разделах выше):
+
+| Вопрос | Ответ |
+|--------|-------|
+| Что нового в апстриме? | Не только платформы: +322 модуля, desktop, Bot Mode, `/goal` `/loop` `/heartbeat`, vault, turn-рефакторинг, MCP, Skills Hub |
+| Есть ли замена Zulip? | **Нет** — ни одна платформа не даёт stream+topic как адресуемую сущность |
+| Сделаны ли custom prompts как у нас? | **Нет** — блоки захардкожены, `prompt_overrides` уникален для форка |
+
+**Новый открытый вопрос (важнее прежних):** Bot Mode апстрима делает нативно
+то, что у нас держится на самодельном `whale-thread-guard` + `thread_ownership.json`.
+Если переезжать на вариант B — надо решить, **переносить наш роутинг или
+выбрасывать в пользу нативного Bot Mode**. Этот вопрос не задан Alex'у явно,
+вынесен как следующий шаг.
+
+**Также не проверено:** `agent/thread_scoped_output.py` в апстриме vs наша
+thread-scoped память — возможно, у них готовое решение лучше нашей реализации.
+
+**Статус:** стратегия подтяжки по-прежнему **не выбрана**. Форк запушен и стабилен.
+
 ## Команды для проверки расхождения
 
 ```bash