7cb3199d09
Один логический тул жил под двумя именами: внешний MCP snake_case (edit_page_text), in-app camelCase (editPageText) — дублирование доков, путаница при переносе промптов/скиллов, помеха шарингу спек (#294). Решение владельца: единый camelCase везде, включая внешний MCP. После этого mcpName === inAppKey. - tool-specs.ts: mcpName ВЫВЕДЕН из ключа спеки (mcpName == inAppKey) для всех 43 shared-спек — раньше divergent snake, теперь равен ключу (проверено: mcpName читается только структурно — цикл регистрации, генератор <tool_inventory>, TOOL_FAMILY). +5 inline-регистраций (tableGet/updateComment/deleteComment/ docmostTransform; search без изменений). Рантайм: 47 тулов, все camelCase, ноль подчёркиваний. - Контракт-конвенция ИНВЕРТИРОВАНА: shared-tool-specs.contract.spec `mcpName === toSnake(inAppKey)` → `mcpName === inAppKey`; tool-specs.test и tool-inventory.test обновлены. - ROUTING_PROSE/TOOL_FAMILY/INLINE_MCP_INVENTORY (server-instructions.ts) → camelCase (105 замен). ai-chat.prompt/guard уже на in-app camelCase-ключах — без изменений (guard прошёл). comment-signal EXCLUDED_TOOLS схлопнут с дублей snake+camel до camelCase. - Некоторое неочевидное: assertUnambiguousMatch(op: "patch_node"|"delete_node") в prosemirror-markdown/node-ops — op интерполируется в model-facing ошибку; литерал-юнион + call-sites → "patchNode"|"deleteNode". - Все snake-имена в описаниях/error-строках/комментах/тестах/доках → camelCase (whole-token, longest-match-first). CHANGELOG: BREAKING-таблица 46 строк + миграция (allowlists mcp__gitmost-*__get_node→__getNode, промпты/скиллы, .mcp.json, метрики по tool-label); релизится вместе с #411. Внутренние имена методов (PageService.updatePageContent и т.п.) НЕ тронуты — переименованы только ИМЕНА ТУЛОВ. Гейт: mcp node --test 677/677; tsc -p apps/server чисто; jest ai-chat-tools. service + shared-tool-specs.contract + tool-tiers + ai-chat.prompt + comment-signal-inapp → 323. Второй линк breaking-окна (#411→ЭТОТ→#413→#415). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
23 lines
871 B
TypeScript
23 lines
871 B
TypeScript
// The model sometimes serializes a ProseMirror node arg as a JSON string
|
|
// instead of an object. Normalize: parse a string to an object (throwing on
|
|
// invalid JSON), pass an object through unchanged. Shared by patchNode /
|
|
// insertNode (and the analogous updatePageJson content parsing).
|
|
//
|
|
// This lives in the converter package (#414) so BOTH consumers import the ONE
|
|
// copy: `@docmost/mcp` (ESM) and the CommonJS server app. The server cannot
|
|
// import `@docmost/mcp` directly (ESM-only, no declaration files), but it does
|
|
// import `@docmost/prosemirror-markdown` natively — so this is the shared home.
|
|
export function parseNodeArg(
|
|
node: unknown,
|
|
errMsg = "node was a string but not valid JSON",
|
|
): unknown {
|
|
if (typeof node === "string") {
|
|
try {
|
|
return JSON.parse(node);
|
|
} catch {
|
|
throw new Error(errMsg);
|
|
}
|
|
}
|
|
return node;
|
|
}
|