client.ts был god-object'ом на 5206 строк / ~65 методов / 5 ответственностей —
любая правка рисковала всем write-path, обработка ошибок неоднородна. Разнесли
на доменные модули; DocmostClient остаётся ТОНКИМ ФАСАДОМ с прежним внешним
контрактом. Чистый рефакторинг, поведение не меняется. closes#450
- Фасад client.ts (93 строки) композирует 10 миксинов над общим абстрактным
базовым классом. Паттерн — МИКСИНЫ (не context-object), т.к. тесты
субклассируют DocmostClient и переопределяют seam'ы (mutatePage/replacePage/
resolvePageId/getPageRaw/…); единая цепочка прототипов сохраняет виртуальную
диспетчеризацию this.<method> сквозь модули.
- client/context.ts (база, ≤700): общее состояние (axios, apiUrl, токены, кэши
resolvePageId/collab-token, sandbox/metrics-синки), конструктор + оба
интерсептора, login/ensureAuthenticated/paginateAll/resolvePageId/
mutateLiveContentUnlocked + write-seam'ы mutatePage/replacePage. private-поля
расширены до protected (внутреннее, не в публичном контракте) чтобы
соседние миксины видели общее состояние.
- Модули (каждый ≤730): read, pages, nodes-write, media (images/attachments/
drawio), comments, transforms (markdown + JS-sandbox transformPage), tables,
stash, doc-validate. errors.ts — единый REST error-mapping (formatDocmost
AxiosError, довершение #437; тексты сообщений без изменений).
- Внешний контракт СОХРАНЁН (доказано компиляцией с обеих сторон): 53 публичных
метода на DocmostClient через `implements IXMixin`-интерфейсы (без ручного
зеркала, #446); Pick<DocmostClient, DocmostClientMethod> in-app и Pick в
tool-specs резолвятся; множество async-методов 59==59 идентично. Нагруженные
seam'ы (replaceImage один-лок #425, self-resolve #449, единый error-путь) —
байт-идентичны. Ни одного дубля публичного метода; stub+impl всегда
затеняется реальной реализацией.
- zod v3→v4: investigate-only, РЕКОМЕНДАЦИЯ отложить — SDK 1.29 поддерживает v4
(peer ^3.25||^4.0), но мажор-бамп трогает всю схема-поверхность и оба хоста,
смешивать со структурным распилом рискованно. Отдельным follow-up.
Стоит на #449 (#475). Тесты: mcp node --test 800/800 (== база), tsc чисто в
client/ (2 pre-existing ws-типа в нетронутом lib/). Ни одной строки кода не
потеряно (нормализованный дифф), убраны 52 дублированных JSDoc-блока.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace the removed enterprise EE MCP (private apps/server/src/ee submodule,
license-gated /mcp route) with our docmost-mcp, vendored as an isolated ESM
workspace package and served by the server over HTTP — no enterprise license.
Backend:
- Add packages/mcp (@docmost/mcp): vendored docmost-mcp refactored into a
side-effect-free createDocmostMcpServer() factory (38 tools preserved),
stdio entry kept in stdio.ts, Streamable-HTTP session manager in http.ts.
- Add apps/server McpModule: @Post/@Get/@Delete('mcp') (served at /mcp via the
existing global-prefix exclude), @SkipTransform + reply.hijack to bridge raw
Fastify req/res into the SDK transport. The module dynamically imports the
ESM-only package from CommonJS via a Function-indirected import resolved with
require.resolve + file:// URL. Gated by the workspace ai.mcp toggle, a
service-account (MCP_DOCMOST_EMAIL/PASSWORD/API_URL) and optional MCP_TOKEN;
per-session idle eviction (MCP_SESSION_IDLE_MS).
- Drop the enterprise license check on mcpEnabled in workspace.service.
- Dockerfile: copy packages/mcp into the production image.
- .env.example: document MCP_DOCMOST_*, MCP_TOKEN, MCP_SESSION_IDLE_MS.
Frontend:
- Recreate the community "AI & MCP" workspace-settings panel (mcp-settings.tsx):
admin-only toggle on settings.ai.mcp with optimistic update, copyable
${APP_URL}/mcp URL; wired into workspace-settings page. Reuses existing i18n.
Fixes:
- Pin packages/mcp tiptap deps to 3.20.4 (matching the client) and inline
getStyleProperty, preventing a duplicate @tiptap/core@3.26.1 from leaking into
the client editor via pnpm shamefully-hoist (was breaking apps/client tsc).
agent_coder
vvzvlad